asheeui 0.7.0 → 1.1.0

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

@@ -0,0 +1,40 @@
+import { Radius } from '../../shared';
+/**
+ * Theme configuration options for the Skeleton component.
+ *
+ * Set under `components.skeleton` in the AsheeUI config. Values feed the
+ * component-level fallback tier of the theme cascade.
+ */
+export interface SkeletonConfig {
+    /**
+     * Corner rounding.
+     * Controls the border-radius of the placeholder.
+     *
+     * @default "sm"
+     */
+    radius?: Radius;
+    /**
+     * Whether the placeholder shimmers while it is visible.
+     * When true the animation is applied through a reduced-motion-safe class, so
+     * a consumer who asked for less motion sees a static placeholder.
+     *
+     * @default true
+     */
+    isAnimated?: boolean;
+}
+/**
+ * Default config values registered for the Skeleton component.
+ */
+export declare const defaultSkeletonConfig: SkeletonConfig;
+/**
+ * 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_SKELETON_CONFIG: Required<SkeletonConfig>;
+declare module "../../libs/registry" {
+    interface ComponentTypeConfigRegistry {
+        skeleton: SkeletonConfig;
+    }
+}
+//# sourceMappingURL=skeleton-config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skeleton-config.d.ts","sourceRoot":"","sources":["../../../src/components/skeleton/skeleton-config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,cAGnC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAAC,cAAc,CAGpD,CAAC;AAEX,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,QAAQ,EAAE,cAAc,CAAC;KAC1B;CACF"}

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

@@ -0,0 +1,13 @@
+"use client";
+import { registerComponentDefaults as e } from "../../libs/registry.js";
+//#region src/components/skeleton/skeleton-config.ts
+var t = {
+	radius: "sm",
+	isAnimated: !0
+}, n = {
+	radius: "sm",
+	isAnimated: !0
+};
+e("skeleton", t);
+//#endregion
+export { n as FALLBACK_SKELETON_CONFIG, t as defaultSkeletonConfig };

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

@@ -0,0 +1,19 @@
+/**
+ * Skeleton component styles for AsheeUI.
+ * This file provides the static classes the Skeleton component is built from.
+ */
+/**
+ * Base classes for the placeholder surface.
+ * The surface colour resolves through the theme's secondary token, so the
+ * placeholder follows the active theme.
+ */
+export declare const SKELETON_BASE_CLASS = "block h-4 w-full bg-secondary/60 select-none pointer-events-none";
+/**
+ * The shimmer.
+ *
+ * It is applied through the `motion-safe` variant rather than from a script, so
+ * a consumer who asked for reduced motion sees a static placeholder and the
+ * media query decides before hydration.
+ */
+export declare const SKELETON_ANIMATION_CLASS = "motion-safe:animate-pulse";
+//# sourceMappingURL=skeleton-styles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skeleton-styles.d.ts","sourceRoot":"","sources":["../../../src/components/skeleton/skeleton-styles.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,qEACoC,CAAC;AAErE;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,8BAA8B,CAAC"}

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

@@ -0,0 +1,5 @@
+"use client";
+//#region src/components/skeleton/skeleton-styles.ts
+var e = "block h-4 w-full bg-secondary/60 select-none pointer-events-none", t = "motion-safe:animate-pulse";
+//#endregion
+export { t as SKELETON_ANIMATION_CLASS, e as SKELETON_BASE_CLASS };

package/dist/components/stack/Stack.d.ts

