asheeui 0.7.0 → 1.1.0

package/dist/components/radio/RadioGroup.js

@@ -2,57 +2,51 @@
 "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 { resolveCascade as r, resolveClassKey as i, resolveRadiusKey as a } from "../../utils/resolve-token.js";
-import { FALLBACK_RADIO_CONFIG as o } from "./radio-config.js";
-import { useRadioGroupContext as ee } from "./radio-context.js";
-import { RADIO_COLOR_CLASS as s, RADIO_FONT_SIZE_CLASS as c, RADIO_GAP_CLASS as te, RADIO_INNER_SIZE_CLASS as l, RADIO_OUTER_SIZE_CLASS as ne, RADIO_STATUS_BORDER_CLASS as u } from "./radio-styles.js";
-import { forwardRef as d, useCallback as f, useId as p, useState as m } from "react";
-import { jsx as h, jsxs as g } from "react/jsx-runtime";
+import { resolveCascade as n } from "../../utils/resolve-token.js";
+import { FieldShell as r } from "../field/FieldShell.js";
+import { FALLBACK_RADIO_CONFIG as i } from "./radio-config.js";
+import { RadioContext as a } from "./radio-context.js";
+import { forwardRef as o, useCallback as s, useId as c, useState as l } from "react";
+import { jsx as u } from "react/jsx-runtime";
 //#region src/components/radio/RadioGroup.tsx
