@payglocal_ui/flux-ui 0.1.0

package/src/link.tsx

@@ -0,0 +1,80 @@
+"use client";
+
+import * as React from "react";
+import { Slot } from "@radix-ui/react-slot";
+import { cva, type VariantProps } from "class-variance-authority";
+import { cn } from "./utils";
+
+const linkVariants = cva(
+  [
+    "inline-flex items-center gap-1 transition-colors duration-pg-fast ease-pg-standard",
+    "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring/35 rounded-sm",
+    "aria-disabled:cursor-not-allowed aria-disabled:opacity-50 aria-disabled:pointer-events-none",
+  ],
+  {
+    variants: {
+      variant: {
+        default: "text-primary underline-offset-4 hover:underline",
+        subtle: "text-muted-foreground hover:text-foreground",
+        nav: "text-foreground hover:text-primary",
+      },
+      size: {
+        sm: "text-xs",
+        md: "text-sm",
+        lg: "text-base",
+      },
+    },
+    defaultVariants: {
+      variant: "default",
+      size: "md",
+    },
+  }
+);
+
+export interface LinkProps
+  extends React.AnchorHTMLAttributes<HTMLAnchorElement>,
+    VariantProps<typeof linkVariants> {
+  asChild?: boolean;
+}
+
+export const Link = React.forwardRef<HTMLAnchorElement, LinkProps>(
+  (
+    {
+      className,
+      variant,
+      size,
+      asChild = false,
+      href,
+      target,
+      rel,
+      children,
+      ...props
+    },
+    ref
+  ) => {
+    const Comp = asChild ? Slot : "a";
+
+    const isExternal =
+      typeof href === "string" && href.startsWith("http");
+
+    const externalProps = isExternal
+      ? {
+          target: target ?? "_blank",
+          rel: rel ?? "noreferrer",
+        }
+      : { target, rel };
+
+    return (
+      <Comp
+        ref={ref}
+        href={href}
+        className={cn(linkVariants({ variant, size }), className)}
+        {...externalProps}
+        {...props}
+      >
+        {children}
+      </Comp>
+    );
+  }
+);
+Link.displayName = "Link";

package/src/lozenge.tsx

@@ -0,0 +1,61 @@
+"use client";
+
+import { forwardRef, type HTMLAttributes } from "react";
+import { cn } from "./utils";
+
+export interface LozengeProps extends HTMLAttributes<HTMLSpanElement> {
+  variant?: "default" | "inprogress" | "success" | "moved" | "new" | "removed";
+  isBold?: boolean;
+  maxWidth?: number | string;
+}
+
+const variantClasses: Record<NonNullable<LozengeProps["variant"]>, string> = {
+  default: "bg-muted text-muted-foreground",
+  inprogress: "bg-blue-500/15 text-blue-700 dark:text-blue-300",
+  success: "bg-green-500/15 text-green-700 dark:text-green-300",
+  moved: "bg-purple-500/15 text-purple-700 dark:text-purple-300",
+  new: "bg-teal-500/15 text-teal-700 dark:text-teal-300",
+  removed: "bg-red-500/15 text-red-700 dark:text-red-300",
+};
+
+export const Lozenge = forwardRef<HTMLSpanElement, LozengeProps>(
+  (
+    {
+      variant = "default",
+      isBold = false,
+      maxWidth,
+      children,
+      className,
+      style,
+      ...props
+    },
+    ref
+  ) => {
+    return (
+      <span
+        ref={ref}
+        className={cn(
+          "inline-flex items-center rounded-sm px-1.5 py-0.5 text-[10px] font-bold uppercase tracking-wide whitespace-nowrap transition-colors duration-pg-fast ease-pg-standard",
+          variantClasses[variant],
+          isBold && "ring-1 ring-current/30",
+          className
+        )}
+        style={
+          maxWidth !== undefined
+            ? { maxWidth, overflow: "hidden", textOverflow: "ellipsis", ...style }
+            : style
+        }
+        {...props}
+      >
+        <span
+          className={cn(
+            maxWidth !== undefined ? "truncate" : undefined
+          )}
+        >
+          {children}
+        </span>
+      </span>
+    );
+  }
+);
+Lozenge.displayName = "Lozenge";

package/src/menu.tsx

