asheeui 0.7.0 → 1.1.0

package/dist/components/clipboard/Clipboard.d.ts

@@ -0,0 +1,75 @@
+import { ReactNode } from 'react';
+/**
+ * What a clipboard consumer renders with.
+ */
+export interface ClipboardState {
+    /**
+     * Whether the text is on the clipboard.
+     * It returns to false after the configured timeout.
+     */
+    copied: boolean;
+    /**
+     * Whether the last attempt failed.
+     * A browser refuses clipboard access outside a user gesture or without
+     * permission, which is a state a consumer usually wants to surface.
+     */
+    error: boolean;
+    /**
+     * Copy the component's value, or the given text.
+     *
+     * @param text - Text to copy instead of the component's value.
+     * @returns Whether the copy succeeded.
+     */
+    copy: (text?: string) => Promise<boolean>;
+    /** Clear the copied and error states without copying. */
+    reset: () => void;
+}
+/**
+ * Props for the Clipboard component.
+ */
+export interface ClipboardProps {
+    /** Text copied when `copy` is called without an argument. */
+    value?: string;
+    /**
+     * How long the copied state lasts, in milliseconds.
+     * Defaults to `components.clipboard.timeout`, then to the framework fallback.
+     */
+    timeout?: number;
+    /** Called after a successful copy. */
+    onCopy?: (text: string) => void;
+    /** Called after a failed copy. */
+    onError?: (error: unknown) => void;
+    /** Renders the control, using the clipboard state. */
+    children: (state: ClipboardState) => ReactNode;
+}
+/**
+ * Copies text and reports the result through a render function.
+ *
+ * The copied state is a timer, not a change of value, so this component keeps
+ * one and clears it on unmount. Copying is a user-triggered side effect, so the
+ * component performs no clipboard work during render and renders identically on
+ * the server and the client.
+ *
+ * @param props - The value, the timing and the render function.
+ * @param props.value - Text copied by a bare `copy()` call.
+ * @param props.timeout - How long the copied state lasts.
+ * @param props.onCopy - Called after a successful copy.
+ * @param props.onError - Called after a failed copy.
+ * @param props.children - Renders the control.
+ * @returns The rendered control.
+ *
+ * @example
+ * ```tsx
+ * <Clipboard value={invoice.id}>
+ *   {({ copied, copy }) => (
+ *     <button type="button" onClick={() => copy()}>
+ *       {copied ? "Copied" : "Copy invoice number"}
+ *     </button>
+ *   )}
+ * </Clipboard>
+ * ```
+ *
+ * @see CopyButton - The framework's own copy control.
+ */
+export declare function Clipboard({ value, timeout, onCopy, onError, children, }: ClipboardProps): import("react").JSX.Element;
+//# sourceMappingURL=Clipboard.d.ts.map

package/dist/components/clipboard/Clipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Clipboard.d.ts","sourceRoot":"","sources":["../../../src/components/clipboard/Clipboard.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EACL,KAAK,SAAS,EAKf,MAAM,OAAO,CAAC;AAKf;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;;;OAIG;IACH,KAAK,EAAE,OAAO,CAAC;IAEf;;;;;OAKG;IACH,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAE1C,yDAAyD;IACzD,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,sCAAsC;IACtC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAEhC,kCAAkC;IAClC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAEnC,sDAAsD;IACtD,QAAQ,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,SAAS,CAAC;CAChD;AA0CD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,SAAS,CAAC,EACxB,KAAK,EACL,OAAO,EACP,MAAM,EACN,OAAO,EACP,QAAQ,GACT,EAAE,cAAc,+BAiEhB"}

package/dist/components/clipboard/Clipboard.js

