@elasticias/ui 1.0.50 → 1.0.52

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';
@@ -385,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 {
@@ -475,6 +482,11 @@ declare class EfOrderBuilderComponent implements OnInit {
      * 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>;
@@ -591,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; }; "recipient": { "alias": "recipient"; "required": false; "isSignal": true; }; "defaultCallingCode": { "alias": "defaultCallingCode"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "countGroupLabels": { "alias": "countGroupLabels"; "required": false; "isSignal": true; }; "productKeyField": { "alias": "productKeyField"; "required": false; "isSignal": true; }; "priceList": { "alias": "priceList"; "required": false; "isSignal": true; }; "backendErrors": { "alias": "backendErrors"; "required": false; "isSignal": true; }; "shippingTotal": { "alias": "shippingTotal"; "required": false; "isSignal": true; }; "auditEntries": { "alias": "auditEntries"; "required": false; "isSignal": true; }; "focusMode": { "alias": "focusMode"; "required": false; "isSignal": true; }; }, { "order": "orderChange"; "openCatalogue": "openCatalogue"; "orderChanged": "orderChanged"; "orderValidated": "orderValidated"; "productsAdded": "productsAdded"; "focusMode": "focusModeChange"; }, never, ["[obRail]"], true, never>;
+    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>;
 }
 
 /**
@@ -1606,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
@@ -1619,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;
 }
 
@@ -2595,6 +2609,55 @@ declare class EfPdfPreviewComponent {
     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>;
+}
+
 /**
  * Comptoir status spectrum — the canonical set of chip tones every
  * status reference can map to via `metadata.color`.
@@ -3310,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;
@@ -3325,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. */
@@ -3346,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;
@@ -3355,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>;
 }
 
 /**
@@ -3615,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
@@ -3625,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>;
@@ -3718,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; }; "describedByExtra": { "alias": "describedByExtra"; "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 {
@@ -3728,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;
@@ -3757,6 +3857,7 @@ declare class EfInputTextComponent extends AbstractEfFormControl implements Cont
     private onChange;
     private onTouched;
     readonly ngControl: NgControl | null;
+    private readonly hostRef;
     constructor();
     get showRequired(): boolean;
     get serverErrors(): string[] | null;
@@ -3766,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;
 }
@@ -4356,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
@@ -4371,6 +4497,7 @@ declare class EfPasswordComponent extends AbstractEfFormControl implements Contr
     private onChange;
     private onTouched;
     readonly ngControl: NgControl | null;
+    private readonly host;
     constructor();
     get showRequired(): boolean;
     get serverErrors(): string[] | null;
@@ -4385,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;
@@ -5243,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. */
@@ -6187,6 +6322,7 @@ declare class EfTextareaComponent extends AbstractEfFormControl implements Contr
     private onChange;
     private onTouched;
     readonly ngControl: NgControl | null;
+    private readonly hostRef;
     constructor();
     get isInvalid(): boolean;
     get serverErrors(): string[] | null;
