@rarui/components 1.24.1 → 1.24.2-rc.2

package/src/layout/Box/CHANGELOG.md

@@ -0,0 +1,50 @@
+# Changelog
+
+A low-level utility component that accepts styled system props to enable custom theme-aware styling
+
+## 2025-09-04 `2.7.0`
+
+#### 🎉 New features
+
+- Added comprehensive accessibility support with ARIA attributes (aria-label, aria-labelledby, aria-describedby) for screen reader compatibility. ([#134](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/134) by [@junior](https://git.rarolabs.com.br/junior))
+
+## 2025-08-29 `2.6.0`
+
+#### 🎉 New features
+
+- Added support for `as` property to enable polymorphic element rendering. ([#130](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/130) by [@junior](https://git.rarolabs.com.br/junior))
+
+## 2025-08-27 `2.5.0`
+
+#### 🎉 New features
+
+- Adding `verticalAlign` and `whiteSpace` property to the component.
+
+## 2025-05-27 `1.2.0`
+
+#### 🎉 New features
+
+- Added the `custom-elements.json` file to the package for automatic documentation tools and web component support editors. ([#110](https://git.rarolabs.com.br/frontend/rarui/pull/110) by [@junior](https://git.rarolabs.com.br/junior))
+
+## 2025-05-23 `1.1.0`
+
+#### 🎉 New features
+
+- Adjusted the creation of components for `lit` use to `stencil` Inves. ([#109](https://git.rarolabs.com.br/frontend/rarui/pull/109) by [@junior](https://git.rarolabs.com.br/junior))
+
+## 2024-08-06 `1.0.0`
+
+#### 🎉 New features
+
+- Added properties `css` to the Component. ([#87](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/87) by [@junior](https://git.rarolabs.com.br/junior))
+- Added stories on Component. ([#87](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/87) by [@junior](https://git.rarolabs.com.br/junior))
+
+<!-- #### 🛠 Breaking changes -->
+
+<!-- #### 📚 3rd party library updates -->
+
+<!-- #### 🎉 New features -->
+
+<!-- #### 🐛 Bug fixes -->
+
+<!-- #### 💡 Others -->

package/src/layout/Box/README.md

@@ -0,0 +1,15 @@
+# `@rarui/box`
+
+A low-level utility component that accepts styled system props to enable custom theme-aware styling
+
+## Installation
+
+```sh
+$ yarn add @rarui/box
+# or
+$ npm install @rarui/box
+```
+
+## Usage
+
+View docs [here]().

package/src/layout/Sidebar/CHANGELOG.md

@@ -0,0 +1,28 @@
+# Changelog
+
+A sidebar component that slides in from the left or right side of the screen, with floating-ui positioning for responsive behavior.
+
+## 2025-09-04 `0.1.0`
+
+#### 🎉 New features
+
+- Enhanced accessibility support with additional ARIA attributes (aria-label, aria-labelledby, aria-describedby) for improved screen reader compatibility. ([#134](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/134) by [@junior](https://git.rarolabs.com.br/junior))
+
+## 2025-09-01 `0.0.0`
+
+#### 🎉 New features
+
+- Added web component implementation of Sidebar with floating-ui integration. ([#132](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/132) by [@junior](https://git.rarolabs.com.br/junior))
+- Added intelligent positioning system using floating-ui for responsive behavior. ([#132](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/132) by [@junior](https://git.rarolabs.com.br/junior))
+- Added automatic viewport adaptation and overflow prevention. ([#132](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/132) by [@junior](https://git.rarolabs.com.br/junior))
+- Added comprehensive accessibility features with focus management. ([#132](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/132) by [@junior](https://git.rarolabs.com.br/junior))
+- Added portal system for flexible rendering locations. ([#132](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/132) by [@junior](https://git.rarolabs.com.br/junior))
+- Added custom events for state change tracking. ([#132](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/132) by [@junior](https://git.rarolabs.com.br/junior))
+
+<!-- #### 🛠 Breaking changes -->
+
+<!-- #### 📚 3rd party library updates -->
+
+<!-- #### 🐛 Bug fixes -->
+
+<!-- #### 💡 Others -->

package/src/layout/Sidebar/README.md

@@ -0,0 +1,109 @@
+# Rarui Sidebar
+
+A sidebar component that slides in from the left or right side of the screen, with intelligent positioning for responsive behavior.
+
+## Installation
+
+```bash
+npm install @rarui/sidebar
+# or
+yarn add @rarui/sidebar
+```
+
+## Usage
+
+```html
+<rarui-sidebar open="true" position="right" max-width="375px" padding="$small">
+  <div>Your sidebar content here</div>
+</rarui-sidebar>
+```
+
+## Features
+
+- ✨ **Floating-UI Integration**: Intelligent positioning with automatic viewport adjustments using floating-ui
+- 📱 **Responsive**: Adapts to different screen sizes automatically
+- 🎭 **CSS Transitions**: Smooth slide animations with proper transition support
+- ♿ **Accessible**: Full keyboard navigation and screen reader support
+- 🎯 **Position Control**: Left or right positioning options
+- 🔒 **Focus Management**: Automatic focus trapping and restoration
+- 🎨 **Themeable**: Works with Rarui design tokens
+
+## Properties
+
+| Property | Type | Default | Description |
+|----------|------|---------|-------------|
+| `open` | `boolean` | `false` | Whether the sidebar is open or not |
+| `position` | `'left' \| 'right'` | `'right'` | The position of the sidebar |
+| `max-width` | `string` | `'375px'` | Maximum width of the sidebar |
+| `padding` | `string` | `'$small'` | Padding inside the sidebar |
+| `portal-id` | `string` | - | ID of the portal element for rendering |
+
+> **Note**: Properties inherit from `SidebarProps` and are automatically converted from camelCase to kebab-case for web component attributes (e.g., `maxWidth` → `max-width`, `portalId` → `portal-id`).
+
+## Events
+
+| Event | Detail | Description |
+|-------|--------|-------------|
+| `sidebar-open-changed` | `{ open: boolean }` | Dispatched when the sidebar open state changes |
+
+## Examples
+
+### Basic Sidebar
+
+```html
+<rarui-sidebar open="true">
+  <div>Basic sidebar content</div>
+</rarui-sidebar>
+```
+
+### Left Positioned Sidebar
+
+```html
+<rarui-sidebar open="true" position="left" max-width="300px">
+  <nav>
+    <ul>
+      <li>Home</li>
+      <li>About</li>
+      <li>Contact</li>
+    </ul>
+  </nav>
+</rarui-sidebar>
+```
+
+### Custom Width and Padding
+
+```html
+<rarui-sidebar open="true" max-width="500px" padding="$large">
+  <div>Wide sidebar with custom padding</div>
+</rarui-sidebar>
+```
+
+## Differences from React Version
+
+### Enhanced Features
+- **Floating-UI Integration**: Unlike the React version that uses basic floating-ui hooks, the web component version uses advanced virtual references for optimal sidebar positioning
+- **Smooth Transitions**: Always renders allowing CSS transitions to work properly
+- **Automatic Viewport Adaptation**: Content automatically adjusts to viewport constraints using floating-ui middleware
+- **Better Performance**: Native web APIs with optimized floating-ui integration
+
+### Positioning Intelligence
+The web component version provides superior positioning capabilities:
+- Virtual reference system optimized for sidebar edges
+- Responsive width adjustments via floating-ui size middleware
+- Intelligent overflow prevention with shift middleware
+- Automatic repositioning on viewport changes
+
+## Browser Support
+
+This component works in all modern browsers that support:
+- Web Components
+- ES2017+ features
+- CSS Custom Properties
+
+## Development
+
+Built with:
+- **LitElement** for the component base
+- **Floating-UI** for advanced positioning with virtual references
+- **TypeScript** for type safety
+- **Rarui Design System** for styling

package/src/navigation/Breadcrumb/CHANGELOG.md

@@ -0,0 +1,26 @@
+# Changelog
+
+Componente de navegação hierárquica que permite aos usuários navegar através de uma estrutura de páginas, mostrando a localização atual e fornecendo links para níveis anteriores.
+
+## 2025-09-05 `1.1.0`
+
+#### 🎉 New features
+
+- Enhanced Breadcrumb component with comprehensive accessibility improvements including semantic navigation structure (nav aria-label="breadcrumb") and improved dropdown accessibility with proper ARIA attributes for screen reader support. ([#134](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/134) by [@junior](https://git.rarolabs.com.br/junior))
+
+## 2025-08-29 `1.0.0`
+
+#### 🎉 New features
+
+- Implementação inicial do componente Breadcrumb para Web Components. ([#130](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/130) by [@junior](https://git.rarolabs.com.br/junior))
+- Adicionado componente BreadcrumbItem com suporte a links e botões. ([#130](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/130) by [@junior](https://git.rarolabs.com.br/junior))
+- Implementada lógica de truncamento com dropdown para muitos itens. ([#130](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/130) by [@junior](https://git.rarolabs.com.br/junior))
+- Adicionado suporte a ícones nos itens do breadcrumb. ([#130](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/130) by [@junior](https://git.rarolabs.com.br/junior))
+
+<!-- #### 🛠 Breaking changes -->
+
+<!-- #### 📚 3rd party library updates -->
+
+<!-- #### 🐛 Bug fixes -->
+
+<!-- #### 💡 Others -->

package/src/navigation/Breadcrumb/README.md

@@ -0,0 +1,56 @@
+# Breadcrumb
+
+O componente Breadcrumb permite a navegação hierárquica através de uma estrutura de páginas, indicando a localização atual do usuário e fornecendo links para as páginas anteriores.
+
+## Quando usar
+
+- Para mostrar a localização atual do usuário na hierarquia do site
+- Para permitir navegação rápida para níveis anteriores da estrutura
+- Em sistemas com estrutura hierárquica profunda (mais de 3 níveis)
+
+## Estrutura
+
+O componente é formado por:
+
+- `rarui-breadcrumb`: Container principal que gerencia a lógica de truncamento
+- `rarui-breadcrumb-item`: Item individual do breadcrumb
+
+## Uso básico
+
+```html
+<rarui-breadcrumb>
+  <rarui-breadcrumb-item href="/">Home</rarui-breadcrumb-item>
+  <rarui-breadcrumb-item href="/category">Category</rarui-breadcrumb-item>
+  <rarui-breadcrumb-item href="/subcategory">Subcategory</rarui-breadcrumb-item>
+  <rarui-breadcrumb-item active>Current Page</rarui-breadcrumb-item>
+</rarui-breadcrumb>
+```
+
+## Com truncamento
+
+```html
+<rarui-breadcrumb items-after-truncate="2">
+  <rarui-breadcrumb-item href="/">Home</rarui-breadcrumb-item>
+  <rarui-breadcrumb-item href="/level1">Level 1</rarui-breadcrumb-item>
+  <rarui-breadcrumb-item href="/level2">Level 2</rarui-breadcrumb-item>
+  <rarui-breadcrumb-item href="/level3">Level 3</rarui-breadcrumb-item>
+  <rarui-breadcrumb-item href="/level4">Level 4</rarui-breadcrumb-item>
+  <rarui-breadcrumb-item active>Current</rarui-breadcrumb-item>
+</rarui-breadcrumb>
+```
+
+## Com ícones
+
+```html
+<rarui-breadcrumb>
+  <rarui-breadcrumb-item href="/">
+    <rarui-icon slot="icon" name="home"></rarui-icon>
+    Home
+  </rarui-breadcrumb-item>
+  <rarui-breadcrumb-item href="/dashboard">
+    <rarui-icon slot="icon" name="dashboard"></rarui-icon>
+    Dashboard
+  </rarui-breadcrumb-item>
+  <rarui-breadcrumb-item active>Settings</rarui-breadcrumb-item>
+</rarui-breadcrumb>
+```

package/src/navigation/Link/CHANGELOG.md

@@ -0,0 +1,28 @@
+# Changelog
+
+The Link component allows us to navigate to external addresses.
+
+## 2025-09-05 `1.1.0`
+
+#### 🎉 New features
+
+- Enhanced Link component with comprehensive accessibility and form integration (target, rel, name, value, form properties) for proper HTML form submission when as="button" and automatic external link security with noopener noreferrer. ([#134](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/134) by [@junior](https://git.rarolabs.com.br/junior))
+- Added standardized custom event `link-click` with detailed event payload including href, target, and original event for consistent interaction handling. ([#134](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/134) by [@junior](https://git.rarolabs.com.br/junior))
+- Improved ARIA support with complete attributes implementation (aria-label, aria-labelledby, aria-describedby, aria-disabled) for screen reader accessibility. ([#134](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/134) by [@junior](https://git.rarolabs.com.br/junior))
+
+## 2025-06-18 `1.0.0`
+
+#### 🎉 New features
+
+- Added `appearance`, `size`, `size`, `type`, `disabled`, `as` and `href` property to the Component. ([#119](https://git.rarolabs.com.br/frontend/rarui/pull/119) by [@junior](https://git.rarolabs.com.br/junior))
+- Added stories on Component. ([#119](https://git.rarolabs.com.br/frontend/rarui/pull/119) by [@junior](https://git.rarolabs.com.br/junior))
+
+<!-- #### 🛠 Breaking changes -->
+
+<!-- #### 📚 3rd party library updates -->
+
+<!-- #### 🎉 New features -->
+
+<!-- #### 🐛 Bug fixes -->
+
+<!-- #### 💡 Others -->

package/src/navigation/Link/README.md

@@ -0,0 +1,15 @@
+# `@rarui/link`
+
+The Link component allows us to navigate to external addresses.
+
+## Installation
+
+```sh
+$ yarn add @rarui/link
+# or
+$ npm install @rarui/link
+```
+
+## Usage
+
+View docs [here]().

package/src/navigation/Pagination/CHANGELOG.md

@@ -0,0 +1,28 @@
+# Changelog
+
+The pagination component allows the user to select a specific page in a page range.
+
+## 2025-09-05 `1.1.0`
+
+#### 🎉 New features
+
+- Enhanced Pagination component with comprehensive accessibility improvements including semantic navigation structure (nav aria-label="Pagination navigation"), aria-current="page" for current page indication, and descriptive aria-labels for all navigation buttons. ([#134](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/134) by [@junior](https://git.rarolabs.com.br/junior))
+- Improved custom event `page-change` with enhanced payload including previousPage information for better state management and user interaction tracking. ([#134](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/134) by [@junior](https://git.rarolabs.com.br/junior))
+- Added proper ARIA attributes for icons (aria-hidden="true") and improved screen reader experience with contextual button labels. ([#134](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/134) by [@junior](https://git.rarolabs.com.br/junior))
+
+## 2025-06-27 `1.0.0`
+
+#### 🎉 New features
+
+- Added `active-page`, `page-count`, `show-numbers`, `show-arrows` and `size` property to the Component. ([#119](https://git.rarolabs.com.br/frontend/rarui/pull/119) by [@junior](https://git.rarolabs.com.br/junior))
+- Added stories on Component. ([#119](https://git.rarolabs.com.br/frontend/rarui/pull/119) by [@junior](https://git.rarolabs.com.br/junior))
+
+<!-- #### 🛠 Breaking changes -->
+
+<!-- #### 📚 3rd party library updates -->
+
+<!-- #### 🎉 New features -->
+
+<!-- #### 🐛 Bug fixes -->
+
+<!-- #### 💡 Others -->

package/src/navigation/Pagination/README.md

@@ -0,0 +1,15 @@
+# `@rarui/pagination`
+
+The pagination component allows the user to select a specific page in a page range.
+
+## Installation
+
+```sh
+$ yarn add @rarui/pagination
+# or
+$ npm install @rarui/pagination
+```
+
+## Usage
+
+View docs [here]().

package/src/navigation/SideNavigation/CHANGELOG.md

@@ -0,0 +1,33 @@
+# Changelog
+
+A navigation component that supports collapsible content with nested items.
+
+## 2025-09-05 `1.1.0`
+
+#### 🎉 New features
+
+- Enhanced SideNavigation component with comprehensive accessibility improvements including proper ARIA attributes (aria-expanded, aria-controls), semantic roles for expandable sections, and contextual aria-labels that change based on state. ([#134](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/134) by [@junior](https://git.rarolabs.com.br/junior))
+- Improved custom event from `toggle` to standardized `side-navigation-toggle` with enhanced payload including name property for better component identification and interaction tracking. ([#134](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/134) by [@junior](https://git.rarolabs.com.br/junior))
+- Added proper region roles for expandable content areas with aria-labelledby relationships for screen reader navigation support. ([#134](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/134) by [@junior](https://git.rarolabs.com.br/junior))
+
+## 2025-08-27 `1.0.0`
+
+#### 🎉 New features
+
+- Added SideNavigation web component with collapsible functionality. ([#129](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/129) by [@junior](https://git.rarolabs.com.br/junior))
+- Added SideNavigationItem sub-component with level support. ([#129](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/129) by [@junior](https://git.rarolabs.com.br/junior))
+- Added slot support for leading-start and leading-end elements. ([#129](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/129) by [@junior](https://git.rarolabs.com.br/junior))
+- Added toggle event for open/close state changes. ([#129](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/129) by [@junior](https://git.rarolabs.com.br/junior))
+- Integrated rarui-box components for better layout consistency. ([#129](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/129) by [@junior](https://git.rarolabs.com.br/junior))
+- Arrow icons now always visible with proper up/down states. ([#129](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/129) by [@junior](https://git.rarolabs.com.br/junior))
+- Added boolean converters for better attribute handling. ([#129](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/129) by [@junior](https://git.rarolabs.com.br/junior))
+
+<!-- #### 🛠 Breaking changes -->
+
+<!-- #### 📚 3rd party library updates -->
+
+<!-- #### 🎉 New features -->
+
+<!-- #### 🐛 Bug fixes -->
+
+<!-- #### 💡 Others -->

package/src/navigation/SideNavigation/README.md

@@ -0,0 +1,87 @@
+# `@rarui/side-navigation`
+
+The SideNavigation component provides collapsible navigation functionality with support for nested items, leading elements, and active states.
+
+## Installation
+
+```sh
+$ yarn add @rarui/side-navigation
+# or
+$ npm install @rarui/side-navigation
+```
+
+## Usage
+
+### Basic SideNavigation
+```html
+<rarui-side-navigation name="Dashboard" description="Main dashboard">
+  <rarui-side-navigation-item>Reports</rarui-side-navigation-item>
+  <rarui-side-navigation-item>Analytics</rarui-side-navigation-item>
+</rarui-side-navigation>
+```
+
+### SideNavigation with Leading Elements
+```html
+<rarui-side-navigation name="Settings" description="System configuration">
+  <!-- Custom icon at start -->
+  <rarui-icon slot="leading-start" name="folder-outlined" size="medium"></rarui-icon>
+  
+  <!-- Custom icon at end (replaces default arrow) -->
+  <rarui-icon slot="leading-end" name="chevron-down" size="medium"></rarui-icon>
+  
+  <!-- Nested items -->
+  <rarui-side-navigation-item>Profile</rarui-side-navigation-item>
+  <rarui-side-navigation-item>Permissions</rarui-side-navigation-item>
+</rarui-side-navigation>
+```
+
+### Active State
+```html
+<rarui-side-navigation name="Dashboard" active>
+  <rarui-side-navigation-item active>Current Page</rarui-side-navigation-item>
+  <rarui-side-navigation-item>Other Page</rarui-side-navigation-item>
+</rarui-side-navigation>
+```
+
+### Multi-level Navigation
+```html
+<rarui-side-navigation name="Administration">
+  <rarui-side-navigation-item level="0">Users</rarui-side-navigation-item>
+  <rarui-side-navigation-item level="1">Permissions</rarui-side-navigation-item>
+  <rarui-side-navigation-item level="1">Roles</rarui-side-navigation-item>
+</rarui-side-navigation>
+```
+
+## Components
+
+- `rarui-side-navigation` - Main navigation component with collapsible content
+- `rarui-side-navigation-item` - Individual navigation items with support for nesting levels
+
+## Slots
+
+### rarui-side-navigation
+- **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)
+
+### rarui-side-navigation-item
+- **Default slot**: Content for the navigation item
+
+## Behavior
+
+### Arrow Icon
+- Navigation items **always display an arrow icon** by default
+- The arrow rotates between up/down states when toggling
+- Use `leading-end` slot to provide a custom icon that replaces the default arrow
+- Arrow shows `arrow-up` when expanded, `arrow-down` when collapsed
+
+### Boolean Attributes
+- Use `active` instead of `active="true"` for cleaner HTML
+- Use `disabled` instead of `disabled="true"` 
+- Supports string values like `active="false"` for dynamic binding
+
+## Events
+
+- `toggle` - Fired when the navigation item is toggled (opened/closed)
+
+View docs [here]().

package/src/navigation/Tabs/CHANGELOG.md

@@ -0,0 +1,40 @@
+# Changelog
+
+Tabs are used to switch between different display modes or pages.
+
+## 2025-09-05 `1.3.0`
+
+#### 🎉 New features
+
+- Enhanced Tabs component with comprehensive accessibility improvements including complete ARIA tabs pattern implementation (tablist, tab, tabpanel roles), aria-selected and aria-controls attributes for proper screen reader navigation. ([#134](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/134) by [@junior](https://git.rarolabs.com.br/junior))
+- Added standardized custom event `tab-change` with detailed event payload including selectedTab, previousTab, and label information for enhanced state management and interaction tracking. ([#134](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/134) by [@junior](https://git.rarolabs.com.br/junior))
+- Implemented proper tabpanel management with aria-hidden, aria-labelledby relationships, and semantic role attributes for complete accessibility compliance. ([#134](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/134) by [@junior](https://git.rarolabs.com.br/junior))
+
+## 2025-05-27 `1.2.0`
+
+#### 🎉 New features
+
+- Added the `custom-elements.json` file to the package for automatic documentation tools and web component support editors. ([#110](https://git.rarolabs.com.br/frontend/rarui/pull/110) by [@junior](https://git.rarolabs.com.br/junior))
+
+## 2025-05-23 `1.1.0`
+
+#### 🎉 New features
+
+- Adjusted the creation of components for `lit` use to `stencil` Inves. ([#109](https://git.rarolabs.com.br/frontend/rarui/pull/109) by [@junior](https://git.rarolabs.com.br/junior))
+
+## 2024-08-06 `1.0.0`
+
+#### 🎉 New features
+
+- Added `preSelectedTab`, `position`, `full` and `underlined` properties to the Component. ([#87](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/87) by [@junior](https://git.rarolabs.com.br/junior))
+- Added stories on Component. ([#87](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/87) by [@junior](https://git.rarolabs.com.br/junior))
+
+<!-- #### 🛠 Breaking changes -->
+
+<!-- #### 📚 3rd party library updates -->
+
+<!-- #### 🎉 New features -->
+
+<!-- #### 🐛 Bug fixes -->
+
+<!-- #### 💡 Others -->

package/src/navigation/Tabs/README.md

@@ -0,0 +1,9 @@
+# `@rarui/tabs`
+
+Tabs are used to switch between different display modes or pages.
+
+## Installation
+
+## Usage
+
+View docs [here]().

package/src/stylization/ThemeProvider/CHANGELOG.md

@@ -0,0 +1,32 @@
+# Changelog
+
+The ThemeProvider component provides global theme management for the application.
+
+## 2025-09-04 `1.1.0`
+
+#### 🎉 New features
+
+- Added comprehensive accessibility support with ARIA attributes (aria-label, aria-labelledby, aria-describedby) for screen reader compatibility. ([#134](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/134) by [@junior](https://git.rarolabs.com.br/junior))
+
+## 2025-08-28 `1.0.0`
+
+#### 🎉 New features
+
+- Added ThemeProvider Web Component implementation. ([#128](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/128) by [@junior](https://git.rarolabs.com.br/junior))
+- Added global theme management system. ([#128](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/128) by [@junior](https://git.rarolabs.com.br/junior))
+- Added support for 'base' and 'dark' themes. ([#128](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/128) by [@junior](https://git.rarolabs.com.br/junior))
+- Added global API via window.raruiTheme. ([#128](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/128) by [@junior](https://git.rarolabs.com.br/junior))
+- Added custom events for theme changes. ([#128](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/128) by [@junior](https://git.rarolabs.com.br/junior))
+- Added theme manipulation utilities. ([#128](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/128) by [@junior](https://git.rarolabs.com.br/junior))
+- Added localStorage persistence. ([#128](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/128) by [@junior](https://git.rarolabs.com.br/junior))
+- Added stories on Component. ([#128](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/128) by [@junior](https://git.rarolabs.com.br/junior))
+
+<!-- #### 🛠 Breaking changes -->
+
+<!-- #### 📚 3rd party library updates -->
+
+<!-- #### 🎉 New features -->
+
+<!-- #### 🐛 Bug fixes -->
+
+<!-- #### 💡 Others -->

package/src/stylization/ThemeProvider/README.md

@@ -0,0 +1,56 @@
+# ThemeProvider Web Component
+
+Componente para gerenciamento global de temas na aplicação.
+
+## Instalação
+
+```bash
+npm install @rarui/theme-provider
+```
+
+## Uso Básico
+
+```html
+<rarui-theme-provider theme="dark">
+  <rarui-button>Botão com tema aplicado</rarui-button>
+</rarui-theme-provider>
+```
+
+## API Global
+
+```javascript
+// Alternar tema
+window.raruiTheme.setTheme('dark');
+
+// Obter tema atual
+const currentTheme = window.raruiTheme.getTheme();
+
+// Escutar mudanças de tema
+const unsubscribe = window.raruiTheme.subscribe((theme) => {
+  console.log('Tema mudou para:', theme);
+});
+
+// Evento global
+document.addEventListener('rarui-theme-change', (event) => {
+  console.log('Novo tema:', event.detail.theme);
+});
+```
+
+## Utilitários
+
+```javascript
+import { toggleTheme, isDarkTheme, onThemeChange } from '@rarui/theme-provider';
+
+// Alternar entre temas
+toggleTheme();
+
+// Verificar se está no tema escuro
+if (isDarkTheme()) {
+  console.log('Tema escuro ativo');
+}
+
+// Escutar mudanças
+const unsubscribe = onThemeChange((theme) => {
+  console.log('Tema atual:', theme);
+});
+```