@rarui/components 1.18.0 → 1.20.0

package/dist/index.d.ts

@@ -17466,6 +17466,23 @@ declare const styles: {
 
 type TooltipVariants = NonNullable<RecipeVariants<typeof styles.tooltip>>;
 
+declare const breadcrumbStyles: {
+    breadcrumb: string;
+    item: RuntimeFn<{
+        /**
+         * Indicates whether the breadcrumb item is currently active.
+         * An active item is typically styled differently to show that it represents the current page.
+         */
+        active: {
+            true: {
+                color: `var(--${string})` | `var(--${string}, ${string})`;
+            };
+        };
+    }>;
+};
+
+type BreadcrumbVariants = NonNullable<RecipeVariants<typeof breadcrumbStyles.item>>;
+
 declare const cardStyles: {
     card: RuntimeFn<{
         /**
@@ -17576,6 +17593,81 @@ declare const paginationStyles: {
 
 type PaginationVariants = Omit<NonNullable<RecipeVariants<typeof paginationStyles.item>>, "selected">;
 
+declare const sideNavigationStyles: {
+    sideNavigation: RuntimeFn<{
+        active: {
+            true: {
+                color: `var(--${string})` | `var(--${string}, ${string})`;
+                ":after": {
+                    content: "";
+                    position: "absolute";
+                    left: number;
+                    right: number;
+                    top: number;
+                    bottom: number;
+                    backgroundColor: `var(--${string})` | `var(--${string}, ${string})`;
+                };
+                ":hover": {
+                    backgroundColor: `var(--${string})` | `var(--${string}, ${string})`;
+                };
+                ":active": {
+                    backgroundColor: `var(--${string})` | `var(--${string}, ${string})`;
+                };
+                ":disabled": {
+                    backgroundColor: `var(--${string})` | `var(--${string}, ${string})`;
+                    cursor: "not-allowed";
+                };
+            };
+        };
+    }>;
+    item: RuntimeFn<{
+        /**
+         * Determines the level of nesting for the item.
+         */
+        level: {
+            0: {
+                paddingLeft: `var(--${string})` | `var(--${string}, ${string})`;
+            };
+            1: {
+                paddingLeft: `var(--${string})` | `var(--${string}, ${string})`;
+            };
+            2: {
+                paddingLeft: `var(--${string})` | `var(--${string}, ${string})`;
+            };
+        };
+    }>;
+    name: RuntimeFn<{
+        active: {
+            true: {
+                color: `var(--${string})` | `var(--${string}, ${string})`;
+            };
+        };
+        disabled: {
+            true: {
+                color: `var(--${string})` | `var(--${string}, ${string})`;
+            };
+        };
+    }>;
+    description: RuntimeFn<{
+        disabled: {
+            true: {
+                color: `var(--${string})` | `var(--${string}, ${string})`;
+            };
+        };
+    }>;
+    content: RuntimeFn<{
+        open: {
+            true: {
+                overflow: "visible";
+                maxHeight: "unset";
+                marginTop: `var(--${string})` | `var(--${string}, ${string})`;
+            };
+        };
+    }>;
+};
+
+type SideNavigationVariants = NonNullable<RecipeVariants<typeof sideNavigationStyles.sideNavigation> & RecipeVariants<typeof sideNavigationStyles.item>>;
+
 declare const stepperStyles: {
     stepper: RuntimeFn<{
         /**
@@ -17984,6 +18076,14 @@ interface ModalHeaderTypings {
 }
 type ModalHeaderProps = ModalHeaderTypings;
 
+interface BreadcrumbItemTyping {
+    /**
+     * The name of the breadcrumb item. This is typically the text that is displayed for the item.
+     */
+    name?: string;
+}
+type BreadcrumbItemProps = BreadcrumbItemTyping & BreadcrumbVariants;
+
 type LinkProps = LinkVariants;
 
 interface PaginationTyping {
@@ -18013,6 +18113,26 @@ interface PaginationTyping {
 }
 type PaginationProps = PaginationTyping & PaginationVariants;
 
+interface SideNavigationTyping {
+    /**
+     * Title of the sideNavigation
+     */
+    name: string;
+    /**
+     * Description of the sideNavigation.
+     */
+    description?: string;
+}
+type SideNavigationProps = SideNavigationTyping & SideNavigationVariants;
+
+interface SideNavigationItemTypings {
+    /**
+     * Determines if the item is active or not.
+     */
+    active?: boolean;
+}
+type SideNavigationItemProps = SideNavigationItemTypings & Pick<SideNavigationVariants, "level">;
+
 declare global {
     interface HTMLElementTagNameMap {
         "rarui-avatar": RaruiAvatar;
@@ -18729,6 +18849,86 @@ declare class RaruiToggle extends LitElement {
     render(): TemplateResult<1>;
 }
 
+declare global {
+    interface HTMLElementTagNameMap {
+        "rarui-breadcrumb": RaruiBreadcrumb;
+    }
+}
+/**
+ * ## Rarui Breadcrumb
+ * ---
+ * Componente de navegação hierárquica que permite aos usuários navegar através de uma estrutura de páginas.
+ *
+ * See [a complete document](https://rarui.rarolabs.com.br/docs/components-web-components/navigation/breadcrumb) for more details.
+ */
+interface BreadcrumbProperties {
+    /**
+     * Especifica o número de itens do breadcrumb a serem exibidos após o truncamento.
+     * Útil para gerenciar a exibição de listas longas de breadcrumb.
+     * @default 10
+     */
+    'items-after-truncate'?: number;
+}
+
+declare class RaruiBreadcrumb extends LitElement {
+    itemsAfterTruncate: BreadcrumbProperties["items-after-truncate"];
+    private items;
+    private visibleItems;
+    private hiddenItems;
+    private firstItem?;
+    static styles: CSSResult;
+    connectedCallback(): void;
+    private updateItems;
+    private getTextContent;
+    private getSlotContent;
+    private calculateVisibilityDistribution;
+    private renderSeparator;
+    private renderFirstItem;
+    private renderDropdownItems;
+    private renderVisibleItems;
+    render(): TemplateResult<1>;
+}
+
+declare global {
+    interface HTMLElementTagNameMap {
+        "rarui-breadcrumb-item": RaruiBreadcrumbItem;
+    }
+}
+/**
+ * ## Rarui BreadcrumbItem
+ * ---
+ * Item individual do breadcrumb que pode ser renderizado como link ou botão.
+ *
+ * See [a complete document](https://rarui.rarolabs.com.br/docs/components-web-components/navigation/breadcrumb-item) for more details.
+ */
+type BreadcrumbItemProperties = BreadcrumbItemProps & {
+    /**
+     * Nome do item do breadcrumb exibido como texto.
+     */
+    name?: string;
+    /**
+     * URL de destino quando o item for um link.
+     */
+    href?: string;
+    /**
+     * Tipo de elemento a ser renderizado.
+     * @default "button"
+     */
+    as?: "button" | "a";
+};
+
+declare class RaruiBreadcrumbItem extends LitElement {
+    name?: BreadcrumbItemProperties["name"];
+    href?: BreadcrumbItemProperties["href"];
+    active?: BreadcrumbItemProperties["active"];
+    as?: BreadcrumbItemProperties["as"];
+    static styles: CSSResult;
+    private handleClick;
+    render(): TemplateResult<1>;
+    private renderContent;
+    private hasSlotContent;
+}
+
 declare global {
     interface HTMLElementTagNameMap {
         "rarui-link": RaruiLink;
@@ -18806,6 +19006,88 @@ declare class RaruiPagination extends LitElement {
     render(): TemplateResult<1>;
 }
 
+declare global {
+    interface HTMLElementTagNameMap {
+        "rarui-side-navigation": RaruiSideNavigation;
+    }
+}
+/**
+ * ## Rarui SideNavigation
+ * ---
+ * A navigation component that supports collapsible content with nested items.
+ *
+ * ### Slots
+ * - **Default slot**: Content for nested navigation items
+ * - **leading-start**: Content to display at the start (e.g., icons)
+ * - **leading-end**: Content to display at the end (e.g., custom icons)
+ *
+ * See [a complete document](https://rarui.rarolabs.com.br/docs/components-web-components/navigation/side-navigation) for more details.
+ */
+type SideNavigationProperties = Partial<SideNavigationProps> & {
+    /**
+     * Whether the navigation item is disabled.
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Whether the navigation item is in active state.
+     * @default false
+     */
+    active?: boolean;
+    /**
+     * The HTML element type to render.
+     * @default "button"
+     */
+    as?: "button" | "a";
+};
+
+declare class RaruiSideNavigation extends LitElement {
+    name: SideNavigationProperties["name"];
+    description: SideNavigationProperties["description"];
+    active: SideNavigationProperties["active"];
+    disabled: SideNavigationProperties["disabled"];
+    as: SideNavigationProperties["as"];
+    private _open;
+    private _buttonRef;
+    static styles: CSSResult;
+    connectedCallback(): void;
+    private _handleToggle;
+    private _hasChildItems;
+    private _renderLeadingEnd;
+    private _renderContent;
+    render(): TemplateResult<1>;
+}
+
+declare global {
+    interface HTMLElementTagNameMap {
+        "rarui-side-navigation-item": RaruiSideNavigationItem;
+    }
+}
+/**
+ * ## Rarui SideNavigationItem
+ * ---
+ * A navigation item component for use within SideNavigation.
+ *
+ * See [a complete document](https://rarui.rarolabs.com.br/docs/components-web-components/navigation/side-navigation) for more details.
+ */
+type SideNavigationItemProperties = Partial<SideNavigationItemProps> & {
+    /**
+     * The HTML element type to render.
+     * @default "button"
+     */
+    as?: "button" | "a";
+};
+
+declare class RaruiSideNavigationItem extends LitElement {
+    active: SideNavigationItemProperties["active"];
+    level: SideNavigationItemProperties["level"];
+    as: SideNavigationItemProperties["as"];
+    private _itemRef;
+    static styles: CSSResult;
+    private _handleClick;
+    render(): TemplateResult<1>;
+}
+
 declare global {
     interface HTMLElementTagNameMap {
         "rarui-banner": RaruiBanner;