@fuf-stack/uniform 1.22.4 → 1.22.6

package/dist/Checkboxes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/Checkboxes/Checkboxes.tsx"],"mappings":";;;;;cAoBa,kBAAA,IAAkB,KAAA;;;;gbAmC7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;obAEe;;;;wbACH;IAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mbA2CM;mbAAA;obAQjB;sbAAe;2bAAA;ybARE;ybAAA;0bAAA;icAAA;4bAAA;IAAA;;;;ubAAA;mbAAA;obAAA;sbAAA;2bAQjB;ybAAe;ybAAA;0bAiHjB;icAAA;;;;;;;;;;;;;;;;;;KArKI,YAAA,GAAe,OAAO,QAAQ,kBAAA;AAAA,KAC9B,SAAA,GAAY,WAAW,QAAQ,kBAAA;AAAA,UAEnB,cAAA;;EAEf,KAAA,GAAQ,SAAA;;EAER,YAAA,GAAe,SAAS;;EAExB,KAAA;;EAEA,QAAA;;EAEA,MAAA;AAAA;AAAA,UAGe,eAAA,SAAwB,YAAA;;EAEvC,SAAA;;EAEA,SAAA,GAAY,SAAA;;EAEZ,KAAA,GAAQ,YAAA;;EAER,QAAA;;EAEA,MAAA;;EAEA,KAAA,GAAQ,SAAA;;EAER,WAAA;;EAEA,IAAA;;EAEA,OAAA,EAAS,cAAA;;EAET,MAAA;;EAEA,SAAA,GAAY,mBAAA;AAAA;;;;cAMR,UAAA;EAAc,SAAA;EAAA,KAAA;EAAA,MAAA;EAAA,WAAA;EAAA,OAAA;EAAA,IAAA;EAAA,GAAA;AAAA,GAQjB,eAAA,iCAAe,GAAA,CAAA,OAAA"}

package/dist/Checkboxes/index.js

@@ -1,2 +1,112 @@
-import { n as Checkboxes, t as Checkboxes_default } from "../Checkboxes-D1hppxDE.js";
-export { Checkboxes, Checkboxes_default as default };
+import { t as FieldValidationError_default } from "../FieldValidationError-ByRoIxaM.js";
+import { useUniformField } from "../hooks/useUniformField/index.js";
+import { Checkbox, CheckboxGroup } from "@heroui/checkbox";
+import { checkbox } from "@heroui/theme";
+import { slugify, tv, variantsToClassNames } from "@fuf-stack/pixel-utils";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/Checkboxes/Checkboxes.tsx
+const checkboxesVariants = tv({
+	slots: {
+		base: "group",
+		errorMessage: "text-tiny",
+		label: "inline-flex text-sm text-foreground subpixel-antialiased group-data-[invalid=true]:!text-danger",
+		optionBase: "",
+		optionIcon: "",
+		optionLabel: "",
+		optionLabelSubline: "text-foreground-400 !text-small",
+		optionWrapper: "",
+		wrapper: ""
+	},
+	variants: {
+		color: {
+			info: { wrapper: "text-info-foreground after:bg-info after:text-info-foreground" },
+			...checkbox.variants.color
+		},
+		lineThrough: { true: {
+			optionLabel: [...checkbox.variants.lineThrough.true.label, "relative before:transition-all before:duration-200"],
+			optionLabelSubline: "group-data-[selected=true]:opacity-60"
+		} }
+	}
+});
+/**
+* Checkboxes component based on [HeroUI CheckboxGroup](https://www.heroui.com//docs/components/checkbox-group)
+*/
+const Checkboxes = ({ className = void 0, color = "primary", inline = false, lineThrough = false, options, name, ...uniformFieldProps }) => {
+	const { ariaLabel, disabled, error: _error, field: { onChange, value: fieldValue, ref, onBlur }, invalid, label, required, testId } = useUniformField({
+		name,
+		...uniformFieldProps
+	});
+	const value = Array.isArray(fieldValue) ? fieldValue : [];
+	const errorMessage = /* @__PURE__ */ jsx(FieldValidationError_default, {
+		error: (_error && Object.values(_error).flat()) ?? [],
+		testId
+	});
+	const classNames = variantsToClassNames(checkboxesVariants({ lineThrough }), className, "base");
+	const heroCheckboxGroupClassNames = {
+		base: classNames.base,
+		label: classNames.label,
+		wrapper: classNames.wrapper
+	};
+	const heroCheckboxClassNames = {
+		base: classNames.optionBase,
+		icon: classNames.optionIcon,
+		label: classNames.optionLabel,
+		wrapper: classNames.optionWrapper
+	};
+	return /* @__PURE__ */ jsx(CheckboxGroup, {
+		ref,
+		"aria-label": ariaLabel,
+		classNames: heroCheckboxGroupClassNames,
+		color: color === "info" ? "primary" : color,
+		"data-invalid": invalid,
+		"data-testid": testId,
+		errorMessage,
+		isDisabled: disabled,
+		isInvalid: invalid,
+		isRequired: required,
+		label: label ? /* @__PURE__ */ jsx("legend", { children: label }) : null,
+		name,
+		onBlur,
+		onChange,
+		orientation: inline ? "horizontal" : "vertical",
+		value,
+		children: options?.map((option) => {
+			const optionTestId = slugify(`${testId}_option_${option?.testId ?? option?.value}`, { replaceDots: true });
+			const hasSubline = !!option.labelSubline;
+			let labelContent;
+			let optionClassNames = heroCheckboxClassNames;
+			if (hasSubline) {
+				labelContent = /* @__PURE__ */ jsxs("div", {
+					className: "flex grow flex-col items-start",
+					children: [/* @__PURE__ */ jsx("span", {
+						className: classNames.optionLabel,
+						children: option.label
+					}), /* @__PURE__ */ jsx("span", {
+						className: classNames.optionLabelSubline,
+						children: option.labelSubline
+					})]
+				});
+				optionClassNames = {
+					...optionClassNames,
+					label: ""
+				};
+			} else labelContent = option.label;
+			return /* @__PURE__ */ jsx(Checkbox, {
+				"aria-label": typeof option.label === "string" ? option.label : option.value,
+				classNames: optionClassNames,
+				"data-invalid": invalid,
+				"data-testid": optionTestId,
+				isDisabled: !!disabled || option.disabled,
+				value: option?.value,
+				children: labelContent
+			}, `index_${option.value}`);
+		})
+	});
+};
+//#endregion
+//#region src/Checkboxes/index.ts
+var Checkboxes_default = Checkboxes;
+//#endregion
+export { checkboxesVariants, Checkboxes_default as default };
+
+//# sourceMappingURL=index.js.map

