@mieweb/ui 0.7.3 → 0.8.0-dev.0

package/dist/{chunk-KFLDXJEE.js → chunk-753Z3NXL.js}

@@ -1,3 +1,4 @@
+import { floatingGroupLabelVariants, floatingGroupVariants } from './chunk-3IMM2PM4.js';
 import { cn } from './chunk-TQONQSJO.js';
 import * as React from 'react';
 import { cva } from 'class-variance-authority';
@@ -145,6 +146,7 @@ var Checkbox = React.forwardRef(
 Checkbox.displayName = "Checkbox";
 function CheckboxGroup({
   label,
+  labelVariant = "stacked",
   description,
   error,
   orientation = "vertical",
@@ -154,6 +156,19 @@ function CheckboxGroup({
   const groupId = React.useId();
   const descriptionId = `${groupId}-description`;
   const errorId = `${groupId}-error`;
+  const isFloating = labelVariant === "floating" && !!label;
+  const itemsElement = /* @__PURE__ */ jsx(
+    "div",
+    {
+      role: "group",
+      "data-slot": "checkbox-group-items",
+      className: cn(
+        "flex gap-4",
+        orientation === "vertical" && "flex-col gap-2"
+      ),
+      children
+    }
+  );
   return /* @__PURE__ */ jsxs(
     "fieldset",
     {
@@ -165,31 +180,47 @@ function CheckboxGroup({
           "legend",
           {
             "data-slot": "checkbox-group-legend",
-            className: "text-foreground mb-1 text-sm font-medium",
+            className: cn(
+              // Legends are excluded from the fieldset's flex layout; explicit
+              // margin matches the stacked Input label's 6px gap.
+              "text-foreground mb-1.5 text-sm font-medium",
+              isFloating && "sr-only"
+            ),
             children: label
           }
         ),
+        isFloating ? /* @__PURE__ */ jsxs(
+          "div",
+          {
+            "data-slot": "checkbox-group-field",
+            className: floatingGroupVariants({ hasError: !!error }),
+            children: [
+              /* @__PURE__ */ jsx(
+                "span",
+                {
+                  "aria-hidden": "true",
+                  "data-slot": "checkbox-group-floating-label",
+                  className: floatingGroupLabelVariants({ hasError: !!error }),
+                  children: label
+                }
+              ),
+              itemsElement
+            ]
+          }
+        ) : null,
         description && /* @__PURE__ */ jsx(
           "p",
           {
             id: descriptionId,
             "data-slot": "checkbox-group-description",
-            className: "text-muted-foreground mb-3 text-xs",
-            children: description
-          }
-        ),
-        /* @__PURE__ */ jsx(
-          "div",
-          {
-            role: "group",
-            "data-slot": "checkbox-group-items",
             className: cn(
-              "flex gap-4",
-              orientation === "vertical" && "flex-col gap-2"
+              "text-muted-foreground text-xs",
+              isFloating ? "mt-1" : "mb-3"
             ),
-            children
+            children: description
           }
         ),
+        !isFloating && itemsElement,
         error && /* @__PURE__ */ jsx(
           "p",
           {
@@ -257,5 +288,5 @@ function MinusIcon({ size, className }) {
 }
 
 export { Checkbox, CheckboxGroup, checkboxVariants };
-//# sourceMappingURL=chunk-KFLDXJEE.js.map
-//# sourceMappingURL=chunk-KFLDXJEE.js.map
+//# sourceMappingURL=chunk-753Z3NXL.js.map
+//# sourceMappingURL=chunk-753Z3NXL.js.map

package/dist/chunk-753Z3NXL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/Checkbox/Checkbox.tsx"],"names":[],"mappings":"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","file":"chunk-753Z3NXL.js","sourcesContent":["import * as React from 'react';\nimport { cva, type VariantProps } from 'class-variance-authority';\nimport { cn } from '../../utils/cn';\nimport {\n  floatingGroupVariants,\n  floatingGroupLabelVariants,\n} from '../Input/Input';\n\nconst checkboxVariants = cva(\n  [\n    'shrink-0 appearance-none',\n    'border-2 border-input rounded',\n    'bg-background',\n    'transition-all duration-150',\n    'cursor-pointer',\n    'focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2',\n    'disabled:cursor-not-allowed disabled:opacity-50',\n    'checked:bg-primary-800 checked:border-primary-500',\n    'indeterminate:bg-primary-800 indeterminate:border-primary-500',\n  ],\n  {\n    variants: {\n      size: {\n        sm: 'h-4 w-4',\n        md: 'h-5 w-5',\n        lg: 'h-6 w-6',\n      },\n    },\n    defaultVariants: {\n      size: 'md',\n    },\n  }\n);\n\nexport interface CheckboxProps\n  extends\n    Omit<React.InputHTMLAttributes<HTMLInputElement>, 'size' | 'type'>,\n    VariantProps<typeof checkboxVariants> {\n  /** Label for the checkbox */\n  label?: string;\n  /** Description text below the label */\n  description?: string;\n  /** Indeterminate state (neither checked nor unchecked) */\n  indeterminate?: boolean;\n  /** Error message */\n  error?: string;\n  /** Position of the label */\n  labelPosition?: 'left' | 'right';\n}\n\n/**\n * An accessible checkbox component with support for indeterminate state.\n *\n * @example\n * ```tsx\n * <Checkbox label=\"Accept terms and conditions\" />\n * <Checkbox label=\"Newsletter\" description=\"Receive updates about new features\" />\n * <Checkbox indeterminate label=\"Select all\" />\n * ```\n */\nconst Checkbox = React.forwardRef<HTMLInputElement, CheckboxProps>(\n  (\n    {\n      className,\n      size,\n      label,\n      description,\n      indeterminate = false,\n      error,\n      labelPosition = 'right',\n      id,\n      disabled,\n      ...props\n    },\n    ref\n  ) => {\n    const internalRef = React.useRef<HTMLInputElement>(null);\n    const generatedId = React.useId();\n    const checkboxId = id || generatedId;\n    const descriptionId = `${checkboxId}-description`;\n    const errorId = `${checkboxId}-error`;\n\n    // Handle indeterminate state\n    React.useEffect(() => {\n      const checkbox = internalRef.current;\n      if (checkbox) {\n        checkbox.indeterminate = indeterminate;\n      }\n    }, [indeterminate]);\n\n    // Combine refs\n    React.useImperativeHandle(ref, () => internalRef.current!);\n\n    const checkboxElement = (\n      <span\n        data-slot=\"checkbox-indicator\"\n        className=\"relative inline-flex items-center justify-center\"\n      >\n        <input\n          ref={internalRef}\n          data-slot=\"checkbox\"\n          id={checkboxId}\n          type=\"checkbox\"\n          disabled={disabled}\n          aria-describedby={\n            [description ? descriptionId : null, error ? errorId : null]\n              .filter(Boolean)\n              .join(' ') || undefined\n          }\n          aria-invalid={!!error}\n          className={cn('peer', checkboxVariants({ size }), className)}\n          {...props}\n        />\n        {/* Custom check icon overlay */}\n        <CheckIcon\n          size={size}\n          className=\"pointer-events-none absolute text-white opacity-0 transition-opacity peer-checked:opacity-100\"\n        />\n        {/* Custom indeterminate icon overlay */}\n        <MinusIcon\n          size={size}\n          className=\"pointer-events-none absolute text-white opacity-0 transition-opacity peer-indeterminate:opacity-100\"\n        />\n      </span>\n    );\n\n    const labelElement = label && (\n      <div className=\"flex flex-col\">\n        <label\n          htmlFor={checkboxId}\n          data-slot=\"checkbox-label\"\n          className={cn(\n            'text-foreground cursor-pointer text-sm font-medium select-none',\n            disabled && 'cursor-not-allowed opacity-50'\n          )}\n        >\n          {label}\n        </label>\n        {description && (\n          <p\n            id={descriptionId}\n            data-slot=\"checkbox-description\"\n            className=\"text-muted-foreground mt-0.5 text-xs\"\n          >\n            {description}\n          </p>\n        )}\n      </div>\n    );\n\n    return (\n      <div data-slot=\"checkbox-wrapper\" className=\"flex flex-col gap-1\">\n        <div\n          data-slot=\"checkbox-row\"\n          className={cn(\n            'flex gap-2',\n            description ? 'items-start' : 'items-center',\n            labelPosition === 'left' && 'flex-row-reverse'\n          )}\n        >\n          {checkboxElement}\n          {labelElement}\n        </div>\n        {error && (\n          <p\n            id={errorId}\n            data-slot=\"checkbox-error\"\n            className=\"text-destructive-700 dark:text-destructive-400 text-sm\"\n            role=\"alert\"\n          >\n            {error}\n          </p>\n        )}\n      </div>\n    );\n  }\n);\n\nCheckbox.displayName = 'Checkbox';\n\n// ============================================================================\n// Checkbox Group\n// ============================================================================\n\nexport interface CheckboxGroupProps {\n  /** Group label */\n  label?: string;\n  /**\n   * How the group label is rendered.\n   * - `stacked` (default): label above the options.\n   * - `floating`: renders the group as a bordered field matching floating\n   *   inputs, with the label fixed in the floated position so mixed forms\n   *   stay vertically aligned.\n   */\n  labelVariant?: 'stacked' | 'floating';\n  /** Description for the group */\n  description?: string;\n  /** Error message for the group */\n  error?: string;\n  /** Orientation of checkboxes */\n  orientation?: 'horizontal' | 'vertical';\n  /** Children checkboxes */\n  children: React.ReactNode;\n  /** Additional class name */\n  className?: string;\n}\n\n/**\n * A container for grouping related checkboxes.\n *\n * @example\n * ```tsx\n * <CheckboxGroup label=\"Interests\" orientation=\"vertical\">\n *   <Checkbox label=\"Sports\" />\n *   <Checkbox label=\"Music\" />\n *   <Checkbox label=\"Travel\" />\n * </CheckboxGroup>\n * ```\n */\nfunction CheckboxGroup({\n  label,\n  labelVariant = 'stacked',\n  description,\n  error,\n  orientation = 'vertical',\n  children,\n  className,\n}: CheckboxGroupProps) {\n  const groupId = React.useId();\n  const descriptionId = `${groupId}-description`;\n  const errorId = `${groupId}-error`;\n\n  const isFloating = labelVariant === 'floating' && !!label;\n\n  const itemsElement = (\n    <div\n      role=\"group\"\n      data-slot=\"checkbox-group-items\"\n      className={cn(\n        'flex gap-4',\n        orientation === 'vertical' && 'flex-col gap-2'\n      )}\n    >\n      {children}\n    </div>\n  );\n\n  return (\n    <fieldset\n      data-slot=\"checkbox-group\"\n      className={cn('flex flex-col', className)}\n      aria-describedby={\n        [description ? descriptionId : null, error ? errorId : null]\n          .filter(Boolean)\n          .join(' ') || undefined\n      }\n    >\n      {label && (\n        <legend\n          data-slot=\"checkbox-group-legend\"\n          className={cn(\n            // Legends are excluded from the fieldset's flex layout; explicit\n            // margin matches the stacked Input label's 6px gap.\n            'text-foreground mb-1.5 text-sm font-medium',\n            isFloating && 'sr-only'\n          )}\n        >\n          {label}\n        </legend>\n      )}\n      {isFloating ? (\n        <div\n          data-slot=\"checkbox-group-field\"\n          className={floatingGroupVariants({ hasError: !!error })}\n        >\n          <span\n            aria-hidden=\"true\"\n            data-slot=\"checkbox-group-floating-label\"\n            className={floatingGroupLabelVariants({ hasError: !!error })}\n          >\n            {label}\n          </span>\n          {itemsElement}\n        </div>\n      ) : null}\n      {description && (\n        <p\n          id={descriptionId}\n          data-slot=\"checkbox-group-description\"\n          className={cn(\n            'text-muted-foreground text-xs',\n            isFloating ? 'mt-1' : 'mb-3'\n          )}\n        >\n          {description}\n        </p>\n      )}\n      {!isFloating && itemsElement}\n      {error && (\n        <p\n          id={errorId}\n          data-slot=\"checkbox-group-error\"\n          className=\"text-destructive mt-2 text-sm\"\n          role=\"alert\"\n        >\n          {error}\n        </p>\n      )}\n    </fieldset>\n  );\n}\n\nCheckboxGroup.displayName = 'CheckboxGroup';\n\n// ============================================================================\n// Check Icon\n// ============================================================================\n\ninterface CheckIconProps {\n  size?: 'sm' | 'md' | 'lg' | null;\n  className?: string;\n}\n\nfunction CheckIcon({ size, className }: CheckIconProps) {\n  const sizeMap = {\n    sm: 10,\n    md: 12,\n    lg: 14,\n  };\n  const iconSize = sizeMap[size || 'md'];\n\n  return (\n    <svg\n      xmlns=\"http://www.w3.org/2000/svg\"\n      width={iconSize}\n      height={iconSize}\n      viewBox=\"0 0 24 24\"\n      fill=\"none\"\n      stroke=\"currentColor\"\n      strokeWidth=\"3\"\n      strokeLinecap=\"round\"\n      strokeLinejoin=\"round\"\n      className={className}\n      aria-hidden=\"true\"\n    >\n      <path d=\"M20 6 9 17l-5-5\" />\n    </svg>\n  );\n}\n\nfunction MinusIcon({ size, className }: CheckIconProps) {\n  const sizeMap = {\n    sm: 10,\n    md: 12,\n    lg: 14,\n  };\n  const iconSize = sizeMap[size || 'md'];\n\n  return (\n    <svg\n      xmlns=\"http://www.w3.org/2000/svg\"\n      width={iconSize}\n      height={iconSize}\n      viewBox=\"0 0 24 24\"\n      fill=\"none\"\n      stroke=\"currentColor\"\n      strokeWidth=\"3\"\n      strokeLinecap=\"round\"\n      strokeLinejoin=\"round\"\n      className={className}\n      aria-hidden=\"true\"\n    >\n      <path d=\"M5 12h14\" />\n    </svg>\n  );\n}\n\nexport { Checkbox, CheckboxGroup, checkboxVariants };\n"]}

package/dist/{chunk-S3MKIDYG.cjs → chunk-7AECNMYV.cjs}

@@ -1,5 +1,6 @@
 'use strict';
 
+var chunkZ5S5JEJD_cjs = require('./chunk-Z5S5JEJD.cjs');
 var chunkS5RVSXDV_cjs = require('./chunk-S5RVSXDV.cjs');
 var React = require('react');
 var classVarianceAuthority = require('class-variance-authority');
@@ -167,6 +168,7 @@ var Checkbox = React__namespace.forwardRef(
 Checkbox.displayName = "Checkbox";
 function CheckboxGroup({
   label,
+  labelVariant = "stacked",
   description,
   error,
   orientation = "vertical",
@@ -176,6 +178,19 @@ function CheckboxGroup({
   const groupId = React__namespace.useId();
   const descriptionId = `${groupId}-description`;
   const errorId = `${groupId}-error`;
+  const isFloating = labelVariant === "floating" && !!label;
+  const itemsElement = /* @__PURE__ */ jsxRuntime.jsx(
+    "div",
+    {
+      role: "group",
+      "data-slot": "checkbox-group-items",
+      className: chunkS5RVSXDV_cjs.cn(
+        "flex gap-4",
+        orientation === "vertical" && "flex-col gap-2"
+      ),
+      children
+    }
+  );
   return /* @__PURE__ */ jsxRuntime.jsxs(
     "fieldset",
     {
@@ -187,31 +202,47 @@ function CheckboxGroup({
           "legend",
           {
             "data-slot": "checkbox-group-legend",
-            className: "text-foreground mb-1 text-sm font-medium",
+            className: chunkS5RVSXDV_cjs.cn(
+              // Legends are excluded from the fieldset's flex layout; explicit
+              // margin matches the stacked Input label's 6px gap.
+              "text-foreground mb-1.5 text-sm font-medium",
+              isFloating && "sr-only"
+            ),
             children: label
           }
         ),
+        isFloating ? /* @__PURE__ */ jsxRuntime.jsxs(
+          "div",
+          {
+            "data-slot": "checkbox-group-field",
+            className: chunkZ5S5JEJD_cjs.floatingGroupVariants({ hasError: !!error }),
+            children: [
+              /* @__PURE__ */ jsxRuntime.jsx(
+                "span",
+                {
+                  "aria-hidden": "true",
+                  "data-slot": "checkbox-group-floating-label",
+                  className: chunkZ5S5JEJD_cjs.floatingGroupLabelVariants({ hasError: !!error }),
+                  children: label
+                }
+              ),
+              itemsElement
+            ]
+          }
+        ) : null,
         description && /* @__PURE__ */ jsxRuntime.jsx(
           "p",
           {
             id: descriptionId,
             "data-slot": "checkbox-group-description",
-            className: "text-muted-foreground mb-3 text-xs",
-            children: description
-          }
-        ),
-        /* @__PURE__ */ jsxRuntime.jsx(
-          "div",
-          {
-            role: "group",
-            "data-slot": "checkbox-group-items",
             className: chunkS5RVSXDV_cjs.cn(
-              "flex gap-4",
-              orientation === "vertical" && "flex-col gap-2"
+              "text-muted-foreground text-xs",
+              isFloating ? "mt-1" : "mb-3"
             ),
-            children
+            children: description
           }
         ),
+        !isFloating && itemsElement,
         error && /* @__PURE__ */ jsxRuntime.jsx(
           "p",
           {
@@ -281,5 +312,5 @@ function MinusIcon({ size, className }) {
 exports.Checkbox = Checkbox;
 exports.CheckboxGroup = CheckboxGroup;
 exports.checkboxVariants = checkboxVariants;
-//# sourceMappingURL=chunk-S3MKIDYG.cjs.map
-//# sourceMappingURL=chunk-S3MKIDYG.cjs.map
+//# sourceMappingURL=chunk-7AECNMYV.cjs.map
+//# sourceMappingURL=chunk-7AECNMYV.cjs.map

package/dist/chunk-7AECNMYV.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/Checkbox/Checkbox.tsx"],"names":["cva","React","jsxs","jsx","cn","floatingGroupVariants","floatingGroupLabelVariants"],"mappings":"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","file":"chunk-7AECNMYV.cjs","sourcesContent":["import * as React from 'react';\nimport { cva, type VariantProps } from 'class-variance-authority';\nimport { cn } from '../../utils/cn';\nimport {\n  floatingGroupVariants,\n  floatingGroupLabelVariants,\n} from '../Input/Input';\n\nconst checkboxVariants = cva(\n  [\n    'shrink-0 appearance-none',\n    'border-2 border-input rounded',\n    'bg-background',\n    'transition-all duration-150',\n    'cursor-pointer',\n    'focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2',\n    'disabled:cursor-not-allowed disabled:opacity-50',\n    'checked:bg-primary-800 checked:border-primary-500',\n    'indeterminate:bg-primary-800 indeterminate:border-primary-500',\n  ],\n  {\n    variants: {\n      size: {\n        sm: 'h-4 w-4',\n        md: 'h-5 w-5',\n        lg: 'h-6 w-6',\n      },\n    },\n    defaultVariants: {\n      size: 'md',\n    },\n  }\n);\n\nexport interface CheckboxProps\n  extends\n    Omit<React.InputHTMLAttributes<HTMLInputElement>, 'size' | 'type'>,\n    VariantProps<typeof checkboxVariants> {\n  /** Label for the checkbox */\n  label?: string;\n  /** Description text below the label */\n  description?: string;\n  /** Indeterminate state (neither checked nor unchecked) */\n  indeterminate?: boolean;\n  /** Error message */\n  error?: string;\n  /** Position of the label */\n  labelPosition?: 'left' | 'right';\n}\n\n/**\n * An accessible checkbox component with support for indeterminate state.\n *\n * @example\n * ```tsx\n * <Checkbox label=\"Accept terms and conditions\" />\n * <Checkbox label=\"Newsletter\" description=\"Receive updates about new features\" />\n * <Checkbox indeterminate label=\"Select all\" />\n * ```\n */\nconst Checkbox = React.forwardRef<HTMLInputElement, CheckboxProps>(\n  (\n    {\n      className,\n      size,\n      label,\n      description,\n      indeterminate = false,\n      error,\n      labelPosition = 'right',\n      id,\n      disabled,\n      ...props\n    },\n    ref\n  ) => {\n    const internalRef = React.useRef<HTMLInputElement>(null);\n    const generatedId = React.useId();\n    const checkboxId = id || generatedId;\n    const descriptionId = `${checkboxId}-description`;\n    const errorId = `${checkboxId}-error`;\n\n    // Handle indeterminate state\n    React.useEffect(() => {\n      const checkbox = internalRef.current;\n      if (checkbox) {\n        checkbox.indeterminate = indeterminate;\n      }\n    }, [indeterminate]);\n\n    // Combine refs\n    React.useImperativeHandle(ref, () => internalRef.current!);\n\n    const checkboxElement = (\n      <span\n        data-slot=\"checkbox-indicator\"\n        className=\"relative inline-flex items-center justify-center\"\n      >\n        <input\n          ref={internalRef}\n          data-slot=\"checkbox\"\n          id={checkboxId}\n          type=\"checkbox\"\n          disabled={disabled}\n          aria-describedby={\n            [description ? descriptionId : null, error ? errorId : null]\n              .filter(Boolean)\n              .join(' ') || undefined\n          }\n          aria-invalid={!!error}\n          className={cn('peer', checkboxVariants({ size }), className)}\n          {...props}\n        />\n        {/* Custom check icon overlay */}\n        <CheckIcon\n          size={size}\n          className=\"pointer-events-none absolute text-white opacity-0 transition-opacity peer-checked:opacity-100\"\n        />\n        {/* Custom indeterminate icon overlay */}\n        <MinusIcon\n          size={size}\n          className=\"pointer-events-none absolute text-white opacity-0 transition-opacity peer-indeterminate:opacity-100\"\n        />\n      </span>\n    );\n\n    const labelElement = label && (\n      <div className=\"flex flex-col\">\n        <label\n          htmlFor={checkboxId}\n          data-slot=\"checkbox-label\"\n          className={cn(\n            'text-foreground cursor-pointer text-sm font-medium select-none',\n            disabled && 'cursor-not-allowed opacity-50'\n          )}\n        >\n          {label}\n        </label>\n        {description && (\n          <p\n            id={descriptionId}\n            data-slot=\"checkbox-description\"\n            className=\"text-muted-foreground mt-0.5 text-xs\"\n          >\n            {description}\n          </p>\n        )}\n      </div>\n    );\n\n    return (\n      <div data-slot=\"checkbox-wrapper\" className=\"flex flex-col gap-1\">\n        <div\n          data-slot=\"checkbox-row\"\n          className={cn(\n            'flex gap-2',\n            description ? 'items-start' : 'items-center',\n            labelPosition === 'left' && 'flex-row-reverse'\n          )}\n        >\n          {checkboxElement}\n          {labelElement}\n        </div>\n        {error && (\n          <p\n            id={errorId}\n            data-slot=\"checkbox-error\"\n            className=\"text-destructive-700 dark:text-destructive-400 text-sm\"\n            role=\"alert\"\n          >\n            {error}\n          </p>\n        )}\n      </div>\n    );\n  }\n);\n\nCheckbox.displayName = 'Checkbox';\n\n// ============================================================================\n// Checkbox Group\n// ============================================================================\n\nexport interface CheckboxGroupProps {\n  /** Group label */\n  label?: string;\n  /**\n   * How the group label is rendered.\n   * - `stacked` (default): label above the options.\n   * - `floating`: renders the group as a bordered field matching floating\n   *   inputs, with the label fixed in the floated position so mixed forms\n   *   stay vertically aligned.\n   */\n  labelVariant?: 'stacked' | 'floating';\n  /** Description for the group */\n  description?: string;\n  /** Error message for the group */\n  error?: string;\n  /** Orientation of checkboxes */\n  orientation?: 'horizontal' | 'vertical';\n  /** Children checkboxes */\n  children: React.ReactNode;\n  /** Additional class name */\n  className?: string;\n}\n\n/**\n * A container for grouping related checkboxes.\n *\n * @example\n * ```tsx\n * <CheckboxGroup label=\"Interests\" orientation=\"vertical\">\n *   <Checkbox label=\"Sports\" />\n *   <Checkbox label=\"Music\" />\n *   <Checkbox label=\"Travel\" />\n * </CheckboxGroup>\n * ```\n */\nfunction CheckboxGroup({\n  label,\n  labelVariant = 'stacked',\n  description,\n  error,\n  orientation = 'vertical',\n  children,\n  className,\n}: CheckboxGroupProps) {\n  const groupId = React.useId();\n  const descriptionId = `${groupId}-description`;\n  const errorId = `${groupId}-error`;\n\n  const isFloating = labelVariant === 'floating' && !!label;\n\n  const itemsElement = (\n    <div\n      role=\"group\"\n      data-slot=\"checkbox-group-items\"\n      className={cn(\n        'flex gap-4',\n        orientation === 'vertical' && 'flex-col gap-2'\n      )}\n    >\n      {children}\n    </div>\n  );\n\n  return (\n    <fieldset\n      data-slot=\"checkbox-group\"\n      className={cn('flex flex-col', className)}\n      aria-describedby={\n        [description ? descriptionId : null, error ? errorId : null]\n          .filter(Boolean)\n          .join(' ') || undefined\n      }\n    >\n      {label && (\n        <legend\n          data-slot=\"checkbox-group-legend\"\n          className={cn(\n            // Legends are excluded from the fieldset's flex layout; explicit\n            // margin matches the stacked Input label's 6px gap.\n            'text-foreground mb-1.5 text-sm font-medium',\n            isFloating && 'sr-only'\n          )}\n        >\n          {label}\n        </legend>\n      )}\n      {isFloating ? (\n        <div\n          data-slot=\"checkbox-group-field\"\n          className={floatingGroupVariants({ hasError: !!error })}\n        >\n          <span\n            aria-hidden=\"true\"\n            data-slot=\"checkbox-group-floating-label\"\n            className={floatingGroupLabelVariants({ hasError: !!error })}\n          >\n            {label}\n          </span>\n          {itemsElement}\n        </div>\n      ) : null}\n      {description && (\n        <p\n          id={descriptionId}\n          data-slot=\"checkbox-group-description\"\n          className={cn(\n            'text-muted-foreground text-xs',\n            isFloating ? 'mt-1' : 'mb-3'\n          )}\n        >\n          {description}\n        </p>\n      )}\n      {!isFloating && itemsElement}\n      {error && (\n        <p\n          id={errorId}\n          data-slot=\"checkbox-group-error\"\n          className=\"text-destructive mt-2 text-sm\"\n          role=\"alert\"\n        >\n          {error}\n        </p>\n      )}\n    </fieldset>\n  );\n}\n\nCheckboxGroup.displayName = 'CheckboxGroup';\n\n// ============================================================================\n// Check Icon\n// ============================================================================\n\ninterface CheckIconProps {\n  size?: 'sm' | 'md' | 'lg' | null;\n  className?: string;\n}\n\nfunction CheckIcon({ size, className }: CheckIconProps) {\n  const sizeMap = {\n    sm: 10,\n    md: 12,\n    lg: 14,\n  };\n  const iconSize = sizeMap[size || 'md'];\n\n  return (\n    <svg\n      xmlns=\"http://www.w3.org/2000/svg\"\n      width={iconSize}\n      height={iconSize}\n      viewBox=\"0 0 24 24\"\n      fill=\"none\"\n      stroke=\"currentColor\"\n      strokeWidth=\"3\"\n      strokeLinecap=\"round\"\n      strokeLinejoin=\"round\"\n      className={className}\n      aria-hidden=\"true\"\n    >\n      <path d=\"M20 6 9 17l-5-5\" />\n    </svg>\n  );\n}\n\nfunction MinusIcon({ size, className }: CheckIconProps) {\n  const sizeMap = {\n    sm: 10,\n    md: 12,\n    lg: 14,\n  };\n  const iconSize = sizeMap[size || 'md'];\n\n  return (\n    <svg\n      xmlns=\"http://www.w3.org/2000/svg\"\n      width={iconSize}\n      height={iconSize}\n      viewBox=\"0 0 24 24\"\n      fill=\"none\"\n      stroke=\"currentColor\"\n      strokeWidth=\"3\"\n      strokeLinecap=\"round\"\n      strokeLinejoin=\"round\"\n      className={className}\n      aria-hidden=\"true\"\n    >\n      <path d=\"M5 12h14\" />\n    </svg>\n  );\n}\n\nexport { Checkbox, CheckboxGroup, checkboxVariants };\n"]}

package/dist/chunk-7IKLGH3Z.cjs

@@ -0,0 +1,92 @@
+'use strict';
+
+var react = require('react');
+
+// src/hooks/useScrollSpy.ts
+function useScrollSpy({
+  selectors,
+  ids,
+  rootMargin = "0px 0px -60% 0px",
+  threshold = 0,
+  root,
+  enabled = true
+} = {}) {
+  const [activeId, setActiveId] = react.useState(null);
+  const visibleEntries = react.useRef(
+    /* @__PURE__ */ new Map()
+  );
+  const rootEl = root?.current ?? null;
+  react.useEffect(() => {
+    if (!enabled) return;
+    const container = rootEl ?? document;
+    function resolveElements() {
+      let els = [];
+      if (ids && ids.length > 0) {
+        els = ids.map((id) => document.getElementById(id)).filter((el) => el !== null);
+      } else if (selectors) {
+        els = Array.from(container.querySelectorAll(selectors));
+      }
+      return els.filter((el) => el.id);
+    }
+    let intersectionObserver = null;
+    let mutationObserver = null;
+    function startObserving() {
+      const elements = resolveElements();
+      if (elements.length === 0) return false;
+      intersectionObserver = new IntersectionObserver(
+        (entries2) => {
+          for (const entry of entries2) {
+            if (entry.isIntersecting) {
+              visibleEntries.current.set(entry.target.id, entry);
+            } else {
+              visibleEntries.current.delete(entry.target.id);
+            }
+          }
+          if (visibleEntries.current.size > 0) {
+            let topmost = null;
+            let topmostTop = Infinity;
+            for (const [id, entry] of visibleEntries.current) {
+              const top = entry.boundingClientRect.top;
+              if (top < topmostTop) {
+                topmostTop = top;
+                topmost = id;
+              }
+            }
+            if (topmost) {
+              setActiveId(topmost);
+            }
+          }
+        },
+        {
+          root: rootEl,
+          rootMargin,
+          threshold
+        }
+      );
+      for (const el of elements) {
+        intersectionObserver.observe(el);
+      }
+      mutationObserver?.disconnect();
+      mutationObserver = null;
+      return true;
+    }
+    if (!startObserving()) {
+      const watchRoot = rootEl ?? document.body;
+      mutationObserver = new MutationObserver(() => {
+        startObserving();
+      });
+      mutationObserver.observe(watchRoot, { childList: true, subtree: true });
+    }
+    const entries = visibleEntries.current;
+    return () => {
+      mutationObserver?.disconnect();
+      intersectionObserver?.disconnect();
+      entries.clear();
+    };
+  }, [selectors, ids, rootMargin, threshold, rootEl, enabled]);
+  return { activeId };
+}
+
+exports.useScrollSpy = useScrollSpy;
+//# sourceMappingURL=chunk-7IKLGH3Z.cjs.map
+//# sourceMappingURL=chunk-7IKLGH3Z.cjs.map

package/dist/chunk-7IKLGH3Z.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/useScrollSpy.ts"],"names":["useState","useRef","useEffect","entries"],"mappings":"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","file":"chunk-7IKLGH3Z.cjs","sourcesContent":["import { useEffect, useState, useRef, type RefObject } from 'react';\n\n// =============================================================================\n// Types\n// =============================================================================\n\nexport interface UseScrollSpyOptions {\n  /** CSS selector for the elements to observe (e.g. 'h2, h3, h4') */\n  selectors?: string;\n  /** Explicit list of element IDs to observe (alternative to selectors) */\n  ids?: string[];\n  /** IntersectionObserver root margin (default: '0px 0px -60% 0px') */\n  rootMargin?: string;\n  /** IntersectionObserver threshold (default: 0) */\n  threshold?: number | number[];\n  /** Scroll container element ref. Defaults to document viewport. */\n  root?: RefObject<HTMLElement | null>;\n  /** Whether the hook is active (default: true) */\n  enabled?: boolean;\n}\n\nexport interface UseScrollSpyReturn {\n  /** The ID of the currently active (in-view) element */\n  activeId: string | null;\n}\n\n// =============================================================================\n// Hook\n// =============================================================================\n\n/**\n * Tracks which section is currently in the viewport using IntersectionObserver.\n * Pairs naturally with `TableOfContents` to highlight the active heading.\n *\n * @example\n * ```tsx\n * function DocsPage() {\n *   const { activeId } = useScrollSpy({ selectors: 'h2, h3' });\n *   return (\n *     <aside>\n *       <TableOfContents activeId={activeId} />\n *     </aside>\n *   );\n * }\n * ```\n */\nexport function useScrollSpy({\n  selectors,\n  ids,\n  rootMargin = '0px 0px -60% 0px',\n  threshold = 0,\n  root,\n  enabled = true,\n}: UseScrollSpyOptions = {}): UseScrollSpyReturn {\n  const [activeId, setActiveId] = useState<string | null>(null);\n  const visibleEntries = useRef<Map<string, IntersectionObserverEntry>>(\n    new Map()\n  );\n\n  // Track root.current so the effect re-runs when the ref attaches\n  const rootEl = root?.current ?? null;\n\n  useEffect(() => {\n    if (!enabled) return;\n\n    const container = rootEl ?? document;\n\n    // Resolve target elements from the DOM\n    function resolveElements(): Element[] {\n      let els: Element[] = [];\n      if (ids && ids.length > 0) {\n        els = ids\n          .map((id) => document.getElementById(id))\n          .filter((el): el is HTMLElement => el !== null);\n      } else if (selectors) {\n        els = Array.from(container.querySelectorAll(selectors));\n      }\n      return els.filter((el) => el.id);\n    }\n\n    let intersectionObserver: IntersectionObserver | null = null;\n    let mutationObserver: MutationObserver | null = null;\n\n    function startObserving(): boolean {\n      const elements = resolveElements();\n      if (elements.length === 0) return false;\n\n      intersectionObserver = new IntersectionObserver(\n        (entries) => {\n          for (const entry of entries) {\n            if (entry.isIntersecting) {\n              visibleEntries.current.set(entry.target.id, entry);\n            } else {\n              visibleEntries.current.delete(entry.target.id);\n            }\n          }\n\n          // Pick the topmost visible heading (by DOM order)\n          if (visibleEntries.current.size > 0) {\n            let topmost: string | null = null;\n            let topmostTop = Infinity;\n\n            for (const [id, entry] of visibleEntries.current) {\n              const top = entry.boundingClientRect.top;\n              if (top < topmostTop) {\n                topmostTop = top;\n                topmost = id;\n              }\n            }\n\n            if (topmost) {\n              setActiveId(topmost);\n            }\n          }\n        },\n        {\n          root: rootEl,\n          rootMargin,\n          threshold,\n        }\n      );\n\n      for (const el of elements) {\n        intersectionObserver.observe(el);\n      }\n\n      // Elements found — stop watching for new DOM nodes\n      mutationObserver?.disconnect();\n      mutationObserver = null;\n      return true;\n    }\n\n    // If target elements don't exist yet (e.g. headings mount after ToC),\n    // watch for DOM changes and retry until they appear.\n    if (!startObserving()) {\n      const watchRoot = rootEl ?? document.body;\n      mutationObserver = new MutationObserver(() => {\n        startObserving();\n      });\n      mutationObserver.observe(watchRoot, { childList: true, subtree: true });\n    }\n\n    const entries = visibleEntries.current;\n    return () => {\n      mutationObserver?.disconnect();\n      intersectionObserver?.disconnect();\n      entries.clear();\n    };\n  }, [selectors, ids, rootMargin, threshold, rootEl, enabled]);\n\n  return { activeId };\n}\n"]}