@allxsmith/bestax-bulma 5.16.4 → 5.16.6

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

@@ -0,0 +1,51 @@
+import React from 'react';
+import type { FieldProps } from './Field.js';
+interface UseAutoLabelIdOptions {
+    /** The convenience `label` prop as passed by the caller. */
+    label: React.ReactNode;
+    /** User-supplied id for the control, if any. */
+    id?: string;
+    /** User-supplied labelProps, if any. */
+    labelProps?: FieldProps['labelProps'];
+    /**
+     * True when this render actually outputs the label wired to a control —
+     * false inside an outer Field (label is dropped), in variants that render
+     * no Field, and in modes with no labellable control (e.g. inline pickers).
+     */
+    rendersLabel: boolean;
+}
+/**
+ * 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 `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.
+ */
+export declare function useAutoLabelId({ label, id, labelProps, rendersLabel, }: UseAutoLabelIdOptions): {
+    controlId: string | undefined;
+    fieldLabelProps: FieldProps['labelProps'] | undefined;
+};
+interface UseAutoLabelledByOptions {
+    /** The convenience `label` prop as passed by the caller. */
+    label: React.ReactNode;
+    /** User-supplied labelProps, if any. */
+    labelProps?: FieldProps['labelProps'];
+    /** True when this render actually outputs the label naming the group. */
+    rendersLabel: boolean;
+}
+/**
+ * Group-input counterpart of {@link useAutoLabelId} (#494): a group of
+ * controls cannot take a single `htmlFor`, so instead the rendered `<label>`
+ * gets a generated id and the group container points at it with
+ * `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`.
+ * Internal; not part of the public API.
+ */
+export declare function useAutoLabelledBy({ label, labelProps, rendersLabel, }: UseAutoLabelledByOptions): {
+    ariaLabelledBy: string | undefined;
+    fieldLabelProps: FieldProps['labelProps'] | undefined;
+};
+export {};

package/dist/types-cjs/grid/Cell.d.ts

@@ -0,0 +1,42 @@
+import React from 'react';
+import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses.js';
+/**
+ * Type for grid cell span values.
+ */
+export type CellSpanValue = number;
+/**
+ * Props for the Cell component.
+ */
+export interface CellProps extends React.HTMLAttributes<HTMLDivElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+    /** Which column the cell starts at (Bulma: `is-col-start-x`). */
+    colStart?: number;
+    /** Which column the cell ends at, counting from the end (Bulma: `is-col-from-end-x`). */
+    colFromEnd?: number;
+    /** How many columns the cell will span (Bulma: `is-col-span-x`). */
+    colSpan?: CellSpanValue;
+    /** Which row the cell starts at (Bulma: `is-row-start-x`). */
+    rowStart?: number;
+    /** Which row the cell ends at, counting from the end (Bulma: `is-row-from-end-x`). */
+    rowFromEnd?: number;
+    /** How many rows the cell will span (Bulma: `is-row-span-x`). */
+    rowSpan?: CellSpanValue;
+    /** Additional CSS class names. */
+    className?: string;
+    /** Text color. */
+    textColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Bulma color modifier for the cell. */
+    color?: 'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger';
+    /** Background color. */
+    bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Content to render inside the cell. */
+    children?: React.ReactNode;
+}
+/**
+ * The `Cell` component provides a single Bulma grid cell for use inside the [`Grid`](./grid.md) component.
+ *
+ * @function
+ * @param {CellProps} props - Props for the Cell component.
+ * @returns {JSX.Element} The rendered grid cell.
+ * @see {@link https://bulma.io/documentation/grid/ | Bulma Grid documentation}
+ */
+export declare const Cell: React.FC<CellProps>;

package/dist/types-cjs/grid/Grid.d.ts

@@ -0,0 +1,59 @@
+import React from 'react';
+import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses.js';
+/**
+ * Allowed gap values for Bulma's 0-8 spacing scale, shared by `Grid` and
+ * `Columns`. Accepts the value as a number or a numeric string.
+ */
+export type BulmaGapValue = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8';
+/**
+ * Allowed minimum column values for Bulma grid.
+ */
+export type BulmaMinColValue = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32;
+/**
+ * Allowed fixed grid columns for Bulma grid.
+ */
+export type BulmaFixedGridCols = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12;
+/**
+ * Allowed fixed grid columns prop for Bulma grid.
+ */
+export type BulmaFixedGridColsProp = BulmaFixedGridCols | 'auto';
+/**
+ * Props for the Grid component.
+ */
+export interface GridProps extends React.HTMLAttributes<HTMLDivElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+    /** Use a fixed grid layout (`.fixed-grid > .grid`). */
+    isFixed?: boolean;
+    /** Main gap for grid (Bulma `is-gap-X`). */
+    gap?: BulmaGapValue;
+    /** Column gap for grid (`is-column-gap-X`). */
+    columnGap?: BulmaGapValue;
+    /** Row gap for grid (`is-row-gap-X`). */
+    rowGap?: BulmaGapValue;
+    /** Minimum column width for the grid (`is-col-min-X`). */
+    minCol?: BulmaMinColValue;
+    /** For fixed grids: explicit column count (`has-X-cols`), or `'auto'` for auto-count. */
+    fixedCols?: BulmaFixedGridColsProp;
+    /** For fixed grids: explicit column count for mobile. */
+    fixedColsMobile?: BulmaFixedGridCols;
+    /** For fixed grids: explicit column count for tablet. */
+    fixedColsTablet?: BulmaFixedGridCols;
+    /** For fixed grids: explicit column count for desktop. */
+    fixedColsDesktop?: BulmaFixedGridCols;
+    /** For fixed grids: explicit column count for widescreen. */
+    fixedColsWidescreen?: BulmaFixedGridCols;
+    /** For fixed grids: explicit column count for fullhd. */
+    fixedColsFullhd?: BulmaFixedGridCols;
+    /** Additional CSS classes for the grid. */
+    className?: string;
+    /** Text color. */
+    textColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Bulma color modifier for the grid. */
+    color?: 'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger';
+    /** Background color. */
+    bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Children to render inside the grid (usually `Cell` components). */
+    children?: React.ReactNode;
+}
+export declare const Grid: React.FC<GridProps> & {
+    Cell: React.FC<import("./Cell.js").CellProps>;
+};

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

