@acontplus/ng-components 3.2.0 → 4.0.0

package/types/acontplus-ng-components.d.ts

@@ -1,5 +1,5 @@
 import * as _angular_core from '@angular/core';
-import { EventEmitter, TemplateRef, InjectionToken, OnDestroy, OnInit, ElementRef, Signal, ViewContainerRef, Injector, Binding, Type, ComponentRef, AfterViewInit, EnvironmentProviders, OnChanges, SimpleChanges, NgZone, QueryList, TrackByFunction, KeyValueChangeRecord, OutputEmitterRef, WritableSignal, AfterContentInit, PipeTransform } from '@angular/core';
+import { EventEmitter, TemplateRef, InjectionToken, OnDestroy, OnInit, ElementRef, Signal, ViewContainerRef, Injector, Binding, Type, ComponentRef, AfterViewInit, EnvironmentProviders, DoCheck, OnChanges, SimpleChanges, NgZone, QueryList, TrackByFunction, KeyValueChangeRecord, OutputEmitterRef, WritableSignal, AfterContentInit, PipeTransform } from '@angular/core';
 import * as rxjs from 'rxjs';
 import { Observable, Subject } from 'rxjs';
 import { DialogPosition, MatDialogRef, MatDialogState } from '@angular/material/dialog';
@@ -7,6 +7,9 @@ import { ScrollStrategy } from '@angular/cdk/overlay';
 import * as _acontplus_ng_components from '@acontplus/ng-components';
 import { FormControl, ControlValueAccessor, FormGroup } from '@angular/forms';
 import { SelectOption, IconDefinition, ButtonVariant, ButtonType, MaterialButtonStyle, REPORT_FORMAT } from '@acontplus/ui-kit';
+import { ErrorStateMatcher, ThemePalette } from '@angular/material/core';
+import { MatAutocompleteSelectedEvent } from '@angular/material/autocomplete';
+import { MatFormFieldAppearance } from '@angular/material/form-field';
 import { SafeHtml } from '@angular/platform-browser';
 import { MatChipInputEvent, MatChipEditedEvent } from '@angular/material/chips';
 import { LiveAnnouncer, FocusOrigin } from '@angular/cdk/a11y';
@@ -17,7 +20,6 @@ import { SortDirection, MatSort, Sort } from '@angular/material/sort';
 import { SelectionModel } from '@angular/cdk/collections';
 import { MatBadgePosition, MatBadgeSize } from '@angular/material/badge';
 import { MatButtonAppearance } from '@angular/material/button';
-import { ThemePalette } from '@angular/material/core';
 import { TooltipPosition, TooltipTouchGestures } from '@angular/material/tooltip';
 import { CdkDragDrop } from '@angular/cdk/drag-drop';
 import { MatMenu, MatMenuTrigger } from '@angular/material/menu';
@@ -113,136 +115,6 @@ declare const ACP_BADGE_SHAPES: AcpBadgeShape[];
 
 declare const TREND_CONFIGS: Record<AcpBadgeTrend, AcpBadgeTrendConfig>;
 
-/**
- * A versatile card component that wraps Angular Material's mat-card with additional functionality
- * and customization options. This component provides a consistent card layout with configurable
- * header, content, and action areas.
- */
-declare class DynamicCard {
-    /**
-     * The title text to display in the card header.
-     * @default null
-     */
-    cardTitle: _angular_core.InputSignal<string | null>;
-    /**
-     * The subtitle text to display in the card header.
-     * @default null
-     */
-    cardSubtitle: _angular_core.InputSignal<string | null>;
-    /**
-     * URL for the avatar image to display in the card header.
-     * @default null
-     */
-    avatarImageUrl: _angular_core.InputSignal<string | null>;
-    /**
-     * Whether to show the card header section.
-     * @default false
-     */
-    isHeaderVisible: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /**
-     * CSS padding value for the card content area.
-     * @default '1rem'
-     */
-    contentPadding: _angular_core.InputSignal<string>;
-    /**
-     * Whether to show a divider between the header and content sections.
-     * @default false
-     */
-    hasDivider: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /**
-     * Whether to show the action buttons section.
-     * @default false
-     */
-    areActionsVisible: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /**
-     * Text for the primary action button.
-     * @default 'Confirm'
-     */
-    primaryButtonText: _angular_core.InputSignal<string>;
-    /**
-     * Text for the secondary action button.
-     * @default 'Cancel'
-     */
-    secondaryButtonText: _angular_core.InputSignal<string>;
-    /**
-     * Material icon name for the primary button.
-     * @default null
-     */
-    primaryButtonIcon: _angular_core.InputSignal<string | null>;
-    /**
-     * Material icon name for the secondary button.
-     * @default null
-     */
-    secondaryButtonIcon: _angular_core.InputSignal<string | null>;
-    /**
-     * Alignment of the action buttons.
-     * @default 'end'
-     */
-    buttonsPosition: _angular_core.InputSignal<"start" | "end">;
-    /**
-     * Event emitted when the primary button is clicked.
-     */
-    primaryButtonClicked: _angular_core.OutputEmitterRef<void>;
-    /**
-     * Event emitted when the secondary button is clicked.
-     */
-    secondaryButtonClicked: _angular_core.OutputEmitterRef<void>;
-    /**
-     * Event emitted when the card is clicked.
-     */
-    cardClicked: _angular_core.OutputEmitterRef<Event>;
-    /**
-     * Event emitted when a key is pressed down on the card.
-     */
-    keyDown: _angular_core.OutputEmitterRef<KeyboardEvent>;
-    /**
-     * Event emitted when a key is released on the card.
-     */
-    keyUp: _angular_core.OutputEmitterRef<KeyboardEvent>;
-    /**
-     * Event emitted when a key is pressed on the card.
-     */
-    keyPress: _angular_core.OutputEmitterRef<KeyboardEvent>;
-    /**
-     * Handles the primary button click event.
-     * Stops event propagation and emits the primaryButtonClicked event.
-     * @param event The click event
-     */
-    handlePrimaryButtonClick(event: Event): void;
-    /**
-     * Handles the secondary button click event.
-     * Stops event propagation and emits the secondaryButtonClicked event.
-     * @param event The click event
-     */
-    handleSecondaryButtonClick(event: Event): void;
-    /**
-     * Handles the card click event.
-     * Emits the cardClicked event with the original event.
-     * @param event The click event
-     */
-    handleCardClick(event: Event): void;
-    /**
-     * Handles the key down event on the card.
-     * Emits the keyDown event with the original keyboard event.
-     * @param event The keyboard event
-     */
-    handleKeyDown(event: KeyboardEvent): void;
-    /**
-     * Handles the key up event on the card.
-     * Emits the keyUp event with the original keyboard event.
-     * @param event The keyboard event
-     */
-    handleKeyUp(event: KeyboardEvent): void;
-    /**
-     * Handles the key press event on the card.
-     * Emits the keyPress event with the original keyboard event.
-     * @param event The keyboard event
-     */
-    handleKeyPress(event: KeyboardEvent): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DynamicCard, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DynamicCard, "acp-dynamic-card", never, { "cardTitle": { "alias": "cardTitle"; "required": false; "isSignal": true; }; "cardSubtitle": { "alias": "cardSubtitle"; "required": false; "isSignal": true; }; "avatarImageUrl": { "alias": "avatarImageUrl"; "required": false; "isSignal": true; }; "isHeaderVisible": { "alias": "isHeaderVisible"; "required": false; "isSignal": true; }; "contentPadding": { "alias": "contentPadding"; "required": false; "isSignal": true; }; "hasDivider": { "alias": "hasDivider"; "required": false; "isSignal": true; }; "areActionsVisible": { "alias": "areActionsVisible"; "required": false; "isSignal": true; }; "primaryButtonText": { "alias": "primaryButtonText"; "required": false; "isSignal": true; }; "secondaryButtonText": { "alias": "secondaryButtonText"; "required": false; "isSignal": true; }; "primaryButtonIcon": { "alias": "primaryButtonIcon"; "required": false; "isSignal": true; }; "secondaryButtonIcon": { "alias": "secondaryButtonIcon"; "required": false; "isSignal": true; }; "buttonsPosition": { "alias": "buttonsPosition"; "required": false; "isSignal": true; }; }, { "primaryButtonClicked": "primaryButtonClicked"; "secondaryButtonClicked": "secondaryButtonClicked"; "cardClicked": "cardClicked"; "keyDown": "keyDown"; "keyUp": "keyUp"; "keyPress": "keyPress"; }, never, ["*"], true, never>;
-}
-
 /**
  * Context Menu Types and Interfaces
  * Defines the API contract for the ContextMenu component
@@ -1148,7 +1020,7 @@ declare class AcpDialogContainer implements AfterViewInit {
     /** Pending declarative titlebar template, captured before the outlet is ready. */
     private readonly pendingTitlebarTemplate;
     /** Alignment requested by a declarative actions template. */