@@ -0,0 +1,53 @@
+"use client";
+"use client";
+import { useAsheeConfig as e } from "../../libs/context.js";
+import { resolveAnimate as t } from "../../utils/resolve-token.js";
+import { FALLBACK_CLIPBOARD_CONFIG as n } from "./clipboard-config.js";
+import { useCallback as r, useEffect as i, useRef as a, useState as o } from "react";
+import { Fragment as s, jsx as c } from "react/jsx-runtime";
+//#region src/components/clipboard/Clipboard.tsx
+async function l(e) {
+	if (typeof navigator < "u" && navigator.clipboard?.writeText) return await navigator.clipboard.writeText(e), !0;
+	if (typeof document > "u") return !1;
+	let t = document.createElement("textarea");
+	t.value = e, t.setAttribute("readonly", ""), t.style.position = "fixed", t.style.opacity = "0";
+	let n = document.activeElement;
+	document.body.appendChild(t), t.select();
+	try {
+		return document.execCommand("copy");
+	} finally {
+		t.remove(), n instanceof HTMLElement && n.focus();
+	}
+}
+function u({ value: u, timeout: d, onCopy: f, onError: p, children: m }) {
+	let h = e(), g = t(d, h.components?.clipboard?.timeout, n.timeout), [_, v] = o(!1), [y, b] = o(!1), x = a(null), S = r(() => {
+		x.current !== null && (clearTimeout(x.current), x.current = null);
+	}, []);
+	i(() => S, [S]);
+	let C = r(() => {
+		S(), v(!1), b(!1);
+	}, [S]), w = r(async (e) => {
+		let t = e ?? u ?? "";
+		try {
+			return await l(t) ? (S(), b(!1), v(!0), f?.(t), x.current = setTimeout(() => {
+				v(!1), x.current = null;
+			}, g), !0) : (S(), b(!0), v(!1), p?.(/* @__PURE__ */ Error("Clipboard access was refused")), !1);
+		} catch (e) {
+			return S(), b(!0), v(!1), p?.(e), !1;
+		}
+	}, [
+		S,
+		f,
+		p,
+		g,
+		u
+	]);
+	return /* @__PURE__ */ c(s, { children: m({
+		copied: _,
+		error: y,
+		copy: w,
+		reset: C
+	}) });
+}
+//#endregion
+export { u as Clipboard };

package/dist/components/clipboard/CopyButton.d.ts

@@ -0,0 +1,64 @@
+import { ReactNode } from 'react';
+import { ButtonProps } from '../button/Button';
+type BaseCopyButtonProps = Omit<ButtonProps, "children" | "startContent" | "endContent" | "onClick" | "onCopy" | "isLoading">;
+/**
+ * Props for the CopyButton component.
+ */
+export interface CopyButtonProps extends BaseCopyButtonProps {
+    /** Text written to the clipboard. */
+    value: string;
+    /** Name of the control. Defaults to `components.clipboard.label`. */
+    label?: ReactNode;
+    /** Name of the control once the text is copied. Defaults to
+     * `components.clipboard.copiedLabel`. */
+    copiedLabel?: ReactNode;
+    /** Announcement made through the status region once the text is copied. */
+    copiedAnnouncement?: string;
+    /**
+     * How long the copied state lasts, in milliseconds.
+     * Defaults to `components.clipboard.timeout`.
+     */
+    timeout?: number;
+    /** Called after a successful copy. */
+    onCopy?: (text: string) => void;
+    /** Called after a failed copy. */
+    onError?: (error: unknown) => void;
+    /** Icon shown before the copy. @default CopyIcon */
+    copyIcon?: ReactNode;
+    /** Icon shown after a successful copy. @default CheckIcon */
+    copiedIcon?: ReactNode;
+}
+/**
+ * A button that copies a value to the clipboard.
+ *
+ * The control reports its result twice: the label changes to the copied wording
+ * and a status region announces the same thing, because a label change alone is
+ * not announced by a screen reader. Focus stays on the button, so a reader can
+ * copy again immediately.
+ *
+ * @param props - CopyButton configuration options and button props.
+ * @param props.value - Text written to the clipboard.
+ * @param props.label - Name of the control before a copy.
+ * @param props.copiedLabel - Name of the control after a copy.
+ * @param props.copiedAnnouncement - Announcement made after a copy.
+ * @param props.timeout - How long the copied state lasts.
+ * @param props.onCopy - Called after a successful copy.
+ * @param props.onError - Called after a failed copy.
+ * @param props.copyIcon - Icon shown before the copy.
+ * @param props.copiedIcon - Icon shown after a copy.
+ * @returns The rendered control and its status region.
+ *
+ * @example
+ * ```tsx
+ * <CopyButton
+ *   value="INV-1042"
+ *   label="Copy invoice number"
+ *   copiedAnnouncement="Invoice number copied"
+ * />
+ * ```
+ *
+ * @see Clipboard - The headless primitive, for a consumer's own control.
+ */
+export declare const CopyButton: import('react').ForwardRefExoticComponent<CopyButtonProps & import('react').RefAttributes<HTMLButtonElement>>;
+export {};
+//# sourceMappingURL=CopyButton.d.ts.map

