asheeui 1.0.0 → 1.1.0

package/dist/components/section/Section.js

@@ -0,0 +1,27 @@
+"use client";
+"use client";
+import { cn as e } from "../../utils/cn.js";
+import { SPACE_PADDING_Y_CLASS as t } from "../../shared/spacing.js";
+import { useAsheeConfig as n } from "../../libs/context.js";
+import { resolveCascade as r } from "../../utils/resolve-token.js";
+import { Container as i } from "../container/Container.js";
+import { FALLBACK_SECTION_CONFIG as a } from "./section-config.js";
+import { SECTION_BACKGROUND_CLASS as o, SECTION_BASE_CLASS as s } from "./section-styles.js";
+import { forwardRef as c } from "react";
+import { jsx as l } from "react/jsx-runtime";
+//#region src/components/section/Section.tsx
+var u = c(({ as: c, spacing: u, background: d, contained: f, containerSize: p, divider: m, className: h, children: g, ..._ }, v) => {
+	let y = n().components?.section, b = r(u, y?.spacing, void 0, a.spacing), x = r(d, y?.background, void 0, a.background), S = r(f, y?.contained, void 0, a.contained), C = r(p, y?.containerSize, void 0, a.containerSize), w = r(m, y?.divider, void 0, a.divider);
+	return /* @__PURE__ */ l(c ?? "section", {
+		ref: v,
+		className: e(s, t[b], o[x], w && "border-t border-border", h),
+		..._,
+		children: S ? /* @__PURE__ */ l(i, {
+			size: C,
+			children: g
+		}) : g
+	});
+});
+u.displayName = "Section";
+//#endregion
+export { u as Section };

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/section/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC"}

package/dist/components/section/index.js

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

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

@@ -0,0 +1,64 @@
+import { Space } from '../../shared';
+import { ContainerSize } from '../container/container-config';
+/**
+ * Background treatment of a section.
+ *
+ * - `none`: transparent, so the page background shows through.
+ * - `muted`: a subdued band, used to separate one section from the next.
+ * - `tinted`: a faint accent band, used to emphasise a section.
+ */
+export type SectionBackground = "none" | "muted" | "tinted";
+/**
+ * Theme configuration options for the Section component.
+ *
+ * Set under `components.section` in the AsheeUI config. Values feed the
+ * component-level fallback tier of the theme cascade.
+ */
+export interface SectionConfig {
+    /**
+     * Vertical padding of the section.
+     *
+     * @default "lg"
+     */
+    spacing?: Space;
+    /**
+     * Background treatment.
+     *
+     * @default "none"
+     */
+    background?: SectionBackground;
+    /**
+     * Whether the section wraps its children in a {@link Container}.
+     * Off by default, so a section can be composed with any other layout
+     * element. On, the section owns the maximum width and the gutter.
+     *
+     * @default false
+     */
+    contained?: boolean;
+    /**
+     * Maximum content width used when the section is contained.
+     *
+     * @default "lg"
+     */
+    containerSize?: ContainerSize;
+    /**
+     * Whether to draw a separator line above the section.
+     *
+     * @default false
+     */
+    divider?: boolean;
+}
+/**
+ * Default config values registered for the Section component.
+ */
+export declare const defaultSectionConfig: SectionConfig;
+declare module "../../libs/registry" {
+    interface ComponentTypeConfigRegistry {
+        section: SectionConfig;
+    }
+}
+/**
+ * Hard fallback values used when no config tier provides a value.
+ */
+export declare const FALLBACK_SECTION_CONFIG: Required<SectionConfig>;
+//# sourceMappingURL=section-config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"section-config.d.ts","sourceRoot":"","sources":["../../../src/components/section/section-config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAEnE;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC;IAEhB;;;;OAIG;IACH,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAE/B;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;OAIG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAE9B;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,aAMlC,CAAC;AAEF,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,OAAO,EAAE,aAAa,CAAC;KACxB;CACF;AAID;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,aAAa,CAM3D,CAAC"}

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

