feat: add FormSwitchInput component with RHF integration and Storybook

Author: Rusaln

.idea/.gitignore

@@ -0,0 +1,47 @@
+import React from "react";
+import { Meta, StoryFn } from "@storybook/react";
+import { useForm, FormProvider } from "react-hook-form";
+import FormSwitchInput, { SwitchInputProps } from "./form-switch";
+
+interface Option {
+  id: number;
+  name: string;
+}
+
+export default {
+  title: "Components/Form/SwitchInput",
+  component: FormSwitchInput,
+} as Meta;
+
+const Template: StoryFn<SwitchInputProps<Option> & { name: string }> = (
+  args
+) => {
+  const methods = useForm({
+    defaultValues: {
+      switchField: [],
+    },
+  });
+
+  return (
+    <FormProvider {...methods}>
+      <form>
+        <FormSwitchInput {...args} />
+      </form>
+    </FormProvider>
+  );
+};
+
+export const Default = Template.bind({});
+Default.args = {
+  label: "Toggle options",
+  name: "switchField",
+  options: [
+    { id: 1, name: "Option A" },
+    { id: 2, name: "Option B" },
+    { id: 3, name: "Option C" },
+  ],
+  keyValue: "id",
+  keyExtractor: (option) => option.id.toString(),
+  renderOption: (option) => option.name,
+  testId: "switch-input",
+};

.idea/codeStyles/Project.xml

@@ -0,0 +1,132 @@
+"use client";
+
+import {
+  Controller,
+  ControllerProps,
+  FieldPath,
+  FieldValues,
+} from "react-hook-form";
+
+import FormControl from "@mui/material/FormControl";
+import FormHelperText from "@mui/material/FormHelperText";
+import FormLabel from "@mui/material/FormLabel";
+import FormControlLabel from "@mui/material/FormControlLabel";
+import FormGroup from "@mui/material/FormGroup";
+import Switch from "@mui/material/Switch";
+import { ForwardedRef, forwardRef } from "react";
+
+export type SwitchInputProps<T> = {
+  label: string;
+  autoFocus?: boolean;
+  disabled?: boolean;
+  readOnly?: boolean;
+  error?: string;
+  testId?: string;
+  keyValue: keyof T;
+  options: T[];
+  keyExtractor: (option: T) => string;
+  renderOption: (option: T) => React.ReactNode;
+};
+
+function SwitchInputRaw<T>(
+  props: SwitchInputProps<T> & {
+    name: string;
+    value: T[] | undefined | null;
+    onChange: (value: T[]) => void;
+    onBlur: () => void;
+  },
+  ref?: ForwardedRef<HTMLDivElement | null>
+) {
+  const value = props.value ?? [];
+
+  const onChange = (switchValue: T) => () => {
+    const isExist = value
+      .map((option) => option[props.keyValue])
+      .includes(switchValue[props.keyValue]);
+
+    const newValue = isExist
+      ? value.filter(
+          (option) => option[props.keyValue] !== switchValue[props.keyValue]
+        )
+      : [...value, switchValue];
+
+    props.onChange(newValue);
+  };
+
+  return (
+    <FormControl
+      component="fieldset"
+      variant="standard"
+      error={!!props.error}
+      data-testid={props.testId}
+    >
+      <FormLabel component="legend" data-testid={`${props.testId}-label`}>
+        {props.label}
+      </FormLabel>
+      <FormGroup ref={ref}>
+        {props.options.map((option) => (
+          <FormControlLabel
+            key={props.keyExtractor(option)}
+            control={
+              <Switch
+                checked={value
+                  .map((val) => val[props.keyValue])
+                  .includes(option[props.keyValue])}
+                onChange={onChange(option)}
+                name={props.name}
+                data-testid={`${props.testId}-${props.keyExtractor(option)}`}
+              />
+            }
+            label={props.renderOption(option)}
+          />
+        ))}
+      </FormGroup>
+      {!!props.error && (
+        <FormHelperText data-testid={`${props.testId}-error`}>
+          {props.error}
+        </FormHelperText>
+      )}
+    </FormControl>
+  );
+}
+
+const SwitchInput = forwardRef(SwitchInputRaw) as never as <T>(
+  props: SwitchInputProps<T> & {
+    name: string;
+    value: T[] | undefined | null;
+    onChange: (value: T[]) => void;
+    onBlur: () => void;
+  } & { ref?: ForwardedRef<HTMLDivElement | null> }
+) => ReturnType<typeof SwitchInputRaw>;
+
+function FormSwitchInput<
+  TFieldValues extends FieldValues = FieldValues,
+  T = unknown,
+  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,
+>(
+  props: SwitchInputProps<T> &
+    Pick<ControllerProps<TFieldValues, TName>, "name" | "defaultValue">
+) {
+  return (
+    <Controller
+      name={props.name}
+      defaultValue={props.defaultValue}
+      render={({ field, fieldState }) => (
+        <SwitchInput<T>
+          {...field}
+          label={props.label}
+          error={fieldState.error?.message}
+          disabled={props.disabled}
+          readOnly={props.readOnly}
+          testId={props.testId}
+          options={props.options}
+          keyValue={props.keyValue}
+          keyExtractor={props.keyExtractor}
+          renderOption={props.renderOption}
+        />
+      )}
+    />
+  );
+}
+
+export default FormSwitchInput;