@@ -0,0 +1,67 @@
+import React, { ReactNode } from 'react';
+/** Supported icon library identifiers. */
+type IconLibrary = 'fa' | 'mdi' | 'ion' | 'material-icons' | 'material-symbols';
+/**
+ * Shape of the configuration context value.
+ *
+ * @property {string} [classPrefix] - Prefix applied to all Bulma class names.
+ * @property {IconLibrary} [iconLibrary] - Default icon library for Icon components.
+ */
+export interface ConfigContextProps {
+    classPrefix?: string;
+    iconLibrary?: IconLibrary;
+}
+/**
+ * Hook to access the bulma-ui configuration context.
+ *
+ * @function
+ * @returns {ConfigContextProps} The current configuration values.
+ */
+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 {
+    children: ReactNode;
+    classPrefix?: string;
+    iconLibrary?: IconLibrary;
+}
+/**
+ * ConfigProvider injects configuration into all child components via React context.
+ *
+ * @function
+ * @param {ConfigProviderProps} props - Provider props.
+ * @returns {JSX.Element} The context provider wrapping children.
+ *
+ * @example
+ * <ConfigProvider classPrefix="my-" iconLibrary="mdi">
+ *   <App />
+ * </ConfigProvider>
+ */
+export declare const ConfigProvider: React.FC<ConfigProviderProps>;
+/**
+ * Utility hook to get the configured class prefix string.
+ *
+ * @function
+ * @returns {string} The class prefix, or empty string if none configured.
+ */
+export declare const useClassPrefix: () => string;
+/**
+ * Hook that returns a function to prefix a class name with the configured prefix.
+ *
+ * @function
+ * @returns {(className: string) => string} A function that applies the class prefix.
+ */
+export declare const usePrefixedClass: () => (className: string) => string;
+/**
+ * Hook to get the default icon library from configuration.
+ *
+ * @function
+ * @returns {IconLibrary | undefined} The configured icon library, or undefined.
+ */
+export declare const useIconLibrary: () => IconLibrary | undefined;
+export {};

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

