@tribepad/themis 1.0.0 → 1.0.1

package/dist/elements/Progress/index.mjs

@@ -1,5 +1,183 @@
-export { Progress, ProgressPropsSchema, progressContainerVariants, progressIndicatorVariants, progressTrackVariants } from '../../chunk-FJRXLJC2.mjs';
-import '../../chunk-E2KQFV3O.mjs';
-import '../../chunk-5SVLJN2C.mjs';
+"use client";
+import { memo, forwardRef, useId } from 'react';
+import { ProgressBar } 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';
+import { z } from 'zod';
+
+// src/elements/Progress/Progress.tsx
+function cn(...inputs) {
+  return twMerge(clsx(inputs));
+}
+var progressTrackVariants = cva(
+  // Base styles - track container
+  "relative w-full overflow-hidden rounded-full bg-[var(--accent-background)]",
+  {
+    variants: {
+      size: {
+        sm: "h-1",
+        // 4px
+        default: "h-2",
+        // 8px
+        lg: "h-3"
+        // 12px
+      }
+    },
+    defaultVariants: {
+      size: "default"
+    }
+  }
+);
+var progressIndicatorVariants = cva(
+  // Base styles - indicator with smooth transition
+  "h-full rounded-full transition-all duration-300 ease-out",
+  {
+    variants: {
+      variant: {
+        default: "bg-[var(--primary)]",
+        success: "bg-[var(--success,hsl(142,76%,36%))]",
+        warning: "bg-[var(--warning,hsl(38,92%,50%))]",
+        destructive: "bg-[var(--destructive)]"
+      }
+    },
+    defaultVariants: {
+      variant: "default"
+    }
+  }
+);
+var progressContainerVariants = cva("flex w-full gap-2", {
+  variants: {
+    labelPosition: {
+      top: "flex-col",
+      side: "flex-row items-center"
+    }
+  },
+  defaultVariants: {
+    labelPosition: "top"
+  }
+});
+var Progress = memo(
+  forwardRef(
+    ({
+      value,
+      minValue = 0,
+      maxValue = 100,
+      isIndeterminate = false,
+      label,
+      showValueLabel = true,
+      valueLabel,
+      formatOptions,
+      labelPosition = "top",
+      variant = "default",
+      size = "default",
+      className,
+      "aria-label": ariaLabel,
+      "aria-labelledby": ariaLabelledBy,
+      "aria-describedby": ariaDescribedBy,
+      ...props
+    }, ref) => {
+      const labelId = useId();
+      const shouldShowValueLabel = showValueLabel && !isIndeterminate;
+      return /* @__PURE__ */ jsx(
+        ProgressBar,
+        {
+          ref,
+          value: isIndeterminate ? void 0 : value,
+          minValue,
+          maxValue,
+          isIndeterminate,
+          formatOptions: formatOptions ?? { style: "percent" },
+          "aria-label": ariaLabel,
+          "aria-labelledby": label ? labelId : ariaLabelledBy,
+          "aria-describedby": ariaDescribedBy,
+          className: cn(progressContainerVariants({ labelPosition }), className),
+          ...props,
+          children: ({ percentage, valueText }) => /* @__PURE__ */ jsxs(Fragment, { children: [
+            (label || shouldShowValueLabel) && /* @__PURE__ */ jsxs("div", { className: "flex justify-between text-sm", children: [
+              label && /* @__PURE__ */ jsx(
+                "span",
+                {
+                  id: labelId,
+                  className: "font-medium text-[var(--content-foreground)]",
+                  children: label
+                }
+              ),
+              shouldShowValueLabel && /* @__PURE__ */ jsx(
+                "span",
+                {
+                  "aria-hidden": "true",
+                  className: "text-[var(--menu-muted)]",
+                  children: valueLabel ?? valueText
+                }
+              )
+            ] }),
+            /* @__PURE__ */ jsx("div", { className: progressTrackVariants({ size }), children: /* @__PURE__ */ jsx(
+              "div",
+              {
+                className: cn(
+                  progressIndicatorVariants({ variant }),
+                  isIndeterminate && "motion-safe:animate-pulse"
+                ),
+                style: {
+                  width: isIndeterminate ? "100%" : `${percentage ?? 0}%`
+                }
+              }
+            ) })
+          ] })
+        }
+      );
+    }
+  )
+);
+Progress.displayName = "Progress";
+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/Progress/Progress.types.ts
+var ProgressPropsSchema = BaseComponentPropsSchema.extend({
+  // Value props
+  /** Current progress value (0-100 by default) */
+  value: z.number().optional(),
+  /** Minimum value (default: 0) */
+  minValue: z.number().optional().default(0),
+  /** Maximum value (default: 100) */
+  maxValue: z.number().optional().default(100),
+  /** When true, shows indeterminate animation (unknown progress) */
+  isIndeterminate: z.boolean().optional(),
+  // Label props
+  /** Label text displayed above or beside the progress bar */
+  label: z.string().optional(),
+  /** Show/hide the value label (default: true) */
+  showValueLabel: z.boolean().optional().default(true),
+  /** Custom value label text (overrides formatted value) */
+  valueLabel: z.string().optional(),
+  /** Label position relative to progress bar */
+  labelPosition: z.enum(["top", "side"]).optional().default("top"),
+  // Note: formatOptions is Intl.NumberFormatOptions which can't be validated by Zod
+  // It's handled in the TypeScript interface instead
+  // Variants
+  /** Color variant for semantic meaning */
+  variant: z.enum(["default", "success", "warning", "destructive"]).optional().default("default"),
+  /** Size variant controlling track height */
+  size: z.enum(["sm", "default", "lg"]).optional().default("default")
+});
+
+export { Progress, ProgressPropsSchema, progressContainerVariants, progressIndicatorVariants, progressTrackVariants };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

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

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.mjs"}
+{"version":3,"sources":["../../../src/utils/cn.ts","../../../src/elements/Progress/Progress.tsx","../../../src/schemas/BaseComponentProps.ts","../../../src/elements/Progress/Progress.types.ts"],"names":["AriaProgressBar","z"],"mappings":";;;;;;;;;AAcO,SAAS,MAAM,MAAA,EAA8B;AAClD,EAAA,OAAO,OAAA,CAAQ,IAAA,CAAK,MAAM,CAAC,CAAA;AAC7B;ACMA,IAAM,qBAAA,GAAwB,GAAA;AAAA;AAAA,EAE5B,4EAAA;AAAA,EACA;AAAA,IACE,QAAA,EAAU;AAAA,MACR,IAAA,EAAM;AAAA,QACJ,EAAA,EAAI,KAAA;AAAA;AAAA,QACJ,OAAA,EAAS,KAAA;AAAA;AAAA,QACT,EAAA,EAAI;AAAA;AAAA;AACN,KACF;AAAA,IACA,eAAA,EAAiB;AAAA,MACf,IAAA,EAAM;AAAA;AACR;AAEJ;AAMA,IAAM,yBAAA,GAA4B,GAAA;AAAA;AAAA,EAEhC,0DAAA;AAAA,EACA;AAAA,IACE,QAAA,EAAU;AAAA,MACR,OAAA,EAAS;AAAA,QACP,OAAA,EAAS,qBAAA;AAAA,QACT,OAAA,EAAS,sCAAA;AAAA,QACT,OAAA,EAAS,qCAAA;AAAA,QACT,WAAA,EAAa;AAAA;AACf,KACF;AAAA,IACA,eAAA,EAAiB;AAAA,MACf,OAAA,EAAS;AAAA;AACX;AAEJ;AAKA,IAAM,yBAAA,GAA4B,IAAI,mBAAA,EAAqB;AAAA,EACzD,QAAA,EAAU;AAAA,IACR,aAAA,EAAe;AAAA,MACb,GAAA,EAAK,UAAA;AAAA,MACL,IAAA,EAAM;AAAA;AACR,GACF;AAAA,EACA,eAAA,EAAiB;AAAA,IACf,aAAA,EAAe;AAAA;AAEnB,CAAC;AAyBD,IAAM,QAAA,GAAW,IAAA;AAAA,EACf,UAAA;AAAA,IACE,CACE;AAAA,MACE,KAAA;AAAA,MACA,QAAA,GAAW,CAAA;AAAA,MACX,QAAA,GAAW,GAAA;AAAA,MACX,eAAA,GAAkB,KAAA;AAAA,MAClB,KAAA;AAAA,MACA,cAAA,GAAiB,IAAA;AAAA,MACjB,UAAA;AAAA,MACA,aAAA;AAAA,MACA,aAAA,GAAgB,KAAA;AAAA,MAChB,OAAA,GAAU,SAAA;AAAA,MACV,IAAA,GAAO,SAAA;AAAA,MACP,SAAA;AAAA,MACA,YAAA,EAAc,SAAA;AAAA,MACd,iBAAA,EAAmB,cAAA;AAAA,MACnB,kBAAA,EAAoB,eAAA;AAAA,MACpB,GAAG;AAAA,OAEL,GAAA,KACG;AACH,MAAA,MAAM,UAAU,KAAA,EAAM;AAGtB,MAAA,MAAM,oBAAA,GAAuB,kBAAkB,CAAC,eAAA;AAEhD,MAAA,uBACE,GAAA;AAAA,QAACA,WAAA;AAAA,QAAA;AAAA,UACC,GAAA;AAAA,UACA,KAAA,EAAO,kBAAkB,MAAA,GAAY,KAAA;AAAA,UACrC,QAAA;AAAA,UACA,QAAA;AAAA,UACA,eAAA;AAAA,UACA,aAAA,EAAe,aAAA,IAAiB,EAAE,KAAA,EAAO,SAAA,EAAU;AAAA,UACnD,YAAA,EAAY,SAAA;AAAA,UACZ,iBAAA,EAAiB,QAAQ,OAAA,GAAU,cAAA;AAAA,UACnC,kBAAA,EAAkB,eAAA;AAAA,UAClB,WAAW,EAAA,CAAG,yBAAA,CAA0B,EAAE,aAAA,EAAe,GAAG,SAAS,CAAA;AAAA,UACpE,GAAG,KAAA;AAAA,UAEH,QAAA,EAAA,CAAC,EAAE,UAAA,EAAY,SAAA,uBACd,IAAA,CAAA,QAAA,EAAA,EAEI,QAAA,EAAA;AAAA,YAAA,CAAA,KAAA,IAAS,oBAAA,qBACT,IAAA,CAAC,KAAA,EAAA,EAAI,SAAA,EAAU,8BAAA,EACZ,QAAA,EAAA;AAAA,cAAA,KAAA,oBACC,GAAA;AAAA,gBAAC,MAAA;AAAA,gBAAA;AAAA,kBACC,EAAA,EAAI,OAAA;AAAA,kBACJ,SAAA,EAAU,8CAAA;AAAA,kBAET,QAAA,EAAA;AAAA;AAAA,eACH;AAAA,cAED,oBAAA,oBACC,GAAA;AAAA,gBAAC,MAAA;AAAA,gBAAA;AAAA,kBACC,aAAA,EAAY,MAAA;AAAA,kBACZ,SAAA,EAAU,0BAAA;AAAA,kBAET,QAAA,EAAA,UAAA,IAAc;AAAA;AAAA;AACjB,aAAA,EAEJ,CAAA;AAAA,gCAID,KAAA,EAAA,EAAI,SAAA,EAAW,sBAAsB,EAAE,IAAA,EAAM,CAAA,EAC5C,QAAA,kBAAA,GAAA;AAAA,cAAC,KAAA;AAAA,cAAA;AAAA,gBACC,SAAA,EAAW,EAAA;AAAA,kBACT,yBAAA,CAA0B,EAAE,OAAA,EAAS,CAAA;AAAA,kBACrC,eAAA,IAAmB;AAAA,iBACrB;AAAA,gBACA,KAAA,EAAO;AAAA,kBACL,KAAA,EAAO,eAAA,GAAkB,MAAA,GAAS,CAAA,EAAG,cAAc,CAAC,CAAA,CAAA;AAAA;AACtD;AAAA,aACF,EACF;AAAA,WAAA,EACF;AAAA;AAAA,OAEJ;AAAA,IAEJ;AAAA;AAEJ;AAEA,QAAA,CAAS,WAAA,GAAc,UAAA;AChLhB,IAAM,wBAAA,GAA2B,EAAE,MAAA,CAAO;AAAA;AAAA,EAE/C,SAAA,EAAW,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA;AAAA,EAG/B,QAAA,EAAU,CAAA,CAAE,GAAA,EAAI,CAAE,QAAA,EAAS;AAAA;AAAA,EAC3B,EAAA,EAAI,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA;AAAA,EAGxB,YAAA,EAAc,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAClC,iBAAA,EAAmB,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EACvC,kBAAA,EAAoB,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EACxC,WAAA,EAAa,EAAE,IAAA,CAAK,CAAC,OAAO,QAAA,EAAU,WAAW,CAAC,CAAA,CAAE,QAAA,EAAS;AAAA,EAC7D,aAAA,EAAe,CAAA,CAAE,OAAA,EAAQ,CAAE,QAAA,EAAS;AAAA;AAAA,EAGpC,aAAA,EAAe,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA;AAC5B,CAAC,CAAA;;;ACdM,IAAM,mBAAA,GAAsB,yBAAyB,MAAA,CAAO;AAAA;AAAA;AAAA,EAGjE,KAAA,EAAOC,CAAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA;AAAA,EAE3B,UAAUA,CAAAA,CAAE,MAAA,GAAS,QAAA,EAAS,CAAE,QAAQ,CAAC,CAAA;AAAA;AAAA,EAEzC,UAAUA,CAAAA,CAAE,MAAA,GAAS,QAAA,EAAS,CAAE,QAAQ,GAAG,CAAA;AAAA;AAAA,EAE3C,eAAA,EAAiBA,CAAAA,CAAE,OAAA,EAAQ,CAAE,QAAA,EAAS;AAAA;AAAA;AAAA,EAItC,KAAA,EAAOA,CAAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA;AAAA,EAE3B,gBAAgBA,CAAAA,CAAE,OAAA,GAAU,QAAA,EAAS,CAAE,QAAQ,IAAI,CAAA;AAAA;AAAA,EAEnD,UAAA,EAAYA,CAAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA;AAAA,EAEhC,aAAA,EAAeA,CAAAA,CAAE,IAAA,CAAK,CAAC,KAAA,EAAO,MAAM,CAAC,CAAA,CAAE,QAAA,EAAS,CAAE,OAAA,CAAQ,KAAK,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAO/D,OAAA,EAASA,CAAAA,CACN,IAAA,CAAK,CAAC,SAAA,EAAW,SAAA,EAAW,SAAA,EAAW,aAAa,CAAC,CAAA,CACrD,QAAA,EAAS,CACT,QAAQ,SAAS,CAAA;AAAA;AAAA,EAEpB,IAAA,EAAMA,CAAAA,CAAE,IAAA,CAAK,CAAC,IAAA,EAAM,SAAA,EAAW,IAAI,CAAC,CAAA,CAAE,QAAA,EAAS,CAAE,OAAA,CAAQ,SAAS;AACpE,CAAC","file":"index.mjs","sourcesContent":["/**\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","\"use client\";\n\n/**\n * Progress Component\n * Accessible progress bar with React Aria primitives and CVA styling\n *\n * @see React Aria ProgressBar: https://react-aria.adobe.com/ProgressBar\n * @see ShadCN Progress: https://ui.shadcn.com/docs/components/progress\n * @see spec.md FR-009 (WCAG 2.2 AAA - 7:1 contrast ratio)\n * @see constitution.md Principle IV (Accessibility First)\n */\n\nimport { forwardRef, memo, useId } from 'react';\nimport { ProgressBar as AriaProgressBar } from 'react-aria-components';\nimport { cva, type VariantProps } from 'class-variance-authority';\nimport { cn } from '../../utils/cn';\nimport type { ProgressProps } from './Progress.types';\n\n/**\n * Progress track variants (the background container)\n * Controls size/height of the progress bar\n */\nconst progressTrackVariants = cva(\n  // Base styles - track container\n  'relative w-full overflow-hidden rounded-full bg-[var(--accent-background)]',\n  {\n    variants: {\n      size: {\n        sm: 'h-1',      // 4px\n        default: 'h-2', // 8px\n        lg: 'h-3',      // 12px\n      },\n    },\n    defaultVariants: {\n      size: 'default',\n    },\n  }\n);\n\n/**\n * Progress indicator variants (the filled portion)\n * Controls color and animation based on variant and state\n */\nconst progressIndicatorVariants = cva(\n  // Base styles - indicator with smooth transition\n  'h-full rounded-full transition-all duration-300 ease-out',\n  {\n    variants: {\n      variant: {\n        default: 'bg-[var(--primary)]',\n        success: 'bg-[var(--success,hsl(142,76%,36%))]',\n        warning: 'bg-[var(--warning,hsl(38,92%,50%))]',\n        destructive: 'bg-[var(--destructive)]',\n      },\n    },\n    defaultVariants: {\n      variant: 'default',\n    },\n  }\n);\n\n/**\n * Progress container variants (wrapper with label positioning)\n */\nconst progressContainerVariants = cva('flex w-full gap-2', {\n  variants: {\n    labelPosition: {\n      top: 'flex-col',\n      side: 'flex-row items-center',\n    },\n  },\n  defaultVariants: {\n    labelPosition: 'top',\n  },\n});\n\nexport interface ProgressComponentProps\n  extends Omit<ProgressProps, 'children' | 'size' | 'variant'>,\n    VariantProps<typeof progressTrackVariants>,\n    VariantProps<typeof progressIndicatorVariants> {\n  /** Size variant controlling track height */\n  size?: 'sm' | 'default' | 'lg';\n  /** Color variant for semantic meaning */\n  variant?: 'default' | 'success' | 'warning' | 'destructive';\n}\n\n/**\n * Progress Component\n * Displays determinate or indeterminate progress indicators\n *\n * Features:\n * - WCAG 2.2 AAA compliant (7:1 contrast ratio)\n * - Determinate and indeterminate modes\n * - Custom value formatting via Intl.NumberFormat\n * - 3 size variants (sm, default, lg)\n * - 4 color variants (default, success, warning, destructive)\n * - Label support with flexible positioning\n * - Theme-aware styling via semantic CSS tokens\n */\nconst Progress = memo(\n  forwardRef<HTMLDivElement, ProgressComponentProps>(\n    (\n      {\n        value,\n        minValue = 0,\n        maxValue = 100,\n        isIndeterminate = false,\n        label,\n        showValueLabel = true,\n        valueLabel,\n        formatOptions,\n        labelPosition = 'top',\n        variant = 'default',\n        size = 'default',\n        className,\n        'aria-label': ariaLabel,\n        'aria-labelledby': ariaLabelledBy,\n        'aria-describedby': ariaDescribedBy,\n        ...props\n      },\n      ref\n    ) => {\n      const labelId = useId();\n\n      // Determine if we should show the value label\n      const shouldShowValueLabel = showValueLabel && !isIndeterminate;\n\n      return (\n        <AriaProgressBar\n          ref={ref}\n          value={isIndeterminate ? undefined : value}\n          minValue={minValue}\n          maxValue={maxValue}\n          isIndeterminate={isIndeterminate}\n          formatOptions={formatOptions ?? { style: 'percent' }}\n          aria-label={ariaLabel}\n          aria-labelledby={label ? labelId : ariaLabelledBy}\n          aria-describedby={ariaDescribedBy}\n          className={cn(progressContainerVariants({ labelPosition }), className)}\n          {...props}\n        >\n          {({ percentage, valueText }) => (\n            <>\n              {/* Label row with optional value display */}\n              {(label || shouldShowValueLabel) && (\n                <div className=\"flex justify-between text-sm\">\n                  {label && (\n                    <span\n                      id={labelId}\n                      className=\"font-medium text-[var(--content-foreground)]\"\n                    >\n                      {label}\n                    </span>\n                  )}\n                  {shouldShowValueLabel && (\n                    <span\n                      aria-hidden=\"true\"\n                      className=\"text-[var(--menu-muted)]\"\n                    >\n                      {valueLabel ?? valueText}\n                    </span>\n                  )}\n                </div>\n              )}\n\n              {/* Progress track and indicator */}\n              <div className={progressTrackVariants({ size })}>\n                <div\n                  className={cn(\n                    progressIndicatorVariants({ variant }),\n                    isIndeterminate && 'motion-safe:animate-pulse'\n                  )}\n                  style={{\n                    width: isIndeterminate ? '100%' : `${percentage ?? 0}%`,\n                  }}\n                />\n              </div>\n            </>\n          )}\n        </AriaProgressBar>\n      );\n    }\n  )\n);\n\nProgress.displayName = 'Progress';\n\nexport {\n  Progress,\n  progressTrackVariants,\n  progressIndicatorVariants,\n  progressContainerVariants,\n};\n","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';\n\n/**\n * Progress props schema extending BaseComponentProps\n *\n * @see React Aria ProgressBar: https://react-aria.adobe.com/ProgressBar\n * @see ShadCN Progress: https://ui.shadcn.com/docs/components/progress\n * @see tasks.md Phase 1.1 (Type System)\n * @see spec.md FR-009 (WCAG 2.2 AAA - 7:1 contrast ratio)\n * @see constitution.md Principle IV (Accessibility First)\n */\nexport const ProgressPropsSchema = BaseComponentPropsSchema.extend({\n  // Value props\n  /** Current progress value (0-100 by default) */\n  value: z.number().optional(),\n  /** Minimum value (default: 0) */\n  minValue: z.number().optional().default(0),\n  /** Maximum value (default: 100) */\n  maxValue: z.number().optional().default(100),\n  /** When true, shows indeterminate animation (unknown progress) */\n  isIndeterminate: z.boolean().optional(),\n\n  // Label props\n  /** Label text displayed above or beside the progress bar */\n  label: z.string().optional(),\n  /** Show/hide the value label (default: true) */\n  showValueLabel: z.boolean().optional().default(true),\n  /** Custom value label text (overrides formatted value) */\n  valueLabel: z.string().optional(),\n  /** Label position relative to progress bar */\n  labelPosition: z.enum(['top', 'side']).optional().default('top'),\n\n  // Note: formatOptions is Intl.NumberFormatOptions which can't be validated by Zod\n  // It's handled in the TypeScript interface instead\n\n  // Variants\n  /** Color variant for semantic meaning */\n  variant: z\n    .enum(['default', 'success', 'warning', 'destructive'])\n    .optional()\n    .default('default'),\n  /** Size variant controlling track height */\n  size: z.enum(['sm', 'default', 'lg']).optional().default('default'),\n});\n\nexport type ProgressProps = z.infer<typeof ProgressPropsSchema> & {\n  /** Number format options for value display (default: { style: 'percent' }) */\n  formatOptions?: Intl.NumberFormatOptions;\n};\n\n/**\n * Progress variant type for CVA\n */\nexport type ProgressVariant = NonNullable<ProgressProps['variant']>;\n\n/**\n * Progress size type for CVA\n */\nexport type ProgressSize = NonNullable<ProgressProps['size']>;\n\n/**\n * Progress label position type\n */\nexport type ProgressLabelPosition = NonNullable<ProgressProps['labelPosition']>;\n"]}

