@fuf-stack/uniform 1.22.5 → 1.22.6

package/dist/Checkboxes/index.cjs

@@ -2,7 +2,116 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_Checkboxes = require("../Checkboxes-DrJqx6O2.cjs");
-exports.Checkboxes = require_Checkboxes.Checkboxes;
-exports.checkboxesVariants = require_Checkboxes.checkboxesVariants;
-exports.default = require_Checkboxes.Checkboxes_default;
+const require_FieldValidationError = require("../FieldValidationError-CfYKzl7P.cjs");
+const require_hooks_useUniformField_index = require("../hooks/useUniformField/index.cjs");
+let _heroui_checkbox = require("@heroui/checkbox");
+let _heroui_theme = require("@heroui/theme");
+let _fuf_stack_pixel_utils = require("@fuf-stack/pixel-utils");
+let react_jsx_runtime = require("react/jsx-runtime");
+//#region src/Checkboxes/Checkboxes.tsx
+const checkboxesVariants = (0, _fuf_stack_pixel_utils.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" },
+			..._heroui_theme.checkbox.variants.color
+		},
+		lineThrough: { true: {
+			optionLabel: [..._heroui_theme.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 } = require_hooks_useUniformField_index.useUniformField({
+		name,
+		...uniformFieldProps
+	});
+	const value = Array.isArray(fieldValue) ? fieldValue : [];
+	const errorMessage = /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_FieldValidationError.FieldValidationError_default, {
+		error: (_error && Object.values(_error).flat()) ?? [],
+		testId
+	});
+	const classNames = (0, _fuf_stack_pixel_utils.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__ */ (0, react_jsx_runtime.jsx)(_heroui_checkbox.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__ */ (0, react_jsx_runtime.jsx)("legend", { children: label }) : null,
+		name,
+		onBlur,
+		onChange,
+		orientation: inline ? "horizontal" : "vertical",
+		value,
+		children: options?.map((option) => {
+			const optionTestId = (0, _fuf_stack_pixel_utils.slugify)(`${testId}_option_${option?.testId ?? option?.value}`, { replaceDots: true });
+			const hasSubline = !!option.labelSubline;
+			let labelContent;
+			let optionClassNames = heroCheckboxClassNames;
+			if (hasSubline) {
+				labelContent = /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: "flex grow flex-col items-start",
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+						className: classNames.optionLabel,
+						children: option.label
+					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+						className: classNames.optionLabelSubline,
+						children: option.labelSubline
+					})]
+				});
+				optionClassNames = {
+					...optionClassNames,
+					label: ""
+				};
+			} else labelContent = option.label;
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_heroui_checkbox.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
+exports.checkboxesVariants = checkboxesVariants;
+exports.default = Checkboxes_default;
+
+//# sourceMappingURL=index.cjs.map

package/dist/Checkboxes/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["heroCheckboxVariants","useUniformField","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,sBAAA,GAAA,uBAAA,IAAwB;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,cAAAA,SAAqB,SAAS;EACnC;EACA,aAAa,EACX,MAAM;GACJ,aAAa,CACX,GAAGA,cAAAA,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,WACEC,oCAAAA,gBAAgB;EAClB;EACA,GAAG;CACL,CAAC;CAGD,MAAM,QAAQ,MAAM,QAAQ,UAAU,IAAI,aAAa,CAAC;CAYxD,MAAM,eACJ,iBAAA,GAAA,kBAAA,KAACC,6BAAAA,8BAAD;EAAsB,QANrB,UACC,OAAO,OACL,MACF,EAAE,KAAK,MACT,CAAC;EAE+C;CAAS,CAAA;CAK3D,MAAM,cAAA,GAAA,uBAAA,sBADW,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,iBAAA,GAAA,kBAAA,KAACC,iBAAAA,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,iBAAA,GAAA,kBAAA,KAAC,UAAD,EAAA,UAAS,MAAc,CAAA,IAAI;EACpC;EACE;EACE;EACV,aAAa,SAAS,eAAe;EAC9B;YAEN,SAAS,KAAK,WAAW;GACxB,MAAM,gBAAA,GAAA,uBAAA,SACJ,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,iBAAA,GAAA,kBAAA,MAAC,OAAD;KAAK,WAAU;eAAf,CACE,iBAAA,GAAA,kBAAA,KAAC,QAAD;MAAM,WAAW,WAAW;gBAAc,OAAO;KAAY,CAAA,GAC7D,iBAAA,GAAA,kBAAA,KAAC,QAAD;MAAM,WAAW,WAAW;gBACzB,OAAO;KACJ,CAAA,CACH;;IAGP,mBAAmB;KAAE,GAAG;KAAkB,OAAO;IAAG;GACtD,OACE,eAAe,OAAO;GAGxB,OACE,iBAAA,GAAA,kBAAA,KAACC,iBAAAA,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"}