@jfrader/ui 0.6.0 → 0.7.0

package/dist/locale-switcher-DTkySKsM.js

@@ -0,0 +1,375 @@
+'use client';
+import { i as e } from "./css-BYJhdGh-.js";
+import { n as t } from "./focus-ring-BK5W5_NY.js";
+import { n, r } from "./media-8yrN85VT.js";
+import { t as i } from "./sx-BJXJ2xJK.js";
+import { t as a } from "./visually-hidden-DgVO3NaB.js";
+import { t as o } from "./renderable-DzcIj1Lo.js";
+import { t as s } from "./icon-wrapper-C-zMD0uL.js";
+import { t as c } from "./trigger-style-CtOrdPk4.js";
+import { o as l, r as u, s as d } from "./listbox-style-DNOxAulu.js";
+import { a as f, i as p, l as m, r as h, s as g, u as _ } from "./menu-CVzpsyXn.js";
+import { useEffect as v, useId as y } from "react";
+import { vars as b } from "@jfrader/tokens/vars";
+import { Fragment as x, jsx as S, jsxs as C } from "@emotion/react/jsx-runtime";
+import { useMergeRefs as w } from "@floating-ui/react";
+//#region src/components/locale-switcher/locale-switcher.tsx
+var T = "LocaleSwitcher", E = "✓", D = e({
+	display: "inline-flex",
+	alignItems: "center",
+	minInlineSize: 0,
+	maxInlineSize: "100%",
+	fontFamily: b.font.sans,
+	lineHeight: b.lineHeight.tight,
+	color: b.color.text
+}), O = {
+	sm: e({ fontSize: b.textSize.sm }),
+	md: e({ fontSize: b.textSize.sm }),
+	lg: e({ fontSize: b.textSize.md })
+}, k = e({
+	gap: b.space[2],
+	maxInlineSize: "100%",
+	fontSize: "inherit",
+	whiteSpace: "nowrap"
+}), A = {
+	sm: e({
+		minBlockSize: b.space[8],
+		paddingInline: b.space[3]
+	}),
+	md: e({
+		minBlockSize: b.space[10],
+		paddingInline: b.space[4]
+	}),
+	lg: e({
+		minBlockSize: b.space[12],
+		paddingInline: b.space[5]
+	})
+}, j = e({
+	display: "inline-flex",
+	transitionProperty: "transform",
+	transitionDuration: b.motion.duration.fast,
+	transitionTimingFunction: b.motion.easeStandard,
+	"& svg": {
+		inlineSize: "1em",
+		blockSize: "1em"
+	},
+	"[aria-expanded=\"true\"] > &": { transform: "rotate(180deg)" },
+	[r]: { transitionDuration: "0s" }
+}), M = e({
+	gap: b.space[2],
+	textDecoration: "none",
+	"&[aria-current=\"true\"]": { fontWeight: b.fontWeight.medium }
+}), N = e({ marginInlineStart: "auto" }), P = e({
+	display: "flex",
+	flexWrap: "wrap",
+	alignItems: "center",
+	gap: b.space[3],
+	margin: 0,
+	padding: 0,
+	listStyle: "none"
+}), F = e({
+	display: "inline-flex",
+	alignItems: "center",
+	minBlockSize: b.space[8],
+	borderRadius: b.radius.sm
+}), I = e({
+	color: b.color.accentText,
+	textDecoration: "underline",
+	textUnderlineOffset: "0.2em",
+	transitionProperty: "color",
+	transitionDuration: b.motion.duration.fast,
+	transitionTimingFunction: b.motion.easeStandard,
+	"&:hover": { color: b.color.text },
+	"&:focus-visible": { ...t },
+	[r]: { transitionDuration: "0s" }
+}), L = e({
+	color: b.color.text,
+	fontWeight: b.fontWeight.medium
+}), R = e({
+	display: "inline-flex",
+	alignItems: "center",
+	gap: `calc(${b.space[1]} / 2)`,
+	margin: 0,
+	padding: `calc(${b.space[1]} * 0.75)`,
+	listStyle: "none",
+	border: `1px solid ${b.color.borderControl}`,
+	borderRadius: b.radius.full,
+	backgroundColor: b.color.surfaceRaised,
+	"& > li": { display: "flex" },
+	[n]: { borderColor: "CanvasText" }
+}), z = e({
+	justifyContent: "center",
+	boxSizing: "border-box",
+	borderRadius: b.radius.full,
+	whiteSpace: "nowrap"
+}), B = {
+	sm: e({
+		minBlockSize: b.space[6],
+		minInlineSize: b.space[10],
+		paddingInline: b.space[2]
+	}),
+	md: e({
+		minBlockSize: b.space[8],
+		minInlineSize: b.space[12],
+		paddingInline: b.space[3]
+	}),
+	lg: e({
+		minBlockSize: b.space[10],
+		minInlineSize: `calc(${b.space[12]} + ${b.space[2]})`,
+		paddingInline: b.space[3]
+	})
+}, V = e({
+	color: b.color.textMuted,
+	textDecoration: "none",
+	transitionProperty: "color",
+	transitionDuration: b.motion.duration.fast,
+	transitionTimingFunction: b.motion.easeStandard,
+	"&:hover": { color: b.color.text },
+	"&:focus-visible": { ...t },
+	[r]: { transitionDuration: "0s" }
+}), H = e({
+	backgroundColor: b.color.accent,
+	color: b.color.accentContrast,
+	fontWeight: b.fontWeight.medium,
+	[n]: {
+		forcedColorAdjust: "none",
+		backgroundColor: "SelectedItem",
+		color: "SelectedItemText"
+	}
+}), U = /* @__PURE__ */ C("svg", {
+	viewBox: "0 0 24 24",
+	fill: "none",
+	stroke: "currentColor",
+	strokeWidth: "2",
+	strokeLinecap: "round",
+	focusable: "false",
+	children: [/* @__PURE__ */ S("circle", {
+		cx: "12",
+		cy: "12",
+		r: "9"
+	}), /* @__PURE__ */ S("path", { d: "M3 12h18M12 3c2.5 2.5 3.75 5.5 3.75 9S14.5 18.5 12 21c-2.5-2.5-3.75-5.5-3.75-9S9.5 5.5 12 3Z" })]
+}), W = /* @__PURE__ */ S("svg", {
+	viewBox: "0 0 16 16",
+	fill: "none",
+	stroke: "currentColor",
+	strokeWidth: "1.5",
+	strokeLinecap: "round",
+	strokeLinejoin: "round",
+	children: /* @__PURE__ */ S("path", { d: "M4 6l4 4 4-4" })
+});
+function G({ option: e, current: t, link: n, adornment: r, ...i }) {
+	let o = /* @__PURE__ */ C(x, { children: [e.label, r] }), s = e.ariaLabel ? /* @__PURE__ */ C(x, { children: [
+		o,
+		" ",
+		/* @__PURE__ */ S("span", {
+			css: a,
+			children: e.ariaLabel
+		})
+	] }) : o, c = {
+		...i,
+		lang: e.lang,
+		dir: "auto",
+		"aria-current": t ? "true" : void 0,
+		children: s
+	};
+	if (!n) return /* @__PURE__ */ S("span", { ...c });
+	let l = {
+		...c,
+		href: e.href,
+		hrefLang: e.lang
+	};
+	return e.render ? e.render(l) : /* @__PURE__ */ S("a", { ...l });
+}
+function K({ styles: e, slot: t, ...n }) {
+	return /* @__PURE__ */ S(i, {
+		className: t?.className,
+		styles: [
+			F,
+			e,
+			t?.css
+		],
+		children: (e) => /* @__PURE__ */ S(G, {
+			...n,
+			"data-ui": "locale-switcher-option",
+			className: e
+		})
+	});
+}
+function q({ options: e, value: t, current: n, size: r, triggerLabel: i, icon: v, open: b, defaultOpen: w, onOpenChange: D, placement: O, slotProps: P }) {
+	let F = y(), I = `${F}-action`, L = `${F}-current`, { className: R, css: z, ...B } = P?.trigger ?? {}, { className: V, css: H, ...U } = P?.content ?? {}, K = P?.option;
+	return /* @__PURE__ */ C(p, {
+		open: b,
+		defaultOpen: w,
+		onOpenChange: D,
+		placement: O,
+		children: [/* @__PURE__ */ C(g, {
+			...B,
+			"aria-labelledby": m(i ? I : void 0, n ? L : void 0),
+			family: T,
+			marker: "locale-switcher-trigger",
+			styles: [
+				c,
+				k,
+				A[r],
+				z
+			],
+			className: R,
+			children: [
+				i && /* @__PURE__ */ S("span", {
+					id: I,
+					css: a,
+					children: i
+				}),
+				o(v) && /* @__PURE__ */ S("span", {
+					"aria-hidden": "true",
+					css: s,
+					children: v
+				}),
+				n && /* @__PURE__ */ C("span", {
+					id: L,
+					lang: n.lang,
+					dir: "auto",
+					children: [n.label, n.ariaLabel && /* @__PURE__ */ C(x, { children: [" ", /* @__PURE__ */ S("span", {
+						css: a,
+						children: n.ariaLabel
+					})] })]
+				}),
+				/* @__PURE__ */ S("span", {
+					"aria-hidden": "true",
+					css: j,
+					children: W
+				})
+			]
+		}), /* @__PURE__ */ S(h, {
+			...U,
+			family: T,
+			marker: "locale-switcher-menu",
+			styles: [
+				d,
+				l,
+				H
+			],
+			className: V,
+			defaultLabelledBy: i ? I : void 0,
+			children: e.map((e) => {
+				let n = e.value === t;
+				return /* @__PURE__ */ S(f, {
+					family: T,
+					marker: "locale-switcher-option",
+					styles: [
+						_,
+						M,
+						K?.css
+					],
+					className: K?.className,
+					render: (t) => /* @__PURE__ */ S(G, {
+						...t,
+						option: e,
+						current: n,
+						link: !0,
+						adornment: n && /* @__PURE__ */ S("span", {
+							"aria-hidden": "true",
+							css: [u, N],
+							children: E
+						})
+					})
+				}, e.value);
+			})
+		})]
+	});
+}
+function J({ options: e, value: t, slotProps: n }) {
+	let r = e.find((e) => e.value !== t);
+	return r ? /* @__PURE__ */ S(K, {
+		option: r,
+		current: !1,
+		link: !0,
+		styles: I,
+		slot: n?.option
+	}) : null;
+}
+function Y({ options: e, value: t, slotProps: n, listStyles: r, linkStyles: i, currentStyles: a }) {
+	return /* @__PURE__ */ S("ul", {
+		css: r,
+		children: e.map((e) => {
+			let r = e.value === t;
+			return /* @__PURE__ */ S("li", { children: /* @__PURE__ */ S(K, {
+				option: e,
+				current: r,
+				link: !r,
+				styles: r ? a : i,
+				slot: n?.option
+			}) }, e.value);
+		})
+	});
+}
+function X(e) {
+	return /* @__PURE__ */ S(Y, {
+		...e,
+		listStyles: P,
+		linkStyles: I,
+		currentStyles: L
+	});
+}
+function Z(e) {
+	let t = [z, B[e.size]];
+	return /* @__PURE__ */ S(Y, {
+		...e,
+		listStyles: R,
+		linkStyles: [t, V],
+		currentStyles: [t, H]
+	});
+}
+var Q = {
+	menu: q,
+	swap: J,
+	inline: X,
+	segmented: Z
+}, ee = {
+	menu: "div",
+	swap: "div",
+	inline: "nav",
+	segmented: "nav"
+};
+function $({ ref: e, options: t, value: n, variant: r = "menu", size: a = "md", triggerLabel: o, label: s, icon: c = U, open: l, defaultOpen: u, onOpenChange: d, placement: f, slotProps: p, className: m, sx: h, ...g }) {
+	let _ = w([e]), y = t.find((e) => e.value === n), b = t.length, x = y !== void 0, C = !!o;
+	v(() => {
+		process.env.NODE_ENV !== "production" && (x || console.warn(`LocaleSwitcher: value "${n}" matches no option.`), r === "swap" && b !== 2 && console.warn(`LocaleSwitcher: the swap variant expects exactly two options and got ${b}; it links to the first option that is not current.`), r === "menu" && !C && console.warn("LocaleSwitcher: the menu variant needs a triggerLabel that names its action."));
+	}, [
+		r,
+		n,
+		x,
+		b,
+		C
+	]);
+	let T = ee[r], E = Q[r];
+	return /* @__PURE__ */ S(i, {
+		className: m,
+		styles: [D, O[a]],
+		sx: h,
+		children: (e) => /* @__PURE__ */ S(T, {
+			...g,
+			ref: _,
+			"aria-label": g["aria-label"] ?? (T === "nav" ? s : void 0),
+			"data-ui": "locale-switcher",
+			"data-variant": r,
+			className: e,
+			children: /* @__PURE__ */ S(E, {
+				options: t,
+				value: n,
+				current: y,
+				size: a,
+				triggerLabel: o,
+				icon: c,
+				open: l,
+				defaultOpen: u,
+				onOpenChange: d,
+				placement: f,
+				slotProps: p
+			})
+		})
+	});
+}
+$.displayName = "LocaleSwitcher";
+//#endregion
+export { $ as t };

