@vkzstudio/muza-ui 1.0.43 → 1.0.44

package/dist/components/TextEditor/TextEditor.d.ts

@@ -1,14 +1,14 @@
 import { ReactNode } from 'react';
 import { AnyExtension } from '@tiptap/core';
 import { Editor } from '@tiptap/react';
-/** History toolbar item type */
-type HistoryItem = 'undo' | 'redo';
-/** Heading level type (1-3) */
-type HeadingLevel = 1 | 2 | 3;
-/** Text formatting toolbar item type */
-type FormattingItem = 'bold' | 'italic' | 'strikethrough';
-/** List toolbar item type */
-type ListItem = 'bullet' | 'ordered';
+/** Identifier for a history toolbar item. */
+export type HistoryItem = 'undo' | 'redo';
+/** Heading level supported by the editor (H1, H2, H3). */
+export type HeadingLevel = 1 | 2 | 3;
+/** Identifier for a text formatting toolbar item. */
+export type FormattingItem = 'bold' | 'italic' | 'strikethrough';
+/** Identifier for a list toolbar item. */
+export type ListItem = 'bullet' | 'ordered';
 /**
  * Configuration for the TextEditor toolbar.
  * Each property can be:
@@ -28,17 +28,33 @@ type ListItem = 'bullet' | 'ordered';
  * }
  */
 export interface TextEditorToolbarConfig {
-    /** Show history buttons (undo/redo). Default: true */
+    /**
+     * Controls the history buttons (undo/redo). Pass an array to show only specific items.
+     * @default true
+     * @see HistoryItem
+     */
     history?: boolean | HistoryItem[];
-    /** Show heading buttons (H1/H2/H3). Default: true */
+    /**
+     * Controls the heading buttons (H1/H2/H3). Pass an array to show only specific levels.
+     * @default true
+     * @see HeadingLevel
+     */
     headings?: boolean | HeadingLevel[];
-    /** Show formatting buttons (bold/italic/strikethrough). Default: true */
+    /**
+     * Controls the formatting buttons (bold/italic/strikethrough). Pass an array to show only specific items.
+     * @default true
+     * @see FormattingItem
+     */
     formatting?: boolean | FormattingItem[];
-    /** Show list buttons (bullet/ordered). Default: true */
+    /**
+     * Controls the list buttons (bullet/ordered). Pass an array to show only specific items.
+     * @default true
+     * @see ListItem
+     */
     lists?: boolean | ListItem[];
-    /** Show link button. When false, link pasting is also disabled. Default: true */
+    /** Controls the link button. When `false`, link pasting is also disabled. @default true */
     link?: boolean;
-    /** Show clear formatting button. Default: true */
+    /** Controls the clear-formatting button. @default true */
     clearFormatting?: boolean;
 }
 /**
@@ -54,90 +70,110 @@ export interface TextEditorToolbarConfig {
  * const html = editorRef.current?.getHTML()
  */
 export interface TextEditorRef {
-    /** The underlying TipTap editor instance */
+    /** The underlying TipTap editor instance. */
     editor: Editor | null;
-    /** Focuses the editor */
+    /** Focuses the editor. */
     focus: () => void;
-    /** Removes focus from the editor */
+    /** Removes focus from the editor. */
     blur: () => void;
-    /** Returns the current content as HTML */
+    /** Returns the current content as HTML. */
     getHTML: () => string;
-    /** Returns the current content as plain text */
+    /** Returns the current content as plain text. */
     getText: () => string;
-    /** Returns true if the editor has no content */
+    /** Returns `true` if the editor has no content. */
     isEmpty: () => boolean;
-    /** Sets the editor content from HTML string */
+    /** Replaces the editor content with the given HTML string. */
     setContent: (html: string) => void;
 }
 /**
  * Props for the TextEditor component.
  */
 export interface TextEditorProps {
-    /** Controlled value (HTML string). Use with onChange for controlled mode. */
+    /** Controlled value as an HTML string. Pair with `onChange` for controlled usage. */
     value?: string;
-    /** Initial value for uncontrolled mode */
+    /** Initial HTML value for uncontrolled usage. */
     defaultValue?: string;
     /**
-     * Fires when content changes. Receives empty string when editor is empty,
-     * otherwise HTML content.
+     * Fires when the content changes. Receives an empty string when the editor is
+     * empty (no visible text), otherwise the current HTML.
+     *
+     * @example
+     * <TextEditor onChange={(html) => setValue(html)} />
      */
     onChange?: (html: string) => void;
-    /** Fires when the editor loses focus */
+    /** Fires when the editor loses focus. */
     onBlur?: () => void;
-    /** Fires when the editor gains focus */
+    /** Fires when the editor gains focus. */
     onFocus?: () => void;
-    /** Placeholder text shown when editor is empty */
+    /** Placeholder text shown when the editor is empty. */
     placeholder?: string;
-    /** Label displayed above the editor */
+    /** Label displayed above the editor. */
     label?: string;
-    /** Helper text displayed below the editor */
+    /** Helper text displayed below the editor. Replaced by the error message when `error` is a string. */
     hint?: string;
-    /** Tooltip content shown next to the label */
+    /** Tooltip content shown next to the label. */
     infoTooltip?: string;
-    /** Disables editing and applies disabled styling */
+    /** Prevents editing and applies disabled styling. @default false */
     disabled?: boolean;
-    /** Allows viewing but not editing content */
+    /** Allows viewing but not editing the content. @default false */
     readOnly?: 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;
-    /** Error state. String shows as error message, boolean only shows error styling. */
+    /**
+     * Error state. A string is shown as the error message below the editor;
+     * a boolean only applies the error border styling.
+     *
+     * @example
+     * <TextEditor error="Title is required" />
+     * <TextEditor error={!!formErrors.title} />
+     */
     error?: string | boolean;
     /**
-     * Toolbar configuration. See TextEditorToolbarConfig for options.
+     * Toolbar configuration. Controls which toolbar groups are visible.
      * @see TextEditorToolbarConfig
      */
     toolbar?: TextEditorToolbarConfig;
-    /** Additional content rendered at the end of the toolbar */
+    /** Additional content rendered at the end of the toolbar. */
     toolbarExtra?: ReactNode;
     /**
      * Additional TipTap extensions to add to the editor.
+     *
      * @example
      * import Mention from '@tiptap/extension-mention'
      * <TextEditor extensions={[Mention.configure({ ... })]} />
      */
     extensions?: AnyExtension[];
     /**
-     * Minimum height of the content area in pixels. Clamped to a minimum of 220px
-     * to ensure the link bubble menu has enough space. Default: 220
+     * Minimum height of the content area in pixels. Clamped to a minimum of 200px
+     * to ensure the link bubble menu has enough space.
+     * @default 200
      */
     minHeight?: number;
-    /** Maximum height of the content area (enables scrolling) */
+    /** Maximum height of the content area. Enables scrolling when content exceeds it. */
     maxHeight?: number | string;
-    /** Enables vertical resizing. Default: true */
+    /** Enables vertical resizing via the content area handle. @default true */
     resizable?: boolean;
-    /** Additional class name for the root element */
+    /** Additional class name for the root element. */
     className?: string;
-    /** Additional class name for the content area */
+    /** Additional class name for the scrollable content area. */
     contentClassName?: string;
-    /** Disables built-in content formatting styles (headings, paragraphs, lists, links). Default: false */
+    /** Disables built-in content formatting styles (headings, paragraphs, lists, links). @default false */
     unstyled?: boolean;
-    /** Additional class name for the TipTap editor element */
+    /** Additional class name for the inner TipTap editor element. */
     editorClassName?: string;
-    /** Maximum character count. Blocks input past this limit and enables the counter when `showCharacterCount` is true. */
+    /**
+     * Maximum character count. Blocks input past this limit and enables the counter
+     * when `showCharacterCount` is true. Counts plain-text characters only — formatting
+     * markup is excluded.
+     */
     maxLength?: number;
-    /** Displays a character counter (currentCount/maxLength) in the label row. Requires `maxLength` to be set. @default false */
+    /**
+     * Displays a character counter (`currentCount/maxLength`) in the label row.
+     * Requires `maxLength` to be set.
+     * @default false
+     */
     showCharacterCount?: boolean;
 }
 declare const TextEditor: import('react').ForwardRefExoticComponent<TextEditorProps & import('react').RefAttributes<TextEditorRef>>;

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

