@uniform-ts/core 0.0.0 → 0.0.2

package/README.md

@@ -468,7 +468,26 @@ const schema = z.object({
 
 Zod still validates the array (`.min(1)` etc.) — only the _render_ is taken over by your component.
 
-#### Option 2 — Named key in the registry
+#### Option 2 — String field as select
+
+A `z.string()` field can be rendered as a select by setting `meta.component: 'select'` together with `meta.options`. UniForm treats it as type `"select"` during introspection:
+
+```ts
+const schema = z.object({
+  role: z.string().meta({
+    component: 'select',
+    options: [
+      { label: 'User', value: 'user' },
+      { label: 'Admin', value: 'admin' },
+      { label: 'Editor', value: 'editor' },
+    ],
+  }),
+})
+```
+
+This is an alternative to `z.enum(...)` — useful when the option list is dynamic or when you need a plain `string` output type rather than a union literal.
+
+#### Option 3 — Named key in the registry
 
 Register a component under a custom string key — either in `createAutoForm` or the `components` prop — then reference it with `meta.component: 'yourKey'`:
 

package/dist/index.d.mts

@@ -181,6 +181,26 @@ type FieldConfigBase = {
     required: boolean;
     /** Merged UI metadata for the field. */
     meta: FieldMeta;
+    /**
+     * The original Zod schema for this field, after transparent wrappers
+     * (`optional`, `nullable`, `default`, `pipe`) have been stripped.
+     *
+     * This is a general escape hatch for custom components that need to inspect
+     * the raw schema — for example, to read union variants, access custom Zod
+     * metadata not captured by introspection, or build schema-aware validation UI.
+     *
+     * @example
+     * function MyUnionInput({ field }: FieldProps) {
+     *   // Inspect the original schema for any edge case
+     *   const schema = field.schema
+     *   if (schema._zod.def.type === 'union') {
+     *     const variants = (schema._zod.def as z.$ZodUnionDef).options
+     *     // render a type-switcher using the raw Zod variants
+     *   }
+     *   return <input ... />
+     * }
+     */
+    schema: z.$ZodType;
 };
 /**
  * The fully resolved configuration for a single form field, produced by
@@ -256,6 +276,12 @@ type FieldProps = {
     options?: SelectOption[];
     /** Full field metadata, including any custom keys. */
     meta: FieldMeta;
+    /**
+     * The original Zod schema for this field (after transparent wrappers are stripped).
+     * Use this as an escape hatch when you need capabilities beyond what `FieldConfig`
+     * exposes — e.g. inspecting union variants, accessing custom Zod refinements, etc.
+     */
+    schema: z.$ZodType;
 };
 /**
  * A map of field type keys to React components used to render them.

package/dist/index.d.ts

@@ -181,6 +181,26 @@ type FieldConfigBase = {
     required: boolean;
     /** Merged UI metadata for the field. */
     meta: FieldMeta;
+    /**
+     * The original Zod schema for this field, after transparent wrappers
+     * (`optional`, `nullable`, `default`, `pipe`) have been stripped.
+     *
+     * This is a general escape hatch for custom components that need to inspect
+     * the raw schema — for example, to read union variants, access custom Zod
+     * metadata not captured by introspection, or build schema-aware validation UI.
+     *
+     * @example
+     * function MyUnionInput({ field }: FieldProps) {
+     *   // Inspect the original schema for any edge case
+     *   const schema = field.schema
+     *   if (schema._zod.def.type === 'union') {
+     *     const variants = (schema._zod.def as z.$ZodUnionDef).options
+     *     // render a type-switcher using the raw Zod variants
+     *   }
+     *   return <input ... />
+     * }
+     */
+    schema: z.$ZodType;
 };
 /**
  * The fully resolved configuration for a single form field, produced by
@@ -256,6 +276,12 @@ type FieldProps = {
     options?: SelectOption[];
     /** Full field metadata, including any custom keys. */
     meta: FieldMeta;
