@chayns-ui/core 0.2.0 → 0.3.0

package/dist/components/button/Button.types.d.ts

@@ -1,35 +1,49 @@
 import type { ComponentPropsWithRef, ReactNode } from 'react';
-/** Supported visual emphasis levels for Button and IconButton. */
+/**
+ * @description Supported visual emphasis levels for {@link ButtonProps} and
+ * `IconButtonProps`. Milestone 1 supports exactly these four values; there is
+ * no default variant and no fifth value.
+ * @see {@link https://tappqa.tobit.com/Bodywork/DesignSystem/#buttons | DesignSystem — Buttons & Aktionen}
+ */
 export type ButtonVariant = 'primary' | 'outline' | 'ghost' | 'danger';
-/** FontAwesome Classic icon name with a Regular and Solid pair. */
+/**
+ * @description A FontAwesome Classic icon name in its Regular form (e.g.
+ * `fa-plus`). Button and IconButton resolve the matching Solid weight
+ * internally and cross-fade between the two on hover/active; consumers must
+ * not pass a pre-resolved weight and must supply a name that has both a
+ * Regular and a Solid glyph available.
+ */
 export type ButtonIcon = `fa-${string}`;
-/** Visible content that gives a Button its accessible name. */
+/**
+ * @description Visible content that gives a `Button` its accessible name.
+ * Excludes `boolean`, `null` and `undefined` so a `Button` can never be
+ * rendered without real, visible label content.
+ */
 export type ButtonContent = Exclude<ReactNode, boolean | null | undefined>;
-/** Props for a visible-label native action button. */
+/**
+ * @description Props for a visible-label native action button. Renders a
+ * native `<button>` and forwards all remaining native button props, events,
+ * `className` and `ref`.
+ */
 export interface ButtonProps extends Omit<ComponentPropsWithRef<'button'>, 'children'> {
-    /** Visual emphasis that communicates the action's role. */
+    /**
+     * @description Visual emphasis that communicates the action's role within
+     * its action scope. At most one `primary` action should exist per closed
+     * action scope (page, card, dialog, drawer, form, wizard step, or closed
+     * accordion content).
+     */
     variant: ButtonVariant;
-    /** Optional leading FontAwesome Classic icon name. */
+    /**
+     * @description Optional leading FontAwesome Classic icon name. Always
+     * rendered before `children`; there is no trailing-icon or icon-only mode
+     * on `Button` itself — use `IconButton` for an icon-only action.
+     */
     icon?: ButtonIcon;
-    /** Visible, non-empty content used as the button label. */
+    /**
+     * @description Visible, non-empty content used as the button label. Loading
+     * state, polymorphism (rendering as something other than a native button)
+     * and navigation are explicitly not part of the Milestone 1 API.
+     */
     children: ButtonContent;
 }
-type IconButtonAccessibleName = {
-    /** Localized accessible name when no external label element exists. */
-    'aria-label': string;
-    'aria-labelledby'?: never;
-} | {
-    'aria-label'?: never;
-    /** ID of the element that provides the localized accessible name. */
-    'aria-labelledby': string;
-};
-interface IconButtonBaseProps extends Omit<ComponentPropsWithRef<'button'>, 'aria-label' | 'aria-labelledby' | 'children'> {
-    /** Visual emphasis that communicates the action's role. */
-    variant: ButtonVariant;
-    /** FontAwesome Classic icon name rendered Regular at rest and Solid on interaction. */
-    icon: ButtonIcon;
-}
-/** Props for a compact native action button with a required accessible name. */
-export type IconButtonProps = IconButtonBaseProps & IconButtonAccessibleName;
-export {};
 //# sourceMappingURL=Button.types.d.ts.map

