asheeui 0.7.0 → 1.1.0

package/dist/puck/fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../src/puck/fields.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,UAAU,EAEV,WAAW,EACX,WAAW,EACX,aAAa,EACb,SAAS,EACV,MAAM,kBAAkB,CAAC;AAE1B;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAC1C,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,SAAS,CAAC,EAAE,GACpB,WAAW,CAMb;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAExE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,GACnB,aAAa,CAEf;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,8BAA+B,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,eAAe,wDAQlB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,kBAAkB,sCAAuC,CAAC;AAEvE;;GAEG;AACH,eAAO,MAAM,sBAAsB,2CAA4C,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,eAAe,+BAAgC,CAAC;AAE7D;;GAEG;AACH,eAAO,MAAM,sBAAsB,kDAKzB,CAAC;AAEX;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAQA,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,UAAU,CACzC,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAU9C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,UAAU,CAC5C,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,CAiB5C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;CAGI,CAAC;AAElC;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,UAAU,CAC7C,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAerD,CAAC"}

package/dist/puck/fields.js

@@ -0,0 +1,116 @@
+"use client";
+//#region src/puck/fields.ts
+function e(e, t) {
+	return {
+		type: "select",
+		label: e,
+		options: t.map((e) => ({
+			label: e,
+			value: e
+		}))
+	};
+}
+function t(e, t) {
+	return {
+		type: "text",
+		label: e,
+		placeholder: t
+	};
+}
+function n(e, t) {
+	return {
+		type: "textarea",
+		label: e,
+		placeholder: t
+	};
+}
+var r = ["start", "center"], i = [
+	"none",
+	"xs",
+	"sm",
+	"md",
+	"lg",
+	"xl",
+	"2xl"
+], a = [
+	"none",
+	"muted",
+	"tinted"
+], o = [
+	"sm",
+	"md",
+	"lg",
+	"xl",
+	"full"
+], s = [
+	"1",
+	"2",
+	"3",
+	"4"
+], c = [
+	"solid",
+	"faded",
+	"bordered",
+	"ghost"
+], l = {
+	type: "object",
+	label: "Action",
+	objectFields: {
+		label: t("Action label"),
+		href: t("Action link", "/pricing"),
+		variant: e("Action emphasis", c)
+	}
+}, u = {
+	type: "array",
+	label: "Features",
+	arrayFields: {
+		title: t("Feature title"),
+		description: n("Feature description")
+	},
+	defaultItemProps: {
+		title: "New feature",
+		description: ""
+	},
+	getItemSummary: (e) => e.title
+}, d = {
+	type: "array",
+	label: "Feature lines",
+	arrayFields: {
+		label: t("Line"),
+		included: {
+			type: "radio",
+			label: "Included",
+			options: [{
+				label: "Included",
+				value: !0
+			}, {
+				label: "Not included",
+				value: !1
+			}]
+		}
+	},
+	defaultItemProps: {
+		label: "New line",
+		included: !0
+	},
+	getItemSummary: (e) => e.label
+}, f = {
+	label: t("Link label"),
+	href: t("Link", "/pricing")
+}, p = {
+	type: "array",
+	label: "Quotes",
+	arrayFields: {
+		quote: n("Quote"),
+		name: t("Name"),
+		role: t("Role")
+	},
+	defaultItemProps: {
+		quote: "They send twice as fast as they used to.",
+		name: "New customer",
+		role: ""
+	},
+	getItemSummary: (e) => e.name
+};
+//#endregion
+export { l as ACTION_FIELDS, c as ACTION_VARIANT_OPTIONS, r as ALIGNMENT_OPTIONS, a as BACKGROUND_OPTIONS, s as COLUMNS_OPTIONS, o as CONTAINER_SIZE_OPTIONS, u as FEATURE_ITEM_FIELD, f as LINK_ITEM_FIELDS, d as PRICING_FEATURE_FIELD, i as SPACING_OPTIONS, p as TESTIMONIAL_ITEM_FIELD, e as selectField, t as textField, n as textareaField };

