asheeui 1.1.1 → 2.0.0

package/dist/components/search-input/search-input-styles.d.ts

@@ -0,0 +1,16 @@
+import { Size } from '../../shared';
+/** The search region, which is announced as the page's search rather than a form. */
+export declare const SEARCH_INPUT_REGION_CLASS = "relative w-full min-w-0";
+/** The control that empties the field. */
+export declare const SEARCH_INPUT_CLEAR_CLASS = "shrink-0";
+/**
+ * The keyboard hint.
+ * It shows the shortcut a consumer has bound elsewhere; the field itself never
+ * listens for it, because a global shortcut is an application concern.
+ */
+export declare const SEARCH_INPUT_HINT_CLASS = "pointer-events-none shrink-0 rounded border border-border px-1.5 py-0.5 text-xs text-foreground/60";
+/** Density of the hint, so it matches the field it sits in. */
+export declare const SEARCH_INPUT_HINT_SIZE_CLASS: Record<Size, string>;
+/** Visually hidden label, for a field that is named but not captioned. */
+export declare const SEARCH_INPUT_HIDDEN_LABEL_CLASS = "sr-only";
+//# sourceMappingURL=search-input-styles.d.ts.map

package/dist/components/search-input/search-input-styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-input-styles.d.ts","sourceRoot":"","sources":["../../../src/components/search-input/search-input-styles.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC,qFAAqF;AACrF,eAAO,MAAM,yBAAyB,4BAA4B,CAAC;AAEnE,0CAA0C;AAC1C,eAAO,MAAM,wBAAwB,aAAa,CAAC;AAEnD;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,uGACkE,CAAC;AAEvG,+DAA+D;AAC/D,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAI7D,CAAC;AAEF,0EAA0E;AAC1E,eAAO,MAAM,+BAA+B,YAAY,CAAC"}

package/dist/components/search-input/search-input-styles.js

@@ -0,0 +1,9 @@
+"use client";
+//#region src/components/search-input/search-input-styles.ts
+var e = "relative w-full min-w-0", t = "shrink-0", n = "pointer-events-none shrink-0 rounded border border-border px-1.5 py-0.5 text-xs text-foreground/60", r = {
+	sm: "text-[10px]",
+	md: "text-xs",
+	lg: "text-sm"
+}, i = "sr-only";
+//#endregion
+export { t as SEARCH_INPUT_CLEAR_CLASS, i as SEARCH_INPUT_HIDDEN_LABEL_CLASS, n as SEARCH_INPUT_HINT_CLASS, r as SEARCH_INPUT_HINT_SIZE_CLASS, e as SEARCH_INPUT_REGION_CLASS };

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

@@ -1,3 +1,4 @@
+import { ReactNode } from 'react';
 import { ActionConfig } from '../../shared';
 /**
  * Props for the internal ActionGroup helper.
@@ -24,6 +25,12 @@ export interface ActionGroupProps {
      * Additional classes for the wrapper.
      */
     className?: string;
+    /**
+     * Content rendered alongside the configured actions, inside the same group.
+     * It is the way a pattern places an action that carries a handler, because a
+     * configured action describes a destination rather than a React callback.
+     */
+    children?: ReactNode;
 }
 /**
  * Renders a pattern's configured actions.
@@ -43,5 +50,5 @@ export interface ActionGroupProps {
  * />
  * ```
  */
-export declare function ActionGroup({ primaryAction, secondaryAction, align, className, }: ActionGroupProps): import("react").JSX.Element | null;
+export declare function ActionGroup({ primaryAction, secondaryAction, align, className, children, }: ActionGroupProps): import("react").JSX.Element | null;
 //# sourceMappingURL=ActionGroup.d.ts.map

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

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

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

@@ -3,16 +3,20 @@ import { cn as e } from "../../utils/cn.js";
 import { Button as t } from "../button/Button.js";
 import { jsx as n, jsxs as r } from "react/jsx-runtime";
 //#region src/components/section-kit/ActionGroup.tsx
