@malva-ui/core 0.1.12

package/color-picker/lib/color-picker-popup/color-picker-popup.d.ts

@@ -0,0 +1,151 @@
+import type { Signal } from '@angular/core';
+import type { BooleanInput } from '@angular/cdk/coercion';
+import { MlvSignalFormControlBase } from '@malva-ui/core/form-utils';
+import type { MlvColorInputMode } from '../color-utils/color-utils';
+import * as i0 from "@angular/core";
+/**
+ * Input-like CSS color control that opens the full `mlv-color-picker` in a
+ * connected popup with a light-dismiss backdrop.
+ *
+ * The editable draft stays separate from the committed forms value. Valid
+ * concrete colors and `var(--custom-property)` references commit on blur or
+ * popup close by default; `live` publishes every valid draft immediately.
+ * Invalid drafts roll back to the most recent valid draft.
+ */
+export declare class MlvColorPickerPopup extends MlvSignalFormControlBase<string> {
+    /** The committed CSS color string used by all Angular forms APIs. */
+    readonly value: import("@angular/core").ModelSignal<string>;
+    /** Visual trigger presentation. Field mode preserves the input-like control. */
+    readonly presentation: import("@angular/core").InputSignal<"field" | "swatch" | "icon">;
+    /** Two-way bindable connected-overlay state. */
+    readonly opened: import("@angular/core").ModelSignal<boolean>;
+    /** Emits after the detached picker panel has opened. */
+    readonly afterOpened: import("@angular/core").OutputEmitterRef<void>;
+    /** Emits after the detached picker panel has closed and torn down. */
+    readonly afterClosed: import("@angular/core").OutputEmitterRef<void>;
+    /** Whether to show the opacity slider inside the picker. */
+    readonly showOpacity: import("@angular/core").InputSignalWithTransform<boolean, BooleanInput>;
+    /** The default input mode for the picker's text tabs. */
+    readonly defaultMode: import("@angular/core").InputSignal<MlvColorInputMode>;
+    /** Available picker formats, in display order. */
+    readonly supportedFormats: import("@angular/core").InputSignal<readonly MlvColorInputMode[]>;
+    /** Whether every valid draft is published immediately. */
+    readonly live: import("@angular/core").InputSignalWithTransform<boolean, BooleanInput>;
+    /** Emits when user interaction commits a new CSS color string. */
+    readonly colorChange: import("@angular/core").OutputEmitterRef<string>;
+    /** Whether the committed value is non-empty and can be cleared. */
+    readonly hasValue: Signal<boolean>;
+    /**
+     * Suppresses the wrapper-owned clear affordance while readonly. Disabled
+     * wrappers already suppress pointer interaction through their shared state.
+     */
+    readonly ownsClearButton: Signal<boolean>;
+    /** @protected Injected i18n translations for the color picker. */
+    protected readonly _i18n: Signal<import("@malva-ui/i18n").MlvColorPickerI18n>;
+    /** @protected Localized copy used by the swatch-mode clear action. */
+    protected readonly _formI18n: Signal<import("@malva-ui/i18n").MlvFormUtilsI18n>;
+    /** @private Resolver for ICU parameterized i18n strings. */
+    private readonly _resolver;
+    /** @protected Whether the connected popup is open. */
+    /** Keep the wrapper focus treatment active while its popup is visible. */
+    readonly focused: Signal<boolean>;
+    /** @protected Editable text that has not necessarily been committed. */
+    protected readonly _draftValue: import("@angular/core").WritableSignal<string>;
+    /** @private Most recent valid draft used for invalid-input rollback. */
+    private readonly _lastValidDraft;
+    /** @protected Concrete color used to initialize the visual picker. */
+    protected readonly _pickerValue: import("@angular/core").WritableSignal<string>;
+    /** @protected Stable id linked from the input's `aria-controls`. */
+    protected readonly _panelId: string;
+    /** @protected Stable id used by the input's `aria-describedby`. */
+    /**
+     * @protected Resolved accessible name for the swatch button, e.g.
+     * "Pick color: #ff0000".
+     */
+    protected readonly _pickColorLabel: Signal<string>;
+    /** @private Native input used for synchronous rollback of invalid drafts. */
+    private readonly _inputRef;
+    /** @private Rounded color square used for computed CSS-variable resolution. */
+    private readonly _fieldSwatchColorRef;
+    /** @private Swatch-only presentation color layer. */
+    private readonly _swatchTriggerColorRef;
+    /** @private Field-mode swatch button used for keyboard focus restoration. */
+    private readonly _fieldSwatchButtonRef;
+    /** @private Swatch-mode Malva trigger used by detached composition. */
+    private readonly _swatchTriggerRef;
+    /** @private Field-mode detached picker surface. */
+    private readonly _fieldPanelRef;
+    /** @private Swatch-mode detached picker surface. */
+    private readonly _swatchPanelRef;
+    /** Public trigger element for toolbar/composite registration. */
+    readonly triggerElement: Signal<HTMLElement | null>;
+    /** Public detached panel element for overlay ownership registration. */
+    readonly panelElement: Signal<HTMLElement | null>;
+    /** @private Locates the first tabbable picker control for keyboard opening. */
+    private readonly _tabbable;
+    /** @private Whether the next completed close should restore swatch focus. */
+    private _restoreSwatchFocus;
+    /** @private Whether `afterOpened` should transfer focus into the picker. */
+    private _focusPickerAfterOpen;
+    /** @private Whether the shared overlay is attached or playing its leave animation. */
+    private _popupAttached;
+    /** @private Previous open state used to detect every close request once. */
+    private _wasOpen;
+    /** @private Reopens after a click/focus that occurs during the leave animation. */
+    private _reopenAfterClose;
+    constructor();
+    /** @protected Stores text input without publishing a partial forms value. */
+    protected _onInput(event: Event): void;
+    /** @protected Opens the popup when the editable field receives focus. */
+    protected _onInputFocus(): void;
+    /**
+     * @protected Reopens after Escape when the input retained focus (and thus
+     * cannot emit another native focus event).
+     */
+    protected _onInputClick(): void;
+    /** @protected Commits or rolls back the draft when focus leaves the input. */
+    protected _onInputBlur(): void;
+    /** @protected Closes the popup from the input on Escape. */
+    protected _onInputKeydown(event: KeyboardEvent): void;
+    /**
+     * @protected Opens from the rounded square. Keyboard activation opts into
+     * focus transfer; pointer activation leaves focus on the trigger.
+     */
+    protected _openFromSwatch(focusPicker?: boolean): void;
+    /** @private Opens the connected popup and refreshes the picker's color. */
+    private _open;
+    /** @protected Performs post-attach focus work requested by keyboard opening. */
+    protected _onPopupOpened(): void;
+    /** @protected Restores swatch focus only for keyboard/panel close flows. */
+    protected _onPopupClosed(): void;
+    /** @protected Closes from the panel and commits the current draft. */
+    protected _onPanelEscape(event: Event): void;
+    /** @protected Clears the committed forms value through the shared X button. */
+    protected _clearValue(): void;
+    /** @protected Updates the picker draft and optionally publishes it live. */
+    protected _onColorChange(cssColor: string): void;
+    /** @private Commits valid/empty input or the most recent valid draft. */
+    private _commitDraft;
+    /**
+     * @private Restores local state from the committed value without publishing.
+     */
+    private _restoreCommittedValue;
+    /** @private Synchronizes all visual draft consumers without committing. */
+    private _setDraftValue;
+    /** @private Publishes one committed user change across forms and output. */
+    private _commitValue;
+    /**
+     * @private Initializes the visual picker without replacing the committed
+     * source string. Concrete formats pass through. CSS variables are resolved
+     * from the swatch's computed background in the trigger's cascade.
+     */
+    private _syncPickerValue;
+    /** @private Moves focus into the picker after a keyboard swatch activation. */
+    private _focusPicker;
+    /** @private Current presentation's rendered colour layer. */
+    private _swatchColorElement;
+    /** @private Whether disabled/readonly state blocks all user mutation. */
+    private _isInert;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvColorPickerPopup, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MlvColorPickerPopup, "mlv-color-picker-popup", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "presentation": { "alias": "presentation"; "required": false; "isSignal": true; }; "opened": { "alias": "opened"; "required": false; "isSignal": true; }; "showOpacity": { "alias": "showOpacity"; "required": false; "isSignal": true; }; "defaultMode": { "alias": "defaultMode"; "required": false; "isSignal": true; }; "supportedFormats": { "alias": "supportedFormats"; "required": false; "isSignal": true; }; "live": { "alias": "live"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "opened": "openedChange"; "afterOpened": "afterOpened"; "afterClosed": "afterClosed"; "colorChange": "colorChange"; }, never, ["*"], true, never>;
+}

