@tribepad/themis 1.0.0 → 1.0.1

package/dist/elements/NumberField/index.mjs

@@ -1,8 +1,656 @@
-import '../../chunk-4NHAP4AN.mjs';
-export { DEFAULT_MAX_VALUE, DEFAULT_MIN_VALUE, NEGATIVE_MIN_VALUE, NumberField, NumberFieldPropsSchema, numberFieldDescriptionVariants, numberFieldErrorVariants, numberFieldInputVariants, numberFieldLabelVariants, numberFieldStepperVariants, numberFieldVariants } from '../../chunk-A3YUJA6W.mjs';
-import '../../chunk-BDXKKMBZ.mjs';
-import '../../chunk-FPKEAJRZ.mjs';
-import '../../chunk-HK46BT5U.mjs';
-import '../../chunk-E2KQFV3O.mjs';
+"use client";
+import { createContext, memo, forwardRef, useId, useContext } from 'react';
+import { Button as Button$1, NumberField as NumberField$1, Label, Group, Input, Text, FieldError } from 'react-aria-components';
+import { Loader2, Zap, Minus, Plus } from 'lucide-react';
+import { cva } from 'class-variance-authority';
+import { clsx } from 'clsx';
+import { twMerge } from 'tailwind-merge';
+import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
+import { z } from 'zod';
+
+// src/elements/NumberField/NumberField.tsx
+function cn(...inputs) {
+  return twMerge(clsx(inputs));
+}
+var PRESSED_STYLES = "data-[pressed]:scale-[0.97]";
+var HOVER_STYLES = "data-[hovered]:shadow-md";
+var HIGH_CONTRAST_HOVER = "hc:data-[hovered]:outline hc:data-[hovered]:outline-2 hc:data-[hovered]:outline-foreground";
+var HIGH_CONTRAST_PRESSED = "hc:data-[pressed]:outline hc:data-[pressed]:outline-2 hc:data-[pressed]:outline-offset-1 hc:data-[pressed]:outline-foreground";
+var ButtonGroupContext = createContext(null);
+ButtonGroupContext.displayName = "ButtonGroupContext";
+function useButtonGroupContext() {
+  return useContext(ButtonGroupContext);
+}
+var ButtonGroupItemContext = createContext(null);
+ButtonGroupItemContext.displayName = "ButtonGroupItemContext";
+function useButtonGroupItemContext() {
+  return useContext(ButtonGroupItemContext);
+}
+cva("inline-flex items-center gap-0", {
+  variants: {
+    orientation: {
+      horizontal: "flex-row",
+      vertical: "flex-col w-full"
+    }
+  },
+  defaultVariants: {
+    orientation: "horizontal"
+  }
+});
+var buttonGroupItemVariants = cva("", {
+  variants: {
+    orientation: {
+      // min-w-[44px] ensures visual layer fills touch target width (for icon buttons)
+      horizontal: "min-w-[44px]",
+      // flex (overrides inline-flex) + min-h-[44px] makes visual layer fill touch target,
+      // eliminating gaps between stacked buttons in vertical orientation
+      vertical: "flex min-h-[44px]"
+    },
+    position: {
+      first: "",
+      middle: "",
+      last: "",
+      only: ""
+      // Single button - no modifications needed
+    }
+  },
+  compoundVariants: [
+    // ==========================================================================
+    // Horizontal Orientation
+    // ==========================================================================
+    {
+      orientation: "horizontal",
+      position: "first",
+      className: "rounded-r-none border-r-0"
+    },
+    {
+      orientation: "horizontal",
+      position: "middle",
+      className: "rounded-none border-r-0"
+    },
+    {
+      orientation: "horizontal",
+      position: "last",
+      className: "rounded-l-none"
+    },
+    // ==========================================================================
+    // Vertical Orientation
+    // Note: w-full is handled by Button's effectiveFullWidth for both layers
+    // ==========================================================================
+    {
+      orientation: "vertical",
+      position: "first",
+      className: "rounded-b-none border-b-0"
+    },
+    {
+      orientation: "vertical",
+      position: "middle",
+      className: "rounded-none border-b-0"
+    },
+    {
+      orientation: "vertical",
+      position: "last",
+      className: "rounded-t-none"
+    }
+  ],
+  defaultVariants: {
+    orientation: "horizontal",
+    position: "only"
+  }
+});
+cva("bg-[var(--border)]", {
+  variants: {
+    orientation: {
+      horizontal: "w-px h-6 mx-1",
+      vertical: "h-px w-full my-1"
+    }
+  },
+  defaultVariants: {
+    orientation: "horizontal"
+  }
+});
+var buttonOuterVariants = cva(
+  "inline-flex justify-center min-h-[44px] min-w-[44px] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[var(--ring)] focus-visible:ring-offset-2 focus-visible:ring-offset-background disabled:pointer-events-none disabled:opacity-50",
+  {
+    variants: {
+      fullWidth: {
+        true: "w-full",
+        false: ""
+      },
+      inVerticalGroup: {
+        true: "items-stretch",
+        false: "items-center"
+      }
+    },
+    defaultVariants: {
+      fullWidth: false,
+      inVerticalGroup: false
+    }
+  }
+);
+var buttonVisualVariants = cva(
+  "inline-flex items-center justify-center gap-2 whitespace-nowrap rounded-md text-sm font-medium ring-offset-background transition-colors [&_svg]:pointer-events-none [&_svg]:size-4 [&_svg]:shrink-0 relative cursor-pointer",
+  {
+    variants: {
+      variant: {
+        default: "bg-[var(--primary-action)] text-[var(--primary-action-foreground)] shadow-md hover:bg-[var(--primary-action-hover)] data-[pressed]:bg-[var(--primary-action)]/80",
+        destructive: "bg-[var(--destructive-background)] text-[var(--destructive-foreground)] shadow-md hover:bg-[var(--destructive-background)]/90 data-[pressed]:bg-[var(--destructive-background)]/80",
+        outline: "border border-[var(--input-border)] bg-[var(--page-background)] hover:bg-[var(--input-border)] data-[pressed]:bg-[var(--input-border)]",
+        secondary: "bg-[var(--secondary)] text-[var(--secondary-foreground)] shadow-md hover:bg-[var(--secondary)]/80 data-[pressed]:bg-[var(--secondary)]/70",
+        ghost: "hover:bg-[var(--accent)] hover:text-[var(--accent-foreground)] data-[pressed]:bg-[var(--accent)]",
+        link: "text-[var(--text-link)] underline-offset-4 hover:underline data-[pressed]:text-[var(--text-link-hover)]"
+      },
+      fullWidth: {
+        true: "w-full",
+        false: ""
+      },
+      visualSize: {
+        default: "h-10 px-4 py-2",
+        sm: "h-9 rounded-md px-3 text-xs",
+        lg: "h-11 rounded-md px-8",
+        icon: "h-10 w-10",
+        dot: "h-5 w-5 rounded-full p-0 min-h-0 min-w-0"
+      },
+      paywall: {
+        true: "!bg-[var(--paywall)] !text-[var(--paywall-foreground)] !shadow-md hover:!bg-[var(--paywall)]/90 !cursor-not-allowed !border-transparent",
+        false: ""
+      }
+    },
+    defaultVariants: {
+      variant: "default",
+      visualSize: "default",
+      paywall: false
+    }
+  }
+);
+var Button = memo(forwardRef(
+  ({
+    className,
+    buttonVisualClassName,
+    variant,
+    size,
+    visualSize,
+    fullWidth,
+    loading = false,
+    loadingText = "Loading...",
+    shortcut,
+    children,
+    isDisabled,
+    paywall = false,
+    paywallRedirect,
+    paywallDescription,
+    onPress,
+    ...props
+  }, ref) => {
+    const paywallDescriptionId = useId();
+    const groupContext = useButtonGroupContext();
+    const itemContext = useButtonGroupItemContext();
+    const effectiveVariant = variant ?? groupContext?.variant ?? "default";
+    const effectiveSize = size ?? groupContext?.size;
+    const effectiveIsDisabled = isDisabled ?? groupContext?.isDisabled ?? false;
+    const isInVerticalGroup = groupContext?.orientation === "vertical";
+    const effectiveFullWidth = fullWidth || isInVerticalGroup;
+    const positionClassName = itemContext ? buttonGroupItemVariants({
+      orientation: groupContext?.orientation ?? "horizontal",
+      position: itemContext.position
+    }) : "";
+    const effectiveVisualSize = visualSize ?? effectiveSize ?? "default";
+    if (process.env.NODE_ENV !== "production") {
+      if ((effectiveVisualSize === "dot" || effectiveVisualSize === "icon") && !props["aria-label"] && !children) {
+        console.warn(
+          '[Button] visualSize="dot" or "icon" requires aria-label when no visible text is provided (WCAG 1.1.1)'
+        );
+      }
+    }
+    const handlePress = (e) => {
+      if (paywall) {
+        if (paywallRedirect) {
+          window.open(paywallRedirect, "_blank", "noopener,noreferrer");
+        }
+        return;
+      }
+      onPress?.(e);
+    };
+    const computedIsDisabled = effectiveIsDisabled || loading || void 0;
+    return /* @__PURE__ */ jsx(
+      Button$1,
+      {
+        ref,
+        isDisabled: computedIsDisabled,
+        "aria-disabled": paywall ? true : void 0,
+        "aria-describedby": paywall ? paywallDescriptionId : void 0,
+        onPress: handlePress,
+        className: cn(buttonOuterVariants({ fullWidth: effectiveFullWidth, inVerticalGroup: isInVerticalGroup }), className),
+        ...props,
+        children: (renderProps) => (
+          /* Layer 2: Visual Button */
+          /* @__PURE__ */ jsxs(
+            "span",
+            {
+              className: cn(
+                buttonVisualVariants({
+                  variant: effectiveVariant,
+                  visualSize: effectiveVisualSize,
+                  paywall,
+                  fullWidth: effectiveFullWidth
+                }),
+                // Position styling from ButtonGroup context (border-radius adjustments)
+                positionClassName,
+                buttonVisualClassName,
+                // Layer 2 interaction styles (no focus - focus ring is on Layer 1)
+                PRESSED_STYLES,
+                HOVER_STYLES,
+                HIGH_CONTRAST_HOVER,
+                HIGH_CONTRAST_PRESSED
+              ),
+              "data-pressed": renderProps.isPressed || void 0,
+              children: [
+                loading && /* @__PURE__ */ jsxs(Fragment, { children: [
+                  /* @__PURE__ */ jsx(Loader2, { className: "motion-safe:animate-spin", "aria-hidden": "true" }),
+                  /* @__PURE__ */ jsx("span", { className: "sr-only", "aria-live": "polite", children: loadingText })
+                ] }),
+                !loading && children,
+                paywall && /* @__PURE__ */ jsx(
+                  Zap,
+                  {
+                    "data-testid": "zap-icon",
+                    "aria-hidden": "true",
+                    className: "ml-1"
+                  }
+                ),
+                paywall && /* @__PURE__ */ jsxs("span", { id: paywallDescriptionId, className: "sr-only", children: [
+                  "Premium feature: ",
+                  paywallDescription || "Upgrade required to access this feature"
+                ] }),
+                renderProps.isFocusVisible && shortcut && /* @__PURE__ */ jsx("kbd", { className: "ml-auto hidden text-xs opacity-60 lg:inline", children: shortcut }),
+                renderProps.isPressed && /* @__PURE__ */ jsx(
+                  "span",
+                  {
+                    className: "absolute inset-0 rounded-[inherit] bg-current opacity-10 motion-safe:animate-in motion-safe:zoom-in-95",
+                    "aria-hidden": "true"
+                  }
+                )
+              ]
+            }
+          )
+        )
+      }
+    );
+  }
+));
+Button.displayName = "Button";
+var DEFAULT_MAX_VALUE = 4294967295;
+var DEFAULT_MIN_VALUE = 0;
+var NEGATIVE_MIN_VALUE = -2147483647;
+var NumberFieldPropsSchema = z.object({
+  // Value props
+  /** Current value (controlled mode) */
+  value: z.number().nullable().optional(),
+  /** Default value (uncontrolled mode) */
+  defaultValue: z.number().optional(),
+  // Constraint props
+  /** Minimum allowed value (default: 0) */
+  minValue: z.number().optional(),
+  /** Maximum allowed value (default: 4294967295 / UINT32_MAX) */
+  maxValue: z.number().optional(),
+  /** Allow negative numbers (sets minValue to -2147483647 if not explicitly set) */
+  allowNegative: z.boolean().optional(),
+  /** Step increment for stepper buttons and arrow keys (default: 1) */
+  step: z.number().positive().optional(),
+  // Formatting props
+  /** Intl.NumberFormat options for locale-aware formatting */
+  formatOptions: z.custom().optional(),
+  // State props
+  /** Whether the field is disabled */
+  isDisabled: z.boolean().optional(),
+  /** Whether the field is read-only */
+  isReadOnly: z.boolean().optional(),
+  /** Whether the field is required */
+  isRequired: z.boolean().optional(),
+  /** Whether the field is in an invalid state */
+  isInvalid: z.boolean().optional(),
+  /** Whether scroll wheel adjustment is disabled */
+  isWheelDisabled: z.boolean().optional(),
+  // Validation props
+  /** Custom validation function that returns an error message or null */
+  validate: z.function().optional(),
+  /** Validation behavior: 'native' for HTML5 validation, 'aria' for ARIA-only */
+  validationBehavior: z.enum(["native", "aria"]).default("native"),
+  // Display props
+  /** Field label (required for accessibility) */
+  label: z.string(),
+  /** Description text below the field */
+  description: z.string().optional(),
+  /** Error message string or render function */
+  errorMessage: z.union([z.string(), z.function()]).optional(),
+  // Stepper props
+  /** Layout for stepper buttons */
+  stepperLayout: z.enum(["sides", "stacked", "hidden"]).default("sides"),
+  /** Custom aria-label for increment button */
+  incrementAriaLabel: z.string().optional(),
+  /** Custom aria-label for decrement button */
+  decrementAriaLabel: z.string().optional(),
+  // Form props
+  /** Name attribute for form submission */
+  name: z.string().optional(),
+  // Variant props
+  /** Size variant */
+  size: z.enum(["sm", "default", "lg"]).default("default"),
+  // Event props
+  /** Called when the numeric value changes */
+  onChange: z.function().optional(),
+  /** Called when the field gains focus */
+  onFocus: z.function().optional(),
+  /** Called when the field loses focus */
+  onBlur: z.function().optional(),
+  /** Called when focus state changes */
+  onFocusChange: z.function().optional(),
+  // Standard props
+  /** Additional CSS classes */
+  className: z.string().optional(),
+  /** Whether to auto-focus on mount */
+  autoFocus: z.boolean().optional()
+});
+var numberFieldVariants = cva(
+  [
+    // Base styles
+    "inline-flex items-center rounded-md border",
+    "bg-[var(--content-background)] text-[var(--content-foreground)]",
+    "transition-colors duration-200",
+    // Focus within
+    "focus-within:ring-2 focus-within:ring-[var(--ring)] focus-within:ring-offset-2",
+    // Disabled
+    "data-[disabled]:cursor-not-allowed data-[disabled]:opacity-50"
+  ],
+  {
+    variants: {
+      size: {
+        sm: "h-9 text-sm",
+        default: "h-10 text-base",
+        lg: "h-12 text-lg"
+      },
+      isInvalid: {
+        true: "border-[var(--destructive)] focus-within:ring-[var(--destructive)]",
+        false: "border-[var(--input)] hover:border-[var(--input)]/80"
+      }
+    },
+    defaultVariants: {
+      size: "default",
+      isInvalid: false
+    }
+  }
+);
+var numberFieldInputVariants = cva(
+  [
+    // Base styles
+    "flex-1 bg-transparent text-center tabular-nums",
+    "min-w-0",
+    // Allow shrinking
+    // Focus
+    "focus:outline-none",
+    // Hide native spinners
+    "[appearance:textfield]",
+    "[&::-webkit-outer-spin-button]:appearance-none",
+    "[&::-webkit-inner-spin-button]:appearance-none"
+  ],
+  {
+    variants: {
+      size: {
+        sm: "px-2 text-sm",
+        default: "px-3 text-base",
+        lg: "px-4 text-lg"
+      }
+    },
+    defaultVariants: {
+      size: "default"
+    }
+  }
+);
+var numberFieldStepperVariants = cva(
+  [
+    // Base styles
+    "flex items-center justify-center",
+    "transition-colors duration-150",
+    "select-none",
+    // Hover
+    "hover:bg-[var(--accent)] hover:text-[var(--accent-foreground)]",
+    // Focus
+    "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[var(--ring)]",
+    "focus-visible:ring-inset",
+    // Active (pressed)
+    "active:bg-[var(--accent)]/80",
+    // Disabled
+    "disabled:pointer-events-none disabled:opacity-50"
+  ],
+  {
+    variants: {
+      size: {
+        sm: "min-w-8 min-h-8 text-sm",
+        default: "min-w-10 min-h-10 text-base",
+        lg: "min-w-12 min-h-12 text-lg"
+      },
+      position: {
+        left: "rounded-l-md border-r border-[var(--input)]",
+        right: "rounded-r-md border-l border-[var(--input)]",
+        top: "rounded-tr-md border-b border-l border-[var(--input)] h-1/2",
+        bottom: "rounded-br-md border-l border-[var(--input)] h-1/2"
+      }
+    },
+    defaultVariants: {
+      size: "default"
+    }
+  }
+);
+var numberFieldLabelVariants = cva(
+  [
+    "block font-medium text-[var(--content-foreground)]",
+    "mb-1.5",
+    // Required indicator
+    'data-[required]:after:content-["*"] data-[required]:after:ml-0.5',
+    "data-[required]:after:text-[var(--destructive)]"
+  ],
+  {
+    variants: {
+      size: {
+        sm: "text-sm",
+        default: "text-sm",
+        lg: "text-base"
+      }
+    },
+    defaultVariants: {
+      size: "default"
+    }
+  }
+);
+var numberFieldDescriptionVariants = cva(
+  [
+    "text-[var(--menu-muted)]",
+    "mt-1"
+  ],
+  {
+    variants: {
+      size: {
+        sm: "text-xs",
+        default: "text-sm",
+        lg: "text-base"
+      }
+    },
+    defaultVariants: {
+      size: "default"
+    }
+  }
+);
+var numberFieldErrorVariants = cva(
+  [
+    "flex items-center gap-1",
+    "text-[var(--destructive)]",
+    "mt-1"
+  ],
+  {
+    variants: {
+      size: {
+        sm: "text-xs",
+        default: "text-sm",
+        lg: "text-base"
+      }
+    },
+    defaultVariants: {
+      size: "default"
+    }
+  }
+);
+var NumberField = forwardRef(
+  ({
+    // Display props
+    label,
+    description,
+    errorMessage,
+    // Variant props
+    size = "default",
+    stepperLayout = "sides",
+    // Custom props
+    allowNegative = false,
+    incrementAriaLabel,
+    decrementAriaLabel,
+    // Constraint props (apply defaults)
+    minValue,
+    maxValue,
+    // Standard props
+    className,
+    isInvalid,
+    isRequired,
+    isDisabled,
+    isReadOnly,
+    // All other props go to AriaNumberField
+    ...props
+  }, ref) => {
+    const effectiveMinValue = minValue ?? (allowNegative ? NEGATIVE_MIN_VALUE : DEFAULT_MIN_VALUE);
+    const effectiveMaxValue = maxValue ?? DEFAULT_MAX_VALUE;
+    const showSteppers = stepperLayout !== "hidden" && !isReadOnly;
+    const isStackedLayout = stepperLayout === "stacked";
+    return /* @__PURE__ */ jsxs(
+      NumberField$1,
+      {
+        ref,
+        className: cn("group flex flex-col", className),
+        minValue: effectiveMinValue,
+        maxValue: effectiveMaxValue,
+        isInvalid,
+        isRequired,
+        isDisabled,
+        isReadOnly,
+        ...props,
+        children: [
+          /* @__PURE__ */ jsx(
+            Label,
+            {
+              className: cn(numberFieldLabelVariants({ size })),
+              "data-required": isRequired || void 0,
+              children: label
+            }
+          ),
+          /* @__PURE__ */ jsxs(
+            Group,
+            {
+              className: cn(
+                numberFieldVariants({
+                  size,
+                  isInvalid: isInvalid ?? false
+                }),
+                isStackedLayout && "pr-0"
+              ),
+              children: [
+                showSteppers && !isStackedLayout && /* @__PURE__ */ jsx(
+                  Button,
+                  {
+                    slot: "decrement",
+                    variant: "ghost",
+                    className: "!min-h-0 !min-w-0",
+                    buttonVisualClassName: cn(
+                      numberFieldStepperVariants({
+                        size,
+                        position: "left"
+                      })
+                    ),
+                    "aria-label": decrementAriaLabel ?? "Decrease value",
+                    children: /* @__PURE__ */ jsx(Minus, { className: "h-4 w-4", "aria-hidden": "true" })
+                  }
+                ),
+                /* @__PURE__ */ jsx(
+                  Input,
+                  {
+                    className: cn(numberFieldInputVariants({ size }))
+                  }
+                ),
+                showSteppers && isStackedLayout && /* @__PURE__ */ jsxs("div", { className: "flex flex-col h-full", children: [
+                  /* @__PURE__ */ jsx(
+                    Button,
+                    {
+                      slot: "increment",
+                      variant: "ghost",
+                      className: "!min-h-0 !min-w-0",
+                      buttonVisualClassName: cn(
+                        numberFieldStepperVariants({
+                          size,
+                          position: "top"
+                        })
+                      ),
+                      "aria-label": incrementAriaLabel ?? "Increase value",
+                      children: /* @__PURE__ */ jsx(Plus, { className: "h-3 w-3", "aria-hidden": "true" })
+                    }
+                  ),
+                  /* @__PURE__ */ jsx(
+                    Button,
+                    {
+                      slot: "decrement",
+                      variant: "ghost",
+                      className: "!min-h-0 !min-w-0",
+                      buttonVisualClassName: cn(
+                        numberFieldStepperVariants({
+                          size,
+                          position: "bottom"
+                        })
+                      ),
+                      "aria-label": decrementAriaLabel ?? "Decrease value",
+                      children: /* @__PURE__ */ jsx(Minus, { className: "h-3 w-3", "aria-hidden": "true" })
+                    }
+                  )
+                ] }),
+                showSteppers && !isStackedLayout && /* @__PURE__ */ jsx(
+                  Button,
+                  {
+                    slot: "increment",
+                    variant: "ghost",
+                    className: "!min-h-0 !min-w-0",
+                    buttonVisualClassName: cn(
+                      numberFieldStepperVariants({
+                        size,
+                        position: "right"
+                      })
+                    ),
+                    "aria-label": incrementAriaLabel ?? "Increase value",
+                    children: /* @__PURE__ */ jsx(Plus, { className: "h-4 w-4", "aria-hidden": "true" })
+                  }
+                )
+              ]
+            }
+          ),
+          description && /* @__PURE__ */ jsx(
+            Text,
+            {
+              slot: "description",
+              className: cn(numberFieldDescriptionVariants({ size })),
+              children: description
+            }
+          ),
+          /* @__PURE__ */ jsx(FieldError, { className: cn(numberFieldErrorVariants({ size })), children: errorMessage })
+        ]
+      }
+    );
+  }
+);
+NumberField.displayName = "NumberField";
+
+export { DEFAULT_MAX_VALUE, DEFAULT_MIN_VALUE, NEGATIVE_MIN_VALUE, NumberField, NumberFieldPropsSchema, numberFieldDescriptionVariants, numberFieldErrorVariants, numberFieldInputVariants, numberFieldLabelVariants, numberFieldStepperVariants, numberFieldVariants };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map