@rarui/components 1.8.0-rc.1 → 1.9.0

package/dist/index.d.ts

@@ -16151,18 +16151,29 @@ interface DividerSprinkle {
     size?: string | Conditions<string>;
     /**
      * The **`type`** shorthand CSS property sets the line style for all four sides of an element's.
+     * @default solid
      */
     type?: AddDollar<DividerBorderStyle> | Conditions<AddDollar<DividerBorderStyle>>;
     /**
      * The **`thickness`** shorthand CSS property sets the width of an element's.
+     * @default $1
      */
     thickness?: AddDollar<keyof typeof dividerBorderWidthProperties> | Conditions<AddDollar<keyof typeof dividerBorderWidthProperties>>;
     /**
      * The **`color`** CSS property sets an element's color.
+     * @default $divider
      */
     color?: AddDollar<keyof typeof borderColorProperties> | Conditions<AddDollar<keyof typeof borderColorProperties>>;
 }
 
+type IconDynamicProperties = Pick<StandardLonghandProperties, "cursor">;
+interface IconSprinkle extends IconDynamicProperties {
+    /**
+     * The color property sets the icon.
+     */
+    color?: AddDollar<keyof typeof colorProperties> | Conditions<AddDollar<keyof typeof colorProperties>>;
+}
+
 declare const textLineHeightProperties: {
     xxs: `var(--${string})` | `var(--${string}, ${string})` | `var(--${string}, ${number})`;
     xs: `var(--${string})` | `var(--${string}, ${string})` | `var(--${string}, ${number})`;
@@ -16337,7 +16348,7 @@ declare const badgeStyles: {
         };
         /**
          * Specifies the size of the badge, controlling its dimensions.
-         * @defaiult medium
+         * @default medium
          */
         size: {
             large: {
@@ -16365,7 +16376,7 @@ declare const badgeStyles: {
         };
         /**
          * Defines the visual variant of the badge, affecting its background style.
-         * @defaiult solid
+         * @default solid
          */
         variant: {
             solid: {};
@@ -16395,6 +16406,7 @@ declare const buttonStyles: {
         /**
          * Defines the appearance variants for the button component.
          * Each appearance variant corresponds to a specific background color, border color, and text color.
+         * @default brand
          */
         appearance: {
             brand: {
@@ -16430,7 +16442,7 @@ declare const buttonStyles: {
         };
         /**
          * Defines the size of the button component.
-         * @default "large"
+         * @default large
          */
         size: {
             large: {
@@ -16454,6 +16466,7 @@ declare const buttonStyles: {
         };
         /**
          * Defines the visual variant of the badge, affecting its background style, border and text.
+         * @default solid
          */
         variant: {
             solid: {
@@ -16546,6 +16559,112 @@ declare const checkboxStyles: {
 
 type CheckboxVariants = NonNullable<RecipeVariants<typeof checkboxStyles.checkbox>>;
 
+declare const iconButtonStyles: {
+    iconButton: RuntimeFn<{
+        /**
+         * Determines the visual style of the icon button, influencing its color scheme and appearance.
+         * @default brand
+         */
+        appearance: {
+            brand: {
+                backgroundColor: `var(--${string})` | `var(--${string}, ${string})` | `var(--${string}, ${number})`;
+                borderColor: `var(--${string})` | `var(--${string}, ${string})` | `var(--${string}, ${number})`;
+                color: `var(--${string})` | `var(--${string}, ${string})` | `var(--${string}, ${number})`;
+            };
+            danger: {
+                backgroundColor: `var(--${string})` | `var(--${string}, ${string})` | `var(--${string}, ${number})`;
+                borderColor: `var(--${string})` | `var(--${string}, ${string})` | `var(--${string}, ${number})`;
+                color: `var(--${string})` | `var(--${string}, ${string})` | `var(--${string}, ${number})`;
+            };
+            success: {
+                backgroundColor: `var(--${string})` | `var(--${string}, ${string})` | `var(--${string}, ${number})`;
+                borderColor: `var(--${string})` | `var(--${string}, ${string})` | `var(--${string}, ${number})`;
+                color: `var(--${string})` | `var(--${string}, ${string})` | `var(--${string}, ${number})`;
+            };
+            warning: {
+                backgroundColor: `var(--${string})` | `var(--${string}, ${string})` | `var(--${string}, ${number})`;
+                borderColor: `var(--${string})` | `var(--${string}, ${string})` | `var(--${string}, ${number})`;
+                color: `var(--${string})` | `var(--${string}, ${string})` | `var(--${string}, ${number})`;
+            };
+            neutral: {
+                backgroundColor: `var(--${string})` | `var(--${string}, ${string})` | `var(--${string}, ${number})`;
+                borderColor: `var(--${string})` | `var(--${string}, ${string})` | `var(--${string}, ${number})`;
+                color: `var(--${string})` | `var(--${string}, ${string})` | `var(--${string}, ${number})`;
+            };
+            inverted: {
+                backgroundColor: `var(--${string})` | `var(--${string}, ${string})` | `var(--${string}, ${number})`;
+                borderColor: `var(--${string})` | `var(--${string}, ${string})` | `var(--${string}, ${number})`;
+                color: `var(--${string})` | `var(--${string}, ${string})` | `var(--${string}, ${number})`;
+            };
+        };
+        /**
+         * Defines the size of the icon button component.
+         * @default medium
+         */
+        size: {
+            large: {
+                height: "3rem";
+                width: "3rem";
+                fontSize: `var(--${string})` | `var(--${string}, ${string})` | `var(--${string}, ${number})`;
+            };
+            medium: {
+                height: "2.5rem";
+                width: "2.5rem";
+                fontSize: `var(--${string})` | `var(--${string}, ${string})` | `var(--${string}, ${number})`;
+            };
+            small: {
+                height: "2rem";
+                width: "2rem";
+                fontSize: `var(--${string})` | `var(--${string}, ${string})` | `var(--${string}, ${number})`;
+            };
+        };
+        variant: {
+            /**
+             * Defines the visual variant of the icon button, affecting its background style, border and text.
+             * @default solid
+             */
+            solid: {
+                selectors: {
+                    "&:hover:after": {
+                        backgroundColor: `var(--${string})` | `var(--${string}, ${string})` | `var(--${string}, ${number})`;
+                    };
+                    "&:active:after": {
+                        borderColor: `var(--${string})` | `var(--${string}, ${string})` | `var(--${string}, ${number})`;
+                        backgroundColor: `var(--${string})` | `var(--${string}, ${string})` | `var(--${string}, ${number})`;
+                    };
+                };
+            };
+            outlined: {
+                backgroundColor: "transparent";
+            };
+            ghost: {
+                backgroundColor: "transparent";
+                borderColor: "transparent";
+            };
+            tonal: {
+                borderColor: "transparent";
+            };
+        };
+        /**
+         * Defines if the button should have rounded edges.
+         *
+         * - `true`: The button will be rendered with completely rounded edges, useful for circular -shaped icons.
+         * - `false` (default): The button will have standard edges or defined by the component style.
+         * @default false
+         */
+        rounded: {
+            true: {
+                borderRadius: `var(--${string})` | `var(--${string}, ${string})` | `var(--${string}, ${number})`;
+                ":after": {
+                    borderRadius: `var(--${string})` | `var(--${string}, ${string})` | `var(--${string}, ${number})`;
+                };
+            };
+        };
+    }>;
+};
+
+type IconButtonVariants = NonNullable<RecipeVariants<typeof iconButtonStyles.iconButton>>;
+
 declare const progressStyles: {
     progress: string;
     bar: string;
@@ -16694,6 +16813,7 @@ declare const styles: {
     tooltip: RuntimeFn<{
         /**
          * Specifies whether the color scheme should be inverted
+         * @default false
          */
         inverted: {
             true: {
@@ -16707,6 +16827,7 @@ declare const styles: {
         };
         /**
          * Specifies the padding for the tooltip
+         * @default base
          */
         padding: {
             base: {
@@ -16781,10 +16902,13 @@ type AvatarProps = AvatarTypings & AvatarVariants;
 interface DividerProps extends DividerSprinkle {
     /**
      * The direction of the Divider.
+     * @default horizontal
      */
     direction?: "vertical" | "horizontal";
 }
 
+type IconProps = IconSprinkle;
+
 interface TitleProps extends TitleSprinkle {
     /**
      * Type of html tag to create for the title.
@@ -16885,6 +17009,15 @@ interface CheckboxTyping {
 }
 type CheckboxProps = CheckboxTyping & CheckboxVariants;
 
+interface IconButtonTyping {
+    /**
+     * Disables the button, disallowing user interaction.
+     * @default false
+     */
+    disabled?: boolean;
+}
+type IconButtonProps = IconButtonTyping & IconButtonVariants;
+
 interface RadioButtonTyping {
     /**
      * Sets radio state to activated or deactivated.
@@ -16985,6 +17118,42 @@ declare class RaruiDivider extends LitElement {
     render(): TemplateResult<1>;
 }
 
+type IconName = "add-circle-filled" | "add-circle-outlined" | "alarm-filled" | "alarm-outlined" | "alternate-email" | "archive-all-filled" | "archive-all-outlined" | "archive-filled" | "archive-in-filled" | "archive-in-outlined" | "archive-outlined" | "arrow-alt-down" | "arrow-alt-left" | "arrow-alt-right" | "arrow-alt-up" | "arrow-circle-down-filled" | "arrow-circle-down-outlined" | "arrow-circle-up-filled" | "arrow-circle-up-outlined" | "arrow-circled-down-circle-outlined" | "arrow-circled-down-filled" | "arrow-circled-up-circle-outlined" | "arrow-direction-down-up" | "arrow-direction-left-right" | "arrow-direction-right-left" | "arrow-direction-up-down" | "arrow-directions" | "arrow-down" | "arrow-down-left" | "arrow-down-right" | "arrow-first-page" | "arrow-last-page" | "arrow-left" | "arrow-line-down" | "arrow-line-left" | "arrow-line-long-down" | "arrow-line-long-left" | "arrow-line-long-right" | "arrow-line-long-up" | "arrow-line-right" | "arrow-line-up" | "arrow-right" | "arrow-subdirectory-left" | "arrow-subdirectory-right" | "arrow-trending-down" | "arrow-trending-up" | "arrow-up" | "arrow-up-left" | "arrow-up-right" | "attachment" | "backspace" | "backspace-outlined" | "barley" | "barley-off" | "bolt-circle-filled" | "bolt-circle-outlined" | "bookmark-filled" | "bookmark-outlined" | "calendar-date-range-filled" | "calendar-date-range-outlined" | "calendar-event-filled" | "calendar-event-outlined" | "calendar-filled" | "calendar-outlined" | "camera-filled" | "camera-outlined" | "camera-shutter-filled" | "camera-shutter-outlined" | "cancel-circle-filled" | "cancel-circle-outlined" | "car-filled" | "car-outlined" | "chart-bars-filled" | "chart-bars-outlined" | "chat-bubble-filled" | "chat-bubble-outlined" | "chat-message-filled" | "chat-message-outlined" | "check" | "check-circle-filled" | "check-circle-outlined" | "check-small" | "chevron-big-down" | "chevron-big-left" | "chevron-big-right" | "chevron-big-up" | "chevron-down" | "chevron-left" | "chevron-right" | "chevron-up" | "clock-filled" | "clock-outlined" | "close" | "cloud-filled" | "cloud-outlined" | "contact-support-filled" | "contact-support-outlined" | "content-copy-filled" | "content-copy-outlined" | "content-paste-filled" | "content-paste-outlined" | "conversation-filled" | "conversation-outlined" | "copyright-filled" | "copyright-outlined" | "credit-card-filled" | "credit-card-outlined" | "danger-filled" | "danger-outlined" | "dashboard-filled" | "dashboard-outlined" | "document-filled" | "document-outlined" | "document-text-filled" | "document-text-outlined" | "download-filled" | "download-outlined" | "eco-filled" | "eco-outlined" | "edit-filled" | "edit-outlined" | "euro-symbol" | "exit-fullscreen" | "eye-filled" | "eye-off-filled" | "eye-off-outlined" | "eye-outlined" | "facebook-filled" | "facebook-outlined" | "file-copy-filled" | "file-copy-outlined" | "filter-alt-filled" | "filter-alt-outlined" | "filter-list" | "fingerprint" | "flag-filled" | "flag-outlined" | "flag-tour-filled" | "flag-tour-outlined" | "flower-filled" | "flower-outlined" | "folder-filled" | "folder-list-filled" | "folder-list-outlined" | "folder-open" | "folder-outlined" | "fruit-apple-filled" | "fruit-apple-outlined" | "fullscreen-filled" | "fullscreen-outlined" | "google" | "google-play" | "headphones-filled" | "headphones-outlined" | "heart-filled" | "heart-outlined" | "help-filled" | "help-outlined" | "history" | "home-filled" | "home-outlined" | "image-filled" | "image-outlined" | "info-circle-filled" | "info-circle-outlined" | "instagram" | "instagram-outlined" | "label-filled" | "label-important-filled" | "label-important-outlined" | "label-outlined" | "language" | "lightbulb-filled" | "lightbulb-outlined" | "link" | "linkedin-filled" | "linkedin-outlined" | "loader" | "loading" | "lock-filled" | "lock-open-filled" | "lock-open-outlined" | "lock-outlined" | "login" | "logout" | "mail-filled" | "mail-open-filled" | "mail-open-outlined" | "mail-outlined" | "menu" | "menu-large" | "microphone-filled" | "microphone-outlined" | "minus" | "money-filled" | "money-outlined" | "mood-bad" | "mood-bad-outlined" | "mood-filled" | "mood-outlined" | "more-horiz" | "more-vert" | "music-note-filled" | "music-note-outlined" | "notification-filled" | "notification-outlined" | "open-in-new" | "package" | "package-outlined" | "pause-filled" | "pause-outlined" | "pets-filled" | "pets-outlined" | "phone-call-filled" | "phone-call-outlined" | "phone-filled" | "phone-outlined" | "pin-filled" | "pin-outlined" | "play-arrow-filled" | "play-arrow-outlined" | "play-circle-filled" | "play-circle-outlined" | "plus" | "power-settings-new" | "printer-filled" | "printer-outlined" | "push-pin-filled" | "push-pin-outlined" | "receipt-filled" | "receipt-outlined" | "recycle" | "redeem" | "redo" | "refresh" | "refresh-alt" | "remove" | "remove-circle-filled" | "remove-circle-outlined" | "repeat" | "reply" | "save-alt" | "screen-outlined" | "search" | "send-filled" | "send-outlined" | "sentiment-dissatisfied-filled" | "sentiment-dissatisfied-outlined" | "sentiment-neutral-filled" | "sentiment-neutral-outlined" | "sentiment-satisfied-filled" | "sentiment-satisfied-outlined" | "sentiment-very-dissatisfied-filled" | "sentiment-very-dissatisfied-outlined" | "sentiment-very-satisfied-filled" | "sentiment-very-satisfied-outlined" | "settings-filled" | "settings-outlined" | "share-filled" | "share-outlined" | "shopping-bag-filled" | "shopping-bag-outlined" | "shopping-cart-add" | "shopping-cart-filled" | "shopping-cart-outlined" | "sprout" | "sprout-outline-outlined" | "star-filled" | "star-outlined" | "stay-primary-portrait" | "storefront" | "tag-filled" | "tag-outlined" | "textsms-filled" | "textsms-outlined" | "thumb-down-filled" | "thumb-down-outlined" | "thumb-up-filled" | "thumb-up-outlined" | "tiktok" | "toc" | "trash-filled" | "trash-outlined" | "truck-filled" | "truck-outlined" | "tune" | "twitter" | "undo" | "upload-filled" | "upload-outlined" | "user-circle-filled" | "user-circle-outlined" | "user-filled" | "user-outlined" | "user-square-filled" | "user-square-outlined" | "users-filled" | "users-outlined" | "view-grid-filled" | "view-grid-outlined" | "view-list-filled" | "view-list-outlined" | "warning-bubble-filled" | "warning-bubble-outlined" | "warning-filled" | "warning-outlined" | "whatsapp-filled" | "whatsapp-outlined" | "work-filled" | "work-outlined" | "wysiwyg-filled" | "youtube-filled" | "youtube-outlined" | "zoom-in" | "zoom-out";
+
+declare global {
+    interface HTMLElementTagNameMap {
+        "rarui-icon": RaruiIcon;
+    }
+}
+/**
+ * ## Rarui Icon
+ * ---
+ * Iconography used in the system based on Google's Material Design.
+ *
+ * See [a complete document](https://rarui.rarolabs.com.br/docs/components/exhibition/icon) for more details.
+ */
+type Sizes = "small" | "medium" | "large";
+type IconProperties = IconProps & {
+    /**
+     * Name of the icon to be rendered (must be in the @rarui/icons package).
+     */
+    name: IconName;
+    /**
+     * Icon size, can be 'small' |'medium' |'large' or a number.
+     * @default medium
+     */
+    size?: Sizes | number;
+};
+
+declare class RaruiIcon extends LitElement {
+    sprinkleAttrs: Record<string, string>;
+    name: IconProperties["name"];
+    size: Sizes | string;
+    static styles: CSSResult;
+    private getSvgWithSize;
+    render(): TemplateResult<1> | null;
+}
+
 declare global {
     interface HTMLElementTagNameMap {
         "rarui-text": RaruiText;
@@ -17050,13 +17219,13 @@ declare global {
     }
 }
 /**
- * ## Rarui Tooltip
+ * ## Rarui Tootip
  * ---
- * A Divider is a thin line used to separate or group content in lists and layouts.
+ * Tooltips are informative, specific, and action-oriented text labels that provide contextual support
  *
- * See [a complete document](https://rarui.rarolabs.com.br/docs/components/exhibition/divider) for more details.
+ * See [a complete document](https://rarui.rarolabs.com.br/docs/components/exhibition/tooltip) for more details.
  */
-type TooltipProperties = Partial<TooltipProps> & {
+type TooltipProperties = Partial<Omit<TooltipProps, "visible" | "onVisibility" | "portalId">> & {
     /**
      * Position of the popover.
      * @default bottom
@@ -17078,10 +17247,10 @@ type TooltipProperties = Partial<TooltipProps> & {
 };
 
 declare class RaruiTooltip extends LitElement {
+    arrow: TooltipProperties["arrow"];
     padding: TooltipProperties["padding"];
     offset: TooltipProperties["offset"];
     inverted: TooltipProperties["inverted"];
-    arrow: TooltipProperties["arrow"];
     enabledDismiss: TooltipProperties["enabledDismiss"];
     enabledClick: TooltipProperties["enabledClick"];
     enabledHover: TooltipProperties["enabledHover"];
@@ -17168,18 +17337,18 @@ type ButtonProperties = Partial<ButtonProps> & {
     /**
      * Defines the native button type.
      * Can be 'button', 'submit', or 'reset'.
-     * @default 'button'
+     * @default button
      */
     type?: "button" | "submit" | "reset";
 };
 
 declare class RaruiButton extends LitElement {
-    full: ButtonProperties["full"];
-    size: ButtonProperties["size"];
     type: ButtonProperties["type"];
+    size: ButtonProperties["size"];
     variant: ButtonProperties["variant"];
-    disabled: ButtonProperties["disabled"];
     appearance: ButtonProperties["appearance"];
+    disabled: ButtonProperties["disabled"];
+    full: ButtonProperties["full"];
     static styles: CSSResult;
     render(): TemplateResult<1>;
 }
@@ -17209,6 +17378,30 @@ declare class RaruiCheckbox extends LitElement {
     private _onChange;
 }
 
+declare global {
+    interface HTMLElementTagNameMap {
+        "rarui-icon-button": RaruiIconButton;
+    }
+}
+/**
+ * ## Rarui Icon Button
+ * ---
+ * Button allows the user to perform actions, such as sending a file, advancing a form, sharing a document, or making a comment.
+ *
+ * See [a complete document](https://rarui.rarolabs.com.br/docs/components/input/button) for more details.
+ */
+type IconButtonProperties = Partial<IconButtonProps>;
+
+declare class RaruiIconButton extends LitElement {
+    size: IconButtonProperties["size"];
+    variant: IconButtonProperties["variant"];
+    appearance: IconButtonProperties["appearance"];
+    disabled: IconButtonProperties["disabled"];
+    rounded: IconButtonProperties["rounded"];
+    static styles: CSSResult;
+    render(): TemplateResult<1>;
+}
+
 declare global {
     interface HTMLElementTagNameMap {
         "rarui-radio-button": RaruiRadioButton;