@@ -6196,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>;
@@ -6432,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
@@ -6448,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'`. */
@@ -6566,6 +6735,19 @@ 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`. */
@@ -6627,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;
@@ -6652,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;
@@ -6900,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_SEO_DEFAULT_LOCALES, EF_STATUS_COLORS, EF_STATUS_COLOR_ALIASES, EfAboutDialogComponent, EfActivationFilterComponent, EfAppMainComponent, EfAppShellComponent, EfAppShellMobileComponent, EfAppTopComponent, EfBadgeComponent, EfBlockUiComponent, EfBlockableDivComponent, EfBottomSheetComponent, EfBuildStampComponent, EfBulkBarComponent, EfButtonComponent, EfButtonGroupComponent, EfCardComponent, EfChangeHistoryComponent, EfChangePasswordComponent, EfChartComponent, EfCheckboxComponent, EfClearButtonComponent, EfColumnHeaderTemplateDirective, EfColumnTemplateDirective, EfCompactPipe, EfConfirmDialogComponent, EfCurrencyPipe, EfDataCardComponent, EfDatatableActionBarComponent, EfDatatableComponent, EfDatepickerAdvancedComponent, EfDatepickerComponent, EfDetailToolbarComponent, EfDialogComponent, EfEmailMetricsCardComponent, EfEmptyStateComponent, EfFabComponent, EfFieldsetComponent, EfFileUploadComponent, EfFilterDrawerComponent, EfFilterPillComponent, EfFormGridComponent, EfIdentityThumbComponent, EfInputNumberComponent, EfInputTextComponent, EfKpiCardComponent, EfLabelComponent, EfModuleRailComponent, EfModuleSideComponent, EfMultiSelectComponent, EfOrderBuilderComponent, EfOrderSummaryComponent, EfOverflowTooltipDirective, EfPagerComponent, EfPasswordComponent, EfPdfPreviewComponent, EfPillGroupComponent, EfPresetPillComponent, EfPriceDisplayComponent, EfProductCatalogueComponent, EfProductCatalogueFilterComponent, EfProductPickerComponent, EfProductTypeaheadComponent, EfProfileChipComponent, EfProfileMenuComponent, EfPulseComponent, EfQuantitySelectorComponent, EfQuantityStepperComponent, EfRadioComponent, EfRankListComponent, EfReadOnlyDirective, EfRowActionsComponent, EfSearchToolbarComponent, EfSelectButtonComponent, EfSelectComponent, EfSeoFieldsComponent, EfSeoPreviewComponent, EfServerErrorsDirective, EfSessionIdleDialogComponent, EfShortcutsDialogComponent, EfSkeletonComponent, EfSmartBarComponent, EfStatsComponent, EfStatusChipComponent, EfTabPanelDirective, EfTabsComponent, EfTextareaComponent, EfThemeConfiguratorComponent, EfThemeToggleComponent, EfTimelineComponent, EfToastRegionComponent, EfToggleSwitchComponent, EfToolbarComponent, EfTooltipDirective, EfTotalsComponent, OrderEntityHelper, OrderLineItemHelper, TruncatePipe, buildChartConfig, defaultUnitPrice, getColumnAlignment, mergeColumnDefaults, resolveEfStatusColor };
-export type { CatalogueProduct, CatalogueProductVariant, CategoryAssignment, CategoryGroup, CategoryItem, DatatableSearchEntity, DocumentConfig, EfAboutServer, EfBadgeColor, EfBadgeConfig, EfBadgeSize, EfBadgeVariant, EfButtonComptoirSeverity, EfButtonPrimeNGSeverity, EfButtonSeverity, EfChangeHistoryEntry, EfChangeHistoryFieldChange, EfChangePasswordSubmit, EfChartSeries, EfChartType, EfDataCardMobileLayout, EfDataCardRowAction, EfDataCardRowActionState, EfDatatableActions, EfDatatableColumn, EfDatatableColumnAlign, EfDatatableColumnType, EfDatatableConfig, EfDateFieldOutput, EfDateFieldValue, EfDatePreset, EfDialogAction, EfDialogSeverity, EfDialogSize, EfFabPosition, EfFileRejectReason, EfFileRejection, EfIdentityThumbSize, EfKpiDeltaTone, EfKpiSparkline, EfOrderPriceList, EfOrderRecipient, EfPillItem, EfPresetItem, EfProductPickerItem, EfProductPickerQuery, EfProfileMenuItem, EfRankRow, EfRowAction, EfSeoLocale, EfSeoPatch, EfSkeletonVariant, EfStatsRow, EfStatusColor, EfStatusReferenceItem, EfTabItem, EfTabsModule, EfTabsVariant, EfTimelineItem, EfTimelineState, EfToastRegionPosition, EfTotalsGrand, EfTotalsRow, HighlightSegment, OrderChangeInfo, OrderEntity, OrderLineItem, OrderProductsSummary, OrderSummaryItem, ProductCountGroup, ProductCountGroupLabel, ProductTypeaheadRow, ProductTypeaheadSelection, ProductWithCountGroup, SelectedFilter, ValidationResult };
+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 };