+    /**
+     * The original Zod schema for this field (after transparent wrappers are stripped).
+     * Use this as an escape hatch when you need capabilities beyond what `FieldConfig`
+     * exposes — e.g. inspecting union variants, accessing custom Zod refinements, etc.
+     */
+    schema: z.$ZodType;
 };
 /**
  * A map of field type keys to React components used to render them.

package/dist/index.js

@@ -83,25 +83,30 @@ function introspectSchema(schema, name = "", parentPath = "") {
   let maxItems;
   try {
     if (kind === "string") {
-      type = "string";
-      const defFormat = def.format;
-      if (defFormat === "email") {
-        mergedMeta["inputType"] = "email";
-      } else if (defFormat === "url") {
-        mergedMeta["inputType"] = "url";
-      } else if (defFormat === "uuid") {
-        mergedMeta["inputType"] = "uuid";
+      if (mergedMeta.component === "select" && Array.isArray(mergedMeta.options) && mergedMeta.options.length > 0) {
+        type = "select";
+        options = mergedMeta.options;
       } else {
-        const checks = def.checks ?? [];
-        const hasFormat = (fmt) => checks.some(
-          (c) => c._zod.def.check === "string_format" && c._zod.def.format === fmt
-        );
-        if (hasFormat("email")) {
+        type = "string";
+        const defFormat = def.format;
+        if (defFormat === "email") {
           mergedMeta["inputType"] = "email";
-        } else if (hasFormat("url")) {
+        } else if (defFormat === "url") {
           mergedMeta["inputType"] = "url";
-        } else if (hasFormat("uuid")) {
+        } else if (defFormat === "uuid") {
           mergedMeta["inputType"] = "uuid";
+        } else {
+          const checks = def.checks ?? [];
+          const hasFormat = (fmt) => checks.some(
+            (c) => c._zod.def.check === "string_format" && c._zod.def.format === fmt
+          );
+          if (hasFormat("email")) {
+            mergedMeta["inputType"] = "email";
+          } else if (hasFormat("url")) {
+            mergedMeta["inputType"] = "url";
+          } else if (hasFormat("uuid")) {
+            mergedMeta["inputType"] = "uuid";
+          }
         }
       }
     } else if (kind === "number") {
@@ -138,15 +143,24 @@ function introspectSchema(schema, name = "", parentPath = "") {
         }
       }
     } else if (def.type === "union") {
-      type = "union";
       const unionDef = def;
+      const variants = unionDef.options;
       if ("discriminator" in unionDef) {
+        type = "union";
         discriminatorKey = unionDef.discriminator;
+        unionVariants = variants.map(
+          (variant, i) => introspectSchema(variant, String(i), path)
+        );
+      } else {
+        const collapsed = introspectSchema(variants[0], name, parentPath);
+        return {
+          ...collapsed,
+          name: path,
+          label,
+          meta: { ...collapsed.meta, ...mergedMeta },
+          schema: inner
+        };
       }
-      const variants = unionDef.options;
-      unionVariants = variants.map(
-        (variant, i) => introspectSchema(variant, String(i), path)
-      );
     }
   } catch {
     type = "unknown";
@@ -157,6 +171,7 @@ function introspectSchema(schema, name = "", parentPath = "") {
     label,
     required,
     meta: mergedMeta,
+    schema: inner,
     ...options !== void 0 && { options },
     ...children !== void 0 && { children },
     ...itemConfig !== void 0 && { itemConfig },
@@ -195,6 +210,7 @@ function parseDiscriminatedUnionMeta(schema) {
     label: deriveLabel(discriminatorKey),
     required: true,
     meta: {},
+    schema,
     options: discriminatorOptions
   };
   return {
@@ -495,7 +511,7 @@ function ScalarField({
           onChange: (value) => {
             const coerced = coerceValue(field.type, value, coercions);
             rhfField.onChange(coerced);
-            field.meta.onChange?.(coerced, formMethods);
+            void field.meta.onChange?.(coerced, formMethods);
           },
           onBlur: rhfField.onBlur,
           ref: rhfField.ref,
@@ -505,7 +521,9 @@ function ScalarField({
           error: fieldState.error?.message,
           required: field.required,
           disabled: field.meta.disabled || contextDisabled,
-          meta: field.meta
+          options: field.meta.options,
+          meta: field.meta,
+          schema: field.schema
         }
       )
     }
@@ -537,7 +555,7 @@ function BooleanField({
           value: rhfField.value ?? false,
           onChange: (value) => {
             rhfField.onChange(value);
-            field.meta.onChange?.(value, formMethods);
+            void field.meta.onChange?.(value, formMethods);
           },
           onBlur: rhfField.onBlur,
           ref: rhfField.ref,
@@ -547,7 +565,8 @@ function BooleanField({
           error: fieldState.error?.message,
           required: field.required,
           disabled: field.meta.disabled || rhfField.disabled || contextDisabled,
-          meta: field.meta
+          meta: field.meta,
+          schema: field.schema
         }
       )
     }
@@ -579,7 +598,7 @@ function SelectField({
           value: rhfField.value ?? "",
           onChange: (value) => {
             rhfField.onChange(value);
-            field.meta.onChange?.(value, formMethods);
+            void field.meta.onChange?.(value, formMethods);
           },
           onBlur: rhfField.onBlur,
           ref: rhfField.ref,
@@ -590,7 +609,8 @@ function SelectField({
           required: field.required,
           disabled: field.meta.disabled || contextDisabled,
           options: field.options,
-          meta: field.meta
+          meta: field.meta,
+          schema: field.schema
         }
       )
     }