asheeui 2.0.0 → 2.3.0

package/dist/components/data-table/DataTable.d.ts

@@ -1,137 +0,0 @@
-import { ElementType, HTMLAttributes, ReactNode } from 'react';
-import { ColumnDef, TableConfig } from '../table/table-config';
-import { DataTableConfig } from './data-table-config';
-/**
- * Props for the DataTable component.
- */
-export interface DataTableProps<TData> extends DataTableConfig, Pick<TableConfig, "variant" | "size" | "color" | "radius">, Omit<HTMLAttributes<HTMLDivElement>, "color" | "onClick" | "title"> {
-    /**
-     * The rows the table shows, in the order the consumer gives them.
-     * The table does not sort, because an order is a decision about the data and
-     * the consumer already has one.
-     */
-    data: TData[];
-    /**
-     * The columns, in order.
-     */
-    columns: ColumnDef<TData>[];
-    /**
-     * Heading above the toolbar.
-     */
-    title?: ReactNode;
-    /**
-     * Sentence under the heading.
-     */
-    description?: ReactNode;
-    /**
-     * Reads the text a row is searched by.
-     * Without it, and without `onSearchChange`, the search control is not
-     * rendered, because a field that cannot search would be a control that does
-     * nothing.
-     */
-    searchAccessor?: (row: TData) => string;
-    /**
-     * Called with the query whenever it changes.
-     * Supplying it is what a consumer that searches on the server does: the table
-     * then reports the query and leaves the filtering to the consumer.
-     */
-    onSearchChange?: (query: string) => void;
-    /**
-     * The page, for a consumer that owns it.
-     */
-    page?: number;
-    /**
-     * The page to open first, for a consumer that does not.
-     *
-     * @default 1
-     */
-    defaultPage?: number;
-    /**
-     * Called with the page the reader asked for.
-     */
-    onPageChange?: (page: number) => void;
-    /**
-     * Identifies a row, so the table can keep its rows stable as they change.
-     */
-    rowKeyAccessor?: (row: TData) => string | number;
-    /**
-     * Called when a row is activated, which also makes the rows interactive.
-     */
-    onRowClick?: (row: TData) => void;
-    /**
-     * Whether the rows are still loading.
-     * While they are, the table is replaced by a loading region rather than shown
-     * empty, because an empty table would say the wrong thing.
-     *
-     * @default false
-     */
-    isLoading?: boolean;
-    /**
-     * Controls the consumer places beside the search control.
-     */
-    toolbar?: ReactNode;
-    /**
-     * Element to render the wrapper as.
-     * Defaults to a `div`.
-     *
-     * @default "div"
-     */
-    as?: ElementType;
-}
-/**
- * A table a list page is built from.
- *
- * DataTable composes the framework's parts around `Table`: a search control, a
- * row count that is announced when it changes, pagination, a loading region and
- * an empty presentation. Nothing about the table itself is reimplemented, so a
- * consumer that restyles `Table`, `Pagination`, `EmptyState`, `LoadingState` or
- * `SearchInput` restyles the table too.
- *
- * Searching is client-side when `searchAccessor` is given and the consumer's own
- * when `onSearchChange` is given; the two may be combined, with the consumer
- * replacing the rows. A new query starts at the first page, because a query is a
- * new result set.
- *
- * @param props - DataTable configuration options and element attributes.
- * @param props.data - The rows, in the order they are shown.
- * @param props.columns - The columns, in order.
- * @param props.title - Heading above the toolbar.
- * @param props.description - Sentence under the heading.
- * @param props.searchAccessor - Reads the text a row is searched by.
- * @param props.onSearchChange - Called with the query as it changes.
- * @param props.page - The page, for a controlled consumer.
- * @param props.defaultPage - The page to open first. Defaults to 1.
- * @param props.onPageChange - Called with the page the reader asked for.
- * @param props.pageSize - How many rows a page holds. Defaults to 10.
- * @param props.paginated - Divide the rows into pages. Defaults to true.
- * @param props.showRowCount - Report how many rows are shown. Defaults to true.
- * @param props.isLoading - Replace the rows with a loading region. Defaults to
- * false.
- * @param props.toolbar - Controls placed beside the search control.
- * @param props.emptyTitle - What the table says when it has nothing to show.
- * @param props.emptyDescription - The sentence under that title.
- * @param props.as - Element to render. Defaults to "div".
- * @returns The rendered table.
- *
- * @example
- * ```tsx
- * <DataTable
- *   title="Invoices"
- *   description="Everything issued this quarter."
- *   data={invoices}
- *   columns={columns}
- *   searchAccessor={(invoice) => `${invoice.number} ${invoice.customer}`}
- *   rowKeyAccessor={(invoice) => invoice.id}
- *   onRowClick={(invoice) => open(invoice.id)}
- *   pageSize={20}
- * />
- * ```
- *
- * @see Table - The table itself, without the search, the count or the paging.
- * @see EmptyState - The presentation the table uses when it has no rows.
- */
-export declare function DataTable<TData>({ data, columns, title, description, searchAccessor, onSearchChange, page, defaultPage, onPageChange, rowKeyAccessor, onRowClick, pageSize, paginated, searchable, searchLabel, showRowCount, emptyTitle, emptyDescription, isLoading, toolbar, variant, size, color, radius, as, className, ...rest }: DataTableProps<TData>): import("react").JSX.Element;
-export declare namespace DataTable {
-    var displayName: string;
-}
-//# sourceMappingURL=DataTable.d.ts.map

