ngx-opalbytes-components 1.25.1 → 1.27.0

package/src/lib/shared/components/checkbox/checkbox.component.ts

@@ -0,0 +1,258 @@
+import { CommonModule } from "@angular/common";
+import {
+  ChangeDetectionStrategy,
+  ChangeDetectorRef,
+  Component,
+  EventEmitter,
+  forwardRef,
+  HostBinding,
+  inject,
+  Input,
+  OnChanges,
+  OnDestroy,
+  Output,
+  SimpleChanges,
+} from "@angular/core";
+import { AbstractControl, ControlValueAccessor, NG_VALUE_ACCESSOR } from "@angular/forms";
+
+import { LucideDynamicIcon } from "@lucide/angular";
+import { Subscription } from "rxjs";
+
+let nextCheckboxId = 0;
+
+export interface ICaoCheckboxChangeEvent {
+  checked: boolean;
+  source: CaoCheckboxComponent;
+}
+
+@Component({
+  selector: "cao-checkbox",
+  standalone: true,
+  imports: [CommonModule, LucideDynamicIcon],
+  templateUrl: "./checkbox.component.html",
+  styleUrl: "./checkbox.component.css",
+  changeDetection: ChangeDetectionStrategy.OnPush,
+  providers: [
+    {
+      provide: NG_VALUE_ACCESSOR,
+      useExisting: forwardRef(() => CaoCheckboxComponent),
+      multi: true,
+    },
+  ],
+})
+export class CaoCheckboxComponent implements ControlValueAccessor, OnChanges, OnDestroy {
+  @Input() checked = false;
+  @Input() indeterminate = false;
+  @Input() isDisabled = false;
+  @Input() required = false;
+  @Input() label = "";
+  @Input() labelPosition: "before" | "after" = "after";
+  @Input() name = "";
+  @Input() id = "";
+  @Input() ariaLabel = "";
+  @Input() ariaLabelledBy = "";
+  @Input() dataCy = "";
+  @Input() control?: AbstractControl | null;
+  @Input() errorMessage = "";
+
+  @Input() color?: string;
+  @Input() uncheckedColor?: string;
+  @Input() disabledColor?: string;
+  @Input() labelColor?: string;
+  @Input() disabledLabelColor?: string;
+  @Input() focusRingColor?: string;
+
+  @Input() size?: string;
+  @Input() borderRadius?: string;
+  @Input() animationDuration?: string;
+
+  @Input() checkedIcon = "";
+  @Input() uncheckedIcon = "";
+  @Input() indeterminateIcon = "";
+  @Input() isLucideIcon = false;
+  @Input() iconColor = "";
+  @Input() checkedIconColor = "";
+  @Input() uncheckedIconColor = "";
+  @Input() iconSize: string | number = 14;
+  @Input() iconStrokeWidth: string | number = 2.5;
+
+  @Input() set disabled(value: boolean) {
+    this.isDisabled = value;
+    this.cdr.markForCheck();
+  }
+
+  get disabled(): boolean {
+    return this.isDisabled;
+  }
+
+  @Output() readonly checkedChange = new EventEmitter<boolean>();
+  @Output() readonly indeterminateChange = new EventEmitter<boolean>();
+  @Output() readonly checkboxChange = new EventEmitter<ICaoCheckboxChangeEvent>();
+
+  private readonly cdr = inject(ChangeDetectorRef);
+  private readonly uid = `cao-checkbox-${nextCheckboxId++}`;
+  private controlSub?: Subscription;
+  private onChange: (value: boolean) => void = () => {};
+  private onTouched: () => void = () => {};
+
+  ngOnChanges(changes: SimpleChanges): void {
+    if (changes["control"]) {
+      this.controlSub?.unsubscribe();
+      this.controlSub = this.control?.statusChanges.subscribe(() =>
+        this.cdr.markForCheck(),
+      );
+    }
+  }
+
+  ngOnDestroy(): void {
+    this.controlSub?.unsubscribe();
+  }
+
+  get inputId(): string {
+    return this.id || this.uid;
+  }
+
+  get hasError(): boolean {
+    return !!this.errorMessage;
+  }
+
+  get hasInvalidState(): boolean {
+    return !!(this.control?.touched && this.control?.invalid);
+  }
+
+  get hasValidState(): boolean {
+    return !!(this.control?.touched && this.control?.valid);
+  }
+
+  get resolvedIconColor(): string {
+    if (this.indeterminate) {
+      return this.iconColor || this.checkedIconColor;
+    }
+
+    return this.checked
+      ? this.checkedIconColor || this.iconColor
+      : this.uncheckedIconColor || this.iconColor;
+  }
+
+  @HostBinding("style")
+  get hostStyles(): Record<string, string> {
+    const styles: Record<string, string> = {};
+
+    if (this.color) {
+      styles["--cao-checkbox-color"] = this.color;
+    }
+    if (this.uncheckedColor) {
+      styles["--cao-checkbox-unselected"] = this.uncheckedColor;
+    }
+    if (this.disabledColor) {
+      styles["--cao-checkbox-disabled"] = this.disabledColor;
+    }
+    if (this.labelColor) {
+      styles["--cao-checkbox-label"] = this.labelColor;
+    }
+    if (this.disabledLabelColor) {
+      styles["--cao-checkbox-label-disabled"] = this.disabledLabelColor;
+    }
+    if (this.focusRingColor) {
+      styles["--cao-checkbox-focus-ring"] = this.focusRingColor;
+    }
+    if (this.size) {
+      styles["--cao-checkbox-size"] = this.size;
+    }
+    if (this.borderRadius) {
+      styles["--cao-checkbox-radius"] = this.borderRadius;
+    }
+    if (this.animationDuration) {
+      styles["--cao-checkbox-duration"] = this.animationDuration;
+    }
+    if (this.resolvedIconColor) {
+      styles["--cao-checkbox-icon-color"] = this.resolvedIconColor;
+    }
+
+    styles["--cao-checkbox-icon-size"] = this.toCssLength(this.iconSize);
+
+    return styles;
+  }
+
+  toggle(): void {
+    if (this.isDisabled) {
+      return;
+    }
+
+    this.setChecked(!this.checked, true);
+  }
+
+  setChecked(value: boolean, emit = true): void {
+    if (this.isDisabled) {
+      return;
+    }
+
+    const wasIndeterminate = this.indeterminate;
+
+    this.checked = value;
+    this.indeterminate = false;
+    this.onChange(value);
+
+    if (emit) {
+      this.checkedChange.emit(value);
+      this.checkboxChange.emit({ checked: value, source: this });
+    }
+
+    if (wasIndeterminate) {
+      this.indeterminateChange.emit(false);
+    }
+
+    this.cdr.markForCheck();
+  }
+
+  setIndeterminate(value: boolean): void {
+    if (this.isDisabled || this.indeterminate === value) {
+      return;
+    }
+
+    this.indeterminate = value;
+    this.indeterminateChange.emit(value);
+    this.cdr.markForCheck();
+  }
+
+  enable(): void {
+    this.isDisabled = false;
+    this.cdr.markForCheck();
+  }
+
+  disable(): void {
+    this.isDisabled = true;
+    this.cdr.markForCheck();
+  }
+
+  onInputChange(event: Event): void {
+    const target = event.target as HTMLInputElement;
+    this.setChecked(target.checked, true);
+  }
+
+  onBlur(): void {
+    this.onTouched();
+  }
+
+  writeValue(value: boolean | null): void {
+    this.checked = !!value;
+    this.cdr.markForCheck();
+  }
+
+  registerOnChange(fn: (value: boolean) => void): void {
+    this.onChange = fn;
+  }
+
+  registerOnTouched(fn: () => void): void {
+    this.onTouched = fn;
+  }
+
+  setDisabledState(isDisabled: boolean): void {
+    this.isDisabled = isDisabled;
+    this.cdr.markForCheck();
+  }
+
+  private toCssLength(value: string | number): string {
+    return typeof value === "number" ? `${value}px` : value;
+  }
+}