-    protected readonly declarativeActionsAlign: _angular_core.WritableSignal<"start" | "end" | "center" | undefined>;
+    protected readonly declarativeActionsAlign: _angular_core.WritableSignal<"start" | "center" | "end" | undefined>;
     /** Title requested by a declarative titlebar template. */
     protected readonly declarativeTitle: _angular_core.WritableSignal<string | undefined>;
     /** Outlet object provided to content so `acp-dialog-actions` can register itself. */
@@ -1160,7 +1032,7 @@ declare class AcpDialogContainer implements AfterViewInit {
     /** Title used for the actions footer label. */
     protected readonly resolvedDialogTitle: Signal<string | undefined>;
     /** Alignment used for the actions footer. */
-    protected readonly resolvedActionsAlign: Signal<"start" | "end" | "center">;
+    protected readonly resolvedActionsAlign: Signal<"start" | "center" | "end">;
     /** Whether the current content is a plain string. */
     protected readonly isStringContent: _angular_core.WritableSignal<boolean>;
     get config(): _acontplus_ng_components.AcpDialogConfig<unknown>;
@@ -1246,7 +1118,7 @@ declare class AcpDialogActions implements AfterViewInit {
     protected readonly renderInline: _angular_core.WritableSignal<boolean>;
     protected readonly hostDisplay: _angular_core.WritableSignal<string>;
     /** Alignment of the action buttons. @default 'end' */
-    align: _angular_core.InputSignal<"start" | "end" | "center">;
+    align: _angular_core.InputSignal<"start" | "center" | "end">;
     /** Configured footer actions. When omitted, the component works as a declarative slot. */
     actions: _angular_core.InputSignal<AcpDialogAction<unknown>[] | undefined>;
     /** Optional title used to label the actions footer. */
@@ -1584,6 +1456,113 @@ declare class DynamicSelect implements OnInit, OnDestroy {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DynamicSelect, "acp-dynamic-select", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": true; "isSignal": true; }; "selectedValue": { "alias": "selectedValue"; "required": false; "isSignal": true; }; "className": { "alias": "className"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "virtualScroll": { "alias": "virtualScroll"; "required": false; "isSignal": true; }; "dropdownPosition": { "alias": "dropdownPosition"; "required": false; "isSignal": true; }; "closeOnSelect": { "alias": "closeOnSelect"; "required": false; "isSignal": true; }; "hideSelected": { "alias": "hideSelected"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "selectOnTab": { "alias": "selectOnTab"; "required": false; "isSignal": true; }; "openOnEnter": { "alias": "openOnEnter"; "required": false; "isSignal": true; }; "selectableGroup": { "alias": "selectableGroup"; "required": false; "isSignal": true; }; "selectableGroupAsModel": { "alias": "selectableGroupAsModel"; "required": false; "isSignal": true; }; "clearOnBackspace": { "alias": "clearOnBackspace"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "searchWhileComposing": { "alias": "searchWhileComposing"; "required": false; "isSignal": true; }; "minTermLength": { "alias": "minTermLength"; "required": false; "isSignal": true; }; "editableSearchTerm": { "alias": "editableSearchTerm"; "required": false; "isSignal": true; }; "typeToSearchText": { "alias": "typeToSearchText"; "required": false; "isSignal": true; }; "addTagText": { "alias": "addTagText"; "required": false; "isSignal": true; }; "loadingText": { "alias": "loadingText"; "required": false; "isSignal": true; }; "clearAllText": { "alias": "clearAllText"; "required": false; "isSignal": true; }; "notFoundText": { "alias": "notFoundText"; "required": false; "isSignal": true; }; }, { "selectionChange": "selectionChange"; }, never, never, true, never>;
 }
 
+/** Property name or function that reads a value from an item. */
+type AcpSearchSelectAccessor<T, R> = keyof T | ((item: T) => R);
+/** Context of the `#option` template. */
+interface AcpSearchSelectOptionContext<T> {
+    $implicit: T;
+    group: T | null;
+}
+/** Payload of `optionSelected`. */
+interface AcpSearchSelectSelection<T, V = unknown> {
+    value: V;
+    item: T;
+    group: T | null;
+}
+
+interface OptionVm<T> {
+    key: string;
+    label: string;
+    value: unknown;
+    source: T;
+    group: T | null;
+}
+/** `label === null` holds loose options rendered without `mat-optgroup`. */
+interface GroupVm<T> {
+    label: string | null;
+    options: OptionVm<T>[];
+}
+/** Matches `1` with `'1'`, useful when ids come as strings from forms or query params. */
+declare const acpSearchSelectLooseEquals: (a: unknown, b: unknown) => boolean;
+/** Lowercase and strip accents, so "camion" matches "Camión". */
+declare const acpSearchSelectNormalize: (text: string) => string;
+/**
+ * Searchable select built on `mat-autocomplete`. Accepts flat or one-level tree lists:
+ * an item whose `children` is an array renders as a group.
+ * Works with `ngModel`, reactive forms and `[(value)]`.
+ */
+declare class AcpSearchSelect<T = any> implements ControlValueAccessor, DoCheck {
+    private readonly document;
+    private readonly ngControl;
+    private readonly parentForm;
+    private readonly parentFormGroup;
+    readonly items: _angular_core.InputSignal<T[] | null | undefined>;
+    readonly bindLabel: _angular_core.InputSignal<AcpSearchSelectAccessor<T, string>>;
+    readonly bindValue: _angular_core.InputSignal<AcpSearchSelectAccessor<T, unknown>>;
+    readonly children: _angular_core.InputSignal<AcpSearchSelectAccessor<T, T[] | undefined>>;
+    readonly groupLabel: _angular_core.InputSignal<AcpSearchSelectAccessor<T, string>>;
+    readonly compareWith: _angular_core.InputSignal<(a: unknown, b: unknown) => boolean>;
+    /** Custom match. Receives the item and the normalized query. */
+    readonly filterFn: _angular_core.InputSignal<((item: T, query: string) => boolean) | null>;
+    /** Set to `false` when `items` already come filtered from the server (see `searchChange`). */
+    readonly localFilter: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Value written when the field is cleared, e.g. `0` for "all". */
+    readonly emptyValue: _angular_core.InputSignal<unknown>;
+    readonly label: _angular_core.InputSignal<string>;
+    readonly placeholder: _angular_core.InputSignal<string>;
+    readonly hint: _angular_core.InputSignal<string>;
+    readonly errorText: _angular_core.InputSignal<string>;
+    readonly noResultsText: _angular_core.InputSignal<string>;
+    readonly loadingText: _angular_core.InputSignal<string>;
+    readonly clearLabel: _angular_core.InputSignal<string>;
+    readonly appearance: _angular_core.InputSignal<MatFormFieldAppearance>;
+    readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly clearable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly value: _angular_core.ModelSignal<unknown>;
+    readonly optionSelected: _angular_core.OutputEmitterRef<AcpSearchSelectSelection<T, unknown>>;
+    readonly cleared: _angular_core.OutputEmitterRef<void>;
+    /** Raw text typed by the user; debounce it in the consumer for server-side search. */
+    readonly searchChange: _angular_core.OutputEmitterRef<string>;
+    private readonly input;
+    private readonly trigger;
+    private readonly inputEl;
+    readonly optionTemplate: _angular_core.Signal<TemplateRef<AcpSearchSelectOptionContext<T>> | undefined>;
+    /** Text typed by the user; `null` while not searching. */
+    protected readonly query: _angular_core.WritableSignal<string | null>;
+    private readonly formDisabled;
+    protected readonly isDisabled: _angular_core.Signal<boolean>;
+    private onChange;
+    private onTouched;
+    protected readonly errorStateMatcher: ErrorStateMatcher;
+    constructor();
+    /** The inner `matInput` has no `NgControl`, so it never refreshes its error state by itself. */
+    ngDoCheck(): void;
+    private readonly groups;
+    protected readonly filteredGroups: _angular_core.Signal<GroupVm<T>[]>;
+    private readonly selected;
+    protected readonly text: _angular_core.Signal<string>;
+    protected readonly hasValue: _angular_core.Signal<boolean>;
+    protected readonly displayWith: (option: OptionVm<T> | string | null) => string;
+    /** Clears the selection and the search text. */
+    clear(): void;
+    protected selectAll(event: Event): void;
+    protected onInput(event: Event): void;
+    /** Leaving the field without picking drops the typed text and shows the selection again. */
+    protected onBlur(): void;
+    /** The panel also closes while typing (e.g. no results yet); keep the text in that case. */
+    protected onClosed(): void;
+    protected onSelected(event: MatAutocompleteSelectedEvent): void;
+    writeValue(value: unknown): void;
+    registerOnChange(fn: (value: unknown) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    private setValue;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AcpSearchSelect<any>, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AcpSearchSelect<any>, "acp-search-select", ["acpSearchSelect"], { "items": { "alias": "items"; "required": true; "isSignal": true; }; "bindLabel": { "alias": "bindLabel"; "required": false; "isSignal": true; }; "bindValue": { "alias": "bindValue"; "required": false; "isSignal": true; }; "children": { "alias": "children"; "required": false; "isSignal": true; }; "groupLabel": { "alias": "groupLabel"; "required": false; "isSignal": true; }; "compareWith": { "alias": "compareWith"; "required": false; "isSignal": true; }; "filterFn": { "alias": "filterFn"; "required": false; "isSignal": true; }; "localFilter": { "alias": "localFilter"; "required": false; "isSignal": true; }; "emptyValue": { "alias": "emptyValue"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "errorText": { "alias": "errorText"; "required": false; "isSignal": true; }; "noResultsText": { "alias": "noResultsText"; "required": false; "isSignal": true; }; "loadingText": { "alias": "loadingText"; "required": false; "isSignal": true; }; "clearLabel": { "alias": "clearLabel"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "optionSelected": "optionSelected"; "cleared": "cleared"; "searchChange": "searchChange"; }, ["optionTemplate"], never, true, never>;
+}
+
 declare class UserIcon {
     size: _angular_core.InputSignal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<UserIcon, never>;
@@ -4051,53 +4030,47 @@ declare class AcpCheckboxGroup implements AfterViewInit, OnDestroy, ControlValue
 }
 
 /**
- * Card appearance variants
+ * Card appearance variants. Mirrors Angular Material's `MatCardAppearance`
+ * (`elevated` maps to Material's `raised`).
  */
-type AcpCardAppearance = 'default' | 'outlined' | 'elevated' | 'filled' | 'interactive' | 'compact';
+type AcpCardAppearance = 'elevated' | 'outlined' | 'filled';
 /**
- * Card elevation levels (Material Design)
+ * Card elevation levels, mapped to `--mat-sys-level{n}`. Only applies to `elevated` cards.
  */
 type AcpCardElevation = 0 | 1 | 2 | 3 | 4 | 5;
 /**
- * Card padding options
+ * Content padding options.
  */
 type AcpCardPadding = 'none' | 'small' | 'medium' | 'large';
 /**
- * Card background color variants (Material Design)
+ * Card color variants based on Material Design 3 system roles.
  */
-type AcpCardBackgroundColor = 'primary' | 'primary-container' | 'secondary' | 'secondary-container' | 'error' | 'error-container' | 'surface' | 'surface-variant' | 'surface-container-highest' | 'surface-container-high' | 'surface-container' | 'surface-container-low' | 'surface-container-lowest' | 'inverse-surface' | 'disabled-bg';
+type AcpCardColor = 'primary' | 'primary-container' | 'secondary' | 'secondary-container' | 'tertiary' | 'tertiary-container' | 'error' | 'error-container' | 'surface' | 'surface-variant' | 'surface-container-highest' | 'surface-container-high' | 'surface-container' | 'surface-container-low' | 'surface-container-lowest' | 'inverse-surface' | 'disabled-bg';
 /**
- * Card image aspect ratio
+ * Media aspect ratio.
  */
 type AcpCardImageRatio = '1:1' | '4:3' | '16:9' | '21:9' | '3:2' | '3:4';
 /**
- * Card configuration interface
+ * Horizontal alignment of the actions slot (same as `mat-card-actions[align]`).
+ */
+type AcpCardActionsAlign = 'start' | 'end';
+/**
+ * Application-wide or subtree defaults for `acp-card`.
+ * Provide them with `provideAcpCardDefaults()` or the `ACP_CARD_DEFAULT_OPTIONS` token.
+ * Inputs set on an individual card always win.
  */
 interface AcpCardConfig {
     appearance?: AcpCardAppearance;
     elevation?: AcpCardElevation;
     rounded?: boolean | number;
-    hover?: boolean;
-    clickable?: boolean;
-    outlined?: boolean;
-    loading?: boolean;
-    disabled?: boolean;
     padding?: AcpCardPadding;
+    color?: AcpCardColor;
+    hoverable?: boolean;
+    actionsAlign?: AcpCardActionsAlign;
     imageRatio?: AcpCardImageRatio;
-    fullHeight?: boolean;
-    fullWidth?: boolean;
-}
-/**
- * Card badge configuration
- */
-interface AcpCardBadge {
-    content: string | number;
-    color?: 'primary' | 'secondary' | 'accent' | 'error' | 'success' | 'warning' | 'info';
-    position?: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
 }
 /**
- * Pass Through options for card sections
- * Allows customization of classes, styles, and attributes for each section
+ * Pass-through classes and styles for a single card section.
  */
 interface AcpCardPassThroughSection {
     class?: string | string[] | Record<string, boolean>;
@@ -4116,135 +4089,209 @@ interface AcpCardPassThroughOptions {
     footer?: AcpCardPassThroughSection | undefined;
 }
 
+/**
+ * Defaults for every `acp-card` in the injector tree. Mirrors `MAT_CARD_CONFIG`.
+ * Can also be provided at component level: `providers: [{ provide: ACP_CARD_DEFAULT_OPTIONS, useValue }]`.
+ */
+declare const ACP_CARD_DEFAULT_OPTIONS: InjectionToken<AcpCardConfig>;
+/**
+ * Registers application-wide card defaults, e.g.:
+ * `provideAcpCardDefaults({ appearance: 'outlined', rounded: 16 })`.
+ */
+declare function provideAcpCardDefaults(defaults: AcpCardConfig): EnvironmentProviders;
+
+/**
+ * Typed slot directives for `acp-card`. Preferred over `#title`-style template refs:
+ * they are type-checked, discoverable and never collide with refs of nested components.
+ *
+ * @example
+ * ```html
+ * <acp-card>
+ *   <ng-template acpCardTitle>Order #123</ng-template>
+ *   <p>Body</p>
+ *   <ng-template acpCardActions><acp-button text="Open" /></ng-template>
+ * </acp-card>
+ * ```
+ */
+declare class AcpCardHeader {
+    readonly templateRef: TemplateRef<any>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AcpCardHeader, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<AcpCardHeader, "ng-template[acpCardHeader]", never, {}, {}, never, never, true, never>;
+}
+declare class AcpCardMedia {
+    readonly templateRef: TemplateRef<any>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AcpCardMedia, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<AcpCardMedia, "ng-template[acpCardMedia]", never, {}, {}, never, never, true, never>;
+}
+declare class AcpCardAvatar {
+    readonly templateRef: TemplateRef<any>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AcpCardAvatar, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<AcpCardAvatar, "ng-template[acpCardAvatar]", never, {}, {}, never, never, true, never>;
+}
+declare class AcpCardTitle {
+    readonly templateRef: TemplateRef<any>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AcpCardTitle, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<AcpCardTitle, "ng-template[acpCardTitle]", never, {}, {}, never, never, true, never>;
+}
+declare class AcpCardSubtitle {
+    readonly templateRef: TemplateRef<any>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AcpCardSubtitle, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<AcpCardSubtitle, "ng-template[acpCardSubtitle]", never, {}, {}, never, never, true, never>;
+}
+declare class AcpCardActions {
+    readonly templateRef: TemplateRef<any>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AcpCardActions, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<AcpCardActions, "ng-template[acpCardActions]", never, {}, {}, never, never, true, never>;
+}
+declare class AcpCardFooter {
+    readonly templateRef: TemplateRef<any>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AcpCardFooter, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<AcpCardFooter, "ng-template[acpCardFooter]", never, {}, {}, never, never, true, never>;
+}
+declare const ACP_CARD_SLOTS: readonly [typeof AcpCardHeader, typeof AcpCardMedia, typeof AcpCardAvatar, typeof AcpCardTitle, typeof AcpCardSubtitle, typeof AcpCardActions, typeof AcpCardFooter];
+
 declare class AcpCard {
-    readonly appearance: _angular_core.InputSignal<AcpCardAppearance>;
-    readonly elevation: _angular_core.InputSignal<AcpCardElevation>;
-    readonly rounded: _angular_core.InputSignal<number | boolean>;
-    readonly hover: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    private readonly defaults;
+    readonly title: _angular_core.InputSignal<string | undefined>;
+    readonly subtitle: _angular_core.InputSignal<string | undefined>;
+    readonly appearance: _angular_core.InputSignal<AcpCardAppearance | undefined>;
+    readonly color: _angular_core.InputSignal<AcpCardColor | undefined>;
+    readonly elevation: _angular_core.InputSignal<AcpCardElevation | undefined>;
+    /** `true` = theme radius, `false` = square, number = radius in px. */
+    readonly rounded: _angular_core.InputSignal<number | boolean | undefined>;
+    readonly padding: _angular_core.InputSignal<AcpCardPadding | undefined>;
+    readonly hoverable: _angular_core.InputSignalWithTransform<boolean | undefined, unknown>;
+    readonly actionsAlign: _angular_core.InputSignal<AcpCardActionsAlign | undefined>;
+    /** Aspect ratio applied to the media slot. Media keeps its natural size when unset. */
+    readonly imageRatio: _angular_core.InputSignal<AcpCardImageRatio | undefined>;
     readonly clickable: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    readonly outlined: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    readonly padding: _angular_core.InputSignal<AcpCardPadding>;
-    readonly imageRatio: _angular_core.InputSignal<AcpCardImageRatio>;
+    readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly fullHeight: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly fullWidth: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    readonly backgroundColor: _angular_core.InputSignal<AcpCardBackgroundColor | undefined>;
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
     readonly passThrough: _angular_core.InputSignal<AcpCardPassThroughOptions>;
-    headerTemplate: TemplateRef<any>;
-    mediaTemplate: TemplateRef<any>;
-    avatarTemplate: TemplateRef<any>;
-    titleTemplate: TemplateRef<any>;
-    subtitleTemplate: TemplateRef<any>;
-    actionsTemplate: TemplateRef<any>;
-    footerTemplate: TemplateRef<any>;
-    get role(): string;
-    get tabindex(): string | null;
-    get ariaDisabled(): string | null;
+    /** Emitted on click, Enter or Space when `clickable` and not disabled/loading. */
+    readonly clicked: _angular_core.OutputEmitterRef<MouseEvent | KeyboardEvent>;
+    private readonly headerDir;
+    private readonly mediaDir;
+    private readonly avatarDir;
+    private readonly titleDir;
+    private readonly subtitleDir;
+    private readonly actionsDir;
+    private readonly footerDir;
+    private readonly headerRef;
+    private readonly mediaRef;
+    private readonly avatarRef;
+    private readonly titleRef;
+    private readonly subtitleRef;
+    private readonly actionsRef;
+    private readonly footerRef;
+    readonly headerTpl: _angular_core.Signal<TemplateRef<any> | undefined>;
+    readonly mediaTpl: _angular_core.Signal<TemplateRef<any> | undefined>;
+    readonly avatarTpl: _angular_core.Signal<TemplateRef<any> | undefined>;
+    readonly titleTpl: _angular_core.Signal<TemplateRef<any> | undefined>;
+    readonly subtitleTpl: _angular_core.Signal<TemplateRef<any> | undefined>;
+    readonly actionsTpl: _angular_core.Signal<TemplateRef<any> | undefined>;
+    readonly footerTpl: _angular_core.Signal<TemplateRef<any> | undefined>;
+    readonly hasTitleGroup: _angular_core.Signal<boolean>;
+    readonly resolvedAppearance: _angular_core.Signal<AcpCardAppearance>;
+    readonly matAppearance: _angular_core.Signal<"filled" | "outlined" | "raised">;
+    readonly resolvedPadding: _angular_core.Signal<AcpCardPadding>;
+    readonly resolvedColor: _angular_core.Signal<AcpCardColor | undefined>;
+    readonly resolvedHoverable: _angular_core.Signal<boolean>;
+    readonly resolvedActionsAlign: _angular_core.Signal<AcpCardActionsAlign>;
+    readonly mediaRatio: _angular_core.Signal<string | undefined>;
+    readonly interactive: _angular_core.Signal<boolean>;
+    readonly shape: _angular_core.Signal<string | null>;
+    readonly elevationShadow: _angular_core.Signal<string | null>;
+    readonly hostClasses: _angular_core.Signal<string>;
+    onActivate(event: MouseEvent): void;
+    onKeyActivate(event: Event): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AcpCard, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AcpCard, "acp-card", never, { "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "elevation": { "alias": "elevation"; "required": false; "isSignal": true; }; "rounded": { "alias": "rounded"; "required": false; "isSignal": true; }; "hover": { "alias": "hover"; "required": false; "isSignal": true; }; "clickable": { "alias": "clickable"; "required": false; "isSignal": true; }; "outlined": { "alias": "outlined"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "padding": { "alias": "padding"; "required": false; "isSignal": true; }; "imageRatio": { "alias": "imageRatio"; "required": false; "isSignal": true; }; "fullHeight": { "alias": "fullHeight"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "backgroundColor": { "alias": "backgroundColor"; "required": false; "isSignal": true; }; "passThrough": { "alias": "passThrough"; "required": false; "isSignal": true; }; }, {}, ["headerTemplate", "mediaTemplate", "avatarTemplate", "titleTemplate", "subtitleTemplate", "actionsTemplate", "footerTemplate"], ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AcpCard, "acp-card", ["acpCard"], { "title": { "alias": "title"; "required": false; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "elevation": { "alias": "elevation"; "required": false; "isSignal": true; }; "rounded": { "alias": "rounded"; "required": false; "isSignal": true; }; "padding": { "alias": "padding"; "required": false; "isSignal": true; }; "hoverable": { "alias": "hoverable"; "required": false; "isSignal": true; }; "actionsAlign": { "alias": "actionsAlign"; "required": false; "isSignal": true; }; "imageRatio": { "alias": "imageRatio"; "required": false; "isSignal": true; }; "clickable": { "alias": "clickable"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "fullHeight": { "alias": "fullHeight"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "passThrough": { "alias": "passThrough"; "required": false; "isSignal": true; }; }, { "clicked": "clicked"; }, ["headerDir", "mediaDir", "avatarDir", "titleDir", "subtitleDir", "actionsDir", "footerDir", "headerRef", "mediaRef", "avatarRef", "titleRef", "subtitleRef", "actionsRef", "footerRef"], ["*"], true, never>;
 }
 
-type AcpKpiCardColor = 'primary' | 'secondary' | 'success' | 'success-light' | 'warning' | 'warning-light' | 'error' | 'error-light' | 'info' | 'info-light' | 'neutral' | 'white' | 'custom';
+type AcpKpiCardColor = 'primary' | 'secondary' | 'success' | 'success-light' | 'warning' | 'warning-light' | 'error' | 'error-light' | 'info' | 'info-light' | 'neutral' | 'surface' | 'custom';
 type AcpKpiCardVariant = 'default' | 'elevated' | 'outlined' | 'filled' | 'tonal';
 type AcpKpiCardSize = 'xs' | 'sm' | 'md' | 'lg';
+/** Horizontal alignment of header, value and text. */
+type AcpKpiCardAlign = 'start' | 'center' | 'end';
+/** Direction of the change. `none` hides the trend icon. */
 type AcpKpiCardTrend = 'up' | 'down' | 'neutral' | 'none';
+/** Whether the change is good or bad for the business; drives the delta badge color. */
+type AcpKpiCardTrendSentiment = 'positive' | 'negative' | 'neutral';
 interface AcpKpiCardTrendConfig {
     icon: string;
-    color: AcpKpiCardColor;
     ariaLabel: string;
 }
-interface AcpKpiCardLayout {
-    title: boolean;
-    subtitle: boolean;
-    value: boolean;
-    description: boolean;
-    trend: boolean;
-    percentage: boolean;
-    icon: boolean;
-    avatar: boolean;
-    actions: boolean;
-    footer: boolean;
-    progress: boolean;
-}
 
 declare class AcpKpiCard {
-    title: _angular_core.InputSignal<string | undefined>;
-    subtitle: _angular_core.InputSignal<string | undefined>;
-    value: _angular_core.InputSignal<string | number | undefined>;
-    description: _angular_core.InputSignal<string | undefined>;
-    footer: _angular_core.InputSignal<string | undefined>;
-    variant: _angular_core.InputSignal<AcpKpiCardVariant>;
-    color: _angular_core.InputSignal<AcpKpiCardColor>;
-    size: _angular_core.InputSignal<AcpKpiCardSize>;
-    icon: _angular_core.InputSignal<string | undefined>;
-    svgIcon: _angular_core.InputSignal<string | undefined>;
-    avatar: _angular_core.InputSignal<string | undefined>;
-    avatarInitials: _angular_core.InputSignal<string | undefined>;
-    trend: _angular_core.InputSignal<AcpKpiCardTrend>;
-    percentage: _angular_core.InputSignal<string | number | undefined>;
-    percentageFormat: _angular_core.InputSignal<"number" | "percent">;
-    progress: _angular_core.InputSignal<number | undefined>;
-    progressColor: _angular_core.InputSignal<AcpKpiCardColor>;
-    loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    clickable: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    selected: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    routerLink: _angular_core.InputSignal<string | any[] | null>;
-    href: _angular_core.InputSignal<string | null>;
-    ariaLabel: _angular_core.InputSignal<string | undefined>;
-    tooltip: _angular_core.InputSignal<string | undefined>;
-    clicked: _angular_core.OutputEmitterRef<void>;
-    actionClicked: _angular_core.OutputEmitterRef<string>;
-    isHovered: _angular_core.WritableSignal<boolean>;
-    iconTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
-    avatarTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
-    footerTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
-    actionsTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
-    isTrending: _angular_core.Signal<boolean>;
-    trendConfig: _angular_core.Signal<_acontplus_ng_components.AcpKpiCardTrendConfig>;
-    effectiveIcon: _angular_core.Signal<string | undefined>;
-    trendColor: _angular_core.Signal<AcpKpiCardColor>;
-    hasHeader: _angular_core.Signal<boolean>;
-    hasFooter: _angular_core.Signal<boolean>;
-    hasActions: _angular_core.Signal<boolean>;
-    hostClasses: _angular_core.Signal<string>;
+    private readonly defaultLocale;
+    readonly title: _angular_core.InputSignal<string | undefined>;
+    readonly subtitle: _angular_core.InputSignal<string | undefined>;
+    /** Numbers are formatted with `Intl.NumberFormat`; strings are shown as-is. */
+    readonly value: _angular_core.InputSignal<string | number | null | undefined>;
+    readonly valueFormat: _angular_core.InputSignal<Intl.NumberFormatOptions | undefined>;
+    readonly prefix: _angular_core.InputSignal<string | undefined>;
+    readonly suffix: _angular_core.InputSignal<string | undefined>;
+    readonly description: _angular_core.InputSignal<string | undefined>;
+    readonly footer: _angular_core.InputSignal<string | undefined>;
+    /** BCP 47 locale for number formatting. Defaults to the app `LOCALE_ID`. */
+    readonly locale: _angular_core.InputSignal<string | undefined>;
+    readonly variant: _angular_core.InputSignal<AcpKpiCardVariant>;
+    readonly color: _angular_core.InputSignal<AcpKpiCardColor>;
+    readonly size: _angular_core.InputSignal<AcpKpiCardSize>;
+    readonly align: _angular_core.InputSignal<AcpKpiCardAlign>;
+    readonly icon: _angular_core.InputSignal<string | undefined>;
+    readonly svgIcon: _angular_core.InputSignal<string | undefined>;
+    readonly avatar: _angular_core.InputSignal<string | undefined>;
+    readonly avatarInitials: _angular_core.InputSignal<string | undefined>;
+    readonly percentage: _angular_core.InputSignal<string | number | null | undefined>;
+    readonly percentageFormat: _angular_core.InputSignal<"number" | "percent">;
+    /** Direction of the change. Inferred from the sign of `percentage` when unset. */
+    readonly trend: _angular_core.InputSignal<AcpKpiCardTrend | undefined>;
+    /** Invert the badge color for metrics where a decrease is good (costs, churn, errors). */
+    readonly lowerIsBetter: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Comparison context shown next to the change, e.g. "vs last month". */
+    readonly trendLabel: _angular_core.InputSignal<string | undefined>;
+    /** Show the trend arrow inside the change badge. */
+    readonly showTrendIcon: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly progress: _angular_core.InputSignal<number | undefined>;
+    readonly progressColor: _angular_core.InputSignal<AcpKpiCardColor | undefined>;
+    readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly clickable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly selected: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly routerLink: _angular_core.InputSignal<string | any[] | null>;
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
+    readonly menuAriaLabel: _angular_core.InputSignal<string>;
+    readonly tooltip: _angular_core.InputSignal<string | undefined>;
+    /** Emitted on click, Enter or Space when `clickable`. */
+    readonly clicked: _angular_core.OutputEmitterRef<void>;
+    readonly iconTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
+    readonly avatarTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
+    readonly footerTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
+    readonly actionsTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
+    private readonly resolvedLocale;
+    readonly formattedValue: _angular_core.Signal<string | null>;
+    readonly formattedDelta: _angular_core.Signal<string | null>;
+    readonly resolvedTrend: _angular_core.Signal<AcpKpiCardTrend>;
+    readonly trendConfig: _angular_core.Signal<_acontplus_ng_components.AcpKpiCardTrendConfig>;
+    readonly sentiment: _angular_core.Signal<AcpKpiCardTrendSentiment>;
+    readonly hasHeader: _angular_core.Signal<boolean>;
+    readonly hasFooter: _angular_core.Signal<boolean>;
+    readonly interactive: _angular_core.Signal<boolean>;
+    readonly hostClasses: _angular_core.Signal<string>;
     onCardClick(): void;
-    onActionClick(action: string, event: Event): void;
-    onMouseEnter(): void;
-    onMouseLeave(): void;
+    onCardKey(event: Event): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AcpKpiCard, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AcpKpiCard, "acp-kpi-card", ["acpKpiCard"], { "title": { "alias": "title"; "required": false; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "footer": { "alias": "footer"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "svgIcon": { "alias": "svgIcon"; "required": false; "isSignal": true; }; "avatar": { "alias": "avatar"; "required": false; "isSignal": true; }; "avatarInitials": { "alias": "avatarInitials"; "required": false; "isSignal": true; }; "trend": { "alias": "trend"; "required": false; "isSignal": true; }; "percentage": { "alias": "percentage"; "required": false; "isSignal": true; }; "percentageFormat": { "alias": "percentageFormat"; "required": false; "isSignal": true; }; "progress": { "alias": "progress"; "required": false; "isSignal": true; }; "progressColor": { "alias": "progressColor"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "clickable": { "alias": "clickable"; "required": false; "isSignal": true; }; "selected": { "alias": "selected"; "required": false; "isSignal": true; }; "routerLink": { "alias": "routerLink"; "required": false; "isSignal": true; }; "href": { "alias": "href"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; }, { "clicked": "clicked"; "actionClicked": "actionClicked"; }, ["iconTemplate", "avatarTemplate", "footerTemplate", "actionsTemplate"], never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AcpKpiCard, "acp-kpi-card", ["acpKpiCard"], { "title": { "alias": "title"; "required": false; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "prefix": { "alias": "prefix"; "required": false; "isSignal": true; }; "suffix": { "alias": "suffix"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "footer": { "alias": "footer"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "align": { "alias": "align"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "svgIcon": { "alias": "svgIcon"; "required": false; "isSignal": true; }; "avatar": { "alias": "avatar"; "required": false; "isSignal": true; }; "avatarInitials": { "alias": "avatarInitials"; "required": false; "isSignal": true; }; "percentage": { "alias": "percentage"; "required": false; "isSignal": true; }; "percentageFormat": { "alias": "percentageFormat"; "required": false; "isSignal": true; }; "trend": { "alias": "trend"; "required": false; "isSignal": true; }; "lowerIsBetter": { "alias": "lowerIsBetter"; "required": false; "isSignal": true; }; "trendLabel": { "alias": "trendLabel"; "required": false; "isSignal": true; }; "showTrendIcon": { "alias": "showTrendIcon"; "required": false; "isSignal": true; }; "progress": { "alias": "progress"; "required": false; "isSignal": true; }; "progressColor": { "alias": "progressColor"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "clickable": { "alias": "clickable"; "required": false; "isSignal": true; }; "selected": { "alias": "selected"; "required": false; "isSignal": true; }; "routerLink": { "alias": "routerLink"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "menuAriaLabel": { "alias": "menuAriaLabel"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; }, { "clicked": "clicked"; }, ["iconTemplate", "avatarTemplate", "footerTemplate", "actionsTemplate"], never, true, never>;
 }
 
 declare const KPI_CARD_TREND_CONFIGS: Record<AcpKpiCardTrend, AcpKpiCardTrendConfig>;
-declare function formatValue(value: number | string, format?: string): string;
-
-declare const KPI_CARD_TOKENS: {
-    SIZE_SM: string;
-    SIZE_MD: string;
-    SIZE_LG: string;
-    VARIANT_DEFAULT: string;
-    VARIANT_ELEVATED: string;
-    VARIANT_OUTLINED: string;
-    VARIANT_FILLED: string;
-    VARIANT_TONAL: string;
-    COLOR_PRIMARY: string;
-    COLOR_SECONDARY: string;
-    COLOR_SUCCESS: string;
-    COLOR_SUCCESS_LIGHT: string;
-    COLOR_WARNING: string;
-    COLOR_WARNING_LIGHT: string;
-    COLOR_ERROR: string;
-    COLOR_ERROR_LIGHT: string;
-    COLOR_INFO: string;
-    COLOR_INFO_LIGHT: string;
-    COLOR_NEUTRAL: string;
-    COLOR_CUSTOM: string;
-    TREND_UP: string;
-    TREND_DOWN: string;
-    TREND_NEUTRAL: string;
-    TREND_NONE: string;
-};
+/** Infers the trend direction from a numeric or numeric-string delta (`'+12.5'`, `-3`). */
+declare function inferKpiTrend(delta: number | string | null | undefined): AcpKpiCardTrend;
 
 declare class Branding {
     readonly logo: _angular_core.InputSignal<string | null>;
@@ -5394,5 +5441,5 @@ declare class StatusDisplayPipe implements PipeTransform {
     static ɵpipe: _angular_core.ɵɵPipeDeclaration<StatusDisplayPipe, "statusDisplay", true>;
 }
 
-export { ACP_ACTIVE_DATE_DEBOUNCE, ACP_BADGE_COLORS, ACP_BADGE_SHAPES, ACP_BADGE_SIZES, ACP_BADGE_VARIANTS, ACP_DATE_OPTION_TYPE, ACP_DEFAULT_DATE_OPTIONS, ACP_DIALOG_ACTIONS, ACP_DIALOG_DATA, ACP_DIALOG_DEFAULT_OPTIONS, ACP_DIALOG_TITLEBAR, ACP_DRAWER_DATA, ACP_DRAWER_DEFAULT_OPTIONS, ACP_POPOVER_CONTENT, ACP_POPOVER_DEFAULT_OPTIONS, ACP_POPOVER_SCROLL_STRATEGY, AcpAlert, AcpBadge, AcpButton, AcpCard, AcpCheckboxBase, AcpCheckboxGroup, AcpContextMenu, AcpContextMenuDirective, AcpContextMenuPanel, AcpContextMenuService, AcpDateRangeInput, AcpDialog, AcpDialogActions, AcpDialogContainer, AcpDialogContent, AcpDialogRef, AcpDialogService, AcpDialogTitlebar, AcpDrawer, AcpDrawerConfig, AcpDrawerContainer, AcpDrawerRef, AcpHeader, AcpHeaderActions, AcpHeaderBranding, AcpHeaderCenter, AcpHeaderEnd, AcpHeaderLanguage, AcpHeaderNotifications, AcpHeaderStart, AcpHeaderTheme, AcpHeaderWorkspace, AcpKpiCard, AcpPopover, AcpPopoverContent, AcpPopoverTarget, AcpPopoverTrigger, AcpSelectDateOption, AcpShellLayout, AcpShellSlotHeader, AcpShellSlotSidebar, AcpShellSlotSidebarFooter, AcpShellSlotToolbar, AcpShellSlotTopmenu, AcpSidebar, AcpSidebarBranding, AcpSidebarContent, AcpSidebarHeader, AcpSidebarToggle, AcpSidebarUserPanel, AcpTopmenu, AcpTopmenuPanel, AdvancedDialogService, Branding, Button, CONTEXT_MENU_DATA, CONTEXT_MENU_ITEMS, DATA_GRID_DEFAULT_OPTIONS, DataGrid, DateRangePicker, DialogWrapper, DialogZIndexService, DynamicCard, DynamicSelect, GetTotalPipe, IconRegistryService, InputChip, KPI_CARD_TOKENS, KPI_CARD_TREND_CONFIGS, KeyboardNavigationService, NavAccordionDirective, NavAccordionItemDirective, NavAccordionToggleDirective, OverlayService, Pagination, SidemenuComponent, Spinner, StatusDisplayPipe, SvgIcon, TREND_CONFIGS, TabulatorTable, ThemeSwitcher, ThemeToggle, ToUpperCase, UserIcon, UserMenu, UserPanel, _AcpPopoverContentBase, formatValue, provideAcpDialogDefaults };
-export type { AcpAlertType, AcpBadgeColor, AcpBadgeShape, AcpBadgeSize, AcpBadgeTrend, AcpBadgeTrendConfig, AcpBadgeVariant, AcpButtonAppearance$1 as AcpButtonAppearance, AcpButtonColor$1 as AcpButtonColor, AcpButtonSize, AcpButtonType$1 as AcpButtonType, AcpButtonVariant$1 as AcpButtonVariant, AcpCardAppearance, AcpCardBackgroundColor, AcpCardBadge, AcpCardConfig, AcpCardElevation, AcpCardImageRatio, AcpCardPadding, AcpCardPassThroughOptions, AcpCardPassThroughSection, AcpCheckboxGroupOption, AcpContextMenuItem, AcpContextMenuItemContext, AcpContextMenuOpenConfig, AcpContextMenuPosition, AcpContextMenuRef, AcpContextMenuTriggerConfig, AcpDialogAction, AcpDialogActionClick, AcpDialogActionState, AcpDialogActionsOutlet, AcpDialogCloseConfig, AcpDialogComponentLoader, AcpDialogConfig, AcpDialogContainerData, AcpDialogContentFunction, AcpDialogContentInput, AcpDialogDirection, AcpDialogHeaderConfig, AcpDialogResolvedContent, AcpDialogRestoreFocus, AcpDialogSize, AcpDialogTitlebarOutlet, AcpDir, AcpHeaderAction, AcpHeaderActionEvent, AcpHeaderBrandingConfig, AcpHeaderConfig, AcpHeaderPos, AcpHeaderUserMenuConfig, AcpHeaderUserMenuItem, AcpHeaderUserMenuItemEvent, AcpKpiCardColor, AcpKpiCardLayout, AcpKpiCardSize, AcpKpiCardTrend, AcpKpiCardTrendConfig, AcpKpiCardVariant, AcpLanguageItem, AcpNavPos, AcpNotificationItem, AcpPopoverDefaultOptions, AcpPopoverPanel, AcpPopoverPosition, AcpPopoverPositionEnd, AcpPopoverPositionStart, AcpPopoverTriggerEvent, AcpSelectedDateEvent, AcpThemeVariant, AcpTopmenuChildItem, AcpTopmenuItem, AcpTopmenuPermissions, AcpTopmenuTag, AcpWorkspaceItem, AutoFocusTarget, DataGridButtonType, DataGridCellTemplate, DataGridColumn, DataGridColumnButton, DataGridColumnButtonBadge, DataGridColumnButtonPop, DataGridColumnButtonTooltip, DataGridColumnPinOption, DataGridColumnPinValue, DataGridColumnTag, DataGridColumnTagValue, DataGridColumnType, DataGridColumnTypeParameter, DataGridDefaultOptions, DataGridMenuItem, DataGridRowClassFormatter, DataGridRowSelectionFormatter, DataGridSortProp, DateRangePickerOptions, DateRangeValue, DialogSize, DialogType, DialogWrapperConfig, DrawerPosition, FocusableElement, IAcpSelectDateOption, IconRegistryConfig, MatCustomDialogConfig, MenuItem, MenuPermissions, MenuTag, PaginationOptions, PopoverCloseReason, TabulatorColumn, TabulatorConfig, TabulatorEventHandlers, TabulatorTheme, UserMenuItem, UserMenuSelectedEvent, UserProfile };
+export { ACP_ACTIVE_DATE_DEBOUNCE, ACP_BADGE_COLORS, ACP_BADGE_SHAPES, ACP_BADGE_SIZES, ACP_BADGE_VARIANTS, ACP_CARD_DEFAULT_OPTIONS, ACP_CARD_SLOTS, ACP_DATE_OPTION_TYPE, ACP_DEFAULT_DATE_OPTIONS, ACP_DIALOG_ACTIONS, ACP_DIALOG_DATA, ACP_DIALOG_DEFAULT_OPTIONS, ACP_DIALOG_TITLEBAR, ACP_DRAWER_DATA, ACP_DRAWER_DEFAULT_OPTIONS, ACP_POPOVER_CONTENT, ACP_POPOVER_DEFAULT_OPTIONS, ACP_POPOVER_SCROLL_STRATEGY, AcpAlert, AcpBadge, AcpButton, AcpCard, AcpCardActions, AcpCardAvatar, AcpCardFooter, AcpCardHeader, AcpCardMedia, AcpCardSubtitle, AcpCardTitle, AcpCheckboxBase, AcpCheckboxGroup, AcpContextMenu, AcpContextMenuDirective, AcpContextMenuPanel, AcpContextMenuService, AcpDateRangeInput, AcpDialog, AcpDialogActions, AcpDialogContainer, AcpDialogContent, AcpDialogRef, AcpDialogService, AcpDialogTitlebar, AcpDrawer, AcpDrawerConfig, AcpDrawerContainer, AcpDrawerRef, AcpHeader, AcpHeaderActions, AcpHeaderBranding, AcpHeaderCenter, AcpHeaderEnd, AcpHeaderLanguage, AcpHeaderNotifications, AcpHeaderStart, AcpHeaderTheme, AcpHeaderWorkspace, AcpKpiCard, AcpPopover, AcpPopoverContent, AcpPopoverTarget, AcpPopoverTrigger, AcpSearchSelect, AcpSelectDateOption, AcpShellLayout, AcpShellSlotHeader, AcpShellSlotSidebar, AcpShellSlotSidebarFooter, AcpShellSlotToolbar, AcpShellSlotTopmenu, AcpSidebar, AcpSidebarBranding, AcpSidebarContent, AcpSidebarHeader, AcpSidebarToggle, AcpSidebarUserPanel, AcpTopmenu, AcpTopmenuPanel, AdvancedDialogService, Branding, Button, CONTEXT_MENU_DATA, CONTEXT_MENU_ITEMS, DATA_GRID_DEFAULT_OPTIONS, DataGrid, DateRangePicker, DialogWrapper, DialogZIndexService, DynamicSelect, GetTotalPipe, IconRegistryService, InputChip, KPI_CARD_TREND_CONFIGS, KeyboardNavigationService, NavAccordionDirective, NavAccordionItemDirective, NavAccordionToggleDirective, OverlayService, Pagination, SidemenuComponent, Spinner, StatusDisplayPipe, SvgIcon, TREND_CONFIGS, TabulatorTable, ThemeSwitcher, ThemeToggle, ToUpperCase, UserIcon, UserMenu, UserPanel, _AcpPopoverContentBase, acpSearchSelectLooseEquals, acpSearchSelectNormalize, inferKpiTrend, provideAcpCardDefaults, provideAcpDialogDefaults };
+export type { AcpAlertType, AcpBadgeColor, AcpBadgeShape, AcpBadgeSize, AcpBadgeTrend, AcpBadgeTrendConfig, AcpBadgeVariant, AcpButtonAppearance$1 as AcpButtonAppearance, AcpButtonColor$1 as AcpButtonColor, AcpButtonSize, AcpButtonType$1 as AcpButtonType, AcpButtonVariant$1 as AcpButtonVariant, AcpCardActionsAlign, AcpCardAppearance, AcpCardColor, AcpCardConfig, AcpCardElevation, AcpCardImageRatio, AcpCardPadding, AcpCardPassThroughOptions, AcpCardPassThroughSection, AcpCheckboxGroupOption, AcpContextMenuItem, AcpContextMenuItemContext, AcpContextMenuOpenConfig, AcpContextMenuPosition, AcpContextMenuRef, AcpContextMenuTriggerConfig, AcpDialogAction, AcpDialogActionClick, AcpDialogActionState, AcpDialogActionsOutlet, AcpDialogCloseConfig, AcpDialogComponentLoader, AcpDialogConfig, AcpDialogContainerData, AcpDialogContentFunction, AcpDialogContentInput, AcpDialogDirection, AcpDialogHeaderConfig, AcpDialogResolvedContent, AcpDialogRestoreFocus, AcpDialogSize, AcpDialogTitlebarOutlet, AcpDir, AcpHeaderAction, AcpHeaderActionEvent, AcpHeaderBrandingConfig, AcpHeaderConfig, AcpHeaderPos, AcpHeaderUserMenuConfig, AcpHeaderUserMenuItem, AcpHeaderUserMenuItemEvent, AcpKpiCardAlign, AcpKpiCardColor, AcpKpiCardSize, AcpKpiCardTrend, AcpKpiCardTrendConfig, AcpKpiCardTrendSentiment, AcpKpiCardVariant, AcpLanguageItem, AcpNavPos, AcpNotificationItem, AcpPopoverDefaultOptions, AcpPopoverPanel, AcpPopoverPosition, AcpPopoverPositionEnd, AcpPopoverPositionStart, AcpPopoverTriggerEvent, AcpSearchSelectAccessor, AcpSearchSelectOptionContext, AcpSearchSelectSelection, AcpSelectedDateEvent, AcpThemeVariant, AcpTopmenuChildItem, AcpTopmenuItem, AcpTopmenuPermissions, AcpTopmenuTag, AcpWorkspaceItem, AutoFocusTarget, DataGridButtonType, DataGridCellTemplate, DataGridColumn, DataGridColumnButton, DataGridColumnButtonBadge, DataGridColumnButtonPop, DataGridColumnButtonTooltip, DataGridColumnPinOption, DataGridColumnPinValue, DataGridColumnTag, DataGridColumnTagValue, DataGridColumnType, DataGridColumnTypeParameter, DataGridDefaultOptions, DataGridMenuItem, DataGridRowClassFormatter, DataGridRowSelectionFormatter, DataGridSortProp, DateRangePickerOptions, DateRangeValue, DialogSize, DialogType, DialogWrapperConfig, DrawerPosition, FocusableElement, IAcpSelectDateOption, IconRegistryConfig, MatCustomDialogConfig, MenuItem, MenuPermissions, MenuTag, PaginationOptions, PopoverCloseReason, TabulatorColumn, TabulatorConfig, TabulatorEventHandlers, TabulatorTheme, UserMenuItem, UserMenuSelectedEvent, UserProfile };