package/dist/components/clipboard/CopyButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CopyButton.d.ts","sourceRoot":"","sources":["../../../src/components/clipboard/CopyButton.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAKnD,OAAO,EAAU,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAK5D,KAAK,mBAAmB,GAAG,IAAI,CAC7B,WAAW,EACT,UAAU,GACV,cAAc,GACd,YAAY,GACZ,SAAS,GACT,QAAQ,GACR,WAAW,CACd,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,mBAAmB;IAC1D,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IAEd,qEAAqE;IACrE,KAAK,CAAC,EAAE,SAAS,CAAC;IAElB;6CACyC;IACzC,WAAW,CAAC,EAAE,SAAS,CAAC;IAExB,2EAA2E;IAC3E,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,sCAAsC;IACtC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAEhC,kCAAkC;IAClC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAEnC,oDAAoD;IACpD,QAAQ,CAAC,EAAE,SAAS,CAAC;IAErB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,SAAS,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,UAAU,+GAyEtB,CAAC"}

package/dist/components/clipboard/CopyButton.js

@@ -0,0 +1,44 @@
+"use client";
+"use client";
+import { useAsheeConfig as e } from "../../libs/context.js";
+import { resolveCascade as t } from "../../utils/resolve-token.js";
+import { CheckIcon as n } from "../../icons/CheckIcon.js";
+import { Button as r } from "../button/Button.js";
+import { FALLBACK_CLIPBOARD_CONFIG as i } from "./clipboard-config.js";
+import { Clipboard as a } from "./Clipboard.js";
+import { CopyIcon as o } from "../../icons/CopyIcon.js";
+import { CLIPBOARD_STATUS_CLASS as s } from "./clipboard-styles.js";
+import { forwardRef as c } from "react";
+import { Fragment as l, jsx as u, jsxs as d } from "react/jsx-runtime";
+//#region src/components/clipboard/CopyButton.tsx
+var f = c(({ value: c, label: f, copiedLabel: p, copiedAnnouncement: m, timeout: h, onCopy: g, onError: _, copyIcon: v, copiedIcon: y, ...b }, x) => {
+	let S = e().components?.clipboard, C = t(f, S?.label, void 0, i.label), w = t(p, S?.copiedLabel, void 0, i.copiedLabel);
+	return /* @__PURE__ */ u(a, {
+		value: c,
+		timeout: h,
+		onCopy: g,
+		onError: _,
+		children: ({ copied: e, copy: t }) => /* @__PURE__ */ d(l, { children: [/* @__PURE__ */ u(r, {
+			ref: x,
+			type: "button",
+			variant: b.variant ?? S?.variant ?? void 0,
+			color: b.color ?? S?.color ?? void 0,
+			size: b.size ?? S?.size ?? void 0,
+			startContent: e ? y ?? /* @__PURE__ */ u(n, {}) : v ?? /* @__PURE__ */ u(o, {}),
+			onClick: () => {
+				t();
+			},
+			...b,
+			children: e ? w : C
+		}), /* @__PURE__ */ u("span", {
+			role: "status",
+			"aria-live": "polite",
+			className: s,
+			"data-copied": e ? "true" : void 0,
+			children: e ? m ?? `${String(w)}: ${c}` : ""
+		})] })
+	});
+});
+f.displayName = "CopyButton";
+//#endregion
+export { f as CopyButton };

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

