@elasticias/ui 1.0.49 → 1.0.51

package/types/elasticias-ui.d.ts

@@ -10,7 +10,7 @@ import * as _elasticias_core from '@elasticias/core';
 import { EfBuildPackage, EfSessionIdleService, EfModule, EfNavSection, EfNavItem, EfModuleId, EfToast, EfToastAction, EfThemeConfigService } from '@elasticias/core';
 import * as i1 from 'primeng/tooltip';
 import { BlockableUI } from 'primeng/api';
-import { SafeResourceUrl } from '@angular/platform-browser';
+import { SafeResourceUrl, SafeHtml } from '@angular/platform-browser';
 import { ChartConfiguration } from 'chart.js';
 import { ControlValueAccessor, NgControl } from '@angular/forms';
 import { TranslateService } from '@ngx-translate/core';
@@ -70,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
  */
@@ -91,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;
@@ -135,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)
  */
@@ -201,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
      */
@@ -359,6 +385,13 @@ interface EfChangeHistoryEntry {
     toStatus?: string | null;
     note?: string | null;
 }
+/** A reference-list item used to translate a raw audit value: matched on
+ *  `code`, shown as `label`. Structurally compatible with the static reference
+ *  data items screens already load. */
+interface EfChangeHistoryValueItem {
+    code: string;
+    label?: string | null;
+}
 
 /** Emitted when the user picks a product (with its active variant) from the menu. */
 interface ProductTypeaheadSelection {
@@ -397,15 +430,38 @@ 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[];
     }>;
@@ -416,16 +472,28 @@ declare class EfOrderBuilderComponent implements OnInit {
      * 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>;
-    /** Optional change-history entries; when non-empty the Historique rail card renders. */
+    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[]>;
+    /** Passed to the history's `valueLists`: field path to reference items, so
+     *  raw statuses show as translated labels. */
+    auditValueLists: _angular_core.InputSignal<Readonly<Record<string, readonly EfChangeHistoryValueItem[]>> | null>;
+    /** Passed to the history's `noteFormatter`: returns the text for a note, or null for the raw note. */
+    auditNoteFormatter: _angular_core.InputSignal<((note: string) => string | null) | null>;
     openCatalogue: _angular_core.OutputEmitterRef<void>;
     orderChanged: _angular_core.OutputEmitterRef<OrderChangeInfo>;
     orderValidated: _angular_core.OutputEmitterRef<ValidationResult>;
     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>;
@@ -444,7 +512,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>;
@@ -457,7 +525,7 @@ declare class EfOrderBuilderComponent implements OnInit {
     editingCell: _angular_core.WritableSignal<{
         id: OrderLineItem["id"];
         field: EditableLineField;
-    }>;
+    } | null>;
     /**
      * Columns for the lines table.
      *
@@ -535,7 +603,7 @@ declare class EfOrderBuilderComponent implements OnInit {
      */
     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; }; "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, 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; }; "auditValueLists": { "alias": "auditValueLists"; "required": false; "isSignal": true; }; "auditNoteFormatter": { "alias": "auditNoteFormatter"; "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>;
 }
 
 /**
@@ -569,6 +637,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>;
@@ -591,7 +664,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>;
+    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>;
 }
 
 /**
@@ -854,7 +927,7 @@ declare class EfProductPickerComponent {
     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: any;
+    readonly searchShortcut: null;
     protected readonly isMobile: _angular_core.Signal<boolean>;
     private readonly selected;
     readonly selectedIds: _angular_core.Signal<string[]>;
@@ -1007,6 +1080,12 @@ declare class EfProductCatalogueComponent implements OnChanges {
     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>;
     /**
@@ -1020,7 +1099,7 @@ declare class EfProductCatalogueComponent implements OnChanges {
      *   </ng-template>
      * </ef-product-catalogue>
      */
-    productThumbnailTpl: _angular_core.Signal<TemplateRef<unknown>>;
+    productThumbnailTpl: _angular_core.Signal<TemplateRef<unknown> | undefined>;
     sortMenu: Menu;
     /** Emitted when products are validated */
     productsValidated: _angular_core.OutputEmitterRef<{
@@ -1073,11 +1152,13 @@ declare class EfProductCatalogueComponent implements OnChanges {
     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): 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; }; "localeCode": { "alias": "localeCode"; "required": false; "isSignal": true; }; }, { "productsValidated": "productsValidated"; }, ["productThumbnailTpl"], never, true, 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>;
 }
 
 /**
@@ -1137,7 +1218,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>;
@@ -1162,7 +1243,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
@@ -1231,7 +1312,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[]>;
     /**
@@ -1350,7 +1431,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>;
@@ -1490,7 +1571,7 @@ declare class EfButtonComponent implements OnInit {
      * `'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;
@@ -1537,6 +1618,8 @@ declare class EfLabelComponent {
     label?: string;
     /** Translation key — preferred. */
     labelKey?: string;