package/dist/puck/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Puck integration for AsheeUI.
+ *
+ * The subpath holds the framework's block configuration: the fields a builder
+ * can edit, one block per component, the categories they are filed under and the
+ * page shell a published page renders into. Nothing here is imported by the
+ * component library itself, so a consumer that does not use Puck never loads it.
+ *
+ * ```tsx
+ * import { asheePuckConfig } from "asheeui/puck";
+ * ```
+ */
+export * from './adapters';
+export * from './blocks/content';
+export * from './blocks/layout';
+export * from './blocks/navigation';
+export * from './blocks/sections';
+export * from './blocks/utility';
+export * from './config';
+export * from './fields';
+//# sourceMappingURL=index.d.ts.map

package/dist/puck/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/puck/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC"}

package/dist/puck/index.js

@@ -0,0 +1,10 @@
+"use client";
+import { toAction as e, toColumns as t } from "./adapters.js";
+import { ACTION_FIELDS as n, ACTION_VARIANT_OPTIONS as r, ALIGNMENT_OPTIONS as i, BACKGROUND_OPTIONS as a, COLUMNS_OPTIONS as o, CONTAINER_SIZE_OPTIONS as s, FEATURE_ITEM_FIELD as c, LINK_ITEM_FIELDS as l, PRICING_FEATURE_FIELD as u, SPACING_OPTIONS as d, TESTIMONIAL_ITEM_FIELD as f, selectField as p, textField as m, textareaField as h } from "./fields.js";
+import { headingBlock as g, textBlock as _ } from "./blocks/content.js";
+import { COLUMN_RATIO_OPTIONS as v, columnsBlock as y, sectionBlock as b } from "./blocks/layout.js";
+import { footerBlock as x, navbarBlock as S } from "./blocks/navigation.js";
+import { ctaBlock as C, featureGridBlock as w, heroBlock as T, pricingCardBlock as E, testimonialsBlock as D } from "./blocks/sections.js";
+import { emptyStateBlock as O } from "./blocks/utility.js";
+import { asheePuckConfig as k } from "./config.js";
+export { n as ACTION_FIELDS, r as ACTION_VARIANT_OPTIONS, i as ALIGNMENT_OPTIONS, a as BACKGROUND_OPTIONS, o as COLUMNS_OPTIONS, v as COLUMN_RATIO_OPTIONS, s as CONTAINER_SIZE_OPTIONS, c as FEATURE_ITEM_FIELD, l as LINK_ITEM_FIELDS, u as PRICING_FEATURE_FIELD, d as SPACING_OPTIONS, f as TESTIMONIAL_ITEM_FIELD, k as asheePuckConfig, y as columnsBlock, C as ctaBlock, O as emptyStateBlock, w as featureGridBlock, x as footerBlock, g as headingBlock, T as heroBlock, S as navbarBlock, E as pricingCardBlock, b as sectionBlock, p as selectField, D as testimonialsBlock, _ as textBlock, m as textField, h as textareaField, e as toAction, t as toColumns };

package/dist/scripts/AsheeThemeScript.js

@@ -13,15 +13,44 @@ var n = {
 	success: "--ashee-success",
 	scrollbarThumb: "--ashee-scrollbar-thumb",
 	scrollbarTrack: "--ashee-scrollbar-track"
-}, r = "ashee-theme-vars";
-function i(e) {
+}, r = "ashee-theme-vars", i = "ashee-theme-script";
+function a(e) {
 	return Object.entries(e).map(([e, t]) => {
 		let r = Object.entries(t).map(([e, t]) => `  ${n[e]}: ${t};`).join("\n");
 		return `${e === "light" ? ":root, .theme-light" : `.theme-${e}`} {\n${r}\n}`;
 	}).join("\n\n");
 }