@@ -0,0 +1,42 @@
+import { Color, Radius, Size, Variant } from '../../shared';
+/**
+ * Theme configuration options for the clipboard components.
+ *
+ * Set under `components.clipboard` in the AsheeUI config. Values feed the
+ * component-level fallback tier of the theme cascade.
+ */
+export interface ClipboardConfig {
+    /**
+     * How long the copied state lasts, in milliseconds.
+     *
+     * @default 2000
+     */
+    timeout?: number;
+    /** Name of the copy control. @default "Copy" */
+    label?: string;
+    /** Name of the copy control once the text is on the clipboard.
+     * @default "Copied" */
+    copiedLabel?: string;
+    /** Visual style of the copy control. @default "bordered" */
+    variant?: Variant;
+    /** Accent colour of the copy control. @default "primary" */
+    color?: Color;
+    /** Density of the copy control. @default "sm" */
+    size?: Size;
+    /** Corner rounding of the copy control. Defaults to the framework radius. */
+    radius?: Radius;
+}
+/**
+ * Default config values registered for the clipboard components.
+ */
+export declare const defaultClipboardConfig: ClipboardConfig;
+declare module "../../libs/registry" {
+    interface ComponentTypeConfigRegistry {
+        clipboard: ClipboardConfig;
+    }
+}
+/**
+ * Hard fallback values used when no config tier provides a value.
+ */
+export declare const FALLBACK_CLIPBOARD_CONFIG: Required<ClipboardConfig>;
+//# sourceMappingURL=clipboard-config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard-config.d.ts","sourceRoot":"","sources":["../../../src/components/clipboard/clipboard-config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEjE;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;2BACuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,KAAK,CAAC;IAEd,iDAAiD;IACjD,IAAI,CAAC,EAAE,IAAI,CAAC;IAEZ,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,eAOpC,CAAC;AAEF,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,SAAS,EAAE,eAAe,CAAC;KAC5B;CACF;AAID;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,QAAQ,CAAC,eAAe,CAQ/D,CAAC"}

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

@@ -0,0 +1,23 @@
+"use client";
+import { registerComponentDefaults as e } from "../../libs/registry.js";
+//#region src/components/clipboard/clipboard-config.ts
+var t = {
+	timeout: 2e3,
+	label: "Copy",
+	copiedLabel: "Copied",
+	variant: "bordered",
+	color: "primary",
+	size: "sm"
+};
+e("clipboard", t);
+var n = {
+	timeout: 2e3,
+	label: "Copy",
+	copiedLabel: "Copied",
+	variant: "bordered",
+	color: "primary",
+	size: "sm",
+	radius: "sm"
+};
+//#endregion
+export { n as FALLBACK_CLIPBOARD_CONFIG, t as defaultClipboardConfig };

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

@@ -0,0 +1,11 @@
+/**
+ * Clipboard component styles for AsheeUI.
+ * This file provides the static class mappings for the clipboard pair.
+ */
+/**
+ * The status region a copy control announces its result through.
+ * It is visually hidden and stays in the document, so the change is announced
+ * without moving the reader's focus off the control they pressed.
+ */
+export declare const CLIPBOARD_STATUS_CLASS = "sr-only";
+//# sourceMappingURL=clipboard-styles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard-styles.d.ts","sourceRoot":"","sources":["../../../src/components/clipboard/clipboard-styles.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,YAAY,CAAC"}

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

@@ -0,0 +1,5 @@
+"use client";
+//#region src/components/clipboard/clipboard-styles.ts
+var e = "sr-only";
+//#endregion
+export { e as CLIPBOARD_STATUS_CLASS };

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

@@ -0,0 +1,4 @@
+export * from './Clipboard';
+export * from './CopyButton';
+export * from './clipboard-config';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/clipboard/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC"}

package/dist/components/clipboard/index.js

@@ -0,0 +1,4 @@
+export * from "./Clipboard.js";
+export * from "./CopyButton.js";
+export * from "./clipboard-config.js";
+export * from "./clipboard-styles.js";

package/dist/components/container/Container.d.ts