package/dist/elements/RadioGroup/index.js

@@ -1,47 +1,371 @@
+"use client";
 'use strict';
 
-var chunkFKQI434R_js = require('../../chunk-FKQI434R.js');
-require('../../chunk-B5Q4UPL6.js');
-require('../../chunk-VIREG536.js');
-require('../../chunk-T4COXKQ3.js');
+var react = require('react');
+var reactAriaComponents = require('react-aria-components');
+var classVarianceAuthority = require('class-variance-authority');
+var clsx = require('clsx');
+var tailwindMerge = require('tailwind-merge');
+var jsxRuntime = require('react/jsx-runtime');
+var zod = require('zod');
 
+// src/elements/RadioGroup/RadioGroup.tsx
+function cn(...inputs) {
+  return tailwindMerge.twMerge(clsx.clsx(inputs));
+}
 
-
-Object.defineProperty(exports, "Radio", {
-  enumerable: true,
-  get: function () { return chunkFKQI434R_js.Radio; }
-});
-Object.defineProperty(exports, "RadioDescriptionPropsSchema", {
-  enumerable: true,
-  get: function () { return chunkFKQI434R_js.RadioDescriptionPropsSchema; }
-});
-Object.defineProperty(exports, "RadioGroup", {
-  enumerable: true,
-  get: function () { return chunkFKQI434R_js.RadioGroup; }
+// 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 RadioGroupContext = react.createContext({
+  variant: "default",
+  size: "default",
+  isInvalid: false
 });