@@ -0,0 +1,146 @@
+"use client";
+
+import { cn } from "./utils";
+import { forwardRef, type AnchorHTMLAttributes, type ButtonHTMLAttributes, type HTMLAttributes, type ReactNode } from "react";
+
+// ─── MenuDivider ─────────────────────────────────────────────────────────────
+
+export const MenuDivider = forwardRef<HTMLHRElement, HTMLAttributes<HTMLHRElement>>(
+  ({ className, ...props }, ref) => (
+    <hr
+      ref={ref}
+      className={cn("h-px bg-border border-none my-1", className)}
+      {...props}
+    />
+  )
+);
+MenuDivider.displayName = "MenuDivider";
+
+// ─── MenuSection ─────────────────────────────────────────────────────────────
+
+export interface MenuSectionProps extends HTMLAttributes<HTMLDivElement> {
+  label?: string;
+  children: ReactNode;
+}
+
+export const MenuSection = forwardRef<HTMLDivElement, MenuSectionProps>(
+  ({ label, children, className, ...props }, ref) => (
+    <div ref={ref} className={cn("flex flex-col", className)} {...props}>
+      {label && (
+        <span className="text-[11px] font-semibold uppercase tracking-wider text-muted-foreground px-2 py-1.5 mt-2 first:mt-0 select-none">
+          {label}
+        </span>
+      )}
+      {children}
+    </div>
+  )
+);
+MenuSection.displayName = "MenuSection";
+
+// ─── MenuItem ────────────────────────────────────────────────────────────────
+
+type MenuItemBaseProps = {
+  icon?: ReactNode;
+  rightContent?: ReactNode;
+  isSelected?: boolean;
+  isDanger?: boolean;
+};
+
+type MenuItemButtonProps = MenuItemBaseProps &
+  ButtonHTMLAttributes<HTMLButtonElement> & {
+    href?: undefined;
+  };
+
+type MenuItemAnchorProps = MenuItemBaseProps &
+  AnchorHTMLAttributes<HTMLAnchorElement> & {
+    href: string;
+  };
+
+export type MenuItemProps = MenuItemButtonProps | MenuItemAnchorProps;
+
+const menuItemBaseClasses =
+  "flex items-center gap-2.5 px-2 py-2 rounded-lg text-sm transition-colors duration-pg-fast ease-pg-standard w-full focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring/35";
+
+export const MenuItem = forwardRef<HTMLButtonElement | HTMLAnchorElement, MenuItemProps>(
+  (props, ref) => {
+    const {
+      icon,
+      rightContent,
+      isSelected,
+      isDanger,
+      children,
+      className,
+      ...rest
+    } = props;
+
+    const resolvedClasses = cn(
+      menuItemBaseClasses,
+      !isDanger && !isSelected && "text-muted-foreground hover:bg-muted hover:text-foreground",
+      isSelected && !isDanger && "bg-muted text-foreground font-medium",
+      isDanger && "text-destructive hover:bg-destructive/10",
+      (rest as { disabled?: boolean }).disabled && "opacity-50 cursor-not-allowed pointer-events-none",
+      className
+    );
+
+    const content = (
+      <>
+        {icon && (
+          <span className="size-4 shrink-0 flex items-center justify-center [&>svg]:size-4">
+            {icon}
+          </span>
+        )}
+        <span className="flex-1 text-left truncate">{children}</span>
+        {rightContent && (
+          <span className="ml-auto shrink-0">{rightContent}</span>
+        )}
+      </>
+    );
+
+    if ("href" in props && props.href !== undefined) {
+      const { href, ...anchorRest } = rest as AnchorHTMLAttributes<HTMLAnchorElement> & { href: string };
+      return (
+        <a
+          ref={ref as React.Ref<HTMLAnchorElement>}
+          href={href}
+          className={resolvedClasses}
+          {...anchorRest}
+        >
+          {content}
+        </a>
+      );
+    }
+
+    const { disabled, ...buttonRest } = rest as ButtonHTMLAttributes<HTMLButtonElement>;
+    return (
+      <button
+        ref={ref as React.Ref<HTMLButtonElement>}
+        type="button"
+        disabled={disabled}
+        className={resolvedClasses}
+        {...buttonRest}
+      >
+        {content}
+      </button>
+    );
+  }
+);
+MenuItem.displayName = "MenuItem";
+
+// ─── Menu ────────────────────────────────────────────────────────────────────
+
+export interface MenuProps extends HTMLAttributes<HTMLElement> {
+  children: ReactNode;
+}
+
+export const Menu = forwardRef<HTMLElement, MenuProps>(
+  ({ children, className, ...props }, ref) => (
+    <nav
+      ref={ref as React.Ref<HTMLElement>}
+      className={cn("flex flex-col", className)}
+      {...props}
+    >
+      {children}
+    </nav>
+  )
+);
+Menu.displayName = "Menu";

package/src/otp-input.tsx

