stackkit 0.3.5 → 0.3.6

package/modules/components/files/shared/shadcn/global/form-field/input-field.tsx

@@ -0,0 +1,440 @@
+"use client";
+
+import { Button } from "@/components/ui/button";
+import { Checkbox } from "@/components/ui/checkbox";
+import {
+  Field,
+  FieldContent,
+  FieldDescription,
+  FieldError,
+  FieldLabel,
+} from "@/components/ui/field";
+import {
+  InputGroup,
+  InputGroupAddon,
+  InputGroupInput,
+} from "@/components/ui/input-group";
+import { CloudUpload, Eye, EyeOff, type LucideIcon } from "lucide-react";
+import type { ChangeEvent, HTMLInputTypeAttribute } from "react";
+import * as React from "react";
+import type { FieldPath, FieldValues } from "react-hook-form";
+import { Controller } from "react-hook-form";
+
+// Types
+type ButtonVariant =
+  | "default"
+  | "outline"
+  | "destructive"
+  | "secondary"
+  | "ghost"
+  | "link";
+type ButtonSize = "default" | "sm" | "lg" | "icon";
+
+/** Base props shared across standalone & RHF modes */
+type BaseProps = Omit<
+  React.InputHTMLAttributes<HTMLInputElement>,
+  "onChange" | "type" | "value"
+> & {
+  icon?: LucideIcon;
+  startIcon?: LucideIcon;
+  label?: React.ReactNode;
+  labelNode?: React.ReactNode;
+  disable?: boolean;
+  isDisabled?: boolean;
+  value?: string | number | boolean;
+  defaultValue?: string | number | boolean;
+  requiredMark?: boolean;
+  hint?: React.ReactNode;
+  onChange?: React.ChangeEventHandler<HTMLInputElement>;
+  type?: HTMLInputTypeAttribute;
+  parseNumber?: boolean;
+  preventWheelChange?: boolean;
+  id?: string;
+  className?: string;
+  inputClassName?: string;
+  multiple?: boolean;
+  accept?: string;
+  onFilesChange?: (files: File[] | null) => void;
+  fileIcon?: LucideIcon;
+  fileButtonLabel?: string;
+  fileButtonVariant?: ButtonVariant;
+  fileButtonSize?: ButtonSize;
+};
+
+/** Props for generic + optional RHF name */
+export type InputFieldProps<
+  TFieldValues extends FieldValues = FieldValues,
+  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,
+> = BaseProps & {
+  name?: TName;
+};
+
+// Helpers
+function toTextInputValue(v: unknown): string | number {
+  if (v === null || v === undefined) return "";
+  if (typeof v === "boolean") return v ? "1" : "";
+  if (typeof v === "string" || typeof v === "number") return v;
+  return "";
+}
+
+function makeSyntheticCheckboxChange(
+  checked: boolean,
+): React.ChangeEvent<HTMLInputElement> {
+  const input = document.createElement("input");
+  input.type = "checkbox";
+  input.checked = checked;
+  const evt = new Event("change", { bubbles: true });
+  Object.defineProperty(evt, "target", { writable: false, value: input });
+  return evt as unknown as React.ChangeEvent<HTMLInputElement>;
+}
+
+// Component
+export default function InputField<
+  TFieldValues extends FieldValues = FieldValues,
+  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,
+>({
+  name,
+  icon: LabelIcon,
+  startIcon,
+  label,
+  labelNode,
+  placeholder,
+  type = "text",
+  disabled,
+  isDisabled,
+  disable,
+  className,
+  inputClassName,
+  value,
+  defaultValue,
+  requiredMark,
+  hint,
+  onChange,
+  id,
+  parseNumber,
+  preventWheelChange,
+  multiple,
+  accept,
+  onFilesChange,
+  fileIcon: FileIcon,
+  fileButtonLabel = "Import",
+  fileButtonVariant = "outline",
+  fileButtonSize = "default",
+  ...rest
+}: InputFieldProps<TFieldValues, TName>) {
+  const effectiveDisabled = disabled ?? isDisabled ?? disable ?? false;
+  const isFile = type === "file";
+  const isCheckbox = type === "checkbox";
+  const shouldParseNumber = !isCheckbox && (parseNumber ?? type === "number");
+  const shouldPreventWheel =
+    !isCheckbox && (preventWheelChange ?? shouldParseNumber);
+  const labelContent = labelNode ?? label;
+
+  const hiddenFileRef = React.useRef<HTMLInputElement | null>(null);
+  const chooseFile = React.useCallback(
+    () => hiddenFileRef.current?.click(),
+    [],
+  );
+
+  const [internal, setInternal] = React.useState<
+    string | number | boolean | undefined
+  >(defaultValue);
+
+  const [showPassword, setShowPassword] = React.useState(false);
+  const isPassword = type === "password";
+  const effectiveType =
+    isPassword && showPassword ? ("text" as HTMLInputTypeAttribute) : type;
+
+  const inFormMode = Boolean(name);
+
+  const toNumberIfNeeded = (raw: string): string | number => {
+    if (!shouldParseNumber) return raw;
+    return raw === "" ? "" : Number(raw);
+  };
+
+  const LabelIconEffective: LucideIcon | undefined = startIcon ?? LabelIcon;
+  const FileButtonIcon: LucideIcon = FileIcon ?? CloudUpload;
+
+  if (inFormMode) {
+    // RHF mode using Controller + Field components
+    return (
+      <Controller<TFieldValues, TName>
+        name={name as TName}
+        render={({ field, fieldState }) => {
+          const inputId = id ?? (field.name as string);
+
+          const handleFileChange = (e: ChangeEvent<HTMLInputElement>) => {
+            const fl = e.target.files;
+            field.onChange(fl);
+            onFilesChange?.(fl ? Array.from(fl) : null);
+          };
+
+          const handleChangeTextOrNumber = (
+            e: ChangeEvent<HTMLInputElement>,
+          ) => {
+            const raw = e.target.value;
+            const val = toNumberIfNeeded(raw);
+            field.onChange(val);
+            onChange?.(e);
+          };
+
+          const assignRefs = (el: HTMLInputElement | null) => {
+            hiddenFileRef.current = el;
+            const ref = field.ref as
+              | ((instance: HTMLInputElement | null) => void)
+              | React.MutableRefObject<HTMLInputElement | null>
+              | undefined;
+            if (typeof ref === "function") ref(el);
+            else if (ref && "current" in ref) ref.current = el;
+          };
+
+          return (
+            <Field className={className} data-invalid={fieldState.invalid}>
+              {!isCheckbox && labelContent ? (
+                <FieldLabel
+                  className="mb-2 inline-flex items-center gap-2"
+                  htmlFor={inputId}
+                >
+                  {LabelIcon ? (
+                    <LabelIcon className="h-4 w-4" />
+                  ) : LabelIconEffective ? (
+                    <LabelIconEffective className="h-4 w-4" />
+                  ) : null}
+                  {labelContent}
+                  {requiredMark ? (
+                    <span className="ml-0.5 text-destructive">*</span>
+                  ) : null}
+                </FieldLabel>
+              ) : null}
+
+              <FieldContent>
+                {isFile ? (
+                  <div className="flex items-center gap-2">
+                    <input
+                      id={inputId}
+                      ref={assignRefs}
+                      type="file"
+                      className="hidden"
+                      disabled={effectiveDisabled}
+                      multiple={multiple}
+                      accept={accept}
+                      onChange={handleFileChange}
+                      {...rest}
+                    />
+                    <Button
+                      type="button"
+                      variant={fileButtonVariant}
+                      size={fileButtonSize}
+                      onClick={chooseFile}
+                      disabled={effectiveDisabled}
+                      className="gap-2"
+                    >
+                      <FileButtonIcon className="h-4 w-4" />
+                      {fileButtonLabel}
+                    </Button>
+                  </div>
+                ) : isCheckbox ? (
+                  <div className="flex items-center gap-2">
+                    <Checkbox
+                      id={inputId}
+                      checked={Boolean(field.value)}
+                      onCheckedChange={(v) => field.onChange(Boolean(v))}
+                      disabled={effectiveDisabled}
+                    />
+                    {labelContent ? (
+                      <FieldLabel
+                        htmlFor={inputId}
+                        className="cursor-pointer select-none"
+                      >
+                        {labelContent}
+                        {requiredMark ? (
+                          <span className="ml-0.5 text-destructive">*</span>
+                        ) : null}
+                      </FieldLabel>
+                    ) : null}
+                  </div>
+                ) : (
+                  <InputGroup>
+                    <InputGroupInput
+                      id={inputId}
+                      type={effectiveType}
+                      placeholder={placeholder}
+                      disabled={effectiveDisabled}
+                      value={toTextInputValue(field.value)}
+                      onChange={handleChangeTextOrNumber}
+                      onWheel={
+                        shouldPreventWheel
+                          ? (e) => (e.currentTarget as HTMLInputElement).blur()
+                          : undefined
+                      }
+                      className={inputClassName}
+                      ref={field.ref}
+                      {...rest}
+                    />
+                    {isPassword ? (
+                      <InputGroupAddon align="inline-end">
+                        <Button
+                          type="button"
+                          variant="ghost"
+                          size="icon"
+                          className="h-full px-3 py-2 hover:bg-transparent"
+                          onClick={() => setShowPassword(!showPassword)}
+                          disabled={effectiveDisabled}
+                        >
+                          {showPassword ? (
+                            <EyeOff className="h-4 w-4" />
+                          ) : (
+                            <Eye className="h-4 w-4" />
+                          )}
+                        </Button>
+                      </InputGroupAddon>
+                    ) : null}
+                  </InputGroup>
+                )}
+              </FieldContent>
+
+              {hint ? <FieldDescription>{hint}</FieldDescription> : null}
+              {fieldState.invalid && <FieldError errors={[fieldState.error]} />}
+            </Field>
+          );
+        }}
+      />
+    );
+  }
+
+  // Standalone mode
+  const isControlled = value !== undefined;
+  const currentValue = isControlled ? value : internal;
+
+  const inputId =
+    id ??
+    (typeof label === "string"
+      ? `input-${label.toLowerCase().replace(/\s+/g, "-")}`
+      : undefined);
+
+  const handleStandaloneChange: React.ChangeEventHandler<HTMLInputElement> = (
+    e,
+  ) => {
+    const raw = e.target.value;
+    const val = toNumberIfNeeded(raw);
+    if (!isControlled) setInternal(val);
+    onChange?.(e);
+  };
+
+  const handleStandaloneFileChange: React.ChangeEventHandler<
+    HTMLInputElement
+  > = (e) => {
+    const fl = e.target.files;
+    onFilesChange?.(fl ? Array.from(fl) : null);
+    onChange?.(e);
+  };
+
+  const handleStandaloneCheckboxChange = (checked: boolean) => {
+    if (!isControlled) setInternal(checked);
+    if (onChange) onChange(makeSyntheticCheckboxChange(checked));
+  };
+
+  return (
+    <div className={className}>
+      {!isCheckbox && labelContent ? (
+        <FieldLabel
+          className="mb-2 inline-flex items-center gap-2"
+          htmlFor={inputId}
+        >
+          {LabelIcon ? <LabelIcon className="h-4 w-4" /> : null}
+          {labelContent}
+          {requiredMark ? (
+            <span className="ml-0.5 text-destructive">*</span>
+          ) : null}
+        </FieldLabel>
+      ) : null}
+
+      {isFile ? (
+        <div className="flex items-center gap-2">
+          <input
+            id={inputId}
+            ref={hiddenFileRef}
+            type="file"
+            className="hidden"
+            disabled={effectiveDisabled}
+            multiple={multiple}
+            accept={accept}
+            onChange={handleStandaloneFileChange}
+            {...rest}
+          />
+          <Button
+            type="button"
+            variant={fileButtonVariant}
+            size={fileButtonSize}
+            onClick={chooseFile}
+            disabled={effectiveDisabled}
+            className="gap-2"
+          >
+            <FileButtonIcon className="h-4 w-4" />
+            {fileButtonLabel}
+          </Button>
+        </div>
+      ) : isCheckbox ? (
+        <div className="flex items-center gap-2">
+          <Checkbox
+            id={inputId}
+            checked={Boolean(currentValue)}
+            onCheckedChange={(v) => handleStandaloneCheckboxChange(Boolean(v))}
+            disabled={effectiveDisabled}
+          />
+          {labelContent ? (
+            <FieldLabel
+              htmlFor={inputId}
+              className="cursor-pointer select-none"
+            >
+              {labelContent}
+              {requiredMark ? (
+                <span className="ml-0.5 text-destructive">*</span>
+              ) : null}
+            </FieldLabel>
+          ) : null}
+        </div>
+      ) : (
+        <InputGroup>
+          <InputGroupInput
+            id={inputId}
+            type={effectiveType}
+            placeholder={placeholder}
+            disabled={effectiveDisabled}
+            value={toTextInputValue(currentValue)}
+            onChange={handleStandaloneChange}
+            onWheel={
+              shouldPreventWheel
+                ? (e) => (e.currentTarget as HTMLInputElement).blur()
+                : undefined
+            }
+            className={inputClassName}
+            {...rest}
+          />
+          {isPassword ? (
+            <InputGroupAddon align="inline-end">
+              <Button
+                type="button"
+                variant="ghost"
+                size="icon"
+                className="h-full px-3 py-2 hover:bg-transparent"
+                onClick={() => setShowPassword(!showPassword)}
+                disabled={effectiveDisabled}
+              >
+                {showPassword ? (
+                  <EyeOff className="h-4 w-4" />
+                ) : (
+                  <Eye className="h-4 w-4" />
+                )}
+              </Button>
+            </InputGroupAddon>
+          ) : null}
+        </InputGroup>
+      )}
+
+      {hint ? (
+        <p className="mt-1 text-xs text-muted-foreground">{hint}</p>
+      ) : null}
+    </div>
+  );
+}