@@ -0,0 +1,116 @@
+import React, { ReactNode } from 'react';
+import { BulmaClassesProps } from './useBulmaClasses.js';
+declare const bulmaCssVars: readonly ["--bulma-scheme-h", "--bulma-scheme-s", "--bulma-scheme-main", "--bulma-scheme-main-bis", "--bulma-scheme-main-ter", "--bulma-scheme-invert", "--bulma-scheme-invert-bis", "--bulma-scheme-invert-ter", "--bulma-light-l", "--bulma-light-invert-l", "--bulma-dark-l", "--bulma-dark-invert-l", "--bulma-soft-l", "--bulma-bold-l", "--bulma-soft-invert-l", "--bulma-bold-invert-l", "--bulma-hover-background-l-delta", "--bulma-active-background-l-delta", "--bulma-hover-border-l-delta", "--bulma-active-border-l-delta", "--bulma-hover-color-l-delta", "--bulma-active-color-l-delta", "--bulma-hover-shadow-a-delta", "--bulma-active-shadow-a-delta", "--bulma-primary-h", "--bulma-primary-s", "--bulma-primary-l", "--bulma-link-h", "--bulma-link-s", "--bulma-link-l", "--bulma-info-h", "--bulma-info-s", "--bulma-info-l", "--bulma-success-h", "--bulma-success-s", "--bulma-success-l", "--bulma-warning-h", "--bulma-warning-s", "--bulma-warning-l", "--bulma-danger-h", "--bulma-danger-s", "--bulma-danger-l", "--bulma-shadow-h", "--bulma-shadow-s", "--bulma-shadow-l", "--bulma-shadow", "--bulma-family-primary", "--bulma-family-secondary", "--bulma-family-code", "--bulma-size-small", "--bulma-size-normal", "--bulma-size-medium", "--bulma-size-large", "--bulma-weight-light", "--bulma-weight-normal", "--bulma-weight-medium", "--bulma-weight-semibold", "--bulma-weight-bold", "--bulma-weight-extrabold", "--bulma-block-spacing", "--bulma-duration", "--bulma-easing", "--bulma-radius-small", "--bulma-radius", "--bulma-radius-medium", "--bulma-radius-large", "--bulma-radius-rounded", "--bulma-speed", "--bulma-arrow-color", "--bulma-loading-color", "--bulma-burger-h", "--bulma-burger-s", "--bulma-burger-l", "--bulma-burger-border-radius", "--bulma-burger-gap", "--bulma-burger-item-height", "--bulma-burger-item-width", "--bulma-body-background-color", "--bulma-body-size", "--bulma-body-min-width", "--bulma-body-rendering", "--bulma-body-family", "--bulma-body-overflow-x", "--bulma-body-overflow-y", "--bulma-body-color", "--bulma-body-font-size", "--bulma-body-weight", "--bulma-body-line-height", "--bulma-code-family", "--bulma-code-padding", "--bulma-code-weight", "--bulma-code-size", "--bulma-small-font-size", "--bulma-hr-background-color", "--bulma-hr-height", "--bulma-hr-margin", "--bulma-strong-color", "--bulma-strong-weight", "--bulma-pre-font-size", "--bulma-pre-padding", "--bulma-pre-code-font-size", "--bulma-skeleton-background", "--bulma-skeleton-radius", "--bulma-skeleton-block-min-height", "--bulma-skeleton-lines-gap", "--bulma-skeleton-line-height", "--bulma-breadcrumb-item-color", "--bulma-breadcrumb-item-hover-color", "--bulma-breadcrumb-item-active-color", "--bulma-breadcrumb-item-padding-vertical", "--bulma-breadcrumb-item-padding-horizontal", "--bulma-breadcrumb-item-separator-color", "--bulma-card-color", "--bulma-card-background-color", "--bulma-card-shadow", "--bulma-card-radius", "--bulma-card-header-background-color", "--bulma-card-header-color", "--bulma-card-header-padding", "--bulma-card-header-shadow", "--bulma-card-header-weight", "--bulma-card-content-background-color", "--bulma-card-content-padding", "--bulma-card-footer-background-color", "--bulma-card-footer-border-top", "--bulma-card-footer-padding", "--bulma-card-media-margin", "--bulma-dropdown-menu-min-width", "--bulma-dropdown-content-background-color", "--bulma-dropdown-content-offset", "--bulma-dropdown-content-padding-bottom", "--bulma-dropdown-content-padding-top", "--bulma-dropdown-content-radius", "--bulma-dropdown-content-shadow", "--bulma-dropdown-content-z", "--bulma-dropdown-item-h", "--bulma-dropdown-item-s", "--bulma-dropdown-item-l", "--bulma-dropdown-item-background-l", "--bulma-dropdown-item-background-l-delta", "--bulma-dropdown-item-hover-background-l-delta", "--bulma-dropdown-item-active-background-l-delta", "--bulma-dropdown-item-color-l", "--bulma-dropdown-item-selected-h", "--bulma-dropdown-item-selected-s", "--bulma-dropdown-item-selected-l", "--bulma-dropdown-item-selected-background-l", "--bulma-dropdown-item-selected-color-l", "--bulma-dropdown-divider-background-color", "--bulma-menu-item-h", "--bulma-menu-item-s", "--bulma-menu-item-l", "--bulma-menu-item-background-l", "--bulma-menu-item-background-l-delta", "--bulma-menu-item-hover-background-l-delta", "--bulma-menu-item-active-background-l-delta", "--bulma-menu-item-color-l", "--bulma-menu-item-radius", "--bulma-menu-item-selected-h", "--bulma-menu-item-selected-s", "--bulma-menu-item-selected-l", "--bulma-menu-item-selected-background-l", "--bulma-menu-item-selected-color-l", "--bulma-menu-list-border-left", "--bulma-menu-list-line-height", "--bulma-menu-list-link-padding", "--bulma-menu-nested-list-margin", "--bulma-menu-nested-list-padding-left", "--bulma-menu-label-color", "--bulma-menu-label-font-size", "--bulma-menu-label-letter-spacing", "--bulma-menu-label-spacing", "--bulma-message-h", "--bulma-message-s", "--bulma-message-background-l", "--bulma-message-border-l", "--bulma-message-border-l-delta", "--bulma-message-border-style", "--bulma-message-border-width", "--bulma-message-color-l", "--bulma-message-radius", "--bulma-message-header-weight", "--bulma-message-header-padding", "--bulma-message-header-radius", "--bulma-message-header-body-border-width", "--bulma-message-header-background-l", "--bulma-message-header-color-l", "--bulma-message-body-border-width", "--bulma-message-body-color", "--bulma-message-body-padding", "--bulma-message-body-radius", "--bulma-message-body-pre-code-background-color", "--bulma-modal-z", "--bulma-modal-background-background-color", "--bulma-modal-content-width", "--bulma-modal-content-margin-mobile", "--bulma-modal-content-spacing-mobile", "--bulma-modal-content-spacing-tablet", "--bulma-modal-close-dimensions", "--bulma-modal-close-right", "--bulma-modal-close-top", "--bulma-modal-card-spacing", "--bulma-modal-card-head-background-color", "--bulma-modal-card-head-padding", "--bulma-modal-card-head-radius", "--bulma-modal-card-title-color", "--bulma-modal-card-title-line-height", "--bulma-modal-card-title-size", "--bulma-modal-card-foot-background-color", "--bulma-modal-card-foot-radius", "--bulma-modal-card-body-background-color", "--bulma-modal-card-body-padding", "--bulma-navbar-h", "--bulma-navbar-s", "--bulma-navbar-l", "--bulma-navbar-background-color", "--bulma-navbar-box-shadow-size", "--bulma-navbar-box-shadow-color", "--bulma-navbar-padding-vertical", "--bulma-navbar-padding-horizontal", "--bulma-navbar-z", "--bulma-navbar-fixed-z", "--bulma-navbar-item-background-a", "--bulma-navbar-item-background-l", "--bulma-navbar-item-background-l-delta", "--bulma-navbar-item-hover-background-l-delta", "--bulma-navbar-item-active-background-l-delta", "--bulma-navbar-item-color-l", "--bulma-navbar-item-selected-h", "--bulma-navbar-item-selected-s", "--bulma-navbar-item-selected-l", "--bulma-navbar-item-selected-background-l", "--bulma-navbar-item-selected-color-l", "--bulma-navbar-item-img-max-height", "--bulma-navbar-burger-color", "--bulma-navbar-tab-hover-background-color", "--bulma-navbar-tab-hover-border-bottom-color", "--bulma-navbar-tab-active-color", "--bulma-navbar-tab-active-background-color", "--bulma-navbar-tab-active-border-bottom-color", "--bulma-navbar-tab-active-border-bottom-style", "--bulma-navbar-tab-active-border-bottom-width", "--bulma-navbar-dropdown-background-color", "--bulma-navbar-dropdown-border-l", "--bulma-navbar-dropdown-border-color", "--bulma-navbar-dropdown-border-style", "--bulma-navbar-dropdown-border-width", "--bulma-navbar-dropdown-offset", "--bulma-navbar-dropdown-arrow", "--bulma-navbar-dropdown-radius", "--bulma-navbar-dropdown-z", "--bulma-navbar-dropdown-boxed-radius", "--bulma-navbar-dropdown-boxed-shadow", "--bulma-navbar-dropdown-item-h", "--bulma-navbar-dropdown-item-s", "--bulma-navbar-dropdown-item-l", "--bulma-navbar-dropdown-item-background-l", "--bulma-navbar-dropdown-item-color-l", "--bulma-navbar-divider-background-l", "--bulma-navbar-divider-height", "--bulma-navbar-bottom-box-shadow-size", "--bulma-pagination-margin", "--bulma-pagination-min-width", "--bulma-pagination-item-h", "--bulma-pagination-item-s", "--bulma-pagination-item-l", "--bulma-pagination-item-background-l-delta", "--bulma-pagination-item-hover-background-l-delta", "--bulma-pagination-item-active-background-l-delta", "--bulma-pagination-item-border-style", "--bulma-pagination-item-border-width", "--bulma-pagination-item-border-l", "--bulma-pagination-item-border-l-delta", "--bulma-pagination-item-hover-border-l-delta", "--bulma-pagination-item-active-border-l-delta", "--bulma-pagination-item-focus-border-l-delta", "--bulma-pagination-item-color-l", "--bulma-pagination-item-font-size", "--bulma-pagination-item-margin", "--bulma-pagination-item-padding-left", "--bulma-pagination-item-padding-right", "--bulma-pagination-item-outer-shadow-h", "--bulma-pagination-item-outer-shadow-s", "--bulma-pagination-item-outer-shadow-l", "--bulma-pagination-item-outer-shadow-a", "--bulma-pagination-nav-padding-left", "--bulma-pagination-nav-padding-right", "--bulma-pagination-disabled-color", "--bulma-pagination-disabled-background-color", "--bulma-pagination-disabled-border-color", "--bulma-pagination-current-color", "--bulma-pagination-current-background-color", "--bulma-pagination-current-border-color", "--bulma-pagination-ellipsis-color", "--bulma-pagination-shadow-inset", "--bulma-pagination-selected-item-h", "--bulma-pagination-selected-item-s", "--bulma-pagination-selected-item-l", "--bulma-pagination-selected-item-background-l", "--bulma-pagination-selected-item-border-l", "--bulma-pagination-selected-item-color-l", "--bulma-panel-margin", "--bulma-panel-item-border", "--bulma-panel-radius", "--bulma-panel-shadow", "--bulma-panel-heading-line-height", "--bulma-panel-heading-padding", "--bulma-panel-heading-radius", "--bulma-panel-heading-size", "--bulma-panel-heading-weight", "--bulma-panel-tabs-font-size", "--bulma-panel-tab-border-bottom-color", "--bulma-panel-tab-border-bottom-style", "--bulma-panel-tab-border-bottom-width", "--bulma-panel-tab-active-color", "--bulma-panel-list-item-color", "--bulma-panel-list-item-hover-color", "--bulma-panel-block-color", "--bulma-panel-block-hover-background-color", "--bulma-panel-block-active-border-left-color", "--bulma-panel-block-active-color", "--bulma-panel-block-active-icon-color", "--bulma-panel-icon-color", "--bulma-tabs-border-bottom-color", "--bulma-tabs-border-bottom-style", "--bulma-tabs-border-bottom-width", "--bulma-tabs-link-color", "--bulma-tabs-link-hover-border-bottom-color", "--bulma-tabs-link-hover-color", "--bulma-tabs-link-active-border-bottom-color", "--bulma-tabs-link-active-color", "--bulma-tabs-link-padding", "--bulma-tabs-boxed-link-radius", "--bulma-tabs-boxed-link-hover-background-color", "--bulma-tabs-boxed-link-hover-border-bottom-color", "--bulma-tabs-boxed-link-active-background-color", "--bulma-tabs-boxed-link-active-border-color", "--bulma-tabs-boxed-link-active-border-bottom-color", "--bulma-tabs-toggle-link-border-color", "--bulma-tabs-toggle-link-border-style", "--bulma-tabs-toggle-link-border-width", "--bulma-tabs-toggle-link-hover-background-color", "--bulma-tabs-toggle-link-hover-border-color", "--bulma-tabs-toggle-link-radius", "--bulma-tabs-toggle-link-active-background-color", "--bulma-tabs-toggle-link-active-border-color", "--bulma-tabs-toggle-link-active-color", "--bulma-box-background-color", "--bulma-box-color", "--bulma-box-radius", "--bulma-box-shadow", "--bulma-box-padding", "--bulma-box-link-hover-shadow", "--bulma-box-link-active-shadow", "--bulma-content-heading-color", "--bulma-content-heading-weight", "--bulma-content-heading-line-height", "--bulma-content-block-margin-bottom", "--bulma-content-blockquote-background-color", "--bulma-content-blockquote-border-left", "--bulma-content-blockquote-padding", "--bulma-content-pre-padding", "--bulma-content-table-cell-border", "--bulma-content-table-cell-border-width", "--bulma-content-table-cell-padding", "--bulma-content-table-cell-heading-color", "--bulma-content-table-head-cell-border-width", "--bulma-content-table-head-cell-color", "--bulma-content-table-body-last-row-cell-border-bottom-width", "--bulma-content-table-foot-cell-border-width", "--bulma-content-table-foot-cell-color", "--bulma-delete-dimensions", "--bulma-delete-background-l", "--bulma-delete-background-alpha", "--bulma-delete-color", "--bulma-icon-dimensions", "--bulma-icon-dimensions-small", "--bulma-icon-dimensions-medium", "--bulma-icon-dimensions-large", "--bulma-icon-text-spacing", "--bulma-notification-h", "--bulma-notification-s", "--bulma-notification-background-l", "--bulma-notification-color-l", "--bulma-notification-code-background-color", "--bulma-notification-radius", "--bulma-notification-padding", "--bulma-progress-border-radius", "--bulma-progress-bar-background-color", "--bulma-progress-value-background-color", "--bulma-progress-indeterminate-duration", "--bulma-table-color", "--bulma-table-background-color", "--bulma-table-cell-border-color", "--bulma-table-cell-border-style", "--bulma-table-cell-border-width", "--bulma-table-cell-padding", "--bulma-table-cell-heading-color", "--bulma-table-cell-text-align", "--bulma-table-head-cell-border-width", "--bulma-table-head-cell-color", "--bulma-table-foot-cell-border-width", "--bulma-table-foot-cell-color", "--bulma-table-head-background-color", "--bulma-table-body-background-color", "--bulma-table-foot-background-color", "--bulma-table-row-hover-background-color", "--bulma-table-row-active-background-color", "--bulma-table-row-active-color", "--bulma-table-striped-row-even-background-color", "--bulma-table-striped-row-even-hover-background-color", "--bulma-tag-h", "--bulma-tag-s", "--bulma-tag-background-l", "--bulma-tag-background-l-delta", "--bulma-tag-hover-background-l-delta", "--bulma-tag-active-background-l-delta", "--bulma-tag-color-l", "--bulma-tag-radius", "--bulma-tag-delete-margin", "--bulma-title-color", "--bulma-title-family", "--bulma-title-size", "--bulma-title-weight", "--bulma-title-line-height", "--bulma-title-strong-color", "--bulma-title-strong-weight", "--bulma-title-sub-size", "--bulma-title-sup-size", "--bulma-subtitle-color", "--bulma-subtitle-family", "--bulma-subtitle-size", "--bulma-subtitle-weight", "--bulma-subtitle-line-height", "--bulma-subtitle-strong-color", "--bulma-subtitle-strong-weight", "--bulma-control-radius", "--bulma-control-radius-small", "--bulma-control-border-width", "--bulma-control-height", "--bulma-control-line-height", "--bulma-control-padding-vertical", "--bulma-control-padding-horizontal", "--bulma-control-size", "--bulma-control-focus-shadow-l", "--bulma-file-radius", "--bulma-file-name-border-color", "--bulma-file-name-border-style", "--bulma-file-name-border-width", "--bulma-file-name-max-width", "--bulma-file-h", "--bulma-file-s", "--bulma-file-background-l", "--bulma-file-background-l-delta", "--bulma-file-hover-background-l-delta", "--bulma-file-active-background-l-delta", "--bulma-file-border-l", "--bulma-file-border-l-delta", "--bulma-file-hover-border-l-delta", "--bulma-file-active-border-l-delta", "--bulma-file-cta-color-l", "--bulma-file-name-color-l", "--bulma-file-color-l-delta", "--bulma-file-hover-color-l-delta", "--bulma-file-active-color-l-delta", "--bulma-input-h", "--bulma-input-s", "--bulma-input-l", "--bulma-input-border-style", "--bulma-input-border-l", "--bulma-input-border-l-delta", "--bulma-input-hover-border-l-delta", "--bulma-input-active-border-l-delta", "--bulma-input-focus-h", "--bulma-input-focus-s", "--bulma-input-focus-l", "--bulma-input-focus-shadow-size", "--bulma-input-focus-shadow-alpha", "--bulma-input-color-l", "--bulma-input-background-l", "--bulma-input-background-l-delta", "--bulma-input-height", "--bulma-input-shadow", "--bulma-input-placeholder-color", "--bulma-input-disabled-color", "--bulma-input-disabled-background-color", "--bulma-input-disabled-border-color", "--bulma-input-disabled-placeholder-color", "--bulma-input-arrow", "--bulma-input-icon-color", "--bulma-input-icon-hover-color", "--bulma-input-icon-focus-color", "--bulma-input-radius", "--bulma-column-gap", "--bulma-grid-gap", "--bulma-grid-column-count", "--bulma-grid-column-min", "--bulma-grid-cell-column-span", "--bulma-grid-cell-column-start", "--bulma-footer-background-color", "--bulma-footer-color", "--bulma-footer-padding", "--bulma-hero-body-padding", "--bulma-hero-body-padding-tablet", "--bulma-hero-body-padding-small", "--bulma-hero-body-padding-medium", "--bulma-hero-body-padding-large", "--bulma-media-border-color", "--bulma-media-border-size", "--bulma-media-spacing", "--bulma-media-spacing-large", "--bulma-media-content-spacing", "--bulma-media-level-1-spacing", "--bulma-media-level-1-content-spacing", "--bulma-media-level-2-spacing", "--bulma-section-padding", "--bulma-section-padding-desktop", "--bulma-section-padding-medium", "--bulma-section-padding-large"];
+/** A single Bulma CSS variable key from the `bulmaCssVars` tuple. */
+type BulmaVarKey = (typeof bulmaCssVars)[number];
+/** A partial record mapping Bulma CSS variable keys to string values. */
+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 {boolean} [isRoot] - Inject CSS variables globally at :root level. Default: false.
+ * @property {'light' | 'dark' | 'system'} [colorMode] - Set Bulma's light/dark scheme by writing
+ *   the `data-theme` attribute on the document root (`<html>`). This is always global, even on a
+ *   scoped Theme. `'system'` removes the attribute so Bulma follows the OS `prefers-color-scheme`.
+ *   Omit to leave the current setting untouched.
+ * @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'> {
+    children: ReactNode;
+    className?: string;
+    isRoot?: boolean;
+    colorMode?: 'light' | 'dark' | 'system';
+    bulmaVars?: BulmaVars;
+    schemeH?: string;
+    schemeS?: string;
+    lightL?: string;
+    lightInvertL?: string;
+    darkL?: string;
+    darkInvertL?: string;
+    softL?: string;
+    boldL?: string;
+    softInvertL?: string;
+    boldInvertL?: string;
+    hoverBackgroundLDelta?: string;
+    activeBackgroundLDelta?: string;
+    hoverBorderLDelta?: string;
+    activeBorderLDelta?: string;
+    hoverColorLDelta?: string;
+    activeColorLDelta?: string;
+    hoverShadowADelta?: string;
+    activeShadowADelta?: string;
+    primaryH?: string;
+    primaryS?: string;
+    primaryL?: string;
+    linkH?: string;
+    linkS?: string;
+    linkL?: string;
+    infoH?: string;
+    infoS?: string;
+    infoL?: string;
+    successH?: string;
+    successS?: string;
+    successL?: string;
+    warningH?: string;
+    warningS?: string;
+    warningL?: string;
+    dangerH?: string;
+    dangerS?: string;
+    dangerL?: string;
+}
+/**
+ * Theme component that injects Bulma CSS variables either globally or locally.
+ *
+ * When `isRoot` is true, variables are injected at `:root`. Otherwise, a wrapping
+ * `<div>` scopes the variables to its children.
+ *
+ * @function
+ * @param {ThemeProps} props - Props for the Theme component.
+ * @returns {JSX.Element} The theme wrapper or fragment.
+ *
+ * @example
+ * // Local theme scope
+ * <Theme primaryH="171" primaryS="100%" primaryL="41%">
+ *   <Button color="primary">Themed</Button>
+ * </Theme>
+ */
+export declare const Theme: React.FC<ThemeProps>;
+export {};

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