-Object.defineProperty(exports, "RadioGroupOrientationSchema", {
-  enumerable: true,
-  get: function () { return chunkFKQI434R_js.RadioGroupOrientationSchema; }
+var radioGroupVariants = classVarianceAuthority.cva(
+  // Base: flex container
+  "flex",
+  {
+    variants: {
+      orientation: {
+        vertical: "flex-col gap-2",
+        horizontal: "flex-row flex-wrap gap-2"
+      }
+    },
+    defaultVariants: {
+      orientation: "vertical"
+    }
+  }
+);
+var radioItemVariants = classVarianceAuthority.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: ""
+      },
+      isInvalid: {
+        // Error: ALL items get destructive border (cognitive accessibility)
+        true: "border-[var(--destructive)]",
+        false: ""
+      }
+    },
+    defaultVariants: {
+      variant: "default",
+      size: "default",
+      isDisabled: false,
+      isInvalid: false
+    }
+  }
+);
+var radioIndicatorVariants = classVarianceAuthority.cva(
+  // Base: circle with border, flex-shrink-0 to prevent squishing
+  "flex-shrink-0 rounded-full border-2 flex items-center justify-center transition-colors duration-200",
+  {
+    variants: {
+      variant: {
+        default: [
+          "border-[var(--border)]",
+          "data-[selected]:border-[var(--primary)]"
+        ].join(" "),
+        destructive: [
+          "border-[var(--border)]",
+          "data-[selected]:border-[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 radioInnerDotVariants = classVarianceAuthority.cva(
+  // Base: centered dot with spring animation
+  [
+    "rounded-full 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: "bg-[var(--primary)]",
+        destructive: "bg-[var(--destructive)]"
+      },
+      size: {
+        sm: "h-2 w-2",
+        default: "h-2.5 w-2.5",
+        lg: "h-3 w-3"
+      }
+    },
+    defaultVariants: {
+      variant: "default",
+      size: "default"
+    }
+  }
+);
+function RadioLabel({ children, className }) {
+  return /* @__PURE__ */ jsxRuntime.jsx("span", { className: cn("font-medium text-[var(--content-foreground)]", className), children });
+}
+RadioLabel.displayName = "Radio.Label";
+function RadioDescription({ children, className }) {
+  return /* @__PURE__ */ jsxRuntime.jsx("span", { className: cn("text-sm text-[var(--menu-muted)]", className), children });
+}
+RadioDescription.displayName = "Radio.Description";
+function RadioComponent({ value, isDisabled, children, className }) {
+  const { variant, size, isInvalid } = react.useContext(RadioGroupContext);
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    reactAriaComponents.Radio,
+    {
+      value,
+      isDisabled,
+      className: (renderProps) => cn(
+        radioItemVariants({
+          variant,
+          size,
+          isDisabled: renderProps.isDisabled,
+          isInvalid
+        }),
+        className
+      ),
+      children: (renderProps) => /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+        /* @__PURE__ */ jsxRuntime.jsx(
+          "div",
+          {
+            className: radioIndicatorVariants({ variant, size }),
+            "data-selected": renderProps.isSelected || void 0,
+            children: /* @__PURE__ */ jsxRuntime.jsx(
+              "div",
+              {
+                className: radioInnerDotVariants({ variant, size }),
+                "data-selected": renderProps.isSelected || void 0
+              }
+            )
+          }
+        ),
+        /* @__PURE__ */ jsxRuntime.jsx("div", { className: "flex-1 flex flex-col", children })
+      ] })
+    }
+  );
+}
+var Radio = Object.assign(RadioComponent, {
+  Label: RadioLabel,
+  Description: RadioDescription
 });