+    /** Interpolation params for `labelKey`. */
+    labelParams?: Record<string, unknown>;
     /** DOM id of the labelled input. Empty / unset → no `for` attr. */
     for?: string;
     /** Caller-supplied extra class. The Comptoir `.ef-label` class is
@@ -1550,7 +1633,7 @@ declare class EfLabelComponent {
      *  binding replaces (doesn't merge) so we do the joining here. */
     get resolvedClass(): string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<EfLabelComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfLabelComponent, "ef-label", never, { "label": { "alias": "label"; "required": false; }; "labelKey": { "alias": "labelKey"; "required": false; }; "for": { "alias": "for"; "required": false; }; "styleClass": { "alias": "styleClass"; "required": false; }; "required": { "alias": "required"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfLabelComponent, "ef-label", never, { "label": { "alias": "label"; "required": false; }; "labelKey": { "alias": "labelKey"; "required": false; }; "labelParams": { "alias": "labelParams"; "required": false; }; "for": { "alias": "for"; "required": false; }; "styleClass": { "alias": "styleClass"; "required": false; }; "required": { "alias": "required"; "required": false; }; }, {}, never, never, true, never>;
     static ngAcceptInputType_required: unknown;
 }
 
@@ -1656,11 +1739,11 @@ 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>;
+    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.
@@ -1685,7 +1768,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
      */
@@ -1818,7 +1901,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[]>;
@@ -1870,7 +1953,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[]>;
@@ -1902,7 +1985,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;
@@ -1937,7 +2020,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;
@@ -1955,8 +2038,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>;
@@ -1999,7 +2082,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>;
@@ -2022,8 +2105,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;
@@ -2128,8 +2211,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. */
@@ -2149,7 +2239,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. */
@@ -2228,7 +2318,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`. */
@@ -2249,7 +2342,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;
 }
@@ -2479,7 +2572,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. */
@@ -2491,11 +2584,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[]>;
@@ -2508,7 +2606,56 @@ 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>;
+}
+
+/**
+ * Shows a complete HTML document (an email template, rendered with sample
+ * data) inside a frame that cannot act.
+ *
+ * The frame's `sandbox` attribute is written in the template and empty, and
+ * no input reaches it: the document runs no script, has an opaque origin
+ * (no cookies, no storage, no access to the parent), cannot submit a form,
+ * open a popup or navigate the top window. The document comes from
+ * `srcdoc`, so there is no URL to load and no new origin for the CSP; it
+ * inherits the host page's policy, whose `style-src 'unsafe-inline'` lets
+ * the template's own styles apply.
+ *
+ * The frame always has an accessible name (WCAG 4.1.2): `titleKey`, or the
+ * shared `ef_html_preview_title` key when none is given. Consuming apps define it:
+ * fr "Aperçu", ar "معاينة", en "Preview".
+ *
+ * `width: 100%` and `min-width: 0` keep a 600px email table scrolling inside
+ * the frame on a phone instead of widening the page.
+ *
+ * ```html
+ * <ef-html-preview [html]="previewHtml()" titleKey="email_templates_preview_title" [height]="560" />
+ * ```
+ */
+/** The title key the frame falls back to; apps add it to fr.json, ar.json and en.json. */
+declare const EF_HTML_PREVIEW_DEFAULT_TITLE_KEY = "ef_html_preview_title";
+declare class EfHtmlPreviewComponent {
+    /** The full document to show. Sanitized by the server before it gets here. */
+    readonly html: _angular_core.InputSignal<string>;
+    /** i18n key of the frame's accessible title; `ef_html_preview_title` when empty. */
+    readonly titleKey: _angular_core.InputSignal<string>;
+    /** Frame height in pixels. */
+    readonly height: _angular_core.InputSignal<number>;
+    private readonly sanitizer;
+    protected readonly effectiveTitleKey: _angular_core.Signal<string>;
+    /**
+     * Angular's sanitizer strips every `style` attribute and `<style>` block
+     * from a bound `srcdoc`, which would preview an email without its
+     * layout, so the HTML is trusted explicitly. The guarantee is the frame's
+     * empty sandbox: nothing in the document can run, submit, open a window
+     * or reach this page, even for raw author HTML of an unsaved edit. The
+     * server's sanitization of stored templates is a second layer, not the
+     * reason this is safe. Never reuse this bypass for markup rendered
+     * outside such a frame.
+     */
+    protected readonly trustedHtml: _angular_core.Signal<SafeHtml>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<EfHtmlPreviewComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfHtmlPreviewComponent, "ef-html-preview", never, { "html": { "alias": "html"; "required": false; "isSignal": true; }; "titleKey": { "alias": "titleKey"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 /**
@@ -2884,13 +3031,19 @@ interface EfRowAction {
  * ```
  *
  * Phone overflow: on the mobile tier, when the visible actions (custom and
- * standard, Save included) outnumber `[overflowAfter]`, Save stays in view
- * and every other action moves into a kebab menu (`ef-row-actions`, so it is
+ * 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.
@@ -2910,7 +3063,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. */
@@ -2951,10 +3104,21 @@ declare class EfDetailToolbarComponent {
     readonly hasCustomActions: _angular_core.Signal<boolean>;
     /** The phone is showing the overflow menu instead of inline buttons. */
     readonly overflowing: _angular_core.Signal<boolean>;
-    /** Everything but Save, as menu items, in toolbar order. */
+    /** 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
@@ -3016,7 +3180,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). */
@@ -3101,7 +3265,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>;
 }
@@ -3209,6 +3373,19 @@ interface OpMeta {
  * ```html
  * <ef-change-history [entries]="auditEntries()" />
  * ```
+ *
+ * Values are shown raw by default (`Received → Confirmed`). To show a field's
+ * values translated, pass `valueLists`: a map of field path to the
+ * `{ code, label }` items of a reference list. Each old/new value that matches
+ * an item `code` (case-insensitive) is shown as its `label` (translated when
+ * the label is an i18n key); anything unmatched stays raw. The reserved key
+ * `status` maps the `fromStatus` / `toStatus` of status-change entries.
+ * On a V2 detail screen, `AbstractDetailScreenV2.auditValueLists()` builds this
+ * map from `ScreenConfig.AUDIT_VALUE_LISTS`.
+ *
+ * ```html
+ * <ef-change-history [entries]="auditEntries()" [valueLists]="auditValueLists()" />
+ * ```
  */
 declare class EfChangeHistoryComponent {
     private readonly translate;
@@ -3224,6 +3401,14 @@ declare class EfChangeHistoryComponent {
     readonly collapsible: _angular_core.InputSignal<boolean>;
     /** Initial collapsed state — expanded by default. */
     readonly startCollapsed: _angular_core.InputSignal<boolean>;
+    /** Optional field path to reference items, used to show a field's raw
+     *  old/new values as translated labels. Unmapped fields and unmatched
+     *  values stay raw. Key `status` covers `fromStatus` / `toStatus`. */
+    readonly valueLists: _angular_core.InputSignal<Readonly<Record<string, readonly EfChangeHistoryValueItem[]>> | null>;
+    /** Optional formatter for an entry's free-text note. Return the text to show,
+     *  or null to keep the raw note. Rendered as plain text (never HTML). A
+     *  screen uses it to translate coded notes such as `order_email_resent:order_confirmed`. */
+    readonly noteFormatter: _angular_core.InputSignal<((note: string) => string | null) | null>;
     /** "Show more" dialog visibility. */
     readonly dialogVisible: _angular_core.WritableSignal<boolean>;
     /** First `previewLimit` rows shown inline in the card. */
@@ -3245,6 +3430,11 @@ declare class EfChangeHistoryComponent {
      *  (`clientCode` → "Client code"), so new entities/fields work with zero
      *  i18n maintenance. Add a key only for a properly localized (fr/ar) term. */
     fieldLabel(field: string | undefined): string;
+    /** The note as shown: the formatter's text, else the raw note. */
+    noteText(note: string | null | undefined): string;
+    /** Display value for a field's raw value: the matching list item's label
+     *  (translated when it is an i18n key), else the raw value. */
+    valueLabel(field: string | undefined, value: string | null | undefined): string;
     /** Returns the translation when present, otherwise a humanized fallback of
      *  the source token (ngx-translate echoes the key on a miss). */
     private resolveLabel;
@@ -3254,7 +3444,7 @@ declare class EfChangeHistoryComponent {
      *  registration (the app's default locale is fr-MA). */
     formatWhen(value: string | Date | null | undefined): string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<EfChangeHistoryComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfChangeHistoryComponent, "ef-change-history", never, { "entries": { "alias": "entries"; "required": false; "isSignal": true; }; "titleKey": { "alias": "titleKey"; "required": false; "isSignal": true; }; "emptyKey": { "alias": "emptyKey"; "required": false; "isSignal": true; }; "limit": { "alias": "limit"; "required": false; "isSignal": true; }; "previewLimit": { "alias": "previewLimit"; "required": false; "isSignal": true; }; "collapsible": { "alias": "collapsible"; "required": false; "isSignal": true; }; "startCollapsed": { "alias": "startCollapsed"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfChangeHistoryComponent, "ef-change-history", never, { "entries": { "alias": "entries"; "required": false; "isSignal": true; }; "titleKey": { "alias": "titleKey"; "required": false; "isSignal": true; }; "emptyKey": { "alias": "emptyKey"; "required": false; "isSignal": true; }; "limit": { "alias": "limit"; "required": false; "isSignal": true; }; "previewLimit": { "alias": "previewLimit"; "required": false; "isSignal": true; }; "collapsible": { "alias": "collapsible"; "required": false; "isSignal": true; }; "startCollapsed": { "alias": "startCollapsed"; "required": false; "isSignal": true; }; "valueLists": { "alias": "valueLists"; "required": false; "isSignal": true; }; "noteFormatter": { "alias": "noteFormatter"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 /**
@@ -3320,7 +3510,7 @@ 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; }; "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>;
 }
@@ -3400,8 +3590,8 @@ type EfIdentityThumbSize = 'sm' | 'md';
  * ```
  */
 declare class EfIdentityThumbComponent {
-    readonly imageUrl: _angular_core.InputSignal<string>;
-    readonly name: _angular_core.InputSignal<string>;
+    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>;
@@ -3437,18 +3627,18 @@ declare class EfIdentityThumbComponent {
  */
 declare class EfSeoPreviewComponent {
     /** The page title. Named `pageTitle` so it does not become the host's tooltip. */
-    readonly pageTitle: _angular_core.InputSignal<string>;
+    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>;
-    readonly description: _angular_core.InputSignal<string>;
+    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>;
+    readonly titleMaxLength: _angular_core.InputSignal<number | null>;
     /** Characters kept of the description; `null` shows it whole. */
-    readonly descriptionMaxLength: _angular_core.InputSignal<number>;
+    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>;
+    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>;
@@ -3514,8 +3704,12 @@ declare abstract class AbstractEfFormControl {
     /** Translation key for the label — preferred (memory:
      *  feedback_i18n_keys says always use `*Key`). */
     readonly labelKey: _angular_core.InputSignal<string>;
+    /** Interpolation params for `labelKey` (`{{name}}` in the translation). */
+    readonly labelParams: _angular_core.InputSignal<Record<string, unknown> | undefined>;
     readonly placeholder: _angular_core.InputSignal<string>;
     readonly placeholderKey: _angular_core.InputSignal<string>;
+    /** Interpolation params for `placeholderKey` (`{{last4}}` and the like). */
+    readonly placeholderParams: _angular_core.InputSignal<Record<string, unknown> | undefined>;
     /** 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
@@ -3524,6 +3718,8 @@ declare abstract class AbstractEfFormControl {
      *  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>;
+    /** Interpolation params for `hintKey`. */
+    readonly hintParams: _angular_core.InputSignal<Record<string, unknown> | undefined>;
     readonly ariaLabel: _angular_core.InputSignal<string>;
     readonly ariaLabelKey: _angular_core.InputSignal<string>;
     readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -3574,7 +3770,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;
     /**
@@ -3584,7 +3780,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. */
@@ -3598,6 +3794,9 @@ declare abstract class AbstractEfFormControl {
      * accessible name and duplicate `aria-label` would override it.
      */
     get effectiveAriaLabel(): string | null;
+    /** 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`. */
@@ -3614,7 +3813,7 @@ declare abstract class AbstractEfFormControl {
      *  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; }; "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; }; }, {}, 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; }; "labelParams": { "alias": "labelParams"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "placeholderKey": { "alias": "placeholderKey"; "required": false; "isSignal": true; }; "placeholderParams": { "alias": "placeholderParams"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "hintKey": { "alias": "hintKey"; "required": false; "isSignal": true; }; "hintParams": { "alias": "hintParams"; "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 {
@@ -3624,6 +3823,11 @@ declare class EfInputTextComponent extends AbstractEfFormControl implements Cont
     fluid: boolean;
     inline: boolean;
     autocomplete?: string;
+    /** Direction of the typed value, applied to the native input. Use
+     *  `'ltr'` for IBAN / RIB / phone values on an Arabic screen, `'auto'` to
+     *  follow the value's first strong character. The label and messages keep
+     *  the page direction. Null or absent leaves the input unchanged. */
+    dir: 'ltr' | 'rtl' | 'auto' | null;
     /** Clearable (showClear / canClear) is inherited from AbstractEfFormControl;
      *  we only supply the value predicate + the reset. */
     protected get hasValue(): boolean;
@@ -3652,7 +3856,8 @@ declare class EfInputTextComponent extends AbstractEfFormControl implements Cont
     value: string;
     private onChange;
     private onTouched;
-    readonly ngControl: NgControl;
+    readonly ngControl: NgControl | null;
+    private readonly hostRef;
     constructor();
     get showRequired(): boolean;
     get serverErrors(): string[] | null;
@@ -3662,9 +3867,25 @@ declare class EfInputTextComponent extends AbstractEfFormControl implements Cont
     registerOnTouched(fn: () => void): void;
     setDisabledState(isDisabled: boolean): void;
     handleInput(value: string): void;
+    /** Set once the field itself has had focus; see {@link insertAtSelection}. */
+    private wasFocused;
+    protected markFocused(event: FocusEvent): void;
+    /**
+     * Inserts `text` at the caret (replacing a selection), or at the end when
+     * the field was never focused, then puts the caret after it. Emits the
+     * change once, exactly as typing would. Does nothing when read-only or
+     * disabled, and refuses the whole insert when the result would pass
+     * `maxlength` (a cut placeholder token is worse than none).
+     *
+     * The value is written programmatically, so the browser's undo history for
+     * the field is reset and no DOM `input` event fires; the form control
+     * (`onChange`) and `valueChangeEvent` are the contract.
+     */
+    insertAtCursor(text: string): void;
+    private nativeField;
     handleBlur(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<EfInputTextComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfInputTextComponent, "ef-input-text", never, { "size": { "alias": "size"; "required": false; }; "type": { "alias": "type"; "required": false; }; "maxlength": { "alias": "maxlength"; "required": false; }; "fluid": { "alias": "fluid"; "required": false; }; "inline": { "alias": "inline"; "required": false; }; "autocomplete": { "alias": "autocomplete"; "required": false; }; "variant": { "alias": "variant"; "required": false; }; "prefix": { "alias": "prefix"; "required": false; }; "suffix": { "alias": "suffix"; "required": false; }; "value": { "alias": "value"; "required": false; }; }, { "valueChangeEvent": "valueChangeEvent"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfInputTextComponent, "ef-input-text", never, { "size": { "alias": "size"; "required": false; }; "type": { "alias": "type"; "required": false; }; "maxlength": { "alias": "maxlength"; "required": false; }; "fluid": { "alias": "fluid"; "required": false; }; "inline": { "alias": "inline"; "required": false; }; "autocomplete": { "alias": "autocomplete"; "required": false; }; "dir": { "alias": "dir"; "required": false; }; "variant": { "alias": "variant"; "required": false; }; "prefix": { "alias": "prefix"; "required": false; }; "suffix": { "alias": "suffix"; "required": false; }; "value": { "alias": "value"; "required": false; }; }, { "valueChangeEvent": "valueChangeEvent"; }, never, never, true, never>;
     static ngAcceptInputType_fluid: unknown;
     static ngAcceptInputType_inline: unknown;
 }
@@ -3937,7 +4158,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;
@@ -3991,7 +4212,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;
@@ -4053,7 +4274,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;
@@ -4194,7 +4415,7 @@ declare class EfInputNumberComponent extends AbstractEfFormControl implements Co
     get displayText(): string | number;
     private onChange;
     private onTouched;
-    readonly ngControl: NgControl;
+    readonly ngControl: NgControl | null;
     private readonly localeId;
     private readonly cdr;
     constructor();
@@ -4252,6 +4473,15 @@ declare class EfPasswordComponent extends AbstractEfFormControl implements Contr
     toggleMask: boolean;
     feedback: boolean;
     autocomplete?: string;
+    /**
+     * Rendering variant, as `ef-input-text`. `'comptoir'` skins the PrimeNG
+     * input to the native `.ef-input` look (--hit-field height, --r-md radius,
+     * 12px padding, --paper-alt fill) so it lines up with the comptoir inputs
+     * beside it; the show/hide toggle becomes a --hit-field square target.
+     * `'primeng'` (default) keeps the stock PrimeNG look.
+     */
+    variant: 'primeng' | 'comptoir';
+    get fieldStyleClass(): string;
     /**
      * Take focus on load. Bound explicitly rather than left unset: PrimeNG's
      * AutoFocus directive tests `autofocus === false`, and the control declares
@@ -4266,7 +4496,8 @@ declare class EfPasswordComponent extends AbstractEfFormControl implements Contr
     value: string;
     private onChange;
     private onTouched;
-    readonly ngControl: NgControl;
+    readonly ngControl: NgControl | null;
+    private readonly host;
     constructor();
     get showRequired(): boolean;
     get serverErrors(): string[] | null;
@@ -4281,7 +4512,7 @@ declare class EfPasswordComponent extends AbstractEfFormControl implements Contr
     handleChange(value: string): void;
     handleBlur(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<EfPasswordComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfPasswordComponent, "ef-password", never, { "size": { "alias": "size"; "required": false; }; "fluid": { "alias": "fluid"; "required": false; }; "inline": { "alias": "inline"; "required": false; }; "toggleMask": { "alias": "toggleMask"; "required": false; }; "feedback": { "alias": "feedback"; "required": false; }; "autocomplete": { "alias": "autocomplete"; "required": false; }; "autofocus": { "alias": "autofocus"; "required": false; }; }, { "valueChangeEvent": "valueChangeEvent"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfPasswordComponent, "ef-password", never, { "size": { "alias": "size"; "required": false; }; "fluid": { "alias": "fluid"; "required": false; }; "inline": { "alias": "inline"; "required": false; }; "toggleMask": { "alias": "toggleMask"; "required": false; }; "feedback": { "alias": "feedback"; "required": false; }; "autocomplete": { "alias": "autocomplete"; "required": false; }; "variant": { "alias": "variant"; "required": false; }; "autofocus": { "alias": "autofocus"; "required": false; }; }, { "valueChangeEvent": "valueChangeEvent"; }, never, never, true, never>;
     static ngAcceptInputType_fluid: unknown;
     static ngAcceptInputType_inline: unknown;
     static ngAcceptInputType_toggleMask: unknown;
@@ -4306,7 +4537,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;
@@ -4335,7 +4566,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;
@@ -4401,7 +4632,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
      */
@@ -4634,23 +4865,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)
      */
@@ -4711,7 +4942,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
@@ -4881,7 +5112,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;
@@ -4916,8 +5147,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
@@ -4951,7 +5182,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
@@ -5020,18 +5251,18 @@ declare class EfDataCardComponent<TRow = any> implements AfterContentInit {
      * not have, and `aria-selected` is not allowed on a button. Unset, no
      * attribute is written.
      */
-    readonly rowPressed: _angular_core.InputSignal<(row: TRow) => boolean>;
+    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>;
+    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>;
@@ -5049,7 +5280,7 @@ declare class EfDataCardComponent<TRow = any> implements AfterContentInit {
      * 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>;
+    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. */
@@ -5073,7 +5304,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
@@ -5139,6 +5370,14 @@ declare class EfDataCardComponent<TRow = any> implements AfterContentInit {
     headerTemplate(columnId: string): TemplateRef<unknown> | undefined;
     /** Pluck `column.field` (or `column.id`) from a row, dotted-path safe. */
     cellValue(row: TRow, col: EfDataCardColumn): unknown;
+    /**
+     * Whether a cell has anything to show. The mobile secondary line joins its
+     * parts with a "·" drawn before every part but the first, so an empty part
+     * left a dangling separator; skipping it keeps separators between present
+     * values only. A column with a custom body template is always present (the
+     * template decides what to render); a boolean always renders a glyph.
+     */
+    hasCellContent(row: TRow, col: EfDataCardColumn): boolean;
     headerAlignClass(col: EfDataCardColumn): string;
     cellAlignClass(col: EfDataCardColumn): string;
     /** Sort indicator: '↑' / '↓' / '' for the given column. */
@@ -5154,7 +5393,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.
      *
@@ -5178,8 +5417,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;
@@ -5474,7 +5713,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. */
@@ -5541,7 +5780,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
@@ -5763,7 +6002,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,
@@ -5828,7 +6067,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. */
@@ -5899,7 +6138,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>;
@@ -6023,7 +6262,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. */
@@ -6082,7 +6321,8 @@ declare class EfTextareaComponent extends AbstractEfFormControl implements Contr
     clearValue(): void;
     private onChange;
     private onTouched;
-    readonly ngControl: NgControl;
+    readonly ngControl: NgControl | null;
+    private readonly hostRef;
     constructor();
     get isInvalid(): boolean;
     get serverErrors(): string[] | null;
@@ -6092,6 +6332,22 @@ declare class EfTextareaComponent extends AbstractEfFormControl implements Contr
     registerOnTouched(fn: () => void): void;
     setDisabledState(isDisabled: boolean): void;
     handleInput(value: string): void;
+    /** Set once the field itself has had focus; see {@link insertAtSelection}. */
+    private wasFocused;
+    protected markFocused(event: FocusEvent): void;
+    /**
+     * Inserts `text` at the caret (replacing a selection), or at the end when
+     * the field was never focused, then puts the caret after it. Emits the
+     * change once, exactly as typing would. Does nothing when read-only or
+     * disabled, and refuses the whole insert when the result would pass
+     * `maxlength` (a cut placeholder token is worse than none).
+     *
+     * The value is written programmatically, so the browser's undo history for
+     * the field is reset and no DOM `input` event fires; the form control
+     * (`onChange`) and `valueChangeEvent` are the contract.
+     */
+    insertAtCursor(text: string): void;
+    private nativeField;
     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; }; "mono": { "alias": "mono"; "required": false; }; "value": { "alias": "value"; "required": false; }; }, { "valueChangeEvent": "valueChangeEvent"; }, never, never, true, never>;
@@ -6099,6 +6355,65 @@ declare class EfTextareaComponent extends AbstractEfFormControl implements Contr
     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;
@@ -6129,13 +6444,13 @@ interface EfFileRejection {
  */
 declare class EfFileUploadComponent {
     /** Visible label (translation key). Omit for an icon-only button and set `ariaLabelKey`. */
-    readonly labelKey: _angular_core.InputSignal<string>;
-    readonly ariaLabelKey: _angular_core.InputSignal<string>;
-    readonly icon: _angular_core.InputSignal<string>;
+    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>;
-    readonly maxSizeBytes: _angular_core.InputSignal<number>;
+    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`. */
@@ -6145,7 +6460,7 @@ declare class EfFileUploadComponent {
     readonly fileRejected: _angular_core.OutputEmitterRef<EfFileRejection>;
     private readonly picker;
     private readonly reason;
-    protected readonly errorKey: _angular_core.Signal<string>;
+    protected readonly errorKey: _angular_core.Signal<string | null>;
     protected open(): void;
     protected onChange(event: Event): void;
     private check;
@@ -6188,9 +6503,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). */
@@ -6269,6 +6584,11 @@ declare class EfDatepickerAdvancedComponent extends AbstractEfFormControl implem
     private readonly vcr;
     private readonly destroyRef;
     private readonly cdr;
+    private readonly viewport;
+    /** The one picker whose panel is open on the page, if any. A click on
+     *  another picker's trigger never reaches the document (the trigger
+     *  stops it), so opening a picker closes this one explicitly. */
+    private static openPicker;
     /**
      * Self-injected form control (present only when the consumer binds
      * `[(ngModel)]` / `formControlName` in field mode). We register as its
@@ -6276,7 +6596,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;
@@ -6285,7 +6605,19 @@ declare class EfDatepickerAdvancedComponent extends AbstractEfFormControl implem
     /** Active embedded view + its root node, while the panel is open. */
     private panelView;
     private panelRoot;
-    private resizeHandler;
+    /** Every root node the panel template rendered (the sheet backdrop too). */
+    private portalNodes;
+    private repositionListener;
+    private resizeObserver;
+    private repositionFrame;
+    /** Phone width (EfViewportService, <= 767px): the panel opens as a
+     *  full-width bottom sheet with 48px targets instead of a popover. */
+    readonly sheet: _angular_core.Signal<boolean>;
+    /** The dialog's accessible name: the field's own label in field mode
+     *  (the panel no longer repeats it as a visible title), else the
+     *  trigger label. */
+    readonly panelLabelKey: _angular_core.Signal<string>;
+    readonly panelLabel: _angular_core.Signal<string>;
     constructor();
     ngAfterViewInit(): void;
     /** Trigger left-side label (translation key). Default: `'filter_date'`. */
@@ -6298,13 +6630,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>;
     /**
@@ -6361,8 +6693,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. */
@@ -6403,11 +6735,24 @@ declare class EfDatepickerAdvancedComponent extends AbstractEfFormControl implem
     /** Du / Au inputs as DD/MM/YYYY strings (kept in sync with drafts). */
     readonly fromText: _angular_core.Signal<string>;
     readonly toText: _angular_core.Signal<string>;
+    /** Bumps whenever the language or its translations change, so the
+     *  placeholder below re-reads the dictionary. */
+    private readonly i18nTick;
+    /**
+     * Placeholder of the typed-date inputs. The parser takes ASCII digits
+     * only, day first (`\d` and the keydown filter are [0-9/]), so the hint
+     * spells that order in the reader's terms, in Latin letters: `JJ/MM/AAAA`
+     * for French, `DD/MM/YYYY` otherwise, Arabic included. An Arabic-word
+     * pattern (يوم/شهر/سنة) would lay out right to left, the reverse of the
+     * digits the user then types. An app can override it per language with
+     * the `date_input_placeholder` key.
+     */
+    readonly datePlaceholder: _angular_core.Signal<string>;
     /** 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). */
@@ -6464,8 +6809,19 @@ declare class EfDatepickerAdvancedComponent extends AbstractEfFormControl implem
     /** Commit a typed `HH:mm` value to the start or end draft time. */
     commitTimeInput(which: 'start' | 'end', el: HTMLInputElement): void;
     toggle(event: MouseEvent): void;
-    close(): void;
+    /**
+     * Close the panel. `returnFocus` puts focus back on the trigger; Escape
+     * and a commit pass it, so a keyboard user is not dropped on <body>
+     * when the panel's DOM goes. An outside click or another picker opening
+     * does not, since the user has just put focus somewhere else.
+     */
+    close(returnFocus?: boolean): void;
+    /** The trigger sits behind an `@if` (field box or pill), so find it now. */
+    private focusTrigger;
     onDocumentClick(event: MouseEvent): void;
+    /** The phone sheet is aria-modal, so Tab wraps inside it instead of
+     *  reaching the page behind the backdrop. */
+    onTab(event: KeyboardEvent): void;
     onEscape(): void;
     selectPreset(preset: EfDatePreset): void;
     isActivePreset(key: EfDatePresetKey): boolean;
@@ -6489,12 +6845,22 @@ declare class EfDatepickerAdvancedComponent extends AbstractEfFormControl implem
     commitDateInput(which: 'start' | 'end', el: HTMLInputElement): void;
     private attachPortal;
     private detachPortal;
-    /** Anchor the panel's top-left to the trigger's bottom-left, using
-     *  page coords so the panel scrolls with the trigger naturally.
-     *  Flips to right-aligned (and clamps to the viewport) when the
-     *  default left-anchor would overflow the right edge — otherwise the
-     *  panel is clipped for triggers that sit near the right of the page. */
+    /** The sheet is modal and sits at the end of <body>, far from the
+     *  trigger in tab order, so focus moves into it: the picked day, else
+     *  today, else the first day of the month. A day, not the date input,
+     *  which would raise the on-screen keyboard over the calendar. */
+    private focusIntoSheet;
+    private schedulePosition;
+    /** Place the popover against the trigger (see `placeDpPanel`). Sizes
+     *  come from offsetWidth / scrollHeight, not getBoundingClientRect:
+     *  the entry animation scales the panel, and scrollHeight still tells
+     *  the natural height once a previous placement capped it. */
     private positionPanel;
+    /** The trigger button's box, not the wrapper's: the wrapper also holds
+     *  the label above and the error text below. */
+    private triggerRect;
+    /** The nearest `dir` wins (the app sets it on <html>); computed style covers a page without one. */
+    private isRtl;
     /** Click handling: 1st click sets start, 2nd click sets end (or swap).
      *  Field single-date mode short-circuits — one click commits & closes. */
     selectDay(day: Date): void;
@@ -6599,13 +6965,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>;
 }
@@ -6637,7 +7007,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;
@@ -6661,9 +7031,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>;
@@ -6704,7 +7074,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>;
@@ -6733,5 +7103,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, 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, EfSeoPreviewComponent, 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, EfDataCardRowActionState, EfDatatableActions, EfDatatableColumn, EfDatatableColumnAlign, EfDatatableColumnType, EfDatatableConfig, EfDateFieldOutput, EfDateFieldValue, EfDatePreset, EfDialogAction, EfDialogSeverity, EfDialogSize, EfFabPosition, EfFileRejectReason, EfFileRejection, EfIdentityThumbSize, EfKpiDeltaTone, EfKpiSparkline, EfPillItem, EfPresetItem, EfProductPickerItem, EfProductPickerQuery, 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_HTML_PREVIEW_DEFAULT_TITLE_KEY, 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, EfHtmlPreviewComponent, 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, EfChangeHistoryValueItem, 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 };