feat: add timepicker component

Signed-off-by: ayushnirwal <53055971+ayushnirwal@users.noreply.github.com>

Author: ayushnirwal

packages/frappe-ui-react/src/components/timePicker/index.ts

@@ -0,0 +1,2 @@
+export { default as TimePicker } from "./timePicker";
+export * from "./types";

packages/frappe-ui-react/src/components/timePicker/timePicker.stories.tsx

@@ -0,0 +1,198 @@
+import type { Meta, StoryObj } from "@storybook/react-vite";
+import { useState } from "react";
+
+import TimePicker from "./timePicker";
+
+export default {
+  title: "Components/TimePicker",
+  component: TimePicker,
+  argTypes: {
+    value: {
+      control: "text",
+      description: "The time value (HH:MM format)",
+    },
+    interval: {
+      control: "number",
+      description: "Time interval in minutes for generated options",
+    },
+    variant: {
+      control: {
+        type: "select",
+        options: ["outline", "subtle"],
+      },
+      description: "Visual variant of the input",
+    },
+    allowCustom: {
+      control: "boolean",
+      description: "Allow custom time input",
+    },
+    autoClose: {
+      control: "boolean",
+      description: "Auto close on selection",
+    },
+    use12Hour: {
+      control: "boolean",
+      description: "Use 12-hour format",
+    },
+    disabled: {
+      control: "boolean",
+      description: "Disable the input",
+    },
+    placement: {
+      control: "select",
+      options: [
+        "bottom-start",
+        "bottom-end",
+        "top-start",
+        "top-end",
+        "right-start",
+        "right-end",
+        "left-start",
+        "left-end",
+      ],
+      description: "Popover placement",
+    },
+    scrollMode: {
+      control: {
+        type: "select",
+        options: ["center", "start", "nearest"],
+      },
+      description: "Scroll behavior when opening",
+    },
+    minTime: {
+      control: "text",
+      description: "Minimum time (HH:MM)",
+    },
+    maxTime: {
+      control: "text",
+      description: "Maximum time (HH:MM)",
+    },
+    placeholder: {
+      control: "text",
+      description: "Placeholder text",
+    },
+    prefix: {
+      control: false,
+      description: "Prefix element",
+    },
+    suffix: {
+      control: false,
+      description: "Suffix element",
+    },
+    options: {
+      control: "object",
+      description: "Custom time options",
+    },
+  },
+  parameters: {
+    docs: {
+      source: {
+        type: "dynamic",
+      },
+    },
+    layout: "centered",
+  },
+  tags: ["autodocs"],
+} as Meta<typeof TimePicker>;
+
+type Story = StoryObj<typeof TimePicker>;
+
+export const Basic: Story = {
+  render: (args) => {
+    const [value, setValue] = useState("");
+
+    return (
+      <div className="p-2 space-y-2">
+        <TimePicker {...args} value={value} onChange={setValue} />
+        <div className="text-xs text-ink-gray-6">Value: {value || "—"}</div>
+      </div>
+    );
+  },
+  args: {
+    placeholder: "Select time",
+    interval: 15,
+    allowCustom: true,
+    autoClose: true,
+    use12Hour: true,
+    variant: "subtle",
+    placement: "bottom-start",
+    scrollMode: "center",
+  },
+};
+
+export const TwentyFourHourFormat: Story = {
+  render: (args) => {
+    const [value, setValue] = useState("13:30");
+
+    return (
+      <div className="p-2 space-y-2">
+        <TimePicker {...args} value={value} onChange={setValue} />
+        <div className="text-xs text-ink-gray-6">Value: {value}</div>
+      </div>
+    );
+  },
+  name: "24 Hour Format",
+  args: {
+    use12Hour: false,
+    interval: 15,
+    allowCustom: true,
+    autoClose: true,
+    variant: "subtle",
+    placement: "bottom-start",
+    scrollMode: "center",
+  },
+};
+
+export const CustomOptions: Story = {
+  render: (args) => {
+    const [value, setValue] = useState("09:00");
+
+    return (
+      <div className="p-2 space-y-2">
+        <TimePicker {...args} value={value} onChange={setValue} />
+        <div className="text-xs text-ink-gray-6">Value: {value}</div>
+      </div>
+    );
+  },
+  name: "Custom Options (no interval generation)",
+  args: {
+    allowCustom: false,
+    autoClose: true,
+    use12Hour: true,
+    variant: "subtle",
+    placement: "bottom-start",
+    scrollMode: "center",
+    options: [
+      { value: "08:00" },
+      { value: "09:00" },
+      { value: "09:30" },
+      { value: "10:00" },
+      { value: "11:15" },
+      { value: "13:45" },
+    ],
+  },
+};
+
+export const MinMaxRange: Story = {
+  render: (args) => {
+    const [value, setValue] = useState("08:00");
+
+    return (
+      <div className="p-2 space-y-2">
+        <TimePicker {...args} value={value} onChange={setValue} />
+        <div className="text-xs text-ink-gray-6">Value: {value}</div>
+      </div>
+    );
+  },
+  args: {
+    minTime: "08:00",
+    maxTime: "12:00",
+    interval: 15,
+    allowCustom: true,
+    autoClose: true,
+    use12Hour: true,
+    variant: "subtle",
+    placement: "bottom-start",
+    scrollMode: "center",
+  },
+};

packages/frappe-ui-react/src/components/timePicker/timePicker.tsx

