asheeui 1.0.0 → 1.1.0

package/dist/puck/config.d.ts

@@ -0,0 +1,63 @@
+import { Config } from '@puckeditor/core';
+import { ReactNode } from 'react';
+import { HeadingBlockProps, TextBlockProps } from './blocks/content';
+import { ColumnsBlockProps, SectionBlockProps } from './blocks/layout';
+import { FooterBlockProps, NavbarBlockProps } from './blocks/navigation';
+import { CtaBlockProps, FeatureGridBlockProps, HeroBlockProps, PricingCardBlockProps, TestimonialsBlockProps } from './blocks/sections';
+import { EmptyStateBlockProps } from './blocks/utility';
+/**
+ * Every block the AsheeUI configuration offers, with its props.
+ */
+export type AsheePuckComponents = {
+    /** A band with vertical rhythm and a background. */
+    Section: SectionBlockProps;
+    /** A two-column arrangement that stacks on a narrow screen. */
+    Columns: ColumnsBlockProps;
+    /** A section heading. */
+    Heading: HeadingBlockProps;
+    /** A paragraph of body text. */
+    Text: TextBlockProps;
+    /** The navigation bar of a page. */
+    Navbar: NavbarBlockProps;
+    /** The footer of a page. */
+    Footer: FooterBlockProps;
+    /** The leading statement of a page. */
+    Hero: HeroBlockProps;
+    /** The closing call to action of a page. */
+    CTA: CtaBlockProps;
+    /** A band of features in a responsive grid. */
+    FeatureGrid: FeatureGridBlockProps;
+    /** A band of attributed customer quotes. */
+    Testimonials: TestimonialsBlockProps;
+    /** One plan in a pricing table. */
+    PricingCard: PricingCardBlockProps;
+    /** A region with nothing in it. */
+    EmptyState: EmptyStateBlockProps;
+};
+/**
+ * The categories a block can be filed under.
+ * A block that appears in none of them is listed by the builder's own fallback
+ * category, which is why the list stays explicit rather than complete by
+ * accident.
+ */
+export type AsheePuckCategory = "Layout" | "Navigation" | "Hero" | "Content" | "Features" | "CTA" | "Pricing" | "Testimonials" | "Utility";
+/**
+ * Props of the published page's root, which is the framework's page shell.
+ */
+export type AsheePuckRootProps = {
+    /** The page content the builder composed. */
+    children?: ReactNode;
+};
+/**
+ * The type of the AsheeUI Puck configuration.
+ */
+export type AsheePuckConfig = Config<{
+    components: AsheePuckComponents;
+    root: AsheePuckRootProps;
+    categories: AsheePuckCategory[];
+}>;
+/**
+ * The AsheeUI blocks, filed under the categories the builder shows.
+ */
+export declare const asheePuckConfig: AsheePuckConfig;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/puck/config.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,KAAK,SAAS,EAAc,MAAM,OAAO,CAAC;AAGnD,OAAO,EACL,KAAK,iBAAiB,EAEtB,KAAK,cAAc,EAEpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,KAAK,iBAAiB,EAEtB,KAAK,iBAAiB,EAEvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,KAAK,gBAAgB,EAErB,KAAK,gBAAgB,EAEtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,KAAK,aAAa,EAElB,KAAK,qBAAqB,EAE1B,KAAK,cAAc,EAEnB,KAAK,qBAAqB,EAE1B,KAAK,sBAAsB,EAE5B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,KAAK,oBAAoB,EAAmB,MAAM,kBAAkB,CAAC;AAE9E;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,oDAAoD;IACpD,OAAO,EAAE,iBAAiB,CAAC;IAE3B,+DAA+D;IAC/D,OAAO,EAAE,iBAAiB,CAAC;IAE3B,yBAAyB;IACzB,OAAO,EAAE,iBAAiB,CAAC;IAE3B,gCAAgC;IAChC,IAAI,EAAE,cAAc,CAAC;IAErB,oCAAoC;IACpC,MAAM,EAAE,gBAAgB,CAAC;IAEzB,4BAA4B;IAC5B,MAAM,EAAE,gBAAgB,CAAC;IAEzB,uCAAuC;IACvC,IAAI,EAAE,cAAc,CAAC;IAErB,4CAA4C;IAC5C,GAAG,EAAE,aAAa,CAAC;IAEnB,+CAA+C;IAC/C,WAAW,EAAE,qBAAqB,CAAC;IAEnC,4CAA4C;IAC5C,YAAY,EAAE,sBAAsB,CAAC;IAErC,mCAAmC;IACnC,WAAW,EAAE,qBAAqB,CAAC;IAEnC,mCAAmC;IACnC,UAAU,EAAE,oBAAoB,CAAC;CAClC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GACzB,QAAQ,GACR,YAAY,GACZ,MAAM,GACN,SAAS,GACT,UAAU,GACV,KAAK,GACL,SAAS,GACT,cAAc,GACd,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC;IACnC,UAAU,EAAE,mBAAmB,CAAC;IAChC,IAAI,EAAE,kBAAkB,CAAC;IACzB,UAAU,EAAE,iBAAiB,EAAE,CAAC;CACjC,CAAC,CAAC;AAyBH;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,eAkC7B,CAAC"}