package/dist/locale-switcher.js

@@ -1,2 +1,2 @@
 'use client';
-export { t as LocaleSwitcher } from "./locale-switcher-CZF7XNYG.js";
+export { t as LocaleSwitcher } from "./locale-switcher-DTkySKsM.js";

package/dist/{thread-parts-DfZNz70v.js → thread-parts-Cpktor6D.js}

@@ -4,7 +4,7 @@ import { n as t } from "./media-8yrN85VT.js";
 import { n } from "./roving-focus-CYlo_Kf8.js";
 import { t as r } from "./visually-hidden-DgVO3NaB.js";
 import { t as i } from "./button-C6OV0C7J.js";
-import { t as a } from "./avatar-B6idYC59.js";
+import { t as a } from "./avatar-sPxDqFiZ.js";
 import { n as o, o as s, s as c, t as l } from "./listbox-style-DNOxAulu.js";
 import { t as u } from "./overlay-portal-C9igMHnC.js";
 import { t as d } from "./part-id-D0zksy32.js";

package/dist/{timeline-DaldDMX7.js → timeline-BcF46lG9.js}

@@ -9,7 +9,7 @@ import { t as c } from "./use-controlled-state-DpeVQZNR.js";
 import { t as l } from "./visually-hidden-DgVO3NaB.js";
 import { t as u } from "./renderable-DzcIj1Lo.js";
 import { t as d } from "./icon-wrapper-C-zMD0uL.js";
