@allxsmith/bestax-bulma 5.15.2 → 5.15.4

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/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.
@@ -66,8 +67,20 @@ export interface LevelRightProps extends React.HTMLAttributes<HTMLDivElement>, O
 export declare const LevelRight: React.FC<LevelRightProps>;
 /**
  * Props for the LevelItem component.
+ *
+ * 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 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; `helpers/anchorAttrs.ts` derives it from
+ * React instead, and `ANCHOR_ONLY_ATTRS` there is the guard to protect.
  */
-export interface LevelItemProps extends React.HTMLAttributes<HTMLDivElement | HTMLParagraphElement | HTMLAnchorElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+export interface LevelItemProps extends AnchorOnlyAttributes, React.HTMLAttributes<HTMLDivElement | HTMLParagraphElement | HTMLAnchorElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
     /** Element type to render. */
     as?: 'div' | 'p' | 'a';
     /** Center the text in the item. */
@@ -82,12 +95,6 @@ export interface LevelItemProps extends React.HTMLAttributes<HTMLDivElement | HT
     className?: string;
     /** Content. */
     children?: React.ReactNode;
-    /** Href for "a" tag. */
-    href?: string;
-    /** Target for "a" tag */
-    target?: string;
-    /** Rel for "a" tag */
-    rel?: string;
 }
 /**
  * Individual item, can be rendered as `div`, `p`, or `a`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allxsmith/bestax-bulma",
-  "version": "5.15.2",
+  "version": "5.15.4",
   "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",