package/dist/puck/config.js

@@ -0,0 +1,79 @@
+"use client";
+import { AsheeConfigContext as e } from "../libs/context.js";
+import { AsheeUIProvider as t } from "../AsheeUIProvider.js";
+import { headingBlock as n, textBlock as r } from "./blocks/content.js";
+import { columnsBlock as i, sectionBlock as a } from "./blocks/layout.js";
+import { footerBlock as o, navbarBlock as s } from "./blocks/navigation.js";
+import { ctaBlock as c, featureGridBlock as l, heroBlock as u, pricingCardBlock as d, testimonialsBlock as f } from "./blocks/sections.js";
+import { emptyStateBlock as p } from "./blocks/utility.js";
+import { useContext as m } from "react";
+import { jsx as h } from "react/jsx-runtime";
+//#region src/puck/config.tsx
+function g({ children: n }) {
+	let r = m(e), i = /* @__PURE__ */ h("div", {
+		className: "flex min-h-dvh w-full flex-col bg-background text-foreground",
+		children: n
+	});
+	return r ? i : /* @__PURE__ */ h(t, { children: i });
+}
+var _ = {
+	components: {
+		Section: a,
+		Columns: i,
+		Heading: n,
+		Text: r,
+		Navbar: s,
+		Footer: o,
+		Hero: u,
+		CTA: c,
+		FeatureGrid: l,
+		Testimonials: f,
+		PricingCard: d,
+		EmptyState: p
+	},
+	categories: {
+		Layout: {
+			title: "Layout",
+			components: ["Section", "Columns"]
+		},
+		Navigation: {
+			title: "Navigation",
+			components: ["Navbar", "Footer"]
+		},
+		Hero: {
+			title: "Hero",
+			components: ["Hero"]
+		},
+		Content: {
+			title: "Content",
+			components: ["Heading", "Text"]
+		},
+		Features: {
+			title: "Features",
+			components: ["FeatureGrid"]
+		},
+		CTA: {
+			title: "CTA",
+			components: ["CTA"]
+		},
+		Pricing: {
+			title: "Pricing",
+			components: ["PricingCard"]
+		},
+		Testimonials: {
+			title: "Testimonials",
+			components: ["Testimonials"]
+		},
+		Utility: {
+			title: "Utility",
+			components: ["EmptyState"]
+		}
+	},
+	root: {
+		fields: {},
+		defaultProps: {},
+		render: ({ children: e }) => /* @__PURE__ */ h(g, { children: e })
+	}
+};
+//#endregion
+export { _ as asheePuckConfig };

package/dist/puck/fields.d.ts