package/dist/components/data-table/DataTable.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"DataTable.d.ts","sourceRoot":"","sources":["../../../src/components/data-table/DataTable.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,SAAS,EAGf,MAAM,OAAO,CAAC;AAUf,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpE,OAAO,EACL,KAAK,eAAe,EAErB,MAAM,qBAAqB,CAAC;AAW7B;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,KAAK,CACnC,SAAQ,eAAe,EACrB,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC,EAC1D,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;IACrE;;;;OAIG;IACH,IAAI,EAAE,KAAK,EAAE,CAAC;IAEd;;OAEG;IACH,OAAO,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;IAE5B;;OAEG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAElB;;OAEG;IACH,WAAW,CAAC,EAAE,SAAS,CAAC;IAExB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,MAAM,CAAC;IAExC;;;;OAIG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAEzC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAEtC;;OAEG;IACH,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,MAAM,GAAG,MAAM,CAAC;IAEjD;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;IAElC;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;IAEpB;;;;;OAKG;IACH,EAAE,CAAC,EAAE,WAAW,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,EAC/B,IAAI,EACJ,OAAO,EACP,KAAK,EACL,WAAW,EACX,cAAc,EACd,cAAc,EACd,IAAI,EACJ,WAAe,EACf,YAAY,EACZ,cAAc,EACd,UAAU,EACV,QAAQ,EACR,SAAS,EACT,UAAU,EACV,WAAW,EACX,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,SAAiB,EACjB,OAAO,EACP,OAAO,EACP,IAAI,EACJ,KAAK,EACL,MAAM,EACN,EAAE,EACF,SAAS,EACT,GAAG,IAAI,EACR,EAAE,cAAc,CAAC,KAAK,CAAC,+BAqJvB;yBAjLe,SAAS"}

package/dist/components/data-table/DataTable.js

