@allxsmith/bestax-bulma 5.8.4 → 5.9.0

package/dist/index.cjs.js

@@ -5560,6 +5560,17 @@ const useInsideControl = () => React.useContext(ControlContext);
 const FieldProvider = FieldContext.Provider;
 /** Provider for Control context — used internally by Control component. */
 const ControlProvider = ControlContext.Provider;
+const FieldLabelIdContext = React.createContext(undefined);
+/**
+ * The id a labeled Field wants its single composed control to adopt (#495).
+ * `undefined` outside a Field, in unlabeled/grouped/addons Fields, or when the
+ * user took over the association with an explicit `labelProps.htmlFor`.
+ * Consumed only by the single-control bases (InputBase, SelectBase,
+ * TextAreaBase). Internal; not part of the public API.
+ */
+const useFieldLabelId = () => React.useContext(FieldLabelIdContext);
+/** Provider for the Field label-target id — used internally by Field. */
+const FieldLabelIdProvider = FieldLabelIdContext.Provider;
 const RadiosContext = React.createContext(undefined);
 const CheckboxesContext = React.createContext(undefined);
 /**
@@ -5767,15 +5778,19 @@ const FieldBody = ({ textColor, bgColor, className, children, ...props }) => {
  * @see {@link https://bulma.io/documentation/form/general/#field | Bulma Field documentation}
  *
  * @example
- * // Labelled field
+ * // Labelled field — the label auto-associates with the composed base
  * <Field label="Email">
- *   <input className="input" type="email" />
+ *   <Control>
+ *     <InputBase type="email" />
+ *   </Control>
  * </Field>
  *
  * @example
  * // Horizontal field
  * <Field horizontal label="Name">
- *   <input className="input" />
+ *   <Control>
+ *     <InputBase />
+ *   </Control>
  * </Field>
  */
 const FieldComponent = ({ horizontal, grouped, hasAddons, narrow, label, labelSize, labelProps, textColor, color: _fieldColor, bgColor, className, children, ...props }) => {
@@ -5802,13 +5817,24 @@ const FieldComponent = ({ horizontal, grouped, hasAddons, narrow, label, labelSi
     // Default labelSize to 'normal' when horizontal for proper baseline alignment
     const effectiveLabelSize = labelSize ?? (horizontal ? 'normal' : undefined);
     const labelClass = usePrefixedClassNames('label');
+    // Auto-associate the label with a single composed base control (#495): the
+    // label points at a generated id shared via context, which InputBase/
+    // SelectBase/TextAreaBase adopt when the user supplied no id of their own.
+    // Presence semantics on htmlFor — even an explicit `htmlFor: undefined`
+    // means the caller owns the association. Grouped/addons fields hold several
+    // controls, so no single association is generated for them.
+    const generatedId = React.useId();
+    const userWiredLabel = !!labelProps && 'htmlFor' in labelProps;
+    const targetId = label && !userWiredLabel && !grouped && !hasAddons
+        ? generatedId
+        : undefined;
     let renderedLabel = null;
     if (label) {
         if (horizontal) {
-            renderedLabel = (jsxRuntime.jsx(FieldLabel, { size: effectiveLabelSize, children: jsxRuntime.jsx("label", { ...labelProps, className: classNames(labelClass, labelProps?.className), style: labelProps?.style, children: label }) }));
+            renderedLabel = (jsxRuntime.jsx(FieldLabel, { size: effectiveLabelSize, children: jsxRuntime.jsx("label", { htmlFor: targetId, ...labelProps, className: classNames(labelClass, labelProps?.className), style: labelProps?.style, children: label }) }));
         }
         else {
-            renderedLabel = (jsxRuntime.jsx("label", { ...labelProps, className: classNames(labelClass, labelProps?.className), style: { display: 'block', ...(labelProps?.style || {}) }, children: label }));
+            renderedLabel = (jsxRuntime.jsx("label", { htmlFor: targetId, ...labelProps, className: classNames(labelClass, labelProps?.className), style: { display: 'block', ...(labelProps?.style || {}) }, children: label }));
         }
     }
     // If horizontal, wrap children in FieldBody (unless the user already provided
@@ -5831,7 +5857,7 @@ const FieldComponent = ({ horizontal, grouped, hasAddons, narrow, label, labelSi
             content = jsxRuntime.jsx(FieldBody, { children: children });
         }
     }
-    return (jsxRuntime.jsx(FieldProvider, { value: true, children: jsxRuntime.jsxs("div", { className: fieldClass, ...rest, children: [renderedLabel, content] }) }));
+    return (jsxRuntime.jsx(FieldProvider, { value: true, children: jsxRuntime.jsx(FieldLabelIdProvider, { value: targetId, children: jsxRuntime.jsxs("div", { className: fieldClass, ...rest, children: [renderedLabel, content] }) }) }));
 };
 FieldLabel.displayName = 'FieldLabel';
 FieldBody.displayName = 'FieldBody';
@@ -5845,18 +5871,28 @@ const Field = withSubComponents(FieldComponent, {
  * Associates the convenience `label` prop with its control (#368): generates
  * an id for the control and returns labelProps carrying a matching `htmlFor`.
  * A user-supplied `id` is used as the target instead of the generated one, and
- * an explicit `labelProps.htmlFor` disables generation entirely — the user has
- * taken over the association. Internal; not part of the public API.
+ * an explicit `htmlFor` key in labelProps — even set to `undefined` — disables
+ * generation entirely: the user has taken over the association (#495 presence
+ * semantics). Internal; not part of the public API.
  */
 function useAutoLabelId({ label, id, labelProps, rendersLabel, }) {
     // Called unconditionally per the rules of hooks; SSR-safe on React 18 and 19.
     const generatedId = React.useId();
     // Truthiness mirrors Field's own `if (label)` render gate.
     const active = !!label && rendersLabel;
-    const controlId = id ?? (active && !labelProps?.htmlFor ? generatedId : undefined);
+    // Presence, not truthiness: `htmlFor: undefined` is an explicit opt-out and
+    // must not leave an orphan generated id on the control.
+    const userWired = !!labelProps && 'htmlFor' in labelProps;
+    const controlId = id ?? (active && !userWired ? generatedId : undefined);
+    // Inactive with a label still means an own Field may render it (pickers'
+    // inline mode, Taginput at maxTags) — the explicit `htmlFor: undefined`
+    // tells Field the association is owned here, so it must not generate one
+    // that would dangle (#495 presence semantics).
     const fieldLabelProps = active
         ? { htmlFor: controlId, ...labelProps }
-        : labelProps;
+        : label
+            ? { htmlFor: undefined, ...labelProps }
+            : labelProps;
     return { controlId, fieldLabelProps };
 }
 /**
@@ -7668,6 +7704,7 @@ const InputBase = React.forwardRef(({ color, size, isRounded, isStatic, isHovere
         color,
         ...props,
     });
+    const fieldLabelId = useFieldLabelId();
     const mainClass = usePrefixedClassNames('input', {
         [`is-${color}`]: !!color,
         [`is-${size}`]: !!size,
@@ -7678,7 +7715,10 @@ const InputBase = React.forwardRef(({ color, size, isRounded, isStatic, isHovere
         'is-loading': isLoading,
     });
     const inputClass = classNames(mainClass, bulmaHelperClasses, className);
-    return (jsxRuntime.jsx("input", { ref: ref, className: inputClass, disabled: disabled, readOnly: readOnly, ...rest }));
+    return (jsxRuntime.jsx("input", { ref: ref, className: inputClass, disabled: disabled, readOnly: readOnly, ...rest, 
+        // After the spread: a labeled Field's generated id is adopted only
+        // when no user id arrived (rest.id may be an undefined own key).
+        id: rest.id ?? fieldLabelId }));
 });
 InputBase.displayName = 'InputBase';
 
@@ -7695,6 +7735,7 @@ const SelectBase = React.forwardRef(({ color, size, isRounded, isLoading, isActi
         color,
         ...props,
     });
+    const fieldLabelId = useFieldLabelId();
     const mainClass = usePrefixedClassNames('select', {
         [`is-${color}`]: !!color,
         [`is-${size}`]: !!size,
@@ -7719,7 +7760,10 @@ const SelectBase = React.forwardRef(({ color, size, isRounded, isLoading, isActi
     if (multiple && typeof multipleSize === 'number') {
         selectProps.size = multipleSize;
     }
-    return (jsxRuntime.jsx("div", { className: selectClass, children: jsxRuntime.jsx("select", { ref: ref, className: innerSelectClass || undefined, ...selectProps, children: children }) }));
+    return (jsxRuntime.jsx("div", { className: selectClass, children: jsxRuntime.jsx("select", { ref: ref, className: innerSelectClass || undefined, ...selectProps, 
+            // After the spread: a labeled Field's generated id is adopted only
+            // when no user id arrived; the id belongs on the inner <select>.
+            id: selectProps.id ?? fieldLabelId, children: children }) }));
 });
 SelectBase.displayName = 'SelectBase';
 
@@ -7736,6 +7780,7 @@ const TextAreaBase = React.forwardRef(({ color, size, isRounded, isStatic, isHov
         color,
         ...props,
     });
+    const fieldLabelId = useFieldLabelId();
     // Note: `is-loading` is intentionally NOT applied to the <textarea> itself —
     // Bulma documents `<div class="control is-loading">` as the loading pattern
     // for textareas, not `<textarea class="textarea is-loading">`. The convenience
@@ -7751,7 +7796,10 @@ const TextAreaBase = React.forwardRef(({ color, size, isRounded, isStatic, isHov
         'has-fixed-size': hasFixedSize,
     });
     const textareaClass = classNames(mainClass, bulmaHelperClasses, className);
-    return (jsxRuntime.jsx("textarea", { ref: ref, className: textareaClass, disabled: disabled, readOnly: readOnly, rows: rows, ...rest }));
+    return (jsxRuntime.jsx("textarea", { ref: ref, className: textareaClass, disabled: disabled, readOnly: readOnly, rows: rows, ...rest, 
+        // After the spread: a labeled Field's generated id is adopted only
+        // when no user id arrived (rest.id may be an undefined own key).
+        id: rest.id ?? fieldLabelId }));
 });
 TextAreaBase.displayName = 'TextAreaBase';