@malva-ui/core 0.1.12

package/AGENTS.md

@@ -0,0 +1,92 @@
+# @malva-ui/core — AI Reference
+
+Full-featured Angular UI components for the Malva UI design system.
+
+## Quick Start
+
+```ts
+import { MlvButton } from '@malva-ui/core/button';
+import { MlvDialogService } from '@malva-ui/core/dialog';
+import { MlvInput } from '@malva-ui/core/input';
+```
+
+## Conventions
+
+- Components use standalone Angular APIs, signals, and OnPush change detection.
+- BEM classes and `--mlv-*` custom properties provide style isolation and theming.
+- Import only documented package entry points.
+
+## Reference
+
+| Area | Import | Description |
+|---|---|---|
+| core | `@malva-ui/core` | `@malva-ui/core` is the grouped public package for all Malva UI components. [Details](docs/ai/core.md) |
+| accordion | `@malva-ui/core/accordion` | `@malva-ui/core/accordion` provides a vertically stacked, expandable-section. [Details](docs/ai/accordion.md) |
+| action-bar | `@malva-ui/core/action-bar` | The Action Bar library provides a flexible header/toolbar container that can be fixed, sticky, anchored to the top or bottom of its container/viewport, and rendered either as a full-width bar or a content-width floating pill. [Details](docs/ai/action-bar.md) |
+| alert | `@malva-ui/core/alert` | `@malva-ui/core/alert` provides an inline feedback banner component for displaying contextual messages with four semantic tones. [Details](docs/ai/alert.md) |
+| autocomplete | `@malva-ui/core/autocomplete` | `@malva-ui/core/autocomplete` provides a single reusable attribute directive, **`[mlvAutocomplete]`**, that adds autocomplete / typeahead behaviour to **any** text input — a native `<input>` or a `<mlv-input>` — without turning the field into a form control. [Details](docs/ai/autocomplete.md) |
+| avatar | `@malva-ui/core/avatar` | The Avatar library provides a versatile component for representing users or entities. [Details](docs/ai/avatar.md) |
+| avatar-group | `@malva-ui/core/avatar-group` | The Avatar Group library renders a horizontal stack of overlapping `mlv-avatar` instances representing a list of members. [Details](docs/ai/avatar-group.md) |
+| badge | `@malva-ui/core/badge` | The Badge library provides a compact `mlv-badge` element component for displaying short status labels, counts, category tags, and other inline metadata. [Details](docs/ai/badge.md) |
+| bottom-nav | `@malva-ui/core/bottom-nav` | @malva-ui/bottom-nav [Details](docs/ai/bottom-nav.md) |
+| breadcrumb | `@malva-ui/core/breadcrumb` | `@malva-ui/core/breadcrumb` provides a navigation breadcrumb component with configurable separator, overflow truncation for long paths, and Angular Router integration. [Details](docs/ai/breadcrumb.md) |
+| button | `@malva-ui/core/button` | The Button library provides accessible button primitives: styled native buttons, close buttons, connected button groups, split-button layouts, and two-state toggle buttons. [Details](docs/ai/button.md) |
+| calendar | `@malva-ui/core/calendar` | The Calendar library provides a fully accessible, keyboard-navigable date picker component with three view modes: **month**, **year**, and **multi-year**. [Details](docs/ai/calendar.md) |
+| card | `@malva-ui/core/card` | The Card library provides a flexible, composable container for displaying grouped content. [Details](docs/ai/card.md) |
+| chat | `@malva-ui/core/chat` | @malva-ui/core/chat [Details](docs/ai/chat.md) |
+| checkbox | `@malva-ui/core/checkbox` | The checkbox library provides accessible, stateful checkbox components. [Details](docs/ai/checkbox.md) |
+| chip | `@malva-ui/core/chip` | The Chip library provides an interactive `mlv-chip` element component for representing tags, filters, and selected items. [Details](docs/ai/chip.md) |
+| color-picker | `@malva-ui/core/color-picker` | The Color Picker library provides an HSL/HEX/RGB color picker with:. [Details](docs/ai/color-picker.md) |
+| combobox | `@malva-ui/core/combobox` | The Combobox library provides a searchable dropdown supporting both single and multiple selection. [Details](docs/ai/combobox.md) |
+| copy-to-clipboard | `@malva-ui/core/copy-to-clipboard` | `@malva-ui/core/copy-to-clipboard` provides the `<mlv-copy-to-clipboard>` component — an inline text wrapper that copies its projected content to the system clipboard on click, Enter, or Space. [Details](docs/ai/copy-to-clipboard.md) |
+| data-table | `@malva-ui/core/data-table` | @malva-ui/data-table [Details](docs/ai/data-table.md) |
+| date-range-picker | `@malva-ui/core/date-range-picker` | The Date Range Picker library provides a date range selection input combining two `mlv-calendar` instances inside a `mlv-popup` overlay. [Details](docs/ai/date-range-picker.md) |
+| day-picker | `@malva-ui/core/day-picker` | The Day Picker library provides a date selection component with a calendar popup. [Details](docs/ai/day-picker.md) |
+| dialog | `@malva-ui/core/dialog` | `@malva-ui/core/dialog` has one engine and one vocabulary. [Details](docs/ai/dialog.md) |
+| divider | `@malva-ui/core/divider` | `@malva-ui/core/divider` provides a thin separator line component for visually dividing sections of content. [Details](docs/ai/divider.md) |
+| drawer | `@malva-ui/core/drawer` | `@malva-ui/core/drawer` provides a slide-in overlay panel that renders over the rest of the UI using the Angular CDK Overlay. [Details](docs/ai/drawer.md) |
+| dropdown | `@malva-ui/core/dropdown` | The Dropdown library provides a generic dropdown panel component and option utilities. [Details](docs/ai/dropdown.md) |
+| empty-state | `@malva-ui/core/empty-state` | `@malva-ui/core/empty-state` provides a placeholder component for displaying when there is no content to show. [Details](docs/ai/empty-state.md) |
+| expand | `@malva-ui/core/expand` | The Expand library provides a **headless** `mlv-expand` element component for animated expand/collapse panels. [Details](docs/ai/expand.md) |
+| file-upload | `@malva-ui/core/file-upload` | The File Upload library provides a drag-and-drop file upload component with MIME type and size validation, multi-file support, image preview generation, upload progress display, and signal/reactive/template-driven forms integration. [Details](docs/ai/file-upload.md) |
+| filter | `@malva-ui/core/filter` | `@malva-ui/core/filter` provides a compact field filter and a metadata-driven Smart Filter Bar. [Details](docs/ai/filter.md) |
+| form | `@malva-ui/core/form` | `@malva-ui/core/form` is the **layout** layer for forms. [Details](docs/ai/form.md) |
+| form-utils | `@malva-ui/core/form-utils` | The Form Utils library provides foundational building blocks for accessible, state-aware forms. [Details](docs/ai/form-utils.md) |
+| input | `@malva-ui/core/input` | The Input library provides a fully accessible, state-aware text input component that integrates with Angular signal, reactive, and template-driven forms. [Details](docs/ai/input.md) |
+| kbd | `@malva-ui/core/kbd` | The Kbd library provides a purely presentational `mlv-kbd` component that renders keyboard shortcuts as styled `<kbd>` HTML elements. [Details](docs/ai/kbd.md) |
+| layout | `@malva-ui/core/layout` | The Layout library provides a responsive application. [Details](docs/ai/layout.md) |
+| link | `@malva-ui/core/link` | `@malva-ui/core/link` provides a styled hyperlink component applied as an attribute selector on native `<a>` elements. [Details](docs/ai/link.md) |
+| list | `@malva-ui/core/list` | The List library provides a composable vertical list system with:. [Details](docs/ai/list.md) |
+| loader | `@malva-ui/core/loader` | The Loader library provides a progress indicator component with two visual variants. [Details](docs/ai/loader.md) |
+| menu | `@malva-ui/core/menu` | The Menu library provides a dropdown action menu system with keyboard navigation, grouped items, separators, and nested submenu support. [Details](docs/ai/menu.md) |
+| notification | `@malva-ui/core/notification` | `@malva-ui/core/notification` provides richer programmatic notification cards with semantic icons, supporting text, and optional actions. [Details](docs/ai/notification.md) |
+| number-input | `@malva-ui/core/number-input` | The `number-input` library provides a themed numeric stepper input component that extends `FormControlBase<number>` and integrates with Angular Reactive Forms via CVA. [Details](docs/ai/number-input.md) |
+| page | `@malva-ui/core/page` | `@malva-ui/core/page` provides composable application-page primitives. [Details](docs/ai/page.md) |
+| pagination | `@malva-ui/core/pagination` | @malva-ui/pagination [Details](docs/ai/pagination.md) |
+| pin-input | `@malva-ui/core/pin-input` | The `pin-input` library provides `mlv-pin-input`: a row of single-character input cells that behave as one logical Signal Forms control. [Details](docs/ai/pin-input.md) |
+| popup | `@malva-ui/core/popup` | The Popup library provides a flexible overlay/popover system built on Angular CDK. [Details](docs/ai/popup.md) |
+| progress | `@malva-ui/core/progress` | The Progress library provides a standalone determinate progress indicator component — distinct from `mlv-loader`. [Details](docs/ai/progress.md) |
+| radio | `@malva-ui/core/radio` | The Radio library provides accessible radio button components following WAI-ARIA patterns. [Details](docs/ai/radio.md) |
+| rating | `@malva-ui/core/rating` | **Package:** `@malva-ui/core/rating`. [Details](docs/ai/rating.md) |
+| scrollbar | `@malva-ui/core/scrollbar` | The `scrollbar` library provides a minimalistic custom scrollbar component that hides the native browser scrollbar and renders a themed overlay track and thumb. [Details](docs/ai/scrollbar.md) |
+| search-field | `@malva-ui/core/search-field` | `@malva-ui/core/search-field` provides `MlvSearchField`, a search-specific composite control built from Malva input, button, and loader primitives. [Details](docs/ai/search-field.md) |
+| segmented | `@malva-ui/core/segmented` | `@malva-ui/core/segmented` provides a segmented control: `mlv-segmented` plus the `mlvSegmentedItem` attribute component applied to native `<button>` / `<a>` children. [Details](docs/ai/segmented.md) |
+| select | `@malva-ui/core/select` | `@malva-ui/core/select` provides a fully-featured, accessible dropdown select component for Angular forms. [Details](docs/ai/select.md) |
+| sidebar | `@malva-ui/core/sidebar` | The `@malva-ui/core/sidebar` library provides a navigation sidebar shell with collapsible group support, four layout modes, drag-to-resize rail, structural slot directives, a workspace switcher, and a toggle trigger component. [Details](docs/ai/sidebar.md) |
+| skeleton | `@malva-ui/core/skeleton` | `@malva-ui/core/skeleton` provides a skeleton loader component used as a visual placeholder while content is loading. [Details](docs/ai/skeleton.md) |
+| slider | `@malva-ui/core/slider` | The Slider library provides a range slider component for selecting numeric values or numeric ranges. [Details](docs/ai/slider.md) |
+| split-pane | `@malva-ui/core/split-pane` | `@malva-ui/core/split-pane` provides a resizable split-pane container for dividing screen space into two or more panels separated by draggable handles. [Details](docs/ai/split-pane.md) |
+| status-indicator | `@malva-ui/core/status-indicator` | `@malva-ui/core/status-indicator` provides a small circular **status dot**. [Details](docs/ai/status-indicator.md) |
+| stepper | `@malva-ui/core/stepper` | `@malva-ui/core/stepper` provides a multi-step workflow UI with a stepper header and managed content panels. [Details](docs/ai/stepper.md) |
+| switch | `@malva-ui/core/switch` | The Switch library provides accessible toggle switch components implementing the WAI-ARIA switch pattern. [Details](docs/ai/switch.md) |
+| tabs | `@malva-ui/core/tabs` | `@malva-ui/core/tabs` provides a full-featured, accessible tab group component for the Malva UI design system. [Details](docs/ai/tabs.md) |
+| textarea | `@malva-ui/core/textarea` | `@malva-ui/core/textarea` provides a multi-line text input form control. [Details](docs/ai/textarea.md) |
+| tile | `@malva-ui/core/tile` | The Tile library provides a card-like container component for displaying information in a structured, elevated panel. [Details](docs/ai/tile.md) |
+| time-picker | `@malva-ui/core/time-picker` | The Time Picker library provides a popup-based drum-roll style time selection component. [Details](docs/ai/time-picker.md) |
+| timeline | `@malva-ui/core/timeline` | `@malva-ui/core/timeline` provides a vertical timeline component for visualising ordered sequences of events. [Details](docs/ai/timeline.md) |
+| title | `@malva-ui/core/title` | The Title library provides an inline heading-typography component that decorates the host element itself through the `[mlvTitle]` selector. [Details](docs/ai/title.md) |
+| toast | `@malva-ui/core/toast` | `@malva-ui/core/toast` provides lightweight, programmatic notifications in six viewport positions. [Details](docs/ai/toast.md) |
+| tokenizer | `@malva-ui/core/tokenizer` | The Tokenizer library provides a tag/token input component for managing a collection of labelled items. [Details](docs/ai/tokenizer.md) |
+| toolbar | `@malva-ui/core/toolbar` | The Toolbar library provides simple, composable components for building horizontal toolbars and action bars. [Details](docs/ai/toolbar.md) |
+| tooltip | `@malva-ui/core/tooltip` | The Tooltip library provides a lightweight, accessible tooltip that appears on hover and focus. [Details](docs/ai/tooltip.md) |
+| tree | `@malva-ui/core/tree` | The Tree library provides a hierarchical data tree component for displaying nested data. [Details](docs/ai/tree.md) |