@@ -1,101 +0,0 @@
-"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 { Typography as r } from "../typography/Typography.js";
-import { SectionHeading as i } from "../section-kit/SectionHeading.js";
-import { EmptyState as a } from "../empty-state/EmptyState.js";
-import { LoadingState as ee } from "../loading-state/LoadingState.js";
-import { Pagination as o } from "../pagination/Pagination.js";
-import { SearchInput as s } from "../search-input/SearchInput.js";
-import { Table as c } from "../table/Table.js";
-import { FALLBACK_DATA_TABLE_CONFIG as l } from "./data-table-config.js";
-import { DATA_TABLE_CLASS as u, DATA_TABLE_REGION_CLASS as d } from "./data-table-styles.js";
-import { useMemo as f, useState as p } from "react";
-import { jsx as m, jsxs as h } from "react/jsx-runtime";
-//#region src/components/data-table/DataTable.tsx
-function g({ data: g, columns: _, title: v, description: y, searchAccessor: b, onSearchChange: x, page: S, defaultPage: te = 1, onPageChange: C, rowKeyAccessor: w, onRowClick: T, pageSize: E, paginated: D, searchable: O, searchLabel: k, showRowCount: A, emptyTitle: j, emptyDescription: M, isLoading: N = !1, toolbar: P, variant: F, size: I, color: L, radius: R, as: ne, className: z, ...B }) {
-	let V = t(), H = n({
-		searchable: O,
-		searchLabel: k,
-		paginated: D,
-		pageSize: E,
-		showRowCount: A,
-		emptyTitle: j,
-		emptyDescription: M
-	}, V.components?.datatable, l), [U, W] = p(""), [G, K] = p(te), q = S ?? G, J = H.searchable && !!(b || x), Y = f(() => {
-		let e = U.trim().toLowerCase();
-		return !J || !b || !e ? g : g.filter((t) => b(t).toLowerCase().includes(e));
-	}, [
-		g,
-		U,
-		b,
-		J
-	]), X = Math.max(1, H.pageSize), Z = Math.max(1, Math.ceil(Y.length / X)), Q = Math.min(Math.max(1, q), Z), $ = H.paginated ? Y.slice((Q - 1) * X, Q * X) : Y, re = `Showing ${Y.length === 0 ? 0 : (Q - 1) * X + 1} to ${H.paginated ? Math.min(Q * X, Y.length) : Y.length} of ${Y.length}`, ie = (e) => {
-		W(e), Q !== 1 && (S === void 0 && K(1), C?.(1)), x?.(e);
-	}, ae = (e) => {
-		S === void 0 && K(e), C?.(e);
-	}, oe = ne ?? "div", se = !!(v || y);
-	return /* @__PURE__ */ h(oe, {
-		className: e(u, z),
-		...B,
-		children: [
-			se && /* @__PURE__ */ m("div", {
-				className: "flex flex-col gap-1",
-				children: /* @__PURE__ */ m(i, {
-					title: v,
-					description: y
-				})
-			}),
-			(J || P) && /* @__PURE__ */ m("div", {
-				className: "flex flex-col gap-3 sm:flex-row sm:items-center sm:justify-between",
-				children: /* @__PURE__ */ h("div", {
-					className: "flex w-full flex-col gap-2 sm:flex-row sm:items-center",
-					children: [J && /* @__PURE__ */ m(s, {
-						className: "w-full sm:max-w-sm",
-						label: H.searchLabel,
-						placeholder: H.searchLabel,
-						onValueChange: ie
-					}), P]
-				})
-			}),
-			/* @__PURE__ */ m("div", {
-				className: d,
-				children: N ? /* @__PURE__ */ m(ee, {}) : $.length === 0 ? /* @__PURE__ */ m(a, {
-					panel: !0,
-					title: H.emptyTitle,
-					description: H.emptyDescription
-				}) : /* @__PURE__ */ m(c, {
-					data: $,
-					columns: _,
-					variant: F,
-					size: I,
-					color: L,
-					radius: R,
-					rowKeyAccessor: w,
-					handleClick: T,
-					isClickable: !!T
-				})
-			}),
-			!N && (H.showRowCount || H.paginated) && /* @__PURE__ */ h("div", {
-				className: "flex flex-col gap-3 sm:flex-row sm:items-center sm:justify-between",
-				children: [H.showRowCount && /* @__PURE__ */ m("div", {
-					role: "status",
-					children: /* @__PURE__ */ m(r, {
-						role: "caption",
-						tone: "muted",
-						children: re
-					})
-				}), H.paginated && Z > 1 && /* @__PURE__ */ m(o, {
-					page: Q,
-					pageCount: Z,
-					onPageChange: ae
-				})]
-			})
-		]
-	});
-}
-g.displayName = "DataTable";
-//#endregion
-export { g as DataTable };

package/dist/components/data-table/data-table-config.d.ts