@@ -0,0 +1,117 @@
+"use client";
+
+import * as React from "react";
+import { cn } from "./utils";
+
+export interface OtpInputProps {
+  /** Current OTP value (controlled). */
+  value: string;
+  /** Fires with the full joined string on every change. */
+  onChange: (value: string) => void;
+  /** Number of digit boxes. */
+  length?: number;
+  /** Fired when all boxes are filled. */
+  onComplete?: (value: string) => void;
+  disabled?: boolean;
+  invalid?: boolean;
+  autoFocus?: boolean;
+  "aria-label"?: string;
+}
+
+export function OtpInput({
+  value,
+  onChange,
+  length = 6,
+  onComplete,
+  disabled,
+  invalid,
+  autoFocus,
+  "aria-label": ariaLabel = "One-time passcode",
+}: OtpInputProps) {
+  const refs = React.useRef<Array<HTMLInputElement | null>>([]);
+  const digits = React.useMemo(() => {
+    const arr = value.split("").slice(0, length);
+    return Array.from({ length }, (_, i) => arr[i] ?? "");
+  }, [value, length]);
+
+  const emit = (next: string) => {
+    onChange(next);
+    if (next.length === length && !next.includes(" ")) onComplete?.(next);
+  };
+
+  const setAt = (index: number, char: string) => {
+    const arr = digits.slice();
+    arr[index] = char;
+    emit(arr.join("").replace(/\s+$/g, ""));
+  };
+
+  const handleChange = (index: number, raw: string) => {
+    const onlyDigits = raw.replace(/\D/g, "");
+    if (!onlyDigits) {
+      setAt(index, "");
+      return;
+    }
+    const chars = onlyDigits.split("");
+    const arr = digits.slice();
+    let cursor = index;
+    for (const c of chars) {
+      if (cursor >= length) break;
+      arr[cursor] = c;
+      cursor += 1;
+    }
+    emit(arr.join(""));
+    refs.current[Math.min(cursor, length - 1)]?.focus();
+  };
+
+  const handleKeyDown = (index: number, e: React.KeyboardEvent<HTMLInputElement>) => {
+    if (e.key === "Backspace") {
+      e.preventDefault();
+      if (digits[index]) {
+        setAt(index, "");
+      } else if (index > 0) {
+        refs.current[index - 1]?.focus();
+        setAt(index - 1, "");
+      }
+    } else if (e.key === "ArrowLeft" && index > 0) {
+      refs.current[index - 1]?.focus();
+    } else if (e.key === "ArrowRight" && index < length - 1) {
+      refs.current[index + 1]?.focus();
+    }
+  };
+
+  const handlePaste = (e: React.ClipboardEvent<HTMLInputElement>) => {
+    e.preventDefault();
+    const pasted = e.clipboardData.getData("text").replace(/\D/g, "").slice(0, length);
+    if (!pasted) return;
+    emit(pasted);
+    refs.current[Math.min(pasted.length, length - 1)]?.focus();
+  };
+
+  return (
+    <div className="flex gap-2" role="group" aria-label={ariaLabel}>
+      {digits.map((digit, i) => (
+        <input
+          key={i}
+          ref={(el) => { refs.current[i] = el; }}
+          type="text"
+          inputMode="numeric"
+          autoComplete={i === 0 ? "one-time-code" : "off"}
+          maxLength={length}
+          value={digit}
+          disabled={disabled}
+          aria-invalid={invalid || undefined}
+          autoFocus={autoFocus && i === 0}
+          onChange={(e) => handleChange(i, e.target.value)}
+          onKeyDown={(e) => handleKeyDown(i, e)}
+          onPaste={handlePaste}
+          className={cn(
+            "h-12 w-11 rounded-lg border bg-card text-center text-lg font-semibold text-foreground shadow-sm transition-colors",
+            "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring/35 focus-visible:border-primary",
+            "disabled:cursor-not-allowed disabled:opacity-50",
+            invalid ? "border-destructive ring-destructive/20" : "border-input"
+          )}
+        />
+      ))}
+    </div>
+  );
+}

package/src/page-header.tsx

@@ -0,0 +1,28 @@
+import type { ReactNode } from "react";
+import { cn } from "./utils";
+
+interface PageHeaderProps {
+  title: ReactNode;
+  /** When title is non-plain text (e.g. includes a flag), set for screen readers. */
+  titleAriaLabel?: string;
+  subtitle?: string;
+  actions?: ReactNode;
+  className?: string;
+}
+
+export function PageHeader({ title, titleAriaLabel, subtitle, actions, className }: PageHeaderProps) {
+  return (
+    <div className={cn("flex items-start justify-between mb-6", className)}>
+      <div>
+        <h1
+          className="text-xl font-semibold text-foreground tracking-tight flex items-center gap-2.5 flex-wrap"
+          {...(titleAriaLabel ? { "aria-label": titleAriaLabel } : {})}
+        >
+          {title}
+        </h1>
+        {subtitle && <p className="text-sm text-muted-foreground mt-0.5">{subtitle}</p>}
+      </div>
+      {actions && <div className="flex items-center gap-2">{actions}</div>}
+    </div>
+  );
+}

