@alepha/ui 0.10.5 → 0.10.7

package/src/components/Control.tsx

@@ -1,275 +1,429 @@
-import { TypeBoxError } from "@alepha/core";
-import { type InputField, useFormState } from "@alepha/react-form";
+import { type TObject, TypeBoxError } from "@alepha/core";
 import {
-	Autocomplete,
-	type AutocompleteProps,
-	Flex,
-	Input,
-	PasswordInput,
-	type PasswordInputProps,
-	SegmentedControl,
-	type SegmentedControlProps,
-	Select,
-	type SelectProps,
-	Switch,
-	type SwitchProps,
-	Textarea,
-	type TextareaProps,
-	TextInput,
-	type TextInputProps,
+  type InputField,
+  type UseFormStateReturn,
+  useFormState,
+} from "@alepha/react-form";
+import {
+  Autocomplete,
+  type AutocompleteProps,
+  ColorInput,
+  type ColorInputProps,
+  FileInput,
+  type FileInputProps,
+  Flex,
+  Input,
+  NumberInput,
+  type NumberInputProps,
+  PasswordInput,
+  type PasswordInputProps,
+  SegmentedControl,
+  type SegmentedControlProps,
+  type SelectProps,
+  Switch,
+  type SwitchProps,
+  Textarea,
+  type TextareaProps,
+  TextInput,
+  type TextInputProps,
 } from "@mantine/core";
+import type {
+  DateInputProps,
+  DateTimePickerProps,
+  TimeInputProps,
+} from "@mantine/dates";
 import type { ComponentType, ReactNode } from "react";
+import { getDefaultIcon } from "../utils/icons.tsx";
+import { prettyName } from "../utils/string.ts";
+import ControlDate from "./ControlDate";
+import ControlSelect from "./ControlSelect";
 