@@ -1,75 +0,0 @@
-/**
- * DataTable component configuration for AsheeUI.
- * This file defines the configuration type and defaults for the table
- * composition: whether it searches and pages, how many rows a page holds,
- * whether it reports the count, and what it says when there is nothing to show.
- * It registers the default configuration with the component registry and
- * provides fallback values for the cascade resolution system.
- */
-/**
- * Theme configuration options for the DataTable component.
- *
- * Set under `components.datatable` in the AsheeUI config. Values feed the
- * component-level tier of the theme cascade.
- */
-export interface DataTableConfig {
-    /**
-     * Whether the table offers a search control.
-     * The control appears only when the table also knows what to search, through
-     * `searchAccessor` or `onSearchChange`, because a field that cannot search
-     * would be a control that does nothing.
-     *
-     * @default true
-     */
-    searchable?: boolean;
-    /**
-     * Placeholder of the search control.
-     *
-     * @default "Search"
-     */
-    searchLabel?: string;
-    /**
-     * Whether the rows are divided into pages.
-     *
-     * @default true
-     */
-    paginated?: boolean;
-    /**
-     * How many rows a page holds.
-     *
-     * @default 10
-     */
-    pageSize?: number;
-    /**
-     * Whether the table reports how many rows it is showing.
-     *
-     * @default true
-     */
-    showRowCount?: boolean;
-    /**
-     * What the table says when there is nothing to show.
-     *
-     * @default "No results"
-     */
-    emptyTitle?: string;
-    /**
-     * The sentence under that title.
-     *
-     * @default "Try a different search, or clear it to see everything."
-     */
-    emptyDescription?: string;
-}
-/**
- * Default config values registered for the DataTable component.
- */
-export declare const defaultDataTableConfig: DataTableConfig;
-declare module "../../libs/registry" {
-    interface ComponentTypeConfigRegistry {
-        datatable: DataTableConfig;
-    }
-}
-/**
- * Hard fallback values used when no config tier provides a value.
- */
-export declare const FALLBACK_DATA_TABLE_CONFIG: Required<DataTableConfig>;
-//# sourceMappingURL=data-table-config.d.ts.map

package/dist/components/data-table/data-table-config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"data-table-config.d.ts","sourceRoot":"","sources":["../../../src/components/data-table/data-table-config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,eAQpC,CAAC;AAEF,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,SAAS,EAAE,eAAe,CAAC;KAC5B;CACF;AAID;;GAEG;AACH,eAAO,MAAM,0BAA0B,EAAE,QAAQ,CAAC,eAAe,CAQhE,CAAC"}

package/dist/components/data-table/data-table-config.js

@@ -1,24 +0,0 @@
-"use client";
-import { registerComponentDefaults as e } from "../../libs/registry.js";
-//#region src/components/data-table/data-table-config.ts
-var t = {
-	searchable: !0,
-	searchLabel: "Search",
-	paginated: !0,
-	pageSize: 10,
-	showRowCount: !0,
-	emptyTitle: "No results",
-	emptyDescription: "Try a different search, or clear it to see everything."
-};
-e("datatable", t);
-var n = {
-	searchable: !0,
-	searchLabel: "Search",
-	paginated: !0,
-	pageSize: 10,
-	showRowCount: !0,
-	emptyTitle: "No results",
-	emptyDescription: "Try a different search, or clear it to see everything."
-};
-//#endregion
-export { n as FALLBACK_DATA_TABLE_CONFIG, t as defaultDataTableConfig };

package/dist/components/data-table/data-table-styles.d.ts

@@ -1,25 +0,0 @@
-/**
- * DataTable component styles for AsheeUI.
- * This file provides the static class mappings for the table composition: the
- * wrapper, the toolbar above the table and its parts. The table itself keeps the
- * classes the `Table` component owns.
- */
-/** The wrapper. */
-export declare const DATA_TABLE_CLASS = "flex w-full min-w-0 flex-col gap-4";
-/** The heading above the toolbar. */
-export declare const DATA_TABLE_HEADING_CLASS = "flex flex-col gap-1";
-/**
- * The toolbar above the table.
- * The control and the count stack on a narrow screen and sit in a row from the
- * `sm` breakpoint.
- */
-export declare const DATA_TABLE_TOOLBAR_CLASS = "flex flex-col gap-3 sm:flex-row sm:items-center sm:justify-between";
-/** The group that holds the search control and the consumer's own controls. */
-export declare const DATA_TABLE_TOOLBAR_GROUP_CLASS = "flex w-full flex-col gap-2 sm:flex-row sm:items-center";
-/** The region that holds the table or the empty state. */
-export declare const DATA_TABLE_REGION_CLASS = "flex w-full min-w-0 flex-col gap-4";
-/** The row count, which sits under the table beside the pagination. */
-export declare const DATA_TABLE_FOOTER_CLASS = "flex flex-col gap-3 sm:flex-row sm:items-center sm:justify-between";
-/** Width the search control takes in the toolbar. */
-export declare const DATA_TABLE_SEARCH_CLASS = "w-full sm:max-w-sm";
-//# sourceMappingURL=data-table-styles.d.ts.map