package/src/pagination.tsx

@@ -0,0 +1,185 @@
+"use client";
+
+import { forwardRef } from "react";
+import { ChevronLeft, ChevronRight, MoreHorizontal } from "lucide-react";
+import { cn } from "./utils";
+
+// ---------------------------------------------------------------------------
+// Pagination (nav wrapper)
+// ---------------------------------------------------------------------------
+
+export interface PaginationProps extends React.ComponentPropsWithoutRef<"nav"> {}
+
+export const Pagination = forwardRef<HTMLElement, PaginationProps>(
+  ({ className, ...props }, ref) => (
+    <nav
+      ref={ref}
+      role="navigation"
+      aria-label="pagination"
+      className={cn("mx-auto flex w-full justify-center", className)}
+      {...props}
+    />
+  )
+);
+Pagination.displayName = "Pagination";
+
+// ---------------------------------------------------------------------------
+// PaginationContent (ul)
+// ---------------------------------------------------------------------------
+
+export interface PaginationContentProps
+  extends React.ComponentPropsWithoutRef<"ul"> {}
+
+export const PaginationContent = forwardRef<
+  HTMLUListElement,
+  PaginationContentProps
+>(({ className, ...props }, ref) => (
+  <ul
+    ref={ref}
+    className={cn("flex flex-row items-center gap-1", className)}
+    {...props}
+  />
+));
+PaginationContent.displayName = "PaginationContent";
+
+// ---------------------------------------------------------------------------
+// PaginationItem (li)
+// ---------------------------------------------------------------------------
+
+export interface PaginationItemProps
+  extends React.ComponentPropsWithoutRef<"li"> {}
+
+export const PaginationItem = forwardRef<HTMLLIElement, PaginationItemProps>(
+  ({ className, ...props }, ref) => (
+    <li ref={ref} className={cn("list-none", className)} {...props} />
+  )
+);
+PaginationItem.displayName = "PaginationItem";
+
+// ---------------------------------------------------------------------------
+// PaginationLink (anchor / button-like)
+// ---------------------------------------------------------------------------
+
+export interface PaginationLinkProps
+  extends React.ComponentPropsWithoutRef<"a"> {
+  isActive?: boolean;
+}
+
+export const PaginationLink = forwardRef<HTMLAnchorElement, PaginationLinkProps>(
+  ({ className, isActive = false, ...props }, ref) => (
+    <a
+      ref={ref}
+      aria-current={isActive ? "page" : undefined}
+      className={cn(
+        // base
+        "h-9 w-9 inline-flex items-center justify-center rounded-lg text-sm font-medium border",
+        "transition-colors duration-pg-fast ease-pg-standard",
+        "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring/35",
+        "cursor-pointer select-none",
+        // active
+        isActive
+          ? "bg-primary text-primary-foreground border-primary shadow-sm"
+          : "text-muted-foreground border-border hover:bg-muted hover:text-foreground",
+        className
+      )}
+      {...props}
+    />
+  )
+);
+PaginationLink.displayName = "PaginationLink";
+
+// ---------------------------------------------------------------------------
+// PaginationPrevious
+// ---------------------------------------------------------------------------
+
+export interface PaginationPreviousProps
+  extends React.ComponentPropsWithoutRef<"a"> {
+  disabled?: boolean;
+}
+
+export const PaginationPrevious = forwardRef<
+  HTMLAnchorElement,
+  PaginationPreviousProps
+>(({ className, disabled, ...props }, ref) => (
+  <a
+    ref={ref}
+    aria-label="Go to previous page"
+    aria-disabled={disabled}
+    className={cn(
+      "h-9 px-3 inline-flex items-center justify-center gap-1.5 rounded-lg text-sm font-medium border border-border",
+      "transition-colors duration-pg-fast ease-pg-standard",
+      "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring/35",
+      "cursor-pointer select-none",
+      disabled
+        ? "cursor-not-allowed opacity-50 pointer-events-none text-muted-foreground border-border"
+        : "text-muted-foreground hover:bg-muted hover:text-foreground",
+      className
+    )}
+    {...props}
+  >
+    <ChevronLeft className="size-4" />
+    <span>Previous</span>
+  </a>
+));
+PaginationPrevious.displayName = "PaginationPrevious";
+
+// ---------------------------------------------------------------------------
+// PaginationNext
+// ---------------------------------------------------------------------------
+
+export interface PaginationNextProps
+  extends React.ComponentPropsWithoutRef<"a"> {
+  disabled?: boolean;
+}
+
+export const PaginationNext = forwardRef<
+  HTMLAnchorElement,
+  PaginationNextProps
+>(({ className, disabled, ...props }, ref) => (
+  <a
+    ref={ref}
+    aria-label="Go to next page"
+    aria-disabled={disabled}
+    className={cn(
+      "h-9 px-3 inline-flex items-center justify-center gap-1.5 rounded-lg text-sm font-medium border border-border",
+      "transition-colors duration-pg-fast ease-pg-standard",
+      "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring/35",
+      "cursor-pointer select-none",
+      disabled
+        ? "cursor-not-allowed opacity-50 pointer-events-none text-muted-foreground border-border"
+        : "text-muted-foreground hover:bg-muted hover:text-foreground",
+      className
+    )}
+    {...props}
+  >
+    <span>Next</span>
+    <ChevronRight className="size-4" />
+  </a>
+));
+PaginationNext.displayName = "PaginationNext";
+
+// ---------------------------------------------------------------------------
+// PaginationEllipsis
+// ---------------------------------------------------------------------------
+
+export interface PaginationEllipsisProps
+  extends React.ComponentPropsWithoutRef<"span"> {}
+
+export const PaginationEllipsis = forwardRef<
+  HTMLSpanElement,
+  PaginationEllipsisProps
+>(({ className, ...props }, ref) => (
+  <span
+    ref={ref}
+    aria-hidden
+    className={cn(
+      "h-9 w-9 inline-flex items-center justify-center text-muted-foreground",
+      className
+    )}
+    {...props}
+  >
+    <MoreHorizontal className="size-4" />
+    <span className="sr-only">More pages</span>
+  </span>
+));
+PaginationEllipsis.displayName = "PaginationEllipsis";