@@ -0,0 +1,37 @@
+import type React from 'react';
+/**
+ * Exactly what `<a>` adds over the attributes every element has: `href`,
+ * `target`, `download`, `hrefLang`, `ping`, `referrerPolicy`, `media`, `type`.
+ *
+ * Subtracted from React's own types rather than listed. Listing them is how
+ * `Level.Item` came to reject `download` at `as="a"` — its list said `href`,
+ * `target`, `rel` and stopped (#641). A list gains an entry when someone
+ * notices; a subtraction gains it when React does.
+ *
+ * NOT `rel`: React declares it on `HTMLAttributes`, for every element, so the
+ * subtraction removes it. A component that withholds `rel` from a non-anchor is
+ * making a compatibility choice rather than stating a fact about anchors, and
+ * says so where it makes it.
+ */
+export type AnchorOnlyAttributes = Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, keyof React.HTMLAttributes<HTMLAnchorElement>>;
+/**
+ * The runtime mirror of `AnchorOnlyAttributes`, keyed so the two cannot drift.
+ *
+ * `Record<keyof …, true>` is what links them: the day React adds an anchor
+ * attribute, every component deriving its props from `as` accepts it and this
+ * object stops compiling until it is named here. A plain array beside a derived
+ * type drifts in the one direction that matters — the type accepts the new
+ * attribute and the filter lets it leak onto a `<div>`.
+ */
+export declare const ANCHOR_ONLY_ATTRS: Readonly<Record<keyof AnchorOnlyAttributes, true>>;
+/**
+ * `props` without the keys named in `strip`.
+ *
+ * The SET is per component and deliberately not shared, because the right
+ * answer differs and the differences are principled: how open the component's
+ * `as` is, and which of these attributes its own tags legitimately take. What
+ * IS shared is the derived source of truth above and this function. Each caller
+ * declares its delta next to the set it passes, which is the only place that
+ * stays true when a component's `as` changes.
+ */
+export declare function omitAttrs<T extends object, K extends string>(props: T, strip: Readonly<Record<K, true>>): Omit<T, K>;

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