package/dist/Checkboxes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["heroCheckboxVariants","FieldValidationError","HeroCheckboxGroup","HeroCheckbox"],"sources":["../../src/Checkboxes/Checkboxes.tsx","../../src/Checkboxes/index.ts"],"sourcesContent":["import type { TVClassName, TVProps } from '@fuf-stack/pixel-utils';\nimport type {\n  CheckboxGroupProps as HeroCheckboxGroupProps,\n  CheckboxProps as HeroCheckboxProps,\n} from '@heroui/checkbox';\nimport type { ReactNode } from 'react';\nimport type { FieldError } from 'react-hook-form';\nimport type { InputValueTransform } from '../hooks/useInputValueTransform';\n\nimport {\n  Checkbox as HeroCheckbox,\n  CheckboxGroup as HeroCheckboxGroup,\n} from '@heroui/checkbox';\nimport { checkbox as heroCheckboxVariants } from '@heroui/theme';\n\nimport { slugify, tv, variantsToClassNames } from '@fuf-stack/pixel-utils';\n\nimport { useUniformField } from '../hooks/useUniformField';\nimport FieldValidationError from '../partials/FieldValidationError';\n\nexport const checkboxesVariants = tv({\n  slots: {\n    base: 'group', // Needs group for group-data condition\n    errorMessage: 'text-tiny',\n    // see HeroUI styles for group-data condition,\n    // e.g.: https://github.com/heroui-inc/heroui/blob/main/packages/core/theme/src/components/select.ts\n    label:\n      'inline-flex text-sm text-foreground subpixel-antialiased group-data-[invalid=true]:!text-danger',\n    optionBase: '',\n    optionIcon: '',\n    optionLabel: '',\n    optionLabelSubline: 'text-foreground-400 !text-small',\n    optionWrapper: '',\n    wrapper: '',\n  },\n  variants: {\n    // see: https://github.com/heroui-inc/heroui/blob/canary/packages/core/theme/src/components/checkbox.ts\n    color: {\n      info: {\n        wrapper:\n          'text-info-foreground after:bg-info after:text-info-foreground',\n      },\n      ...heroCheckboxVariants.variants.color,\n    } as const,\n    lineThrough: {\n      true: {\n        optionLabel: [\n          ...heroCheckboxVariants.variants.lineThrough.true.label,\n          // fix stroke position when used with subline and enable animation\n          'relative before:transition-all before:duration-200',\n        ],\n        optionLabelSubline: 'group-data-[selected=true]:opacity-60',\n      },\n    },\n  },\n});\n\ntype VariantProps = TVProps<typeof checkboxesVariants>;\ntype ClassName = TVClassName<typeof checkboxesVariants>;\n\nexport interface CheckboxOption {\n  /** option label */\n  label?: ReactNode;\n  /** subline displayed below the label */\n  labelSubline?: ReactNode;\n  /** option value */\n  value: string;\n  /** disables the option */\n  disabled?: boolean;\n  /** HTML data-testid attribute of the option */\n  testId?: string;\n}\n\nexport interface CheckboxesProps extends VariantProps {\n  /** Custom aria-label for accessibility. If not provided, falls back to field name when no visible label exists */\n  ariaLabel?: string;\n  /** CSS class name */\n  className?: ClassName;\n  /** Color scheme of the checkboxes */\n  color?: VariantProps['color'];\n  /** Sets all checkboxes disabled */\n  disabled?: boolean;\n  /** Orientation of the checkboxes */\n  inline?: boolean;\n  /** Label displayed above the checkboxes */\n  label?: ReactNode;\n  /** Whether the checkboxes label should be crossed out */\n  lineThrough?: boolean;\n  /** Name the Field is registered on the form */\n  name: string;\n  /** Checkboxes that should be displayed. */\n  options: CheckboxOption[];\n  /** HTML data-testid attribute used in e2e tests */\n  testId?: string;\n  /** allows disentangled display and form values for a field */\n  transform?: InputValueTransform<string[]>;\n}\n\n/**\n * Checkboxes component based on [HeroUI CheckboxGroup](https://www.heroui.com//docs/components/checkbox-group)\n */\nconst Checkboxes = ({\n  className = undefined,\n  color = 'primary',\n  inline = false,\n  lineThrough = false,\n  options,\n  name,\n  ...uniformFieldProps\n}: CheckboxesProps) => {\n  const {\n    ariaLabel,\n    disabled,\n    error: _error,\n    field: { onChange, value: fieldValue, ref, onBlur },\n    invalid,\n    label,\n    required,\n    testId,\n  } = useUniformField({\n    name,\n    ...uniformFieldProps,\n  });\n\n  // Ensure value is always an array (checkboxes need arrays)\n  const value = Array.isArray(fieldValue) ? fieldValue : [];\n\n  // Convert React Hook Form's nested error object structure to a flat array\n  // RHF errors can be nested like: checkboxField.0 (individual checkbox errors)\n  // and checkboxField._error (global field errors) - this flattens all\n  // error values into a single array for rendering with FieldValidationError\n  const errorFlat: FieldError[] =\n    (_error &&\n      Object.values(\n        _error as unknown as Record<string, FieldError[]>,\n      ).flat()) ??\n    [];\n  const errorMessage = (\n    <FieldValidationError error={errorFlat} testId={testId} />\n  );\n\n  // classNames from slots\n  const variants = checkboxesVariants({ lineThrough });\n  const classNames = variantsToClassNames(variants, className, 'base');\n\n  // map slots to HeroUI class names\n  const heroCheckboxGroupClassNames: HeroCheckboxGroupProps['classNames'] = {\n    base: classNames.base,\n    label: classNames.label,\n    wrapper: classNames.wrapper,\n  };\n  const heroCheckboxClassNames: HeroCheckboxProps['classNames'] = {\n    base: classNames.optionBase,\n    icon: classNames.optionIcon,\n    label: classNames.optionLabel,\n    wrapper: classNames.optionWrapper,\n  };\n\n  return (\n    <HeroCheckboxGroup\n      ref={ref}\n      aria-label={ariaLabel}\n      classNames={heroCheckboxGroupClassNames}\n      color={color === 'info' ? 'primary' : color}\n      // see HeroUI styles for group-data condition (data-invalid),\n      // e.g.: https://github.com/heroui-inc/heroui/blob/main/packages/components/select/src/use-select.ts\n      data-invalid={invalid}\n      data-testid={testId}\n      errorMessage={errorMessage}\n      isDisabled={disabled}\n      isInvalid={invalid}\n      isRequired={required}\n      label={label ? <legend>{label}</legend> : null}\n      name={name}\n      onBlur={onBlur}\n      onChange={onChange}\n      orientation={inline ? 'horizontal' : 'vertical'}\n      value={value}\n    >\n      {options?.map((option) => {\n        const optionTestId = slugify(\n          `${testId}_option_${option?.testId ?? option?.value}`,\n          { replaceDots: true },\n        );\n\n        // set content and classes depending option has subline\n        const hasSubline = !!option.labelSubline;\n        let labelContent: ReactNode;\n        let optionClassNames = heroCheckboxClassNames;\n        if (hasSubline) {\n          labelContent = (\n            <div className=\"flex grow flex-col items-start\">\n              <span className={classNames.optionLabel}>{option.label}</span>\n              <span className={classNames.optionLabelSubline}>\n                {option.labelSubline}\n              </span>\n            </div>\n          );\n          // remove label classes from outer label when subline is used\n          optionClassNames = { ...optionClassNames, label: '' };\n        } else {\n          labelContent = option.label;\n        }\n\n        return (\n          <HeroCheckbox\n            key={`index_${option.value}`}\n            aria-label={\n              typeof option.label === 'string' ? option.label : option.value\n            }\n            classNames={optionClassNames}\n            data-invalid={invalid}\n            data-testid={optionTestId}\n            isDisabled={!!disabled || option.disabled}\n            value={option?.value}\n          >\n            {labelContent}\n          </HeroCheckbox>\n        );\n      })}\n    </HeroCheckboxGroup>\n  );\n};\n\nexport default Checkboxes;\n","import Checkboxes from './Checkboxes';\n\nexport type { CheckboxesProps, CheckboxOption } from './Checkboxes';\n\nexport { checkboxesVariants } from './Checkboxes';\n\nexport default Checkboxes;\n"],"mappings":";;;;;;;AAoBA,MAAa,qBAAqB,GAAG;CACnC,OAAO;EACL,MAAM;EACN,cAAc;EAGd,OACE;EACF,YAAY;EACZ,YAAY;EACZ,aAAa;EACb,oBAAoB;EACpB,eAAe;EACf,SAAS;CACX;CACA,UAAU;EAER,OAAO;GACL,MAAM,EACJ,SACE,gEACJ;GACA,GAAGA,SAAqB,SAAS;EACnC;EACA,aAAa,EACX,MAAM;GACJ,aAAa,CACX,GAAGA,SAAqB,SAAS,YAAY,KAAK,OAElD,oDACF;GACA,oBAAoB;EACtB,EACF;CACF;AACF,CAAC;;;;AA8CD,MAAM,cAAc,EAClB,YAAY,KAAA,GACZ,QAAQ,WACR,SAAS,OACT,cAAc,OACd,SACA,MACA,GAAG,wBACkB;CACrB,MAAM,EACJ,WACA,UACA,OAAO,QACP,OAAO,EAAE,UAAU,OAAO,YAAY,KAAK,UAC3C,SACA,OACA,UACA,WACE,gBAAgB;EAClB;EACA,GAAG;CACL,CAAC;CAGD,MAAM,QAAQ,MAAM,QAAQ,UAAU,IAAI,aAAa,CAAC;CAYxD,MAAM,eACJ,oBAACC,8BAAD;EAAsB,QANrB,UACC,OAAO,OACL,MACF,EAAE,KAAK,MACT,CAAC;EAE+C;CAAS,CAAA;CAK3D,MAAM,aAAa,qBADF,mBAAmB,EAAE,YAAY,CACH,GAAG,WAAW,MAAM;CAGnE,MAAM,8BAAoE;EACxE,MAAM,WAAW;EACjB,OAAO,WAAW;EAClB,SAAS,WAAW;CACtB;CACA,MAAM,yBAA0D;EAC9D,MAAM,WAAW;EACjB,MAAM,WAAW;EACjB,OAAO,WAAW;EAClB,SAAS,WAAW;CACtB;CAEA,OACE,oBAACC,eAAD;EACO;EACL,cAAY;EACZ,YAAY;EACZ,OAAO,UAAU,SAAS,YAAY;EAGtC,gBAAc;EACd,eAAa;EACC;EACd,YAAY;EACZ,WAAW;EACX,YAAY;EACZ,OAAO,QAAQ,oBAAC,UAAD,EAAA,UAAS,MAAc,CAAA,IAAI;EACpC;EACE;EACE;EACV,aAAa,SAAS,eAAe;EAC9B;YAEN,SAAS,KAAK,WAAW;GACxB,MAAM,eAAe,QACnB,GAAG,OAAO,UAAU,QAAQ,UAAU,QAAQ,SAC9C,EAAE,aAAa,KAAK,CACtB;GAGA,MAAM,aAAa,CAAC,CAAC,OAAO;GAC5B,IAAI;GACJ,IAAI,mBAAmB;GACvB,IAAI,YAAY;IACd,eACE,qBAAC,OAAD;KAAK,WAAU;eAAf,CACE,oBAAC,QAAD;MAAM,WAAW,WAAW;gBAAc,OAAO;KAAY,CAAA,GAC7D,oBAAC,QAAD;MAAM,WAAW,WAAW;gBACzB,OAAO;KACJ,CAAA,CACH;;IAGP,mBAAmB;KAAE,GAAG;KAAkB,OAAO;IAAG;GACtD,OACE,eAAe,OAAO;GAGxB,OACE,oBAACC,UAAD;IAEE,cACE,OAAO,OAAO,UAAU,WAAW,OAAO,QAAQ,OAAO;IAE3D,YAAY;IACZ,gBAAc;IACd,eAAa;IACb,YAAY,CAAC,CAAC,YAAY,OAAO;IACjC,OAAO,QAAQ;cAEd;GACW,GAXP,SAAS,OAAO,OAWT;EAElB,CAAC;CACgB,CAAA;AAEvB;;;ACxNA,IAAA,qBAAe"}