package/dist/components/data-table/data-table-styles.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"data-table-styles.d.ts","sourceRoot":"","sources":["../../../src/components/data-table/data-table-styles.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,mBAAmB;AACnB,eAAO,MAAM,gBAAgB,uCAAuC,CAAC;AAErE,qCAAqC;AACrC,eAAO,MAAM,wBAAwB,wBAAwB,CAAC;AAE9D;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,uEACiC,CAAC;AAEvE,+EAA+E;AAC/E,eAAO,MAAM,8BAA8B,2DACe,CAAC;AAE3D,0DAA0D;AAC1D,eAAO,MAAM,uBAAuB,uCAAuC,CAAC;AAE5E,uEAAuE;AACvE,eAAO,MAAM,uBAAuB,uEACkC,CAAC;AAEvE,qDAAqD;AACrD,eAAO,MAAM,uBAAuB,uBAAuB,CAAC"}

package/dist/components/data-table/data-table-styles.js

@@ -1,5 +0,0 @@
-"use client";
-//#region src/components/data-table/data-table-styles.ts
-var e = "flex w-full min-w-0 flex-col gap-4", t = "flex flex-col gap-1", n = "flex flex-col gap-3 sm:flex-row sm:items-center sm:justify-between", r = "flex w-full flex-col gap-2 sm:flex-row sm:items-center", i = "flex w-full min-w-0 flex-col gap-4", a = "flex flex-col gap-3 sm:flex-row sm:items-center sm:justify-between", o = "w-full sm:max-w-sm";
-//#endregion
-export { e as DATA_TABLE_CLASS, a as DATA_TABLE_FOOTER_CLASS, t as DATA_TABLE_HEADING_CLASS, i as DATA_TABLE_REGION_CLASS, o as DATA_TABLE_SEARCH_CLASS, n as DATA_TABLE_TOOLBAR_CLASS, r as DATA_TABLE_TOOLBAR_GROUP_CLASS };

package/dist/components/data-table/index.d.ts

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

package/dist/components/data-table/index.d.ts.map

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

package/dist/components/data-table/index.js

@@ -1,3 +0,0 @@
-export * from "./DataTable.js";
-export * from "./data-table-config.js";
-export * from "./data-table-styles.js";

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

