@allxsmith/bestax-bulma 5.16.11 → 5.18.0

package/dist/index.esm.js

@@ -1671,6 +1671,75 @@ const Breadcrumb = ({ className, alignment, separator, size, children, ...props
     return (jsx("nav", { className: breadcrumbClasses, "aria-label": "breadcrumbs", ...rest, children: jsx("ul", { children: children }) }));
 };
 
+/**
+ * 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>`.
+ */
+const ANCHOR_ONLY_ATTRS = {
+    href: true,
+    target: true,
+    download: true,
+    hrefLang: true,
+    ping: true,
+    referrerPolicy: true,
+    media: true,
+    type: 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.
+ */
+function omitAttrs(props, strip) {
+    const out = {};
+    // `Reflect.ownKeys`, not `Object.entries`: the latter drops symbol-keyed props.
+    // React enumerates props with `for...in`, which never reports a symbol, so
+    // nothing renders differently either way. It is not the same change for all
+    // three callers: Menu filtered by rest-destructure and kept them already,
+    // while Dropdown and Level filtered through `Object.entries` and did not, so
+    // this restores one and widens two. Symbols are the only shape where those
+    // two disagreed, and keeping them is the side a spread is on.
+    for (const key of Reflect.ownKeys(props)) {
+        // Enumerability, for the same reason in the other direction: `Reflect.ownKeys`
+        // also reports NON-enumerable own props, which every filter this replaced left
+        // behind. Copying one out would both add a prop the old code dropped and make
+        // it enumerable on the way, so widening the key source must not widen this.
+        if (!Object.prototype.propertyIsEnumerable.call(props, key))
+            continue;
+        const value = props[key];
+        // `hasOwnProperty`, not `key in strip`: `in` walks the prototype chain, so a
+        // prop named `toString`, `valueOf`, `constructor` or `hasOwnProperty` was
+        // stripped although no caller named it — and anything written to
+        // `Object.prototype` would start deleting props that share its keys.
+        if (typeof key === 'symbol' ||
+            !Object.prototype.hasOwnProperty.call(strip, key)) {
+            // `defineProperty`, not `out[key] = value`: assignment consults the
+            // prototype chain for a setter, and `__proto__` has one. A prop named
+            // `__proto__` would be swallowed by it — dropped from the result AND
+            // replacing the result's prototype with its value. A spread and a rest
+            // destructure both DEFINE, which is what makes them immune, so this has
+            // to define too.
+            Object.defineProperty(out, key, {
+                value,
+                writable: true,
+                enumerable: true,
+                configurable: true,
+            });
+        }
+    }
+    return out;
+}
+
 /**
  * Merges helper-emitted inline styles (e.g., `bulmaHelperStyles` from
  * `useBulmaClasses`) with a user-supplied `style` prop.
@@ -1747,6 +1816,34 @@ const CardComponent = ({ className, children, textColor, color, bgColor, hasShad
                 hasCompoundComponents(children) &&
                 children, hasFooter && (jsx("footer", { className: prefixedClassNames(classPrefix, 'card-footer'), children: Array.isArray(footer) ? (footer.map((item, idx) => (jsx("span", { className: prefixedClassNames(classPrefix, 'card-footer-item'), children: item }, idx)))) : (jsx("span", { className: prefixedClassNames(classPrefix, 'card-footer-item'), children: footer })) }))] }));
 };
+/**
+ * The set withheld from a non-anchor `Card.FooterItem` (`span`/`button`): the
+ * derived anchor-only attributes, minus `type` (also valid on a `<button>` as
+ * `submit`/`button`/`reset`, so stripping it there would remove a working
+ * attribute — the same trade `DropdownItem`'s own `STRIP_FROM_NON_ANCHOR`
+ * accepts, in `./Dropdown.tsx`), plus `rel` (React declares it on
+ * `HTMLAttributes` for every element, so the derived set alone would not
+ * withhold it — the same addition `Level.Item` makes).
+ */
+const STRIP_FROM_NON_ANCHOR$2 = (() => {
+    const { type: _type, ...rest } = ANCHOR_ONLY_ATTRS;
+    return { ...rest, rel: true };
+})();
+/**
+ * The set withheld from a non-button `Card.FooterItem` (`span`/`a`), keyed so
+ * it stops compiling until a button attribute React adds is named here.
+ */
+const STRIP_FROM_NON_BUTTON = {
+    disabled: true,
+    form: true,
+    formAction: true,
+    formEncType: true,
+    formMethod: true,
+    formNoValidate: true,
+    formTarget: true,
+    name: true,
+    value: true,
+};
 /**
  * Card header compound component. Wraps children in a `.card-header` element.
  *
@@ -1777,13 +1874,14 @@ const CardHeader = ({ className, children, centered, color, bgColor, textColor,
  * @param {CardHeaderTitleProps} props - Props for the CardHeaderTitle component.
  * @returns {JSX.Element} The rendered card header title.
  */
-const CardHeaderTitle = ({ className, children, centered, color, bgColor, textColor, ...props }) => {
+const CardHeaderTitle = ({ as = 'div', className, children, centered, color, bgColor, textColor, ...props }) => {
     const { bulmaHelperClasses, rest } = useBulmaClasses({
         color: textColor ?? color,
         backgroundColor: bgColor,
         ...props,
     });
-    return (jsx("div", { className: classNames(usePrefixedClassNames('card-header-title', {
+    const Tag = as;
+    return (jsx(Tag, { className: classNames(usePrefixedClassNames('card-header-title', {
             'is-centered': centered,
         }), bulmaHelperClasses, className), ...rest, children: children }));
 };
@@ -1854,13 +1952,40 @@ const CardFooter = ({ className, children, color, bgColor, textColor, ...props }
  * @param {CardFooterItemProps} props - Props for the CardFooterItem component.
  * @returns {JSX.Element} The rendered card footer item.
  */
-const CardFooterItem = ({ className, children, color, bgColor, textColor, ...props }) => {
+const CardFooterItem = ({ as = 'span', className, children, color, bgColor, textColor, ...props }) => {
     const { bulmaHelperClasses, rest } = useBulmaClasses({
         color: textColor ?? color,
         backgroundColor: bgColor,
         ...props,
     });
-    return (jsx("span", { className: classNames(usePrefixedClassNames('card-footer-item'), bulmaHelperClasses, className), ...rest, children: children }));
+    const itemClasses = classNames(usePrefixedClassNames('card-footer-item'), bulmaHelperClasses, className);
+    // The anchor's own attributes reach an `<a>` and nothing else, and the button's a
+    // `<button>` — `STRIP_FROM_NON_ANCHOR` above names the anchor set and why `type`
+    // stays while `rel` is added, and `STRIP_FROM_NON_BUTTON` the button set.
+    if (as === 'a') {
+        return (jsx("a", { className: itemClasses, ...omitAttrs(rest, STRIP_FROM_NON_BUTTON), children: children }));
+    }
+    const forwarded = omitAttrs(rest, STRIP_FROM_NON_ANCHOR$2);
+    if (as === 'button') {
+        const forwardedType = forwarded.type;
+        return (jsx("button", { className: itemClasses, ...forwarded, 
+            // A footer item button must not submit an enclosing form by default —
+            // `<button>` defaults to `type="submit"`, and a Save/Cancel action row
+            // sitting in a form is the common case this `as` exists for.
+            //
+            // A MISSING `type` is not the only way that default arrives: `type` is
+            // typed here as the `<a>` MIME string (`STRIP_FROM_NON_ANCHOR` above
+            // says why it is not withheld), so `as="button" type="text/html"`
+            // compiles, and HTML's INVALID-value default for a button's `type` is
+            // submit too. So anything that is not one of the three native button
+            // types falls back to `button` rather than being forwarded.
+            type: forwardedType === 'submit' ||
+                forwardedType === 'reset' ||
+                forwardedType === 'button'
+                ? forwardedType
+                : 'button', children: children }));
+    }
+    return (jsx("span", { className: itemClasses, ...omitAttrs(forwarded, STRIP_FROM_NON_BUTTON), children: children }));
 };
 // Attach nested Title and Icon components to CardHeader
 const CardHeaderCompound = withSubComponents(CardHeader, {
@@ -1876,75 +2001,6 @@ const Card = withSubComponents(CardComponent, {
     FooterItem: CardFooterItem,
 }, 'Card');
 
-/**
- * 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>`.
- */
-const ANCHOR_ONLY_ATTRS = {
-    href: true,
-    target: true,
-    download: true,
-    hrefLang: true,
-    ping: true,
-    referrerPolicy: true,
-    media: true,
-    type: 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.
- */
-function omitAttrs(props, strip) {
-    const out = {};
-    // `Reflect.ownKeys`, not `Object.entries`: the latter drops symbol-keyed props.
-    // React enumerates props with `for...in`, which never reports a symbol, so
-    // nothing renders differently either way. It is not the same change for all
-    // three callers: Menu filtered by rest-destructure and kept them already,
-    // while Dropdown and Level filtered through `Object.entries` and did not, so
-    // this restores one and widens two. Symbols are the only shape where those
-    // two disagreed, and keeping them is the side a spread is on.
-    for (const key of Reflect.ownKeys(props)) {
-        // Enumerability, for the same reason in the other direction: `Reflect.ownKeys`
-        // also reports NON-enumerable own props, which every filter this replaced left
-        // behind. Copying one out would both add a prop the old code dropped and make
-        // it enumerable on the way, so widening the key source must not widen this.
-        if (!Object.prototype.propertyIsEnumerable.call(props, key))
-            continue;
-        const value = props[key];
-        // `hasOwnProperty`, not `key in strip`: `in` walks the prototype chain, so a
-        // prop named `toString`, `valueOf`, `constructor` or `hasOwnProperty` was
-        // stripped although no caller named it — and anything written to
-        // `Object.prototype` would start deleting props that share its keys.
-        if (typeof key === 'symbol' ||
-            !Object.prototype.hasOwnProperty.call(strip, key)) {
-            // `defineProperty`, not `out[key] = value`: assignment consults the
-            // prototype chain for a setter, and `__proto__` has one. A prop named
-            // `__proto__` would be swallowed by it — dropped from the result AND
-            // replacing the result's prototype with its value. A spread and a rest
-            // destructure both DEFINE, which is what makes them immune, so this has
-            // to define too.
-            Object.defineProperty(out, key, {
-                value,
-                writable: true,
-                enumerable: true,
-                configurable: true,
-            });
-        }
-    }
-    return out;
-}
-
 /**
  * Checks if code is running in a browser environment.
  * @deprecated Dropdown's internal SSR guard, exported by accident; it will
@@ -3148,6 +3204,38 @@ const warnDeprecatedColorProp = (component, value, hint) => {
         `a visual effect. It will be removed in the next major version. ${hint}`);
 };
 
+/** A count read as a whole number from zero, or `fallback` when it's no number. */
+function whole(count, fallback) {
+    return Number.isFinite(count) ? Math.max(Math.floor(count), 0) : fallback;
+}
+function range(from, to) {
+    return Array.from({ length: Math.max(to - from + 1, 0) }, (_, i) => from + i);
+}
+/**
+ * The pages to show for `current` of `total`: the first and last
+ * `boundaries`, `siblings` on each side of the current one, and a gap for
+ * each run left out. A gap of a single page shows that page instead, and the
+ * window around the current page slides inward near either end, so the row
+ * keeps its length as the page moves.
+ */
+function pageItems(total, current, siblings, boundaries) {
+    const windowSize = siblings * 2 + 1;
+    // Every page fits in the room the boundary pages, the window and two gaps take.
+    if (total <= boundaries * 2 + windowSize + 2)
+        return range(1, total);
+    const lowest = boundaries + 2;
+    const highest = total - boundaries - 1;
+    const start = Math.min(Math.max(current - siblings, lowest), highest - windowSize + 1);
+    const end = start + windowSize - 1;
+    const gap = (from, to, name) => to === from ? [from] : [name];
+    return [
+        ...range(1, boundaries),
+        ...gap(boundaries + 1, start - 1, 'start-gap'),
+        ...range(start, end),
+        ...gap(end + 1, total - boundaries, 'end-gap'),
+        ...range(total - boundaries + 1, total),
+    ];
+}
 /**
  * "Previous" navigation button.
  *
@@ -3155,9 +3243,9 @@ const warnDeprecatedColorProp = (component, value, hint) => {
  * @param {PaginationPreviousNextProps} props - Props for the PaginationPrevious component.
  * @returns {JSX.Element} The rendered previous button.
  */
-const PaginationPrevious = ({ className, disabled, children, ...props }) => (jsx("a", { className: classNames(usePrefixedClassNames('pagination-previous'), className, {
+const PaginationPrevious = ({ className, disabled, children, ...props }) => (jsx("a", { className: classNames(usePrefixedClassNames('pagination-previous', {
         'is-disabled': disabled,
-    }), "aria-disabled": disabled, tabIndex: disabled ? -1 : 0, ...props, onClick: disabled
+    }), className), "aria-disabled": disabled, tabIndex: disabled ? -1 : 0, ...props, onClick: disabled
         ? e => {
             e.preventDefault();
             e.stopPropagation();
@@ -3170,9 +3258,7 @@ const PaginationPrevious = ({ className, disabled, children, ...props }) => (jsx
  * @param {PaginationPreviousNextProps} props - Props for the PaginationNext component.
  * @returns {JSX.Element} The rendered next button.
  */
-const PaginationNext = ({ className, disabled, children, ...props }) => (jsx("a", { className: classNames(usePrefixedClassNames('pagination-next'), className, {
-        'is-disabled': disabled,
-    }), "aria-disabled": disabled, tabIndex: disabled ? -1 : 0, ...props, onClick: disabled
+const PaginationNext = ({ className, disabled, children, ...props }) => (jsx("a", { className: classNames(usePrefixedClassNames('pagination-next', { 'is-disabled': disabled }), className), "aria-disabled": disabled, tabIndex: disabled ? -1 : 0, ...props, onClick: disabled
         ? e => {
             e.preventDefault();
             e.stopPropagation();
@@ -3186,7 +3272,8 @@ const PaginationNext = ({ className, disabled, children, ...props }) => (jsx("a"
  * @returns {JSX.Element} The rendered pagination.
  * @see {@link https://bulma.io/documentation/components/pagination/ | Bulma Pagination documentation}
  */
-const PaginationComponent = ({ color, textColor, bgColor, size, align, rounded, className, children, ...props }) => {
+const PaginationComponent = ({ color, textColor, bgColor, size, align, rounded, total, current, onPageChange, siblingCount = 1, boundaryCount = 1, previousLabel = 'Previous', nextLabel = 'Next', disabled, getPageHref, getPageLabel, className, children, ...props }) => {
+    const [kept, setKept] = React.useState(1);
     warnDeprecatedColorProp('Pagination', color, 'Use the textColor / bgColor helper props instead.');
     const { bulmaHelperClasses, rest } = useBulmaClasses({
         color: textColor,
@@ -3201,7 +3288,43 @@ const PaginationComponent = ({ color, textColor, bgColor, size, align, rounded,
         'is-rounded': rounded,
     });
     const paginationClasses = classNames(bulmaClasses, bulmaHelperClasses, className);
-    return (jsx("nav", { className: paginationClasses, role: "navigation", "aria-label": "pagination", ...rest, children: children }));
+    // A child that renders nothing (`{show && …}` when false) is no children.
+    const fromTotal = total !== undefined && React.Children.toArray(children).length === 0;
+    let content = children;
+    if (fromTotal) {
+        const pages = Number.isFinite(total) ? Math.max(Math.floor(total), 0) : 0;
+        // A current page that's no number reads as the first.
+        const page = Math.min(Math.max(whole(current ?? kept, 1), 1), Math.max(pages, 1));
+        const choose = (next) => {
+            if (next === page)
+                return;
+            if (current === undefined)
+                setKept(next);
+            onPageChange?.(next);
+        };
+        /**
+         * What a link to `target` is given, beside what it renders. With no
+         * `getPageHref` it's a button; a link that's `off` goes nowhere.
+         */
+        const linkTo = (target, off) => ({
+            href: off || !getPageHref ? undefined : getPageHref(target),
+            role: getPageHref ? undefined : 'button',
+            // A link that's off is disabled too, and the parts drop its clicks.
+            onClick: () => choose(target),
+            onKeyDown: getPageHref
+                ? undefined
+                : (e) => {
+                    if (off || (e.key !== 'Enter' && e.key !== ' '))
+                        return;
+                    e.preventDefault();
+                    choose(target);
+                },
+        });
+        const atStart = disabled || page <= 1;
+        const atEnd = disabled || page >= pages;
+        content = (jsxs(Fragment, { children: [jsx(PaginationPrevious, { disabled: atStart, ...linkTo(page - 1, atStart), children: previousLabel }), jsx(PaginationNext, { disabled: atEnd, ...linkTo(page + 1, atEnd), children: nextLabel }), jsx(PaginationList, { children: pageItems(pages, page, whole(siblingCount, 1), whole(boundaryCount, 1)).map(item => typeof item === 'number' ? (jsx(PaginationLink, { "aria-label": getPageLabel ? getPageLabel(item) : `Page ${item}`, active: item === page, disabled: disabled, ...linkTo(item, Boolean(disabled)), children: item }, item)) : (jsx(PaginationEllipsis, {}, item))) })] }));
+    }
+    return (jsx("nav", { className: paginationClasses, role: "navigation", "aria-label": "pagination", ...rest, children: content }));
 };
 /**
  * Container for page links and ellipsis.
@@ -3241,10 +3364,10 @@ const PaginationLink = ({ className, textColor, bgColor, active, disabled, onCli
             onClick(e);
         }
     };
-    return (jsx("li", { children: jsx("a", { className: classNames(usePrefixedClassNames('pagination-link'), bulmaHelperClasses, className, {
+    return (jsx("li", { children: jsx("a", { className: classNames(usePrefixedClassNames('pagination-link', {
                 'is-current': active,
                 'is-disabled': disabled,
-            }), "aria-current": active ? 'page' : undefined, "aria-disabled": disabled, tabIndex: disabled ? -1 : 0, onClick: handleClick, ...rest, children: children }) }));
+            }), bulmaHelperClasses, className), "aria-current": active ? 'page' : undefined, "aria-disabled": disabled, tabIndex: disabled ? -1 : 0, onClick: handleClick, ...rest, children: children }) }));
 };
 /**
  * Ellipsis separator.