@datum-cloud/datum-ui 0.5.0 → 0.6.0-alpha.a9a8815

package/README.md

@@ -88,7 +88,7 @@ Some components with shared heavy dependencies are grouped under a single subpat
 | `@datum-cloud/datum-ui/map`         | `Map`, `PlaceAutocomplete`, + map controls | `leaflet`, `react-leaflet`, + leaflet plugins |
 | `@datum-cloud/datum-ui/dropzone`    | `Dropzone`, `FileInputButton`              | `react-dropzone`                              |
 | `@datum-cloud/datum-ui/chart`       | `ChartContainer`, `ChartTooltip`, etc.     | `recharts`                                    |
-| `@datum-cloud/datum-ui/form`        | `Form`, `FormField`, `FormInput`, etc.     | `@conform-to/react`, `@conform-to/zod`, `zod` |
+| `@datum-cloud/datum-ui/form`        | `Form`, `FormField`, `FormInput`, etc.     | See [Form Adapters](#form-adapters) below     |
 
 ## Components
 
@@ -136,31 +136,34 @@ Thin wrappers around shadcn/Radix primitives with Datum styling. **Radix UI depe
 
 Complex, fully-customized components with significant business logic.
 
-| Component                                                                                                                        | Additional Dependencies                       | Description                                |
-| -------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------- | ------------------------------------------ |
-| `Autocomplete`                                                                                                                   | —                                             | Search autocomplete input                  |
-| `AvatarStack`                                                                                                                    | —                                             | Stacked avatar display                     |
-| `CalendarDatePicker`                                                                                                             | `react-day-picker`, `date-fns`                | Date/range picker with presets             |
-| `CodeEditor`, `CodeEditorTabs`                                                                                                   | `@monaco-editor/react`, `monaco-editor`       | Monaco-based code editor with VS Code UX   |
-| `DataTable`, `DataTableColumnHeader`, `DataTablePagination`, `DataTableToolbar`, `DataTableViewOptions`                          | `@tanstack/react-table`                       | Advanced data table with sorting/filtering |
-| `Dropdown`, `DropdownHeader`, `DropdownItem`, `DropdownSection`                                                                  | —                                             | Dropdown menu                              |
-| `Dropzone`                                                                                                                       | `react-dropzone`                              | File drag-and-drop upload area             |
-| `EmptyContent`                                                                                                                   | —                                             | Empty state placeholder                    |
-| `FileInputButton`                                                                                                                | —                                             | File upload button                         |
-| `Form`, `FormField`, `FormInput`, `FormTextarea`, `FormSelect`, `FormCheckbox`, `FormSwitch`, `FormRadioGroup`, `FormFieldArray` | `@conform-to/react`, `@conform-to/zod`, `zod` | Form system with validation                |
-| `Grid`                                                                                                                           | `@tanstack/react-virtual`                     | Virtualized data grid                      |
-| `InputNumber`                                                                                                                    | `react-number-format`                         | Numeric input with formatting              |
-| `InputWithAddons`                                                                                                                | —                                             | Input with prefix/suffix addons            |
-| `LoaderOverlay`                                                                                                                  | —                                             | Full-screen loading overlay                |
-| `MoreActions`                                                                                                                    | —                                             | Three-dot actions menu                     |
-| `NProgress`                                                                                                                      | `nprogress`                                   | Page navigation progress bar               |
-| `PageTitle`                                                                                                                      | —                                             | Page header with breadcrumbs               |
-| `Sidebar`, `SidebarHeader`, `SidebarContent`, `SidebarFooter`, `SidebarMenu`, `SidebarMenuItem`, `SidebarMenuButton`             | —                                             | App sidebar navigation                     |
-| `Stepper`                                                                                                                        | `@stepperize/react`                           | Multi-step wizard                          |
-| `TagInput`                                                                                                                       | —                                             | Tag/chip input                             |
-| `TaskQueue`, `TaskQueueProvider`, `TaskQueueDropdown`, `TaskPanelHeader`, `TaskSummaryDialog`                                    | —                                             | Background task queue with progress UI     |
-| `TimeRangePicker`                                                                                                                | `date-fns`, `date-fns-tz`                     | Time range selector with timezone support  |
-| `Toast`, `Toaster`, `useToast`                                                                                                   | `sonner`                                      | Toast notifications                        |
+| Component                                                                                                                        | Additional Dependencies                   | Description                                |
+| -------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------- | ------------------------------------------ |
+| `Autocomplete`                                                                                                                   | —                                         | Search autocomplete input                  |
+| `AvatarStack`                                                                                                                    | —                                         | Stacked avatar display                     |
+| `CalendarDatePicker`                                                                                                             | `react-day-picker`, `date-fns`            | Date/range picker with presets             |
+| `Combobox`                                                                                                                       | —                                         | Searchable single-select dropdown          |
+| `CodeEditor`, `CodeEditorTabs`                                                                                                   | `@monaco-editor/react`, `monaco-editor`   | Monaco-based code editor with VS Code UX   |
+| `DataTable`, `DataTableColumnHeader`, `DataTablePagination`, `DataTableToolbar`, `DataTableViewOptions`                          | `@tanstack/react-table`                   | Advanced data table with sorting/filtering |
+| `DateTimePicker`, `TimePicker`                                                                                                   | `date-fns`, `date-fns-tz`                 | Date/time picker with timezone support     |
+| `Dropdown`, `DropdownHeader`, `DropdownItem`, `DropdownSection`                                                                  | —                                         | Dropdown menu                              |
+| `Dropzone`                                                                                                                       | `react-dropzone`                          | File drag-and-drop upload area             |
+| `EmptyContent`                                                                                                                   | —                                         | Empty state placeholder                    |
+| `FileInputButton`                                                                                                                | —                                         | File upload button                         |
+| `Form`, `FormField`, `FormInput`, `FormTextarea`, `FormSelect`, `FormCheckbox`, `FormSwitch`, `FormRadioGroup`, `FormFieldArray` | See [Form Adapters](#form-adapters) below | Form system with pluggable adapter support |
+| `Grid`                                                                                                                           | `@tanstack/react-virtual`                 | Virtualized data grid                      |
+| `InputNumber`                                                                                                                    | `react-number-format`                     | Numeric input with formatting              |
+| `InputWithAddons`                                                                                                                | —                                         | Input with prefix/suffix addons            |
+| `LoaderOverlay`                                                                                                                  | —                                         | Full-screen loading overlay                |
+| `MoreActions`                                                                                                                    | —                                         | Three-dot actions menu                     |
+| `NProgress`                                                                                                                      | `nprogress`                               | Page navigation progress bar               |
+| `PageTitle`                                                                                                                      | —                                         | Page header with breadcrumbs               |
+| `Sidebar`, `SidebarHeader`, `SidebarContent`, `SidebarFooter`, `SidebarMenu`, `SidebarMenuItem`, `SidebarMenuButton`             | —                                         | App sidebar navigation                     |
+| `Stepper`                                                                                                                        | `@stepperize/react`                       | Multi-step wizard                          |
+| `TagInput`                                                                                                                       | —                                         | Tag/chip input                             |
+| `TaskQueue`, `TaskQueueProvider`, `TaskQueueDropdown`, `TaskPanelHeader`, `TaskSummaryDialog`                                    | —                                         | Background task queue with progress UI     |
+| `TimeRangePicker`                                                                                                                | `date-fns`, `date-fns-tz`                 | Time range selector with timezone support  |
+| `Transfer`                                                                                                                       | —                                         | Dual-panel item selector with search       |
+| `Toast`, `Toaster`, `useToast`                                                                                                   | `sonner`                                  | Toast notifications                        |
 
 ## Usage Examples
 
@@ -212,26 +215,45 @@ import { Title, Text, Paragraph, Code } from '@datum-cloud/datum-ui/typography'
 
 ### Form with Validation
 
+The form system uses a pluggable adapter pattern. Wrap your app with an adapter, then use `Form.*` components as usual:
+
 ```tsx
-import { Form, FormField, FormInput, FormSelect } from '@datum-cloud/datum-ui/form'
+import { Form } from '@datum-cloud/datum-ui/form'
+import { ConformAdapter } from '@datum-cloud/datum-ui/form/adapters/conform'
+// or: import { RHFAdapter } from '@datum-cloud/datum-ui/form/adapters/rhf'
 import { z } from 'zod'
 
 const schema = z.object({
-  name: z.string().min(1),
+  name: z.string().min(1, 'Name is required'),
   role: z.enum(['admin', 'user']),
 })
 
-<Form schema={schema} onSubmit={handleSubmit}>
-  <FormField name="name">
-    <FormInput label="Name" />
-  </FormField>
-  <FormField name="role">
-    <FormSelect label="Role" options={[
-      { label: 'Admin', value: 'admin' },
-      { label: 'User', value: 'user' },
-    ]} />
-  </FormField>
-</Form>
+// Wrap your app once with an adapter
+function App() {
+  return (
+    <ConformAdapter>
+      <MyForm />
+    </ConformAdapter>
+  )
+}
+
+// Form code is identical regardless of adapter
+function MyForm() {
+  return (
+    <Form.Root schema={schema} onSubmit={handleSubmit}>
+      <Form.Field name="name" label="Name" required>
+        <Form.Input />
+      </Form.Field>
+      <Form.Field name="role" label="Role" required>
+        <Form.Select placeholder="Select a role">
+          <Form.SelectItem value="admin">Admin</Form.SelectItem>
+          <Form.SelectItem value="user">User</Form.SelectItem>
+        </Form.Select>
+      </Form.Field>
+      <Form.Submit>Save</Form.Submit>
+    </Form.Root>
+  )
+}
 ```
 
 ### Map
@@ -364,9 +386,12 @@ Many components require additional packages. Install only what you use:
 > Replace `npm install` with `yarn add`, `pnpm add`, or `bun add` for your package manager.
 
 ```bash
-# Forms (Form, FormField, FormInput, etc.)
+# Forms — Conform adapter
 npm install @conform-to/react @conform-to/zod zod
 
+# Forms — React Hook Form adapter (alternative)
+npm install react-hook-form @hookform/resolvers zod
+
 # Maps (Map, MapMarker, MapPopup, etc.)
 npm install leaflet react-leaflet leaflet-draw leaflet.fullscreen leaflet.markercluster react-leaflet-markercluster
 
@@ -407,6 +432,19 @@ npm install nuqs
 npm install motion
 ```
 
+## Form Adapters
+
+The form system supports pluggable adapters. Choose one and wrap your app:
+
+| Adapter             | Import Path                                   | Dependencies                                                         |
+| ------------------- | --------------------------------------------- | -------------------------------------------------------------------- |
+| **Conform.js**      | `@datum-cloud/datum-ui/form/adapters/conform` | `@conform-to/react`, `@conform-to/zod`, `zod` (>=4)                  |
+| **React Hook Form** | `@datum-cloud/datum-ui/form/adapters/rhf`     | `react-hook-form` (>=7.55), `@hookform/resolvers` (>=5), `zod` (>=4) |
+
+The `Form.*` component API is identical with either adapter. Switch adapters by changing only the root provider -- no form code changes needed.
+
+See the [Form README](./src/components/features/form/README.md) for detailed documentation.
+
 ## Tech Stack
 
 - **React 19** with server component support

package/dist/adapter-context-rWveHhDd.mjs

@@ -0,0 +1,25 @@
+import * as React$1 from "react";
+import { jsx } from "react/jsx-runtime";
+//#region src/components/features/form/adapter-context.tsx
+const AdapterContext = React$1.createContext(null);
+/**
+* Read the current form adapter from context.
+* Throws with a helpful error if no adapter is found.
+*/
+function useAdapter() {
+	const adapter = React$1.use(AdapterContext);
+	if (!adapter) throw new Error("No form adapter found. Wrap your application with an adapter provider:\n\n  import { ConformAdapter } from '@datum-cloud/datum-ui/form/adapters/conform'\n  // or\n  import { RHFAdapter } from '@datum-cloud/datum-ui/form/adapters/rhf'\n\n  <ConformAdapter>\n    <App />\n  </ConformAdapter>");
+	return adapter;
+}
+/**
+* Internal provider used by adapter packages (ConformAdapter, RHFAdapter).
+* Consumers don't use this directly.
+*/
+function FormAdapterProvider({ adapter, children }) {
+	return /* @__PURE__ */ jsx(AdapterContext, {
+		value: adapter,
+		children
+	});
+}
+//#endregion
+export { useAdapter as n, FormAdapterProvider as t };

package/dist/combobox/index.mjs

@@ -0,0 +1,2 @@
+import { t as Combobox } from "../combobox-cKTFK4uN.mjs";
+export { Combobox };

package/dist/combobox-cKTFK4uN.mjs

@@ -0,0 +1,96 @@
+import { t as cn } from "./cn-D2KYQ917.mjs";
+import { a as CommandInput, i as CommandGroup, o as CommandItem, r as CommandEmpty, s as CommandList, t as Command } from "./command-DqHWukGK.mjs";
+import { i as PopoverTrigger, r as PopoverContent, t as Popover } from "./popover-FJAcbYoH.mjs";
+import { CheckIcon, ChevronDown, X } from "lucide-react";
+import * as React$1 from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/components/features/combobox/combobox.tsx
+/**
+* Combobox - Single-select dropdown with search
+*
+* A simpler alternative to Autocomplete for basic select scenarios.
+* Supports grouped options and search filtering.
+*
+* @example
+* ```tsx
+* const options = [
+*   { value: '1', label: 'Option 1' },
+*   { value: '2', label: 'Option 2' },
+* ]
+*
+* <Combobox
+*   options={options}
+*   value={value}
+*   onChange={setValue}
+*   placeholder="Select an option"
+* />
+* ```
+*/
+function Combobox({ options, value, onChange, placeholder = "Select option...", searchPlaceholder = "Search...", emptyMessage = "No options found.", disabled = false, className, triggerClassName, contentClassName, searchable = true, showDropdownArrow = true, clearable = false, id, "data-testid": testId }) {
+	const [open, setOpen] = React$1.useState(false);
+	const isGrouped = options.length > 0 && "options" in options[0];
+	const selectedOption = React$1.useMemo(() => {
+		if (isGrouped) return options.flatMap((group) => group.options);
+		return options;
+	}, [options, isGrouped]).find((opt) => opt.value === value);
+	const handleSelect = React$1.useCallback((selectedValue) => {
+		onChange?.(selectedValue === value ? void 0 : selectedValue);
+		setOpen(false);
+	}, [value, onChange]);
+	const handleClear = React$1.useCallback((e) => {
+		e.stopPropagation();
+		onChange?.(void 0);
+	}, [onChange]);
+	return /* @__PURE__ */ jsxs(Popover, {
+		open,
+		onOpenChange: setOpen,
+		children: [/* @__PURE__ */ jsx(PopoverTrigger, {
+			asChild: true,
+			children: /* @__PURE__ */ jsxs("button", {
+				type: "button",
+				role: "combobox",
+				"aria-expanded": open,
+				disabled,
+				id,
+				"data-testid": testId,
+				className: cn("flex h-10 w-full items-center justify-between rounded-lg border border-input bg-background px-3 py-2 text-sm", "ring-offset-background placeholder:text-muted-foreground", "focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2", "disabled:cursor-not-allowed disabled:opacity-50", triggerClassName, className),
+				children: [/* @__PURE__ */ jsx("span", {
+					className: "truncate",
+					children: selectedOption ? selectedOption.label : placeholder
+				}), /* @__PURE__ */ jsxs("div", {
+					className: "ml-2 flex shrink-0 items-center gap-1",
+					children: [clearable && selectedOption && !disabled && /* @__PURE__ */ jsx(X, {
+						className: "size-4 opacity-50 hover:opacity-100",
+						onClick: handleClear
+					}), showDropdownArrow && /* @__PURE__ */ jsx(ChevronDown, { className: "size-4 opacity-50" })]
+				})]
+			})
+		}), /* @__PURE__ */ jsx(PopoverContent, {
+			className: cn("w-[--radix-popover-trigger-width] p-0", contentClassName),
+			align: "start",
+			children: /* @__PURE__ */ jsxs(Command, { children: [searchable && /* @__PURE__ */ jsx(CommandInput, {
+				placeholder: searchPlaceholder,
+				className: "h-9"
+			}), /* @__PURE__ */ jsxs(CommandList, {
+				className: "max-h-[300px]",
+				children: [/* @__PURE__ */ jsx(CommandEmpty, { children: emptyMessage }), isGrouped ? options.map((group) => /* @__PURE__ */ jsx(CommandGroup, {
+					heading: group.label,
+					children: group.options.map((option) => /* @__PURE__ */ jsxs(CommandItem, {
+						value: option.value,
+						disabled: option.disabled,
+						onSelect: handleSelect,
+						children: [option.label, /* @__PURE__ */ jsx(CheckIcon, { className: cn("ml-auto size-4", value === option.value ? "opacity-100" : "opacity-0") })]
+					}, option.value))
+				}, group.label)) : /* @__PURE__ */ jsx(CommandGroup, { children: options.map((option) => /* @__PURE__ */ jsxs(CommandItem, {
+					value: option.value,
+					disabled: option.disabled,
+					onSelect: handleSelect,
+					children: [option.label, /* @__PURE__ */ jsx(CheckIcon, { className: cn("ml-auto size-4", value === option.value ? "opacity-100" : "opacity-0") })]
+				}, option.value)) })]
+			})] })
+		})]
+	});
+}
+Combobox.displayName = "Combobox";
+//#endregion
+export { Combobox as t };

package/dist/components/features/combobox/combobox.d.ts

@@ -0,0 +1,27 @@
+import type { ComboboxProps } from './types';
+/**
+ * Combobox - Single-select dropdown with search
+ *
+ * A simpler alternative to Autocomplete for basic select scenarios.
+ * Supports grouped options and search filtering.
+ *
+ * @example
+ * ```tsx
+ * const options = [
+ *   { value: '1', label: 'Option 1' },
+ *   { value: '2', label: 'Option 2' },
+ * ]
+ *
+ * <Combobox
+ *   options={options}
+ *   value={value}
+ *   onChange={setValue}
+ *   placeholder="Select an option"
+ * />
+ * ```
+ */
+export declare function Combobox({ options, value, onChange, placeholder, searchPlaceholder, emptyMessage, disabled, className, triggerClassName, contentClassName, searchable, showDropdownArrow, clearable, id, 'data-testid': testId, }: ComboboxProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace Combobox {
+    var displayName: string;
+}
+//# sourceMappingURL=combobox.d.ts.map

package/dist/components/features/combobox/combobox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"combobox.d.ts","sourceRoot":"","sources":["../../../../src/components/features/combobox/combobox.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiC,aAAa,EAAE,MAAM,SAAS,CAAA;AAc3E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,QAAQ,CAAC,EACvB,OAAO,EACP,KAAK,EACL,QAAQ,EACR,WAAgC,EAChC,iBAA+B,EAC/B,YAAkC,EAClC,QAAgB,EAChB,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,UAAiB,EACjB,iBAAwB,EACxB,SAAiB,EACjB,EAAE,EACF,aAAa,EAAE,MAAM,GACtB,EAAE,aAAa,2CAgIf;yBAhJe,QAAQ"}

package/dist/components/features/combobox/index.d.ts

@@ -0,0 +1,3 @@
+export { Combobox } from './combobox';
+export type { ComboboxGroup, ComboboxOption, ComboboxProps } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/features/combobox/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/features/combobox/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA"}

package/dist/components/features/combobox/types.d.ts

@@ -0,0 +1,78 @@
+export interface ComboboxOption {
+    value: string;
+    label: string;
+    disabled?: boolean;
+}
+export interface ComboboxGroup {
+    label: string;
+    options: ComboboxOption[];
+}
+export interface ComboboxProps {
+    /**
+     * Available options (flat or grouped)
+     */
+    'options': ComboboxOption[] | ComboboxGroup[];
+    /**
+     * Selected value
+     */
+    'value'?: string;
+    /**
+     * Called when selection changes
+     */
+    'onChange'?: (value: string | undefined) => void;
+    /**
+     * Placeholder for trigger button
+     * @default "Select option..."
+     */
+    'placeholder'?: string;
+    /**
+     * Placeholder for search input
+     * @default "Search..."
+     */
+    'searchPlaceholder'?: string;
+    /**
+     * Message shown when no options match
+     * @default "No options found."
+     */
+    'emptyMessage'?: string;
+    /**
+     * Disable the combobox
+     */
+    'disabled'?: boolean;
+    /**
+     * Additional CSS classes for container
+     */
+    'className'?: string;
+    /**
+     * Additional CSS classes for trigger button
+     */
+    'triggerClassName'?: string;
+    /**
+     * Additional CSS classes for popover content
+     */
+    'contentClassName'?: string;
+    /**
+     * Enable search functionality
+     * @default true
+     */
+    'searchable'?: boolean;
+    /**
+     * Show dropdown arrow icon
+     * @default true
+     */
+    'showDropdownArrow'?: boolean;
+    /**
+     * Allow clearing the selection
+     * @default false
+     */
+    'clearable'?: boolean;
+    /**
+     * ID for the combobox
+     */
+    'id'?: string;
+    /**
+     * Test ID
+     */
+    'data-testid'?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/components/features/combobox/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/features/combobox/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,cAAc,EAAE,CAAA;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,SAAS,EAAE,cAAc,EAAE,GAAG,aAAa,EAAE,CAAA;IAE7C;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAA;IAEhD;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAE5B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IAEpB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAE3B;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAE3B;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IAEtB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAE7B;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;IAErB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB"}

package/dist/components/features/date-time-picker/date-time-picker.d.ts

@@ -0,0 +1,9 @@
+import type { DateTimePickerProps } from './types';
+import * as React from 'react';
+export declare function DateTimePicker({ ref, value, onChange, minDate, maxDate, disabledDates, timezone, showTimezoneIndicator, placeholder, disabled, className }: DateTimePickerProps & {
+    ref?: React.RefObject<HTMLDivElement | null>;
+}): import("react/jsx-runtime").JSX.Element;
+export declare namespace DateTimePicker {
+    var displayName: string;
+}
+//# sourceMappingURL=date-time-picker.d.ts.map

package/dist/components/features/date-time-picker/date-time-picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-time-picker.d.ts","sourceRoot":"","sources":["../../../../src/components/features/date-time-picker/date-time-picker.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAiB,MAAM,SAAS,CAAA;AAIjE,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAY9B,wBAAgB,cAAc,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,QAA2B,EAAE,qBAA6B,EAAE,WAAoC,EAAE,QAAgB,EAAE,SAAS,EAAE,EAAE,mBAAmB,GAAG;IAAE,GAAG,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAA;CAAE,2CAkH9R;yBAlHe,cAAc"}

package/dist/components/features/date-time-picker/index.d.ts

@@ -0,0 +1,3 @@
+export { DateTimePicker } from './date-time-picker';
+export type { DateTimePickerProps, DateTimeState } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/features/date-time-picker/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/features/date-time-picker/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACnD,YAAY,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA"}

package/dist/components/features/date-time-picker/types.d.ts

@@ -0,0 +1,53 @@
+export interface DateTimePickerProps {
+    /**
+     * Current value (UTC ISO string)
+     * @example "2024-01-15T14:30:00Z"
+     */
+    value?: string;
+    /**
+     * Called when value changes
+     */
+    onChange?: (value: string) => void;
+    /**
+     * Minimum selectable date
+     */
+    minDate?: Date;
+    /**
+     * Maximum selectable date
+     */
+    maxDate?: Date;
+    /**
+     * Dates that should be disabled
+     */
+    disabledDates?: Date[] | ((date: Date) => boolean);
+    /**
+     * Timezone for display (defaults to browser timezone)
+     * @example "America/New_York"
+     */
+    timezone?: string;
+    /**
+     * Show timezone indicator below input
+     * @default false
+     */
+    showTimezoneIndicator?: boolean;
+    /**
+     * Input placeholder text
+     */
+    placeholder?: string;
+    /**
+     * Disable the input
+     */
+    disabled?: boolean;
+    /**
+     * Additional CSS class
+     */
+    className?: string;
+}
+/**
+ * Internal state for date + time selection
+ */
+export interface DateTimeState {
+    date: Date | undefined;
+    time: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/components/features/date-time-picker/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/features/date-time-picker/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAElC;;OAEG;IACH,OAAO,CAAC,EAAE,IAAI,CAAA;IAEd;;OAEG;IACH,OAAO,CAAC,EAAE,IAAI,CAAA;IAEd;;OAEG;IACH,aAAa,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAA;IAElD;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAE/B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAElB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,IAAI,GAAG,SAAS,CAAA;IACtB,IAAI,EAAE,MAAM,CAAA;CACb"}

package/dist/components/features/date-time-picker/utils/format.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Format date for display
+ */
+export declare function formatDate(date: Date | undefined): string;
+/**
+ * Format time for display
+ */
+export declare function formatTime(time: string): string;
+/**
+ * Format full date-time for display
+ */
+export declare function formatDateTime(date: Date | undefined, time: string): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/components/features/date-time-picker/utils/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/date-time-picker/utils/format.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,GAAG,MAAM,CAIzD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI/C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAI3E"}

package/dist/components/features/date-time-picker/utils/index.d.ts

@@ -0,0 +1,3 @@
+export * from './format';
+export * from './timezone';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/features/date-time-picker/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/date-time-picker/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,YAAY,CAAA"}

package/dist/components/features/date-time-picker/utils/timezone.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Get the browser's timezone
+ */
+export declare function getBrowserTimezone(): string;
+/**
+ * Convert local date + time to UTC ISO string
+ * @param date - Date object (date part)
+ * @param time - Time string in HH:mm format
+ * @param timezone - IANA timezone (e.g., "America/New_York")
+ * @returns UTC ISO string
+ */
+export declare function localDateTimeToUtc(date: Date, time: string, timezone: string): string;
+/**
+ * Convert UTC ISO string to local date + time
+ * @param utcString - UTC ISO string
+ * @param timezone - IANA timezone
+ * @returns Object with date and time (HH:mm)
+ */
+export declare function utcToLocalDateTime(utcString: string, timezone: string): {
+    date: Date;
+    time: string;
+};
+//# sourceMappingURL=timezone.d.ts.map

package/dist/components/features/date-time-picker/utils/timezone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timezone.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/date-time-picker/utils/timezone.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,MAAM,CAwBR;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CA4B9B"}

package/dist/components/features/form/adapter-context.d.ts

@@ -0,0 +1,17 @@
+import type { FormAdapter } from './adapter-types';
+import * as React from 'react';
+/**
+ * Read the current form adapter from context.
+ * Throws with a helpful error if no adapter is found.
+ */
+export declare function useAdapter(): FormAdapter;
+export interface FormAdapterProviderProps {
+    adapter: FormAdapter;
+    children: React.ReactNode;
+}
+/**
+ * Internal provider used by adapter packages (ConformAdapter, RHFAdapter).
+ * Consumers don't use this directly.
+ */
+export declare function FormAdapterProvider({ adapter, children }: FormAdapterProviderProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=adapter-context.d.ts.map

package/dist/components/features/form/adapter-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-context.d.ts","sourceRoot":"","sources":["../../../../src/components/features/form/adapter-context.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAI9B;;;GAGG;AACH,wBAAgB,UAAU,IAAI,WAAW,CAgBxC;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,WAAW,CAAA;IACpB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,wBAAwB,2CAElF"}