package/README.md

@@ -0,0 +1,61 @@
+# @malva-ui/core
+
+Malva UI's grouped Angular component package. Components are available from
+secondary entry points such as `@malva-ui/core/button`,
+`@malva-ui/core/dialog`, and `@malva-ui/core/data-table`.
+
+## Install
+
+Run the Angular installer from the root of a consumer workspace:
+
+```bash
+ng add @malva-ui/core
+```
+
+The installer:
+
+1. Selects the only Angular application automatically, or accepts
+   `--project <name>` in a multi-application workspace.
+2. Adds the matching `@malva-ui/cdk` and `@malva-ui/i18n` packages.
+3. Adds the packaged Malva UI token, reset, and animation stylesheet.
+4. Configures `provideDefaultTheme()` and `provideMlvDensity()` in the root
+   application providers.
+
+It asks for the initial light/dark theme, component density, global-style
+setup, and provider bootstrapping. The command is idempotent and can be run
+again without duplicating configuration.
+
+### Non-interactive installation
+
+```bash
+ng add @malva-ui/core \
+  --project my-app \
+  --theme dark \
+  --density compact \
+  --include-styles \
+  --configure-providers \
+  --no-interactive
+```
+
+| Option               | Values                                                  | Default       |
+| -------------------- | ------------------------------------------------------- | ------------- |
+| `project`            | Angular application name                                | sole app      |
+| `theme`              | `light`, `dark`                                         | `light`       |
+| `density`            | `tight`, `compact`, `comfortable`, `spacious`, `airy`   | `comfortable` |
+| `includeStyles`      | Add the packaged global stylesheet                      | `true`        |
+| `configureProviders` | Add theme and density root providers                    | `true`        |
+| `themeStorageKey`    | Browser storage key for the persisted theme             | `mlv-theme`   |
+| `skipInstall`        | Do not run the package manager after dependency changes | `false`       |
+
+If styles or providers are managed elsewhere, disable those steps with
+`--no-include-styles` and `--no-configure-providers`.
+
+## Use a component
+
+```ts
+import { MlvButton } from '@malva-ui/core/button';
+```
+
+```html
+<button mlvButton>Save</button>
+```

