@fiestaboard/ui 5.12.2 → 6.0.0

package/dist/components/feedback/alert.d.ts

@@ -3,7 +3,25 @@ import * as React from "react";
 declare const alertVariants: (props?: ({
     variant?: "destructive" | "default" | "info" | "success" | "warning" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
-declare function Alert({ className, variant, ...props }: React.ComponentProps<"div"> & VariantProps<typeof alertVariants>): React.JSX.Element;
+export type AlertProps = React.ComponentProps<"div"> & VariantProps<typeof alertVariants> & {
+    /**
+     * Override the announcement urgency the variant would otherwise pick.
+     *
+     * The default is derived from `variant` (see {@link ASSERTIVE_VARIANTS}),
+     * which is right for the overwhelming majority of call sites — reach for
+     * this only when the message's urgency genuinely disagrees with its
+     * colour. A `destructive`-tinted alert that has been on the page since
+     * load is `politeness="polite"`; a `default`-tinted alert announcing that
+     * a save just failed is `politeness="assertive"`.
+     *
+     * Named for the ARIA term rather than spelled as a role so the two
+     * spellings cannot drift: this picks `alert` vs `status`, and no
+     * `aria-live` is set alongside, because the role already implies it (the
+     * same rule `EmptyState` follows).
+     */
+    politeness?: "assertive" | "polite";
+};
+declare function Alert({ className, variant, politeness, ...props }: AlertProps): React.JSX.Element;
 declare function AlertTitle({ className, ...props }: React.ComponentProps<"h5">): React.JSX.Element;
 declare function AlertDescription({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
 export { Alert, AlertDescription, AlertTitle, alertVariants };

package/dist/components/feedback/alert.js

@@ -12,23 +12,24 @@ var r = n("relative w-full rounded-lg border px-4 py-3 text-sm [&>svg+div]:trans
 		warning: "border-warning bg-warning/8 text-foreground [&>svg]:text-warning"
 	} },
 	defaultVariants: { variant: "default" }
-});
-function i({ className: n, variant: i, ...a }) {
+}), i = ["destructive", "warning"];
+function a({ className: n, variant: a, politeness: o, ...s }) {
+	let c = o ?? (a && i.includes(a) ? "assertive" : "polite");
 	return /* @__PURE__ */ t("div", {
 		"data-slot": "alert",
-		role: "alert",
-		className: e(r({ variant: i }), n),
-		...a
+		role: c === "assertive" ? "alert" : "status",
+		className: e(r({ variant: a }), n),
+		...s
 	});
 }
-function a({ className: n, ...r }) {
+function o({ className: n, ...r }) {
 	return /* @__PURE__ */ t("h5", {
 		"data-slot": "alert-title",
 		className: e("mb-1 font-semibold leading-tight tracking-tight", n),
 		...r
 	});
 }
-function o({ className: n, ...r }) {
+function s({ className: n, ...r }) {
 	return /* @__PURE__ */ t("div", {
 		"data-slot": "alert-description",
 		className: e("text-sm [&_p]:leading-relaxed", n),
@@ -36,6 +37,6 @@ function o({ className: n, ...r }) {
 	});
 }
 //#endregion
-export { i as Alert, o as AlertDescription, a as AlertTitle, r as alertVariants };
+export { a as Alert, s as AlertDescription, o as AlertTitle, r as alertVariants };
 
 //# sourceMappingURL=alert.js.map

package/dist/components/feedback/alert.js.map

@@ -1 +1 @@
-{"version":3,"file":"alert.js","names":[],"sources":["../../../src/components/feedback/alert.tsx"],"mappings":";;;;;AAqBA,IAAM,IAAgB,EACpB,2KACA;CACE,UAAU,EACR,SAAS;EAKP,SAAS;EAiBT,aAAa;EACb,MAAM;EACN,SAAS;EACT,SAAS;CACX,EACF;CACA,iBAAiB,EACf,SAAS,UACX;AACF,CACF;AAEA,SAAS,EAAM,EAAE,cAAW,YAAS,GAAG,KAA2E;CACjH,OAAO,kBAAC,OAAD;EAAK,aAAU;EAAQ,MAAK;EAAQ,WAAW,EAAG,EAAc,EAAE,WAAQ,CAAC,GAAG,CAAS;EAAG,GAAI;CAAQ,CAAA;AAC/G;AAIA,SAAS,EAAW,EAAE,cAAW,GAAG,KAAqC;CACvE,OACE,kBAAC,MAAD;EACE,aAAU;EACV,WAAW,EAAG,mDAAmD,CAAS;EAC1E,GAAI;CACL,CAAA;AAEL;AAEA,SAAS,EAAiB,EAAE,cAAW,GAAG,KAAsC;CAC9E,OAAO,kBAAC,OAAD;EAAK,aAAU;EAAoB,WAAW,EAAG,iCAAiC,CAAS;EAAG,GAAI;CAAQ,CAAA;AACnH"}
+{"version":3,"file":"alert.js","names":[],"sources":["../../../src/components/feedback/alert.tsx"],"mappings":";;;;;AAqBA,IAAM,IAAgB,EACpB,2KACA;CACE,UAAU,EACR,SAAS;EAKP,SAAS;EAiBT,aAAa;EACb,MAAM;EACN,SAAS;EACT,SAAS;CACX,EACF;CACA,iBAAiB,EACf,SAAS,UACX;AACF,CACF,GA0BM,IAA8C,CAAC,eAAe,SAAS;AAsB7E,SAAS,EAAM,EAAE,cAAW,YAAS,eAAY,GAAG,KAAqB;CACvE,IAAM,IAAU,MAAe,KAAW,EAAmB,SAAS,CAAO,IAAI,cAAc;CAE/F,OACE,kBAAC,OAAD;EACE,aAAU;EACV,MAAM,MAAY,cAAc,UAAU;EAC1C,WAAW,EAAG,EAAc,EAAE,WAAQ,CAAC,GAAG,CAAS;EAMnD,GAAI;CACL,CAAA;AAEL;AAIA,SAAS,EAAW,EAAE,cAAW,GAAG,KAAqC;CACvE,OACE,kBAAC,MAAD;EACE,aAAU;EACV,WAAW,EAAG,mDAAmD,CAAS;EAC1E,GAAI;CACL,CAAA;AAEL;AAEA,SAAS,EAAiB,EAAE,cAAW,GAAG,KAAsC;CAC9E,OAAO,kBAAC,OAAD;EAAK,aAAU;EAAoB,WAAW,EAAG,iCAAiC,CAAS;EAAG,GAAI;CAAQ,CAAA;AACnH"}

package/dist/components/feedback/badge.d.ts

@@ -3,8 +3,41 @@ import * as React from "react";
 declare const badgeVariants: (props?: ({
     variant?: "destructive" | "default" | "success" | "brand" | "outline" | "secondary" | "variable" | "formula" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
-export type BadgeProps = React.ComponentProps<"span"> & VariantProps<typeof badgeVariants> & {
-    asChild?: boolean;
+/**
+ * The dismiss pair, as a union rather than two optional props (#299).
+ *
+ * The dismiss button's entire visible content is an `aria-hidden` X glyph, so
+ * `dismissLabel` is not a nicety — it is the button's ONLY accessible name.
+ * While both props were independently optional, `<Badge onDismiss={fn}>Weather
+ * </Badge>` type-checked, `aria-label={undefined}` was dropped at runtime, and
+ * the badge shipped a control a screen reader announces as bare "button". In a
+ * row of filter chips that is "button, button, button" with no way to tell
+ * which one removes Weather and which removes Traffic (SC 4.1.2, and 2.5.3
+ * once the X is the only thing a sighted user has to go on).
+ *
+ * The JSDoc had said REQUIRED since #249. Prose is not a compiler. This makes
+ * the unnamed case unrepresentable instead — the same move `SelectionGroup`
+ * already makes for the `aria-label`/`aria-labelledby` pair, and the same
+ * principle `card.tsx` names as "what makes that drift impossible rather than
+ * merely discouraged".
+ *
+ * A DEFAULT label was the other option and is not available to this package:
+ * `IconTile` already settled that a component needing a name needs a
+ * *localized* name, and this library ships no copy of its own (§8). "Dismiss"
+ * hardcoded in English is a worse bug than no name at all, because it looks
+ * fixed.
+ *
+ * The negative arm spells both keys as `?: never` so the props stay
+ * destructurable and a stray `dismissLabel` with no `onDismiss` is caught too
+ * — a label on a button that does not exist is a typo, not a no-op.
+ *
+ * Exported because a union cannot be built up prop by prop. A call site whose
+ * dismissibility is conditional has to hold the whole pair as one value —
+ * `const dismiss: BadgeDismissProps = enabled ? { onDismiss, dismissLabel } :
+ * {}` and then `<Badge {...dismiss}>` — and without this export it would have
+ * to re-declare the union to say that.
+ */
+export type BadgeDismissProps = {
     /**
      * Renders a trailing dismiss button that the badge owns (#249).
      *
@@ -17,13 +50,20 @@ export type BadgeProps = React.ComponentProps<"span"> & VariantProps<typeof badg
      * Incompatible with `asChild`, which hands the rendered element to the
      * caller and leaves nowhere to put the button.
      */
-    onDismiss?: () => void;
+    onDismiss: () => void;
     /**
-     * Localized accessible name for the dismiss button, e.g. "Remove Weather".
-     * REQUIRED with `onDismiss`: an X glyph names nothing, and per the
-     * package's i18n rule this ships no copy of its own.
+     * Localized accessible name for the dismiss button, e.g. "Remove
+     * Weather". Required alongside `onDismiss` and enforced by the type: an
+     * X glyph names nothing, and per the package's i18n rule this ships no
+     * copy of its own.
      */
-    dismissLabel?: string;
+    dismissLabel: string;
+} | {
+    onDismiss?: never;
+    dismissLabel?: never;
 };
+export type BadgeProps = React.ComponentProps<"span"> & VariantProps<typeof badgeVariants> & {
+    asChild?: boolean;
+} & BadgeDismissProps;
 declare function Badge({ className, variant, asChild, children, onDismiss, dismissLabel, ref, ...props }: BadgeProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
 export { Badge, badgeVariants };

package/dist/components/feedback/badge.js.map

@@ -1 +1 @@
-{"version":3,"file":"badge.js","names":[],"sources":["../../../src/components/feedback/badge.tsx"],"mappings":";;;;;;;;AAQA,IAAM,IAAgB,EACpB,0QACA;CACE,UAAU,EACR,SAAS;EACP,SAAS;EAKT,OAAO;EACP,WAAW;EACX,aAAa;EACb,SAAS;EACT,UACE;EACF,SACE;EACF,SACE;CACJ,EACF;CACA,iBAAiB,EACf,SAAS,UACX;AACF,CACF;AA0BA,SAAS,EAAM,EAAE,cAAW,YAAS,aAAU,IAAO,aAAU,cAAW,iBAAc,QAAK,GAAG,KAAqB;CACpH,IAAM,IAAc,MAAc,KAAA,KAAa,CAAC;CAEhD,OAAO,EAAU;EACf,gBAAgB;EACX;EACL,QAAQ,IAAW,EAAM,SAAS,KAAK,CAAQ,IAA2B,KAAA;EAC1E,OAAO;GACL,aAAa;GACb,WAAW,EACT,EAAc,EAAE,WAAQ,CAAC,GACzB,KAAe,CAQb,oBAIA,iBACF,GACA,CACF;GACA,GAAI,IACA,CAAC,IACD,EACE,UAAU,IACR,kBAAA,GAAA,EAAA,UAAA,CAIE,kBAAC,QAAD;IAAM,aAAU;IAAc,WAAU;IACrC;GACG,CAAA,GACN,kBAAC,GAAD;IACE,MAAK;IACL,SAAQ;IACR,MAAK;IACL,aAAU;IACV,cAAY;IACZ,SAAS;IAGT,WAAU;IAEV,UAAA,kBAAC,GAAD,EAAG,eAAY,OAAQ,CAAA;GACjB,CAAA,CACR,EAAA,CAAA,IAEF,EAEJ;GACJ,GAAG;EACL;CACF,CAAC;AACH"}
+{"version":3,"file":"badge.js","names":[],"sources":["../../../src/components/feedback/badge.tsx"],"mappings":";;;;;;;;AAQA,IAAM,IAAgB,EACpB,0QACA;CACE,UAAU,EACR,SAAS;EACP,SAAS;EAKT,OAAO;EACP,WAAW;EACX,aAAa;EACb,SAAS;EACT,UACE;EACF,SACE;EACF,SACE;CACJ,EACF;CACA,iBAAiB,EACf,SAAS,UACX;AACF,CACF;AAkEA,SAAS,EAAM,EAAE,cAAW,YAAS,aAAU,IAAO,aAAU,cAAW,iBAAc,QAAK,GAAG,KAAqB;CACpH,IAAM,IAAc,MAAc,KAAA,KAAa,CAAC;CAEhD,OAAO,EAAU;EACf,gBAAgB;EACX;EACL,QAAQ,IAAW,EAAM,SAAS,KAAK,CAAQ,IAA2B,KAAA;EAC1E,OAAO;GACL,aAAa;GACb,WAAW,EACT,EAAc,EAAE,WAAQ,CAAC,GACzB,KAAe,CAQb,oBAIA,iBACF,GACA,CACF;GACA,GAAI,IACA,CAAC,IACD,EACE,UAAU,IACR,kBAAA,GAAA,EAAA,UAAA,CAIE,kBAAC,QAAD;IAAM,aAAU;IAAc,WAAU;IACrC;GACG,CAAA,GACN,kBAAC,GAAD;IACE,MAAK;IACL,SAAQ;IACR,MAAK;IACL,aAAU;IACV,cAAY;IACZ,SAAS;IAGT,WAAU;IAEV,UAAA,kBAAC,GAAD,EAAG,eAAY,OAAQ,CAAA;GACjB,CAAA,CACR,EAAA,CAAA,IAEF,EAEJ;GACJ,GAAG;EACL;CACF,CAAC;AACH"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiestaboard/ui",
-  "version": "5.12.2",
+  "version": "6.0.0",
   "description": "FiestaUI — the FiestaBoard design system. React components on Base UI with Tailwind v4 design tokens.",
   "license": "MIT",
   "repository": {