@@ -1 +1 @@
-{"version":3,"file":"TextEditor.d.ts","sourceRoot":"","sources":["../../../src/components/TextEditor/TextEditor.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,SAAS,EAMf,MAAM,OAAO,CAAA;AACd,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAIhD,OAAO,EAAE,KAAK,MAAM,EAA4B,MAAM,eAAe,CAAA;AAWrE,gCAAgC;AAChC,KAAK,WAAW,GAAG,MAAM,GAAG,MAAM,CAAA;AAElC,+BAA+B;AAC/B,KAAK,YAAY,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AAE7B,wCAAwC;AACxC,KAAK,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,eAAe,CAAA;AAEzD,6BAA6B;AAC7B,KAAK,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAA;AAEpC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,uBAAuB;IACtC,sDAAsD;IACtD,OAAO,CAAC,EAAE,OAAO,GAAG,WAAW,EAAE,CAAA;IACjC,qDAAqD;IACrD,QAAQ,CAAC,EAAE,OAAO,GAAG,YAAY,EAAE,CAAA;IACnC,yEAAyE;IACzE,UAAU,CAAC,EAAE,OAAO,GAAG,cAAc,EAAE,CAAA;IACvC,wDAAwD;IACxD,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,EAAE,CAAA;IAC5B,iFAAiF;IACjF,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,kDAAkD;IAClD,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,yBAAyB;IACzB,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,oCAAoC;IACpC,IAAI,EAAE,MAAM,IAAI,CAAA;IAChB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,MAAM,CAAA;IACrB,gDAAgD;IAChD,OAAO,EAAE,MAAM,MAAM,CAAA;IACrB,gDAAgD;IAChD,OAAO,EAAE,MAAM,OAAO,CAAA;IACtB,+CAA+C;IAC/C,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;IACnB,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,gGAAgG;IAChG,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,+EAA+E;IAC/E,uBAAuB,CAAC,EAAE,OAAO,CAAA;IACjC,oFAAoF;IACpF,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACxB;;;OAGG;IACH,OAAO,CAAC,EAAE,uBAAuB,CAAA;IACjC,4DAA4D;IAC5D,YAAY,CAAC,EAAE,SAAS,CAAA;IACxB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,YAAY,EAAE,CAAA;IAC3B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC3B,+CAA+C;IAC/C,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,uGAAuG;IACvG,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,0DAA0D;IAC1D,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,uHAAuH;IACvH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,6HAA6H;IAC7H,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAC7B;AAwBD,QAAA,MAAM,UAAU,2GA6Qf,CAAA;AAID,OAAO,EAAE,UAAU,EAAE,CAAA"}
+{"version":3,"file":"TextEditor.d.ts","sourceRoot":"","sources":["../../../src/components/TextEditor/TextEditor.tsx"],"names":[],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"TextEditor.stories.d.ts","sourceRoot":"","sources":["../../../src/components/TextEditor/TextEditor.stories.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAO3D,OAAO,EACL,UAAU,EAIX,MAAM,SAAS,CAAA;AAEhB,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,UAAU,CAgIjC,CAAA;AAED,eAAe,IAAI,CAAA;AACnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,UAAU,CAAC,CAAA;AAGxC,eAAO,MAAM,OAAO,EAAE,KAerB,CAAA;AAED,eAAO,MAAM,oBAAoB,EAAE,KAgBlC,CAAA;AAGD,eAAO,MAAM,UAAU,EAAE,KA4BxB,CAAA;AAGD,eAAO,MAAM,mBAAmB,EAAE,KAmCjC,CAAA;AAGD,eAAO,MAAM,SAAS,EAAE,KA6DvB,CAAA;AAGD,eAAO,MAAM,kBAAkB,EAAE,KAsBhC,CAAA;AAGD,eAAO,MAAM,cAAc,EAAE,KAsB5B,CAAA;AAGD,eAAO,MAAM,gBAAgB,EAAE,KAsC9B,CAAA;AAGD,eAAO,MAAM,YAAY,EAAE,KAmC1B,CAAA;AAGD,eAAO,MAAM,mBAAmB,EAAE,KAsCjC,CAAA;AAqKD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,YAAY,EAAE,KAwD1B,CAAA;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,mBAAmB,EAAE,KA0DjC,CAAA;AAGD,eAAO,MAAM,QAAQ,EAAE,KA6CtB,CAAA;AAGD,eAAO,MAAM,mBAAmB,EAAE,KA0CjC,CAAA"}
+{"version":3,"file":"TextEditor.stories.d.ts","sourceRoot":"","sources":["../../../src/components/TextEditor/TextEditor.stories.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAO3D,OAAO,EACL,UAAU,EAIX,MAAM,SAAS,CAAA;AAEhB,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,UAAU,CA0JjC,CAAA;AAED,eAAe,IAAI,CAAA;AACnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,UAAU,CAAC,CAAA;AAGxC,eAAO,MAAM,OAAO,EAAE,KAerB,CAAA;AAED,eAAO,MAAM,oBAAoB,EAAE,KAgBlC,CAAA;AAGD,eAAO,MAAM,UAAU,EAAE,KA4BxB,CAAA;AAGD,eAAO,MAAM,mBAAmB,EAAE,KAmCjC,CAAA;AAGD,eAAO,MAAM,SAAS,EAAE,KA6DvB,CAAA;AAGD,eAAO,MAAM,kBAAkB,EAAE,KAsBhC,CAAA;AAGD,eAAO,MAAM,cAAc,EAAE,KAsB5B,CAAA;AAGD,eAAO,MAAM,gBAAgB,EAAE,KAsC9B,CAAA;AAGD,eAAO,MAAM,YAAY,EAAE,KAmC1B,CAAA;AAGD,eAAO,MAAM,mBAAmB,EAAE,KAsCjC,CAAA;AAqKD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,YAAY,EAAE,KAwD1B,CAAA;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,mBAAmB,EAAE,KA0DjC,CAAA;AAGD,eAAO,MAAM,QAAQ,EAAE,KA6CtB,CAAA;AAGD,eAAO,MAAM,mBAAmB,EAAE,KA0CjC,CAAA"}

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

@@ -1,4 +1,4 @@
-export { TextEditor, type TextEditorProps, type TextEditorRef, type TextEditorToolbarConfig, } from './TextEditor';
+export { TextEditor, type FormattingItem, type HeadingLevel, type HistoryItem, type ListItem, type TextEditorProps, type TextEditorRef, type TextEditorToolbarConfig, } from './TextEditor';
 export { ToolbarButton, toolbarButtonVariants, type ToolbarButtonProps, } from './ToolbarButton';
 export { ToolbarSeparator, type ToolbarSeparatorProps, } from './ToolbarSeparator';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/TextEditor/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,uBAAuB,GAC7B,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,KAAK,kBAAkB,GACxB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,gBAAgB,EAChB,KAAK,qBAAqB,GAC3B,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/TextEditor/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,uBAAuB,GAC7B,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,KAAK,kBAAkB,GACxB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,gBAAgB,EAChB,KAAK,qBAAqB,GAC3B,MAAM,oBAAoB,CAAA"}

package/dist/components/Textarea/Textarea.d.ts

@@ -1,29 +1,60 @@
 import { ComponentProps, ReactNode } from 'react';
-/** Props for the Textarea component. */
-export interface TextareaProps extends ComponentProps<'textarea'> {
-    /** Controls manual resize behavior via drag handle. @default 'none' */
+/**
+ * Props for the Textarea component.
+ *
+ * Extends native `<textarea>` attributes except `resize`, which is replaced
+ * by a typed union controlling the CSS resize behavior via a custom prop.
+ */
+export interface TextareaProps extends Omit<ComponentProps<'textarea'>, 'resize'> {
+    /**
+     * Controls manual resize behavior via the drag handle.
+     * - `'none'` disables resizing
+     * - `'vertical'` allows vertical drag only
+     * - `'horizontal'` allows horizontal drag only
+     * - `'both'` allows both axes
+     *
+     * Should not be combined with `autoResize`.
+     *
+     * @default 'none'
+     * @example
+     * <Textarea resize="vertical" />
+     */
     resize?: 'none' | 'vertical' | 'horizontal' | 'both';
     /** Label text displayed above the textarea. */
     label?: string;
-    /** Helper text displayed below the textarea. Replaced by errorMessage when error is true. */
+    /** Helper text displayed below the textarea. Replaced by `errorMessage` when `error` is true. */
     hint?: string;
-    /** Applies error border styling. @default false */
+    /** Applies error border styling and surfaces `errorMessage` in place of `hint`. @default false */
     error?: boolean;
-    /** Error message displayed below textarea when error is true. Overrides hint text. */
+    /** Error message displayed below the textarea when `error` is true. Overrides `hint`. */
     errorMessage?: string;
     /** 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;
-    /** Name attribute for form submission. */
+    /** Name attribute used when submitting the textarea as part of an HTML form. */
     name?: string;
-    /** Automatically grows textarea height to fit content. @default false */
+    /**
+     * Automatically grows the textarea height to fit its content on every input event.
+     * When enabled, internal overflow is hidden; prefer not to combine with `resize`.
+     *
+     * @default false
+     * @example
+     * <Textarea autoResize rows={2} placeholder="Grows as you type" />
+     */
     autoResize?: boolean;
-    /** 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?: ReactNode;
     /** Tooltip content shown in an info icon next to the label. Overridden by `labelExtra` if both are provided. */
     infoTooltip?: string;
-    /** Displays a character counter (currentCount/maxLength) in the label row. Requires `maxLength` to be set. @default false */
+    /**
+     * Displays a live character counter (`currentCount/maxLength`) in the label row.
+     * Requires `maxLength` to be set; the counter is omitted otherwise.
+     *
+     * @default false
+     * @example
+     * <Textarea showCharacterCount maxLength={200} label="Bio" />
+     */
     showCharacterCount?: boolean;
 }
 export declare const Textarea: import('react').ForwardRefExoticComponent<Omit<TextareaProps, "ref"> & import('react').RefAttributes<HTMLTextAreaElement>>;

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

@@ -1 +1 @@
-{"version":3,"file":"Textarea.d.ts","sourceRoot":"","sources":["../../../src/components/Textarea/Textarea.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,SAAS,EAKf,MAAM,OAAO,CAAA;AA+Dd,wCAAwC;AACxC,MAAM,WAAW,aAAc,SAAQ,cAAc,CAAC,UAAU,CAAC;IAC/D,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,YAAY,GAAG,MAAM,CAAA;IACpD,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,6FAA6F;IAC7F,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,mDAAmD;IACnD,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,sFAAsF;IACtF,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,gGAAgG;IAChG,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,+EAA+E;IAC/E,uBAAuB,CAAC,EAAE,OAAO,CAAA;IACjC,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,yEAAyE;IACzE,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,SAAS,CAAA;IACtB,gHAAgH;IAChH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,6HAA6H;IAC7H,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAC7B;AAED,eAAO,MAAM,QAAQ,4HA0GpB,CAAA"}
+{"version":3,"file":"Textarea.d.ts","sourceRoot":"","sources":["../../../src/components/Textarea/Textarea.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,SAAS,EAKf,MAAM,OAAO,CAAA;AA+Dd;;;;;GAKG;AACH,MAAM,WAAW,aACf,SAAQ,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC;IAClD;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,YAAY,GAAG,MAAM,CAAA;IACpD,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iGAAiG;IACjG,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,kGAAkG;IAClG,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,yFAAyF;IACzF,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,gGAAgG;IAChG,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,+EAA+E;IAC/E,uBAAuB,CAAC,EAAE,OAAO,CAAA;IACjC,gFAAgF;IAChF,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,kHAAkH;IAClH,UAAU,CAAC,EAAE,SAAS,CAAA;IACtB,gHAAgH;IAChH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;;;;OAOG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAC7B;AAED,eAAO,MAAM,QAAQ,4HA0GpB,CAAA"}

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

@@ -1 +1 @@
-{"version":3,"file":"Textarea.stories.d.ts","sourceRoot":"","sources":["../../../src/components/Textarea/Textarea.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAErC,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,QAAQ,CAyG/B,CAAA;AAED,eAAe,IAAI,CAAA;AACnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,QAAQ,CAAC,CAAA;AAEtC,eAAO,MAAM,OAAO,EAAE,KAcrB,CAAA;AAED,eAAO,MAAM,gBAAgB,EAAE,KAgB9B,CAAA;AAED,eAAO,MAAM,MAAM,EAAE,KAgBpB,CAAA;AAED,eAAO,MAAM,KAAK,EAAE,KAiBnB,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAgBtB,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAgBtB,CAAA;AAED,eAAO,MAAM,UAAU,EAAE,KAiBxB,CAAA;AAED,eAAO,MAAM,oBAAoB,EAAE,KAiBlC,CAAA;AAED,eAAO,MAAM,gBAAgB,EAAE,KAiB9B,CAAA"}
+{"version":3,"file":"Textarea.stories.d.ts","sourceRoot":"","sources":["../../../src/components/Textarea/Textarea.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAErC,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,QAAQ,CAgG/B,CAAA;AAED,eAAe,IAAI,CAAA;AACnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,QAAQ,CAAC,CAAA;AAEtC,eAAO,MAAM,OAAO,EAAE,KAcrB,CAAA;AAED,eAAO,MAAM,gBAAgB,EAAE,KAgB9B,CAAA;AAED,eAAO,MAAM,MAAM,EAAE,KAgBpB,CAAA;AAED,eAAO,MAAM,KAAK,EAAE,KAiBnB,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAgBtB,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAgBtB,CAAA;AAED,eAAO,MAAM,UAAU,EAAE,KAiBxB,CAAA;AAED,eAAO,MAAM,oBAAoB,EAAE,KAiBlC,CAAA;AAED,eAAO,MAAM,gBAAgB,EAAE,KAiB9B,CAAA"}