@@ -0,0 +1,197 @@
+/**
+ * Valid Bulma color classes.
+ * @example 'primary', 'link', 'info'
+ */
+export declare const validColors: readonly ["primary", "link", "info", "success", "warning", "danger", "black", "black-bis", "black-ter", "grey-darker", "grey-dark", "grey", "grey-light", "grey-lighter", "white", "white-bis", "white-ter", "light", "dark"];
+/**
+ * Valid Bulma color shade suffixes.
+ * @example '00', '05', 'invert', 'light', 'dark', 'soft', 'bold', 'on-scheme'
+ */
+export declare const validColorShades: readonly ["00", "05", "10", "15", "20", "25", "30", "35", "40", "45", "50", "55", "60", "65", "70", "75", "80", "85", "90", "95", "invert", "light", "dark", "soft", "bold", "on-scheme"];
+/**
+ * Valid Bulma scheme color names for scheme-aware backgrounds.
+ *
+ * Bulma ships no `has-background-scheme-*` helper classes, so these values
+ * never emit a class — components render them as a dark-mode-safe inline
+ * `background-color: var(--bulma-<value>)` style instead.
+ * @example 'scheme-main', 'scheme-main-bis', 'scheme-invert'
+ */
+export declare const validSchemeColors: readonly ["scheme-main", "scheme-main-bis", "scheme-main-ter", "scheme-invert", "scheme-invert-bis", "scheme-invert-ter"];
+/**
+ * Valid Bulma size classes for margins and paddings.
+ * @example '0', '1', 'auto'
+ */
+export declare const validSizes: readonly ["0", "1", "2", "3", "4", "5", "6", "auto"];
+/**
+ * Valid Bulma text size classes.
+ * @example '1', '2', '3'
+ */
+export declare const validTextSizes: readonly ["1", "2", "3", "4", "5", "6", "7"];
+/**
+ * Valid Bulma text alignment classes.
+ * @example 'centered', 'left', 'right'
+ */
+export declare const validAlignments: readonly ["centered", "justified", "left", "right"];
+/**
+ * Valid Bulma text transformation classes.
+ * @example 'capitalized', 'uppercase', 'italic'
+ */
+export declare const validTextTransforms: readonly ["capitalized", "lowercase", "uppercase", "italic"];
+/**
+ * Valid Bulma text weight classes.
+ * @example 'light', 'normal', 'bold'
+ */
+export declare const validTextWeights: readonly ["light", "normal", "medium", "semibold", "bold"];
+/**
+ * Valid Bulma font family classes.
+ * @example 'sans-serif', 'monospace', 'code'
+ */
+export declare const validFontFamilies: readonly ["sans-serif", "monospace", "primary", "secondary", "code"];
+/**
+ * Valid Bulma display classes.
+ * @example 'block', 'flex', 'inline'
+ */
+export declare const validDisplays: readonly ["block", "flex", "inline", "inline-block", "inline-flex", "grid"];
+/**
+ * Valid Bulma visibility classes.
+ * These are all the valid visibility options available in Bulma.
+ * @example 'hidden', 'sr-only', 'invisible'
+ */
+export declare const validVisibilities: readonly ["hidden", "sr-only", "invisible"];
+/**
+ * Valid Bulma flex direction classes.
+ * @example 'row', 'column', 'row-reverse'
+ */
+export declare const validFlexDirections: readonly ["row", "row-reverse", "column", "column-reverse"];
+/**
+ * Valid Bulma flex wrap classes.
+ * @example 'nowrap', 'wrap', 'wrap-reverse'
+ */
+export declare const validFlexWraps: readonly ["nowrap", "wrap", "wrap-reverse"];
+/**
+ * Valid Bulma justify-content classes.
+ * @example 'flex-start', 'center', 'space-between'
+ */
+export declare const validJustifyContents: readonly ["flex-start", "flex-end", "center", "space-between", "space-around", "space-evenly", "start", "end", "left", "right"];
+/**
+ * Valid Bulma align-content classes.
+ * @example 'flex-start', 'center', 'stretch'
+ */
+export declare const validAlignContents: readonly ["flex-start", "flex-end", "center", "space-between", "space-around", "space-evenly", "stretch"];
+/**
+ * Valid Bulma align-items classes.
+ * @example 'stretch', 'flex-start', 'center'
+ */
+export declare const validAlignItems: readonly ["stretch", "flex-start", "flex-end", "center", "baseline", "start", "end"];
+/**
+ * Valid Bulma align-self classes.
+ * @example 'auto', 'flex-start', 'center'
+ */
+export declare const validAlignSelfs: readonly ["auto", "flex-start", "flex-end", "center", "baseline", "stretch"];
+/**
+ * Valid Bulma flex grow and shrink values.
+ * @example '0', '1', '2', '3', '4', '5'
+ */
+export declare const validFlexGrowShrink: readonly ["0", "1", "2", "3", "4", "5"];
+/**
+ * Valid Bulma viewport classes for responsive design.
+ * @example 'mobile', 'tablet', 'desktop'
+ */
+export declare const validViewports: readonly ["mobile", "tablet", "tablet-only", "touch", "desktop", "desktop-only", "widescreen", "widescreen-only", "fullhd"];
+/**
+ * Valid Bulma float classes.
+ * @example 'left', 'right'
+ */
+export declare const validFloats: readonly ["left", "right"];
+/**
+ * Valid Bulma overflow classes.
+ * @example 'clipped'
+ */
+export declare const validOverflows: readonly ["clipped"];
+/**
+ * Valid Bulma interaction classes.
+ * @example 'unselectable', 'clickable'
+ */
+export declare const validInteractions: readonly ["unselectable", "clickable"];
+/**
+ * Valid Bulma cursor helper values.
+ *
+ * These share no class stem: `pointer` renders `is-clickable` and `help`
+ * renders `is-cursor-help`, so the class each one emits lives in
+ * `cursorClasses` rather than being built from the value.
+ * @example 'pointer', 'help'
+ */
+export declare const validCursors: readonly ["pointer", "help"];
+/**
+ * Cursor helper value to the class it renders.
+ *
+ * A `Record` over `validCursors` on purpose: TypeScript then rejects a value
+ * added to the tuple with no class for it, and a class for a value the tuple
+ * does not carry, so the accepted set and the rendered classes cannot drift
+ * apart.
+ */
+export declare const cursorClasses: Record<(typeof validCursors)[number], string>;
+/**
+ * Valid Bulma border-radius helper classes.
+ * @example 'radiusless'
+ */
+export declare const validRadii: readonly ["radiusless"];
+/**
+ * Valid Bulma shadow helper classes.
+ * @example 'shadowless'
+ */
+export declare const validShadows: readonly ["shadowless"];
+/**
+ * Valid Bulma responsive helper classes.
+ * @example 'mobile', 'narrow'
+ */
+export declare const validResponsives: readonly ["mobile", "narrow"];
+/**
+ * Props for applying a Bulma viewport modifier to viewport-aware helper classes.
+ */
+export interface BulmaViewportProps {
+    /** Viewport for responsive classes (e.g., 'mobile', 'desktop'). */
+    viewport?: (typeof validViewports)[number];
+}
+/**
+ * Props for applying Bulma display helper classes, including viewport-specific
+ * display variants.
+ */
+export interface BulmaDisplayProps {
+    /** Display type (e.g., 'block', 'flex'). */
+    display?: (typeof validDisplays)[number] | 'none';
+    /** Display type for mobile viewport (up to 768px). */
+    displayMobile?: (typeof validDisplays)[number] | 'none';
+    /** Display type for tablet viewport (769px - 1023px). */
+    displayTablet?: (typeof validDisplays)[number] | 'none';
+    /** Display type for tablet-only viewport (769px - 1023px, excludes desktop+). */
+    displayTabletOnly?: (typeof validDisplays)[number] | 'none';
+    /** Display type for touch viewport (up to 1023px; mobile + tablet). */
+    displayTouch?: (typeof validDisplays)[number] | 'none';
+    /** Display type for desktop viewport (1024px - 1215px). */
+    displayDesktop?: (typeof validDisplays)[number] | 'none';
+    /** Display type for desktop-only viewport (1024px - 1215px, excludes widescreen+). */
+    displayDesktopOnly?: (typeof validDisplays)[number] | 'none';
+    /** Display type for widescreen viewport (1216px - 1407px). */
+    displayWidescreen?: (typeof validDisplays)[number] | 'none';
+    /** Display type for widescreen-only viewport (1216px - 1407px, excludes fullhd). */
+    displayWidescreenOnly?: (typeof validDisplays)[number] | 'none';
+    /** Display type for fullhd viewport (1408px and above). */
+    displayFullhd?: (typeof validDisplays)[number] | 'none';
+}
+/**
+ * Creates the shared class-building helpers used by the Bulma helper hooks.
+ *
+ * Returns a mutable `classes` array along with the helper functions that push
+ * (optionally prefixed, optionally viewport-suffixed) class names onto it.
+ *
+ * @internal
+ * @param classPrefix - Optional prefix applied to all generated class names.
+ * @param viewport - Optional viewport modifier for viewport-aware classes.
+ */
+export declare const createBulmaClassHelpers: (classPrefix?: string, viewport?: (typeof validViewports)[number]) => {
+    classes: string[];
+    addPrefixedClass: (className: string) => void;
+    addClass: (prefix: string, value: string | undefined, validValues: readonly string[], supportsViewport?: boolean, supportedViewports?: readonly string[]) => void;
+    addClassNoViewport: (prefix: string, value: string | undefined, validValues: readonly string[]) => void;
+};