@@ -0,0 +1,107 @@
+import { ElementType, HTMLAttributes } from 'react';
+import { Space } from '../../shared';
+import { StackConfig } from './stack-config';
+type BaseStackProps = StackConfig & Omit<HTMLAttributes<HTMLDivElement>, "color">;
+/**
+ * Props for the Stack component.
+ */
+export interface StackProps extends BaseStackProps {
+    /**
+     * Element to render.
+     * Defaults to a `div`. A stack that is a list should render `ul` or `ol`
+     * and receive `li` children.
+     *
+     * @default "div"
+     */
+    as?: ElementType;
+    /**
+     * Space between children, from the shared spacing scale.
+     * Resolved through the standard cascade: prop, then `components.stack.gap`,
+     * then the framework fallback.
+     *
+     * @default "md"
+     */
+    gap?: Space;
+}
+/**
+ * A one-axis layout with a token gap.
+ *
+ * Stack resolves its own appearance through the standard configuration
+ * cascade, so an application can restate the framework's default rhythm (or its
+ * direction and alignment) once, in configuration, instead of repeating classes
+ * on every usage.
+ *
+ * @param props - Stack configuration options and element attributes.
+ * @param props.direction - Flex direction. Defaults to "column".
+ * @param props.gap - Space between children. Defaults to "md".
+ * @param props.align - Cross-axis alignment. Defaults to "stretch".
+ * @param props.justify - Main-axis distribution. Defaults to "start".
+ * @param props.wrap - Wrap children onto another line. Defaults to false.
+ * @param props.as - Element to render. Defaults to "div".
+ * @returns The rendered stack.
+ *
+ * @example
+ * ```tsx
+ * <Stack gap="lg">
+ *   <Typography role="heading-lg">Recent activity</Typography>
+ *   <Stack direction="row" gap="sm" align="center">
+ *     <Badge color="success">Paid</Badge>
+ *     <Typography role="body-sm" tone="muted">Invoice 1042</Typography>
+ *   </Stack>
+ * </Stack>
+ * ```
+ *
+ * @see HStack - A row stack with centred items.
+ * @see VStack - A column stack with stretched items.
+ * @see Grid - The two-dimensional equivalent.
+ */
+export declare const Stack: import('react').ForwardRefExoticComponent<StackProps & import('react').RefAttributes<HTMLDivElement>>;
+/**
+ * Props for the {@link HStack} preset.
+ * The shared stack options stay available, so a preset is a starting point
+ * rather than a restriction.
+ */
+export type HStackProps = Omit<StackProps, "direction">;
+/**
+ * A row stack with centred items.
+ *
+ * `HStack` is `Stack` with `direction="row"` and `align="center"`, which is the
+ * arrangement most toolbars, media rows and action groups want. It shares the
+ * Stack component's configuration, so `components.stack` restyles both.
+ *
+ * @param props - The same options as {@link StackProps}, without `direction`.
+ * @returns The rendered stack.
+ *
+ * @example
+ * ```tsx
+ * <HStack gap="sm">
+ *   <Button size="sm">Save</Button>
+ *   <Button size="sm" variant="ghost">Cancel</Button>
+ * </HStack>
+ * ```
+ */
+export declare const HStack: import('react').ForwardRefExoticComponent<HStackProps & import('react').RefAttributes<HTMLDivElement>>;
+/**
+ * Props for the {@link VStack} preset.
+ */
+export type VStackProps = Omit<StackProps, "direction">;
+/**
+ * A column stack with stretched items.
+ *
+ * `VStack` is `Stack` with `direction="column"` and `align="stretch"`, the
+ * arrangement a form, a card body or a settings panel wants.
+ *
+ * @param props - The same options as {@link StackProps}, without `direction`.
+ * @returns The rendered stack.
+ *
+ * @example
+ * ```tsx
+ * <VStack gap="sm">
+ *   <Input label="Full name" />
+ *   <Input label="Email" />
+ * </VStack>
+ * ```
+ */
+export declare const VStack: import('react').ForwardRefExoticComponent<VStackProps & import('react').RefAttributes<HTMLDivElement>>;
+export {};
+//# sourceMappingURL=Stack.d.ts.map

