feature: add extracgin options from z.array(z.enum([]) and z.enum([])…

API.md

@@ -1,9 +1,16 @@
 # API
 
-- [createTsForm](#createtsform)
-- [createUniqueFieldSchema](#createuniquefieldschema)
-- [FormComponent](#formcomponent)
-- [Hooks](#hooks)
+- [API](#api)
+  - [createTsForm](#createtsform)
+    - [createTsForm params](#createtsform-params)
+  - [createUniqueFieldSchema](#createuniquefieldschema)
+  - [FormComponent](#formcomponent)
+    - [Props](#props)
+  - [Hooks](#hooks)
+    - [`useTsController`](#usetscontroller)
+    - [`useDescription`](#usedescription)
+    - [`useReqDescription`](#usereqdescription)
+    - [`useEnumValues` (**deprecated**, don't use)](#useenumvalues-deprecated-dont-use)
 
 ## createTsForm
 
@@ -205,3 +212,22 @@ const FormSchema = z.object({
   favoriteColor: z.enum(["red", "green", "blue"]),
 });
 ```
+
+It can be used to extract the enum values passed to `z.enum()` from array of enums:
+
+```tsx
+function MyDropdown() {
+  const values = useEnumValues(); // ['red', 'green', 'blue']
+  return (
+    <select>
+      {values.map((e) => {
+        //...
+      })}
+    </select>
+  );
+}
+
+const FormSchema = z.object({
+  favoriteColors: z.array(z.enum(["red", "green", "blue"])),
+});
+```

src/__tests__/getMetaInformationForZodType.test.ts

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import {
+  getEnumValues,
   getMetaInformationForZodType,
   SPLIT_DESCRIPTION_SYMBOL,
 } from "../getMetaInformationForZodType";
@@ -58,4 +59,24 @@ describe("getMetaInformationForZodType", () => {
       placeholder: undefined,
     });
   });
+
+  it("should get the enum values if the schema is an enum", () => {
+    const result = getEnumValues(z.enum(["a", "b", "c"]));
+    expect(result).toStrictEqual(["a", "b", "c"]);
+  })
+
+  it("should get the enum values if the schema is an array of enums", () => {
+    const result = getEnumValues(z.array(z.enum(["a", "b", "c"])));
+    expect(result).toStrictEqual(["a", "b", "c"]);
+  })
+
+  it("should get the enum values if the schema is an array of enums 2", () => {
+    const result = getEnumValues(z.enum(["a", "b", "c"]).array());
+    expect(result).toStrictEqual(["a", "b", "c"]);
+  })
+
+  it("should return undefined if the schema is not an enum", () => {
+    const result = getEnumValues(z.string());
+    expect(result).toBeUndefined();
+  })
 });

src/getMetaInformationForZodType.ts

@@ -16,7 +16,8 @@ export function parseDescription(description?: string) {
   };
 }
 
-export function getEnumValues(type: RTFSupportedZodTypes) {
+export function getEnumValues(type: RTFSupportedZodTypes): readonly string[] | undefined {
+  if (type._def.typeName === z.ZodFirstPartyTypeKind.ZodArray) return getEnumValues(type._def.type)
   if (!(type._def.typeName === z.ZodFirstPartyTypeKind.ZodEnum)) return;
   return type._def.values as readonly string[];
 }

www/docs/api/api-docs/hooks/useenumvalues.md

@@ -23,3 +23,22 @@ const FormSchema = z.object({
   favoriteColor: z.enum(["red", "green", "blue"]),
 });
 ```
+
+It can be used to extract the enum values passed to `z.enum()` from array of enums:
+
+```tsx
+function MyDropdown() {
+  const values = useEnumValues(); // ['red', 'green', 'blue']
+  return (
+    <select multiple>
+      {values.map((e) => {
+        //...
+      })}
+    </select>
+  );
+}
+
+const FormSchema = z.object({
+  favoriteColors: z.array(z.enum(["red", "green", "blue"])),
+});
+```