@allxsmith/bestax-bulma 5.15.3 → 5.16.0

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

@@ -10,12 +10,10 @@ export interface NotificationProps extends React.HTMLAttributes<HTMLDivElement>,
      * Bulma color modifier for the notification (renders `is-<color>`).
      *
      * Only `primary`, `link`, `info`, `success`, `warning`, `danger`, `black`,
-     * `white`, `light`, and `dark` have shipped CSS for `.notification`. The
-     * other accepted values (`black-bis`, `black-ter`, `grey-darker`,
-     * `grey-dark`, `grey`, `grey-light`, `grey-lighter`) emit a class no CSS
-     * rule matches, so the notification renders unstyled; they log a console
-     * warning in development and will be removed from this union in the next
-     * major version.
+     * `white`, `light`, and `dark` have shipped CSS for `.notification`. Every
+     * other value the union accepts emits a class no CSS rule matches, so the
+     * notification renders unstyled; those log a console warning in development
+     * and will be removed from this union in the next major version.
      */
     color?: (typeof validColors)[number];
     /** Text color helper. */
@@ -50,12 +48,10 @@ export interface NotificationOptions {
      * Bulma color modifier for the notification (renders `is-<color>`).
      *
      * Only `primary`, `link`, `info`, `success`, `warning`, `danger`, `black`,
-     * `white`, `light`, and `dark` have shipped CSS for `.notification`. The
-     * other accepted values (`black-bis`, `black-ter`, `grey-darker`,
-     * `grey-dark`, `grey`, `grey-light`, `grey-lighter`) emit a class no CSS
-     * rule matches, so the notification renders unstyled; they log a console
-     * warning in development and will be removed from this union in the next
-     * major version.
+     * `white`, `light`, and `dark` have shipped CSS for `.notification`. Every
+     * other value the union accepts emits a class no CSS rule matches, so the
+     * notification renders unstyled; those log a console warning in development
+     * and will be removed from this union in the next major version.
      */
     color?: (typeof validColors)[number];
     /** Use the light color variant. */

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

@@ -10,11 +10,10 @@ export interface ProgressProps extends React.ProgressHTMLAttributes<HTMLProgress
      * Bulma color modifier for the progress bar (renders `is-<color>`).
      *
      * Only `primary`, `link`, `info`, `success`, `warning`, `danger`, `black`,
-     * `white`, `light`, and `dark` have shipped CSS for `.progress`. The other
-     * accepted values (`black-bis`, `black-ter`, `grey-darker`, `grey-dark`,
-     * `grey`, `grey-light`, `grey-lighter`) emit a class no CSS rule matches, so
-     * the bar renders unstyled; they log a console warning in development and
-     * will be removed from this union in the next major version.
+     * `white`, `light`, and `dark` have shipped CSS for `.progress`. Every
+     * other value the union accepts emits a class no CSS rule matches, so the
+     * bar renders unstyled; those log a console warning in development and will
+     * be removed from this union in the next major version.
      */
     color?: (typeof validColors)[number];
     /** Size modifier for the progress bar. */

package/dist/types/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/helpers/bulmaClassHelpers.d.ts

@@ -2,7 +2,7 @@
  * 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", "light", "dark"];
+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'
@@ -98,6 +98,54 @@ export declare const validFlexGrowShrink: readonly ["0", "1", "2", "3", "4", "5"
  * @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.
  */

package/dist/types/helpers/colorDeprecations.d.ts

@@ -4,7 +4,7 @@
  * `has-background-*` helpers DO cover these values — only the
  * component-modifier form is dead.
  */
-export declare const UNSTYLED_MODIFIER_COLORS: readonly ["black-bis", "black-ter", "grey-darker", "grey-dark", "grey", "grey-light", "grey-lighter"];
+export declare const UNSTYLED_MODIFIER_COLORS: readonly ["black-bis", "black-ter", "white-bis", "white-ter", "grey-darker", "grey-dark", "grey", "grey-light", "grey-lighter"];
 /** Test-only: re-arm the warn-once registry. */
 export declare const resetColorDeprecationWarnings: () => void;
 /**

package/dist/types/helpers/useBulmaClasses.d.ts

@@ -50,7 +50,7 @@ export declare const useBulmaClasses: <T extends object>(props: BulmaClassesProp
     bulmaHelperStyles?: CSSProperties;
     rest: Omit<T, keyof BulmaClassesProps>;
 };
-export { validColors, validColorShades, validSchemeColors, validSizes, validTextSizes, validAlignments, validTextTransforms, validTextWeights, validFontFamilies, validDisplays, validVisibilities, validFlexDirections, validFlexWraps, validJustifyContents, validAlignContents, validAlignItems, validAlignSelfs, validFlexGrowShrink, validViewports, } from './bulmaClassHelpers';
+export { validColors, validColorShades, validSchemeColors, validSizes, validTextSizes, validAlignments, validTextTransforms, validTextWeights, validFontFamilies, validDisplays, validVisibilities, validFlexDirections, validFlexWraps, validJustifyContents, validAlignContents, validAlignItems, validAlignSelfs, validFlexGrowShrink, validViewports, validFloats, validOverflows, validInteractions, validCursors, validRadii, validShadows, validResponsives, } from './bulmaClassHelpers';
 export type { BulmaViewportProps, BulmaDisplayProps };
 export * from './useColorClasses';
 export * from './useSpacingClasses';

package/dist/types/helpers/useOtherClasses.d.ts

@@ -1,23 +1,24 @@
+import { validCursors, validFloats, validInteractions, validOverflows, validRadii, validResponsives, validShadows } from './bulmaClassHelpers';
 /**
  * Props for applying miscellaneous Bulma helper classes.
  */
 export interface BulmaOtherProps {
     /** Float direction (e.g., 'left', 'right'). */
-    float?: 'left' | 'right';
+    float?: (typeof validFloats)[number];
     /** Overflow behavior (e.g., 'clipped'). */
-    overflow?: 'clipped';
+    overflow?: (typeof validOverflows)[number];
     /** Applies overlay styling if true. */
     overlay?: boolean;
     /** Interaction behavior (e.g., 'unselectable', 'clickable'). */
-    interaction?: 'unselectable' | 'clickable';
+    interaction?: (typeof validInteractions)[number];
     /** Cursor style (e.g., 'pointer', 'help'). */
-    cursor?: 'pointer' | 'help';
+    cursor?: (typeof validCursors)[number];
     /** Border radius style (e.g., 'radiusless'). */
-    radius?: 'radiusless';
+    radius?: (typeof validRadii)[number];
     /** Shadow style (e.g., 'shadowless'). */
-    shadow?: 'shadowless';
+    shadow?: (typeof validShadows)[number];
     /** Responsive behavior (e.g., 'mobile', 'narrow'). */
-    responsive?: 'mobile' | 'narrow';
+    responsive?: (typeof validResponsives)[number];
     /** Add Bulma skeleton class if true. */
     skeleton?: boolean;
     /** Applies clearfix to fix floating children if true. */

package/dist/types/layout/Hero.d.ts

@@ -14,12 +14,10 @@ export interface HeroProps extends React.HTMLAttributes<HTMLElement>, Omit<Bulma
      * Bulma color modifier for the hero section (renders `is-<color>`).
      *
      * Only `primary`, `link`, `info`, `success`, `warning`, `danger`, `black`,
-     * `white`, `light`, and `dark` have shipped CSS for `.hero`. The other
-     * accepted values (`black-bis`, `black-ter`, `grey-darker`, `grey-dark`,
-     * `grey`, `grey-light`, `grey-lighter`, `inherit`, `current`) emit a class
-     * no CSS rule matches, so the hero renders unstyled; they log a console
-     * warning in development and will be removed from this union in the next
-     * major version.
+     * `white`, `light`, and `dark` have shipped CSS for `.hero`. Every other
+     * value the union accepts emits a class no CSS rule matches, so the hero
+     * renders unstyled; those log a console warning in development and will be
+     * removed from this union in the next major version.
      */
     color?: (typeof validColors)[number] | 'inherit' | 'current';
     /** Hero size. */

package/dist/types/layout/Level.d.ts

@@ -1,4 +1,5 @@
 import React from 'react';
+import { type AnchorOnlyAttributes } from '../helpers/anchorAttrs';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
 /**
  * Props for the Level component.
@@ -64,38 +65,20 @@ export interface LevelRightProps extends React.HTMLAttributes<HTMLDivElement>, O
  * @returns {JSX.Element} The rendered level right section.
  */
 export declare const LevelRight: React.FC<LevelRightProps>;
-/**
- * Exactly what `<a>` adds over the attributes every element has: `href`,
- * `target`, `download`, `hrefLang`, `ping`, `referrerPolicy`, `media`, `type`.
- *
- * NOT `rel`, which React declares on `HTMLAttributes` for every element and the
- * subtraction therefore removes. This component withholds it from a non-anchor
- * anyway, because it always has — see `ANCHOR_ONLY` in the implementation,
- * where it is named separately for that reason.
- *
- * Subtracted from React's own types rather than listed. Listing them is how this
- * component came to reject `download` at `as="a"` — the list said `href`,
- * `target`, `rel` and stopped, and #641 is the report. A list gains an entry only
- * when someone notices; a subtraction gains it when React does.
- *
- * They reach the `<a>` branch and no other: declared at every `as` because
- * narrowing them to the anchor is source-breaking (#672, `next-major`), and
- * withheld at runtime so the type's permissiveness costs no dead markup.
- */
-type AnchorOnlyAttributes = Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, keyof React.HTMLAttributes<HTMLAnchorElement>>;
 /**
  * Props for the LevelItem component.
  *
- * The anchor attributes are enumerated here, at every `as`, and forwarded only
- * when the tag is an `<a>` — so `<Level.Item as="p" download>` compiles and
+ * The anchor attributes arrive through `AnchorOnlyAttributes`, at every `as`, and
+ * are forwarded only when the tag is an `<a>` — so `<Level.Item as="p" download>` compiles and
  * renders a `<p>` without it. That asymmetry is deliberate for now: deriving
  * them from `as` instead is what makes the dead pair a type error, and it also
  * stops `const p: LevelItemProps = { href }` compiling for consumers who write
  * it today. #672 carries that half, labelled `next-major`.
  *
- * What this list must NOT become is a shorter one. Enumerating only `href`,
+ * What that set must NOT become is a hand-written list. Enumerating only `href`,
  * `target` and `rel` made every other anchor attribute a type error even at
- * `as="a"`, which is what #641 reported.
+ * `as="a"`, which is what #641 reported; `helpers/anchorAttrs.ts` derives it from
+ * React instead, and `ANCHOR_ONLY_ATTRS` there is the guard to protect.
  */
 export interface LevelItemProps extends AnchorOnlyAttributes, React.HTMLAttributes<HTMLDivElement | HTMLParagraphElement | HTMLAnchorElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
     /** Element type to render. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allxsmith/bestax-bulma",
-  "version": "5.15.3",
+  "version": "5.16.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",
@@ -99,12 +99,29 @@
     "agents",
     "agent-skills"
   ],
+  "typesVersions": {
+    "*": {
+      "constants": [
+        "./dist/types/helpers/bulmaClassHelpers.d.ts"
+      ]
+    }
+  },
   "exports": {
     ".": {
       "types": "./dist/types/index.d.ts",
       "import": "./dist/index.esm.js",
       "require": "./dist/index.cjs.js"
     },
+    "./constants": {
+      "import": {
+        "types": "./dist/types/helpers/bulmaClassHelpers.d.ts",
+        "default": "./dist/constants.esm.js"
+      },
+      "require": {
+        "types": "./dist/constants.d.cts",
+        "default": "./dist/constants.cjs"
+      }
+    },
     "./dist/extras.css": {
       "default": "./dist/extras.css"
     },