@@ -0,0 +1,20 @@
+"use client";
+import { registerComponentDefaults as e } from "../../libs/registry.js";
+//#region src/components/section/section-config.ts
+var t = {
+	spacing: "lg",
+	background: "none",
+	contained: !1,
+	containerSize: "lg",
+	divider: !1
+};
+e("section", t);
+var n = {
+	spacing: "lg",
+	background: "none",
+	contained: !1,
+	containerSize: "lg",
+	divider: !1
+};
+//#endregion
+export { n as FALLBACK_SECTION_CONFIG, t as defaultSectionConfig };

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

@@ -0,0 +1,8 @@
+import { SectionBackground } from './section-config';
+/** Background treatment classes for each section background. */
+export declare const SECTION_BACKGROUND_CLASS: Record<SectionBackground, string>;
+/** Shared base classes for every section. */
+export declare const SECTION_BASE_CLASS = "w-full";
+/** Separator drawn above a section that asks for one. */
+export declare const SECTION_DIVIDER_CLASS = "border-t border-border";
+//# sourceMappingURL=section-styles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"section-styles.d.ts","sourceRoot":"","sources":["../../../src/components/section/section-styles.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,gEAAgE;AAChE,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAItE,CAAC;AAEF,6CAA6C;AAC7C,eAAO,MAAM,kBAAkB,WAAW,CAAC;AAE3C,yDAAyD;AACzD,eAAO,MAAM,qBAAqB,2BAA2B,CAAC"}

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

@@ -0,0 +1,9 @@
+"use client";
+//#region src/components/section/section-styles.ts
+var e = {
+	none: "",
+	muted: "bg-secondary/50",
+	tinted: "bg-primary/5"
+}, t = "w-full", n = "border-t border-border";
+//#endregion
+export { e as SECTION_BACKGROUND_CLASS, t as SECTION_BASE_CLASS, n as SECTION_DIVIDER_CLASS };

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

@@ -0,0 +1,47 @@
+import { ActionConfig } from '../../shared';
+/**
+ * Props for the internal ActionGroup helper.
+ */
+export interface ActionGroupProps {
+    /**
+     * The emphasised action of the pattern.
+     * Renders as a solid button or link.
+     */
+    primaryAction?: ActionConfig;
+    /**
+     * The supporting action of the pattern.
+     * Renders as a bordered button or link.
+     */
+    secondaryAction?: ActionConfig;
+    /**
+     * Horizontal alignment of the group on a wide screen.
+     * The actions are always stacked vertically on a narrow screen.
+     *
+     * @default "start"
+     */
+    align?: "start" | "center";
+    /**
+     * Additional classes for the wrapper.
+     */
+    className?: string;
+}
+/**
+ * Renders a pattern's configured actions.
+ *
+ * The group stacks on a narrow screen and sits in a row from the `sm`
+ * breakpoint, which is the arrangement that keeps two actions readable on a
+ * phone without the consumer writing a media query.
+ *
+ * @param props - The configured actions and their alignment.
+ * @returns The rendered group, or null when the pattern has no actions.
+ *
+ * @example
+ * ```tsx
+ * <ActionGroup
+ *   primaryAction={{ label: "Start free", href: "/signup" }}
+ *   secondaryAction={{ label: "Read the docs", href: "/docs" }}
+ * />
+ * ```
+ */
+export declare function ActionGroup({ primaryAction, secondaryAction, align, className, }: ActionGroupProps): import("react").JSX.Element | null;
+//# sourceMappingURL=ActionGroup.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,35 @@
+"use client";
+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", {
+		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"
+		})]
+	});
+}
+function a({ action: e, defaultVariant: r }) {
+	let { label: i, href: a, variant: o, color: s, size: c, radius: l, icon: u, component: d, componentProps: f } = e;
+	return /* @__PURE__ */ n(t, {
+		href: a,
+		variant: o ?? r,
+		color: s,
+		size: c,
+		radius: l,
+		startContent: u,
+		link: d ? {
+			component: d,
+			props: f
+		} : void 0,
+		children: i
+	});
+}
+//#endregion
+export { i as ActionGroup };

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

