@malva-ui/core 0.1.12

package/input/lib/input/input.d.ts

@@ -0,0 +1,189 @@
+import type { BooleanInput } from '@angular/cdk/coercion';
+import type { MlvFormState, MlvFormControl } from '@malva-ui/core/form-utils';
+import { MlvSignalFormControlBase } from '@malva-ui/core/form-utils';
+import * as i0 from "@angular/core";
+export type MlvInputType = 'text' | 'password' | 'email' | 'number' | 'tel' | 'search' | 'url';
+/**
+ * Visual/validation state of the input. Mirrors {@link MlvFormState}.
+ */
+export type MlvInputState = MlvFormState;
+export type MlvInputInputMode = 'none' | 'text' | 'decimal' | 'numeric' | 'tel' | 'search' | 'email' | 'url';
+export declare class MlvInput extends MlvSignalFormControlBase<string> implements MlvFormControl {
+    readonly type: import("@angular/core").InputSignal<MlvInputType>;
+    readonly placeholder: import("@angular/core").InputSignal<string>;
+    /**
+     * Native HTML `autocomplete` hint forwarded to the underlying `<input>`.
+     * When empty, no `autocomplete` attribute is rendered.
+     * @default ''
+     */
+    readonly autocomplete: import("@angular/core").InputSignal<string>;
+    /**
+     * Native HTML `inputmode` attribute forwarded to the underlying `<input>`.
+     * Controls the virtual keyboard on mobile devices.
+     * @default null
+     */
+    readonly inputMode: import("@angular/core").InputSignal<MlvInputInputMode | null>;
+    /**
+     * Maximum number of characters the user may enter. Forwarded to the
+     * underlying `<input>` `maxlength` attribute. `null` removes the cap.
+     */
+    readonly maxLength: import("@angular/core").InputSignalWithTransform<number | null, number | null | undefined>;
+    /**
+     * Minimum number of characters the user must enter for the form control
+     * to validate. Forwarded to the underlying `<input>` `minlength` attribute.
+     */
+    readonly minLength: import("@angular/core").InputSignalWithTransform<number | null, number | null | undefined>;
+    /**
+     * Native HTML5 validation pattern (regular-expression source) forwarded
+     * to the underlying `<input>` `pattern` attribute.
+     */
+    readonly pattern: import("@angular/core").InputSignalWithTransform<string | null, string | RegExp | readonly RegExp[] | null | undefined>;
+    /**
+     * Native HTML `name` attribute. Required for non-Angular form submission;
+     * Reactive Forms / template-driven forms do not need this.
+     */
+    readonly name: import("@angular/core").InputSignalWithTransform<string | null, string | null | undefined>;
+    /**
+     * When `true`, the underlying `<input>` is focused as soon as it mounts.
+     * Use sparingly — autofocus is generally an a11y anti-pattern outside of
+     * dialogs and confirmation flows.
+     */
+    readonly autofocus: import("@angular/core").InputSignalWithTransform<boolean, BooleanInput>;
+    /**
+     * Numeric `min` attribute forwarded to the underlying `<input>`.
+     * Only meaningful when `type` is `'number'`.
+     */
+    readonly min: import("@angular/core").InputSignalWithTransform<string | number | null, string | number | null | undefined>;
+    /**
+     * Numeric `max` attribute forwarded to the underlying `<input>`.
+     * Only meaningful when `type` is `'number'`.
+     */
+    readonly max: import("@angular/core").InputSignalWithTransform<string | number | null, string | number | null | undefined>;
+    /**
+     * Numeric `step` attribute forwarded to the underlying `<input>`.
+     * Only meaningful when `type` is `'number'`. `null` falls back to the
+     * browser default of `1`.
+     */
+    readonly step: import("@angular/core").InputSignalWithTransform<number | null, number | null | undefined>;
+    /**
+     * When `true`, renders only the bare `<input>` element with no
+     * `mlv-form-control-wrapper` chrome (no label, no message, no
+     * prefix/suffix slots). Used by composite controls (combobox,
+     * tokenizer, command-palette, color-picker) that own their own
+     * surrounding container.
+     */
+    readonly bare: import("@angular/core").InputSignalWithTransform<boolean, BooleanInput>;
+    /**
+     * When `true`, `mlv-input` does not render its own internal `<input>` and
+     * instead adopts a consumer-projected `<input mlvInputNative>` as the control
+     * element. Opt in when an external attribute directive must sit directly on
+     * the native input — e.g. `@angular/aria`'s combobox trigger, which requires
+     * `[ngCombobox]` on the `<input>` itself. In this mode the projected input
+     * owns its own value/keyboard wiring; `mlv-input` provides the surrounding
+     * chrome, styling hook (`mlv-input__native`), and focus/select forwarding.
+     *
+     * Ignored unless a matching `<input mlvInputNative>` is projected.
+     */
+    readonly projectControl: import("@angular/core").InputSignalWithTransform<boolean, BooleanInput>;
+    /**
+     * Optional explicit `role` attribute forwarded to the underlying
+     * `<input>`. Use for combobox-style consumers — leave `null` for
+     * a vanilla text field.
+     */
+    readonly role: import("@angular/core").InputSignal<string | null>;
+    /**
+     * Forwarded to `aria-expanded`. Use with `role="combobox"` to
+     * communicate dropdown state.
+     */
+    readonly ariaExpanded: import("@angular/core").InputSignal<string | boolean | null>;
+    /**
+     * Forwarded to `aria-haspopup` (typically `'listbox'`).
+     */
+    readonly ariaHasPopup: import("@angular/core").InputSignal<string | null>;
+    /**
+     * Forwarded to `aria-autocomplete` (typically `'list'`). Use with
+     * `role="combobox"` to describe the autocomplete behaviour of the field.
+     */
+    readonly ariaAutocomplete: import("@angular/core").InputSignal<string | null>;
+    /**
+     * Forwarded to `aria-controls` — the id of the listbox / popup the
+     * input drives.
+     */
+    readonly ariaControls: import("@angular/core").InputSignal<string | null>;
+    /**
+     * Forwarded to `aria-activedescendant` — the id of the currently
+     * highlighted option in the listbox.
+     */
+    readonly ariaActiveDescendant: import("@angular/core").InputSignal<string | null>;
+    /**
+     * Explicit `aria-describedby` for the underlying `<input>`, overriding the
+     * ids the control derives from its own `description` / `message`. Composite
+     * controls (`mlv-pin-input`, `mlv-tokenizer`, `mlv-combobox`) that render the
+     * description and message themselves point the inner input here.
+     */
+    readonly ariaDescribedBy: import("@angular/core").InputSignal<string | null>;
+    /**
+     * The input's text value — the signal-forms `FormValueControl` model.
+     * Two-way bindable (`[(value)]`), one-way bindable by composite controls
+     * (`[value]="searchQuery()"`), and kept in sync with the bound field by
+     * `[formField]` / `[formControl]` / `ngModel`.
+     */
+    readonly value: import("@angular/core").ModelSignal<string>;
+    /**
+     * Emitted when the underlying native `<input>` gains focus. Re-emitted from
+     * the input's own `focus` handler so composite controls (e.g. `mlv-combobox`)
+     * can react to focus without relying on the non-bubbling native `focus`
+     * event reaching the `mlv-input` host. Carries the original `FocusEvent`.
+     */
+    readonly inputFocus: import("@angular/core").OutputEmitterRef<FocusEvent>;
+    /**
+     * Emitted when the underlying native `<input>` loses focus. Re-emitted from
+     * the input's own `blur` handler (fired after the touch output), so composite
+     * controls can run blur-driven logic (close dropdowns, revert text, mark
+     * touched) reliably. Carries the original `FocusEvent`.
+     */
+    readonly inputBlur: import("@angular/core").OutputEmitterRef<FocusEvent>;
+    /**
+     * @private Reference to the internally-rendered native `<input>` element so
+     * the component can imperatively focus / select its contents.
+     */
+    private readonly _nativeRef;
+    /**
+     * @private Reference to a consumer-projected `<input mlvInputNative>` used
+     * when {@link projectControl} is enabled.
+     */
+    private readonly _projectedNative;
+    /**
+     * @private Resolves the active native `<input>` — the projected one when
+     * projection is enabled and present, otherwise the internally-rendered input.
+     */
+    private _resolveNative;
+    /**
+     * Direct access to the underlying native `<input>`. Use sparingly —
+     * required only for selection-range / paste-distribution flows in
+     * composite controls. Resolves to the projected input when
+     * {@link projectControl} is enabled.
+     */
+    get nativeElement(): HTMLInputElement | null;
+    /**
+     * Focuses the underlying native input.
+     */
+    focus(): void;
+    /**
+     * Selects the current text inside the underlying native input.
+     */
+    select(): void;
+    onInput(event: Event): void;
+    /**
+     * Handles the native `<input>` focus event: sets the focused state and
+     * re-emits {@link inputFocus} for composite-control consumers.
+     */
+    onFocus(event: FocusEvent): void;
+    onBlur(event: FocusEvent): void;
+    /** Whether the control holds a clearable value — Non-empty text present. */
+    readonly hasValue: import("@angular/core").Signal<boolean>;
+    /** Clears the text value (wired to the wrapper's clear button). */
+    clearValue(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvInput, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MlvInput, "mlv-input", never, { "type": { "alias": "type"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "autocomplete": { "alias": "autocomplete"; "required": false; "isSignal": true; }; "inputMode": { "alias": "inputMode"; "required": false; "isSignal": true; }; "maxLength": { "alias": "maxLength"; "required": false; "isSignal": true; }; "minLength": { "alias": "minLength"; "required": false; "isSignal": true; }; "pattern": { "alias": "pattern"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "autofocus": { "alias": "autofocus"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "bare": { "alias": "bare"; "required": false; "isSignal": true; }; "projectControl": { "alias": "projectControl"; "required": false; "isSignal": true; }; "role": { "alias": "role"; "required": false; "isSignal": true; }; "ariaExpanded": { "alias": "ariaExpanded"; "required": false; "isSignal": true; }; "ariaHasPopup": { "alias": "ariaHasPopup"; "required": false; "isSignal": true; }; "ariaAutocomplete": { "alias": "ariaAutocomplete"; "required": false; "isSignal": true; }; "ariaControls": { "alias": "ariaControls"; "required": false; "isSignal": true; }; "ariaActiveDescendant": { "alias": "ariaActiveDescendant"; "required": false; "isSignal": true; }; "ariaDescribedBy": { "alias": "ariaDescribedBy"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "inputFocus": "inputFocus"; "inputBlur": "inputBlur"; }, ["_projectedNative"], ["input[mlvInputNative]", "input[mlvInputNative]"], true, never>;
+}

package/input/lib/input/password-strength.d.ts

@@ -0,0 +1,34 @@
+import * as i0 from "@angular/core";
+/**
+ * A synchronous password-strength rule supplied by the consumer.
+ *
+ * Return `true` when the password satisfies the rule and `false` otherwise.
+ */
+export interface MlvPasswordStrengthRule {
+    (value: string): boolean;
+}
+/**
+ * Headless password-strength calculator for `mlv-input`.
+ *
+ * The directive evaluates consumer-provided rules against the input's current
+ * value and exposes reactive score metadata through `exportAs`. It renders no
+ * UI, allowing consumers to present bars, text, emoji, or another indicator.
+ */
+export declare class MlvPasswordStrength {
+    /**
+     * Synchronous rules evaluated against the current input value.
+     */
+    readonly mlvPasswordStrength: import("@angular/core").InputSignal<readonly MlvPasswordStrengthRule[]>;
+    /** @private Input value accessor provided by the host `mlv-input`. */
+    private readonly _input;
+    /** Number of rules currently satisfied by the input value. */
+    readonly score: import("@angular/core").Signal<number>;
+    /** Total number of configured rules. */
+    readonly maxScore: import("@angular/core").Signal<number>;
+    /**
+     * Normalized score from `0` to `1`. Returns `0` when no rules are configured.
+     */
+    readonly ratio: import("@angular/core").Signal<number>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvPasswordStrength, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvPasswordStrength, "mlv-input[mlvPasswordStrength]", ["mlvPasswordStrength"], { "mlvPasswordStrength": { "alias": "mlvPasswordStrength"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}

package/input/malva-ui-core-input.d.ts

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

package/kbd/index.d.ts

@@ -0,0 +1 @@
+export * from './lib/kbd/kbd';

package/kbd/lib/kbd/kbd.d.ts

@@ -0,0 +1,52 @@
+import * as i0 from "@angular/core";
+/**
+ * Canonical key names accepted by the `keys` input.
+ * These map to human-readable labels and OS-specific symbols.
+ */
+export type MlvKbdKey = 'cmd' | 'command' | 'ctrl' | 'control' | 'shift' | 'alt' | 'option' | 'meta' | 'enter' | 'return' | 'backspace' | 'delete' | 'escape' | 'esc' | 'tab' | 'space' | 'up' | 'down' | 'left' | 'right' | 'home' | 'end' | 'pageup' | 'pagedown' | (string & {});
+/** Resolved label/symbol for a single key. */
+export interface MlvResolvedKey {
+    /** Display label rendered inside the `<kbd>` element. */
+    label: string;
+    /** Original key name, for aria labelling. */
+    key: string;
+}
+/**
+ * Keyboard shortcut display component. Renders an array of key names
+ * as styled `<kbd>` elements separated by a configurable separator.
+ *
+ * OS detection swaps modifier labels: Mac shows `⌘`, `⌃`, `⇧`, `⌥`;
+ * Windows/Linux shows `Ctrl`, `Shift`, `Alt`, etc.
+ *
+ * @example
+ * ```html
+ * <!-- Renders ⌘ + K on Mac, Ctrl + K on Windows -->
+ * <mlv-kbd [keys]="['cmd', 'k']" />
+ *
+ * <!-- Custom separator -->
+ * <mlv-kbd [keys]="['ctrl', 'shift', 'p']" separator=" " />
+ * ```
+ */
+export declare class MlvKbd {
+    /**
+     * The ordered list of key names to display.
+     * Accepts canonical names (`'cmd'`, `'shift'`, `'enter'`, etc.) or any
+     * plain string which will be uppercased as a fallback label.
+     *
+     * @example `['cmd', 'k']` → `⌘ + K` (Mac) / `Ctrl + K` (Win)
+     */
+    readonly keys: import("@angular/core").InputSignal<MlvKbdKey[]>;
+    /**
+     * The string rendered between each key element.
+     * Defaults to `'+'`.
+     */
+    readonly separator: import("@angular/core").InputSignal<string>;
+    /** @private Resolved OS flag — true on macOS browsers. */
+    private readonly _isMac;
+    /** @protected Resolved key labels for the template. */
+    protected readonly _resolvedKeys: import("@angular/core").Signal<MlvResolvedKey[]>;
+    /** @private Accessible label joining all resolved key names. */
+    protected readonly _ariaLabel: import("@angular/core").Signal<string>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvKbd, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MlvKbd, "mlv-kbd", never, { "keys": { "alias": "keys"; "required": true; "isSignal": true; }; "separator": { "alias": "separator"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}

package/kbd/malva-ui-core-kbd.d.ts

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

package/layout/index.d.ts

@@ -0,0 +1,4 @@
+export * from './lib/layout/layout';
+export * from './lib/layout/directives/MlvLayoutSide';
+export * from './lib/layout/directives/MlvLayoutTop';
+export * from './lib/layout/services/theme.service';

package/layout/lib/layout/directives/MlvLayoutSide.d.ts

@@ -0,0 +1,6 @@
+import { MlvStructural } from '@malva-ui/cdk/utils';
+import * as i0 from "@angular/core";
+export declare class MlvLayoutSide extends MlvStructural {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvLayoutSide, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvLayoutSide, "[mlvLayoutSide]", never, {}, {}, never, never, true, never>;
+}

package/layout/lib/layout/directives/MlvLayoutTop.d.ts

@@ -0,0 +1,6 @@
+import { MlvStructural } from '@malva-ui/cdk/utils';
+import * as i0 from "@angular/core";
+export declare class MlvLayoutTop extends MlvStructural {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvLayoutTop, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvLayoutTop, "[mlvLayoutTop]", never, {}, {}, never, never, true, never>;
+}

package/layout/lib/layout/layout.d.ts

@@ -0,0 +1,20 @@
+import { MlvLayoutTop } from './directives/MlvLayoutTop';
+import { MlvLayoutSide } from './directives/MlvLayoutSide';
+import * as i0 from "@angular/core";
+export declare class MlvLayout {
+    /** @protected Header slot directive projected via `[mlvLayoutTop]`. */
+    protected readonly topRef: import("@angular/core").Signal<MlvLayoutTop | undefined>;
+    /** @protected Sidebar slot directive projected via `[mlvLayoutSide]`. */
+    protected readonly sideRef: import("@angular/core").Signal<MlvLayoutSide | undefined>;
+    /** @protected Current active theme, sourced from the theme service. */
+    protected readonly _theme: import("@angular/core").Signal<import("@malva-ui/core/layout").MlvTheme>;
+    /** @private Theme service providing the current light/dark theme signal. */
+    private readonly _themeService;
+    /** @private Current platform identifier used to avoid DOM access during SSR. */
+    private readonly _platformId;
+    /** @private Platform document supplied by Angular for browser-safe DOM access. */
+    private readonly _document;
+    constructor();
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvLayout, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MlvLayout, "mlv-layout", never, {}, {}, ["topRef", "sideRef"], ["*"], true, never>;
+}

package/layout/lib/layout/services/theme.service.d.ts

@@ -0,0 +1,33 @@
+import type { Provider } from '@angular/core';
+import { InjectionToken } from '@angular/core';
+import * as i0 from "@angular/core";
+export type MlvTheme = 'light' | 'dark';
+export type MlvThemeMode = MlvTheme | 'auto';
+export declare function isMlvThemeMode(value: unknown): value is MlvThemeMode;
+export declare const MLV_THEME: InjectionToken<MlvThemeMode>;
+export declare const MLV_THEME_KEY: InjectionToken<string>;
+export declare const defaultThemeKey: "mlv-theme";
+export declare const defaultTheme: MlvThemeMode;
+export declare function provideDefaultTheme(theme?: MlvThemeMode, themeKey?: "mlv-theme"): Provider[];
+export declare class MlvThemeService {
+    /** @private Whether the service is running in a browser (vs. server-side rendering). */
+    private readonly _isBrowser;
+    /**
+     * Lazily-resolved `prefers-color-scheme: dark` media query list. `null` on
+     * the server where `window` is undefined.
+     */
+    private readonly _darkModeMedia;
+    /** @protected System dark-mode preference from the `prefers-color-scheme` media query. */
+    protected readonly _prefersDark: import("@angular/core").WritableSignal<boolean>;
+    readonly defaultTheme: MlvThemeMode;
+    /** @private Storage key used to persist the selected theme. */
+    private readonly _themeKey;
+    readonly themeMode: import("@angular/core").WritableSignal<MlvThemeMode>;
+    readonly currentTheme: import("@angular/core").WritableSignal<MlvTheme>;
+    constructor();
+    setTheme(mode: MlvThemeMode): void;
+    private _resolveTheme;
+    private _syncResolvedTheme;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvThemeService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<MlvThemeService>;
+}

package/layout/malva-ui-core-layout.d.ts

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

package/link/index.d.ts

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

package/link/lib/link/link.d.ts

@@ -0,0 +1,15 @@
+import type { BooleanInput } from '@angular/cdk/coercion';
+import { MlvLinkAfter, MlvLinkBefore } from './link.directives';
+import * as i0 from "@angular/core";
+export type MlvLinkVariant = 'default' | 'subtle' | 'emphasized';
+export declare class MlvLink {
+    readonly variant: import("@angular/core").InputSignal<MlvLinkVariant>;
+    /** Whether the link is disabled — prevents activation and removes it from the tab order. */
+    readonly disabled: import("@angular/core").InputSignalWithTransform<boolean, BooleanInput>;
+    /** @protected Optional leading-slot template projected before the link text. */
+    protected readonly _before: import("@angular/core").Signal<MlvLinkBefore | undefined>;
+    /** @protected Optional trailing-slot template projected after the link text. */
+    protected readonly _after: import("@angular/core").Signal<MlvLinkAfter | undefined>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvLink, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MlvLink, "a[mlvLink]", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, {}, ["_before", "_after"], ["*"], true, never>;
+}

package/link/lib/link/link.directives.d.ts

@@ -0,0 +1,10 @@
+import { MlvStructural } from '@malva-ui/cdk/utils';
+import * as i0 from "@angular/core";
+export declare class MlvLinkBefore extends MlvStructural {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvLinkBefore, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvLinkBefore, "[mlvLinkBefore]", never, {}, {}, never, never, true, never>;
+}
+export declare class MlvLinkAfter extends MlvStructural {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvLinkAfter, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvLinkAfter, "[mlvLinkAfter]", never, {}, {}, never, never, true, never>;
+}

package/link/malva-ui-core-link.d.ts

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

package/list/index.d.ts

@@ -0,0 +1,13 @@
+export * from './lib/list/list';
+export * from './lib/list-item/list-item';
+export * from './lib/list-item-media';
+export * from './lib/list-item-title';
+export * from './lib/list-item-byline';
+export * from './lib/list-item-meta';
+export * from './lib/list-item-actions';
+export * from './lib/list-item-prefix';
+export * from './lib/list-item-suffix';
+export * from './lib/list-item-template';
+export * from './lib/list-selectable';
+export * from './lib/list-item-link/list-item-link';
+export * from './lib/list-item-group/list-item-group';

package/list/lib/list/list.d.ts

@@ -0,0 +1,25 @@
+import * as i0 from "@angular/core";
+/**
+ * Visual variant of the list container.
+ *
+ * - `plain` — spaced rows with no container styling (default).
+ * - `inset` — grouped, elevated appearance: rows sit on a raised surface
+ *   inside a sunken background, connected by inset dividers and topped with
+ *   sticky group headers. The iOS/Apple Settings look.
+ */
+export type MlvListVariant = 'plain' | 'inset';
+export declare class MlvList {
+    /**
+     * WAI-ARIA role for the list host element.
+     * Override when the list is used in a context requiring a different role
+     * (e.g. `'menu'` when used as a menu panel container).
+     * Defaults to `'list'`.
+     */
+    readonly listRole: import("@angular/core").InputSignal<string>;
+    /**
+     * Visual variant of the list. See {@link MlvListVariant}.
+     */
+    readonly variant: import("@angular/core").InputSignal<MlvListVariant>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvList, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MlvList, "mlv-list", never, { "listRole": { "alias": "listRole"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}

package/list/lib/list-item/list-item.d.ts

@@ -0,0 +1,67 @@
+import type { BooleanInput } from '@angular/cdk/coercion';
+import { MlvListItemLink } from '../list-item-link/list-item-link';
+import { MlvListItemActions } from '../list-item-actions';
+import { MlvListItemByline } from '../list-item-byline';
+import { MlvListItemMedia } from '../list-item-media';
+import { MlvListItemMeta } from '../list-item-meta';
+import { MlvListItemPrefix } from '../list-item-prefix';
+import { MlvListItemSuffix } from '../list-item-suffix';
+import { MlvListItemTitle } from '../list-item-title';
+import * as i0 from "@angular/core";
+/**
+ * Semantic accent key used to tint the leading accent bar of a list item.
+ * Any other string is treated as a raw CSS color value.
+ */
+export type MlvListItemAccent = 'neutral' | 'primary' | 'positive' | 'negative' | 'warning' | 'info' | (string & {});
+export declare class MlvListItem {
+    /**
+     * WAI-ARIA role for the host element.
+     * Defaults to `'listitem'`. Override to `'menuitem'`, `'option'`, or another
+     * appropriate role when the item is used inside a composite widget that
+     * requires a different ARIA role (e.g. inside a `role="menu"` container).
+     */
+    readonly itemRole: import("@angular/core").InputSignal<string>;
+    /**
+     * Marks the item as unread — bolds the title and shows a leading unread dot.
+     * Matches the familiar inbox/notification-center pattern.
+     */
+    readonly unread: import("@angular/core").InputSignalWithTransform<boolean, BooleanInput>;
+    /**
+     * Optional accent color for the leading bar. Accepts semantic keys
+     * (`primary`, `positive`, `negative`, `warning`, `info`, `neutral`) or any
+     * raw CSS color value. When set, the accent bar is always rendered.
+     */
+    readonly accent: import("@angular/core").InputSignal<MlvListItemAccent | undefined>;
+    /** @protected Projected `a[mlvListItemLink]` child, if any — drives router-active state. */
+    protected readonly _link: import("@angular/core").Signal<MlvListItemLink | undefined>;
+    /** @protected Leading rich-media slot (`[mlvListItemMedia]`). */
+    protected readonly _mediaSlot: import("@angular/core").Signal<MlvListItemMedia | undefined>;
+    /** @protected Title slot (`[mlvListItemTitle]`). */
+    protected readonly _titleSlot: import("@angular/core").Signal<MlvListItemTitle | undefined>;
+    /** @protected Secondary byline slot (`[mlvListItemByline]`). */
+    protected readonly _bylineSlot: import("@angular/core").Signal<MlvListItemByline | undefined>;
+    /** @protected Inline headline meta slot (`[mlvListItemMeta]`). */
+    protected readonly _metaSlot: import("@angular/core").Signal<MlvListItemMeta | undefined>;
+    /** @protected Trailing actions slot (`[mlvListItemActions]`). */
+    protected readonly _actionsSlot: import("@angular/core").Signal<MlvListItemActions | undefined>;
+    /** @protected Legacy leading prefix slot (`[mlvListItemPrefix]`). */
+    protected readonly _prefixSlot: import("@angular/core").Signal<MlvListItemPrefix | undefined>;
+    /** @protected Legacy trailing suffix slot (`[mlvListItemSuffix]`). */
+    protected readonly _suffixSlot: import("@angular/core").Signal<MlvListItemSuffix | undefined>;
+    readonly isActive: import("@angular/core").Signal<boolean>;
+    /** @protected Whether any rich-layout slot is projected — switches the row to rich layout. */
+    protected readonly _hasRichLayout: import("@angular/core").Signal<boolean>;
+    /** @protected Whether a leading slot (media or legacy prefix) is projected. */
+    protected readonly _hasLeadingSlot: import("@angular/core").Signal<boolean>;
+    /** @protected Whether a trailing slot (actions or legacy suffix) is projected. */
+    protected readonly _hasTrailingSlot: import("@angular/core").Signal<boolean>;
+    /** @protected Whether the actions slot opts into reveal-on-hover behaviour. */
+    protected readonly _revealActions: import("@angular/core").Signal<boolean>;
+    /**
+     * @protected Resolves the `accent` input to a CSS color value. Semantic
+     * keys map to Malva UI tokens; any other string is returned verbatim.
+     */
+    protected readonly _accentColor: import("@angular/core").Signal<string | null>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvListItem, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MlvListItem, "mlv-list-item", never, { "itemRole": { "alias": "itemRole"; "required": false; "isSignal": true; }; "unread": { "alias": "unread"; "required": false; "isSignal": true; }; "accent": { "alias": "accent"; "required": false; "isSignal": true; }; }, {}, ["_link", "_mediaSlot", "_titleSlot", "_bylineSlot", "_metaSlot", "_actionsSlot", "_prefixSlot", "_suffixSlot"], ["[mlvListItemMedia], [mlvListItemPrefix]", "[mlvListItemTitle]", "*", "[mlvListItemMeta]", "[mlvListItemByline]", "[mlvListItemActions], [mlvListItemSuffix]", "[mlvListItemPrefix]", "*", "[mlvListItemSuffix]"], true, never>;
+}

package/list/lib/list-item-actions.d.ts

@@ -0,0 +1,12 @@
+import type { BooleanInput } from '@angular/cdk/coercion';
+import * as i0 from "@angular/core";
+export declare class MlvListItemActions {
+    /**
+     * When true, the actions wrapper is hidden by default and revealed on row
+     * hover, focus-within, or touch devices. Lets rows stay visually calm until
+     * the user signals intent to interact.
+     */
+    readonly revealOnHover: import("@angular/core").InputSignalWithTransform<boolean, BooleanInput>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvListItemActions, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvListItemActions, "[mlvListItemActions]", never, { "revealOnHover": { "alias": "revealOnHover"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}

package/list/lib/list-item-byline.d.ts

@@ -0,0 +1,5 @@
+import * as i0 from "@angular/core";
+export declare class MlvListItemByline {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvListItemByline, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvListItemByline, "[mlvListItemByline]", never, {}, {}, never, never, true, never>;
+}

package/list/lib/list-item-group/list-item-group.d.ts

@@ -0,0 +1,11 @@
+import type { BooleanInput } from '@angular/cdk/coercion';
+import * as i0 from "@angular/core";
+export declare class MlvListItemGroup {
+    readonly label: import("@angular/core").InputSignal<string>;
+    readonly open: import("@angular/core").ModelSignal<BooleanInput>;
+    /** @protected Unique ID for the collapsible content region. */
+    protected readonly _contentId: string;
+    toggle(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvListItemGroup, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MlvListItemGroup, "mlv-list-item-group", never, { "label": { "alias": "label"; "required": true; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; }, { "open": "openChange"; }, never, ["*"], true, never>;
+}

package/list/lib/list-item-link/list-item-link.d.ts

@@ -0,0 +1,8 @@
+import { RouterLinkActive } from '@angular/router';
+import * as i0 from "@angular/core";
+export declare class MlvListItemLink {
+    readonly routerLink: RouterLinkActive | null;
+    readonly isActive: import("@angular/core").Signal<boolean>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvListItemLink, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MlvListItemLink, "a[mlvListItemLink]", never, {}, {}, never, ["*"], true, never>;
+}

package/list/lib/list-item-media.d.ts

@@ -0,0 +1,5 @@
+import * as i0 from "@angular/core";
+export declare class MlvListItemMedia {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvListItemMedia, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvListItemMedia, "[mlvListItemMedia]", never, {}, {}, never, never, true, never>;
+}

package/list/lib/list-item-meta.d.ts

@@ -0,0 +1,5 @@
+import * as i0 from "@angular/core";
+export declare class MlvListItemMeta {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvListItemMeta, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvListItemMeta, "[mlvListItemMeta]", never, {}, {}, never, never, true, never>;
+}

package/list/lib/list-item-prefix.d.ts

@@ -0,0 +1,5 @@
+import * as i0 from "@angular/core";
+export declare class MlvListItemPrefix {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvListItemPrefix, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvListItemPrefix, "[mlvListItemPrefix]", never, {}, {}, never, never, true, never>;
+}

package/list/lib/list-item-suffix.d.ts

@@ -0,0 +1,5 @@
+import * as i0 from "@angular/core";
+export declare class MlvListItemSuffix {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvListItemSuffix, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvListItemSuffix, "[mlvListItemSuffix]", never, {}, {}, never, never, true, never>;
+}

package/list/lib/list-item-template.d.ts

@@ -0,0 +1,10 @@
+import { TemplateRef } from '@angular/core';
+import * as i0 from "@angular/core";
+export interface MlvListItemTemplateContext<T = unknown> {
+    $implicit: T;
+}
+export declare class MlvListItemTemplate<T = unknown> {
+    readonly templateRef: TemplateRef<any>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvListItemTemplate<any>, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvListItemTemplate<any>, "[mlvListItemTemplate]", never, {}, {}, never, never, true, never>;
+}

package/list/lib/list-item-title.d.ts

@@ -0,0 +1,5 @@
+import * as i0 from "@angular/core";
+export declare class MlvListItemTitle {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvListItemTitle, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvListItemTitle, "[mlvListItemTitle]", never, {}, {}, never, never, true, never>;
+}