package/dist/components/stack/Stack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Stack.d.ts","sourceRoot":"","sources":["../../../src/components/stack/Stack.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,KAAK,WAAW,EAAc,KAAK,cAAc,EAAE,MAAM,OAAO,CAAC;AAE1E,OAAO,EAAmB,KAAK,KAAK,EAAE,MAAM,cAAc,CAAC;AAG3D,OAAO,EAGL,KAAK,WAAW,EAGjB,MAAM,gBAAgB,CAAC;AAQxB,KAAK,cAAc,GAAG,WAAW,GAC/B,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,cAAc;IAChD;;;;;;OAMG;IACH,EAAE,CAAC,EAAE,WAAW,CAAC;IAEjB;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,KAAK,CAAC;CACb;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,KAAK,uGA0DjB,CAAC;AAIF;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;AAExD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,MAAM,wGAIlB,CAAC;AAIF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;AAExD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,MAAM,wGAIlB,CAAC"}

package/dist/components/stack/Stack.js

@@ -0,0 +1,36 @@
+"use client";
+"use client";
+import { cn as e } from "../../utils/cn.js";
+import { SPACE_GAP_CLASS as t } from "../../shared/spacing.js";
+import { useAsheeConfig as n } from "../../libs/context.js";
+import { resolveCascade as r } from "../../utils/resolve-token.js";
+import { FALLBACK_STACK_CONFIG as i } from "./stack-config.js";
+import { STACK_ALIGN_CLASS as a, STACK_BASE_CLASS as o, STACK_DIRECTION_CLASS as s, STACK_JUSTIFY_CLASS as c } from "./stack-styles.js";
+import { forwardRef as l } from "react";
+import { jsx as u } from "react/jsx-runtime";
+//#region src/components/stack/Stack.tsx
+var d = l(({ as: l, direction: d, gap: f, align: p, justify: m, wrap: h, className: g, ..._ }, v) => {
+	let y = n().components?.stack, b = r(d, y?.direction, void 0, i.direction), x = r(f, y?.gap, void 0, i.gap), S = r(p, y?.align, void 0, i.align), C = r(m, y?.justify, void 0, i.justify), w = r(h, y?.wrap, void 0, i.wrap);
+	return /* @__PURE__ */ u(l ?? "div", {
+		ref: v,
+		className: e(o, s[b], a[S], c[C], t[x], w ? "flex-wrap" : "flex-nowrap", g),
+		..._
+	});
+});
+d.displayName = "Stack";
+var f = l(({ align: e, ...t }, n) => /* @__PURE__ */ u(d, {
+	ref: n,
+	direction: "row",
+	align: e ?? "center",
+	...t
+}));
+f.displayName = "HStack";
+var p = l(({ align: e, ...t }, n) => /* @__PURE__ */ u(d, {
+	ref: n,
+	direction: "column",
+	align: e ?? "stretch",
+	...t
+}));
+p.displayName = "VStack";
+//#endregion
+export { f as HStack, d as Stack, p as VStack };

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/stack/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC"}

package/dist/components/stack/index.js

@@ -0,0 +1,3 @@
+export * from "./Stack.js";
+export * from "./stack-config.js";
+export * from "./stack-styles.js";

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

