asheeui 0.7.0 → 1.0.0

package/dist/components/autocomplete/Autocomplete.js

@@ -3,77 +3,113 @@
 import { useAsheeConfig as e } from "../../libs/context.js";
 import { resolveCascade as t, resolveRadiusKey as n } from "../../utils/resolve-token.js";
 import { Input as r } from "../input/Input.js";
-import { SelectMenu as i } from "../select-menu/SelectMenu.js";
-import { useSelectFloating as a } from "../select-menu/use-select-floating.js";
-import { FALLBACK_AUTOCOMPLETE_CONFIG as o } from "./autocomplete-config.js";
-import { forwardRef as s, useCallback as c, useEffect as l, useMemo as u, useState as d } from "react";
-import { jsx as f, jsxs as p } from "react/jsx-runtime";
-import { useDismiss as m, useFocus as h, useInteractions as g, useRole as _ } from "@floating-ui/react";
+import { edgeOptionIndex as i, nextOptionIndex as a } from "../menu/menu-navigation.js";
+import { Menu as o, menuOptionId as s } from "../menu/Menu.js";
+import { useMenuFloating as c } from "../menu/use-menu-floating.js";
+import { FALLBACK_AUTOCOMPLETE_CONFIG as l } from "./autocomplete-config.js";
+import { forwardRef as u, useCallback as d, useEffect as f, useMemo as p, useState as m } from "react";
+import { jsx as h, jsxs as g } from "react/jsx-runtime";
+import { useDismiss as _, useFocus as ee, useInteractions as v, useRole as y } from "@floating-ui/react";
 //#region src/components/autocomplete/Autocomplete.tsx
