@allxsmith/bestax-bulma 5.27.0 → 5.27.2

package/dist/esm/form/Switch.js

@@ -0,0 +1,96 @@
+/* @allxsmith/bestax-bulma — AI agents: see AGENTS.md in the package root, or https://bestax.io/llms.txt */
+import { jsxs, jsx } from 'react/jsx-runtime';
+import { forwardRef } from 'react';
+import { usePrefixedClassNames, classNames } from '../helpers/classNames.js';
+import { useBulmaClasses } from '../helpers/useBulmaClasses.js';
+
+/**
+ * The values the Switch `color` and `passiveType` props accept, as a readonly
+ * tuple.
+ *
+ * Both props are typed from it, so they list the same values. Map over it to
+ * build a color picker, or check a value that arrives at runtime before
+ * passing it in: the component adds no class for a value outside the tuple.
+ *
+ * @example
+ * import { Switch, switchColors } from '@allxsmith/bestax-bulma';
+ *
+ * switchColors.map(color => (
+ *   <Switch key={color} color={color} defaultChecked>
+ *     {color}
+ *   </Switch>
+ * ));
+ */
+const switchColors = [
+    'primary',
+    'link',
+    'info',
+    'success',
+    'warning',
+    'danger',
+];
+/**
+ * The values the Switch `size` prop accepts, as a readonly tuple.
+ *
+ * `SwitchProps['size']` is typed from it, so the two list the same values. Use
+ * it to offer a size choice or to check a value that arrives at runtime: the
+ * component adds no size class for a value outside the tuple. These are
+ * element sizes, not the spacing scale in `validSizes`.
+ *
+ * @example
+ * import { switchSizes } from '@allxsmith/bestax-bulma';
+ *
+ * type SwitchSize = (typeof switchSizes)[number];
+ */
+const switchSizes = ['small', 'normal', 'medium', 'large'];
+/**
+ * The `Switch` component provides a toggle switch for boolean on/off states.
+ *
+ * @function
+ * @param {SwitchProps} props - Props for the Switch component.
+ * @returns {JSX.Element} The rendered switch element.
+ *
+ * @example
+ * // Basic switch
+ * <Switch>Enable notifications</Switch>
+ *
+ * @example
+ * // Colored and rounded switch
+ * <Switch color="success" isRounded checked>
+ *   Active
+ * </Switch>
+ *
+ * @example
+ * // Controlled switch
+ * <Switch
+ *   checked={isEnabled}
+ *   onChange={(e) => setIsEnabled(e.target.checked)}
+ * >
+ *   Feature enabled
+ * </Switch>
+ */
+const Switch = forwardRef(({ color, size, isRounded, isThin, isOutlined, isRtl, passiveType, className, children, textColor, disabled, ...props }, ref) => {
+    const { bulmaHelperClasses, rest } = useBulmaClasses({
+        color: textColor,
+        ...props,
+    });
+    // Generate Bulma classes with prefix
+    const switchClasses = usePrefixedClassNames('switch', {
+        [`is-${color}`]: color && switchColors.includes(color),
+        [`is-${size}`]: size && switchSizes.includes(size),
+        'is-rounded': isRounded,
+        'is-thin': isThin,
+        'is-outlined': isOutlined,
+        'is-rtl': isRtl,
+        [`is-${passiveType}-passive`]: passiveType && switchColors.includes(passiveType),
+    });
+    // Combine prefixed Bulma classes with unprefixed user className and helper classes
+    const labelClasses = classNames(switchClasses, bulmaHelperClasses, className);
+    const checkClass = usePrefixedClassNames('check');
+    const controlLabelClass = usePrefixedClassNames('control-label');
+    return (jsxs("label", { className: labelClasses, children: [jsx("input", { ref: ref, type: "checkbox", disabled: disabled, ...rest }), jsx("span", { className: checkClass }), children && jsx("span", { className: controlLabelClass, children: children })] }));
+});
+Switch.displayName = 'Switch';
+
+export { Switch, switchColors, switchSizes };
+//# sourceMappingURL=Switch.js.map

