ngx-opalbytes-components 1.25.0 → 1.26.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ngx-opalbytes-components",
-  "version": "1.25.0",
+  "version": "1.26.0",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
     "@angular/core": "^21.0.0",

package/src/lib/shared/components/index.ts

@@ -27,4 +27,7 @@ export * from "./error/error"
 
 export * from "./card/card.component"
 export * from "./base-toggle/base-toggle.component"
+export * from "./slide-toggle/slide-toggle.component"
+export * from "./radio/radio-group.component"
+export * from "./radio/radio-button.component"
 export * from "./footer/footer"

package/src/lib/shared/components/radio/radio-button.component.css

@@ -0,0 +1,95 @@
+:host {
+  display: inline-flex;
+}
+
+.cao-radio {
+  display: inline-flex;
+  align-items: center;
+  gap: 8px;
+  cursor: pointer;
+  user-select: none;
+}
+
+.cao-radio--disabled {
+  cursor: not-allowed;
+}
+
+.cao-radio__input {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  margin: -1px;
+  padding: 0;
+  border: 0;
+  overflow: hidden;
+  clip: rect(0 0 0 0);
+  clip-path: inset(50%);
+  white-space: nowrap;
+}
+
+.cao-radio__control {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  flex: none;
+  width: var(--cao-radio-size, 20px);
+  height: var(--cao-radio-size, 20px);
+  box-sizing: border-box;
+  border: 2px solid var(--cao-radio-unselected, #6b7280);
+  border-radius: 50%;
+  transition: border-color var(--cao-radio-duration, 200ms) ease;
+}
+
+.cao-radio__dot {
+  width: 50%;
+  height: 50%;
+  border-radius: 50%;
+  background-color: var(--cao-radio-color, #4f46e5);
+  transform: scale(0);
+  transition:
+    transform var(--cao-radio-duration, 200ms) ease,
+    background-color var(--cao-radio-duration, 200ms) ease;
+}
+
+.cao-radio__label {
+  color: var(--cao-radio-label, #111827);
+  font-size: 0.875rem;
+  line-height: 1.25rem;
+}
+
+.cao-radio__label:empty {
+  display: none;
+}
+
+.cao-radio:not(.cao-radio--disabled):hover .cao-radio__control,
+.cao-radio--checked .cao-radio__control {
+  border-color: var(--cao-radio-color, #4f46e5);
+}
+
+.cao-radio--checked .cao-radio__dot {
+  transform: scale(1);
+}
+
+.cao-radio--disabled .cao-radio__control {
+  border-color: var(--cao-radio-disabled, #d1d5db);
+}
+
+.cao-radio--disabled .cao-radio__dot {
+  background-color: var(--cao-radio-disabled, #d1d5db);
+}
+
+.cao-radio--disabled .cao-radio__label {
+  color: var(--cao-radio-label-disabled, #9ca3af);
+}
+
+.cao-radio__input:focus-visible + .cao-radio__control {
+  box-shadow: 0 0 0 3px var(--cao-radio-focus-ring, rgba(79, 70, 229, 0.35));
+}
+
+.cao-radio--label-before .cao-radio__control {
+  order: 2;
+}
+
+.cao-radio--label-before .cao-radio__label {
+  order: 1;
+}

package/src/lib/shared/components/radio/radio-button.component.html

@@ -0,0 +1,32 @@
+<label
+  class="cao-radio"
+  [class.cao-radio--checked]="isSelected"
+  [class.cao-radio--disabled]="effectiveDisabled"
+  [class.cao-radio--label-before]="effectiveLabelPosition === 'before'">
+  <input
+    #input
+    class="cao-radio__input"
+    type="radio"
+    [checked]="isSelected"
+    [disabled]="effectiveDisabled"
+    [required]="isRequired"
+    [attr.name]="effectiveName"
+    [attr.id]="inputId"
+    [attr.aria-label]="ariaLabel || null"
+    [attr.aria-labelledby]="ariaLabelledBy || null"
+    [attr.data-cy]="dataCy || null"
+    (change)="select()"
+    (blur)="onBlur()" />
+
+  <span class="cao-radio__control" aria-hidden="true">
+    <span class="cao-radio__dot"></span>
+  </span>
+
+  <span class="cao-radio__label">
+    @if (label) {
+      {{ label }}
+    } @else {
+      <ng-content />
+    }
+  </span>
+</label>

package/src/lib/shared/components/radio/radio-button.component.ts

@@ -0,0 +1,133 @@
+import { CommonModule } from "@angular/common";
+import {
+  Component,
+  forwardRef,
+  HostBinding,
+  Inject,
+  Input,
+  Optional,
+} from "@angular/core";
+
+import { CaoRadioGroupComponent } from "./radio-group.component";
+
+let nextRadioId = 0;
+
+@Component({
+  selector: "cao-radio-button",
+  standalone: true,
+  imports: [CommonModule],
+  templateUrl: "./radio-button.component.html",
+  styleUrl: "./radio-button.component.css",
+})
+export class CaoRadioButtonComponent {
+  @Input() value: unknown = undefined;
+  @Input() label = "";
+  @Input() isDisabled = false;
+  @Input() labelPosition?: "before" | "after";
+  @Input() id = "";
+  @Input() name = "";
+  @Input() ariaLabel = "";
+  @Input() ariaLabelledBy = "";
+  @Input() dataCy = "";
+
+  @Input() color?: string;
+  @Input() unselectedColor?: string;
+  @Input() disabledColor?: string;
+  @Input() labelColor?: string;
+  @Input() disabledLabelColor?: string;
+  @Input() focusRingColor?: string;
+  @Input() size?: string;
+  @Input() animationDuration?: string;
+
+  @Input() set disabled(value: boolean) {
+    this.isDisabled = value;
+  }
+
+  get disabled(): boolean {
+    return this.isDisabled;
+  }
+
+  private readonly uid = `cao-radio-${nextRadioId++}`;
+
+  constructor(
+    @Optional()
+    @Inject(forwardRef(() => CaoRadioGroupComponent))
+    readonly group: CaoRadioGroupComponent | null,
+  ) {}
+
+  get effectiveDisabled(): boolean {
+    return this.isDisabled || !!this.group?.isEffectivelyDisabled;
+  }
+
+  get effectiveLabelPosition(): "before" | "after" {
+    return this.labelPosition ?? this.group?.labelPosition ?? "after";
+  }
+
+  get effectiveName(): string {
+    return this.name || this.group?.groupName || this.uid;
+  }
+
+  get inputId(): string {
+    return this.id || this.uid;
+  }
+
+  get isSelected(): boolean {
+    return this.group?.isValueSelected(this.value) ?? false;
+  }
+
+  get isRequired(): boolean {
+    return this.group?.required ?? false;
+  }
+
+  @HostBinding("style")
+  get hostStyles(): Record<string, string> {
+    const styles: Record<string, string> = {};
+
+    if (this.color) {
+      styles["--cao-radio-color"] = this.color;
+    }
+    if (this.unselectedColor) {
+      styles["--cao-radio-unselected"] = this.unselectedColor;
+    }
+    if (this.disabledColor) {
+      styles["--cao-radio-disabled"] = this.disabledColor;
+    }
+    if (this.labelColor) {
+      styles["--cao-radio-label"] = this.labelColor;
+    }
+    if (this.disabledLabelColor) {
+      styles["--cao-radio-label-disabled"] = this.disabledLabelColor;
+    }
+    if (this.focusRingColor) {
+      styles["--cao-radio-focus-ring"] = this.focusRingColor;
+    }
+    if (this.size) {
+      styles["--cao-radio-size"] = this.size;
+    }
+    if (this.animationDuration) {
+      styles["--cao-radio-duration"] = this.animationDuration;
+    }
+
+    return styles;
+  }
+
+  select(): void {
+    if (this.effectiveDisabled) {
+      return;
+    }
+
+    this.group?.select(this);
+  }
+
+  onBlur(): void {
+    this.group?.markAsTouched();
+  }
+
+  enable(): void {
+    this.isDisabled = false;
+  }
+
+  disable(): void {
+    this.isDisabled = true;
+  }
+}

package/src/lib/shared/components/radio/radio-button.stories.ts

@@ -0,0 +1,94 @@
+import { FormsModule } from '@angular/forms';
+
+import type { Meta, StoryObj } from '@storybook/angular-vite';
+
+import { CaoRadioButtonComponent } from './radio-button.component';
+import { CaoRadioGroupComponent } from './radio-group.component';
+
+const meta: Meta<CaoRadioButtonComponent> = {
+  title: 'Componentes/Radio Button',
+  component: CaoRadioButtonComponent,
+  tags: ['autodocs'],
+  decorators: [
+    (story) => ({
+      ...story,
+      moduleMetadata: {
+        imports: [FormsModule, CaoRadioGroupComponent, CaoRadioButtonComponent],
+      },
+    }),
+  ],
+  argTypes: {
+    labelPosition: { control: 'select', options: ['before', 'after'] },
+    isDisabled: { control: 'boolean' },
+    disabled: { control: 'boolean' },
+    color: { control: 'color' },
+    unselectedColor: { control: 'color' },
+    disabledColor: { control: 'color' },
+    labelColor: { control: 'color' },
+    disabledLabelColor: { control: 'color' },
+    focusRingColor: { control: 'color' },
+    size: { control: 'text' },
+    animationDuration: { control: 'text' },
+  },
+  args: {
+    value: 'option-1',
+    label: 'Opção selecionada',
+    labelPosition: 'after',
+    isDisabled: false,
+  },
+  render: (args) => ({
+    props: {
+      ...args,
+      selectedValue: 'option-1',
+    },
+    template: `
+    <cao-radio-group
+      [(ngModel)]="selectedValue"
+      [labelPosition]="labelPosition">
+      <cao-radio-button
+        value="option-1"
+        [label]="label"
+        [isDisabled]="isDisabled"
+        [labelPosition]="labelPosition"
+        [color]="color"
+        [unselectedColor]="unselectedColor"
+        [disabledColor]="disabledColor"
+        [labelColor]="labelColor"
+        [disabledLabelColor]="disabledLabelColor"
+        [focusRingColor]="focusRingColor"
+        [size]="size"
+        [animationDuration]="animationDuration" />
+      <cao-radio-button value="option-2" label="Outra opção" />
+    </cao-radio-group>
+    <p>Selecionado: {{ selectedValue }}</p>
+  `,
+  }),
+};
+
+export default meta;
+type Story = StoryObj<CaoRadioButtonComponent>;
+
+export const Padrao: Story = {};
+
+export const Desabilitado: Story = {
+  args: {
+    isDisabled: true,
+    label: 'Opção desabilitada',
+  },
+};
+
+export const CoresCustomizadas: Story = {
+  args: {
+    color: '#16a34a',
+    unselectedColor: '#94a3b8',
+    labelColor: '#166534',
+    size: '24px',
+  },
+};
+
+export const LabelAntes: Story = {
+  args: {
+    labelPosition: 'before',
+    label: 'Label antes',
+  },
+};

package/src/lib/shared/components/radio/radio-group.component.css

@@ -0,0 +1,21 @@
+:host {
+  --cao-radio-color: #4f46e5;
+  --cao-radio-unselected: #6b7280;
+  --cao-radio-disabled: #d1d5db;
+  --cao-radio-label: #111827;
+  --cao-radio-label-disabled: #9ca3af;
+  --cao-radio-focus-ring: rgba(79, 70, 229, 0.35);
+  --cao-radio-size: 20px;
+  --cao-radio-duration: 200ms;
+  --cao-radio-gap: 8px;
+
+  display: flex;
+  flex-direction: column;
+  gap: var(--cao-radio-gap);
+}
+
+:host(.cao-radio-group--horizontal) {
+  flex-direction: row;
+  flex-wrap: wrap;
+  align-items: center;
+}

package/src/lib/shared/components/radio/radio-group.component.ts

@@ -0,0 +1,216 @@
+import {
+  ChangeDetectionStrategy,
+  ChangeDetectorRef,
+  Component,
+  EventEmitter,
+  forwardRef,
+  HostBinding,
+  inject,
+  Input,
+  Output,
+} from "@angular/core";
+import { ControlValueAccessor, NG_VALUE_ACCESSOR } from "@angular/forms";
+
+import type { CaoRadioButtonComponent } from "./radio-button.component";
+
+let nextRadioGroupId = 0;
+
+export interface ICaoRadioChangeEvent {
+  value: unknown;
+  source: CaoRadioButtonComponent;
+}
+
+@Component({
+  selector: "cao-radio-group",
+  standalone: true,
+  template: "<ng-content />",
+  styleUrl: "./radio-group.component.css",
+  providers: [
+    {
+      provide: NG_VALUE_ACCESSOR,
+      useExisting: forwardRef(() => CaoRadioGroupComponent),
+      multi: true,
+    },
+  ],
+  changeDetection: ChangeDetectionStrategy.OnPush,
+})
+export class CaoRadioGroupComponent implements ControlValueAccessor {
+  @Input() value: unknown = undefined;
+  @Input() name = "";
+  @Input() isDisabled = false;
+  @Input() required = false;
+  @Input() orientation: "vertical" | "horizontal" = "vertical";
+  @Input() labelPosition: "before" | "after" = "after";
+  @Input() compareWith: (option: unknown, value: unknown) => boolean = (
+    option,
+    value,
+  ) => option === value;
+
+  @Input() color?: string;
+  @Input() unselectedColor?: string;
+  @Input() disabledColor?: string;
+  @Input() labelColor?: string;
+  @Input() disabledLabelColor?: string;
+  @Input() focusRingColor?: string;
+  @Input() size?: string;
+  @Input() animationDuration?: string;
+  @Input() gap?: string;
+
+  @Input() ariaLabel = "";
+  @Input() ariaLabelledBy = "";
+  @Input() dataCy = "";
+
+  @Input() set disabled(value: boolean) {
+    this.isDisabled = value;
+    this.cdr.markForCheck();
+  }
+
+  get disabled(): boolean {
+    return this.isDisabled;
+  }
+
+  @Output() readonly valueChange = new EventEmitter<unknown>();
+  @Output() readonly selectionChange = new EventEmitter<ICaoRadioChangeEvent>();
+
+  readonly resolvedName = `cao-radio-group-${nextRadioGroupId++}`;
+
+  private readonly cdr = inject(ChangeDetectorRef);
+  private formDisabled = false;
+  private onChange: (value: unknown) => void = () => {};
+  private onTouched: () => void = () => {};
+
+  get isEffectivelyDisabled(): boolean {
+    return this.isDisabled || this.formDisabled;
+  }
+
+  @HostBinding("attr.role")
+  readonly role = "radiogroup";
+
+  @HostBinding("class.cao-radio-group--horizontal")
+  get isHorizontal(): boolean {
+    return this.orientation === "horizontal";
+  }
+
+  @HostBinding("class.cao-radio-group--disabled")
+  get isDisabledClass(): boolean {
+    return this.isEffectivelyDisabled;
+  }
+
+  @HostBinding("attr.aria-label")
+  get ariaLabelAttr(): string | null {
+    return this.ariaLabel || null;
+  }
+
+  @HostBinding("attr.aria-labelledby")
+  get ariaLabelledByAttr(): string | null {
+    return this.ariaLabelledBy || null;
+  }
+
+  @HostBinding("attr.aria-disabled")
+  get ariaDisabledAttr(): boolean | null {
+    return this.isEffectivelyDisabled || null;
+  }
+
+  @HostBinding("attr.aria-required")
+  get ariaRequiredAttr(): boolean | null {
+    return this.required || null;
+  }
+
+  @HostBinding("attr.data-cy")
+  get dataCyAttr(): string | null {
+    return this.dataCy || null;
+  }
+
+  @HostBinding("style")
+  get hostStyles(): Record<string, string> {
+    const styles: Record<string, string> = {};
+
+    if (this.color) {
+      styles["--cao-radio-color"] = this.color;
+    }
+    if (this.unselectedColor) {
+      styles["--cao-radio-unselected"] = this.unselectedColor;
+    }
+    if (this.disabledColor) {
+      styles["--cao-radio-disabled"] = this.disabledColor;
+    }
+    if (this.labelColor) {
+      styles["--cao-radio-label"] = this.labelColor;
+    }
+    if (this.disabledLabelColor) {
+      styles["--cao-radio-label-disabled"] = this.disabledLabelColor;
+    }
+    if (this.focusRingColor) {
+      styles["--cao-radio-focus-ring"] = this.focusRingColor;
+    }
+    if (this.size) {
+      styles["--cao-radio-size"] = this.size;
+    }
+    if (this.animationDuration) {
+      styles["--cao-radio-duration"] = this.animationDuration;
+    }
+    if (this.gap) {
+      styles["--cao-radio-gap"] = this.gap;
+    }
+
+    return styles;
+  }
+
+  get groupName(): string {
+    return this.name || this.resolvedName;
+  }
+
+  isValueSelected(value: unknown): boolean {
+    return this.compareWith(this.value, value);
+  }
+
+  select(button: CaoRadioButtonComponent): void {
+    if (this.isEffectivelyDisabled || button.effectiveDisabled) {
+      return;
+    }
+
+    if (this.compareWith(this.value, button.value)) {
+      this.markAsTouched();
+      return;
+    }
+
+    this.value = button.value;
+    this.onChange(this.value);
+    this.valueChange.emit(this.value);
+    this.selectionChange.emit({ value: this.value, source: button });
+    this.markAsTouched();
+    this.cdr.markForCheck();
+  }
+
+  markAsTouched(): void {
+    this.onTouched();
+  }
+
+  enable(): void {
+    this.isDisabled = false;
+    this.cdr.markForCheck();
+  }
+
+  disable(): void {
+    this.isDisabled = true;
+    this.cdr.markForCheck();
+  }
+
+  writeValue(value: unknown): void {
+    this.value = value;
+    this.cdr.markForCheck();
+  }
+
+  registerOnChange(fn: (value: unknown) => void): void {
+    this.onChange = fn;
+  }
+
+  registerOnTouched(fn: () => void): void {
+    this.onTouched = fn;
+  }
+
+  setDisabledState(isDisabled: boolean): void {
+    this.formDisabled = isDisabled;
+    this.cdr.markForCheck();
+  }
+}