@@ -0,0 +1,65 @@
+import { ElementType, ReactNode } from 'react';
+/**
+ * Heading sizes a section heading can use.
+ * The size selects a semantic typography role, so the visual step and the
+ * markup step are decided together.
+ */
+export type SectionHeadingSize = "md" | "lg" | "xl";
+/**
+ * Horizontal alignment of a section heading.
+ */
+export type SectionHeadingAlign = "start" | "center";
+/**
+ * Props for the internal SectionHeading helper.
+ */
+export interface SectionHeadingProps {
+    /**
+     * Short label above the title, for example the category of a section.
+     */
+    eyebrow?: ReactNode;
+    /**
+     * The heading itself.
+     */
+    title?: ReactNode;
+    /**
+     * Supporting sentence under the title.
+     */
+    description?: ReactNode;
+    /**
+     * Horizontal alignment of the block.
+     *
+     * @default "start"
+     */
+    align?: SectionHeadingAlign;
+    /**
+     * Element the title renders as.
+     * Defaults to the element the resolved typography role implies.
+     */
+    titleAs?: ElementType;
+    /**
+     * Size of the title.
+     *
+     * @default "md"
+     */
+    size?: SectionHeadingSize;
+    /**
+     * Identifier applied to the title element, so a section can point at it with
+     * `aria-labelledby`.
+     */
+    titleId?: string;
+    /**
+     * Additional classes for the wrapper.
+     */
+    className?: string;
+}
+/**
+ * The eyebrow, title and description block the patterns share.
+ *
+ * @param props - The heading content and its presentation options.
+ * @returns The rendered heading block, or null when it has nothing to show.
+ *
+ * @see Hero - Uses it for the page's leading statement.
+ * @see FeatureGrid - Uses it for the heading above the grid.
+ */
+export declare function SectionHeading({ eyebrow, title, description, align, titleAs, size, titleId, className, }: SectionHeadingProps): import("react").JSX.Element | null;
+//# sourceMappingURL=SectionHeading.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SectionHeading.d.ts","sourceRoot":"","sources":["../../../src/components/section-kit/SectionHeading.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIpD;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,QAAQ,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;IAEpB;;OAEG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAElB;;OAEG;IACH,WAAW,CAAC,EAAE,SAAS,CAAC;IAExB;;;;OAIG;IACH,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAE5B;;;OAGG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC;IAEtB;;;;OAIG;IACH,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAE1B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,EAC7B,OAAO,EACP,KAAK,EACL,WAAW,EACX,KAAe,EACf,OAAO,EACP,IAAW,EACX,OAAO,EACP,SAAS,GACV,EAAE,mBAAmB,sCA4CrB"}

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

@@ -0,0 +1,34 @@
+"use client";
+import { cn as e } from "../../utils/cn.js";
+import { Typography as t } from "../typography/Typography.js";
+import { jsx as n, jsxs as r } from "react/jsx-runtime";
+//#region src/components/section-kit/SectionHeading.tsx
+function i({ eyebrow: i, title: a, description: o, align: s = "start", titleAs: c, size: l = "md", titleId: u, className: d }) {
+	if (!i && !a && !o) return null;
+	let f = s === "center";
+	return /* @__PURE__ */ r("div", {
+		className: e("flex flex-col gap-2", f && "items-center text-center", d),
+		children: [
+			i && /* @__PURE__ */ n(t, {
+				role: "overline",
+				tone: "primary",
+				children: i
+			}),
+			a && /* @__PURE__ */ n(t, {
+				as: c,
+				id: u,
+				role: l === "xl" ? "display" : l === "lg" ? "heading-xl" : "heading-lg",
+				className: f ? "text-balance" : "text-pretty",
+				children: a
+			}),
+			o && /* @__PURE__ */ n(t, {
+				role: "body-lg",
+				tone: "muted",
+				className: e("max-w-2xl", f && "mx-auto"),
+				children: o
+			})
+		]
+	});
+}
+//#endregion
+export { i as SectionHeading };

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

@@ -0,0 +1,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.
+ */
+export * from './ActionGroup';
+export * from './SectionHeading';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

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

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

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

