@allxsmith/bestax-bulma 5.15.2 → 5.15.3

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

@@ -64,10 +64,40 @@ 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
+ * 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`,
+ * `target` and `rel` made every other anchor attribute a type error even at
+ * `as="a"`, which is what #641 reported.
  */
-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 +112,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.3",
   "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",