-var v = s(({ options: s = [], value: v, onValueChange: y, onInputChange: b, allowCustomValue: x = !1, belowList: S, menu: C, variant: w, color: T, radius: E, size: D, endContent: O, onClick: k, disabled: A, placeholder: j = "Type to search...", className: M, ...N }, P) => {
-	let F = e(), I = F.components?.autocomplete, L = t(w, I?.variant, F.defaultVariant, o.variant), R = t(T, I?.color, F.defaultColor, o.color), z = n(E, I?.radius, F.defaultRadius, o.radius), ee = t(D, I?.size, void 0, o.size), B = u(() => s.find((e) => e.value === v), [s, v]), [V, H] = d(!1), [U, W] = d(() => B ? B.label : String(v ?? ""));
-	l(() => {
-		B ? W(B.label) : v != null && W(String(v));
-	}, [B, v]);
-	let { refs: G, context: K, isPositioned: q, floatingStyles: J } = a({
-		isOpen: V,
-		onOpenChange: H,
-		disabled: A
-	}), Y = h(K), X = m(K), Z = _(K, { role: "combobox" }), { getReferenceProps: Q, getFloatingProps: $ } = g([
-		Y,
-		X,
-		Z
-	]), te = u(() => U.trim() ? s.filter((e) => e.label.toLowerCase().includes(U.toLowerCase())) : s, [s, U]), ne = c((e) => {
+var b = u(({ options: u = [], value: b, onValueChange: x, onInputChange: S, allowCustomValue: C = !1, belowList: w, menu: T, variant: te, color: ne, radius: E, size: D, endContent: O, onClick: k, onKeyDown: A, disabled: j, placeholder: M = "Type to search...", className: N, ...P }, F) => {
+	let I = e(), L = I.components?.autocomplete, R = t(te, L?.variant, I.defaultVariant, l.variant), z = t(ne, L?.color, I.defaultColor, l.color), B = n(E, L?.radius, I.defaultRadius, l.radius), V = t(D, L?.size, void 0, l.size), H = p(() => u.find((e) => e.value === b), [u, b]), [U, W] = m(!1), [G, K] = m(() => H ? H.label : String(b ?? "")), [q, J] = m(null);
+	f(() => {
+		H ? K(H.label) : b != null && K(String(b));
+	}, [H, b]);
+	let { refs: Y, context: X, isPositioned: Z, floatingStyles: re } = c({
+		isOpen: U,
+		onOpenChange: W,
+		disabled: j
+	}), ie = ee(X), ae = _(X), oe = y(X, { role: "combobox" }), { getReferenceProps: se, getFloatingProps: ce } = v([
+		ie,
+		ae,
+		oe
+	]), Q = p(() => G.trim() ? u.filter((e) => e.label.toLowerCase().includes(G.toLowerCase())) : u, [u, G]), le = d((e) => {
 		let t = e.target.value;
-		W(t), b?.(t), H(!0), x && y?.(t);
+		K(t), S?.(t), W(!0), J(null), C && x?.(t);
 	}, [
-		x,
-		b,
-		y
-	]), re = c((e) => {
-		W(e.label), y?.(e.value, e), H(!1);
-	}, [y]), ie = u(() => v == null ? [] : [v], [v]);
-	return /* @__PURE__ */ p("div", {
+		C,
+		S,
+		x
+	]), $ = d((e) => {
+		K(e.label), x?.(e.value, e), W(!1), J(null);
+	}, [x]), ue = d((e) => {
+		if (A?.(e), e.defaultPrevented || j) return;
+		let t = e.key === "ArrowDown" ? 1 : e.key === "ArrowUp" ? -1 : 0;
+		if (t !== 0) {
+			if (e.preventDefault(), !U) {
+				W(!0);
+				return;
+			}
+			J((e) => a(Q, e, t));
+			return;
+		}
+		if (e.key === "Home" || e.key === "End") {
+			if (!U) return;
+			e.preventDefault(), J(i(Q, e.key === "Home" ? "first" : "last"));
+			return;
+		}
+		if (e.key === "Enter" && U) {
+			let t = q === null ? void 0 : Q[q];
+			t && !t.disabled && (e.preventDefault(), $(t));
+			return;
+		}
+		e.key === "Escape" && U && (W(!1), J(null));
+	}, [
+		q,
+		A,
+		j,
+		Q,
+		$,
+		U
+	]), de = q === null ? void 0 : s(X.floatingId, q), fe = se({
+		...P,
+		onKeyDown: ue
+	}), pe = p(() => b == null ? [] : [b], [b]);
+	return /* @__PURE__ */ g("div", {
 		className: "w-full relative inline-block",
-		children: [/* @__PURE__ */ f(r, {
+		children: [/* @__PURE__ */ h(r, {
 			ref: (e) => {
-				G.setReference(e), typeof P == "function" ? P(e) : P && (P.current = e);
+				Y.setReference(e), typeof F == "function" ? F(e) : F && (F.current = e);
 			},
-			variant: L,
-			radius: z,
-			color: R,
-			size: ee,
-			disabled: A,
-			placeholder: j,
-			value: U,
-			onChange: ne,
+			variant: R,
+			radius: B,
+			color: z,
+			size: V,
+			disabled: j,
+			placeholder: M,
+			value: G,
+			onChange: le,
 			onClick: (e) => {
-				A || H(!0), k?.(e);
+				j || W(!0), k?.(e);
 			},
-			"aria-expanded": V,
-			"aria-autocomplete": "none",
+			"aria-expanded": U,
+			"aria-autocomplete": "list",
+			"aria-activedescendant": de,
 			endContent: O,
-			className: M,
-			...Q(N)
-		}), /* @__PURE__ */ f(i, {
-			isOpen: V,
-			floatingStyles: J,
-			context: K,
-			getFloatingProps: $,
-			setFloatingRef: G.setFloating,
-			isPositioned: q,
-			options: te,
-			selectedValues: ie,
-			onSelectMenuOption: re,
+			className: N,
+			...fe
+		}), /* @__PURE__ */ h(o, {
+			isOpen: U,
+			floatingStyles: re,
+			context: X,
+			getFloatingProps: ce,
+			setFloatingRef: Y.setFloating,
+			isPositioned: Z,
+			activeIndex: q,
+			onActiveIndexChange: J,
+			options: Q,
+			selectedValues: pe,
+			onOptionSelect: $,
 			isSearch: !1,
-			belowList: S,
-			menuProps: C,
-			menuConfig: I?.menu,
+			belowList: w,
+			menuProps: T,
+			menuConfig: L?.menu,
 			initialFocus: -1,
 			returnFocus: !1
 		})]
 	});
 });
-v.displayName = "Autocomplete";
+b.displayName = "Autocomplete";
 //#endregion
-export { v as Autocomplete };
+export { b as Autocomplete };

package/dist/components/autocomplete/autocomplete-config.d.ts

@@ -1,5 +1,5 @@
 import { InputConfig } from '../input';
-import { MenuConfig } from '../select-menu';
+import { MenuConfig } from '../menu';
 /**
  * Theme configuration options for the Autocomplete component.
  *

package/dist/components/autocomplete/autocomplete-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"autocomplete-config.d.ts","sourceRoot":"","sources":["../../../src/components/autocomplete/autocomplete-config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,WAAW,kBAAmB,SAAQ,WAAW;IACrD;;;OAGG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAAE,kBAEvC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;CAE/B,CAAC;AAEX,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,YAAY,EAAE,kBAAkB,CAAC;KAClC;CACF"}
+{"version":3,"file":"autocomplete-config.d.ts","sourceRoot":"","sources":["../../../src/components/autocomplete/autocomplete-config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;;;;;GAMG;AACH,MAAM,WAAW,kBAAmB,SAAQ,WAAW;IACrD;;;OAGG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAAE,kBAEvC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;CAE/B,CAAC;AAEX,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,YAAY,EAAE,kBAAkB,CAAC;KAClC;CACF"}

package/dist/components/avatar/Avatar.d.ts

@@ -0,0 +1,87 @@
+import { ElementType, HTMLAttributes, ReactNode } from 'react';
+import { AvatarConfig } from './avatar-config';
+type BaseAvatarProps = AvatarConfig & Omit<HTMLAttributes<HTMLDivElement>, "color" | "children">;
+/**
+ * Configuration options for the Avatar component.
+ */
+export interface AvatarProps extends BaseAvatarProps {
+    /**
+     * Name of the represented entity.
+     * Supplies the initials the avatar falls back to and, unless `alt` overrides
+     * it, the name assistive technology reads.
+     */
+    name?: string;
+    /**
+     * Picture of the represented entity.
+     * When it is missing or fails to load, the avatar shows its fallback.
+     */
+    src?: string;
+    /**
+     * Name assistive technology reads, instead of `name`.
+     * Use it when the entity's name is not the wording the avatar should carry.
+     */
+    alt?: string;
+    /**
+     * Component that replaces the picture inside the avatar, passed to
+     * {@link Image}. This is how a consumer keeps a framework image working
+     * inside an avatar.
+     */
+    component?: ElementType;
+    /**
+     * Additional props for that component, passed to {@link Image}.
+     */
+    componentProps?: Record<string, unknown>;
+    /**
+     * Content shown in place of the initials when there is no picture.
+     */
+    fallback?: ReactNode;
+}
+/**
+ * An entity representation with an initials fallback.
+ *
+ * Avatar shows the picture of a person or an entity, and falls back to that
+ * entity's initials when there is no picture or the picture fails to load. The
+ * fallback sits on the accent surface of the resolved colour, and the picture
+ * is rendered through the framework's {@link Image} primitive, so a consumer
+ * keeps its own image component by passing `component`.
+ *
+ * The avatar carries the entity's name as a single image role with a label, so
+ * assistive technology reads one name instead of the initials and the picture
+ * separately. With neither a name nor an alternative given, the avatar is
+ * decoration and is hidden from assistive technology: that is the right
+ * behaviour for a purely decorative picture beside text that already names the
+ * entity.
+ *
+ * Diameter, radius and colour resolve through the standard AsheeUI cascade:
+ * prop, component config, global theme defaults, and the built-in fallback.
+ *
+ * @param props - Avatar configuration options and div attributes.
+ * @param props.name - The represented entity's name.
+ * @param props.src - The picture's source.
+ * @param props.alt - Name for assistive technology, instead of `name`.
+ * @param props.component - Custom image component, passed to `Image`.
+ * @param props.componentProps - Additional props for that component.
+ * @param props.fallback - Content shown when there is no picture.
+ * @param props.size - Diameter scale. Defaults to "md".
+ * @param props.radius - Corner rounding. Defaults to "full".
+ * @param props.color - Accent colour of the fallback surface.
+ * @param props.className - Extra classes applied last, which is where a
+ * consumer overrides the diameter.
+ *
+ * @example
+ * ```tsx
+ * <Avatar name="Ada Lovelace" src="/ada.png" />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // No picture: the initials carry the identity.
+ * <Avatar name="Ada Lovelace" size="lg" />
+ * ```
+ *
+ * @see AvatarConfig - The configuration type for component defaults.
+ * @see Image - The framework's image primitive.
+ */
+export declare const Avatar: import('react').ForwardRefExoticComponent<AvatarProps & import('react').RefAttributes<HTMLDivElement>>;
+export {};
+//# sourceMappingURL=Avatar.d.ts.map

package/dist/components/avatar/Avatar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Avatar.d.ts","sourceRoot":"","sources":["../../../src/components/avatar/Avatar.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EACL,KAAK,WAAW,EAEhB,KAAK,cAAc,EACnB,KAAK,SAAS,EAEf,MAAM,OAAO,CAAC;AAOf,OAAO,EACL,KAAK,YAAY,EAElB,MAAM,iBAAiB,CAAC;AASzB,KAAK,eAAe,GAAG,YAAY,GACjC,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,eAAe;IAClD;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,SAAS,CAAC,EAAE,WAAW,CAAC;IAExB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEzC;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,eAAO,MAAM,MAAM,wGAsGlB,CAAC"}

package/dist/components/avatar/Avatar.js

@@ -0,0 +1,43 @@
+"use client";
+"use client";
+import { cn as e } from "../../utils/cn.js";
+import { RADIUS_CLASS as t } from "../../shared/radius.js";
+import { resolveVariantClass as n } from "../../shared/variant.js";
+import { useAsheeConfig as r } from "../../libs/context.js";
+import { resolveCascade as i, resolveClassKey as a } from "../../utils/resolve-token.js";
+import { Image as o } from "../image/Image.js";
+import { FALLBACK_AVATAR_CONFIG as s } from "./avatar-config.js";
+import { AVATAR_BASE_CLASS as c, AVATAR_FALLBACK_VARIANT as l, AVATAR_FONT_CLASS as u, AVATAR_SIZE_CLASS as d } from "./avatar-styles.js";
+import { getInitials as f } from "./avatar.helpers.js";
+import { forwardRef as p, useState as m } from "react";
+import { jsx as h } from "react/jsx-runtime";
+//#region src/components/avatar/Avatar.tsx
+var g = p(({ name: p, src: g, alt: _, component: v, componentProps: y, fallback: b, size: x, radius: S, color: C, className: w, ...T }, E) => {
+	let D = r(), O = D.components?.avatar, [k, A] = m(!1), j = i(x, O?.size, void 0, s.size), M = i(S, O?.radius, D.defaultRadius, s.radius), N = i(C, O?.color, D.defaultColor, s.color), P = a(j, d, s.size), F = a(j, u, s.size), I = a(M, t, s.radius), L = _ ?? p, R = !!g && !k;
+	return /* @__PURE__ */ h("div", {
+		ref: E,
+		role: "img",
+		"aria-label": L,
+		"aria-hidden": !L || void 0,
+		className: e(c, P, I, w),
+		...T,
+		children: R ? /* @__PURE__ */ h(o, {
+			src: g,
+			alt: "",
+			component: v,
+			componentProps: y,
+			fit: "cover",
+			radius: M,
+			showSkeleton: !1,
+			onError: () => A(!0),
+			className: "size-full"
+		}) : /* @__PURE__ */ h("span", {
+			"aria-hidden": "true",
+			className: e("inline-flex items-center justify-center size-full", F, n(l, N)),
+			children: b ?? f(p ?? "")
+		})
+	});
+});
+g.displayName = "Avatar";
+//#endregion
+export { g as Avatar };

package/dist/components/avatar/avatar-config.d.ts

@@ -0,0 +1,48 @@
+import { Color, Radius, Size } from '../../shared';
+/**
+ * Theme configuration options for the Avatar component.
+ *
+ * Set under `components.avatar` in the AsheeUI config. Values feed the
+ * component-level fallback tier of the theme cascade.
+ */
+export interface AvatarConfig {
+    /**
+     * Diameter scale of the avatar.
+     *
+     * @default "md"
+     */
+    size?: Size;
+    /**
+     * Corner rounding.
+     * The default makes a circular avatar; a smaller radius makes it square.
+     *
+     * @default "full"
+     */
+    radius?: Radius;
+    /**
+     * Theme accent colour.
+     * Colours the surface the initials fall back to. It does not tint the image.
+     *
+     * @default "primary"
+     */
+    color?: Color;
+}
+/**
+ * Default config values registered for the Avatar component.
+ *
+ * `color` is intentionally absent so it inherits from the global
+ * `defaultColor`.
+ */
+export declare const defaultAvatarConfig: AvatarConfig;
+/**
+ * Hard fallback values used when no config tier provides a value.
+ * These values are used when instance props, component config,
+ * and global defaults are all undefined.
+ */
+export declare const FALLBACK_AVATAR_CONFIG: Required<AvatarConfig>;
+declare module "../../libs/registry" {
+    interface ComponentTypeConfigRegistry {
+        avatar: AvatarConfig;
+    }
+}
+//# sourceMappingURL=avatar-config.d.ts.map

package/dist/components/avatar/avatar-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"avatar-config.d.ts","sourceRoot":"","sources":["../../../src/components/avatar/avatar-config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAExD;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;IAEZ;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,YAGjC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,YAAY,CAIhD,CAAC;AAEX,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,MAAM,EAAE,YAAY,CAAC;KACtB;CACF"}

package/dist/components/avatar/avatar-config.js

@@ -0,0 +1,14 @@
+"use client";
+import { registerComponentDefaults as e } from "../../libs/registry.js";
+//#region src/components/avatar/avatar-config.ts
+var t = {
+	size: "md",
+	radius: "full"
+}, n = {
+	size: "md",
+	radius: "full",
+	color: "primary"
+};
+e("avatar", t);
+//#endregion
+export { n as FALLBACK_AVATAR_CONFIG, t as defaultAvatarConfig };

package/dist/components/avatar/avatar-styles.d.ts

@@ -0,0 +1,21 @@
+import { Size, Variant } from '../../shared';
+/**
+ * CSS classes for the avatar's diameter based on size.
+ */
+export declare const AVATAR_SIZE_CLASS: Record<Size, string>;
+/**
+ * CSS classes for the initials' font size based on size.
+ */
+export declare const AVATAR_FONT_CLASS: Record<Size, string>;
+/**
+ * Base classes for the avatar frame.
+ * The frame clips the picture to the resolved radius and centres a fallback.
+ */
+export declare const AVATAR_BASE_CLASS = "relative inline-flex items-center justify-center shrink-0 overflow-hidden select-none font-medium uppercase";
+/**
+ * The variant the initials fall back to.
+ * An avatar shows an entity, so its fallback is a filled accent surface rather
+ * than an outline or a tint.
+ */
+export declare const AVATAR_FALLBACK_VARIANT: Variant;
+//# sourceMappingURL=avatar-styles.d.ts.map

package/dist/components/avatar/avatar-styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"avatar-styles.d.ts","sourceRoot":"","sources":["../../../src/components/avatar/avatar-styles.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAIlD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAIlD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,gHACiF,CAAC;AAEhH;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,EAAE,OAAiB,CAAC"}

package/dist/components/avatar/avatar-styles.js

@@ -0,0 +1,13 @@
+"use client";
+//#region src/components/avatar/avatar-styles.ts
+var e = {
+	sm: "size-8",
+	md: "size-10",
+	lg: "size-12"
+}, t = {
+	sm: "text-xs",
+	md: "text-sm",
+	lg: "text-base"
+}, n = "relative inline-flex items-center justify-center shrink-0 overflow-hidden select-none font-medium uppercase", r = "solid";
+//#endregion
+export { n as AVATAR_BASE_CLASS, r as AVATAR_FALLBACK_VARIANT, t as AVATAR_FONT_CLASS, e as AVATAR_SIZE_CLASS };

package/dist/components/avatar/avatar.helpers.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Avatar helpers for AsheeUI.
+ * This file provides the small pure helpers the Avatar component needs, kept
+ * apart from the component so they can be reasoned about and tested on their
+ * own.
+ */
+/**
+ * Derives the initials shown when an avatar has no picture.
+ *
+ * A single word contributes its first two characters, and a longer name
+ * contributes the first character of its first and last word, which is what
+ * identifies a person in most name orders.
+ *
+ * @param name - The represented entity's name.
+ * @returns One or two uppercase characters, or an empty string when there is
+ * nothing to derive them from.
+ */
+export declare function getInitials(name: string): string;
+//# sourceMappingURL=avatar.helpers.d.ts.map

package/dist/components/avatar/avatar.helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"avatar.helpers.d.ts","sourceRoot":"","sources":["../../../src/components/avatar/avatar.helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAUhD"}

package/dist/components/avatar/avatar.helpers.js

@@ -0,0 +1,11 @@
+"use client";
+//#region src/components/avatar/avatar.helpers.ts
+function e(e) {
+	let t = e.trim().split(/\s+/).filter(Boolean);
+	if (t.length === 0) return "";
+	if (t.length === 1) return t[0].slice(0, 2).toUpperCase();
+	let n = t[0], r = t[t.length - 1];
+	return `${n[0]}${r[0]}`.toUpperCase();
+}
+//#endregion
+export { e as getInitials };

package/dist/components/avatar/index.d.ts

@@ -0,0 +1,3 @@
+export * from './Avatar';
+export * from './avatar-config';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/avatar/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/avatar/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC"}

package/dist/components/avatar/index.js

@@ -0,0 +1,4 @@
+export * from "./Avatar.js";
+export * from "./avatar-config.js";
+export * from "./avatar-styles.js";
+export * from "./avatar.helpers.js";

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

@@ -0,0 +1,69 @@
+import { HTMLAttributes, ReactNode } from 'react';
+import { BadgeConfig } from './badge-config';
+type BaseBadgeProps = BadgeConfig & Omit<HTMLAttributes<HTMLSpanElement>, "color" | "content">;
+/**
+ * Configuration options for the Badge component.
+ */
+export interface BadgeProps extends BaseBadgeProps {
+    /**
+     * Badge content.
+     * Typically a short piece of text. Omit it when the badge shows only an icon
+     * and pass `label` instead so the badge still has an accessible name.
+     */
+    children?: ReactNode;
+    /**
+     * Text that stands in for the badge's content.
+     * Use it when the badge shows only an icon: the text is rendered for
+     * assistive technology and the visible content is treated as decoration. A
+     * badge with visible text does not need it, because its text is its content.
+     */
+    label?: string;
+    /**
+     * Content rendered before the badge text, typically an icon.
+     */
+    startContent?: ReactNode;
+    /**
+     * Content rendered after the badge text, typically an icon.
+     */
+    endContent?: ReactNode;
+}
+/**
+ * A compact status or label indicator.
+ *
+ * Badge renders an inline, non-interactive element for short pieces of status
+ * or category information. Its colour, variant, size, and radius resolve
+ * through the standard AsheeUI cascade: prop, component config, global theme
+ * defaults, and the built-in fallback. It is decorative in the sense that it
+ * carries no interaction of its own: pointer events, focus, and keyboard
+ * behaviour belong to whatever it is placed inside.
+ *
+ * Consumer `className` is appended last, so it can restyle or reposition the
+ * badge without fighting the framework's classes.
+ *
+ * @param props - Badge configuration options and span attributes.
+ * @param props.children - Badge text or content.
+ * @param props.label - Text that stands in for the content of an icon-only badge.
+ * @param props.variant - Visual style variant. Defaults to the configured value.
+ * @param props.color - Theme accent colour. Defaults to the configured value.
+ * @param props.size - Density scale. Defaults to "md".
+ * @param props.radius - Corner rounding. Defaults to "full".
+ * @param props.startContent - Content rendered before the badge text.
+ * @param props.endContent - Content rendered after the badge text.
+ * @param props.className - Extra classes applied last.
+ *
+ * @example
+ * ```tsx
+ * <Badge color="success">Active</Badge>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Icon only: the label is the badge's accessible name.
+ * <Badge label="Active" startContent={<CheckIcon />} />
+ * ```
+ *
+ * @see BadgeConfig - The configuration type for component defaults.
+ */
+export declare const Badge: import('react').ForwardRefExoticComponent<BadgeProps & import('react').RefAttributes<HTMLSpanElement>>;
+export {};
+//# sourceMappingURL=Badge.d.ts.map

package/dist/components/badge/Badge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Badge.d.ts","sourceRoot":"","sources":["../../../src/components/badge/Badge.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAiBf,OAAO,EACL,KAAK,WAAW,EAGjB,MAAM,gBAAgB,CAAC;AAExB,KAAK,cAAc,GAAG,WAAW,GAC/B,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,cAAc;IAChD;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IAErB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,YAAY,CAAC,EAAE,SAAS,CAAC;IAEzB;;OAEG;IACH,UAAU,CAAC,EAAE,SAAS,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,eAAO,MAAM,KAAK,wGA+HjB,CAAC"}

package/dist/components/badge/Badge.js

@@ -0,0 +1,39 @@
+"use client";
+"use client";
+import { cn as e } from "../../utils/cn.js";
+import { RADIUS_CLASS as t } from "../../shared/radius.js";
+import { resolveVariantClass as n } from "../../shared/variant.js";
+import { useAsheeConfig as r } from "../../libs/context.js";
+import { resolveCascade as i, resolveClassKey as a, resolveRadiusKey as o } from "../../utils/resolve-token.js";
+import { BADGE_FONT_CLASS as s, BADGE_GAP_CLASS as c, BADGE_HEIGHT_CLASS as l, BADGE_ICON_SIZE_CLASS as u, BADGE_PADDING_CLASS as d } from "./badge-styles.js";
+import { FALLBACK_BADGE_CONFIG as f } from "./badge-config.js";
+import { forwardRef as p } from "react";
+import { Fragment as m, jsx as h, jsxs as g } from "react/jsx-runtime";
+//#region src/components/badge/Badge.tsx
+var _ = p(({ variant: p, color: _, size: v, radius: y, label: b, children: x, startContent: S, endContent: C, className: w, ...T }, E) => {
+	let D = r(), O = D.components?.badge, k = i(p, O?.variant, D.defaultVariant, f.variant), A = k === "underlined" ? "bordered" : k, j = i(_, O?.color, D.defaultColor, f.color), M = i(v, O?.size, void 0, f.size), N = o(y, O?.radius, D.defaultRadius, f.radius), P = a(M, l, f.size), F = a(M, d, f.size), I = a(M, s, f.size), L = a(M, c, f.size), R = a(M, u, f.size), z = a(N, t, f.radius);
+	return /* @__PURE__ */ h("span", {
+		ref: E,
+		className: e("inline-flex items-center justify-center shrink-0 whitespace-nowrap font-medium select-none", P, F, I, L, R, z, n(A, j), w),
+		...T,
+		children: b ? /* @__PURE__ */ g(m, { children: [/* @__PURE__ */ h("span", {
+			className: "sr-only",
+			children: b
+		}), /* @__PURE__ */ g("span", {
+			"aria-hidden": "true",
+			className: e("inline-flex items-center", L),
+			children: [
+				S,
+				x,
+				C
+			]
+		})] }) : /* @__PURE__ */ g(m, { children: [
+			S,
+			x,
+			C
+		] })
+	});
+});
+_.displayName = "Badge";
+//#endregion
+export { _ as Badge };