@nimbus-ds/components 5.35.1 → 5.36.0-rc.2

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 Nimbus is an open-source Design System created by Tiendanube / Nuvemshop's team to empower and enhance more stories every day, with simplicity, accessibility, consistency and performance.
 
+## 2025-11-11 `5.36.0`
+
+#### 🎉 New features
+
+- `Accordion`: Added controlled mode support allowing external state management of accordion selection. ([#381](https://github.com/TiendaNube/nimbus-design-system/pull/381) by [@joacotornello](https://github.com/joacotornello))
+
 ## 2025-11-11 `5.35.1`
 
 #### 🐛 Bug fixes

package/dist/Accordion/index.d.ts

@@ -119,18 +119,35 @@ export interface AccordionComponents {
 	Item: typeof AccordionItem;
 	Header: typeof AccordionHeader;
 }
-export interface AccordionProperties {
+export interface AccordionBaseProperties {
 	/**
 	 * The content of the accordion.
 	 * @TJS-type React.ReactNode
 	 */
 	children?: ReactNode;
+}
+export interface UncontrolledAccordionProperties extends AccordionBaseProperties {
 	/**
 	 * Informs which accordion item is open by default, this value must be the same as informed in the index of each item
 	 */
 	selectedDefault?: string;
 }
-export type AccordionProps = AccordionProperties & HTMLAttributes<HTMLElement>;
+export interface ControlledAccordionProperties extends AccordionBaseProperties {
+	/**
+	 * The currently selected accordion item ID.
+	 */
+	selectedItem: string;
+	/**
+	 * Callback fired when the selected accordion item changes.
+	 * @param selectedId The ID of the selected accordion item
+	 */
+	onItemSelect?: (selectedId: string) => void;
+}
+/**
+ * Props for the Accordion component, supporting both controlled and uncontrolled modes
+ */
+export type AccordionProps = (UncontrolledAccordionProperties | ControlledAccordionProperties) & Omit<HTMLAttributes<HTMLElement>, "onItemSelect" | "selectedItem">;
+export type AccordionProperties = AccordionBaseProperties & UncontrolledAccordionProperties & ControlledAccordionProperties;
 export declare const Accordion: React.FC<AccordionProps> & AccordionComponents;
 
 export {};