@askrjs/themes 0.0.25 → 0.0.28

package/dist/components/page/page.d.ts

@@ -1,6 +1,7 @@
 import { PageProps } from "./page.types.js";
 import { JSX } from "@askrjs/askr/jsx-runtime";
 //#region src/components/page/page.d.ts
+/** Top-level page wrapper: a growing `<main>` containing a {@link Container} with vertical page padding and content spacing. */
 declare function Page(props: PageProps): JSX.Element;
 //#endregion
 export { Page };

package/dist/components/page/page.js

@@ -2,6 +2,7 @@ import { Block } from "../block/block.js";
 import { Container } from "../container/container.js";
 import { jsx } from "@askrjs/askr/jsx-runtime";
 //#region src/components/page/page.tsx
+/** Top-level page wrapper: a growing `<main>` containing a {@link Container} with vertical page padding and content spacing. */
 function Page(props) {
 	const { children, ...rest } = props;
 	return /* @__PURE__ */ jsx(Block, {

package/dist/components/page/page.js.map

@@ -1 +1 @@
-{"version":3,"file":"page.js","names":[],"sources":["../../../src/components/page/page.tsx"],"sourcesContent":["import type { JSX } from \"@askrjs/askr/jsx-runtime\";\nimport { Block } from \"../block\";\nimport { Container } from \"../container\";\nimport type { PageProps } from \"./page.types\";\n\nexport function Page(props: PageProps): JSX.Element {\n  const { children, ...rest } = props;\n\n  return (\n    <Block as=\"main\" grow {...rest} data-slot=\"page\">\n      <Container>\n        <Block paddingY=\"xl\" gap=\"lg\">\n          {children}\n        </Block>\n      </Container>\n    </Block>\n  );\n}\n"],"mappings":";;;;AAKA,SAAgB,KAAK,OAA+B;CAClD,MAAM,EAAE,UAAU,GAAG,SAAS;CAE9B,OACE,oBAAC,OAAD;EAAO,IAAG;EAAO,MAAA;EAAK,GAAI;EAAM,aAAU;EACxC,UAAA,oBAAC,WAAD,EAAA,UACE,oBAAC,OAAD;GAAO,UAAS;GAAK,KAAI;GACtB;EACI,CAAA,EACE,CAAA;CACN,CAAA;AAEX"}
+{"version":3,"file":"page.js","names":[],"sources":["../../../src/components/page/page.tsx"],"sourcesContent":["import type { JSX } from \"@askrjs/askr/jsx-runtime\";\nimport { Block } from \"../block\";\nimport { Container } from \"../container\";\nimport type { PageProps } from \"./page.types\";\n\n/** Top-level page wrapper: a growing `<main>` containing a {@link Container} with vertical page padding and content spacing. */\nexport function Page(props: PageProps): JSX.Element {\n  const { children, ...rest } = props;\n\n  return (\n    <Block as=\"main\" grow {...rest} data-slot=\"page\">\n      <Container>\n        <Block paddingY=\"xl\" gap=\"lg\">\n          {children}\n        </Block>\n      </Container>\n    </Block>\n  );\n}\n"],"mappings":";;;;;AAMA,SAAgB,KAAK,OAA+B;CAClD,MAAM,EAAE,UAAU,GAAG,SAAS;CAE9B,OACE,oBAAC,OAAD;EAAO,IAAG;EAAO,MAAA;EAAK,GAAI;EAAM,aAAU;EACxC,UAAA,oBAAC,WAAD,EAAA,UACE,oBAAC,OAAD;GAAO,UAAS;GAAK,KAAI;GACtB;EACI,CAAA,EACE,CAAA;CACN,CAAA;AAEX"}

package/dist/components/page/page.types.d.ts

@@ -1,6 +1,7 @@
 import { MainProps } from "../main/main.types.js";
 import "../main/index.js";
 //#region src/components/page/page.types.d.ts
+/** Props for the {@link Page} component. */
 type PageProps = MainProps;
 //#endregion
 export { PageProps };

package/dist/components/page-header/page-header.d.ts

@@ -1,6 +1,7 @@
 import { PageHeaderProps } from "./page-header.types.js";
 import { JSX } from "@askrjs/askr/jsx-runtime";
 //#region src/components/page-header/page-header.d.ts
+/** Page-level header with a title, optional description, and an actions row that wraps to a new line on small screens. */
 declare function PageHeader(props: PageHeaderProps): JSX.Element;
 //#endregion
 export { PageHeader };

package/dist/components/page-header/page-header.js

@@ -1,6 +1,7 @@
 import { Block } from "../block/block.js";
 import { jsx, jsxs } from "@askrjs/askr/jsx-runtime";
 //#region src/components/page-header/page-header.tsx
+/** Page-level header with a title, optional description, and an actions row that wraps to a new line on small screens. */
 function PageHeader(props) {
 	const { title, description, actions, ...rest } = props;
 	return /* @__PURE__ */ jsxs(Block, {

package/dist/components/page-header/page-header.js.map

@@ -1 +1 @@
-{"version":3,"file":"page-header.js","names":[],"sources":["../../../src/components/page-header/page-header.tsx"],"sourcesContent":["import type { JSX } from \"@askrjs/askr/jsx-runtime\";\nimport { Block } from \"../block\";\nimport type { PageHeaderProps } from \"./page-header.types\";\n\nexport function PageHeader(props: PageHeaderProps): JSX.Element {\n  const { title, description, actions, ...rest } = props;\n\n  return (\n    <Block\n      rowFrom=\"md\"\n      align={{ base: \"start\", md: \"center\" }}\n      justify=\"between\"\n      gap=\"lg\"\n      {...rest}\n      data-slot=\"page-header\"\n    >\n      <Block gap=\"xs\" data-slot=\"page-header-copy\">\n        <h1 data-slot=\"page-header-title\">{title}</h1>\n        {description !== undefined ? (\n          <p data-slot=\"page-header-description\">{description}</p>\n        ) : null}\n      </Block>\n      {actions !== undefined ? (\n        <Block direction=\"row\" gap=\"sm\" data-slot=\"page-header-actions\">\n          {actions}\n        </Block>\n      ) : null}\n    </Block>\n  );\n}\n"],"mappings":";;;AAIA,SAAgB,WAAW,OAAqC;CAC9D,MAAM,EAAE,OAAO,aAAa,SAAS,GAAG,SAAS;CAEjD,OACE,qBAAC,OAAD;EACE,SAAQ;EACR,OAAO;GAAE,MAAM;GAAS,IAAI;EAAS;EACrC,SAAQ;EACR,KAAI;EACJ,GAAI;EACJ,aAAU;EANZ,UAAA,CAQE,qBAAC,OAAD;GAAO,KAAI;GAAK,aAAU;GAA1B,UAAA,CACE,oBAAC,MAAD;IAAI,aAAU;IAAqB,UAAA;GAAU,CAAA,GAC5C,gBAAgB,KAAA,IACf,oBAAC,KAAD;IAAG,aAAU;IAA2B,UAAA;GAAe,CAAA,IACrD,IACC;EACN,CAAA,GAAA,YAAY,KAAA,IACX,oBAAC,OAAD;GAAO,WAAU;GAAM,KAAI;GAAK,aAAU;GACvC,UAAA;EACI,CAAA,IACL,IACC;;AAEX"}
+{"version":3,"file":"page-header.js","names":[],"sources":["../../../src/components/page-header/page-header.tsx"],"sourcesContent":["import type { JSX } from \"@askrjs/askr/jsx-runtime\";\nimport { Block } from \"../block\";\nimport type { PageHeaderProps } from \"./page-header.types\";\n\n/** Page-level header with a title, optional description, and an actions row that wraps to a new line on small screens. */\nexport function PageHeader(props: PageHeaderProps): JSX.Element {\n  const { title, description, actions, ...rest } = props;\n\n  return (\n    <Block\n      rowFrom=\"md\"\n      align={{ base: \"start\", md: \"center\" }}\n      justify=\"between\"\n      gap=\"lg\"\n      {...rest}\n      data-slot=\"page-header\"\n    >\n      <Block gap=\"xs\" data-slot=\"page-header-copy\">\n        <h1 data-slot=\"page-header-title\">{title}</h1>\n        {description !== undefined ? (\n          <p data-slot=\"page-header-description\">{description}</p>\n        ) : null}\n      </Block>\n      {actions !== undefined ? (\n        <Block direction=\"row\" gap=\"sm\" data-slot=\"page-header-actions\">\n          {actions}\n        </Block>\n      ) : null}\n    </Block>\n  );\n}\n"],"mappings":";;;;AAKA,SAAgB,WAAW,OAAqC;CAC9D,MAAM,EAAE,OAAO,aAAa,SAAS,GAAG,SAAS;CAEjD,OACE,qBAAC,OAAD;EACE,SAAQ;EACR,OAAO;GAAE,MAAM;GAAS,IAAI;EAAS;EACrC,SAAQ;EACR,KAAI;EACJ,GAAI;EACJ,aAAU;EANZ,UAAA,CAQE,qBAAC,OAAD;GAAO,KAAI;GAAK,aAAU;GAA1B,UAAA,CACE,oBAAC,MAAD;IAAI,aAAU;IAAqB,UAAA;GAAU,CAAA,GAC5C,gBAAgB,KAAA,IACf,oBAAC,KAAD;IAAG,aAAU;IAA2B,UAAA;GAAe,CAAA,IACrD,IACC;EACN,CAAA,GAAA,YAAY,KAAA,IACX,oBAAC,OAAD;GAAO,WAAU;GAAM,KAAI;GAAK,aAAU;GACvC,UAAA;EACI,CAAA,IACL,IACC;;AAEX"}

package/dist/components/page-header/page-header.types.d.ts

@@ -1,6 +1,7 @@
 import { BlockDivProps } from "../block/block.types.js";
 import "../block/index.js";
 //#region src/components/page-header/page-header.types.d.ts
+/** Props for the {@link PageHeader} component. */
 type PageHeaderProps = BlockDivProps & {
   title: unknown;
   description?: unknown;

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

@@ -1,6 +1,7 @@
 import { SectionProps } from "./section.types.js";
 import { JSX } from "@askrjs/askr/jsx-runtime";
 //#region src/components/section/section.d.ts
+/** Renders a `<section>`-element {@link Block} with vertical spacing between children and page padding. */
 declare function Section(props: SectionProps): JSX.Element;
 //#endregion
 export { Section };

package/dist/components/section/section.js

@@ -1,6 +1,7 @@
 import { Block } from "../block/block.js";
 import { jsx } from "@askrjs/askr/jsx-runtime";
 //#region src/components/section/section.tsx
+/** Renders a `<section>`-element {@link Block} with vertical spacing between children and page padding. */
 function Section(props) {
 	const { children, ...rest } = props;
 	return /* @__PURE__ */ jsx(Block, {

package/dist/components/section/section.js.map

@@ -1 +1 @@
-{"version":3,"file":"section.js","names":[],"sources":["../../../src/components/section/section.tsx"],"sourcesContent":["import type { JSX } from \"@askrjs/askr/jsx-runtime\";\nimport { Block } from \"../block\";\nimport type { SectionProps } from \"./section.types\";\n\nexport function Section(props: SectionProps): JSX.Element {\n  const { children, ...rest } = props;\n\n  return (\n    <Block as=\"section\" gap=\"lg\" paddingY=\"xl\" {...rest} data-slot=\"section\">\n      {children}\n    </Block>\n  );\n}\n"],"mappings":";;;AAIA,SAAgB,QAAQ,OAAkC;CACxD,MAAM,EAAE,UAAU,GAAG,SAAS;CAE9B,OACE,oBAAC,OAAD;EAAO,IAAG;EAAU,KAAI;EAAK,UAAS;EAAK,GAAI;EAAM,aAAU;EAC5D;CACI,CAAA;AAEX"}
+{"version":3,"file":"section.js","names":[],"sources":["../../../src/components/section/section.tsx"],"sourcesContent":["import type { JSX } from \"@askrjs/askr/jsx-runtime\";\nimport { Block } from \"../block\";\nimport type { SectionProps } from \"./section.types\";\n\n/** Renders a `<section>`-element {@link Block} with vertical spacing between children and page padding. */\nexport function Section(props: SectionProps): JSX.Element {\n  const { children, ...rest } = props;\n\n  return (\n    <Block as=\"section\" gap=\"lg\" paddingY=\"xl\" {...rest} data-slot=\"section\">\n      {children}\n    </Block>\n  );\n}\n"],"mappings":";;;;AAKA,SAAgB,QAAQ,OAAkC;CACxD,MAAM,EAAE,UAAU,GAAG,SAAS;CAE9B,OACE,oBAAC,OAAD;EAAO,IAAG;EAAU,KAAI;EAAK,UAAS;EAAK,GAAI;EAAM,aAAU;EAC5D;CACI,CAAA;AAEX"}

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

@@ -1,6 +1,7 @@
 import { BlockElementProps } from "../block/block.types.js";
 import "../block/index.js";
 //#region src/components/section/section.types.d.ts
+/** Props for the {@link Section} component. */
 type SectionProps = Omit<BlockElementProps<"section">, "as">;
 //#endregion
 export { SectionProps };

package/dist/components/separator/separator.d.ts

@@ -1,6 +1,11 @@
 import { SeparatorAsChildProps, SeparatorNativeProps } from "./separator.types.js";
 import { JSX } from "@askrjs/askr/jsx-runtime";
 //#region src/components/separator/separator.d.ts
+/**
+ * Visual divider, defaulting to horizontal `role="separator"`; pass
+ * `decorative` to drop the semantic role, or `asChild` to merge onto a
+ * single child element.
+ */
 declare function Separator(props: SeparatorNativeProps): JSX.Element;
 declare function Separator(props: SeparatorAsChildProps): JSX.Element;
 //#endregion

package/dist/components/separator/separator.js.map

@@ -1 +1 @@
-{"version":3,"file":"separator.js","names":[],"sources":["../../../src/components/separator/separator.tsx"],"sourcesContent":["import type { JSX } from \"@askrjs/askr/jsx-runtime\";\nimport { Slot } from \"@askrjs/askr/foundations\";\nimport { mergeProps } from \"../_internal/merge-props\";\nimport { intrinsicElement } from \"../_internal/jsx\";\nimport type { SeparatorAsChildProps, SeparatorNativeProps } from \"./separator.types\";\n\nexport function Separator(props: SeparatorNativeProps): JSX.Element;\nexport function Separator(props: SeparatorAsChildProps): JSX.Element;\nexport function Separator(props: SeparatorNativeProps | SeparatorAsChildProps) {\n  const { asChild, children, decorative = false, orientation = \"horizontal\", ref, ...rest } = props;\n\n  const finalProps = mergeProps(rest, {\n    ref,\n    \"data-slot\": \"separator\",\n    \"data-orientation\": orientation,\n    role: decorative ? \"presentation\" : \"separator\",\n    \"aria-orientation\": decorative ? undefined : orientation,\n  });\n\n  if (asChild) {\n    return <Slot asChild {...finalProps} children={children} />;\n  }\n\n  return intrinsicElement(\"div\", finalProps, children);\n}\n"],"mappings":";;;;;AAQA,SAAgB,UAAU,OAAqD;CAC7E,MAAM,EAAE,SAAS,UAAU,aAAa,OAAO,cAAc,cAAc,KAAK,GAAG,SAAS;CAE5F,MAAM,aAAa,WAAW,MAAM;EAClC;EACA,aAAa;EACb,oBAAoB;EACpB,MAAM,aAAa,iBAAiB;EACpC,oBAAoB,aAAa,KAAA,IAAY;CAC/C,CAAC;CAED,IAAI,SACF,OAAO,oBAAC,MAAD;EAAM,SAAA;EAAQ,GAAI;EAAsB;CAAW,CAAA;CAG5D,OAAO,iBAAiB,OAAO,YAAY,QAAQ;AACrD"}
+{"version":3,"file":"separator.js","names":[],"sources":["../../../src/components/separator/separator.tsx"],"sourcesContent":["import type { JSX } from \"@askrjs/askr/jsx-runtime\";\nimport { Slot } from \"@askrjs/askr/foundations\";\nimport { mergeProps } from \"../_internal/merge-props\";\nimport { intrinsicElement } from \"../_internal/jsx\";\nimport type { SeparatorAsChildProps, SeparatorNativeProps } from \"./separator.types\";\n\n/**\n * Visual divider, defaulting to horizontal `role=\"separator\"`; pass\n * `decorative` to drop the semantic role, or `asChild` to merge onto a\n * single child element.\n */\nexport function Separator(props: SeparatorNativeProps): JSX.Element;\nexport function Separator(props: SeparatorAsChildProps): JSX.Element;\nexport function Separator(props: SeparatorNativeProps | SeparatorAsChildProps) {\n  const { asChild, children, decorative = false, orientation = \"horizontal\", ref, ...rest } = props;\n\n  const finalProps = mergeProps(rest, {\n    ref,\n    \"data-slot\": \"separator\",\n    \"data-orientation\": orientation,\n    role: decorative ? \"presentation\" : \"separator\",\n    \"aria-orientation\": decorative ? undefined : orientation,\n  });\n\n  if (asChild) {\n    return <Slot asChild {...finalProps} children={children} />;\n  }\n\n  return intrinsicElement(\"div\", finalProps, children);\n}\n"],"mappings":";;;;;AAaA,SAAgB,UAAU,OAAqD;CAC7E,MAAM,EAAE,SAAS,UAAU,aAAa,OAAO,cAAc,cAAc,KAAK,GAAG,SAAS;CAE5F,MAAM,aAAa,WAAW,MAAM;EAClC;EACA,aAAa;EACb,oBAAoB;EACpB,MAAM,aAAa,iBAAiB;EACpC,oBAAoB,aAAa,KAAA,IAAY;CAC/C,CAAC;CAED,IAAI,SACF,OAAO,oBAAC,MAAD;EAAM,SAAA;EAAQ,GAAI;EAAsB;CAAW,CAAA;CAG5D,OAAO,iBAAiB,OAAO,YAAY,QAAQ;AACrD"}

package/dist/components/separator/separator.types.d.ts

@@ -2,20 +2,24 @@ import { JSX } from "@askrjs/askr/jsx-runtime";
 import { JSXElement } from "@askrjs/askr/foundations";
 import { Ref } from "@askrjs/askr/foundations/utilities";
 //#region src/components/separator/separator.types.d.ts
+/** Props shared by both {@link Separator} call signatures. */
 type SeparatorOwnProps = {
   decorative?: boolean;
   orientation?: "horizontal" | "vertical";
   children?: unknown;
 };
+/** Props for {@link Separator} rendered as its default `<div>` element. */
 type SeparatorNativeProps = Omit<JSX.IntrinsicElements["div"], "children" | "ref"> & SeparatorOwnProps & {
   asChild?: false;
   ref?: Ref<HTMLDivElement>;
 };
+/** Props for {@link Separator} rendered with `asChild`, merging its attributes onto a single child element. */
 type SeparatorAsChildProps = SeparatorOwnProps & {
   asChild: true;
   children: JSXElement;
   ref?: Ref<unknown>;
 };
+/** Union of all prop shapes accepted by {@link Separator}. */
 type SeparatorProps = SeparatorNativeProps | SeparatorAsChildProps;
 //#endregion
 export { SeparatorAsChildProps, SeparatorNativeProps, SeparatorOwnProps, SeparatorProps };

package/dist/components/sidebar/sidebar.d.ts

@@ -1,21 +1,37 @@
 import { SidebarButtonProps, SidebarPartProps, SidebarProps } from "./sidebar.types.js";
 import { JSX } from "@askrjs/askr/jsx-runtime";
 //#region src/components/sidebar/sidebar.d.ts
+/** Root `<aside>` sidebar layout with configurable width, side, collapse behavior, and visual variant, exposed as data attributes for CSS. */
 declare function Sidebar(props: SidebarProps): JSX.Element;
+/** Scoping wrapper that establishes the sidebar's CSS/context boundary. */
 declare function SidebarScope(props: SidebarPartProps): JSX.Element;
+/** Renders the `<main>` content area beside the {@link Sidebar}. */
 declare function SidebarInset(props: SidebarPartProps): JSX.Element;
+/** Renders the scrollable content region of a {@link Sidebar}. */
 declare function SidebarContent(props: SidebarPartProps): JSX.Element;
+/** Renders the header region of a {@link Sidebar}. */
 declare function SidebarHeader(props: SidebarPartProps): JSX.Element;
+/** Renders the footer region of a {@link Sidebar}. */
 declare function SidebarFooter(props: SidebarPartProps): JSX.Element;
+/** Groups related {@link SidebarMenu} items together. */
 declare function SidebarGroup(props: SidebarPartProps): JSX.Element;
+/** Renders the label for a {@link SidebarGroup}. */
 declare function SidebarGroupLabel(props: SidebarPartProps): JSX.Element;
+/** Renders the content region of a {@link SidebarGroup}. */
 declare function SidebarGroupContent(props: SidebarPartProps): JSX.Element;
+/** Renders a `<ul>` list of {@link SidebarMenuItem}s. */
 declare function SidebarMenu(props: SidebarPartProps): JSX.Element;
+/** Renders a single `<li>` entry within a {@link SidebarMenu}. */
 declare function SidebarMenuItem(props: SidebarPartProps): JSX.Element;
+/** Clickable menu button within a {@link SidebarMenuItem}; supports `active`/`size`/`variant` state and an optional tooltip. */
 declare function SidebarMenuButton(props: SidebarButtonProps): JSX.Element;
+/** Renders a secondary action button attached to a {@link SidebarMenuItem}, with an optional tooltip. */
 declare function SidebarMenuAction(props: SidebarButtonProps): JSX.Element;
+/** Renders a status badge attached to a {@link SidebarMenuItem}. */
 declare function SidebarMenuBadge(props: SidebarPartProps): JSX.Element;
+/** Renders a draggable/clickable rail along the sidebar's edge for resizing or toggling it. */
 declare function SidebarRail(props: SidebarButtonProps): JSX.Element;
+/** Icon button that toggles the {@link Sidebar}'s open/collapsed state, with an optional tooltip. */
 declare function SidebarTrigger(props: SidebarButtonProps): JSX.Element;
 //#endregion
 export { Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarRail, SidebarScope, SidebarTrigger };

package/dist/components/sidebar/sidebar.js

@@ -24,6 +24,7 @@ function sidebarPart(props, slot, element = "div") {
 	});
 	return intrinsicElement(String(as ?? element), finalProps, children);
 }
+/** Root `<aside>` sidebar layout with configurable width, side, collapse behavior, and visual variant, exposed as data attributes for CSS. */
 function Sidebar(props) {
 	const { children, collapsible = "offcanvas", side = "left", variant = "sidebar", width = "sidebar", shrink = false, ...rest } = props;
 	return /* @__PURE__ */ jsx(Block, {
@@ -42,36 +43,47 @@ function Sidebar(props) {
 		children
 	});
 }
+/** Scoping wrapper that establishes the sidebar's CSS/context boundary. */
 function SidebarScope(props) {
 	return sidebarPart(props, "sidebar-scope");
 }
+/** Renders the `<main>` content area beside the {@link Sidebar}. */
 function SidebarInset(props) {
 	return sidebarPart(props, "sidebar-inset", "main");
 }
+/** Renders the scrollable content region of a {@link Sidebar}. */
 function SidebarContent(props) {
 	return sidebarPart(props, "sidebar-content");
 }
+/** Renders the header region of a {@link Sidebar}. */
 function SidebarHeader(props) {
 	return sidebarPart(props, "sidebar-header");
 }
+/** Renders the footer region of a {@link Sidebar}. */
 function SidebarFooter(props) {
 	return sidebarPart(props, "sidebar-footer");
 }
+/** Groups related {@link SidebarMenu} items together. */
 function SidebarGroup(props) {
 	return sidebarPart(props, "sidebar-group");
 }
+/** Renders the label for a {@link SidebarGroup}. */
 function SidebarGroupLabel(props) {
 	return sidebarPart(props, "sidebar-group-label");
 }
+/** Renders the content region of a {@link SidebarGroup}. */
 function SidebarGroupContent(props) {
 	return sidebarPart(props, "sidebar-group-content");
 }
+/** Renders a `<ul>` list of {@link SidebarMenuItem}s. */
 function SidebarMenu(props) {
 	return sidebarPart(props, "sidebar-menu", "ul");
 }
+/** Renders a single `<li>` entry within a {@link SidebarMenu}. */
 function SidebarMenuItem(props) {
 	return sidebarPart(props, "sidebar-menu-item", "li");
 }
+/** Clickable menu button within a {@link SidebarMenuItem}; supports `active`/`size`/`variant` state and an optional tooltip. */
 function SidebarMenuButton(props) {
 	const { active, asChild, children, class: className, size, tooltip, tooltipSide, type = "button", variant, ...rest } = props;
 	const finalProps = mergeProps(normalizeAriaProps(rest), {
@@ -93,6 +105,7 @@ function SidebarMenuButton(props) {
 		children
 	});
 }
+/** Renders a secondary action button attached to a {@link SidebarMenuItem}, with an optional tooltip. */
 function SidebarMenuAction(props) {
 	const { asChild, children, class: className, tooltip, tooltipSide, type = "button", ...rest } = props;
 	const finalProps = mergeProps(normalizeAriaProps(rest), {
@@ -111,9 +124,11 @@ function SidebarMenuAction(props) {
 		children
 	});
 }
+/** Renders a status badge attached to a {@link SidebarMenuItem}. */
 function SidebarMenuBadge(props) {
 	return sidebarPart(props, "sidebar-menu-badge", "span");
 }
+/** Renders a draggable/clickable rail along the sidebar's edge for resizing or toggling it. */
 function SidebarRail(props) {
 	const { asChild, children, class: className, type = "button", ...rest } = props;
 	const finalProps = mergeProps(normalizeAriaProps(rest), {
@@ -131,6 +146,7 @@ function SidebarRail(props) {
 		children
 	});
 }
+/** Icon button that toggles the {@link Sidebar}'s open/collapsed state, with an optional tooltip. */
 function SidebarTrigger(props) {
 	const { asChild, children, class: className, tooltip, tooltipSide, type = "button", ...rest } = props;
 	const finalProps = mergeProps(normalizeAriaProps(rest), {

package/dist/components/sidebar/sidebar.js.map

@@ -1 +1 @@
-{"version":3,"file":"sidebar.js","names":[],"sources":["../../../src/components/sidebar/sidebar.tsx"],"sourcesContent":["import type { JSX } from \"@askrjs/askr/jsx-runtime\";\nimport { Slot } from \"@askrjs/askr/foundations\";\nimport { Block } from \"../block\";\nimport { classes } from \"../_internal/classes\";\nimport { mergeProps } from \"../_internal/merge-props\";\nimport { intrinsicElement, normalizeAriaProps } from \"../_internal/jsx\";\nimport type {\n  SidebarButtonProps,\n  SidebarPartProps,\n  SidebarProps,\n  SidebarTooltipSide,\n} from \"./sidebar.types\";\n\nfunction sidebarTooltipProps(\n  tooltip: string | undefined,\n  tooltipSide: SidebarTooltipSide | undefined,\n): Record<string, string | undefined> {\n  return {\n    \"data-tooltip\": tooltip,\n    \"data-tooltip-side\": tooltip ? tooltipSide : undefined,\n  };\n}\n\nfunction sidebarPart(\n  props: SidebarPartProps,\n  slot: string,\n  element: keyof JSX.IntrinsicElements = \"div\",\n): JSX.Element {\n  const { as, asChild, children, class: className, ...rest } = props;\n  const finalProps = mergeProps(normalizeAriaProps(rest), {\n    class: className,\n    \"data-slot\": slot,\n  });\n\n  if (asChild) {\n    return <Slot asChild {...finalProps} children={children as JSX.Element} />;\n  }\n\n  return intrinsicElement(String(as ?? element), finalProps, children);\n}\n\nexport function Sidebar(props: SidebarProps): JSX.Element {\n  const {\n    children,\n    collapsible = \"offcanvas\",\n    side = \"left\",\n    variant = \"sidebar\",\n    width = \"sidebar\",\n    shrink = false,\n    ...rest\n  } = props;\n\n  return (\n    <Block\n      as=\"aside\"\n      width={width}\n      shrink={shrink}\n      minHeight=\"screen\"\n      padding=\"md\"\n      gap=\"lg\"\n      borderRight={true}\n      {...rest}\n      data-collapsible={collapsible}\n      data-side={side}\n      data-slot=\"sidebar\"\n      data-variant={variant}\n    >\n      {children}\n    </Block>\n  );\n}\n\nexport function SidebarScope(props: SidebarPartProps): JSX.Element {\n  return sidebarPart(props, \"sidebar-scope\");\n}\n\nexport function SidebarInset(props: SidebarPartProps): JSX.Element {\n  return sidebarPart(props, \"sidebar-inset\", \"main\");\n}\n\nexport function SidebarContent(props: SidebarPartProps): JSX.Element {\n  return sidebarPart(props, \"sidebar-content\");\n}\n\nexport function SidebarHeader(props: SidebarPartProps): JSX.Element {\n  return sidebarPart(props, \"sidebar-header\");\n}\n\nexport function SidebarFooter(props: SidebarPartProps): JSX.Element {\n  return sidebarPart(props, \"sidebar-footer\");\n}\n\nexport function SidebarGroup(props: SidebarPartProps): JSX.Element {\n  return sidebarPart(props, \"sidebar-group\");\n}\n\nexport function SidebarGroupLabel(props: SidebarPartProps): JSX.Element {\n  return sidebarPart(props, \"sidebar-group-label\");\n}\n\nexport function SidebarGroupContent(props: SidebarPartProps): JSX.Element {\n  return sidebarPart(props, \"sidebar-group-content\");\n}\n\nexport function SidebarMenu(props: SidebarPartProps): JSX.Element {\n  return sidebarPart(props, \"sidebar-menu\", \"ul\");\n}\n\nexport function SidebarMenuItem(props: SidebarPartProps): JSX.Element {\n  return sidebarPart(props, \"sidebar-menu-item\", \"li\");\n}\n\nexport function SidebarMenuButton(props: SidebarButtonProps): JSX.Element {\n  const {\n    active,\n    asChild,\n    children,\n    class: className,\n    size,\n    tooltip,\n    tooltipSide,\n    type = \"button\",\n    variant,\n    ...rest\n  } = props;\n  const finalProps = mergeProps(normalizeAriaProps(rest), {\n    class: classes(className),\n    \"data-active\": active ? \"true\" : undefined,\n    \"data-size\": size && size !== \"default\" ? size : undefined,\n    \"data-slot\": \"sidebar-menu-button\",\n    ...sidebarTooltipProps(tooltip, tooltipSide),\n    \"data-variant\": variant && variant !== \"default\" ? variant : undefined,\n  });\n\n  if (asChild) {\n    return <Slot asChild {...finalProps} children={children as JSX.Element} />;\n  }\n\n  return (\n    <button type={type as \"button\" | \"submit\" | \"reset\" | undefined} {...finalProps}>\n      {children}\n    </button>\n  );\n}\n\nexport function SidebarMenuAction(props: SidebarButtonProps): JSX.Element {\n  const {\n    asChild,\n    children,\n    class: className,\n    tooltip,\n    tooltipSide,\n    type = \"button\",\n    ...rest\n  } = props;\n  const finalProps = mergeProps(normalizeAriaProps(rest), {\n    class: classes(className),\n    \"data-slot\": \"sidebar-menu-action\",\n    ...sidebarTooltipProps(tooltip, tooltipSide),\n  });\n  if (asChild) return <Slot asChild {...finalProps} children={children as JSX.Element} />;\n  return (\n    <button type={type as \"button\" | \"submit\" | \"reset\" | undefined} {...finalProps}>\n      {children}\n    </button>\n  );\n}\n\nexport function SidebarMenuBadge(props: SidebarPartProps): JSX.Element {\n  return sidebarPart(props, \"sidebar-menu-badge\", \"span\");\n}\n\nexport function SidebarRail(props: SidebarButtonProps): JSX.Element {\n  const { asChild, children, class: className, type = \"button\", ...rest } = props;\n  const finalProps = mergeProps(normalizeAriaProps(rest), {\n    class: classes(className),\n    \"data-slot\": \"sidebar-rail\",\n  });\n  if (asChild) return <Slot asChild {...finalProps} children={children as JSX.Element} />;\n  return (\n    <button type={type as \"button\" | \"submit\" | \"reset\" | undefined} {...finalProps}>\n      {children}\n    </button>\n  );\n}\n\nexport function SidebarTrigger(props: SidebarButtonProps): JSX.Element {\n  const {\n    asChild,\n    children,\n    class: className,\n    tooltip,\n    tooltipSide,\n    type = \"button\",\n    ...rest\n  } = props;\n  const finalProps = mergeProps(normalizeAriaProps(rest), {\n    class: classes(\"btn btn-ghost btn-icon\", className),\n    \"data-slot\": \"sidebar-trigger\",\n    ...sidebarTooltipProps(tooltip, tooltipSide),\n  });\n  if (asChild) return <Slot asChild {...finalProps} children={children as JSX.Element} />;\n  return (\n    <button type={type as \"button\" | \"submit\" | \"reset\" | undefined} {...finalProps}>\n      {children}\n    </button>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"sidebar.js","names":[],"sources":["../../../src/components/sidebar/sidebar.tsx"],"sourcesContent":["import type { JSX } from \"@askrjs/askr/jsx-runtime\";\nimport { Slot } from \"@askrjs/askr/foundations\";\nimport { Block } from \"../block\";\nimport { classes } from \"../_internal/classes\";\nimport { mergeProps } from \"../_internal/merge-props\";\nimport { intrinsicElement, normalizeAriaProps } from \"../_internal/jsx\";\nimport type {\n  SidebarButtonProps,\n  SidebarPartProps,\n  SidebarProps,\n  SidebarTooltipSide,\n} from \"./sidebar.types\";\n\nfunction sidebarTooltipProps(\n  tooltip: string | undefined,\n  tooltipSide: SidebarTooltipSide | undefined,\n): Record<string, string | undefined> {\n  return {\n    \"data-tooltip\": tooltip,\n    \"data-tooltip-side\": tooltip ? tooltipSide : undefined,\n  };\n}\n\nfunction sidebarPart(\n  props: SidebarPartProps,\n  slot: string,\n  element: keyof JSX.IntrinsicElements = \"div\",\n): JSX.Element {\n  const { as, asChild, children, class: className, ...rest } = props;\n  const finalProps = mergeProps(normalizeAriaProps(rest), {\n    class: className,\n    \"data-slot\": slot,\n  });\n\n  if (asChild) {\n    return <Slot asChild {...finalProps} children={children as JSX.Element} />;\n  }\n\n  return intrinsicElement(String(as ?? element), finalProps, children);\n}\n\n/** Root `<aside>` sidebar layout with configurable width, side, collapse behavior, and visual variant, exposed as data attributes for CSS. */\nexport function Sidebar(props: SidebarProps): JSX.Element {\n  const {\n    children,\n    collapsible = \"offcanvas\",\n    side = \"left\",\n    variant = \"sidebar\",\n    width = \"sidebar\",\n    shrink = false,\n    ...rest\n  } = props;\n\n  return (\n    <Block\n      as=\"aside\"\n      width={width}\n      shrink={shrink}\n      minHeight=\"screen\"\n      padding=\"md\"\n      gap=\"lg\"\n      borderRight={true}\n      {...rest}\n      data-collapsible={collapsible}\n      data-side={side}\n      data-slot=\"sidebar\"\n      data-variant={variant}\n    >\n      {children}\n    </Block>\n  );\n}\n\n/** Scoping wrapper that establishes the sidebar's CSS/context boundary. */\nexport function SidebarScope(props: SidebarPartProps): JSX.Element {\n  return sidebarPart(props, \"sidebar-scope\");\n}\n\n/** Renders the `<main>` content area beside the {@link Sidebar}. */\nexport function SidebarInset(props: SidebarPartProps): JSX.Element {\n  return sidebarPart(props, \"sidebar-inset\", \"main\");\n}\n\n/** Renders the scrollable content region of a {@link Sidebar}. */\nexport function SidebarContent(props: SidebarPartProps): JSX.Element {\n  return sidebarPart(props, \"sidebar-content\");\n}\n\n/** Renders the header region of a {@link Sidebar}. */\nexport function SidebarHeader(props: SidebarPartProps): JSX.Element {\n  return sidebarPart(props, \"sidebar-header\");\n}\n\n/** Renders the footer region of a {@link Sidebar}. */\nexport function SidebarFooter(props: SidebarPartProps): JSX.Element {\n  return sidebarPart(props, \"sidebar-footer\");\n}\n\n/** Groups related {@link SidebarMenu} items together. */\nexport function SidebarGroup(props: SidebarPartProps): JSX.Element {\n  return sidebarPart(props, \"sidebar-group\");\n}\n\n/** Renders the label for a {@link SidebarGroup}. */\nexport function SidebarGroupLabel(props: SidebarPartProps): JSX.Element {\n  return sidebarPart(props, \"sidebar-group-label\");\n}\n\n/** Renders the content region of a {@link SidebarGroup}. */\nexport function SidebarGroupContent(props: SidebarPartProps): JSX.Element {\n  return sidebarPart(props, \"sidebar-group-content\");\n}\n\n/** Renders a `<ul>` list of {@link SidebarMenuItem}s. */\nexport function SidebarMenu(props: SidebarPartProps): JSX.Element {\n  return sidebarPart(props, \"sidebar-menu\", \"ul\");\n}\n\n/** Renders a single `<li>` entry within a {@link SidebarMenu}. */\nexport function SidebarMenuItem(props: SidebarPartProps): JSX.Element {\n  return sidebarPart(props, \"sidebar-menu-item\", \"li\");\n}\n\n/** Clickable menu button within a {@link SidebarMenuItem}; supports `active`/`size`/`variant` state and an optional tooltip. */\nexport function SidebarMenuButton(props: SidebarButtonProps): JSX.Element {\n  const {\n    active,\n    asChild,\n    children,\n    class: className,\n    size,\n    tooltip,\n    tooltipSide,\n    type = \"button\",\n    variant,\n    ...rest\n  } = props;\n  const finalProps = mergeProps(normalizeAriaProps(rest), {\n    class: classes(className),\n    \"data-active\": active ? \"true\" : undefined,\n    \"data-size\": size && size !== \"default\" ? size : undefined,\n    \"data-slot\": \"sidebar-menu-button\",\n    ...sidebarTooltipProps(tooltip, tooltipSide),\n    \"data-variant\": variant && variant !== \"default\" ? variant : undefined,\n  });\n\n  if (asChild) {\n    return <Slot asChild {...finalProps} children={children as JSX.Element} />;\n  }\n\n  return (\n    <button type={type as \"button\" | \"submit\" | \"reset\" | undefined} {...finalProps}>\n      {children}\n    </button>\n  );\n}\n\n/** Renders a secondary action button attached to a {@link SidebarMenuItem}, with an optional tooltip. */\nexport function SidebarMenuAction(props: SidebarButtonProps): JSX.Element {\n  const {\n    asChild,\n    children,\n    class: className,\n    tooltip,\n    tooltipSide,\n    type = \"button\",\n    ...rest\n  } = props;\n  const finalProps = mergeProps(normalizeAriaProps(rest), {\n    class: classes(className),\n    \"data-slot\": \"sidebar-menu-action\",\n    ...sidebarTooltipProps(tooltip, tooltipSide),\n  });\n  if (asChild) return <Slot asChild {...finalProps} children={children as JSX.Element} />;\n  return (\n    <button type={type as \"button\" | \"submit\" | \"reset\" | undefined} {...finalProps}>\n      {children}\n    </button>\n  );\n}\n\n/** Renders a status badge attached to a {@link SidebarMenuItem}. */\nexport function SidebarMenuBadge(props: SidebarPartProps): JSX.Element {\n  return sidebarPart(props, \"sidebar-menu-badge\", \"span\");\n}\n\n/** Renders a draggable/clickable rail along the sidebar's edge for resizing or toggling it. */\nexport function SidebarRail(props: SidebarButtonProps): JSX.Element {\n  const { asChild, children, class: className, type = \"button\", ...rest } = props;\n  const finalProps = mergeProps(normalizeAriaProps(rest), {\n    class: classes(className),\n    \"data-slot\": \"sidebar-rail\",\n  });\n  if (asChild) return <Slot asChild {...finalProps} children={children as JSX.Element} />;\n  return (\n    <button type={type as \"button\" | \"submit\" | \"reset\" | undefined} {...finalProps}>\n      {children}\n    </button>\n  );\n}\n\n/** Icon button that toggles the {@link Sidebar}'s open/collapsed state, with an optional tooltip. */\nexport function SidebarTrigger(props: SidebarButtonProps): JSX.Element {\n  const {\n    asChild,\n    children,\n    class: className,\n    tooltip,\n    tooltipSide,\n    type = \"button\",\n    ...rest\n  } = props;\n  const finalProps = mergeProps(normalizeAriaProps(rest), {\n    class: classes(\"btn btn-ghost btn-icon\", className),\n    \"data-slot\": \"sidebar-trigger\",\n    ...sidebarTooltipProps(tooltip, tooltipSide),\n  });\n  if (asChild) return <Slot asChild {...finalProps} children={children as JSX.Element} />;\n  return (\n    <button type={type as \"button\" | \"submit\" | \"reset\" | undefined} {...finalProps}>\n      {children}\n    </button>\n  );\n}\n"],"mappings":"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"}

package/dist/components/sidebar/sidebar.types.d.ts

@@ -2,10 +2,15 @@ import { BlockElementProps } from "../block/block.types.js";
 import "../block/index.js";
 import { JSX } from "@askrjs/askr/jsx-runtime";
 //#region src/components/sidebar/sidebar.types.d.ts
+/** How a {@link Sidebar} collapses: fully off-canvas, down to icons only, or not at all. */
 type SidebarCollapsible = "offcanvas" | "icon" | "none";
+/** Which edge of the viewport a {@link Sidebar} is docked to. */
 type SidebarSide = "left" | "right";
+/** Side a sidebar button's tooltip is positioned on. */
 type SidebarTooltipSide = "top" | "bottom" | "left" | "right";
+/** Visual style of a {@link Sidebar}. */
 type SidebarVariant = "sidebar" | "floating" | "inset";
+/** Props for the {@link Sidebar} component. */
 type SidebarProps = Omit<BlockElementProps<"aside">, "as" | "width" | "shrink"> & {
   collapsible?: SidebarCollapsible;
   side?: SidebarSide;
@@ -13,10 +18,12 @@ type SidebarProps = Omit<BlockElementProps<"aside">, "as" | "width" | "shrink">
   width?: BlockElementProps<"aside">["width"];
   shrink?: BlockElementProps<"aside">["shrink"];
 };
+/** Props shared by the generic {@link Sidebar} structural parts (content, header, footer, group, etc.). */
 type SidebarPartProps = JSX.IntrinsicElements["div"] & {
   as?: keyof JSX.IntrinsicElements;
   asChild?: boolean;
 };
+/** Props shared by the interactive {@link Sidebar} button parts (menu button, action, trigger). */
 type SidebarButtonProps = JSX.IntrinsicElements["button"] & {
   active?: boolean;
   asChild?: boolean;
@@ -25,6 +32,7 @@ type SidebarButtonProps = JSX.IntrinsicElements["button"] & {
   tooltipSide?: SidebarTooltipSide;
   variant?: "default" | "outline";
 };
+/** Props for the {@link SidebarRail} component. */
 type SidebarRailProps = SidebarButtonProps;
 //#endregion
 export { SidebarButtonProps, SidebarCollapsible, SidebarPartProps, SidebarProps, SidebarRailProps, SidebarSide, SidebarTooltipSide, SidebarVariant };

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

@@ -1,6 +1,7 @@
 import { SkeletonAsChildProps, SkeletonProps } from "./skeleton.types.js";
 import { JSX } from "@askrjs/askr/jsx-runtime";
 //#region src/components/skeleton/skeleton.d.ts
+/** Loading placeholder block with configurable `width`/`height`, hidden from assistive tech via `aria-hidden`, rendered as a `<div>` or merged onto a child via `asChild`. */
 declare function Skeleton(props: SkeletonProps): JSX.Element;
 declare function Skeleton(props: SkeletonAsChildProps): JSX.Element;
 //#endregion

package/dist/components/skeleton/skeleton.js.map

@@ -1 +1 @@
-{"version":3,"file":"skeleton.js","names":[],"sources":["../../../src/components/skeleton/skeleton.tsx"],"sourcesContent":["import type { JSX } from \"@askrjs/askr/jsx-runtime\";\nimport { Slot } from \"@askrjs/askr/foundations\";\nimport { mergeLayoutStyles } from \"../_internal/block-layout\";\nimport { classes } from \"../_internal/classes\";\nimport { mergeProps } from \"../_internal/merge-props\";\nimport { intrinsicElement } from \"../_internal/jsx\";\nimport { styleDeclarationsToClass } from \"../_internal/style\";\nimport type { SkeletonAsChildProps, SkeletonProps } from \"./skeleton.types\";\n\nfunction resolveSkeletonDimension(value: string | number | undefined): string | undefined {\n  if (typeof value === \"number\") return `${value}px`;\n  return value;\n}\n\nexport function Skeleton(props: SkeletonProps): JSX.Element;\nexport function Skeleton(props: SkeletonAsChildProps): JSX.Element;\nexport function Skeleton(props: SkeletonProps | SkeletonAsChildProps) {\n  const {\n    asChild,\n    children,\n    class: classProp,\n    className,\n    height,\n    ref,\n    style,\n    width,\n    ...rest\n  } = props as (SkeletonProps | SkeletonAsChildProps) & {\n    class?: unknown;\n    className?: unknown;\n    style?: unknown;\n  };\n  const dimensions: Record<string, string | number> = {};\n  const blockSize = resolveSkeletonDimension(height);\n  const inlineSize = resolveSkeletonDimension(width);\n  if (blockSize !== undefined) dimensions.blockSize = blockSize;\n  if (inlineSize !== undefined) dimensions.inlineSize = inlineSize;\n  const layoutClass = styleDeclarationsToClass(mergeLayoutStyles(dimensions, style));\n  const finalProps = mergeProps(rest, {\n    ref,\n    class: classes(classProp, className, layoutClass),\n    \"data-slot\": \"skeleton\",\n    \"data-skeleton\": \"true\",\n    \"aria-hidden\": \"true\",\n  });\n\n  if (asChild) {\n    return <Slot asChild {...finalProps} children={children} />;\n  }\n\n  return intrinsicElement(\"div\", finalProps, children);\n}\n"],"mappings":";;;;;;;;AASA,SAAS,yBAAyB,OAAwD;CACxF,IAAI,OAAO,UAAU,UAAU,OAAO,GAAG,MAAM;CAC/C,OAAO;AACT;AAIA,SAAgB,SAAS,OAA6C;CACpE,MAAM,EACJ,SACA,UACA,OAAO,WACP,WACA,QACA,KACA,OACA,OACA,GAAG,SACD;CAKJ,MAAM,aAA8C,CAAC;CACrD,MAAM,YAAY,yBAAyB,MAAM;CACjD,MAAM,aAAa,yBAAyB,KAAK;CACjD,IAAI,cAAc,KAAA,GAAW,WAAW,YAAY;CACpD,IAAI,eAAe,KAAA,GAAW,WAAW,aAAa;CACtD,MAAM,cAAc,yBAAyB,kBAAkB,YAAY,KAAK,CAAC;CACjF,MAAM,aAAa,WAAW,MAAM;EAClC;EACA,OAAO,QAAQ,WAAW,WAAW,WAAW;EAChD,aAAa;EACb,iBAAiB;EACjB,eAAe;CACjB,CAAC;CAED,IAAI,SACF,OAAO,oBAAC,MAAD;EAAM,SAAA;EAAQ,GAAI;EAAsB;CAAW,CAAA;CAG5D,OAAO,iBAAiB,OAAO,YAAY,QAAQ;AACrD"}
+{"version":3,"file":"skeleton.js","names":[],"sources":["../../../src/components/skeleton/skeleton.tsx"],"sourcesContent":["import type { JSX } from \"@askrjs/askr/jsx-runtime\";\nimport { Slot } from \"@askrjs/askr/foundations\";\nimport { mergeLayoutStyles } from \"../_internal/block-layout\";\nimport { classes } from \"../_internal/classes\";\nimport { mergeProps } from \"../_internal/merge-props\";\nimport { intrinsicElement } from \"../_internal/jsx\";\nimport { styleDeclarationsToClass } from \"../_internal/style\";\nimport type { SkeletonAsChildProps, SkeletonProps } from \"./skeleton.types\";\n\nfunction resolveSkeletonDimension(value: string | number | undefined): string | undefined {\n  if (typeof value === \"number\") return `${value}px`;\n  return value;\n}\n\n/** Loading placeholder block with configurable `width`/`height`, hidden from assistive tech via `aria-hidden`, rendered as a `<div>` or merged onto a child via `asChild`. */\nexport function Skeleton(props: SkeletonProps): JSX.Element;\nexport function Skeleton(props: SkeletonAsChildProps): JSX.Element;\nexport function Skeleton(props: SkeletonProps | SkeletonAsChildProps) {\n  const {\n    asChild,\n    children,\n    class: classProp,\n    className,\n    height,\n    ref,\n    style,\n    width,\n    ...rest\n  } = props as (SkeletonProps | SkeletonAsChildProps) & {\n    class?: unknown;\n    className?: unknown;\n    style?: unknown;\n  };\n  const dimensions: Record<string, string | number> = {};\n  const blockSize = resolveSkeletonDimension(height);\n  const inlineSize = resolveSkeletonDimension(width);\n  if (blockSize !== undefined) dimensions.blockSize = blockSize;\n  if (inlineSize !== undefined) dimensions.inlineSize = inlineSize;\n  const layoutClass = styleDeclarationsToClass(mergeLayoutStyles(dimensions, style));\n  const finalProps = mergeProps(rest, {\n    ref,\n    class: classes(classProp, className, layoutClass),\n    \"data-slot\": \"skeleton\",\n    \"data-skeleton\": \"true\",\n    \"aria-hidden\": \"true\",\n  });\n\n  if (asChild) {\n    return <Slot asChild {...finalProps} children={children} />;\n  }\n\n  return intrinsicElement(\"div\", finalProps, children);\n}\n"],"mappings":";;;;;;;;AASA,SAAS,yBAAyB,OAAwD;CACxF,IAAI,OAAO,UAAU,UAAU,OAAO,GAAG,MAAM;CAC/C,OAAO;AACT;AAKA,SAAgB,SAAS,OAA6C;CACpE,MAAM,EACJ,SACA,UACA,OAAO,WACP,WACA,QACA,KACA,OACA,OACA,GAAG,SACD;CAKJ,MAAM,aAA8C,CAAC;CACrD,MAAM,YAAY,yBAAyB,MAAM;CACjD,MAAM,aAAa,yBAAyB,KAAK;CACjD,IAAI,cAAc,KAAA,GAAW,WAAW,YAAY;CACpD,IAAI,eAAe,KAAA,GAAW,WAAW,aAAa;CACtD,MAAM,cAAc,yBAAyB,kBAAkB,YAAY,KAAK,CAAC;CACjF,MAAM,aAAa,WAAW,MAAM;EAClC;EACA,OAAO,QAAQ,WAAW,WAAW,WAAW;EAChD,aAAa;EACb,iBAAiB;EACjB,eAAe;CACjB,CAAC;CAED,IAAI,SACF,OAAO,oBAAC,MAAD;EAAM,SAAA;EAAQ,GAAI;EAAsB;CAAW,CAAA;CAG5D,OAAO,iBAAiB,OAAO,YAAY,QAAQ;AACrD"}

package/dist/components/skeleton/skeleton.types.d.ts

@@ -2,15 +2,18 @@ import { JSX } from "@askrjs/askr/jsx-runtime";
 import { JSXElement } from "@askrjs/askr/foundations";
 import { Ref } from "@askrjs/askr/foundations/utilities";
 //#region src/components/skeleton/skeleton.types.d.ts
+/** Props shared by both {@link Skeleton} call signatures. */
 type SkeletonOwnProps = {
   children?: unknown;
   height?: string | number;
   width?: string | number;
 };
+/** Props for {@link Skeleton} rendered as its default `<div>` element. */
 type SkeletonProps = Omit<JSX.IntrinsicElements["div"], "children" | "ref"> & SkeletonOwnProps & {
   asChild?: false;
   ref?: Ref<HTMLDivElement>;
 };
+/** Props for {@link Skeleton} rendered with `asChild`, merging its attributes onto a single child element. */
 type SkeletonAsChildProps = SkeletonOwnProps & {
   asChild: true;
   children: JSXElement;

package/dist/components/spinner/spinner.d.ts

@@ -1,6 +1,7 @@
 import { SpinnerProps } from "./spinner.types.js";
 import { JSX } from "@askrjs/askr/jsx-runtime";
 //#region src/components/spinner/spinner.d.ts
+/** Indeterminate loading spinner built on `ProgressCircle`, with an accessible label (defaults to `"Loading"`) and a `size` modifier. */
 declare function Spinner(props: SpinnerProps): JSX.Element;
 //#endregion
 export { Spinner };

package/dist/components/spinner/spinner.js

@@ -1,6 +1,7 @@
 import { ProgressCircle, ProgressCircleIndicator } from "@askrjs/ui";
 import { jsx } from "@askrjs/askr/jsx-runtime";
 //#region src/components/spinner/spinner.tsx
+/** Indeterminate loading spinner built on `ProgressCircle`, with an accessible label (defaults to `"Loading"`) and a `size` modifier. */
 function Spinner(props) {
 	const { label, size, "aria-label": ariaLabel, ...rest } = props;
 	return /* @__PURE__ */ jsx(ProgressCircle, {

package/dist/components/spinner/spinner.js.map

@@ -1 +1 @@
-{"version":3,"file":"spinner.js","names":[],"sources":["../../../src/components/spinner/spinner.tsx"],"sourcesContent":["import type { JSX } from \"@askrjs/askr/jsx-runtime\";\nimport { ProgressCircle, ProgressCircleIndicator } from \"@askrjs/ui\";\nimport type { SpinnerProps } from \"./spinner.types\";\n\nexport function Spinner(props: SpinnerProps): JSX.Element {\n  const {\n    label,\n    size,\n    \"aria-label\": ariaLabel,\n    ...rest\n  } = props as SpinnerProps & {\n    \"aria-label\"?: string;\n  };\n\n  return (\n    <ProgressCircle\n      {...rest}\n      aria-label={ariaLabel ?? label ?? \"Loading\"}\n      data-spinner=\"true\"\n      data-size={size && size !== \"md\" ? size : undefined}\n      value={null}\n      getValueLabel={() => label ?? \"Loading\"}\n    >\n      <ProgressCircleIndicator />\n    </ProgressCircle>\n  );\n}\n"],"mappings":";;;AAIA,SAAgB,QAAQ,OAAkC;CACxD,MAAM,EACJ,OACA,MACA,cAAc,WACd,GAAG,SACD;CAIJ,OACE,oBAAC,gBAAD;EACE,GAAI;EACJ,cAAY,aAAa,SAAS;EAClC,gBAAa;EACb,aAAW,QAAQ,SAAS,OAAO,OAAO,KAAA;EAC1C,OAAO;EACP,qBAAqB,SAAS;EAE9B,UAAA,oBAAC,yBAAD,CAA0B,CAAA;CACZ,CAAA;AAEpB"}
+{"version":3,"file":"spinner.js","names":[],"sources":["../../../src/components/spinner/spinner.tsx"],"sourcesContent":["import type { JSX } from \"@askrjs/askr/jsx-runtime\";\nimport { ProgressCircle, ProgressCircleIndicator } from \"@askrjs/ui\";\nimport type { SpinnerProps } from \"./spinner.types\";\n\n/** Indeterminate loading spinner built on `ProgressCircle`, with an accessible label (defaults to `\"Loading\"`) and a `size` modifier. */\nexport function Spinner(props: SpinnerProps): JSX.Element {\n  const {\n    label,\n    size,\n    \"aria-label\": ariaLabel,\n    ...rest\n  } = props as SpinnerProps & {\n    \"aria-label\"?: string;\n  };\n\n  return (\n    <ProgressCircle\n      {...rest}\n      aria-label={ariaLabel ?? label ?? \"Loading\"}\n      data-spinner=\"true\"\n      data-size={size && size !== \"md\" ? size : undefined}\n      value={null}\n      getValueLabel={() => label ?? \"Loading\"}\n    >\n      <ProgressCircleIndicator />\n    </ProgressCircle>\n  );\n}\n"],"mappings":";;;;AAKA,SAAgB,QAAQ,OAAkC;CACxD,MAAM,EACJ,OACA,MACA,cAAc,WACd,GAAG,SACD;CAIJ,OACE,oBAAC,gBAAD;EACE,GAAI;EACJ,cAAY,aAAa,SAAS;EAClC,gBAAa;EACb,aAAW,QAAQ,SAAS,OAAO,OAAO,KAAA;EAC1C,OAAO;EACP,qBAAqB,SAAS;EAE9B,UAAA,oBAAC,yBAAD,CAA0B,CAAA;CACZ,CAAA;AAEpB"}

package/dist/components/spinner/spinner.types.d.ts

@@ -1,10 +1,13 @@
 import { ProgressCircleProps } from "@askrjs/ui";
 //#region src/components/spinner/spinner.types.d.ts
+/** Size modifier for {@link Spinner}. */
 type SpinnerSize = "sm" | "md" | "lg";
+/** Props specific to {@link Spinner}, layered on top of `ProgressCircleProps`. */
 type SpinnerOwnProps = Omit<ProgressCircleProps, "value" | "getValueLabel"> & {
   label?: string;
   size?: SpinnerSize;
 };
+/** Props for the {@link Spinner} component. */
 type SpinnerProps = SpinnerOwnProps;
 //#endregion
 export { SpinnerOwnProps, SpinnerProps, SpinnerSize };

package/dist/components/stat/stat.d.ts

@@ -1,9 +1,13 @@
 import { StatDescriptionProps, StatLabelProps, StatProps, StatValueProps } from "./stat.types.js";
 import { JSX } from "@askrjs/askr/jsx-runtime";
 //#region src/components/stat/stat.d.ts
+/** Container for a labeled statistic (label, value, description). */
 declare function Stat(props: StatProps): JSX.Element;
+/** Renders the label of a {@link Stat}. */
 declare function StatLabel(props: StatLabelProps): JSX.Element;
+/** Renders the primary value of a {@link Stat}. */
 declare function StatValue(props: StatValueProps): JSX.Element;
+/** Renders supporting description text for a {@link Stat}. */
 declare function StatDescription(props: StatDescriptionProps): JSX.Element;
 //#endregion
 export { Stat, StatDescription, StatLabel, StatValue };

package/dist/components/stat/stat.js

@@ -2,6 +2,7 @@ import { classes } from "../_internal/classes.js";
 import { mergeProps } from "../_internal/merge-props.js";
 import { jsx } from "@askrjs/askr/jsx-runtime";
 //#region src/components/stat/stat.tsx
+/** Container for a labeled statistic (label, value, description). */
 function Stat(props) {
 	const { children, class: className, ref, ...rest } = props;
 	const finalProps = mergeProps(rest, {
@@ -14,6 +15,7 @@ function Stat(props) {
 		children
 	});
 }
+/** Renders the label of a {@link Stat}. */
 function StatLabel(props) {
 	const { children, class: className, ref, ...rest } = props;
 	const finalProps = mergeProps(rest, {
@@ -26,6 +28,7 @@ function StatLabel(props) {
 		children
 	});
 }
+/** Renders the primary value of a {@link Stat}. */
 function StatValue(props) {
 	const { children, class: className, ref, ...rest } = props;
 	const finalProps = mergeProps(rest, {
@@ -38,6 +41,7 @@ function StatValue(props) {
 		children
 	});
 }
+/** Renders supporting description text for a {@link Stat}. */
 function StatDescription(props) {
 	const { children, class: className, ref, ...rest } = props;
 	const finalProps = mergeProps(rest, {

package/dist/components/stat/stat.js.map

@@ -1 +1 @@
-{"version":3,"file":"stat.js","names":[],"sources":["../../../src/components/stat/stat.tsx"],"sourcesContent":["import type { JSX } from \"@askrjs/askr/jsx-runtime\";\nimport { classes } from \"../_internal/classes\";\nimport { mergeProps } from \"../_internal/merge-props\";\nimport type { StatDescriptionProps, StatLabelProps, StatProps, StatValueProps } from \"./stat.types\";\n\nexport function Stat(props: StatProps): JSX.Element {\n  const { children, class: className, ref, ...rest } = props;\n  const finalProps = mergeProps(rest, {\n    ref,\n    class: classes(\"stat\", className),\n    \"data-slot\": \"stat\",\n  });\n\n  return <div {...finalProps}>{children}</div>;\n}\n\nexport function StatLabel(props: StatLabelProps): JSX.Element {\n  const { children, class: className, ref, ...rest } = props;\n  const finalProps = mergeProps(rest, {\n    ref,\n    class: classes(\"stat-label\", className),\n    \"data-slot\": \"stat-label\",\n  });\n\n  return <p {...finalProps}>{children}</p>;\n}\n\nexport function StatValue(props: StatValueProps): JSX.Element {\n  const { children, class: className, ref, ...rest } = props;\n  const finalProps = mergeProps(rest, {\n    ref,\n    class: classes(\"stat-value\", className),\n    \"data-slot\": \"stat-value\",\n  });\n\n  return <p {...finalProps}>{children}</p>;\n}\n\nexport function StatDescription(props: StatDescriptionProps): JSX.Element {\n  const { children, class: className, ref, ...rest } = props;\n  const finalProps = mergeProps(rest, {\n    ref,\n    class: classes(\"stat-description\", className),\n    \"data-slot\": \"stat-description\",\n  });\n\n  return <p {...finalProps}>{children}</p>;\n}\n"],"mappings":";;;;AAKA,SAAgB,KAAK,OAA+B;CAClD,MAAM,EAAE,UAAU,OAAO,WAAW,KAAK,GAAG,SAAS;CACrD,MAAM,aAAa,WAAW,MAAM;EAClC;EACA,OAAO,QAAQ,QAAQ,SAAS;EAChC,aAAa;CACf,CAAC;CAED,OAAO,oBAAC,OAAD;EAAK,GAAI;EAAa;CAAc,CAAA;AAC7C;AAEA,SAAgB,UAAU,OAAoC;CAC5D,MAAM,EAAE,UAAU,OAAO,WAAW,KAAK,GAAG,SAAS;CACrD,MAAM,aAAa,WAAW,MAAM;EAClC;EACA,OAAO,QAAQ,cAAc,SAAS;EACtC,aAAa;CACf,CAAC;CAED,OAAO,oBAAC,KAAD;EAAG,GAAI;EAAa;CAAY,CAAA;AACzC;AAEA,SAAgB,UAAU,OAAoC;CAC5D,MAAM,EAAE,UAAU,OAAO,WAAW,KAAK,GAAG,SAAS;CACrD,MAAM,aAAa,WAAW,MAAM;EAClC;EACA,OAAO,QAAQ,cAAc,SAAS;EACtC,aAAa;CACf,CAAC;CAED,OAAO,oBAAC,KAAD;EAAG,GAAI;EAAa;CAAY,CAAA;AACzC;AAEA,SAAgB,gBAAgB,OAA0C;CACxE,MAAM,EAAE,UAAU,OAAO,WAAW,KAAK,GAAG,SAAS;CACrD,MAAM,aAAa,WAAW,MAAM;EAClC;EACA,OAAO,QAAQ,oBAAoB,SAAS;EAC5C,aAAa;CACf,CAAC;CAED,OAAO,oBAAC,KAAD;EAAG,GAAI;EAAa;CAAY,CAAA;AACzC"}
+{"version":3,"file":"stat.js","names":[],"sources":["../../../src/components/stat/stat.tsx"],"sourcesContent":["import type { JSX } from \"@askrjs/askr/jsx-runtime\";\nimport { classes } from \"../_internal/classes\";\nimport { mergeProps } from \"../_internal/merge-props\";\nimport type { StatDescriptionProps, StatLabelProps, StatProps, StatValueProps } from \"./stat.types\";\n\n/** Container for a labeled statistic (label, value, description). */\nexport function Stat(props: StatProps): JSX.Element {\n  const { children, class: className, ref, ...rest } = props;\n  const finalProps = mergeProps(rest, {\n    ref,\n    class: classes(\"stat\", className),\n    \"data-slot\": \"stat\",\n  });\n\n  return <div {...finalProps}>{children}</div>;\n}\n\n/** Renders the label of a {@link Stat}. */\nexport function StatLabel(props: StatLabelProps): JSX.Element {\n  const { children, class: className, ref, ...rest } = props;\n  const finalProps = mergeProps(rest, {\n    ref,\n    class: classes(\"stat-label\", className),\n    \"data-slot\": \"stat-label\",\n  });\n\n  return <p {...finalProps}>{children}</p>;\n}\n\n/** Renders the primary value of a {@link Stat}. */\nexport function StatValue(props: StatValueProps): JSX.Element {\n  const { children, class: className, ref, ...rest } = props;\n  const finalProps = mergeProps(rest, {\n    ref,\n    class: classes(\"stat-value\", className),\n    \"data-slot\": \"stat-value\",\n  });\n\n  return <p {...finalProps}>{children}</p>;\n}\n\n/** Renders supporting description text for a {@link Stat}. */\nexport function StatDescription(props: StatDescriptionProps): JSX.Element {\n  const { children, class: className, ref, ...rest } = props;\n  const finalProps = mergeProps(rest, {\n    ref,\n    class: classes(\"stat-description\", className),\n    \"data-slot\": \"stat-description\",\n  });\n\n  return <p {...finalProps}>{children}</p>;\n}\n"],"mappings":";;;;;AAMA,SAAgB,KAAK,OAA+B;CAClD,MAAM,EAAE,UAAU,OAAO,WAAW,KAAK,GAAG,SAAS;CACrD,MAAM,aAAa,WAAW,MAAM;EAClC;EACA,OAAO,QAAQ,QAAQ,SAAS;EAChC,aAAa;CACf,CAAC;CAED,OAAO,oBAAC,OAAD;EAAK,GAAI;EAAa;CAAc,CAAA;AAC7C;;AAGA,SAAgB,UAAU,OAAoC;CAC5D,MAAM,EAAE,UAAU,OAAO,WAAW,KAAK,GAAG,SAAS;CACrD,MAAM,aAAa,WAAW,MAAM;EAClC;EACA,OAAO,QAAQ,cAAc,SAAS;EACtC,aAAa;CACf,CAAC;CAED,OAAO,oBAAC,KAAD;EAAG,GAAI;EAAa;CAAY,CAAA;AACzC;;AAGA,SAAgB,UAAU,OAAoC;CAC5D,MAAM,EAAE,UAAU,OAAO,WAAW,KAAK,GAAG,SAAS;CACrD,MAAM,aAAa,WAAW,MAAM;EAClC;EACA,OAAO,QAAQ,cAAc,SAAS;EACtC,aAAa;CACf,CAAC;CAED,OAAO,oBAAC,KAAD;EAAG,GAAI;EAAa;CAAY,CAAA;AACzC;;AAGA,SAAgB,gBAAgB,OAA0C;CACxE,MAAM,EAAE,UAAU,OAAO,WAAW,KAAK,GAAG,SAAS;CACrD,MAAM,aAAa,WAAW,MAAM;EAClC;EACA,OAAO,QAAQ,oBAAoB,SAAS;EAC5C,aAAa;CACf,CAAC;CAED,OAAO,oBAAC,KAAD;EAAG,GAAI;EAAa;CAAY,CAAA;AACzC"}

package/dist/components/stat/stat.types.d.ts

@@ -3,18 +3,22 @@ import { Ref } from "@askrjs/askr/foundations/utilities";
 //#region src/components/stat/stat.types.d.ts
 type DivProps = Omit<JSX.IntrinsicElements["div"], "children" | "ref">;
 type ParagraphProps = Omit<JSX.IntrinsicElements["p"], "children" | "ref">;
+/** Props for the {@link Stat} component. */
 type StatProps = DivProps & {
   children?: unknown;
   ref?: Ref<HTMLDivElement>;
 };
+/** Props for the {@link StatLabel} component. */
 type StatLabelProps = ParagraphProps & {
   children?: unknown;
   ref?: Ref<HTMLParagraphElement>;
 };
+/** Props for the {@link StatValue} component. */
 type StatValueProps = ParagraphProps & {
   children?: unknown;
   ref?: Ref<HTMLParagraphElement>;
 };
+/** Props for the {@link StatDescription} component. */
 type StatDescriptionProps = ParagraphProps & {
   children?: unknown;
   ref?: Ref<HTMLParagraphElement>;

package/dist/components/text/text.d.ts

@@ -1,6 +1,7 @@
 import { TextElement, TextProps } from "./text.types.js";
 import { JSX } from "@askrjs/askr/jsx-runtime";
 //#region src/components/text/text.d.ts
+/** Typography primitive: renders any {@link TextElement} (default `<p>`) and turns `size`/`tone`/`weight`/`font`/`numeric`/`wrap`/`truncate` into data attributes for CSS styling. */
 declare function Text<TElement extends TextElement = "p">(props: TextProps<TElement>): JSX.Element;
 //#endregion
 export { Text };

package/dist/components/text/text.js

@@ -3,6 +3,7 @@ import { mergeProps } from "../_internal/merge-props.js";
 import { intrinsicElement } from "../_internal/jsx.js";
 //#region src/components/text/text.tsx
 const DEFAULT_ELEMENT = "p";
+/** Typography primitive: renders any {@link TextElement} (default `<p>`) and turns `size`/`tone`/`weight`/`font`/`numeric`/`wrap`/`truncate` into data attributes for CSS styling. */
 function Text(props) {
 	const { as, size = "md", tone = "default", weight, font, numeric, wrap, truncate, children, class: classProp, className, ref, ...rest } = props;
 	const finalProps = mergeProps(rest, {

package/dist/components/text/text.js.map

@@ -1 +1 @@
-{"version":3,"file":"text.js","names":[],"sources":["../../../src/components/text/text.tsx"],"sourcesContent":["import type { JSX } from \"@askrjs/askr/jsx-runtime\";\nimport { classes } from \"../_internal/classes\";\nimport { mergeProps } from \"../_internal/merge-props\";\nimport { intrinsicElement } from \"../_internal/jsx\";\nimport type { TextElement, TextProps } from \"./text.types\";\n\nconst DEFAULT_ELEMENT = \"p\";\n\nexport function Text<TElement extends TextElement = \"p\">(props: TextProps<TElement>): JSX.Element {\n  const {\n    as,\n    size = \"md\",\n    tone = \"default\",\n    weight,\n    font,\n    numeric,\n    wrap,\n    truncate,\n    children,\n    class: classProp,\n    className,\n    ref,\n    ...rest\n  } = props as TextProps<TextElement> & { class?: unknown; className?: unknown };\n\n  const finalProps = mergeProps(rest, {\n    ref,\n    class: classes(\"text\", classProp, className),\n    \"data-slot\": \"text\",\n    \"data-size\": size,\n    \"data-tone\": tone,\n    \"data-weight\": weight,\n    \"data-font\": font && font !== \"body\" ? font : undefined,\n    \"data-numeric\": numeric && numeric !== \"normal\" ? numeric : undefined,\n    \"data-wrap\": wrap,\n    \"data-truncate\": truncate ? \"true\" : undefined,\n  });\n\n  return intrinsicElement(as ?? DEFAULT_ELEMENT, finalProps, children);\n}\n"],"mappings":";;;;AAMA,MAAM,kBAAkB;AAExB,SAAgB,KAAyC,OAAyC;CAChG,MAAM,EACJ,IACA,OAAO,MACP,OAAO,WACP,QACA,MACA,SACA,MACA,UACA,UACA,OAAO,WACP,WACA,KACA,GAAG,SACD;CAEJ,MAAM,aAAa,WAAW,MAAM;EAClC;EACA,OAAO,QAAQ,QAAQ,WAAW,SAAS;EAC3C,aAAa;EACb,aAAa;EACb,aAAa;EACb,eAAe;EACf,aAAa,QAAQ,SAAS,SAAS,OAAO,KAAA;EAC9C,gBAAgB,WAAW,YAAY,WAAW,UAAU,KAAA;EAC5D,aAAa;EACb,iBAAiB,WAAW,SAAS,KAAA;CACvC,CAAC;CAED,OAAO,iBAAiB,MAAM,iBAAiB,YAAY,QAAQ;AACrE"}
+{"version":3,"file":"text.js","names":[],"sources":["../../../src/components/text/text.tsx"],"sourcesContent":["import type { JSX } from \"@askrjs/askr/jsx-runtime\";\nimport { classes } from \"../_internal/classes\";\nimport { mergeProps } from \"../_internal/merge-props\";\nimport { intrinsicElement } from \"../_internal/jsx\";\nimport type { TextElement, TextProps } from \"./text.types\";\n\nconst DEFAULT_ELEMENT = \"p\";\n\n/** Typography primitive: renders any {@link TextElement} (default `<p>`) and turns `size`/`tone`/`weight`/`font`/`numeric`/`wrap`/`truncate` into data attributes for CSS styling. */\nexport function Text<TElement extends TextElement = \"p\">(props: TextProps<TElement>): JSX.Element {\n  const {\n    as,\n    size = \"md\",\n    tone = \"default\",\n    weight,\n    font,\n    numeric,\n    wrap,\n    truncate,\n    children,\n    class: classProp,\n    className,\n    ref,\n    ...rest\n  } = props as TextProps<TextElement> & { class?: unknown; className?: unknown };\n\n  const finalProps = mergeProps(rest, {\n    ref,\n    class: classes(\"text\", classProp, className),\n    \"data-slot\": \"text\",\n    \"data-size\": size,\n    \"data-tone\": tone,\n    \"data-weight\": weight,\n    \"data-font\": font && font !== \"body\" ? font : undefined,\n    \"data-numeric\": numeric && numeric !== \"normal\" ? numeric : undefined,\n    \"data-wrap\": wrap,\n    \"data-truncate\": truncate ? \"true\" : undefined,\n  });\n\n  return intrinsicElement(as ?? DEFAULT_ELEMENT, finalProps, children);\n}\n"],"mappings":";;;;AAMA,MAAM,kBAAkB;;AAGxB,SAAgB,KAAyC,OAAyC;CAChG,MAAM,EACJ,IACA,OAAO,MACP,OAAO,WACP,QACA,MACA,SACA,MACA,UACA,UACA,OAAO,WACP,WACA,KACA,GAAG,SACD;CAEJ,MAAM,aAAa,WAAW,MAAM;EAClC;EACA,OAAO,QAAQ,QAAQ,WAAW,SAAS;EAC3C,aAAa;EACb,aAAa;EACb,aAAa;EACb,eAAe;EACf,aAAa,QAAQ,SAAS,SAAS,OAAO,KAAA;EAC9C,gBAAgB,WAAW,YAAY,WAAW,UAAU,KAAA;EAC5D,aAAa;EACb,iBAAiB,WAAW,SAAS,KAAA;CACvC,CAAC;CAED,OAAO,iBAAiB,MAAM,iBAAiB,YAAY,QAAQ;AACrE"}

package/dist/components/text/text.types.d.ts

@@ -1,14 +1,22 @@
 import { JSX } from "@askrjs/askr/jsx-runtime";
 import { Ref } from "@askrjs/askr/foundations/utilities";
 //#region src/components/text/text.types.d.ts
+/** Element tags {@link Text} can render as via its `as` prop. */
 type TextElement = "p" | "span" | "div" | "strong";
+/** Font size modifier for {@link Text}. */
 type TextSize = "sm" | "md" | "lg";
+/** Color tone modifier for {@link Text}. */
 type TextTone = "default" | "muted" | "subtle" | "inverse" | "success" | "warning" | "danger" | "info";
+/** Font weight modifier for {@link Text}. */
 type TextWeight = "normal" | "medium" | "semibold" | "bold";
+/** Font family modifier for {@link Text}. */
 type TextFont = "body" | "mono";
+/** Numeric glyph variant (e.g. tabular figures) for {@link Text}. */
 type TextNumeric = "normal" | "tabular";
+/** White-space wrapping behavior for {@link Text}. */
 type TextWrap = "normal" | "nowrap" | "anywhere";
 type TextIntrinsicProps<TElement extends TextElement> = Omit<JSX.IntrinsicElements[TElement], "children" | "ref">;
+/** Props for the {@link Text} component, specialized for a given {@link TextElement} `TElement`. */
 type TextProps<TElement extends TextElement = "p"> = TextIntrinsicProps<TElement> & {
   as?: TElement;
   size?: TextSize;