-Object.defineProperty(exports, "RadioGroupPropsSchema", {
-  enumerable: true,
-  get: function () { return chunkFKQI434R_js.RadioGroupPropsSchema; }
+Radio.displayName = "Radio";
+var RadioGroup = react.forwardRef(
+  function RadioGroup2(props, ref) {
+    const {
+      // Display props
+      label,
+      description,
+      errorMessage,
+      // Selection props
+      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 = react.useId();
+    const radioGroupId = id ?? generatedId;
+    const labelId = `${radioGroupId}-label`;
+    const descriptionId = `${radioGroupId}-description`;
+    const errorId = `${radioGroupId}-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;
+    return /* @__PURE__ */ jsxRuntime.jsx(RadioGroupContext.Provider, { value: { variant, size, isInvalid }, children: /* @__PURE__ */ jsxRuntime.jsxs(
+      reactAriaComponents.RadioGroup,
+      {
+        ref,
+        id: radioGroupId,
+        name,
+        value: value ?? void 0,
+        defaultValue: defaultValue ?? void 0,
+        isDisabled,
+        isReadOnly,
+        isRequired,
+        isInvalid,
+        orientation,
+        onChange,
+        onFocusChange,
+        "aria-label": ariaLabel,
+        "aria-labelledby": label ? labelId : ariaLabelledby,
+        "aria-describedby": computedAriaDescribedBy,
+        "data-testid": dataTestId,
+        "data-orientation": orientation,
+        className: cn("flex flex-col gap-1.5", className),
+        ...restProps,
+        children: [
+          label && /* @__PURE__ */ jsxRuntime.jsxs(reactAriaComponents.Label, { id: labelId, className: "text-sm font-medium text-[var(--content-foreground)]", children: [
+            label,
+            isRequired && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "ml-1 text-[var(--destructive)]", "aria-hidden": "true", children: "*" })
+          ] }),
+          description && /* @__PURE__ */ jsxRuntime.jsx(
+            reactAriaComponents.Text,
+            {
+              id: descriptionId,
+              slot: "description",
+              className: "text-sm text-[var(--menu-muted)]",
+              children: description
+            }
+          ),
+          /* @__PURE__ */ jsxRuntime.jsx("div", { className: radioGroupVariants({ orientation }), children }),
+          isInvalid && errorMessage && /* @__PURE__ */ jsxRuntime.jsx(
+            reactAriaComponents.FieldError,
+            {
+              id: errorId,
+              className: "text-sm text-[var(--destructive)]",
+              children: /* @__PURE__ */ jsxRuntime.jsx("span", { role: "alert", children: errorMessage })
+            }
+          )
+        ]
+      }
+    ) });
+  }
+);
+RadioGroup.displayName = "RadioGroup";
+var BaseComponentPropsSchema = zod.z.object({
+  // Styling
+  className: zod.z.string().optional(),
+  // React
+  children: zod.z.any().optional(),
+  // ReactNode not directly supported by Zod
+  id: zod.z.string().optional(),
+  // Accessibility (WCAG 2.2 AA requirements)
+  "aria-label": zod.z.string().optional(),
+  "aria-labelledby": zod.z.string().optional(),
+  "aria-describedby": zod.z.string().optional(),
+  "aria-live": zod.z.enum(["off", "polite", "assertive"]).optional(),
+  "aria-hidden": zod.z.boolean().optional(),
+  // Testing & Development
+  "data-testid": zod.z.string().optional()
 });
-Object.defineProperty(exports, "RadioGroupSizeSchema", {
-  enumerable: true,
-  get: function () { return chunkFKQI434R_js.RadioGroupSizeSchema; }
+
+// src/elements/RadioGroup/RadioGroup.types.ts
+var RadioGroupVariantSchema = zod.z.enum(["default", "destructive"]);
+var RadioGroupSizeSchema = zod.z.enum(["sm", "default", "lg"]);
+var RadioGroupOrientationSchema = zod.z.enum(["vertical", "horizontal"]);
+var RadioGroupPropsSchema = BaseComponentPropsSchema.extend({
+  // Display props (US-4)
+  label: zod.z.string().optional(),
+  description: zod.z.string().optional(),
+  errorMessage: zod.z.string().optional(),
+  // Selection props (US-1) - nullable for no initial selection
+  value: zod.z.string().nullable().optional(),
+  defaultValue: zod.z.string().nullable().optional(),
+  // State props (US-6)
+  isDisabled: zod.z.boolean().optional().default(false),
+  isReadOnly: zod.z.boolean().optional().default(false),
+  isRequired: zod.z.boolean().optional().default(false),
+  isInvalid: zod.z.boolean().optional().default(false),
+  // Layout props (US-5)
+  orientation: RadioGroupOrientationSchema.optional().default("vertical"),
+  // Variant props (US-2, US-3) - 2 variants only
+  variant: RadioGroupVariantSchema.optional().default("default"),
+  size: RadioGroupSizeSchema.optional().default("default"),
+  // Form props (US-6)
+  name: zod.z.string().optional(),
+  // Event handlers
+  onChange: zod.z.custom().optional(),
+  onFocusChange: zod.z.custom().optional(),
+  // Children (Radio components)
+  children: zod.z.custom()
 });
-Object.defineProperty(exports, "RadioGroupVariantSchema", {
-  enumerable: true,
-  get: function () { return chunkFKQI434R_js.RadioGroupVariantSchema; }
+var RadioPropsSchema = BaseComponentPropsSchema.extend({
+  // Item value (required)
+  value: zod.z.string(),
+  // Disabled state (individual item)
+  isDisabled: zod.z.boolean().optional().default(false),
+  // Item content - accepts any ReactNode for flexible children
+  children: zod.z.custom(),
+  // Optional className for custom styling
+  className: zod.z.string().optional()
 });
-Object.defineProperty(exports, "RadioLabelPropsSchema", {
-  enumerable: true,
-  get: function () { return chunkFKQI434R_js.RadioLabelPropsSchema; }
+var RadioLabelPropsSchema = zod.z.object({
+  // Label content
+  children: zod.z.custom(),
+  // Optional className for custom styling
+  className: zod.z.string().optional()
 });
-Object.defineProperty(exports, "RadioPropsSchema", {
-  enumerable: true,
-  get: function () { return chunkFKQI434R_js.RadioPropsSchema; }
+var RadioDescriptionPropsSchema = zod.z.object({
+  // Description content
+  children: zod.z.custom(),
+  // Optional className for custom styling
+  className: zod.z.string().optional()
 });
+
+exports.Radio = Radio;
+exports.RadioDescriptionPropsSchema = RadioDescriptionPropsSchema;
+exports.RadioGroup = RadioGroup;
+exports.RadioGroupOrientationSchema = RadioGroupOrientationSchema;
+exports.RadioGroupPropsSchema = RadioGroupPropsSchema;
+exports.RadioGroupSizeSchema = RadioGroupSizeSchema;
+exports.RadioGroupVariantSchema = RadioGroupVariantSchema;
+exports.RadioLabelPropsSchema = RadioLabelPropsSchema;
+exports.RadioPropsSchema = RadioPropsSchema;
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map