@allxsmith/bestax-bulma 5.27.1 → 5.27.2

package/dist/types-cjs/form/TimeInput.d.ts

@@ -22,7 +22,7 @@ import { TimeInputBaseProps } from './TimeInputBase.js';
  * @extraProp {React.Ref<HTMLInputElement>} [ref] - Forwarded to the underlying `<input>`.
  */
 export interface TimeInputProps extends TimeInputBaseProps {
-    /** Field label. Automatically associated with the input via `htmlFor` — uses your `id` when provided, otherwise a generated one. Not wired in `inline` mode (no visible input to label) and dropped inside an outer `Field`. */
+    /** Field label. Automatically associated with the input via `htmlFor` — uses your `id` when provided, otherwise a generated one. Not wired in `inline` mode (no visible input to label). Dropped inside an outer `Field`, whose own label associates instead when that `Field` generates a target id (not `grouped`/`hasAddons`, no explicit `labelProps.htmlFor`). */
     label?: React.ReactNode;
     /** Size for the label. */
     labelSize?: FieldProps['labelSize'];

package/dist/types-cjs/form/useAutoLabelId.d.ts

@@ -13,6 +13,11 @@ interface UseAutoLabelIdOptions {
      * no Field, and in modes with no labellable control (e.g. inline pickers).
      */
     rendersLabel: boolean;
+    /**
+     * False when this render has no input to label at all (an inline picker),
+     * so it takes no id from a surrounding Field either. Defaults to true.
+     */
+    hasInput?: boolean;
 }
 /**
  * Associates the convenience `label` prop with its control (#368): generates
@@ -20,11 +25,16 @@ interface UseAutoLabelIdOptions {
  * A user-supplied `id` is used as the target instead of the generated one, and
  * 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.
+ * semantics). When the control renders no label of its own, it adopts the id
+ * a labeled Field around it offers, the way the bases do, so that Field's
+ * label names it (#939); a user `id` still wins there.
+ * Internal; not part of the public API.
  */
-export declare function useAutoLabelId({ label, id, labelProps, rendersLabel, }: UseAutoLabelIdOptions): {
+export declare function useAutoLabelId({ label, id, labelProps, rendersLabel, hasInput, }: UseAutoLabelIdOptions): {
     controlId: string | undefined;
     fieldLabelProps: FieldProps['labelProps'] | undefined;
+    /** Whether a rendered label, its own or a surrounding Field's, points at `controlId`. */
+    labelled: boolean;
 };
 interface UseAutoLabelledByOptions {
     /** The convenience `label` prop as passed by the caller. */
@@ -33,6 +43,13 @@ interface UseAutoLabelledByOptions {
     labelProps?: FieldProps['labelProps'];
     /** True when this render actually outputs the label naming the group. */
     rendersLabel: boolean;
+    /**
+     * The caller's remaining props. A non-empty `aria-label` among them names
+     * the group, and so does any `aria-labelledby` key, even an undefined one,
+     * since the group spreads them after its own attribute. Either keeps every
+     * label off the group, its own and a surrounding Field's alike.
+     */
+    callerProps: object;
 }
 /**
  * Group-input counterpart of {@link useAutoLabelId} (#494): a group of
@@ -41,10 +58,14 @@ interface UseAutoLabelledByOptions {
  * `aria-labelledby`. A user-supplied `labelProps.id` is used as the target
  * instead of generating one. Any caller `htmlFor` is stripped — a group label
  * names the group, never a single control — so the merged labelProps always
- * carry an explicit `htmlFor: undefined`.
+ * carry an explicit `htmlFor: undefined`. When the group renders no label of
+ * its own, it points at the label of a labeled Field around it instead
+ * (#939). A caller who named the group with `aria-label` or
+ * `aria-labelledby` gets no `aria-labelledby` from either label, so their
+ * name wins wherever the label sits.
  * Internal; not part of the public API.
  */
-export declare function useAutoLabelledBy({ label, labelProps, rendersLabel, }: UseAutoLabelledByOptions): {
+export declare function useAutoLabelledBy({ label, labelProps, rendersLabel, callerProps, }: UseAutoLabelledByOptions): {
     ariaLabelledBy: string | undefined;
     fieldLabelProps: FieldProps['labelProps'] | undefined;
 };

package/dist/types-cjs/helpers/Config.d.ts

@@ -20,14 +20,13 @@ export interface ConfigContextProps {
 export declare const useConfig: () => ConfigContextProps;
 /**
  * Props for the ConfigProvider component.
- *
- * @property {React.ReactNode} children - Child components to receive configuration.
- * @property {string} [classPrefix] - Prefix applied to all Bulma class names.
- * @property {IconLibrary} [iconLibrary] - Default icon library for Icon components.
  */
 export interface ConfigProviderProps {
+    /** Child components to receive configuration. */
     children: ReactNode;
+    /** Prefix applied to all Bulma class names. */
     classPrefix?: string;
+    /** Default icon library for Icon components. */
     iconLibrary?: IconLibrary;
 }
 /**

package/dist/types-cjs/helpers/Theme.d.ts

@@ -8,48 +8,9 @@ type BulmaVarKey = (typeof bulmaCssVars)[number];
 type BulmaVars = Partial<Record<BulmaVarKey, string>>;
 /**
  * Props for the Theme component.
- *
- * @property {React.ReactNode} children - Content to render inside the theme scope.
- * @property {string} [className] - Additional CSS classes (only when isRoot is false).
- * @property {BulmaVars} [bulmaVars] - Object mapping Bulma CSS variable names to values.
- * @property {string} [schemeH] - Scheme hue value.
- * @property {string} [schemeS] - Scheme saturation value.
- * @property {string} [lightL] - Light theme lightness value.
- * @property {string} [lightInvertL] - Light theme inverted lightness value.
- * @property {string} [darkL] - Dark theme lightness value.
- * @property {string} [darkInvertL] - Dark theme inverted lightness value.
- * @property {string} [softL] - Soft lightness value.
- * @property {string} [boldL] - Bold lightness value.
- * @property {string} [softInvertL] - Soft inverted lightness value.
- * @property {string} [boldInvertL] - Bold inverted lightness value.
- * @property {string} [hoverBackgroundLDelta] - Background lightness delta on hover.
- * @property {string} [activeBackgroundLDelta] - Background lightness delta on active.
- * @property {string} [hoverBorderLDelta] - Border lightness delta on hover.
- * @property {string} [activeBorderLDelta] - Border lightness delta on active.
- * @property {string} [hoverColorLDelta] - Text color lightness delta on hover.
- * @property {string} [activeColorLDelta] - Text color lightness delta on active.
- * @property {string} [hoverShadowADelta] - Shadow alpha delta on hover.
- * @property {string} [activeShadowADelta] - Shadow alpha delta on active.
- * @property {string} [primaryH] - Primary color hue.
- * @property {string} [primaryS] - Primary color saturation.
- * @property {string} [primaryL] - Primary color lightness.
- * @property {string} [linkH] - Link color hue.
- * @property {string} [linkS] - Link color saturation.
- * @property {string} [linkL] - Link color lightness.
- * @property {string} [infoH] - Info color hue.
- * @property {string} [infoS] - Info color saturation.
- * @property {string} [infoL] - Info color lightness.
- * @property {string} [successH] - Success color hue.
- * @property {string} [successS] - Success color saturation.
- * @property {string} [successL] - Success color lightness.
- * @property {string} [warningH] - Warning color hue.
- * @property {string} [warningS] - Warning color saturation.
- * @property {string} [warningL] - Warning color lightness.
- * @property {string} [dangerH] - Danger color hue.
- * @property {string} [dangerS] - Danger color saturation.
- * @property {string} [dangerL] - Danger color lightness.
  */
 export interface ThemeProps extends Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+    /** The content the theme applies to. */
     children: ReactNode;
     /**
      * Additional CSS classes for the wrapper div. A root Theme (`isRoot`) has no
@@ -86,6 +47,13 @@ export interface ThemeProps extends Omit<BulmaClassesProps, 'color' | 'backgroun
      * write only `data-theme` and warn in development.
      */
     colorMode?: 'light' | 'dark' | 'system';
+    /**
+     * Bulma CSS variables to set, by name, such as
+     * `{ '--bulma-primary-h': '210' }`. Only Bulma's own variables, the keys
+     * the `BulmaVars` type allows, are applied, and an empty value is skipped.
+     * Where a variable prop, such as `primaryH`, sets the same variable, the
+     * prop wins.
+     */
     bulmaVars?: BulmaVars;
     /**
      * Border radius helper, as on every other component: `radiusless` adds
@@ -124,41 +92,77 @@ export interface ThemeProps extends Omit<BulmaClassesProps, 'color' | 'backgroun
      * now adds `is-column-gap-0` to the wrapper instead.
      */
     columnGap?: BulmaGapStep;
+    /** Base hue for the color scheme, 0 to 360. Sets `--bulma-scheme-h`. */
     schemeH?: string;
+    /** Base saturation for the color scheme, as a percentage. Sets `--bulma-scheme-s`. */
     schemeS?: string;
+    /** Lightness for light backgrounds. Sets `--bulma-light-l`. */
     lightL?: string;
+    /** Inverted lightness for light backgrounds. Sets `--bulma-light-invert-l`. */
     lightInvertL?: string;
+    /** Lightness for dark backgrounds. Sets `--bulma-dark-l`. */
     darkL?: string;
+    /** Inverted lightness for dark backgrounds. Sets `--bulma-dark-invert-l`. */
     darkInvertL?: string;
+    /** Lightness for soft colors. Sets `--bulma-soft-l`. */
     softL?: string;
+    /** Lightness for bold colors. Sets `--bulma-bold-l`. */
     boldL?: string;
+    /** Inverted lightness for soft colors. Sets `--bulma-soft-invert-l`. */
     softInvertL?: string;
+    /** Inverted lightness for bold colors. Sets `--bulma-bold-invert-l`. */
     boldInvertL?: string;
+    /** Lightness change of a background on hover. Sets `--bulma-hover-background-l-delta`. */
     hoverBackgroundLDelta?: string;
+    /** Lightness change of a background when active. Sets `--bulma-active-background-l-delta`. */
     activeBackgroundLDelta?: string;
+    /** Lightness change of a border on hover. Sets `--bulma-hover-border-l-delta`. */
     hoverBorderLDelta?: string;
+    /** Lightness change of a border when active. Sets `--bulma-active-border-l-delta`. */
     activeBorderLDelta?: string;
+    /** Lightness change of text color on hover. Sets `--bulma-hover-color-l-delta`. */
     hoverColorLDelta?: string;
+    /** Lightness change of text color when active. Sets `--bulma-active-color-l-delta`. */
     activeColorLDelta?: string;
+    /** Alpha change of a shadow on hover. Sets `--bulma-hover-shadow-a-delta`. */
     hoverShadowADelta?: string;
+    /** Alpha change of a shadow when active. Sets `--bulma-active-shadow-a-delta`. */
     activeShadowADelta?: string;
+    /** Primary color hue, 0 to 360. Sets `--bulma-primary-h`. */
     primaryH?: string;
+    /** Primary color saturation, as a percentage. Sets `--bulma-primary-s`. */
     primaryS?: string;
+    /** Primary color lightness, as a percentage. Sets `--bulma-primary-l`. */
     primaryL?: string;
+    /** Link color hue, 0 to 360. Sets `--bulma-link-h`. */
     linkH?: string;
+    /** Link color saturation, as a percentage. Sets `--bulma-link-s`. */
     linkS?: string;
+    /** Link color lightness, as a percentage. Sets `--bulma-link-l`. */
     linkL?: string;
+    /** Info color hue, 0 to 360. Sets `--bulma-info-h`. */
     infoH?: string;
+    /** Info color saturation, as a percentage. Sets `--bulma-info-s`. */
     infoS?: string;
+    /** Info color lightness, as a percentage. Sets `--bulma-info-l`. */
     infoL?: string;
+    /** Success color hue, 0 to 360. Sets `--bulma-success-h`. */
     successH?: string;
+    /** Success color saturation, as a percentage. Sets `--bulma-success-s`. */
     successS?: string;
+    /** Success color lightness, as a percentage. Sets `--bulma-success-l`. */
     successL?: string;
+    /** Warning color hue, 0 to 360. Sets `--bulma-warning-h`. */
     warningH?: string;
+    /** Warning color saturation, as a percentage. Sets `--bulma-warning-s`. */
     warningS?: string;
+    /** Warning color lightness, as a percentage. Sets `--bulma-warning-l`. */
     warningL?: string;
+    /** Danger color hue, 0 to 360. Sets `--bulma-danger-h`. */
     dangerH?: string;
+    /** Danger color saturation, as a percentage. Sets `--bulma-danger-s`. */
     dangerS?: string;
+    /** Danger color lightness, as a percentage. Sets `--bulma-danger-l`. */
     dangerL?: string;
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allxsmith/bestax-bulma",
-  "version": "5.27.1",
+  "version": "5.27.2",
   "description": "A fully-typed React component library for the Bulma CSS framework. Build modern UIs quickly with reusable, accessible, and customizable Bulma-based React components.",
   "main": "dist/index.cjs",
   "module": "dist/index.esm.js",