@@ -0,0 +1,68 @@
+import { Space } from '../../shared';
+/**
+ * Flex direction of a stack.
+ * `row` lays children out horizontally, `column` vertically.
+ */
+export type StackDirection = "row" | "column";
+/**
+ * Cross-axis alignment of a stack's children.
+ * `stretch` makes them fill the cross axis, `baseline` aligns their first
+ * line of text.
+ */
+export type StackAlign = "start" | "center" | "end" | "stretch" | "baseline";
+/**
+ * Main-axis distribution of a stack's children.
+ */
+export type StackJustify = "start" | "center" | "end" | "between" | "around" | "evenly";
+/**
+ * Theme configuration options for the Stack component.
+ *
+ * Set under `components.stack` in the AsheeUI config. Values feed the
+ * component-level fallback tier of the theme cascade.
+ */
+export interface StackConfig {
+    /**
+     * Flex direction.
+     *
+     * @default "column"
+     */
+    direction?: StackDirection;
+    /**
+     * Space between children.
+     *
+     * @default "md"
+     */
+    gap?: Space;
+    /**
+     * Cross-axis alignment of the children.
+     *
+     * @default "stretch"
+     */
+    align?: StackAlign;
+    /**
+     * Main-axis distribution of the children.
+     *
+     * @default "start"
+     */
+    justify?: StackJustify;
+    /**
+     * Whether children wrap onto another line when they run out of room.
+     *
+     * @default false
+     */
+    wrap?: boolean;
+}
+/**
+ * Default config values registered for the Stack component.
+ */
+export declare const defaultStackConfig: StackConfig;
+declare module "../../libs/registry" {
+    interface ComponentTypeConfigRegistry {
+        stack: StackConfig;
+    }
+}
+/**
+ * Hard fallback values used when no config tier provides a value.
+ */
+export declare const FALLBACK_STACK_CONFIG: Required<StackConfig>;
+//# sourceMappingURL=stack-config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stack-config.d.ts","sourceRoot":"","sources":["../../../src/components/stack/stack-config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAE1C;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE9C;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,GAAG,UAAU,CAAC;AAE7E;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,OAAO,GACP,QAAQ,GACR,KAAK,GACL,SAAS,GACT,QAAQ,GACR,QAAQ,CAAC;AAEb;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,SAAS,CAAC,EAAE,cAAc,CAAC;IAE3B;;;;OAIG;IACH,GAAG,CAAC,EAAE,KAAK,CAAC;IAEZ;;;;OAIG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;IAEnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC;IAEvB;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,WAMhC,CAAC;AAEF,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,KAAK,EAAE,WAAW,CAAC;KACpB;CACF;AAID;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,WAAW,CAMvD,CAAC"}

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

@@ -0,0 +1,20 @@
+"use client";
+import { registerComponentDefaults as e } from "../../libs/registry.js";
+//#region src/components/stack/stack-config.ts
+var t = {
+	direction: "column",
+	gap: "md",
+	align: "stretch",
+	justify: "start",
+	wrap: !1
+};
+e("stack", t);
+var n = {
+	direction: "column",
+	gap: "md",
+	align: "stretch",
+	justify: "start",
+	wrap: !1
+};
+//#endregion
+export { n as FALLBACK_STACK_CONFIG, t as defaultStackConfig };

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

@@ -0,0 +1,10 @@
+import { StackAlign, StackDirection, StackJustify } from './stack-config';
+/** Flex direction classes. */
+export declare const STACK_DIRECTION_CLASS: Record<StackDirection, string>;
+/** Cross-axis alignment classes. */
+export declare const STACK_ALIGN_CLASS: Record<StackAlign, string>;
+/** Main-axis distribution classes. */
+export declare const STACK_JUSTIFY_CLASS: Record<StackJustify, string>;
+/** Shared base classes for every stack. */
+export declare const STACK_BASE_CLASS = "flex min-w-0";
+//# sourceMappingURL=stack-styles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stack-styles.d.ts","sourceRoot":"","sources":["../../../src/components/stack/stack-styles.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE/E,8BAA8B;AAC9B,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAGhE,CAAC;AAEF,oCAAoC;AACpC,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAMxD,CAAC;AAEF,sCAAsC;AACtC,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAO5D,CAAC;AAEF,2CAA2C;AAC3C,eAAO,MAAM,gBAAgB,iBAAiB,CAAC"}

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

