asheeui 1.1.0 → 2.0.0

package/dist/components/docs-layout/docs-layout-styles.d.ts

@@ -0,0 +1,31 @@
+/**
+ * DocsLayout component styles for AsheeUI.
+ * This file provides the static class mappings for the documentation
+ * composition: the page shell, the article column, the table of contents column
+ * and the article body's reading measure.
+ */
+/**
+ * The page shell.
+ * It wraps the application shell rather than replacing it, so the skip link can
+ * be the first focusable element of the page.
+ */
+export declare const DOCS_LAYOUT_CLASS = "flex min-h-dvh w-full flex-col bg-background";
+/** The application shell inside the page shell. */
+export declare const DOCS_LAYOUT_SHELL_CLASS = "flex-1";
+/**
+ * The article column.
+ * It is the region the skip link leads to, so it takes focus when the link is
+ * followed.
+ */
+export declare const DOCS_LAYOUT_ARTICLE_CLASS = "flex w-full min-w-0 flex-col";
+/**
+ * The reading measure of the article body.
+ * A documentation page is read rather than scanned, so the body keeps a readable
+ * line length while the columns around it may be wider.
+ */
+export declare const DOCS_LAYOUT_BODY_CLASS = "flex flex-col gap-6 max-w-3xl";
+/** The table of contents column. */
+export declare const DOCS_LAYOUT_TOC_CLASS = "hidden w-full xl:block xl:w-64 xl:shrink-0";
+/** Keeps the table of contents in view while the article scrolls. */
+export declare const DOCS_LAYOUT_TOC_STICKY_CLASS = "xl:sticky xl:top-0 xl:self-start";
+//# sourceMappingURL=docs-layout-styles.d.ts.map

package/dist/components/docs-layout/docs-layout-styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-layout-styles.d.ts","sourceRoot":"","sources":["../../../src/components/docs-layout/docs-layout-styles.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,iDAAiD,CAAC;AAEhF,mDAAmD;AACnD,eAAO,MAAM,uBAAuB,WAAW,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,iCAAiC,CAAC;AAExE;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,kCAAkC,CAAC;AAEtE,oCAAoC;AACpC,eAAO,MAAM,qBAAqB,+CACY,CAAC;AAE/C,qEAAqE;AACrE,eAAO,MAAM,4BAA4B,qCAAqC,CAAC"}

package/dist/components/docs-layout/docs-layout-styles.js

@@ -0,0 +1,5 @@
+"use client";
+//#region src/components/docs-layout/docs-layout-styles.ts
+var e = "flex min-h-dvh w-full flex-col bg-background", t = "flex-1", n = "flex w-full min-w-0 flex-col", r = "flex flex-col gap-6 max-w-3xl", i = "hidden w-full xl:block xl:w-64 xl:shrink-0", a = "xl:sticky xl:top-0 xl:self-start";
+//#endregion
+export { n as DOCS_LAYOUT_ARTICLE_CLASS, r as DOCS_LAYOUT_BODY_CLASS, e as DOCS_LAYOUT_CLASS, t as DOCS_LAYOUT_SHELL_CLASS, i as DOCS_LAYOUT_TOC_CLASS, a as DOCS_LAYOUT_TOC_STICKY_CLASS };

package/dist/components/docs-layout/index.d.ts

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

package/dist/components/docs-layout/index.d.ts.map

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

package/dist/components/docs-layout/index.js

@@ -0,0 +1,3 @@
+export * from "./DocsLayout.js";
+export * from "./docs-layout-config.js";
+export * from "./docs-layout-styles.js";

package/dist/components/empty-state/EmptyState.d.ts

@@ -30,6 +30,13 @@ export interface EmptyStateProps extends BaseEmptyStateProps {
      * @default "div"
      */
     as?: ElementType;
+    /**
+     * Actions that carry a React handler.
+     * A configured action describes a destination rather than a callback, so an
+     * action that runs one (a retry, a dismissal) is passed here and rendered in
+     * the same group as the configured actions.
+     */
+    actions?: ReactNode;
     /** Content below the actions. */
     children?: ReactNode;
 }
