@tribepad/themis 1.0.0 → 1.0.1

package/dist/elements/CheckboxGroup/index.mjs

@@ -1,6 +1,441 @@
-export { Checkbox, CheckboxDescriptionPropsSchema, CheckboxGroup, CheckboxGroupOrientationSchema, CheckboxGroupPropsSchema, CheckboxGroupSizeSchema, CheckboxGroupVariantSchema, CheckboxLabelPropsSchema, CheckboxPropsSchema, CheckmarkIcon, TimesIcon, checkboxGroupVariants, checkboxIndicatorVariants, checkboxItemVariants, checkmarkVariants } from '../../chunk-4S33J5NY.mjs';
-import '../../chunk-HK46BT5U.mjs';
-import '../../chunk-E2KQFV3O.mjs';
-import '../../chunk-5SVLJN2C.mjs';
+"use client";
+import { z } from 'zod';
+import { createContext, forwardRef, useId, useContext, isValidElement, cloneElement } from 'react';
+import { CheckboxGroup as CheckboxGroup$1, Label, Text, FieldError, Checkbox as Checkbox$1 } from 'react-aria-components';
+import { cva } from 'class-variance-authority';
+import { clsx } from 'clsx';
+import { twMerge } from 'tailwind-merge';
+import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
+
+// src/elements/CheckboxGroup/CheckboxGroup.types.ts
+var BaseComponentPropsSchema = z.object({
+  // Styling
+  className: z.string().optional(),
+  // React
+  children: z.any().optional(),
+  // ReactNode not directly supported by Zod
+  id: z.string().optional(),
+  // Accessibility (WCAG 2.2 AA requirements)
+  "aria-label": z.string().optional(),
+  "aria-labelledby": z.string().optional(),
+  "aria-describedby": z.string().optional(),
+  "aria-live": z.enum(["off", "polite", "assertive"]).optional(),
+  "aria-hidden": z.boolean().optional(),
+  // Testing & Development
+  "data-testid": z.string().optional()
+});
+
+// src/elements/CheckboxGroup/CheckboxGroup.types.ts
+var CheckboxGroupVariantSchema = z.enum(["default", "destructive"]);
+var CheckboxGroupSizeSchema = z.enum(["sm", "default", "lg"]);
+var CheckboxGroupOrientationSchema = z.enum(["vertical", "horizontal"]);
+var CheckboxGroupPropsSchema = BaseComponentPropsSchema.extend({
+  // Display props (US-4)
+  label: z.string().optional(),
+  description: z.string().optional(),
+  errorMessage: z.string().optional(),
+  // Selection props (US-1) - array for multi-select (key difference from RadioGroup)
+  value: z.array(z.string()).optional(),
+  defaultValue: z.array(z.string()).optional(),
+  // State props (US-6)
+  isDisabled: z.boolean().optional().default(false),
+  isReadOnly: z.boolean().optional().default(false),
+  isRequired: z.boolean().optional().default(false),
+  isInvalid: z.boolean().optional().default(false),
+  // Layout props (US-5)
+  orientation: CheckboxGroupOrientationSchema.optional().default("vertical"),
+  // Variant props (US-2, US-3)
+  variant: CheckboxGroupVariantSchema.optional().default("default"),
+  size: CheckboxGroupSizeSchema.optional().default("default"),
+  // Form props (US-6)
+  name: z.string().optional(),
+  // Event handlers
+  onChange: z.custom().optional(),
+  onFocusChange: z.custom().optional(),
+  // Children (Checkbox components)
+  children: z.custom()
+});
+var CheckboxPropsSchema = BaseComponentPropsSchema.extend({
+  // Item value (required)
+  value: z.string(),
+  // Disabled state (individual item)
+  isDisabled: z.boolean().optional().default(false),
+  // Item content - accepts any ReactNode for flexible children
+  children: z.custom(),
+  // Optional className for custom styling
+  className: z.string().optional(),
+  // Custom icon to display when selected (defaults to checkmark)
+  // Useful for destructive variants where an X icon may be more appropriate
+  selectedIcon: z.custom().optional()
+});
+var CheckboxLabelPropsSchema = z.object({
+  // Label content
+  children: z.custom(),
+  // Optional className for custom styling
+  className: z.string().optional()
+});
+var CheckboxDescriptionPropsSchema = z.object({
+  // Description content
+  children: z.custom(),
+  // Optional className for custom styling
+  className: z.string().optional()
+});
+function cn(...inputs) {
+  return twMerge(clsx(inputs));
+}
+
+// src/styles/interaction-states.ts
+var FOCUS_STYLES = "data-[focus-visible]:ring-2 data-[focus-visible]:ring-[var(--themis-ring)] data-[focus-visible]:ring-offset-2";
+var HIGH_CONTRAST_FOCUS = "hc:data-[focus-visible]:outline hc:data-[focus-visible]:outline-4 hc:data-[focus-visible]:outline-offset-2 hc:data-[focus-visible]:outline-foreground";
+var CheckboxGroupContext = createContext({
+  variant: "default",
+  size: "default",
+  isInvalid: false,
+  isDisabled: false,
+  isReadOnly: false
+});
+var checkboxGroupVariants = cva(
+  // Base: flex container
+  "flex",
+  {
+    variants: {
+      orientation: {
+        vertical: "flex-col gap-2",
+        horizontal: "flex-row flex-wrap gap-2"
+      }
+    },
+    defaultVariants: {
+      orientation: "vertical"
+    }
+  }
+);
+var checkboxItemVariants = cva(
+  // Base: bordered container with flex layout, RTL support
+  [
+    "flex items-center gap-3 rounded-md border cursor-pointer",
+    "transition-colors duration-200",
+    "rtl:flex-row-reverse",
+    // RTL: indicator flips to right
+    // Focus ring on entire container
+    FOCUS_STYLES,
+    HIGH_CONTRAST_FOCUS
+  ].join(" "),
+  {
+    variants: {
+      variant: {
+        default: [
+          "border-[var(--border)]",
+          "data-[hovered]:bg-[var(--accent)]/10",
+          "data-[selected]:border-[var(--primary)]",
+          "data-[selected]:bg-[var(--primary)]/10"
+        ].join(" "),
+        destructive: [
+          "border-[var(--border)]",
+          "data-[hovered]:bg-[var(--destructive)]/10",
+          "data-[selected]:border-[var(--destructive)]",
+          "data-[selected]:bg-[var(--destructive)]/10"
+        ].join(" ")
+      },
+      size: {
+        sm: "min-h-[44px] py-2 px-3 text-sm",
+        default: "min-h-[48px] py-3 px-4 text-sm",
+        lg: "min-h-[56px] py-4 px-5 text-base"
+      },
+      isDisabled: {
+        true: "opacity-50 cursor-not-allowed",
+        false: ""
+      },
+      isReadOnly: {
+        // Subtle visual cue per clarification
+        true: "cursor-default",
+        false: ""
+      },
+      isInvalid: {
+        // Error: ALL items get destructive border (cognitive accessibility)
+        true: "border-[var(--destructive)]",
+        false: ""
+      }
+    },
+    defaultVariants: {
+      variant: "default",
+      size: "default",
+      isDisabled: false,
+      isReadOnly: false,
+      isInvalid: false
+    }
+  }
+);
+var checkboxIndicatorVariants = cva(
+  // Base: square with border, flex-shrink-0 to prevent squishing
+  "flex-shrink-0 rounded-sm border-2 flex items-center justify-center transition-colors duration-200",
+  {
+    variants: {
+      variant: {
+        default: [
+          "border-[var(--border)]",
+          "data-[selected]:border-[var(--primary)]",
+          "data-[selected]:bg-[var(--primary)]"
+        ].join(" "),
+        destructive: [
+          "border-[var(--border)]",
+          "data-[selected]:border-[var(--destructive)]",
+          "data-[selected]:bg-[var(--destructive)]"
+        ].join(" ")
+      },
+      size: {
+        sm: "h-4 w-4",
+        default: "h-5 w-5",
+        lg: "h-6 w-6"
+      }
+    },
+    defaultVariants: {
+      variant: "default",
+      size: "default"
+    }
+  }
+);
+var checkmarkVariants = cva(
+  // Base: centered checkmark with spring animation
+  [
+    "transition-transform duration-200",
+    // Spring animation with overshoot
+    "[transition-timing-function:cubic-bezier(0.34,1.56,0.64,1)]",
+    // Respect reduced motion preference
+    "motion-reduce:transition-none",
+    // Scale from 0 to 1 on selection
+    "scale-0 data-[selected]:scale-100"
+  ].join(" "),
+  {
+    variants: {
+      variant: {
+        default: "text-[var(--primary-foreground)]",
+        destructive: "text-[var(--destructive-foreground)]"
+      },
+      size: {
+        sm: "h-3 w-3",
+        default: "h-3.5 w-3.5",
+        lg: "h-4 w-4"
+      }
+    },
+    defaultVariants: {
+      variant: "default",
+      size: "default"
+    }
+  }
+);
+function CheckmarkIcon({ className, ...props }) {
+  return /* @__PURE__ */ jsx(
+    "svg",
+    {
+      className,
+      viewBox: "0 0 24 24",
+      fill: "none",
+      stroke: "currentColor",
+      strokeWidth: 3,
+      strokeLinecap: "round",
+      strokeLinejoin: "round",
+      "aria-hidden": "true",
+      ...props,
+      children: /* @__PURE__ */ jsx("polyline", { points: "20 6 9 17 4 12" })
+    }
+  );
+}
+function TimesIcon({ className, ...props }) {
+  return /* @__PURE__ */ jsxs(
+    "svg",
+    {
+      className,
+      viewBox: "0 0 24 24",
+      fill: "none",
+      stroke: "currentColor",
+      strokeWidth: 3,
+      strokeLinecap: "round",
+      strokeLinejoin: "round",
+      "aria-hidden": "true",
+      ...props,
+      children: [
+        /* @__PURE__ */ jsx("line", { x1: "18", y1: "6", x2: "6", y2: "18" }),
+        /* @__PURE__ */ jsx("line", { x1: "6", y1: "6", x2: "18", y2: "18" })
+      ]
+    }
+  );
+}
+function CheckboxLabel({ children, className }) {
+  return /* @__PURE__ */ jsx("span", { className: cn("font-medium text-[var(--content-foreground)]", className), children });
+}
+CheckboxLabel.displayName = "Checkbox.Label";
+function CheckboxDescription({ children, className }) {
+  return /* @__PURE__ */ jsx("span", { className: cn("text-sm text-[var(--menu-muted)]", className), children });
+}
+CheckboxDescription.displayName = "Checkbox.Description";
+function CheckboxComponent({ value, isDisabled, children, className, selectedIcon }) {
+  const { variant, size, isInvalid, isDisabled: groupDisabled, isReadOnly } = useContext(CheckboxGroupContext);
+  const effectiveDisabled = isDisabled || groupDisabled;
+  const renderSelectedIcon = (isSelected) => {
+    const iconClassName = cn(checkmarkVariants({ variant, size }));
+    const dataSelected = isSelected || void 0;
+    if (selectedIcon) {
+      if (isValidElement(selectedIcon)) {
+        const iconElement = selectedIcon;
+        return cloneElement(iconElement, {
+          className: cn(iconClassName, iconElement.props.className),
+          "data-selected": dataSelected
+        });
+      }
+      return /* @__PURE__ */ jsx("span", { className: iconClassName, "data-selected": dataSelected, children: selectedIcon });
+    }
+    return /* @__PURE__ */ jsx(
+      CheckmarkIcon,
+      {
+        className: iconClassName,
+        "data-selected": dataSelected
+      }
+    );
+  };
+  return /* @__PURE__ */ jsx(
+    Checkbox$1,
+    {
+      value,
+      isDisabled: effectiveDisabled,
+      className: (renderProps) => cn(
+        checkboxItemVariants({
+          variant,
+          size,
+          isDisabled: renderProps.isDisabled,
+          isReadOnly,
+          isInvalid
+        }),
+        className
+      ),
+      children: (renderProps) => /* @__PURE__ */ jsxs(Fragment, { children: [
+        /* @__PURE__ */ jsx(
+          "div",
+          {
+            className: checkboxIndicatorVariants({ variant, size }),
+            "data-selected": renderProps.isSelected || void 0,
+            children: renderSelectedIcon(renderProps.isSelected)
+          }
+        ),
+        /* @__PURE__ */ jsx("div", { className: "flex-1 flex flex-col", children })
+      ] })
+    }
+  );
+}
+var Checkbox = Object.assign(CheckboxComponent, {
+  Label: CheckboxLabel,
+  Description: CheckboxDescription
+});
+Checkbox.displayName = "Checkbox";
+function dedupeWithWarning(values, componentName) {
+  if (!values) return values;
+  const uniqueValues = [...new Set(values)];
+  if (process.env.NODE_ENV !== "production" && uniqueValues.length !== values.length) {
+    console.warn(
+      `[${componentName}] Received duplicate values in value/defaultValue prop. Original: [${values.join(", ")}], Deduplicated: [${uniqueValues.join(", ")}]. Duplicate values are automatically removed.`
+    );
+  }
+  return uniqueValues;
+}
+var CheckboxGroup = forwardRef(
+  function CheckboxGroup2(props, ref) {
+    const {
+      // Display props
+      label,
+      description,
+      errorMessage,
+      // Selection props (string[] for multi-select)
+      value,
+      defaultValue,
+      // State props
+      isDisabled = false,
+      isReadOnly = false,
+      isRequired = false,
+      isInvalid = false,
+      // Layout props
+      orientation = "vertical",
+      // Variant props
+      variant = "default",
+      size = "default",
+      // Form props
+      name,
+      // Event handlers
+      onChange,
+      onFocusChange,
+      // Standard props
+      className,
+      children,
+      id,
+      "aria-label": ariaLabel,
+      "aria-labelledby": ariaLabelledby,
+      "aria-describedby": ariaDescribedby,
+      "data-testid": dataTestId,
+      ...restProps
+    } = props;
+    const generatedId = useId();
+    const checkboxGroupId = id ?? generatedId;
+    const labelId = `${checkboxGroupId}-label`;
+    const descriptionId = `${checkboxGroupId}-description`;
+    const errorId = `${checkboxGroupId}-error`;
+    const describedByParts = [];
+    if (ariaDescribedby) describedByParts.push(ariaDescribedby);
+    if (description) describedByParts.push(descriptionId);
+    if (isInvalid && errorMessage) describedByParts.push(errorId);
+    const computedAriaDescribedBy = describedByParts.length > 0 ? describedByParts.join(" ") : void 0;
+    const dedupedValue = dedupeWithWarning(value, "CheckboxGroup");
+    const dedupedDefaultValue = dedupeWithWarning(defaultValue, "CheckboxGroup");
+    return /* @__PURE__ */ jsx(CheckboxGroupContext.Provider, { value: { variant, size, isInvalid, isDisabled, isReadOnly }, children: /* @__PURE__ */ jsxs(
+      CheckboxGroup$1,
+      {
+        ref,
+        id: checkboxGroupId,
+        name,
+        value: dedupedValue,
+        defaultValue: dedupedDefaultValue,
+        isDisabled,
+        isReadOnly,
+        isRequired,
+        isInvalid,
+        onChange,
+        onFocusChange,
+        "aria-label": ariaLabel,
+        "aria-labelledby": label ? labelId : ariaLabelledby,
+        "aria-describedby": computedAriaDescribedBy,
+        "aria-orientation": orientation,
+        "aria-required": isRequired || void 0,
+        "aria-invalid": isInvalid || void 0,
+        "data-testid": dataTestId,
+        className: cn("flex flex-col gap-1.5", className),
+        ...restProps,
+        children: [
+          label && /* @__PURE__ */ jsxs(Label, { id: labelId, className: "text-sm font-medium text-[var(--content-foreground)]", children: [
+            label,
+            isRequired && /* @__PURE__ */ jsx("span", { className: "ml-1 text-[var(--destructive)]", "aria-hidden": "true", children: "*" })
+          ] }),
+          description && /* @__PURE__ */ jsx(
+            Text,
+            {
+              id: descriptionId,
+              slot: "description",
+              className: "text-sm text-[var(--menu-muted)]",
+              children: description
+            }
+          ),
+          /* @__PURE__ */ jsx("div", { className: checkboxGroupVariants({ orientation }), children }),
+          isInvalid && errorMessage && /* @__PURE__ */ jsx(
+            FieldError,
+            {
+              id: errorId,
+              className: "text-sm text-[var(--destructive)]",
+              children: /* @__PURE__ */ jsx("span", { role: "alert", children: errorMessage })
+            }
+          )
+        ]
+      }
+    ) });
+  }
+);
+CheckboxGroup.displayName = "CheckboxGroup";
+
+export { Checkbox, CheckboxDescriptionPropsSchema, CheckboxGroup, CheckboxGroupOrientationSchema, CheckboxGroupPropsSchema, CheckboxGroupSizeSchema, CheckboxGroupVariantSchema, CheckboxLabelPropsSchema, CheckboxPropsSchema, CheckmarkIcon, TimesIcon, checkboxGroupVariants, checkboxIndicatorVariants, checkboxItemVariants, checkmarkVariants };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/elements/CheckboxGroup/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.mjs"}
+{"version":3,"sources":["../../../src/schemas/BaseComponentProps.ts","../../../src/elements/CheckboxGroup/CheckboxGroup.types.ts","../../../src/utils/cn.ts","../../../src/styles/interaction-states.ts","../../../src/elements/CheckboxGroup/CheckboxGroup.tsx"],"names":["z","AriaCheckbox","CheckboxGroup","AriaCheckboxGroup"],"mappings":"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","file":"index.mjs","sourcesContent":["import { z } from 'zod';\n\n/**\n * Base props schema for all Themis components\n * Ensures consistent accessibility and styling APIs across the library\n *\n * @see spec.md FR-009 to FR-014 (Accessibility Requirements)\n * @see constitution.md Principle IV (Accessibility First - WCAG 2.2 AA minimum)\n */\nexport const BaseComponentPropsSchema = z.object({\n  // Styling\n  className: z.string().optional(),\n\n  // React\n  children: z.any().optional(), // ReactNode not directly supported by Zod\n  id: z.string().optional(),\n\n  // Accessibility (WCAG 2.2 AA requirements)\n  'aria-label': z.string().optional(),\n  'aria-labelledby': z.string().optional(),\n  'aria-describedby': z.string().optional(),\n  'aria-live': z.enum(['off', 'polite', 'assertive']).optional(),\n  'aria-hidden': z.boolean().optional(),\n\n  // Testing & Development\n  'data-testid': z.string().optional(),\n});\n\nexport type BaseComponentProps = z.infer<typeof BaseComponentPropsSchema>;\n","import { z } from 'zod';\nimport { BaseComponentPropsSchema } from '../../schemas/BaseComponentProps';\nimport type { ReactNode } from 'react';\nimport type {\n  CheckboxGroupProps as AriaCheckboxGroupProps,\n  CheckboxProps as AriaCheckboxProps,\n} from 'react-aria-components';\n\n/**\n * CheckboxGroup variant schema\n * Only 2 variants: default and destructive (matching RadioGroup)\n *\n * @see checkboxgroup-prd.md US-2 (Style Variants)\n */\nexport const CheckboxGroupVariantSchema = z.enum(['default', 'destructive']);\nexport type CheckboxGroupVariant = z.infer<typeof CheckboxGroupVariantSchema>;\n\n/**\n * CheckboxGroup size schema\n * All sizes maintain 44px minimum height for WCAG 2.2 AAA compliance\n *\n * @see checkboxgroup-prd.md US-3 (Size Variants)\n * @see constitution.md Principle IV (Accessibility First)\n */\nexport const CheckboxGroupSizeSchema = z.enum(['sm', 'default', 'lg']);\nexport type CheckboxGroupSize = z.infer<typeof CheckboxGroupSizeSchema>;\n\n/**\n * CheckboxGroup orientation schema\n *\n * @see checkboxgroup-prd.md US-5 (Orientation Support)\n */\nexport const CheckboxGroupOrientationSchema = z.enum(['vertical', 'horizontal']);\nexport type CheckboxGroupOrientation = z.infer<typeof CheckboxGroupOrientationSchema>;\n\n/**\n * CheckboxGroup root component props schema\n *\n * Key difference from RadioGroup: value is string[] (multi-select)\n *\n * @see checkboxgroup-prd.md US-1 (Basic Multi-Selection)\n * @see checkboxgroup-prd.md US-4 (Labels, Descriptions, Errors)\n * @see checkboxgroup-prd.md US-6 (Validation States)\n */\nexport const CheckboxGroupPropsSchema = BaseComponentPropsSchema.extend({\n  // Display props (US-4)\n  label: z.string().optional(),\n  description: z.string().optional(),\n  errorMessage: z.string().optional(),\n\n  // Selection props (US-1) - array for multi-select (key difference from RadioGroup)\n  value: z.array(z.string()).optional(),\n  defaultValue: z.array(z.string()).optional(),\n\n  // State props (US-6)\n  isDisabled: z.boolean().optional().default(false),\n  isReadOnly: z.boolean().optional().default(false),\n  isRequired: z.boolean().optional().default(false),\n  isInvalid: z.boolean().optional().default(false),\n\n  // Layout props (US-5)\n  orientation: CheckboxGroupOrientationSchema.optional().default('vertical'),\n\n  // Variant props (US-2, US-3)\n  variant: CheckboxGroupVariantSchema.optional().default('default'),\n  size: CheckboxGroupSizeSchema.optional().default('default'),\n\n  // Form props (US-6)\n  name: z.string().optional(),\n\n  // Event handlers\n  onChange: z.custom<(value: string[]) => void>().optional(),\n  onFocusChange: z.custom<(isFocused: boolean) => void>().optional(),\n\n  // Children (Checkbox components)\n  children: z.custom<ReactNode>(),\n});\n\nexport type CheckboxGroupProps = z.infer<typeof CheckboxGroupPropsSchema> &\n  Omit<AriaCheckboxGroupProps, keyof z.infer<typeof CheckboxGroupPropsSchema>>;\n\n/**\n * Checkbox item component props schema\n *\n * @see checkboxgroup-prd.md US-1 (Basic Multi-Selection)\n * @see checkboxgroup-prd.md US-7 (Rich Content Support)\n */\nexport const CheckboxPropsSchema = BaseComponentPropsSchema.extend({\n  // Item value (required)\n  value: z.string(),\n\n  // Disabled state (individual item)\n  isDisabled: z.boolean().optional().default(false),\n\n  // Item content - accepts any ReactNode for flexible children\n  children: z.custom<ReactNode>(),\n\n  // Optional className for custom styling\n  className: z.string().optional(),\n\n  // Custom icon to display when selected (defaults to checkmark)\n  // Useful for destructive variants where an X icon may be more appropriate\n  selectedIcon: z.custom<ReactNode>().optional(),\n});\n\nexport type CheckboxProps = z.infer<typeof CheckboxPropsSchema> &\n  Omit<AriaCheckboxProps, keyof z.infer<typeof CheckboxPropsSchema>>;\n\n/**\n * Checkbox.Label sub-component props schema\n * Helper component for styled label within Checkbox item\n *\n * @see checkboxgroup-prd.md US-7 (Rich Content Support)\n */\nexport const CheckboxLabelPropsSchema = z.object({\n  // Label content\n  children: z.custom<ReactNode>(),\n\n  // Optional className for custom styling\n  className: z.string().optional(),\n});\n\nexport type CheckboxLabelProps = z.infer<typeof CheckboxLabelPropsSchema>;\n\n/**\n * Checkbox.Description sub-component props schema\n * Helper component for styled description within Checkbox item (muted text)\n *\n * @see checkboxgroup-prd.md US-7 (Rich Content Support)\n */\nexport const CheckboxDescriptionPropsSchema = z.object({\n  // Description content\n  children: z.custom<ReactNode>(),\n\n  // Optional className for custom styling\n  className: z.string().optional(),\n});\n\nexport type CheckboxDescriptionProps = z.infer<typeof CheckboxDescriptionPropsSchema>;\n\n/**\n * CVA variant configuration types\n * Used for class-variance-authority integration\n */\nexport type CheckboxGroupVariantType = CheckboxGroupVariant;\nexport type CheckboxGroupSizeType = CheckboxGroupSize;\nexport type CheckboxGroupOrientationType = CheckboxGroupOrientation;\n","/**\n * Class Name Utility\n * Merges Tailwind CSS classes with conflict resolution\n *\n * Combines clsx for conditional classes and tailwind-merge for deduplication\n *\n * @example\n * cn('px-2 py-1', 'px-4') // => 'py-1 px-4' (px-4 overrides px-2)\n * cn('text-red-500', condition && 'text-blue-500') // => conditional application\n */\n\nimport { clsx, type ClassValue } from 'clsx';\nimport { twMerge } from 'tailwind-merge';\n\nexport function cn(...inputs: ClassValue[]): string {\n  return twMerge(clsx(inputs));\n}\n","/**\n * Global Interaction State Styles\n *\n * Consistent interaction patterns across all Themis components.\n * These styles ensure WCAG 2.2 AAA compliance and predictable UX.\n *\n * @see spec.md FR-010 (Visible focus ring for keyboard navigation)\n * @see spec.md FR-031 (Pressed state feedback)\n * @see spec.md FR-012 (High contrast mode support)\n * @see constitution.md Principle IV (Accessibility First)\n */\n\n/**\n * Focus state styles (FR-010)\n * Visible focus ring for keyboard navigation - WCAG 2.2 Level AAA\n *\n * Components can override by extending these styles:\n * @example\n * cn(FOCUS_STYLES, \"ring-4\") // Increases ring width to 4px\n */\nexport const FOCUS_STYLES = \"data-[focus-visible]:ring-2 data-[focus-visible]:ring-[var(--themis-ring)] data-[focus-visible]:ring-offset-2\";\n\n/**\n * Pressed/Active state styles (FR-031)\n * Visual feedback for press interactions\n *\n * Components can override the scale amount:\n * @example\n * cn(PRESSED_STYLES_BASE, \"data-[pressed]:scale-[0.95]\") // More pronounced scale\n */\nexport const PRESSED_STYLES = \"data-[pressed]:scale-[0.97]\";\n\n/**\n * Base pressed styles without scale (for components that need different feedback)\n */\nexport const PRESSED_STYLES_BASE = \"data-[pressed]:transition-transform data-[pressed]:duration-100\";\n\n/**\n * Hover state styles\n * Elevation change on hover for better affordance\n *\n * Components can override shadow depth:\n * @example\n * cn(HOVER_STYLES_BASE, \"data-[hovered]:shadow-lg\") // Larger shadow\n */\nexport const HOVER_STYLES = \"data-[hovered]:shadow-md\";\n\n/**\n * Base hover styles without shadow (for components that use different hover effects)\n */\nexport const HOVER_STYLES_BASE = \"data-[hovered]:transition-shadow data-[hovered]:duration-200\";\n\n/**\n * High contrast mode focus (FR-012)\n * Enhanced outlines for users requiring high contrast\n *\n * Uses 'hc:' prefix for prefers-contrast: more media query\n */\nexport const HIGH_CONTRAST_FOCUS = \"hc:data-[focus-visible]:outline hc:data-[focus-visible]:outline-4 hc:data-[focus-visible]:outline-offset-2 hc:data-[focus-visible]:outline-foreground\";\n\n/**\n * High contrast mode hover (FR-012)\n * Enhanced outlines for hover in high contrast mode\n */\nexport const HIGH_CONTRAST_HOVER = \"hc:data-[hovered]:outline hc:data-[hovered]:outline-2 hc:data-[hovered]:outline-foreground\";\n\n/**\n * High contrast mode pressed state\n * Enhanced outlines for pressed state in high contrast mode\n */\nexport const HIGH_CONTRAST_PRESSED = \"hc:data-[pressed]:outline hc:data-[pressed]:outline-2 hc:data-[pressed]:outline-offset-1 hc:data-[pressed]:outline-foreground\";\n\n/**\n * Combined high contrast styles\n * Use this for components that need all high contrast interaction states\n */\nexport const HIGH_CONTRAST_INTERACTIONS = `${HIGH_CONTRAST_FOCUS} ${HIGH_CONTRAST_HOVER} ${HIGH_CONTRAST_PRESSED}`;\n\n/**\n * Disabled state styles\n * Consistent disabled appearance across all components\n */\nexport const DISABLED_STYLES = \"disabled:pointer-events-none disabled:opacity-50\";\n\n/**\n * Default interaction bundle\n * Most common combination for interactive components\n *\n * Includes: focus ring, pressed scale, hover shadow, high contrast enhancements\n *\n * @example\n * <button className={cn(DEFAULT_INTERACTIONS, \"bg-primary\")}>Click</button>\n */\nexport const DEFAULT_INTERACTIONS = `${FOCUS_STYLES} ${PRESSED_STYLES} ${HOVER_STYLES} ${HIGH_CONTRAST_FOCUS} ${HIGH_CONTRAST_HOVER} ${HIGH_CONTRAST_PRESSED}`;\n\n/**\n * Subtle interaction bundle\n * For components that need less pronounced feedback\n *\n * Includes: focus ring and high contrast, but no hover shadow or pressed scale\n */\nexport const SUBTLE_INTERACTIONS = `${FOCUS_STYLES} ${HIGH_CONTRAST_FOCUS}`;\n\n/**\n * Non-interactive element styles\n * For elements that should indicate they are not interactive\n */\nexport const NON_INTERACTIVE = \"cursor-default select-none\";\n","\"use client\";\n\n/**\n * CheckboxGroup Component\n * Accessible multi-selection checkbox group with React Aria primitives and CVA styling\n *\n * Key Features:\n * - Bordered container design with explicit 44px+ touch targets\n * - 2 variants: default, destructive (no outline per clarification)\n * - 3 sizes: sm (44px), default (48px), lg (56px)\n * - Tab moves focus between checkboxes, Space toggles (standard checkbox behavior)\n * - Error styling on ALL items (cognitive accessibility)\n * - Spring animation for checkmark indicator\n * - RTL support (indicator auto-flips)\n * - Checkbox.Label and Checkbox.Description sub-components\n * - value: string[] for multi-select (key difference from RadioGroup)\n *\n * @see checkboxgroup-prd.md (Product Requirements)\n * @see plan.md (12 Key Clarifications)\n * @see React Aria CheckboxGroup: https://react-spectrum.adobe.com/react-aria/CheckboxGroup.html\n * @see constitution.md Principle IV (Accessibility First - WCAG 2.2 AAA)\n */\n\nimport {\n  forwardRef,\n  createContext,\n  useContext,\n  useId,\n  cloneElement,\n  isValidElement,\n  type ReactNode,\n  type ForwardedRef,\n  type ReactElement,\n} from 'react';\nimport {\n  CheckboxGroup as AriaCheckboxGroup,\n  Checkbox as AriaCheckbox,\n  Label,\n  Text,\n  FieldError,\n} from 'react-aria-components';\nimport { cva } from 'class-variance-authority';\nimport { cn } from '../../utils/cn';\nimport { FOCUS_STYLES, HIGH_CONTRAST_FOCUS } from '../../styles/interaction-states';\nimport type {\n  CheckboxGroupProps,\n  CheckboxProps,\n  CheckboxLabelProps,\n  CheckboxDescriptionProps,\n  CheckboxGroupVariant,\n  CheckboxGroupSize,\n} from './CheckboxGroup.types';\n\n// ============================================================================\n// Context\n// ============================================================================\n\n/**\n * CheckboxGroup context value\n * Includes isDisabled and isReadOnly per clarification (plan.md #10)\n */\ninterface CheckboxGroupContextValue {\n  variant: CheckboxGroupVariant;\n  size: CheckboxGroupSize;\n  isInvalid: boolean;\n  isDisabled: boolean;\n  isReadOnly: boolean;\n}\n\nconst CheckboxGroupContext = createContext<CheckboxGroupContextValue>({\n  variant: 'default',\n  size: 'default',\n  isInvalid: false,\n  isDisabled: false,\n  isReadOnly: false,\n});\n\n// ============================================================================\n// CVA Variants\n// ============================================================================\n\n/**\n * CheckboxGroup container variants\n * Controls orientation and spacing (gap-2 = 8px per clarification)\n */\nconst checkboxGroupVariants = cva(\n  // Base: flex container\n  \"flex\",\n  {\n    variants: {\n      orientation: {\n        vertical: \"flex-col gap-2\",\n        horizontal: \"flex-row flex-wrap gap-2\",\n      },\n    },\n    defaultVariants: {\n      orientation: \"vertical\",\n    },\n  }\n);\n\n/**\n * Checkbox item bordered container variants\n * Bordered container design with explicit touch targets\n * All sizes maintain 44px minimum height (WCAG 2.2 AAA)\n * All sizes use rounded-md (6px) per clarification\n */\nconst checkboxItemVariants = cva(\n  // Base: bordered container with flex layout, RTL support\n  [\n    \"flex items-center gap-3 rounded-md border cursor-pointer\",\n    \"transition-colors duration-200\",\n    \"rtl:flex-row-reverse\", // RTL: indicator flips to right\n    // Focus ring on entire container\n    FOCUS_STYLES,\n    HIGH_CONTRAST_FOCUS,\n  ].join(\" \"),\n  {\n    variants: {\n      variant: {\n        default: [\n          \"border-[var(--border)]\",\n          \"data-[hovered]:bg-[var(--accent)]/10\",\n          \"data-[selected]:border-[var(--primary)]\",\n          \"data-[selected]:bg-[var(--primary)]/10\",\n        ].join(\" \"),\n        destructive: [\n          \"border-[var(--border)]\",\n          \"data-[hovered]:bg-[var(--destructive)]/10\",\n          \"data-[selected]:border-[var(--destructive)]\",\n          \"data-[selected]:bg-[var(--destructive)]/10\",\n        ].join(\" \"),\n      },\n      size: {\n        sm: \"min-h-[44px] py-2 px-3 text-sm\",\n        default: \"min-h-[48px] py-3 px-4 text-sm\",\n        lg: \"min-h-[56px] py-4 px-5 text-base\",\n      },\n      isDisabled: {\n        true: \"opacity-50 cursor-not-allowed\",\n        false: \"\",\n      },\n      isReadOnly: {\n        // Subtle visual cue per clarification\n        true: \"cursor-default\",\n        false: \"\",\n      },\n      isInvalid: {\n        // Error: ALL items get destructive border (cognitive accessibility)\n        true: \"border-[var(--destructive)]\",\n        false: \"\",\n      },\n    },\n    defaultVariants: {\n      variant: \"default\",\n      size: \"default\",\n      isDisabled: false,\n      isReadOnly: false,\n      isInvalid: false,\n    },\n  }\n);\n\n/**\n * Square indicator (checkbox box) variants\n * Uses rounded-sm (2px) for square appearance (unlike RadioGroup's circle)\n */\nconst checkboxIndicatorVariants = cva(\n  // Base: square with border, flex-shrink-0 to prevent squishing\n  \"flex-shrink-0 rounded-sm border-2 flex items-center justify-center transition-colors duration-200\",\n  {\n    variants: {\n      variant: {\n        default: [\n          \"border-[var(--border)]\",\n          \"data-[selected]:border-[var(--primary)]\",\n          \"data-[selected]:bg-[var(--primary)]\",\n        ].join(\" \"),\n        destructive: [\n          \"border-[var(--border)]\",\n          \"data-[selected]:border-[var(--destructive)]\",\n          \"data-[selected]:bg-[var(--destructive)]\",\n        ].join(\" \"),\n      },\n      size: {\n        sm: \"h-4 w-4\",\n        default: \"h-5 w-5\",\n        lg: \"h-6 w-6\",\n      },\n    },\n    defaultVariants: {\n      variant: \"default\",\n      size: \"default\",\n    },\n  }\n);\n\n/**\n * Checkmark SVG variants\n * Spring animation: cubic-bezier(0.34, 1.56, 0.64, 1) with slight overshoot\n */\nconst checkmarkVariants = cva(\n  // Base: centered checkmark with spring animation\n  [\n    \"transition-transform duration-200\",\n    // Spring animation with overshoot\n    \"[transition-timing-function:cubic-bezier(0.34,1.56,0.64,1)]\",\n    // Respect reduced motion preference\n    \"motion-reduce:transition-none\",\n    // Scale from 0 to 1 on selection\n    \"scale-0 data-[selected]:scale-100\",\n  ].join(\" \"),\n  {\n    variants: {\n      variant: {\n        default: \"text-[var(--primary-foreground)]\",\n        destructive: \"text-[var(--destructive-foreground)]\",\n      },\n      size: {\n        sm: \"h-3 w-3\",\n        default: \"h-3.5 w-3.5\",\n        lg: \"h-4 w-4\",\n      },\n    },\n    defaultVariants: {\n      variant: \"default\",\n      size: \"default\",\n    },\n  }\n);\n\n// ============================================================================\n// Icon Components\n// ============================================================================\n\n/**\n * Checkmark SVG icon (default)\n * Used inside the checkbox indicator when selected\n */\nfunction CheckmarkIcon({ className, ...props }: { className?: string; 'data-selected'?: boolean }): ReactNode {\n  return (\n    <svg\n      className={className}\n      viewBox=\"0 0 24 24\"\n      fill=\"none\"\n      stroke=\"currentColor\"\n      strokeWidth={3}\n      strokeLinecap=\"round\"\n      strokeLinejoin=\"round\"\n      aria-hidden=\"true\"\n      {...props}\n    >\n      <polyline points=\"20 6 9 17 4 12\" />\n    </svg>\n  );\n}\n\n/**\n * Times (X) SVG icon\n * Alternative icon for destructive or exclusion selections\n * @example <Checkbox value=\"exclude\" selectedIcon={<TimesIcon />}>Exclude this item</Checkbox>\n */\nfunction TimesIcon({ className, ...props }: { className?: string; 'data-selected'?: boolean }): ReactNode {\n  return (\n    <svg\n      className={className}\n      viewBox=\"0 0 24 24\"\n      fill=\"none\"\n      stroke=\"currentColor\"\n      strokeWidth={3}\n      strokeLinecap=\"round\"\n      strokeLinejoin=\"round\"\n      aria-hidden=\"true\"\n      {...props}\n    >\n      <line x1=\"18\" y1=\"6\" x2=\"6\" y2=\"18\" />\n      <line x1=\"6\" y1=\"6\" x2=\"18\" y2=\"18\" />\n    </svg>\n  );\n}\n\n// ============================================================================\n// Sub-components\n// ============================================================================\n\n/**\n * Checkbox.Label - Styled label for checkbox item content\n */\nfunction CheckboxLabel({ children, className }: CheckboxLabelProps): ReactNode {\n  return (\n    <span className={cn(\"font-medium text-[var(--content-foreground)]\", className)}>\n      {children}\n    </span>\n  );\n}\n\nCheckboxLabel.displayName = \"Checkbox.Label\";\n\n/**\n * Checkbox.Description - Styled description for checkbox item content (muted)\n */\nfunction CheckboxDescription({ children, className }: CheckboxDescriptionProps): ReactNode {\n  return (\n    <span className={cn(\"text-sm text-[var(--menu-muted)]\", className)}>\n      {children}\n    </span>\n  );\n}\n\nCheckboxDescription.displayName = \"Checkbox.Description\";\n\n// ============================================================================\n// Checkbox Component\n// ============================================================================\n\n/**\n * Checkbox item component with bordered container design\n */\nfunction CheckboxComponent({ value, isDisabled, children, className, selectedIcon }: CheckboxProps): ReactNode {\n  const { variant, size, isInvalid, isDisabled: groupDisabled, isReadOnly } = useContext(CheckboxGroupContext);\n\n  // Individual isDisabled OR group isDisabled\n  const effectiveDisabled = isDisabled || groupDisabled;\n\n  // Render the selected icon - use custom icon if provided, otherwise default CheckmarkIcon\n  const renderSelectedIcon = (isSelected: boolean) => {\n    const iconClassName = cn(checkmarkVariants({ variant, size }));\n    const dataSelected = isSelected || undefined;\n\n    if (selectedIcon) {\n      // Clone the custom icon element to add our styling classes\n      if (isValidElement(selectedIcon)) {\n        const iconElement = selectedIcon as ReactElement<{ className?: string; 'data-selected'?: boolean }>;\n        return cloneElement(iconElement, {\n          className: cn(iconClassName, iconElement.props.className),\n          'data-selected': dataSelected,\n        });\n      }\n      // If it's not a valid element (e.g., just text), wrap it\n      return <span className={iconClassName} data-selected={dataSelected}>{selectedIcon}</span>;\n    }\n\n    // Default: CheckmarkIcon\n    return (\n      <CheckmarkIcon\n        className={iconClassName}\n        data-selected={dataSelected}\n      />\n    );\n  };\n\n  return (\n    <AriaCheckbox\n      value={value}\n      isDisabled={effectiveDisabled}\n      className={(renderProps) =>\n        cn(\n          checkboxItemVariants({\n            variant,\n            size,\n            isDisabled: renderProps.isDisabled,\n            isReadOnly,\n            isInvalid,\n          }),\n          className\n        )\n      }\n    >\n      {(renderProps) => (\n        <>\n          {/* Square indicator */}\n          <div\n            className={checkboxIndicatorVariants({ variant, size })}\n            data-selected={renderProps.isSelected || undefined}\n          >\n            {/* Icon with spring animation */}\n            {renderSelectedIcon(renderProps.isSelected)}\n          </div>\n\n          {/* Children content (flexible - text, icons, complex layouts) */}\n          <div className=\"flex-1 flex flex-col\">\n            {children}\n          </div>\n        </>\n      )}\n    </AriaCheckbox>\n  );\n}\n\n// Attach sub-components\nconst Checkbox = Object.assign(CheckboxComponent, {\n  Label: CheckboxLabel,\n  Description: CheckboxDescription,\n}) as typeof CheckboxComponent & {\n  Label: typeof CheckboxLabel;\n  Description: typeof CheckboxDescription;\n  displayName: string;\n};\n\nCheckbox.displayName = \"Checkbox\";\n\n// ============================================================================\n// Duplicate Value Warning\n// ============================================================================\n\n/**\n * Deduplicates array and warns in development mode\n * Per clarification: dedupe internally + console.warn in development\n */\nfunction dedupeWithWarning(values: string[] | undefined, componentName: string): string[] | undefined {\n  if (!values) return values;\n\n  const uniqueValues = [...new Set(values)];\n\n  if (process.env.NODE_ENV !== 'production' && uniqueValues.length !== values.length) {\n    console.warn(\n      `[${componentName}] Received duplicate values in value/defaultValue prop. ` +\n      `Original: [${values.join(', ')}], Deduplicated: [${uniqueValues.join(', ')}]. ` +\n      `Duplicate values are automatically removed.`\n    );\n  }\n\n  return uniqueValues;\n}\n\n// ============================================================================\n// CheckboxGroup Component\n// ============================================================================\n\n/**\n * CheckboxGroup root component\n * Accessible multi-selection control with bordered container design\n */\nconst CheckboxGroup = forwardRef<HTMLDivElement, CheckboxGroupProps>(\n  function CheckboxGroup(props: CheckboxGroupProps, ref: ForwardedRef<HTMLDivElement>) {\n    const {\n      // Display props\n      label,\n      description,\n      errorMessage,\n      // Selection props (string[] for multi-select)\n      value,\n      defaultValue,\n      // State props\n      isDisabled = false,\n      isReadOnly = false,\n      isRequired = false,\n      isInvalid = false,\n      // Layout props\n      orientation = 'vertical',\n      // Variant props\n      variant = 'default',\n      size = 'default',\n      // Form props\n      name,\n      // Event handlers\n      onChange,\n      onFocusChange,\n      // Standard props\n      className,\n      children,\n      id,\n      'aria-label': ariaLabel,\n      'aria-labelledby': ariaLabelledby,\n      'aria-describedby': ariaDescribedby,\n      'data-testid': dataTestId,\n      ...restProps\n    } = props;\n\n    // Generate unique IDs for accessibility\n    const generatedId = useId();\n    const checkboxGroupId = id ?? generatedId;\n    const labelId = `${checkboxGroupId}-label`;\n    const descriptionId = `${checkboxGroupId}-description`;\n    const errorId = `${checkboxGroupId}-error`;\n\n    // Build aria-describedby from description and error\n    const describedByParts: string[] = [];\n    if (ariaDescribedby) describedByParts.push(ariaDescribedby);\n    if (description) describedByParts.push(descriptionId);\n    if (isInvalid && errorMessage) describedByParts.push(errorId);\n    const computedAriaDescribedBy = describedByParts.length > 0\n      ? describedByParts.join(' ')\n      : undefined;\n\n    // Dedupe values with warning in development\n    const dedupedValue = dedupeWithWarning(value, 'CheckboxGroup');\n    const dedupedDefaultValue = dedupeWithWarning(defaultValue, 'CheckboxGroup');\n\n    return (\n      <CheckboxGroupContext.Provider value={{ variant, size, isInvalid, isDisabled, isReadOnly }}>\n        <AriaCheckboxGroup\n          ref={ref}\n          id={checkboxGroupId}\n          name={name}\n          value={dedupedValue}\n          defaultValue={dedupedDefaultValue}\n          isDisabled={isDisabled}\n          isReadOnly={isReadOnly}\n          isRequired={isRequired}\n          isInvalid={isInvalid}\n          onChange={onChange}\n          onFocusChange={onFocusChange}\n          aria-label={ariaLabel}\n          aria-labelledby={label ? labelId : ariaLabelledby}\n          aria-describedby={computedAriaDescribedBy}\n          aria-orientation={orientation}\n          aria-required={isRequired || undefined}\n          aria-invalid={isInvalid || undefined}\n          data-testid={dataTestId}\n          className={cn(\"flex flex-col gap-1.5\", className)}\n          {...restProps}\n        >\n          {/* Label with optional required asterisk */}\n          {label && (\n            <Label id={labelId} className=\"text-sm font-medium text-[var(--content-foreground)]\">\n              {label}\n              {isRequired && (\n                <span className=\"ml-1 text-[var(--destructive)]\" aria-hidden=\"true\">\n                  *\n                </span>\n              )}\n            </Label>\n          )}\n\n          {/* Description */}\n          {description && (\n            <Text\n              id={descriptionId}\n              slot=\"description\"\n              className=\"text-sm text-[var(--menu-muted)]\"\n            >\n              {description}\n            </Text>\n          )}\n\n          {/* Checkbox items container with orientation */}\n          <div className={checkboxGroupVariants({ orientation })}>\n            {children}\n          </div>\n\n          {/* Error message with role=\"alert\" for screen reader announcements */}\n          {isInvalid && errorMessage && (\n            <FieldError\n              id={errorId}\n              className=\"text-sm text-[var(--destructive)]\"\n            >\n              <span role=\"alert\">{errorMessage}</span>\n            </FieldError>\n          )}\n        </AriaCheckboxGroup>\n      </CheckboxGroupContext.Provider>\n    );\n  }\n);\n\nCheckboxGroup.displayName = \"CheckboxGroup\";\n\n// ============================================================================\n// Exports\n// ============================================================================\n\nexport {\n  CheckboxGroup,\n  Checkbox,\n  checkboxGroupVariants,\n  checkboxItemVariants,\n  checkboxIndicatorVariants,\n  checkmarkVariants,\n  // Icon exports for custom selectedIcon usage\n  CheckmarkIcon,\n  TimesIcon,\n};\n"]}