@allxsmith/bestax-bulma 5.9.0 → 5.10.0

package/dist/types/columns/Column.d.ts

@@ -1,9 +1,9 @@
 import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
 /**
- * Possible values for Bulma column size.
+ * Possible values for Bulma column size: a number 1–12 (as a number or a numeric string, `7` and `"7"` are equivalent) or a named fraction.
  */
-export type BulmaColumnSize = number | 'full' | 'half' | 'one-third' | 'two-thirds' | 'one-quarter' | 'three-quarters' | 'one-fifth' | 'two-fifths' | 'three-fifths' | 'four-fifths';
+export type BulmaColumnSize = number | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' | '10' | '11' | '12' | 'full' | 'half' | 'one-third' | 'two-thirds' | 'one-quarter' | 'three-quarters' | 'one-fifth' | 'two-fifths' | 'three-fifths' | 'four-fifths';
 /**
  * Props for the Column component.
  */

package/dist/types/components/Card.d.ts

@@ -38,7 +38,13 @@ export interface CardProps extends React.HTMLAttributes<HTMLDivElement>, Omit<Bu
 /**
  * Props for the Card.Header compound component.
  */
-export interface CardHeaderProps extends React.HTMLAttributes<HTMLElement> {
+export interface CardHeaderProps extends React.HTMLAttributes<HTMLElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+    /** Bulma color modifier (text color helper). */
+    color?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Background color helper. */
+    bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Text color helper; wins over `color` when both are set. */
+    textColor?: (typeof validColors)[number] | 'inherit' | 'current';
     /** Additional CSS classes. */
     className?: string;
     /** Header content. Wrap in Card.Header.Title for Bulma styling. */
@@ -49,7 +55,13 @@ export interface CardHeaderProps extends React.HTMLAttributes<HTMLElement> {
 /**
  * Props for the Card.Image compound component.
  */
-export interface CardImageProps extends React.HTMLAttributes<HTMLDivElement> {
+export interface CardImageProps extends React.HTMLAttributes<HTMLDivElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+    /** Bulma color modifier (text color helper). */
+    color?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Background color helper. */
+    bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Text color helper; wins over `color` when both are set. */
+    textColor?: (typeof validColors)[number] | 'inherit' | 'current';
     /** Additional CSS classes. */
     className?: string;
     /** Image content (e.g. a `<figure>` with an `<img>`). */
@@ -58,7 +70,13 @@ export interface CardImageProps extends React.HTMLAttributes<HTMLDivElement> {
 /**
  * Props for the Card.Content compound component.
  */
-export interface CardContentProps extends React.HTMLAttributes<HTMLDivElement> {
+export interface CardContentProps extends React.HTMLAttributes<HTMLDivElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+    /** Bulma color modifier (text color helper). */
+    color?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Background color helper. */
+    bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Text color helper; wins over `color` when both are set. */
+    textColor?: (typeof validColors)[number] | 'inherit' | 'current';
     /** Additional CSS classes. */
     className?: string;
     /** Card body content. */
@@ -67,7 +85,13 @@ export interface CardContentProps extends React.HTMLAttributes<HTMLDivElement> {
 /**
  * Props for the Card.Footer compound component.
  */
-export interface CardFooterProps extends React.HTMLAttributes<HTMLElement> {
+export interface CardFooterProps extends React.HTMLAttributes<HTMLElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+    /** Bulma color modifier (text color helper). */
+    color?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Background color helper. */
+    bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Text color helper; wins over `color` when both are set. */
+    textColor?: (typeof validColors)[number] | 'inherit' | 'current';
     /** Additional CSS classes. */
     className?: string;
     /** Footer content, typically Card.FooterItem elements. */
@@ -76,7 +100,13 @@ export interface CardFooterProps extends React.HTMLAttributes<HTMLElement> {
 /**
  * Props for the Card.FooterItem compound component.
  */
-export interface CardFooterItemProps extends React.HTMLAttributes<HTMLSpanElement> {
+export interface CardFooterItemProps extends React.HTMLAttributes<HTMLSpanElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+    /** Bulma color modifier (text color helper). */
+    color?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Background color helper. */
+    bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Text color helper; wins over `color` when both are set. */
+    textColor?: (typeof validColors)[number] | 'inherit' | 'current';
     /** Additional CSS classes. */
     className?: string;
     /** Footer item content (link, button, text, etc.). */
@@ -85,7 +115,13 @@ export interface CardFooterItemProps extends React.HTMLAttributes<HTMLSpanElemen
 /**
  * Props for the Card.Header.Title compound component.
  */
-export interface CardHeaderTitleProps extends React.HTMLAttributes<HTMLDivElement> {
+export interface CardHeaderTitleProps extends React.HTMLAttributes<HTMLDivElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+    /** Bulma color modifier (text color helper). */
+    color?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Background color helper. */
+    bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Text color helper; wins over `color` when both are set. */
+    textColor?: (typeof validColors)[number] | 'inherit' | 'current';
     /** Additional CSS classes. */
     className?: string;
     /** Title text content. */
@@ -96,7 +132,13 @@ export interface CardHeaderTitleProps extends React.HTMLAttributes<HTMLDivElemen
 /**
  * Props for the Card.Header.Icon compound component.
  */
-export interface CardHeaderIconProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+export interface CardHeaderIconProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+    /** Bulma color modifier (text color helper). */
+    color?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Background color helper. */
+    bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Text color helper; wins over `color` when both are set. */
+    textColor?: (typeof validColors)[number] | 'inherit' | 'current';
     /** Additional CSS classes. */
     className?: string;
     /** Icon content (e.g. an icon element). */

package/dist/types/components/Sidebar.d.ts

@@ -17,6 +17,8 @@ export interface SidebarProps extends Omit<React.HTMLAttributes<HTMLElement>, 'c
     /** Custom width of the sidebar. */
     width?: string;
     /** Sidebar takes full width (mobile-style). */
+    isFullwidth?: boolean;
+    /** Sidebar takes full width (mobile-style). @deprecated Use `isFullwidth` instead — `isFullwidth` wins if both are set. */
     fullWidth?: boolean;
     /** Show overlay behind sidebar. Default: true. */
     overlay?: boolean;

package/dist/types/components/Tabs.d.ts

@@ -9,6 +9,10 @@ export interface TabsProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'o
     /** Tab size. */
     size?: 'small' | 'medium' | 'large';
     /** Tabs expand to fill the horizontal space. */
+    isFullwidth?: boolean;
+    /** Tabs expand to fill the horizontal space. @deprecated Use `isFullwidth` instead — `isFullwidth` wins if both are set. */
+    isFullWidth?: boolean;
+    /** Tabs expand to fill the horizontal space. @deprecated Use `isFullwidth` instead — `isFullwidth` wins if both are set. */
     fullwidth?: boolean;
     /** Tabs use the boxed style. */
     boxed?: boolean;

package/dist/types/elements/Button.d.ts

@@ -17,6 +17,8 @@ export interface ButtonProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonE
     /** Makes the button non-interactive. */
     isStatic?: boolean;
     /** Makes the button full-width. */
+    isFullwidth?: boolean;
+    /** Makes the button full-width. @deprecated Use `isFullwidth` instead — `isFullwidth` wins if both are set. */
     isFullWidth?: boolean;
     /** Applies outlined styling (requires color). */
     isOutlined?: boolean;

package/dist/types/elements/LinkButton.d.ts

@@ -4,7 +4,7 @@ import { ButtonProps } from './Button';
  * Props for the LinkButton component.
  */
 export interface LinkButtonProps extends Omit<ButtonProps, 'color' | 'isOutlined' | 'isInverted' | 'isLight'> {
-    /** Display mode. `text` has no underline; `ghost` uses default text color. */
+    /** Display mode. `text` has no underline and highlights its background on hover; `ghost` uses the default text color and underlines on hover; `underline` drops the button chrome entirely (transparent background and border) and underlines on hover or focus. */
     variant?: 'text' | 'ghost' | 'underline';
     /** Text color override for the button. */
     color?: 'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger' | 'white' | 'light' | 'dark' | 'black';

package/dist/types/elements/SubTitle.d.ts

@@ -1,10 +1,9 @@
 import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
-declare const validSubTitleSizes: readonly ["1", "2", "3", "4", "5", "6"];
 /**
- * Valid size values for the SubTitle component (Bulma subtitle sizes).
+ * Valid size values for the SubTitle component (Bulma subtitle sizes): `'1'`–`'6'` as a string or number (`3` and `'3'` are equivalent).
  */
-export type SubTitleSize = (typeof validSubTitleSizes)[number];
+export type SubTitleSize = '1' | '2' | '3' | '4' | '5' | '6' | 1 | 2 | 3 | 4 | 5 | 6;
 declare const validSubTitleElements: readonly ["h1", "h2", "h3", "h4", "h5", "h6", "p"];
 /**
  * Valid HTML elements for the SubTitle component.
@@ -17,7 +16,7 @@ export type SubTitleElement = (typeof validSubTitleElements)[number];
 export interface SubTitleProps extends Omit<React.HTMLAttributes<HTMLHeadingElement | HTMLParagraphElement>, 'color'>, Omit<BulmaClassesProps, 'backgroundColor' | 'color'> {
     /** Additional CSS classes to apply. */
     className?: string;
-    /** Size of the subtitle (Bulma sizes). */
+    /** Size of the subtitle (Bulma sizes `1`-`6`, as a string or number). */
     size?: SubTitleSize;
     /** HTML element to render as (h1-h6 or p). */
     as?: SubTitleElement;

package/dist/types/elements/Table.d.ts

@@ -19,6 +19,8 @@ export interface TableProps extends Omit<React.TableHTMLAttributes<HTMLTableElem
     isHoverable?: boolean;
     /** Makes the table span the full width of its parent. */
     isFullwidth?: boolean;
+    /** Makes the table span the full width of its parent. @deprecated Use `isFullwidth` instead — `isFullwidth` wins if both are set. */
+    isFullWidth?: boolean;
     /** Makes the table horizontally scrollable on small screens. */
     isResponsive?: boolean;
     /** Table content (should use subcomponents). */

package/dist/types/elements/Tag.d.ts

@@ -20,6 +20,8 @@ export interface TagProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, 'c
     color?: TagColor;
     /** Tag size. */
     size?: TagSize;
+    /** Use the light color variant. */
+    isLight?: boolean;
     /** Renders a rounded tag. */
     isRounded?: boolean;
     /** Renders a delete-style tag (delete button). */

package/dist/types/elements/Title.d.ts

@@ -1,10 +1,9 @@
 import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
-declare const validTitleSizes: readonly ["1", "2", "3", "4", "5", "6"];
 /**
- * Valid size values for the Title component (Bulma title sizes).
+ * Valid size values for the Title component (Bulma title sizes): `'1'`–`'6'` as a string or number (`3` and `'3'` are equivalent).
  */
-export type TitleSize = (typeof validTitleSizes)[number];
+export type TitleSize = '1' | '2' | '3' | '4' | '5' | '6' | 1 | 2 | 3 | 4 | 5 | 6;
 declare const validTitleElements: readonly ["h1", "h2", "h3", "h4", "h5", "h6", "p"];
 /**
  * Valid HTML elements for the Title component.
@@ -17,7 +16,7 @@ export type TitleElement = (typeof validTitleElements)[number];
 export interface TitleProps extends Omit<React.HTMLAttributes<HTMLHeadingElement | HTMLParagraphElement>, 'color'>, Omit<BulmaClassesProps, 'backgroundColor' | 'color'> {
     /** Additional CSS classes to apply. */
     className?: string;
-    /** Size of the title (Bulma sizes). */
+    /** Size of the title (Bulma sizes `1`-`6`, as a string or number). */
     size?: TitleSize;
     /** Adds margin below the title. */
     isSpaced?: boolean;

package/dist/types/form/File.d.ts

@@ -19,6 +19,8 @@ export interface FileProps extends Omit<React.InputHTMLAttributes<HTMLInputEleme
     isBoxed?: boolean;
     /** Whether the file input expands to full width. */
     isFullwidth?: boolean;
+    /** Whether the file input expands to full width. @deprecated Use `isFullwidth` instead — `isFullwidth` wins if both are set. */
+    isFullWidth?: boolean;
     /** Position the CTA on the right (with `hasName`). */
     isRight?: boolean;
     /** Center the file input within its container. */

package/dist/types/form/Numberinput.d.ts

@@ -76,4 +76,8 @@ export interface NumberinputProps extends Omit<React.InputHTMLAttributes<HTMLInp
  * <Numberinput variant="stepper" color="primary" step={10} />
  */
 export declare const Numberinput: React.ForwardRefExoticComponent<NumberinputProps & React.RefAttributes<HTMLInputElement>>;
+/** @deprecated Use `Numberinput` — same component. */
+export declare const NumberInput: React.ForwardRefExoticComponent<NumberinputProps & React.RefAttributes<HTMLInputElement>>;
+/** @deprecated Use `NumberinputProps`. */
+export type NumberInputProps = NumberinputProps;
 export default Numberinput;

package/dist/types/form/SelectBase.d.ts

@@ -20,6 +20,8 @@ export interface SelectBaseProps extends Omit<React.SelectHTMLAttributes<HTMLSel
     isFocused?: boolean;
     /** Makes the select span the full width of parent. */
     isFullwidth?: boolean;
+    /** Makes the select span the full width of parent. @deprecated Use `isFullwidth` instead — `isFullwidth` wins if both are set. */
+    isFullWidth?: boolean;
     /** Additional CSS classes to apply. */
     className?: string;
     /** Disables the select. */

package/dist/types/form/Taginput.d.ts

@@ -133,4 +133,8 @@ export interface TaginputProps extends Omit<React.HTMLAttributes<HTMLDivElement>
  * />
  */
 export declare const Taginput: React.ForwardRefExoticComponent<TaginputProps & React.RefAttributes<HTMLInputElement>>;
+/** @deprecated Use `Taginput` — same component. */
+export declare const TagInput: React.ForwardRefExoticComponent<TaginputProps & React.RefAttributes<HTMLInputElement>>;
+/** @deprecated Use `TaginputProps`. */
+export type TagInputProps = TaginputProps;
 export default Taginput;

package/llms.txt

@@ -7,3 +7,4 @@ React components for Bulma v1.
 - Any docs page as markdown: append .md (e.g. https://bestax.io/docs/api/elements/button.md)
 - LLM guide: https://bestax.io/docs/guides/llms
 - Agent skills: https://bestax.io/docs/skills/intro
+- MCP server: `npx bestax-mcp` — setup at https://bestax.io/docs/guides/llms#mcp-server

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allxsmith/bestax-bulma",
-  "version": "5.9.0",
+  "version": "5.10.0",
   "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.js",
   "module": "dist/index.esm.js",