@@ -0,0 +1,51 @@
+import { ElementType, HTMLAttributes } from 'react';
+import { ContainerConfig, ContainerSize } from './container-config';
+type BaseContainerProps = ContainerConfig & Omit<HTMLAttributes<HTMLDivElement>, "color">;
+/**
+ * Props for the Container component.
+ */
+export interface ContainerProps extends BaseContainerProps {
+    /**
+     * Element to render.
+     * Defaults to a `div`.
+     *
+     * @default "div"
+     */
+    as?: ElementType;
+    /**
+     * Maximum content width.
+     * Resolved through the standard cascade: prop, then
+     * `components.container.size`, then the framework fallback.
+     *
+     * @default "lg"
+     */
+    size?: ContainerSize;
+}
+/**
+ * A centred content column with a maximum width.
+ *
+ * Container adds the three things a page needs from its outermost layout
+ * element and nothing else: a maximum width, a responsive gutter and horizontal
+ * centring. It carries no background and no vertical rhythm, so a `Section` can
+ * add those without the two fighting over the same properties.
+ *
+ * @param props - Container configuration options and element attributes.
+ * @param props.size - Maximum content width. Defaults to "lg".
+ * @param props.gutter - Reserve a horizontal gutter. Defaults to true.
+ * @param props.centered - Centre the content. Defaults to true.
+ * @param props.as - Element to render. Defaults to "div".
+ * @returns The rendered container.
+ *
+ * @example
+ * ```tsx
+ * <Container size="sm">
+ *   <Typography role="body-md">A single reading column.</Typography>
+ * </Container>
+ * ```
+ *
+ * @see Section - Adds vertical rhythm and a background around a container.
+ * @see PageContent - The application-page equivalent.
+ */
+export declare const Container: import('react').ForwardRefExoticComponent<ContainerProps & import('react').RefAttributes<HTMLDivElement>>;
+export {};
+//# sourceMappingURL=Container.d.ts.map

package/dist/components/container/Container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Container.d.ts","sourceRoot":"","sources":["../../../src/components/container/Container.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,KAAK,WAAW,EAAc,KAAK,cAAc,EAAE,MAAM,OAAO,CAAC;AAI1E,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,aAAa,EAEnB,MAAM,oBAAoB,CAAC;AAO5B,KAAK,kBAAkB,GAAG,eAAe,GACvC,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,kBAAkB;IACxD;;;;;OAKG;IACH,EAAE,CAAC,EAAE,WAAW,CAAC;IAEjB;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,aAAa,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,SAAS,2GA0CrB,CAAC"}

package/dist/components/container/Container.js

@@ -0,0 +1,21 @@
+"use client";
+"use client";
+import { cn as e } from "../../utils/cn.js";
+import { useAsheeConfig as t } from "../../libs/context.js";
+import { resolveCascade as n } from "../../utils/resolve-token.js";
+import { FALLBACK_CONTAINER_CONFIG as r } from "./container-config.js";
+import { CONTAINER_BASE_CLASS as i, CONTAINER_GUTTER_CLASS as a, CONTAINER_MAX_WIDTH_CLASS as o } from "./container-styles.js";
+import { forwardRef as s } from "react";
+import { jsx as c } from "react/jsx-runtime";
+//#region src/components/container/Container.tsx
+var l = s(({ as: s, size: l, gutter: u, centered: d, className: f, ...p }, m) => {
+	let h = t().components?.container, g = n(l, h?.size, void 0, r.size), _ = n(u, h?.gutter, void 0, r.gutter), v = n(d, h?.centered, void 0, r.centered);
+	return /* @__PURE__ */ c(s ?? "div", {
+		ref: m,
+		className: e(i, o[g], v && "mx-auto", _ && a, f),
+		...p
+	});
+});
+l.displayName = "Container";
+//#endregion
+export { l as Container };

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

