@elasticias/ui 1.0.48 → 1.0.50

package/types/elasticias-ui.d.ts

@@ -1,8 +1,10 @@
 import * as _angular_core from '@angular/core';
-import { PipeTransform, OnInit, OnChanges, TemplateRef, EventEmitter, AfterContentInit, OnDestroy, SimpleChanges, InjectionToken, AfterViewInit } from '@angular/core';
+import { PipeTransform, OnInit, EventEmitter, TemplateRef, OnChanges, AfterContentInit, OnDestroy, SimpleChanges, InjectionToken, AfterViewInit } from '@angular/core';
 import * as _elasticias_screens from '@elasticias/screens';
 import { EfDataCardColumn, ScreenContext, EfDetailToolbarAction, EfSearchToolbarAction, EfDataCardSort, EfDataCardExportRequest, EfDateRange, EfDatePresetKey } from '@elasticias/screens';
 export { EfBoundedDateRange, EfDataCardColumn, EfDataCardColumnAlign, EfDataCardColumnMobileRole, EfDataCardColumnType, EfDataCardSort, EfDataCardSortDirection, EfDatePresetKey, EfDateRange, EfDetailToolbarAction, EfSearchToolbarAction } from '@elasticias/screens';
+import { Observable } from 'rxjs';
+import { EfPage, Permissions, EmailMetrics, EmailEventRecord, EmailEventKind } from '@elasticias/types';
 import { Menu } from 'primeng/menu';
 import * as _elasticias_core from '@elasticias/core';
 import { EfBuildPackage, EfSessionIdleService, EfModule, EfNavSection, EfNavItem, EfModuleId, EfToast, EfToastAction, EfThemeConfigService } from '@elasticias/core';
@@ -16,7 +18,6 @@ import { InputNumber, InputNumberInputEvent } from 'primeng/inputnumber';
 import { Nullable } from 'primeng/ts-helpers';
 import * as _elasticias_ui from '@elasticias/ui';
 import { Table, TableLazyLoadEvent } from 'primeng/table';
-import { Permissions, EmailMetrics, EmailEventRecord, EmailEventKind } from '@elasticias/types';
 import { PrimeNG } from 'primeng/config';
 
 /**
@@ -69,6 +70,20 @@ declare class EfQuantitySelectorComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfQuantitySelectorComponent, "ef-quantity-selector", never, { "quantity": { "alias": "quantity"; "required": false; "isSignal": true; }; }, { "quantityChange": "quantityChange"; }, never, never, true, never>;
 }
 
+/**
+ * Which catalogue price a new order line starts from.
+ * - `wholesale`: the ERP channel price (`variant.price`, then `product.unitPrice`,
+ *   which mirrors the default variant's, then `product.salePrice`). B2B sales orders.
+ * - `retail`: the shop price (`variant.salePrice`, then `product.salePrice`). A Web
+ *   order must cost what the shop charges, and the shop sells a variant at its
+ *   `salePrice` only: an unpriced variant is not sold, so retail never falls back to
+ *   the wholesale price, and `compareAtPrice` (the "was" price) is never charged.
+ *   With no shop price the line starts at 0 for the staff to set.
+ */
+type EfOrderPriceList = 'wholesale' | 'retail';
+/** The unit price a new line for `product` (and its chosen `variant`) starts at under `priceList`. */
+declare function defaultUnitPrice(product: Record<string, unknown>, variant: Record<string, unknown> | null | undefined, priceList?: EfOrderPriceList): number;
+
 /**
  * Summary item for product count groups
  */
