@flikk/ui 1.0.0-beta.20 → 1.0.0-beta.22

package/dist/components/forms/Radio/Radio.theme.js

@@ -11,13 +11,9 @@ const radioTheme = {
         // Default state - dark
         "dark:bg-[var(--color-background-tertiary)] " +
         // Checked state - light
-        "checked:border-[var(--color-primary)]  " +
+        "checked:border-[var(--color-primary)] checked:bg-white " +
         // Checked state - dark
-        "checked:bg-[var(--color-neutral-200)] " +
-        // Checked outline - light
-        "checked:outline-2 checked:outline-[var(--color-primary-100)] checked:outline-offset-1 " +
-        // Checked outline - dark
-        "dark:checked:outline-[var(--color-primary-900)] " +
+        "dark:checked:bg-[var(--color-surface)] " +
         // Focus visible - light
         "focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-[var(--color-primary-600)] " +
         // Focus visible - dark
@@ -28,17 +24,21 @@ const radioTheme = {
         // Disabled state - dark
         "dark:disabled:bg-[var(--color-neutral-700)] dark:disabled:border-[var(--color-neutral-600)] " +
         "dark:data-[state=disabled]:bg-[var(--color-neutral-700)] dark:data-[state=disabled]:border-[var(--color-neutral-600)]",
-    dotStyle: "absolute inset-0 m-auto pointer-events-none rounded-full bg-[var(--color-primary)]",
-    descriptionStyle: "text-base text-[var(--color-text-secondary)]/80 mt-0.5",
+    dotStyle: "absolute top-1/2 left-1/2 pointer-events-none rounded-full bg-[var(--color-primary)]",
+    dotSizes: {
+        sm: "size-2.5 mt-0.25",
+        md: "size-3",
+    },
+    descriptionStyle: "text-sm text-[var(--color-text-secondary)]/80 mt-0",
     sizes: {
-        sm: "size-5 mt-0.25",
+        sm: "size-5 mt-0.5",
         md: "size-6",
     },
     // Group styles
     groupStyle: "flex flex-col gap-1.5",
     groupHorizontalStyle: "flex-row flex-wrap gap-x-6 gap-y-3",
-    groupDescriptionStyle: "text-base text-[var(--color-text-secondary)]/80 -mt-0.5 mb-1",
-    groupErrorStyle: "text-base text-[var(--color-danger)] mt-1.5",
+    groupDescriptionStyle: "text-sm text-[var(--color-text-secondary)]/80 -mt-0.5 mb-1",
+    groupErrorStyle: "text-sm text-[var(--color-danger)] mt-1.5",
     groupItemsStyle: "flex flex-col gap-3",
 };
 

package/dist/components/forms/Radio/Radio.types.d.ts

@@ -51,6 +51,7 @@ export interface RadioTheme {
     inputContainerStyle: string;
     inputStyle: string;
     dotStyle: string;
+    dotSizes: Record<RadioSize, string>;
     descriptionStyle: string;
     sizes: Record<RadioSize, string>;
     groupStyle?: string;

package/dist/components/forms/RichTextEditor/RichTextEditor.theme.js

@@ -32,7 +32,7 @@ const richTextEditorTheme = {
     // Dropdown styling (font size, color picker)
     dropdownStyle: "fixed z-[1000] min-w-[120px] py-1 bg-white/90 backdrop-blur-md rounded-[var(--form-radius)] shadow-xl ring-1 ring-[var(--color-border)] focus:outline-none",
     // Dropdown item styling
-    dropdownItemStyle: "block w-full px-3 py-2 text-left text-base text-[var(--color-text-primary)] hover:bg-[var(--color-background-tertiary)] transition-colors duration-150 disabled:opacity-50 disabled:cursor-not-allowed",
+    dropdownItemStyle: "block w-full px-3 py-2 text-left text-sm text-[var(--color-text-primary)] hover:bg-[var(--color-background-tertiary)] transition-colors duration-150 disabled:opacity-50 disabled:cursor-not-allowed",
     // Separator between toolbar sections
     separatorStyle: "w-px h-6 bg-[var(--color-border)] mx-1",
     // Color picker grid layout

package/dist/components/forms/Select/Select.theme.js

@@ -60,7 +60,7 @@ const selectTheme = {
     iconPadding: formsBaseTheme.iconStyles.padding,
     // Multi-select chip styles
     chipContainerStyle: "flex flex-nowrap gap-1 items-center min-w-0 overflow-hidden -ml-2",
-    chipOverflowStyle: "inline-flex items-center shrink-0 whitespace-nowrap px-1.5 py-0.5 text-sm font-medium " +
+    chipOverflowStyle: "inline-flex items-center shrink-0 whitespace-nowrap px-1.5 py-0.5 text-xs font-medium " +
         "text-[var(--color-text-muted)]",
 };
 

package/dist/components/forms/SelectableCard/SelectableCard.js

@@ -1,53 +1,68 @@
-import { jsxs, jsx } from 'react/jsx-runtime';
+import { jsx, jsxs } from 'react/jsx-runtime';
 import React__default, { useId } from 'react';
 import { useReducedMotion, motion } from 'motion/react';
-import { CheckIcon } from '@heroicons/react/24/outline';
 import { cn } from '../../../utils/cn.js';
-import { useSelectableCardContext } from './SelectableCardContext.js';
+import { Radio } from '../Radio/Radio.js';
+import { Checkbox } from '../Checkbox/Checkbox.js';
+import { useOptionalSelectableCardContext } from './SelectableCardContext.js';
+import { selectableCardTheme } from './SelectableCard.theme.js';
 import { SelectableCardGroup } from './SelectableCardGroup.js';
 import { cardVariants } from './SelectableCard.animations.js';
 
-// ─── Radio Indicator ─────────────────────────────────────────────────────────
-const RadioIndicator = ({ checked }) => (jsxs("div", { className: "relative flex-shrink-0 flex items-center justify-center size-5", children: [jsx("div", { className: cn("size-5 rounded-full border-2 transition-colors duration-200", checked
-                ? "border-[var(--color-primary)]"
-                : "border-[var(--color-border)]") }), jsx("div", { className: cn("absolute inset-0 m-auto rounded-full bg-[var(--color-primary)] transition-all duration-200", checked ? "size-2.5 opacity-100" : "size-0 opacity-0") })] }));
-// ─── Checkbox Indicator ──────────────────────────────────────────────────────
-const CheckboxIndicator = ({ checked }) => (jsx("div", { className: cn("flex-shrink-0 flex items-center justify-center size-5 rounded-[4px] border-2 transition-colors duration-200", checked
-        ? "border-[var(--color-primary)] bg-[var(--color-primary)]"
-        : "border-[var(--color-border)] bg-[var(--color-background)]"), children: checked && jsx(CheckIcon, { className: "size-3.5 stroke-white", strokeWidth: 3 }) }));
 // ─── SelectableCard ──────────────────────────────────────────────────────────
-const SelectableCardRoot = React__default.forwardRef(({ value, disabled: cardDisabled, className, children, onAnimationStart, onAnimationEnd, onDrag, onDragStart, onDragEnd, ...props }, ref) => {
-    const content = children;
-    const ctx = useSelectableCardContext();
+const SelectableCardRoot = React__default.forwardRef(({ value, disabled: cardDisabled, checked: standaloneChecked, onChange: standaloneOnChange, indicator: standaloneIndicator, indicatorPosition: cardIndicatorPosition, size: cardSize, className, children, onAnimationStart, onAnimationEnd, onDrag, onDragStart, onDragEnd, ...props }, ref) => {
+    var _a;
+    const ctx = useOptionalSelectableCardContext();
+    const isStandalone = ctx === undefined;
     const inputId = useId();
     const shouldReduceMotion = useReducedMotion();
-    const isDisabled = cardDisabled || ctx.disabled;
-    const isSelected = ctx.type === "single"
-        ? ctx.value === value
-        : Array.isArray(ctx.value) && ctx.value.includes(value);
+    const theme = isStandalone ? selectableCardTheme : ctx.theme;
+    const isDisabled = cardDisabled || (!isStandalone && ctx.disabled);
+    const isSelected = isStandalone
+        ? (standaloneChecked !== null && standaloneChecked !== void 0 ? standaloneChecked : false)
+        : ctx.type === "single"
+            ? ctx.value === value
+            : Array.isArray(ctx.value) && ctx.value.includes(value);
+    const resolvedIndicator = isStandalone
+        ? (standaloneIndicator !== null && standaloneIndicator !== void 0 ? standaloneIndicator : "radio")
+        : ctx.indicator;
+    const resolvedIndicatorPosition = cardIndicatorPosition !== null && cardIndicatorPosition !== void 0 ? cardIndicatorPosition : (isStandalone ? "end" : ctx.indicatorPosition);
+    const resolvedSize = cardSize !== null && cardSize !== void 0 ? cardSize : (isStandalone ? "md" : ctx.size);
+    const indicatorSize = "sm";
     const handleClick = () => {
         if (isDisabled)
             return;
-        ctx.onChange(value);
+        if (isStandalone) {
+            standaloneOnChange === null || standaloneOnChange === void 0 ? void 0 : standaloneOnChange(!isSelected, value);
+        }
+        else {
+            ctx.onChange(value);
+        }
     };
     const handleKeyDown = (e) => {
         if (isDisabled)
             return;
         if (e.key === " " || e.key === "Enter") {
             e.preventDefault();
-            ctx.onChange(value);
+            handleClick();
         }
     };
-    const inputType = ctx.type === "single" ? "radio" : "checkbox";
+    const inputType = isStandalone
+        ? "checkbox"
+        : ctx.type === "single"
+            ? "radio"
+            : "checkbox";
+    const role = isStandalone
+        ? "checkbox"
+        : ctx.type === "single"
+            ? "radio"
+            : "checkbox";
     const animated = !shouldReduceMotion && !isDisabled;
     const motionProps = animated
-        ? {
-            variants: cardVariants,
-            initial: "idle",
-            whileTap: "tap",
-        }
+        ? { variants: cardVariants, initial: "idle", whileTap: "tap" }
         : {};
-    return (jsxs(motion.div, { ref: ref, role: ctx.type === "single" ? "radio" : "checkbox", "aria-checked": isSelected, "aria-disabled": isDisabled || undefined, tabIndex: isDisabled ? -1 : 0, "data-selected": isSelected, "data-disabled": isDisabled || undefined, className: cn(ctx.theme.card, isSelected && ctx.theme.selectedCard, isDisabled && ctx.theme.disabledCard, className), onClick: handleClick, onKeyDown: handleKeyDown, ...motionProps, ...props, children: [jsx("input", { type: inputType, id: inputId, name: ctx.name, value: value, checked: isSelected, disabled: isDisabled, onChange: () => { }, className: "sr-only", tabIndex: -1, "aria-hidden": true }), jsx("div", { className: ctx.theme.contentWrapper, children: content }), ctx.indicator !== "none" && (jsx("div", { className: ctx.theme.indicator, children: ctx.indicator === "radio" ? (jsx(RadioIndicator, { checked: isSelected })) : (jsx(CheckboxIndicator, { checked: isSelected })) }))] }));
+    const indicatorNode = resolvedIndicator !== "none" && (jsx("div", { className: cn(theme.indicator, "pointer-events-none"), "aria-hidden": "true", children: resolvedIndicator === "radio" ? (jsx(Radio, { value: value, checked: isSelected, onChange: () => { }, state: isDisabled ? "disabled" : "default", size: indicatorSize })) : (jsx(Checkbox, { value: value, checked: isSelected, onChange: () => { }, state: isDisabled ? "disabled" : "default", size: indicatorSize })) }));
+    return (jsxs(motion.div, { ref: ref, role: role, "aria-checked": isSelected, "aria-disabled": isDisabled || undefined, tabIndex: isDisabled ? -1 : 0, "data-selected": isSelected, "data-disabled": isDisabled || undefined, className: cn(theme.card, (_a = theme.cardSizes) === null || _a === void 0 ? void 0 : _a[resolvedSize], isSelected && theme.selectedCard, isDisabled && theme.disabledCard, className), onClick: handleClick, onKeyDown: handleKeyDown, ...motionProps, ...props, children: [jsx("input", { type: inputType, id: inputId, name: isStandalone ? undefined : ctx === null || ctx === void 0 ? void 0 : ctx.name, value: value, checked: isSelected, disabled: isDisabled, onChange: () => { }, className: "sr-only", tabIndex: -1, "aria-hidden": true }), resolvedIndicatorPosition === "start" && indicatorNode, jsx("div", { className: theme.contentWrapper, children: children }), resolvedIndicatorPosition === "end" && indicatorNode] }));
 });
 SelectableCardRoot.displayName = "SelectableCard";
 // ─── Compound Export ─────────────────────────────────────────────────────────

package/dist/components/forms/SelectableCard/SelectableCard.theme.js

@@ -1,38 +1,28 @@
 const selectableCardTheme = {
     group: "flex flex-col gap-3",
     card: 
-    // Base layout
-    "relative flex items-center justify-between gap-4 rounded-[var(--radius-base)] p-4 cursor-pointer transition-[border-color,background-color,box-shadow,outline] duration-200 " +
-        // Default state - light
+    // Base layout — no justify-between; indicator position handled by render order
+    "relative flex items-start gap-3 rounded-[var(--radius-base)] cursor-pointer transition-[border-color,background-color,box-shadow,outline] duration-200 " +
+        // Default state
         "border border-[var(--color-border)] bg-[var(--color-surface)] " +
-        // Default state - dark
         "dark:bg-[var(--color-background)] " +
-        // Hover state - light
+        // Hover
         "hover:border-[var(--color-border-secondary)] " +
-        // Hover state - dark
-        "  " +
-        // Focus visible - light
+        // Focus visible
         "focus-visible:outline focus-visible:outline-offset-1 focus-visible:outline-[var(--color-primary)] " +
-        // Focus visible - dark
         "dark:focus-visible:outline-[var(--color-primary)]/50",
-    selectedCard: 
-    // Selected border & ring - light
-    "border-[var(--color-primary)] ring-2 ring-[var(--color-primary)]/10  " +
-        // Selected border & ring - dark
-        "dark:border-[var(--color-primary)] dark:ring-[var(--color-primary)]/20  " +
-        // Selected background gradient - light
-        "bg-[var(--color-primary-50)] " +
-        // Selected background gradient - dark
-        "dark:bg-[var(--color-background-secondary)] " +
-        // Selected hover - light
+    selectedCard: "border-[var(--color-primary)] ring-2 ring-[var(--color-primary)]/10 " +
+        "dark:border-[var(--color-primary)] dark:ring-[var(--color-primary)]/20 " +
         "hover:border-[var(--color-primary)] " +
-        // Selected hover - dark
-        "dark:hover:border-[var(--color-primary)] ",
-    disabledCard: 
-    // Disabled state
-    "opacity-50 cursor-not-allowed pointer-events-none",
+        "dark:hover:border-[var(--color-primary)]",
+    disabledCard: "opacity-50 cursor-not-allowed pointer-events-none",
     contentWrapper: "flex-1 min-w-0",
-    indicator: "flex-shrink-0",
+    indicator: "flex-shrink-0 -mt-0.5",
+    cardSizes: {
+        sm: "p-3",
+        md: "p-4",
+        lg: "p-5",
+    },
 };
 
 export { selectableCardTheme };

package/dist/components/forms/SelectableCard/SelectableCard.types.d.ts

@@ -1,6 +1,8 @@
 import React from "react";
 export type SelectableCardType = "single" | "multiple";
 export type SelectableCardIndicator = "radio" | "checkbox" | "none";
+export type SelectableCardIndicatorPosition = "start" | "end";
+export type SelectableCardSize = "sm" | "md" | "lg";
 export interface SelectableCardTheme {
     group?: string;
     card?: string;
@@ -8,10 +10,13 @@ export interface SelectableCardTheme {
     disabledCard?: string;
     contentWrapper?: string;
     indicator?: string;
+    cardSizes?: Record<SelectableCardSize, string>;
 }
 export interface SelectableCardContextValue {
     type: SelectableCardType;
     indicator: SelectableCardIndicator;
+    indicatorPosition: SelectableCardIndicatorPosition;
+    size: SelectableCardSize;
     value: string | string[];
     onChange: (cardValue: string) => void;
     disabled: boolean;
@@ -20,14 +25,22 @@ export interface SelectableCardContextValue {
 }
 export interface SelectableCardGroupProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange"> {
     type?: SelectableCardType;
-    value: string | string[];
-    onChange: (value: string | string[]) => void;
+    value?: string | string[];
+    defaultValue?: string | string[];
+    onChange?: (value: string | string[]) => void;
     indicator?: SelectableCardIndicator;
+    indicatorPosition?: SelectableCardIndicatorPosition;
+    size?: SelectableCardSize;
     disabled?: boolean;
     name?: string;
     theme?: Partial<SelectableCardTheme>;
 }
-export interface SelectableCardProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "value"> {
+export interface SelectableCardProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "value" | "onChange"> {
     value: string;
     disabled?: boolean;
+    checked?: boolean;
+    onChange?: (checked: boolean, value: string) => void;
+    indicator?: SelectableCardIndicator;
+    indicatorPosition?: SelectableCardIndicatorPosition;
+    size?: SelectableCardSize;
 }

package/dist/components/forms/SelectableCard/SelectableCardContext.d.ts

@@ -1,3 +1,4 @@
 import type { SelectableCardContextValue } from "./SelectableCard.types";
 export declare const SelectableCardContext: import("react").Context<SelectableCardContextValue | undefined>;
 export declare function useSelectableCardContext(): SelectableCardContextValue;
+export declare function useOptionalSelectableCardContext(): SelectableCardContextValue | undefined;

package/dist/components/forms/SelectableCard/SelectableCardContext.js

@@ -1,12 +1,9 @@
 import { createContext, useContext } from 'react';
 
 const SelectableCardContext = createContext(undefined);
-function useSelectableCardContext() {
-    const context = useContext(SelectableCardContext);
-    if (!context) {
-        throw new Error("SelectableCard must be used within a SelectableCard.Group");
-    }
-    return context;
+// Used by SelectableCard itself — returns undefined when used standalone
+function useOptionalSelectableCardContext() {
+    return useContext(SelectableCardContext);
 }
 
-export { SelectableCardContext, useSelectableCardContext };
+export { SelectableCardContext, useOptionalSelectableCardContext };

package/dist/components/forms/SelectableCard/SelectableCardGroup.js

@@ -1,35 +1,56 @@
 import { jsx } from 'react/jsx-runtime';
-import React__default, { useId, useMemo } from 'react';
+import React__default, { useId, useState, useMemo, useCallback } from 'react';
 import { cn } from '../../../utils/cn.js';
 import { selectableCardTheme } from './SelectableCard.theme.js';
 import { SelectableCardContext } from './SelectableCardContext.js';
 
-const SelectableCardGroup = React__default.forwardRef(({ type = "single", value, onChange, indicator, disabled = false, name, className, theme: customTheme, children, ...props }, ref) => {
+const SelectableCardGroup = React__default.forwardRef(({ type = "single", value, defaultValue, onChange, indicator, indicatorPosition = "end", size = "md", disabled = false, name, className, theme: customTheme, children, ...props }, ref) => {
     const autoId = useId();
     const groupName = name !== null && name !== void 0 ? name : `selectable-card-${autoId}`;
+    const isControlled = value !== undefined;
+    const [internalValue, setInternalValue] = useState(() => {
+        if (defaultValue !== undefined) {
+            if (process.env.NODE_ENV !== "production") {
+                if (type === "single" && Array.isArray(defaultValue)) {
+                    console.warn("[SelectableCard.Group]: defaultValue is an array but type is 'single'. Use a string.");
+                }
+                if (type === "multiple" && typeof defaultValue === "string") {
+                    console.warn("[SelectableCard.Group]: defaultValue is a string but type is 'multiple'. Use an array.");
+                }
+            }
+            return defaultValue;
+        }
+        return type === "single" ? "" : [];
+    });
+    const resolvedValue = value !== undefined ? value : internalValue;
     const resolvedIndicator = indicator !== null && indicator !== void 0 ? indicator : (type === "single" ? "radio" : "checkbox");
     const theme = useMemo(() => ({ ...selectableCardTheme, ...customTheme }), [customTheme]);
-    const handleChange = (cardValue) => {
+    const handleChange = useCallback((cardValue) => {
+        let next;
         if (type === "single") {
-            onChange(cardValue);
+            next = cardValue;
         }
         else {
-            const current = Array.isArray(value) ? value : [];
-            const next = current.includes(cardValue)
+            const current = Array.isArray(resolvedValue) ? resolvedValue : [];
+            next = current.includes(cardValue)
                 ? current.filter((v) => v !== cardValue)
                 : [...current, cardValue];
-            onChange(next);
         }
-    };
+        if (!isControlled)
+            setInternalValue(next);
+        onChange === null || onChange === void 0 ? void 0 : onChange(next);
+    }, [type, resolvedValue, isControlled, onChange]);
     const contextValue = useMemo(() => ({
         type,
         indicator: resolvedIndicator,
-        value,
+        indicatorPosition,
+        size,
+        value: resolvedValue,
         onChange: handleChange,
         disabled,
         name: groupName,
         theme,
-    }), [type, resolvedIndicator, value, disabled, groupName, theme]);
+    }), [type, resolvedIndicator, indicatorPosition, size, resolvedValue, handleChange, disabled, groupName, theme]);
     return (jsx(SelectableCardContext.Provider, { value: contextValue, children: jsx("div", { ref: ref, role: type === "single" ? "radiogroup" : "group", className: cn(theme.group, className), ...props, children: children }) }));
 });
 SelectableCardGroup.displayName = "SelectableCard.Group";

package/dist/components/forms/SelectableCard/index.d.ts

@@ -1,3 +1,3 @@
 export { SelectableCard } from "./SelectableCard";
-export type { SelectableCardProps, SelectableCardGroupProps, SelectableCardType, SelectableCardIndicator, SelectableCardTheme, } from "./SelectableCard.types";
+export type { SelectableCardProps, SelectableCardGroupProps, SelectableCardType, SelectableCardIndicator, SelectableCardIndicatorPosition, SelectableCardSize, SelectableCardTheme, } from "./SelectableCard.types";
 export { selectableCardTheme } from "./SelectableCard.theme";

package/dist/components/forms/Signature/Signature.theme.js

@@ -14,7 +14,7 @@ const signatureTheme = {
     // Canvas element style
     canvasStyle: "block w-full h-full cursor-crosshair touch-none focus:outline-none",
     // Placeholder text style
-    placeholderStyle: "absolute inset-0 flex items-center justify-center pointer-events-none text-[var(--color-text-placeholder)] text-base",
+    placeholderStyle: "absolute inset-0 flex items-center justify-center pointer-events-none text-[var(--color-text-placeholder)] text-sm",
     // Control buttons container style
     controlsStyle: "absolute bottom-2 right-2 flex gap-2 z-10",
     // Size variants - use shared padding system

package/dist/components/forms/Slider/Slider.theme.js

@@ -4,7 +4,7 @@ const sliderTheme = {
     // Wrapper styles
     wrapperStyle: formsBaseTheme.wrapperStyle,
     // Label styles
-    labelStyle: "block text-base font-medium text-[var(--color-text-primary)] mb-2",
+    labelStyle: "block text-sm font-medium text-[var(--color-text-primary)] mb-2",
     // Helper text styles
     helperTextStyle: formsBaseTheme.helperText,
     // Root container with layout
@@ -16,9 +16,9 @@ const sliderTheme = {
     // Thumb (draggable handle)
     thumbStyle: "block h-5 w-7 rounded-full bg-transparent overflow-hidden cursor-grab active:cursor-grabbing active:scale-x-110 active:scale-y-[0.98] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[var(--color-border)] focus-visible:ring-offset-2 transition-all hover:scale-110 data-[disabled]:cursor-not-allowed data-[disabled]:hover:scale-100 data-[invalid]:focus-visible:ring-[var(--color-danger)]",
     // Value display
-    valueDisplayStyle: "text-base font-medium text-[var(--color-text-secondary)] w-fit min-w-12",
+    valueDisplayStyle: "text-sm font-medium text-[var(--color-text-secondary)] w-fit min-w-12",
     // Min/max labels
-    minMaxLabelStyle: "text-base font-medium text-[var(--color-text-muted)]",
+    minMaxLabelStyle: "text-sm font-medium text-[var(--color-text-muted)]",
     // Tick marks
     tickStyle: "absolute w-0.5 h-2 bg-[var(--color-border)] -translate-x-0.5 pointer-events-none",
 };

package/dist/components/forms/Switch/Switch.theme.js

@@ -5,7 +5,7 @@ const switchTheme = {
     container: "flex w-full justify-between items-center gap-4",
     track: "w-12 h-6 rounded-full cursor-pointer shadow-inner bg-[var(--color-background-tertiary)] data-[state=checked]:bg-[var(--color-primary)] data-[state=disabled]:bg-[var(--color-background-disabled)] data-[state=disabled]:cursor-not-allowed data-[state=invalid]:border-2 data-[state=invalid]:border-[var(--color-danger)] outline outline-[var(--color-border)] transition-colors duration-300",
     thumb: "w-7 h-5 rounded-full bg-transparent overflow-hidden border border-[var(--color-border)]/40 shadow-lg",
-    description: "text-base text-[var(--color-text-muted)] -mt-1.5",
+    description: "text-sm text-[var(--color-text-muted)] -mt-1.5",
 };
 /**
  * Thumb position values for animation

package/dist/components/forms/TimePicker/TimePicker.theme.js

@@ -62,7 +62,7 @@ const timePickerTheme = {
     // Individual wheel column - relative positioning for highlight overlay
     wheelColumnStyle: "flex-1 flex flex-col relative",
     // Wheel column header label
-    wheelHeaderStyle: "text-center py-2 text-sm font-semibold text-[var(--color-text-muted)] uppercase",
+    wheelHeaderStyle: "text-center py-2 text-xs font-semibold text-[var(--color-text-muted)] uppercase",
     // Center highlight row - positioned behind selected item
     wheelHighlightStyle: "absolute -mt-4 inset-x-0 bg-[var(--color-border)] pointer-events-none z-0",
     // Wheel item - centered with transition for smooth opacity/color changes
@@ -77,7 +77,7 @@ const timePickerTheme = {
         "text-[var(--color-text-primary)] placeholder:text-[var(--color-text-placeholder)] " +
         "dark:text-[var(--color-neutral-200)] dark:placeholder:text-[var(--color-neutral-500)]",
     // AM/PM period toggle button
-    periodToggleStyle: "px-1.5 py-0.5 text-sm font-semibold rounded " +
+    periodToggleStyle: "px-1.5 py-0.5 text-xs font-semibold rounded " +
         "bg-[var(--color-background-tertiary)] text-[var(--color-text-primary)] " +
         "hover:bg-[var(--color-background-quaternary)] transition-colors cursor-pointer select-none " +
         "dark:bg-[var(--color-neutral-700)] dark:text-[var(--color-neutral-200)] " +

package/dist/components/forms/forms.theme.js

@@ -15,7 +15,7 @@ const formsBaseTheme = {
         "dark:bg-[var(--color-neutral-900)] dark:outline-[var(--color-neutral-700)] " +
         "dark:focus-within:outline-[var(--color-primary-500)] dark:focus-within:ring-[var(--color-primary-500)]/20",
     // Common base input/control style
-    controlBaseStyle: "w-full bg-transparent text-base text-[var(--color-text-primary)] " +
+    controlBaseStyle: "w-full bg-transparent text-sm text-[var(--color-text-primary)] " +
         "placeholder:text-[var(--color-text-placeholder)] focus:outline-none " +
         // Dark mode
         "dark:text-[var(--color-text-primary)] dark:placeholder:text-[var(--color-neutral-500)]",
@@ -23,19 +23,19 @@ const formsBaseTheme = {
     // These tokens can be composed together or used individually for maximum flexibility
     sizes: {
         sm: {
-            text: "text-base",
+            text: "text-sm",
             padding: "py-[var(--form-py-sm)] px-[var(--form-px-sm)]",
             height: "h-[var(--form-min-h-sm)]",
             textareaHeight: "min-h-[calc(var(--form-min-h-sm)*2)]",
         },
         md: {
-            text: "text-base",
+            text: "text-sm",
             padding: "py-[var(--form-py-md)] px-[var(--form-px-md)]",
             height: "h-[var(--form-min-h-md)]",
             textareaHeight: "min-h-[calc(var(--form-min-h-md)*2)]",
         },
         lg: {
-            text: "text-lg",
+            text: "text-base",
             padding: "py-[var(--form-py-lg)] px-[var(--form-px-lg)]",
             height: "h-[var(--form-min-h-lg)]",
             textareaHeight: "min-h-[calc(var(--form-min-h-lg)*2)]",
@@ -72,7 +72,7 @@ const formsBaseTheme = {
         invalid: "",
     },
     // Common helper text style with state variations
-    helperText: "text-sm text-[var(--color-text-muted)] mt-1.5 [.state-disabled_&]:text-[var(--color-text-disabled)] [.state-invalid_&]:text-[var(--color-danger-500)] " +
+    helperText: "text-xs text-[var(--color-text-muted)] mt-1.5 [.state-disabled_&]:text-[var(--color-text-disabled)] [.state-invalid_&]:text-[var(--color-danger-500)] " +
         "dark:text-[var(--color-neutral-400)] dark:[.state-invalid_&]:text-[var(--color-danger-400)]",
     // Common icon styles
     iconStyles: {
@@ -89,7 +89,7 @@ const formsBaseTheme = {
     dropdownStyles: {
         // Container for dropdown panel
         container: "fixed z-[1000] max-h-[var(--select-content-available-height,20rem)] overflow-auto overscroll-contain " +
-            "rounded-[var(--form-radius)] bg-white/90 backdrop-blur-md text-base border border-[var(--color-border)] " +
+            "rounded-[var(--form-radius)] bg-white/90 backdrop-blur-md text-sm border border-[var(--color-border)] " +
             "shadow-real-lg ring-1 ring-[var(--color-border)] focus:outline-none " +
             "dark:bg-[var(--color-neutral-900)]/90 dark:ring-[var(--color-neutral-700)]",
         // Base option style

package/dist/components/forms/index.js

@@ -52,7 +52,8 @@ export { InputTag } from './InputTag/InputTag.js';
 export { inputTagTheme } from './InputTag/InputTag.theme.js';
 export { Combobox } from './Combobox/Combobox.js';
 export { comboboxTheme } from './Combobox/Combobox.theme.js';
-export { ColorPicker, ColorPickerContext, useColorPicker } from './ColorPicker/ColorPicker.js';
+export { ColorPicker } from './ColorPicker/ColorPicker.js';
+export { ColorPickerContext, useColorPicker } from './ColorPicker/ColorPickerContext.js';
 export { ColorPickerTrigger } from './ColorPicker/ColorPickerTrigger.js';
 export { ColorPickerBody } from './ColorPicker/ColorPickerBody.js';
 export { ColorPicker2DCanvas } from './ColorPicker/ColorPicker2DCanvas.js';
@@ -62,6 +63,10 @@ export { ColorPickerInput } from './ColorPicker/ColorPickerInput.js';
 export { ColorPickerFormatSelector } from './ColorPicker/ColorPickerFormatSelector.js';
 export { ColorPickerEyeDropper } from './ColorPicker/ColorPickerEyeDropper.js';
 export { ColorPickerPresets } from './ColorPicker/ColorPickerPresets.js';
+export { ColorPickerSavedColors } from './ColorPicker/ColorPickerSavedColors.js';
+export { ColorPickerHeader } from './ColorPicker/ColorPickerHeader.js';
+export { ColorPickerGradient } from './ColorPicker/ColorPickerGradient.js';
+export { ColorPickerImage } from './ColorPicker/ColorPickerImage.js';
 export { formatHex, formatHsl, formatRgb, hexToRgb, hslToRgb, hsvToRgb, parseColor, rgbToHex, rgbToHsl, rgbToHsv, validateHex, validateRgb } from './ColorPicker/colorUtils.js';
 export { SelectableCard } from './SelectableCard/SelectableCard.js';
 export { selectableCardTheme } from './SelectableCard/SelectableCard.theme.js';

package/dist/components/layout/FormLayout/FormLayout.theme.js

@@ -2,8 +2,8 @@ const formLayoutTheme = {
     root: "flex flex-col gap-6",
     section: "grid grid-cols-1 md:grid-cols-6 gap-6 md:gap-10",
     sectionSidebar: "col-span-full md:col-span-2",
-    sectionTitle: "text-lg font-semibold text-[var(--color-text-primary)]",
-    sectionSubtitle: "text-base text-[var(--color-text-muted)] mt-1",
+    sectionTitle: "text-base font-semibold text-[var(--color-text-primary)]",
+    sectionSubtitle: "text-sm text-[var(--color-text-muted)] mt-1",
     sectionAction: "mt-4",
     sectionContent: "col-span-full md:col-span-4 grid grid-cols-1 sm:grid-cols-2 gap-4",
     sectionContentFull: "col-span-full grid grid-cols-1 sm:grid-cols-2 gap-4",

package/dist/hooks/useOverlay.d.ts

@@ -1,3 +1,5 @@
+export declare function lockScroll(): void;
+export declare function unlockScroll(): void;
 export interface UseOverlayOptions {
     /** Whether the overlay is currently open */
     isOpen: boolean;

package/dist/hooks/useOverlay.js

@@ -1,5 +1,35 @@
 import { useCallback, useEffect } from 'react';
 
+// ── Scroll-lock manager (ref-counted) ──────────────────────────────────
+// Supports nested overlays: only the first lock measures the scrollbar
+// and compensates; subsequent locks just bump the counter.
+let lockCount = 0;
+let savedOverflow = '';
+let savedPaddingRight = '';
+function lockScroll() {
+    lockCount++;
+    if (lockCount === 1) {
+        const scrollbarWidth = window.innerWidth - document.documentElement.clientWidth;
+        // Save originals before mutating
+        savedOverflow = document.body.style.overflow;
+        savedPaddingRight = document.body.style.paddingRight;
+        // Expose width as CSS variable so fixed-position elements can compensate
+        // e.g.  position: fixed; padding-right: var(--scrollbar-width, 0px);
+        document.documentElement.style.setProperty('--scrollbar-width', `${scrollbarWidth}px`);
+        if (scrollbarWidth > 0) {
+            document.body.style.paddingRight = `${scrollbarWidth}px`;
+        }
+        document.body.style.overflow = 'hidden';
+    }
+}
+function unlockScroll() {
+    lockCount = Math.max(0, lockCount - 1);
+    if (lockCount === 0) {
+        document.body.style.overflow = savedOverflow;
+        document.body.style.paddingRight = savedPaddingRight;
+        document.documentElement.style.removeProperty('--scrollbar-width');
+    }
+}
 /**
  * Shared hook for overlay behavior (escape key, scroll lock, click handling)
  *
@@ -49,15 +79,15 @@ const useOverlay = ({ isOpen, onClose, closeOnEsc = true, closeOnOverlayClick =
         if (isOpen) {
             // Add Escape key listener
             document.addEventListener('keydown', handleEscKey);
-            // Lock body scroll to prevent background scrolling
+            // Lock body scroll (ref-counted so nested overlays work)
             if (enableScrollLock) {
-                document.body.style.overflow = 'hidden';
+                lockScroll();
             }
             // Cleanup on unmount or when overlay closes
             return () => {
                 document.removeEventListener('keydown', handleEscKey);
                 if (enableScrollLock) {
-                    document.body.style.overflow = 'unset';
+                    unlockScroll();
                 }
             };
         }
@@ -68,4 +98,4 @@ const useOverlay = ({ isOpen, onClose, closeOnEsc = true, closeOnOverlayClick =
     };
 };
 
-export { useOverlay };
+export { lockScroll, unlockScroll, useOverlay };