@@ -1,94 +0,0 @@
-import { ElementType, HTMLAttributes, ReactNode } from 'react';
-import { DocsLayoutConfig } from './docs-layout-config';
-type BaseDocsLayoutProps = DocsLayoutConfig & Omit<HTMLAttributes<HTMLDivElement>, "color">;
-/**
- * Props for the DocsLayout component.
- */
-export interface DocsLayoutProps extends BaseDocsLayoutProps {
-    /**
-     * The documentation navigation, typically a `Sidebar` of sections and pages.
-     */
-    navigation: ReactNode;
-    /**
-     * The table of contents of the current article.
-     * Left out, the composition is a two-column page; supplied, the contents take
-     * the third column on a large screen and are hidden below it.
-     */
-    toc?: ReactNode;
-    /**
-     * Content above everything, typically a `Navbar` with the site's brand and
-     * search.
-     */
-    header?: ReactNode;
-    /**
-     * Content below everything.
-     */
-    footer?: ReactNode;
-    /**
-     * The article.
-     */
-    children?: ReactNode;
-    /**
-     * Identifier of the article region, which the skip link points at.
-     *
-     * @default "main-content"
-     */
-    mainId?: string;
-    /**
-     * Element to render the page shell as.
-     * Defaults to a `div`.
-     *
-     * @default "div"
-     */
-    as?: ElementType;
-}
-/**
- * The arrangement a documentation page is built in.
- *
- * The composition is a navigation column, an article and, when one is supplied,
- * a table of contents. It composes the framework's application shell and split
- * layout, so the behaviour a documentation page depends on (the sticky
- * navigation, the stacked narrow-screen layout and the responsive columns) is
- * the behaviour those primitives already provide and test.
- *
- * Nothing but the table of contents is hidden from a narrow screen: the
- * navigation stays in the document above the article, so a keyboard reader
- * reaches it without a drawer to trap focus in. The contents repeat the
- * article's own headings, which stay in the article.
- *
- * @param props - DocsLayout configuration options and element attributes.
- * @param props.navigation - The documentation navigation.
- * @param props.toc - The table of contents of the current article.
- * @param props.header - Content above everything.
- * @param props.footer - Content below everything.
- * @param props.children - The article.
- * @param props.mainId - Identifier of the article region. Defaults to
- * "main-content".
- * @param props.navigationLabel - Name of the navigation landmark. Defaults to
- * "Documentation".
- * @param props.tocLabel - Name of the contents landmark. Defaults to "On this
- * page".
- * @param props.navigationWidth - Width of the navigation column from `lg`.
- * Defaults to "md".
- * @param props.stickyToc - Keep the contents in view. Defaults to true.
- * @param props.skipLink - Render a skip link. Defaults to true.
- * @param props.as - Element to render. Defaults to "div".
- * @returns The rendered page.
- *
- * @example
- * ```tsx
- * <DocsLayout
- *   header={<Navbar brand="AsheeUI" links={links} />}
- *   navigation={<Sidebar items={sections} activeKey="layout" />}
- *   toc={<TableOfContents items={headings} />}>
- *   <Typography role="display">Layout</Typography>
- *   <Typography role="body-md">A page is composed from the layout layer.</Typography>
- * </DocsLayout>
- * ```
- *
- * @see MarketingLayout - The marketing composition.
- * @see SidebarLayout - The application shell the composition builds on.
- */
-export declare const DocsLayout: import('react').ForwardRefExoticComponent<DocsLayoutProps & import('react').RefAttributes<HTMLDivElement>>;
-export {};
-//# sourceMappingURL=DocsLayout.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"DocsLayout.d.ts","sourceRoot":"","sources":["../../../src/components/docs-layout/DocsLayout.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EACL,KAAK,WAAW,EAEhB,KAAK,cAAc,EACnB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAOf,OAAO,EACL,KAAK,gBAAgB,EAEtB,MAAM,sBAAsB,CAAC;AAU9B,KAAK,mBAAmB,GAAG,gBAAgB,GACzC,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,mBAAmB;IAC1D;;OAEG;IACH,UAAU,EAAE,SAAS,CAAC;IAEtB;;;;OAIG;IACH,GAAG,CAAC,EAAE,SAAS,CAAC;IAEhB;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;IAEnB;;OAEG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IAErB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;OAKG;IACH,EAAE,CAAC,EAAE,WAAW,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,eAAO,MAAM,UAAU,4GAuFtB,CAAC"}

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

@@ -1,62 +0,0 @@
-"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 { SkipLink as r } from "../section-kit/SkipLink.js";
-import { SidebarLayout as i } from "../sidebar-layout/SidebarLayout.js";
-import { Split as a } from "../split/Split.js";
-import { FALLBACK_DOCS_LAYOUT_CONFIG as o } from "./docs-layout-config.js";
-import { DOCS_LAYOUT_ARTICLE_CLASS as s, DOCS_LAYOUT_BODY_CLASS as c, DOCS_LAYOUT_CLASS as l, DOCS_LAYOUT_SHELL_CLASS as u, DOCS_LAYOUT_TOC_CLASS as d } from "./docs-layout-styles.js";
-import { forwardRef as f } from "react";
-import { jsx as p, jsxs as m } from "react/jsx-runtime";
-//#region src/components/docs-layout/DocsLayout.tsx
-var h = f(({ navigation: f, toc: h, header: g, footer: _, children: v, mainId: y = "main-content", navigationLabel: b, tocLabel: x, navigationWidth: S, stickyToc: C, skipLink: w, skipLinkLabel: T, as: E, className: D, ...O }, k) => {
-	let A = t(), j = n({
-		navigationLabel: b,
-		tocLabel: x,
-		navigationWidth: S,
-		stickyToc: C,
-		skipLink: w,
-		skipLinkLabel: T
-	}, A.components?.docslayout, o), M = /* @__PURE__ */ p("main", {
-		id: y,
-		tabIndex: -1,
-		className: s,
-		children: /* @__PURE__ */ p("div", {
-			className: c,
-			children: v
-		})
-	});
-	return /* @__PURE__ */ m(E ?? "div", {
-		ref: k,
-		className: e(l, D),
-		...O,
-		children: [j.skipLink && /* @__PURE__ */ p(r, {
-			targetId: y,
-			label: j.skipLinkLabel
-		}), /* @__PURE__ */ p(i, {
-			className: u,
-			header: g,
-			footer: _,
-			sidebar: f,
-			sidebarLabel: j.navigationLabel,
-			sidebarWidth: j.navigationWidth,
-			children: h ? /* @__PURE__ */ p(a, {
-				stackAt: "xl",
-				ratio: "start",
-				gap: "xl",
-				align: "start",
-				start: M,
-				end: /* @__PURE__ */ p("aside", {
-					"aria-label": j.tocLabel,
-					className: e(d, j.stickyToc && "xl:sticky xl:top-0 xl:self-start"),
-					children: h
-				})
-			}) : M
-		})]
-	});
-});
-h.displayName = "DocsLayout";
-//#endregion
-export { h as DocsLayout };

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