@@ -0,0 +1,61 @@
+/**
+ * Container component configuration for AsheeUI.
+ * This file defines the configuration type and defaults for the Container
+ * layout primitive, including its maximum width, gutter and centring
+ * behaviour. It registers the default configuration with the component
+ * registry and provides fallback values for the cascade resolution system.
+ */
+/**
+ * Maximum content width of a container.
+ *
+ * - `sm`: a single reading column.
+ * - `md`: a narrow application or form column.
+ * - `lg`: the default content width.
+ * - `xl`: a wide application shell.
+ * - `full`: no maximum width.
+ */
+export type ContainerSize = "sm" | "md" | "lg" | "xl" | "full";
+/**
+ * Theme configuration options for the Container component.
+ *
+ * Set under `components.container` in the AsheeUI config. Values feed the
+ * component-level fallback tier of the theme cascade.
+ */
+export interface ContainerConfig {
+    /**
+     * Maximum content width.
+     *
+     * @default "lg"
+     */
+    size?: ContainerSize;
+    /**
+     * Whether to reserve a horizontal gutter.
+     * The gutter widens with the viewport, so content never touches the edge on
+     * a phone and never stretches to the full screen on a desktop.
+     *
+     * @default true
+     */
+    gutter?: boolean;
+    /**
+     * Whether to centre the content horizontally.
+     * Leave this on unless the container is nested in another centring
+     * element that already does it.
+     *
+     * @default true
+     */
+    centered?: boolean;
+}
+/**
+ * Default config values registered for the Container component.
+ */
+export declare const defaultContainerConfig: ContainerConfig;
+declare module "../../libs/registry" {
+    interface ComponentTypeConfigRegistry {
+        container: ContainerConfig;
+    }
+}
+/**
+ * Hard fallback values used when no config tier provides a value.
+ */
+export declare const FALLBACK_CONTAINER_CONFIG: Required<ContainerConfig>;
+//# sourceMappingURL=container-config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"container-config.d.ts","sourceRoot":"","sources":["../../../src/components/container/container-config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;;;;;GAQG;AACH,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,IAAI,CAAC,EAAE,aAAa,CAAC;IAErB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,eAIpC,CAAC;AAEF,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,SAAS,EAAE,eAAe,CAAC;KAC5B;CACF;AAID;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,QAAQ,CAAC,eAAe,CAI/D,CAAC"}

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

@@ -0,0 +1,16 @@
+"use client";
+import { registerComponentDefaults as e } from "../../libs/registry.js";
+//#region src/components/container/container-config.ts
+var t = {
+	size: "lg",
+	gutter: !0,
+	centered: !0
+};
+e("container", t);
+var n = {
+	size: "lg",
+	gutter: !0,
+	centered: !0
+};
+//#endregion
+export { n as FALLBACK_CONTAINER_CONFIG, t as defaultContainerConfig };

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

@@ -0,0 +1,18 @@
+import { ContainerSize } from './container-config';
+/**
+ * Maximum width class for each container size.
+ * The classes are complete literals so Tailwind can see them.
+ */
+export declare const CONTAINER_MAX_WIDTH_CLASS: Record<ContainerSize, string>;
+/**
+ * Shared base classes for every container.
+ * The container is a block element that never exceeds its parent.
+ */
+export declare const CONTAINER_BASE_CLASS = "w-full";
+/**
+ * Horizontal gutter applied when the gutter is enabled.
+ * The scale token is the layout gutter of the framework, so a container and a
+ * section align on the same edge.
+ */
+export declare const CONTAINER_GUTTER_CLASS: string;
+//# sourceMappingURL=container-styles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"container-styles.d.ts","sourceRoot":"","sources":["../../../src/components/container/container-styles.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAMnE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,WAAW,CAAC;AAE7C;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,QAA2B,CAAC"}

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

@@ -0,0 +1,12 @@
+"use client";
+import { SPACE_PADDING_X_CLASS as e } from "../../shared/spacing.js";
+//#region src/components/container/container-styles.ts
+var t = {
+	sm: "max-w-2xl",
+	md: "max-w-4xl",
+	lg: "max-w-6xl",
+	xl: "max-w-7xl",
+	full: "max-w-none"
+}, n = "w-full", r = e.lg;
+//#endregion
+export { n as CONTAINER_BASE_CLASS, r as CONTAINER_GUTTER_CLASS, t as CONTAINER_MAX_WIDTH_CLASS };

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/container/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC"}

package/dist/components/container/index.js

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

package/dist/components/cta/CTA.d.ts

