@mihcm/ui 0.14.1 → 0.15.1

package/dist/Form/fields-complex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields-complex.d.ts","sourceRoot":"","sources":["../../src/Form/fields-complex.tsx"],"names":[],"mappings":"AAOA,OAAO,EAEL,KAAK,iBAAiB,EAEvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAY,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAO9D,OAAO,KAAK,EAAE,UAAU,EAAoB,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAIpF,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CACjD,iBAAiB,EACf,OAAO,GACP,SAAS,GACT,QAAQ,GACR,SAAS,GACT,aAAa,GACb,mBAAmB,GACnB,WAAW,GACX,YAAY,GACZ,kBAAkB,CACrB;IACC,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,mBAAmB,CAAC;CAClC;AAED,+DAA+D;AAC/D,wBAAgB,gBAAgB,CAAC,EAC/B,IAAI,EACJ,IAAI,EACJ,KAAK,EACL,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,UAAU,EACV,KAAK,EACL,OAAO,EACP,MAAM,EACN,OAAO,EACP,WAAW,EACX,iBAAiB,EACjB,SAAS,EACT,UAAU,EACV,gBAAgB,GACjB,EAAE,qBAAqB,2CAwCvB;AAID,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAC7C,aAAa,EACX,QAAQ,GACR,UAAU,GACV,SAAS,GACT,SAAS,GACT,UAAU,GACV,WAAW,GACX,SAAS,GACT,aAAa,GACb,aAAa,GACb,UAAU,CACb;IACC,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,mBAAmB,CAAC;CAClC;AAED,iFAAiF;AACjF,wBAAgB,YAAY,CAAC,EAC3B,IAAI,EACJ,IAAI,EACJ,KAAK,EACL,gBAAgB,EAChB,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,UAAU,EACV,MAAM,EACN,QAAQ,EACR,OAAO,EACP,OAAO,EACP,QAAQ,EACR,SAAS,EACT,OAAO,EACP,WAAW,EACX,WAAW,EACX,QAAQ,GACT,EAAE,iBAAiB,2CA2CnB"}

package/dist/Form/fields-complex.js

@@ -0,0 +1,38 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Complex multi-value fields integrated with TanStack Form: FormCheckboxGrid,
+ * FormDropzone.
+ */
+import { useId } from 'react';
+import { CheckboxGrid, } from '../CheckboxGrid.js';
+import { Dropzone } from '../Dropzone.js';
+import { FormDescription, FormItem, FormLabel, FormMessage, } from './building-blocks.js';
+/** Multi-select CheckboxGrid integrated with TanStack Form. */
+export function FormCheckboxGrid({ form, name, label, description, required, disabled, className, validators, items, columns, layout, density, showToolbar, searchPlaceholder, maxHeight, emptyState, getItemClassName, }) {
+    const descId = useId();
+    const msgId = `${descId}-msg`;
+    return (_jsx(form.Field, { name: name, ...(validators !== undefined && { validators }), children: (field) => {
+            const errors = field.state.meta.isTouched ? field.state.meta.errors : [];
+            const hasError = errors.length > 0;
+            return (_jsxs(FormItem, { ...(className !== undefined && { className }), children: [_jsx(FormLabel, { ...(required !== undefined && { required }), children: label }), _jsx(CheckboxGrid, { items: items, selected: field.state.value ?? {}, onSelectedChange: (next) => {
+                            if (!disabled)
+                                field.handleChange(next);
+                            field.handleBlur();
+                        }, ...(columns !== undefined && { columns }), ...(layout !== undefined && { layout }), ...(density !== undefined && { density }), ...(showToolbar !== undefined && { showToolbar }), ...(searchPlaceholder !== undefined && { searchPlaceholder }), ...(maxHeight !== undefined && { maxHeight }), ...(emptyState !== undefined && { emptyState }), ...(getItemClassName !== undefined && { getItemClassName }), "aria-disabled": disabled, "aria-describedby": hasError ? msgId : description !== undefined ? descId : undefined, "aria-invalid": hasError }), description !== undefined ? (_jsx(FormDescription, { id: descId, children: description })) : null, hasError ? _jsx(FormMessage, { id: msgId, errors: errors }) : null] }));
+        } }));
+}
+/** File-list Dropzone integrated with TanStack Form. Field value is `File[]`. */
+export function FormDropzone({ form, name, label, fieldDescription, required, disabled, className, validators, accept, maxFiles, maxSize, minSize, multiple, validator, heading, description, browseLabel, children, }) {
+    const descId = useId();
+    const msgId = `${descId}-msg`;
+    return (_jsx(form.Field, { name: name, ...(validators !== undefined && { validators }), children: (field) => {
+            const errors = field.state.meta.isTouched ? field.state.meta.errors : [];
+            const hasError = errors.length > 0;
+            return (_jsxs(FormItem, { ...(className !== undefined && { className }), children: [_jsx(FormLabel, { ...(required !== undefined && { required }), children: label }), _jsx(Dropzone, { ...(accept !== undefined && { accept }), ...(maxFiles !== undefined && { maxFiles }), ...(maxSize !== undefined && { maxSize }), ...(minSize !== undefined && { minSize }), ...(multiple !== undefined && { multiple }), ...(validator !== undefined && { validator }), ...(heading !== undefined && { heading }), ...(description !== undefined && { description }), ...(browseLabel !== undefined && { browseLabel }), ...(children !== undefined && { children }), ...(disabled !== undefined && { disabled }), onFilesAccepted: (files) => {
+                            field.handleChange(files);
+                            field.handleBlur();
+                        }, onFilesRejected: () => field.handleBlur(), "aria-describedby": hasError ? msgId : fieldDescription !== undefined ? descId : undefined, "aria-invalid": hasError }), fieldDescription !== undefined ? (_jsx(FormDescription, { id: descId, children: fieldDescription })) : null, hasError ? _jsx(FormMessage, { id: msgId, errors: errors }) : null] }));
+        } }));
+}
+//# sourceMappingURL=fields-complex.js.map

