pixelize-design-library 2.4.2 → 3.0.0

package/dist/Components/Header/components/desktopMenu.js

@@ -5,24 +5,24 @@ const react_1 = require("@chakra-ui/react");
 const lucide_react_1 = require("lucide-react");
 const useCustomTheme_1 = require("../../../Theme/useCustomTheme");
 const accentText_1 = require("../../../Theme/tokens/builders/accentText");
-const DesktopMenu = ({ menuItems, rightSlot, setHoveredMenu, isActive, activeBg, hoveredMenu, hoverBg, color, hoverTextColor }) => {
+const tone_1 = require("../../../Theme/tokens/builders/tone");
+const paletteFromTheme_1 = require("../../../Theme/chakra/paletteFromTheme");
+/** Desktop nav row of Header: ghost buttons with hover dropdowns for items that have children. */
+const DesktopMenu = ({ menuItems, rightSlot, setHoveredMenu, isActive, activeBg, hoveredMenu, hoverBg, color, hoverTextColor, surface, }) => {
     const { colors } = (0, useCustomTheme_1.useCustomTheme)();
+    const badgeTone = (scheme) => (0, tone_1.resolveSoftTone)(colors, (0, paletteFromTheme_1.scaleFor)(colors, scheme !== null && scheme !== void 0 ? scheme : "blue"), surface);
     return ((0, jsx_runtime_1.jsx)(react_1.HStack, { spacing: 6, align: "center", display: { base: "none", md: "flex" }, mx: rightSlot ? "auto" : 0, wrap: "wrap", padding: "0.5rem 1.5rem", children: menuItems.map((item) => {
-            var _a, _b, _c, _d;
+            var _a, _b;
             const hasChildren = !!item.children;
             const isHovered = hoveredMenu === item.label;
             return ((0, jsx_runtime_1.jsxs)(react_1.Box, { position: "relative", onMouseEnter: () => hasChildren && setHoveredMenu(item.label), onMouseLeave: () => hasChildren && setHoveredMenu(null), children: [(0, jsx_runtime_1.jsx)(react_1.Button, { variant: "ghost", onClick: item.onClick, rightIcon: hasChildren ? (0, jsx_runtime_1.jsx)(lucide_react_1.ChevronDown, { size: 14 }) : undefined, 
                         // `activeBg` is the rail's 3:1 non-text accent; label ink stays on `color`.
-                        borderBottom: `2px solid ${isActive(item.href) ? activeBg : "transparent"}`, borderRadius: 0, _hover: { bg: hoverBg, color: hoverTextColor }, color: color, children: (0, jsx_runtime_1.jsxs)(react_1.VStack, { spacing: 0, children: [item.badge && ((0, jsx_runtime_1.jsx)(react_1.Badge, { colorScheme: (_b = (_a = item === null || item === void 0 ? void 0 : item.badge) === null || _a === void 0 ? void 0 : _a.colorScheme) !== null && _b !== void 0 ? _b : "blue", variant: "subtle", fontSize: "0.65em", borderRadius: "md", boxShadow: "sm", px: 2, py: 0.5, children: (_c = item.badge) === null || _c === void 0 ? void 0 : _c.label })), (0, jsx_runtime_1.jsx)(react_1.Text, { children: item.label })] }) }), hasChildren && ((0, jsx_runtime_1.jsx)(react_1.Collapse, { in: isHovered, animateOpacity: true, children: (0, jsx_runtime_1.jsx)(react_1.Box, { position: "absolute", top: "100%", bg: colors.background[50], color: colors.text[900], rounded: "md", shadow: "md", minW: "10rem", zIndex: 10, children: (0, jsx_runtime_1.jsx)(react_1.Stack, { spacing: 1, p: 2, children: (_d = item.children) === null || _d === void 0 ? void 0 : _d.map((subItem) => {
-                                    var _a, _b, _c;
-                                    return ((0, jsx_runtime_1.jsx)(react_1.Button, { onClick: subItem.onClick, variant: "ghost", justifyContent: "flex-start", w: "full", bg: isActive(subItem.href) ? activeBg : "transparent", _hover: { bg: hoverBg, color: hoverTextColor }, children: (0, jsx_runtime_1.jsxs)(react_1.VStack, { spacing: 0, align: "start", children: [subItem.badge && ((0, jsx_runtime_1.jsx)(react_1.Badge, { colorScheme: (_b = (_a = subItem === null || subItem === void 0 ? void 0 : subItem.badge) === null || _a === void 0 ? void 0 : _a.colorScheme) !== null && _b !== void 0 ? _b : "blue", variant: "subtle", fontSize: "0.65em", alignItems: "end", borderRadius: "md", boxShadow: "sm", px: 2, py: 0.5, children: (_c = subItem.badge) === null || _c === void 0 ? void 0 : _c.label })), (0, jsx_runtime_1.jsx)(react_1.Text
-                                                // text[800] is tuned for the background[50] canvas, not the activeBg
-                                                // fill this row switches to — onFilled picks whichever of white/black
-                                                // actually clears AA against that fill instead.
+                        borderBottom: `2px solid ${isActive(item.href) ? activeBg : "transparent"}`, borderRadius: 0, _hover: { bg: hoverBg, color: hoverTextColor }, color: color, children: (0, jsx_runtime_1.jsxs)(react_1.VStack, { spacing: 0, children: [item.badge && ((0, jsx_runtime_1.jsx)(react_1.Badge, { bg: badgeTone(item.badge.colorScheme).bg, color: badgeTone(item.badge.colorScheme).fg, variant: "subtle", fontSize: "0.65em", borderRadius: "full", boxShadow: "sm", px: 2, py: 0.5, children: (_a = item.badge) === null || _a === void 0 ? void 0 : _a.label })), (0, jsx_runtime_1.jsx)(react_1.Text, { children: item.label })] }) }), hasChildren && ((0, jsx_runtime_1.jsx)(react_1.Collapse, { in: isHovered, animateOpacity: true, children: (0, jsx_runtime_1.jsx)(react_1.Box, { position: "absolute", top: "100%", bg: colors.surfaceRaised, color: colors.text[900], rounded: "xl", shadow: "md", minW: "10rem", zIndex: 10, children: (0, jsx_runtime_1.jsx)(react_1.Stack, { spacing: 1, p: 2, children: (_b = item.children) === null || _b === void 0 ? void 0 : _b.map((subItem) => {
+                                    var _a;
+                                    return ((0, jsx_runtime_1.jsx)(react_1.Button, { onClick: subItem.onClick, variant: "ghost", justifyContent: "flex-start", w: "full", bg: isActive(subItem.href) ? activeBg : "transparent", _hover: { bg: hoverBg, color: hoverTextColor }, children: (0, jsx_runtime_1.jsxs)(react_1.VStack, { spacing: 0, align: "start", children: [subItem.badge && ((0, jsx_runtime_1.jsx)(react_1.Badge, { bg: badgeTone(subItem.badge.colorScheme).bg, color: badgeTone(subItem.badge.colorScheme).fg, variant: "subtle", fontSize: "0.65em", alignItems: "end", borderRadius: "full", boxShadow: "sm", px: 2, py: 0.5, children: (_a = subItem.badge) === null || _a === void 0 ? void 0 : _a.label })), (0, jsx_runtime_1.jsx)(react_1.Text
+                                                // NOTE: text[800] is tuned for background[50], not activeBg — onFilled picks a clearing ink instead.
                                                 , { 
-                                                    // text[800] is tuned for the background[50] canvas, not the activeBg
-                                                    // fill this row switches to — onFilled picks whichever of white/black
-                                                    // actually clears AA against that fill instead.
+                                                    // NOTE: text[800] is tuned for background[50], not activeBg — onFilled picks a clearing ink instead.
                                                     color: isActive(subItem.href)
                                                         ? (0, accentText_1.onFilled)(activeBg, colors.white, colors.black)
                                                         : colors.text[800], _hover: { color: hoverTextColor }, children: subItem.label })] }) }, subItem.label));

package/dist/Components/Header/components/mobileMenu.d.ts

@@ -1,3 +1,4 @@
 import { MobileMenuProps } from "../HeaderProps";
-declare const MobileMenu: ({ menuItems, isOpen, isActive, hoverBg, activeBg, color, rightSlot, onClose, }: MobileMenuProps) => import("react/jsx-runtime").JSX.Element;
+/** Collapsible mobile nav panel of Header; items with children toggle an inline submenu. */
+declare const MobileMenu: ({ menuItems, isOpen, isActive, hoverBg, activeBg, color, surface, onClose, }: MobileMenuProps) => import("react/jsx-runtime").JSX.Element;
 export default MobileMenu;

package/dist/Components/Header/components/mobileMenu.js

@@ -7,24 +7,37 @@ const jsx_runtime_1 = require("react/jsx-runtime");
 const react_1 = require("@chakra-ui/react");
 const react_2 = __importDefault(require("react"));
 const lucide_react_1 = require("lucide-react");
-const MobileMenu = ({ menuItems, isOpen, isActive, hoverBg, activeBg, color, rightSlot, onClose, }) => {
+const useCustomTheme_1 = require("../../../Theme/useCustomTheme");
+const accentText_1 = require("../../../Theme/tokens/builders/accentText");
+const tone_1 = require("../../../Theme/tokens/builders/tone");
+const paletteFromTheme_1 = require("../../../Theme/chakra/paletteFromTheme");
+/** Collapsible mobile nav panel of Header; items with children toggle an inline submenu. */
+const MobileMenu = ({ menuItems, isOpen, isActive, hoverBg, activeBg, color, surface, onClose, }) => {
+    const { colors } = (0, useCustomTheme_1.useCustomTheme)();
+    const badgeTone = (scheme) => (0, tone_1.resolveSoftTone)(colors, (0, paletteFromTheme_1.scaleFor)(colors, scheme !== null && scheme !== void 0 ? scheme : "blue"), surface);
     const [openMenuLabel, setOpenMenuLabel] = react_2.default.useState(null);
     react_2.default.useEffect(() => {
         if (!isOpen)
             setOpenMenuLabel(null);
     }, [isOpen]);
-    return ((0, jsx_runtime_1.jsx)(react_1.Collapse, { in: isOpen, animateOpacity: true, children: (0, jsx_runtime_1.jsx)(react_1.Box, { pb: 4, display: { md: "none" }, children: (0, jsx_runtime_1.jsxs)(react_1.Stack, { spacing: 4, children: [menuItems.map((item) => {
-                        var _a, _b, _c, _d, _e;
-                        return item.children ? ((0, jsx_runtime_1.jsxs)(react_1.Box, { px: 2, children: [(0, jsx_runtime_1.jsx)(react_1.Button, { onClick: () => setOpenMenuLabel((prev) => (prev === item.label ? null : item.label)), variant: "ghost", w: "full", justifyContent: "flex-start", color: color, bg: item.children.some((subItem) => isActive(subItem.href))
-                                        ? activeBg
-                                        : "transparent", _hover: { bg: hoverBg }, rightIcon: openMenuLabel === item.label ? ((0, jsx_runtime_1.jsx)(lucide_react_1.ChevronDown, { size: 16 })) : ((0, jsx_runtime_1.jsx)(lucide_react_1.ChevronRight, { size: 16 })), px: 2, children: (0, jsx_runtime_1.jsx)(react_1.HStack, { w: "full", justify: "space-between", align: "center", children: (0, jsx_runtime_1.jsxs)(react_1.VStack, { spacing: 0, align: "start", children: [item.badge && ((0, jsx_runtime_1.jsx)(react_1.Badge, { colorScheme: (_b = (_a = item === null || item === void 0 ? void 0 : item.badge) === null || _a === void 0 ? void 0 : _a.colorScheme) !== null && _b !== void 0 ? _b : "blue", variant: "subtle", fontSize: "0.65em", borderRadius: "md", boxShadow: "sm", px: 2, py: 0.5, children: item.badge.label })), (0, jsx_runtime_1.jsx)(react_1.Text, { fontWeight: "bold", children: item.label })] }) }) }), (0, jsx_runtime_1.jsx)(react_1.Collapse, { in: openMenuLabel === item.label, animateOpacity: true, children: (0, jsx_runtime_1.jsx)(react_1.Stack, { pl: 4, mt: 1, spacing: 1, children: item.children.map((subItem) => {
-                                            var _a, _b, _c;
-                                            return ((0, jsx_runtime_1.jsx)(react_1.Button, { onClick: () => {
-                                                    var _a;
-                                                    (_a = subItem.onClick) === null || _a === void 0 ? void 0 : _a.call(subItem);
-                                                    onClose === null || onClose === void 0 ? void 0 : onClose();
-                                                }, variant: "ghost", w: "full", justifyContent: "flex-start", color: color, bg: isActive(subItem.href) ? activeBg : "transparent", _hover: { bg: hoverBg }, children: (0, jsx_runtime_1.jsxs)(react_1.VStack, { spacing: 0, align: "start", children: [subItem.badge && ((0, jsx_runtime_1.jsx)(react_1.Badge, { colorScheme: (_b = (_a = subItem === null || subItem === void 0 ? void 0 : subItem.badge) === null || _a === void 0 ? void 0 : _a.colorScheme) !== null && _b !== void 0 ? _b : "blue", variant: "subtle", fontSize: "0.65em", borderRadius: "md", boxShadow: "sm", px: 2, py: 0.5, children: (_c = subItem.badge) === null || _c === void 0 ? void 0 : _c.label })), (0, jsx_runtime_1.jsxs)(react_1.HStack, { spacing: 2, align: "center", children: [(0, jsx_runtime_1.jsx)(react_1.Box, { boxSize: "0.4rem", borderRadius: "full", bg: "currentColor" }), (0, jsx_runtime_1.jsx)(react_1.Text, { fontSize: "sm", children: subItem.label })] })] }) }, subItem.label));
-                                        }) }) })] }, item.label)) : ((0, jsx_runtime_1.jsx)(react_1.Button, { onClick: () => { var _a; (_a = item.onClick) === null || _a === void 0 ? void 0 : _a.call(item); onClose === null || onClose === void 0 ? void 0 : onClose(); }, variant: "ghost", w: "full", justifyContent: "flex-start", color: color, bg: isActive(item.href) ? activeBg : "transparent", _hover: { bg: hoverBg }, children: (0, jsx_runtime_1.jsxs)(react_1.VStack, { spacing: 0, align: "start", children: [item.badge && ((0, jsx_runtime_1.jsx)(react_1.Badge, { colorScheme: (_d = (_c = item === null || item === void 0 ? void 0 : item.badge) === null || _c === void 0 ? void 0 : _c.colorScheme) !== null && _d !== void 0 ? _d : "blue", variant: "subtle", fontSize: "0.65em", borderRadius: "md", boxShadow: "sm", px: 2, py: 0.5, children: (_e = item.badge) === null || _e === void 0 ? void 0 : _e.label })), (0, jsx_runtime_1.jsx)(react_1.Text, { children: item.label })] }) }, item.label));
-                    }), rightSlot && (0, jsx_runtime_1.jsx)(react_1.Box, { mt: 4, children: rightSlot })] }) }) }));
+    return ((0, jsx_runtime_1.jsx)(react_1.Collapse, { in: isOpen, animateOpacity: true, children: (0, jsx_runtime_1.jsx)(react_1.Box, { pb: 4, display: { md: "none" }, children: (0, jsx_runtime_1.jsx)(react_1.Stack, { spacing: 4, children: menuItems.map((item) => {
+                    var _a;
+                    return item.children ? ((0, jsx_runtime_1.jsxs)(react_1.Box, { px: 2, children: [(0, jsx_runtime_1.jsx)(react_1.Button, { onClick: () => setOpenMenuLabel((prev) => (prev === item.label ? null : item.label)), variant: "ghost", w: "full", justifyContent: "flex-start", color: item.children.some((subItem) => isActive(subItem.href))
+                                    ? (0, accentText_1.onFilled)(activeBg, colors.white, colors.black)
+                                    : color, bg: item.children.some((subItem) => isActive(subItem.href))
+                                    ? activeBg
+                                    : "transparent", _hover: { bg: hoverBg }, rightIcon: openMenuLabel === item.label ? ((0, jsx_runtime_1.jsx)(lucide_react_1.ChevronDown, { size: 16 })) : ((0, jsx_runtime_1.jsx)(lucide_react_1.ChevronRight, { size: 16 })), px: 2, children: (0, jsx_runtime_1.jsx)(react_1.HStack, { w: "full", justify: "space-between", align: "center", children: (0, jsx_runtime_1.jsxs)(react_1.VStack, { spacing: 0, align: "start", children: [item.badge && ((0, jsx_runtime_1.jsx)(react_1.Badge, { bg: badgeTone(item.badge.colorScheme).bg, color: badgeTone(item.badge.colorScheme).fg, variant: "subtle", fontSize: "0.65em", borderRadius: "full", boxShadow: "sm", px: 2, py: 0.5, children: item.badge.label })), (0, jsx_runtime_1.jsx)(react_1.Text, { fontWeight: 700, children: item.label })] }) }) }), (0, jsx_runtime_1.jsx)(react_1.Collapse, { in: openMenuLabel === item.label, animateOpacity: true, children: (0, jsx_runtime_1.jsx)(react_1.Stack, { pl: 4, mt: 1, spacing: 1, children: item.children.map((subItem) => {
+                                        var _a;
+                                        return ((0, jsx_runtime_1.jsx)(react_1.Button, { onClick: () => {
+                                                var _a;
+                                                (_a = subItem.onClick) === null || _a === void 0 ? void 0 : _a.call(subItem);
+                                                onClose === null || onClose === void 0 ? void 0 : onClose();
+                                            }, variant: "ghost", w: "full", justifyContent: "flex-start", color: isActive(subItem.href)
+                                                ? (0, accentText_1.onFilled)(activeBg, colors.white, colors.black)
+                                                : color, bg: isActive(subItem.href) ? activeBg : "transparent", _hover: { bg: hoverBg }, children: (0, jsx_runtime_1.jsxs)(react_1.VStack, { spacing: 0, align: "start", children: [subItem.badge && ((0, jsx_runtime_1.jsx)(react_1.Badge, { bg: badgeTone(subItem.badge.colorScheme).bg, color: badgeTone(subItem.badge.colorScheme).fg, variant: "subtle", fontSize: "0.65em", borderRadius: "full", boxShadow: "sm", px: 2, py: 0.5, children: (_a = subItem.badge) === null || _a === void 0 ? void 0 : _a.label })), (0, jsx_runtime_1.jsxs)(react_1.HStack, { spacing: 2, align: "center", children: [(0, jsx_runtime_1.jsx)(react_1.Box, { boxSize: "0.4rem", borderRadius: "full", bg: "currentColor" }), (0, jsx_runtime_1.jsx)(react_1.Text, { fontSize: "sm", children: subItem.label })] })] }) }, subItem.label));
+                                    }) }) })] }, item.label)) : ((0, jsx_runtime_1.jsx)(react_1.Button, { onClick: () => { var _a; (_a = item.onClick) === null || _a === void 0 ? void 0 : _a.call(item); onClose === null || onClose === void 0 ? void 0 : onClose(); }, variant: "ghost", w: "full", justifyContent: "flex-start", color: isActive(item.href)
+                            ? (0, accentText_1.onFilled)(activeBg, colors.white, colors.black)
+                            : color, bg: isActive(item.href) ? activeBg : "transparent", _hover: { bg: hoverBg }, children: (0, jsx_runtime_1.jsxs)(react_1.VStack, { spacing: 0, align: "start", children: [item.badge && ((0, jsx_runtime_1.jsx)(react_1.Badge, { bg: badgeTone(item.badge.colorScheme).bg, color: badgeTone(item.badge.colorScheme).fg, variant: "subtle", fontSize: "0.65em", borderRadius: "full", boxShadow: "sm", px: 2, py: 0.5, children: (_a = item.badge) === null || _a === void 0 ? void 0 : _a.label })), (0, jsx_runtime_1.jsx)(react_1.Text, { children: item.label })] }) }, item.label));
+                }) }) }) }));
 };
 exports.default = MobileMenu;

package/dist/Components/IconButton/IconButton.d.ts

@@ -0,0 +1,5 @@
+import { type ComponentWithAs } from "@chakra-ui/react";
+import type { IconButtonProps } from "./IconButtonProps";
+export declare const UNNAMED_ICON_BUTTON_WARNING = "[pixelize-design-library] IconButton: no aria-label or aria-labelledby, so screen readers announce it as an unnamed button.";
+declare const _default: ComponentWithAs<"button", IconButtonProps>;
+export default _default;

package/dist/Components/IconButton/IconButton.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UNNAMED_ICON_BUTTON_WARNING = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const react_2 = require("@chakra-ui/react");
+// NOTE: Chakra omits a missing aria-label at runtime; only its type insists on one.
+const UnlabelledChakraIconButton = react_2.IconButton;
+exports.UNNAMED_ICON_BUTTON_WARNING = "[pixelize-design-library] IconButton: no aria-label or aria-labelledby, so screen readers announce it as an unnamed button.";
+const useUnnamedWarning = (isUnnamed) => {
+    const warned = (0, react_1.useRef)(false);
+    (0, react_1.useEffect)(() => {
+        if (process.env.NODE_ENV === "production" || !isUnnamed || warned.current)
+            return;
+        warned.current = true;
+        console.warn(exports.UNNAMED_ICON_BUTTON_WARNING);
+    }, [isUnnamed]);
+};
+const IconButton = (0, react_1.forwardRef)(function IconButton(props, ref) {
+    var _a, _b;
+    useUnnamedWarning(!((_a = props["aria-label"]) === null || _a === void 0 ? void 0 : _a.trim()) && !((_b = props["aria-labelledby"]) === null || _b === void 0 ? void 0 : _b.trim()));
+    return (0, jsx_runtime_1.jsx)(UnlabelledChakraIconButton, { ref: ref, ...props });
+});
+exports.default = (0, react_1.memo)(IconButton);

package/dist/Components/IconButton/IconButtonProps.d.ts

@@ -0,0 +1,11 @@
+import type { IconButtonProps as ChakraIconButtonProps } from "@chakra-ui/react";
+import type { DataAttributes } from "../Common/dataAttributes";
+/** Every Chakra `IconButtonProps` prop, with the same theme `Button` look; only `aria-label` is relaxed to optional. */
+export interface IconButtonProps extends Omit<ChakraIconButtonProps, "aria-label">, DataAttributes {
+    /** The button's accessible name. Optional in the type, but dev builds warn once per mount when it and `aria-labelledby` are both missing. */
+    "aria-label"?: string;
+    /** Swaps the icon for a spinner inside the same box, and disables the button until it clears. */
+    isLoading?: boolean;
+    /** A square on Button's own scale: xs 24 · sm 32 (default) · md 40 · lg 48 · xl 56, with no padding. */
+    size?: ChakraIconButtonProps["size"];
+}

package/dist/Components/IconButton/IconButtonProps.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/Components/Input/PhoneNumberInput.d.ts

@@ -1,3 +1,4 @@
 import { PhoneNumberInputProps } from "./PhoneNumberInputProps";
-declare const PhoneNumberInput: ({ size, value, codeValueReturn, country, countries, placeholder, onChange, inputId, selectId, error, errorMessage, helperText, label, id, width, isInformation, informationMessage, isRequired, onBlur, onFocus, isReadOnly, height, autoComplete, showCountrySelect, ref, name, minW, maxW, ...rest }: PhoneNumberInputProps) => import("react/jsx-runtime").JSX.Element;
+/** Country-code-aware phone field with a flag/dial-code prefix; `ref` forwards to the number `<input>`. */
+declare const PhoneNumberInput: import("react").ForwardRefExoticComponent<PhoneNumberInputProps & import("react").RefAttributes<HTMLInputElement>>;
 export default PhoneNumberInput;

package/dist/Components/Input/PhoneNumberInput.js

@@ -9,6 +9,7 @@ const react_2 = require("@chakra-ui/react");
 const ErrorMessage_1 = __importDefault(require("../Common/ErrorMessage"));
 const HelperText_1 = __importDefault(require("../Common/HelperText"));
 const FormLabel_1 = require("../Common/FormLabel");
+const useFieldIds_1 = require("../Common/useFieldIds");
 const useCustomTheme_1 = require("../../Theme/useCustomTheme");
 const getFlagEmoji = (countryCode) => {
     if (!countryCode)
@@ -19,8 +20,10 @@ const getFlagEmoji = (countryCode) => {
 };
 const sizeToPt = { xs: 2, sm: -1, md: 2, lg: 4 };
 const sizeToWidth = { xs: "3.5rem", sm: "3.8rem", md: "4rem", lg: "4rem" };
-const PhoneNumberInput = ({ size = "md", value, codeValueReturn = true, country, countries, placeholder = "Enter phone number", onChange, inputId, selectId, error, errorMessage, helperText, label, id, width = "100%", isInformation, informationMessage, isRequired, onBlur, onFocus, isReadOnly, height, autoComplete, showCountrySelect = true, ref, name, minW, maxW, ...rest }) => {
+/** Country-code-aware phone field with a flag/dial-code prefix; `ref` forwards to the number `<input>`. */
+const PhoneNumberInput = (0, react_1.forwardRef)(function PhoneNumberInput({ size = "sm", value, codeValueReturn = true, country, countries, placeholder = "Enter phone number", onChange, inputId, selectId, error, errorMessage, helperText, label, id, width = "100%", isInformation, informationMessage, isRequired, onBlur, onFocus, isReadOnly, height, autoComplete, showCountrySelect = true, name, minW, maxW, countrySelectAriaLabel = "Country code", ...rest }, ref) {
     const theme = (0, useCustomTheme_1.useCustomTheme)();
+    const ids = (0, useFieldIds_1.useFieldIds)(inputId !== null && inputId !== void 0 ? inputId : id, { error, errorMessage, helperText });
     const getCountryTelCode = (0, react_1.useCallback)((countryCode) => {
         var _a;
         if (!countryCode)
@@ -30,6 +33,20 @@ const PhoneNumberInput = ({ size = "md", value, codeValueReturn = true, country,
     const [number, setNumber] = (0, react_1.useState)(value);
     const [selectedCountry, setSelectedCountry] = (0, react_1.useState)(country);
     const [countryCode, setCountryCode] = (0, react_1.useState)(country);
+    const countryCodeRef = (0, react_1.useRef)(countryCode);
+    countryCodeRef.current = countryCode;
+    const firstValue = (0, react_1.useRef)(true);
+    (0, react_1.useEffect)(() => {
+        if (firstValue.current) {
+            firstValue.current = false;
+            return;
+        }
+        if (value === undefined)
+            return;
+        const dial = countryCodeRef.current;
+        const digits = dial && value.startsWith(`${dial} `) ? value.slice(dial.length + 1) : value;
+        setNumber(digits);
+    }, [value]);
     (0, react_1.useEffect)(() => {
         if (country) {
             const code = getCountryTelCode(country);
@@ -62,6 +79,7 @@ const PhoneNumberInput = ({ size = "md", value, codeValueReturn = true, country,
             return;
         }
     };
-    return ((0, jsx_runtime_1.jsxs)(react_2.FormControl, { w: width, minW: minW, maxW: maxW, children: [label && ((0, jsx_runtime_1.jsx)(FormLabel_1.TextLabel, { label: label, id: id, isInformation: isInformation, informationMessage: informationMessage, isRequired: isRequired })), (0, jsx_runtime_1.jsxs)(react_2.InputGroup, { size: size, ...rest, children: [(0, jsx_runtime_1.jsxs)(react_2.InputLeftElement, { width: showCountrySelect ? "3rem" : "2rem", height: "100%", children: [showCountrySelect && (0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: (0, jsx_runtime_1.jsxs)(react_2.Select, { position: "absolute", top: "0", left: "0", height: "100%", id: selectId, width: sizeToWidth[size], opacity: 0, zIndex: 1, value: selectedCountry, onChange: handleCountryChange, size: size, pt: sizeToPt[size], iconColor: theme.colors.gray[500], children: [(0, jsx_runtime_1.jsx)("option", { value: "", children: "Select Country" }), countries.map((option) => ((0, jsx_runtime_1.jsx)("option", { value: option.code, children: option.country }, option.code)))] }) }), (0, jsx_runtime_1.jsx)(react_2.Flex, { pl: 2, width: "100%", alignItems: "center", justifyContent: "space-between", children: selectedCountry ? ((0, jsx_runtime_1.jsx)(react_2.Box, { fontSize: "1.2rem", children: getFlagEmoji(selectedCountry) })) : ((0, jsx_runtime_1.jsx)(react_2.Icon, { viewBox: "0 0 24 24", boxSize: "1rem", children: (0, jsx_runtime_1.jsx)("path", { fill: "currentColor", d: "M6.62,10.79C8.06,13.62 10.38,15.94 13.21,17.38L15.41,15.18C15.79,14.8 16.33,14.67 16.8,14.82C18.17,15.27 19.65,15.5 21,15.5C21.55,15.5 22,15.95 22,16.5V20C22,20.55 21.55,21 21,21C10.61,21 3,13.39 3,3C3,2.45 3.45,2 4,2H7.5C8.05,2 8.5,2.45 8.5,3C8.5,4.35 8.73,5.83 9.18,7.2C9.33,7.67 9.2,8.21 8.82,8.59L6.62,10.79Z" }) })) })] }), (0, jsx_runtime_1.jsx)(react_2.Input, { type: "tel", pl: showCountrySelect ? "4rem" : "2rem", value: number, id: inputId, onChange: handleNumberChange, onBlur: onBlur, onFocus: onFocus, isReadOnly: isReadOnly, name: name, size: size, height: height, ref: ref, autoComplete: autoComplete, placeholder: placeholder, disabled: !selectedCountry, isInvalid: error })] }), error && (0, jsx_runtime_1.jsx)(ErrorMessage_1.default, { errorMessage: errorMessage }), helperText && !error && (0, jsx_runtime_1.jsx)(HelperText_1.default, { helperText: helperText })] }));
-};
+    return ((0, jsx_runtime_1.jsxs)(react_2.FormControl, { w: width, minW: minW, maxW: maxW, children: [label && ((0, jsx_runtime_1.jsx)(FormLabel_1.TextLabel, { label: label, id: ids.inputId, isInformation: isInformation, informationMessage: informationMessage, isRequired: isRequired })), (0, jsx_runtime_1.jsxs)(react_2.InputGroup, { size: size, ...rest, children: [(0, jsx_runtime_1.jsxs)(react_2.InputLeftElement, { width: showCountrySelect ? "3rem" : "2rem", height: "100%", children: [showCountrySelect && (0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: (0, jsx_runtime_1.jsxs)(react_2.Select, { position: "absolute", top: "0", left: "0", height: "100%", id: selectId, "aria-label": countrySelectAriaLabel, width: sizeToWidth[size], opacity: 0, zIndex: 1, value: selectedCountry, onChange: handleCountryChange, size: size, pt: sizeToPt[size], iconColor: theme.colors.gray[500], children: [(0, jsx_runtime_1.jsx)("option", { value: "", children: "Select Country" }), countries.map((option) => ((0, jsx_runtime_1.jsx)("option", { value: option.code, children: option.country }, option.code)))] }) }), (0, jsx_runtime_1.jsx)(react_2.Flex, { pl: 2, width: "100%", alignItems: "center", justifyContent: "space-between", children: selectedCountry ? ((0, jsx_runtime_1.jsx)(react_2.Box, { fontSize: "1.2rem", children: getFlagEmoji(selectedCountry) })) : ((0, jsx_runtime_1.jsx)(react_2.Icon, { viewBox: "0 0 24 24", boxSize: "1rem", children: (0, jsx_runtime_1.jsx)("path", { fill: "currentColor", d: "M6.62,10.79C8.06,13.62 10.38,15.94 13.21,17.38L15.41,15.18C15.79,14.8 16.33,14.67 16.8,14.82C18.17,15.27 19.65,15.5 21,15.5C21.55,15.5 22,15.95 22,16.5V20C22,20.55 21.55,21 21,21C10.61,21 3,13.39 3,3C3,2.45 3.45,2 4,2H7.5C8.05,2 8.5,2.45 8.5,3C8.5,4.35 8.73,5.83 9.18,7.2C9.33,7.67 9.2,8.21 8.82,8.59L6.62,10.79Z" }) })) })] }), (0, jsx_runtime_1.jsx)(react_2.Input, { type: "tel", pl: showCountrySelect ? "4rem" : "2rem", value: number, id: ids.inputId, "aria-describedby": ids.describedBy, onChange: handleNumberChange, onBlur: onBlur, onFocus: onFocus, isReadOnly: isReadOnly, name: name, size: size, height: height, ref: ref, autoComplete: autoComplete, placeholder: placeholder, disabled: !selectedCountry, isInvalid: error })] }), error && errorMessage && (0, jsx_runtime_1.jsx)(ErrorMessage_1.default, { errorMessage: errorMessage, id: ids.errorId }), helperText && !error && (0, jsx_runtime_1.jsx)(HelperText_1.default, { helperText: helperText, id: ids.helperId })] }));
+});
+PhoneNumberInput.displayName = "PhoneNumberInput";
 exports.default = PhoneNumberInput;

package/dist/Components/Input/PhoneNumberInputProps.d.ts

@@ -1,19 +1,25 @@
+/** One entry in the `countries` select; `dial_code` prefixes the number on change. */
 export type CountryOption = {
     country_id: string | number;
     code: string;
     country: string;
     dial_code: string;
 };
+/** The number field stays isDisabled until a country is chosen (via the select or the country prop) — with neither, typing silently does nothing. */
 export type PhoneNumberInputProps = {
     label?: string;
+    /** Falls back to an auto-generated id (shared with `inputId` when that's omitted too), so the label is always bound. */
     id?: string;
+    /** Control-scale height: xs 32 · sm 38 · md 40 · lg 48px. Defaults to "sm", like TextInput, so it lines up in a form. */
     size?: string;
+    /** The number shown in the field; a later change to it updates the field. A leading dial code (the `onChange` shape) is stripped, so echoing `onChange` back is safe. */
     value?: string;
     codeValueReturn?: boolean;
     country?: string;
     placeholder?: string;
     onChange: (value: string) => void;
     countries: CountryOption[];
+    /** The number `<input>`'s id; the label binds to this when given, else to `id`, else to an auto-generated id. */
     inputId?: string;
     selectId?: string;
     name?: string;
@@ -26,11 +32,12 @@ export type PhoneNumberInputProps = {
     onBlur?: () => void;
     onFocus?: () => void;
     isReadOnly?: boolean;
-    ref?: React.Ref<HTMLInputElement>;
     autoComplete?: string;
     height?: string;
     width?: string;
     minW?: string;
     maxW?: string;
     showCountrySelect?: boolean;
+    /** Accessible name for the country-code select; defaults to "Country code". */
+    countrySelectAriaLabel?: string;
 };

package/dist/Components/Input/Switch/InputSwitch.d.ts

@@ -1,5 +1,7 @@
-import { SwitchProps } from "@chakra-ui/react";
-export interface ThemedSwitchProps extends SwitchProps {
+import { type SwitchProps } from "@chakra-ui/react";
+import type { ToggleSwitchColorScheme } from "../../ToggleSwitch/ToggleSwitchProps";
+/** @deprecated Use `ToggleSwitch` — InputSwitch now renders it; Chakra-only style props are ignored. */
+export interface ThemedSwitchProps extends Omit<SwitchProps, "colorScheme" | "variant" | "spacing" | "isFocusable"> {
     switchText?: string;
     switchTextPosition?: "left" | "right";
     isInformation?: boolean;
@@ -7,5 +9,16 @@ export interface ThemedSwitchProps extends SwitchProps {
     isRequired?: boolean;
     label?: string;
     size?: "sm" | "md" | "lg";
+    helperText?: string;
+    errorMessage?: string;
+    /** Fill colour when on; now actually applied (previously silently ignored). */
+    colorScheme?: ToggleSwitchColorScheme;
+    /** @deprecated Never did anything — neither this theme nor the hand-rolled ToggleSwitch has variants. */
+    variant?: SwitchProps["variant"];
+    /** @deprecated Never did anything — ToggleSwitch's label gap is a fixed design token. */
+    spacing?: SwitchProps["spacing"];
+    /** @deprecated Never did anything — use `isReadOnly` for a focusable, non-interactive switch. */
+    isFocusable?: boolean;
 }
-export declare const InputSwitch: ({ switchText, switchTextPosition, id, isChecked, label, isInformation, informationMessage, isRequired, size, ...props }: ThemedSwitchProps) => import("react/jsx-runtime").JSX.Element;
+/** @deprecated Use `ToggleSwitch` with `label`/`fieldLabel`/`helperText`/`error` — this is a thin wrapper around it. */
+export declare const InputSwitch: ({ switchText, switchTextPosition, id, isChecked, defaultChecked, label, isInformation, informationMessage, isRequired, size, isDisabled, isReadOnly, isInvalid, helperText, errorMessage, name, value, onChange, onFocus, onBlur, colorScheme, variant, spacing, isFocusable, "aria-label": ariaLabel, "aria-describedby": ariaDescribedBy, ...layout }: ThemedSwitchProps) => import("react/jsx-runtime").JSX.Element;

package/dist/Components/Input/Switch/InputSwitch.js

@@ -1,25 +1,24 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.InputSwitch = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const react_1 = require("@chakra-ui/react");
-const FormLabel_1 = require("../../Common/FormLabel");
-const useCustomTheme_1 = require("../../../Theme/useCustomTheme");
-const InputSwitch = ({ switchText, switchTextPosition = "right", id, isChecked, label, isInformation, informationMessage, isRequired, size = "md", ...props }) => {
-    const theme = (0, useCustomTheme_1.useCustomTheme)();
-    // Read the palette directly — it is already swapped for the active mode, so pairing the rungs
-    // through useColorModeValue would adapt twice and pick the wrong rung on the dark canvas.
-    const activeColor = theme.colors.primary[500];
-    const inactiveColor = theme.colors.gray[300];
-    const sizeStyles = {
-        sm: { fontSize: "sm", spacing: 1 },
-        md: { fontSize: "md", spacing: 2 },
-        lg: { fontSize: "lg", spacing: 3 },
-    };
-    return ((0, jsx_runtime_1.jsxs)(react_1.FormControl, { children: [label && ((0, jsx_runtime_1.jsx)(FormLabel_1.TextLabel, { label: label, id: id, isInformation: isInformation, informationMessage: informationMessage, isRequired: isRequired })), (0, jsx_runtime_1.jsx)(react_1.Box, { display: "flex", alignItems: "center", flexGrow: 1, children: (0, jsx_runtime_1.jsxs)(react_1.HStack, { spacing: sizeStyles[size].spacing, children: [switchText && switchTextPosition === "left" && ((0, jsx_runtime_1.jsx)(react_1.FormLabel, { mb: "0", htmlFor: id, fontSize: sizeStyles[size].fontSize, cursor: "pointer", children: switchText })), (0, jsx_runtime_1.jsx)(react_1.Switch, { id: id, size: size, isChecked: isChecked, colorScheme: "blue", sx: {
-                                "span.chakra-switch__track": {
-                                    bg: isChecked ? activeColor : inactiveColor,
-                                },
-                            }, ...props }), switchText && switchTextPosition === "right" && ((0, jsx_runtime_1.jsx)(react_1.FormLabel, { mb: "0", htmlFor: id, fontSize: sizeStyles[size].fontSize, cursor: "pointer", children: switchText }))] }) })] }));
+const ToggleSwitch_1 = __importDefault(require("../../ToggleSwitch/ToggleSwitch"));
+/** @deprecated Use `ToggleSwitch` with `label`/`fieldLabel`/`helperText`/`error` — this is a thin wrapper around it. */
+const InputSwitch = ({ switchText, switchTextPosition = "right", id, isChecked, defaultChecked, label, isInformation, informationMessage, isRequired, size = "md", isDisabled, isReadOnly, isInvalid, helperText, errorMessage, name, value, onChange, onFocus, onBlur, colorScheme, variant, spacing, isFocusable, "aria-label": ariaLabel, "aria-describedby": ariaDescribedBy, ...layout }) => {
+    void variant;
+    void spacing;
+    void isFocusable;
+    // NOTE: unreachable when a real caller names it; matches the pre-existing accessibility gap.
+    const naming = typeof switchText === "string"
+        ? { label: switchText, fieldLabel: label }
+        : typeof ariaLabel === "string"
+            ? { "aria-label": ariaLabel, fieldLabel: label }
+            : { fieldLabel: label };
+    const handleChange = (_checked, event) => onChange === null || onChange === void 0 ? void 0 : onChange(event);
+    return ((0, jsx_runtime_1.jsx)(react_1.Box, { ...layout, children: (0, jsx_runtime_1.jsx)(ToggleSwitch_1.default, { ...naming, id: id, isChecked: isChecked, defaultChecked: defaultChecked, onChange: handleChange, size: size, labelPosition: switchTextPosition === "left" ? "start" : "end", isDisabled: isDisabled, isReadOnly: isReadOnly, isRequired: isRequired, isInformation: isInformation, informationMessage: informationMessage, colorScheme: colorScheme, error: isInvalid, errorMessage: errorMessage, helperText: helperText, name: name, value: value === undefined ? undefined : String(value), onFocus: onFocus, onBlur: onBlur, "aria-describedby": ariaDescribedBy }) }));
 };
 exports.InputSwitch = InputSwitch;

package/dist/Components/Input/TextInput.js

@@ -39,16 +39,90 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const jsx_runtime_1 = require("react/jsx-runtime");
 const react_1 = __importStar(require("react"));
 const react_2 = require("@chakra-ui/react");
+const lucide_react_1 = require("lucide-react");
 const textInputIconSize_1 = require("./textInputIconSize");
+const useAriaRequired_1 = require("./useAriaRequired");
+const TextInput_styles_1 = require("./TextInput.styles");
 const FormLabel_1 = require("../Common/FormLabel");
-const HelperText_1 = __importDefault(require("../Common/HelperText"));
-const ErrorMessage_1 = __importDefault(require("../Common/ErrorMessage"));
+const FieldMessage_1 = __importDefault(require("../Common/FieldMessage"));
+const useFieldIds_1 = require("../Common/useFieldIds");
+const fieldMessageStyles_1 = require("../Common/fieldMessageStyles");
 const useCustomTheme_1 = require("../../Theme/useCustomTheme");
-const TextInput = (0, react_1.forwardRef)(({ label, type = "text", id, name, onChange, onBlur, onFocus, isDisabled = false, isReadOnly = false, isRequired = false, value, placeholder = "Placeholder", width = "100%", height, error, errorMessage, helperText, onRightIconclick, inputRightIcon, inputLeftIcon, onLeftIconClick, inputGroupStyle, inputStyle, size = "md", isInformation = false, informationMessage, leftElementStyle, rightElementStyle, autoComplete, minW, maxW, ...props }, ref) => {
+const focusRing_styles_1 = require("../../Theme/chakra/focusRing.styles");
+const controlSizes_1 = require("../../Theme/tokens/primitives/controlSizes");
+const IconSlot = ({ icon, onClick, ariaLabel, sx, color, isDisabled }) => {
+    const { colors } = (0, useCustomTheme_1.useCustomTheme)();
+    if (!onClick) {
+        return (0, jsx_runtime_1.jsx)(react_2.Box, { as: "span", sx: sx, color: color, "aria-hidden": "true", children: icon });
+    }
+    return ((0, jsx_runtime_1.jsx)(react_2.Box, { as: "button", type: "button", "aria-label": ariaLabel, onClick: onClick, disabled: isDisabled, sx: { ...sx, ...(0, focusRing_styles_1.focusVisibleStyles)(colors) }, color: color, p: 1, borderRadius: "md", cursor: isDisabled ? "not-allowed" : "pointer", children: icon }));
+};
+/** Standard labelled text field — label always bound (auto id), helper/error row, optional left/right icons that become real buttons when clickable. */
+const TextInput = (0, react_1.forwardRef)(({ label, type = "text", id, name, onChange, onBlur, onFocus, isDisabled = false, isReadOnly = false, isRequired = false, value, placeholder, width = "100%", height, error, errorMessage, helperText, variant = "outline", onRightIconClick, onRightIconclick, inputRightIcon, rightIconAriaLabel, inputLeftIcon, onLeftIconClick, leftIconAriaLabel, inputLeftAddon, inputRightAddon, isClearable = false, clearIconAriaLabel, showCharacterCount = false, isLoading = false, isPasswordToggleDisabled = false, inputGroupStyle, inputStyle, size = controlSizes_1.DEFAULT_CONTROL_SIZE, isInformation = false, informationMessage, leftElementStyle, rightElementStyle, autoComplete, minW, maxW, maxLength, ...props }, ref) => {
+    var _a;
     const theme = (0, useCustomTheme_1.useCustomTheme)();
-    const sizeKey = typeof size === "string" ? size : "md";
-    const iconScaleSx = (0, textInputIconSize_1.getTextInputIconWrapperSx)(sizeKey);
-    return ((0, jsx_runtime_1.jsxs)(react_2.FormControl, { w: width, minW: minW, maxW: maxW, children: [label && ((0, jsx_runtime_1.jsx)(FormLabel_1.TextLabel, { label: label, id: id, isInformation: isInformation, informationMessage: informationMessage, isRequired: isRequired })), (0, jsx_runtime_1.jsxs)(react_2.InputGroup, { style: inputGroupStyle, size: size, height: height, children: [inputLeftIcon && ((0, jsx_runtime_1.jsx)(react_2.InputLeftElement, { onClick: onLeftIconClick, pointerEvents: onLeftIconClick ? "auto" : "none", ...leftElementStyle, height: "100%", display: "flex", alignItems: "center", children: (0, jsx_runtime_1.jsx)(react_2.Box, { as: "span", sx: iconScaleSx, color: theme.colors.gray[500], children: inputLeftIcon }) })), (0, jsx_runtime_1.jsx)(react_2.Input, { type: type, placeholder: placeholder, onChange: onChange, onBlur: onBlur, onFocus: onFocus, value: value, isDisabled: isDisabled, isReadOnly: isReadOnly, id: id, name: name, size: size, ...(height != null && { height }), isInvalid: error, ref: ref, autoComplete: autoComplete, ...inputStyle, ...props }), inputRightIcon && ((0, jsx_runtime_1.jsx)(react_2.InputRightElement, { onClick: onRightIconclick, pointerEvents: onRightIconclick ? "auto" : "none", ...rightElementStyle, height: "100%", display: "flex", alignItems: "center", children: (0, jsx_runtime_1.jsx)(react_2.Box, { as: "span", sx: iconScaleSx, children: inputRightIcon }) }))] }), error && (0, jsx_runtime_1.jsx)(ErrorMessage_1.default, { errorMessage: errorMessage }), helperText && !error && (0, jsx_runtime_1.jsx)(HelperText_1.default, { helperText: helperText })] }));
+    const inputRef = (0, react_1.useRef)(null);
+    const [showPassword, setShowPassword] = (0, react_1.useState)(false);
+    // Inside a consumer FormControl: skip our own, inherit its id/invalid/required/disabled.
+    const parentField = (0, react_2.useFormControlContext)();
+    const hasParentFormControl = Boolean(parentField);
+    const fieldId = id !== null && id !== void 0 ? id : parentField === null || parentField === void 0 ? void 0 : parentField.id;
+    const isFieldRequired = isRequired || Boolean(parentField === null || parentField === void 0 ? void 0 : parentField.isRequired);
+    const isFieldDisabled = isDisabled || Boolean(parentField === null || parentField === void 0 ? void 0 : parentField.isDisabled);
+    const isFieldReadOnly = isReadOnly || Boolean(parentField === null || parentField === void 0 ? void 0 : parentField.isReadOnly);
+    const isFieldInvalid = (_a = error !== null && error !== void 0 ? error : parentField === null || parentField === void 0 ? void 0 : parentField.isInvalid) !== null && _a !== void 0 ? _a : false;
+    const ids = (0, useFieldIds_1.useFieldIds)(fieldId, { error: isFieldInvalid, errorMessage, helperText });
+    const mergedRef = (0, react_2.useMergeRefs)(ref, (0, useAriaRequired_1.useAriaRequired)(isFieldRequired), inputRef);
+    const iconScaleSx = (0, textInputIconSize_1.getTextInputIconWrapperSx)(typeof size === "string" ? size : undefined);
+    const iconColor = theme.colors.textMuted;
+    const actionName = (fallback) => (label ? `${label}: ${fallback}` : fallback);
+    const stringValue = typeof value === "string" ? value : undefined;
+    const isPasswordField = type === "password";
+    const effectiveType = isPasswordField && showPassword ? "text" : type;
+    const clearInput = () => {
+        var _a;
+        const node = inputRef.current;
+        if (!node)
+            return;
+        // Native setter + a real "input" event, so React's controlled onChange fires as if typed.
+        const setter = (_a = Object.getOwnPropertyDescriptor(window.HTMLInputElement.prototype, "value")) === null || _a === void 0 ? void 0 : _a.set;
+        setter === null || setter === void 0 ? void 0 : setter.call(node, "");
+        node.dispatchEvent(new Event("input", { bubbles: true }));
+        node.focus();
+    };
+    const showClear = isClearable && !isFieldDisabled && !isFieldReadOnly && Boolean(stringValue);
+    const rightSlots = [];
+    if (inputRightIcon) {
+        rightSlots.push({
+            key: "custom",
+            icon: inputRightIcon,
+            onClick: onRightIconClick !== null && onRightIconClick !== void 0 ? onRightIconClick : onRightIconclick,
+            ariaLabel: rightIconAriaLabel !== null && rightIconAriaLabel !== void 0 ? rightIconAriaLabel : actionName("right icon action"),
+        });
+    }
+    if (isPasswordField && !isPasswordToggleDisabled && !inputRightIcon) {
+        rightSlots.push({
+            key: "password-toggle",
+            icon: showPassword ? (0, jsx_runtime_1.jsx)(lucide_react_1.EyeOff, { size: 16 }) : (0, jsx_runtime_1.jsx)(lucide_react_1.Eye, { size: 16 }),
+            onClick: () => setShowPassword((prev) => !prev),
+            ariaLabel: actionName(showPassword ? "Hide password" : "Show password"),
+        });
+    }
+    if (showClear) {
+        rightSlots.push({
+            key: "clear",
+            icon: (0, jsx_runtime_1.jsx)(lucide_react_1.X, { size: 16 }),
+            onClick: clearInput,
+            ariaLabel: clearIconAriaLabel !== null && clearIconAriaLabel !== void 0 ? clearIconAriaLabel : actionName("Clear"),
+        });
+    }
+    const showCounter = showCharacterCount && typeof maxLength === "number" && stringValue !== undefined;
+    const counterId = showCounter ? `${ids.inputId}-count` : undefined;
+    const { showError, showHelper } = (0, fieldMessageStyles_1.fieldMessageVisibility)({ error: isFieldInvalid, errorMessage, helperText });
+    const showMessageRow = showCounter || showError || showHelper;
+    const describedBy = [ids.describedBy, counterId].filter(Boolean).join(" ") || undefined;
+    const content = ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [label && ((0, jsx_runtime_1.jsx)(FormLabel_1.TextLabel, { label: label, id: ids.inputId, isInformation: isInformation, informationMessage: informationMessage, isRequired: isFieldRequired })), (0, jsx_runtime_1.jsxs)(react_2.InputGroup, { style: inputGroupStyle, size: size, height: height, children: [inputLeftAddon && ((0, jsx_runtime_1.jsx)(react_2.InputLeftAddon, { sx: (0, TextInput_styles_1.fieldAddonSx)(theme.colors), children: inputLeftAddon })), inputLeftIcon && ((0, jsx_runtime_1.jsx)(react_2.InputLeftElement, { pointerEvents: onLeftIconClick ? "auto" : "none", ...leftElementStyle, height: "100%", display: "flex", alignItems: "center", children: (0, jsx_runtime_1.jsx)(IconSlot, { icon: inputLeftIcon, onClick: onLeftIconClick, ariaLabel: leftIconAriaLabel !== null && leftIconAriaLabel !== void 0 ? leftIconAriaLabel : actionName("left icon action"), sx: iconScaleSx, color: iconColor, isDisabled: isFieldDisabled }) })), (0, jsx_runtime_1.jsx)(react_2.Input, { type: effectiveType, placeholder: placeholder, onChange: onChange, onBlur: onBlur, onFocus: onFocus, value: value, isDisabled: isFieldDisabled, isReadOnly: isFieldReadOnly, name: name, size: size, variant: variant, maxLength: maxLength, ...(height != null && { height, minH: height }), isInvalid: isFieldInvalid, ref: mergedRef, autoComplete: autoComplete, "aria-busy": isLoading || undefined, ...ids.controlProps, "aria-describedby": describedBy, ...inputStyle, ...props }), (isLoading || rightSlots.length > 0) && ((0, jsx_runtime_1.jsx)(react_2.InputRightElement, { pointerEvents: !isLoading && rightSlots.some((slot) => slot.onClick) ? "auto" : "none", ...rightElementStyle, height: "100%", display: "flex", alignItems: "center", justifyContent: !isLoading && rightSlots.length > 1 ? "flex-end" : "center", width: !isLoading && rightSlots.length > 1 ? "auto" : undefined, ...(!isLoading && rightSlots.length > 1 ? { pr: 2, gap: 1 } : {}), children: isLoading ? ((0, jsx_runtime_1.jsx)(react_2.Spinner, { size: "xs", color: iconColor })) : (rightSlots.map((slot) => ((0, jsx_runtime_1.jsx)(IconSlot, { icon: slot.icon, onClick: slot.onClick, ariaLabel: slot.ariaLabel, sx: iconScaleSx, color: iconColor, isDisabled: isFieldDisabled }, slot.key)))) })), inputRightAddon && ((0, jsx_runtime_1.jsx)(react_2.InputRightAddon, { sx: (0, TextInput_styles_1.fieldAddonSx)(theme.colors), children: inputRightAddon }))] }), showMessageRow && ((0, jsx_runtime_1.jsxs)(react_2.Flex, { justify: "space-between", align: "flex-start", gap: 2, children: [(0, jsx_runtime_1.jsx)(FieldMessage_1.default, { error: isFieldInvalid, errorMessage: errorMessage, helperText: helperText, helperId: ids.helperId, errorId: ids.errorId }), showCounter && stringValue !== undefined && ((0, jsx_runtime_1.jsxs)(react_2.Text, { id: counterId, flexShrink: 0, ...(0, fieldMessageStyles_1.fieldMessageStyles)(theme.colors), color: isFieldInvalid ? theme.colors.semanticText.error : theme.colors.textMuted, children: [stringValue.length, "/", maxLength] }))] }))] }));
+    return hasParentFormControl ? ((0, jsx_runtime_1.jsx)(react_2.Box, { w: width, minW: minW, maxW: maxW, children: content })) : ((0, jsx_runtime_1.jsx)(react_2.FormControl, { w: width, minW: minW, maxW: maxW, children: content }));
 });
 TextInput.displayName = "TextInput";
 exports.default = react_1.default.memo(TextInput);

package/dist/Components/Input/TextInput.styles.d.ts

@@ -1,2 +1,19 @@
-import { ComponentStyleConfig } from "@chakra-ui/react";
+import type { ComponentStyleConfig, SystemStyleObject } from "@chakra-ui/react";
+import type { PaletteProps } from "../../Theme/tokens/types";
+/** Field look shared by Input, Textarea and NumberInput; `_invalid` also clears Chakra's stock invalid shadow. */
+export declare const fieldPartStyles: (colors: PaletteProps) => SystemStyleObject;
+export declare const fieldFilledStyles: (colors: PaletteProps) => SystemStyleObject;
+export declare const fieldFlushedStyles: (colors: PaletteProps) => SystemStyleObject;
+/** Look for `InputLeftAddon`/`InputRightAddon` — Chakra ships no token-aware default for these parts. */
+export declare const fieldAddonSx: (colors: PaletteProps) => SystemStyleObject;
+export declare const fieldSizes: <Part extends string>(part: Part) => {
+    [k: string]: {
+        [x: string]: {
+            h: string;
+            minH: string;
+            fontSize: string;
+            px: string;
+        };
+    };
+};
 export declare const Input: ComponentStyleConfig;