-function a({ config: n }) {
-	let a = Object.keys(n.color ?? {}), o = n.defaultTheme ?? "system", s = e, c = i(n.color), l = `
+var o = {
+	width: "--ashee-scrollbar-width",
+	radius: "--ashee-scrollbar-radius",
+	trackRadius: "--ashee-scrollbar-track-radius",
+	thumbBorder: "--ashee-scrollbar-thumb-border",
+	gutter: "--ashee-scrollbar-gutter"
+};
+function s(e) {
+	if (!e) return "";
+	let t = {
+		width: e.width,
+		radius: e.radius,
+		trackRadius: e.trackRadius ?? e.radius,
+		thumbBorder: e.thumbBorder,
+		gutter: e.gutter
+	}, n = Object.entries(o).map(([e, n]) => {
+		let r = t[e];
+		return r ? `  ${n}: ${r};` : null;
+	}).filter((e) => e !== null);
+	return n.length > 0 ? `:root {\n${n.join("\n")}\n}` : "";
+}
+function c(e) {
+	return [a(e.color), s(e.components?.scrollbar)].filter((e) => e !== "").join("\n\n");
+}
+function l(e) {
+	if (typeof document > "u" || document.getElementById("ashee-theme-vars")) return;
+	let t = document.createElement("style");
+	t.id = r, t.textContent = c(e), document.head.appendChild(t);
+}
+function u({ config: n }) {
+	let a = Object.keys(n.color ?? {}), o = n.defaultTheme ?? "system", s = e, l = c(n), u = `
     (function() {
       var el = document.documentElement;
       var storageKey = ${JSON.stringify(s)};
@@ -35,7 +64,13 @@ function a({ config: n }) {
       } catch (e) {}
       
       var selection = stored || defaultTheme;
+      if (selection !== 'system' && themes.indexOf(selection) === -1) {
+        selection = defaultTheme;
+      }
       var resolved = selection === 'system' ? (systemDark ? 'dark' : 'light') : selection;
+      if (themes.indexOf(resolved) === -1) {
+        resolved = themes.indexOf(defaultTheme) !== -1 ? defaultTheme : (themes[0] || resolved);
+      }
       
       var prefix = 'theme-';
       for (var i = el.classList.length - 1; i >= 0; i--) {
@@ -51,16 +86,16 @@ function a({ config: n }) {
       if (!styleEl) {
         styleEl = document.createElement('style');
         styleEl.id = ${JSON.stringify(r)};
-        styleEl.textContent = ${JSON.stringify(c)};
+        styleEl.textContent = ${JSON.stringify(l)};
         document.head.appendChild(styleEl);
       }
     })();
   `;
 	return /* @__PURE__ */ t("script", {
-		id: "ashee-theme-script",
-		dangerouslySetInnerHTML: { __html: l },
+		id: i,
+		dangerouslySetInnerHTML: { __html: u },
 		suppressHydrationWarning: !0
 	});
 }
 //#endregion
-export { a as AsheeThemeScript, r as THEME_VARS_STYLE_ID };
+export { u as AsheeThemeScript, i as THEME_SCRIPT_ID, r as THEME_VARS_STYLE_ID, c as buildThemeVarsCss, l as ensureThemeVarsStyle };

package/dist/shared/action.d.ts

@@ -0,0 +1,52 @@
+import { ElementType, ReactNode } from 'react';
+import { Radius, Size } from './radius';
+import { Color, Variant } from './variant';
+/**
+ * A call to action described as configuration.
+ *
+ * Every field maps to a prop of {@link Button}, so a configured action renders
+ * exactly like an action the consumer wrote by hand. `label` is the only
+ * required field: an action without a name cannot be read or clicked.
+ */
+export interface ActionConfig {
+    /**
+     * Visible name of the action, and the accessible name of its control.
+     */
+    label: ReactNode;
+    /**
+     * Destination of the action.
+     * With one, the action renders as a link; without one, as a button.
+     */
+    href?: string;
+    /**
+     * Visual style of the action.
+     * Defaults to the emphasis the pattern gives that position: the primary
+     * action is solid and the secondary action is bordered.
+     */
+    variant?: Variant;
+    /**
+     * Accent colour of the action.
+     */
+    color?: Color;
+    /**
+     * Density of the action.
+     */
+    size?: Size;
+    /**
+     * Corner rounding of the action.
+     */
+    radius?: Radius;
+    /**
+     * Content before the label, typically an icon.
+     */
+    icon?: ReactNode;
+    /**
+     * Component that replaces the anchor, such as a framework router link.
+     */
+    component?: ElementType;
+    /**
+     * Props for that component.
+     */
+    componentProps?: Record<string, unknown>;
+}
+//# sourceMappingURL=action.d.ts.map

package/dist/shared/action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../src/shared/action.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEhD;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,KAAK,EAAE,SAAS,CAAC;IAEjB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;IAEd;;OAEG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;IAEZ;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;IAEjB;;OAEG;IACH,SAAS,CAAC,EAAE,WAAW,CAAC;IAExB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C"}

package/dist/shared/index.d.ts

@@ -1,3 +1,6 @@
+export * from './action';
 export * from './radius';
+export * from './spacing';
+export * from './typography';
 export * from './variant';
 //# sourceMappingURL=index.d.ts.map

package/dist/shared/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC"}

package/dist/shared/spacing.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Spacing token definitions for AsheeUI.
+ *
+ * This file provides the shared spacing scale that the layout components use
+ * for gaps, vertical rhythm and section padding. Every entry is a complete,
+ * static Tailwind class string, so the scale never assembles a utility name at
+ * runtime (Hard Rule 5) and a layout component can resolve spacing through the
+ * standard configuration cascade.
+ */
+/**
+ * The available spacing tokens.
+ * The scale is intentionally small: it exists so layout primitives agree on
+ * rhythm, not so it can express every value Tailwind supports.
+ */
+export type Space = "none" | "xs" | "sm" | "md" | "lg" | "xl" | "2xl";
+/**
+ * Flex and grid gap classes for each spacing token.
+ * Used by `Stack` and `Grid` for the space between their children.
+ */
+export declare const SPACE_GAP_CLASS: Record<Space, string>;
+/**
+ * Vertical rhythm classes for stacked block content.
+ * Applied to a container whose direct children are blocks rather than
+ * flex or grid items.
+ */
+export declare const SPACE_BLOCK_CLASS: Record<Space, string>;
+/**
+ * Vertical padding classes for a page section.
+ * Larger tokens add a wider step at the `md` breakpoint, so the same token
+ * reads as a section on a phone and as a band on a wide screen.
+ */
+export declare const SPACE_PADDING_Y_CLASS: Record<Space, string>;
+/**
+ * Horizontal padding classes for a page gutter.
+ * Used by `Container`, where the gutter widens with the viewport.
+ */
+export declare const SPACE_PADDING_X_CLASS: Record<Space, string>;
+//# sourceMappingURL=spacing.d.ts.map

package/dist/shared/spacing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spacing.d.ts","sourceRoot":"","sources":["../../src/shared/spacing.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;GAIG;AACH,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;AAEtE;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAQjD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAQnD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAQvD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAQvD,CAAC"}

package/dist/shared/spacing.js

@@ -0,0 +1,29 @@
+"use client";
+//#region src/shared/spacing.ts
+var e = {
+	none: "gap-0",
+	xs: "gap-1",
+	sm: "gap-2",
+	md: "gap-4",
+	lg: "gap-6",
+	xl: "gap-8",
+	"2xl": "gap-12"
+}, t = {
+	none: "py-0",
+	xs: "py-2",
+	sm: "py-6",
+	md: "py-8 md:py-12",
+	lg: "py-12 md:py-16",
+	xl: "py-16 md:py-24",
+	"2xl": "py-20 md:py-32"
+}, n = {
+	none: "px-0",
+	xs: "px-1",
+	sm: "px-3",
+	md: "px-4 sm:px-6",
+	lg: "px-4 sm:px-6 lg:px-8",
+	xl: "px-6 sm:px-8 lg:px-12",
+	"2xl": "px-8 sm:px-12 lg:px-16"
+};
+//#endregion
+export { e as SPACE_GAP_CLASS, n as SPACE_PADDING_X_CLASS, t as SPACE_PADDING_Y_CLASS };

package/dist/shared/typography.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Typography token definitions for AsheeUI.
+ *
+ * Typography uses the same two-layer model as radius and colour: a semantic
+ * layer (roles) resolves to a size/style layer, which resolves to complete,
+ * static Tailwind class strings. This file holds the types and the mappings;
+ * the public `Typography` component consumes them.
+ *
+ * @see `docs/docs/asheeui-typography-specification-proposal.md` (approved M2
+ * specification) for the rationale, the role table and the compatibility notes.
+ */
+/** The available typography size tokens. */
+export type TypographySize = "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "3xl";
+/** The available font-weight tokens. */
+export type TypographyWeight = "normal" | "medium" | "semibold" | "bold";
+/** The available line-height tokens. */
+export type TypographyLeading = "tight" | "snug" | "normal" | "relaxed" | "loose";
+/** The available letter-spacing tokens. */
+export type TypographyTracking = "tighter" | "tight" | "normal" | "wide" | "wider" | "widest";
+/**
+ * The semantic typography roles.
+ * A role describes why text exists and resolves to a complete treatment.
+ */
+export type TypographyRole = "display" | "heading-xl" | "heading-lg" | "heading-md" | "heading-sm" | "body-lg" | "body-md" | "body-sm" | "label" | "caption" | "overline";
+/**
+ * The colour treatments available to typography.
+ * `default`, `muted` and `disabled` are derived from the foreground token;
+ * the remaining values are framework colour tokens resolved through the colour
+ * engine, never raw Tailwind palette colours.
+ */
+export type TypographyTone = "default" | "muted" | "disabled" | "primary" | "secondary" | "danger" | "warning" | "success" | "none";
+/** Text alignment options. */
+export type TypographyAlign = "left" | "center" | "right" | "justify";
+/** The size/style tokens a role resolves to. */
+export interface TypographyRoleTokens {
+    /** Size token. */
+    size: TypographySize;
+    /** Font-weight token. */
+    weight: TypographyWeight;
+    /** Line-height token. */
+    leading: TypographyLeading;
+    /** Letter-spacing token. */
+    tracking: TypographyTracking;
+}
+/**
+ * Size token to static Tailwind class.
+ * Note the deliberate difference between the token name (`md`) and the utility
+ * (`text-base`): the token is the semantic name, as with `RADIUS_CLASS`.
+ */
+export declare const TYPOGRAPHY_SIZE_CLASS: Record<TypographySize, string>;
+/** Font-weight token to static Tailwind class. */
+export declare const TYPOGRAPHY_WEIGHT_CLASS: Record<TypographyWeight, string>;
+/** Line-height token to static Tailwind class. */
+export declare const TYPOGRAPHY_LEADING_CLASS: Record<TypographyLeading, string>;
+/** Letter-spacing token to static Tailwind class. */
+export declare const TYPOGRAPHY_TRACKING_CLASS: Record<TypographyTracking, string>;
+/** Tone token to static Tailwind class, using framework colour tokens only. */
+export declare const TYPOGRAPHY_TONE_CLASS: Record<TypographyTone, string>;
+/** Alignment token to static Tailwind class. */
+export declare const TYPOGRAPHY_ALIGN_CLASS: Record<TypographyAlign, string>;
+/**
+ * The size/style tokens each semantic role resolves to.
+ * This table is the documentation source for {@link TYPOGRAPHY_ROLE_CLASS};
+ * a test asserts the two can never drift.
+ */
+export declare const TYPOGRAPHY_ROLE_TOKEN: Record<TypographyRole, TypographyRoleTokens>;
+/**
+ * The semantic element each role renders by default.
+ * Consumers can override the element without changing the treatment.
+ */
+export declare const TYPOGRAPHY_ROLE_DEFAULT_ELEMENT: Record<TypographyRole, string>;
+/**
+ * The complete, static class string for each semantic role.
+ *
+ * These are written out in full rather than composed at render time: Tailwind
+ * class names must always be static and complete. The entries are asserted
+ * against {@link TYPOGRAPHY_ROLE_TOKEN} in the test suite, so the documented
+ * token table and the shipped classes cannot drift.
+ */
+export declare const TYPOGRAPHY_ROLE_CLASS: Record<TypographyRole, string>;
+//# sourceMappingURL=typography.d.ts.map

package/dist/shared/typography.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typography.d.ts","sourceRoot":"","sources":["../../src/shared/typography.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,4CAA4C;AAC5C,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,CAAC;AAE9E,wCAAwC;AACxC,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;AAEzE,wCAAwC;AACxC,MAAM,MAAM,iBAAiB,GACzB,OAAO,GACP,MAAM,GACN,QAAQ,GACR,SAAS,GACT,OAAO,CAAC;AAEZ,2CAA2C;AAC3C,MAAM,MAAM,kBAAkB,GAC1B,SAAS,GACT,OAAO,GACP,QAAQ,GACR,MAAM,GACN,OAAO,GACP,QAAQ,CAAC;AAEb;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB,SAAS,GACT,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,SAAS,GACT,SAAS,GACT,SAAS,GACT,OAAO,GACP,SAAS,GACT,UAAU,CAAC;AAEf;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GACtB,SAAS,GACT,OAAO,GACP,UAAU,GACV,SAAS,GACT,WAAW,GACX,QAAQ,GACR,SAAS,GACT,SAAS,GACT,MAAM,CAAC;AAEX,8BAA8B;AAC9B,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAEtE,gDAAgD;AAChD,MAAM,WAAW,oBAAoB;IACnC,kBAAkB;IAClB,IAAI,EAAE,cAAc,CAAC;IACrB,yBAAyB;IACzB,MAAM,EAAE,gBAAgB,CAAC;IACzB,yBAAyB;IACzB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,4BAA4B;IAC5B,QAAQ,EAAE,kBAAkB,CAAC;CAC9B;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAQhE,CAAC;AAEF,kDAAkD;AAClD,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAKpE,CAAC;AAEF,kDAAkD;AAClD,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAMtE,CAAC;AAEF,qDAAqD;AACrD,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAOxE,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAUhE,CAAC;AAEF,gDAAgD;AAChD,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAKlE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CACxC,cAAc,EACd,oBAAoB,CAoErB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,+BAA+B,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAY1E,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAYhE,CAAC"}

package/dist/shared/typography.js

@@ -0,0 +1,137 @@
+"use client";
+//#region src/shared/typography.ts
+var e = {
+	xs: "text-xs",
+	sm: "text-sm",
+	md: "text-base",
+	lg: "text-lg",
+	xl: "text-xl",
+	"2xl": "text-2xl",
+	"3xl": "text-3xl"
+}, t = {
+	normal: "font-normal",
+	medium: "font-medium",
+	semibold: "font-semibold",
+	bold: "font-bold"
+}, n = {
+	tight: "leading-tight",
+	snug: "leading-snug",
+	normal: "leading-normal",
+	relaxed: "leading-relaxed",
+	loose: "leading-loose"
+}, r = {
+	tighter: "tracking-tighter",
+	tight: "tracking-tight",
+	normal: "tracking-normal",
+	wide: "tracking-wide",
+	wider: "tracking-wider",
+	widest: "tracking-widest"
+}, i = {
+	default: "text-foreground",
+	muted: "text-foreground/60",
+	disabled: "text-foreground/50",
+	primary: "text-primary",
+	secondary: "text-secondary",
+	danger: "text-danger",
+	warning: "text-warning",
+	success: "text-success",
+	none: "text-background"
+}, a = {
+	left: "text-left",
+	center: "text-center",
+	right: "text-right",
+	justify: "text-justify"
+}, o = {
+	display: {
+		size: "3xl",
+		weight: "semibold",
+		leading: "tight",
+		tracking: "tight"
+	},
+	"heading-xl": {
+		size: "2xl",
+		weight: "semibold",
+		leading: "tight",
+		tracking: "tight"
+	},
+	"heading-lg": {
+		size: "xl",
+		weight: "semibold",
+		leading: "snug",
+		tracking: "normal"
+	},
+	"heading-md": {
+		size: "lg",
+		weight: "semibold",
+		leading: "snug",
+		tracking: "normal"
+	},
+	"heading-sm": {
+		size: "md",
+		weight: "semibold",
+		leading: "snug",
+		tracking: "normal"
+	},
+	"body-lg": {
+		size: "lg",
+		weight: "normal",
+		leading: "relaxed",
+		tracking: "normal"
+	},
+	"body-md": {
+		size: "md",
+		weight: "normal",
+		leading: "normal",
+		tracking: "normal"
+	},
+	"body-sm": {
+		size: "sm",
+		weight: "normal",
+		leading: "normal",
+		tracking: "normal"
+	},
+	label: {
+		size: "sm",
+		weight: "medium",
+		leading: "normal",
+		tracking: "normal"
+	},
+	caption: {
+		size: "xs",
+		weight: "normal",
+		leading: "normal",
+		tracking: "normal"
+	},
+	overline: {
+		size: "xs",
+		weight: "semibold",
+		leading: "normal",
+		tracking: "wider"
+	}
+}, s = {
+	display: "h1",
+	"heading-xl": "h1",
+	"heading-lg": "h2",
+	"heading-md": "h3",
+	"heading-sm": "h4",
+	"body-lg": "p",
+	"body-md": "p",
+	"body-sm": "p",
+	label: "span",
+	caption: "span",
+	overline: "span"
+}, c = {
+	display: "text-3xl font-semibold leading-tight tracking-tight",
+	"heading-xl": "text-2xl font-semibold leading-tight tracking-tight",
+	"heading-lg": "text-xl font-semibold leading-snug tracking-normal",
+	"heading-md": "text-lg font-semibold leading-snug tracking-normal",
+	"heading-sm": "text-base font-semibold leading-snug tracking-normal",
+	"body-lg": "text-lg font-normal leading-relaxed tracking-normal",
+	"body-md": "text-base font-normal leading-normal tracking-normal",
+	"body-sm": "text-sm font-normal leading-normal tracking-normal",
+	label: "text-sm font-medium leading-normal tracking-normal",
+	caption: "text-xs font-normal leading-normal tracking-normal",
+	overline: "text-xs font-semibold leading-normal tracking-wider"
+};
+//#endregion
+export { a as TYPOGRAPHY_ALIGN_CLASS, n as TYPOGRAPHY_LEADING_CLASS, c as TYPOGRAPHY_ROLE_CLASS, s as TYPOGRAPHY_ROLE_DEFAULT_ELEMENT, o as TYPOGRAPHY_ROLE_TOKEN, e as TYPOGRAPHY_SIZE_CLASS, i as TYPOGRAPHY_TONE_CLASS, r as TYPOGRAPHY_TRACKING_CLASS, t as TYPOGRAPHY_WEIGHT_CLASS };

package/dist/utils/resolve-token.d.ts

@@ -1,10 +1,4 @@
-/**
- * Utility functions for resolving cascade values in AsheeUI.
- * This file provides helper functions that implement the configuration
- * precedence hierarchy: instance prop > component config > theme default > hard fallback.
- * These utilities are used throughout the component library to resolve
- * values like variant, color, size, and radius.
- */
+import { DeepPartial } from './types';
 /**
  * Resolves a value using the standard cascade precedence order.
  * Follows the hierarchy: instance prop > component config > global default > hard fallback.
@@ -71,6 +65,37 @@ export declare function resolveAnimate<T>(instance: T | undefined, section: T |
  * ```
  */
 export declare function resolveRadiusKey<TKey>(instanceProp: TKey | undefined, sectionConfig: TKey | undefined, globalDefaultRadius: TKey | undefined, hardFallback?: TKey): TKey;
+/**
+ * Resolve every option of a component's configuration in one step.
+ *
+ * A layout or pattern component usually exposes its whole configuration as a
+ * set of optional props that resolve through the same cascade. Calling
+ * {@link resolveCascade} once per key repeats the same precedence rule and the
+ * same fallback argument for every option, which is where drift creeps in. This
+ * helper applies the rule to every key of the hard fallback in one call, so a
+ * component states its options once and the precedence is guaranteed to be
+ * identical for all of them.
+ *
+ * The fallback object defines the shape: every key it declares is resolved and
+ * returned, and a key it omits has no fallback at all (which is how optional
+ * responsive keys stay undefined).
+ *
+ * @param instance - The props passed to the component instance.
+ * @param section - The component's configuration section, if any.
+ * @param fallback - The hard fallback for every option.
+ * @returns A complete set of resolved values.
+ *
+ * @example
+ * ```tsx
+ * const resolved = resolveConfigCascade<HeroConfig, Required<HeroConfig>>(
+ *   { align, spacing, background },
+ *   config.components?.hero,
+ *   FALLBACK_HERO_CONFIG,
+ * );
+ * // resolved.align is the prop, then components.hero.align, then the fallback
+ * ```
+ */
+export declare function resolveConfigCascade<C extends object, F extends Required<C>>(instance: Partial<C>, section: DeepPartial<C> | undefined, fallback: F): F;
 /**
  * Resolves a CSS class from a class map based on a key.
  * Returns the class string for the given key, falling back to the

package/dist/utils/resolve-token.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-token.d.ts","sourceRoot":"","sources":["../../src/utils/resolve-token.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,QAAQ,EAAE,CAAC,GAAG,SAAS,EACvB,OAAO,EAAE,CAAC,GAAG,SAAS,EACtB,aAAa,EAAE,CAAC,GAAG,SAAS,EAC5B,YAAY,EAAE,CAAC,GACd,CAAC,CAEH;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,QAAQ,EAAE,CAAC,GAAG,SAAS,EACvB,OAAO,EAAE,CAAC,GAAG,SAAS,EACtB,YAAY,EAAE,CAAC,GACd,CAAC,CAEH;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EACnC,YAAY,EAAE,IAAI,GAAG,SAAS,EAC9B,aAAa,EAAE,IAAI,GAAG,SAAS,EAC/B,mBAAmB,EAAE,IAAI,GAAG,SAAS,EACrC,YAAY,GAAE,IAAmB,GAChC,IAAI,CAEN;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,eAAe,CAAC,IAAI,SAAS,WAAW,EACtD,GAAG,EAAE,IAAI,EACT,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,EAC9B,WAAW,EAAE,IAAI,GAChB,MAAM,CAER"}
+{"version":3,"file":"resolve-token.d.ts","sourceRoot":"","sources":["../../src/utils/resolve-token.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,QAAQ,EAAE,CAAC,GAAG,SAAS,EACvB,OAAO,EAAE,CAAC,GAAG,SAAS,EACtB,aAAa,EAAE,CAAC,GAAG,SAAS,EAC5B,YAAY,EAAE,CAAC,GACd,CAAC,CAEH;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,QAAQ,EAAE,CAAC,GAAG,SAAS,EACvB,OAAO,EAAE,CAAC,GAAG,SAAS,EACtB,YAAY,EAAE,CAAC,GACd,CAAC,CAEH;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EACnC,YAAY,EAAE,IAAI,GAAG,SAAS,EAC9B,aAAa,EAAE,IAAI,GAAG,SAAS,EAC/B,mBAAmB,EAAE,IAAI,GAAG,SAAS,EACrC,YAAY,GAAE,IAAmB,GAChC,IAAI,CAEN;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,EAC1E,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS,EACnC,QAAQ,EAAE,CAAC,GACV,CAAC,CAeH;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,eAAe,CAAC,IAAI,SAAS,WAAW,EACtD,GAAG,EAAE,IAAI,EACT,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,EAC9B,WAAW,EAAE,IAAI,GAChB,MAAM,CAER"}