@rarui/components 1.24.0 → 1.24.1

package/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 `@rarui/components` components is a component library built with [Lit](https://lit.dev/).
 
+## 2025-09-18 `1.25.0`
+
+#### 🎉 New features
+
+- Enhanced form integration across all input components with native HTML form association using ElementInternals API for seamless form submission, validation, and reset capabilities. ([#135](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/135) by [@junior](https://git.rarolabs.com.br/junior))
+- Standardized custom event naming convention with `rarui-*` pattern across all components (Button, Checkbox, Input, Select, Textarea, Chip) for consistent event handling and better namespace organization. ([#135](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/135) by [@junior](https://git.rarolabs.com.br/junior))
+- Implemented comprehensive label integration system with automatic focus management through `rarui-label-click` communication pattern for seamless label-to-control association. ([#135](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/135) by [@junior](https://git.rarolabs.com.br/junior))
+- Enhanced Button component with intelligent form interaction (automatic submit/reset based on type) and standardized custom event `rarui-button-click` for consistent interaction handling. ([#135](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/135) by [@junior](https://git.rarolabs.com.br/junior))
+- Enhanced Label component with proper HTML semantics (standardized `for` attribute replacing `htmlFor`) and automatic form control association through custom event system. ([#135](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/135) by [@junior](https://git.rarolabs.com.br/junior))
+
+#### 🛠 Breaking changes
+
+- Changed Label component `htmlFor` property to `for` for standard HTML label attribute compliance. ([#135](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/135) by [@junior](https://git.rarolabs.com.br/junior))
+- Updated custom event names across all components: `input-change` → `rarui-input-change`, `select-change` → `rarui-select-change`, `textarea-change` → `rarui-textarea-change`, `change` → `rarui-checkbox-change`, `chip-click` → `rarui-chip-click`, `chip-close` → `rarui-chip-close`. ([#135](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/135) by [@junior](https://git.rarolabs.com.br/junior))
+
+#### 💡 Others
+
+- Enhanced Chip component type definitions with comprehensive event documentation for better developer experience. ([#135](https://git.rarolabs.com.br/frontend/rarui/-/merge_requests/135) by [@junior](https://git.rarolabs.com.br/junior))
+
 ## 2025-09-05 `1.24.0`
 
 #### 🎉 New features

package/custom-elements.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.23.0",
+  "version": "1.24.0",
   "tags": [
     {
       "name": "rarui-avatar",

package/dist/index.d.ts

@@ -16928,29 +16928,6 @@ declare const styles$6: {
 
 type InputVariants = NonNullable<RecipeVariants<typeof styles$6.container> & RecipeVariants<typeof styles$6.input>>;
 
-declare const styles$5: {
-    label: RuntimeFn<{
-        /**
-         * Specifies whether the label is hidden or not
-         * @default false
-         */
-        hidden: {
-            true: {
-                border: "0";
-                clip: "rect(0 0 0 0)";
-                height: "1px";
-                margin: "-1px";
-                overflow: "hidden";
-                padding: "0";
-                position: "absolute";
-                width: "1px";
-            };
-        };
-    }>;
-};
-
-type LabelVariants = RecipeVariants<typeof styles$5.label>;
-
 declare const styles$4: {
     link: RuntimeFn<{
         /**
@@ -17894,14 +17871,6 @@ interface TextProps extends TextSprinkle {
     lineClamp?: number;
 }
 
-interface LabelTyping {
-    /**
-     * The for attribute specifies which form element a label is bound to.
-     */
-    htmlFor?: string;
-}
-type LabelProps = LabelTyping & LabelVariants;
-
 interface TooltipTyping {
     /**
      * Conditional for displaying the popover arrow.
@@ -18453,14 +18422,20 @@ declare global {
  *
  See [a complete document](https://rarui.rarolabs.com.br/docs/components-web-components/exhibition/label) for more details.
  */
-type LabelManifestProperties = LabelProps;
+type LabelManifestProperties = {
+    /**
+     * The for attribute specifies which form element a label is bound to.
+     */
+    for?: string;
+};
 type LabelProperties = WebComponentProperties<LabelManifestProperties>;
 
 declare class RaruiLabel extends LitElement {
-    htmlFor: LabelProperties["html-for"];
+    for: LabelProperties["for"];
     hidden: boolean;
     static styles: CSSResult;
     render(): TemplateResult<1>;
+    private _handleClick;
 }
 
 declare global {
@@ -18770,6 +18745,7 @@ declare class RaruiButton extends LitElement {
     form: ButtonProperties["form"];
     static styles: CSSResult;
     render(): TemplateResult<1>;
+    private _handleClick;
 }
 
 declare global {
@@ -18839,13 +18815,22 @@ declare class RaruiCheckbox extends LitElement {
     value?: CheckboxProperties["value"];
     form?: CheckboxProperties["form"];
     private _hasCheckedAttribute;
+    private _internals;
     private input;
+    static formAssociated: boolean;
+    constructor();
     static styles: CSSResult;
     connectedCallback(): void;
+    disconnectedCallback(): void;
     attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
     updated(changedProperties: Map<string, any>): void;
     render(): TemplateResult<1>;
     private _onChange;
+    private _updateFormValue;
+    focus(): void;
+    blur(): void;
+    private _handleLabelClick;
+    formResetCallback(): void;
     private getAriaCheckedValue;
 }
 
@@ -18884,6 +18869,19 @@ type ChipManifestProperties = ChipProps & {
      * Associates the chip with a form element by ID.
      */
     form?: string;
+    /**
+     * @events
+     * rarui-chip-click: Fired when the chip is clicked (only when not closeable)
+     * rarui-chip-close: Fired when the close button is clicked (only when closeable is true)
+     */
+    _events?: {
+        "rarui-chip-click": {
+            detail: MouseEvent;
+        };
+        "rarui-chip-close": {
+            detail: MouseEvent | KeyboardEvent;
+        };
+    };
 };
 type ChipProperties = WebComponentProperties<ChipManifestProperties>;
 
@@ -19122,7 +19120,11 @@ type InputManifestProperties = InputProps & {
     /**
      * The name of the input for form submission.
      */
-    name?: string;
+    name: string;
+    /**
+     * The id of the input for form submission.
+     */
+    id: string;
     /**
      * Associates the input with a form element by ID.
      */
@@ -19168,10 +19170,19 @@ declare class RaruiInput extends LitElement {
     minlength: InputProperties["minlength"];
     maxlength: InputProperties["maxlength"];
     pattern: InputProperties["pattern"];
+    private _internals;
+    static formAssociated: boolean;
+    constructor();
+    connectedCallback(): void;
+    disconnectedCallback(): void;
     static styles: CSSResult;
     render(): TemplateResult<1>;
     private _focusInput;
     private _onInput;
+    focus(): void;
+    blur(): void;
+    private _handleLabelClick;
+    formResetCallback(): void;
 }
 
 declare global {
@@ -19294,7 +19305,10 @@ type TextareaProperties = WebComponentProperties<TextareaManifestProperties>;
 
 declare class RaruiTextarea extends LitElement {
     disabled: boolean;
-    value?: string;
+    value: string;
+    private _internals;
+    static formAssociated: boolean;
+    constructor();
     appearance?: TextareaProperties["appearance"];
     lines?: TextareaProperties["lines"];
     name: TextareaProperties["name"];
@@ -19306,6 +19320,13 @@ declare class RaruiTextarea extends LitElement {
     maxlength: TextareaProperties["maxlength"];
     static styles: CSSResult;
     render(): TemplateResult<1>;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private _onInput;
+    focus(): void;
+    blur(): void;
+    private _handleLabelClick;
+    formResetCallback(): void;
 }
 
 declare global {