-function i({ primaryAction: t, secondaryAction: i, align: o = "start", className: s }) {
-	return !t && !i ? null : /* @__PURE__ */ r("div", {
+function i({ primaryAction: t, secondaryAction: i, align: o = "start", className: s, children: c }) {
+	return !t && !i && !c ? null : /* @__PURE__ */ r("div", {
 		className: e("flex flex-col gap-3 sm:flex-row sm:items-center", o === "center" && "sm:justify-center", s),
-		children: [t && /* @__PURE__ */ n(a, {
-			action: t,
-			defaultVariant: "solid"
-		}), i && /* @__PURE__ */ n(a, {
-			action: i,
-			defaultVariant: "bordered"
-		})]
+		children: [
+			t && /* @__PURE__ */ n(a, {
+				action: t,
+				defaultVariant: "solid"
+			}),
+			i && /* @__PURE__ */ n(a, {
+				action: i,
+				defaultVariant: "bordered"
+			}),
+			c
+		]
 	});
 }
 function a({ action: e, defaultVariant: r }) {

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

@@ -0,0 +1,50 @@
+/**
+ * Skip link helper for AsheeUI.
+ *
+ * This file provides the internal `SkipLink` component: the first focusable
+ * element of a page composition, which lets a keyboard reader pass repeated
+ * navigation and land in the content. It is shared by the page compositions so
+ * the behaviour (and the classes that hide it until it is focused) are written
+ * once. It is an internal helper and is not part of the public component
+ * inventory.
+ */
+/**
+ * Classes of the skip link.
+ *
+ * The link is visually hidden until it receives focus, which is the arrangement
+ * a keyboard reader needs: it is the first thing Tab reaches, and it is
+ * invisible to a pointer user until then.
+ */
+export declare const SKIP_LINK_CLASS = "sr-only focus:not-sr-only focus:absolute focus:left-4 focus:top-4 focus:z-50 focus:rounded-md focus:bg-background focus:px-4 focus:py-2 focus:text-foreground focus:ring-2 focus:ring-primary";
+/**
+ * Props for the internal SkipLink helper.
+ */
+export interface SkipLinkProps {
+    /**
+     * Identifier of the region the link leads to.
+     * The region is expected to be focusable (`tabIndex={-1}`), so following the
+     * link moves the reader into the content rather than only scrolling to it.
+     */
+    targetId: string;
+    /**
+     * Wording of the link, which is also its accessible name.
+     */
+    label: string;
+    /**
+     * Additional classes for the anchor.
+     */
+    className?: string;
+}
+/**
+ * Renders the skip link of a page composition.
+ *
+ * @param props - The destination, the wording and any extra classes.
+ * @returns The rendered anchor.
+ *
+ * @example
+ * ```tsx
+ * <SkipLink targetId="main-content" label="Skip to content" />
+ * ```
+ */
+export declare function SkipLink({ targetId, label, className }: SkipLinkProps): import("react").JSX.Element;
+//# sourceMappingURL=SkipLink.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SkipLink.d.ts","sourceRoot":"","sources":["../../../src/components/section-kit/SkipLink.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,kMACqK,CAAC;AAElM;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,aAAa,+BAMrE"}

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

@@ -0,0 +1,14 @@
+"use client";
+import { cn as e } from "../../utils/cn.js";
+import { jsx as t } from "react/jsx-runtime";
+//#region src/components/section-kit/SkipLink.tsx
+var n = "sr-only focus:not-sr-only focus:absolute focus:left-4 focus:top-4 focus:z-50 focus:rounded-md focus:bg-background focus:px-4 focus:py-2 focus:text-foreground focus:ring-2 focus:ring-primary";
+function r({ targetId: r, label: i, className: a }) {
+	return /* @__PURE__ */ t("a", {
+		href: `#${r}`,
+		className: e(n, a),
+		children: i
+	});
+}
+//#endregion
+export { n as SKIP_LINK_CLASS, r as SkipLink };

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

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

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

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

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

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

package/dist/components/sidebar-layout/SidebarLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SidebarLayout.d.ts","sourceRoot":"","sources":["../../../src/components/sidebar-layout/SidebarLayout.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EACL,KAAK,WAAW,EAEhB,KAAK,cAAc,EACnB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAIf,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,yBAAyB,CAAC;AAYjC,KAAK,sBAAsB,GAAG,mBAAmB,GAC/C,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,sBAAsB;IAChE,kEAAkE;IAClE,OAAO,EAAE,SAAS,CAAC;IAEnB,sEAAsE;IACtE,MAAM,CAAC,EAAE,SAAS,CAAC;IAEnB,kCAAkC;IAClC,MAAM,CAAC,EAAE,SAAS,CAAC;IAEnB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;;OAKG;IACH,EAAE,CAAC,EAAE,WAAW,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,eAAO,MAAM,aAAa,+GAyDzB,CAAC"}
+{"version":3,"file":"SidebarLayout.d.ts","sourceRoot":"","sources":["../../../src/components/sidebar-layout/SidebarLayout.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EACL,KAAK,WAAW,EAEhB,KAAK,cAAc,EACnB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAIf,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,yBAAyB,CAAC;AAajC,KAAK,sBAAsB,GAAG,mBAAmB,GAC/C,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,sBAAsB;IAChE,kEAAkE;IAClE,OAAO,EAAE,SAAS,CAAC;IAEnB,sEAAsE;IACtE,MAAM,CAAC,EAAE,SAAS,CAAC;IAEnB,kCAAkC;IAClC,MAAM,CAAC,EAAE,SAAS,CAAC;IAEnB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;;OAKG;IACH,EAAE,CAAC,EAAE,WAAW,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,eAAO,MAAM,aAAa,+GAyDzB,CAAC"}

package/dist/components/sidebar-layout/SidebarLayout.js

@@ -4,37 +4,37 @@ 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 { FALLBACK_SIDEBAR_LAYOUT_CONFIG as r } from "./sidebar-layout-config.js";
-import { SIDEBAR_LAYOUT_ASIDE_CLASS as i, SIDEBAR_LAYOUT_ASIDE_END_BORDER_CLASS as a, SIDEBAR_LAYOUT_ASIDE_END_CLASS as o, SIDEBAR_LAYOUT_ASIDE_START_BORDER_CLASS as s, SIDEBAR_LAYOUT_CLASS as c, SIDEBAR_LAYOUT_CONTENT_CLASS as l, SIDEBAR_LAYOUT_WIDTH_CLASS as u } from "./sidebar-layout-styles.js";
-import { forwardRef as d } from "react";
-import { jsx as f, jsxs as p } from "react/jsx-runtime";
+import { SIDEBAR_LAYOUT_ASIDE_CLASS as i, SIDEBAR_LAYOUT_ASIDE_END_BORDER_CLASS as a, SIDEBAR_LAYOUT_ASIDE_END_CLASS as o, SIDEBAR_LAYOUT_ASIDE_START_BORDER_CLASS as s, SIDEBAR_LAYOUT_CLASS as c, SIDEBAR_LAYOUT_CONTENT_CLASS as l, SIDEBAR_LAYOUT_ROW_CLASS as u, SIDEBAR_LAYOUT_WIDTH_CLASS as d } from "./sidebar-layout-styles.js";
+import { forwardRef as f } from "react";
+import { jsx as p, jsxs as m } from "react/jsx-runtime";
 //#region src/components/sidebar-layout/SidebarLayout.tsx
-var m = d(({ sidebar: d, header: m, footer: h, sidebarLabel: g = "Sidebar", side: _, sidebarWidth: v, stickySidebar: y, as: b, className: x, children: S, ...C }, w) => {
-	let T = t(), E = n({
-		side: _,
-		sidebarWidth: v,
-		stickySidebar: y
-	}, T.components?.sidebarlayout, r), D = E.side === "end";
-	return /* @__PURE__ */ p(b ?? "div", {
-		ref: w,
-		className: e(c, x),
-		...C,
+var h = f(({ sidebar: f, header: h, footer: g, sidebarLabel: _ = "Sidebar", side: v, sidebarWidth: y, stickySidebar: b, as: x, className: S, children: C, ...w }, T) => {
+	let E = t(), D = n({
+		side: v,
+		sidebarWidth: y,
+		stickySidebar: b
+	}, E.components?.sidebarlayout, r), O = D.side === "end";
+	return /* @__PURE__ */ m(x ?? "div", {
+		ref: T,
+		className: e(c, S),
+		...w,
 		children: [
-			m,
-			/* @__PURE__ */ p("div", {
-				className: "flex w-full flex-1 flex-col lg:flex-row",
-				children: [/* @__PURE__ */ f("aside", {
-					"aria-label": g,
-					className: e(i, u[E.sidebarWidth], D ? o : s, D ? a : void 0, E.stickySidebar && "lg:sticky lg:top-0 lg:h-dvh lg:overflow-y-auto"),
-					children: d
-				}), /* @__PURE__ */ f("div", {
+			h,
+			/* @__PURE__ */ m("div", {
+				className: u,
+				children: [/* @__PURE__ */ p("aside", {
+					"aria-label": _,
+					className: e(i, d[D.sidebarWidth], O ? o : s, O ? a : void 0, D.stickySidebar && "lg:sticky lg:top-0 lg:h-dvh lg:overflow-y-auto"),
+					children: f
+				}), /* @__PURE__ */ p("div", {
 					className: l,
-					children: S
+					children: C
 				})]
 			}),
-			h
+			g
 		]
 	});
 });
-m.displayName = "SidebarLayout";
+h.displayName = "SidebarLayout";
 //#endregion
-export { m as SidebarLayout };
+export { h as SidebarLayout };

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

@@ -1,9 +1,16 @@
 import { SidebarLayoutWidth } from './sidebar-layout-config';
 /**
- * The shell: a full-height column that becomes a row from the `lg` breakpoint,
- * where the navigation column and the content sit beside each other.
+ * The shell: a full-height column of the header, the two-column row and the
+ * footer. The shell itself stays a column at every width, so the header and the
+ * footer always span the page rather than sitting beside the columns.
  */
-export declare const SIDEBAR_LAYOUT_CLASS = "flex min-h-dvh w-full flex-col bg-background lg:flex-row";
+export declare const SIDEBAR_LAYOUT_CLASS = "flex min-h-dvh w-full flex-col bg-background";
+/**
+ * The row that holds the navigation column and the content column.
+ * It stacks the two columns on a narrow screen and places them side by side
+ * from the `lg` breakpoint, which is where the shell becomes two columns.
+ */
+export declare const SIDEBAR_LAYOUT_ROW_CLASS = "flex w-full flex-1 flex-col lg:flex-row";
 /** The navigation column, stacked above the content on a narrow screen. */
 export declare const SIDEBAR_LAYOUT_ASIDE_CLASS = "w-full shrink-0 border-b border-border";
 /** The navigation column when it sits at the trailing edge. */

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

@@ -1 +1 @@
-{"version":3,"file":"sidebar-layout-styles.d.ts","sourceRoot":"","sources":["../../../src/components/sidebar-layout/sidebar-layout-styles.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE;;;GAGG;AACH,eAAO,MAAM,oBAAoB,6DAC2B,CAAC;AAE7D,2EAA2E;AAC3E,eAAO,MAAM,0BAA0B,2CACG,CAAC;AAE3C,+DAA+D;AAC/D,eAAO,MAAM,8BAA8B,kBAAkB,CAAC;AAE9D,kEAAkE;AAClE,eAAO,MAAM,uCAAuC,gBAAgB,CAAC;AAErE,mEAAmE;AACnE,eAAO,MAAM,qCAAqC,gBAAgB,CAAC;AAEnE,qEAAqE;AACrE,eAAO,MAAM,iCAAiC,mDACI,CAAC;AAEnD,0BAA0B;AAC1B,eAAO,MAAM,4BAA4B,iCAAiC,CAAC;AAE3E,sEAAsE;AACtE,eAAO,MAAM,0BAA0B,EAAE,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAIzE,CAAC"}
+{"version":3,"file":"sidebar-layout-styles.d.ts","sourceRoot":"","sources":["../../../src/components/sidebar-layout/sidebar-layout-styles.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,iDACe,CAAC;AAEjD;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,4CACM,CAAC;AAE5C,2EAA2E;AAC3E,eAAO,MAAM,0BAA0B,2CACG,CAAC;AAE3C,+DAA+D;AAC/D,eAAO,MAAM,8BAA8B,kBAAkB,CAAC;AAE9D,kEAAkE;AAClE,eAAO,MAAM,uCAAuC,gBAAgB,CAAC;AAErE,mEAAmE;AACnE,eAAO,MAAM,qCAAqC,gBAAgB,CAAC;AAEnE,qEAAqE;AACrE,eAAO,MAAM,iCAAiC,mDACI,CAAC;AAEnD,0BAA0B;AAC1B,eAAO,MAAM,4BAA4B,iCAAiC,CAAC;AAE3E,sEAAsE;AACtE,eAAO,MAAM,0BAA0B,EAAE,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAIzE,CAAC"}

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

@@ -1,9 +1,9 @@
 "use client";
 //#region src/components/sidebar-layout/sidebar-layout-styles.ts
-var e = "flex min-h-dvh w-full flex-col bg-background lg:flex-row", t = "w-full shrink-0 border-b border-border", n = "lg:order-last", r = "lg:border-r", i = "lg:border-l", a = "lg:sticky lg:top-0 lg:h-dvh lg:overflow-y-auto", o = "flex min-w-0 flex-1 flex-col", s = {
+var e = "flex min-h-dvh w-full flex-col bg-background", t = "flex w-full flex-1 flex-col lg:flex-row", n = "w-full shrink-0 border-b border-border", r = "lg:order-last", i = "lg:border-r", a = "lg:border-l", o = "lg:sticky lg:top-0 lg:h-dvh lg:overflow-y-auto", s = "flex min-w-0 flex-1 flex-col", c = {
 	sm: "lg:w-56",
 	md: "lg:w-64",
 	lg: "lg:w-80"
 };
 //#endregion
-export { t as SIDEBAR_LAYOUT_ASIDE_CLASS, i as SIDEBAR_LAYOUT_ASIDE_END_BORDER_CLASS, n as SIDEBAR_LAYOUT_ASIDE_END_CLASS, r as SIDEBAR_LAYOUT_ASIDE_START_BORDER_CLASS, a as SIDEBAR_LAYOUT_ASIDE_STICKY_CLASS, e as SIDEBAR_LAYOUT_CLASS, o as SIDEBAR_LAYOUT_CONTENT_CLASS, s as SIDEBAR_LAYOUT_WIDTH_CLASS };
+export { n as SIDEBAR_LAYOUT_ASIDE_CLASS, a as SIDEBAR_LAYOUT_ASIDE_END_BORDER_CLASS, r as SIDEBAR_LAYOUT_ASIDE_END_CLASS, i as SIDEBAR_LAYOUT_ASIDE_START_BORDER_CLASS, o as SIDEBAR_LAYOUT_ASIDE_STICKY_CLASS, e as SIDEBAR_LAYOUT_CLASS, s as SIDEBAR_LAYOUT_CONTENT_CLASS, t as SIDEBAR_LAYOUT_ROW_CLASS, c as SIDEBAR_LAYOUT_WIDTH_CLASS };

package/dist/components/split/Split.d.ts

@@ -0,0 +1,68 @@
+import { ElementType, HTMLAttributes, ReactNode } from 'react';
+import { SplitConfig } from './split-config';
+type BaseSplitProps = SplitConfig & Omit<HTMLAttributes<HTMLDivElement>, "color">;
+/**
+ * Props for the Split component.
+ */
+export interface SplitProps extends BaseSplitProps {
+    /**
+     * The first pane.
+     * Left out when the layout has one pane only, which is what a page that grows
+     * a second pane at a breakpoint starts as.
+     */
+    start?: ReactNode;
+    /**
+     * The second pane.
+     * Left out when the layout has one pane only.
+     */
+    end?: ReactNode;
+    /**
+     * Element to render.
+     * Defaults to a `div`.
+     *
+     * @default "div"
+     */
+    as?: ElementType;
+}
+/**
+ * Two panes that stack on a narrow screen and sit side by side on a wide one.
+ *
+ * Split resolves its options through the standard configuration cascade, so
+ * `components.split` states the application's breakpoint and ratio once. It
+ * carries no width, no gutter and no background of its own: panes are as wide as
+ * the layout allows, and the content inside them decides its own presentation.
+ *
+ * The primitive never hides a pane. Below the breakpoint the panes stack, so
+ * everything stays in the document, reachable with the keyboard and read by a
+ * screen reader in a sensible order.
+ *
+ * @param props - Split configuration options and element attributes.
+ * @param props.start - The first pane.
+ * @param props.end - The second pane.
+ * @param props.stackAt - Breakpoint from which the panes sit side by side.
+ * Defaults to "lg".
+ * @param props.ratio - How the panes divide the width. Defaults to "equal".
+ * @param props.gap - Space between the panes. Defaults to "lg".
+ * @param props.align - Cross-axis alignment. Defaults to "stretch".
+ * @param props.divider - Draw a rule between the panes. Defaults to false.
+ * @param props.stickyEnd - Keep the second pane in view. Defaults to false.
+ * @param props.as - Element to render. Defaults to "div".
+ * @returns The rendered layout.
+ *
+ * @example
+ * ```tsx
+ * <Split
+ *   stackAt="xl"
+ *   ratio="start"
+ *   start={<Typography role="body-md">The article.</Typography>}
+ *   end={<TableOfContents items={items} />}
+ *   stickyEnd
+ * />
+ * ```
+ *
+ * @see Grid - The two-dimensional layout, for more than two regions.
+ * @see SidebarLayout - The application shell, when a pane is navigation.
+ */
+export declare const Split: import('react').ForwardRefExoticComponent<SplitProps & import('react').RefAttributes<HTMLDivElement>>;
+export {};
+//# sourceMappingURL=Split.d.ts.map

package/dist/components/split/Split.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Split.d.ts","sourceRoot":"","sources":["../../../src/components/split/Split.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EACL,KAAK,WAAW,EAEhB,KAAK,cAAc,EACnB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAKf,OAAO,EAAyB,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAWzE,KAAK,cAAc,GAAG,WAAW,GAC/B,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,cAAc;IAChD;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAElB;;;OAGG;IACH,GAAG,CAAC,EAAE,SAAS,CAAC;IAEhB;;;;;OAKG;IACH,EAAE,CAAC,EAAE,WAAW,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,eAAO,MAAM,KAAK,uGAwDjB,CAAC"}

package/dist/components/split/Split.js

@@ -0,0 +1,36 @@
+"use client";
+"use client";
+import { cn as e } from "../../utils/cn.js";
+import { SPACE_GAP_CLASS as t } from "../../shared/spacing.js";
+import { useAsheeConfig as n } from "../../libs/context.js";
+import { resolveConfigCascade as r } from "../../utils/resolve-token.js";
+import { FALLBACK_SPLIT_CONFIG as i } from "./split-config.js";
+import { SPLIT_ALIGN_CLASS as a, SPLIT_BASE_CLASS as o, SPLIT_DIVIDER_CLASS as s, SPLIT_PANE_WIDTH_CLASS as c, SPLIT_STACK_CLASS as l } from "./split-styles.js";
+import { forwardRef as u } from "react";
+import { jsx as d, jsxs as f } from "react/jsx-runtime";
+//#region src/components/split/Split.tsx
+var p = u(({ as: u, start: p, end: m, stackAt: h, ratio: g, gap: _, align: v, divider: y, stickyEnd: b, className: x, ...S }, C) => {
+	let w = n(), T = r({
+		stackAt: h,
+		ratio: g,
+		gap: _,
+		align: v,
+		divider: y,
+		stickyEnd: b
+	}, w.components?.split, i), E = c[T.stackAt][T.ratio];
+	return /* @__PURE__ */ f(u ?? "div", {
+		ref: C,
+		className: e(o, l[T.stackAt], a[T.align], t[T.gap], T.divider && s[T.stackAt], x),
+		...S,
+		children: [p !== void 0 && /* @__PURE__ */ d("div", {
+			className: e("w-full min-w-0", E.start),
+			children: p
+		}), m !== void 0 && /* @__PURE__ */ d("div", {
+			className: e("w-full min-w-0", E.end, T.stickyEnd && "sticky top-0 self-start"),
+			children: m
+		})]
+	});
+});
+p.displayName = "Split";
+//#endregion
+export { p as Split };

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

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

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

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

package/dist/components/split/index.js

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

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

@@ -0,0 +1,83 @@
+import { Space } from '../../shared';
+/**
+ * The breakpoints at which two panes stop stacking.
+ * `sm` is a wide phone in landscape, `md` a tablet, `lg` a laptop and `xl` a
+ * large desktop, which are the framework's shared breakpoints.
+ */
+export type SplitStackAt = "sm" | "md" | "lg" | "xl";
+/**
+ * How the two panes divide the width once they sit side by side.
+ *
+ * - `equal`: the panes share the width, for a comparison or a media pair.
+ * - `start`: the first pane takes two thirds, for a content column beside a
+ *   narrower aside.
+ * - `end`: the second pane takes two thirds, for a narrow navigation column
+ *   beside a wide content column.
+ */
+export type SplitRatio = "equal" | "start" | "end";
+/**
+ * Cross-axis alignment of the two panes on the wide layout.
+ */
+export type SplitAlign = "start" | "center" | "stretch";
+/**
+ * Theme configuration options for the Split component.
+ *
+ * Set under `components.split` in the AsheeUI config. Values feed the
+ * component-level tier of the theme cascade.
+ */
+export interface SplitConfig {
+    /**
+     * Breakpoint from which the panes sit side by side instead of stacking.
+     *
+     * @default "lg"
+     */
+    stackAt?: SplitStackAt;
+    /**
+     * How the panes divide the width.
+     *
+     * @default "equal"
+     */
+    ratio?: SplitRatio;
+    /**
+     * Space between the two panes.
+     *
+     * @default "lg"
+     */
+    gap?: Space;
+    /**
+     * Cross-axis alignment of the panes.
+     *
+     * @default "stretch"
+     */
+    align?: SplitAlign;
+    /**
+     * Whether a border is drawn between the panes on the wide layout.
+     * On the narrow layout the panes stack, so there is nothing to separate.
+     *
+     * @default false
+     */
+    divider?: boolean;
+    /**
+     * Whether the second pane sticks to the top of the viewport while the first
+     * pane scrolls. It suits a table of contents or a summary column.
+     *
+     * @default false
+     */
+    stickyEnd?: boolean;
+}
+/**
+ * Default config values registered for the Split component.
+ * The breakpoint and the ratio are pinned; alignment, divider and stickiness
+ * stay unset so a consumer's own value is the only one the cascade sees.
+ */
+export declare const defaultSplitConfig: SplitConfig;
+declare module "../../libs/registry" {
+    interface ComponentTypeConfigRegistry {
+        split: SplitConfig;
+    }
+}
+/**
+ * Hard fallback values used when no config tier provides a value.
+ */
+export declare const FALLBACK_SPLIT_CONFIG: Required<SplitConfig>;
+//# sourceMappingURL=split-config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"split-config.d.ts","sourceRoot":"","sources":["../../../src/components/split/split-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAE1C;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAErD;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AAExD;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC;IAEvB;;;;OAIG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;IAEnB;;;;OAIG;IACH,GAAG,CAAC,EAAE,KAAK,CAAC;IAEZ;;;;OAIG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;IAEnB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,WAKhC,CAAC;AAEF,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,KAAK,EAAE,WAAW,CAAC;KACpB;CACF;AAID;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,WAAW,CAOvD,CAAC"}

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

@@ -0,0 +1,20 @@
+"use client";
+import { registerComponentDefaults as e } from "../../libs/registry.js";
+//#region src/components/split/split-config.ts
+var t = {
+	stackAt: "lg",
+	ratio: "equal",
+	gap: "lg",
+	align: "stretch"
+};
+e("split", t);
+var n = {
+	stackAt: "lg",
+	ratio: "equal",
+	gap: "lg",
+	align: "stretch",
+	divider: !1,
+	stickyEnd: !1
+};
+//#endregion
+export { n as FALLBACK_SPLIT_CONFIG, t as defaultSplitConfig };

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

@@ -0,0 +1,36 @@
+import { SplitAlign, SplitRatio, SplitStackAt } from './split-config';
+/** Shared classes for every split. */
+export declare const SPLIT_BASE_CLASS = "flex w-full min-w-0";
+/**
+ * Stacking classes per breakpoint.
+ * Below the breakpoint the panes are a column, so a narrow screen reads the
+ * panes in the order they are written rather than side by side.
+ */
+export declare const SPLIT_STACK_CLASS: Record<SplitStackAt, string>;
+/** Cross-axis alignment classes for the wide layout. */
+export declare const SPLIT_ALIGN_CLASS: Record<SplitAlign, string>;
+/** Shared classes for every pane. */
+export declare const SPLIT_PANE_BASE_CLASS = "w-full min-w-0";
+/**
+ * Width each pane takes once the panes sit side by side, per breakpoint and
+ * ratio. `flex-basis` decides the main size of a flex item, so it settles the
+ * division of the width without the panes having to grow.
+ */
+export declare const SPLIT_PANE_WIDTH_CLASS: Record<SplitStackAt, Record<SplitRatio, {
+    start: string;
+    end: string;
+}>>;
+/**
+ * Divider classes per breakpoint.
+ * Stacked panes are separated by a horizontal rule; side-by-side panes by a
+ * vertical one, which the same utility produces because it follows the flex
+ * direction.
+ */
+export declare const SPLIT_DIVIDER_CLASS: Record<SplitStackAt, string>;
+/**
+ * Sticky classes for a pane that stays in view.
+ * A sticky flex item also needs to stop stretching, or it has no room to move
+ * within its parent.
+ */
+export declare const SPLIT_STICKY_CLASS = "sticky top-0 self-start";
+//# sourceMappingURL=split-styles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"split-styles.d.ts","sourceRoot":"","sources":["../../../src/components/split/split-styles.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE3E,sCAAsC;AACtC,eAAO,MAAM,gBAAgB,wBAAwB,CAAC;AAEtD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAK1D,CAAC;AAEF,wDAAwD;AACxD,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAIxD,CAAC;AAEF,qCAAqC;AACrC,eAAO,MAAM,qBAAqB,mBAAmB,CAAC;AAEtD;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CACzC,YAAY,EACZ,MAAM,CAAC,UAAU,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAsBnD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAK5D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,4BAA4B,CAAC"}