@mediaradar/design-components 0.8.0 → 0.8.1

package/dist/index.d.cts

@@ -165,6 +165,7 @@ declare function AdvertiserSearchPrompt({ label }: AdvertiserSearchPromptProps):
  * ```
  */
 interface CheckBoxProps {
+    /** Whether the box is checked. Controlled: the parent owns this value. */
     checked: boolean;
     /**
      * Some-but-not-all state for a "select all" checkbox -- shows a dash
@@ -172,9 +173,14 @@ interface CheckBoxProps {
      * plain boolean.
      */
     indeterminate?: boolean;
+    /**
+     * Called on click with no argument -- flip `checked` yourself. The click
+     * doesn't bubble, so a row that toggles on its own click won't fire twice.
+     */
     onChange: () => void;
     /** Accessible label -- required since the control carries no visible text of its own. */
     ariaLabel: string;
+    /** Blocks clicks, dims the box to 50% opacity, and cancels its hover preview. */
     disabled?: boolean;
     /** Forwarded as `data-testid`, for Playwright/test selectors. */
     testId?: string;
@@ -493,6 +499,8 @@ interface CardProps extends Omit<React.HTMLAttributes<HTMLElement>, "title"> {
     subtitle?: string;
     /** Trailing header content, e.g. a "View all" link. Ignored without `title`. */
     action?: ReactNode;
+    /** Card body. Rendered edge to edge without `title`; inside the standard padding with it. */
+    children?: ReactNode;
 }
 declare const Card: react.ForwardRefExoticComponent<CardProps & react.RefAttributes<HTMLElement>>;
 
@@ -1194,6 +1202,8 @@ interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement>, VariantPr
     asChild?: boolean;
     /** Shows a spinner in place of the leading edge and disables the button. */
     loading?: boolean;
+    /** Button label and/or icon. With `asChild`, the single element that receives the button styling. */
+    children?: ReactNode;
 }
 /**
  * @pattern Button
@@ -1438,6 +1448,7 @@ interface WorkspaceAvatarProps {
 declare function WorkspaceAvatar({ name, size }: WorkspaceAvatarProps): react.JSX.Element;
 
 interface TagProps {
+    /** The tag's text, e.g. "Digital". Keep it short: the chip doesn't wrap or truncate. */
     children: ReactNode;
     /** Extra classes merged onto the chip. */
     className?: string;
@@ -1599,13 +1610,17 @@ declare const SIZES: {
     };
 };
 interface ToggleProps {
+    /** Whether the switch is on. Controlled: the parent owns this value. */
     checked: boolean;
     /** Receives the value being switched TO, not the current one. */
     onChange: (next: boolean) => void;
     /** Accessible name; the visible label lives in the row around it. */
     label: string;
+    /** `md` for settings rows where the switch is the subject; `sm` for dense rows next to 13px text. */
     size?: keyof typeof SIZES;
+    /** Blocks clicks and dims the switch to 50% opacity. */
     disabled?: boolean;
+    /** Extra classes merged onto the track (the outer `<button>`). */
     className?: string;
 }
 /**

package/dist/index.d.ts

@@ -165,6 +165,7 @@ declare function AdvertiserSearchPrompt({ label }: AdvertiserSearchPromptProps):
  * ```
  */
 interface CheckBoxProps {
+    /** Whether the box is checked. Controlled: the parent owns this value. */
     checked: boolean;
     /**
      * Some-but-not-all state for a "select all" checkbox -- shows a dash
@@ -172,9 +173,14 @@ interface CheckBoxProps {
      * plain boolean.
      */
     indeterminate?: boolean;
+    /**
+     * Called on click with no argument -- flip `checked` yourself. The click
+     * doesn't bubble, so a row that toggles on its own click won't fire twice.
+     */
     onChange: () => void;
     /** Accessible label -- required since the control carries no visible text of its own. */
     ariaLabel: string;
+    /** Blocks clicks, dims the box to 50% opacity, and cancels its hover preview. */
     disabled?: boolean;
     /** Forwarded as `data-testid`, for Playwright/test selectors. */
     testId?: string;
@@ -493,6 +499,8 @@ interface CardProps extends Omit<React.HTMLAttributes<HTMLElement>, "title"> {
     subtitle?: string;
     /** Trailing header content, e.g. a "View all" link. Ignored without `title`. */
     action?: ReactNode;
+    /** Card body. Rendered edge to edge without `title`; inside the standard padding with it. */
+    children?: ReactNode;
 }
 declare const Card: react.ForwardRefExoticComponent<CardProps & react.RefAttributes<HTMLElement>>;
 
@@ -1194,6 +1202,8 @@ interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement>, VariantPr
     asChild?: boolean;
     /** Shows a spinner in place of the leading edge and disables the button. */
     loading?: boolean;
+    /** Button label and/or icon. With `asChild`, the single element that receives the button styling. */
+    children?: ReactNode;
 }
 /**
  * @pattern Button
@@ -1438,6 +1448,7 @@ interface WorkspaceAvatarProps {
 declare function WorkspaceAvatar({ name, size }: WorkspaceAvatarProps): react.JSX.Element;
 
 interface TagProps {
+    /** The tag's text, e.g. "Digital". Keep it short: the chip doesn't wrap or truncate. */
     children: ReactNode;
     /** Extra classes merged onto the chip. */
     className?: string;
@@ -1599,13 +1610,17 @@ declare const SIZES: {
     };
 };
 interface ToggleProps {
+    /** Whether the switch is on. Controlled: the parent owns this value. */
     checked: boolean;
     /** Receives the value being switched TO, not the current one. */
     onChange: (next: boolean) => void;
     /** Accessible name; the visible label lives in the row around it. */
     label: string;
+    /** `md` for settings rows where the switch is the subject; `sm` for dense rows next to 13px text. */
     size?: keyof typeof SIZES;
+    /** Blocks clicks and dims the switch to 50% opacity. */
     disabled?: boolean;
+    /** Extra classes merged onto the track (the outer `<button>`). */
     className?: string;
 }
 /**