-var _ = d(({ value: d, size: _, color: v, radius: y, variant: b, status: x, label: S, description: C, id: re, name: w, className: T, style: E, disabled: D, checked: O, defaultChecked: k = !1, onChange: A, ...j }, M) => {
-	let N = t(), P = ee(), F = N.components?.radio, I = p(), L = re ?? I, R = w ?? P?.name, z = D ?? P?.disabled ?? !1, [B, V] = m(k), H = P ? P.value === d : O ?? B, U = r(_ ?? P?.size, F?.size, void 0, o.size), W = r(b ?? P?.variant, F?.variant, void 0, o.variant), G = r(v ?? P?.color, F?.color, N.defaultColor, o.color), K = x ?? P?.status ?? o.status, q = W === "card", J = a(y, F?.radius, void 0, o.radius), Y = q && J === "full" ? "xl" : J, X = i(U, ne, o.size), ie = i(U, l, o.size), ae = i(U, c, o.size), oe = i(U, te, o.size), Z = i(J, n, o.radius), se = i(Y, n, "xl"), Q = s[G] ?? s.primary, $ = u[K] ?? u.default, ce = f((e) => {
-		z || (P ? P.onChange?.(d) : O === void 0 && V(!0), A?.(e.target.checked, d, e));
-	}, [
-		O,
-		P,
-		z,
-		A,
-		d
-	]);
-	return /* @__PURE__ */ g("label", {
-		className: e("relative inline-flex items-start select-none cursor-pointer transition-all duration-150 shrink-0", oe, q ? e("p-3 border bg-background", se) : "", q && (H ? `${Q.border} ${Q.cardBg}` : $), z && "opacity-50 pointer-events-none cursor-not-allowed", T),
-		style: E,
-		children: [
-			/* @__PURE__ */ h("input", {
-				ref: M,
-				id: L,
-				type: "radio",
-				name: R,
-				value: d,
-				checked: H,
-				disabled: z,
-				onChange: ce,
-				className: "sr-only peer",
-				...j
-			}),
-			/* @__PURE__ */ h("div", {
-				className: e("shrink-0 flex items-center justify-center border-2 transition-all duration-150 mt-0.5", "peer-focus-visible:ring-2 peer-focus-visible:ring-primary peer-focus-visible:ring-offset-2", X, Z, H ? Q.border : $),
-				children: /* @__PURE__ */ h("span", { className: e(ie, Z, Q.bg, "transition-all duration-200 ease-in-out transform-gpu", H ? "scale-100 opacity-100" : "scale-0 opacity-0") })
-			}),
-			(S || C) && /* @__PURE__ */ g("div", {
-				className: "flex flex-col min-w-0",
-				children: [S && /* @__PURE__ */ h("span", {
-					className: e("font-medium text-foreground leading-snug", ae),
-					children: S
-				}), C && /* @__PURE__ */ h("span", {
-					className: "text-xs sm:text-sm text-foreground/70 leading-snug mt-0.5",
-					children: C
-				})]
+var d = o(({ children: o, name: d, value: f, defaultValue: p, onChange: m, size: h, color: g, variant: _, orientation: v = "vertical", status: y, label: b, labelAlign: x, description: S, message: C, required: w, disabled: T, className: E }, D) => {
+	let O = t().components?.radio, k = c(), A = d ?? k, [j, M] = l(p), N = f !== void 0, P = N ? f : j, F = s((e) => {
+		N || M(e), m?.(e);
+	}, [N, m]), I = b ? `${k}-label` : void 0, L = S ? `${k}-description` : void 0, R = C ? `${k}-message` : void 0, z = [L, R].filter(Boolean).join(" ") || void 0, B = y ?? i.status, V = n(x, O?.labelAlign, void 0, i.labelAlign);
+	return /* @__PURE__ */ u(r, {
+		id: k,
+		htmlFor: null,
+		labelId: I,
+		label: b,
+		labelAlign: V,
+		description: S,
+		descriptionId: L,
+		message: C,
+		messageId: R,
+		status: B,
+		required: w,
+		children: /* @__PURE__ */ u(a.Provider, {
+			value: {
+				name: A,
+				value: P,
+				onChange: F,
+				size: h,
+				color: g,
+				variant: _,
+				disabled: T,
+				status: B
+			},
+			children: /* @__PURE__ */ u("div", {
+				ref: D,
+				role: "radiogroup",
+				"aria-labelledby": I,
+				"aria-describedby": z,
+				className: e("flex", v === "vertical" ? "flex-col gap-2" : "flex-row flex-wrap gap-4", E),
+				children: o
 			})
-		]
+		})
 	});
 });
-_.displayName = "Radio";
+d.displayName = "RadioGroup";
 //#endregion
-export { _ as Radio };
+export { d as RadioGroup };

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

@@ -1,5 +1,4 @@
 export * from './Radio';
 export * from './RadioGroup';
 export * from './radio-config';
-export * from './radio-context';
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/components/resizable-screen/ResizableScreen.d.ts

@@ -83,8 +83,8 @@ export interface ResizableScreenProps extends BaseResizableScreenProps {
  *       maxSize={70}
  *       orientation="horizontal"
  *     >
- *       <div className="bg-blue-100 p-4">Left Panel</div>
- *       <div className="bg-green-100 p-4">Right Panel</div>
+ *       <div className="bg-primary/10 p-4">Left Panel</div>
+ *       <div className="bg-success/10 p-4">Right Panel</div>
  *     </ResizableScreen>
  *   );
  * }
@@ -102,8 +102,8 @@ export interface ResizableScreenProps extends BaseResizableScreenProps {
  *   minSize={25}
  *   maxSize={75}
  * >
- *   <div className="bg-red-100 p-4">Top Panel</div>
- *   <div className="bg-blue-100 p-4">Bottom Panel</div>
+ *   <div className="bg-danger/10 p-4">Top Panel</div>
+ *   <div className="bg-primary/10 p-4">Bottom Panel</div>
  * </ResizableScreen>
  * ```
  *

package/dist/components/scrollbar/index.js

@@ -0,0 +1 @@
+export * from "./scrollbar-config.js";

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

@@ -0,0 +1,13 @@
+"use client";
+import { registerComponentDefaults as e } from "../../libs/registry.js";
+//#region src/components/scrollbar/scrollbar-config.ts
+var t = {
+	width: "10px",
+	radius: "9999px",
+	thumbBorder: "3px",
+	gutter: "stable",
+	fallbackWidth: "thin"
+};
+e("scrollbar", t);
+//#endregion
+export { t as defaultScrollbarConfig };

package/dist/components/section/Section.d.ts

@@ -0,0 +1,56 @@
+import { ElementType, HTMLAttributes } from 'react';
+import { Space } from '../../shared';
+import { SectionConfig } from './section-config';
+type BaseSectionProps = SectionConfig & Omit<HTMLAttributes<HTMLElement>, "color">;
+/**
+ * Props for the Section component.
+ */
+export interface SectionProps extends BaseSectionProps {
+    /**
+     * Element to render.
+     * Defaults to `section`, which is the correct landmark when the section
+     * carries a heading. A section used purely for spacing should render a `div`
+     * through this prop, so the page does not gain an unnamed region.
+     *
+     * @default "section"
+     */
+    as?: ElementType;
+    /**
+     * Vertical padding, from the shared spacing scale.
+     * Resolved through the standard cascade: prop, then
+     * `components.section.spacing`, then the framework fallback.
+     *
+     * @default "lg"
+     */
+    spacing?: Space;
+}
+/**
+ * A full-width band with vertical rhythm.
+ *
+ * Section owns the vertical space between parts of a page and the background
+ * behind them. It does not own the maximum width unless asked to, so it composes
+ * either way round: a Section can contain a Container, or a Page can place a
+ * Container around several Sections.
+ *
+ * @param props - Section configuration options and element attributes.
+ * @param props.spacing - Vertical padding. Defaults to "lg".
+ * @param props.background - Background treatment. Defaults to "none".
+ * @param props.contained - Wrap the children in a Container. Defaults to false.
+ * @param props.containerSize - Container width when contained. Defaults to "lg".
+ * @param props.divider - Draw a separator above the section. Defaults to false.
+ * @param props.as - Element to render. Defaults to "section".
+ * @returns The rendered section.
+ *
+ * @example
+ * ```tsx
+ * <Section spacing="xl" background="muted" contained>
+ *   <Typography role="heading-xl">Everything your team needs</Typography>
+ * </Section>
+ * ```
+ *
+ * @see Container - Maximum width and gutter.
+ * @see PageContent - The application-page equivalent.
+ */
+export declare const Section: import('react').ForwardRefExoticComponent<SectionProps & import('react').RefAttributes<HTMLElement>>;
+export {};
+//# sourceMappingURL=Section.d.ts.map

package/dist/components/section/Section.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Section.d.ts","sourceRoot":"","sources":["../../../src/components/section/Section.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,KAAK,WAAW,EAAc,KAAK,cAAc,EAAE,MAAM,OAAO,CAAC;AAE1E,OAAO,EAAyB,KAAK,KAAK,EAAE,MAAM,cAAc,CAAC;AAKjE,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,kBAAkB,CAAC;AAO1B,KAAK,gBAAgB,GAAG,aAAa,GACnC,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACpD;;;;;;;OAOG;IACH,EAAE,CAAC,EAAE,WAAW,CAAC;IAEjB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,OAAO,sGA0EnB,CAAC"}

package/dist/components/section/Section.js

@@ -0,0 +1,27 @@
+"use client";
+"use client";
+import { cn as e } from "../../utils/cn.js";
+import { SPACE_PADDING_Y_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 { Container as i } from "../container/Container.js";
+import { FALLBACK_SECTION_CONFIG as a } from "./section-config.js";
+import { SECTION_BACKGROUND_CLASS as o, SECTION_BASE_CLASS as s } from "./section-styles.js";
+import { forwardRef as c } from "react";
+import { jsx as l } from "react/jsx-runtime";
+//#region src/components/section/Section.tsx
+var u = c(({ as: c, spacing: u, background: d, contained: f, containerSize: p, divider: m, className: h, children: g, ..._ }, v) => {
+	let y = n().components?.section, b = r(u, y?.spacing, void 0, a.spacing), x = r(d, y?.background, void 0, a.background), S = r(f, y?.contained, void 0, a.contained), C = r(p, y?.containerSize, void 0, a.containerSize), w = r(m, y?.divider, void 0, a.divider);
+	return /* @__PURE__ */ l(c ?? "section", {
+		ref: v,
+		className: e(s, t[b], o[x], w && "border-t border-border", h),
+		..._,
+		children: S ? /* @__PURE__ */ l(i, {
+			size: C,
+			children: g
+		}) : g
+	});
+});
+u.displayName = "Section";
+//#endregion
+export { u as Section };

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/section/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC"}

package/dist/components/section/index.js

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

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

@@ -0,0 +1,64 @@
+import { Space } from '../../shared';
+import { ContainerSize } from '../container/container-config';
+/**
+ * Background treatment of a section.
+ *
+ * - `none`: transparent, so the page background shows through.
+ * - `muted`: a subdued band, used to separate one section from the next.
+ * - `tinted`: a faint accent band, used to emphasise a section.
+ */
+export type SectionBackground = "none" | "muted" | "tinted";
+/**
+ * Theme configuration options for the Section component.
+ *
+ * Set under `components.section` in the AsheeUI config. Values feed the
+ * component-level fallback tier of the theme cascade.
+ */
+export interface SectionConfig {
+    /**
+     * Vertical padding of the section.
+     *
+     * @default "lg"
+     */
+    spacing?: Space;
+    /**
+     * Background treatment.
+     *
+     * @default "none"
+     */
+    background?: SectionBackground;
+    /**
+     * Whether the section wraps its children in a {@link Container}.
+     * Off by default, so a section can be composed with any other layout
+     * element. On, the section owns the maximum width and the gutter.
+     *
+     * @default false
+     */
+    contained?: boolean;
+    /**
+     * Maximum content width used when the section is contained.
+     *
+     * @default "lg"
+     */
+    containerSize?: ContainerSize;
+    /**
+     * Whether to draw a separator line above the section.
+     *
+     * @default false
+     */
+    divider?: boolean;
+}
+/**
+ * Default config values registered for the Section component.
+ */
+export declare const defaultSectionConfig: SectionConfig;
+declare module "../../libs/registry" {
+    interface ComponentTypeConfigRegistry {
+        section: SectionConfig;
+    }
+}
+/**
+ * Hard fallback values used when no config tier provides a value.
+ */
+export declare const FALLBACK_SECTION_CONFIG: Required<SectionConfig>;
+//# sourceMappingURL=section-config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"section-config.d.ts","sourceRoot":"","sources":["../../../src/components/section/section-config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAEnE;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC;IAEhB;;;;OAIG;IACH,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAE/B;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;OAIG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAE9B;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,aAMlC,CAAC;AAEF,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,OAAO,EAAE,aAAa,CAAC;KACxB;CACF;AAID;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,aAAa,CAM3D,CAAC"}

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

@@ -0,0 +1,20 @@
+"use client";
+import { registerComponentDefaults as e } from "../../libs/registry.js";
+//#region src/components/section/section-config.ts
+var t = {
+	spacing: "lg",
+	background: "none",
+	contained: !1,
+	containerSize: "lg",
+	divider: !1
+};
+e("section", t);
+var n = {
+	spacing: "lg",
+	background: "none",
+	contained: !1,
+	containerSize: "lg",
+	divider: !1
+};
+//#endregion
+export { n as FALLBACK_SECTION_CONFIG, t as defaultSectionConfig };

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

@@ -0,0 +1,8 @@
+import { SectionBackground } from './section-config';
+/** Background treatment classes for each section background. */
+export declare const SECTION_BACKGROUND_CLASS: Record<SectionBackground, string>;
+/** Shared base classes for every section. */
+export declare const SECTION_BASE_CLASS = "w-full";
+/** Separator drawn above a section that asks for one. */
+export declare const SECTION_DIVIDER_CLASS = "border-t border-border";
+//# sourceMappingURL=section-styles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"section-styles.d.ts","sourceRoot":"","sources":["../../../src/components/section/section-styles.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,gEAAgE;AAChE,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAItE,CAAC;AAEF,6CAA6C;AAC7C,eAAO,MAAM,kBAAkB,WAAW,CAAC;AAE3C,yDAAyD;AACzD,eAAO,MAAM,qBAAqB,2BAA2B,CAAC"}

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

@@ -0,0 +1,9 @@
+"use client";
+//#region src/components/section/section-styles.ts
+var e = {
+	none: "",
+	muted: "bg-secondary/50",
+	tinted: "bg-primary/5"
+}, t = "w-full", n = "border-t border-border";
+//#endregion
+export { e as SECTION_BACKGROUND_CLASS, t as SECTION_BASE_CLASS, n as SECTION_DIVIDER_CLASS };

package/dist/components/section-kit/ActionGroup.d.ts

@@ -0,0 +1,47 @@
+import { ActionConfig } from '../../shared';
+/**
+ * Props for the internal ActionGroup helper.
+ */
+export interface ActionGroupProps {
+    /**
+     * The emphasised action of the pattern.
+     * Renders as a solid button or link.
+     */
+    primaryAction?: ActionConfig;
+    /**
+     * The supporting action of the pattern.
+     * Renders as a bordered button or link.
+     */
+    secondaryAction?: ActionConfig;
+    /**
+     * Horizontal alignment of the group on a wide screen.
+     * The actions are always stacked vertically on a narrow screen.
+     *
+     * @default "start"
+     */
+    align?: "start" | "center";
+    /**
+     * Additional classes for the wrapper.
+     */
+    className?: string;
+}
+/**
+ * Renders a pattern's configured actions.
+ *
+ * The group stacks on a narrow screen and sits in a row from the `sm`
+ * breakpoint, which is the arrangement that keeps two actions readable on a
+ * phone without the consumer writing a media query.
+ *
+ * @param props - The configured actions and their alignment.
+ * @returns The rendered group, or null when the pattern has no actions.
+ *
+ * @example
+ * ```tsx
+ * <ActionGroup
+ *   primaryAction={{ label: "Start free", href: "/signup" }}
+ *   secondaryAction={{ label: "Read the docs", href: "/docs" }}
+ * />
+ * ```
+ */
+export declare function ActionGroup({ primaryAction, secondaryAction, align, className, }: ActionGroupProps): import("react").JSX.Element | null;
+//# sourceMappingURL=ActionGroup.d.ts.map

package/dist/components/section-kit/ActionGroup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActionGroup.d.ts","sourceRoot":"","sources":["../../../src/components/section-kit/ActionGroup.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAIjD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,aAAa,CAAC,EAAE,YAAY,CAAC;IAE7B;;;OAGG;IACH,eAAe,CAAC,EAAE,YAAY,CAAC;IAE/B;;;;;OAKG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAE3B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,EAC1B,aAAa,EACb,eAAe,EACf,KAAe,EACf,SAAS,GACV,EAAE,gBAAgB,sCAoBlB"}

package/dist/components/section-kit/ActionGroup.js

@@ -0,0 +1,35 @@
+"use client";
+import { cn as e } from "../../utils/cn.js";
+import { Button as t } from "../button/Button.js";
+import { jsx as n, jsxs as r } from "react/jsx-runtime";
+//#region src/components/section-kit/ActionGroup.tsx
+function i({ primaryAction: t, secondaryAction: i, align: o = "start", className: s }) {
+	return !t && !i ? null : /* @__PURE__ */ r("div", {
+		className: e("flex flex-col gap-3 sm:flex-row sm:items-center", o === "center" && "sm:justify-center", s),
+		children: [t && /* @__PURE__ */ n(a, {
+			action: t,
+			defaultVariant: "solid"
+		}), i && /* @__PURE__ */ n(a, {
+			action: i,
+			defaultVariant: "bordered"
+		})]
+	});
+}
+function a({ action: e, defaultVariant: r }) {
+	let { label: i, href: a, variant: o, color: s, size: c, radius: l, icon: u, component: d, componentProps: f } = e;
+	return /* @__PURE__ */ n(t, {
+		href: a,
+		variant: o ?? r,
+		color: s,
+		size: c,
+		radius: l,
+		startContent: u,
+		link: d ? {
+			component: d,
+			props: f
+		} : void 0,
+		children: i
+	});
+}
+//#endregion
+export { i as ActionGroup };

package/dist/components/section-kit/SectionHeading.d.ts

@@ -0,0 +1,65 @@
+import { ElementType, ReactNode } from 'react';
+/**
+ * Heading sizes a section heading can use.
+ * The size selects a semantic typography role, so the visual step and the
+ * markup step are decided together.
+ */
+export type SectionHeadingSize = "md" | "lg" | "xl";
+/**
+ * Horizontal alignment of a section heading.
+ */
+export type SectionHeadingAlign = "start" | "center";
+/**
+ * Props for the internal SectionHeading helper.
+ */
+export interface SectionHeadingProps {
+    /**
+     * Short label above the title, for example the category of a section.
+     */
+    eyebrow?: ReactNode;
+    /**
+     * The heading itself.
+     */
+    title?: ReactNode;
+    /**
+     * Supporting sentence under the title.
+     */
+    description?: ReactNode;
+    /**
+     * Horizontal alignment of the block.
+     *
+     * @default "start"
+     */
+    align?: SectionHeadingAlign;
+    /**
+     * Element the title renders as.
+     * Defaults to the element the resolved typography role implies.
+     */
+    titleAs?: ElementType;
+    /**
+     * Size of the title.
+     *
+     * @default "md"
+     */
+    size?: SectionHeadingSize;
+    /**
+     * Identifier applied to the title element, so a section can point at it with
+     * `aria-labelledby`.
+     */
+    titleId?: string;
+    /**
+     * Additional classes for the wrapper.
+     */
+    className?: string;
+}
+/**
+ * The eyebrow, title and description block the patterns share.
+ *
+ * @param props - The heading content and its presentation options.
+ * @returns The rendered heading block, or null when it has nothing to show.
+ *
+ * @see Hero - Uses it for the page's leading statement.
+ * @see FeatureGrid - Uses it for the heading above the grid.
+ */
+export declare function SectionHeading({ eyebrow, title, description, align, titleAs, size, titleId, className, }: SectionHeadingProps): import("react").JSX.Element | null;
+//# sourceMappingURL=SectionHeading.d.ts.map

package/dist/components/section-kit/SectionHeading.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SectionHeading.d.ts","sourceRoot":"","sources":["../../../src/components/section-kit/SectionHeading.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIpD;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,QAAQ,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;IAEpB;;OAEG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAElB;;OAEG;IACH,WAAW,CAAC,EAAE,SAAS,CAAC;IAExB;;;;OAIG;IACH,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAE5B;;;OAGG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC;IAEtB;;;;OAIG;IACH,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAE1B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,EAC7B,OAAO,EACP,KAAK,EACL,WAAW,EACX,KAAe,EACf,OAAO,EACP,IAAW,EACX,OAAO,EACP,SAAS,GACV,EAAE,mBAAmB,sCA4CrB"}

package/dist/components/section-kit/SectionHeading.js

@@ -0,0 +1,34 @@
+"use client";
+import { cn as e } from "../../utils/cn.js";
+import { Typography as t } from "../typography/Typography.js";
+import { jsx as n, jsxs as r } from "react/jsx-runtime";
+//#region src/components/section-kit/SectionHeading.tsx
+function i({ eyebrow: i, title: a, description: o, align: s = "start", titleAs: c, size: l = "md", titleId: u, className: d }) {
+	if (!i && !a && !o) return null;
+	let f = s === "center";
+	return /* @__PURE__ */ r("div", {
+		className: e("flex flex-col gap-2", f && "items-center text-center", d),
+		children: [
+			i && /* @__PURE__ */ n(t, {
+				role: "overline",
+				tone: "primary",
+				children: i
+			}),
+			a && /* @__PURE__ */ n(t, {
+				as: c,
+				id: u,
+				role: l === "xl" ? "display" : l === "lg" ? "heading-xl" : "heading-lg",
+				className: f ? "text-balance" : "text-pretty",
+				children: a
+			}),
+			o && /* @__PURE__ */ n(t, {
+				role: "body-lg",
+				tone: "muted",
+				className: e("max-w-2xl", f && "mx-auto"),
+				children: o
+			})
+		]
+	});
+}
+//#endregion
+export { i as SectionHeading };

package/dist/components/section-kit/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Internal section kit for AsheeUI.
+ *
+ * The kit holds the parts the framework's patterns share: the heading block
+ * (`SectionHeading`) and the configured action group (`ActionGroup`). It is an
+ * internal helper module, like the field and menu helpers: it is deliberately
+ * not exported from the package entry point and is not part of the public
+ * component inventory.
+ */
+export * from './ActionGroup';
+export * from './SectionHeading';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/section-kit/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/section-kit/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC"}

package/dist/components/section-kit/index.js

@@ -0,0 +1,2 @@
+export * from "./ActionGroup.js";
+export * from "./SectionHeading.js";

package/dist/components/sidebar/Sidebar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Sidebar.d.ts","sourceRoot":"","sources":["../../../src/components/sidebar/Sidebar.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"Sidebar.d.ts","sourceRoot":"","sources":["../../../src/components/sidebar/Sidebar.tsx"],"names":[],"mappings":"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"}