package/color-picker/lib/color-utils/color-utils.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Represents a color in HSL + Alpha space.
+ * All values are stored internally in this format for canvas rendering.
+ */
+export interface MlvHsla {
+    /** Hue: 0–360 */
+    h: number;
+    /** Saturation: 0–100 */
+    s: number;
+    /** Lightness: 0–100 */
+    l: number;
+    /** Alpha: 0–1 */
+    a: number;
+}
+/** Represents a color in RGBA space. */
+export interface MlvRgba {
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+}
+/** The color input mode for the text tabs. */
+export type MlvColorInputMode = 'hex' | 'rgb' | 'hsl';
+/**
+ * Clamps a number to the range [min, max].
+ */
+export declare function clamp(value: number, min: number, max: number): number;
+/**
+ * Rounds a number to a given number of decimal places.
+ */
+export declare function round(value: number, decimals?: number): number;
+/**
+ * Converts HSL (0-360, 0-100, 0-100) to RGB (0-255 each).
+ */
+export declare function hslToRgb(h: number, s: number, l: number): {
+    r: number;
+    g: number;
+    b: number;
+};
+/**
+ * Converts RGB (0-255) to HSL (0-360, 0-100, 0-100).
+ */
+export declare function rgbToHsl(r: number, g: number, b: number): {
+    h: number;
+    s: number;
+    l: number;
+};
+/**
+ * Converts a hex string (#RRGGBB or #RRGGBBAA) to RGBA.
+ * Returns null if the hex string is invalid.
+ */
+export declare function hexToRgba(hex: string): MlvRgba | null;
+/**
+ * Converts RGBA to a hex string.
+ * Includes alpha channel as #RRGGBBAA if alpha < 1.
+ */
+export declare function rgbaToHex(r: number, g: number, b: number, a: number): string;
+/**
+ * Converts an HSLa object to a CSS color string.
+ * Produces hsla() when alpha < 1, otherwise hsl().
+ */
+export declare function hslaToString(color: MlvHsla): string;
+/**
+ * Converts an HSLa object to an RGBA object.
+ */
+export declare function hslaToRgba(color: MlvHsla): MlvRgba;
+/**
+ * Converts an HSLa object to a hex string (#RRGGBB or #RRGGBBAA).
+ */
+export declare function hslaToHex(color: MlvHsla): string;
+/**
+ * Strictly parses a supported concrete CSS color string into an HSLa object.
+ * Supports: #RGB, #RGBA, #RRGGBB, #RRGGBBAA, rgb(), rgba(), hsl(), hsla().
+ * Returns `null` when parsing fails.
+ *
+ * CSS custom-property references are intentionally not resolved here because
+ * their value depends on an element's computed cascade. Use
+ * {@link isCssColorValue} when validating editable color text.
+ */
+export declare function tryParseCssColor(css: string): MlvHsla | null;
+/**
+ * Returns whether a string is a supported concrete color or a syntactically
+ * valid CSS custom-property color reference.
+ *
+ * An unresolved `var(--name)` is valid editable input: the browser resolves it
+ * later against the element's computed cascade. Optional fallbacks are
+ * validated recursively, including nested `var(...)` references.
+ */
+export declare function isCssColorValue(css: string): boolean;
+/**
+ * Parses any supported concrete CSS color string into an HSLa object.
+ * Returns a default black color if parsing fails.
+ */
+export declare function parseCssColor(css: string): MlvHsla;
+/**
+ * Converts an HSLa object to a CSS color string in the specified mode.
+ */
+export declare function hslaToModeString(color: MlvHsla, mode: MlvColorInputMode): string;
+/**
+ * Converts an HSLa color to a CSS rgba() string (used internally for canvas rendering).
+ */
+export declare function hslaToRgbaString(color: MlvHsla): string;

package/color-picker/malva-ui-core-color-picker.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Generated bundle index. Do not edit.
+ */
+/// <amd-module name="@malva-ui/core/color-picker" />
+export * from './index';

package/combobox/index.d.ts

@@ -0,0 +1,2 @@
+export * from './lib/combobox/combobox';
+export * from './lib/combobox-template.directives';