@vkzstudio/muza-ui 1.0.43 → 1.0.44

package/dist/components/Accordion/Accordion.d.ts

@@ -62,20 +62,56 @@ export interface AccordionMultipleProps extends RadixAccordionMultipleProps {
  * <Accordion type="single" variant="default" collapsible>
  */
 export type AccordionProps = AccordionSingleProps | AccordionMultipleProps;
-/** Props for AccordionItem. Requires a unique `value` string to identify the section. */
+/**
+ * Props for the AccordionItem component.
+ * Represents a single expandable section within an Accordion.
+ */
 export interface AccordionItemProps extends React.ComponentProps<typeof AccordionPrimitive.Item> {
-    /** Unique string identifying this item within the accordion. */
+    /** Unique string identifying this item within the accordion. Must be unique across sibling items. */
     value: string;
     /** Prevents interaction with this specific item. @default false */
     disabled?: boolean;
-    /** When true, clicking the content area also toggles the item. Set to false for items with interactive content (forms, inputs). @default true */
+    /**
+     * When true, clicking anywhere on the item (not just the header) toggles the open state.
+     * Set to false for items whose content contains interactive elements (forms, inputs, switches)
+     * so inner clicks don't collapse the section.
+     *
+     * @default true
+     * @example
+     * <AccordionItem value="settings" clickableContent={false}>
+     *   <AccordionHeader>Settings</AccordionHeader>
+     *   <AccordionContent>
+     *     <Input />
+     *     <Switch />
+     *   </AccordionContent>
+     * </AccordionItem>
+     */
     clickableContent?: boolean;
-    /** When true, the item is always expanded, non-interactive, and the chevron is hidden. The header renders as a plain element instead of a button for proper accessibility. @default false */
+    /**
+     * When true, the item is always expanded, non-interactive, and the chevron is hidden.
+     * The header renders as a plain element instead of a button so it stays accessible
+     * when no toggle action is available.
+     *
+     * @default false
+     * @example
+     * <AccordionItem value="always-visible" static>
+     *   <AccordionHeader>Always visible</AccordionHeader>
+     *   <AccordionContent>This content is always shown.</AccordionContent>
+     * </AccordionItem>
+     */
     static?: boolean;
 }
-/** Props for AccordionHeader. Clickable area that toggles content visibility. */
+/**
+ * Props for the AccordionHeader component.
+ * Renders the clickable header area that toggles content visibility.
+ * Wraps and behaves as Radix's `Accordion.Header` + `Accordion.Trigger`.
+ */
 export type AccordionHeaderProps = React.ComponentProps<typeof AccordionPrimitive.Header>;
-/** Props for AccordionContent. Collapsible content area with slide animation. */
+/**
+ * Props for the AccordionContent component.
+ * Collapsible content area with built-in slide-up/slide-down animation.
+ * Wraps Radix's `Accordion.Content`.
+ */
 export type AccordionContentProps = React.ComponentProps<typeof AccordionPrimitive.Content>;
 declare const accordionItemVariants: (props?: ({
     variant?: "default" | "branded" | "settings" | null | undefined;

package/dist/components/Accordion/Accordion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Accordion.d.ts","sourceRoot":"","sources":["../../../src/components/Accordion/Accordion.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,kBAAkB,MAAM,2BAA2B,CAAA;AAC/D,OAAO,EACL,KAAK,sBAAsB,IAAI,2BAA2B,EAC1D,KAAK,oBAAoB,IAAI,yBAAyB,EACvD,MAAM,2BAA2B,CAAA;AAKlC;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAA;AAEjE,mEAAmE;AACnE,MAAM,WAAW,oBAAqB,SAAQ,yBAAyB;IACrE,yDAAyD;IACzD,IAAI,EAAE,QAAQ,CAAA;IACd;;;;OAIG;IACH,OAAO,CAAC,EAAE,gBAAgB,CAAA;IAC1B,iFAAiF;IACjF,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,2EAA2E;IAC3E,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,gFAAgF;AAChF,MAAM,WAAW,sBAAuB,SAAQ,2BAA2B;IACzE,sEAAsE;IACtE,IAAI,EAAE,UAAU,CAAA;IAChB;;;;OAIG;IACH,OAAO,CAAC,EAAE,gBAAgB,CAAA;IAC1B,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAA;IACzC,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,cAAc,GAAG,oBAAoB,GAAG,sBAAsB,CAAA;AAE1E,yFAAyF;AACzF,MAAM,WAAW,kBACf,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,kBAAkB,CAAC,IAAI,CAAC;IAC5D,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAA;IACb,mEAAmE;IACnE,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,iJAAiJ;IACjJ,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,6LAA6L;IAC7L,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,iFAAiF;AACjF,MAAM,MAAM,oBAAoB,GAAG,KAAK,CAAC,cAAc,CACrD,OAAO,kBAAkB,CAAC,MAAM,CACjC,CAAA;AAED,iFAAiF;AACjF,MAAM,MAAM,qBAAqB,GAAG,KAAK,CAAC,cAAc,CACtD,OAAO,kBAAkB,CAAC,OAAO,CAClC,CAAA;AAMD,QAAA,MAAM,qBAAqB;;8EAYzB,CAAA;AAEF,QAAA,MAAM,wBAAwB;;8EAe7B,CAAA;AAED,QAAA,MAAM,6BAA6B;;8EASjC,CAAA;AA8BF,QAAA,MAAM,SAAS,GAAI,+CAIhB,cAAc,4CAahB,CAAA;AAED,QAAA,MAAM,aAAa,GAAI,wFAQpB,kBAAkB,4CAiDpB,CAAA;AAED,QAAA,MAAM,eAAe,GAAI,mCAItB,oBAAoB,4CA+BtB,CAAA;AAED,QAAA,MAAM,gBAAgB,GAAI,mCAIvB,qBAAqB,4CA6BvB,CAAA;AAED,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,qBAAqB,EACrB,wBAAwB,EACxB,6BAA6B,GAC9B,CAAA"}
+{"version":3,"file":"Accordion.d.ts","sourceRoot":"","sources":["../../../src/components/Accordion/Accordion.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,kBAAkB,MAAM,2BAA2B,CAAA;AAC/D,OAAO,EACL,KAAK,sBAAsB,IAAI,2BAA2B,EAC1D,KAAK,oBAAoB,IAAI,yBAAyB,EACvD,MAAM,2BAA2B,CAAA;AAKlC;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAA;AAEjE,mEAAmE;AACnE,MAAM,WAAW,oBAAqB,SAAQ,yBAAyB;IACrE,yDAAyD;IACzD,IAAI,EAAE,QAAQ,CAAA;IACd;;;;OAIG;IACH,OAAO,CAAC,EAAE,gBAAgB,CAAA;IAC1B,iFAAiF;IACjF,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,2EAA2E;IAC3E,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,gFAAgF;AAChF,MAAM,WAAW,sBAAuB,SAAQ,2BAA2B;IACzE,sEAAsE;IACtE,IAAI,EAAE,UAAU,CAAA;IAChB;;;;OAIG;IACH,OAAO,CAAC,EAAE,gBAAgB,CAAA;IAC1B,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAA;IACzC,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,cAAc,GAAG,oBAAoB,GAAG,sBAAsB,CAAA;AAE1E;;;GAGG;AACH,MAAM,WAAW,kBACf,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,kBAAkB,CAAC,IAAI,CAAC;IAC5D,qGAAqG;IACrG,KAAK,EAAE,MAAM,CAAA;IACb,mEAAmE;IACnE,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;;;;;;;;;;;OAcG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,KAAK,CAAC,cAAc,CACrD,OAAO,kBAAkB,CAAC,MAAM,CACjC,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,KAAK,CAAC,cAAc,CACtD,OAAO,kBAAkB,CAAC,OAAO,CAClC,CAAA;AAMD,QAAA,MAAM,qBAAqB;;8EAYzB,CAAA;AAEF,QAAA,MAAM,wBAAwB;;8EAe7B,CAAA;AAED,QAAA,MAAM,6BAA6B;;8EASjC,CAAA;AA8BF,QAAA,MAAM,SAAS,GAAI,+CAIhB,cAAc,4CAahB,CAAA;AAED,QAAA,MAAM,aAAa,GAAI,wFAQpB,kBAAkB,4CAiDpB,CAAA;AAED,QAAA,MAAM,eAAe,GAAI,mCAItB,oBAAoB,4CA+BtB,CAAA;AAED,QAAA,MAAM,gBAAgB,GAAI,mCAIvB,qBAAqB,4CA6BvB,CAAA;AAED,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,qBAAqB,EACrB,wBAAwB,EACxB,6BAA6B,GAC9B,CAAA"}

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

@@ -3,48 +3,102 @@ import { buttonVariants } from './buttonVariants';
 import * as React from 'react';
 /**
  * Props for the Button component.
- * Extends standard button HTML attributes. The `iconOnly` and `size` CVA variants
- * are excluded from VariantProps and re-declared with custom types.
+ *
+ * Extends standard button HTML attributes. CVA's inferred `iconOnly` and `size`
+ * variants are omitted from `VariantProps` and re-declared below with explicit
+ * union types so consumers see the allowed values in `.d.ts` output.
  */
 export interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, Omit<VariantProps<typeof buttonVariants>, 'iconOnly' | 'size'> {
     /**
-     * Visual style variant: primary (brand), secondary (outlined), tertiary (subtle),
-     * invert (dark backgrounds), dashed (bordered), link/linkInvert (text only).
+     * Visual style variant.
+     *
+     * - `primary` — brand-colored solid button for the main call-to-action.
+     * - `secondary` — outlined button for secondary actions.
+     * - `tertiary` — subtle button for low-emphasis actions.
+     * - `invert` — inverted colors for dark backgrounds.
+     * - `dashed` — dashed-border button, typically for add/create actions.
+     * - `link` / `linkInvert` — text-only link-styled button.
+     *
      * @default 'primary'
      */
     variant?: 'primary' | 'secondary' | 'tertiary' | 'invert' | 'dashed' | 'link' | 'linkInvert';
     /**
      * Controls height and padding. The `icon` size renders a compact icon-only
      * button with ghost styling (no background, border, or border radius).
+     *
      * @default 'md'
      */
     size?: 'xs' | 'sm' | 'md' | 'lg' | 'icon';
-    /** Stretches button to fill its container width. @default false */
+    /** Stretches the button to fill its container width. @default false */
     fullWidth?: boolean;
     /**
-     * When true, merges Button props/styles onto the single child element via
-     * Radix `Slot` (e.g. `<Button asChild><Link href="/">Home</Link></Button>`
-     * renders an `<a>` with all button styling and click target). Icons and the
-     * `loading` spinner are injected as siblings of the child's original content.
-     * Note: `disabled` has no effect on non-`<button>` children — use
-     * `aria-disabled` on the child instead.
+     * Renders the single child as the root element via Radix `Slot`, merging
+     * Button's props, styles, ref, and event handlers onto it. Use for
+     * polymorphic rendering — e.g. a router `Link`, a plain `<a>`, a `<label>`,
+     * or a `<button type="submit">` — while keeping full Button styling.
+     *
+     * Icons and the `loading` spinner are injected as siblings of the child's
+     * original content.
+     *
+     * Note: the `disabled` attribute is inert on non-`<button>` children
+     * (e.g. `<a>`). Use `aria-disabled` on the child instead.
+     *
      * @default false
+     * @example
+     * <Button asChild variant="primary">
+     *   <Link href="/dashboard">Go to dashboard</Link>
+     * </Button>
+     *
+     * @example
+     * <Button asChild variant="primary">
+     *   <button type="submit">Submit form</button>
+     * </Button>
      */
     asChild?: boolean;
-    /** React node displayed as an icon. Position controlled by `iconPosition`. */
+    /**
+     * Icon node rendered alongside the label. Position is controlled by
+     * `iconPosition`. Omit `children` to render an icon-only button (provide
+     * `aria-label` for accessibility).
+     *
+     * @example
+     * <Button icon={<DownloadIcon />}>Download</Button>
+     *
+     * @example
+     * <Button icon={<PlusIcon />} aria-label="Add" />
+     */
     icon?: React.ReactNode;
-    /** Places icon before (`start`) or after (`end`) the button text. Ignored when `secondIcon` is provided. @default 'start' */
+    /**
+     * Places `icon` before (`'start'`) or after (`'end'`) the button text.
+     * Ignored when `secondIcon` is provided.
+     *
+     * @default 'start'
+     */
     iconPosition?: 'start' | 'end';
-    /** Optional trailing icon. When set, `icon` is always rendered at the start and `secondIcon` at the end, ignoring `iconPosition`. */
+    /**
+     * Optional trailing icon. When set, `icon` is always rendered at the start
+     * and `secondIcon` at the end, overriding `iconPosition`.
+     *
+     * @example
+     * <Button icon={<PlusIcon />} secondIcon={<ArrowRightIcon />}>Add and continue</Button>
+     */
     secondIcon?: React.ReactNode;
-    /** Removes background, showing only text and icon with hover effects. @default false */
+    /**
+     * Removes background and border, showing only text and icon with hover
+     * effects. The `icon` size always renders as ghost regardless of this prop.
+     *
+     * @default false
+     */
     ghost?: boolean;
     /** Applies destructive/error styling for delete or dangerous actions. @default false */
     danger?: boolean;
     /**
-     * Shows a spinner overlay and disables interaction.
-     * Text becomes invisible but maintains button width.
+     * Shows a spinner overlay and disables interaction. The label fades out but
+     * the button keeps its width, preventing layout shift during async actions.
+     *
      * @default false
+     * @example
+     * const [saving, setSaving] = useState(false)
+     * <Button loading={saving} onClick={handleSave}>Save</Button>
      */
     loading?: boolean;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"Button.d.ts","sourceRoot":"","sources":["../../../src/components/Button/Button.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAI5D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEjD;;;;GAIG;AACH,MAAM,WAAW,WACf,SAAQ,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EACnD,IAAI,CAAC,YAAY,CAAC,OAAO,cAAc,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;IAChE;;;;OAIG;IACH,OAAO,CAAC,EACJ,SAAS,GACT,WAAW,GACX,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,YAAY,CAAA;IAChB;;;;OAIG;IACH,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAA;IACzC,mEAAmE;IACnE,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,8EAA8E;IAC9E,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB,6HAA6H;IAC7H,YAAY,CAAC,EAAE,OAAO,GAAG,KAAK,CAAA;IAC9B,qIAAqI;IACrI,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC5B,wFAAwF;IACxF,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,wFAAwF;IACxF,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,QAAA,MAAM,MAAM,uFAqFX,CAAA;AAGD,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAA"}
+{"version":3,"file":"Button.d.ts","sourceRoot":"","sources":["../../../src/components/Button/Button.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAI5D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEjD;;;;;;GAMG;AACH,MAAM,WAAW,WACf,SAAQ,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EACnD,IAAI,CAAC,YAAY,CAAC,OAAO,cAAc,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;IAChE;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,EACJ,SAAS,GACT,WAAW,GACX,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,YAAY,CAAA;IAChB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAA;IACzC,uEAAuE;IACvE,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;;;;;;;;OAUG;IACH,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,OAAO,GAAG,KAAK,CAAA;IAC9B;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC5B;;;;;OAKG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,wFAAwF;IACxF,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,QAAA,MAAM,MAAM,uFAqFX,CAAA;AAGD,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAA"}

package/dist/components/DataTable/DataTable.d.ts

@@ -1,11 +1,19 @@
 import { ReactNode } from 'react';
 import { VariantProps } from 'class-variance-authority';
+/**
+ * CVA variants for the DataTable body cells. Controls background color
+ * (`variant`) and rounded-corner/border treatment based on the cell's
+ * position in the row (`position`).
+ */
 declare const dataTableCellVariants: (props?: ({
     variant?: "default" | "white" | null | undefined;
     position?: "first" | "last" | "middle" | null | undefined;
 } & import('class-variance-authority/types').ClassProp) | undefined) => string;
 /**
- * Column definition for the DataTable component.
+ * Column definition for the DataTable component. Describes how a single column
+ * pulls its value from each row object, how its header renders, and optionally
+ * how each cell renders.
+ *
  * @typeParam T - The type of data objects in each row
  *
  * @example
@@ -16,20 +24,24 @@ declare const dataTableCellVariants: (props?: ({
  * ]
  */
 export interface DataTableColumn<T> {
-    /** Property key from the data object to display in this column. */
+    /** Property key on each row object whose value is displayed in this column. */
     dataKey: keyof T;
-    /** Header label for the column. */
+    /** Header label for the column. Pass an empty string to render a blank header (e.g. an actions column). */
     title: ReactNode;
-    /** Additional CSS class applied to both the header and body cells. */
+    /** Extra CSS class applied to both the header cell (`<th>`) and body cells (`<td>`) of this column. */
     className?: string;
     /**
-     * Truncates cell text to the specified number of lines.
-     * `true` or `1` clamps to one line, `2` clamps to two lines.
+     * Truncates default cell text to the specified number of lines. Has no
+     * effect when a custom `render` is provided.
+     * - `true` or `1` clamps to one line
+     * - `2` clamps to two lines
      */
     lineClamp?: boolean | 1 | 2;
     /**
      * Custom render function for cell content. When omitted, the raw value
-     * is displayed inside a Typography component.
+     * at `dataKey` is displayed inside a Typography component. The function
+     * receives the raw value, the full row object, the row index, and the
+     * table's `disabled` state so custom cells can mirror the disabled styling.
      *
      * @example
      * render: (value, rowData, rowIndex, disabled) => (
@@ -40,26 +52,51 @@ export interface DataTableColumn<T> {
 }
 /**
  * Props for the DataTable component.
- * Extends standard table attributes except `children` (content is driven by `data` and `columns`).
+ * Extends standard table attributes except `children` (content is driven by
+ * `data` and `columns` rather than JSX children).
+ *
  * @typeParam T - The type of data objects in each row
  */
 export interface DataTableProps<T> extends Omit<React.HTMLAttributes<HTMLTableElement>, 'children'>, Omit<VariantProps<typeof dataTableCellVariants>, 'variant' | 'position'> {
-    /** Array of data objects to display as table rows. */
+    /** Array of data objects to display. Each item renders as one table row. */
     data: T[];
-    /** Column definitions describing headers and cell rendering. @see DataTableColumn */
+    /**
+     * Column definitions describing headers, cell rendering, and per-column styling.
+     * @see DataTableColumn
+     */
     columns: DataTableColumn<T>[];
     /** Controls visibility of the table header row. @default true */
     showHeader?: boolean;
-    /** Additional CSS class applied to the table element. */
+    /** Extra CSS class applied to the `<table>` element. */
     className?: string;
-    /** Visual style variant for row background. @default 'default' */
+    /**
+     * Visual style variant for row background.
+     * - `'default'` uses the primary surface color
+     * - `'white'` uses the secondary surface color (for nested/alt backgrounds)
+     *
+     * @default 'default'
+     */
     variant?: 'default' | 'white';
-    /** Prevents interaction and applies muted text colors. @default false */
+    /**
+     * Prevents row-click interaction and applies muted text colors. The value
+     * is also forwarded to every column's `render` callback so custom cells
+     * can reflect the disabled state.
+     *
+     * @default false
+     */
     disabled?: boolean;
     /**
      * Fires when a row is clicked (pointer only — rows are not keyboard-activatable).
-     * When provided and not `disabled`, rows get a pointer cursor and a
-     * hover/focus-within border on cells.
+     * When provided and the table is not `disabled`, rows get a pointer cursor
+     * and a hover/focus-within border on cells. Inner interactive elements
+     * should call `event.stopPropagation()` to prevent the row handler from firing.
+     *
+     * @example
+     * <DataTable
+     *   data={users}
+     *   columns={columns}
+     *   onRowClick={(rowData, rowIndex) => openDetail(rowData.id)}
+     * />
      */
     onRowClick?: (rowData: T, rowIndex: number) => void;
 }

package/dist/components/DataTable/DataTable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DataTable.d.ts","sourceRoot":"","sources":["../../../src/components/DataTable/DataTable.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,EAAE,KAAK,YAAY,EAAO,MAAM,0BAA0B,CAAA;AAIjE,QAAA,MAAM,qBAAqB;;;8EAmB1B,CAAA;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC,CAAA;IAChB,mCAAmC;IACnC,KAAK,EAAE,SAAS,CAAA;IAChB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,CAAC,GAAG,CAAC,CAAA;IAC3B;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,CACP,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EACjB,OAAO,EAAE,CAAC,EACV,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,OAAO,KACf,SAAS,CAAA;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,CAC/B,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,gBAAgB,CAAC,EAAE,UAAU,CAAC,EAC9D,IAAI,CAAC,YAAY,CAAC,OAAO,qBAAqB,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC;IAC1E,sDAAsD;IACtD,IAAI,EAAE,CAAC,EAAE,CAAA;IACT,qFAAqF;IACrF,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,CAAA;IAC7B,iEAAiE;IACjE,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kEAAkE;IAClE,OAAO,CAAC,EAAE,SAAS,GAAG,OAAO,CAAA;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;CACpD;AAED,QAAA,MAAM,SAAS,GAAI,CAAC,EAAG,mFASpB,cAAc,CAAC,CAAC,CAAC,4CAwGnB,CAAA;AAED,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,CAAA"}
+{"version":3,"file":"DataTable.d.ts","sourceRoot":"","sources":["../../../src/components/DataTable/DataTable.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,EAAE,KAAK,YAAY,EAAO,MAAM,0BAA0B,CAAA;AAIjE;;;;GAIG;AACH,QAAA,MAAM,qBAAqB;;;8EAmB1B,CAAA;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC,CAAA;IAChB,2GAA2G;IAC3G,KAAK,EAAE,SAAS,CAAA;IAChB,uGAAuG;IACvG,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,CAAC,GAAG,CAAC,CAAA;IAC3B;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAE,CACP,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EACjB,OAAO,EAAE,CAAC,EACV,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,OAAO,KACf,SAAS,CAAA;CACf;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,CAC/B,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,gBAAgB,CAAC,EAAE,UAAU,CAAC,EAC9D,IAAI,CAAC,YAAY,CAAC,OAAO,qBAAqB,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC;IAC1E,4EAA4E;IAC5E,IAAI,EAAE,CAAC,EAAE,CAAA;IACT;;;OAGG;IACH,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,CAAA;IAC7B,iEAAiE;IACjE,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,SAAS,GAAG,OAAO,CAAA;IAC7B;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;;;;;;;;;OAYG;IACH,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;CACpD;AAED,QAAA,MAAM,SAAS,GAAI,CAAC,EAAG,mFASpB,cAAc,CAAC,CAAC,CAAC,4CAwGnB,CAAA;AAED,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,CAAA"}

package/dist/components/DatePicker/DatePicker.d.ts

@@ -3,29 +3,44 @@ import { DateRange } from 'react-day-picker';
 import { CalendarBaseProps } from '../Calendar';
 import { PopoverContentProps } from '../Popover/Popover';
 import { Presets } from './utils/getDateRange';
+/**
+ * Custom class names for DatePicker internal elements.
+ *
+ * @example
+ * classNames={{ popoverTrigger: 'w-full', input: 'rounded-lg' }}
+ */
+export type DatePickerClassNames = Partial<{
+    /** Class applied to the Radix popover trigger wrapping the input. */
+    popoverTrigger: string;
+    /** Class applied to the popover content container. */
+    popoverContent: string;
+    /** Class applied to the default Input trigger. */
+    input: string;
+    /** Class applied to each preset button in the left panel. */
+    leftPanelButton: string;
+}>;
 /**
  * Props for the DatePicker component.
  *
- * Uses a discriminated union on `mode` to type `value`, `defaultValue`,
- * `onChange`, and `dateFormatter` for either single date or date range selection.
+ * Discriminated union on `mode`: `'single'` for picking one date, `'range'` for a start-end range.
+ * The `mode` value narrows `value`, `defaultValue`, `onChange`, and `dateFormatter`
+ * to the matching type — see {@link DatePickerSingleProps} and {@link DatePickerRangeProps}.
  *
- * Also inherits calendar layout/visibility props from {@link CalendarBaseProps}
- * (e.g. `hideNavigation`, `hideCaption`, `showOutsideDays`, etc.).
+ * Also inherits calendar layout and visibility props from {@link CalendarBaseProps}
+ * (e.g. `hideNavigation`, `hideCaption`, `showOutsideDays`, `weekStartsOn`, `disabledDates`).
  */
 export type DatePickerProps = {
-    /** Controls horizontal alignment of the calendar popover relative to the trigger. */
+    /** Horizontal alignment of the calendar popover relative to the trigger. */
     alignCalendar?: 'center' | 'end' | 'start';
     /**
-     * Defines preset date range options shown in the left panel (range mode only).
+     * Preset date range shortcuts shown in the left panel (range mode only).
      * Each preset has a display `name` and a `type` matching a built-in range calculation.
      *
      * @example
-     * ```tsx
      * allowedPresets={[
      *   { name: 'Today', type: 'Today' },
      *   { name: 'Last 7 days', type: 'Last 7 days' },
      * ]}
-     * ```
      *
      * @see Presets
      */
@@ -33,35 +48,26 @@ export type DatePickerProps = {
         name: string;
         type: (typeof Presets)[number];
     }[];
-    /** Controls the open state of the calendar popover when used as a controlled component. */
+    /** Controlled open state of the calendar popover. */
     open?: boolean;
     /** Fires when the popover open state changes. */
     onOpenChange?: (open: boolean) => void;
     /**
      * Custom class names for internal elements.
-     *
-     * @example
-     * ```tsx
-     * classNames={{ popoverTrigger: 'w-full', input: 'rounded-lg' }}
-     * ```
+     * @see DatePickerClassNames
      */
-    classNames?: Partial<{
-        popoverTrigger: string;
-        popoverContent: string;
-        input: string;
-        leftPanelButton: string;
-    }>;
+    classNames?: DatePickerClassNames;
     /** Prevents interaction and applies disabled styling. */
     disabled?: boolean;
     /** Applies error styling with red border to the input. */
     error?: boolean;
-    /** Displays label text above the input. */
+    /** Label text displayed above the input. */
     label?: string;
-    /** Displays helper text below the input. */
+    /** Helper text displayed below the input. */
     hint?: string;
     /** Placeholder text shown when no date is selected. */
     placeholder?: string;
-    /** Controls which side of the trigger the calendar popover opens on. @default 'bottom' */
+    /** Side of the trigger the calendar popover opens on. @default 'bottom' */
     side?: 'top' | 'right' | 'bottom' | 'left';
     /** Prevents the popover from overflowing viewport boundaries. @default true */
     avoidCollisions?: boolean;
@@ -79,24 +85,48 @@ export type DatePickerProps = {
     /** Replaces the default Input trigger with a custom rendered element. */
     renderCustomTrigger?: () => ReactNode;
     /**
-     * Controls reset button behavior. When true, reset restores `defaultValue`.
-     * When false or omitted, reset reverts to the last confirmed value.
+     * Controls reset button behavior. When `true`, reset restores `defaultValue`.
+     * When `false` or omitted, reset reverts to the last confirmed value.
+     *
+     * @example
+     * // Reset clears the field (defaultValue is undefined)
+     * <DatePicker shouldResetToDefaultValue defaultValue={undefined} />
      */
     shouldResetToDefaultValue?: boolean;
-    /** When true, every calendar click calls onChange immediately. Buttons remain visible. Reset reverts to value when popover opened. */
+    /**
+     * Calls `onChange` immediately on every calendar click instead of waiting for
+     * confirm. Bottom bar buttons remain visible unless {@link hideBottomBar} is true.
+     * Reset reverts to the value the popover was opened with.
+     */
     immediateCommit?: boolean;
-    /** Range mode only. Replicates react-day-picker v8 range behavior (no longer natively supported in v9): first click sets start, second click sets end (same-day allowed). Clicking the same day again cycles back — when `required` is false the cycle is: selected → one-day range → cleared → selected; otherwise: selected → one-day range → selected. */
+    /**
+     * Range mode only. Replicates react-day-picker v8 same-day range behavior
+     * (no longer supported natively in v9): first click sets start, second click
+     * sets end (same day allowed). A third click on the same day cycles back:
+     * - `required={false}`: selected → one-day range → cleared → selected
+     * - otherwise: selected → one-day range → selected
+     */
     allowOneDayRange?: boolean;
-    /** Marks the field as required, displaying an asterisk on the label. Also passed to the underlying Calendar — when explicitly set to `false`, allows deselecting dates by clicking the selected date again. */
+    /**
+     * Marks the field as required and displays an asterisk on the label.
+     * Also forwarded to the underlying Calendar — when explicitly set to `false`,
+     * dates can be deselected by clicking the selected date again.
+     */
     required?: boolean;
     /** Hides the required asterisk even when `required` is true. @default false */
     disableRequiredAsterisk?: boolean;
-    /** Number of months to display side by side. @default 2 on desktop, 1 on mobile */
+    /** Number of months displayed side by side. @default 2 on desktop, 1 on mobile */
     numberOfMonths?: 1 | 2;
-    /** Hides the entire bottom bar (text, reset button, and confirm button). Only effective when `immediateCommit` is true. @default false */
+    /**
+     * Hides the entire bottom bar (text, reset button, and confirm button).
+     * Only effective when `immediateCommit` is true. @default false
+     */
     hideBottomBar?: boolean;
 } & Omit<CalendarBaseProps, 'numberOfMonths' | 'onConfirm' | 'onReset' | 'isExpanded' | 'leftPanelChildren' | 'bottomTextDefault' | 'dateFormatter' | 'dateRangeFormatter' | 'required'> & (DatePickerRangeProps | DatePickerSingleProps);
-/** Props for date range selection mode. */
+/**
+ * Props for date range selection mode (`mode: 'range'`).
+ * Narrows `value`, `defaultValue`, `onChange`, and `dateFormatter` to `DateRange`.
+ */
 export type DatePickerRangeProps = {
     /** Enables date range selection with start and end dates. */
     mode: 'range';
@@ -104,12 +134,15 @@ export type DatePickerRangeProps = {
     value?: DateRange | undefined;
     /** Initial date range for uncontrolled usage. */
     defaultValue?: DateRange | undefined;
-    /** Fires when a date range selection is confirmed, or `undefined` when deselected (`required={false}`). */
+    /** Fires when a date range is confirmed, or `undefined` when deselected (`required={false}`). */
     onChange?: (date: DateRange | undefined) => void;
-    /** Custom function to format the displayed date range string. */
+    /** Custom formatter for the date range displayed in the input trigger. */
     dateFormatter?: (date: DateRange) => string;
 };
-/** Props for single date selection mode. */
+/**
+ * Props for single date selection mode (`mode: 'single'`).
+ * Narrows `value`, `defaultValue`, `onChange`, and `dateFormatter` to `Date`.
+ */
 export type DatePickerSingleProps = {
     /** Enables single date selection. */
     mode: 'single';
@@ -117,9 +150,9 @@ export type DatePickerSingleProps = {
     value?: Date | undefined;
     /** Initial date for uncontrolled usage. */
     defaultValue?: Date | undefined;
-    /** Fires when a single date selection is confirmed, or `undefined` when deselected (`required={false}`). */
+    /** Fires when a date is confirmed, or `undefined` when deselected (`required={false}`). */
     onChange?: (date: Date | undefined) => void;
-    /** Custom function to format the displayed date string. */
+    /** Custom formatter for the date displayed in the input trigger. */
     dateFormatter?: (date: Date) => string;
 };
 export declare const DatePicker: import('react').ForwardRefExoticComponent<DatePickerProps & import('react').RefAttributes<HTMLInputElement>>;

package/dist/components/DatePicker/DatePicker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DatePicker.d.ts","sourceRoot":"","sources":["../../../src/components/DatePicker/DatePicker.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"DatePicker.d.ts","sourceRoot":"","sources":["../../../src/components/DatePicker/DatePicker.tsx"],"names":[],"mappings":"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"}

package/dist/components/DatePicker/DatePicker.stories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DatePicker.stories.d.ts","sourceRoot":"","sources":["../../../src/components/DatePicker/DatePicker.stories.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAI3D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAKzC,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,UAAU,CAiMjC,CAAA;AAED,eAAe,IAAI,CAAA;AACnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,UAAU,CAAC,CAAA;AAExC,eAAO,MAAM,iBAAiB,EAAE,KAoC/B,CAAA;AAED,eAAO,MAAM,gBAAgB,EAAE,KAsB9B,CAAA;AAED,eAAO,MAAM,0BAA0B,EAAE,KAuBxC,CAAA;AAED,eAAO,MAAM,eAAe,EAAE,KA0B7B,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAwBtB,CAAA;AAED,eAAO,MAAM,KAAK,EAAE,KAwBnB,CAAA;AAED,eAAO,MAAM,0BAA0B,EAAE,KAyBxC,CAAA;AAED,eAAO,MAAM,2BAA2B,EAAE,KAmCzC,CAAA;AAED,eAAO,MAAM,qCAAqC,EAAE,KA8CnD,CAAA;AAED,eAAO,MAAM,4BAA4B,EAAE,KAyB1C,CAAA;AAED,eAAO,MAAM,4BAA4B,EAAE,KAyB1C,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KA0BtB,CAAA;AAED,eAAO,MAAM,WAAW,EAAE,KAwBzB,CAAA;AAED,eAAO,MAAM,oBAAoB,EAAE,KAkClC,CAAA;AAED,eAAO,MAAM,8BAA8B,EAAE,KAiC5C,CAAA;AAED,eAAO,MAAM,gBAAgB,EAAE,KAkC9B,CAAA;AAED,eAAO,MAAM,WAAW,EAAE,KAoCzB,CAAA;AAED,eAAO,MAAM,WAAW,EAAE,KAqCzB,CAAA;AAED,eAAO,MAAM,UAAU,EAAE,KA6CxB,CAAA"}
+{"version":3,"file":"DatePicker.stories.d.ts","sourceRoot":"","sources":["../../../src/components/DatePicker/DatePicker.stories.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAI3D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAKzC,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,UAAU,CA2KjC,CAAA;AAED,eAAe,IAAI,CAAA;AACnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,UAAU,CAAC,CAAA;AAExC,eAAO,MAAM,iBAAiB,EAAE,KAoC/B,CAAA;AAED,eAAO,MAAM,gBAAgB,EAAE,KAsB9B,CAAA;AAED,eAAO,MAAM,0BAA0B,EAAE,KAuBxC,CAAA;AAED,eAAO,MAAM,eAAe,EAAE,KA0B7B,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAwBtB,CAAA;AAED,eAAO,MAAM,KAAK,EAAE,KAwBnB,CAAA;AAED,eAAO,MAAM,0BAA0B,EAAE,KAyBxC,CAAA;AAED,eAAO,MAAM,2BAA2B,EAAE,KAmCzC,CAAA;AAED,eAAO,MAAM,qCAAqC,EAAE,KA8CnD,CAAA;AAED,eAAO,MAAM,4BAA4B,EAAE,KAyB1C,CAAA;AAED,eAAO,MAAM,4BAA4B,EAAE,KAyB1C,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KA0BtB,CAAA;AAED,eAAO,MAAM,WAAW,EAAE,KAwBzB,CAAA;AAED,eAAO,MAAM,oBAAoB,EAAE,KAkClC,CAAA;AAED,eAAO,MAAM,8BAA8B,EAAE,KAiC5C,CAAA;AAED,eAAO,MAAM,gBAAgB,EAAE,KAkC9B,CAAA;AAED,eAAO,MAAM,WAAW,EAAE,KAoCzB,CAAA;AAED,eAAO,MAAM,WAAW,EAAE,KAqCzB,CAAA;AAED,eAAO,MAAM,UAAU,EAAE,KA6CxB,CAAA"}

package/dist/components/EdgeButton/EdgeButton.d.ts

@@ -4,17 +4,13 @@ declare const edgeButtonVariants: (props?: ({
 } & import('class-variance-authority/types').ClassProp) | undefined) => string;
 /**
  * Props for the EdgeButton component.
- *
- * EdgeButton is a fixed-position help button designed for page corners with a distinctive
- * rounded top-left corner design and primary brand styling.
+ * Extends standard button HTML attributes. `disabled` is re-declared on the
+ * interface so JSDoc flows into the generated `.d.ts` output.
  */
 export interface EdgeButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
-    /** Button text content displayed next to the icon. */
+    /** Button text content displayed next to the icon. Rendered with Typography (cta, medium, base). */
     text?: string;
-    /**
-     * Prevents user interaction and applies disabled styling with reduced opacity.
-     * @default false
-     */
+    /** Prevents interaction and applies disabled styling. @default false */
     disabled?: boolean;
     /**
      * When true, merges EdgeButton props/styles onto the single child element via
@@ -24,11 +20,14 @@ export interface EdgeButtonProps extends React.ButtonHTMLAttributes<HTMLButtonEl
      * Note: `disabled` has no effect on non-`<button>` children — use
      * `aria-disabled` on the child instead.
      * @default false
+     *
+     * @example
+     * <EdgeButton asChild text="Help">
+     *   <a href="/help" />
+     * </EdgeButton>
      */
     asChild?: boolean;
-    /**
-     * Leading icon element positioned before the text.
-     */
+    /** Leading icon node rendered before the text. Sized to `size-icon-medium`. */
     icon?: React.ReactNode;
 }
 declare const EdgeButton: React.ForwardRefExoticComponent<EdgeButtonProps & React.RefAttributes<HTMLButtonElement>>;

package/dist/components/EdgeButton/EdgeButton.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EdgeButton.d.ts","sourceRoot":"","sources":["../../../src/components/EdgeButton/EdgeButton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAOzB,QAAA,MAAM,kBAAkB;;8EAwBvB,CAAA;AAED;;;;;GAKG;AACH,MAAM,WAAW,eACf,SAAQ,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC;IACrD,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;OAEG;IACH,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CACvB;AAED,QAAA,MAAM,UAAU,2FAmFf,CAAA;AAID,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,CAAA"}
+{"version":3,"file":"EdgeButton.d.ts","sourceRoot":"","sources":["../../../src/components/EdgeButton/EdgeButton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAOzB,QAAA,MAAM,kBAAkB;;8EAwBvB,CAAA;AAED;;;;GAIG;AACH,MAAM,WAAW,eACf,SAAQ,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC;IACrD,oGAAoG;IACpG,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,wEAAwE;IACxE,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,+EAA+E;IAC/E,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CACvB;AAED,QAAA,MAAM,UAAU,2FAmFf,CAAA;AAID,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,CAAA"}