package/dist/DatePicker/index.cjs

@@ -2,6 +2,197 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_DatePicker = require("../DatePicker-DuBjvS5g.cjs");
-exports.DatePicker = require_DatePicker.DatePicker;
-exports.default = require_DatePicker.DatePicker_default;
+const require_hooks_useUniformField_index = require("../hooks/useUniformField/index.cjs");
+let _fuf_stack_pixel_utils = require("@fuf-stack/pixel-utils");
+let react_jsx_runtime = require("react/jsx-runtime");
+let _heroui_date_picker = require("@heroui/date-picker");
+let _internationalized_date = require("@internationalized/date");
+//#region src/DatePicker/dateHelpers.ts
+/** Cast unknown input to the DatePicker value union type. */
+const asDatePickerValue = (value) => {
+	return value;
+};
+/** Check whether a value already looks like an @internationalized/date object. */
+const isDateValueLike = (value) => {
+	return !!value && typeof value === "object" && "calendar" in value;
+};
+/** True for ISO datetime strings that do not yet include timezone information. */
+const isNaiveDateTimeString = (value) => {
+	return /^\d{4}-\d{2}-\d{2}T/.test(value) && !hasExplicitTimeZone(value);
+};
+/** True when an input already carries timezone/offset information. */
+const hasExplicitTimeZone = (value) => {
+	if (value.includes("[") && value.includes("]")) return true;
+	return /(?:[zZ]|[+-]\d{2}:\d{2})$/.test(value);
+};
+/** Safely run a parser and return `null` on parsing errors. */
+const tryParse = (parser) => {
+	try {
+		return asDatePickerValue(parser());
+	} catch {
+		return null;
+	}
+};
+/**
+* Parse a form value into a HeroUI DatePicker compatible `DateValue`.
+*
+* Accepts existing `DateValue` objects, native `Date` instances, and ISO-like
+* strings (date, date-time, zoned, and absolute). Returns `null` when the value
+* is empty or cannot be parsed.
+*/
+const parseDateValue = (value, timeZone) => {
+	if (value == null || value === "") return null;
+	if (isDateValueLike(value)) return asDatePickerValue(value);
+	if (value instanceof Date) return asDatePickerValue(timeZone ? (0, _internationalized_date.parseAbsolute)(value.toISOString(), timeZone) : (0, _internationalized_date.parseAbsoluteToLocal)(value.toISOString()));
+	if (typeof value !== "string") return null;
+	const normalizedValue = value.trim();
+	if (normalizedValue === "") return null;
+	if (/^\d{4}-\d{2}-\d{2}$/.test(normalizedValue)) return tryParse(() => {
+		return (0, _internationalized_date.parseDate)(normalizedValue);
+	});
+	return [
+		...timeZone && isNaiveDateTimeString(normalizedValue) ? [() => {
+			return (0, _internationalized_date.parseZonedDateTime)(`${normalizedValue}[${timeZone}]`);
+		}] : [],
+		() => {
+			return timeZone ? (0, _internationalized_date.parseAbsolute)(normalizedValue, timeZone) : (0, _internationalized_date.parseAbsoluteToLocal)(normalizedValue);
+		},
+		() => {
+			return (0, _internationalized_date.parseZonedDateTime)(normalizedValue);
+		},
+		() => {
+			return (0, _internationalized_date.parseDateTime)(normalizedValue);
+		},
+		() => {
+			return (0, _internationalized_date.parseDate)(normalizedValue);
+		}
+	].map((parser) => {
+		return tryParse(parser);
+	}).find((parsedValue) => {
+		return parsedValue != null;
+	}) ?? null;
+};
+/** Resolve the timezone used by the DatePicker when time fields are enabled. */
+const resolveDatePickerTimeZone = (withTime, timeZone) => {
+	if (!withTime) return timeZone;
+	return timeZone ?? (0, _internationalized_date.getLocalTimeZone)();
+};
+/** Build the default placeholder value for time-enabled pickers. */
+const getDatePickerPlaceholderValue = (withTime, timeZone) => {
+	const resolvedTimeZone = resolveDatePickerTimeZone(withTime, timeZone);
+	if (!resolvedTimeZone || !withTime) return;
+	return asDatePickerValue((0, _internationalized_date.now)(resolvedTimeZone));
+};
+/**
+* Convert a date value into a UTC ISO string.
+*
+* `CalendarDate` and `CalendarDateTime` values are interpreted in the provided
+* timezone. `ZonedDateTime` values use their own timezone and offset.
+*/
+const dateValueToUtcIsoString = (value, timeZone) => {
+	if (value == null) return null;
+	const maybeWithAbsoluteString = value;
+	if (typeof maybeWithAbsoluteString.toAbsoluteString === "function") return maybeWithAbsoluteString.toAbsoluteString();
+	const maybeWithToDate = value;
+	if (typeof maybeWithToDate.toDate === "function") return maybeWithToDate.toDate(timeZone).toISOString();
+	return null;
+};
+//#endregion
+//#region src/DatePicker/DatePicker.tsx
+const datePickerVariants = (0, _fuf_stack_pixel_utils.tv)({ slots: {
+	/** wrapper around the whole date picker */
+	base: "",
+	/** helper wrapper for error/description */
+	helperWrapper: ["p-0"],
+	/** the calendar element */
+	calendar: "",
+	/** the calendar's content element */
+	calendarContent: "",
+	/**
+	* inner wrapper (HeroUI inputWrapper slot)
+	*
+	* NOTE: Unlike HeroUI Input, the DatePicker does not expose a
+	* `data-focus` indicator on the group, so the focus border has to be
+	* driven by the native `focus-within` state of the segment inputs.
+	*/
+	inputWrapper: "bg-content1 focus-within:border-focus",
+	/** the calendar popover element */
+	popoverContent: "",
+	/** selector button element */
+	selectorButton: "",
+	/** selector icon element */
+	selectorIcon: "",
+	/** the time-input component element */
+	timeInput: "",
+	/** the time-input component's label element */
+	timeInputLabel: ""
+} });
+/**
+* DatePicker component based on [HeroUI DatePicker](https://v2.heroui.com/docs/components/date-picker)
+*/
+const DatePicker = ({ className: _className = void 0, hourCycle = 24, hideTimeZone = false, maxValue = void 0, minValue = void 0, name, timeZone = void 0, valueType = "string", withTime = false, ...uniformFieldProps }) => {
+	const { ariaLabel, disabled, errorMessage, field: { onBlur, onChange, value }, invalid, label, required, testId } = require_hooks_useUniformField_index.useUniformField({
+		name,
+		...uniformFieldProps
+	});
+	const classNames = (0, _fuf_stack_pixel_utils.variantsToClassNames)(datePickerVariants(), _className, "base");
+	const resolvedTimeZone = resolveDatePickerTimeZone(withTime, timeZone);
+	const parsedValue = parseDateValue(value, withTime ? resolvedTimeZone : timeZone);
+	const placeholderValue = getDatePickerPlaceholderValue(withTime, timeZone);
+	const parsedMinValue = parseDateValue(minValue, withTime ? resolvedTimeZone : timeZone);
+	const parsedMaxValue = parseDateValue(maxValue, withTime ? resolvedTimeZone : timeZone);
+	const handleChange = (nextValue) => {
+		if (nextValue == null) {
+			onChange(null);
+			return;
+		}
+		if (valueType === "dateValue") {
+			onChange(nextValue);
+			return;
+		}
+		onChange(dateValueToUtcIsoString(nextValue, resolvedTimeZone ?? "UTC") ?? String(nextValue));
+	};
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_heroui_date_picker.DatePicker, {
+		"aria-label": label ? void 0 : ariaLabel,
+		classNames: {
+			base: classNames.base,
+			calendar: classNames.calendar,
+			calendarContent: classNames.calendarContent,
+			helperWrapper: classNames.helperWrapper,
+			inputWrapper: classNames.inputWrapper,
+			popoverContent: classNames.popoverContent,
+			selectorButton: classNames.selectorButton,
+			selectorIcon: classNames.selectorIcon,
+			timeInput: classNames.timeInput,
+			timeInputLabel: classNames.timeInputLabel
+		},
+		"data-testid": testId,
+		errorMessage,
+		granularity: withTime ? "minute" : "day",
+		hideTimeZone,
+		hourCycle,
+		id: testId,
+		isDisabled: disabled,
+		isInvalid: invalid,
+		isRequired: required,
+		label,
+		labelPlacement: "outside",
+		maxValue: parsedMaxValue,
+		minValue: parsedMinValue,
+		name,
+		onBlur,
+		onChange: handleChange,
+		placeholderValue,
+		radius: "sm",
+		value: parsedValue,
+		variant: "bordered"
+	});
+};
+//#endregion
+//#region src/DatePicker/index.ts
+var DatePicker_default = DatePicker;
+//#endregion
+exports.datePickerVariants = datePickerVariants;
+exports.default = DatePicker_default;
+
+//# sourceMappingURL=index.cjs.map