package/dist/Form/fields-complex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields-complex.js","sourceRoot":"","sources":["../../src/Form/fields-complex.tsx"],"names":[],"mappings":"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"}

package/dist/Form/fields-date.d.ts

@@ -0,0 +1,46 @@
+import { type DatePickerProps } from '../DatePicker.js';
+import type { AnyFormApi, FormFieldValidators } from './types.js';
+export interface FormDatePickerProps {
+    form: AnyFormApi;
+    name: string;
+    label: string;
+    description?: string;
+    required?: boolean;
+    placeholder?: string;
+    disabled?: boolean;
+    /** Show time selection alongside date. */
+    showTimeSelect?: boolean;
+    /** Date format string (default: "MM/dd/yyyy"). */
+    dateFormat?: string;
+    className?: string;
+    validators?: FormFieldValidators;
+}
+/** DatePicker field integrated with TanStack Form. Uses the mihcm DatePicker primitive. */
+export declare function FormDatePicker({ form, name, label, description, required, placeholder, disabled, showTimeSelect, dateFormat, className, validators, }: FormDatePickerProps): import("react/jsx-runtime").JSX.Element;
+export interface FormDateRangePickerProps {
+    form: AnyFormApi;
+    name: string;
+    label: string;
+    description?: string;
+    required?: boolean;
+    placeholder?: string;
+    disabled?: boolean;
+    isClearable?: boolean;
+    align?: DatePickerProps['align'];
+    showTimeSelect?: boolean;
+    showWeekNumbers?: boolean;
+    monthsShown?: number;
+    minDate?: Date;
+    maxDate?: Date;
+    disabledDays?: DatePickerProps['disabledDays'];
+    dateFormat?: string;
+    calendarProps?: DatePickerProps['calendarProps'];
+    triggerWidth?: 'auto' | 'full';
+    triggerClassName?: string;
+    closeOnRangeComplete?: boolean;
+    className?: string;
+    validators?: FormFieldValidators;
+}
+/** Date range picker integrated with TanStack Form. Field value is `[start, end]`. */
+export declare function FormDateRangePicker({ form, name, label, description, required, placeholder, disabled, isClearable, align, showTimeSelect, showWeekNumbers, monthsShown, minDate, maxDate, disabledDays, dateFormat, calendarProps, triggerWidth, triggerClassName, closeOnRangeComplete, className, validators, }: FormDateRangePickerProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=fields-date.d.ts.map

package/dist/Form/fields-date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields-date.d.ts","sourceRoot":"","sources":["../../src/Form/fields-date.tsx"],"names":[],"mappings":"AAOA,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAOpE,OAAO,KAAK,EAAE,UAAU,EAAoB,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAIpF,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0CAA0C;IAC1C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,mBAAmB,CAAC;CAClC;AAED,2FAA2F;AAC3F,wBAAgB,cAAc,CAAC,EAC7B,IAAI,EACJ,IAAI,EACJ,KAAK,EACL,WAAW,EACX,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,cAAc,EACd,UAAU,EACV,SAAS,EACT,UAAU,GACX,EAAE,mBAAmB,2CAwCrB;AAID,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;IACjC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,YAAY,CAAC,EAAE,eAAe,CAAC,cAAc,CAAC,CAAC;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,eAAe,CAAC,eAAe,CAAC,CAAC;IACjD,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,mBAAmB,CAAC;CAClC;AAED,sFAAsF;AACtF,wBAAgB,mBAAmB,CAAC,EAClC,IAAI,EACJ,IAAI,EACJ,KAAK,EACL,WAAW,EACX,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,WAAW,EACX,KAAK,EACL,cAAc,EACd,eAAe,EACf,WAAW,EACX,OAAO,EACP,OAAO,EACP,YAAY,EACZ,UAAU,EACV,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,SAAS,EACT,UAAU,GACX,EAAE,wBAAwB,2CAsD1B"}

package/dist/Form/fields-date.js

@@ -0,0 +1,41 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Date fields integrated with TanStack Form: FormDatePicker, FormDateRangePicker.
+ */
+import { useId } from 'react';
+import { cn } from '../internal/cn.js';
+import { DatePicker } from '../DatePicker.js';
+import { FormDescription, FormItem, FormLabel, FormMessage, } from './building-blocks.js';
+/** DatePicker field integrated with TanStack Form. Uses the mihcm DatePicker primitive. */
+export function FormDatePicker({ form, name, label, description, required, placeholder, disabled, showTimeSelect, dateFormat, className, validators, }) {
+    const id = useId();
+    const descId = `${id}-desc`;
+    const msgId = `${id}-msg`;
+    return (_jsx(form.Field, { name: name, ...(validators !== undefined && { validators }), children: (field) => {
+            const errors = field.state.meta.isTouched ? field.state.meta.errors : [];
+            const hasError = errors.length > 0;
+            return (_jsxs(FormItem, { ...(className !== undefined && { className }), children: [_jsx(FormLabel, { htmlFor: id, ...(required !== undefined && { required }), children: label }), _jsx(DatePicker, { id: id, selected: field.state.value, onChange: (date) => field.handleChange(date), onBlur: field.handleBlur, ...(placeholder !== undefined && { placeholderText: placeholder }), ...(disabled !== undefined && { disabled }), ...(showTimeSelect !== undefined && { showTimeSelect }), ...(dateFormat !== undefined && { dateFormat }), className: cn(hasError && 'border-destructive focus:ring-destructive'), ...(hasError
+                            ? { 'aria-describedby': msgId }
+                            : description !== undefined
+                                ? { 'aria-describedby': descId }
+                                : {}) }), description !== undefined ? (_jsx(FormDescription, { id: descId, children: description })) : null, hasError ? _jsx(FormMessage, { id: msgId, errors: errors }) : null] }));
+        } }));
+}
+/** Date range picker integrated with TanStack Form. Field value is `[start, end]`. */
+export function FormDateRangePicker({ form, name, label, description, required, placeholder, disabled, isClearable, align, showTimeSelect, showWeekNumbers, monthsShown, minDate, maxDate, disabledDays, dateFormat, calendarProps, triggerWidth, triggerClassName, closeOnRangeComplete, className, validators, }) {
+    const id = useId();
+    const descId = `${id}-desc`;
+    const msgId = `${id}-msg`;
+    return (_jsx(form.Field, { name: name, ...(validators !== undefined && { validators }), children: (field) => {
+            const errors = field.state.meta.isTouched ? field.state.meta.errors : [];
+            const hasError = errors.length > 0;
+            const [startDate, endDate] = field.state.value ?? [null, null];
+            return (_jsxs(FormItem, { ...(className !== undefined && { className }), children: [_jsx(FormLabel, { htmlFor: id, ...(required !== undefined && { required }), children: label }), _jsx(DatePicker, { id: id, selectsRange: true, startDate: startDate, endDate: endDate, onChange: (range) => field.handleChange(range), onBlur: field.handleBlur, ...(placeholder !== undefined && { placeholderText: placeholder }), ...(disabled !== undefined && { disabled }), ...(isClearable !== undefined && { isClearable }), ...(align !== undefined && { align }), ...(showTimeSelect !== undefined && { showTimeSelect }), ...(showWeekNumbers !== undefined && { showWeekNumbers }), ...(monthsShown !== undefined && { monthsShown }), ...(minDate !== undefined && { minDate }), ...(maxDate !== undefined && { maxDate }), ...(disabledDays !== undefined && { disabledDays }), ...(dateFormat !== undefined && { dateFormat }), ...(calendarProps !== undefined && { calendarProps }), ...(triggerWidth !== undefined && { triggerWidth }), ...(triggerClassName !== undefined && { triggerClassName }), ...(closeOnRangeComplete !== undefined && { closeOnRangeComplete }), className: cn(hasError && 'border-destructive focus:ring-destructive'), ...(hasError
+                            ? { 'aria-describedby': msgId }
+                            : description !== undefined
+                                ? { 'aria-describedby': descId }
+                                : {}) }), description !== undefined ? (_jsx(FormDescription, { id: descId, children: description })) : null, hasError ? _jsx(FormMessage, { id: msgId, errors: errors }) : null] }));
+        } }));
+}
+//# sourceMappingURL=fields-date.js.map

package/dist/Form/fields-date.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields-date.js","sourceRoot":"","sources":["../../src/Form/fields-date.tsx"],"names":[],"mappings":"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"}

package/dist/Form/fields-text.d.ts

@@ -0,0 +1,47 @@
+import { type SearchFieldProps } from '../SearchField.js';
+import type { AnyFormApi, FormFieldValidators } from './types.js';
+export interface FormInputProps {
+    form: AnyFormApi;
+    name: string;
+    label: string;
+    description?: string;
+    required?: boolean;
+    placeholder?: string;
+    type?: string;
+    disabled?: boolean;
+    className?: string;
+    validators?: FormFieldValidators;
+}
+/** Input field integrated with TanStack Form. */
+export declare function FormInput({ form, name, label, description, required, placeholder, type, disabled, className, validators, }: FormInputProps): import("react/jsx-runtime").JSX.Element;
+export interface FormSearchFieldProps {
+    form: AnyFormApi;
+    name: string;
+    label: string;
+    description?: string;
+    required?: boolean;
+    placeholder?: string;
+    disabled?: boolean;
+    size?: SearchFieldProps['size'];
+    noClear?: boolean;
+    className?: string;
+    inputClassName?: string;
+    validators?: FormFieldValidators;
+}
+/** Search field integrated with TanStack Form. */
+export declare function FormSearchField({ form, name, label, description, required, placeholder, disabled, size, noClear, className, inputClassName, validators, }: FormSearchFieldProps): import("react/jsx-runtime").JSX.Element;
+export interface FormTextareaProps {
+    form: AnyFormApi;
+    name: string;
+    label: string;
+    description?: string;
+    required?: boolean;
+    placeholder?: string;
+    rows?: number;
+    disabled?: boolean;
+    className?: string;
+    validators?: FormFieldValidators;
+}
+/** Textarea field integrated with TanStack Form. */
+export declare function FormTextarea({ form, name, label, description, required, placeholder, rows, disabled, className, validators, }: FormTextareaProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=fields-text.d.ts.map

package/dist/Form/fields-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields-text.d.ts","sourceRoot":"","sources":["../../src/Form/fields-text.tsx"],"names":[],"mappings":"AASA,OAAO,EAAe,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAQvE,OAAO,KAAK,EAAE,UAAU,EAAoB,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAIpF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,mBAAmB,CAAC;CAClC;AAED,iDAAiD;AACjD,wBAAgB,SAAS,CAAC,EACxB,IAAI,EACJ,IAAI,EACJ,KAAK,EACL,WAAW,EACX,QAAQ,EACR,WAAW,EACX,IAAI,EACJ,QAAQ,EACR,SAAS,EACT,UAAU,GACX,EAAE,cAAc,2CAoChB;AAID,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,mBAAmB,CAAC;CAClC;AAED,kDAAkD;AAClD,wBAAgB,eAAe,CAAC,EAC9B,IAAI,EACJ,IAAI,EACJ,KAAK,EACL,WAAW,EACX,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,SAAS,EACT,cAAc,EACd,UAAU,GACX,EAAE,oBAAoB,2CAqCtB;AAID,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,mBAAmB,CAAC;CAClC;AAED,oDAAoD;AACpD,wBAAgB,YAAY,CAAC,EAC3B,IAAI,EACJ,IAAI,EACJ,KAAK,EACL,WAAW,EACX,QAAQ,EACR,WAAW,EACX,IAAI,EACJ,QAAQ,EACR,SAAS,EACT,UAAU,GACX,EAAE,iBAAiB,2CAoCnB"}

package/dist/Form/fields-text.js

@@ -0,0 +1,46 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Text-style fields integrated with TanStack Form: FormInput, FormSearchField,
+ * FormTextarea. Each wires `form.Field` to the matching UI primitive with
+ * label, description, and error display included.
+ */
+import { useId } from 'react';
+import { Input } from '../Input.js';
+import { SearchField } from '../SearchField.js';
+import { Textarea } from '../Textarea.js';
+import { FormDescription, FormItem, FormLabel, FormMessage, } from './building-blocks.js';
+/** Input field integrated with TanStack Form. */
+export function FormInput({ form, name, label, description, required, placeholder, type, disabled, className, validators, }) {
+    const id = useId();
+    const descId = `${id}-desc`;
+    const msgId = `${id}-msg`;
+    return (_jsx(form.Field, { name: name, ...(validators !== undefined && { validators }), children: (field) => {
+            const errors = field.state.meta.isTouched ? field.state.meta.errors : [];
+            const hasError = errors.length > 0;
+            return (_jsxs(FormItem, { ...(className !== undefined && { className }), children: [_jsx(FormLabel, { htmlFor: id, ...(required !== undefined && { required }), children: label }), _jsx(Input, { id: id, ...(type !== undefined && { type }), ...(placeholder !== undefined && { placeholder }), ...(disabled !== undefined && { disabled }), ...(required !== undefined && { required }), invalid: hasError, value: field.state.value ?? '', onChange: (e) => field.handleChange(e.target.value), onBlur: field.handleBlur, "aria-describedby": hasError ? msgId : description !== undefined ? descId : undefined }), description !== undefined ? (_jsx(FormDescription, { id: descId, children: description })) : null, hasError ? _jsx(FormMessage, { id: msgId, errors: errors }) : null] }));
+        } }));
+}
+/** Search field integrated with TanStack Form. */
+export function FormSearchField({ form, name, label, description, required, placeholder, disabled, size, noClear, className, inputClassName, validators, }) {
+    const id = useId();
+    const descId = `${id}-desc`;
+    const msgId = `${id}-msg`;
+    return (_jsx(form.Field, { name: name, ...(validators !== undefined && { validators }), children: (field) => {
+            const errors = field.state.meta.isTouched ? field.state.meta.errors : [];
+            const hasError = errors.length > 0;
+            return (_jsxs(FormItem, { ...(className !== undefined && { className }), children: [_jsx(FormLabel, { htmlFor: id, ...(required !== undefined && { required }), children: label }), _jsx(SearchField, { id: id, value: field.state.value ?? '', onValueChange: field.handleChange, onBlur: field.handleBlur, ...(placeholder !== undefined && { placeholder }), ...(disabled !== undefined && { disabled }), ...(size !== undefined && { size }), ...(noClear !== undefined && { noClear }), ...(inputClassName !== undefined && { inputClassName }), "aria-describedby": hasError ? msgId : description !== undefined ? descId : undefined, "aria-invalid": hasError }), description !== undefined ? (_jsx(FormDescription, { id: descId, children: description })) : null, hasError ? _jsx(FormMessage, { id: msgId, errors: errors }) : null] }));
+        } }));
+}
+/** Textarea field integrated with TanStack Form. */
+export function FormTextarea({ form, name, label, description, required, placeholder, rows, disabled, className, validators, }) {
+    const id = useId();
+    const descId = `${id}-desc`;
+    const msgId = `${id}-msg`;
+    return (_jsx(form.Field, { name: name, ...(validators !== undefined && { validators }), children: (field) => {
+            const errors = field.state.meta.isTouched ? field.state.meta.errors : [];
+            const hasError = errors.length > 0;
+            return (_jsxs(FormItem, { ...(className !== undefined && { className }), children: [_jsx(FormLabel, { htmlFor: id, ...(required !== undefined && { required }), children: label }), _jsx(Textarea, { id: id, ...(placeholder !== undefined && { placeholder }), ...(disabled !== undefined && { disabled }), ...(required !== undefined && { required }), ...(rows !== undefined && { rows }), invalid: hasError, value: field.state.value ?? '', onChange: (e) => field.handleChange(e.target.value), onBlur: field.handleBlur, "aria-describedby": hasError ? msgId : description !== undefined ? descId : undefined }), description !== undefined ? (_jsx(FormDescription, { id: descId, children: description })) : null, hasError ? _jsx(FormMessage, { id: msgId, errors: errors }) : null] }));
+        } }));
+}
+//# sourceMappingURL=fields-text.js.map

package/dist/Form/fields-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields-text.js","sourceRoot":"","sources":["../../src/Form/fields-text.tsx"],"names":[],"mappings":"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"}

package/dist/Form/fields-toggle.d.ts

@@ -0,0 +1,24 @@
+import type { AnyFormApi, FormFieldValidators } from './types.js';
+export interface FormCheckboxProps {
+    form: AnyFormApi;
+    name: string;
+    label: string;
+    description?: string;
+    disabled?: boolean;
+    className?: string;
+    validators?: FormFieldValidators;
+}
+/** Checkbox field integrated with TanStack Form. */
+export declare function FormCheckbox({ form, name, label, description, disabled, className, validators, }: FormCheckboxProps): import("react/jsx-runtime").JSX.Element;
+export interface FormSwitchProps {
+    form: AnyFormApi;
+    name: string;
+    label: string;
+    description?: string;
+    disabled?: boolean;
+    className?: string;
+    validators?: FormFieldValidators;
+}
+/** Switch field integrated with TanStack Form. */
+export declare function FormSwitch({ form, name, label, description, disabled, className, validators, }: FormSwitchProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=fields-toggle.d.ts.map

package/dist/Form/fields-toggle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields-toggle.d.ts","sourceRoot":"","sources":["../../src/Form/fields-toggle.tsx"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,UAAU,EAAoB,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAIpF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,mBAAmB,CAAC;CAClC;AAED,oDAAoD;AACpD,wBAAgB,YAAY,CAAC,EAC3B,IAAI,EACJ,IAAI,EACJ,KAAK,EACL,WAAW,EACX,QAAQ,EACR,SAAS,EACT,UAAU,GACX,EAAE,iBAAiB,2CA+BnB;AAID,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,mBAAmB,CAAC;CAClC;AAED,kDAAkD;AAClD,wBAAgB,UAAU,CAAC,EACzB,IAAI,EACJ,IAAI,EACJ,KAAK,EACL,WAAW,EACX,QAAQ,EACR,SAAS,EACT,UAAU,GACX,EAAE,eAAe,2CA+BjB"}

package/dist/Form/fields-toggle.js

@@ -0,0 +1,32 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Boolean / toggle fields integrated with TanStack Form: FormCheckbox, FormSwitch.
+ */
+import { useId } from 'react';
+import { Checkbox } from '../Checkbox.js';
+import { Switch } from '../Switch.js';
+import { FormDescription, FormItem, FormLabel, FormMessage, } from './building-blocks.js';
+/** Checkbox field integrated with TanStack Form. */
+export function FormCheckbox({ form, name, label, description, disabled, className, validators, }) {
+    const id = useId();
+    const descId = `${id}-desc`;
+    const msgId = `${id}-msg`;
+    return (_jsx(form.Field, { name: name, ...(validators !== undefined && { validators }), children: (field) => {
+            const errors = field.state.meta.isTouched ? field.state.meta.errors : [];
+            const hasError = errors.length > 0;
+            return (_jsxs(FormItem, { ...(className !== undefined && { className }), children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Checkbox, { id: id, checked: !!field.state.value, onCheckedChange: (checked) => field.handleChange(checked === true), ...(disabled !== undefined && { disabled }), "aria-describedby": hasError ? msgId : description !== undefined ? descId : undefined }), _jsx(FormLabel, { htmlFor: id, children: label })] }), description !== undefined ? (_jsx(FormDescription, { id: descId, children: description })) : null, hasError ? _jsx(FormMessage, { id: msgId, errors: errors }) : null] }));
+        } }));
+}
+/** Switch field integrated with TanStack Form. */
+export function FormSwitch({ form, name, label, description, disabled, className, validators, }) {
+    const id = useId();
+    const descId = `${id}-desc`;
+    const msgId = `${id}-msg`;
+    return (_jsx(form.Field, { name: name, ...(validators !== undefined && { validators }), children: (field) => {
+            const errors = field.state.meta.isTouched ? field.state.meta.errors : [];
+            const hasError = errors.length > 0;
+            return (_jsxs(FormItem, { ...(className !== undefined && { className }), children: [_jsxs("div", { className: "flex items-center gap-3", children: [_jsx(Switch, { id: id, checked: !!field.state.value, onCheckedChange: (checked) => field.handleChange(checked), ...(disabled !== undefined && { disabled }), "aria-describedby": hasError ? msgId : description !== undefined ? descId : undefined }), _jsx(FormLabel, { htmlFor: id, children: label })] }), description !== undefined ? (_jsx(FormDescription, { id: descId, children: description })) : null, hasError ? _jsx(FormMessage, { id: msgId, errors: errors }) : null] }));
+        } }));
+}
+//# sourceMappingURL=fields-toggle.js.map

