@stackone/malachite 0.39.0 → 0.40.0

package/COMPONENTS.md

@@ -20,7 +20,7 @@ The catalog of components exported from `@stackone/malachite`. **Reach for one o
 ## Lists, rows & navigation
 
 - **`ButtonList`** — Vertical list of pill-style button/link rows with built-in hover/focus/active states. _Key props:_ `buttons[]` (`key`, `children`, `onClick`, `href`), `compact`.
-- **`Accordion`** — Expand/collapse section with a clickable header (arrow + title + trailing slot). Controlled or uncontrolled. _Key props:_ `title`, `trailing`, `isExpanded`/`defaultExpanded`, `onToggle`.
+- **`Accordion`** — Expand/collapse section with a clickable header (disclosure arrow + title/header + trailing slot). Use `header` for rich content and `trailing` for an interactive control (e.g. a Checkbox) — trailing sits outside the toggle button, so a selectable+expandable row is just an Accordion. Controlled or uncontrolled. _Key props:_ `title` or `header`, `trailing`, `disabled`, `isExpanded`/`defaultExpanded`, `onToggle`.
 - **`DefinitionRow`** — Row showing an icon, label, optional tag and description — for definition/detail lists. _Key props:_ `icon`, `label`, `tag`, `description`.
 - **`PreviewTree`** — Nested, indented tree for previewing hierarchical structure.
 - **`PreviewTreeRow`** — A single labelled row within a PreviewTree. _Key props:_ `label`.

package/dist/index.d.ts

@@ -10,16 +10,33 @@ import { UseFormReturn } from 'react-hook-form';
 
 export declare const Accordion: default_2.FC<AccordionProps>;
 
-export declare interface AccordionProps {
-    title: string;
+declare interface AccordionBaseProps {
     className?: string;
     children?: default_2.ReactNode;
+    /**
+     * Content pinned to the right of the header, OUTSIDE the toggle button — so it may
+     * be interactive (e.g. a Checkbox) without nesting a button inside a button.
+     */
     trailing?: default_2.ReactNode;
     defaultExpanded?: boolean;
     isExpanded?: boolean;
     onToggle?: (expanded: boolean) => void;
+    /** Disables the toggle (and its hover). Trailing controls manage their own state. */
+    disabled?: boolean;
 }
 
+/**
+ * Requires at least one of `title` (simple text header) or `header` (rich ReactNode
+ * content for the toggle area, e.g. avatar + badges) so the toggle is never empty.
+ */
+export declare type AccordionProps = AccordionBaseProps & ({
+    title: string;
+    header?: default_2.ReactNode;
+} | {
+    title?: string;
+    header: default_2.ReactNode;
+});
+
 /**
  * ActionMenu is a kebab-style overflow action menu. The trigger renders a
  * three-dot icon button; on click, a popover appears with the given items.