package/dist/components/button/Button.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Button.types.d.ts","sourceRoot":"","sources":["../../../src/components/button/Button.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAE9D,kEAAkE;AAClE,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEvE,mEAAmE;AACnE,MAAM,MAAM,UAAU,GAAG,MAAM,MAAM,EAAE,CAAC;AAExC,+DAA+D;AAC/D,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAE3E,sDAAsD;AACtD,MAAM,WAAW,WAAY,SAAQ,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC;IACpF,2DAA2D;IAC3D,OAAO,EAAE,aAAa,CAAC;IAEvB,sDAAsD;IACtD,IAAI,CAAC,EAAE,UAAU,CAAC;IAElB,2DAA2D;IAC3D,QAAQ,EAAE,aAAa,CAAC;CACzB;AAED,KAAK,wBAAwB,GACzB;IACE,uEAAuE;IACvE,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,KAAK,CAAC;CAC3B,GACD;IACE,YAAY,CAAC,EAAE,KAAK,CAAC;IAErB,qEAAqE;IACrE,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEN,UAAU,mBAAoB,SAAQ,IAAI,CACxC,qBAAqB,CAAC,QAAQ,CAAC,EAC/B,YAAY,GAAG,iBAAiB,GAAG,UAAU,CAC9C;IACC,2DAA2D;IAC3D,OAAO,EAAE,aAAa,CAAC;IAEvB,uFAAuF;IACvF,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,gFAAgF;AAChF,MAAM,MAAM,eAAe,GAAG,mBAAmB,GAAG,wBAAwB,CAAC"}
+{"version":3,"file":"Button.types.d.ts","sourceRoot":"","sources":["../../../src/components/button/Button.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAE9D;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEvE;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,MAAM,EAAE,CAAC;AAExC;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAE3E;;;;GAIG;AACH,MAAM,WAAW,WAAY,SAAQ,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC;IACpF;;;;;OAKG;IACH,OAAO,EAAE,aAAa,CAAC;IAEvB;;;;OAIG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC;IAElB;;;;OAIG;IACH,QAAQ,EAAE,aAAa,CAAC;CACzB"}

package/dist/components/button/button-icon/ButtonIcon.d.ts

@@ -0,0 +1,7 @@
+import type { ButtonIcon as ButtonIconName } from '../Button.types.js';
+interface ButtonIconProps {
+    icon: ButtonIconName;
+}
+declare const ButtonIcon: ({ icon }: ButtonIconProps) => import("react").JSX.Element;
+export default ButtonIcon;
+//# sourceMappingURL=ButtonIcon.d.ts.map

package/dist/components/button/button-icon/ButtonIcon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ButtonIcon.d.ts","sourceRoot":"","sources":["../../../../src/components/button/button-icon/ButtonIcon.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEvE,UAAU,eAAe;IACvB,IAAI,EAAE,cAAc,CAAC;CACtB;AAED,QAAA,MAAM,UAAU,GAAI,UAAU,eAAe,gCAS5C,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/components/button/button-icon/ButtonIcon.js

@@ -0,0 +1,17 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/components/button/button-icon/ButtonIcon.tsx
+var ButtonIcon = ({ icon }) => /* @__PURE__ */ jsxs("span", {
+	"aria-hidden": "true",
+	className: "chayns-button-icon",
+	children: [/* @__PURE__ */ jsx("span", {
+		className: "chayns-button-icon__weight",
+		children: /* @__PURE__ */ jsx("i", { className: `far ${icon}` })
+	}), /* @__PURE__ */ jsx("span", {
+		className: "chayns-button-icon__weight chayns-button-icon__weight--active",
+		children: /* @__PURE__ */ jsx("i", { className: `fas ${icon}` })
+	})]
+});
+//#endregion
+export { ButtonIcon as default };
+
+//# sourceMappingURL=ButtonIcon.js.map

package/dist/components/button/button-icon/ButtonIcon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ButtonIcon.js","names":[],"sources":["../../../../src/components/button/button-icon/ButtonIcon.tsx"],"sourcesContent":["import type { ButtonIcon as ButtonIconName } from '../Button.types.js';\n\ninterface ButtonIconProps {\n  icon: ButtonIconName;\n}\n\nconst ButtonIcon = ({ icon }: ButtonIconProps) => (\n  <span aria-hidden=\"true\" className=\"chayns-button-icon\">\n    <span className=\"chayns-button-icon__weight\">\n      <i className={`far ${icon}`} />\n    </span>\n    <span className=\"chayns-button-icon__weight chayns-button-icon__weight--active\">\n      <i className={`fas ${icon}`} />\n    </span>\n  </span>\n);\n\nexport default ButtonIcon;\n"],"mappings":";;AAMA,IAAM,cAAc,EAAE,WACpB,qBAAC,QAAD;CAAM,eAAY;CAAO,WAAU;CAAnC,UAAA,CACE,oBAAC,QAAD;EAAM,WAAU;EACd,UAAA,oBAAC,KAAD,EAAG,WAAW,OAAO,OAAS,CAAA;CAC1B,CAAA,GACN,oBAAC,QAAD;EAAM,WAAU;EACd,UAAA,oBAAC,KAAD,EAAG,WAAW,OAAO,OAAS,CAAA;CAC1B,CAAA,CACF"}

package/dist/components/card/Card.d.ts

@@ -1,4 +1,4 @@
 import type { CardProps } from './Card.types.js';
-declare function Card({ children, className, elevated, ...cardProps }: CardProps): import("react").JSX.Element;
+declare const Card: ({ children, className, elevated, ...cardProps }: CardProps) => import("react").JSX.Element;
 export default Card;
 //# sourceMappingURL=Card.d.ts.map