package/dist/Form/fields-toggle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields-toggle.js","sourceRoot":"","sources":["../../src/Form/fields-toggle.tsx"],"names":[],"mappings":"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"}

package/dist/Form/helpers.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Form composition helpers: FormFieldArray, FormSubscribe, FormListenEffect,
+ * FormActions. These wire common TanStack Form patterns to MiHCM primitives.
+ */
+import { type ReactNode } from 'react';
+import type { AnyFormApi, FormFieldValidators } from './types.js';
+/** Render props supplied to each array item's `renderField` callback. */
+export interface FieldArrayItemApi {
+    /** Index of this item within the array. */
+    index: number;
+    /** Total number of items currently in the array. */
+    total: number;
+    /** Remove this item from the array. */
+    remove: () => void;
+}
+export interface FormFieldArrayProps {
+    form: AnyFormApi;
+    name: string;
+    label: string;
+    description?: string;
+    /** Render function called for each array item. */
+    renderField: (item: FieldArrayItemApi) => ReactNode;
+    /** Label text for the add button. Default: "Add item". */
+    addLabel?: string;
+    className?: string;
+    validators?: FormFieldValidators;
+}
+/** Field array integrated with TanStack Form. Provides add/remove buttons. */
+export declare function FormFieldArray({ form, name, label, description, renderField, addLabel, className, validators, }: FormFieldArrayProps): import("react/jsx-runtime").JSX.Element;
+export interface FormSubscribeProps<TSelected> {
+    form: AnyFormApi;
+    /** Selector function that picks values from form state. */
+    selector: (state: any) => TSelected;
+    /** Render function receiving the selected state. */
+    children: (selected: TSelected) => ReactNode;
+}
+/** Convenience wrapper around `form.Subscribe` for reactive state display. */
+export declare function FormSubscribe<TSelected>({ form, selector, children, }: FormSubscribeProps<TSelected>): import("react/jsx-runtime").JSX.Element;
+export interface FormListenEffectProps {
+    form: AnyFormApi;
+    /** Field name to listen to. */
+    name: string;
+    /** Listener callbacks (onChange, onBlur, etc.) for side effects. */
+    listeners: Record<string, any>;
+}
+/**
+ * Invisible field that fires side effects when another field changes.
+ * Useful for dependent field updates (e.g. country changes → reset city).
+ * Renders nothing visually.
+ */
+export declare function FormListenEffect({ form, name, listeners }: FormListenEffectProps): import("react/jsx-runtime").JSX.Element;
+export interface FormActionsProps {
+    form: AnyFormApi;
+    /** Label for the submit button. Default: "Submit". */
+    submitLabel?: string;
+    /** Label for the reset button. Default: "Reset". */
+    resetLabel?: string;
+    /** Whether to show the reset button. Default: true. */
+    showReset?: boolean;
+    /** Disable both buttons externally. */
+    disabled?: boolean;
+    className?: string;
+}
+/** Footer with submit and reset buttons. Reacts to form submitting state. */
+export declare function FormActions({ form, submitLabel, resetLabel, showReset, disabled, className, }: FormActionsProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/Form/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/Form/helpers.tsx"],"names":[],"mappings":"AAEA;;;GAGG;AACH,OAAO,EAAS,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAQ9C,OAAO,KAAK,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAIlE,yEAAyE;AACzE,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,WAAW,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,SAAS,CAAC;IACpD,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,mBAAmB,CAAC;CAClC;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,EAC7B,IAAI,EACJ,IAAI,EACJ,KAAK,EACL,WAAW,EACX,WAAW,EACX,QAAqB,EACrB,SAAS,EACT,UAAU,GACX,EAAE,mBAAmB,2CAwCrB;AAID,MAAM,WAAW,kBAAkB,CAAC,SAAS;IAC3C,IAAI,EAAE,UAAU,CAAC;IACjB,2DAA2D;IAE3D,QAAQ,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,SAAS,CAAC;IACpC,oDAAoD;IACpD,QAAQ,EAAE,CAAC,QAAQ,EAAE,SAAS,KAAK,SAAS,CAAC;CAC9C;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,SAAS,EAAE,EACvC,IAAI,EACJ,QAAQ,EACR,QAAQ,GACT,EAAE,kBAAkB,CAAC,SAAS,CAAC,2CAE/B;AAID,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,UAAU,CAAC;IACjB,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IAEpE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,qBAAqB,2CAMhF;AAID,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,UAAU,CAAC;IACjB,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,EAC1B,IAAI,EACJ,WAAsB,EACtB,UAAoB,EACpB,SAAgB,EAChB,QAAQ,EACR,SAAS,GACV,EAAE,gBAAgB,2CA4BlB"}

package/dist/Form/helpers.js

@@ -0,0 +1,44 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Form composition helpers: FormFieldArray, FormSubscribe, FormListenEffect,
+ * FormActions. These wire common TanStack Form patterns to MiHCM primitives.
+ */
+import { useId } from 'react';
+import { cn } from '../internal/cn.js';
+import { Button } from '../Button.js';
+import { FormDescription, FormItem, FormLabel, } from './building-blocks.js';
+/** Field array integrated with TanStack Form. Provides add/remove buttons. */
+export function FormFieldArray({ form, name, label, description, renderField, addLabel = 'Add item', className, validators, }) {
+    const id = useId();
+    const descId = `${id}-desc`;
+    return (_jsx(form.Field, { name: name, mode: "array", ...(validators !== undefined && { validators }), children: (field) => {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const items = (field.state.value ?? []);
+            return (_jsxs(FormItem, { ...(className !== undefined && { className }), children: [_jsxs("div", { className: "flex items-center justify-between", children: [_jsx(FormLabel, { children: label }), _jsxs(Button, { type: "button", variant: "outline", size: "sm", onClick: () => field.pushValue({}), children: ["+ ", addLabel] })] }), description !== undefined ? (_jsx(FormDescription, { id: descId, children: description })) : null, _jsx("div", { className: "space-y-3", children: items.map((_, i) => (_jsx("div", { className: "rounded-lg border border-border p-3 transition-all duration-150", children: renderField({
+                                index: i,
+                                total: items.length,
+                                remove: () => field.removeValue(i),
+                            }) }, i))) })] }));
+        } }));
+}
+/** Convenience wrapper around `form.Subscribe` for reactive state display. */
+export function FormSubscribe({ form, selector, children, }) {
+    return _jsx(form.Subscribe, { selector: selector, children: children });
+}
+/**
+ * Invisible field that fires side effects when another field changes.
+ * Useful for dependent field updates (e.g. country changes → reset city).
+ * Renders nothing visually.
+ */
+export function FormListenEffect({ form, name, listeners }) {
+    return (_jsx(form.Field, { name: name, listeners: listeners, children: () => null }));
+}
+/** Footer with submit and reset buttons. Reacts to form submitting state. */
+export function FormActions({ form, submitLabel = 'Submit', resetLabel = 'Reset', showReset = true, disabled, className, }) {
+    return (_jsx(form.Subscribe, { selector: (s) => ({
+            canSubmit: s.canSubmit,
+            isSubmitting: s.isSubmitting,
+        }), children: (state) => (_jsxs("div", { className: cn('flex items-center gap-3 pt-2', className), children: [_jsx(Button, { type: "submit", disabled: disabled || !state.canSubmit, children: state.isSubmitting ? 'Submitting...' : submitLabel }), showReset ? (_jsx(Button, { type: "button", variant: "outline", disabled: disabled || state.isSubmitting, onClick: () => form.reset(), children: resetLabel })) : null] })) }));
+}
+//# sourceMappingURL=helpers.js.map

package/dist/Form/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/Form/helpers.tsx"],"names":[],"mappings":"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"}

package/dist/Form/types.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Shared Form types.
+ *
+ * Wraps TanStack React Form's internals at the boundary so the rest of the
+ * field components can stay strongly typed without leaking 12-param generics.
+ */
+/** Validator config passed through to TanStack Form's `form.Field`. */
+export type FormFieldValidators = Record<string, any>;
+export type AnyFormApi = any;
+/**
+ * Field render-prop shape — kept minimal to avoid coupling to TanStack
+ * internals that change across minor versions.
+ */
+export interface FieldRenderProps<T> {
+    state: {
+        value: T;
+        meta: {
+            errors: string[];
+            isTouched: boolean;
+        };
+    };
+    handleChange: (v: T) => void;
+    handleBlur: () => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/Form/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/Form/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,uEAAuE;AAEvE,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAGtD,MAAM,MAAM,UAAU,GAAG,GAAG,CAAC;AAE7B;;;GAGG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,KAAK,EAAE;QACL,KAAK,EAAE,CAAC,CAAC;QACT,IAAI,EAAE;YAAE,MAAM,EAAE,MAAM,EAAE,CAAC;YAAC,SAAS,EAAE,OAAO,CAAA;SAAE,CAAC;KAChD,CAAC;IACF,YAAY,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;IAC7B,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB"}

package/dist/Form/types.js

@@ -0,0 +1,8 @@
+/**
+ * Shared Form types.
+ *
+ * Wraps TanStack React Form's internals at the boundary so the rest of the
+ * field components can stay strongly typed without leaking 12-param generics.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/Form/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/Form/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}