package/dist/DatePicker/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["useUniformField","HeroDatePicker"],"sources":["../../src/DatePicker/dateHelpers.ts","../../src/DatePicker/DatePicker.tsx","../../src/DatePicker/index.ts"],"sourcesContent":["import type { DatePicker as HeroDatePicker } from '@heroui/date-picker';\nimport type { ComponentProps } from 'react';\n\nimport {\n  getLocalTimeZone,\n  now,\n  parseAbsolute,\n  parseAbsoluteToLocal,\n  parseDate,\n  parseDateTime,\n  parseZonedDateTime,\n} from '@internationalized/date';\n\n/** Value type accepted by the HeroUI DatePicker */\nexport type DatePickerValue = ComponentProps<typeof HeroDatePicker>['value'];\n\n/** Cast unknown input to the DatePicker value union type. */\nconst asDatePickerValue = (value: unknown): DatePickerValue => {\n  return value as DatePickerValue;\n};\n\n/** Check whether a value already looks like an @internationalized/date object. */\nconst isDateValueLike = (value: unknown): value is object => {\n  return !!value && typeof value === 'object' && 'calendar' in value;\n};\n\n/** True for ISO datetime strings that do not yet include timezone information. */\nconst isNaiveDateTimeString = (value: string): boolean => {\n  return /^\\d{4}-\\d{2}-\\d{2}T/.test(value) && !hasExplicitTimeZone(value);\n};\n\n/** True when an input already carries timezone/offset information. */\nconst hasExplicitTimeZone = (value: string): boolean => {\n  if (value.includes('[') && value.includes(']')) {\n    return true;\n  }\n\n  return /(?:[zZ]|[+-]\\d{2}:\\d{2})$/.test(value);\n};\n\n/** Safely run a parser and return `null` on parsing errors. */\nconst tryParse = (parser: () => unknown): DatePickerValue => {\n  try {\n    return asDatePickerValue(parser());\n  } catch {\n    return null;\n  }\n};\n\n/**\n * Parse a form value into a HeroUI DatePicker compatible `DateValue`.\n *\n * Accepts existing `DateValue` objects, native `Date` instances, and ISO-like\n * strings (date, date-time, zoned, and absolute). Returns `null` when the value\n * is empty or cannot be parsed.\n */\nexport const parseDateValue = (\n  value: unknown,\n  timeZone?: string,\n): DatePickerValue => {\n  if (value == null || value === '') {\n    return null;\n  }\n\n  if (isDateValueLike(value)) {\n    return asDatePickerValue(value);\n  }\n\n  if (value instanceof Date) {\n    return asDatePickerValue(\n      timeZone\n        ? parseAbsolute(value.toISOString(), timeZone)\n        : parseAbsoluteToLocal(value.toISOString()),\n    );\n  }\n\n  if (typeof value !== 'string') {\n    return null;\n  }\n\n  const normalizedValue = value.trim();\n  if (normalizedValue === '') {\n    return null;\n  }\n\n  if (/^\\d{4}-\\d{2}-\\d{2}$/.test(normalizedValue)) {\n    return tryParse(() => {\n      return parseDate(normalizedValue);\n    });\n  }\n\n  const parsers: (() => unknown)[] = [\n    ...(timeZone && isNaiveDateTimeString(normalizedValue)\n      ? [\n          () => {\n            return parseZonedDateTime(`${normalizedValue}[${timeZone}]`);\n          },\n        ]\n      : []),\n    () => {\n      return timeZone\n        ? parseAbsolute(normalizedValue, timeZone)\n        : parseAbsoluteToLocal(normalizedValue);\n    },\n    () => {\n      return parseZonedDateTime(normalizedValue);\n    },\n    () => {\n      return parseDateTime(normalizedValue);\n    },\n    () => {\n      return parseDate(normalizedValue);\n    },\n  ];\n\n  return (\n    parsers\n      .map((parser) => {\n        return tryParse(parser);\n      })\n      .find((parsedValue) => {\n        return parsedValue != null;\n      }) ?? null\n  );\n};\n\n/** Resolve the timezone used by the DatePicker when time fields are enabled. */\nexport const resolveDatePickerTimeZone = (\n  withTime: boolean,\n  timeZone?: string,\n): string | undefined => {\n  if (!withTime) {\n    return timeZone;\n  }\n\n  return timeZone ?? getLocalTimeZone();\n};\n\n/** Build the default placeholder value for time-enabled pickers. */\nexport const getDatePickerPlaceholderValue = (\n  withTime: boolean,\n  timeZone?: string,\n): DatePickerValue => {\n  const resolvedTimeZone = resolveDatePickerTimeZone(withTime, timeZone);\n  if (!resolvedTimeZone || !withTime) {\n    return undefined;\n  }\n\n  return asDatePickerValue(now(resolvedTimeZone));\n};\n\n/**\n * Convert a date value into a UTC ISO string.\n *\n * `CalendarDate` and `CalendarDateTime` values are interpreted in the provided\n * timezone. `ZonedDateTime` values use their own timezone and offset.\n */\nexport const dateValueToUtcIsoString = (\n  value: DatePickerValue,\n  timeZone: string,\n): string | null => {\n  if (value == null) {\n    return null;\n  }\n\n  const maybeWithAbsoluteString = value as { toAbsoluteString?: () => string };\n  if (typeof maybeWithAbsoluteString.toAbsoluteString === 'function') {\n    return maybeWithAbsoluteString.toAbsoluteString();\n  }\n\n  const maybeWithToDate = value as { toDate?: (zone: string) => Date };\n  if (typeof maybeWithToDate.toDate === 'function') {\n    return maybeWithToDate.toDate(timeZone).toISOString();\n  }\n\n  return null;\n};\n","import type { TVClassName, TVProps } from '@fuf-stack/pixel-utils';\nimport type { DatePickerProps as HeroDatePickerProps } from '@heroui/date-picker';\nimport type { ReactNode } from 'react';\nimport type { DatePickerValue } from './dateHelpers';\n\nimport { DatePicker as HeroDatePicker } from '@heroui/date-picker';\n\nimport { tv, variantsToClassNames } from '@fuf-stack/pixel-utils';\n\nimport { useUniformField } from '../hooks/useUniformField';\nimport {\n  dateValueToUtcIsoString,\n  getDatePickerPlaceholderValue,\n  parseDateValue,\n  resolveDatePickerTimeZone,\n} from './dateHelpers';\n\nexport const datePickerVariants = tv({\n  slots: {\n    /** wrapper around the whole date picker */\n    base: '',\n    /** helper wrapper for error/description */\n    helperWrapper: [\n      // set padding to 0 for error message exit animation\n      'p-0',\n    ],\n    /** the calendar element */\n    calendar: '',\n    /** the calendar's content element */\n    calendarContent: '',\n    /**\n     * inner wrapper (HeroUI inputWrapper slot)\n     *\n     * NOTE: Unlike HeroUI Input, the DatePicker does not expose a\n     * `data-focus` indicator on the group, so the focus border has to be\n     * driven by the native `focus-within` state of the segment inputs.\n     */\n    inputWrapper: 'bg-content1 focus-within:border-focus',\n    /** the calendar popover element */\n    popoverContent: '',\n    /** selector button element */\n    selectorButton: '',\n    /** selector icon element */\n    selectorIcon: '',\n    /** the time-input component element */\n    timeInput: '',\n    /** the time-input component's label element */\n    timeInputLabel: '',\n  },\n});\n\ntype VariantProps = TVProps<typeof datePickerVariants>;\ntype ClassName = TVClassName<typeof datePickerVariants>;\n\nexport interface DatePickerProps extends VariantProps {\n  /** Custom aria-label for accessibility. If not provided, falls back to field name when no visible label exists */\n  ariaLabel?: string;\n  /** CSS class name */\n  className?: ClassName;\n  /** date picker is disabled */\n  disabled?: boolean;\n  /**\n   * Optional hour cycle override.\n   *\n   * When omitted, the picker uses the user's locale default (12-hour or 24-hour).\n   */\n  hourCycle?: 12 | 24;\n  /** hide timezone abbreviation for zoned values */\n  hideTimeZone?: boolean;\n  /** form field label */\n  label?: ReactNode;\n  /** latest selectable value as ISO string */\n  maxValue?: string;\n  /** earliest selectable value as ISO string */\n  minValue?: string;\n  /** form field name */\n  name: string;\n  /** HTML data-testid attribute used in e2e tests */\n  testId?: string;\n  /**\n   * Optional advanced override for the display/interpretation timezone.\n   *\n   * When omitted, the picker uses the current user's local timezone while\n   * `withTime` is enabled.\n   */\n  timeZone?: string;\n  /**\n   * Enables date-time mode.\n   *\n   * - `false` (default): date-only input (`day` granularity)\n   * - `true`: includes time segments (`minute` granularity)\n   */\n  withTime?: boolean;\n  /** value format stored in form state (`string` stores UTC ISO values) */\n  valueType?: 'dateValue' | 'string';\n}\n\n/**\n * DatePicker component based on [HeroUI DatePicker](https://v2.heroui.com/docs/components/date-picker)\n */\nconst DatePicker = ({\n  className: _className = undefined,\n  hourCycle = 24,\n  hideTimeZone = false,\n  maxValue = undefined,\n  minValue = undefined,\n  name,\n  timeZone = undefined,\n  valueType = 'string',\n  withTime = false,\n  ...uniformFieldProps\n}: DatePickerProps) => {\n  const {\n    ariaLabel,\n    disabled,\n    errorMessage,\n    field: { onBlur, onChange, value },\n    invalid,\n    label,\n    required,\n    testId,\n  } = useUniformField({ name, ...uniformFieldProps });\n\n  // classNames from slots\n  const variants = datePickerVariants();\n  const classNames = variantsToClassNames(variants, _className, 'base');\n  const resolvedTimeZone = resolveDatePickerTimeZone(withTime, timeZone);\n\n  // Normalize incoming form value into HeroUI's DateValue shape so the field can\n  // render consistently from UTC strings, local strings, Date instances, or DateValue objects.\n  const parsedValue = parseDateValue(\n    value,\n    withTime ? resolvedTimeZone : timeZone,\n  );\n\n  // Build the default placeholder value for time-enabled pickers.\n  const placeholderValue = getDatePickerPlaceholderValue(withTime, timeZone);\n\n  // Parse ISO boundary strings into HeroUI DateValue objects.\n  const parsedMinValue = parseDateValue(\n    minValue,\n    withTime ? resolvedTimeZone : timeZone,\n  ) as unknown as HeroDatePickerProps['minValue'];\n  const parsedMaxValue = parseDateValue(\n    maxValue,\n    withTime ? resolvedTimeZone : timeZone,\n  ) as unknown as HeroDatePickerProps['maxValue'];\n\n  // Normalize DatePicker output into the configured storage format before writing to form state.\n  const handleChange = (nextValue: DatePickerValue) => {\n    if (nextValue == null) {\n      onChange(null);\n      return;\n    }\n\n    if (valueType === 'dateValue') {\n      onChange(nextValue);\n      return;\n    }\n\n    // String mode always stores UTC ISO values so form state is timezone-neutral\n    // and comparable across users/locales.\n    onChange(\n      dateValueToUtcIsoString(nextValue, resolvedTimeZone ?? 'UTC') ??\n        String(nextValue),\n    );\n  };\n\n  return (\n    <HeroDatePicker\n      aria-label={label ? undefined : ariaLabel}\n      classNames={{\n        base: classNames.base,\n        calendar: classNames.calendar,\n        calendarContent: classNames.calendarContent,\n        helperWrapper: classNames.helperWrapper,\n        inputWrapper: classNames.inputWrapper,\n        popoverContent: classNames.popoverContent,\n        selectorButton: classNames.selectorButton,\n        selectorIcon: classNames.selectorIcon,\n        timeInput: classNames.timeInput,\n        timeInputLabel: classNames.timeInputLabel,\n      }}\n      data-testid={testId}\n      errorMessage={errorMessage}\n      granularity={withTime ? 'minute' : 'day'}\n      hideTimeZone={hideTimeZone}\n      hourCycle={hourCycle}\n      id={testId}\n      isDisabled={disabled}\n      isInvalid={invalid}\n      isRequired={required}\n      label={label}\n      labelPlacement=\"outside\"\n      maxValue={parsedMaxValue}\n      minValue={parsedMinValue}\n      name={name}\n      onBlur={onBlur}\n      onChange={handleChange}\n      placeholderValue={placeholderValue}\n      radius=\"sm\"\n      value={parsedValue}\n      variant=\"bordered\"\n    />\n  );\n};\n\nexport default DatePicker;\n","import DatePicker from './DatePicker';\n\nexport type { DatePickerProps } from './DatePicker';\n\nexport { datePickerVariants } from './DatePicker';\n\nexport default DatePicker;\n"],"mappings":";;;;;;;;;;;AAiBA,MAAM,qBAAqB,UAAoC;CAC7D,OAAO;AACT;;AAGA,MAAM,mBAAmB,UAAoC;CAC3D,OAAO,CAAC,CAAC,SAAS,OAAO,UAAU,YAAY,cAAc;AAC/D;;AAGA,MAAM,yBAAyB,UAA2B;CACxD,OAAO,sBAAsB,KAAK,KAAK,KAAK,CAAC,oBAAoB,KAAK;AACxE;;AAGA,MAAM,uBAAuB,UAA2B;CACtD,IAAI,MAAM,SAAS,GAAG,KAAK,MAAM,SAAS,GAAG,GAC3C,OAAO;CAGT,OAAO,4BAA4B,KAAK,KAAK;AAC/C;;AAGA,MAAM,YAAY,WAA2C;CAC3D,IAAI;EACF,OAAO,kBAAkB,OAAO,CAAC;CACnC,QAAQ;EACN,OAAO;CACT;AACF;;;;;;;;AASA,MAAa,kBACX,OACA,aACoB;CACpB,IAAI,SAAS,QAAQ,UAAU,IAC7B,OAAO;CAGT,IAAI,gBAAgB,KAAK,GACvB,OAAO,kBAAkB,KAAK;CAGhC,IAAI,iBAAiB,MACnB,OAAO,kBACL,YAAA,GAAA,wBAAA,eACkB,MAAM,YAAY,GAAG,QAAQ,KAAA,GAAA,wBAAA,sBACtB,MAAM,YAAY,CAAC,CAC9C;CAGF,IAAI,OAAO,UAAU,UACnB,OAAO;CAGT,MAAM,kBAAkB,MAAM,KAAK;CACnC,IAAI,oBAAoB,IACtB,OAAO;CAGT,IAAI,sBAAsB,KAAK,eAAe,GAC5C,OAAO,eAAe;EACpB,QAAA,GAAA,wBAAA,WAAiB,eAAe;CAClC,CAAC;CA2BH,OACE;EAxBA,GAAI,YAAY,sBAAsB,eAAe,IACjD,OACQ;GACJ,QAAA,GAAA,wBAAA,oBAA0B,GAAG,gBAAgB,GAAG,SAAS,EAAE;EAC7D,CACF,IACA,CAAC;QACC;GACJ,OAAO,YAAA,GAAA,wBAAA,eACW,iBAAiB,QAAQ,KAAA,GAAA,wBAAA,sBAClB,eAAe;EAC1C;QACM;GACJ,QAAA,GAAA,wBAAA,oBAA0B,eAAe;EAC3C;QACM;GACJ,QAAA,GAAA,wBAAA,eAAqB,eAAe;EACtC;QACM;GACJ,QAAA,GAAA,wBAAA,WAAiB,eAAe;EAClC;CAIM,EACH,KAAK,WAAW;EACf,OAAO,SAAS,MAAM;CACxB,CAAC,EACA,MAAM,gBAAgB;EACrB,OAAO,eAAe;CACxB,CAAC,KAAK;AAEZ;;AAGA,MAAa,6BACX,UACA,aACuB;CACvB,IAAI,CAAC,UACH,OAAO;CAGT,OAAO,aAAA,GAAA,wBAAA,kBAA6B;AACtC;;AAGA,MAAa,iCACX,UACA,aACoB;CACpB,MAAM,mBAAmB,0BAA0B,UAAU,QAAQ;CACrE,IAAI,CAAC,oBAAoB,CAAC,UACxB;CAGF,OAAO,mBAAA,GAAA,wBAAA,KAAsB,gBAAgB,CAAC;AAChD;;;;;;;AAQA,MAAa,2BACX,OACA,aACkB;CAClB,IAAI,SAAS,MACX,OAAO;CAGT,MAAM,0BAA0B;CAChC,IAAI,OAAO,wBAAwB,qBAAqB,YACtD,OAAO,wBAAwB,iBAAiB;CAGlD,MAAM,kBAAkB;CACxB,IAAI,OAAO,gBAAgB,WAAW,YACpC,OAAO,gBAAgB,OAAO,QAAQ,EAAE,YAAY;CAGtD,OAAO;AACT;;;AC/JA,MAAa,sBAAA,GAAA,uBAAA,IAAwB,EACnC,OAAO;;CAEL,MAAM;;CAEN,eAAe,CAEb,KACF;;CAEA,UAAU;;CAEV,iBAAiB;;;;;;;;CAQjB,cAAc;;CAEd,gBAAgB;;CAEhB,gBAAgB;;CAEhB,cAAc;;CAEd,WAAW;;CAEX,gBAAgB;AAClB,EACF,CAAC;;;;AAmDD,MAAM,cAAc,EAClB,WAAW,aAAa,KAAA,GACxB,YAAY,IACZ,eAAe,OACf,WAAW,KAAA,GACX,WAAW,KAAA,GACX,MACA,WAAW,KAAA,GACX,YAAY,UACZ,WAAW,OACX,GAAG,wBACkB;CACrB,MAAM,EACJ,WACA,UACA,cACA,OAAO,EAAE,QAAQ,UAAU,SAC3B,SACA,OACA,UACA,WACEA,oCAAAA,gBAAgB;EAAE;EAAM,GAAG;CAAkB,CAAC;CAIlD,MAAM,cAAA,GAAA,uBAAA,sBADW,mBAC8B,GAAG,YAAY,MAAM;CACpE,MAAM,mBAAmB,0BAA0B,UAAU,QAAQ;CAIrE,MAAM,cAAc,eAClB,OACA,WAAW,mBAAmB,QAChC;CAGA,MAAM,mBAAmB,8BAA8B,UAAU,QAAQ;CAGzE,MAAM,iBAAiB,eACrB,UACA,WAAW,mBAAmB,QAChC;CACA,MAAM,iBAAiB,eACrB,UACA,WAAW,mBAAmB,QAChC;CAGA,MAAM,gBAAgB,cAA+B;EACnD,IAAI,aAAa,MAAM;GACrB,SAAS,IAAI;GACb;EACF;EAEA,IAAI,cAAc,aAAa;GAC7B,SAAS,SAAS;GAClB;EACF;EAIA,SACE,wBAAwB,WAAW,oBAAoB,KAAK,KAC1D,OAAO,SAAS,CACpB;CACF;CAEA,OACE,iBAAA,GAAA,kBAAA,KAACC,oBAAAA,YAAD;EACE,cAAY,QAAQ,KAAA,IAAY;EAChC,YAAY;GACV,MAAM,WAAW;GACjB,UAAU,WAAW;GACrB,iBAAiB,WAAW;GAC5B,eAAe,WAAW;GAC1B,cAAc,WAAW;GACzB,gBAAgB,WAAW;GAC3B,gBAAgB,WAAW;GAC3B,cAAc,WAAW;GACzB,WAAW,WAAW;GACtB,gBAAgB,WAAW;EAC7B;EACA,eAAa;EACC;EACd,aAAa,WAAW,WAAW;EACrB;EACH;EACX,IAAI;EACJ,YAAY;EACZ,WAAW;EACX,YAAY;EACL;EACP,gBAAe;EACf,UAAU;EACV,UAAU;EACJ;EACE;EACR,UAAU;EACQ;EAClB,QAAO;EACP,OAAO;EACP,SAAQ;CACT,CAAA;AAEL;;;ACvMA,IAAA,qBAAe"}