@@ -0,0 +1,21 @@
+"use client";
+//#region src/components/stack/stack-styles.ts
+var e = {
+	row: "flex-row",
+	column: "flex-col"
+}, t = {
+	start: "items-start",
+	center: "items-center",
+	end: "items-end",
+	stretch: "items-stretch",
+	baseline: "items-baseline"
+}, n = {
+	start: "justify-start",
+	center: "justify-center",
+	end: "justify-end",
+	between: "justify-between",
+	around: "justify-around",
+	evenly: "justify-evenly"
+}, r = "flex min-w-0";
+//#endregion
+export { t as STACK_ALIGN_CLASS, r as STACK_BASE_CLASS, e as STACK_DIRECTION_CLASS, n as STACK_JUSTIFY_CLASS };

package/dist/components/switch/Switch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Switch.d.ts","sourceRoot":"","sources":["../../../src/components/switch/Switch.tsx"],"names":[],"mappings":"AAUA,OAAO,EACL,KAAK,WAAW,EAEhB,KAAK,mBAAmB,EAIzB,MAAM,OAAO,CAAC;AAWf,OAAO,EAA0B,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAS5E,KAAK,eAAe,GAAG,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,GACjD,IAAI,CACF,mBAAmB,CAAC,gBAAgB,CAAC,EACrC,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,CAC3C,CAAC;AAEJ;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,eAAe;IAClD;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;CAC7E;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,eAAO,MAAM,MAAM,0GAqKlB,CAAC"}
+{"version":3,"file":"Switch.d.ts","sourceRoot":"","sources":["../../../src/components/switch/Switch.tsx"],"names":[],"mappings":"AAUA,OAAO,EACL,KAAK,WAAW,EAEhB,KAAK,mBAAmB,EAIzB,MAAM,OAAO,CAAC;AAWf,OAAO,EAA0B,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAS5E,KAAK,eAAe,GAAG,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,GACjD,IAAI,CACF,mBAAmB,CAAC,gBAAgB,CAAC,EACrC,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,CAC3C,CAAC;AAEJ;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,eAAe;IAClD;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;CAC7E;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,eAAO,MAAM,MAAM,0GA4KlB,CAAC"}

package/dist/components/switch/Switch.js

@@ -1,9 +1,9 @@
 "use client";
 "use client";
 import { cn as e } from "../../utils/cn.js";
-import { useAsheeConfig as t } from "../../libs/context.js";
-import { RADIUS_CLASS as n } from "../../shared/radius.js";
-import { resolveVariantClass as r } from "../../shared/variant.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 { FieldShell as s } from "../field/FieldShell.js";
 import { FALLBACK_SWITCH_CONFIG as c } from "./switch-config.js";