package/src/lib/shared/components/checkbox/checkbox.stories.ts

@@ -0,0 +1,240 @@
+import { FormsModule } from '@angular/forms';
+
+import {
+  LucideCheck,
+  LucideCircle,
+  LucideHeart,
+  LucideMinus,
+  LucideX,
+  provideLucideIcons,
+} from '@lucide/angular';
+import { applicationConfig, type Meta, type StoryObj } from '@storybook/angular-vite';
+import { fn } from 'storybook/test';
+
+import { CaoCheckboxComponent } from './checkbox.component';
+
+const imageIcon =
+  'data:image/svg+xml,%3Csvg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"%3E%3Ccircle cx="12" cy="12" r="8" fill="%234f46e5"/%3E%3C/svg%3E';
+
+const meta: Meta<CaoCheckboxComponent> = {
+  title: 'Componentes/Checkbox',
+  component: CaoCheckboxComponent,
+  tags: ['autodocs'],
+  decorators: [
+    applicationConfig({
+      providers: [
+        provideLucideIcons(
+          LucideCheck,
+          LucideMinus,
+          LucideX,
+          LucideCircle,
+          LucideHeart,
+        ),
+      ],
+    }),
+    (story) => ({
+      ...story,
+      moduleMetadata: {
+        imports: [FormsModule],
+      },
+    }),
+  ],
+  argTypes: {
+    checked: { control: 'boolean' },
+    indeterminate: { control: 'boolean' },
+    isDisabled: { control: 'boolean' },
+    disabled: { control: 'boolean' },
+    required: { control: 'boolean' },
+    label: { control: 'text' },
+    labelPosition: { control: 'select', options: ['before', 'after'] },
+    name: { control: 'text' },
+    id: { control: 'text' },
+    ariaLabel: { control: 'text' },
+    ariaLabelledBy: { control: 'text' },
+    dataCy: { control: 'text' },
+    color: { control: 'color' },
+    uncheckedColor: { control: 'color' },
+    disabledColor: { control: 'color' },
+    labelColor: { control: 'color' },
+    disabledLabelColor: { control: 'color' },
+    focusRingColor: { control: 'color' },
+    size: { control: 'text' },
+    borderRadius: { control: 'text' },
+    animationDuration: { control: 'text' },
+    checkedIcon: { control: 'text' },
+    uncheckedIcon: { control: 'text' },
+    indeterminateIcon: { control: 'text' },
+    isLucideIcon: { control: 'boolean' },
+    iconColor: { control: 'color' },
+    checkedIconColor: { control: 'color' },
+    uncheckedIconColor: { control: 'color' },
+    iconSize: { control: 'text' },
+    iconStrokeWidth: { control: 'text' },
+  },
+  args: {
+    checked: false,
+    indeterminate: false,
+    isDisabled: false,
+    required: false,
+    label: 'Aceito os termos',
+    labelPosition: 'after',
+    checkedIcon: '',
+    uncheckedIcon: '',
+    indeterminateIcon: '',
+    isLucideIcon: false,
+    iconColor: '',
+    checkedIconColor: '',
+    uncheckedIconColor: '',
+    iconSize: 14,
+    iconStrokeWidth: 2.5,
+    checkedChange: fn(),
+    indeterminateChange: fn(),
+    checkboxChange: fn(),
+  },
+  render: (args) => ({
+    props: args,
+    template: `
+      <cao-checkbox
+        [(ngModel)]="checked"
+        [indeterminate]="indeterminate"
+        [isDisabled]="isDisabled"
+        [required]="required"
+        [label]="label"
+        [labelPosition]="labelPosition"
+        [name]="name"
+        [id]="id"
+        [ariaLabel]="ariaLabel"
+        [ariaLabelledBy]="ariaLabelledBy"
+        [dataCy]="dataCy"
+        [color]="color"
+        [uncheckedColor]="uncheckedColor"
+        [disabledColor]="disabledColor"
+        [labelColor]="labelColor"
+        [disabledLabelColor]="disabledLabelColor"
+        [focusRingColor]="focusRingColor"
+        [size]="size"
+        [borderRadius]="borderRadius"
+        [animationDuration]="animationDuration"
+        [checkedIcon]="checkedIcon"
+        [uncheckedIcon]="uncheckedIcon"
+        [indeterminateIcon]="indeterminateIcon"
+        [isLucideIcon]="isLucideIcon"
+        [iconColor]="iconColor"
+        [checkedIconColor]="checkedIconColor"
+        [uncheckedIconColor]="uncheckedIconColor"
+        [iconSize]="iconSize"
+        [iconStrokeWidth]="iconStrokeWidth"
+        (checkedChange)="checkedChange($event)"
+        (indeterminateChange)="indeterminateChange($event)"
+        (checkboxChange)="checkboxChange($event)">
+      </cao-checkbox>
+    `,
+  }),
+};
+
+export default meta;
+type Story = StoryObj<CaoCheckboxComponent>;
+
+export const Padrao: Story = {};
+
+export const Marcado: Story = {
+  args: {
+    checked: true,
+  },
+};
+
+export const Indeterminado: Story = {
+  args: {
+    indeterminate: true,
+  },
+};
+
+export const Desabilitado: Story = {
+  args: {
+    isDisabled: true,
+  },
+};
+
+export const DesabilitadoMarcado: Story = {
+  args: {
+    checked: true,
+    isDisabled: true,
+  },
+};
+
+export const LabelAntes: Story = {
+  args: {
+    checked: true,
+    labelPosition: 'before',
+  },
+};
+
+export const Obrigatorio: Story = {
+  args: {
+    required: true,
+    label: 'Campo obrigatório',
+  },
+};
+
+export const CoresCustomizadas: Story = {
+  args: {
+    checked: true,
+    label: 'Cores customizadas',
+    color: '#16a34a',
+    uncheckedColor: '#94a3b8',
+    labelColor: '#166534',
+    focusRingColor: 'rgba(22, 163, 74, 0.35)',
+  },
+};
+
+export const TamanhoCustomizado: Story = {
+  args: {
+    checked: true,
+    label: 'Tamanho customizado',
+    size: '28px',
+    borderRadius: '8px',
+    animationDuration: '300ms',
+    iconSize: 20,
+    iconStrokeWidth: 3,
+  },
+};
+
+export const IconesLucide: Story = {
+  args: {
+    checked: true,
+    label: 'Ícones Lucide',
+    checkedIcon: 'check',
+    uncheckedIcon: 'x',
+    indeterminateIcon: 'minus',
+    isLucideIcon: true,
+    checkedIconColor: '#ffffff',
+    uncheckedIconColor: '#6b7280',
+    iconSize: 14,
+    iconStrokeWidth: 2.5,
+  },
+};
+
+export const IconesCustomizados: Story = {
+  args: {
+    checked: true,
+    label: 'Ícones customizados',
+    checkedIcon: 'heart',
+    uncheckedIcon: 'circle',
+    isLucideIcon: true,
+    checkedIconColor: '#ffffff',
+    uncheckedIconColor: '#db2777',
+    color: '#db2777',
+    uncheckedColor: '#f9a8d4',
+  },
+};
+
+export const IconeImagem: Story = {
+  args: {
+    checked: true,
+    label: 'Ícone via URL/data URI',
+    checkedIcon: imageIcon,
+    uncheckedIcon: imageIcon,
+    isLucideIcon: false,
+    iconSize: 12,
+  },
+};

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

@@ -27,4 +27,8 @@ 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 "./checkbox/checkbox.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>