@@ -0,0 +1,175 @@
+/**
+ * External dependencies.
+ */
+import React from "react";
+import clsx from "clsx";
+
+/**
+ * Internal dependencies.
+ */
+import Popover from "../popover/popover";
+import TextInput from "../textInput/textInput";
+import FeatherIcon from "../featherIcon";
+import type { TimePickerProps, TimePickerOption } from "./types";
+import { useTimePicker } from "./useTimePicker";
+
+const TimePicker: React.FC<TimePickerProps> = ({
+  value = "",
+  onChange,
+  onInputInvalid,
+  onInvalidChange,
+  onOpen,
+  onClose,
+  interval = 15,
+  options = [],
+  placement = "bottom-start",
+  placeholder = "Select time",
+  variant = "subtle",
+  allowCustom = true,
+  autoClose = true,
+  use12Hour = true,
+  disabled = false,
+  scrollMode = "center",
+  minTime = "",
+  maxTime = "",
+  prefix,
+  suffix,
+}) => {
+  const {
+    showOptions,
+    setShowOptions,
+    displayValue,
+    displayedOptions,
+    isTyping,
+    selectedAndNearest,
+    highlightIndex,
+    panelRef,
+    inputRef,
+    handleArrowDown,
+    handleArrowUp,
+    handleEnter,
+    handleClickInput,
+    handleFocus,
+    handleBlur,
+    handleEscape,
+    handleDisplayValueChange,
+    handleMouseEnter,
+    select,
+    optionId,
+  } = useTimePicker({
+    value,
+    onChange,
+    onInputInvalid,
+    onInvalidChange,
+    onOpen,
+    onClose,
+    interval,
+    options,
+    allowCustom,
+    autoClose,
+    use12Hour,
+    scrollMode,
+    minTime,
+    maxTime,
+  });
+
+  const getButtonClasses = (opt: TimePickerOption, idx: number): string => {
+    if (idx === highlightIndex) return "bg-surface-gray-3 text-ink-gray-8";
+    const { selected, nearest } = selectedAndNearest;
+    if (isTyping && !selected) {
+      if (nearest && nearest.value === opt.value)
+        return "text-ink-gray-7 italic bg-surface-gray-2";
+      return "text-ink-gray-6 hover:bg-surface-gray-2 hover:text-ink-gray-8";
+    }
+    if (selected && selected.value === opt.value)
+      return "bg-surface-gray-3 text-ink-gray-8";
+    if (nearest && nearest.value === opt.value)
+      return "text-ink-gray-7 italic bg-surface-gray-2";
+    return "text-ink-gray-6 hover:bg-surface-gray-2 hover:text-ink-gray-8";
+  };
+
+  return (
+    <Popover
+      show={showOptions && !disabled}
+      onUpdateShow={(show) => !disabled && setShowOptions(show)}
+      placement={placement}
+      target={({ togglePopover, isOpen }) => (
+        <TextInput
+          ref={inputRef}
+          value={displayValue}
+          onChange={handleDisplayValueChange}
+          variant={variant}
+          type="text"
+          placeholder={placeholder}
+          disabled={disabled}
+          readOnly={!allowCustom}
+          onFocus={handleFocus}
+          onClick={() => !disabled && handleClickInput(isOpen, togglePopover)}
+          onKeyDown={(e: React.KeyboardEvent<HTMLInputElement>) => {
+            if (e.key === "Enter") handleEnter(e);
+            else if (e.key === "Escape") handleEscape(e);
+            else if (e.key === "ArrowDown")
+              handleArrowDown(e, togglePopover, isOpen);
+            else if (e.key === "ArrowUp")
+              handleArrowUp(e, togglePopover, isOpen);
+          }}
+          onBlur={handleBlur}
+          prefix={prefix}
+          suffix={
+            suffix
+              ? suffix
+              : () => (
+                  <div
+                    onClick={(e) => {
+                      e.stopPropagation();
+                    }}
+                  >
+                    <FeatherIcon
+                      name="chevron-down"
+                      className="h-4 w-4 cursor-pointer"
+                      onMouseDown={(e) => {
+                        e.preventDefault();
+                        togglePopover();
+                      }}
+                    />
+                  </div>
+                )
+          }
+        />
+      )}
+      body={({ isOpen }) => (
+        <div
+          ref={panelRef}
+          style={{ display: isOpen ? "block" : "none" }}
+          className="mt-2 max-h-48 w-44 overflow-y-auto rounded-lg bg-surface-modal p-1 text-base shadow-2xl ring-1 ring-black/5 focus:outline-none"
+          role="listbox"
+          aria-activedescendant={
+            highlightIndex >= 0 ? optionId(highlightIndex) : undefined
+          }
+        >
+          {displayedOptions.map((opt, idx) => (
+            <button
+              key={opt.value}
+              data-value={opt.value}
+              data-index={idx}
+              type="button"
+              className={clsx(
+                "group flex h-7 w-full items-center rounded px-2 text-left",
+                getButtonClasses(opt, idx)
+              )}
+              onClick={() => select(opt.value)}
+              onMouseEnter={() => handleMouseEnter(idx)}
+              role="option"
+              id={optionId(idx)}
+              aria-selected={opt.value === value}
+            >
+              <span className="truncate">{opt.label}</span>
+            </button>
+          ))}
+        </div>
+      )}
+    />
+  );
+};
+
+export default TimePicker;