@@ -0,0 +1,67 @@
+import { ElementType, HTMLAttributes, ReactNode } from 'react';
+import { SidebarLayoutConfig } from './sidebar-layout-config';
+type BaseSidebarLayoutProps = SidebarLayoutConfig & Omit<HTMLAttributes<HTMLDivElement>, "color">;
+/**
+ * Props for the SidebarLayout component.
+ */
+export interface SidebarLayoutProps extends BaseSidebarLayoutProps {
+    /** The navigation column, typically the framework's `Sidebar`. */
+    sidebar: ReactNode;
+    /** Content above both columns, typically the framework's `Navbar`. */
+    header?: ReactNode;
+    /** Content below both columns. */
+    footer?: ReactNode;
+    /**
+     * Name of the navigation landmark the sidebar is rendered in.
+     * A shell usually holds one, so the name distinguishes it from the page's
+     * other navigation regions.
+     *
+     * @default "Sidebar"
+     */
+    sidebarLabel?: string;
+    /**
+     * Element to render the shell as.
+     * Defaults to a `div`.
+     *
+     * @default "div"
+     */
+    as?: ElementType;
+}
+/**
+ * An application shell with a persistent navigation column.
+ *
+ * The shell is a single column on a narrow screen and two columns from the `lg`
+ * breakpoint, with the navigation column sticky and independently scrollable on
+ * a wide screen. It deliberately stacks the navigation above the content on a
+ * narrow screen rather than hiding it behind an off-canvas drawer: the whole page
+ * then stays reachable with the keyboard, with no focus trap to get wrong.
+ *
+ * @param props - SidebarLayout configuration options and element attributes.
+ * @param props.sidebar - The navigation column.
+ * @param props.header - Content above both columns.
+ * @param props.footer - Content below both columns.
+ * @param props.sidebarLabel - Name of the navigation landmark. Defaults to
+ * "Sidebar".
+ * @param props.side - Side the navigation column sits on. Defaults to "start".
+ * @param props.sidebarWidth - Width of the navigation column. Defaults to "md".
+ * @param props.stickySidebar - Keep the column in view. Defaults to true.
+ * @param props.as - Element to render. Defaults to "div".
+ * @returns The rendered shell.
+ *
+ * @example
+ * ```tsx
+ * <SidebarLayout
+ *   header={<Navbar brand="Ashee SMS" links={links} />}
+ *   sidebar={<Sidebar items={items} activeKey="campaigns" />}>
+ *   <PageContent>
+ *     <Typography role="heading-lg">Campaigns</Typography>
+ *   </PageContent>
+ * </SidebarLayout>
+ * ```
+ *
+ * @see Sidebar - The navigation the column usually holds.
+ * @see Page - The single-column shell, for a page without navigation.
+ */
+export declare const SidebarLayout: import('react').ForwardRefExoticComponent<SidebarLayoutProps & import('react').RefAttributes<HTMLDivElement>>;
+export {};
+//# sourceMappingURL=SidebarLayout.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,40 @@
+"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 { 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";
+//#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,
+		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", {
+					className: l,
+					children: S
+				})]
+			}),
+			h
+		]
+	});
+});
+m.displayName = "SidebarLayout";
+//#endregion
+export { m as SidebarLayout };

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

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

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

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

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

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

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