@@ -1,61 +0,0 @@
-import { SidebarLayoutWidth } from '../sidebar-layout/sidebar-layout-config';
-/**
- * Theme configuration options for the DocsLayout component.
- *
- * Set under `components.docslayout` in the AsheeUI config. Values feed the
- * component-level tier of the theme cascade.
- */
-export interface DocsLayoutConfig {
-    /**
-     * Name of the navigation landmark.
-     * It distinguishes the documentation navigation from the other navigation
-     * regions a page may have.
-     *
-     * @default "Documentation"
-     */
-    navigationLabel?: string;
-    /**
-     * Name of the table of contents landmark.
-     *
-     * @default "On this page"
-     */
-    tocLabel?: string;
-    /**
-     * Width of the navigation column from the `lg` breakpoint upwards.
-     *
-     * @default "md"
-     */
-    navigationWidth?: SidebarLayoutWidth;
-    /**
-     * Whether the table of contents stays in view while the article scrolls.
-     *
-     * @default true
-     */
-    stickyToc?: boolean;
-    /**
-     * Whether the composition renders a skip link to its main region.
-     *
-     * @default true
-     */
-    skipLink?: boolean;
-    /**
-     * Wording of the skip link.
-     *
-     * @default "Skip to content"
-     */
-    skipLinkLabel?: string;
-}
-/**
- * Default config values registered for the DocsLayout component.
- */
-export declare const defaultDocsLayoutConfig: DocsLayoutConfig;
-declare module "../../libs/registry" {
-    interface ComponentTypeConfigRegistry {
-        docslayout: DocsLayoutConfig;
-    }
-}
-/**
- * Hard fallback values used when no config tier provides a value.
- */
-export declare const FALLBACK_DOCS_LAYOUT_CONFIG: Required<DocsLayoutConfig>;
-//# sourceMappingURL=docs-layout-config.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"docs-layout-config.d.ts","sourceRoot":"","sources":["../../../src/components/docs-layout/docs-layout-config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAElF;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,eAAe,CAAC,EAAE,kBAAkB,CAAC;IAErC;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,gBAOrC,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,CAOlE,CAAC"}

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

@@ -1,22 +0,0 @@
-"use client";
-import { registerComponentDefaults as e } from "../../libs/registry.js";
-//#region src/components/docs-layout/docs-layout-config.ts
-var t = {
-	navigationLabel: "Documentation",
-	tocLabel: "On this page",
-	navigationWidth: "md",
-	stickyToc: !0,
-	skipLink: !0,
-	skipLinkLabel: "Skip to content"
-};
-e("docslayout", t);
-var n = {
-	navigationLabel: "Documentation",
-	tocLabel: "On this page",
-	navigationWidth: "md",
-	stickyToc: !0,
-	skipLink: !0,
-	skipLinkLabel: "Skip to content"
-};
-//#endregion
-export { n as FALLBACK_DOCS_LAYOUT_CONFIG, t as defaultDocsLayoutConfig };