@@ -65,10 +72,21 @@ export interface EmptyStateProps extends BaseEmptyStateProps {
  *   icon={<SearchIcon />}
  *   title="No campaigns match that filter"
  *   description="Try a different name, or clear the filter to see everything."
- *   primaryAction={{ label: "Clear filters", onClick: clearFilters }}
+ *   primaryAction={{ label: "See all campaigns", href: "/campaigns" }}
  * />
  * ```
  *
+ * A configured action describes a destination, so an action that runs a handler
+ * is passed as a child instead:
+ *
+ * ```tsx
+ * <EmptyState title="No campaigns match that filter">
+ *   <Button variant="solid" onClick={clearFilters}>
+ *     Clear filters
+ *   </Button>
+ * </EmptyState>
+ * ```
+ *
  * @see Skeleton - The loading presentation of the same region.
  * @see Alert - An inline message that is not a whole region.
  */

package/dist/components/empty-state/EmptyState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EmptyState.d.ts","sourceRoot":"","sources":["../../../src/components/empty-state/EmptyState.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EACL,KAAK,WAAW,EAEhB,KAAK,cAAc,EACnB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAKjD,OAAO,EACL,KAAK,gBAAgB,EAEtB,MAAM,sBAAsB,CAAC;AAS9B,KAAK,mBAAmB,GAAG,gBAAgB,GACzC,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,mBAAmB;IAC1D,kCAAkC;IAClC,IAAI,CAAC,EAAE,SAAS,CAAC;IAEjB,6DAA6D;IAC7D,KAAK,EAAE,SAAS,CAAC;IAEjB,uCAAuC;IACvC,WAAW,CAAC,EAAE,SAAS,CAAC;IAExB,8EAA8E;IAC9E,aAAa,CAAC,EAAE,YAAY,CAAC;IAE7B,oEAAoE;IACpE,eAAe,CAAC,EAAE,YAAY,CAAC;IAE/B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAE1B;;;;;OAKG;IACH,EAAE,CAAC,EAAE,WAAW,CAAC;IAEjB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,eAAO,MAAM,UAAU,4GAsEtB,CAAC"}
+{"version":3,"file":"EmptyState.d.ts","sourceRoot":"","sources":["../../../src/components/empty-state/EmptyState.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EACL,KAAK,WAAW,EAEhB,KAAK,cAAc,EACnB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAKjD,OAAO,EACL,KAAK,gBAAgB,EAEtB,MAAM,sBAAsB,CAAC;AAS9B,KAAK,mBAAmB,GAAG,gBAAgB,GACzC,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,mBAAmB;IAC1D,kCAAkC;IAClC,IAAI,CAAC,EAAE,SAAS,CAAC;IAEjB,6DAA6D;IAC7D,KAAK,EAAE,SAAS,CAAC;IAEjB,uCAAuC;IACvC,WAAW,CAAC,EAAE,SAAS,CAAC;IAExB,8EAA8E;IAC9E,aAAa,CAAC,EAAE,YAAY,CAAC;IAE7B,oEAAoE;IACpE,eAAe,CAAC,EAAE,YAAY,CAAC;IAE/B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAE1B;;;;;OAKG;IACH,EAAE,CAAC,EAAE,WAAW,CAAC;IAEjB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;IAEpB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,eAAO,MAAM,UAAU,4GAwEtB,CAAC"}

package/dist/components/empty-state/EmptyState.js

@@ -10,20 +10,20 @@ import { EMPTY_STATE_CLASS as o, EMPTY_STATE_ICON_CLASS as s, EMPTY_STATE_ICON_S
 import { forwardRef as u } from "react";
 import { jsx as d, jsxs as f } from "react/jsx-runtime";
 //#region src/components/empty-state/EmptyState.tsx
-var p = u(({ icon: u, title: p, description: m, primaryAction: h, secondaryAction: g, type: _, size: v, panel: y, role: b, as: x, className: S, children: C, ...w }, T) => {
-	let E = t(), D = n({
+var p = u(({ icon: u, title: p, description: m, primaryAction: h, secondaryAction: g, type: _, size: v, panel: y, role: b, as: x, className: S, actions: C, children: w, ...T }, E) => {
+	let D = t(), O = n({
 		type: _,
 		size: v,
 		panel: y
-	}, E.components?.emptystate, a);
+	}, D.components?.emptystate, a);
 	return /* @__PURE__ */ f(x ?? "div", {
-		ref: T,
+		ref: E,
 		role: b,
-		className: e(o, l[D.size], D.panel && "rounded-md border border-border bg-background", S),
-		...w,
+		className: e(o, l[O.size], O.panel && "rounded-md border border-border bg-background", S),
+		...T,
 		children: [
 			u && /* @__PURE__ */ d("div", {
-				className: e(s[D.type], c[D.size]),
+				className: e(s[O.type], c[O.size]),
 				children: u
 			}),
 			/* @__PURE__ */ d(r, {
@@ -35,9 +35,10 @@ var p = u(({ icon: u, title: p, description: m, primaryAction: h, secondaryActio
 			/* @__PURE__ */ d(i, {
 				primaryAction: h,
 				secondaryAction: g,
-				align: "center"
+				align: "center",
+				children: C
 			}),
-			C
+			w
 		]
 	});
 });

package/dist/components/error-state/ErrorState.d.ts

@@ -0,0 +1,98 @@
+import { ElementType, HTMLAttributes, ReactNode } from 'react';
+import { ActionConfig } from '../../shared';
+import { ErrorStateConfig } from './error-state-config';
+type BaseErrorStateProps = ErrorStateConfig & Omit<HTMLAttributes<HTMLDivElement>, "color" | "title">;
+/**
+ * Props for the ErrorState component.
+ */
+export interface ErrorStateProps extends BaseErrorStateProps {
+    /**
+     * What failed, in the reader's terms.
+     */
+    title: ReactNode;
+    /**
+     * What the reader can do about it.
+     */
+    description?: ReactNode;
+    /**
+     * The technical detail, typically the message a request returned.
+     * It is rendered inside a disclosure rather than in the open, because it is
+     * written for a developer rather than for the reader.
+     */
+    detail?: ReactNode;
+    /**
+     * Called when the reader asks to try again.
+     * Its presence is what renders the retry control.
+     */
+    onRetry?: () => void;
+    /**
+     * The emphasised action, when the way out is a destination rather than a
+     * retry.
+     */
+    primaryAction?: ActionConfig;
+    /**
+     * The supporting action.
+     */
+    secondaryAction?: ActionConfig;
+    /**
+     * Icon shown above the title.
+     * Defaults to the framework's error icon.
+     */
+    icon?: ReactNode;
+    /**
+     * Element to render.
+     * Defaults to a `div`.
+     *
+     * @default "div"
+     */
+    as?: ElementType;
+    /**
+     * Content below the actions.
+     */
+    children?: ReactNode;
+}
+/**
+ * A region whose content could not be loaded.
+ *
+ * The state is an `alert` by default, because it usually replaces content after
+ * a request failed and therefore has to be announced. A state that is part of
+ * the page from the start, such as a not-found page, passes `role="none"` so it
+ * is not announced as a change that just happened.
+ *
+ * A retry is a React handler rather than a configured action, because a
+ * configured action describes a destination. It is rendered in the same group as
+ * any configured actions, so the two arrangements agree.
+ *
+ * @param props - ErrorState configuration options and element attributes.
+ * @param props.title - What failed.
+ * @param props.description - What the reader can do about it.
+ * @param props.detail - The technical message, inside a disclosure.
+ * @param props.onRetry - Called when the reader asks to try again.
+ * @param props.primaryAction - The emphasised action.
+ * @param props.secondaryAction - The supporting action.
+ * @param props.size - Density. Defaults to "md".
+ * @param props.panel - Draw the state as a panel. Defaults to true.
+ * @param props.role - How the state is announced. Defaults to "alert".
+ * @param props.retryLabel - Wording of the retry control. Defaults to "Try
+ * again".
+ * @param props.detailLabel - Wording of the disclosure. Defaults to "Technical
+ * details".
+ * @param props.as - Element to render. Defaults to "div".
+ * @returns The rendered state.
+ *
+ * @example
+ * ```tsx
+ * <ErrorState
+ *   title="Invoices could not be loaded"
+ *   description="The request timed out. Trying again usually works."
+ *   detail={error.message}
+ *   onRetry={refetch}
+ * />
+ * ```
+ *
+ * @see EmptyState - The presentation for a region that has nothing in it.
+ * @see LoadingState - The presentation for a region that has not arrived yet.
+ */
+export declare const ErrorState: import('react').ForwardRefExoticComponent<ErrorStateProps & import('react').RefAttributes<HTMLDivElement>>;
+export {};
+//# sourceMappingURL=ErrorState.d.ts.map

package/dist/components/error-state/ErrorState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorState.d.ts","sourceRoot":"","sources":["../../../src/components/error-state/ErrorState.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EACL,KAAK,WAAW,EAEhB,KAAK,cAAc,EACnB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAGf,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAIjD,OAAO,EACL,KAAK,gBAAgB,EAEtB,MAAM,sBAAsB,CAAC;AAO9B,KAAK,mBAAmB,GAAG,gBAAgB,GACzC,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,mBAAmB;IAC1D;;OAEG;IACH,KAAK,EAAE,SAAS,CAAC;IAEjB;;OAEG;IACH,WAAW,CAAC,EAAE,SAAS,CAAC;IAExB;;;;OAIG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;IAEnB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAErB;;;OAGG;IACH,aAAa,CAAC,EAAE,YAAY,CAAC;IAE7B;;OAEG;IACH,eAAe,CAAC,EAAE,YAAY,CAAC;IAE/B;;;OAGG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;IAEjB;;;;;OAKG;IACH,EAAE,CAAC,EAAE,WAAW,CAAC;IAEjB;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,eAAO,MAAM,UAAU,4GAwEtB,CAAC"}

package/dist/components/error-state/ErrorState.js

@@ -0,0 +1,57 @@
+"use client";
+"use client";
+import { useAsheeConfig as e } from "../../libs/context.js";
+import { resolveConfigCascade as t } from "../../utils/resolve-token.js";
+import { ErrorIcon as n } from "../../icons/ErrorIcon.js";
+import { Button as r } from "../button/Button.js";
+import { EmptyState as i } from "../empty-state/EmptyState.js";
+import { FALLBACK_ERROR_STATE_CONFIG as a } from "./error-state-config.js";
+import "./error-state-styles.js";
+import { forwardRef as o } from "react";
+import { jsx as s, jsxs as c } from "react/jsx-runtime";
+//#region src/components/error-state/ErrorState.tsx
+var l = o(({ title: o, description: l, detail: u, onRetry: d, primaryAction: f, secondaryAction: p, icon: m, size: h, panel: g, role: _, retryLabel: v, detailLabel: y, as: b, className: x, children: S, ...C }, w) => {
+	let T = e(), E = t({
+		size: h,
+		panel: g,
+		role: _,
+		retryLabel: v,
+		detailLabel: y
+	}, T.components?.errorstate, a);
+	return /* @__PURE__ */ c(i, {
+		...C,
+		ref: w,
+		as: b,
+		className: x,
+		type: "error",
+		size: E.size,
+		panel: E.panel,
+		role: E.role === "none" ? void 0 : E.role,
+		icon: m ?? /* @__PURE__ */ s(n, {}),
+		title: o,
+		description: l,
+		primaryAction: f,
+		secondaryAction: p,
+		actions: d ? /* @__PURE__ */ s(r, {
+			type: "button",
+			variant: "solid",
+			color: "danger",
+			size: E.size,
+			onClick: d,
+			children: E.retryLabel
+		}) : void 0,
+		children: [u && /* @__PURE__ */ c("details", {
+			className: "w-full max-w-2xl text-left text-sm text-foreground/70",
+			children: [/* @__PURE__ */ s("summary", {
+				className: "cursor-pointer font-medium text-foreground",
+				children: E.detailLabel
+			}), /* @__PURE__ */ s("div", {
+				className: "mt-2 overflow-x-auto rounded-md border border-border bg-background p-3 font-mono text-xs",
+				children: u
+			})]
+		}), S]
+	});
+});
+l.displayName = "ErrorState";
+//#endregion
+export { l as ErrorState };

package/dist/components/error-state/error-state-config.d.ts

@@ -0,0 +1,66 @@
+import { Size } from '../../shared';
+/**
+ * How the failed region announces itself.
+ *
+ * - `alert`: it is announced as soon as it appears, which is right when it
+ *   replaces content after a request failed.
+ * - `status`: it is announced politely, which is right when the failure is not
+ *   the result of the reader's last action.
+ * - `none`: it is not announced, which is right when it is part of the page's
+ *   initial markup, such as a not-found page.
+ */
+export type ErrorStateRole = "alert" | "status" | "none";
+/**
+ * Theme configuration options for the ErrorState component.
+ *
+ * Set under `components.errorstate` in the AsheeUI config. Values feed the
+ * component-level tier of the theme cascade.
+ */
+export interface ErrorStateConfig {
+    /**
+     * Density of the state.
+     *
+     * @default "md"
+     */
+    size?: Size;
+    /**
+     * Whether the state is drawn as a panel.
+     *
+     * @default true
+     */
+    panel?: boolean;
+    /**
+     * How the state is announced.
+     *
+     * @default "alert"
+     */
+    role?: ErrorStateRole;
+    /**
+     * Wording of the retry control.
+     *
+     * @default "Try again"
+     */
+    retryLabel?: string;
+    /**
+     * Wording of the disclosure that holds the technical detail.
+     *
+     * @default "Technical details"
+     */
+    detailLabel?: string;
+}
+/**
+ * Default config values registered for the ErrorState component.
+ * A panel and an announcement are the defaults because this state usually
+ * replaces a region after a request failed.
+ */
+export declare const defaultErrorStateConfig: ErrorStateConfig;
+declare module "../../libs/registry" {
+    interface ComponentTypeConfigRegistry {
+        errorstate: ErrorStateConfig;
+    }
+}
+/**
+ * Hard fallback values used when no config tier provides a value.
+ */
+export declare const FALLBACK_ERROR_STATE_CONFIG: Required<ErrorStateConfig>;
+//# sourceMappingURL=error-state-config.d.ts.map

package/dist/components/error-state/error-state-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-state-config.d.ts","sourceRoot":"","sources":["../../../src/components/error-state/error-state-config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC;;;;;;;;;GASG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;IAEZ;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;;OAIG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;IAEtB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,EAAE,gBAMrC,CAAC;AAEF,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,UAAU,EAAE,gBAAgB,CAAC;KAC9B;CACF;AAID;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,QAAQ,CAAC,gBAAgB,CAMlE,CAAC"}

package/dist/components/error-state/error-state-config.js

@@ -0,0 +1,20 @@
+"use client";
+import { registerComponentDefaults as e } from "../../libs/registry.js";
+//#region src/components/error-state/error-state-config.ts
+var t = {
+	size: "md",
+	panel: !0,
+	role: "alert",
+	retryLabel: "Try again",
+	detailLabel: "Technical details"
+};
+e("errorstate", t);
+var n = {
+	size: "md",
+	panel: !0,
+	role: "alert",
+	retryLabel: "Try again",
+	detailLabel: "Technical details"
+};
+//#endregion
+export { n as FALLBACK_ERROR_STATE_CONFIG, t as defaultErrorStateConfig };

package/dist/components/error-state/error-state-styles.d.ts

@@ -0,0 +1,17 @@
+/**
+ * ErrorState component styles for AsheeUI.
+ * This file provides the static class mappings for the failed-region
+ * presentation: the disclosure that holds the technical detail and its body.
+ */
+/**
+ * The disclosure.
+ * It is the platform's own `details` element rather than a framework component,
+ * because a detail a reader opens has to work when scripting is unavailable, and
+ * because it is not application state.
+ */
+export declare const ERROR_STATE_DETAIL_CLASS = "w-full max-w-2xl text-left text-sm text-foreground/70";
+/** The summary a reader activates to open the detail. */
+export declare const ERROR_STATE_DETAIL_SUMMARY_CLASS = "cursor-pointer font-medium text-foreground";
+/** The detail body, which keeps the technical text as it was written. */
+export declare const ERROR_STATE_DETAIL_BODY_CLASS = "mt-2 overflow-x-auto rounded-md border border-border bg-background p-3 font-mono text-xs";
+//# sourceMappingURL=error-state-styles.d.ts.map

package/dist/components/error-state/error-state-styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-state-styles.d.ts","sourceRoot":"","sources":["../../../src/components/error-state/error-state-styles.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,0DACoB,CAAC;AAE1D,yDAAyD;AACzD,eAAO,MAAM,gCAAgC,+CACC,CAAC;AAE/C,yEAAyE;AACzE,eAAO,MAAM,6BAA6B,6FACkD,CAAC"}

package/dist/components/error-state/error-state-styles.js

@@ -0,0 +1,5 @@
+"use client";
+//#region src/components/error-state/error-state-styles.ts
+var e = "w-full max-w-2xl text-left text-sm text-foreground/70", t = "cursor-pointer font-medium text-foreground", n = "mt-2 overflow-x-auto rounded-md border border-border bg-background p-3 font-mono text-xs";
+//#endregion
+export { n as ERROR_STATE_DETAIL_BODY_CLASS, e as ERROR_STATE_DETAIL_CLASS, t as ERROR_STATE_DETAIL_SUMMARY_CLASS };

package/dist/components/error-state/index.d.ts

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

package/dist/components/error-state/index.d.ts.map

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

package/dist/components/error-state/index.js

@@ -0,0 +1,3 @@
+export * from "./ErrorState.js";
+export * from "./error-state-config.js";
+export * from "./error-state-styles.js";

package/dist/components/file-upload/FileUpload.d.ts

@@ -0,0 +1,112 @@
+import { InputHTMLAttributes } from 'react';
+import { FieldStatus } from '../field/field-config';
+import { FileUploadConfig } from './file-upload-config';
+type BaseFileUploadProps = FileUploadConfig & Omit<InputHTMLAttributes<HTMLInputElement>, "children" | "className" | "onChange" | "size" | "type" | "value">;
+/**
+ * Props for the FileUpload component.
+ */
+export interface FileUploadProps extends BaseFileUploadProps {
+    /**
+     * Called with the files the reader chose, once the ones over the size limit
+     * have been left out. The field owns nothing: the consumer keeps the list and
+     * passes it back through `files`.
+     */
+    onFilesSelected: (files: File[]) => void;
+    /**
+     * The files that have been chosen, which the field lists and can remove.
+     */
+    files?: File[];
+    /**
+     * Called with the file the reader removed.
+     * Its presence is what draws a remove control beside each file.
+     */
+    onRemove?: (file: File) => void;
+    /**
+     * Largest file the field accepts, in bytes.
+     * A larger file is left out and reported here rather than being passed on to
+     * be rejected later.
+     */
+    maxSize?: number;
+    /**
+     * Label of the field.
+     */
+    label?: string;
+    /**
+     * Description shown under the label.
+     */
+    description?: string;
+    /**
+     * Message shown under the field.
+     */
+    message?: string;
+    /**
+     * Validation status of the field.
+     *
+     * @default "default"
+     */
+    status?: FieldStatus;
+    /**
+     * Whether the field is unavailable.
+     *
+     * @default false
+     */
+    isDisabled?: boolean;
+    /**
+     * Whether the field must be filled in before the form is submitted.
+     *
+     * @default false
+     */
+    required?: boolean;
+    /**
+     * Extra classes for the field wrapper.
+     */
+    className?: string;
+}
+/**
+ * A field that accepts files.
+ *
+ * The zone is a label for the field, so a pointer opens the picker, a keyboard
+ * reaches the field, and a screen reader reads the zone as the field's name.
+ * Files dropped on the zone take the same path as files chosen from the picker,
+ * which is what keeps the size limit from being skipped.
+ *
+ * The field owns nothing: it reports what was chosen and lists what the consumer
+ * passes back, which is what lets one component serve a plain form and a form
+ * library that owns the files.
+ *
+ * @param props - FileUpload configuration options and field attributes.
+ * @param props.onFilesSelected - Called with the accepted files.
+ * @param props.files - The files that have been chosen.
+ * @param props.onRemove - Called with the file the reader removed.
+ * @param props.maxSize - Largest accepted file, in bytes.
+ * @param props.accept - The kinds of file the picker offers.
+ * @param props.multiple - Whether more than one file may be chosen.
+ * @param props.label - Label of the field.
+ * @param props.description - Description under the label.
+ * @param props.message - Message under the field.
+ * @param props.status - Validation status. Defaults to "default".
+ * @param props.isDisabled - Whether the field is unavailable. Defaults to false.
+ * @param props.size - Density of the zone. Defaults to "md".
+ * @param props.buttonLabel - Name of the control. Defaults to "Choose files".
+ * @param props.hint - Instruction in the zone. Defaults to "Drag files here".
+ * @returns The rendered field.
+ *
+ * @example
+ * ```tsx
+ * <FileUpload
+ *   label="Attachments"
+ *   accept="application/pdf"
+ *   multiple
+ *   maxSize={5 * 1024 * 1024}
+ *   files={files}
+ *   onFilesSelected={(chosen) => setFiles((current) => [...current, ...chosen])}
+ *   onRemove={(file) => setFiles((current) => current.filter((f) => f !== file))}
+ * />
+ * ```
+ *
+ * @see Input - The text field, which shares the field contract.
+ * @see Chip - The token the field uses for a chosen file.
+ */
+export declare const FileUpload: import('react').ForwardRefExoticComponent<FileUploadProps & import('react').RefAttributes<HTMLInputElement>>;
+export {};
+//# sourceMappingURL=FileUpload.d.ts.map

package/dist/components/file-upload/FileUpload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileUpload.d.ts","sourceRoot":"","sources":["../../../src/components/file-upload/FileUpload.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAGL,KAAK,mBAAmB,EAIzB,MAAM,OAAO,CAAC;AAMf,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAY9B,KAAK,mBAAmB,GAAG,gBAAgB,GACzC,IAAI,CACF,mBAAmB,CAAC,gBAAgB,CAAC,EACrC,UAAU,GAAG,WAAW,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAClE,CAAC;AAEJ;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,mBAAmB;IAC1D;;;;OAIG;IACH,eAAe,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,CAAC;IAEzC;;OAEG;IACH,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IAEf;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IAEhC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,eAAO,MAAM,UAAU,8GAkKtB,CAAC"}

package/dist/components/file-upload/FileUpload.js

@@ -0,0 +1,83 @@
+"use client";
+"use client";
+import { cn as e } from "../../utils/cn.js";
+import { useAsheeConfig as t } from "../../libs/context.js";
+import { resolveConfigCascade as n } from "../../utils/resolve-token.js";
+import { FieldShell as r } from "../field/FieldShell.js";
+import { Chip as i } from "../chip/Chip.js";
+import { describeRejectedFiles as a } from "./file-upload.helpers.js";
+import { FALLBACK_FILE_UPLOAD_CONFIG as o } from "./file-upload-config.js";
+import { FILE_UPLOAD_BUTTON_CLASS as s, FILE_UPLOAD_HINT_CLASS as c, FILE_UPLOAD_INPUT_CLASS as l, FILE_UPLOAD_SIZE_CLASS as u, FILE_UPLOAD_ZONE_CLASS as d } from "./file-upload-styles.js";
+import { forwardRef as f, useId as p, useRef as m, useState as h } from "react";
+import { jsx as g, jsxs as _ } from "react/jsx-runtime";
+//#region src/components/file-upload/FileUpload.tsx
+var v = f(({ onFilesSelected: f, files: v, onRemove: y, maxSize: b, label: x, description: S, message: C, status: w, isDisabled: T, required: E, buttonLabel: D, hint: O, size: k, className: A, id: j, ...M }, N) => {
+	let P = t(), F = p(), I = j ?? F, L = n({
+		buttonLabel: D,
+		hint: O,
+		size: k
+	}, P.components?.fileupload, o), [R, z] = h(!1), [B, V] = h(""), H = m(null), U = (e) => {
+		H.current = e, typeof N == "function" ? N(e) : N && (N.current = e);
+	}, W = (e) => {
+		let t = Array.from(e ?? []);
+		if (t.length === 0) return;
+		let n = b === void 0 ? t : t.filter((e) => e.size <= b), r = t.length - n.length;
+		V(r === 0 ? "" : a(r, b ?? 0)), n.length > 0 && f(n);
+	}, G = (e) => {
+		e.preventDefault(), z(!1), !T && W(e.dataTransfer?.files ?? null);
+	}, K = () => {
+		W(H.current?.files ?? null);
+	}, q = C ?? B, J = C ? w ?? "default" : B ? "error" : "default", Y = e(d, u[L.size], R && "border-primary bg-primary/10", T && "cursor-not-allowed opacity-60 hover:border-border");
+	return /* @__PURE__ */ g("div", {
+		className: e("flex w-full min-w-0 flex-col", A),
+		children: /* @__PURE__ */ _(r, {
+			id: I,
+			label: x,
+			description: S,
+			message: q,
+			status: J,
+			required: E,
+			children: [
+				/* @__PURE__ */ g("input", {
+					...M,
+					ref: U,
+					id: I,
+					type: "file",
+					className: l,
+					disabled: T,
+					onChange: K
+				}),
+				/* @__PURE__ */ g("label", {
+					htmlFor: I,
+					className: Y,
+					onDragOver: (e) => {
+						e.preventDefault(), T || z(!0);
+					},
+					onDragLeave: () => z(!1),
+					onDrop: G,
+					children: /* @__PURE__ */ _("span", {
+						className: "flex flex-wrap items-baseline justify-center gap-1 text-sm",
+						children: [/* @__PURE__ */ g("span", {
+							className: s,
+							children: L.buttonLabel
+						}), /* @__PURE__ */ _("span", {
+							className: c,
+							children: ["or ", L.hint.toLowerCase()]
+						})]
+					})
+				}),
+				v && v.length > 0 && /* @__PURE__ */ g("ul", {
+					className: "flex flex-wrap gap-2 pt-1",
+					children: v.map((e) => /* @__PURE__ */ g("li", { children: /* @__PURE__ */ g(i, {
+						closeLabel: `Remove ${e.name}`,
+						onClose: y ? () => y(e) : void 0,
+						children: e.name
+					}) }, `${e.name}-${e.lastModified}`))
+				})
+			]
+		})
+	});
+});
+v.displayName = "FileUpload";
+//#endregion
+export { v as FileUpload };