package/accordion/index.d.ts

@@ -0,0 +1,3 @@
+export * from './lib/accordion/accordion';
+export * from './lib/accordion-item/accordion-item';
+export * from './lib/accordion-item/accordion-header';

package/accordion/lib/accordion/accordion.d.ts

@@ -0,0 +1,47 @@
+import * as i0 from "@angular/core";
+import * as i1 from "@angular/aria/accordion";
+/**
+ * Vertical accordion container built on the `@angular/aria` `AccordionGroup`
+ * headless pattern. Projects one or more `mlv-accordion-item` children and
+ * coordinates their expand/collapse behaviour, single- vs multi-expand mode,
+ * and roving keyboard navigation (Arrow Up/Down, Home, End) across the item
+ * headers.
+ *
+ * The `@angular/aria` `AccordionGroup` is applied as a host directive so the
+ * `ACCORDION_GROUP` DI token it provides is visible to the triggers rendered
+ * inside each projected `mlv-accordion-item`. Its inputs are re-exposed
+ * verbatim on `<mlv-accordion>` — the aria directive owns the roles, keyboard
+ * event listeners, roving tabindex, and `aria-*` wiring.
+ *
+ * @example Single-expand (default aria behaviour is multi-expand)
+ * ```html
+ * <mlv-accordion [multiExpandable]="false">
+ *   <mlv-accordion-item header="Shipping">…</mlv-accordion-item>
+ *   <mlv-accordion-item header="Returns">…</mlv-accordion-item>
+ * </mlv-accordion>
+ * ```
+ *
+ * @example Programmatic expand/collapse all
+ * ```html
+ * <mlv-accordion #acc [multiExpandable]="true">…</mlv-accordion>
+ * <button (click)="acc.expandAll()">Expand all</button>
+ * <button (click)="acc.collapseAll()">Collapse all</button>
+ * ```
+ */
+export declare class MlvAccordion {
+    /**
+     * @private The host `@angular/aria` `AccordionGroup` directive instance,
+     * used to delegate the imperative `expandAll()` / `collapseAll()` calls.
+     */
+    private readonly _group;
+    /**
+     * Expands every accordion item. Only has an effect when `multiExpandable`
+     * is `true`; in single-expand mode the aria pattern keeps at most one panel
+     * open.
+     */
+    expandAll(): void;
+    /** Collapses every accordion item. */
+    collapseAll(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvAccordion, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MlvAccordion, "mlv-accordion", never, {}, {}, never, ["*"], true, [{ directive: typeof i1.AccordionGroup; inputs: { "multiExpandable": "multiExpandable"; "disabled": "disabled"; "softDisabled": "softDisabled"; "wrap": "wrap"; }; outputs: {}; }]>;
+}

package/accordion/lib/accordion-item/accordion-header.d.ts

@@ -0,0 +1,22 @@
+import * as i0 from "@angular/core";
+/**
+ * Marks projected content as the rich header of a `mlv-accordion-item`.
+ *
+ * Use it when the header needs more than the plain `header` string input
+ * (icons, badges, multi-line markup). When present, it renders inside the
+ * accordion trigger button alongside — or instead of — the `header` text.
+ *
+ * @example
+ * ```html
+ * <mlv-accordion-item>
+ *   <span mlvAccordionHeader>
+ *     <svg lucideFolder [size]="16" /> Documents
+ *   </span>
+ *   <p>Panel content…</p>
+ * </mlv-accordion-item>
+ * ```
+ */
+export declare class MlvAccordionHeader {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvAccordionHeader, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvAccordionHeader, "[mlvAccordionHeader]", never, {}, {}, never, never, true, never>;
+}

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

@@ -0,0 +1,49 @@
+import type { BooleanInput } from '@angular/cdk/coercion';
+import * as i0 from "@angular/core";
+/**
+ * A single expandable section of a `mlv-accordion`.
+ *
+ * Renders a header button (the `@angular/aria` `AccordionTrigger`) and a
+ * lazily-rendered content region (`AccordionPanel` + `AccordionContent`). The
+ * visual open/close animation is provided by wrapping the panel content in
+ * `mlv-expand`; the aria directives own the `role`, `aria-expanded`,
+ * `aria-controls`/`aria-labelledby` linkage, `inert`, and keyboard handling.
+ *
+ * Panel content is rendered lazily on first expand via aria's `DeferredContent`
+ * and then kept mounted (`preserveContent`) so the `mlv-expand`
+ * grid-row animation is never torn down mid-transition — the collapse hides the
+ * content through `mlv-expand`'s own `@if`, not by unmounting the panel.
+ *
+ * @example
+ * ```html
+ * <mlv-accordion>
+ *   <mlv-accordion-item header="Billing" [(expanded)]="billingOpen">
+ *     <p>Manage your billing details…</p>
+ *   </mlv-accordion-item>
+ * </mlv-accordion>
+ * ```
+ */
+export declare class MlvAccordionItem {
+    /**
+     * Plain-text header shown in the trigger button. For rich header content
+     * (icons, badges) project an element marked with the `mlvAccordionHeader`
+     * directive instead.
+     */
+    readonly header: import("@angular/core").InputSignal<string>;
+    /**
+     * Disables this item: the trigger becomes non-interactive and gets
+     * `aria-disabled="true"`. Whether it stays keyboard-focusable is governed by
+     * the parent `mlv-accordion`'s `softDisabled` input (aria default: focusable).
+     * Supports attribute syntax: `<mlv-accordion-item disabled>`.
+     */
+    readonly disabled: import("@angular/core").InputSignalWithTransform<boolean, BooleanInput>;
+    /**
+     * Two-way bindable expanded state of this item. Bind with
+     * `[(expanded)]="mySignal"`, or observe changes with
+     * `(expandedChange)="onToggle($event)"`. Kept in sync with the aria
+     * `AccordionTrigger` expansion model.
+     */
+    readonly expanded: import("@angular/core").ModelSignal<boolean>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvAccordionItem, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MlvAccordionItem, "mlv-accordion-item", never, { "header": { "alias": "header"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "expanded": { "alias": "expanded"; "required": false; "isSignal": true; }; }, { "expanded": "expandedChange"; }, never, ["[mlvAccordionHeader]", "*"], true, never>;
+}

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

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

package/action-bar/index.d.ts

@@ -0,0 +1,4 @@
+export * from './lib/action-bar/action-bar';
+export * from './lib/action-bar/components/action-bar-actions';
+export * from './lib/action-bar/components/action-bar-logo';
+export * from './lib/action-bar/components/action-bar-spacer';

package/action-bar/lib/action-bar/action-bar.d.ts

@@ -0,0 +1,59 @@
+import type { BooleanInput } from '@angular/cdk/coercion';
+import * as i0 from "@angular/core";
+/**
+ * Vertical anchor of the action bar. `'bottom'` is the natural companion to
+ * `shape="pill"` + `contrast` for floating selection toolbars that appear when
+ * the user selects rows in a data-table.
+ */
+export type MlvActionBarPosition = 'top' | 'bottom';
+/**
+ * Visual shape of the action bar.
+ *
+ * - `'default'` — full-width bar with a flush bottom / top border.
+ * - `'pill'` — content-width floating pill with a fully rounded radius and a
+ *   drop shadow. When paired with `fixed`, the pill auto-centers horizontally.
+ */
+export type MlvActionBarShape = 'default' | 'pill';
+export declare class MlvActionBar {
+    /**
+     * Applies `position: sticky` so the bar stays pinned while its scroll
+     * container scrolls past it.
+     */
+    readonly sticky: import("@angular/core").InputSignalWithTransform<boolean, BooleanInput>;
+    /**
+     * Applies `position: fixed` so the bar stays pinned to the viewport. When
+     * combined with `shape="pill"`, the bar is auto-centered horizontally.
+     */
+    readonly fixed: import("@angular/core").InputSignalWithTransform<boolean, BooleanInput>;
+    /**
+     * Vertical placement of the bar. Used as the anchor edge when combined with
+     * `fixed` or `sticky`, and as the enter/leave animation direction.
+     * Defaults to `'top'`.
+     */
+    readonly position: import("@angular/core").InputSignal<MlvActionBarPosition>;
+    /**
+     * Visual shape. See {@link MlvActionBarShape}. Defaults to `'default'`.
+     */
+    readonly shape: import("@angular/core").InputSignal<MlvActionBarShape>;
+    /**
+     * Lets the bar's content flow onto further lines once it no longer fits on
+     * one, instead of overflowing its container.
+     *
+     * Off by default, so an application navigation bar keeps its single-row
+     * geometry and relies on `[mlvActionBarActions]` to shed controls at narrow
+     * widths. Turn it on for content-heavy bars — for example a workflow toolbar
+     * projected into `mlv-page-dock` — that must stay fully reachable on a
+     * narrow canvas. On a wide viewport nothing wraps and the look is unchanged.
+     */
+    readonly wrap: import("@angular/core").InputSignalWithTransform<boolean, BooleanInput>;
+    /**
+     * Renders the bar on a dark, inverted surface so it stands out from the
+     * surrounding content. On the light theme the bar becomes a distinctive
+     * near-black surface; on the dark theme it flips to a contrasting lighter
+     * surface. Child controls automatically adapt their text / icon color so
+     * they remain readable on the inverted background.
+     */
+    readonly contrast: import("@angular/core").InputSignalWithTransform<boolean, BooleanInput>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvActionBar, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MlvActionBar, "[mlvActionBar]", never, { "sticky": { "alias": "sticky"; "required": false; "isSignal": true; }; "fixed": { "alias": "fixed"; "required": false; "isSignal": true; }; "position": { "alias": "position"; "required": false; "isSignal": true; }; "shape": { "alias": "shape"; "required": false; "isSignal": true; }; "wrap": { "alias": "wrap"; "required": false; "isSignal": true; }; "contrast": { "alias": "contrast"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}

package/action-bar/lib/action-bar/components/action-bar-actions.d.ts

@@ -0,0 +1,9 @@
+import * as i0 from "@angular/core";
+/**
+ * Marks desktop-only action-bar content that is hidden at the medium
+ * breakpoint and below.
+ */
+export declare class MlvActionBarActions {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvActionBarActions, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvActionBarActions, "[mlvActionBarActions]", never, {}, {}, never, never, true, never>;
+}

package/action-bar/lib/action-bar/components/action-bar-logo.d.ts

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

package/action-bar/lib/action-bar/components/action-bar-spacer.d.ts

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

package/action-bar/malva-ui-core-action-bar.d.ts

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

package/alert/index.d.ts

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

package/alert/lib/alert/alert.d.ts

@@ -0,0 +1,84 @@
+import type { BooleanInput } from '@angular/cdk/coercion';
+import { MlvAlertIcon, MlvAlertTitle } from './alert.directives';
+import type { MlvTone } from '@malva-ui/cdk/utils';
+import * as i0 from "@angular/core";
+/**
+ * Inline feedback banner component for displaying contextual messages.
+ *
+ * Supports four semantic tones (`info`, `success`, `warning`, `danger`),
+ * optional dismiss button, custom icon slot, and separate title/description
+ * content projection slots.
+ *
+ * @example Basic
+ * ```html
+ * <mlv-alert tone="info">Your profile has been updated.</mlv-alert>
+ * ```
+ *
+ * @example With title
+ * ```html
+ * <mlv-alert tone="warning">
+ *   <ng-template mlvAlertTitle>Storage nearly full</ng-template>
+ *   You have used 90% of your storage quota.
+ * </mlv-alert>
+ * ```
+ *
+ * @example Dismissible
+ * ```html
+ * <mlv-alert tone="success" dismissible (dismissed)="onDismissed()">
+ *   File uploaded successfully.
+ * </mlv-alert>
+ * ```
+ *
+ * @example Custom icon
+ * ```html
+ * <mlv-alert tone="info">
+ *   <ng-template mlvAlertIcon><svg lucideRocket [size]="16" /></ng-template>
+ *   New version available.
+ * </mlv-alert>
+ * ```
+ */
+export declare class MlvAlert {
+    /** @protected The component's i18n strings signal. */
+    protected readonly _i18n: import("@angular/core").Signal<import("@malva-ui/i18n").MlvAlertI18n>;
+    /**
+     * The semantic tone of the alert.
+     * Controls the color scheme and default icon.
+     * Defaults to `'info'`.
+     */
+    readonly tone: import("@angular/core").InputSignal<MlvTone>;
+    /**
+     * When `true`, renders a dismiss (close) button in the alert.
+     * Clicking it emits `dismissed` and hides the alert.
+     * Supports attribute syntax: `<mlv-alert dismissible>`.
+     */
+    readonly dismissible: import("@angular/core").InputSignalWithTransform<boolean, BooleanInput>;
+    /**
+     * When `true`, renders the alert with a transparent background and a colored border.
+     * The text and border color remain the tone foreground color.
+     * Supports attribute syntax: `<mlv-alert outlined>`.
+     */
+    readonly outlined: import("@angular/core").InputSignalWithTransform<boolean, BooleanInput>;
+    /**
+     * Emits when the user clicks the dismiss button.
+     * The alert is hidden automatically after emission.
+     */
+    readonly dismissed: import("@angular/core").OutputEmitterRef<void>;
+    /**
+     * @protected Tracks whether the alert has been dismissed by the user.
+     */
+    protected readonly _dismissed: import("@angular/core").WritableSignal<boolean>;
+    /**
+     * @protected Query for the optional custom icon slot directive.
+     */
+    protected readonly _iconSlot: import("@angular/core").Signal<MlvAlertIcon | undefined>;
+    /**
+     * @protected Query for the optional title slot directive.
+     */
+    protected readonly _titleSlot: import("@angular/core").Signal<MlvAlertTitle | undefined>;
+    /**
+     * @protected Handles dismiss button click: marks as dismissed and emits output.
+     */
+    protected _onDismiss(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvAlert, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MlvAlert, "mlv-alert", never, { "tone": { "alias": "tone"; "required": false; "isSignal": true; }; "dismissible": { "alias": "dismissible"; "required": false; "isSignal": true; }; "outlined": { "alias": "outlined"; "required": false; "isSignal": true; }; }, { "dismissed": "dismissed"; }, ["_iconSlot", "_titleSlot"], ["*"], true, never>;
+}

package/alert/lib/alert/alert.directives.d.ts

@@ -0,0 +1,44 @@
+import { TemplateRef } from '@angular/core';
+import * as i0 from "@angular/core";
+/**
+ * Slot directive for projecting a custom icon into the alert's icon area.
+ *
+ * Place inside an `<ng-template>` inside `<mlv-alert>` to override the
+ * default tone icon with custom content.
+ *
+ * @example
+ * ```html
+ * <mlv-alert tone="info">
+ *   <ng-template mlvAlertIcon>
+ *     <svg lucideInfo [size]="16" />
+ *   </ng-template>
+ *   Your session will expire soon.
+ * </mlv-alert>
+ * ```
+ */
+export declare class MlvAlertIcon {
+    /** The template reference for this icon slot. */
+    readonly templateRef: TemplateRef<any>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvAlertIcon, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvAlertIcon, "[mlvAlertIcon]", never, {}, {}, never, never, true, never>;
+}
+/**
+ * Slot directive for projecting a custom title into the alert's title area.
+ *
+ * Place inside an `<ng-template>` inside `<mlv-alert>` to provide a structured
+ * title line above the main description content.
+ *
+ * @example
+ * ```html
+ * <mlv-alert tone="warning">
+ *   <ng-template mlvAlertTitle>Storage nearly full</ng-template>
+ *   You have used 90% of your storage quota.
+ * </mlv-alert>
+ * ```
+ */
+export declare class MlvAlertTitle {
+    /** The template reference for this title slot. */
+    readonly templateRef: TemplateRef<any>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvAlertTitle, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvAlertTitle, "[mlvAlertTitle]", never, {}, {}, never, never, true, never>;
+}

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

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

package/autocomplete/index.d.ts

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