-export interface ControlProps {
-	input: InputField;
-
-	title?: string;
-	description?: string;
-
-	icon?: ReactNode;
-
-	text?: TextInputProps;
-	area?: boolean | TextareaProps;
-	select?: boolean | SelectProps;
-	autocomplete?: boolean | AutocompleteProps;
-	password?: boolean | PasswordInputProps;
-	switch?: boolean | SwitchProps;
-	segmented?: boolean | Partial<SegmentedControlProps>;
-
-	custom?: ComponentType<CustomControlProps>;
+export interface ControlProps extends GenericControlProps {
+  text?: TextInputProps;
+  area?: boolean | TextareaProps;
+  select?: boolean | SelectProps;
+  autocomplete?: boolean | AutocompleteProps;
+  password?: boolean | PasswordInputProps;
+  switch?: boolean | SwitchProps;
+  segmented?: boolean | Partial<SegmentedControlProps>;
+  number?: boolean | NumberInputProps;
+  file?: boolean | FileInputProps;
+  color?: boolean | ColorInputProps;
+  date?: boolean | DateInputProps;
+  datetime?: boolean | DateTimePickerProps;
+  time?: boolean | TimeInputProps;
+  custom?: ComponentType<CustomControlProps>;
 }
 
 /**
  * Generic form control that renders the appropriate input based on the schema and props.
  *
  * Supports:
- * - TextInput
+ * - TextInput (with format detection: email, url, tel)
  * - Textarea
+ * - NumberInput (for number/integer types)
+ * - FileInput
+ * - ColorInput (for color format)
  * - Select (for enum types)
  * - Autocomplete
  * - PasswordInput
  * - Switch (for boolean types)
  * - SegmentedControl (for enum types)
+ * - DateInput (for date format)
+ * - DateTimePicker (for date-time format)
+ * - TimeInput (for time format)
  * - Custom component
  *
- * Automatically handles labels, descriptions, error messages, and required state.
+ * Automatically handles labels, descriptions, error messages, required state, and default icons.
  */
 const Control = (props: ControlProps) => {
-	const form = useFormState(props.input);
-	if (!props.input?.props) {
-		return null;
-	}
+  const form = useFormState(props.input);
+  const { inputProps, id, icon } = parseInput(props, form);
+  if (!props.input?.props) {
+    return null;
+  }
+
+  // Extract format once to avoid redeclaration
+  const format =
+    props.input.schema &&
+    "format" in props.input.schema &&
+    typeof props.input.schema.format === "string"
+      ? props.input.schema.format
+      : undefined;
 
-	// shared props
+  //region <Custom/>
+  if (props.custom) {
+    const Custom = props.custom;
+    return (
+      <Input.Wrapper {...inputProps}>
+        <Flex flex={1} mt={"calc(var(--mantine-spacing-xs) / 2)"}>
+          <Custom
+            defaultValue={props.input.props.defaultValue}
+            onChange={(value) => {
+              props.input.set(value);
+            }}
+          />
+        </Flex>
+      </Input.Wrapper>
+    );
+  }
+  //endregion
 
-	const disabled = false; // form.loading;
-	const id = props.input.props.id;
-	const label =
-		props.title ??
-		("title" in props.input.schema &&
-		typeof props.input.schema.title === "string"
-			? props.input.schema.title
-			: undefined) ??
-		prettyName(props.input.path);
-	const description =
-		props.description ??
-		("description" in props.input.schema &&
-		typeof props.input.schema.description === "string"
-			? props.input.schema.description
-			: undefined);
-	const error =
-		form.error && form.error instanceof TypeBoxError
-			? form.error.value.message
-			: undefined;
-	const icon = props.icon;
-	const required = props.input.required;
+  //region <NumberInput/>
+  if (
+    props.number ||
+    (props.input.schema &&
+      "type" in props.input.schema &&
+      (props.input.schema.type === "number" ||
+        props.input.schema.type === "integer"))
+  ) {
+    const numberInputProps =
+      typeof props.number === "object" ? props.number : {};
+    const { type, ...inputPropsWithoutType } = props.input.props;
+    return (
+      <NumberInput
+        {...inputProps}
+        id={id}
+        leftSection={icon}
+        {...inputPropsWithoutType}
+        {...numberInputProps}
+      />
+    );
+  }
+  //endregion
 
-	const inputProps = {
-		label,
-		description,
-		error,
-		required,
-		disabled,
-	};
+  //region <FileInput/>
+  if (props.file) {
+    const fileInputProps = typeof props.file === "object" ? props.file : {};
+    return (
+      <FileInput
+        {...inputProps}
+        id={id}
+        leftSection={icon}
+        onChange={(file) => {
+          props.input.set(file);
+        }}
+        {...fileInputProps}
+      />
+    );
+  }
+  //endregion
 
-	// -------------------------------------------------------------------------------------------------------------------
+  //region <ColorInput/>
+  if (props.color || format === "color") {
+    const colorInputProps = typeof props.color === "object" ? props.color : {};
+    return (
+      <ColorInput
+        {...inputProps}
+        id={id}
+        leftSection={icon}
+        {...props.input.props}
+        {...colorInputProps}
+      />
+    );
+  }
+  //endregion
 
-	if (props.custom) {
-		const Custom = props.custom;
-		return (
-			<Input.Wrapper {...inputProps}>
-				<Flex flex={1} mt={"calc(var(--mantine-spacing-xs) / 2)"}>
-					<Custom
-						defaultValue={props.input.props.defaultValue}
-						onChange={(value) => {
-							props.input.set(value);
-						}}
-					/>
-				</Flex>
-			</Input.Wrapper>
-		);
-	}
+  //region <SegmentedControl/>
+  if (props.segmented) {
+    const segmentedControlProps: Partial<SegmentedControlProps> =
+      typeof props.segmented === "object" ? props.segmented : {};
+    const data =
+      segmentedControlProps.data ??
+      (props.input.schema &&
+      "enum" in props.input.schema &&
+      Array.isArray(props.input.schema.enum)
+        ? props.input.schema.enum?.map((value: string) => ({
+            value,
+            label: value,
+          }))
+        : []);
+    return (
+      <Input.Wrapper {...inputProps}>
+        <Flex mt={"calc(var(--mantine-spacing-xs) / 2)"}>
+          <SegmentedControl
+            disabled={inputProps.disabled}
+            defaultValue={String(props.input.props.defaultValue)}
+            {...segmentedControlProps}
+            onChange={(value) => {
+              props.input.set(value);
+            }}
+            data={data}
+          />
+        </Flex>
+      </Input.Wrapper>
+    );
+  }
+  //endregion
 
-	// region <SegmentedControl/>
-	if (props.segmented) {
-		const segmentedControlProps: Partial<SegmentedControlProps> =
-			typeof props.segmented === "object" ? props.segmented : {};
-		const data =
-			segmentedControlProps.data ??
-			(props.input.schema &&
-			"enum" in props.input.schema &&
-			Array.isArray(props.input.schema.enum)
-				? props.input.schema.enum?.map((value: string) => ({
-						value,
-						label: value,
-					}))
-				: []);
-		return (
-			<Input.Wrapper {...inputProps}>
-				<Flex mt={"calc(var(--mantine-spacing-xs) / 2)"}>
-					<SegmentedControl
-						disabled={disabled}
-						defaultValue={String(props.input.props.defaultValue)}
-						{...segmentedControlProps}
-						onChange={(value) => {
-							props.input.set(value);
-						}}
-						data={data}
-					/>
-				</Flex>
-			</Input.Wrapper>
-		);
-	}
-	// endregion
+  //region <Autocomplete/>
+  if (props.autocomplete) {
+    const autocompleteProps =
+      typeof props.autocomplete === "object" ? props.autocomplete : {};
 
-	// region <Autocomplete/>
-	if (props.autocomplete) {
-		const autocompleteProps =
-			typeof props.autocomplete === "object" ? props.autocomplete : {};
+    return (
+      <Autocomplete
+        {...inputProps}
+        id={id}
+        leftSection={icon}
+        {...props.input.props}
+        {...autocompleteProps}
+      />
+    );
+  }
+  //endregion
 
-		return (
-			<Autocomplete
-				{...inputProps}
-				id={id}
-				leftSection={icon}
-				{...props.input.props}
-				{...autocompleteProps}
-			/>
-		);
-	}
-	// endregion
+  //region <ControlSelect/>
+  // Handle: single enum, array of enum, array of strings, or explicit select/multi/tags props
+  const isEnum =
+    props.input.schema &&
+    "enum" in props.input.schema &&
+    props.input.schema.enum;
+  const isArray =
+    props.input.schema &&
+    "type" in props.input.schema &&
+    props.input.schema.type === "array";
 
-	// region <Select/>
-	if (
-		(props.input.schema &&
-			"enum" in props.input.schema &&
-			props.input.schema.enum) ||
-		props.select
-	) {
-		const data =
-			props.input.schema &&
-			"enum" in props.input.schema &&
-			Array.isArray(props.input.schema.enum)
-				? props.input.schema.enum?.map((value: string) => ({
-						value,
-						label: value,
-					}))
-				: [];
+  if (isEnum || isArray || props.select) {
+    return (
+      <ControlSelect
+        input={props.input}
+        title={props.title}
+        description={props.description}
+        icon={icon}
+        select={props.select}
+      />
+    );
+  }
+  //endregion
 
-		const selectProps = typeof props.select === "object" ? props.select : {};
+  //region <Switch/>
+  if (
+    (props.input.schema &&
+      "type" in props.input.schema &&
+      props.input.schema.type === "boolean") ||
+    props.switch
+  ) {
+    const switchProps = typeof props.switch === "object" ? props.switch : {};
 
-		return (
-			<Select
-				{...inputProps}
-				id={id}
-				leftSection={icon}
-				data={data}
-				{...props.input.props}
-				{...selectProps}
-			/>
-		);
-	}
-	// endregion
+    return (
+      <Switch
+        {...inputProps}
+        id={id}
+        color={"blue"}
+        defaultChecked={props.input.props.defaultValue}
+        {...props.input.props}
+        {...switchProps}
+      />
+    );
+  }
+  //endregion
 
-	// region <Switch/>
+  //region <PasswordInput/>
+  if (props.password || props.input.props.name?.includes("password")) {
+    const passwordInputProps =
+      typeof props.password === "object" ? props.password : {};
+    return (
+      <PasswordInput
+        {...inputProps}
+        id={id}
+        leftSection={icon}
+        {...props.input.props}
+        {...passwordInputProps}
+      />
+    );
+  }
+  //endregion
 
-	if (
-		(props.input.schema &&
-			"type" in props.input.schema &&
-			props.input.schema.type === "boolean") ||
-		props.switch
-	) {
-		const switchProps = typeof props.switch === "object" ? props.switch : {};
+  //region <Textarea/>
+  if (props.area) {
+    const textAreaProps = typeof props.area === "object" ? props.area : {};
+    return (
+      <Textarea
+        {...inputProps}
+        id={id}
+        leftSection={icon}
+        {...props.input.props}
+        {...textAreaProps}
+      />
+    );
+  }
+  //endregion
 
-		return (
-			<Switch
-				{...inputProps}
-				id={id}
-				color={"blue"}
-				defaultChecked={props.input.props.defaultValue}
-				{...props.input.props}
-				{...switchProps}
-			/>
-		);
-	}
-	// endregion
+  //region <ControlDate/>
+  // Handle: date, date-time, and time formats
+  if (
+    props.date ||
+    props.datetime ||
+    props.time ||
+    format === "date" ||
+    format === "date-time" ||
+    format === "time"
+  ) {
+    return (
+      <ControlDate
+        input={props.input}
+        title={props.title}
+        description={props.description}
+        icon={icon}
+        date={props.date}
+        datetime={props.datetime}
+        time={props.time}
+      />
+    );
+  }
+  //endregion
 
-	// region <PasswordInput/>
-	if (props.password) {
-		const passwordInputProps =
-			typeof props.password === "object" ? props.password : {};
-		return (
-			<PasswordInput
-				{...inputProps}
-				id={id}
-				leftSection={icon}
-				{...props.input.props}
-				{...passwordInputProps}
-			/>
-		);
-	}
-	//endregion
+  //region <TextInput/> with format detection
+  const textInputProps = typeof props.text === "object" ? props.text : {};
 
-	//region <Textarea/>
-	if (props.area) {
-		const textAreaProps = typeof props.area === "object" ? props.area : {};
-		return (
-			<Textarea
-				{...inputProps}
-				id={id}
-				leftSection={icon}
-				{...props.input.props}
-				{...textAreaProps}
-			/>
-		);
-	}
-	//endregion
+  // Detect HTML5 input type from format
+  const getInputType = (): string | undefined => {
+    switch (format) {
+      case "email":
+        return "email";
+      case "url":
+      case "uri":
+        return "url";
+      case "tel":
+      case "phone":
+        return "tel";
+      default:
+        return undefined;
+    }
+  };
 
-	// region <TextInput/>
-	const textInputProps = typeof props.text === "object" ? props.text : {};
-	return (
-		<TextInput
-			{...inputProps}
-			id={id}
-			leftSection={icon}
-			{...props.input.props}
-			{...textInputProps}
-		/>
-	);
-	//endregion
+  return (
+    <TextInput
+      {...inputProps}
+      id={id}
+      leftSection={icon}
+      type={getInputType()}
+      {...props.input.props}
+      {...textInputProps}
+    />
+  );
+  //endregion
 };
 
 export default Control;
 
-const prettyName = (name: string) => {
-	return capitalize(name.replaceAll("/", ""));
-};
+// =============================================================================
+// Helper Types and Functions
+// =============================================================================
+
+export interface GenericControlProps {
+  input: InputField;
+  title?: string;
+  description?: string;
+  icon?: ReactNode;
+}
+
+export const parseInput = (
+  props: GenericControlProps,
+  form: UseFormStateReturn<TObject>,
+) => {
+  const disabled = false; // form.loading;
+  const id = props.input.props.id;
+  const label =
+    props.title ??
+    ("title" in props.input.schema &&
+    typeof props.input.schema.title === "string"
+      ? props.input.schema.title
+      : undefined) ??
+    prettyName(props.input.path);
+  const description =
+    props.description ??
+    ("description" in props.input.schema &&
+    typeof props.input.schema.description === "string"
+      ? props.input.schema.description
+      : undefined);
+  const error =
+    form.error && form.error instanceof TypeBoxError
+      ? form.error.value.message
+      : undefined;
+
+  // Auto-generate icon if not provided
+  const icon =
+    props.icon ??
+    getDefaultIcon({
+      type:
+        props.input.schema && "type" in props.input.schema
+          ? String(props.input.schema.type)
+          : undefined,
+      format:
+        props.input.schema &&
+        "format" in props.input.schema &&
+        typeof props.input.schema.format === "string"
+          ? props.input.schema.format
+          : undefined,
+      name: props.input.props.name,
+      isEnum:
+        props.input.schema &&
+        "enum" in props.input.schema &&
+        Boolean(props.input.schema.enum),
+      isArray:
+        props.input.schema &&
+        "type" in props.input.schema &&
+        props.input.schema.type === "array",
+    });
+
+  const required = props.input.required;
 
-const capitalize = (str: string) => {
-	return str.charAt(0).toUpperCase() + str.slice(1);
+  return {
+    id,
+    icon,
+    inputProps: {
+      label,
+      description,
+      error,
+      required,
+      disabled,
+    },
+  };
 };
 
 export type CustomControlProps = {
-	defaultValue: any;
-	onChange: (value: any) => void;
+  defaultValue: any;
+  onChange: (value: any) => void;
 };