@@ -0,0 +1,49 @@
+/**
+ * SidebarLayout component configuration for AsheeUI.
+ * This file defines the configuration type and defaults for the application
+ * shell that places a navigation column beside a page: side, sidebar width and
+ * stickiness. It registers the default configuration with the component registry
+ * and provides fallback values for the cascade resolution system.
+ */
+/**
+ * Side the navigation column sits on from the `lg` breakpoint upwards.
+ */
+export type SidebarLayoutSide = "start" | "end";
+/**
+ * Width of the navigation column.
+ */
+export type SidebarLayoutWidth = "sm" | "md" | "lg";
+/**
+ * Theme configuration options for the SidebarLayout component.
+ *
+ * Set under `components.sidebarlayout` in the AsheeUI config. Values feed the
+ * component-level fallback tier of the theme cascade.
+ */
+export interface SidebarLayoutConfig {
+    /** Side the navigation column sits on. @default "start" */
+    side?: SidebarLayoutSide;
+    /** Width of the navigation column. @default "md" */
+    sidebarWidth?: SidebarLayoutWidth;
+    /**
+     * Whether the navigation column stays in view while the content scrolls.
+     * Applies from the `lg` breakpoint upwards, where the column sits beside the
+     * content rather than above it.
+     *
+     * @default true
+     */
+    stickySidebar?: boolean;
+}
+/**
+ * Default config values registered for the SidebarLayout component.
+ */
+export declare const defaultSidebarLayoutConfig: SidebarLayoutConfig;
+declare module "../../libs/registry" {
+    interface ComponentTypeConfigRegistry {
+        sidebarlayout: SidebarLayoutConfig;
+    }
+}
+/**
+ * Hard fallback values used when no config tier provides a value.
+ */
+export declare const FALLBACK_SIDEBAR_LAYOUT_CONFIG: Required<SidebarLayoutConfig>;
+//# sourceMappingURL=sidebar-layout-config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sidebar-layout-config.d.ts","sourceRoot":"","sources":["../../../src/components/sidebar-layout/sidebar-layout-config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,KAAK,CAAC;AAEhD;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,2DAA2D;IAC3D,IAAI,CAAC,EAAE,iBAAiB,CAAC;IAEzB,oDAAoD;IACpD,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAElC;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,eAAO,MAAM,0BAA0B,EAAE,mBAIxC,CAAC;AAEF,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,aAAa,EAAE,mBAAmB,CAAC;KACpC;CACF;AAID;;GAEG;AACH,eAAO,MAAM,8BAA8B,EAAE,QAAQ,CAAC,mBAAmB,CAIxE,CAAC"}

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

@@ -0,0 +1,16 @@
+"use client";
+import { registerComponentDefaults as e } from "../../libs/registry.js";
+//#region src/components/sidebar-layout/sidebar-layout-config.ts
+var t = {
+	side: "start",
+	sidebarWidth: "md",
+	stickySidebar: !0
+};
+e("sidebarlayout", t);
+var n = {
+	side: "start",
+	sidebarWidth: "md",
+	stickySidebar: !0
+};
+//#endregion
+export { n as FALLBACK_SIDEBAR_LAYOUT_CONFIG, t as defaultSidebarLayoutConfig };

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

@@ -0,0 +1,21 @@
+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.
+ */
+export declare const SIDEBAR_LAYOUT_CLASS = "flex min-h-dvh w-full flex-col bg-background 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. */
+export declare const SIDEBAR_LAYOUT_ASIDE_END_CLASS = "lg:order-last";
+/** The separator of the navigation column on the leading edge. */
+export declare const SIDEBAR_LAYOUT_ASIDE_START_BORDER_CLASS = "lg:border-r";
+/** The separator of the navigation column on the trailing edge. */
+export declare const SIDEBAR_LAYOUT_ASIDE_END_BORDER_CLASS = "lg:border-l";
+/** Keeps the navigation column in view while the content scrolls. */
+export declare const SIDEBAR_LAYOUT_ASIDE_STICKY_CLASS = "lg:sticky lg:top-0 lg:h-dvh lg:overflow-y-auto";
+/** The content column. */
+export declare const SIDEBAR_LAYOUT_CONTENT_CLASS = "flex min-w-0 flex-1 flex-col";
+/** Width of the navigation column at each size, from `lg` upwards. */
+export declare const SIDEBAR_LAYOUT_WIDTH_CLASS: Record<SidebarLayoutWidth, string>;
+//# sourceMappingURL=sidebar-layout-styles.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +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 = {
+	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 };

package/dist/components/skeleton/Skeleton.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Skeleton.d.ts","sourceRoot":"","sources":["../../../src/components/skeleton/Skeleton.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,OAAO,CAAC;AAMxD,OAAO,EACL,KAAK,cAAc,EAEpB,MAAM,mBAAmB,CAAC;AAM3B,KAAK,iBAAiB,GAAG,cAAc,GACrC,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,iBAAiB;IACtD;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,eAAO,MAAM,QAAQ,0GAsDpB,CAAC"}
+{"version":3,"file":"Skeleton.d.ts","sourceRoot":"","sources":["../../../src/components/skeleton/Skeleton.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,OAAO,CAAC;AAMxD,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAM3B,KAAK,iBAAiB,GAAG,cAAc,GACrC,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,iBAAiB;IACtD;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,eAAO,MAAM,QAAQ,0GAsDpB,CAAC"}