@vkzstudio/muza-ui 1.0.43 → 1.0.44

package/dist/components/ExpandableTable/ExpandableTable.d.ts

@@ -6,7 +6,19 @@ import { ReactNode } from 'react';
 export type ResponsiveBreakpoint = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl';
 /**
  * Column definition for the ExpandableTable.
+ *
  * @typeParam T - The type of data objects in each row
+ *
+ * @example
+ * const columns: IColumn<Order>[] = [
+ *   { dataKey: 'date', title: 'Date', responsive: 'sm' },
+ *   {
+ *     dataKey: 'status',
+ *     title: 'Status',
+ *     responsive: 'md',
+ *     render: (value) => <Tag variant="success">{value}</Tag>,
+ *   },
+ * ]
  */
 export interface IColumn<T> {
     /** Key of the data object to display in this column. */
@@ -28,20 +40,31 @@ export interface IColumn<T> {
      * - Named breakpoint (`'xs'..'3xl'`): visible at and above that breakpoint, rendered with static Tailwind classes.
      * - Boolean: caller supplies the visibility directly (e.g. from `useMediaQuery('(min-width: 52rem)')`).
      *   `true` shows the column, `false` hides it. Use this for arbitrary thresholds.
+     *
      * @default 'xs'
+     * @see ResponsiveBreakpoint
      */
     responsive?: ResponsiveBreakpoint | boolean;
     /**
      * When `responsive` hides this column, also render it in the automatic expandable area
      * below the row. Set to `false` to just hide the column — useful when the expandable
      * area already contains a richer version of the same data.
+     *
      * @default true
      */
     moveToExpandable?: boolean;
 }
 /**
  * Cell definition within an expandable row section.
+ *
  * @typeParam T - The type of data objects in each row
+ *
+ * @example
+ * const cell: IExpandableTableRowCell<Order> = {
+ *   dataKey: 'customerName',
+ *   title: 'Customer',
+ *   render: (value) => <a href="#profile">{value}</a>,
+ * }
  */
 export interface IExpandableTableRowCell<T> {
     /** Key of the data object to display in this cell. */
@@ -50,28 +73,59 @@ export interface IExpandableTableRowCell<T> {
     className?: string;
     /** Label rendered next to the cell value. */
     title: ReactNode;
-    /** Custom render function for the cell value. When omitted, the raw value is rendered as text. */
+    /**
+     * Custom render function for the cell value.
+     * When omitted, the raw value is rendered as text.
+     *
+     * @example
+     * render: (value, row) => <Typography weight="medium">{value}</Typography>
+     */
     render?: (value: T[keyof T], rowData: T) => ReactNode;
 }
 /**
  * Section definition for the expandable row content.
  * Groups related cells under an optional heading.
+ *
  * @typeParam T - The type of data objects in each row
+ *
+ * @example
+ * const section: IExpandableTableRowSection<Order> = {
+ *   title: 'Customer Information',
+ *   cells: [
+ *     { dataKey: 'customerName', title: 'Name' },
+ *     { dataKey: 'customerAddress', title: 'Address' },
+ *   ],
+ * }
  */
 export interface IExpandableTableRowSection<T> {
     /** Optional heading rendered above the section cells. */
     title?: ReactNode;
-    /** Array of cell definitions displayed within this section. @see IExpandableTableRowCell */
+    /**
+     * Array of cell definitions displayed within this section.
+     *
+     * @see IExpandableTableRowCell
+     */
     cells: IExpandableTableRowCell<T>[];
 }
 /**
  * Props for the ExpandableTable component.
+ *
  * @typeParam T - The type of data objects in each row
  */
 export interface ExpandableTableProps<T> {
     /** Array of data objects where each item represents one table row. */
     data: T[];
-    /** Array of column definitions describing headers and cell rendering. @see IColumn */
+    /**
+     * Array of column definitions describing headers and cell rendering.
+     *
+     * @example
+     * const columns: IColumn<Order>[] = [
+     *   { dataKey: 'date', title: 'Date', responsive: 'sm' },
+     *   { dataKey: 'title', title: 'Order' },
+     * ]
+     *
+     * @see IColumn
+     */
     columns: IColumn<T>[];
     /**
      * Sections shown when a row is expanded. Can be a static array applied to every row
@@ -80,21 +134,32 @@ export interface ExpandableTableProps<T> {
      *
      * @example
      * // Static sections
-     * expandableRowSections={[{ title: 'Details', cells: [{ dataKey: 'name', title: 'Name' }] }]}
+     * expandableRowSections={[
+     *   { title: 'Details', cells: [{ dataKey: 'name', title: 'Name' }] },
+     * ]}
      *
      * // Dynamic sections based on row data
-     * expandableRowSections={(row) => row.status === 'active' ? activeSections : inactiveSections}
+     * expandableRowSections={(row) =>
+     *   row.status === 'active' ? activeSections : inactiveSections
+     * }
      *
      * @see IExpandableTableRowSection
      */
     expandableRowSections?: IExpandableTableRowSection<T>[] | ((row: T) => IExpandableTableRowSection<T>[]);
     /**
-     * Custom CSS classes for internal elements.
+     * Custom CSS classes for internal elements of the expanded row area.
+     * Use to override the default grid layouts when labels are long or when
+     * independent column sizing is needed.
      *
      * @example
-     * ```tsx
+     * // Override the outer grid used inside the expanded row
      * classNames={{ expandedContentGrid: 'md:grid-cols-[200px_1fr]' }}
-     * ```
+     *
+     * // Replace the subgrid inside each section with independent columns
+     * classNames={{
+     *   sectionTitle: 'md:grid-cols-[minmax(200px,auto)_1fr]',
+     *   cellsWrap: 'md:grid-cols-[minmax(200px,auto)_1fr]',
+     * }}
      */
     classNames?: Partial<{
         /** Custom class for the expanded content grid container (overrides default `md:grid-cols-[auto_1fr]`). */

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

@@ -1 +1 @@
-{"version":3,"file":"ExpandableTable.d.ts","sourceRoot":"","sources":["../../../src/components/ExpandableTable/ExpandableTable.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,SAAS,EAMf,MAAM,OAAO,CAAA;AAuBd;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAC5B,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,KAAK,GACL,KAAK,CAAA;AAET;;;GAGG;AACH,MAAM,WAAW,OAAO,CAAC,CAAC;IACxB,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC,CAAA;IAChB,iDAAiD;IACjD,KAAK,EAAE,SAAS,CAAA;IAChB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,SAAS,CAAA;IACrD;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAA;IAC3C;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB,CAAC,CAAC;IACxC,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC,CAAA;IAChB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,6CAA6C;IAC7C,KAAK,EAAE,SAAS,CAAA;IAChB,kGAAkG;IAClG,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,SAAS,CAAA;CACtD;AAED;;;;GAIG;AACH,MAAM,WAAW,0BAA0B,CAAC,CAAC;IAC3C,yDAAyD;IACzD,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,4FAA4F;IAC5F,KAAK,EAAE,uBAAuB,CAAC,CAAC,CAAC,EAAE,CAAA;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,sEAAsE;IACtE,IAAI,EAAE,CAAC,EAAE,CAAA;IACT,sFAAsF;IACtF,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAA;IACrB;;;;;;;;;;;;;OAaG;IACH,qBAAqB,CAAC,EAClB,0BAA0B,CAAC,CAAC,CAAC,EAAE,GAC/B,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,0BAA0B,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;IACjD;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;QACnB,0GAA0G;QAC1G,mBAAmB,EAAE,MAAM,CAAA;QAC3B,yFAAyF;QACzF,YAAY,EAAE,MAAM,CAAA;QACpB,0GAA0G;QAC1G,SAAS,EAAE,MAAM,CAAA;KAClB,CAAC,CAAA;CACH;AA4CD,eAAO,MAAM,eAAe,GAAI,CAAC,EAAG,uDAKjC,oBAAoB,CAAC,CAAC,CAAC,4CAiZzB,CAAA"}
+{"version":3,"file":"ExpandableTable.d.ts","sourceRoot":"","sources":["../../../src/components/ExpandableTable/ExpandableTable.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,SAAS,EAMf,MAAM,OAAO,CAAA;AAuBd;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAC5B,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,KAAK,GACL,KAAK,CAAA;AAET;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,OAAO,CAAC,CAAC;IACxB,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC,CAAA;IAChB,iDAAiD;IACjD,KAAK,EAAE,SAAS,CAAA;IAChB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,SAAS,CAAA;IACrD;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAA;IAC3C;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,uBAAuB,CAAC,CAAC;IACxC,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC,CAAA;IAChB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,6CAA6C;IAC7C,KAAK,EAAE,SAAS,CAAA;IAChB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,SAAS,CAAA;CACtD;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,0BAA0B,CAAC,CAAC;IAC3C,yDAAyD;IACzD,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB;;;;OAIG;IACH,KAAK,EAAE,uBAAuB,CAAC,CAAC,CAAC,EAAE,CAAA;CACpC;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,sEAAsE;IACtE,IAAI,EAAE,CAAC,EAAE,CAAA;IACT;;;;;;;;;;OAUG;IACH,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAA;IACrB;;;;;;;;;;;;;;;;;OAiBG;IACH,qBAAqB,CAAC,EAClB,0BAA0B,CAAC,CAAC,CAAC,EAAE,GAC/B,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,0BAA0B,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;IACjD;;;;;;;;;;;;;;OAcG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;QACnB,0GAA0G;QAC1G,mBAAmB,EAAE,MAAM,CAAA;QAC3B,yFAAyF;QACzF,YAAY,EAAE,MAAM,CAAA;QACpB,0GAA0G;QAC1G,SAAS,EAAE,MAAM,CAAA;KAClB,CAAC,CAAA;CACH;AA4CD,eAAO,MAAM,eAAe,GAAI,CAAC,EAAG,uDAKjC,oBAAoB,CAAC,CAAC,CAAC,4CAiZzB,CAAA"}

package/dist/components/ExpandableTable/ExpandableTable.stories.d.ts

@@ -25,6 +25,9 @@ declare const meta: {
         expandableRowSections: {
             control: "object";
         };
+        classNames: {
+            control: "object";
+        };
     };
 };
 export default meta;

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

@@ -1 +1 @@
-{"version":3,"file":"ExpandableTable.stories.d.ts","sourceRoot":"","sources":["../../../src/components/ExpandableTable/ExpandableTable.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAQ,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAO3D,QAAA,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+B8B,CAAA;AAExC,eAAe,IAAI,CAAA;AACnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAA;AA+MlC,eAAO,MAAM,MAAM,EAAE,KAsBpB,CAAA;AAED,eAAO,MAAM,iBAAiB,EAAE,KAkB/B,CAAA;AAED,eAAO,MAAM,mBAAmB,EAAE,KAwJjC,CAAA;AAED,eAAO,MAAM,SAAS,EAAE,KAuBvB,CAAA;AAED,eAAO,MAAM,4BAA4B,EAAE,KAyH1C,CAAA;AAED,eAAO,MAAM,kBAAkB,EAAE,KA0DhC,CAAA;AAED,eAAO,MAAM,UAAU,EAAE,KAoExB,CAAA;AAED,eAAO,MAAM,mBAAmB,EAAE,KA6EjC,CAAA;AAED,eAAO,MAAM,iBAAiB,EAAE,KA2E/B,CAAA"}
+{"version":3,"file":"ExpandableTable.stories.d.ts","sourceRoot":"","sources":["../../../src/components/ExpandableTable/ExpandableTable.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAQ,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAO3D,QAAA,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkC8B,CAAA;AAExC,eAAe,IAAI,CAAA;AACnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAA;AA+MlC,eAAO,MAAM,MAAM,EAAE,KAsBpB,CAAA;AAED,eAAO,MAAM,iBAAiB,EAAE,KAkB/B,CAAA;AAED,eAAO,MAAM,mBAAmB,EAAE,KAwJjC,CAAA;AAED,eAAO,MAAM,SAAS,EAAE,KAuBvB,CAAA;AAED,eAAO,MAAM,4BAA4B,EAAE,KAyH1C,CAAA;AAED,eAAO,MAAM,kBAAkB,EAAE,KA0DhC,CAAA;AAED,eAAO,MAAM,UAAU,EAAE,KAoExB,CAAA;AAED,eAAO,MAAM,mBAAmB,EAAE,KA6EjC,CAAA;AAED,eAAO,MAAM,iBAAiB,EAAE,KA2E/B,CAAA"}

package/dist/components/ExpandableTable/index.d.ts

@@ -1,2 +1,2 @@
-export { ExpandableTable, type ExpandableTableProps, type IColumn, type IExpandableTableRowCell, type IExpandableTableRowSection, } from './ExpandableTable';
+export { ExpandableTable, type ExpandableTableProps, type IColumn, type IExpandableTableRowCell, type IExpandableTableRowSection, type ResponsiveBreakpoint, } from './ExpandableTable';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/ExpandableTable/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/ExpandableTable/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,KAAK,oBAAoB,EACzB,KAAK,OAAO,EACZ,KAAK,uBAAuB,EAC5B,KAAK,0BAA0B,GAChC,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/ExpandableTable/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,KAAK,oBAAoB,EACzB,KAAK,OAAO,EACZ,KAAK,uBAAuB,EAC5B,KAAK,0BAA0B,EAC/B,KAAK,oBAAoB,GAC1B,MAAM,mBAAmB,CAAA"}

package/dist/components/FileUpload/FileItem.d.ts

@@ -1,27 +1,43 @@
 import * as React from 'react';
+/**
+ * Internal base props shared by both `file` and `url` variants of FileItem.
+ * Not exported — FileItem is an internal sub-component of FileUpload.
+ */
 interface FileItemBaseProps {
+    /** Whether the file has finished uploading. Controls which action buttons render. */
     uploaded?: boolean;
+    /** Upload progress in percent (0–100). Renders a progress bar while strictly between 0 and 100. */
     progress?: number;
+    /** Controls the item's min-height variant. */
     size?: 'sm' | 'base' | 'lg';
+    /** Prevents interaction and applies disabled styling. */
     disabled?: boolean;
+    /** Hides the delete button; download button remains available for uploaded items. */
     readOnly?: boolean;
+    /** Hint message displayed below the item with secondary styling. */
     note?: React.ReactNode;
+    /** Error message displayed below the item with error styling. */
     error?: React.ReactNode;
     /** Secondary text displayed below the file name (e.g., file size). */
     secondaryText?: React.ReactNode;
+    /** Fires when the delete button is clicked. */
     onDelete: () => void;
+    /** Fires when an internal error occurs (e.g., download failure). */
     onError?: (error: string, file?: File) => void;
 }
+/** Internal props for a FileItem backed by a local `File` object. */
 interface FileItemFileProps extends FileItemBaseProps {
     source: 'file';
     file: File;
 }
+/** Internal props for a FileItem backed by a remote URL (already-uploaded file). */
 interface FileItemUrlProps extends FileItemBaseProps {
     source: 'url';
     url: string;
     name: string;
     type?: string;
 }
+/** Discriminated union: `source: 'file'` uses a local File, `source: 'url'` references a remote URL. */
 type FileItemProps = FileItemFileProps | FileItemUrlProps;
 export declare const FileItem: (props: FileItemProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/FileUpload/FileItem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FileItem.d.ts","sourceRoot":"","sources":["../../../src/components/FileUpload/FileItem.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AA8C9B,UAAU,iBAAiB;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAA;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACvB,sEAAsE;IACtE,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC/B,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,IAAI,KAAK,IAAI,CAAA;CAC/C;AAED,UAAU,iBAAkB,SAAQ,iBAAiB;IACnD,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,IAAI,CAAA;CACX;AAED,UAAU,gBAAiB,SAAQ,iBAAiB;IAClD,MAAM,EAAE,KAAK,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,KAAK,aAAa,GAAG,iBAAiB,GAAG,gBAAgB,CAAA;AAsEzD,eAAO,MAAM,QAAQ,GAAI,OAAO,aAAa,4CAuO5C,CAAA"}
+{"version":3,"file":"FileItem.d.ts","sourceRoot":"","sources":["../../../src/components/FileUpload/FileItem.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AA8C9B;;;GAGG;AACH,UAAU,iBAAiB;IACzB,qFAAqF;IACrF,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,mGAAmG;IACnG,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAA;IAC3B,yDAAyD;IACzD,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,qFAAqF;IACrF,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,oEAAoE;IACpE,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB,iEAAiE;IACjE,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACvB,sEAAsE;IACtE,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC/B,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB,oEAAoE;IACpE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,IAAI,KAAK,IAAI,CAAA;CAC/C;AAED,qEAAqE;AACrE,UAAU,iBAAkB,SAAQ,iBAAiB;IACnD,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,IAAI,CAAA;CACX;AAED,oFAAoF;AACpF,UAAU,gBAAiB,SAAQ,iBAAiB;IAClD,MAAM,EAAE,KAAK,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,wGAAwG;AACxG,KAAK,aAAa,GAAG,iBAAiB,GAAG,gBAAgB,CAAA;AAsEzD,eAAO,MAAM,QAAQ,GAAI,OAAO,aAAa,4CAuO5C,CAAA"}

package/dist/components/FileUpload/FileUpload.d.ts

@@ -9,117 +9,180 @@ declare const fileUploadVariants: (props?: ({
 /**
  * Represents a remote file that is already uploaded and accessible via URL.
  * Used to display previously-uploaded files without re-fetching them as `File` objects.
+ *
+ * @example
+ * const urls: PreselectedUrl[] = [
+ *   { url: 'https://cdn.example.com/photo.jpg', name: 'photo.jpg', type: 'image/jpeg', secondaryText: '3.2 MB' },
+ *   { url: 'https://cdn.example.com/report.pdf', name: 'report.pdf', type: 'application/pdf' },
+ * ]
  */
 export interface PreselectedUrl {
-    /** Direct URL to the file. */
+    /** Direct URL to the file. Used for opening the file in a new tab on download. */
     url: string;
-    /** Display name for the file. */
+    /** Display name shown in the file list item. */
     name: string;
-    /** MIME type — if starts with `"image/"`, shows thumbnail. Falls back to extension sniffing from name. */
+    /**
+     * MIME type used to pick the file icon. If it starts with `"image/"` the item renders a
+     * thumbnail from `url`. When omitted, the extension in `name` is used as a fallback.
+     */
     type?: string;
-    /** File size in bytes (for display). */
+    /** File size in bytes. Currently informational; not rendered directly — use `secondaryText` for display. */
     size?: number;
-    /** Secondary text displayed below the file name (e.g., formatted file size). */
+    /** Secondary text displayed below the file name (e.g., formatted file size like `'3.2 MB'`). */
     secondaryText?: React.ReactNode;
 }
+/**
+ * Upload status for a single file in `FileUpload`, matched by index to `preselectedFiles`.
+ *
+ * @example
+ * // Second file is 75% uploaded, first and third are done
+ * const status: FileUploadStatus[] = [
+ *   { uploaded: true },
+ *   { uploaded: false, progress: 75 },
+ *   { uploaded: true },
+ * ]
+ */
+export interface FileUploadStatus {
+    /** Whether the file has finished uploading. Controls the icon (close vs download/trash). */
+    uploaded: boolean;
+    /** Upload progress in percent (0–100). Renders a progress bar under the item while strictly between 0 and 100. */
+    progress?: number;
+}
 /**
  * Props for the FileUpload component.
  * Extends standard div attributes except `onDrop`, `onError`, and `onChange`
  * (replaced by component-specific callbacks).
  */
 export interface FileUploadProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onDrop' | 'onError' | 'onChange'>, Omit<VariantProps<typeof fileUploadVariants>, 'isDragActive'> {
-    /** Fires when files are dropped or selected. Receives array of accepted files. */
+    /**
+     * Fires when files are dropped or selected (after internal validation). Receives the
+     * array of newly accepted files from the current interaction only — not the cumulative
+     * list. Use `onChange` for the full list after each change.
+     *
+     * @example
+     * <FileUpload onDrop={(files) => uploadToServer(files)} />
+     */
     onDrop?: (acceptedFiles: File[]) => void;
     /**
-     * Accepted file types as MIME type strings.
+     * Accepted file types as MIME type strings. Accepts either a single MIME type or an array.
+     * Wildcards (`image/*`, `video/*`) are supported.
      *
      * @example
-     * accept="image/*"
-     * accept={['image/*', 'application/pdf']}
+     * <FileUpload accept="image/*" />
+     * <FileUpload accept={['image/*', 'application/pdf']} />
      */
     accept?: string | string[];
-    /** Allows selecting multiple files simultaneously. @default true */
+    /** Allows selecting multiple files simultaneously. When `false`, the dropzone hides after the first file is selected. @default true */
     multiple?: boolean;
-    /** Maximum allowed file size in bytes. */
+    /**
+     * Maximum allowed file size in bytes. Files exceeding this size are rejected and trigger `onError`.
+     *
+     * @example
+     * <FileUpload maxSize={5 * 1024 * 1024} /> // 5 MB
+     */
     maxSize?: number;
     /** Custom error message when a file exceeds `maxSize`. Defaults to a translated message with the size in MB. */
     maxSizeErrorMessage?: string;
-    /** Maximum number of files allowed. When reached, the dropzone is hidden. */
+    /** Maximum number of files allowed (counts both `preselectedFiles` and `preselectedUrls`). When reached, the dropzone is hidden. */
     maxFiles?: number;
-    /** Custom error message when file count exceeds `maxFiles`. Defaults to a translated message. */
+    /** Custom error message when file count exceeds `maxFiles`. Defaults to a translated message with the count. */
     maxFilesErrorMessage?: string;
     /** Controls the visual size of file items in the list. @default 'base' */
     size?: 'sm' | 'base' | 'lg';
-    /** Prevents interaction and applies disabled styling. @default false */
+    /** Prevents interaction and applies disabled styling to the dropzone and all file items. @default false */
     disabled?: boolean;
-    /** Hides the dropzone and shows only uploaded files without delete buttons. @default false */
+    /** Hides the dropzone and shows only uploaded files without delete buttons. Download buttons remain available. @default false */
     readOnly?: boolean;
     /** Title text displayed inside the dropzone area. Defaults to a translated string. */
     title?: string;
-    /** Label displayed above the upload area. */
+    /** Label displayed above the upload area via `FormField`. */
     label?: string;
-    /** Subtitle text displayed below the title inside the dropzone. */
+    /** Subtitle text displayed below the title inside the dropzone (typically used for supported formats hint). */
     subtitle?: string;
-    /** Applies error border and text styling to the dropzone. */
+    /** Applies error border and text styling to the dropzone. Independent of per-file errors in `itemErrors`. */
     error?: boolean;
     /** Marks the field as required and displays a red asterisk next to the label. @default false */
     required?: boolean;
     /** Hides the required asterisk even when `required` is true. @default false */
     disableRequiredAsterisk?: boolean;
     /**
-     * Additional options passed to react-dropzone.
-     * Props managed by the component (`onDrop`, `accept`, `multiple`, `maxSize`, `disabled`) are excluded.
+     * Additional options passed to the underlying react-dropzone hook. Props already managed by
+     * `FileUpload` (`onDrop`, `accept`, `multiple`, `maxSize`, `maxFiles`, `disabled`) are excluded.
+     *
      * @see DropzoneOptions
      */
     dropzoneOptions?: Omit<DropzoneOptions, 'onDrop' | 'accept' | 'multiple' | 'maxSize' | 'maxFiles' | 'disabled'>;
     /** Files displayed in the list on mount. @default [] */
     preselectedFiles?: File[];
     /**
-     * Upload status for each file, matched by index to `preselectedFiles`.
-     * Each entry contains `uploaded` (boolean) and optional `progress` (0-100).
+     * Upload status for each file, matched by index to `preselectedFiles`. Omit or pass an empty
+     * array to treat all files as not-yet-uploaded.
+     *
+     * @example
+     * <FileUpload
+     *   preselectedFiles={[file1, file2]}
+     *   fileStatus={[{ uploaded: true }, { uploaded: false, progress: 42 }]}
+     * />
+     *
+     * @see FileUploadStatus
      * @default []
      */
-    fileStatus?: {
-        uploaded: boolean;
-        progress?: number;
-    }[];
+    fileStatus?: FileUploadStatus[];
     /**
-     * Per-file error messages keyed by File reference.
+     * Per-file error messages keyed by File reference. Displayed below the file item with error styling.
      *
      * @example
-     * const errors = new Map<File, string>([[file, 'Upload failed']])
-     * <FileUpload itemErrors={errors} />
+     * const itemErrors = new Map<File, React.ReactNode>([[file, 'Upload failed']])
+     * <FileUpload itemErrors={itemErrors} />
      */
     itemErrors?: Map<File, React.ReactNode>;
     /**
-     * Per-file hint messages keyed by File reference.
+     * Per-file hint messages keyed by File reference. Displayed below the file item with secondary styling.
      *
      * @example
-     * const hints = new Map<File, string>([[file, 'Will be optimized']])
-     * <FileUpload itemHints={hints} />
+     * const itemHints = new Map<File, React.ReactNode>([[file, 'Will be optimized before upload']])
+     * <FileUpload itemHints={itemHints} />
      */
     itemHints?: Map<File, React.ReactNode>;
     /**
-     * Per-file secondary text keyed by File reference (e.g., formatted file size).
+     * Per-file secondary text keyed by File reference (e.g., formatted file size). Displayed below the file name inside the item.
      *
      * @example
-     * const texts = new Map<File, React.ReactNode>([[file, '7 MB']])
-     * <FileUpload itemSecondaryTexts={texts} />
+     * const itemSecondaryTexts = new Map<File, React.ReactNode>([[file, '7 MB']])
+     * <FileUpload itemSecondaryTexts={itemSecondaryTexts} />
      */
     itemSecondaryTexts?: Map<File, React.ReactNode>;
-    /** Fires when an error occurs. Receives the error message and the optional file that caused it. */
+    /**
+     * Fires when an error occurs (file too large, too many files, processing or deletion failure).
+     * Receives the error message and the optional file that caused it.
+     *
+     * @example
+     * <FileUpload onError={(msg, file) => toast({ variant: 'error', text: msg })} />
+     */
     onError?: (error: string, file?: File) => void;
-    /** Fires when a file is deleted. Receives the deleted file and its index. */
+    /** Fires when a `File` item is removed. Receives the deleted file and its index in `preselectedFiles`. */
     onDelete?: (file: File, index: number) => void;
-    /** Fires when the file list changes. Receives the updated array of all files. */
+    /**
+     * Fires when the internal file list changes (after drop or delete). Receives the full updated array,
+     * including previously-selected files.
+     *
+     * @example
+     * <FileUpload onChange={(files) => setValue('attachments', files)} />
+     */
     onChange?: (files: File[]) => void;
-    /** Already-uploaded files to display via URL, without needing `File` objects. @default [] */
+    /**
+     * Already-uploaded files to display via URL, without needing `File` objects. Rendered before
+     * `preselectedFiles` in the list.
+     *
+     * @see PreselectedUrl
+     * @default []
+     */
     preselectedUrls?: PreselectedUrl[];
-    /** Fires when a URL-backed item is deleted. Receives the item and its index in the `preselectedUrls` array. */
+    /** Fires when a URL-backed item is removed. Receives the item and its index in `preselectedUrls`. @see PreselectedUrl */
     onDeleteUrl?: (item: PreselectedUrl, index: number) => void;
-    /** Extra content rendered inline next to the label (e.g. a tooltip icon). */
+    /** Extra content rendered inline next to the label (e.g. a tooltip icon). Takes precedence over `infoTooltip`. */
     labelExtra?: React.ReactNode;
-    /** Tooltip content shown in an info icon next to the label. Overridden by `labelExtra` if both are provided. */
+    /** Tooltip content shown in an info icon next to the label. Ignored when `labelExtra` is provided. */
     infoTooltip?: string;
 }
 declare const FileUpload: React.ForwardRefExoticComponent<FileUploadProps & React.RefAttributes<HTMLDivElement>>;

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

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

package/dist/components/FileUpload/index.d.ts

@@ -1,2 +1,2 @@
-export { FileUpload, type FileUploadProps, type PreselectedUrl, } from './FileUpload';
+export { FileUpload, type FileUploadProps, type FileUploadStatus, type PreselectedUrl, } from './FileUpload';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/FileUpload/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/FileUpload/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/FileUpload/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,cAAc,GACpB,MAAM,cAAc,CAAA"}

package/dist/components/Input/Input.d.ts

@@ -7,53 +7,54 @@ declare const inputWrapperVariants: (props?: ({
 /**
  * Props for the Input component.
  *
- * Omits native `size`, `prefix`, `suffix`, and `type` from the base input
- * element to replace them with custom typed alternatives.
+ * Extends standard input attributes except `size` (replaced by a custom size
+ * variant), `type` (narrowed to a supported union), and `prefix`/`suffix`
+ * (replaced by ReactNode slots rendered inside the wrapper).
  */
 export interface InputProps extends Omit<ComponentProps<'input'>, 'size' | 'prefix' | 'suffix' | 'type'>, VariantProps<typeof inputWrapperVariants> {
-    /** Displays label text above the input field. */
+    /** Label text rendered above the input. */
     label?: string;
     /**
-     * Sets the HTML input type controlling keyboard and validation behavior.
-     * @default "text"
+     * HTML input type controlling keyboard layout and browser validation.
+     * @default 'text'
      */
     type?: 'text' | 'email' | 'password' | 'number' | 'time';
-    /**
-     * Controls the visual size variant affecting height and typography.
-     * @default "base"
-     */
+    /** Controls height and typography. @default 'base' */
     size?: 'xs' | 'sm' | 'base' | 'lg';
-    /**
-     * Enables error state with red border and red hint text.
-     * @default false
-     */
+    /** Applies error border and hint styling. @default false */
     error?: boolean;
-    /** Renders a ReactNode before the input value (e.g., icon or text). */
+    /** Content rendered before the input value (e.g. an icon). */
     prefix?: ReactNode;
-    /** Renders a ReactNode after the input value (e.g., icon or action). */
+    /** Content rendered after the input value (e.g. an icon or action button). */
     suffix?: ReactNode;
     /**
-     * Hides the required asterisk (*) in the label even when `required` is true.
+     * Hides the required asterisk in the label even when `required` is `true`.
      * @default false
      */
     disableRequiredAsterisk?: boolean;
-    /** Displays helper or error text below the input. */
+    /** Helper or error text rendered below the input. */
     hint?: string;
-    /** Extra content rendered inline next to the label (e.g. a tooltip icon). */
+    /**
+     * Custom content rendered inline next to the label. Takes precedence over
+     * `infoTooltip` when both are provided.
+     */
     labelExtra?: ReactNode;
-    /** Tooltip content shown in an info icon next to the label. Overridden by `labelExtra` if both are provided. */
+    /**
+     * Tooltip content shown in an info icon next to the label. Ignored when
+     * `labelExtra` is provided.
+     */
     infoTooltip?: string;
     /**
-     * Input mask pattern using react-imask syntax. All alphabetic input is automatically converted to uppercase.
+     * Input mask pattern using [react-imask](https://imask.js.org/) syntax.
+     * All alphabetic input is automatically uppercased.
      *
-     * Common patterns:
-     * - `0` = digit (0-9)
-     * - `a` = letter (a-z, A-Z) - automatically converted to uppercase
-     * - `*` = alphanumeric (0-9, a-z, A-Z) - automatically converted to uppercase
-     * - Any other character = literal character in the mask
+     * Pattern tokens:
+     * - `0` — digit (0-9)
+     * - `a` — letter (auto-uppercased)
+     * - `*` — alphanumeric (auto-uppercased)
+     * - any other character — literal
      *
      * @example
-     * ```tsx
      * // Phone number: (123) 456-7890
      * <Input mask="(000) 000-0000" />
      *
@@ -62,18 +63,16 @@ export interface InputProps extends Omit<ComponentProps<'input'>, 'size' | 'pref
      *
      * // Mixed format: AB-1234-CD
      * <Input mask="aa-0000-aa" />
-     * ```
      */
     mask?: string;
     /**
-     * Stops `click` events on the wrapper from propagating to ancestors. Use this
-     * when the Input is placed inside a clickable container (e.g. a DataTable or
-     * ReorderableTable row that wires `onRowClick`) so that clicking the input's
-     * padding / prefix / suffix area does not trigger the parent's click handler.
+     * Stops `click` events on the wrapper from propagating to ancestors. Use
+     * when the Input sits inside a clickable container (e.g. a DataTable or
+     * ReorderableTable row with `onRowClick`) so clicking the input's padding,
+     * prefix, or suffix area does not trigger the parent's click handler.
      *
-     * Scope: only `click` events are stopped. `focus`, `pointerdown`/`mousedown`,
-     * and `keydown` events still bubble normally. Focus behavior on the input
-     * itself is preserved.
+     * Only `click` events are stopped — `focus`, `pointerdown`/`mousedown`,
+     * and `keydown` still bubble, and focus behavior on the input is preserved.
      * @default false
      */
     stopClickPropagation?: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"Input.d.ts","sourceRoot":"","sources":["../../../src/components/Input/Input.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,SAAS,EAKf,MAAM,OAAO,CAAA;AACd,OAAO,EAAE,KAAK,YAAY,EAAO,MAAM,0BAA0B,CAAA;AAMjE,QAAA,MAAM,oBAAoB;;;8EA0BzB,CAAA;AAgBD;;;;;GAKG;AACH,MAAM,WAAW,UACf,SAAQ,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC,EAC1E,YAAY,CAAC,OAAO,oBAAoB,CAAC;IAC3C,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAA;IACxD;;;OAGG;IACH,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAAA;IAClC;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,uEAAuE;IACvE,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB,wEAAwE;IACxE,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB;;;OAGG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAA;IACjC,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,6EAA6E;IAC7E,UAAU,CAAC,EAAE,SAAS,CAAA;IACtB,gHAAgH;IAChH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;;;;;;;;OAUG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAC/B;AAED,eAAO,MAAM,KAAK,sHAiJjB,CAAA"}
+{"version":3,"file":"Input.d.ts","sourceRoot":"","sources":["../../../src/components/Input/Input.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,SAAS,EAKf,MAAM,OAAO,CAAA;AACd,OAAO,EAAE,KAAK,YAAY,EAAO,MAAM,0BAA0B,CAAA;AAMjE,QAAA,MAAM,oBAAoB;;;8EA0BzB,CAAA;AAgBD;;;;;;GAMG;AACH,MAAM,WAAW,UACf,SAAQ,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC,EAC1E,YAAY,CAAC,OAAO,oBAAoB,CAAC;IAC3C,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAA;IACxD,sDAAsD;IACtD,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAAA;IAClC,4DAA4D;IAC5D,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,8DAA8D;IAC9D,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB;;;OAGG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAA;IACjC,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;OAGG;IACH,UAAU,CAAC,EAAE,SAAS,CAAA;IACtB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;;;;;;;OASG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAC/B;AAED,eAAO,MAAM,KAAK,sHAiJjB,CAAA"}

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

@@ -1 +1 @@
-{"version":3,"file":"Input.stories.d.ts","sourceRoot":"","sources":["../../../src/components/Input/Input.stories.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAE3D,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAE/B,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,KAAK,CAiK5B,CAAA;AAED,eAAe,IAAI,CAAA;AACnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,KAAK,CAAC,CAAA;AAGnC,eAAO,MAAM,OAAO,EAAE,KAarB,CAAA;AAED,eAAO,MAAM,wBAAwB,EAAE,KAgBtC,CAAA;AAED,eAAO,MAAM,qBAAqB,EAAE,KAgBnC,CAAA;AAED,eAAO,MAAM,cAAc,EAAE,KAgB5B,CAAA;AAED,eAAO,MAAM,aAAa,EAAE,KAgB3B,CAAA;AAED,eAAO,MAAM,aAAa,EAAE,KAyB3B,CAAA;AAED,eAAO,MAAM,yBAAyB,EAAE,KAyBvC,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAqBtB,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAsBtB,CAAA"}
+{"version":3,"file":"Input.stories.d.ts","sourceRoot":"","sources":["../../../src/components/Input/Input.stories.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAE3D,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAE/B,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,KAAK,CAgK5B,CAAA;AAED,eAAe,IAAI,CAAA;AACnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,KAAK,CAAC,CAAA;AAGnC,eAAO,MAAM,OAAO,EAAE,KAarB,CAAA;AAED,eAAO,MAAM,wBAAwB,EAAE,KAgBtC,CAAA;AAED,eAAO,MAAM,qBAAqB,EAAE,KAgBnC,CAAA;AAED,eAAO,MAAM,cAAc,EAAE,KAgB5B,CAAA;AAED,eAAO,MAAM,aAAa,EAAE,KAgB3B,CAAA;AAED,eAAO,MAAM,aAAa,EAAE,KAyB3B,CAAA;AAED,eAAO,MAAM,yBAAyB,EAAE,KAyBvC,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAqBtB,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAsBtB,CAAA"}