@@ -12,7 +12,7 @@ import { forwardRef as f, useCallback as p, useId as m, useState as h } from "re
 import { jsx as g, jsxs as _ } from "react/jsx-runtime";
 //#region src/components/switch/Switch.tsx
 var v = f(({ size: f, color: v, radius: y, label: b, labelAlign: x, description: S, required: C, isLoading: w, id: T, className: E, style: D, disabled: O, checked: k, defaultChecked: A = !1, onChange: j, ...M }, N) => {
-	let P = t(), F = P.components?.switch, I = m(), L = T ?? I, [R, z] = h(A), B = k ?? R, V = i(f, F?.size, void 0, c.size), H = i(v, F?.color, P.defaultColor, c.color), U = o(y, F?.radius, void 0, c.radius), W = i(x, F?.labelAlign, void 0, c.labelAlign), G = a(V, d, c.size), K = a(V, l, c.size), q = a(V, u, c.size), J = a(U, n, c.radius), Y = r("solid", H), X = O || w, Z = p((e) => {
+	let P = r(), F = P.components?.switch, I = m(), L = T ?? I, [R, z] = h(A), B = k ?? R, V = i(f, F?.size, void 0, c.size), H = i(v, F?.color, P.defaultColor, c.color), U = o(y, F?.radius, void 0, c.radius), W = i(x, F?.labelAlign, void 0, c.labelAlign), G = a(V, d, c.size), K = a(V, l, c.size), q = a(V, u, c.size), J = a(U, t, c.radius), Y = n("solid", H), X = O || w, Z = S ? `${L}-description` : void 0, Q = p((e) => {
 		if (X) return;
 		let t = e.target.checked;
 		k === void 0 && z(t), j?.(t, e);
@@ -26,6 +26,7 @@ var v = f(({ size: f, color: v, radius: y, label: b, labelAlign: x, description:
 		label: b,
 		labelAlign: W,
 		description: S,
+		descriptionId: Z,
 		required: C,
 		isLoading: w,
 		children: /* @__PURE__ */ g("label", {
@@ -44,7 +45,8 @@ var v = f(({ size: f, color: v, radius: y, label: b, labelAlign: x, description:
 						required: C,
 						"aria-checked": B,
 						"aria-busy": w,
-						onChange: Z,
+						"aria-describedby": Z,
+						onChange: Q,
 						className: "sr-only peer",
 						...M
 					}),

package/dist/components/table/Table.js

@@ -1,8 +1,8 @@
 "use client";
 "use client";
 import { cn as e } from "../../utils/cn.js";
-import { useAsheeConfig as t } from "../../libs/context.js";
-import { RADIUS_CLASS as n } from "../../shared/radius.js";
+import { RADIUS_CLASS as t } from "../../shared/radius.js";
+import { useAsheeConfig as n } from "../../libs/context.js";
 import { resolveCascade as r, resolveClassKey as i, resolveRadiusKey as a } from "../../utils/resolve-token.js";
 import { FALLBACK_TABLE_CONFIG as o } from "./table-config.js";
 import { TABLE_CELL_PADDING_X_CLASS as s, TABLE_CELL_PADDING_Y_CLASS as c, TABLE_COLOR_STYLES as l, TABLE_FONT_CLASS as u, TABLE_HEADER_FONT_CLASS as d } from "./table-styles.js";
@@ -10,7 +10,7 @@ import { useCallback as f } from "react";
 import { jsx as p, jsxs as m } from "react/jsx-runtime";
 //#region src/components/table/Table.tsx
 function h({ data: h = [], columns: g = [], gridClasses: _, rowKeyAccessor: v, handleClick: y, handleDoubleClick: b, selectedRowKey: x, emptyMessage: S = "No items available", isClickable: C, variant: w, color: T, size: E, radius: D, headerClassName: O, rowClassName: k, cellClassName: A, className: j, style: M, ...N }) {
-	let P = t(), F = P.components?.table, I = r(E, F?.size, void 0, o.size), L = r(w, F?.variant, void 0, o.variant), R = r(T, F?.color, P.defaultColor, o.color), z = (e) => e === "full" ? "xl" : e, B = a(z(D), z(F?.radius), P.defaultRadius, o.radius), V = i(I, c, o.size), H = i(I, s, o.size), U = i(I, u, o.size), W = i(I, d, o.size), G = i(B, n, o.radius), K = l[R] ?? l.primary, q = f((e, t) => {
+	let P = n(), F = P.components?.table, I = r(E, F?.size, void 0, o.size), L = r(w, F?.variant, void 0, o.variant), R = r(T, F?.color, P.defaultColor, o.color), z = (e) => e === "full" ? "xl" : e, B = a(z(D), z(F?.radius), P.defaultRadius, o.radius), V = i(I, c, o.size), H = i(I, s, o.size), U = i(I, u, o.size), W = i(I, d, o.size), G = i(B, t, o.radius), K = l[R] ?? l.primary, q = f((e, t) => {
 		if (v) try {
 			return v(e);
 		} catch {

package/dist/components/tabs/Tabs.js

@@ -1,8 +1,8 @@
 "use client";
 "use client";
 import { cn as e } from "../../utils/cn.js";
-import { useAsheeConfig as t } from "../../libs/context.js";
-import { RADIUS_CLASS as n } from "../../shared/radius.js";
+import { RADIUS_CLASS as t } from "../../shared/radius.js";
+import { useAsheeConfig as n } from "../../libs/context.js";
 import { resolveCascade as r, resolveClassKey as i, resolveRadiusKey as a } from "../../utils/resolve-token.js";
 import { Button as o } from "../button/Button.js";
 import { FALLBACK_TABS_CONFIG as s } from "./tabs-config.js";
@@ -11,7 +11,7 @@ import { forwardRef as d, useCallback as f, useId as p, useMemo as m, useRef as
 import { jsx as _, jsxs as v } from "react/jsx-runtime";
 //#region src/components/tabs/Tabs.tsx
 var y = d(({ tabs: d = [], activeId: y, defaultActiveId: b, onChange: x, variant: S, size: C, radius: w, options: T, fullWidth: ee = !1, tabListClassName: te, tabPanelClassName: E, className: D, style: O, ...k }, A) => {
-	let j = t(), M = j.components?.tabs, N = p(), P = h(/* @__PURE__ */ new Map()), [F, I] = g(() => b ?? d[0]?.id), L = y !== void 0, R = L ? y : F, z = r(C, M?.size, void 0, s.size), B = r(S, M?.variant, void 0, s.variant), V = r(T?.active?.variant, M?.options?.active?.variant, j.defaultVariant, s.options.active.variant), H = r(T?.active?.color, M?.options?.active?.color, j.defaultColor, s.options.active.color), U = r(T?.inactive?.variant, M?.options?.inactive?.variant, void 0, s.options.inactive.variant), W = r(T?.inactive?.color, M?.options?.inactive?.color, void 0, s.options.inactive.color), G = a(w, M?.radius, j.defaultRadius, s.radius), K = a(T?.active?.radius, M?.options?.active?.radius, j.defaultRadius, s.options.active.radius), q = a(T?.inactive?.radius, M?.options?.inactive?.radius, G, s.options.inactive.radius), J = i(z, l, s.size), Y = i(z, u, s.size), X = i(z, c, s.size), Z = i(G, n, s.radius), Q = f((e) => {
+	let j = n(), M = j.components?.tabs, N = p(), P = h(/* @__PURE__ */ new Map()), [F, I] = g(() => b ?? d[0]?.id), L = y !== void 0, R = L ? y : F, z = r(C, M?.size, void 0, s.size), B = r(S, M?.variant, void 0, s.variant), V = r(T?.active?.variant, M?.options?.active?.variant, j.defaultVariant, s.options.active.variant), H = r(T?.active?.color, M?.options?.active?.color, j.defaultColor, s.options.active.color), U = r(T?.inactive?.variant, M?.options?.inactive?.variant, void 0, s.options.inactive.variant), W = r(T?.inactive?.color, M?.options?.inactive?.color, void 0, s.options.inactive.color), G = a(w, M?.radius, j.defaultRadius, s.radius), K = a(T?.active?.radius, M?.options?.active?.radius, j.defaultRadius, s.options.active.radius), q = a(T?.inactive?.radius, M?.options?.inactive?.radius, G, s.options.inactive.radius), J = i(z, l, s.size), Y = i(z, u, s.size), X = i(z, c, s.size), Z = i(G, t, s.radius), Q = f((e) => {
 		L || I(e), x?.(e);
 	}, [L, x]), ne = (e, t) => {
 		if (d.filter((e) => !e.disabled).length === 0) return;

package/dist/components/testimonials/Testimonials.d.ts

@@ -0,0 +1,78 @@
+import { ElementType, HTMLAttributes, ReactNode } from 'react';
+import { TestimonialsConfig } from './testimonials-config';
+/**
+ * One attributed quote.
+ */
+export interface TestimonialItem {
+    /** Stable identifier for the quote. Defaults to its position in the list. */
+    id?: string | number;
+    /** What the person said. */
+    quote: ReactNode;
+    /** Name of the person. */
+    name: string;
+    /** Role or organisation of the person. */
+    role?: string;
+    /** Picture of the person, passed to the framework's `Avatar`. */
+    avatarSrc?: string;
+    /** Component that replaces the avatar picture, such as a framework image. */
+    avatarComponent?: ElementType;
+    /** Additional props for that component. */
+    avatarComponentProps?: Record<string, unknown>;
+}
+type BaseTestimonialsProps = TestimonialsConfig & Omit<HTMLAttributes<HTMLElement>, "color" | "title">;
+/**
+ * Props for the Testimonials component.
+ */
+export interface TestimonialsProps extends BaseTestimonialsProps {
+    /** Short label above the heading. */
+    eyebrow?: ReactNode;
+    /** Heading of the band. */
+    title?: ReactNode;
+    /** Supporting sentence under the heading. */
+    description?: ReactNode;
+    /** The quotes to show. */
+    items: TestimonialItem[];
+    /**
+     * Element to render the band as.
+     * Defaults to `section`.
+     *
+     * @default "section"
+     */
+    as?: ElementType;
+    /** Content below the quotes. */
+    children?: ReactNode;
+}
+/**
+ * A band of attributed customer quotes.
+ *
+ * Testimonials renders each quote as a `figure` with its attribution in a
+ * `figcaption`, inside a list element, so a screen reader announces the set. The
+ * picture goes through `Avatar`, so its substitution API and its initials
+ * fallback apply without the consumer doing anything.
+ *
+ * @param props - Testimonials configuration options and element attributes.
+ * @param props.items - The quotes to show.
+ * @param props.title - Heading of the band.
+ * @param props.eyebrow - Short label above the heading.
+ * @param props.description - Supporting sentence under the heading.
+ * @param props.columns - Columns from the smallest viewport. Defaults to 1.
+ * @param props.columnsMd - Columns from `md` upwards. Defaults to 2.
+ * @param props.columnsLg - Columns from `lg` upwards. Defaults to 3.
+ * @param props.gap - Space between quotes. Defaults to "lg".
+ * @param props.align - Heading alignment. Defaults to "center".
+ *
+ * @returns The rendered band.
+ *
+ * @example
+ * ```tsx
+ * <Testimonials
+ *   title="Teams send more with Ashee"
+ *   items={[{ quote: "Twice as fast.", name: "Ama Boateng", role: "Growth" }]}
+ * />
+ * ```
+ *
+ * @see Card - The surface each quote renders in.
+ */
+export declare const Testimonials: import('react').ForwardRefExoticComponent<TestimonialsProps & import('react').RefAttributes<HTMLElement>>;
+export {};
+//# sourceMappingURL=Testimonials.d.ts.map

package/dist/components/testimonials/Testimonials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Testimonials.d.ts","sourceRoot":"","sources":["../../../src/components/testimonials/Testimonials.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EACL,KAAK,WAAW,EAEhB,KAAK,cAAc,EACnB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAUf,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,uBAAuB,CAAC;AAO/B;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,6EAA6E;IAC7E,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAErB,4BAA4B;IAC5B,KAAK,EAAE,SAAS,CAAC;IAEjB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IAEb,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,6EAA6E;IAC7E,eAAe,CAAC,EAAE,WAAW,CAAC;IAE9B,2CAA2C;IAC3C,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChD;AAED,KAAK,qBAAqB,GAAG,kBAAkB,GAC7C,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,qBAAqB;IAC9D,qCAAqC;IACrC,OAAO,CAAC,EAAE,SAAS,CAAC;IAEpB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,SAAS,CAAC;IAElB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,SAAS,CAAC;IAExB,0BAA0B;IAC1B,KAAK,EAAE,eAAe,EAAE,CAAC;IAEzB;;;;;OAKG;IACH,EAAE,CAAC,EAAE,WAAW,CAAC;IAEjB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,YAAY,2GA6GxB,CAAC"}