@@ -0,0 +1,94 @@
+import { ArrayField, ObjectField, SelectField, TextareaField, TextField } from '@puckeditor/core';
+/**
+ * Build a select field from the values a prop accepts.
+ *
+ * The options are derived from the same tuple the component's type uses, so a
+ * value the builder offers and a value the component accepts cannot drift.
+ *
+ * @param label - Label shown in the builder.
+ * @param options - The accepted values.
+ * @returns The field definition.
+ */
+export declare function selectField<T extends string>(label: string, options: readonly T[]): SelectField;
+/**
+ * Build a single-line text field.
+ *
+ * @param label - Label shown in the builder.
+ * @param placeholder - Placeholder shown in the empty field.
+ * @returns The field definition.
+ */
+export declare function textField(label: string, placeholder?: string): TextField;
+/**
+ * Build a multi-line text field.
+ *
+ * @param label - Label shown in the builder.
+ * @param placeholder - Placeholder shown in the empty field.
+ * @returns The field definition.
+ */
+export declare function textareaField(label: string, placeholder?: string): TextareaField;
+/**
+ * Alignment options shared by the patterns that can centre their content.
+ */
+export declare const ALIGNMENT_OPTIONS: readonly ["start", "center"];
+/**
+ * Vertical rhythm options shared by the section-level blocks.
+ */
+export declare const SPACING_OPTIONS: readonly ["none", "xs", "sm", "md", "lg", "xl", "2xl"];
+/**
+ * Background treatments a section-level block can offer.
+ */
+export declare const BACKGROUND_OPTIONS: readonly ["none", "muted", "tinted"];
+/**
+ * Maximum content widths a block can offer.
+ */
+export declare const CONTAINER_SIZE_OPTIONS: readonly ["sm", "md", "lg", "xl", "full"];
+/**
+ * Column counts a grid block can offer.
+ */
+export declare const COLUMNS_OPTIONS: readonly ["1", "2", "3", "4"];
+/**
+ * Button variants a configured action can offer.
+ */
+export declare const ACTION_VARIANT_OPTIONS: readonly ["solid", "faded", "bordered", "ghost"];
+/**
+ * Fields of a configured action.
+ *
+ * The shape matches the framework's `ActionConfig` for the fields a builder can
+ * own: wording, destination and emphasis. An icon, a custom component and a
+ * click handler stay out, because none of them can be serialized.
+ */
+export declare const ACTION_FIELDS: ObjectField<{
+    label: string;
+    href: string;
+    variant: string;
+}>;
+/**
+ * A single feature inside a feature grid.
+ */
+export declare const FEATURE_ITEM_FIELD: ArrayField<Array<{
+    title: string;
+    description: string;
+}>>;
+/**
+ * A plan's feature line.
+ */
+export declare const PRICING_FEATURE_FIELD: ArrayField<Array<{
+    label: string;
+    included: boolean;
+}>>;
+/**
+ * One navigation link.
+ */
+export declare const LINK_ITEM_FIELDS: {
+    label: TextField;
+    href: TextField;
+};
+/**
+ * A testimonial quote.
+ */
+export declare const TESTIMONIAL_ITEM_FIELD: ArrayField<Array<{
+    quote: string;
+    name: string;
+    role: string;
+}>>;
+//# sourceMappingURL=fields.d.ts.map

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/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,4 +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,cAAc,CAAC;AAC7B,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.map

@@ -1 +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,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;AAElF,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,CAAC,cAAc,EAAE,oBAAoB,CA0D5E,CAAC;AAEJ;;;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"}
+{"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/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"}

package/dist/utils/resolve-token.js

@@ -10,7 +10,15 @@ function n(e, t, n, r = "md") {
 	return e ?? t ?? n ?? r;
 }
 function r(e, t, n) {
+	let r = { ...n }, i = t;
+	for (let t of Object.keys(n)) {
+		let a = e[t], o = i?.[t];
+		r[t] = a ?? o ?? n[t];
+	}
+	return r;
+}
+function i(e, t, n) {
 	return t[e] ?? t[n] ?? "";
 }
 //#endregion
-export { t as resolveAnimate, e as resolveCascade, r as resolveClassKey, n as resolveRadiusKey };
+export { t as resolveAnimate, e as resolveCascade, i as resolveClassKey, r as resolveConfigCascade, n as resolveRadiusKey };