@@ -0,0 +1,81 @@
+import { ElementType, HTMLAttributes, ReactNode } from 'react';
+import { ActionConfig } from '../../shared';
+import { CtaConfig } from './cta-config';
+type BaseCtaProps = CtaConfig & Omit<HTMLAttributes<HTMLElement>, "color" | "title">;
+/**
+ * Props for the CTA component.
+ */
+export interface CtaProps extends BaseCtaProps {
+    /**
+     * Short label above the title.
+     */
+    eyebrow?: ReactNode;
+    /**
+     * The headline of the band.
+     */
+    title: ReactNode;
+    /**
+     * Supporting sentence under the headline.
+     */
+    description?: ReactNode;
+    /**
+     * The emphasised action of the band.
+     */
+    primaryAction?: ActionConfig;
+    /**
+     * The supporting action of the band.
+     */
+    secondaryAction?: ActionConfig;
+    /**
+     * Element to render the band as.
+     * Defaults to `section`.
+     *
+     * @default "section"
+     */
+    as?: ElementType;
+    /**
+     * Content below the actions, for example a small print line.
+     */
+    children?: ReactNode;
+}
+/**
+ * A closing call to action.
+ *
+ * CTA is the band a page ends on: one statement, one or two actions, and
+ * optionally a panel that lifts it off the page. It deliberately does not own a
+ * form: a consumer that wants an email field in the band places its own controls
+ * through `children`, so the framework never couples a layout pattern to an
+ * application's subscription flow.
+ *
+ * @param props - CTA configuration options and element attributes.
+ * @param props.title - The headline of the band.
+ * @param props.eyebrow - Short label above the headline.
+ * @param props.description - Supporting sentence under the headline.
+ * @param props.primaryAction - The emphasised action.
+ * @param props.secondaryAction - The supporting action.
+ * @param props.align - Content alignment. Defaults to "center".
+ * @param props.spacing - Vertical padding. Defaults to "lg".
+ * @param props.background - Background treatment. Defaults to "none".
+ * @param props.panel - Panel treatment. Defaults to "bordered".
+ * @param props.containerSize - Maximum content width. Defaults to "lg".
+ * @param props.contained - Respect the framework's width and gutter.
+ * Defaults to true.
+ * @param props.as - Element to render. Defaults to "section".
+ * @returns The rendered band.
+ *
+ * @example
+ * ```tsx
+ * <CTA
+ *   eyebrow="Ready when you are"
+ *   title="Send your first campaign today"
+ *   description="No card required, and no setup call."
+ *   primaryAction={{ label: "Create an account", href: "/signup" }}
+ *   secondaryAction={{ label: "Talk to sales", href: "/contact", variant: "ghost" }}
+ * />
+ * ```
+ *
+ * @see Hero - The leading band of the same page.
+ */
+export declare const CTA: import('react').ForwardRefExoticComponent<CtaProps & import('react').RefAttributes<HTMLElement>>;
+export {};
+//# sourceMappingURL=CTA.d.ts.map

package/dist/components/cta/CTA.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CTA.d.ts","sourceRoot":"","sources":["../../../src/components/cta/CTA.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EACL,KAAK,WAAW,EAEhB,KAAK,cAAc,EACnB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAOjD,OAAO,EAAE,KAAK,SAAS,EAAuB,MAAM,cAAc,CAAC;AAOnE,KAAK,YAAY,GAAG,SAAS,GAC3B,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,QAAS,SAAQ,YAAY;IAC5C;;OAEG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;IAEpB;;OAEG;IACH,KAAK,EAAE,SAAS,CAAC;IAEjB;;OAEG;IACH,WAAW,CAAC,EAAE,SAAS,CAAC;IAExB;;OAEG;IACH,aAAa,CAAC,EAAE,YAAY,CAAC;IAE7B;;OAEG;IACH,eAAe,CAAC,EAAE,YAAY,CAAC;IAE/B;;;;;OAKG;IACH,EAAE,CAAC,EAAE,WAAW,CAAC;IAEjB;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,eAAO,MAAM,GAAG,kGAsEf,CAAC"}