-import { t as f } from "./avatar-B6idYC59.js";
+import { t as f } from "./avatar-sPxDqFiZ.js";
 import { t as p } from "./part-id-D0zksy32.js";
 import { useEffect as ee, useId as te, useLayoutEffect as ne, useMemo as m, useRef as h, useState as re } from "react";
 import { vars as g } from "@jfrader/tokens/vars";

package/dist/timeline.js

@@ -1,2 +1,2 @@
 'use client';
-export { t as Timeline } from "./timeline-DaldDMX7.js";
+export { t as Timeline } from "./timeline-BcF46lG9.js";

package/dist/types/components/activity-rings/activity-rings.d.ts

@@ -10,10 +10,10 @@ export interface ActivityMetric {
     label: string;
     /** Positive target; nonpositive or nonfinite goals render the metric as unavailable. */
     goal: number;
-    /** Sanctioned `Intl.NumberFormat` unit (`'kilometer'`, `'minute'`, `'hour'`, …); otherwise use `formatValue`. */
+    /** Unit supported by `Intl.NumberFormat` (`'kilometer'`, `'minute'`, `'hour'`, …); otherwise use `formatValue`. */
     unit?: string;
     tone?: ActivityTone;
-    /** Formats amounts for units Intl does not sanction; implement it with Intl. */
+    /** Formats amounts for units Intl does not support. Use Intl in the formatter. */
     formatValue?: (value: number, locale: string | undefined) => string;
 }
 export interface ActivityDay {
@@ -61,9 +61,8 @@ interface ActivityRingsSlotProps {
 /** Metric slot props shared by the toggle-button and plain-row legend elements. */
 export type ActivityRingsMetricProps = Pick<ActivityRingsPartProps<'button'> & ActivityRingsPartProps<'div'>, keyof ActivityRingsPartProps<'button'> & keyof ActivityRingsPartProps<'div'>>;
 /**
- * The metric slot targets the element each legend row renders: a toggle button when
- * `interactiveLegend` is `true`, a plain row when it is `false` or omitted, and only props shared by
- * both when the flag is a runtime boolean.
+ * The metric slot targets a toggle button when `interactiveLegend` is `true`, or a row when false
+ * or omitted. A runtime boolean accepts only props shared by both elements.
  */
 type LegendMode = {
     /** Legend rows become toggle buttons that isolate one ring. */
@@ -103,10 +102,9 @@ export type ActivityRingsProps = Omit<ComponentPropsWithRef<'section'>, 'childre
     hideLegend?: boolean;
 };
 /**
- * Concentric goal rings over the UsageMeter model: each ring is one metric's value against its
- * goal. The SVG is decoration; the legend carries exact amounts, goals and percentages. Optional
- * native radio day picker (arrows native, Home/End added) and opt-in toggle-button legend
- * (Enter/Space isolate one ring).
+ * Compare each metric with its goal using the UsageMeter value rules. The SVG is decorative;
+ * the legend gives amounts, goals, and percentages. The optional day picker uses native radios
+ * with arrows and Home/End. Enable legend toggle buttons to isolate a ring with Enter/Space.
  */
 export declare function ActivityRings({ ref, metrics, values: valuesProp, days: daysProp, value, defaultValue, onValueChange, focusedMetric, defaultFocusedMetric, onFocusedMetricChange, interactiveLegend, onRingClose, size, locale, labels: labelsProp, hideLegend, slotProps, className, sx, 'aria-label': ariaLabel, 'aria-labelledby': labelledBy, ...rest }: ActivityRingsProps): import("@emotion/react/jsx-runtime").JSX.Element;
 export declare namespace ActivityRings {

package/dist/types/components/avatar-group/avatar-group.d.ts

@@ -14,7 +14,7 @@ export interface AvatarGroupPartProps {
     css?: Interpolation<Theme>;
 }
 export interface AvatarGroupProps extends Omit<ComponentPropsWithRef<'div'>, 'children' | 'role'>, SxProps {
-    /** Stable display order of people; immutable input. */
+    /** People in display order. Treat this array as immutable. */
     members: readonly AvatarGroupMember[];
     /** Maximum number of visible people; overflow does not consume a person slot. Defaults to 4. */
     max?: number;
@@ -22,7 +22,7 @@ export interface AvatarGroupProps extends Omit<ComponentPropsWithRef<'div'>, 'ch
     size?: AvatarSize;
     /** Fallback accessible name for the group landmark. Defaults to 'Team members'. */
     label?: string;
-    /** Locale for formatting count numerals; pin for deterministic SSR. Defaults to ambient Intl locale. */
+    /** Locale for counts. Set it for SSR; otherwise uses the environment's Intl locale. */
     locale?: Intl.LocalesArgument;
     /** Formats the accessible name of the overflow image. Defaults to English plural wording. */
     getOverflowLabel?: (hidden: number, formatted: string) => string;
@@ -34,7 +34,7 @@ export interface AvatarGroupProps extends Omit<ComponentPropsWithRef<'div'>, 'ch
         overflow?: AvatarGroupPartProps;
         summary?: AvatarGroupPartProps;
     };
-    /** Shared styling overrides passed down to each child Avatar. Cannot override id/name/status. */
+    /** Style overrides for each Avatar. Cannot override id/name/status. */
     avatarProps?: Pick<AvatarProps, 'slotProps' | 'sx' | 'className'>;
 }
 export declare function AvatarGroup({ ref, members, max, size, label, locale, getOverflowLabel, getSummaryLabel, slotProps, avatarProps, className, sx, ...rest }: AvatarGroupProps): import("@emotion/react/jsx-runtime").JSX.Element;

package/dist/types/components/button/button.d.ts

@@ -20,15 +20,15 @@ export interface ButtonProps extends Omit<ComponentPropsWithRef<'button'>, 'colo
     /** Consumer style overrides, merged after the component's own styles. */
     css?: Interpolation<Theme>;
     /**
-     * Replaces the native button. Spread ALL supplied props onto the operative element and attach
-     * the supplied ref. Both that ref and the forwarded ref refer to the rendered element, which
-     * need not be a button; the public forwarded-ref type remains HTMLButtonElement for compatibility.
-     * Overridden handlers, className and style win; compose behavior manually to retain both:
+     * Replaces the native button. Spread all supplied props onto the element and attach the supplied
+     * ref. Both refs target that element, even when it is not a button. The public ref type remains
+     * HTMLButtonElement for compatibility.
+     * Your handlers, className, and style override the supplied ones. Compose handlers to keep both:
      * `onClick={(e) => { p.onClick?.(e); mine(e); }}`.
-     * Only this render path joins data-ui markers into a token list; library selectors should use
+     * This render path joins data-ui markers into a token list. Library selectors should use
      * `[data-ui~="button"]`. The default button always has data-ui="button".
-     * Disabled anchors receive aria-disabled and remain focusable. Primary click/Enter activation
-     * is blocked by the supplied handler; auxiliary/middle-click navigation is NOT covered.
+     * Disabled anchors receive aria-disabled and stay focusable. The supplied handler blocks primary
+     * click and Enter activation; it does not block auxiliary or middle-click navigation.
      */
     render?: (props: ButtonRenderProps) => ReactNode;
 }

package/dist/types/components/card/card.d.ts

@@ -18,7 +18,10 @@ export interface CardSlotProps {
 }
 export interface CardProps extends ComponentPropsWithRef<'div'>, SxProps {
     variant?: CardVariant;
-    /** `contrast` paints the dark theme's own palette for this card on any page theme. */
+    /**
+     * `contrast` uses the dark palette with a charcoal surface on any page theme.
+     * Omit this prop or use `default` to keep the enclosing theme.
+     */
     appearance?: SurfaceAppearance;
     slotProps?: CardSlotProps;
 }

package/dist/types/components/chip-group/chip-group.d.ts

@@ -45,8 +45,8 @@ export interface ChipGroupMultipleProps extends ChipGroupBaseProps {
     onValueChange?: (value: string[]) => void;
 }
 export type ChipGroupProps = ChipGroupSingleProps | ChipGroupMultipleProps;
-/** Clearable pressed-button filters. Arrows (horizontal RTL-aware), Home/End move focus only;
- * Enter/Space toggle. Multiple values are emitted in option order, not activation order. */
+/** Choose and clear filters. Arrows and Home/End move focus; horizontal arrows reverse in RTL.
+ * Enter/Space toggle selection. Multiple values are reported in option order. */
 export declare function ChipGroup({ ref, options, type, value: valueProp, defaultValue, onValueChange, label, allowEmpty, disabled, size, maxVisible, expanded: expandedProp, defaultExpanded, onExpandedChange, locale, moreLabel, lessLabel, slotProps, className, sx, onKeyDown, onBlur, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledBy, ...rest }: ChipGroupProps): import("@emotion/react/jsx-runtime").JSX.Element;
 export declare namespace ChipGroup {
     var displayName: string;

package/dist/types/components/combobox/combobox.d.ts

@@ -12,14 +12,14 @@ export interface ComboboxProps {
     onOpenChange?: (open: boolean) => void;
     /** Renders a hidden input so the value takes part in native form submission. */
     name?: string;
-    /** Decides whether an option label matches the typed query. Defaults to a case-insensitive substring match. */
+    /** Matches an option label to the query. Defaults to a case-insensitive substring match. */
     filter?: (label: string, query: string) => boolean;
     /** Fires with the new input text when the user types and when a selection or Escape writes a label. */
     onInputChange?: (query: string) => void;
     children?: ReactNode;
 }
 export interface ComboboxInputProps extends Omit<TextFieldProps, 'value' | 'defaultValue' | 'onValueChange'> {
-    /** Root `name` is the canonical form name; an Input `name` submits an extra text entry. */
+    /** Root `name` submits the selected value. Input `name` submits an extra text entry. */
     name?: string;
     /** Controlled input text. */
     inputValue?: string;

package/dist/types/components/command-palette/command-palette.d.ts

@@ -6,7 +6,7 @@ export interface CommandPaletteProps {
     onOpenChange?: (open: boolean) => void;
     /** Accessible name of the dialog, input and listbox. */
     label?: string;
-    /** Decides whether an item's label (or keywords) matches the query. Case-insensitive substring by default. */
+    /** Matches an item's label or keywords to the query. Defaults to a case-insensitive substring match. */
     filter?: (text: string, query: string) => boolean;
     /** Rendered by CommandPalette.Empty when nothing matches. */
     emptyMessage?: ReactNode;

package/dist/types/components/comment-thread/comment-thread.d.ts

@@ -8,7 +8,7 @@ export type CommentReaction = ThreadReaction;
 export type CommentThreadSize = ThreadSize;
 export type CommentThreadHeadingLevel = 2 | 3 | 4 | 5 | 6;
 export type CommentThreadPartProps = ThreadPartProps;
-/** What a proposed tree changes; `parentId` is where a reply actually attached after `maxDepth`. */
+/** Describes a proposed change. `parentId` is the reply's attachment point after applying `maxDepth`. */
 export type CommentThreadEvent = {
     type: 'reply';
     comment: ThreadComment;
@@ -65,9 +65,9 @@ export interface CommentThreadLabels extends ThreadReactionLabels {
 }
 type CommentThreadPart = 'header' | 'title' | 'list' | 'item' | 'article' | 'time' | 'body' | 'replies' | 'actions' | 'reaction' | 'composer' | 'resolved' | 'status';
 export type CommentThreadSlotProps = Partial<Record<CommentThreadPart, CommentThreadPartProps>> & {
-    /** Extra Textarea props for every composer and editor; handlers are composed with the thread's. */
+    /** Textarea props for every composer and editor. Handlers are combined with the thread's handlers. */
     textarea?: ThreadTextareaProps;
-    /** Extra Button props for every Send/Save button; `onClick` runs first and may `preventDefault()`. */
+    /** Button props for Send/Save. `onClick` runs first and can call `preventDefault()`. */
     send?: ThreadButtonProps;
 };
 export interface CommentThreadProps extends Omit<ComponentPropsWithRef<'section'>, 'defaultValue' | 'onChange' | 'children' | 'title'>, SxProps {
@@ -76,7 +76,7 @@ export interface CommentThreadProps extends Omit<ComponentPropsWithRef<'section'
     defaultValue?: readonly ThreadComment[];
     /** The full proposed tree plus what changed. */
     onValueChange?: (next: ThreadComment[], event: CommentThreadEvent) => void;
-    /** Whose comments are editable; authorization stays on the server. */
+    /** Determines whose comments can be edited. Enforce authorization on the server. */
     currentUser: CommentAuthor;
     /** Mention candidates; defaults to every author plus `currentUser`. Deduped by id. */
     people?: readonly CommentAuthor[];

package/dist/types/components/copy-button/copy-button.d.ts

@@ -15,17 +15,17 @@ export interface CopyButtonSlotProps {
 export interface CopyButtonProps extends Omit<ComponentPropsWithRef<'button'>, 'children' | 'value' | 'defaultValue' | 'color' | 'type'>, SxProps {
     /** The string written to the clipboard. An empty string is a valid payload. */
     text: string;
-    /** Accessible name and idle face, e.g. "Copy command". */
+    /** Accessible name and label while idle, e.g. "Copy command". */
     label: string;
-    /** Face and announcement while the write is in flight. */
+    /** Label and announcement while copying. */
     pendingLabel: string;
-    /** Face and announcement after a successful write. */
+    /** Label and announcement after copying succeeds. */
     copiedLabel: string;
-    /** Face and announcement after a failed or unavailable write. */
+    /** Label and announcement when copying fails or is unavailable. */
     errorLabel: string;
     /** Hides the visible label; the accessible name and announcements stay. */
     iconOnly?: boolean;
-    /** Decorative icon per face; a supplied key replaces the default, including `null` for none. */
+    /** Icon for each state. A supplied key replaces the default; `null` removes it. */
     icons?: CopyButtonIcons;
     value?: CopyButtonValue;
     defaultValue?: CopyButtonValue;
@@ -34,7 +34,7 @@ export interface CopyButtonProps extends Omit<ComponentPropsWithRef<'button'>, '
     onCopied?: (text: string) => void;
     /** Called once per failed write, including a missing Clipboard API. */
     onCopyError?: (error: unknown) => void;
-    /** Milliseconds before `copied`/`error` request `idle`; 0 keeps the result face. */
+    /** Milliseconds before `copied`/`error` request `idle`; 0 keeps the result label. */
     resetAfterMs?: number;
     variant?: ButtonVariant;
     tone?: ButtonTone;

package/dist/types/components/countdown/countdown.d.ts

@@ -20,7 +20,7 @@ export interface CountdownProps extends Omit<ComponentPropsWithRef<'div'>, 'chil
     pendingLabel?: ReactNode;
     invalidLabel?: ReactNode;
     invalidText?: string;
-    /** Authoritative epoch-ms source. Background callbacks run at the first executable wake-up. */
+    /** Clock source in epoch milliseconds. Background callbacks run when execution next becomes possible. */
     clock?: () => number;
     /** Shared server snapshot for identical SSR and hydration output. */
     initialNow?: number;
@@ -30,7 +30,7 @@ export interface CountdownProps extends Omit<ComponentPropsWithRef<'div'>, 'chil
     completionIcon?: ReactNode;
     slotProps?: Partial<Record<'label' | 'content' | 'unit' | 'number' | 'complete' | 'icon' | 'description', CountdownPartProps>>;
 }
-/** Noninteractive ARIA timer. Tab and every other key pass through; no focus or editable state. */
+/** Show an ARIA timer without controls. Tab and other keys pass through; it cannot be focused or edited. */
 export declare function Countdown({ ref, target, variant, units, label, locale, unitDisplay, completeLabel, completeText, pendingLabel, invalidLabel, invalidText, clock, initialNow, onComplete, announceCompletion, completionIcon, slotProps, className, sx, 'aria-labelledby': externalLabel, 'aria-describedby': externalDescription, 'aria-label': ariaLabel, ...rest }: CountdownProps): import("@emotion/react/jsx-runtime").JSX.Element;
 export declare namespace Countdown {
     var displayName: string;