@muxima-ui/core 1.1.0 → 1.3.0

package/styles/components/sidebar.css

@@ -0,0 +1,211 @@
+/* ---------- Sidebar ---------- */
+
+.mx-sidebar {
+  --mx-sidebar-width: 248px;
+  --mx-sidebar-collapsed-width: 60px;
+  display: flex;
+  flex-direction: column;
+  gap: 16px;
+  box-sizing: border-box;
+  width: var(--mx-sidebar-width);
+  height: 100%;
+  padding: 16px 10px;
+  border-right: var(--mx-border);
+  background: var(--mx-surface);
+  color: var(--mx-ink);
+  font-family: var(--mx-font-sans);
+  overflow: hidden;
+  transition: width var(--mx-duration) var(--mx-ease);
+}
+.mx-sidebar[data-variant='subtle'] {
+  background: var(--mx-paper);
+}
+.mx-sidebar[data-collapsed] {
+  width: var(--mx-sidebar-collapsed-width);
+}
+.mx-sidebar-header,
+.mx-sidebar-footer {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  min-height: 32px;
+  padding: 0 6px;
+  white-space: nowrap;
+}
+.mx-sidebar-footer {
+  margin-top: auto;
+}
+.mx-sidebar-nav {
+  display: flex;
+  flex: 1;
+  flex-direction: column;
+  gap: 16px;
+  min-height: 0;
+  overflow-x: hidden;
+  overflow-y: auto;
+}
+.mx-sidebar-group {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+}
+.mx-sidebar-group-label {
+  margin: 0;
+  padding: 0 10px;
+  color: var(--mx-muted);
+  font-size: var(--mx-text-xs);
+  font-weight: 600;
+  letter-spacing: 0.04em;
+  text-transform: uppercase;
+  white-space: nowrap;
+}
+.mx-sidebar-list {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+  margin: 0;
+  padding: 0;
+  list-style: none;
+}
+.mx-sidebar-sublist {
+  padding-left: 22px;
+}
+.mx-sidebar-sublist[hidden] {
+  display: none;
+}
+.mx-sidebar-item {
+  position: relative;
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  box-sizing: border-box;
+  width: 100%;
+  min-height: 36px;
+  padding: 0 10px;
+  border: 0;
+  border-radius: var(--mx-radius);
+  background: transparent;
+  color: var(--mx-muted);
+  font: inherit;
+  font-size: var(--mx-text-md);
+  font-weight: 500;
+  text-align: start;
+  text-decoration: none;
+  white-space: nowrap;
+  cursor: pointer;
+  transition: background var(--mx-duration) var(--mx-ease), color var(--mx-duration) var(--mx-ease);
+}
+.mx-sidebar-item:is(:hover, [data-mx-state='hover']) {
+  background: var(--mx-subtle);
+  color: var(--mx-ink);
+}
+.mx-sidebar-item:is([aria-current='page'], [data-active]) {
+  background: var(--mx-accent-soft);
+  color: var(--mx-accent);
+}
+.mx-sidebar-item:is([aria-current='page'], [data-active])::before {
+  content: '';
+  position: absolute;
+  top: 8px;
+  bottom: 8px;
+  left: -10px;
+  width: 3px;
+  border-radius: 0 3px 3px 0;
+  background: var(--mx-accent);
+}
+.mx-sidebar-icon {
+  flex-shrink: 0;
+  width: 18px;
+  height: 18px;
+}
+.mx-sidebar-label {
+  flex: 1;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.mx-sidebar-badge {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  min-width: 20px;
+  height: 20px;
+  padding: 0 6px;
+  box-sizing: border-box;
+  border-radius: 999px;
+  background: var(--mx-subtle);
+  color: var(--mx-ink);
+  font-size: var(--mx-text-xs);
+  font-weight: 600;
+  font-variant-numeric: tabular-nums;
+}
+.mx-sidebar-item[aria-current='page'] .mx-sidebar-badge {
+  background: var(--mx-accent);
+  color: var(--mx-on-accent);
+}
+.mx-sidebar-chevron {
+  flex-shrink: 0;
+  width: 14px;
+  height: 14px;
+  transition: transform var(--mx-duration) var(--mx-ease);
+}
+.mx-sidebar-section-trigger[aria-expanded='true'] .mx-sidebar-chevron {
+  transform: rotate(90deg);
+}
+.mx-sidebar-toggle:not(.mx-button) {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 32px;
+  height: 32px;
+  padding: 0;
+  border: 0;
+  border-radius: var(--mx-radius);
+  background: transparent;
+  color: var(--mx-muted);
+  cursor: pointer;
+}
+.mx-sidebar-toggle:not(.mx-button):hover {
+  background: var(--mx-subtle);
+  color: var(--mx-ink);
+}
+.mx-sidebar-toggle svg {
+  width: 18px;
+  height: 18px;
+}
+
+/* recolhida: os nomes ficam para o leitor de ecrã */
+.mx-sidebar[data-collapsed] :is(.mx-sidebar-label, .mx-sidebar-group-label, .mx-sidebar-chevron) {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  overflow: hidden;
+  clip-path: inset(50%);
+  white-space: nowrap;
+}
+.mx-sidebar[data-collapsed] .mx-sidebar-item {
+  justify-content: center;
+  padding: 0;
+}
+.mx-sidebar[data-collapsed] .mx-sidebar-badge {
+  position: absolute;
+  top: 5px;
+  right: 7px;
+  min-width: 8px;
+  width: 8px;
+  height: 8px;
+  padding: 0;
+  overflow: hidden;
+  background: var(--mx-danger);
+  color: transparent;
+}
+.mx-sidebar[data-collapsed] .mx-sidebar-header,
+.mx-sidebar[data-collapsed] .mx-sidebar-footer {
+  justify-content: center;
+}
+.mx-sidebar-tip {
+  position: fixed;
+  z-index: 1000;
+  transform: translateY(-50%);
+  pointer-events: none;
+  white-space: nowrap;
+}

package/styles/components/timeline.css

@@ -0,0 +1,180 @@
+/* ---------- Timeline ---------- */
+
+.mx-timeline {
+  --_dot: 12px;
+  --_gap: 20px;
+  --_line: var(--mx-stone);
+  display: flex;
+  flex-direction: column;
+  margin: 0;
+  padding: 0;
+  color: var(--mx-ink);
+  font-family: var(--mx-font-sans);
+  list-style: none;
+}
+.mx-timeline[data-size='sm'] {
+  --_dot: 10px;
+  --_gap: 14px;
+}
+.mx-timeline-item {
+  --_tone: var(--mx-stone-strong);
+  --_marker: var(--_dot);
+  position: relative;
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+  min-height: 24px;
+  padding: 0 0 var(--_gap) calc(var(--_marker) + 16px);
+}
+.mx-timeline-item[data-has-icon] {
+  --_marker: 28px;
+}
+.mx-timeline-item:last-child {
+  padding-bottom: 0;
+}
+/* marcador */
+.mx-timeline-item::before {
+  content: '';
+  position: absolute;
+  top: 4px;
+  left: 0;
+  box-sizing: border-box;
+  width: var(--_marker);
+  height: var(--_marker);
+  border: 2px solid var(--_tone);
+  border-radius: 50%;
+  background: var(--mx-surface);
+}
+.mx-timeline-item[data-has-icon]::before {
+  top: 0;
+  border-width: 1px;
+  background: color-mix(in oklab, var(--_tone) 12%, var(--mx-surface));
+}
+.mx-timeline-item:not([data-has-icon]):not([data-pending])::before {
+  background: var(--_tone);
+}
+/* linha até ao item seguinte */
+.mx-timeline-item:not(:last-child)::after {
+  content: '';
+  position: absolute;
+  top: calc(var(--_marker) + 8px);
+  bottom: 4px;
+  left: calc(var(--_marker) / 2 - 1px);
+  width: 2px;
+  border-radius: 1px;
+  background: var(--_line);
+}
+.mx-timeline-item[data-has-icon]:not(:last-child)::after {
+  top: calc(var(--_marker) + 4px);
+}
+.mx-timeline-item[data-variant='accent'] {
+  --_tone: var(--mx-accent);
+}
+.mx-timeline-item[data-variant='success'] {
+  --_tone: var(--mx-success);
+}
+.mx-timeline-item[data-variant='warning'] {
+  --_tone: var(--mx-warning);
+}
+.mx-timeline-item[data-variant='danger'] {
+  --_tone: var(--mx-danger);
+}
+.mx-timeline-item[data-pending]::before {
+  border-style: dashed;
+  border-color: var(--mx-stone-strong);
+}
+.mx-timeline-item[data-pending] .mx-timeline-title {
+  color: var(--mx-muted);
+}
+.mx-timeline-icon {
+  position: absolute;
+  top: 6px;
+  left: 6px;
+  width: 16px;
+  height: 16px;
+  color: var(--_tone);
+}
+.mx-timeline-time {
+  order: -1;
+  color: var(--mx-muted);
+  font-size: var(--mx-text-xs);
+  font-variant-numeric: tabular-nums;
+}
+.mx-timeline-title {
+  margin: 0;
+  font-size: var(--mx-text-md);
+  font-weight: 600;
+  line-height: 1.35;
+}
+.mx-timeline[data-size='sm'] .mx-timeline-title {
+  font-size: var(--mx-text-sm);
+}
+.mx-timeline-description {
+  margin: 0;
+  color: var(--mx-muted);
+  font-size: var(--mx-text-sm);
+  line-height: 1.45;
+}
+
+/* horizontal */
+.mx-timeline[data-orientation='horizontal'] {
+  flex-direction: row;
+  overflow-x: auto;
+  border-radius: var(--mx-radius);
+}
+.mx-timeline[data-orientation='horizontal']:focus-visible {
+  outline: var(--mx-focus-width) solid var(--mx-accent);
+  outline-offset: var(--mx-focus-offset);
+}
+.mx-timeline[data-orientation='horizontal'] .mx-timeline-item {
+  flex: 1 0 140px;
+  padding: calc(var(--_marker) + 14px) var(--_gap) 4px 0;
+}
+.mx-timeline[data-orientation='horizontal'] .mx-timeline-item::before {
+  top: 0;
+}
+.mx-timeline[data-orientation='horizontal'] .mx-timeline-item:not(:last-child)::after {
+  top: calc(var(--_marker) / 2 - 1px);
+  bottom: auto;
+  left: calc(var(--_marker) + 6px);
+  right: 6px;
+  width: auto;
+  height: 2px;
+}
+
+/* alternado (ecrãs largos) */
+@media (min-width: 720px) {
+  .mx-timeline[data-align='alternate']:not([data-orientation='horizontal']) .mx-timeline-item {
+    width: 50%;
+    box-sizing: border-box;
+    margin-left: 50%;
+    padding-left: calc(var(--_marker) / 2 + 16px);
+  }
+  .mx-timeline[data-align='alternate']:not([data-orientation='horizontal']) .mx-timeline-item::before {
+    left: calc(var(--_marker) / -2);
+  }
+  .mx-timeline[data-align='alternate']:not([data-orientation='horizontal']) .mx-timeline-item::after {
+    left: -1px;
+  }
+  .mx-timeline[data-align='alternate']:not([data-orientation='horizontal']) .mx-timeline-item .mx-timeline-icon {
+    left: calc(var(--_marker) / -2 + 6px);
+  }
+  .mx-timeline[data-align='alternate']:not([data-orientation='horizontal']) .mx-timeline-item:nth-child(even) {
+    margin-left: 0;
+    padding-left: 0;
+    padding-right: calc(var(--_marker) / 2 + 16px);
+    text-align: end;
+  }
+  .mx-timeline[data-align='alternate']:not([data-orientation='horizontal']) .mx-timeline-item:nth-child(even)::before {
+    left: auto;
+    right: calc(var(--_marker) / -2);
+  }
+  .mx-timeline[data-align='alternate']:not([data-orientation='horizontal']) .mx-timeline-item:nth-child(even)::after {
+    left: auto;
+    right: -1px;
+  }
+  .mx-timeline[data-align='alternate']:not([data-orientation='horizontal']) .mx-timeline-item:nth-child(even) .mx-timeline-icon {
+    left: auto;
+    right: calc(var(--_marker) / -2 + 6px);
+  }
+}

package/styles/muxima.css

@@ -23,12 +23,17 @@
 @import './components/slider.css';
 @import './components/dialog.css';
 @import './components/tabs.css';
+@import './components/sidebar.css';
 @import './components/table.css';
+@import './components/data-grid.css';
+@import './components/kanban.css';
 @import './components/badge.css';
 @import './components/chips.css';
 @import './components/card.css';
 @import './components/alert.css';
 @import './components/separator.css';
+@import './components/timeline.css';
+@import './components/carousel.css';
 @import './components/rating.css';
 @import './components/clipboard.css';
 @import './components/avatar.css';
@@ -39,14 +44,18 @@
 @import './components/menu.css';
 @import './components/drawer.css';
 @import './components/toast.css';
+@import './components/notification-center.css';
 @import './components/accordion.css';
 @import './components/breadcrumb.css';
 @import './components/pagination.css';
 @import './components/combobox.css';
 @import './components/date-picker.css';
 @import './components/time-picker.css';
+@import './components/color-picker.css';
+@import './components/editor.css';
 @import './components/otp.css';
 @import './components/file-upload.css';
+@import './components/image-cropper.css';
 @import './components/stepper.css';
 @import './components/command.css';
 @import './motion.css';

package/types/muxima-ui-core-carousel.d.ts

@@ -0,0 +1,72 @@
+import * as _angular_core from '@angular/core';
+
+/** Um diapositivo. O carrossel dá-lhe o nome "2 de 5" e tira do teclado os que não se vêem. */
+declare class MxCarouselSlide {
+    /** Nome próprio do diapositivo; por omissão "2 de 5". */
+    readonly label: _angular_core.InputSignal<string>;
+    protected readonly carousel: any;
+    readonly el: HTMLElement;
+    protected readonly index: _angular_core.Signal<any>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MxCarouselSlide, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MxCarouselSlide, "mx-carousel-slide", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+/**
+ * Carrossel acessível (padrão WAI-ARIA Carousel): botões anterior e seguinte, indicadores,
+ * deslizar com o dedo (scroll nativo com snap) e, opcionalmente, rotação automática com
+ * botão de pausa. A rotação pára com o rato ou o foco dentro e não arranca com
+ * "reduzir movimento" activo.
+ *
+ * ```html
+ * <mx-carousel aria-label="Novidades" [perView]="1" [autoplay]="6000">
+ *   <mx-carousel-slide>...</mx-carousel-slide>
+ *   <mx-carousel-slide>...</mx-carousel-slide>
+ * </mx-carousel>
+ * ```
+ */
+declare class MxCarousel {
+    /** Índice do primeiro diapositivo visível. */
+    readonly index: _angular_core.ModelSignal<number>;
+    /** Diapositivos visíveis de cada vez. */
+    readonly perView: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Espaço entre diapositivos, em px. */
+    readonly gap: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Ms entre diapositivos; 0 = sem rotação automática. */
+    readonly autoplay: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Depois do último volta ao primeiro. */
+    readonly loop: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly indicators: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Botões anterior e seguinte. Sem eles, dá à pessoa outra forma de mudar ([(index)]). */
+    readonly controls: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly prevLabel: _angular_core.InputSignal<string>;
+    readonly nextLabel: _angular_core.InputSignal<string>;
+    readonly slides: _angular_core.Signal<readonly MxCarouselSlide[]>;
+    private readonly viewport;
+    private readonly reducedMotion;
+    protected readonly hovering: _angular_core.WritableSignal<boolean>;
+    protected readonly focused: _angular_core.WritableSignal<boolean>;
+    /** Rotação ligada pela pessoa (botão de pausa). */
+    readonly playing: _angular_core.WritableSignal<boolean>;
+    /** A rodar agora: ligada, sem rato nem foco dentro, e sem reduzir movimento. */
+    protected readonly running: _angular_core.Signal<boolean>;
+    protected readonly lastIndex: _angular_core.Signal<number>;
+    protected readonly pages: _angular_core.Signal<number[]>;
+    private scrollFrame;
+    private scrolling;
+    /** O índice mudou porque a pessoa deslizou: não volta a mexer no scroll. */
+    private fromScroll;
+    private readonly injector;
+    constructor();
+    slideLabel(i: number): string;
+    isVisible(i: number): boolean;
+    go(i: number): void;
+    next(auto?: boolean): void;
+    prev(): void;
+    togglePlay(): void;
+    protected onFocusOut(event: FocusEvent): void;
+    private scrollTo;
+    protected onScroll(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MxCarousel, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MxCarousel, "mx-carousel", ["mxCarousel"], { "index": { "alias": "index"; "required": false; "isSignal": true; }; "perView": { "alias": "perView"; "required": false; "isSignal": true; }; "gap": { "alias": "gap"; "required": false; "isSignal": true; }; "autoplay": { "alias": "autoplay"; "required": false; "isSignal": true; }; "loop": { "alias": "loop"; "required": false; "isSignal": true; }; "indicators": { "alias": "indicators"; "required": false; "isSignal": true; }; "controls": { "alias": "controls"; "required": false; "isSignal": true; }; "prevLabel": { "alias": "prevLabel"; "required": false; "isSignal": true; }; "nextLabel": { "alias": "nextLabel"; "required": false; "isSignal": true; }; }, { "index": "indexChange"; }, ["slides"], ["*"], true, never>;
+}
+
+export { MxCarousel, MxCarouselSlide };

package/types/muxima-ui-core-color-picker.d.ts

@@ -0,0 +1,153 @@
+import * as _angular_core from '@angular/core';
+import { ConnectedPosition } from '@angular/cdk/overlay';
+import { ControlValueAccessor } from '@angular/forms';
+import { MxFormFieldControl, MxFormField } from '@muxima-ui/core/form-field';
+
+/** Cor em HSV (h 0–360, s e v 0–1) com opacidade a 0–1. */
+interface MxHsva {
+    h: number;
+    s: number;
+    v: number;
+    a: number;
+}
+/**
+ * Lê uma cor escrita: "#1f6f78", "1f6f78", "#1f6", "#1f6f7880" ou "rgb(31, 111, 120)" / "rgba(...)".
+ * Devolve o hex normalizado ("#1F6F78" ou "#1F6F7880" com opacidade) ou null.
+ */
+declare function mxParseColor(text: string): string | null;
+declare function mxHexToRgba(hex: string): {
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+};
+declare function mxHexToHsva(hex: string): MxHsva;
+declare function mxHsvaToHex({ h, s, v, a }: MxHsva): string;
+/** Contraste WCAG entre duas cores (1 a 21). */
+declare function mxContrast(a: string, b: string): number;
+/** Nome aproximado da cor em português, para o leitor de ecrã: "azul escuro", "cinzento claro". */
+declare function mxColorName(hex: string): string;
+
+/** Amostra pronta: só a cor, ou cor e nome. */
+type MxColorSwatch = string | {
+    color: string;
+    label: string;
+};
+/**
+ * Editor de cor: área de saturação e brilho, matiz, opacidade opcional, campo hex,
+ * amostras e conta-gotas (quando o navegador o tem). O valor é um hex ("#1F6F78",
+ * ou "#1F6F7880" com opacidade).
+ *
+ * ```html
+ * <mx-color-panel [(value)]="cor" [swatches]="marca" />
+ * ```
+ *
+ * Teclado na área: ← → mudam a saturação, ↑ ↓ o brilho (Shift para passos de 10).
+ * A matiz e a opacidade são input range nativos.
+ */
+declare class MxColorPanel {
+    readonly value: _angular_core.ModelSignal<string | null>;
+    /** Mostra o controlo de opacidade e devolve hex de 8 dígitos quando < 100%. */
+    readonly alpha: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly swatches: _angular_core.InputSignal<MxColorSwatch[]>;
+    readonly showInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Só as amostras: uma paleta fechada, sem área nem matiz. */
+    readonly swatchesOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly areaLabel: _angular_core.InputSignal<string>;
+    readonly hueLabel: _angular_core.InputSignal<string>;
+    readonly alphaLabel: _angular_core.InputSignal<string>;
+    readonly swatchesLabel: _angular_core.InputSignal<string>;
+    /** Emite ao largar o rato, escolher amostra ou terminar de escrever (para guardar). */
+    readonly committed: _angular_core.OutputEmitterRef<string>;
+    private readonly area;
+    protected readonly inputId: string;
+    protected readonly eyeDropper: boolean;
+    /** HSVA interno: guarda a matiz quando a cor é cinzenta (o hex não a tem). */
+    protected readonly hsva: _angular_core.WritableSignal<MxHsva>;
+    protected readonly hex: _angular_core.Signal<string>;
+    protected readonly opaque: _angular_core.Signal<string>;
+    protected readonly draft: _angular_core.WritableSignal<string | null>;
+    protected readonly draftInvalid: _angular_core.Signal<boolean>;
+    protected readonly hueName: _angular_core.Signal<string>;
+    protected readonly areaText: _angular_core.Signal<string>;
+    protected readonly swatchList: _angular_core.Signal<{
+        color: string;
+        label: string;
+    }[]>;
+    constructor();
+    protected round(n: number): number;
+    protected pct(n: number): number;
+    private update;
+    setHex(hex: string): void;
+    protected setHue(e: Event): void;
+    protected setAlpha(e: Event): void;
+    protected onHexInput(e: Event): void;
+    protected onAreaKey(e: KeyboardEvent): void;
+    protected onAreaDown(e: PointerEvent): void;
+    protected pickFromScreen(): Promise<void>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MxColorPanel, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MxColorPanel, "mx-color-panel", ["mxColorPanel"], { "value": { "alias": "value"; "required": false; "isSignal": true; }; "alpha": { "alias": "alpha"; "required": false; "isSignal": true; }; "swatches": { "alias": "swatches"; "required": false; "isSignal": true; }; "showInput": { "alias": "showInput"; "required": false; "isSignal": true; }; "swatchesOnly": { "alias": "swatchesOnly"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "areaLabel": { "alias": "areaLabel"; "required": false; "isSignal": true; }; "hueLabel": { "alias": "hueLabel"; "required": false; "isSignal": true; }; "alphaLabel": { "alias": "alphaLabel"; "required": false; "isSignal": true; }; "swatchesLabel": { "alias": "swatchesLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "committed": "committed"; }, never, never, true, never>;
+}
+
+/**
+ * Campo de cor: escreve-se o hex (ou rgb()) ou escolhe-se no painel que abre no botão
+ * da amostra. Funciona com ngModel e Reactive Forms; o valor é um hex ou null.
+ *
+ * ```html
+ * <mx-form-field>
+ *   <label mxLabel>Cor da marca</label>
+ *   <mx-color-picker formControlName="cor" [swatches]="sugestoes" />
+ * </mx-form-field>
+ * ```
+ */
+declare class MxColorPicker implements ControlValueAccessor, MxFormFieldControl {
+    readonly value: _angular_core.ModelSignal<string | null>;
+    readonly alpha: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly swatches: _angular_core.InputSignal<MxColorSwatch[]>;
+    readonly placeholder: _angular_core.InputSignal<string>;
+    readonly dialogLabel: _angular_core.InputSignal<string>;
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly size: _angular_core.InputSignal<"sm" | "md" | "lg">;
+    readonly id: _angular_core.InputSignal<string | undefined>;
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
+    protected readonly field: MxFormField | null;
+    private readonly ngControl;
+    private readonly host;
+    private readonly toggleButton;
+    private readonly panel;
+    protected readonly positions: ConnectedPosition[];
+    private readonly generatedId;
+    readonly controlId: _angular_core.Signal<string>;
+    protected readonly isOpen: _angular_core.WritableSignal<boolean>;
+    protected readonly draft: _angular_core.WritableSignal<string | null>;
+    private readonly formDisabled;
+    protected readonly isDisabled: _angular_core.Signal<boolean>;
+    readonly badFormat: _angular_core.Signal<boolean>;
+    protected readonly toggleLabel: _angular_core.Signal<string>;
+    private onChange;
+    private onTouched;
+    constructor();
+    open(): void;
+    toggle(): void;
+    close(restoreFocus?: boolean): void;
+    protected onAttach(): void;
+    protected onOverlayKey(e: KeyboardEvent): void;
+    protected onOutside(e: MouseEvent): void;
+    protected setValue(v: string | null): void;
+    protected onInput(e: Event): void;
+    protected onBlur(): void;
+    errorState(): boolean;
+    isRequired(): boolean;
+    writeValue(value: string | null): void;
+    registerOnChange(fn: (value: string | null) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MxColorPicker, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MxColorPicker, "mx-color-picker", ["mxColorPicker"], { "value": { "alias": "value"; "required": false; "isSignal": true; }; "alpha": { "alias": "alpha"; "required": false; "isSignal": true; }; "swatches": { "alias": "swatches"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "dialogLabel": { "alias": "dialogLabel"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
+}
+
+export { MxColorPanel, MxColorPicker, mxColorName, mxContrast, mxHexToHsva, mxHexToRgba, mxHsvaToHex, mxParseColor };
+export type { MxColorSwatch, MxHsva };