package/src/password-input.tsx

@@ -0,0 +1,34 @@
+"use client";
+
+import * as React from "react";
+import { Eye, EyeOff } from "lucide-react";
+import { cn } from "./utils";
+import { Input } from "./input";
+
+export type PasswordInputProps = Omit<React.ComponentProps<typeof Input>, "type">;
+
+export const PasswordInput = React.forwardRef<HTMLInputElement, PasswordInputProps>(
+  ({ className, ...props }, ref) => {
+    const [visible, setVisible] = React.useState(false);
+    return (
+      <div className="relative">
+        <Input
+          ref={ref}
+          type={visible ? "text" : "password"}
+          className={cn("pr-10", className)}
+          {...props}
+        />
+        <button
+          type="button"
+          onClick={() => setVisible((v) => !v)}
+          aria-label={visible ? "Hide password" : "Show password"}
+          tabIndex={-1}
+          className="absolute inset-y-0 right-0 flex w-10 items-center justify-center text-muted-foreground transition-colors hover:text-foreground"
+        >
+          {visible ? <EyeOff size={16} /> : <Eye size={16} />}
+        </button>
+      </div>
+    );
+  }
+);
+PasswordInput.displayName = "PasswordInput";

package/src/popover.tsx

@@ -0,0 +1,31 @@
+"use client";
+
+import * as React from "react";
+import * as PopoverPrimitive from "@radix-ui/react-popover";
+import { cn } from "./utils";
+
+const Popover = PopoverPrimitive.Root;
+const PopoverTrigger = PopoverPrimitive.Trigger;
+const PopoverAnchor = PopoverPrimitive.Anchor;
+
+const PopoverContent = React.forwardRef<
+  React.ElementRef<typeof PopoverPrimitive.Content>,
+  React.ComponentPropsWithoutRef<typeof PopoverPrimitive.Content>
+>(({ className, align = "center", sideOffset = 6, ...props }, ref) => (
+  <PopoverPrimitive.Portal>
+    <PopoverPrimitive.Content
+      ref={ref}
+      align={align}
+      sideOffset={sideOffset}
+      className={cn(
+        "z-[120] w-72 rounded-xl border border-border bg-popover p-4 text-popover-foreground shadow-lg outline-none",
+        "data-[state=open]:opacity-100 data-[state=closed]:opacity-0 transition-opacity duration-150",
+        className
+      )}
+      {...props}
+    />
+  </PopoverPrimitive.Portal>
+));
+PopoverContent.displayName = PopoverPrimitive.Content.displayName;
+
+export { Popover, PopoverTrigger, PopoverContent, PopoverAnchor };