@@ -90,7 +105,7 @@ interface OrderProductsSummary {
  */
 interface OrderLineItem {
     id?: string | number;
-    product?: Record<string, unknown>;
+    product?: Record<string, unknown> | null;
     productId?: unknown;
     variantId?: string | null;
     countGroup?: string;
@@ -124,6 +139,8 @@ interface OrderEntity {
     grossTotal: number;
     discountTotal: number;
     taxTotal: number;
+    /** Delivery amount (TTC). Absent or 0 for orders without one (B2B, POS). */
+    shippingTotal?: number;
     finalTotal: number;
     notes?: string;
     internalNotes?: string;
@@ -132,6 +149,17 @@ interface OrderEntity {
     billingAddress?: string;
     productsSummary?: OrderProductsSummary;
 }
+/**
+ * The person an order goes to when there is no client to pick (a storefront
+ * order placed by a shopper). The builder shows it read-only in place of the
+ * customer select.
+ */
+interface EfOrderRecipient {
+    name: string;
+    phone?: string | null;
+    city?: string | null;
+    address?: string | null;
+}
 /**
  * Configuration for document types (order, invoice, quote)
  */
@@ -198,8 +226,9 @@ declare class OrderLineItemHelper {
     /**
      * Create a line item from product selection
      * @param keyField - Field name used to identify the product (default: 'id')
+     * @param priceList - Which catalogue price the line starts at (see `EfOrderPriceList`)
      */
-    static createFromProduct(product: Record<string, unknown>, quantity?: number, keyField?: string, variantId?: string): OrderLineItem;
+    static createFromProduct(product: Record<string, unknown>, quantity?: number, keyField?: string, variantId?: string, priceList?: EfOrderPriceList): OrderLineItem;
     /**
      * Update calculations for an existing line item
      */
@@ -221,6 +250,13 @@ declare class OrderEntityHelper {
      * Create a new empty order entity
      */
     static createEmpty(documentType?: 'order' | 'invoice' | 'quote'): OrderEntity;
+    /**
+     * Round to the centime, half away from zero, as the backend does
+     * (`Math.Round(x, 2, MidpointRounding.AwayFromZero)` on a decimal). The
+     * product goes through 15 significant digits first so a binary value such
+     * as 1.00499999... rounds as the decimal 1.005 would.
+     */
+    static roundMoney(value: number): number;
     /**
      * Calculate all totals for an order
      */
@@ -387,19 +423,57 @@ interface ProductTypeaheadRow {
 /** Numeric line columns that support inline click-to-edit. */
 type EditableLineField = 'price' | 'qty' | 'discount' | 'tva';
 declare class EfOrderBuilderComponent implements OnInit {
-    rowTrackBy: (_: number, item: OrderLineItem) => string | number;
+    rowTrackBy: (_: number, item: OrderLineItem) => string | number | undefined;
     config: _angular_core.InputSignal<DocumentConfig>;
     order: _angular_core.ModelSignal<OrderEntity>;
     products: _angular_core.InputSignal<Record<string, unknown>[]>;
     customers: _angular_core.InputSignal<Record<string, unknown>[]>;
+    /**
+     * Who the order goes to when it has no client to pick (a storefront order).
+     * When set, the header shows it read-only instead of the customer select,
+     * `customers` may be `[]` and the order validates without a `customerId`.
+     * Null keeps the customer select and its required rule.
+     */
+    recipient: _angular_core.InputSignal<EfOrderRecipient | null>;
+    /**
+     * Calling code (`'212'` or `'+212'`) for a national recipient phone, so the
+     * `tel:` link dials `+212612345678` for `0612345678` from anywhere.
+     */
+    defaultCallingCode: _angular_core.InputSignal<string>;
+    /**
+     * `tel:` target for the recipient's phone: E.164 when it can be made, else
+     * the digits as typed (a national number still dials inside the country).
+     */
+    recipientTel: _angular_core.Signal<string | null>;
     readonly: _angular_core.InputSignal<boolean>;
     countGroupLabels: _angular_core.InputSignal<ProductCountGroupLabel[]>;
     /** Field name used to identify products (must match catalogue's trackByField) */
     productKeyField: _angular_core.InputSignal<string>;
+    /**
+     * Which catalogue price a new line starts at, in quick-add, its typeahead
+     * and the catalogue: `'wholesale'` (default, B2B sales) or `'retail'`, the
+     * shop price a Web order is charged. Lines already on the order keep theirs.
+     */
+    priceList: _angular_core.InputSignal<EfOrderPriceList>;
     backendErrors: _angular_core.InputSignal<{
         [key: string]: string[];
     }>;
-    /** Optional change-history entries; when non-empty the Historique rail card renders. */
+    /**
+     * Delivery amount (TTC) the host owns. It is the builder's only fee source:
+     * the rail, the bound order and `exportOrder()` all total it, so the saved
+     * total is the one shown. A host without a fee (B2B) leaves it at 0, and
+     * the bound order then carries no `shippingTotal` at all. A negative or
+     * non-numeric fee is treated as 0.
+     */
+    shippingTotal: _angular_core.InputSignalWithTransform<number, number | null | undefined>;
+    /**
+     * Optional change-history entries; when non-empty the Historique rail card renders.
+     *
+     * Host cards that belong in the rail (a delivery card, internal notes) are
+     * projected with the `obRail` attribute: `<ef-card obRail ...>`. They sit
+     * after the totals and the recap and before the history, as a column at
+     * desktop width and inside the drawer below that or in focus mode.
+     */
     auditEntries: _angular_core.InputSignal<EfChangeHistoryEntry[]>;
     openCatalogue: _angular_core.OutputEmitterRef<void>;
     orderChanged: _angular_core.OutputEmitterRef<OrderChangeInfo>;
@@ -407,7 +481,7 @@ declare class EfOrderBuilderComponent implements OnInit {
     productsAdded: _angular_core.OutputEmitterRef<OrderLineItem[]>;
     private originalOrder;
     private initialized;
-    quickAddSelection: _angular_core.WritableSignal<ProductTypeaheadSelection>;
+    quickAddSelection: _angular_core.WritableSignal<ProductTypeaheadSelection | null>;
     quickAddPrice: _angular_core.WritableSignal<number>;
     quickAddQuantity: _angular_core.WritableSignal<number>;
     quickAddDisabled: _angular_core.Signal<boolean>;
@@ -426,7 +500,7 @@ declare class EfOrderBuilderComponent implements OnInit {
     }>;
     hasErrors: _angular_core.Signal<boolean>;
     isValid: _angular_core.Signal<boolean>;
-    changeInfo: _angular_core.Signal<OrderChangeInfo>;
+    changeInfo: _angular_core.Signal<OrderChangeInfo | null>;
     hasChanges: _angular_core.Signal<boolean>;
     focusMode: _angular_core.ModelSignal<boolean>;
     railOpen: _angular_core.WritableSignal<boolean>;
@@ -439,7 +513,7 @@ declare class EfOrderBuilderComponent implements OnInit {
     editingCell: _angular_core.WritableSignal<{
         id: OrderLineItem["id"];
         field: EditableLineField;
-    }>;
+    } | null>;
     /**
      * Columns for the lines table.
      *
@@ -506,11 +580,18 @@ declare class EfOrderBuilderComponent implements OnInit {
         grossTotal: number;
         discountTotal: number;
         tvaTotal: number;
+        shippingTotal: number;
         finalTotal: number;
     };
     exportOrder(): OrderEntity;
+    /**
+     * The bound order with its totals, the fee taken from the `shippingTotal`
+     * input. Without a fee the order carries no `shippingTotal`, so a B2B order
+     * stays exactly as it came in.
+     */
+    private withTotals;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<EfOrderBuilderComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfOrderBuilderComponent, "ef-order-builder", never, { "config": { "alias": "config"; "required": false; "isSignal": true; }; "order": { "alias": "order"; "required": true; "isSignal": true; }; "products": { "alias": "products"; "required": true; "isSignal": true; }; "customers": { "alias": "customers"; "required": true; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "countGroupLabels": { "alias": "countGroupLabels"; "required": false; "isSignal": true; }; "productKeyField": { "alias": "productKeyField"; "required": false; "isSignal": true; }; "backendErrors": { "alias": "backendErrors"; "required": false; "isSignal": true; }; "auditEntries": { "alias": "auditEntries"; "required": false; "isSignal": true; }; "focusMode": { "alias": "focusMode"; "required": false; "isSignal": true; }; }, { "order": "orderChange"; "openCatalogue": "openCatalogue"; "orderChanged": "orderChanged"; "orderValidated": "orderValidated"; "productsAdded": "productsAdded"; "focusMode": "focusModeChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfOrderBuilderComponent, "ef-order-builder", never, { "config": { "alias": "config"; "required": false; "isSignal": true; }; "order": { "alias": "order"; "required": true; "isSignal": true; }; "products": { "alias": "products"; "required": true; "isSignal": true; }; "customers": { "alias": "customers"; "required": true; "isSignal": true; }; "recipient": { "alias": "recipient"; "required": false; "isSignal": true; }; "defaultCallingCode": { "alias": "defaultCallingCode"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "countGroupLabels": { "alias": "countGroupLabels"; "required": false; "isSignal": true; }; "productKeyField": { "alias": "productKeyField"; "required": false; "isSignal": true; }; "priceList": { "alias": "priceList"; "required": false; "isSignal": true; }; "backendErrors": { "alias": "backendErrors"; "required": false; "isSignal": true; }; "shippingTotal": { "alias": "shippingTotal"; "required": false; "isSignal": true; }; "auditEntries": { "alias": "auditEntries"; "required": false; "isSignal": true; }; "focusMode": { "alias": "focusMode"; "required": false; "isSignal": true; }; }, { "order": "orderChange"; "openCatalogue": "openCatalogue"; "orderChanged": "orderChanged"; "orderValidated": "orderValidated"; "productsAdded": "productsAdded"; "focusMode": "focusModeChange"; }, never, ["[obRail]"], true, never>;
 }
 
 /**
@@ -544,6 +625,11 @@ declare class EfProductTypeaheadComponent {
      * variant + unit price) is identical either way.
      */
     showVariants: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Which catalogue price each row shows and its selection carries: the
+     * wholesale price (default) or the shop price for a Web order.
+     */
+    priceList: _angular_core.InputSignal<EfOrderPriceList>;
     productSelect: _angular_core.OutputEmitterRef<ProductTypeaheadSelection>;
     query: _angular_core.WritableSignal<string>;
     open: _angular_core.WritableSignal<boolean>;
@@ -566,195 +652,7 @@ declare class EfProductTypeaheadComponent {
     /** Clear the field after the consumer has consumed the selection. */
     reset(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<EfProductTypeaheadComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfProductTypeaheadComponent, "ef-product-typeahead", never, { "products": { "alias": "products"; "required": true; "isSignal": true; }; "productKeyField": { "alias": "productKeyField"; "required": false; "isSignal": true; }; "placeholderKey": { "alias": "placeholderKey"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "currency": { "alias": "currency"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "showVariants": { "alias": "showVariants"; "required": false; "isSignal": true; }; }, { "productSelect": "productSelect"; }, never, never, true, never>;
-}
-
-interface CategoryItem {
-    code: string;
-    label: string;
-    description?: string | null;
-    isActive: boolean;
-    sortOrder: number;
-    metadata?: Record<string, unknown> | null;
-    children?: CategoryItem[];
-}
-interface CategoryGroup {
-    code: string;
-    label: string;
-    description?: string | null;
-    isActive: boolean;
-    sortOrder: number;
-    metadata?: Record<string, unknown> | null;
-    children?: CategoryItem[];
-}
-interface CategoryAssignment {
-    type: string;
-    code: string;
-}
-interface SelectedFilter {
-    type: string;
-    code: string;
-    label: string;
-}
-declare class EfProductCatalogueFilterComponent {
-    /**
-     * PrimeNG's Button reads `autofocus || buttonProps?.autofocus`, so a bare
-     * `false` collapses to `undefined` and its AutoFocus directive writes the
-     * attribute anyway. Passing the flag here too makes it resolve to `false`.
-     */
-    protected readonly noAutofocus: {
-        autofocus: boolean;
-    };
-    /** Category groups from reference_data (product_categories items with children) */
-    categoryGroups: _angular_core.InputSignal<CategoryGroup[]>;
-    /** Products to calculate counts */
-    products: _angular_core.InputSignal<{
-        categoryAssignments?: CategoryAssignment[];
-    }[]>;
-    /** Selected filters (two-way binding) */
-    selectedFilters: _angular_core.ModelSignal<SelectedFilter[]>;
-    /** Emitted when filters change */
-    filtersChanged: _angular_core.OutputEmitterRef<SelectedFilter[]>;
-    /** Search terms for each category group */
-    searchTerms: _angular_core.WritableSignal<Record<string, string>>;
-    /** Accordion panel values (expanded panels) */
-    expandedPanels: _angular_core.Signal<string[]>;
-    /** Get filtered children for a category group based on search */
-    getFilteredChildren(group: CategoryGroup): CategoryItem[];
-    /** Get product count for a specific category item */
-    getItemCount(groupCode: string, itemCode: string): number;
-    /** Check if a filter is selected */
-    isFilterSelected(groupCode: string, itemCode: string): boolean;
-    /** Toggle a filter selection */
-    toggleFilter(group: CategoryGroup, item: CategoryItem): void;
-    /** Remove a specific filter */
-    removeFilter(filter: SelectedFilter): void;
-    /** Clear all filters */
-    clearAllFilters(): void;
-    /** Update search term for a category group */
-    updateSearchTerm(groupCode: string, term: string): void;
-    /** Get color class from metadata if available */
-    getColorClass(item: CategoryItem): string | null;
-    /** Check if group should show search input (more than 5 items) */
-    shouldShowSearch(group: CategoryGroup): boolean;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<EfProductCatalogueFilterComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfProductCatalogueFilterComponent, "ef-product-catalogue-filter", never, { "categoryGroups": { "alias": "categoryGroups"; "required": true; "isSignal": true; }; "products": { "alias": "products"; "required": true; "isSignal": true; }; "selectedFilters": { "alias": "selectedFilters"; "required": false; "isSignal": true; }; }, { "selectedFilters": "selectedFiltersChange"; "filtersChanged": "filtersChanged"; }, never, never, true, never>;
-}
-
-interface CatalogueProductVariant {
-    variantId: string;
-    title: string;
-    sku?: string | null;
-    price: number;
-    compareAtPrice?: number | null;
-    optionValues?: Record<string, string>;
-    isActive?: boolean;
-    countGroup?: string | null;
-    [key: string]: unknown;
-}
-interface CatalogueProduct {
-    id: number;
-    productCode: string;
-    name: string;
-    displayName: string;
-    unitPrice?: number | null;
-    packagingVolume?: number | null;
-    categoryAssignments?: CategoryAssignment[];
-    productType?: string | null;
-    variants?: CatalogueProductVariant[];
-    defaultVariantId?: string | null;
-    [key: string]: unknown;
-}
-declare class EfProductCatalogueComponent implements OnChanges {
-    private readonly locale;
-    private readonly currencyPipe;
-    /** Products to display */
-    products: _angular_core.InputSignal<CatalogueProduct[]>;
-    /** Category groups for filtering */
-    categoryGroups: _angular_core.InputSignal<CategoryGroup[]>;
-    /** Initial selected items (for editing existing orders) */
-    initialSelectedItems: _angular_core.InputSignal<{
-        productId?: unknown;
-        quantity: number;
-        variantId?: string | null;
-    }[]>;
-    /** Default filters to apply on init */
-    defaultFilters: _angular_core.InputSignal<SelectedFilter[]>;
-    /** Property name used as unique key for tracking products in the list */
-    trackByField: _angular_core.InputSignal<string>;
-    /** Currency code for price formatting */
-    currencyCode: _angular_core.InputSignal<string>;
-    /** Locale used for number/currency formatting and the quantity stepper */
-    localeCode: _angular_core.InputSignal<string>;
-    /**
-     * Custom product thumbnail template.
-     * Context: { $implicit: CatalogueProduct }
-     *
-     * @example
-     * <ef-product-catalogue [products]="products()">
-     *   <ng-template #productThumbnail let-product>
-     *     <my-custom-thumbnail [product]="product" />
-     *   </ng-template>
-     * </ef-product-catalogue>
-     */
-    productThumbnailTpl: _angular_core.Signal<TemplateRef<unknown>>;
-    sortMenu: Menu;
-    /** Emitted when products are validated */
-    productsValidated: _angular_core.OutputEmitterRef<{
-        product: CatalogueProduct;
-        quantity: number;
-        variantId?: string;
-    }[]>;
-    productSearch: _angular_core.WritableSignal<string>;
-    selectedFilters: _angular_core.WritableSignal<SelectedFilter[]>;
-    selectedSort: _angular_core.WritableSignal<string>;
-    selectedProducts: _angular_core.WritableSignal<{
-        product: CatalogueProduct;
-        quantity: number;
-        variantId?: string;
-    }[]>;
-    /** Tracks the currently selected variantId per product key */
-    selectedVariants: _angular_core.WritableSignal<Record<string, string>>;
-    filteredProducts: _angular_core.Signal<CatalogueProduct[]>;
-    sortOptions: {
-        label: string;
-        icon: string;
-        command: () => void;
-    }[];
-    onFiltersChanged(filters: SelectedFilter[]): void;
-    ngOnChanges(): void;
-    productKey(product: CatalogueProduct): unknown;
-    private initializeSelectedProducts;
-    private initializeDefaultFilters;
-    toggleSortMenu(event: Event): void;
-    /** Composite key for tracking product+variant selections */
-    private selectionKey;
-    /** Get the selected variantId for a product, or its defaultVariantId */
-    getSelectedVariantId(product: CatalogueProduct): string | undefined;
-    /** Set the selected variant for a product */
-    setSelectedVariant(product: CatalogueProduct, variantId: string): void;
-    /** Check if product is a VARIABLE product with variants */
-    isVariableProduct(product: CatalogueProduct): boolean;
-    /** Get active variants for a product */
-    getActiveVariants(product: CatalogueProduct): CatalogueProductVariant[];
-    /** Get total quantity for a product across all its variants */
-    getProductQuantity(product: CatalogueProduct): number;
-    /** Get quantity for a specific product+variant combination */
-    getVariantQuantity(product: CatalogueProduct, variantId: string): number;
-    addProduct(product: CatalogueProduct): void;
-    removeProduct(product: CatalogueProduct): void;
-    removeVariantSelection(product: CatalogueProduct, variantId: string): void;
-    updateProductQuantity(product: CatalogueProduct, quantity: number): void;
-    updateVariantQuantity(product: CatalogueProduct, variantId: string, quantity: number): void;
-    validateSelection(): void;
-    getPackagingLabel(product: CatalogueProduct): string;
-    getVariantTitle(product: CatalogueProduct, variantId: string): string;
-    trackKey(product: CatalogueProduct): unknown;
-    formatPrice(product: CatalogueProduct): string;
-    formatVariantPrice(variant: CatalogueProductVariant): string;
-    private formatCurrency;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<EfProductCatalogueComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfProductCatalogueComponent, "ef-product-catalogue", never, { "products": { "alias": "products"; "required": false; "isSignal": true; }; "categoryGroups": { "alias": "categoryGroups"; "required": false; "isSignal": true; }; "initialSelectedItems": { "alias": "initialSelectedItems"; "required": false; "isSignal": true; }; "defaultFilters": { "alias": "defaultFilters"; "required": false; "isSignal": true; }; "trackByField": { "alias": "trackByField"; "required": false; "isSignal": true; }; "currencyCode": { "alias": "currencyCode"; "required": false; "isSignal": true; }; "localeCode": { "alias": "localeCode"; "required": false; "isSignal": true; }; }, { "productsValidated": "productsValidated"; }, ["productThumbnailTpl"], never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfProductTypeaheadComponent, "ef-product-typeahead", never, { "products": { "alias": "products"; "required": true; "isSignal": true; }; "productKeyField": { "alias": "productKeyField"; "required": false; "isSignal": true; }; "placeholderKey": { "alias": "placeholderKey"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "currency": { "alias": "currency"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "showVariants": { "alias": "showVariants"; "required": false; "isSignal": true; }; "priceList": { "alias": "priceList"; "required": false; "isSignal": true; }; }, { "productSelect": "productSelect"; }, never, never, true, never>;
 }
 
 /**
@@ -952,6 +850,305 @@ declare class EfDialogComponent {
     static ngAcceptInputType_saveDisabled: unknown;
 }
 
+/** A product as the picker shows it. The caller maps its own DTO to this. */
+interface EfProductPickerItem {
+    id: string;
+    /** Internal reference, shown in a mono column. */
+    reference?: string;
+    title: string;
+    /** Public image url, displayed as given (it comes from the backend). */
+    thumbnailUrl?: string;
+    /** One muted line of context ("Femme - publie"), already translated. */
+    meta?: string;
+    /** Shown but not pickable, for a product that is already in. */
+    disabled?: boolean;
+}
+/** What the picker asks the caller's search function for. */
+interface EfProductPickerQuery {
+    text: string;
+    pageNumber: number;
+    pageSize: number;
+}
+
+/**
+ * Multi-select product picker: a dialog that searches the caller's catalogue
+ * page by page and hands back the ids the operator ticked. Data-agnostic: it
+ * knows nothing of collections or promotions, only a search function.
+ *
+ * Built from `ef-dialog` + `ef-smart-bar` + `ef-data-card` (select column,
+ * image column). The selection survives paging and new searches. The whole
+ * row is the toggle, 48px tall. On a phone (`EfViewportService`, <= 767px)
+ * the dialog is full screen and the table becomes a list whose row head is
+ * the toggle.
+ *
+ * `[(open)]` is two-way. The picker closes itself on X, Escape, Cancel and
+ * after a confirm, sets `open` back to false and emits `(closed)` each time.
+ * Each open starts over: empty selection, empty search, page one.
+ *
+ * Rows are toggle buttons (`ef-data-card` `rowPressed`): one tab stop each,
+ * Enter and Space toggle, `aria-pressed` says the state. The tick in the
+ * row is a picture of that state, not a second control. A `disabled` item is
+ * dimmed, `aria-disabled`, and cannot be picked.
+ *
+ * ```html
+ * <ef-product-picker
+ *   [(open)]="pickerOpen"
+ *   [search]="searchCandidates"
+ *   titleKey="collections_products_picker_title"
+ *   (confirm)="addProducts($event)"
+ * />
+ * ```
+ */
+declare class EfProductPickerComponent {
+    private readonly viewport;
+    private readonly destroyRef;
+    /** Two-way: `[(open)]="pickerOpen"`. The picker sets it back to false
+     *  on every close path, so the next open always opens. */
+    readonly open: _angular_core.ModelSignal<boolean>;
+    /** Called for every page and search. Map the caller's DTO to items. */
+    readonly search: _angular_core.InputSignal<(q: EfProductPickerQuery) => Observable<EfPage<EfProductPickerItem>>>;
+    readonly titleKey: _angular_core.InputSignal<string>;
+    readonly confirmLabelKey: _angular_core.InputSignal<string>;
+    readonly searchPlaceholderKey: _angular_core.InputSignal<string>;
+    readonly pageSize: _angular_core.InputSignal<number>;
+    /** The ticked ids, in the order they were ticked. */
+    readonly confirm: _angular_core.OutputEmitterRef<string[]>;
+    readonly closed: _angular_core.OutputEmitterRef<void>;
+    /** The list screen behind the dialog already owns the search shortcut. */
+    readonly searchShortcut: null;
+    protected readonly isMobile: _angular_core.Signal<boolean>;
+    private readonly selected;
+    readonly selectedIds: _angular_core.Signal<string[]>;
+    protected readonly selectedCount: _angular_core.Signal<number>;
+    protected readonly searchText: _angular_core.WritableSignal<string>;
+    protected readonly appliedText: _angular_core.WritableSignal<string>;
+    protected readonly pageNumber: _angular_core.WritableSignal<number>;
+    protected readonly rows: _angular_core.WritableSignal<readonly EfProductPickerItem[]>;
+    protected readonly totalCount: _angular_core.WritableSignal<number>;
+    protected readonly loading: _angular_core.WritableSignal<boolean>;
+    protected readonly errorMsg: _angular_core.WritableSignal<string>;
+    private readonly queries;
+    private lastQuery;
+    protected readonly pageSizeOptions: _angular_core.Signal<number[]>;
+    protected readonly dialogSize: _angular_core.Signal<"lg" | "full">;
+    protected readonly dialogClass: _angular_core.Signal<"ef-product-picker-dialog ef-product-picker-dialog--fullscreen" | "ef-product-picker-dialog">;
+    /** Desktop: a table. Phone: one composed cell, so the list row carries
+     *  the tick, the thumb, the reference and the title without an expander. */
+    protected readonly columns: _angular_core.Signal<EfDataCardColumn[]>;
+    protected readonly actions: _angular_core.Signal<EfDialogAction[]>;
+    constructor();
+    onSearch(text: string): void;
+    onClear(): void;
+    onPageChange(page: number): void;
+    retry(): void;
+    isSelected(id: string): boolean;
+    /** Row state for ef-data-card. Arrow functions: data-card calls them. */
+    protected readonly rowPressed: (row: EfProductPickerItem) => boolean;
+    protected readonly rowDisabled: (row: EfProductPickerItem) => boolean;
+    toggle(item: EfProductPickerItem | null | undefined): void;
+    onVisibleChange(visible: boolean): void;
+    private startOver;
+    private run;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<EfProductPickerComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfProductPickerComponent, "ef-product-picker", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "search": { "alias": "search"; "required": true; "isSignal": true; }; "titleKey": { "alias": "titleKey"; "required": false; "isSignal": true; }; "confirmLabelKey": { "alias": "confirmLabelKey"; "required": false; "isSignal": true; }; "searchPlaceholderKey": { "alias": "searchPlaceholderKey"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "confirm": "confirm"; "closed": "closed"; }, never, never, true, never>;
+}
+
+interface CategoryItem {
+    code: string;
+    label: string;
+    description?: string | null;
+    isActive: boolean;
+    sortOrder: number;
+    metadata?: Record<string, unknown> | null;
+    children?: CategoryItem[];
+}
+interface CategoryGroup {
+    code: string;
+    label: string;
+    description?: string | null;
+    isActive: boolean;
+    sortOrder: number;
+    metadata?: Record<string, unknown> | null;
+    children?: CategoryItem[];
+}
+interface CategoryAssignment {
+    type: string;
+    code: string;
+}
+interface SelectedFilter {
+    type: string;
+    code: string;
+    label: string;
+}
+declare class EfProductCatalogueFilterComponent {
+    /**
+     * PrimeNG's Button reads `autofocus || buttonProps?.autofocus`, so a bare
+     * `false` collapses to `undefined` and its AutoFocus directive writes the
+     * attribute anyway. Passing the flag here too makes it resolve to `false`.
+     */
+    protected readonly noAutofocus: {
+        autofocus: boolean;
+    };
+    /** Category groups from reference_data (product_categories items with children) */
+    categoryGroups: _angular_core.InputSignal<CategoryGroup[]>;
+    /** Products to calculate counts */
+    products: _angular_core.InputSignal<{
+        categoryAssignments?: CategoryAssignment[];
+    }[]>;
+    /** Selected filters (two-way binding) */
+    selectedFilters: _angular_core.ModelSignal<SelectedFilter[]>;
+    /** Emitted when filters change */
+    filtersChanged: _angular_core.OutputEmitterRef<SelectedFilter[]>;
+    /** Search terms for each category group */
+    searchTerms: _angular_core.WritableSignal<Record<string, string>>;
+    /** Accordion panel values (expanded panels) */
+    expandedPanels: _angular_core.Signal<string[]>;
+    /** Get filtered children for a category group based on search */
+    getFilteredChildren(group: CategoryGroup): CategoryItem[];
+    /** Get product count for a specific category item */
+    getItemCount(groupCode: string, itemCode: string): number;
+    /** Check if a filter is selected */
+    isFilterSelected(groupCode: string, itemCode: string): boolean;
+    /** Toggle a filter selection */
+    toggleFilter(group: CategoryGroup, item: CategoryItem): void;
+    /** Remove a specific filter */
+    removeFilter(filter: SelectedFilter): void;
+    /** Clear all filters */
+    clearAllFilters(): void;
+    /** Update search term for a category group */
+    updateSearchTerm(groupCode: string, term: string): void;
+    /** Get color class from metadata if available */
+    getColorClass(item: CategoryItem): string | null;
+    /** Check if group should show search input (more than 5 items) */
+    shouldShowSearch(group: CategoryGroup): boolean;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<EfProductCatalogueFilterComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfProductCatalogueFilterComponent, "ef-product-catalogue-filter", never, { "categoryGroups": { "alias": "categoryGroups"; "required": true; "isSignal": true; }; "products": { "alias": "products"; "required": true; "isSignal": true; }; "selectedFilters": { "alias": "selectedFilters"; "required": false; "isSignal": true; }; }, { "selectedFilters": "selectedFiltersChange"; "filtersChanged": "filtersChanged"; }, never, never, true, never>;
+}
+
+interface CatalogueProductVariant {
+    variantId: string;
+    title: string;
+    sku?: string | null;
+    price: number;
+    compareAtPrice?: number | null;
+    optionValues?: Record<string, string>;
+    isActive?: boolean;
+    countGroup?: string | null;
+    [key: string]: unknown;
+}
+interface CatalogueProduct {
+    id: number;
+    productCode: string;
+    name: string;
+    displayName: string;
+    unitPrice?: number | null;
+    packagingVolume?: number | null;
+    categoryAssignments?: CategoryAssignment[];
+    productType?: string | null;
+    variants?: CatalogueProductVariant[];
+    defaultVariantId?: string | null;
+    [key: string]: unknown;
+}
+declare class EfProductCatalogueComponent implements OnChanges {
+    private readonly locale;
+    private readonly currencyPipe;
+    /** Products to display */
+    products: _angular_core.InputSignal<CatalogueProduct[]>;
+    /** Category groups for filtering */
+    categoryGroups: _angular_core.InputSignal<CategoryGroup[]>;
+    /** Initial selected items (for editing existing orders) */
+    initialSelectedItems: _angular_core.InputSignal<{
+        productId?: unknown;
+        quantity: number;
+        variantId?: string | null;
+    }[]>;
+    /** Default filters to apply on init */
+    defaultFilters: _angular_core.InputSignal<SelectedFilter[]>;
+    /** Property name used as unique key for tracking products in the list */
+    trackByField: _angular_core.InputSignal<string>;
+    /** Currency code for price formatting */
+    currencyCode: _angular_core.InputSignal<string>;
+    /**
+     * Which price the cards show: `'wholesale'` (default) or `'retail'`, the shop price.
+     * Bind the same value as the order builder's `priceList`, so a card shows the price
+     * of the line it adds (the rule lives in `defaultUnitPrice`).
+     */
+    priceList: _angular_core.InputSignal<EfOrderPriceList>;
+    /** Locale used for number/currency formatting and the quantity stepper */
+    localeCode: _angular_core.InputSignal<string>;
+    /**
+     * Custom product thumbnail template.
+     * Context: { $implicit: CatalogueProduct }
+     *
+     * @example
+     * <ef-product-catalogue [products]="products()">
+     *   <ng-template #productThumbnail let-product>
+     *     <my-custom-thumbnail [product]="product" />
+     *   </ng-template>
+     * </ef-product-catalogue>
+     */
+    productThumbnailTpl: _angular_core.Signal<TemplateRef<unknown> | undefined>;
+    sortMenu: Menu;
+    /** Emitted when products are validated */
+    productsValidated: _angular_core.OutputEmitterRef<{
+        product: CatalogueProduct;
+        quantity: number;
+        variantId?: string;
+    }[]>;
+    productSearch: _angular_core.WritableSignal<string>;
+    selectedFilters: _angular_core.WritableSignal<SelectedFilter[]>;
+    selectedSort: _angular_core.WritableSignal<string>;
+    selectedProducts: _angular_core.WritableSignal<{
+        product: CatalogueProduct;
+        quantity: number;
+        variantId?: string;
+    }[]>;
+    /** Tracks the currently selected variantId per product key */
+    selectedVariants: _angular_core.WritableSignal<Record<string, string>>;
+    filteredProducts: _angular_core.Signal<CatalogueProduct[]>;
+    sortOptions: {
+        label: string;
+        icon: string;
+        command: () => void;
+    }[];
+    onFiltersChanged(filters: SelectedFilter[]): void;
+    ngOnChanges(): void;
+    productKey(product: CatalogueProduct): unknown;
+    private initializeSelectedProducts;
+    private initializeDefaultFilters;
+    toggleSortMenu(event: Event): void;
+    /** Composite key for tracking product+variant selections */
+    private selectionKey;
+    /** Get the selected variantId for a product, or its defaultVariantId */
+    getSelectedVariantId(product: CatalogueProduct): string | undefined;
+    /** Set the selected variant for a product */
+    setSelectedVariant(product: CatalogueProduct, variantId: string): void;
+    /** Check if product is a VARIABLE product with variants */
+    isVariableProduct(product: CatalogueProduct): boolean;
+    /** Get active variants for a product */
+    getActiveVariants(product: CatalogueProduct): CatalogueProductVariant[];
+    /** Get total quantity for a product across all its variants */
+    getProductQuantity(product: CatalogueProduct): number;
+    /** Get quantity for a specific product+variant combination */
+    getVariantQuantity(product: CatalogueProduct, variantId: string): number;
+    addProduct(product: CatalogueProduct): void;
+    removeProduct(product: CatalogueProduct): void;
+    removeVariantSelection(product: CatalogueProduct, variantId: string): void;
+    updateProductQuantity(product: CatalogueProduct, quantity: number): void;
+    updateVariantQuantity(product: CatalogueProduct, variantId: string, quantity: number): void;
+    validateSelection(): void;
+    getPackagingLabel(product: CatalogueProduct): string;
+    getVariantTitle(product: CatalogueProduct, variantId: string): string;
+    trackKey(product: CatalogueProduct): unknown;
+    /** The price a variant (or a simple product, `variant` null) is shown at under the active list. */
+    private priceOf;
+    formatPrice(product: CatalogueProduct): string;
+    formatVariantPrice(variant: CatalogueProductVariant, product?: CatalogueProduct): string;
+    private formatCurrency;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<EfProductCatalogueComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfProductCatalogueComponent, "ef-product-catalogue", never, { "products": { "alias": "products"; "required": false; "isSignal": true; }; "categoryGroups": { "alias": "categoryGroups"; "required": false; "isSignal": true; }; "initialSelectedItems": { "alias": "initialSelectedItems"; "required": false; "isSignal": true; }; "defaultFilters": { "alias": "defaultFilters"; "required": false; "isSignal": true; }; "trackByField": { "alias": "trackByField"; "required": false; "isSignal": true; }; "currencyCode": { "alias": "currencyCode"; "required": false; "isSignal": true; }; "priceList": { "alias": "priceList"; "required": false; "isSignal": true; }; "localeCode": { "alias": "localeCode"; "required": false; "isSignal": true; }; }, { "productsValidated": "productsValidated"; }, ["productThumbnailTpl"], never, true, never>;
+}
+
 /**
  * The app-wide confirmation modal, wearing the same skin as `ef-dialog`.
  *
@@ -1009,7 +1206,7 @@ declare class EfThemeToggleComponent {
      * Where the tooltip opens. Below suits a top bar (the app bar, the
      * login header); a toggle placed low on a page can open it above.
      */
-    readonly tooltipPosition: _angular_core.InputSignal<"top" | "left" | "bottom" | "right">;
+    readonly tooltipPosition: _angular_core.InputSignal<"top" | "bottom" | "left" | "right">;
     /** Translation key for the accessible name (also the tooltip text). */
     readonly ariaLabelKey: _angular_core.InputSignal<string>;
     readonly isDark: _angular_core.Signal<boolean>;
@@ -1034,7 +1231,7 @@ declare class EfThemeToggleComponent {
 declare class EfBuildStampComponent {
     /** Copyright holder shown before the build. Omit for the build alone. */
     readonly owner: _angular_core.InputSignal<string>;
-    protected readonly info: _elasticias_core.EfBuildInfo;
+    protected readonly info: _elasticias_core.EfBuildInfo | null;
     protected readonly year: number;
     /**
      * A released build is known by its version; an unreleased one has no
@@ -1103,7 +1300,7 @@ declare class EfAboutDialogComponent {
     readonly initial: _angular_core.InputSignal<string>;
     /** Copyright holder on the last line. */
     readonly owner: _angular_core.InputSignal<string>;
-    protected readonly info: _elasticias_core.EfBuildInfo;
+    protected readonly info: _elasticias_core.EfBuildInfo | null;
     protected readonly year: number;
     protected readonly packages: _angular_core.Signal<EfBuildPackage[]>;
     /**
@@ -1222,7 +1419,7 @@ declare class EfShortcutsDialogComponent {
 declare class EfSessionIdleDialogComponent {
     protected readonly idle: EfSessionIdleService;
     private readonly session;
-    protected readonly secondsLeft: _angular_core.Signal<number>;
+    protected readonly secondsLeft: _angular_core.Signal<number | null>;
     protected readonly actions: EfDialogAction[];
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<EfSessionIdleDialogComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfSessionIdleDialogComponent, "ef-session-idle-dialog", never, {}, {}, never, never, true, never>;
@@ -1233,11 +1430,18 @@ declare class EfFieldsetComponent {
     legend?: string;
     /** Translation key — takes priority over legend */
     legendKey?: string;
+    /**
+     * `framed` (default) is the bordered PrimeNG fieldset. `plain` drops the
+     * frame and padding and sets the legend as a section heading: use it inside
+     * an `ef-card`, so fields keep their full width at 390px. It stays a real
+     * fieldset/legend, and it is never toggleable.
+     */
+    variant: 'framed' | 'plain';
     toggleable: boolean;
     collapsed: boolean;
     styleClass?: string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<EfFieldsetComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfFieldsetComponent, "ef-fieldset", never, { "legend": { "alias": "legend"; "required": false; }; "legendKey": { "alias": "legendKey"; "required": false; }; "toggleable": { "alias": "toggleable"; "required": false; }; "collapsed": { "alias": "collapsed"; "required": false; }; "styleClass": { "alias": "styleClass"; "required": false; }; }, {}, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfFieldsetComponent, "ef-fieldset", never, { "legend": { "alias": "legend"; "required": false; }; "legendKey": { "alias": "legendKey"; "required": false; }; "variant": { "alias": "variant"; "required": false; }; "toggleable": { "alias": "toggleable"; "required": false; }; "collapsed": { "alias": "collapsed"; "required": false; }; "styleClass": { "alias": "styleClass"; "required": false; }; }, {}, never, ["*"], true, never>;
     static ngAcceptInputType_toggleable: unknown;
     static ngAcceptInputType_collapsed: unknown;
 }
@@ -1267,12 +1471,19 @@ type EfButtonSeverity = EfButtonPrimeNGSeverity | EfButtonComptoirSeverity;
  * `disabled`, `loading`, `pTooltip` (via `tooltipKey`), and emit the
  * same `clickEvent`.
  */
-declare class EfButtonComponent {
+declare class EfButtonComponent implements OnInit {
     /** Direct label text (not translated). */
     label?: string;
     /** Translation key — takes priority over `label`. */
     labelKey?: string;
     icon?: string;
+    /**
+     * Translation key for the button's accessible name (`aria-label`). Required
+     * in practice for an icon-only button: a tooltip is not read as the name.
+     * A button with a visible label does not need it. An icon-only button with
+     * neither a label nor this key logs a dev-mode warning.
+     */
+    ariaLabelKey?: string;
     /**
      * Which rendering surface to use. Default `'primeng'` keeps v1
      * consumers unchanged. V2 detail/list screens pass `'comptoir'`
@@ -1348,15 +1559,16 @@ declare class EfButtonComponent {
      * `'small' | 'large'`, with the default (unset) being the normal height, so
      * `'base'` maps to `null` rather than being forwarded verbatim.
      */
-    get pnSize(): 'small' | 'large' | null;
+    get pnSize(): 'small' | 'large' | undefined;
     /** Composed class string for the Comptoir variant —
      *  `btn btn-{severity} btn-sm` plus any caller-supplied `styleClass`. */
     get comptoirClass(): string;
     /** Inline danger tint for the `severity="danger"` Comptoir variant. */
     get comptoirInlineColor(): string | null;
+    ngOnInit(): void;
     handleClick(event: Event): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<EfButtonComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfButtonComponent, "ef-button", never, { "label": { "alias": "label"; "required": false; }; "labelKey": { "alias": "labelKey"; "required": false; }; "icon": { "alias": "icon"; "required": false; }; "variant": { "alias": "variant"; "required": false; }; "severity": { "alias": "severity"; "required": false; }; "size": { "alias": "size"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "rounded": { "alias": "rounded"; "required": false; }; "outlined": { "alias": "outlined"; "required": false; }; "raised": { "alias": "raised"; "required": false; }; "text": { "alias": "text"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; "styleClass": { "alias": "styleClass"; "required": false; }; "type": { "alias": "type"; "required": false; }; "badge": { "alias": "badge"; "required": false; }; "badgeSeverity": { "alias": "badgeSeverity"; "required": false; }; "tooltip": { "alias": "tooltip"; "required": false; }; "tooltipKey": { "alias": "tooltipKey"; "required": false; }; "tooltipPosition": { "alias": "tooltipPosition"; "required": false; }; "autofocus": { "alias": "autofocus"; "required": false; }; }, { "clickEvent": "clickEvent"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfButtonComponent, "ef-button", never, { "label": { "alias": "label"; "required": false; }; "labelKey": { "alias": "labelKey"; "required": false; }; "icon": { "alias": "icon"; "required": false; }; "ariaLabelKey": { "alias": "ariaLabelKey"; "required": false; }; "variant": { "alias": "variant"; "required": false; }; "severity": { "alias": "severity"; "required": false; }; "size": { "alias": "size"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "rounded": { "alias": "rounded"; "required": false; }; "outlined": { "alias": "outlined"; "required": false; }; "raised": { "alias": "raised"; "required": false; }; "text": { "alias": "text"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; "styleClass": { "alias": "styleClass"; "required": false; }; "type": { "alias": "type"; "required": false; }; "badge": { "alias": "badge"; "required": false; }; "badgeSeverity": { "alias": "badgeSeverity"; "required": false; }; "tooltip": { "alias": "tooltip"; "required": false; }; "tooltipKey": { "alias": "tooltipKey"; "required": false; }; "tooltipPosition": { "alias": "tooltipPosition"; "required": false; }; "autofocus": { "alias": "autofocus"; "required": false; }; }, { "clickEvent": "clickEvent"; }, never, never, true, never>;
     static ngAcceptInputType_disabled: unknown;
     static ngAcceptInputType_rounded: unknown;
     static ngAcceptInputType_outlined: unknown;
@@ -1513,7 +1725,16 @@ declare class EfBadgeComponent {
     /**
      * Badge label text
      */
-    label: _angular_core.InputSignal<string>;
+    label: _angular_core.InputSignal<string | undefined>;
+    /**
+     * Translation key for the label; wins over `label`.
+     */
+    labelKey: _angular_core.InputSignal<string | undefined>;
+    /**
+     * Opt in to the pointer cursor and hover lift. Off by default so a
+     * read-only badge does not look like a button.
+     */
+    clickable: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /**
      * Badge color (Tailwind color name)
      */
@@ -1533,7 +1754,7 @@ declare class EfBadgeComponent {
     /**
      * Icon class (e.g., PrimeIcons)
      */
-    icon: _angular_core.InputSignal<string>;
+    icon: _angular_core.InputSignal<string | undefined>;
     /**
      * Whether to show the dot indicator
      */
@@ -1555,7 +1776,7 @@ declare class EfBadgeComponent {
      */
     iconClasses: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<EfBadgeComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfBadgeComponent, "ef-badge", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "styleClass": { "alias": "styleClass"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "showDot": { "alias": "showDot"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfBadgeComponent, "ef-badge", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "labelKey": { "alias": "labelKey"; "required": false; "isSignal": true; }; "clickable": { "alias": "clickable"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "styleClass": { "alias": "styleClass"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "showDot": { "alias": "showDot"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 declare class EfToolbarComponent {
@@ -1666,7 +1887,7 @@ declare class EfAppShellComponent {
     readonly shortcutHint: string;
     toggleSide(): void;
     constructor();
-    readonly activeId: _angular_core.Signal<_elasticias_core.EfModuleId>;
+    readonly activeId: _angular_core.Signal<_elasticias_core.EfModuleId | null>;
     readonly switcherOpen: _angular_core.WritableSignal<boolean>;
     /** Five tabs is what fits a phone; the rest live in the sheet. */
     readonly tabs: _angular_core.Signal<EfModule[]>;
@@ -1718,7 +1939,7 @@ declare class EfAppShellMobileComponent {
     private readonly perms;
     private readonly active;
     private readonly router;
-    readonly activeId: _angular_core.Signal<_elasticias_core.EfModuleId>;
+    readonly activeId: _angular_core.Signal<_elasticias_core.EfModuleId | null>;
     readonly switcherOpen: _angular_core.WritableSignal<boolean>;
     readonly tabs: _angular_core.Signal<EfModule[]>;
     readonly allVisible: _angular_core.Signal<readonly EfModule[]>;
@@ -1750,7 +1971,7 @@ declare class EfAppMainComponent {
     /** Render the 3px module-color stripe at the top of the content area. */
     stripe: boolean;
     /** `data-module` value bound to the host. Null when no module is active. */
-    readonly moduleId: _angular_core.Signal<_elasticias_core.EfModuleId>;
+    readonly moduleId: _angular_core.Signal<_elasticias_core.EfModuleId | null>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<EfAppMainComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfAppMainComponent, "ef-app-main", never, { "stripe": { "alias": "stripe"; "required": false; }; }, {}, never, ["*"], true, never>;
     static ngAcceptInputType_stripe: unknown;
@@ -1785,7 +2006,7 @@ declare class EfAppTopComponent {
      */
     readonly logout: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Present only when the app provides `EF_SESSION`. */
-    protected readonly session: _elasticias_core.EfSession;
+    protected readonly session: _elasticias_core.EfSession | null;
     protected signOut(): void;
     /** A touch or pen press at least this long is a hold, not a tap. */
     static readonly HOLD_MS = 500;
@@ -1803,8 +2024,8 @@ declare class EfAppTopComponent {
     protected forgetSignOutPress(): void;
     protected onSignOutClick(event: MouseEvent): void;
     private readonly active;
-    readonly module: _angular_core.Signal<_elasticias_core.EfModule>;
-    readonly navItem: _angular_core.Signal<_elasticias_core.EfNavItem>;
+    readonly module: _angular_core.Signal<_elasticias_core.EfModule | null>;
+    readonly navItem: _angular_core.Signal<_elasticias_core.EfNavItem | null>;
     readonly hasBreadcrumb: _angular_core.Signal<boolean>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<EfAppTopComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfAppTopComponent, "ef-app-top", never, { "themeToggle": { "alias": "themeToggle"; "required": false; "isSignal": true; }; "logout": { "alias": "logout"; "required": false; "isSignal": true; }; }, {}, never, ["[breadcrumb]", "[actions]"], true, never>;
@@ -1847,7 +2068,7 @@ declare class EfModuleRailComponent {
     /** Optional notification badges per module id. */
     badges: Partial<Record<EfModuleId, string | number>>;
     readonly visibleModules: _angular_core.Signal<readonly EfModule[]>;
-    readonly activeId: _angular_core.Signal<EfModuleId>;
+    readonly activeId: _angular_core.Signal<EfModuleId | null>;
     /** Visible modules interleaved with dividers at group boundaries. */
     readonly rows: _angular_core.Signal<RailRow[]>;
     readonly hasBadges: _angular_core.Signal<boolean>;
@@ -1870,8 +2091,8 @@ declare class EfModuleRailComponent {
 declare class EfModuleSideComponent {
     private readonly active;
     private readonly perms;
-    readonly module: _angular_core.Signal<_elasticias_core.EfModule>;
-    readonly moduleId: _angular_core.Signal<_elasticias_core.EfModuleId>;
+    readonly module: _angular_core.Signal<_elasticias_core.EfModule | null>;
+    readonly moduleId: _angular_core.Signal<_elasticias_core.EfModuleId | null>;
     readonly visibleSections: _angular_core.Signal<EfNavSection[]>;
     trackSection(_: number, s: EfNavSection): string;
     trackItem(_: number, i: EfNavItem): string;
@@ -1976,8 +2197,15 @@ interface EfPillItem<T = string> {
  */
 declare class EfPillGroupComponent<T = string> {
     readonly items: _angular_core.InputSignal<readonly EfPillItem<T>[]>;
-    /** Two-way bound selection. */
-    readonly value: _angular_core.ModelSignal<T>;
+    /** Selected value; `null` when nothing is selected. Two-way bindable
+     *  with `[(value)]`. */
+    readonly value: _angular_core.InputSignal<T | null>;
+    /** Emits the picked pill's value. Never `null`: a click always picks
+     *  a pill, so handlers can take `T` without a null check. */
+    readonly valueChange: _angular_core.OutputEmitterRef<T>;
+    /** What the pills render: the bound value, or the last pick when the
+     *  caller only listens to `valueChange`. */
+    protected readonly selected: _angular_core.WritableSignal<T | null>;
     /** Translation key for the group's accessible name. */
     readonly ariaLabelKey: _angular_core.InputSignal<string>;
     /** Hide counts even when items provide them. */
@@ -1997,7 +2225,7 @@ declare class EfPillGroupComponent<T = string> {
     private measure;
     private scrollActiveIntoView;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<EfPillGroupComponent<any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfPillGroupComponent<any>, "ef-pill-group", never, { "items": { "alias": "items"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "ariaLabelKey": { "alias": "ariaLabelKey"; "required": false; "isSignal": true; }; "hideCounts": { "alias": "hideCounts"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfPillGroupComponent<any>, "ef-pill-group", never, { "items": { "alias": "items"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "ariaLabelKey": { "alias": "ariaLabelKey"; "required": false; "isSignal": true; }; "hideCounts": { "alias": "hideCounts"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
 }
 
 /** Visual treatment of the tabset. `'pill'` is the default. */
@@ -2076,7 +2304,10 @@ declare class EfTabsComponent<T = string> implements AfterContentInit {
     overflow: boolean;
     /** Hide count badges even when items provide them. */
     hideCounts: boolean;
+    /** Untranslated accessible name of the tablist. Prefer `ariaLabelKey`. */
     ariaLabel: string;
+    /** Translation key for the tablist's accessible name; wins over `ariaLabel`. */
+    ariaLabelKey?: string;
     /** Translation key used as the `aria-label` of the dirty dot.
      *  Defaults to `'common.dirty'` — apps add the matching entry to
      *  `fr.json` / `ar.json`. */
@@ -2097,7 +2328,7 @@ declare class EfTabsComponent<T = string> implements AfterContentInit {
     onKeydown(event: KeyboardEvent, index: number): void;
     trackValue(_: number, item: EfTabItem<T>): T;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<EfTabsComponent<any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfTabsComponent<any>, "ef-tabs", never, { "items": { "alias": "items"; "required": true; }; "value": { "alias": "value"; "required": false; }; "variant": { "alias": "variant"; "required": false; }; "module": { "alias": "module"; "required": false; }; "overflow": { "alias": "overflow"; "required": false; }; "hideCounts": { "alias": "hideCounts"; "required": false; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; }; "dirtyLabelKey": { "alias": "dirtyLabelKey"; "required": false; }; }, { "valueChange": "valueChange"; }, ["panels"], never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfTabsComponent<any>, "ef-tabs", never, { "items": { "alias": "items"; "required": true; }; "value": { "alias": "value"; "required": false; }; "variant": { "alias": "variant"; "required": false; }; "module": { "alias": "module"; "required": false; }; "overflow": { "alias": "overflow"; "required": false; }; "hideCounts": { "alias": "hideCounts"; "required": false; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; }; "ariaLabelKey": { "alias": "ariaLabelKey"; "required": false; }; "dirtyLabelKey": { "alias": "dirtyLabelKey"; "required": false; }; }, { "valueChange": "valueChange"; }, ["panels"], never, true, never>;
     static ngAcceptInputType_overflow: unknown;
     static ngAcceptInputType_hideCounts: unknown;
 }
@@ -2327,7 +2558,7 @@ declare class EfPulseComponent {
 declare class EfPdfPreviewComponent {
     private readonly sanitizer;
     /** The PDF blob to preview. Setting it (re)creates the object URL. */
-    blob: _angular_core.InputSignal<Blob>;
+    blob: _angular_core.InputSignal<Blob | null>;
     /** File name shown in the header + used for download / share. */
     fileName: _angular_core.InputSignal<string>;
     /** Two-way dialog visibility. */
@@ -2339,11 +2570,16 @@ declare class EfPdfPreviewComponent {
     showOpenInNewTab: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Show the WhatsApp share button (Web Share API → wa.me fallback). */
     showWhatsappShare: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /** Optional recipient phone for the wa.me fallback (digits / +). */
+    /** Optional recipient phone for the wa.me fallback, as typed: international
+     *  (`+`/`00`) or national with `defaultCallingCode`. */
     whatsappPhone: _angular_core.InputSignal<string>;
+    /** Calling code (`'212'` or `'+212'`) that turns a national
+     *  `whatsappPhone` (`0612345678`) into the international number wa.me
+     *  needs. Without it a national number opens the contact picker. */
+    defaultCallingCode: _angular_core.InputSignal<string>;
     private readonly objectUrl;
     private currentUrl;
-    readonly safeUrl: _angular_core.Signal<SafeResourceUrl>;
+    readonly safeUrl: _angular_core.Signal<SafeResourceUrl | null>;
     /** Footer buttons, rendered by `ef-dialog`'s `[actions]`. `dismiss:false`
      *  keeps the preview open after download/print/share/open. */
     readonly actions: _angular_core.Signal<EfDialogAction[]>;
@@ -2356,7 +2592,7 @@ declare class EfPdfPreviewComponent {
     shareWhatsapp(): void;
     private openWhatsappWeb;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<EfPdfPreviewComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfPdfPreviewComponent, "ef-pdf-preview", never, { "blob": { "alias": "blob"; "required": false; "isSignal": true; }; "fileName": { "alias": "fileName"; "required": false; "isSignal": true; }; "visible": { "alias": "visible"; "required": false; "isSignal": true; }; "titleKey": { "alias": "titleKey"; "required": false; "isSignal": true; }; "showDownload": { "alias": "showDownload"; "required": false; "isSignal": true; }; "showPrint": { "alias": "showPrint"; "required": false; "isSignal": true; }; "showOpenInNewTab": { "alias": "showOpenInNewTab"; "required": false; "isSignal": true; }; "showWhatsappShare": { "alias": "showWhatsappShare"; "required": false; "isSignal": true; }; "whatsappPhone": { "alias": "whatsappPhone"; "required": false; "isSignal": true; }; }, { "visible": "visibleChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfPdfPreviewComponent, "ef-pdf-preview", never, { "blob": { "alias": "blob"; "required": false; "isSignal": true; }; "fileName": { "alias": "fileName"; "required": false; "isSignal": true; }; "visible": { "alias": "visible"; "required": false; "isSignal": true; }; "titleKey": { "alias": "titleKey"; "required": false; "isSignal": true; }; "showDownload": { "alias": "showDownload"; "required": false; "isSignal": true; }; "showPrint": { "alias": "showPrint"; "required": false; "isSignal": true; }; "showOpenInNewTab": { "alias": "showOpenInNewTab"; "required": false; "isSignal": true; }; "showWhatsappShare": { "alias": "showWhatsappShare"; "required": false; "isSignal": true; }; "whatsappPhone": { "alias": "whatsappPhone"; "required": false; "isSignal": true; }; "defaultCallingCode": { "alias": "defaultCallingCode"; "required": false; "isSignal": true; }; }, { "visible": "visibleChange"; }, never, never, true, never>;
 }
 
 /**
@@ -2649,6 +2885,52 @@ declare class EfFormGridComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfFormGridComponent, "ef-form-grid", never, {}, {}, never, ["*"], true, never>;
 }
 
+/**
+ * Declarative row-action item consumed by `ef-row-actions`.
+ *
+ * The component renders a native Comptoir-styled popup (no PrimeNG
+ * Menu) so the design — kbd hint, danger tone, divider, ink-active
+ * trigger when open — matches the prototype 1:1.
+ *
+ * Use `command` for actions, `separator: true` for a divider line.
+ */
+interface EfRowAction {
+    /** Stable identifier for trackBy / tests. */
+    id?: string;
+    /** Translation key — preferred. */
+    labelKey?: string;
+    /** Direct label — used only when `labelKey` is empty. */
+    label?: string;
+    /** PrimeIcons class (e.g. `'pi pi-pencil'`). */
+    icon?: string;
+    /** Optional keyboard-shortcut hint shown right-aligned (e.g. `'↵'`, `'E'`, `'⌘D'`). */
+    kbd?: string;
+    /** Tone: `'danger'` styles destructive items in the cancelled palette. */
+    severity?: 'default' | 'danger';
+    /** Render a divider in this slot — all other fields ignored. */
+    separator?: boolean;
+    /** Disable without removing. The item stays focusable and is exposed
+     *  as `aria-disabled`, so a keyboard user can land on it and read why. */
+    disabled?: boolean;
+    /** Translation key saying why the item is disabled. Shown under the
+     *  label, as its tooltip, and as its `aria-describedby`. */
+    reasonKey?: string;
+    /**
+     * Hide the item explicitly. Combined with `permission` and any
+     * caller-supplied filter; defaults to `true` (visible).
+     */
+    visible?: boolean;
+    /**
+     * If set, the item is hidden unless the bound `ScreenContext`
+     * grants this permission, or every permission in the array (e.g.
+     * Duplicate needs `[Duplicate, Create]`, since a duplicate is saved
+     * through create). Items with no `permission` always show.
+     */
+    permission?: Permissions | ReadonlyArray<Permissions>;
+    /** Click handler. The container handles closing the popup. */
+    command?: () => void;
+}
+
 /**
  * Sticky detail-screen toolbar. Two slots and an optional declarative
  * action API:
@@ -2685,6 +2967,20 @@ declare class EfFormGridComponent {
  * </ef-detail-toolbar>
  * ```
  *
+ * Phone overflow: on the mobile tier, when the visible actions (custom and
+ * standard, Save included) outnumber `[overflowAfter]`, Save and any custom
+ * action flagged `keepInView` stay in view and every other action moves
+ * into a kebab menu (`ef-row-actions`, so it is
+ * a `role="menu"` with Escape, outside-click and RTL placement). The split
+ * happens after permission and `requiresWrite` filtering, so a hidden action
+ * is hidden in the menu too. The projected `[actions]` slot is not moved.
+ * Buttons are 48px on a coarse pointer (see `.detail-toolbar` in patterns).
+ *
+ * Tablet and desktop reflow: the identity has a basis
+ * (`--detail-toolbar-identity-min`, 22rem), so when it and the actions
+ * cannot share a row the actions wrap below it, rather than squeezing the
+ * identity until its notices are cut.
+ *
  * Custom actions can declare `permission` and `visible` like
  * `EfRowAction`. With `[context]` bound, the toolbar filters them
  * against `ScreenContext.isGranted()` automatically.
@@ -2704,7 +3000,7 @@ declare class EfDetailToolbarComponent {
     /** Optional ScreenContext — when present, custom actions with a
      *  `permission` field and standard actions Print / Duplicate /
      *  Delete are filtered against `context.isGranted(...)`. */
-    readonly context: _angular_core.InputSignal<ScreenContext>;
+    readonly context: _angular_core.InputSignal<ScreenContext | undefined>;
     /** Render the standard Print action (left of the standard group). */
     readonly showPrintAction: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Render the standard Duplicate action. */
@@ -2718,6 +3014,11 @@ declare class EfDetailToolbarComponent {
     /** i18n key for the Save button label. Screens typically pass
      *  `'common_create'` in create mode and `'common_save'` in edit. */
     readonly saveLabelKey: _angular_core.InputSignal<string>;
+    /** Most actions (Save included) kept inline on a phone; more than this
+     *  moves all but Save into the overflow menu. Desktop and tablet never
+     *  overflow. */
+    readonly overflowAfter: _angular_core.InputSignalWithTransform<number, string | number>;
+    private readonly viewport;
     /** Fired when a `customActions` button is clicked. The toast
      *  service or screen handler should consume `id`. The `command`
      *  callback on the action is also invoked. */
@@ -2738,8 +3039,23 @@ declare class EfDetailToolbarComponent {
     readonly canSave: _angular_core.Signal<boolean>;
     readonly hasStandardActions: _angular_core.Signal<boolean>;
     readonly hasCustomActions: _angular_core.Signal<boolean>;
+    /** The phone is showing the overflow menu instead of inline buttons. */
+    readonly overflowing: _angular_core.Signal<boolean>;
+    /** Visible custom actions that stay inline on a phone even when the rest overflow. */
+    readonly keptInView: _angular_core.Signal<readonly EfDetailToolbarAction[]>;
+    /** Everything but Save and the keepInView actions, as menu items, in toolbar order. */
+    readonly overflowItems: _angular_core.Signal<readonly EfRowAction[]>;
     /** Whether the `|` separator should render — both groups present. */
     readonly showSeparator: _angular_core.Signal<boolean>;
+    private readonly host;
+    private readonly destroyRef;
+    /** The standard group (separator, Print … Save) starts a row of its own,
+     *  below the custom actions: its leading separator would separate nothing. */
+    readonly standardWrapped: _angular_core.WritableSignal<boolean>;
+    constructor();
+    /** Compares the standard group's row with the first item of the right
+     *  group. Public for specs: jsdom lays nothing out. */
+    measureWrap(): void;
     onCustomClick(action: EfDetailToolbarAction): void;
     private isCustomVisible;
     /** Standard action visibility: `show*Action` flag AND permission
@@ -2748,7 +3064,7 @@ declare class EfDetailToolbarComponent {
     /** Stable trackBy across renders. */
     trackByAction: (i: number, a: EfDetailToolbarAction) => unknown;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<EfDetailToolbarComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfDetailToolbarComponent, "ef-detail-toolbar", never, { "customActions": { "alias": "customActions"; "required": false; "isSignal": true; }; "context": { "alias": "context"; "required": false; "isSignal": true; }; "showPrintAction": { "alias": "showPrintAction"; "required": false; "isSignal": true; }; "showDuplicateAction": { "alias": "showDuplicateAction"; "required": false; "isSignal": true; }; "showDeleteAction": { "alias": "showDeleteAction"; "required": false; "isSignal": true; }; "showSaveAction": { "alias": "showSaveAction"; "required": false; "isSignal": true; }; "saving": { "alias": "saving"; "required": false; "isSignal": true; }; "saveLabelKey": { "alias": "saveLabelKey"; "required": false; "isSignal": true; }; }, { "customAction": "customAction"; "print": "print"; "duplicate": "duplicate"; "delete": "delete"; "save": "save"; }, never, ["*", "[actions]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfDetailToolbarComponent, "ef-detail-toolbar", never, { "customActions": { "alias": "customActions"; "required": false; "isSignal": true; }; "context": { "alias": "context"; "required": false; "isSignal": true; }; "showPrintAction": { "alias": "showPrintAction"; "required": false; "isSignal": true; }; "showDuplicateAction": { "alias": "showDuplicateAction"; "required": false; "isSignal": true; }; "showDeleteAction": { "alias": "showDeleteAction"; "required": false; "isSignal": true; }; "showSaveAction": { "alias": "showSaveAction"; "required": false; "isSignal": true; }; "saving": { "alias": "saving"; "required": false; "isSignal": true; }; "saveLabelKey": { "alias": "saveLabelKey"; "required": false; "isSignal": true; }; "overflowAfter": { "alias": "overflowAfter"; "required": false; "isSignal": true; }; }, { "customAction": "customAction"; "print": "print"; "duplicate": "duplicate"; "delete": "delete"; "save": "save"; }, never, ["*", "[actions]"], true, never>;
 }
 
 /**
@@ -2801,7 +3117,7 @@ declare class EfSearchToolbarComponent {
     /** Optional ScreenContext — when present, custom actions with a
      *  `permission` field and standard actions Export / Add are
      *  filtered against `context.isGranted(...)`. */
-    readonly context: _angular_core.InputSignal<ScreenContext>;
+    readonly context: _angular_core.InputSignal<ScreenContext | undefined>;
     /** Render the standard Export action (left of the standard group). */
     readonly showExportAction: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Render the standard Add action (rightmost, tenant-styled). */
@@ -2886,7 +3202,7 @@ interface EfTotalsGrand {
  */
 declare class EfTotalsComponent {
     readonly rows: _angular_core.InputSignal<readonly EfTotalsRow[]>;
-    readonly grand: _angular_core.InputSignal<EfTotalsGrand>;
+    readonly grand: _angular_core.InputSignal<EfTotalsGrand | undefined>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<EfTotalsComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfTotalsComponent, "ef-totals", never, { "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "grand": { "alias": "grand"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
@@ -3092,6 +3408,10 @@ declare class EfKpiCardComponent {
     readonly delta: _angular_core.InputSignal<string>;
     /** Delta tone — drives the arrow color. */
     readonly deltaTone: _angular_core.InputSignal<EfKpiDeltaTone>;
+    /** Translation key of a secondary line under the value (e.g. "of which delivery: 120 MAD"). */
+    readonly hintKey: _angular_core.InputSignal<string>;
+    /** Interpolation params for `hintKey`. */
+    readonly hintParams: _angular_core.InputSignal<Record<string, unknown>>;
     /** Raw series for the sparkline. */
     readonly spark: _angular_core.InputSignal<EfKpiSparkline>;
     /** Stroke color for the sparkline polyline. Defaults to the active
@@ -3101,9 +3421,9 @@ declare class EfKpiCardComponent {
     /** Computed `points="x,y x,y …"` attribute, normalized into the
      *  200×28 viewBox so the polyline always fits. Returns null
      *  when the series is empty. */
-    readonly sparkPoints: _angular_core.Signal<string>;
+    readonly sparkPoints: _angular_core.Signal<string | null>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<EfKpiCardComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfKpiCardComponent, "ef-kpi-card", never, { "labelKey": { "alias": "labelKey"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "unit": { "alias": "unit"; "required": false; "isSignal": true; }; "delta": { "alias": "delta"; "required": false; "isSignal": true; }; "deltaTone": { "alias": "deltaTone"; "required": false; "isSignal": true; }; "spark": { "alias": "spark"; "required": false; "isSignal": true; }; "sparkColor": { "alias": "sparkColor"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfKpiCardComponent, "ef-kpi-card", never, { "labelKey": { "alias": "labelKey"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "unit": { "alias": "unit"; "required": false; "isSignal": true; }; "delta": { "alias": "delta"; "required": false; "isSignal": true; }; "deltaTone": { "alias": "deltaTone"; "required": false; "isSignal": true; }; "hintKey": { "alias": "hintKey"; "required": false; "isSignal": true; }; "hintParams": { "alias": "hintParams"; "required": false; "isSignal": true; }; "spark": { "alias": "spark"; "required": false; "isSignal": true; }; "sparkColor": { "alias": "sparkColor"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 type EfChartType = 'line' | 'bar' | 'donut';
@@ -3166,6 +3486,78 @@ declare class EfRankListComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfRankListComponent, "ef-rank-list", never, { "rows": { "alias": "rows"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+type EfIdentityThumbSize = 'sm' | 'md';
+/**
+ * The square that stands for a record: a collection in its detail toolbar, a
+ * product in a picker row. Shows the record's image when it has one and two
+ * initials of its name when it does not (or when the image fails to load).
+ *
+ * Built on the `.thumb` pattern from `_patterns.scss`; the size is a host
+ * class (`sm` 32px, `md` 40px), never an inline style. The image is
+ * decorative (`alt=""`): the name always sits next to it.
+ *
+ * ```html
+ * <ef-identity-thumb [imageUrl]="imageUrl()" [name]="title()" size="sm" />
+ * ```
+ */
+declare class EfIdentityThumbComponent {
+    readonly imageUrl: _angular_core.InputSignal<string | null | undefined>;
+    readonly name: _angular_core.InputSignal<string | null | undefined>;
+    readonly size: _angular_core.InputSignal<EfIdentityThumbSize>;
+    /** Set when the image fails; reset whenever the url changes. */
+    protected readonly failed: _angular_core.WritableSignal<boolean>;
+    protected readonly showImage: _angular_core.Signal<boolean>;
+    /**
+     * First letter of the first two words, or the first two letters of a
+     * single word. `Array.from` splits by code point, so a letter outside the
+     * BMP is never cut in half.
+     */
+    protected readonly initials: _angular_core.Signal<string>;
+    constructor();
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<EfIdentityThumbComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfIdentityThumbComponent, "ef-identity-thumb", never, { "imageUrl": { "alias": "imageUrl"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * What a search engine would show for a page: the title, the address and the
+ * description, cut where the engine cuts them (60 and 160 characters, the
+ * same figures the SEO counters advise). One preview for every SEO card.
+ *
+ * It depicts a search result, so it keeps its own light surface and the
+ * familiar link colours in both themes. The address is always left to right;
+ * the title and description follow the direction of their own text, so an
+ * Arabic page previews right to left inside an LTR or RTL app.
+ *
+ * ```html
+ * <ef-seo-preview
+ *     [pageTitle]="seoTitle() || title()"
+ *     [url]="'shop.example/collections/' + slug()"
+ *     [description]="seoDescription() || description()"
+ *     contentLang="fr" />
+ * ```
+ */
+declare class EfSeoPreviewComponent {
+    /** The page title. Named `pageTitle` so it does not become the host's tooltip. */
+    readonly pageTitle: _angular_core.InputSignal<string | null | undefined>;
+    /** The address as shown (no scheme needed), always rendered left to right. */
+    readonly url: _angular_core.InputSignal<string | null | undefined>;
+    readonly description: _angular_core.InputSignal<string | null | undefined>;
+    /** i18n key of the small heading above the preview. */
+    readonly labelKey: _angular_core.InputSignal<string>;
+    /** Characters kept of the title; `null` shows it whole. */
+    readonly titleMaxLength: _angular_core.InputSignal<number | null>;
+    /** Characters kept of the description; `null` shows it whole. */
+    readonly descriptionMaxLength: _angular_core.InputSignal<number | null>;
+    /** Language of the previewed text (`fr`, `ar`, `en`), for screen readers and hyphenation. */
+    readonly contentLang: _angular_core.InputSignal<string | null>;
+    protected readonly labelId: string;
+    protected readonly shownTitle: _angular_core.Signal<string>;
+    protected readonly shownUrl: _angular_core.Signal<string>;
+    protected readonly shownDescription: _angular_core.Signal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<EfSeoPreviewComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfSeoPreviewComponent, "ef-seo-preview", never, { "pageTitle": { "alias": "pageTitle"; "required": false; "isSignal": true; }; "url": { "alias": "url"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "labelKey": { "alias": "labelKey"; "required": false; "isSignal": true; }; "titleMaxLength": { "alias": "titleMaxLength"; "required": false; "isSignal": true; }; "descriptionMaxLength": { "alias": "descriptionMaxLength"; "required": false; "isSignal": true; }; "contentLang": { "alias": "contentLang"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
 /**
  * Shared base for every Comptoir form control (`ef-input-text`,
  * `ef-textarea`, `ef-select`, `ef-input-number`, `ef-checkbox`, …).
@@ -3186,8 +3578,9 @@ declare class EfRankListComponent {
  * - **ARIA** — `ariaLabelKey` / `ariaLabel` for screen-reader-only
  *   labels; `effectiveAriaLabel` returns `null` when a visible
  *   label is rendered (which already serves as the ARIA name).
- *   `errorsId` provides a stable id for the error/hint container
- *   so subclasses can wire `aria-describedby`.
+ *   `errorsId` and `hintId` give the error container and the hint
+ *   stable ids, and `describedBy()` joins them into the value
+ *   subclasses bind to `aria-describedby`.
  * - **State** — `required` / `readonly` / `disabled` shared inputs,
  *   used directly in subclass templates and toggled by CVA's
  *   `setDisabledState` in subclasses.
@@ -3224,6 +3617,14 @@ declare abstract class AbstractEfFormControl {
     readonly labelKey: _angular_core.InputSignal<string>;
     readonly placeholder: _angular_core.InputSignal<string>;
     readonly placeholderKey: _angular_core.InputSignal<string>;
+    /** Short help text shown under the control. Use `hintKey` for i18n. */
+    readonly hint: _angular_core.InputSignal<string>;
+    /** Translation key for the hint, preferred over `hint`. The hint is
+     *  linked to the control through `aria-describedby` (see
+     *  {@link describedBy}), so a screen reader reads it with the field.
+     *  Rendered by ef-input-text, ef-textarea, ef-inputnumber and ef-select;
+     *  the other controls inherit the input but do not render it yet. */
+    readonly hintKey: _angular_core.InputSignal<string>;
     readonly ariaLabel: _angular_core.InputSignal<string>;
     readonly ariaLabelKey: _angular_core.InputSignal<string>;
     readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -3274,7 +3675,7 @@ declare abstract class AbstractEfFormControl {
      * Falls back to the `NgControl` `serverError` path when neither is
      * present, so `ngModel`-based (v1) screens keep working unchanged.
      */
-    readonly errors: _angular_core.InputSignal<string[]>;
+    readonly errors: _angular_core.InputSignal<string[] | null | undefined>;
     /** Optional enclosing `[efServerErrors]` scope (auto-link by `name`). */
     private readonly serverErrorsScope;
     /**
@@ -3284,7 +3685,7 @@ declare abstract class AbstractEfFormControl {
      * the subclass `serverErrors` / `isInvalid` getters track the source
      * signals under zoneless change detection.
      */
-    readonly resolvedExternalErrors: _angular_core.Signal<string[]>;
+    readonly resolvedExternalErrors: _angular_core.Signal<string[] | null>;
     protected readonly translateService: TranslateService;
     /** Resolved DOM id. Always non-empty so `<label for>` and
      *  `<input id>` can match unambiguously. */
@@ -3298,12 +3699,26 @@ declare abstract class AbstractEfFormControl {
      * accessible name and duplicate `aria-label` would override it.
      */
     get effectiveAriaLabel(): string | null;
-    /** Stable id for the error / hint container — wired through
+    /** Ids of elements outside the control that describe it too (a character
+     *  counter, a help block), appended to `aria-describedby`. */
+    readonly describedByExtra: _angular_core.InputSignal<string>;
+    /** Translated hint (or empty string). */
+    get effectiveHint(): string;
+    /** Stable id of the hint element, `<id>-hint`. */
+    get hintId(): string;
+    /**
+     * The control's `aria-describedby`: the hint id when a hint is shown,
+     * then the errors id when `showErrors` (the subclass knows when its
+     * error container renders), then any `extra` ids. `null` (no
+     * attribute) when there is nothing to point at.
+     */
+    describedBy(showErrors: boolean, ...extra: (string | null | undefined)[]): string | null;
+    /** Stable id for the error container, wired through
      *  `aria-describedby` on the input so screen readers announce
      *  the validation message together with the field name. */
     get errorsId(): string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AbstractEfFormControl, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AbstractEfFormControl, "ng-component", never, { "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "labelKey": { "alias": "labelKey"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "placeholderKey": { "alias": "placeholderKey"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "ariaLabelKey": { "alias": "ariaLabelKey"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "showClear": { "alias": "showClear"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AbstractEfFormControl, "ng-component", never, { "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "labelKey": { "alias": "labelKey"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "placeholderKey": { "alias": "placeholderKey"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "hintKey": { "alias": "hintKey"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "ariaLabelKey": { "alias": "ariaLabelKey"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "showClear": { "alias": "showClear"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "describedByExtra": { "alias": "describedByExtra"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 declare class EfInputTextComponent extends AbstractEfFormControl implements ControlValueAccessor {
@@ -3321,7 +3736,7 @@ declare class EfInputTextComponent extends AbstractEfFormControl implements Cont
      * Rendering variant — same dual-mode pattern as `ef-button`.
      * - `'comptoir'` (default) — native `<input class="ef-input">` against
      *                           the Comptoir pattern styles. Renders at the
-     *                           canonical `--hit-base` (40px) control height.
+     *                           canonical `--hit-field` height (40px, 48px on touch).
      *                           Required for `prefix` / `suffix`.
      * - `'primeng'`            — wraps `<input pInputText>` (v1). Opt in when
      *                           you specifically need PrimeNG input behaviour.
@@ -3341,7 +3756,7 @@ declare class EfInputTextComponent extends AbstractEfFormControl implements Cont
     value: string;
     private onChange;
     private onTouched;
-    readonly ngControl: NgControl;
+    readonly ngControl: NgControl | null;
     constructor();
     get showRequired(): boolean;
     get serverErrors(): string[] | null;
@@ -3408,7 +3823,7 @@ declare class EfSelectComponent extends AbstractEfFormControl implements Control
     group: boolean;
     optionGroupLabel: string;
     optionGroupChildren: string;
-    /** Control height. Default (undefined) = the canonical `--hit-base` (40px),
+    /** Control height. Default (undefined) = the canonical `--hit-field` (40px, 48px on touch),
      *  matching native inputs (ADR-009). `'small'` opts into the dense 32px
      *  variant for compact contexts (e.g. table-row editors). */
     size?: 'small' | 'large';
@@ -3469,8 +3884,8 @@ declare class EfSelectComponent extends AbstractEfFormControl implements Control
      *                           the `.es` / `.es__panel` patterns (the custom
      *                           dropdown: filter, styled options, animated panel
      *                           — see `components.html` Section 04). Also pinned
-     *                           to the canonical `--hit-base` (40px) trigger
-     *                           height (`.es.p-select { min-height: --hit-base }`),
+     *                           to the canonical `--hit-field` (40px, 48px on touch) trigger
+     *                           height (`.es.p-select { min-height: --hit-field }`),
      *                           so it aligns with inputs/buttons in a row.
      * - `'comptoir'`           — lite native `<select class="ef-select-native">`.
      *                           No filter / panel / multi / templates; use it for
@@ -3505,11 +3920,28 @@ declare class EfSelectComponent extends AbstractEfFormControl implements Control
     ngControl: NgControl | null;
     private readonly injector;
     ngOnInit(): void;
+    /**
+     * The text an unset select shows: the placeholder, or nothing. A blank or
+     * dash-only placeholder (a translation of " " or "—") counts as nothing, so
+     * the unset state can never read as "— —". The native variant used to wrap
+     * any truthy placeholder in dashes, which turned " " into exactly that.
+     */
+    get placeholderText(): string;
     /** Translated filter placeholder. Falls back to a generic key, then
      *  to "Search…" so it always renders something readable. */
     get effectiveFilterPlaceholder(): string;
     get effectiveEmptyMessage(): string;
     get effectiveEmptyFilterMessage(): string;
+    private _describedByPt?;
+    /**
+     * PrimeNG pass-through that puts `aria-describedby` (hint, then errors)
+     * on the element the `<label for>` points at: `p-select`'s
+     * `span[role=combobox]` (`label`) and `p-multiselect`'s hidden focus
+     * input (`hiddenInput`). Neither component has an input for it. Cached
+     * per id list so change detection does not hand PrimeNG a new object
+     * every pass.
+     */
+    get describedByPt(): Record<string, Record<string, string | null>>;
     /** Always include `.es` so the global Comptoir skin in
      *  `_patterns.scss` always finds a hook, regardless of what the
      *  consumer passes via `styleClass`. */
@@ -3609,7 +4041,7 @@ declare class EfCheckboxComponent extends AbstractEfFormControl implements Contr
     checkedChange: EventEmitter<any>;
     private onChange;
     private onTouched;
-    readonly ngControl: NgControl;
+    readonly ngControl: NgControl | null;
     constructor();
     get showRequired(): boolean;
     get serverErrors(): string[] | null;
@@ -3643,6 +4075,11 @@ declare class EfCheckboxComponent extends AbstractEfFormControl implements Contr
  *   ariaLabelKey="sales_clients_toggle_active_aria"
  *   (checkedChange)="setActive(row, $event)" />
  * ```
+ *
+ * With a label, the host is a flex row: the switch keeps its size and a
+ * sentence-long label wraps beside it, not under it, at phone width.
+ * Screens no longer restyle `ef-toggleswitch` for this. Without a label
+ * (a table row's switch) the host keeps its inline box.
  */
 declare class EfToggleSwitchComponent extends AbstractEfFormControl implements ControlValueAccessor {
     /**
@@ -3658,7 +4095,7 @@ declare class EfToggleSwitchComponent extends AbstractEfFormControl implements C
     checkedChange: EventEmitter<boolean>;
     private onChange;
     private onTouched;
-    readonly ngControl: NgControl;
+    readonly ngControl: NgControl | null;
     constructor();
     writeValue(value: unknown): void;
     registerOnChange(fn: (value: boolean) => void): void;
@@ -3720,7 +4157,7 @@ declare class EfDatepickerComponent implements ControlValueAccessor {
     value: any;
     private onChange;
     private onTouched;
-    readonly ngControl: NgControl;
+    readonly ngControl: NgControl | null;
     private readonly translateService;
     constructor();
     get effectivePlaceholder(): string;
@@ -3746,38 +4183,6 @@ declare class EfDatepickerComponent implements ControlValueAccessor {
     static ngAcceptInputType_autofocus: unknown;
 }
 
-/**
- * Comptoir number input.
- *
- * Two render variants share the same API:
- * - `'comptoir'` (default) — native `<input type="text" inputmode="decimal">`
- *   styled against `.ef-input` / `.ef-input-group`. Lean, no locale
- *   formatting on display, but data entry accepts both `,` and `.` as
- *   the decimal separator (fr-MA users type commas) and ignores
- *   space group separators; pair with `suffix="MAD"` for unit display
- *   in dense grids (variants table, inventory adjustments, etc.).
- *   See ADR-009.
- * - `'primeng'`            — wraps `p-inputnumber`. Full locale-aware
- *   currency / decimal formatting, stepper buttons, prefix / suffix.
- *
- * Identity / label / placeholder / aria / required / readonly /
- * disabled are inherited from `AbstractEfFormControl`.
- *
- * ```html
- * <ef-inputnumber
- *   labelKey="catalog.price"
- *   variant="primeng"
- *   mode="currency" currency="MAD" locale="fr-MA"
- *   [(value)]="variant.price" />
- *
- * <ef-inputnumber
- *   labelKey="catalog.inventory"
- *   variant="comptoir"
- *   [showButtons]="true" buttonLayout="horizontal"
- *   [min]="0" [step]="1"
- *   [(value)]="variant.inventoryQuantity" />
- * ```
- */
 declare class EfInputNumberComponent extends AbstractEfFormControl implements ControlValueAccessor {
     inputNumber?: InputNumber;
     value?: Nullable<number>;
@@ -3804,7 +4209,7 @@ declare class EfInputNumberComponent extends AbstractEfFormControl implements Co
     step: number;
     allowEmpty: boolean;
     inputSize?: number;
-    /** Default (undefined) = canonical `--hit-base` (40px); `'small'` = dense 32px. */
+    /** PrimeNG variant only: `'small'` = dense 32px. The comptoir variant ignores it and is always `--hit-field` (40px, 48px on touch). */
     size?: 'small' | 'large';
     maxlength?: number;
     minlength?: number;
@@ -3827,7 +4232,7 @@ declare class EfInputNumberComponent extends AbstractEfFormControl implements Co
      * Render variant.
      * - `'comptoir'` (default) — native `<input type="text" inputmode="decimal">`
      *                           styled against `.ef-input` / `.ef-input-group`,
-     *                           at the canonical `--hit-base` (40px) height.
+     *                           at the canonical `--hit-field` height (40px, 48px on touch).
      *                           Accepts `,` and `.` as decimal separator.
      * - `'primeng'`            — wraps `p-inputnumber`. Opt in for PrimeNG's
      *                           formatted stepper behaviour.
@@ -3848,9 +4253,54 @@ declare class EfInputNumberComponent extends AbstractEfFormControl implements Co
     /** A number field is clearable when it holds any value (including 0). */
     protected get hasValue(): boolean;
     clearValue(): void;
+    /** True while the comptoir input has focus in currency mode. */
+    private focused;
+    /** What the user typed since focus, shown as is (never reformatted). */
+    private editText;
+    /** A change that did not come from typing (clear, stepper, form write)
+     *  replaces the edit text while focused, or the box would keep the old
+     *  amount and the next keystroke would append to it. Marks the view,
+     *  since a programmatic call (zoneless) would not. */
+    private syncEditText;
+    /** Comptoir currency formatting applies: `mode="currency"` and a currency code. */
+    get isCurrency(): boolean;
+    private get effectiveLocale();
+    /** Decimals: explicit inputs, else the currency's own (2 for MAD). */
+    private get fractionDigits();
+    /**
+     * The amount as text, in Latin digits and without bidi marks: grouped
+     * for display, ungrouped for editing (so the text always parses back
+     * through {@link parseComptoirValue}).
+     */
+    private formatAmount;
+    /**
+     * The currency addon: the locale's symbol and the side it goes on, or
+     * `null` outside currency mode or when an explicit prefix / suffix
+     * already shows the unit.
+     */
+    get currencyAddon(): {
+        symbol: string;
+        side: 'prefix' | 'suffix';
+    } | null;
+    /**
+     * Currency mode, before the generic parse: drops the currency's names (a
+     * pasted "1.234,50 MAD" or "1.234,50 د.م."), then, when the currency has
+     * at most 2 decimals, reads the locale's own group separator followed by
+     * groups of exactly 3 digits as grouping. "1.500" in a fr-MA or ar-MA MAD
+     * field is 1 500, not 1,50: a 3-digit tail cannot be a decimal there.
+     * Only the locale's group character counts, so a French "1,500" stays
+     * 1,5, and "0.500" or "12.50" stay decimals.
+     */
+    private stripCurrencyGrouping;
+    /** Id of the currency addon, referenced by the input's aria-describedby. */
+    get currencyId(): string;
+    /** Text bound to the comptoir input. */
+    get displayText(): string | number;
     private onChange;
     private onTouched;
-    readonly ngControl: NgControl;
+    readonly ngControl: NgControl | null;
+    private readonly localeId;
+    private readonly cdr;
     constructor();
     get showRequired(): boolean;
     get serverErrors(): string[] | null;
@@ -3871,6 +4321,8 @@ declare class EfInputNumberComponent extends AbstractEfFormControl implements Co
      * dot before parsing, and spaces (JS `\s` covers NBSP / narrow-NBSP
      * group separators) are stripped. Both `23,50` and `23.50` parse to
      * 23.5; unparseable text yields `null` (existing empty semantics).
+     * Bidi marks (an Arabic formatted amount carries U+200F) are dropped,
+     * and when both `.` and `,` appear the last one is the decimal.
      */
     private parseComptoirValue;
     /**
@@ -3918,7 +4370,7 @@ declare class EfPasswordComponent extends AbstractEfFormControl implements Contr
     value: string;
     private onChange;
     private onTouched;
-    readonly ngControl: NgControl;
+    readonly ngControl: NgControl | null;
     constructor();
     get showRequired(): boolean;
     get serverErrors(): string[] | null;
@@ -3958,7 +4410,7 @@ declare class EfMultiSelectComponent extends AbstractEfFormControl implements Co
     selectedValues: any[];
     private propagateChange;
     private propagateTouched;
-    readonly ngControl: NgControl;
+    readonly ngControl: NgControl | null;
     constructor();
     get showRequired(): boolean;
     get serverErrors(): string[] | null;
@@ -3987,7 +4439,7 @@ declare class EfSelectButtonComponent extends AbstractEfFormControl implements C
     value: any;
     private onChange;
     private onTouched;
-    readonly ngControl: NgControl;
+    readonly ngControl: NgControl | null;
     constructor();
     writeValue(value: any): void;
     registerOnChange(fn: (value: any) => void): void;
@@ -4053,7 +4505,7 @@ declare class EfQuantityStepperComponent implements ControlValueAccessor {
     /**
      * Callback to invoke when the value changes
      */
-    valueChange: EventEmitter<number>;
+    valueChange: EventEmitter<number | null>;
     /**
      * Pass Through configuration for custom styling
      */
@@ -4286,23 +4738,23 @@ declare class EfDatatableComponent implements OnInit {
     /**
      * Action column configuration (edit/delete/duplicate buttons)
      */
-    actions: _angular_core.InputSignal<EfDatatableActions>;
+    actions: _angular_core.InputSignal<EfDatatableActions | undefined>;
     /**
      * SearchEntity containing items, pagination, etc.
      */
-    searchEntity: _angular_core.InputSignal<DatatableSearchEntity>;
+    searchEntity: _angular_core.InputSignal<DatatableSearchEntity | undefined>;
     /**
      * ScreenContext for reference data access
      */
-    context: _angular_core.InputSignal<ScreenContext>;
+    context: _angular_core.InputSignal<ScreenContext | undefined>;
     /**
      * PassThrough options for deep DOM customization
      */
-    pt: _angular_core.InputSignal<Record<string, unknown>>;
+    pt: _angular_core.InputSignal<Record<string, unknown> | undefined>;
     /**
      * Screen state key for state persistence (auto-generates stateKey if not provided in config)
      */
-    screenStateKey: _angular_core.InputSignal<string>;
+    screenStateKey: _angular_core.InputSignal<string | undefined>;
     /**
      * Emitted when edit button is clicked (emits row ID)
      */
@@ -4363,7 +4815,7 @@ declare class EfDatatableComponent implements OnInit {
     /**
      * Computed sort field from searchEntity for restoring table state
      */
-    sortField: _angular_core.Signal<string>;
+    sortField: _angular_core.Signal<string | undefined>;
     /**
      * Computed sort order from searchEntity for restoring table state
      * 1 = ascending, -1 = descending
@@ -4471,50 +4923,16 @@ type EfDataCardMobileLayout = 'row' | 'card';
  */
 declare const EF_DATA_CARD_MOBILE_LAYOUT: InjectionToken<EfDataCardMobileLayout>;
 
-/**
- * Declarative row-action item consumed by `ef-row-actions`.
- *
- * The component renders a native Comptoir-styled popup (no PrimeNG
- * Menu) so the design — kbd hint, danger tone, divider, ink-active
- * trigger when open — matches the prototype 1:1.
- *
- * Use `command` for actions, `separator: true` for a divider line.
- */
-interface EfRowAction {
-    /** Stable identifier for trackBy / tests. */
-    id?: string;
-    /** Translation key — preferred. */
-    labelKey?: string;
-    /** Direct label — used only when `labelKey` is empty. */
-    label?: string;
-    /** PrimeIcons class (e.g. `'pi pi-pencil'`). */
-    icon?: string;
-    /** Optional keyboard-shortcut hint shown right-aligned (e.g. `'↵'`, `'E'`, `'⌘D'`). */
-    kbd?: string;
-    /** Tone: `'danger'` styles destructive items in the cancelled palette. */
-    severity?: 'default' | 'danger';
-    /** Render a divider in this slot — all other fields ignored. */
-    separator?: boolean;
-    /** Disable without removing. */
-    disabled?: boolean;
-    /**
-     * Hide the item explicitly. Combined with `permission` and any
-     * caller-supplied filter; defaults to `true` (visible).
-     */
-    visible?: boolean;
-    /**
-     * If set, the item is hidden unless the bound `ScreenContext`
-     * grants this permission, or every permission in the array (e.g.
-     * Duplicate needs `[Duplicate, Create]`, since a duplicate is saved
-     * through create). Items with no `permission` always show.
-     */
-    permission?: Permissions | ReadonlyArray<Permissions>;
-    /** Click handler. The container handles closing the popup. */
-    command?: () => void;
-}
-
 /** Action identifier emitted by `ef-data-card`'s auto row-actions cell. */
 type EfDataCardRowAction = 'view' | 'edit' | 'duplicate' | 'delete';
+/** What `[rowActionState]` answers for one action on one row: `'hidden'`
+ *  leaves it out of the menu, `'disabled'` (or `{ state: 'disabled', reasonKey }`, which also says why, announced
+ *  and shown under the item) shows it greyed and inert, and
+ *  `null` / `undefined` leaves it as it is. */
+type EfDataCardRowActionState = 'hidden' | 'disabled' | {
+    state: 'disabled';
+    reasonKey?: string;
+} | null | undefined;
 /** Row height presets offered by the Density control. */
 type EfTableDensity = 'compact' | 'default' | 'comfortable';
 /**
@@ -4567,7 +4985,7 @@ declare class EfDataCardComponent<TRow = any> implements AfterContentInit {
     private readonly configuredMobileLayout;
     readonly isMobile: _angular_core.Signal<boolean>;
     /** Per-screen override of the app-wide default. */
-    readonly mobileLayout: _angular_core.InputSignal<EfDataCardMobileLayout>;
+    readonly mobileLayout: _angular_core.InputSignal<EfDataCardMobileLayout | null>;
     protected readonly effectiveMobileLayout: _angular_core.Signal<EfDataCardMobileLayout>;
     /** Rows currently showing their detail, keyed the same way as trackByRow. */
     private readonly expandedRows;
@@ -4602,8 +5020,8 @@ declare class EfDataCardComponent<TRow = any> implements AfterContentInit {
         type?: string;
     }): string;
     private readonly derivedPrimaryId;
-    protected readonly primaryColumn: _angular_core.Signal<EfDataCardColumn>;
-    protected readonly statusColumn: _angular_core.Signal<EfDataCardColumn>;
+    protected readonly primaryColumn: _angular_core.Signal<EfDataCardColumn | undefined>;
+    protected readonly statusColumn: _angular_core.Signal<EfDataCardColumn | undefined>;
     protected readonly secondaryColumns: _angular_core.Signal<EfDataCardColumn[]>;
     /**
      * Fields shown once a row opens. The primary column is excluded: the
@@ -4637,7 +5055,7 @@ declare class EfDataCardComponent<TRow = any> implements AfterContentInit {
     readonly pageSizeOptions: _angular_core.InputSignal<readonly number[]>;
     readonly hidePager: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Currently active sort. Header click toggles asc / desc. */
-    readonly sort: _angular_core.InputSignal<EfDataCardSort>;
+    readonly sort: _angular_core.InputSignal<EfDataCardSort | undefined>;
     /**
      * First load and every refresh. While true with no rows yet, the body
      * shimmers `ef-skeleton` placeholders instead of the empty state — a
@@ -4694,12 +5112,48 @@ declare class EfDataCardComponent<TRow = any> implements AfterContentInit {
      * their native behaviour (toggle selection, run an action, …).
      */
     readonly rowDoubleClickable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Turns an activatable row into a toggle button (APG button pattern):
+     * the row, already `role="button"` under `[rowDoubleClickable]`, gets
+     * `aria-pressed` from this function, on the desktop `<tr>` and on the
+     * phone row head alike. Enter and Space both activate. For a
+     * multi-select picker whose rows are the selection.
+     *
+     * `aria-pressed` rather than `aria-selected`: selection belongs to a
+     * grid or listbox, which own arrow-key focus management this table does
+     * not have, and `aria-selected` is not allowed on a button. Unset, no
+     * attribute is written.
+     */
+    readonly rowPressed: _angular_core.InputSignal<((row: TRow) => boolean) | null>;
+    /**
+     * A row that is shown but cannot be activated (a product already in the
+     * collection): `.is-disabled` dims it, `aria-disabled` says so, and
+     * click, Enter and Space are ignored. It stays focusable, so a screen
+     * reader user can still find it and hear why nothing happens.
+     */
+    readonly rowDisabled: _angular_core.InputSignal<((row: TRow) => boolean) | null>;
+    protected pressedAttr(row: TRow): 'true' | 'false' | null;
+    protected isRowDisabled(row: TRow): boolean;
     readonly hasActionsColumn: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    readonly rowActionsContext: _angular_core.InputSignal<ScreenContext>;
+    readonly rowActionsContext: _angular_core.InputSignal<ScreenContext | undefined>;
     readonly showViewAction: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly showEditAction: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly showDuplicateAction: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly showDeleteAction: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Per-row visibility of the built-in row actions, e.g. no Delete on a
+     * row that is not a draft:
+     *
+     * ```ts
+     * rowActionState = (action, row) =>
+     *   action === 'delete' && row.status !== 'draft' ? 'hidden' : null;
+     * ```
+     *
+     * Applied on top of the `show*Action` flags and the permission filter,
+     * on desktop rows and phone cards alike. A row whose actions are all
+     * hidden gets a disabled trigger. Unset, every row keeps every action.
+     */
+    readonly rowActionState: _angular_core.InputSignal<((action: EfDataCardRowAction, row: TRow) => EfDataCardRowActionState) | null>;
     /** Render the Density control in the head row. */
     readonly showDensityControl: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Render the Columns picker in the head row. */
@@ -4723,7 +5177,7 @@ declare class EfDataCardComponent<TRow = any> implements AfterContentInit {
      * moving Export out of `ef-search-toolbar` does not quietly drop the
      * permission check that lived there.
      */
-    readonly screenContext: _angular_core.InputSignal<ScreenContext>;
+    readonly screenContext: _angular_core.InputSignal<ScreenContext | undefined>;
     /**
      * Mirrors `ef-search-toolbar`'s rule exactly: hidden unless asked for,
      * and with a context present it obeys `hasExportPermission`. No
@@ -4739,9 +5193,9 @@ declare class EfDataCardComponent<TRow = any> implements AfterContentInit {
     readonly searchTerm: _angular_core.InputSignal<string>;
     /**
      * Stable key used to remember density and hidden columns for this
-     * table. Preferences are a per-viewer convenience, so they live in
-     * localStorage and are read defensively -- a private window or
-     * cleared site data simply falls back to the defaults.
+     * table, through `EF_PREFERENCE_STORE`. They are read defensively: a
+     * store that throws or holds nothing falls back to the defaults
+     * (`defaultDensity`, and each column's `defaultHidden`).
      */
     readonly tableKey: _angular_core.InputSignal<string>;
     readonly pageChange: _angular_core.OutputEmitterRef<number>;
@@ -4804,7 +5258,7 @@ declare class EfDataCardComponent<TRow = any> implements AfterContentInit {
     /** Build an Angular DigitInfo string from min/max fraction-digit hints. */
     numberFormat(col: EfDataCardColumn): string;
     /** Which tools panel is open, if any. */
-    readonly openTool: _angular_core.WritableSignal<"density" | "columns">;
+    readonly openTool: _angular_core.WritableSignal<"density" | "columns" | null>;
     /**
      * Density this table starts at.
      *
@@ -4828,8 +5282,8 @@ declare class EfDataCardComponent<TRow = any> implements AfterContentInit {
         to: number;
     }>;
     /** Index being dragged, and the index it would land on. */
-    readonly dragFrom: _angular_core.WritableSignal<number>;
-    readonly dragTo: _angular_core.WritableSignal<number>;
+    readonly dragFrom: _angular_core.WritableSignal<number | null>;
+    readonly dragTo: _angular_core.WritableSignal<number | null>;
     onDragPointerDown(index: number, ev: PointerEvent): void;
     onDragPointerMove(ev: PointerEvent): void;
     onDragPointerUp(): void;
@@ -4856,8 +5310,17 @@ declare class EfDataCardComponent<TRow = any> implements AfterContentInit {
     readonly fixedLayout: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Row density. Applied as a class on `.tbl-wrap`. */
     readonly density: _angular_core.WritableSignal<EfTableDensity>;
-    /** Column ids the viewer has hidden. */
-    readonly hiddenColumnIds: _angular_core.WritableSignal<readonly string[]>;
+    /**
+     * The viewer's own column choice: from the saved preferences, or from
+     * the Columns picker. `null` until there is one, so the columns'
+     * `defaultHidden` flags decide.
+     */
+    private readonly chosenHiddenColumnIds;
+    /** Columns hidden until the viewer says otherwise. Only ones the
+     *  picker lists, so a default can always be undone. */
+    private readonly defaultHiddenColumnIds;
+    /** Column ids hidden right now: the viewer's choice, else the defaults. */
+    readonly hiddenColumnIds: _angular_core.Signal<readonly string[]>;
     readonly densityOptions: ReadonlyArray<{
         value: EfTableDensity;
         labelKey: string;
@@ -4894,6 +5357,7 @@ declare class EfDataCardComponent<TRow = any> implements AfterContentInit {
     setDensity(value: EfTableDensity): void;
     isColumnHidden(id: string): boolean;
     toggleColumn(id: string): void;
+    /** "Show all columns": every column, the `defaultHidden` ones included. */
     resetColumns(): void;
     /** Close an open panel on an outside click or Escape. */
     onDocumentClick(event: MouseEvent): void;
@@ -4960,11 +5424,17 @@ declare class EfDataCardComponent<TRow = any> implements AfterContentInit {
      * only missing half of the interaction.
      */
     onRowKeydown(row: TRow, event: Event): void;
+    /**
+     * Space activates a button as Enter does (APG). Only when the row itself
+     * has focus: Space on a checkbox or button inside the row is theirs.
+     * preventDefault keeps the page (or a dialog body) from scrolling.
+     */
+    onRowSpace(row: TRow, event: Event): void;
     onHeaderClick(col: EfDataCardColumn): void;
     trackByRow: (_: number, row: TRow) => unknown;
     trackByColumn: (_: number, col: EfDataCardColumn) => string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<EfDataCardComponent<any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfDataCardComponent<any>, "ef-data-card", never, { "mobileLayout": { "alias": "mobileLayout"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "trackByField": { "alias": "trackByField"; "required": false; "isSignal": true; }; "pageNumber": { "alias": "pageNumber"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "totalCount": { "alias": "totalCount"; "required": false; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "hidePager": { "alias": "hidePager"; "required": false; "isSignal": true; }; "sort": { "alias": "sort"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "errorMsg": { "alias": "errorMsg"; "required": false; "isSignal": true; }; "loadingKey": { "alias": "loadingKey"; "required": false; "isSignal": true; }; "rowDoubleClickable": { "alias": "rowDoubleClickable"; "required": false; "isSignal": true; }; "hasActionsColumn": { "alias": "hasActionsColumn"; "required": false; "isSignal": true; }; "rowActionsContext": { "alias": "rowActionsContext"; "required": false; "isSignal": true; }; "showViewAction": { "alias": "showViewAction"; "required": false; "isSignal": true; }; "showEditAction": { "alias": "showEditAction"; "required": false; "isSignal": true; }; "showDuplicateAction": { "alias": "showDuplicateAction"; "required": false; "isSignal": true; }; "showDeleteAction": { "alias": "showDeleteAction"; "required": false; "isSignal": true; }; "showDensityControl": { "alias": "showDensityControl"; "required": false; "isSignal": true; }; "showColumnPicker": { "alias": "showColumnPicker"; "required": false; "isSignal": true; }; "showExportControl": { "alias": "showExportControl"; "required": false; "isSignal": true; }; "exporting": { "alias": "exporting"; "required": false; "isSignal": true; }; "screenContext": { "alias": "screenContext"; "required": false; "isSignal": true; }; "searchTerm": { "alias": "searchTerm"; "required": false; "isSignal": true; }; "tableKey": { "alias": "tableKey"; "required": false; "isSignal": true; }; "defaultDensity": { "alias": "defaultDensity"; "required": false; "isSignal": true; }; "reorderable": { "alias": "reorderable"; "required": false; "isSignal": true; }; "fixedLayout": { "alias": "fixedLayout"; "required": false; "isSignal": true; }; }, { "pageChange": "pageChange"; "pageSizeChange": "pageSizeChange"; "sortChange": "sortChange"; "rowDoubleClick": "rowDoubleClick"; "rowAction": "rowAction"; "exportRequest": "exportRequest"; "clearSearch": "clearSearch"; "retry": "retry"; "rowReorder": "rowReorder"; }, ["bodyTemplates", "headerTemplates"], ["[tbl-head-info]", "[tbl-head-actions]", "[empty-state-mobile]", "[empty-state]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfDataCardComponent<any>, "ef-data-card", never, { "mobileLayout": { "alias": "mobileLayout"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "trackByField": { "alias": "trackByField"; "required": false; "isSignal": true; }; "pageNumber": { "alias": "pageNumber"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "totalCount": { "alias": "totalCount"; "required": false; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "hidePager": { "alias": "hidePager"; "required": false; "isSignal": true; }; "sort": { "alias": "sort"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "errorMsg": { "alias": "errorMsg"; "required": false; "isSignal": true; }; "loadingKey": { "alias": "loadingKey"; "required": false; "isSignal": true; }; "rowDoubleClickable": { "alias": "rowDoubleClickable"; "required": false; "isSignal": true; }; "rowPressed": { "alias": "rowPressed"; "required": false; "isSignal": true; }; "rowDisabled": { "alias": "rowDisabled"; "required": false; "isSignal": true; }; "hasActionsColumn": { "alias": "hasActionsColumn"; "required": false; "isSignal": true; }; "rowActionsContext": { "alias": "rowActionsContext"; "required": false; "isSignal": true; }; "showViewAction": { "alias": "showViewAction"; "required": false; "isSignal": true; }; "showEditAction": { "alias": "showEditAction"; "required": false; "isSignal": true; }; "showDuplicateAction": { "alias": "showDuplicateAction"; "required": false; "isSignal": true; }; "showDeleteAction": { "alias": "showDeleteAction"; "required": false; "isSignal": true; }; "rowActionState": { "alias": "rowActionState"; "required": false; "isSignal": true; }; "showDensityControl": { "alias": "showDensityControl"; "required": false; "isSignal": true; }; "showColumnPicker": { "alias": "showColumnPicker"; "required": false; "isSignal": true; }; "showExportControl": { "alias": "showExportControl"; "required": false; "isSignal": true; }; "exporting": { "alias": "exporting"; "required": false; "isSignal": true; }; "screenContext": { "alias": "screenContext"; "required": false; "isSignal": true; }; "searchTerm": { "alias": "searchTerm"; "required": false; "isSignal": true; }; "tableKey": { "alias": "tableKey"; "required": false; "isSignal": true; }; "defaultDensity": { "alias": "defaultDensity"; "required": false; "isSignal": true; }; "reorderable": { "alias": "reorderable"; "required": false; "isSignal": true; }; "fixedLayout": { "alias": "fixedLayout"; "required": false; "isSignal": true; }; }, { "pageChange": "pageChange"; "pageSizeChange": "pageSizeChange"; "sortChange": "sortChange"; "rowDoubleClick": "rowDoubleClick"; "rowAction": "rowAction"; "exportRequest": "exportRequest"; "clearSearch": "clearSearch"; "retry": "retry"; "rowReorder": "rowReorder"; }, ["bodyTemplates", "headerTemplates"], ["[tbl-head-info]", "[tbl-head-actions]", "[empty-state-mobile]", "[empty-state]"], true, never>;
 }
 
 /**
@@ -5095,6 +5565,7 @@ declare class EfOverflowTooltipDirective {
 declare class EfRowActionsComponent {
     private readonly host;
     private readonly shortcuts;
+    private readonly injector;
     /** Distinguishes this instance's registrations from every other row's:
      *  each row on screen constructs its own component, and ids must not
      *  collide or one row's disposer (and its `when`) would clobber
@@ -5107,7 +5578,7 @@ declare class EfRowActionsComponent {
     readonly items: _angular_core.InputSignal<readonly EfRowAction[]>;
     /** Optional context — when present, items with a `permission` are
      *  filtered against `context.isGranted(permission)`. */
-    readonly context: _angular_core.InputSignal<ScreenContext>;
+    readonly context: _angular_core.InputSignal<ScreenContext | undefined>;
     /** Override the trigger icon (default ellipsis). */
     readonly triggerIcon: _angular_core.InputSignal<string>;
     /** Override the trigger aria-label translation key. */
@@ -5140,6 +5611,17 @@ declare class EfRowActionsComponent {
     private static openInstance;
     toggle(event: MouseEvent): void;
     runCommand(action: EfRowAction, event: MouseEvent): void;
+    /** Id of the visible reason a disabled item carries. */
+    reasonId(index: number): string;
+    /** ArrowDown on the closed trigger opens the menu (APG menu button). */
+    openFromKeyboard(event: Event): void;
+    /** Arrow Up/Down (wrapping), Home and End move between items; Escape
+     *  closes and hands focus back to the trigger. */
+    onMenuKeydown(event: KeyboardEvent): void;
+    private menuButtons;
+    private focusTrigger;
+    /** Once the menu is rendered, focus its first enabled item (or the first). */
+    private focusItem;
     close(): void;
     /** Gap between the trigger and the menu, plus a little breathing room
      *  against the viewport edge. Matches `top: calc(100% + 8px)`. */
@@ -5163,7 +5645,7 @@ declare class EfRowActionsComponent {
         bottom: string;
         left: string;
         maxHeight: string;
-    }>;
+    } | null>;
     /**
      * Fixed rather than absolute: inside ef-data-card the table sits in a
      * horizontal scroller, and `overflow-x: auto` makes the block axis clip
@@ -5385,7 +5867,7 @@ declare class EfSmartBarComponent {
     /** Keyboard shortcut that focuses the search input. `null` opts out
      *  (a screen with two smart bars registers the binding on only one
      *  of them). Defaults to `'mod+k'`. */
-    readonly shortcut: _angular_core.InputSignal<string>;
+    readonly shortcut: _angular_core.InputSignal<string | null>;
     /**
      * Accessible name for the search field: the placeholder text, which
      * already says what this box searches ("Search by order N, customer,
@@ -5450,7 +5932,7 @@ declare class EfFilterPillComponent {
     /** Current value displayed after the label. */
     readonly value: _angular_core.InputSignal<string>;
     /** `'active'` paints ink-active; `'tenant'` paints the tenant-50 surface. */
-    readonly tone: _angular_core.InputSignal<"active" | "tenant" | "neutral">;
+    readonly tone: _angular_core.InputSignal<"tenant" | "neutral" | "active">;
     /** Show the ✕ clear button at the end of the pill. */
     readonly hasClear: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Show a chevron + position the projected `[popover]` slot. */
@@ -5521,7 +6003,7 @@ declare class EfServerErrorsDirective {
     /** Field-name → messages map (camelCase keys, matching control `name`). */
     readonly errors: _angular_core.InputSignal<{
         [key: string]: string[];
-    }>;
+    } | null>;
     /** Messages for a control by its `name`, or `null` when none. */
     errorsFor(name: string | undefined | null): string[] | null;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<EfServerErrorsDirective, never>;
@@ -5645,7 +6127,7 @@ declare class EfRadioComponent extends AbstractEfFormControl implements ControlV
     selectionChangeEvent: EventEmitter<any>;
     private onChange;
     private onTouched;
-    readonly ngControl: NgControl;
+    readonly ngControl: NgControl | null;
     constructor();
     get hasLabel(): boolean;
     /** Shared `name` so the browser treats the options as one group. */
@@ -5685,12 +6167,16 @@ declare class EfRadioComponent extends AbstractEfFormControl implements ControlV
  *   [rows]="4"
  *   [(value)]="description"
  * />
+ * <ef-textarea labelKey="store_pages_details_body_fr" mono [rows]="12" [(value)]="bodyFr" />
  * ```
  */
 declare class EfTextareaComponent extends AbstractEfFormControl implements ControlValueAccessor {
     rows: number;
     maxlength?: number;
     autofocus: boolean;
+    /** Monospace face for source text (an HTML body, a JSON snippet), where
+     *  tags and indentation must stay readable. */
+    mono: boolean;
     valueChangeEvent: EventEmitter<string>;
     /** Two-way-bindable as `[value]` (one-way) or
      *  `[(value)]="signal()"` (set + listen via `valueChangeEvent`). */
@@ -5700,7 +6186,7 @@ declare class EfTextareaComponent extends AbstractEfFormControl implements Contr
     clearValue(): void;
     private onChange;
     private onTouched;
-    readonly ngControl: NgControl;
+    readonly ngControl: NgControl | null;
     constructor();
     get isInvalid(): boolean;
     get serverErrors(): string[] | null;
@@ -5712,8 +6198,123 @@ declare class EfTextareaComponent extends AbstractEfFormControl implements Contr
     handleInput(value: string): void;
     handleBlur(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<EfTextareaComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfTextareaComponent, "ef-textarea", never, { "rows": { "alias": "rows"; "required": false; }; "maxlength": { "alias": "maxlength"; "required": false; }; "autofocus": { "alias": "autofocus"; "required": false; }; "value": { "alias": "value"; "required": false; }; }, { "valueChangeEvent": "valueChangeEvent"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfTextareaComponent, "ef-textarea", never, { "rows": { "alias": "rows"; "required": false; }; "maxlength": { "alias": "maxlength"; "required": false; }; "autofocus": { "alias": "autofocus"; "required": false; }; "mono": { "alias": "mono"; "required": false; }; "value": { "alias": "value"; "required": false; }; }, { "valueChangeEvent": "valueChangeEvent"; }, never, never, true, never>;
     static ngAcceptInputType_autofocus: unknown;
+    static ngAcceptInputType_mono: unknown;
+}
+
+/** A language the SEO texts are written in. */
+interface EfSeoLocale {
+    code: string;
+    labelKey: string;
+    dir: 'auto' | 'rtl' | 'ltr';
+}
+/** What the fields write back: French is the scalar, every other language a dictionary entry. */
+interface EfSeoPatch {
+    seoTitle?: string;
+    seoDescription?: string;
+    seoTitleTranslations?: Record<string, string>;
+    seoDescriptionTranslations?: Record<string, string>;
+}
+type Field = 'title' | 'description';
+declare const EF_SEO_DEFAULT_LOCALES: ReadonlyArray<EfSeoLocale>;
+/**
+ * SEO title and description per language, each with a counter against what a
+ * search engine shows (60 / 160), capped at the server's limits (256 / 512),
+ * and the shared `ef-seo-preview` of the French result with the entity's own
+ * title and description as the fallback the shop uses. Card-less: each screen
+ * wraps it in its own `ef-card`.
+ *
+ * The French controls carry the backend names (`seoTitle`, `seoDescription`)
+ * so `[efServerErrors]` links their errors; the others (`seoTitleAr`, ...) are
+ * dictionary entries whose errors are toasted (ADR-010).
+ *
+ * ```html
+ * <ef-seo-fields [seoTitle]="p.seoTitle" ... [previewUrl]="url()" (seoChange)="patch($event)" />
+ * ```
+ */
+declare class EfSeoFieldsComponent {
+    readonly seoTitle: _angular_core.InputSignal<string | null | undefined>;
+    readonly seoDescription: _angular_core.InputSignal<string | null | undefined>;
+    readonly seoTitleTranslations: _angular_core.InputSignal<Record<string, string> | null | undefined>;
+    readonly seoDescriptionTranslations: _angular_core.InputSignal<Record<string, string> | null | undefined>;
+    /** The entity's own texts, which the shop uses when SEO is empty. */
+    readonly fallbackTitle: _angular_core.InputSignal<string | null | undefined>;
+    readonly fallbackDescription: _angular_core.InputSignal<string | null | undefined>;
+    /** The page address shown in the preview, computed by the app. */
+    readonly previewUrl: _angular_core.InputSignal<string>;
+    readonly titleMax: _angular_core.InputSignal<number>;
+    readonly descriptionMax: _angular_core.InputSignal<number>;
+    readonly titleAdvised: _angular_core.InputSignal<number>;
+    readonly descriptionAdvised: _angular_core.InputSignal<number>;
+    readonly locales: _angular_core.InputSignal<readonly EfSeoLocale[]>;
+    readonly seoChange: _angular_core.OutputEmitterRef<EfSeoPatch>;
+    text(locale: string, field: Field): string;
+    /** Id of a counter, which the field it counts points at with `aria-describedby`. */
+    counterId(locale: string, field: Field): string;
+    private readonly uid;
+    /** French matches the backend property; the others are unique for the label link. */
+    name(locale: string, field: Field): string;
+    setText(locale: string, field: Field, value: string): void;
+    protected readonly previewTitle: _angular_core.Signal<string>;
+    protected readonly previewDescription: _angular_core.Signal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<EfSeoFieldsComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfSeoFieldsComponent, "ef-seo-fields", never, { "seoTitle": { "alias": "seoTitle"; "required": false; "isSignal": true; }; "seoDescription": { "alias": "seoDescription"; "required": false; "isSignal": true; }; "seoTitleTranslations": { "alias": "seoTitleTranslations"; "required": false; "isSignal": true; }; "seoDescriptionTranslations": { "alias": "seoDescriptionTranslations"; "required": false; "isSignal": true; }; "fallbackTitle": { "alias": "fallbackTitle"; "required": false; "isSignal": true; }; "fallbackDescription": { "alias": "fallbackDescription"; "required": false; "isSignal": true; }; "previewUrl": { "alias": "previewUrl"; "required": false; "isSignal": true; }; "titleMax": { "alias": "titleMax"; "required": false; "isSignal": true; }; "descriptionMax": { "alias": "descriptionMax"; "required": false; "isSignal": true; }; "titleAdvised": { "alias": "titleAdvised"; "required": false; "isSignal": true; }; "descriptionAdvised": { "alias": "descriptionAdvised"; "required": false; "isSignal": true; }; "locales": { "alias": "locales"; "required": false; "isSignal": true; }; }, { "seoChange": "seoChange"; }, never, never, true, never>;
+}
+
+type EfFileRejectReason = 'size' | 'type';
+interface EfFileRejection {
+    file: File;
+    reason: EfFileRejectReason;
+}
+/**
+ * A button that opens the native file picker and emits the chosen `File`.
+ * It never talks to the network: the app uploads the emitted file through its
+ * NSwag client (`client.uploadLogo({ data: file, fileName: file.name })`).
+ *
+ * - The button is a real `<button>`, so Enter/Space work and a screen reader
+ *   announces it by its label (`labelKey`) or `ariaLabelKey` when icon-only.
+ *   The native input is hidden from the tab order and the accessibility tree.
+ * - `accept` is the usual `<input accept>` list (MIME types, `image/*`,
+ *   `.ext`); it is checked again on the chosen file, because the picker's
+ *   filter can be bypassed.
+ * - `maxSizeBytes` rejects larger files. A rejected file is not emitted;
+ *   `(fileRejected)` fires and a live region shows `sizeErrorKey` or
+ *   `typeErrorKey` (translated).
+ * - On a coarse pointer (touch phone, tablet, touch laptop) the painted button
+ *   is `--hit-touch` (48px), as `ef-pill-group` does.
+ *
+ * ```html
+ * <ef-file-upload labelKey="tenant_logo_upload" accept="image/png,image/jpeg"
+ *     [maxSizeBytes]="2097152" sizeErrorKey="file_too_large"
+ *     (fileSelected)="upload($event)" />
+ * ```
+ */
+declare class EfFileUploadComponent {
+    /** Visible label (translation key). Omit for an icon-only button and set `ariaLabelKey`. */
+    readonly labelKey: _angular_core.InputSignal<string | undefined>;
+    readonly ariaLabelKey: _angular_core.InputSignal<string | undefined>;
+    readonly icon: _angular_core.InputSignal<string | undefined>;
+    readonly severity: _angular_core.InputSignal<"primary" | "danger" | "tenant" | "ghost">;
+    /** The `<input accept>` list: MIME types, `type/*` and `.ext`, comma separated. */
+    readonly accept: _angular_core.InputSignal<string | undefined>;
+    readonly maxSizeBytes: _angular_core.InputSignal<number | undefined>;
+    /** Translation key shown when the file is over `maxSizeBytes`. */
+    readonly sizeErrorKey: _angular_core.InputSignal<string>;
+    /** Translation key shown when the file does not match `accept`. */
+    readonly typeErrorKey: _angular_core.InputSignal<string>;
+    readonly disabled: _angular_core.InputSignal<boolean>;
+    readonly fileSelected: _angular_core.OutputEmitterRef<File>;
+    readonly fileRejected: _angular_core.OutputEmitterRef<EfFileRejection>;
+    private readonly picker;
+    private readonly reason;
+    protected readonly errorKey: _angular_core.Signal<string | null>;
+    protected open(): void;
+    protected onChange(event: Event): void;
+    private check;
+    private matchesAccept;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<EfFileUploadComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfFileUploadComponent, "ef-file-upload", never, { "labelKey": { "alias": "labelKey"; "required": false; "isSignal": true; }; "ariaLabelKey": { "alias": "ariaLabelKey"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "severity": { "alias": "severity"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "maxSizeBytes": { "alias": "maxSizeBytes"; "required": false; "isSignal": true; }; "sizeErrorKey": { "alias": "sizeErrorKey"; "required": false; "isSignal": true; }; "typeErrorKey": { "alias": "typeErrorKey"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "fileSelected": "fileSelected"; "fileRejected": "fileRejected"; }, never, never, true, never>;
 }
 
 interface EfPresetItem<T = string> {
@@ -5750,9 +6351,9 @@ declare class EfPresetPillComponent<T = string> {
     readonly icon: _angular_core.InputSignal<string>;
     readonly labelKey: _angular_core.InputSignal<string>;
     readonly label: _angular_core.InputSignal<string>;
-    readonly tone: _angular_core.InputSignal<"active" | "tenant" | "neutral">;
+    readonly tone: _angular_core.InputSignal<"tenant" | "neutral" | "active">;
     readonly presets: _angular_core.InputSignal<readonly EfPresetItem<T>[]>;
-    readonly activeKey: _angular_core.ModelSignal<T>;
+    readonly activeKey: _angular_core.ModelSignal<T | null>;
     /** Two-way; consumer can hoist for controlled mode. */
     readonly open: _angular_core.ModelSignal<boolean>;
     /** Auto-close the popover after selection (default on). */
@@ -5797,6 +6398,8 @@ interface EfDatePreset {
  *  a `[start, end]` tuple for a range — so `ef-datepicker-advanced` is a
  *  drop-in replacement for the legacy `ef-datepicker` in forms. */
 type EfDateFieldValue = Date | [Date, Date] | null;
+/** What the form receives: a Date shape, or with `valueFormat="local-datetime"` wall-time strings. */
+type EfDateFieldOutput = EfDateFieldValue | string | [string, string];
 /**
  * Comptoir period selector for smart-bars — a pill trigger ("Date — 30
  * derniers jours v") that opens a popover with a preset list and an
@@ -5836,7 +6439,7 @@ declare class EfDatepickerAdvancedComponent extends AbstractEfFormControl implem
      * `NG_VALUE_ACCESSOR` provider is needed and there's no circular DI.
      * `null` in filter mode (the output-only smart-bar usage).
      */
-    readonly ngControl: NgControl;
+    readonly ngControl: NgControl | null;
     /** Always-present wrapper — the anchor for portal positioning (the
      *  trigger itself lives behind an `@if`, so we anchor to the host box). */
     private anchorEl;
@@ -5858,13 +6461,13 @@ declare class EfDatepickerAdvancedComponent extends AbstractEfFormControl implem
      * `last_90_days`, `this_quarter`, `this_year` — pass anything to
      * replace them outright (e.g. include a `last_year` preset).
      */
-    readonly presets: _angular_core.InputSignal<readonly EfDatePreset[]>;
+    readonly presets: _angular_core.InputSignal<readonly EfDatePreset[] | undefined>;
     /** Currently active preset key (controlled). */
-    readonly activePreset: _angular_core.InputSignal<string>;
+    readonly activePreset: _angular_core.InputSignal<string | undefined>;
     /** Currently selected start (controlled — pairs with `activePreset`). */
-    readonly start: _angular_core.InputSignal<Date>;
+    readonly start: _angular_core.InputSignal<Date | null | undefined>;
     /** Currently selected end. */
-    readonly end: _angular_core.InputSignal<Date>;
+    readonly end: _angular_core.InputSignal<Date | null | undefined>;
     /** Show a `'Personnalisé…'` row that opens the calendar view. */
     readonly allowCustomRange: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /**
@@ -5891,6 +6494,17 @@ declare class EfDatepickerAdvancedComponent extends AbstractEfFormControl implem
      * start-of-day) and the trigger renders `DD/MM/YYYY HH:mm`.
      */
     readonly showTime: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Field mode only: the value shape the form sees.
+     * - `'date'` (default): a `Date` (or `[start, end]`).
+     * - `'local-datetime'`: wall time as a `yyyy-MM-ddTHH:mm` string (or a
+     *   pair), read and written from the date's local components, never
+     *   through UTC. For times that belong to another zone than the
+     *   browser's (a shop's opening time, an offer's start), where the
+     *   server converts and the browser must not. A string in any other
+     *   shape (seconds, `Z`, an offset) is ignored rather than guessed.
+     */
+    readonly valueFormat: _angular_core.InputSignal<"date" | "local-datetime">;
     /** Emitted whenever a preset or applied custom range changes. */
     readonly rangeChange: _angular_core.OutputEmitterRef<EfDateRange>;
     /** Forwarded when the popover opens / closes (mirrors ef-row-actions). */
@@ -5910,8 +6524,8 @@ declare class EfDatepickerAdvancedComponent extends AbstractEfFormControl implem
     /** Custom view: month being displayed (1st of the month, 00:00). */
     readonly visibleMonth: _angular_core.WritableSignal<Date>;
     /** Custom view: working start/end, before the user clicks Apply. */
-    readonly draftStart: _angular_core.WritableSignal<Date>;
-    readonly draftEnd: _angular_core.WritableSignal<Date>;
+    readonly draftStart: _angular_core.WritableSignal<Date | null>;
+    readonly draftEnd: _angular_core.WritableSignal<Date | null>;
     /** Effective preset list — defaults if none provided. */
     readonly effectivePresets: _angular_core.Signal<readonly EfDatePreset[]>;
     /** Current value resolved against today's date. */
@@ -5955,8 +6569,8 @@ declare class EfDatepickerAdvancedComponent extends AbstractEfFormControl implem
     /** Committed value pushed in via `writeValue` / day-pick / Apply. */
     private readonly fieldValue;
     /** Committed start / end derived from `fieldValue`. */
-    readonly fieldStart: _angular_core.Signal<Date>;
-    readonly fieldEnd: _angular_core.Signal<Date>;
+    readonly fieldStart: _angular_core.Signal<Date | null>;
+    readonly fieldEnd: _angular_core.Signal<Date | null>;
     /** Whether the field currently holds a value (vs. placeholder). */
     readonly hasFieldValue: _angular_core.Signal<boolean>;
     /** Text rendered in the field-mode trigger (date, +time when enabled). */
@@ -5980,8 +6594,8 @@ declare class EfDatepickerAdvancedComponent extends AbstractEfFormControl implem
     get serverErrors(): string[] | null;
     /** Invalid + interacted — drives the red border on the field box. */
     get isInvalid(): boolean;
-    writeValue(value: Date | Date[] | string | number | null | undefined): void;
-    registerOnChange(fn: (value: EfDateFieldValue) => void): void;
+    writeValue(value: Date | Date[] | string | string[] | number | null | undefined): void;
+    registerOnChange(fn: (value: EfDateFieldOutput) => void): void;
     registerOnTouched(fn: () => void): void;
     setDisabledState(isDisabled: boolean): void;
     protected get hasValue(): boolean;
@@ -5990,6 +6604,13 @@ declare class EfDatepickerAdvancedComponent extends AbstractEfFormControl implem
      *  Tolerates `null`, `[start, null]`, strings/epochs, and stray
      *  multi-element arrays (keeps the first two). */
     private coerceValue;
+    /** `local-datetime` in: `yyyy-MM-ddTHH:mm` built into a Date from its
+     *  parts (local time), never through `Date` string parsing. */
+    private coerceLocal;
+    private parseLocalDateTime;
+    /** `local-datetime` out: the Date's local components, zero-padded. */
+    private formatLocalDateTime;
+    private toOutput;
     private toDate;
     /** Commit a field-mode value: update internal state, notify the form,
      *  and close the popover. `single` → `Date`, `range` → `[start, end]`. */
@@ -6076,7 +6697,7 @@ declare class EfDatepickerAdvancedComponent extends AbstractEfFormControl implem
     }) => number;
     trackByDow: (_: number, label: string) => string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<EfDatepickerAdvancedComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfDatepickerAdvancedComponent, "ef-datepicker-advanced", never, { "triggerLabelKey": { "alias": "triggerLabelKey"; "required": false; "isSignal": true; }; "triggerLabel": { "alias": "triggerLabel"; "required": false; "isSignal": true; }; "presets": { "alias": "presets"; "required": false; "isSignal": true; }; "activePreset": { "alias": "activePreset"; "required": false; "isSignal": true; }; "start": { "alias": "start"; "required": false; "isSignal": true; }; "end": { "alias": "end"; "required": false; "isSignal": true; }; "allowCustomRange": { "alias": "allowCustomRange"; "required": false; "isSignal": true; }; "allowAllTime": { "alias": "allowAllTime"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "selectionMode": { "alias": "selectionMode"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "showTime": { "alias": "showTime"; "required": false; "isSignal": true; }; }, { "rangeChange": "rangeChange"; "opened": "opened"; "closed": "closed"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfDatepickerAdvancedComponent, "ef-datepicker-advanced", never, { "triggerLabelKey": { "alias": "triggerLabelKey"; "required": false; "isSignal": true; }; "triggerLabel": { "alias": "triggerLabel"; "required": false; "isSignal": true; }; "presets": { "alias": "presets"; "required": false; "isSignal": true; }; "activePreset": { "alias": "activePreset"; "required": false; "isSignal": true; }; "start": { "alias": "start"; "required": false; "isSignal": true; }; "end": { "alias": "end"; "required": false; "isSignal": true; }; "allowCustomRange": { "alias": "allowCustomRange"; "required": false; "isSignal": true; }; "allowAllTime": { "alias": "allowAllTime"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "selectionMode": { "alias": "selectionMode"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "showTime": { "alias": "showTime"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; }, { "rangeChange": "rangeChange"; "opened": "opened"; "closed": "closed"; }, never, never, true, never>;
 }
 
 /**
@@ -6141,13 +6762,17 @@ declare class EfActivationFilterComponent {
     readonly allLabelKey: _angular_core.InputSignal<string>;
     readonly activeLabelKey: _angular_core.InputSignal<string>;
     readonly inactiveLabelKey: _angular_core.InputSignal<string>;
-    readonly valueChange: _angular_core.OutputEmitterRef<boolean>;
+    readonly valueChange: _angular_core.OutputEmitterRef<boolean | undefined>;
     readonly selected: _angular_core.Signal<"active" | "inactive" | "all">;
-    readonly buckets: _angular_core.Signal<{
+    readonly buckets: _angular_core.Signal<({
+        key: string;
+        labelKey: string;
+        value: undefined;
+    } | {
         key: string;
         labelKey: string;
         value: boolean;
-    }[]>;
+    })[]>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<EfActivationFilterComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfActivationFilterComponent, "ef-activation-filter", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "labelKey": { "alias": "labelKey"; "required": false; "isSignal": true; }; "allLabelKey": { "alias": "allLabelKey"; "required": false; "isSignal": true; }; "activeLabelKey": { "alias": "activeLabelKey"; "required": false; "isSignal": true; }; "inactiveLabelKey": { "alias": "inactiveLabelKey"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
 }
@@ -6179,7 +6804,7 @@ declare class EfThemeConfiguratorComponent implements OnInit {
     presetsDisplayNameKeys: Record<string, string>;
     get ripple(): boolean;
     set ripple(value: boolean);
-    get isRTL(): boolean;
+    get isRTL(): boolean | undefined;
     config: PrimeNG;
     configService: EfThemeConfigService;
     platformId: Object;
@@ -6203,9 +6828,9 @@ declare class EfThemeConfiguratorComponent implements OnInit {
             950: string;
         };
     }[];
-    selectedPrimaryColor: _angular_core.Signal<string>;
-    selectedSurfaceColor: _angular_core.Signal<string>;
-    selectedPreset: _angular_core.Signal<string>;
+    selectedPrimaryColor: _angular_core.Signal<string | undefined>;
+    selectedSurfaceColor: _angular_core.Signal<string | undefined>;
+    selectedPreset: _angular_core.Signal<string | undefined>;
     primaryColors: _angular_core.Signal<{
         name: string;
         palette: Record<string, string>;
@@ -6246,7 +6871,7 @@ declare class EfEmailMetricsCardComponent {
     protected readonly noAutofocus: {
         autofocus: boolean;
     };
-    metrics: _angular_core.InputSignal<EmailMetrics>;
+    metrics: _angular_core.InputSignal<EmailMetrics | null>;
     recentEvents: _angular_core.InputSignal<EmailEventRecord[]>;
     loading: _angular_core.InputSignal<boolean>;
     title: _angular_core.InputSignal<string>;
@@ -6275,5 +6900,5 @@ declare class EfEmailMetricsCardComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfEmailMetricsCardComponent, "ef-email-metrics-card", never, { "metrics": { "alias": "metrics"; "required": false; "isSignal": true; }; "recentEvents": { "alias": "recentEvents"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; }, { "rangeChange": "rangeChange"; }, never, never, true, never>;
 }
 
-export { EF_BADGE_BG_COLORS, EF_BADGE_BG_LIGHT_COLORS, EF_BADGE_BORDER_COLORS, EF_BADGE_DEFAULTS, EF_BADGE_TEXT_COLORS, EF_CHART_PALETTE, EF_DATATABLE_ACTIONS_DEFAULTS, EF_DATATABLE_COLUMN_DEFAULTS, EF_DATATABLE_DEFAULTS, EF_DATA_CARD_MOBILE_LAYOUT, EF_STATUS_COLORS, EF_STATUS_COLOR_ALIASES, EfAboutDialogComponent, EfActivationFilterComponent, EfAppMainComponent, EfAppShellComponent, EfAppShellMobileComponent, EfAppTopComponent, EfBadgeComponent, EfBlockUiComponent, EfBlockableDivComponent, EfBottomSheetComponent, EfBuildStampComponent, EfBulkBarComponent, EfButtonComponent, EfButtonGroupComponent, EfCardComponent, EfChangeHistoryComponent, EfChangePasswordComponent, EfChartComponent, EfCheckboxComponent, EfClearButtonComponent, EfColumnHeaderTemplateDirective, EfColumnTemplateDirective, EfCompactPipe, EfConfirmDialogComponent, EfCurrencyPipe, EfDataCardComponent, EfDatatableActionBarComponent, EfDatatableComponent, EfDatepickerAdvancedComponent, EfDatepickerComponent, EfDetailToolbarComponent, EfDialogComponent, EfEmailMetricsCardComponent, EfEmptyStateComponent, EfFabComponent, EfFieldsetComponent, EfFilterDrawerComponent, EfFilterPillComponent, EfFormGridComponent, EfInputNumberComponent, EfInputTextComponent, EfKpiCardComponent, EfLabelComponent, EfModuleRailComponent, EfModuleSideComponent, EfMultiSelectComponent, EfOrderBuilderComponent, EfOrderSummaryComponent, EfOverflowTooltipDirective, EfPagerComponent, EfPasswordComponent, EfPdfPreviewComponent, EfPillGroupComponent, EfPresetPillComponent, EfPriceDisplayComponent, EfProductCatalogueComponent, EfProductCatalogueFilterComponent, EfProductTypeaheadComponent, EfProfileChipComponent, EfProfileMenuComponent, EfPulseComponent, EfQuantitySelectorComponent, EfQuantityStepperComponent, EfRadioComponent, EfRankListComponent, EfReadOnlyDirective, EfRowActionsComponent, EfSearchToolbarComponent, EfSelectButtonComponent, EfSelectComponent, EfServerErrorsDirective, EfSessionIdleDialogComponent, EfShortcutsDialogComponent, EfSkeletonComponent, EfSmartBarComponent, EfStatsComponent, EfStatusChipComponent, EfTabPanelDirective, EfTabsComponent, EfTextareaComponent, EfThemeConfiguratorComponent, EfThemeToggleComponent, EfTimelineComponent, EfToastRegionComponent, EfToggleSwitchComponent, EfToolbarComponent, EfTooltipDirective, EfTotalsComponent, OrderEntityHelper, OrderLineItemHelper, TruncatePipe, buildChartConfig, getColumnAlignment, mergeColumnDefaults, resolveEfStatusColor };
-export type { CatalogueProduct, CatalogueProductVariant, CategoryAssignment, CategoryGroup, CategoryItem, DatatableSearchEntity, DocumentConfig, EfAboutServer, EfBadgeColor, EfBadgeConfig, EfBadgeSize, EfBadgeVariant, EfButtonComptoirSeverity, EfButtonPrimeNGSeverity, EfButtonSeverity, EfChangeHistoryEntry, EfChangeHistoryFieldChange, EfChangePasswordSubmit, EfChartSeries, EfChartType, EfDataCardMobileLayout, EfDataCardRowAction, EfDatatableActions, EfDatatableColumn, EfDatatableColumnAlign, EfDatatableColumnType, EfDatatableConfig, EfDateFieldValue, EfDatePreset, EfDialogAction, EfDialogSeverity, EfDialogSize, EfFabPosition, EfKpiDeltaTone, EfKpiSparkline, EfPillItem, EfPresetItem, EfProfileMenuItem, EfRankRow, EfRowAction, EfSkeletonVariant, EfStatsRow, EfStatusColor, EfStatusReferenceItem, EfTabItem, EfTabsModule, EfTabsVariant, EfTimelineItem, EfTimelineState, EfToastRegionPosition, EfTotalsGrand, EfTotalsRow, HighlightSegment, OrderChangeInfo, OrderEntity, OrderLineItem, OrderProductsSummary, OrderSummaryItem, ProductCountGroup, ProductCountGroupLabel, ProductTypeaheadRow, ProductTypeaheadSelection, ProductWithCountGroup, SelectedFilter, ValidationResult };
+export { EF_BADGE_BG_COLORS, EF_BADGE_BG_LIGHT_COLORS, EF_BADGE_BORDER_COLORS, EF_BADGE_DEFAULTS, EF_BADGE_TEXT_COLORS, EF_CHART_PALETTE, EF_DATATABLE_ACTIONS_DEFAULTS, EF_DATATABLE_COLUMN_DEFAULTS, EF_DATATABLE_DEFAULTS, EF_DATA_CARD_MOBILE_LAYOUT, EF_SEO_DEFAULT_LOCALES, EF_STATUS_COLORS, EF_STATUS_COLOR_ALIASES, EfAboutDialogComponent, EfActivationFilterComponent, EfAppMainComponent, EfAppShellComponent, EfAppShellMobileComponent, EfAppTopComponent, EfBadgeComponent, EfBlockUiComponent, EfBlockableDivComponent, EfBottomSheetComponent, EfBuildStampComponent, EfBulkBarComponent, EfButtonComponent, EfButtonGroupComponent, EfCardComponent, EfChangeHistoryComponent, EfChangePasswordComponent, EfChartComponent, EfCheckboxComponent, EfClearButtonComponent, EfColumnHeaderTemplateDirective, EfColumnTemplateDirective, EfCompactPipe, EfConfirmDialogComponent, EfCurrencyPipe, EfDataCardComponent, EfDatatableActionBarComponent, EfDatatableComponent, EfDatepickerAdvancedComponent, EfDatepickerComponent, EfDetailToolbarComponent, EfDialogComponent, EfEmailMetricsCardComponent, EfEmptyStateComponent, EfFabComponent, EfFieldsetComponent, EfFileUploadComponent, EfFilterDrawerComponent, EfFilterPillComponent, EfFormGridComponent, EfIdentityThumbComponent, EfInputNumberComponent, EfInputTextComponent, EfKpiCardComponent, EfLabelComponent, EfModuleRailComponent, EfModuleSideComponent, EfMultiSelectComponent, EfOrderBuilderComponent, EfOrderSummaryComponent, EfOverflowTooltipDirective, EfPagerComponent, EfPasswordComponent, EfPdfPreviewComponent, EfPillGroupComponent, EfPresetPillComponent, EfPriceDisplayComponent, EfProductCatalogueComponent, EfProductCatalogueFilterComponent, EfProductPickerComponent, EfProductTypeaheadComponent, EfProfileChipComponent, EfProfileMenuComponent, EfPulseComponent, EfQuantitySelectorComponent, EfQuantityStepperComponent, EfRadioComponent, EfRankListComponent, EfReadOnlyDirective, EfRowActionsComponent, EfSearchToolbarComponent, EfSelectButtonComponent, EfSelectComponent, EfSeoFieldsComponent, EfSeoPreviewComponent, EfServerErrorsDirective, EfSessionIdleDialogComponent, EfShortcutsDialogComponent, EfSkeletonComponent, EfSmartBarComponent, EfStatsComponent, EfStatusChipComponent, EfTabPanelDirective, EfTabsComponent, EfTextareaComponent, EfThemeConfiguratorComponent, EfThemeToggleComponent, EfTimelineComponent, EfToastRegionComponent, EfToggleSwitchComponent, EfToolbarComponent, EfTooltipDirective, EfTotalsComponent, OrderEntityHelper, OrderLineItemHelper, TruncatePipe, buildChartConfig, defaultUnitPrice, getColumnAlignment, mergeColumnDefaults, resolveEfStatusColor };
+export type { CatalogueProduct, CatalogueProductVariant, CategoryAssignment, CategoryGroup, CategoryItem, DatatableSearchEntity, DocumentConfig, EfAboutServer, EfBadgeColor, EfBadgeConfig, EfBadgeSize, EfBadgeVariant, EfButtonComptoirSeverity, EfButtonPrimeNGSeverity, EfButtonSeverity, EfChangeHistoryEntry, EfChangeHistoryFieldChange, EfChangePasswordSubmit, EfChartSeries, EfChartType, EfDataCardMobileLayout, EfDataCardRowAction, EfDataCardRowActionState, EfDatatableActions, EfDatatableColumn, EfDatatableColumnAlign, EfDatatableColumnType, EfDatatableConfig, EfDateFieldOutput, EfDateFieldValue, EfDatePreset, EfDialogAction, EfDialogSeverity, EfDialogSize, EfFabPosition, EfFileRejectReason, EfFileRejection, EfIdentityThumbSize, EfKpiDeltaTone, EfKpiSparkline, EfOrderPriceList, EfOrderRecipient, EfPillItem, EfPresetItem, EfProductPickerItem, EfProductPickerQuery, EfProfileMenuItem, EfRankRow, EfRowAction, EfSeoLocale, EfSeoPatch, EfSkeletonVariant, EfStatsRow, EfStatusColor, EfStatusReferenceItem, EfTabItem, EfTabsModule, EfTabsVariant, EfTimelineItem, EfTimelineState, EfToastRegionPosition, EfTotalsGrand, EfTotalsRow, HighlightSegment, OrderChangeInfo, OrderEntity, OrderLineItem, OrderProductsSummary, OrderSummaryItem, ProductCountGroup, ProductCountGroupLabel, ProductTypeaheadRow, ProductTypeaheadSelection, ProductWithCountGroup, SelectedFilter, ValidationResult };