package/dist/components/card/Card.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Card.d.ts","sourceRoot":"","sources":["../../../src/components/card/Card.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,iBAAS,IAAI,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAgB,EAAE,GAAG,SAAS,EAAE,EAAE,SAAS,+BAU/E;AAED,eAAe,IAAI,CAAC"}
+{"version":3,"file":"Card.d.ts","sourceRoot":"","sources":["../../../src/components/card/Card.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,QAAA,MAAM,IAAI,GAAI,iDAAyD,SAAS,gCAU/E,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/components/card/Card.js

@@ -1,6 +1,6 @@
 import { jsx } from "react/jsx-runtime";
 //#region src/components/card/Card.tsx
-function Card({ children, className, elevated = false, ...cardProps }) {
+var Card = ({ children, className, elevated = false, ...cardProps }) => {
 	const resolvedClassName = [
 		"chayns-card",
 		elevated ? "chayns-card--elevated" : null,
@@ -11,7 +11,7 @@ function Card({ children, className, elevated = false, ...cardProps }) {
 		className: resolvedClassName,
 		children
 	});
-}
+};
 //#endregion
 export { Card as default };
 

package/dist/components/card/Card.js.map

@@ -1 +1 @@
-{"version":3,"file":"Card.js","names":[],"sources":["../../../src/components/card/Card.tsx"],"sourcesContent":["import type { CardProps } from './Card.types.js';\n\nfunction Card({ children, className, elevated = false, ...cardProps }: CardProps) {\n  const resolvedClassName = ['chayns-card', elevated ? 'chayns-card--elevated' : null, className]\n    .filter(Boolean)\n    .join(' ');\n\n  return (\n    <div {...cardProps} className={resolvedClassName}>\n      {children}\n    </div>\n  );\n}\n\nexport default Card;\n"],"mappings":";;AAEA,SAAS,KAAK,EAAE,UAAU,WAAW,WAAW,OAAO,GAAG,aAAwB;CAChF,MAAM,oBAAoB;EAAC;EAAe,WAAW,0BAA0B;EAAM;CAAS,CAAC,CAC5F,OAAO,OAAO,CAAC,CACf,KAAK,GAAG;CAEX,OACE,oBAAC,OAAD;EAAK,GAAI;EAAW,WAAW;EAC5B;CACE,CAAA;AAET"}
+{"version":3,"file":"Card.js","names":[],"sources":["../../../src/components/card/Card.tsx"],"sourcesContent":["import type { CardProps } from './Card.types.js';\n\nconst Card = ({ children, className, elevated = false, ...cardProps }: CardProps) => {\n  const resolvedClassName = ['chayns-card', elevated ? 'chayns-card--elevated' : null, className]\n    .filter(Boolean)\n    .join(' ');\n\n  return (\n    <div {...cardProps} className={resolvedClassName}>\n      {children}\n    </div>\n  );\n};\n\nexport default Card;\n"],"mappings":";;AAEA,IAAM,QAAQ,EAAE,UAAU,WAAW,WAAW,OAAO,GAAG,gBAA2B;CACnF,MAAM,oBAAoB;EAAC;EAAe,WAAW,0BAA0B;EAAM;CAAS,CAAC,CAC5F,OAAO,OAAO,CAAC,CACf,KAAK,GAAG;CAEX,OACE,oBAAC,OAAD;EAAK,GAAI;EAAW,WAAW;EAC5B;CACE,CAAA;AAET"}

package/dist/components/card/Card.types.d.ts

@@ -1,9 +1,22 @@
 import type { ComponentPropsWithRef, ReactNode } from 'react';
-/** Props for the presentational surface container. */
+/**
+ * @description Props for the presentational surface container. `Card` is
+ * purely presentational: it exposes no click or keyboard semantics and no
+ * intrinsic padding. Forwards all remaining native `div` props, `className`
+ * and `ref`.
+ */
 export interface CardProps extends ComponentPropsWithRef<'div'> {
-    /** Content rendered inside the card surface. */
+    /**
+     * @description Content rendered inside the card surface. Any content may be
+     * composed inside; internal spacing is owned by that content or a
+     * container, not by `Card`.
+     */
     children?: ReactNode;
-    /** Adds the subtle resting card elevation token. */
+    /**
+     * @description Adds the subtle resting card elevation token on top of the
+     * Design System `.card` surface treatment.
+     * @default false
+     */
     elevated?: boolean;
 }
 //# sourceMappingURL=Card.types.d.ts.map

package/dist/components/card/Card.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Card.types.d.ts","sourceRoot":"","sources":["../../../src/components/card/Card.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAE9D,sDAAsD;AACtD,MAAM,WAAW,SAAU,SAAQ,qBAAqB,CAAC,KAAK,CAAC;IAC7D,gDAAgD;IAChD,QAAQ,CAAC,EAAE,SAAS,CAAC;IAErB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB"}
+{"version":3,"file":"Card.types.d.ts","sourceRoot":"","sources":["../../../src/components/card/Card.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAE9D;;;;;GAKG;AACH,MAAM,WAAW,SAAU,SAAQ,qBAAqB,CAAC,KAAK,CAAC;IAC7D;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IAErB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB"}

package/dist/components/{button → icon-button}/IconButton.d.ts

@@ -1,4 +1,4 @@
-import type { IconButtonProps } from './Button.types.js';
+import type { IconButtonProps } from './IconButton.types.js';
 declare function IconButton({ className, icon, type, variant, ...buttonProps }: IconButtonProps): import("react").JSX.Element;
 export default IconButton;
 //# sourceMappingURL=IconButton.d.ts.map

package/dist/components/icon-button/IconButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IconButton.d.ts","sourceRoot":"","sources":["../../../src/components/icon-button/IconButton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAG7D,iBAAS,UAAU,CAAC,EAClB,SAAS,EACT,IAAI,EACJ,IAAe,EACf,OAAO,EACP,GAAG,WAAW,EACf,EAAE,eAAe,+BAUjB;AAED,eAAe,UAAU,CAAC"}

package/dist/components/{button → icon-button}/IconButton.js

@@ -1,9 +1,12 @@
-import ButtonIcon from "./ButtonIcon.js";
-import { getButtonClassName } from "./buttonClassName.js";
+import ButtonIcon from "../button/button-icon/ButtonIcon.js";
 import { jsx } from "react/jsx-runtime";
-//#region src/components/button/IconButton.tsx
+//#region src/components/icon-button/IconButton.tsx
 function IconButton({ className, icon, type = "button", variant, ...buttonProps }) {
-	const resolvedClassName = getButtonClassName("chayns-icon-button", variant, className);
+	const resolvedClassName = [
+		"chayns-icon-button",
+		`chayns-icon-button--${variant}`,
+		className
+	].filter(Boolean).join(" ");
 	return /* @__PURE__ */ jsx("button", {
 		...buttonProps,
 		className: resolvedClassName,

package/dist/components/icon-button/IconButton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IconButton.js","names":[],"sources":["../../../src/components/icon-button/IconButton.tsx"],"sourcesContent":["import type { IconButtonProps } from './IconButton.types.js';\nimport ButtonIcon from '../button/button-icon/ButtonIcon.js';\n\nfunction IconButton({\n  className,\n  icon,\n  type = 'button',\n  variant,\n  ...buttonProps\n}: IconButtonProps) {\n  const resolvedClassName = ['chayns-icon-button', `chayns-icon-button--${variant}`, className]\n    .filter(Boolean)\n    .join(' ');\n\n  return (\n    <button {...buttonProps} className={resolvedClassName} type={type}>\n      <ButtonIcon icon={icon} />\n    </button>\n  );\n}\n\nexport default IconButton;\n"],"mappings":";;;AAGA,SAAS,WAAW,EAClB,WACA,MACA,OAAO,UACP,SACA,GAAG,eACe;CAClB,MAAM,oBAAoB;EAAC;EAAsB,uBAAuB;EAAW;CAAS,CAAC,CAC1F,OAAO,OAAO,CAAC,CACf,KAAK,GAAG;CAEX,OACE,oBAAC,UAAD;EAAQ,GAAI;EAAa,WAAW;EAAyB;EAC3D,UAAA,oBAAC,YAAD,EAAkB,KAAO,CAAA;CACnB,CAAA;AAEZ"}

package/dist/components/icon-button/IconButton.types.d.ts

@@ -0,0 +1,43 @@
+import type { ComponentPropsWithRef } from 'react';
+import type { ButtonIcon, ButtonVariant } from '../button/Button.types.js';
+/**
+ * @description The two mutually-exclusive accessible-name mechanisms an
+ * `IconButton` can use, matching the native accessible-name contract:
+ * exactly one of `aria-label` or `aria-labelledby` must be supplied.
+ */
+type IconButtonAccessibleName = {
+    /**
+     * @description Localized accessible name when no external label
+     * element exists.
+     */
+    'aria-label': string;
+    'aria-labelledby'?: never;
+} | {
+    'aria-label'?: never;
+    /**
+     * @description ID of the element that provides the localized
+     * accessible name.
+     */
+    'aria-labelledby': string;
+};
+interface IconButtonBaseProps extends Omit<ComponentPropsWithRef<'button'>, 'aria-label' | 'aria-labelledby' | 'children'> {
+    /**
+     * @description Visual emphasis that communicates the action's role within
+     * its action scope, using the same four values as `Button`.
+     */
+    variant: ButtonVariant;
+    /**
+     * @description Required FontAwesome Classic icon name rendered Regular at
+     * rest and Solid on hover/active. `IconButton` has no visible label, so
+     * this is its only visible content.
+     */
+    icon: ButtonIcon;
+}
+/**
+ * @description Props for a compact, icon-only native action button. Does not
+ * accept `children` — it is icon-only by contract — and requires exactly one
+ * of `aria-label` or `aria-labelledby` to guarantee an accessible name.
+ */
+export type IconButtonProps = IconButtonBaseProps & IconButtonAccessibleName;
+export {};
+//# sourceMappingURL=IconButton.types.d.ts.map

package/dist/components/icon-button/IconButton.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IconButton.types.d.ts","sourceRoot":"","sources":["../../../src/components/icon-button/IconButton.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,OAAO,CAAC;AAEnD,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE3E;;;;GAIG;AACH,KAAK,wBAAwB,GACzB;IACE;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,KAAK,CAAC;CAC3B,GACD;IACE,YAAY,CAAC,EAAE,KAAK,CAAC;IAErB;;;OAGG;IACH,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEN,UAAU,mBAAoB,SAAQ,IAAI,CACxC,qBAAqB,CAAC,QAAQ,CAAC,EAC/B,YAAY,GAAG,iBAAiB,GAAG,UAAU,CAC9C;IACC;;;OAGG;IACH,OAAO,EAAE,aAAa,CAAC;IAEvB;;;;OAIG;IACH,IAAI,EAAE,UAAU,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,mBAAmB,GAAG,wBAAwB,CAAC"}

package/dist/components/list/List.d.ts

@@ -1,4 +1,4 @@
 import type { ListProps } from './List.types.js';
-declare function List({ children, className, ...listProps }: ListProps): import("react").JSX.Element;
+declare const List: ({ children, className, ...listProps }: ListProps) => import("react").JSX.Element;
 export default List;
 //# sourceMappingURL=List.d.ts.map

package/dist/components/list/List.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"List.d.ts","sourceRoot":"","sources":["../../../src/components/list/List.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,iBAAS,IAAI,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,EAAE,SAAS,+BAQ7D;AAED,eAAe,IAAI,CAAC"}
+{"version":3,"file":"List.d.ts","sourceRoot":"","sources":["../../../src/components/list/List.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,QAAA,MAAM,IAAI,GAAI,uCAAuC,SAAS,gCAQ7D,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/components/list/List.js

@@ -1,13 +1,13 @@
 import { jsx } from "react/jsx-runtime";
 //#region src/components/list/List.tsx
-function List({ children, className, ...listProps }) {
+var List = ({ children, className, ...listProps }) => {
 	const resolvedClassName = ["chayns-list", className].filter(Boolean).join(" ");
 	return /* @__PURE__ */ jsx("ul", {
 		...listProps,
 		className: resolvedClassName,
 		children
 	});
-}
+};
 //#endregion
 export { List as default };
 

package/dist/components/list/List.js.map

@@ -1 +1 @@
-{"version":3,"file":"List.js","names":[],"sources":["../../../src/components/list/List.tsx"],"sourcesContent":["import type { ListProps } from './List.types.js';\n\nfunction List({ children, className, ...listProps }: ListProps) {\n  const resolvedClassName = ['chayns-list', className].filter(Boolean).join(' ');\n\n  return (\n    <ul {...listProps} className={resolvedClassName}>\n      {children}\n    </ul>\n  );\n}\n\nexport default List;\n"],"mappings":";;AAEA,SAAS,KAAK,EAAE,UAAU,WAAW,GAAG,aAAwB;CAC9D,MAAM,oBAAoB,CAAC,eAAe,SAAS,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,GAAG;CAE7E,OACE,oBAAC,MAAD;EAAI,GAAI;EAAW,WAAW;EAC3B;CACC,CAAA;AAER"}
+{"version":3,"file":"List.js","names":[],"sources":["../../../src/components/list/List.tsx"],"sourcesContent":["import type { ListProps } from './List.types.js';\n\nconst List = ({ children, className, ...listProps }: ListProps) => {\n  const resolvedClassName = ['chayns-list', className].filter(Boolean).join(' ');\n\n  return (\n    <ul {...listProps} className={resolvedClassName}>\n      {children}\n    </ul>\n  );\n};\n\nexport default List;\n"],"mappings":";;AAEA,IAAM,QAAQ,EAAE,UAAU,WAAW,GAAG,gBAA2B;CACjE,MAAM,oBAAoB,CAAC,eAAe,SAAS,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,GAAG;CAE7E,OACE,oBAAC,MAAD;EAAI,GAAI;EAAW,WAAW;EAC3B;CACC,CAAA;AAER"}

package/dist/components/list/List.types.d.ts

@@ -1,32 +1,80 @@
 import type { ComponentPropsWithRef, MouseEventHandler, ReactNode } from 'react';
-/** Props for the vertical list container. */
+/**
+ * @description Props for the vertical list container. Renders a native
+ * `<ul>` and forwards all remaining native list props, `className` and
+ * `ref`.
+ */
 export interface ListProps extends ComponentPropsWithRef<'ul'> {
-    /** List items, typically ListItem elements. */
+    /**
+     * @description List items, typically `ListItem` elements.
+     */
     children?: ReactNode;
 }
-/** Props for a single list row. */
+/**
+ * @description Props for a single list row, rendered as a navigation link
+ * when `href` is set or as an action button when `onClick` is set.
+ */
 export interface ListItemProps {
-    /** Primary single-line row label. */
+    /**
+     * @description Primary single-line row label.
+     */
     title: ReactNode;
-    /** Optional secondary single-line preview text. */
+    /**
+     * @description Optional secondary single-line preview text shown below
+     * `title`.
+     */
     subtitle?: ReactNode;
-    /** Optional leading slot, for example an avatar or icon. */
+    /**
+     * @description Optional leading slot, for example an `Avatar` or icon.
+     */
     leading?: ReactNode;
-    /** Optional trailing slot for row-level actions or metadata. */
+    /**
+     * @description Optional trailing slot for row-level actions or metadata,
+     * freely composable as any `ReactNode`. Consumers render their own content
+     * here, including any future standard-content sub-components chayns UI
+     * provides for recurring trailing content.
+     */
     trailing?: ReactNode;
-    /** Shows an accent unread indicator. */
+    /**
+     * @description Shows an accent unread indicator.
+     * @default false
+     * @remarks Pending replacement per LIST-006 (CONFIRMED): this boolean
+     * contract is planned to be superseded by a generic, non-chat-specific
+     * status/accent indicator composed via `trailing`. The exact replacement
+     * component/prop name is not yet decided — do not assume a new prop name
+     * is already available.
+     */
     unread?: boolean;
-    /** Localized accessible name for the unread indicator. */
+    /**
+     * @description Localized accessible name for the unread indicator. Required
+     * for the indicator to be perceivable by assistive technology; see the
+     * `unread` remarks regarding its planned replacement.
+     */
     unreadLabel?: string;
-    /** Renders the row as a navigation link with this destination. */
+    /**
+     * @description Renders the row as a navigation link (native `<a>`) with
+     * this destination. Mutually exclusive in practice with `onClick` — a row
+     * represents either navigation or an action, not both.
+     */
     href?: string;
-    /** Renders the row as an action button with this handler. */
+    /**
+     * @description Renders the row as an action button (native `<button>`)
+     * with this click handler.
+     */
     onClick?: MouseEventHandler<HTMLButtonElement>;
-    /** Disables the action button variant. */
+    /**
+     * @description Disables the action button variant. Not applicable when the
+     * row renders as a navigation link.
+     * @default false
+     */
     disabled?: boolean;
-    /** Additional class names on the list item element. */
+    /**
+     * @description Additional class names appended to the list item element.
+     */
     className?: string;
-    /** Optional id on the list item element. */
+    /**
+     * @description Optional id on the list item element.
+     */
     id?: string;
 }
 //# sourceMappingURL=List.types.d.ts.map

package/dist/components/list/List.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"List.types.d.ts","sourceRoot":"","sources":["../../../src/components/list/List.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEjF,6CAA6C;AAC7C,MAAM,WAAW,SAAU,SAAQ,qBAAqB,CAAC,IAAI,CAAC;IAC5D,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,mCAAmC;AACnC,MAAM,WAAW,aAAa;IAC5B,qCAAqC;IACrC,KAAK,EAAE,SAAS,CAAC;IAEjB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,SAAS,CAAC;IAErB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,SAAS,CAAC;IAEpB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,SAAS,CAAC;IAErB,wCAAwC;IACxC,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,6DAA6D;IAC7D,OAAO,CAAC,EAAE,iBAAiB,CAAC,iBAAiB,CAAC,CAAC;IAE/C,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,4CAA4C;IAC5C,EAAE,CAAC,EAAE,MAAM,CAAC;CACb"}
+{"version":3,"file":"List.types.d.ts","sourceRoot":"","sources":["../../../src/components/list/List.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEjF;;;;GAIG;AACH,MAAM,WAAW,SAAU,SAAQ,qBAAqB,CAAC,IAAI,CAAC;IAC5D;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,KAAK,EAAE,SAAS,CAAC;IAEjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IAErB;;OAEG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;IAEpB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IAErB;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,OAAO,CAAC,EAAE,iBAAiB,CAAC,iBAAiB,CAAC,CAAC;IAE/C;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;CACb"}

package/dist/components/list-item/ListItem.d.ts

@@ -0,0 +1,4 @@
+import type { ListItemProps } from '../list/List.types.js';
+declare const ListItem: ({ className, disabled, href, id, leading, onClick, subtitle, title, trailing, unread, unreadLabel, }: ListItemProps) => import("react").JSX.Element;
+export default ListItem;
+//# sourceMappingURL=ListItem.d.ts.map

package/dist/components/list-item/ListItem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListItem.d.ts","sourceRoot":"","sources":["../../../src/components/list-item/ListItem.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAG3D,QAAA,MAAM,QAAQ,GAAI,sGAYf,aAAa,gCA0Cf,CAAC;AAEF,eAAe,QAAQ,CAAC"}

package/dist/components/list-item/ListItem.js

@@ -0,0 +1,42 @@
+import ListItemBody from "./list-item-body/ListItemBody.js";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/components/list-item/ListItem.tsx
+var ListItem = ({ className, disabled = false, href, id, leading, onClick, subtitle, title, trailing, unread = false, unreadLabel }) => {
+	const actionClassName = ["chayns-list-item__action", Boolean(href) || Boolean(onClick) ? "chayns-list-item__action--interactive" : null].filter(Boolean).join(" ");
+	const body = /* @__PURE__ */ jsx(ListItemBody, {
+		leading,
+		subtitle,
+		title,
+		unread,
+		unreadLabel
+	});
+	let action;
+	if (href) action = /* @__PURE__ */ jsx("a", {
+		className: actionClassName,
+		href,
+		children: body
+	});
+	else if (onClick) action = /* @__PURE__ */ jsx("button", {
+		className: actionClassName,
+		disabled,
+		onClick,
+		type: "button",
+		children: body
+	});
+	else action = /* @__PURE__ */ jsx("div", {
+		className: actionClassName,
+		children: body
+	});
+	return /* @__PURE__ */ jsxs("li", {
+		className: ["chayns-list-item", className].filter(Boolean).join(" "),
+		id,
+		children: [action, trailing ? /* @__PURE__ */ jsx("span", {
+			className: "chayns-list-item__trailing",
+			children: trailing
+		}) : null]
+	});
+};
+//#endregion
+export { ListItem as default };
+
+//# sourceMappingURL=ListItem.js.map

package/dist/components/list-item/ListItem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListItem.js","names":[],"sources":["../../../src/components/list-item/ListItem.tsx"],"sourcesContent":["import type { ReactNode } from 'react';\n\nimport type { ListItemProps } from '../list/List.types.js';\nimport ListItemBody from './list-item-body/ListItemBody.js';\n\nconst ListItem = ({\n  className,\n  disabled = false,\n  href,\n  id,\n  leading,\n  onClick,\n  subtitle,\n  title,\n  trailing,\n  unread = false,\n  unreadLabel,\n}: ListItemProps) => {\n  const interactive = Boolean(href) || Boolean(onClick);\n  const actionClassName = [\n    'chayns-list-item__action',\n    interactive ? 'chayns-list-item__action--interactive' : null,\n  ]\n    .filter(Boolean)\n    .join(' ');\n\n  const body = (\n    <ListItemBody\n      leading={leading}\n      subtitle={subtitle}\n      title={title}\n      unread={unread}\n      unreadLabel={unreadLabel}\n    />\n  );\n\n  let action: ReactNode;\n  if (href) {\n    action = (\n      <a className={actionClassName} href={href}>\n        {body}\n      </a>\n    );\n  } else if (onClick) {\n    action = (\n      <button className={actionClassName} disabled={disabled} onClick={onClick} type=\"button\">\n        {body}\n      </button>\n    );\n  } else {\n    action = <div className={actionClassName}>{body}</div>;\n  }\n\n  return (\n    <li className={['chayns-list-item', className].filter(Boolean).join(' ')} id={id}>\n      {action}\n      {trailing ? <span className=\"chayns-list-item__trailing\">{trailing}</span> : null}\n    </li>\n  );\n};\n\nexport default ListItem;\n"],"mappings":";;;AAKA,IAAM,YAAY,EAChB,WACA,WAAW,OACX,MACA,IACA,SACA,SACA,UACA,OACA,UACA,SAAS,OACT,kBACmB;CAEnB,MAAM,kBAAkB,CACtB,4BAFkB,QAAQ,IAAI,KAAK,QAAQ,OAAO,IAGpC,0CAA0C,IAC1D,CAAC,CACE,OAAO,OAAO,CAAC,CACf,KAAK,GAAG;CAEX,MAAM,OACJ,oBAAC,cAAD;EACW;EACC;EACH;EACC;EACK;CACd,CAAA;CAGH,IAAI;CACJ,IAAI,MACF,SACE,oBAAC,KAAD;EAAG,WAAW;EAAuB;EAClC,UAAA;CACA,CAAA;MAEA,IAAI,SACT,SACE,oBAAC,UAAD;EAAQ,WAAW;EAA2B;EAAmB;EAAS,MAAK;EAC5E,UAAA;CACK,CAAA;MAGV,SAAS,oBAAC,OAAD;EAAK,WAAW;EAAkB,UAAA;CAAU,CAAA;CAGvD,OACE,qBAAC,MAAD;EAAI,WAAW,CAAC,oBAAoB,SAAS,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,GAAG;EAAO;EAA9E,UAAA,CACG,QACA,WAAW,oBAAC,QAAD;GAAM,WAAU;GAA8B,UAAA;EAAe,CAAA,IAAI,IAC3E;;AAER"}

package/dist/components/list-item/list-item-body/ListItemBody.d.ts

@@ -0,0 +1,10 @@
+import type { ReactNode } from 'react';
+declare const ListItemBody: ({ leading, subtitle, title, unread, unreadLabel, }: {
+    leading?: ReactNode;
+    subtitle?: ReactNode;
+    title: ReactNode;
+    unread?: boolean;
+    unreadLabel?: string | undefined;
+}) => import("react").JSX.Element;
+export default ListItemBody;
+//# sourceMappingURL=ListItemBody.d.ts.map

package/dist/components/list-item/list-item-body/ListItemBody.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListItemBody.d.ts","sourceRoot":"","sources":["../../../../src/components/list-item/list-item-body/ListItemBody.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,QAAA,MAAM,YAAY,GAAI,oDAMnB;IACD,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC,gCAaA,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/components/list-item/list-item-body/ListItemBody.js

@@ -0,0 +1,30 @@
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+//#region src/components/list-item/list-item-body/ListItemBody.tsx
+var ListItemBody = ({ leading, subtitle, title, unread, unreadLabel }) => /* @__PURE__ */ jsxs(Fragment, { children: [
+	unread ? /* @__PURE__ */ jsx("span", {
+		className: "chayns-list-item__unread",
+		"aria-hidden": unreadLabel ? void 0 : true,
+		children: unreadLabel ? /* @__PURE__ */ jsx("span", {
+			className: "chayns-visually-hidden",
+			children: unreadLabel
+		}) : null
+	}) : null,
+	leading ? /* @__PURE__ */ jsx("span", {
+		className: "chayns-list-item__leading",
+		children: leading
+	}) : null,
+	/* @__PURE__ */ jsxs("span", {
+		className: "chayns-list-item__body",
+		children: [/* @__PURE__ */ jsx("span", {
+			className: "chayns-list-item__title",
+			children: title
+		}), subtitle ? /* @__PURE__ */ jsx("span", {
+			className: "chayns-list-item__subtitle",
+			children: subtitle
+		}) : null]
+	})
+] });
+//#endregion
+export { ListItemBody as default };
+
+//# sourceMappingURL=ListItemBody.js.map

package/dist/components/list-item/list-item-body/ListItemBody.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListItemBody.js","names":[],"sources":["../../../../src/components/list-item/list-item-body/ListItemBody.tsx"],"sourcesContent":["import type { ReactNode } from 'react';\n\nconst ListItemBody = ({\n  leading,\n  subtitle,\n  title,\n  unread,\n  unreadLabel,\n}: {\n  leading?: ReactNode;\n  subtitle?: ReactNode;\n  title: ReactNode;\n  unread?: boolean;\n  unreadLabel?: string | undefined;\n}) => (\n  <>\n    {unread ? (\n      <span className=\"chayns-list-item__unread\" aria-hidden={unreadLabel ? undefined : true}>\n        {unreadLabel ? <span className=\"chayns-visually-hidden\">{unreadLabel}</span> : null}\n      </span>\n    ) : null}\n    {leading ? <span className=\"chayns-list-item__leading\">{leading}</span> : null}\n    <span className=\"chayns-list-item__body\">\n      <span className=\"chayns-list-item__title\">{title}</span>\n      {subtitle ? <span className=\"chayns-list-item__subtitle\">{subtitle}</span> : null}\n    </span>\n  </>\n);\n\nexport default ListItemBody;\n"],"mappings":";;AAEA,IAAM,gBAAgB,EACpB,SACA,UACA,OACA,QACA,kBAQA,qBAAA,UAAA,EAAA,UAAA;CACG,SACC,oBAAC,QAAD;EAAM,WAAU;EAA2B,eAAa,cAAc,KAAA,IAAY;EAC/E,UAAA,cAAc,oBAAC,QAAD;GAAM,WAAU;GAA0B,UAAA;EAAkB,CAAA,IAAI;CAC3E,CAAA,IACJ;CACH,UAAU,oBAAC,QAAD;EAAM,WAAU;EAA6B,UAAA;CAAc,CAAA,IAAI;CAC1E,qBAAC,QAAD;EAAM,WAAU;EAAhB,UAAA,CACE,oBAAC,QAAD;GAAM,WAAU;GAA2B,UAAA;EAAY,CAAA,GACtD,WAAW,oBAAC,QAAD;GAAM,WAAU;GAA8B,UAAA;EAAe,CAAA,IAAI,IACzE;;AACN,EAAA,CAAA"}

package/dist/components/popup/Popup.d.ts

@@ -0,0 +1,4 @@
+import type { PopupProps } from './Popup.types.js';
+declare const Popup: ({ children, className, trigger }: PopupProps) => import("react").JSX.Element;
+export default Popup;
+//# sourceMappingURL=Popup.d.ts.map

package/dist/components/popup/Popup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Popup.d.ts","sourceRoot":"","sources":["../../../src/components/popup/Popup.tsx"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAWnD,QAAA,MAAM,KAAK,GAAI,kCAAkC,UAAU,gCAqI1D,CAAC;AAEF,eAAe,KAAK,CAAC"}