package/dist/esm/form/Switch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Switch.js","sources":["../../../src/form/Switch.tsx"],"sourcesContent":["import React, { forwardRef } from 'react';\nimport { classNames, usePrefixedClassNames } from '../helpers/classNames';\nimport {\n  useBulmaClasses,\n  BulmaClassesProps,\n  validColors,\n} from '../helpers/useBulmaClasses';\n\n/**\n * The values the Switch `color` and `passiveType` props accept, as a readonly\n * tuple.\n *\n * Both props are typed from it, so they list the same values. Map over it to\n * build a color picker, or check a value that arrives at runtime before\n * passing it in: the component adds no class for a value outside the tuple.\n *\n * @example\n * import { Switch, switchColors } from '@allxsmith/bestax-bulma';\n *\n * switchColors.map(color => (\n *   <Switch key={color} color={color} defaultChecked>\n *     {color}\n *   </Switch>\n * ));\n */\nexport const switchColors = [\n  'primary',\n  'link',\n  'info',\n  'success',\n  'warning',\n  'danger',\n] as const;\n\n/**\n * The values the Switch `size` prop accepts, as a readonly tuple.\n *\n * `SwitchProps['size']` is typed from it, so the two list the same values. Use\n * it to offer a size choice or to check a value that arrives at runtime: the\n * component adds no size class for a value outside the tuple. These are\n * element sizes, not the spacing scale in `validSizes`.\n *\n * @example\n * import { switchSizes } from '@allxsmith/bestax-bulma';\n *\n * type SwitchSize = (typeof switchSizes)[number];\n */\nexport const switchSizes = ['small', 'normal', 'medium', 'large'] as const;\n\n/**\n * Props for the Switch component.\n * @extraProp {boolean} [checked] - Controlled checked state.\n * @extraProp {boolean} [defaultChecked=false] - Default checked state for uncontrolled usage.\n * @extraProp {boolean} [disabled=false] - Whether the switch is disabled.\n * @extraProp {string} [className] - Additional CSS classes.\n * @extraProp {(event: React.ChangeEvent<HTMLInputElement>) => void} [onChange] - Callback when switch state changes.\n * @extraProp {React.Ref<HTMLInputElement>} [ref] - Ref forwarded to the input element.\n */\nexport interface SwitchProps\n  extends\n    Omit<\n      React.InputHTMLAttributes<HTMLInputElement>,\n      'size' | 'type' | 'color'\n    >,\n    Omit<BulmaClassesProps, 'color' | 'backgroundColor' | 'size'> {\n  /** Color variant for the switch. */\n  color?: (typeof switchColors)[number];\n  /** Size of the switch. */\n  size?: (typeof switchSizes)[number];\n  /** Use rounded switch style. */\n  isRounded?: boolean;\n  /** Use thin switch style. */\n  isThin?: boolean;\n  /** Use outlined switch style. */\n  isOutlined?: boolean;\n  /** Right-to-left layout (label on left). */\n  isRtl?: boolean;\n  /** Color when the switch is in the off/passive state. */\n  passiveType?: (typeof switchColors)[number];\n  /** Text color helper. */\n  textColor?: (typeof validColors)[number] | 'inherit' | 'current';\n  /** Label content for the switch. */\n  children?: React.ReactNode;\n}\n\n/**\n * The `Switch` component provides a toggle switch for boolean on/off states.\n *\n * @function\n * @param {SwitchProps} props - Props for the Switch component.\n * @returns {JSX.Element} The rendered switch element.\n *\n * @example\n * // Basic switch\n * <Switch>Enable notifications</Switch>\n *\n * @example\n * // Colored and rounded switch\n * <Switch color=\"success\" isRounded checked>\n *   Active\n * </Switch>\n *\n * @example\n * // Controlled switch\n * <Switch\n *   checked={isEnabled}\n *   onChange={(e) => setIsEnabled(e.target.checked)}\n * >\n *   Feature enabled\n * </Switch>\n */\nexport const Switch = forwardRef<HTMLInputElement, SwitchProps>(\n  (\n    {\n      color,\n      size,\n      isRounded,\n      isThin,\n      isOutlined,\n      isRtl,\n      passiveType,\n      className,\n      children,\n      textColor,\n      disabled,\n      ...props\n    },\n    ref\n  ) => {\n    const { bulmaHelperClasses, rest } = useBulmaClasses({\n      color: textColor,\n      ...props,\n    });\n\n    // Generate Bulma classes with prefix\n    const switchClasses = usePrefixedClassNames('switch', {\n      [`is-${color}`]: color && switchColors.includes(color),\n      [`is-${size}`]: size && switchSizes.includes(size),\n      'is-rounded': isRounded,\n      'is-thin': isThin,\n      'is-outlined': isOutlined,\n      'is-rtl': isRtl,\n      [`is-${passiveType}-passive`]:\n        passiveType && switchColors.includes(passiveType),\n    });\n\n    // Combine prefixed Bulma classes with unprefixed user className and helper classes\n    const labelClasses = classNames(\n      switchClasses,\n      bulmaHelperClasses,\n      className\n    );\n    const checkClass = usePrefixedClassNames('check');\n    const controlLabelClass = usePrefixedClassNames('control-label');\n\n    return (\n      <label className={labelClasses}>\n        <input ref={ref} type=\"checkbox\" disabled={disabled} {...rest} />\n        <span className={checkClass} />\n        {children && <span className={controlLabelClass}>{children}</span>}\n      </label>\n    );\n  }\n);\n\nSwitch.displayName = 'Switch';\n\nexport default Switch;\n"],"names":["_jsxs","_jsx"],"mappings":";;;;;;AAQA;;;;;;;;;;;;;;;;AAgBG;AACI,MAAM,YAAY,GAAG;IAC1B,SAAS;IACT,MAAM;IACN,MAAM;IACN,SAAS;IACT,SAAS;IACT,QAAQ;;AAGV;;;;;;;;;;;;AAYG;AACI,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO;AAsChE;;;;;;;;;;;;;;;;;;;;;;;;;AAyBG;AACI,MAAM,MAAM,GAAG,UAAU,CAC9B,CACE,EACE,KAAK,EACL,IAAI,EACJ,SAAS,EACT,MAAM,EACN,UAAU,EACV,KAAK,EACL,WAAW,EACX,SAAS,EACT,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,GAAG,KAAK,EACT,EACD,GAAG,KACD;AACF,IAAA,MAAM,EAAE,kBAAkB,EAAE,IAAI,EAAE,GAAG,eAAe,CAAC;AACnD,QAAA,KAAK,EAAE,SAAS;AAChB,QAAA,GAAG,KAAK;AACT,KAAA,CAAC;;AAGF,IAAA,MAAM,aAAa,GAAG,qBAAqB,CAAC,QAAQ,EAAE;AACpD,QAAA,CAAC,CAAA,GAAA,EAAM,KAAK,CAAA,CAAE,GAAG,KAAK,IAAI,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC;AACtD,QAAA,CAAC,CAAA,GAAA,EAAM,IAAI,CAAA,CAAE,GAAG,IAAI,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC;AAClD,QAAA,YAAY,EAAE,SAAS;AACvB,QAAA,SAAS,EAAE,MAAM;AACjB,QAAA,aAAa,EAAE,UAAU;AACzB,QAAA,QAAQ,EAAE,KAAK;AACf,QAAA,CAAC,CAAA,GAAA,EAAM,WAAW,CAAA,QAAA,CAAU,GAC1B,WAAW,IAAI,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC;AACpD,KAAA,CAAC;;IAGF,MAAM,YAAY,GAAG,UAAU,CAC7B,aAAa,EACb,kBAAkB,EAClB,SAAS,CACV;AACD,IAAA,MAAM,UAAU,GAAG,qBAAqB,CAAC,OAAO,CAAC;AACjD,IAAA,MAAM,iBAAiB,GAAG,qBAAqB,CAAC,eAAe,CAAC;AAEhE,IAAA,QACEA,IAAA,CAAA,OAAA,EAAA,EAAO,SAAS,EAAE,YAAY,aAC5BC,GAAA,CAAA,OAAA,EAAA,EAAO,GAAG,EAAE,GAAG,EAAE,IAAI,EAAC,UAAU,EAAC,QAAQ,EAAE,QAAQ,EAAA,GAAM,IAAI,EAAA,CAAI,EACjEA,GAAA,CAAA,MAAA,EAAA,EAAM,SAAS,EAAE,UAAU,EAAA,CAAI,EAC9B,QAAQ,IAAIA,GAAA,CAAA,MAAA,EAAA,EAAM,SAAS,EAAE,iBAAiB,EAAA,QAAA,EAAG,QAAQ,EAAA,CAAQ,CAAA,EAAA,CAC5D;AAEZ,CAAC;AAGH,MAAM,CAAC,WAAW,GAAG,QAAQ;;"}

package/dist/esm/form/Taginput.js

@@ -0,0 +1,351 @@
+/* @allxsmith/bestax-bulma — AI agents: see AGENTS.md in the package root, or https://bestax.io/llms.txt */
+import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
+import { forwardRef, useRef, useState, useEffect, useCallback } from 'react';
+import { classNames, usePrefixedClassNames, prefixedClassNames } from '../helpers/classNames.js';
+import { useConfig, useIconLibrary } from '../helpers/Config.js';
+import { useBulmaClasses } from '../helpers/useBulmaClasses.js';
+import { isEventInside } from '../helpers/shadowDom.js';
+import { useInsideField, useInsideControl, rendersOwnField } from './FormContext.js';
+import { Field } from './Field.js';
+import { useAutoLabelId } from './useAutoLabelId.js';
+import { Icon } from '../elements/Icon.js';
+
+/**
+ * The `Taginput` component provides a tag/chip input field for managing multiple tags.
+ *
+ * @function
+ * @param {TaginputProps} props - Props for the Taginput component.
+ * @param {React.Ref<HTMLInputElement>} ref - Forwarded ref to the input element.
+ * @returns {JSX.Element} The rendered taginput component.
+ *
+ * @example
+ * // Basic usage
+ * <Taginput
+ *   placeholder="Add a tag..."
+ *   onChange={(tags) => console.log(tags)}
+ * />
+ *
+ * @example
+ * // With autocomplete
+ * <Taginput
+ *   data={['React', 'Vue', 'Angular', 'Svelte']}
+ *   allowNew={false}
+ *   placeholder="Select frameworks..."
+ * />
+ */
+const Taginput = forwardRef(({ 
+// Field props
+label, labelSize, labelProps, horizontal, message, messageColor, fieldClassName, value: controlledValue, defaultValue = [], data = [], placeholder, field = 'label', allowNew = true, allowDuplicates = false, openOnFocus = false, removeOnKeys = true, confirmKeys = ['Enter', ','], closable = true, attached = false, maxTags, maxlength, disabled = false, readonly = false, rounded = false, ellipsis = false, hasCounter = true, onPasteSeparators = [','], beforeAdding, createTag, keepFirst = false, keepOpen = true, loading = false, ariaCloseLabel, icon, iconLibrary: iconLibraryProp, iconVariant, iconFeatures, color, tagColor, size, onChange, onAdd, onRemove, onTyping, tagTemplate, name, form, id, className, ...props }, ref) => {
+    const insideField = useInsideField();
+    const insideControl = useInsideControl();
+    const ownField = rendersOwnField('Taginput', {
+        insideField,
+        insideControl,
+        label,
+        message,
+        horizontal,
+        fieldClassName,
+    });
+    const { bulmaHelperClasses, rest } = useBulmaClasses(props);
+    const { classPrefix } = useConfig();
+    const defaultIconLibrary = useIconLibrary();
+    const resolvedLibrary = iconLibraryProp || defaultIconLibrary || 'fa';
+    const pcn = (...args) => prefixedClassNames(classPrefix, ...args);
+    const containerRef = useRef(null);
+    const inputRef = useRef(null);
+    const dropdownRef = useRef(null);
+    const [internalTags, setInternalTags] = useState(defaultValue);
+    const [inputValue, setInputValue] = useState('');
+    const [isActive, setIsActive] = useState(false);
+    const [highlightedIndex, setHighlightedIndex] = useState(-1);
+    // Use controlled or internal tags
+    const tags = controlledValue !== undefined ? controlledValue : internalTags;
+    const isMaxReached = maxTags !== undefined && tags.length >= maxTags;
+    // At the tag limit the text input is not rendered, so there is nothing to
+    // wire a label to, its own or a surrounding Field's.
+    const { controlId, fieldLabelProps, labelled } = useAutoLabelId({
+        label,
+        id,
+        labelProps,
+        rendersLabel: ownField && !isMaxReached,
+        hasInput: !isMaxReached,
+    });
+    // Get display value from tag
+    const getDisplayValue = (tag) => {
+        if (typeof tag === 'string')
+            return tag;
+        const fieldValue = tag[field];
+        if (typeof fieldValue === 'string')
+            return fieldValue;
+        return tag.value || '';
+    };
+    // Filter autocomplete data
+    const filteredData = data.filter(item => {
+        const displayValue = item.toLowerCase();
+        const matchesInput = displayValue.includes(inputValue.toLowerCase());
+        const notAlreadyAdded = allowDuplicates ||
+            !tags.some(tag => getDisplayValue(tag).toLowerCase() === displayValue);
+        const hasInput = inputValue || (openOnFocus && isActive);
+        return matchesInput && notAlreadyAdded && hasInput;
+    });
+    // keepFirst: auto-highlight first item when dropdown opens
+    useEffect(() => {
+        if (keepFirst && isActive && filteredData.length > 0) {
+            setHighlightedIndex(0);
+        }
+    }, [keepFirst, isActive, filteredData.length]);
+    // Update tags
+    const updateTags = useCallback((newTags) => {
+        if (controlledValue === undefined) {
+            setInternalTags(newTags);
+        }
+        onChange?.(newTags);
+    }, [controlledValue, onChange]);
+    // Add tag
+    const addTag = useCallback((value) => {
+        if (disabled || readonly)
+            return;
+        const tagValue = typeof value === 'string' ? value.trim() : value;
+        const displayValue = typeof tagValue === 'string' ? tagValue : getDisplayValue(tagValue);
+        if (!displayValue)
+            return;
+        // Check max tags
+        if (maxTags && tags.length >= maxTags)
+            return;
+        // Check duplicates
+        if (!allowDuplicates) {
+            const exists = tags.some(tag => getDisplayValue(tag).toLowerCase() === displayValue.toLowerCase());
+            if (exists)
+                return;
+        }
+        // Check if allowed (must be in data if allowNew is false). Compare
+        // case-insensitively, consistent with the dropdown filter and the
+        // duplicate check above.
+        if (!allowNew &&
+            !data.some(d => d.toLowerCase() === displayValue.toLowerCase()))
+            return;
+        // beforeAdding validation
+        if (beforeAdding && !beforeAdding(displayValue))
+            return;
+        // createTag transformation
+        const finalTag = createTag ? createTag(displayValue) : tagValue;
+        const newTags = [...tags, finalTag];
+        updateTags(newTags);
+        onAdd?.(finalTag);
+        setInputValue('');
+        if (!keepOpen) {
+            setIsActive(false);
+        }
+        setHighlightedIndex(-1);
+    }, [
+        disabled,
+        readonly,
+        tags,
+        maxTags,
+        allowDuplicates,
+        allowNew,
+        data,
+        field,
+        updateTags,
+        onAdd,
+        beforeAdding,
+        createTag,
+        keepOpen,
+    ]);
+    // Remove tag
+    const removeTag = useCallback((index) => {
+        /* istanbul ignore next: both triggers (delete button click, Backspace handler) are already gated on disabled/readonly */
+        if (disabled || readonly)
+            return;
+        const removedTag = tags[index];
+        const newTags = tags.filter((_, i) => i !== index);
+        updateTags(newTags);
+        onRemove?.(removedTag, index);
+    }, [disabled, readonly, tags, updateTags, onRemove]);
+    // Handle input change
+    const handleInputChange = useCallback((e) => {
+        const newValue = e.target.value;
+        // Check if a confirm key was typed
+        const lastChar = newValue.slice(-1);
+        if (confirmKeys.includes(lastChar) && lastChar !== 'Enter') {
+            const valueWithoutKey = newValue.slice(0, -1).trim();
+            if (valueWithoutKey) {
+                addTag(valueWithoutKey);
+            }
+            return;
+        }
+        setInputValue(newValue);
+        onTyping?.(newValue);
+        if (newValue && data.length > 0) {
+            setIsActive(true);
+        }
+    }, [confirmKeys, addTag, onTyping, data.length]);
+    // Handle paste
+    const handlePaste = useCallback((e) => {
+        if (onPasteSeparators.length === 0)
+            return;
+        const pastedText = e.clipboardData.getData('text');
+        // Check if any separator exists in the pasted text
+        const hasSeparator = onPasteSeparators.some(sep => pastedText.includes(sep));
+        if (!hasSeparator)
+            return;
+        e.preventDefault();
+        // Build a regex from all separators
+        const escapedSeparators = onPasteSeparators.map(s => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'));
+        const regex = new RegExp(`[${escapedSeparators.join('')}]`);
+        const parts = pastedText
+            .split(regex)
+            .map(s => s.trim())
+            .filter(Boolean);
+        for (const part of parts) {
+            addTag(part);
+        }
+    }, [onPasteSeparators, addTag]);
+    // Handle focus
+    const handleFocus = useCallback(() => {
+        if (openOnFocus && data.length > 0 && !disabled) {
+            setIsActive(true);
+        }
+    }, [openOnFocus, data.length, disabled]);
+    // Handle click outside
+    useEffect(() => {
+        if (!isActive)
+            return undefined;
+        const handleClickOutside = (e) => {
+            if (containerRef.current && !isEventInside(e, containerRef.current)) {
+                setIsActive(false);
+                setHighlightedIndex(-1);
+            }
+        };
+        document.addEventListener('mousedown', handleClickOutside);
+        return () => document.removeEventListener('mousedown', handleClickOutside);
+    }, [isActive]);
+    // Handle keyboard
+    const handleKeyDown = useCallback((e) => {
+        if (disabled || readonly)
+            return;
+        // Handle confirm keys
+        if (confirmKeys.includes(e.key)) {
+            e.preventDefault();
+            if (highlightedIndex >= 0 && filteredData[highlightedIndex]) {
+                addTag(filteredData[highlightedIndex]);
+            }
+            else if (inputValue.trim()) {
+                addTag(inputValue);
+            }
+            return;
+        }
+        switch (e.key) {
+            case 'ArrowDown':
+                e.preventDefault();
+                if (!isActive && data.length > 0) {
+                    setIsActive(true);
+                }
+                else {
+                    setHighlightedIndex(prev => prev < filteredData.length - 1 ? prev + 1 : prev);
+                }
+                break;
+            case 'ArrowUp':
+                e.preventDefault();
+                setHighlightedIndex(prev => (prev > 0 ? prev - 1 : prev));
+                break;
+            case 'Backspace':
+                if (removeOnKeys && !inputValue && tags.length > 0) {
+                    e.preventDefault();
+                    removeTag(tags.length - 1);
+                }
+                break;
+            case 'Escape':
+                setIsActive(false);
+                setHighlightedIndex(-1);
+                break;
+        }
+    }, [
+        disabled,
+        readonly,
+        confirmKeys,
+        highlightedIndex,
+        filteredData,
+        addTag,
+        inputValue,
+        isActive,
+        data.length,
+        removeOnKeys,
+        tags.length,
+        removeTag,
+    ]);
+    // Combined ref
+    const combinedRef = useCallback((node) => {
+        inputRef.current =
+            node;
+        if (typeof ref === 'function') {
+            ref(node);
+        }
+        else if (ref) {
+            ref.current =
+                node;
+        }
+    }, [ref]);
+    // Focus input when container is clicked
+    const handleContainerClick = useCallback(() => {
+        inputRef.current?.focus();
+    }, []);
+    // Generate classes
+    const taginputClasses = pcn('taginput', {
+        'is-active': isActive,
+        [`is-${size}`]: !!size,
+        [`is-${color}`]: !!color,
+        'is-disabled': disabled,
+        'is-rounded': rounded,
+        'is-ellipsis': ellipsis,
+    });
+    const containerClasses = pcn('taginput-container', {
+        'is-attached': attached,
+        'has-icons-left': !!icon,
+    });
+    const inputClasses = pcn('input', {
+        [`is-${size}`]: !!size,
+    });
+    const tagClasses = pcn('tag', {
+        [`is-${tagColor}`]: !!tagColor,
+        [`is-${size}`]: !!size,
+    });
+    const combinedClasses = classNames(taginputClasses, bulmaHelperClasses, className);
+    // Counter text
+    const showCounter = hasCounter && (maxTags !== undefined || maxlength !== undefined);
+    const counterText = maxTags !== undefined
+        ? `${tags.length} / ${maxTags}`
+        : maxlength !== undefined
+            ? `${inputValue.length} / ${maxlength}`
+            : '';
+    const counterClasses = pcn('help', 'counter');
+    const tagsClasses = pcn('tags');
+    const dropdownMenuClasses = pcn('dropdown-menu', 'is-active');
+    const dropdownContentClasses = pcn('dropdown-content');
+    const iconRightClass = pcn('icon', 'is-right');
+    const loaderClass = pcn('loader', 'is-loading');
+    const helpClass = usePrefixedClassNames('help', {
+        [`is-${messageColor}`]: !!messageColor,
+    });
+    const messageEl = message ? jsx("p", { className: helpClass, children: message }) : null;
+    const taginputElement = (jsxs("div", { ref: containerRef, className: combinedClasses, onClick: handleContainerClick, ...rest, children: [jsxs("div", { className: containerClasses, children: [icon && (jsx(Icon, { name: icon, library: resolvedLibrary, variant: iconVariant, features: iconFeatures, containerClassName: pcn('icon', 'is-left') })), jsxs("div", { className: tagsClasses, children: [tags.map((tag, index) => {
+                                const displayVal = getDisplayValue(tag);
+                                return (jsxs("span", { className: tagClasses, children: [tagTemplate ? (tagTemplate(tag)) : ellipsis ? (jsx("span", { title: displayVal, children: displayVal })) : (displayVal), closable && !disabled && !readonly && (jsx("button", { type: "button", className: pcn('delete', 'is-small'), onClick: e => {
+                                                e.stopPropagation();
+                                                removeTag(index);
+                                            }, "aria-label": ariaCloseLabel || `Remove ${displayVal}` }))] }, index));
+                            }), !isMaxReached && (jsx("input", { ref: combinedRef, type: "text", className: inputClasses, id: controlId, value: inputValue, placeholder: tags.length === 0 ? placeholder : undefined, disabled: disabled, readOnly: readonly, maxLength: maxlength, onChange: handleInputChange, onFocus: handleFocus, onKeyDown: handleKeyDown, onPaste: handlePaste, "aria-label": labelled ? undefined : 'Add tag' }))] }), loading && (jsx("span", { className: iconRightClass, children: jsx("span", { className: loaderClass }) }))] }), isActive && filteredData.length > 0 && (jsx("div", { className: dropdownMenuClasses, children: jsx("div", { ref: dropdownRef, className: dropdownContentClasses, role: "listbox", children: filteredData.map((item, index) => (jsx("a", { className: pcn('dropdown-item', {
+                            'is-active': index === highlightedIndex,
+                        }), onClick: () => addTag(item), onMouseEnter: () => setHighlightedIndex(index), role: "option", "aria-selected": index === highlightedIndex, children: item }, index))) }) })), showCounter && jsx("small", { className: counterClasses, children: counterText }), name &&
+                tags.map((tag, i) => (jsx("input", { type: "hidden", name: name, value: getDisplayValue(tag), form: form }, `tag-input-${i}`)))] }));
+    if (ownField) {
+        return (jsxs(Field, { label: label, labelSize: labelSize, labelProps: fieldLabelProps, horizontal: horizontal, className: fieldClassName, children: [taginputElement, messageEl] }));
+    }
+    return (jsxs(Fragment, { children: [taginputElement, messageEl] }));
+});
+Taginput.displayName = 'Taginput';
+/** @deprecated Use `Taginput` — same component. */
+const TagInput = Taginput;
+
+export { TagInput, Taginput };
+//# sourceMappingURL=Taginput.js.map

package/dist/esm/form/Taginput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Taginput.js","sources":["../../../src/form/Taginput.tsx"],"sourcesContent":["import React, {\n  forwardRef,\n  useState,\n  useRef,\n  useEffect,\n  useCallback,\n} from 'react';\nimport {\n  classNames,\n  usePrefixedClassNames,\n  prefixedClassNames,\n} from '../helpers/classNames';\nimport { useConfig, useIconLibrary } from '../helpers/Config';\nimport { useBulmaClasses, BulmaClassesProps } from '../helpers/useBulmaClasses';\nimport { isEventInside } from '../helpers/shadowDom';\nimport {\n  useInsideField,\n  useInsideControl,\n  rendersOwnField,\n} from './FormContext';\nimport { Field } from './Field';\nimport { FormFieldProps } from './fieldProps';\nimport { useAutoLabelId } from './useAutoLabelId';\nimport { Icon } from '../elements/Icon';\n\n/**\n * Represents a tag item object with a value and optional label.\n */\nexport interface TaginputItem {\n  /** The tag value. */\n  value: string;\n  /** Display label (optional). */\n  label?: string;\n  [key: string]: unknown;\n}\n\n/** A tag can be either a TaginputItem object or a plain string. */\nexport type TaginputTag = TaginputItem | string;\n\ntype IconLibrary = 'fa' | 'mdi' | 'ion' | 'material-icons' | 'material-symbols';\n\n/**\n * Props for the Taginput component.\n * Inside an outer `Field`, or a `Control` with no `Field` around it, it\n * renders no `Field` of its own. The exception is `label`, `message`,\n * `horizontal` or `fieldClassName` in that bare `Control`: it keeps a `Field`\n * for them, nested in the `.control`, and warns in development. Wrap the\n * `Control` in a `Field` instead, and set the `label`, `horizontal` and class\n * name on that `Field`.\n * @extraProp {string} [className] - Additional CSS classes.\n * @extraProp {React.Ref<HTMLInputElement>} [ref] - Ref forwarded to the input element.\n */\nexport interface TaginputProps\n  extends\n    Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue'>,\n    Omit<BulmaClassesProps, 'color'>,\n    FormFieldProps {\n  /** Field label. Automatically associated with the text input via `htmlFor` — uses your `id` when provided, otherwise a generated one. Not wired when the tag limit is reached (the input is not rendered). Dropped inside an outer `Field`, whose own label associates instead when that `Field` generates a target id (not `grouped`/`hasAddons`, no explicit `labelProps.htmlFor`); it then replaces the `aria-label=\"Add tag\"` fallback too. */\n  label?: React.ReactNode;\n  /** Props for the label element. An explicit `htmlFor` here overrides the automatic association (no id is generated then). */\n  labelProps?: React.LabelHTMLAttributes<HTMLLabelElement> & {\n    [key: string]: unknown;\n  };\n  /** Applied to the inner text input (the labellable control), not the wrapper div. */\n  id?: string;\n  /** The current tags (controlled). */\n  value?: TaginputTag[];\n  /** Default tags (uncontrolled). */\n  defaultValue?: TaginputTag[];\n  /** Autocomplete suggestions. */\n  data?: string[];\n  /** Placeholder text when no tags. */\n  placeholder?: string;\n  /** Object property to use as display field. */\n  field?: string;\n  /** Allow creating new tags not in suggestions. */\n  allowNew?: boolean;\n  /** Allow duplicate tags. */\n  allowDuplicates?: boolean;\n  /** Open autocomplete dropdown on focus. */\n  openOnFocus?: boolean;\n  /** Remove tag on backspace. Default: true. */\n  removeOnKeys?: boolean;\n  /** Keys to confirm tag creation. Default: ['Enter', ',']. */\n  confirmKeys?: string[];\n  /** Show close button on tags. Default: true. */\n  closable?: boolean;\n  /** Attach tags visually. */\n  attached?: boolean;\n  /** Maximum number of tags allowed. */\n  maxTags?: number;\n  /** Maximum length of input. */\n  maxlength?: number;\n  /** Whether the input is disabled. */\n  disabled?: boolean;\n  /** Whether the input is read-only. */\n  readonly?: boolean;\n  /** Applies rounded corners to the tags. */\n  rounded?: boolean;\n  /** Truncates long tag text with ellipsis. */\n  ellipsis?: boolean;\n  /** Shows a counter of the number of tags. */\n  hasCounter?: boolean;\n  /** Characters that split pasted text into tags. */\n  onPasteSeparators?: string[];\n  /** Validation function called before adding a tag. */\n  beforeAdding?: (tag: string) => boolean;\n  /** Custom function for creating tag objects from input. */\n  createTag?: (input: string) => TaginputTag;\n  /** Keeps the first autocomplete suggestion highlighted. */\n  keepFirst?: boolean;\n  /** Keeps the autocomplete dropdown open after selection. */\n  keepOpen?: boolean;\n  /**\n   * Shows a loading spinner in the input.\n   * Under `prefers-reduced-motion: reduce` the spinner stops and stays\n   * drawn (with bestax's CSS loaded).\n   */\n  loading?: boolean;\n  /** ARIA label for tag close buttons. */\n  ariaCloseLabel?: string;\n  /** Icon name for the input field. */\n  icon?: string;\n  /** Icon library to use. */\n  iconLibrary?: IconLibrary;\n  /** Icon style variant (e.g., 'solid', 'outlined'). */\n  iconVariant?: string;\n  /** Additional icon modifiers. */\n  iconFeatures?: string | string[];\n  /** Input color variant. */\n  color?: 'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger';\n  /** Tag color variant. */\n  tagColor?:\n    | 'primary'\n    | 'link'\n    | 'info'\n    | 'success'\n    | 'warning'\n    | 'danger'\n    | 'dark'\n    | 'light';\n  /** Size variant. */\n  size?: 'small' | 'medium' | 'large';\n  /** Form field name. When set, one hidden input per tag is rendered. */\n  name?: string;\n  /** Optional id of the form the hidden inputs belong to. */\n  form?: string;\n  /** Callback when tags change. */\n  onChange?: (tags: TaginputTag[]) => void;\n  /** Callback when tag is added. */\n  onAdd?: (tag: TaginputTag) => void;\n  /** Callback when tag is removed. */\n  onRemove?: (tag: TaginputTag, index: number) => void;\n  /** Callback when typing in input. */\n  onTyping?: (value: string) => void;\n  /** Custom render for tags. */\n  tagTemplate?: (tag: TaginputTag) => React.ReactNode;\n}\n\n/**\n * The `Taginput` component provides a tag/chip input field for managing multiple tags.\n *\n * @function\n * @param {TaginputProps} props - Props for the Taginput component.\n * @param {React.Ref<HTMLInputElement>} ref - Forwarded ref to the input element.\n * @returns {JSX.Element} The rendered taginput component.\n *\n * @example\n * // Basic usage\n * <Taginput\n *   placeholder=\"Add a tag...\"\n *   onChange={(tags) => console.log(tags)}\n * />\n *\n * @example\n * // With autocomplete\n * <Taginput\n *   data={['React', 'Vue', 'Angular', 'Svelte']}\n *   allowNew={false}\n *   placeholder=\"Select frameworks...\"\n * />\n */\nexport const Taginput = forwardRef<HTMLInputElement, TaginputProps>(\n  (\n    {\n      // Field props\n      label,\n      labelSize,\n      labelProps,\n      horizontal,\n      message,\n      messageColor,\n      fieldClassName,\n      value: controlledValue,\n      defaultValue = [],\n      data = [],\n      placeholder,\n      field = 'label',\n      allowNew = true,\n      allowDuplicates = false,\n      openOnFocus = false,\n      removeOnKeys = true,\n      confirmKeys = ['Enter', ','],\n      closable = true,\n      attached = false,\n      maxTags,\n      maxlength,\n      disabled = false,\n      readonly = false,\n      rounded = false,\n      ellipsis = false,\n      hasCounter = true,\n      onPasteSeparators = [','],\n      beforeAdding,\n      createTag,\n      keepFirst = false,\n      keepOpen = true,\n      loading = false,\n      ariaCloseLabel,\n      icon,\n      iconLibrary: iconLibraryProp,\n      iconVariant,\n      iconFeatures,\n      color,\n      tagColor,\n      size,\n      onChange,\n      onAdd,\n      onRemove,\n      onTyping,\n      tagTemplate,\n      name,\n      form,\n      id,\n      className,\n      ...props\n    },\n    ref\n  ) => {\n    const insideField = useInsideField();\n    const insideControl = useInsideControl();\n    const ownField = rendersOwnField('Taginput', {\n      insideField,\n      insideControl,\n      label,\n      message,\n      horizontal,\n      fieldClassName,\n    });\n    const { bulmaHelperClasses, rest } = useBulmaClasses(props);\n    const { classPrefix } = useConfig();\n    const defaultIconLibrary = useIconLibrary();\n    const resolvedLibrary = iconLibraryProp || defaultIconLibrary || 'fa';\n    const pcn = (\n      ...args: (\n        | string\n        | number\n        | undefined\n        | null\n        | false\n        | Record<string, unknown>\n        | unknown[]\n      )[]\n    ) => prefixedClassNames(classPrefix, ...args);\n    const containerRef = useRef<HTMLDivElement>(null);\n    const inputRef = useRef<HTMLInputElement>(null);\n    const dropdownRef = useRef<HTMLDivElement>(null);\n\n    const [internalTags, setInternalTags] =\n      useState<TaginputTag[]>(defaultValue);\n    const [inputValue, setInputValue] = useState('');\n    const [isActive, setIsActive] = useState(false);\n    const [highlightedIndex, setHighlightedIndex] = useState(-1);\n\n    // Use controlled or internal tags\n    const tags = controlledValue !== undefined ? controlledValue : internalTags;\n\n    const isMaxReached = maxTags !== undefined && tags.length >= maxTags;\n    // At the tag limit the text input is not rendered, so there is nothing to\n    // wire a label to, its own or a surrounding Field's.\n    const { controlId, fieldLabelProps, labelled } = useAutoLabelId({\n      label,\n      id,\n      labelProps,\n      rendersLabel: ownField && !isMaxReached,\n      hasInput: !isMaxReached,\n    });\n\n    // Get display value from tag\n    const getDisplayValue = (tag: TaginputTag): string => {\n      if (typeof tag === 'string') return tag;\n      const fieldValue = tag[field];\n      if (typeof fieldValue === 'string') return fieldValue;\n      return tag.value || '';\n    };\n\n    // Filter autocomplete data\n    const filteredData = data.filter(item => {\n      const displayValue = item.toLowerCase();\n      const matchesInput = displayValue.includes(inputValue.toLowerCase());\n      const notAlreadyAdded =\n        allowDuplicates ||\n        !tags.some(tag => getDisplayValue(tag).toLowerCase() === displayValue);\n      const hasInput = inputValue || (openOnFocus && isActive);\n      return matchesInput && notAlreadyAdded && hasInput;\n    });\n\n    // keepFirst: auto-highlight first item when dropdown opens\n    useEffect(() => {\n      if (keepFirst && isActive && filteredData.length > 0) {\n        setHighlightedIndex(0);\n      }\n    }, [keepFirst, isActive, filteredData.length]);\n\n    // Update tags\n    const updateTags = useCallback(\n      (newTags: TaginputTag[]) => {\n        if (controlledValue === undefined) {\n          setInternalTags(newTags);\n        }\n        onChange?.(newTags);\n      },\n      [controlledValue, onChange]\n    );\n\n    // Add tag\n    const addTag = useCallback(\n      (value: string | TaginputTag) => {\n        if (disabled || readonly) return;\n\n        const tagValue = typeof value === 'string' ? value.trim() : value;\n        const displayValue =\n          typeof tagValue === 'string' ? tagValue : getDisplayValue(tagValue);\n\n        if (!displayValue) return;\n\n        // Check max tags\n        if (maxTags && tags.length >= maxTags) return;\n\n        // Check duplicates\n        if (!allowDuplicates) {\n          const exists = tags.some(\n            tag =>\n              getDisplayValue(tag).toLowerCase() === displayValue.toLowerCase()\n          );\n          if (exists) return;\n        }\n\n        // Check if allowed (must be in data if allowNew is false). Compare\n        // case-insensitively, consistent with the dropdown filter and the\n        // duplicate check above.\n        if (\n          !allowNew &&\n          !data.some(d => d.toLowerCase() === displayValue.toLowerCase())\n        )\n          return;\n\n        // beforeAdding validation\n        if (beforeAdding && !beforeAdding(displayValue)) return;\n\n        // createTag transformation\n        const finalTag = createTag ? createTag(displayValue) : tagValue;\n\n        const newTags = [...tags, finalTag];\n        updateTags(newTags);\n        onAdd?.(finalTag);\n        setInputValue('');\n        if (!keepOpen) {\n          setIsActive(false);\n        }\n        setHighlightedIndex(-1);\n      },\n      [\n        disabled,\n        readonly,\n        tags,\n        maxTags,\n        allowDuplicates,\n        allowNew,\n        data,\n        field,\n        updateTags,\n        onAdd,\n        beforeAdding,\n        createTag,\n        keepOpen,\n      ]\n    );\n\n    // Remove tag\n    const removeTag = useCallback(\n      (index: number) => {\n        /* istanbul ignore next: both triggers (delete button click, Backspace handler) are already gated on disabled/readonly */\n        if (disabled || readonly) return;\n\n        const removedTag = tags[index];\n        const newTags = tags.filter((_, i) => i !== index);\n        updateTags(newTags);\n        onRemove?.(removedTag, index);\n      },\n      [disabled, readonly, tags, updateTags, onRemove]\n    );\n\n    // Handle input change\n    const handleInputChange = useCallback(\n      (e: React.ChangeEvent<HTMLInputElement>) => {\n        const newValue = e.target.value;\n\n        // Check if a confirm key was typed\n        const lastChar = newValue.slice(-1);\n        if (confirmKeys.includes(lastChar) && lastChar !== 'Enter') {\n          const valueWithoutKey = newValue.slice(0, -1).trim();\n          if (valueWithoutKey) {\n            addTag(valueWithoutKey);\n          }\n          return;\n        }\n\n        setInputValue(newValue);\n        onTyping?.(newValue);\n\n        if (newValue && data.length > 0) {\n          setIsActive(true);\n        }\n      },\n      [confirmKeys, addTag, onTyping, data.length]\n    );\n\n    // Handle paste\n    const handlePaste = useCallback(\n      (e: React.ClipboardEvent<HTMLInputElement>) => {\n        if (onPasteSeparators.length === 0) return;\n\n        const pastedText = e.clipboardData.getData('text');\n        // Check if any separator exists in the pasted text\n        const hasSeparator = onPasteSeparators.some(sep =>\n          pastedText.includes(sep)\n        );\n\n        if (!hasSeparator) return;\n\n        e.preventDefault();\n\n        // Build a regex from all separators\n        const escapedSeparators = onPasteSeparators.map(s =>\n          s.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n        );\n        const regex = new RegExp(`[${escapedSeparators.join('')}]`);\n\n        const parts = pastedText\n          .split(regex)\n          .map(s => s.trim())\n          .filter(Boolean);\n\n        for (const part of parts) {\n          addTag(part);\n        }\n      },\n      [onPasteSeparators, addTag]\n    );\n\n    // Handle focus\n    const handleFocus = useCallback(() => {\n      if (openOnFocus && data.length > 0 && !disabled) {\n        setIsActive(true);\n      }\n    }, [openOnFocus, data.length, disabled]);\n\n    // Handle click outside\n    useEffect(() => {\n      if (!isActive) return undefined;\n\n      const handleClickOutside = (e: MouseEvent) => {\n        if (containerRef.current && !isEventInside(e, containerRef.current)) {\n          setIsActive(false);\n          setHighlightedIndex(-1);\n        }\n      };\n\n      document.addEventListener('mousedown', handleClickOutside);\n      return () =>\n        document.removeEventListener('mousedown', handleClickOutside);\n    }, [isActive]);\n\n    // Handle keyboard\n    const handleKeyDown = useCallback(\n      (e: React.KeyboardEvent) => {\n        if (disabled || readonly) return;\n\n        // Handle confirm keys\n        if (confirmKeys.includes(e.key)) {\n          e.preventDefault();\n          if (highlightedIndex >= 0 && filteredData[highlightedIndex]) {\n            addTag(filteredData[highlightedIndex]);\n          } else if (inputValue.trim()) {\n            addTag(inputValue);\n          }\n          return;\n        }\n\n        switch (e.key) {\n          case 'ArrowDown':\n            e.preventDefault();\n            if (!isActive && data.length > 0) {\n              setIsActive(true);\n            } else {\n              setHighlightedIndex(prev =>\n                prev < filteredData.length - 1 ? prev + 1 : prev\n              );\n            }\n            break;\n          case 'ArrowUp':\n            e.preventDefault();\n            setHighlightedIndex(prev => (prev > 0 ? prev - 1 : prev));\n            break;\n          case 'Backspace':\n            if (removeOnKeys && !inputValue && tags.length > 0) {\n              e.preventDefault();\n              removeTag(tags.length - 1);\n            }\n            break;\n          case 'Escape':\n            setIsActive(false);\n            setHighlightedIndex(-1);\n            break;\n        }\n      },\n      [\n        disabled,\n        readonly,\n        confirmKeys,\n        highlightedIndex,\n        filteredData,\n        addTag,\n        inputValue,\n        isActive,\n        data.length,\n        removeOnKeys,\n        tags.length,\n        removeTag,\n      ]\n    );\n\n    // Combined ref\n    const combinedRef = useCallback(\n      (node: HTMLInputElement | null) => {\n        (inputRef as React.MutableRefObject<HTMLInputElement | null>).current =\n          node;\n        if (typeof ref === 'function') {\n          ref(node);\n        } else if (ref) {\n          (ref as React.MutableRefObject<HTMLInputElement | null>).current =\n            node;\n        }\n      },\n      [ref]\n    );\n\n    // Focus input when container is clicked\n    const handleContainerClick = useCallback(() => {\n      inputRef.current?.focus();\n    }, []);\n\n    // Generate classes\n    const taginputClasses = pcn('taginput', {\n      'is-active': isActive,\n      [`is-${size}`]: !!size,\n      [`is-${color}`]: !!color,\n      'is-disabled': disabled,\n      'is-rounded': rounded,\n      'is-ellipsis': ellipsis,\n    });\n\n    const containerClasses = pcn('taginput-container', {\n      'is-attached': attached,\n      'has-icons-left': !!icon,\n    });\n\n    const inputClasses = pcn('input', {\n      [`is-${size}`]: !!size,\n    });\n\n    const tagClasses = pcn('tag', {\n      [`is-${tagColor}`]: !!tagColor,\n      [`is-${size}`]: !!size,\n    });\n\n    const combinedClasses = classNames(\n      taginputClasses,\n      bulmaHelperClasses,\n      className\n    );\n\n    // Counter text\n    const showCounter =\n      hasCounter && (maxTags !== undefined || maxlength !== undefined);\n    const counterText =\n      maxTags !== undefined\n        ? `${tags.length} / ${maxTags}`\n        : maxlength !== undefined\n          ? `${inputValue.length} / ${maxlength}`\n          : '';\n\n    const counterClasses = pcn('help', 'counter');\n    const tagsClasses = pcn('tags');\n    const dropdownMenuClasses = pcn('dropdown-menu', 'is-active');\n    const dropdownContentClasses = pcn('dropdown-content');\n    const iconRightClass = pcn('icon', 'is-right');\n    const loaderClass = pcn('loader', 'is-loading');\n\n    const helpClass = usePrefixedClassNames('help', {\n      [`is-${messageColor}`]: !!messageColor,\n    });\n    const messageEl = message ? <p className={helpClass}>{message}</p> : null;\n\n    const taginputElement = (\n      <div\n        ref={containerRef}\n        className={combinedClasses}\n        onClick={handleContainerClick}\n        {...rest}\n      >\n        <div className={containerClasses}>\n          {icon && (\n            <Icon\n              name={icon}\n              library={resolvedLibrary}\n              variant={iconVariant}\n              features={iconFeatures}\n              containerClassName={pcn('icon', 'is-left')}\n            />\n          )}\n          <div className={tagsClasses}>\n            {tags.map((tag, index) => {\n              const displayVal = getDisplayValue(tag);\n              return (\n                <span key={index} className={tagClasses}>\n                  {tagTemplate ? (\n                    tagTemplate(tag)\n                  ) : ellipsis ? (\n                    <span title={displayVal}>{displayVal}</span>\n                  ) : (\n                    displayVal\n                  )}\n                  {closable && !disabled && !readonly && (\n                    <button\n                      type=\"button\"\n                      className={pcn('delete', 'is-small')}\n                      onClick={e => {\n                        e.stopPropagation();\n                        removeTag(index);\n                      }}\n                      aria-label={ariaCloseLabel || `Remove ${displayVal}`}\n                    />\n                  )}\n                </span>\n              );\n            })}\n            {!isMaxReached && (\n              <input\n                ref={combinedRef}\n                type=\"text\"\n                className={inputClasses}\n                id={controlId}\n                value={inputValue}\n                placeholder={tags.length === 0 ? placeholder : undefined}\n                disabled={disabled}\n                readOnly={readonly}\n                maxLength={maxlength}\n                onChange={handleInputChange}\n                onFocus={handleFocus}\n                onKeyDown={handleKeyDown}\n                onPaste={handlePaste}\n                // Fallback name, dropped only when a rendered label actually\n                // targets this input, its own or a surrounding Field's\n                // (aria-label would win otherwise). A label pointing elsewhere\n                // keeps the fallback so the input is never nameless.\n                aria-label={labelled ? undefined : 'Add tag'}\n              />\n            )}\n          </div>\n          {loading && (\n            <span className={iconRightClass}>\n              <span className={loaderClass} />\n            </span>\n          )}\n        </div>\n\n        {isActive && filteredData.length > 0 && (\n          <div className={dropdownMenuClasses}>\n            <div\n              ref={dropdownRef}\n              className={dropdownContentClasses}\n              role=\"listbox\"\n            >\n              {filteredData.map((item, index) => (\n                <a\n                  key={index}\n                  className={pcn('dropdown-item', {\n                    'is-active': index === highlightedIndex,\n                  })}\n                  onClick={() => addTag(item)}\n                  onMouseEnter={() => setHighlightedIndex(index)}\n                  role=\"option\"\n                  aria-selected={index === highlightedIndex}\n                >\n                  {item}\n                </a>\n              ))}\n            </div>\n          </div>\n        )}\n\n        {showCounter && <small className={counterClasses}>{counterText}</small>}\n\n        {name &&\n          tags.map((tag, i) => (\n            <input\n              key={`tag-input-${i}`}\n              type=\"hidden\"\n              name={name}\n              value={getDisplayValue(tag)}\n              form={form}\n            />\n          ))}\n      </div>\n    );\n\n    if (ownField) {\n      return (\n        <Field\n          label={label}\n          labelSize={labelSize}\n          labelProps={fieldLabelProps}\n          horizontal={horizontal}\n          className={fieldClassName}\n        >\n          {taginputElement}\n          {messageEl}\n        </Field>\n      );\n    }\n\n    return (\n      <>\n        {taginputElement}\n        {messageEl}\n      </>\n    );\n  }\n);\n\nTaginput.displayName = 'Taginput';\n\n/** @deprecated Use `Taginput` — same component. */\nexport const TagInput = Taginput;\n\n/** @deprecated Use `TaginputProps`. */\nexport type TagInputProps = TaginputProps;\n\nexport default Taginput;\n"],"names":["_jsx","_jsxs","_Fragment"],"mappings":"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"}

package/dist/esm/form/TextArea.js

@@ -0,0 +1,77 @@
+/* @allxsmith/bestax-bulma — AI agents: see AGENTS.md in the package root, or https://bestax.io/llms.txt */
+import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
+import { forwardRef } from 'react';
+import { usePrefixedClassNames } from '../helpers/classNames.js';
+import { Field } from './Field.js';
+import { Control } from './Control.js';
+import { TextAreaBase } from './TextAreaBase.js';
+import { useInsideField, useInsideControl, rendersOwnField, rendersOwnControl } from './FormContext.js';
+import { useAutoLabelId } from './useAutoLabelId.js';
+
+/**
+ * The `TextArea` component provides a Bulma-styled multi-line text input, supporting color, size, hover/focus/loading states, fixed size, and all Bulma helper props.
+ *
+ * @function
+ * @param {TextAreaProps} props - Props for TextArea.
+ * @returns {JSX.Element} The composed field element.
+ *
+ * @example
+ * <TextArea label="Bio" placeholder="Tell us about yourself" rows={4} />
+ *
+ * @example
+ * <TextArea
+ *   label="Comments"
+ *   message="Max 500 characters"
+ *   messageColor="info"
+ * />
+ */
+const TextArea = forwardRef(({ 
+// Field props
+label, labelSize, labelProps, horizontal, 
+// Control props
+isLoading: controlIsLoading, controlSize, 
+// Message props
+message, messageColor, 
+// Container class overrides
+fieldClassName, controlClassName, 
+// Everything else goes to TextAreaBase
+...textAreaProps }, ref) => {
+    const insideField = useInsideField();
+    const insideControl = useInsideControl();
+    const ownField = rendersOwnField('TextArea', {
+        insideField,
+        insideControl,
+        label,
+        message,
+        horizontal,
+        fieldClassName,
+    });
+    const ownControl = rendersOwnControl('TextArea', {
+        insideControl,
+        isLoading: controlIsLoading,
+        controlSize,
+        controlClassName,
+    });
+    const { controlId, fieldLabelProps } = useAutoLabelId({
+        label,
+        id: textAreaProps.id,
+        labelProps,
+        rendersLabel: ownField,
+    });
+    const helpClass = usePrefixedClassNames('help', {
+        [`is-${messageColor}`]: !!messageColor,
+    });
+    let content = jsx(TextAreaBase, { ref: ref, ...textAreaProps, id: controlId });
+    if (ownControl) {
+        content = (jsx(Control, { isLoading: controlIsLoading, size: controlSize, className: controlClassName, children: content }));
+    }
+    const messageEl = message ? jsx("p", { className: helpClass, children: message }) : null;
+    if (ownField) {
+        return (jsxs(Field, { label: label, labelSize: labelSize, labelProps: fieldLabelProps, horizontal: horizontal, className: fieldClassName, children: [content, messageEl] }));
+    }
+    return (jsxs(Fragment, { children: [content, messageEl] }));
+});
+TextArea.displayName = 'TextArea';
+
+export { TextArea };
+//# sourceMappingURL=TextArea.js.map

package/dist/esm/form/TextArea.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextArea.js","sources":["../../../src/form/TextArea.tsx"],"sourcesContent":["import React, { forwardRef } from 'react';\nimport { usePrefixedClassNames } from '../helpers/classNames';\nimport { Field, FieldProps } from './Field';\nimport { Control, ControlBaseProps } from './Control';\nimport { TextAreaBase, TextAreaBaseProps } from './TextAreaBase';\nimport {\n  useInsideField,\n  useInsideControl,\n  rendersOwnField,\n  rendersOwnControl,\n} from './FormContext';\nimport { useAutoLabelId } from './useAutoLabelId';\n\n/**\n * Props for the TextArea component.\n *\n * Composes Field, Control, and TextAreaBase into a single convenience component.\n * Supports all TextAreaBase props, plus Field-level (label, horizontal) and\n * Control-level (loading) props.\n * Inside an existing `Control` it renders no `Control` of its own, so its\n * Control-level props do nothing there and warn in development; set them on\n * that `Control` instead. Inside an outer `Field`, or a `Control` with no\n * `Field` around it, it renders no `Field` of its own either.\n * The exception is `label`, `message`, `horizontal` or `fieldClassName` in that\n * bare `Control`: it keeps a `Field` for them, nested in the `.control`, and\n * warns in development. Wrap the `Control` in a `Field` instead, and set the\n * `label`, `horizontal` and class name on that `Field`.\n */\nexport interface TextAreaProps extends TextAreaBaseProps {\n  /** Field label. Automatically associated with the textarea via `htmlFor` — uses your `id` when provided, otherwise a generated one. Dropped inside an outer `Field`, whose own label associates instead when that `Field` generates a target id (not `grouped`/`hasAddons`, no explicit `labelProps.htmlFor`). */\n  label?: React.ReactNode;\n  /** Size for the label. */\n  labelSize?: FieldProps['labelSize'];\n  /** Props for the label element when the component renders its own `Field`; dropped inside an outer `Field` (use that `Field`'s `labelProps` instead). An explicit `htmlFor` key — even `undefined` — overrides the automatic association and no id is generated. */\n  labelProps?: FieldProps['labelProps'];\n  /** Horizontal field layout. */\n  horizontal?: boolean;\n  /**\n   * Shows a loading spinner on the `Control` it renders.\n   * Under `prefers-reduced-motion: reduce` the spinner stops and stays\n   * drawn (with bestax's CSS loaded).\n   */\n  isLoading?: boolean;\n  /** Control size. */\n  controlSize?: ControlBaseProps['size'];\n  /** Help/validation message below the textarea. */\n  message?: React.ReactNode;\n  /** Bulma color for the message. */\n  messageColor?: 'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger';\n  /** Additional CSS classes for the Field. */\n  fieldClassName?: string;\n  /** Additional CSS classes for the Control. */\n  controlClassName?: string;\n}\n\n/**\n * The `TextArea` component provides a Bulma-styled multi-line text input, supporting color, size, hover/focus/loading states, fixed size, and all Bulma helper props.\n *\n * @function\n * @param {TextAreaProps} props - Props for TextArea.\n * @returns {JSX.Element} The composed field element.\n *\n * @example\n * <TextArea label=\"Bio\" placeholder=\"Tell us about yourself\" rows={4} />\n *\n * @example\n * <TextArea\n *   label=\"Comments\"\n *   message=\"Max 500 characters\"\n *   messageColor=\"info\"\n * />\n */\nexport const TextArea = forwardRef<HTMLTextAreaElement, TextAreaProps>(\n  (\n    {\n      // Field props\n      label,\n      labelSize,\n      labelProps,\n      horizontal,\n      // Control props\n      isLoading: controlIsLoading,\n      controlSize,\n      // Message props\n      message,\n      messageColor,\n      // Container class overrides\n      fieldClassName,\n      controlClassName,\n      // Everything else goes to TextAreaBase\n      ...textAreaProps\n    },\n    ref\n  ) => {\n    const insideField = useInsideField();\n    const insideControl = useInsideControl();\n    const ownField = rendersOwnField('TextArea', {\n      insideField,\n      insideControl,\n      label,\n      message,\n      horizontal,\n      fieldClassName,\n    });\n    const ownControl = rendersOwnControl('TextArea', {\n      insideControl,\n      isLoading: controlIsLoading,\n      controlSize,\n      controlClassName,\n    });\n    const { controlId, fieldLabelProps } = useAutoLabelId({\n      label,\n      id: textAreaProps.id,\n      labelProps,\n      rendersLabel: ownField,\n    });\n    const helpClass = usePrefixedClassNames('help', {\n      [`is-${messageColor}`]: !!messageColor,\n    });\n\n    let content = <TextAreaBase ref={ref} {...textAreaProps} id={controlId} />;\n\n    if (ownControl) {\n      content = (\n        <Control\n          isLoading={controlIsLoading}\n          size={controlSize}\n          className={controlClassName}\n        >\n          {content}\n        </Control>\n      );\n    }\n\n    const messageEl = message ? <p className={helpClass}>{message}</p> : null;\n\n    if (ownField) {\n      return (\n        <Field\n          label={label}\n          labelSize={labelSize}\n          labelProps={fieldLabelProps}\n          horizontal={horizontal}\n          className={fieldClassName}\n        >\n          {content}\n          {messageEl}\n        </Field>\n      );\n    }\n\n    return (\n      <>\n        {content}\n        {messageEl}\n      </>\n    );\n  }\n);\n\nTextArea.displayName = 'TextArea';\n\nexport default TextArea;\n"],"names":["_jsx","_jsxs","_Fragment"],"mappings":";;;;;;;;;;AAuDA;;;;;;;;;;;;;;;;AAgBG;AACI,MAAM,QAAQ,GAAG,UAAU,CAChC,CACE;AACE;AACA,KAAK,EACL,SAAS,EACT,UAAU,EACV,UAAU;AACV;AACA,SAAS,EAAE,gBAAgB,EAC3B,WAAW;AACX;AACA,OAAO,EACP,YAAY;AACZ;AACA,cAAc,EACd,gBAAgB;AAChB;AACA,GAAG,aAAa,EACjB,EACD,GAAG,KACD;AACF,IAAA,MAAM,WAAW,GAAG,cAAc,EAAE;AACpC,IAAA,MAAM,aAAa,GAAG,gBAAgB,EAAE;AACxC,IAAA,MAAM,QAAQ,GAAG,eAAe,CAAC,UAAU,EAAE;QAC3C,WAAW;QACX,aAAa;QACb,KAAK;QACL,OAAO;QACP,UAAU;QACV,cAAc;AACf,KAAA,CAAC;AACF,IAAA,MAAM,UAAU,GAAG,iBAAiB,CAAC,UAAU,EAAE;QAC/C,aAAa;AACb,QAAA,SAAS,EAAE,gBAAgB;QAC3B,WAAW;QACX,gBAAgB;AACjB,KAAA,CAAC;AACF,IAAA,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,GAAG,cAAc,CAAC;QACpD,KAAK;QACL,EAAE,EAAE,aAAa,CAAC,EAAE;QACpB,UAAU;AACV,QAAA,YAAY,EAAE,QAAQ;AACvB,KAAA,CAAC;AACF,IAAA,MAAM,SAAS,GAAG,qBAAqB,CAAC,MAAM,EAAE;AAC9C,QAAA,CAAC,MAAM,YAAY,CAAA,CAAE,GAAG,CAAC,CAAC,YAAY;AACvC,KAAA,CAAC;AAEF,IAAA,IAAI,OAAO,GAAGA,GAAA,CAAC,YAAY,IAAC,GAAG,EAAE,GAAG,EAAA,GAAM,aAAa,EAAE,EAAE,EAAE,SAAS,GAAI;IAE1E,IAAI,UAAU,EAAE;QACd,OAAO,IACLA,GAAA,CAAC,OAAO,IACN,SAAS,EAAE,gBAAgB,EAC3B,IAAI,EAAE,WAAW,EACjB,SAAS,EAAE,gBAAgB,YAE1B,OAAO,EAAA,CACA,CACX;IACH;AAEA,IAAA,MAAM,SAAS,GAAG,OAAO,GAAGA,GAAA,CAAA,GAAA,EAAA,EAAG,SAAS,EAAE,SAAS,YAAG,OAAO,EAAA,CAAK,GAAG,IAAI;IAEzE,IAAI,QAAQ,EAAE;AACZ,QAAA,QACEC,IAAA,CAAC,KAAK,EAAA,EACJ,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,eAAe,EAC3B,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,cAAc,EAAA,QAAA,EAAA,CAExB,OAAO,EACP,SAAS,CAAA,EAAA,CACJ;IAEZ;AAEA,IAAA,QACEA,IAAA,CAAAC,QAAA,EAAA,EAAA,QAAA,EAAA,CACG,OAAO,EACP,SAAS,CAAA,EAAA,CACT;AAEP,CAAC;AAGH,QAAQ,CAAC,WAAW,GAAG,UAAU;;"}