@forgeroute/ui 0.4.58 → 0.4.60

package/types/forgeroute-ui.d.ts

@@ -1095,7 +1095,7 @@ export declare class SelectComponent implements ControlValueAccessor, Validator,
   readonly error: import("@angular/core").InputSignal<string>;
   /** Reveal the built-in error messages now (e.g. after a failed Save click), without waiting for blur. */
   readonly showErrors: import("@angular/core").InputSignal<boolean>;
-  readonly size: import("@angular/core").InputSignal<"sm" | "default">;
+  readonly size: import("@angular/core").InputSignal<"default" | "sm">;
   readonly _disabledInput: import("@angular/core").InputSignal<boolean>;
   private readonly _cvaDisabled;
   protected readonly disabled: import("@angular/core").Signal<boolean>;
@@ -2152,7 +2152,7 @@ export declare class SidePanelComponent implements OnDestroy {
   readonly cancelLabel: import("@angular/core").InputSignal<string>;
   /** Right-aligned primary action button label. Empty string = hidden. */
   readonly primaryLabel: import("@angular/core").InputSignal<string>;
-  readonly primaryVariant: import("@angular/core").InputSignal<"danger" | "warning" | "primary">;
+  readonly primaryVariant: import("@angular/core").InputSignal<"primary" | "danger" | "warning">;
   readonly primaryLoading: import("@angular/core").InputSignal<boolean>;
   readonly primaryDisabled: import("@angular/core").InputSignal<boolean>;
   /** `data-testid` of the Cancel button; none when empty (default). */
@@ -2260,7 +2260,7 @@ export declare class ModalComponent implements OnInit, OnDestroy {
   readonly title: import("@angular/core").InputSignal<string>;
   readonly description: import("@angular/core").InputSignal<string>;
   readonly maxWidth: import("@angular/core").InputSignal<string>;
-  readonly bodyOverflow: import("@angular/core").InputSignal<"auto" | "hidden" | "visible">;
+  readonly bodyOverflow: import("@angular/core").InputSignal<"hidden" | "visible" | "auto">;
   /** `data-testid` of the dialog element itself (the host `<ui-modal>` is always in the page, the dialog only while open). None when empty. */
   readonly dialogTestId: import("@angular/core").InputSignal<string>;
   /** Hides the header X button (e.g. while a request is running). Escape and a backdrop click still close unless `closable` is false. */
@@ -2682,7 +2682,7 @@ export declare class AudioPlayerComponent {
   /** Accessible name of the player. */
   readonly ariaLabel: import("@angular/core").InputSignal<string>;
   /** How much to load before play: 'metadata' (default), 'auto' or 'none'. */
-  readonly preload: import("@angular/core").InputSignal<"none" | "auto" | "metadata">;
+  readonly preload: import("@angular/core").InputSignal<"metadata" | "none" | "auto">;
   /** Fires when the browser can't load or decode the source. */
   readonly playbackError: import("@angular/core").OutputEmitterRef<void>;
   protected readonly failed: import("@angular/core").WritableSignal<boolean>;
@@ -2936,7 +2936,7 @@ export declare class CheckboxComponent implements ControlValueAccessor, Validato
    * clicking it still toggles the box - e.g. a product name that is both the heading of its card and the label of its checkbox.
    * Default null: plain label text, exactly as before. Single mode only.
    */
-  readonly headingLevel: import("@angular/core").InputSignal<1 | 2 | 3 | 4 | 5 | 6 | null>;
+  readonly headingLevel: import("@angular/core").InputSignal<2 | 1 | 6 | 3 | 4 | 5 | null>;
   readonly indeterminate: import("@angular/core").InputSignal<boolean>;
   readonly checked: import("@angular/core").ModelSignal<boolean>;
   /**
@@ -3847,7 +3847,7 @@ export declare class PhoneNumberPickerComponent {
   protected readonly modeCtl: FormControl<string>;
   protected readonly zipCtl: FormControl<string>;
   protected readonly areaCtl: FormControl<string>;
-  protected readonly step: import("@angular/core").WritableSignal<1 | 2 | 3>;
+  protected readonly step: import("@angular/core").WritableSignal<2 | 1 | 3>;
   protected readonly mode: import("@angular/core").WritableSignal<PhoneNumberSearchMode>;
   private readonly _zip;
   private readonly _area;
@@ -3963,7 +3963,7 @@ export declare class ButtonComponent {
    * `ghost-start`: a ghost button for list / section toggles - a full-width row with its content aligned to the start, transparent
    * background, hover tint and the normal focus ring. Pair it with `ariaExpanded` / `ariaPressed`; the label may contain a heading element.
    */
-  readonly variant: import("@angular/core").InputSignal<"link" | "danger" | "warning" | "primary" | "secondary" | "ghost" | "ghost-start" | "tab" | "icon" | "icon-danger">;
+  readonly variant: import("@angular/core").InputSignal<"link" | "primary" | "secondary" | "danger" | "warning" | "ghost" | "ghost-start" | "tab" | "icon" | "icon-danger">;
   /** Renders an anchor to this route instead of a button (use with `variant="link"` for an inline text link). `['/settings']` or `'/settings'`. While `disabled` or `loading` it renders a non-clickable `<span role="link" aria-disabled>` with no href (like `href`). */
   readonly routerLink: import("@angular/core").InputSignal<string | readonly unknown[] | null>;
   /** Query params of the `routerLink` (e.g. `{ section: 'deal-defaults' }`). */
@@ -4008,8 +4008,8 @@ export declare class ButtonComponent {
   private readonly _narrow;
   readonly color: import("@angular/core").InputSignal<string | undefined>;
   readonly active: import("@angular/core").InputSignal<boolean>;
-  readonly size: import("@angular/core").InputSignal<"xs" | "sm" | "md" | "lg">;
-  readonly type: import("@angular/core").InputSignal<"button" | "reset" | "submit">;
+  readonly size: import("@angular/core").InputSignal<"sm" | "md" | "lg" | "xs">;
+  readonly type: import("@angular/core").InputSignal<"reset" | "submit" | "button">;
   readonly disabled: import("@angular/core").InputSignal<boolean>;
   readonly loading: import("@angular/core").InputSignal<boolean>;
   readonly fullWidth: import("@angular/core").InputSignal<boolean>;
@@ -4948,7 +4948,7 @@ export declare class TextInputComponent implements ControlValueAccessor, Validat
   readonly passwordRequirements: import("@angular/core").InputSignal<boolean>;
   /** Rules for `passwordRequirements`; default = the library's five rules (8+ characters, upper, lower, digit, special). */
   readonly passwordRules: import("@angular/core").InputSignal<readonly PasswordRule[] | undefined>;
-  readonly type: import("@angular/core").InputSignal<"number" | "text" | "email" | "tel" | "password" | "url">;
+  readonly type: import("@angular/core").InputSignal<"number" | "tel" | "text" | "email" | "password" | "url">;
   readonly maxlength: import("@angular/core").InputSignal<number | undefined>;
   readonly required: import("@angular/core").InputSignal<boolean>;
   readonly autocomplete: import("@angular/core").InputSignal<string>;
@@ -4957,7 +4957,7 @@ export declare class TextInputComponent implements ControlValueAccessor, Validat
    * `search`, `text`, `none`). Empty (default) = the browser's default for the field, except `type="tel"`, which keeps `tel`.
    * It only picks the keyboard; it does not restrict what can be typed or pasted.
    */
-  readonly inputmode: import("@angular/core").InputSignal<"" | "none" | "search" | "text" | "email" | "tel" | "url" | "decimal" | "numeric">;
+  readonly inputmode: import("@angular/core").InputSignal<"" | "tel" | "search" | "text" | "none" | "email" | "url" | "decimal" | "numeric">;
   readonly readonly: import("@angular/core").InputSignal<boolean>;
   readonly hint: import("@angular/core").InputSignal<string>;
   /** Id(s) of an external element that also describes this control (e.g. one shared error text for a group of fields). Space separated; MERGED after the control's own hint / error id in `aria-describedby`, never replacing it. Empty = unchanged. */
@@ -5023,7 +5023,7 @@ export declare class TextInputComponent implements ControlValueAccessor, Validat
   protected readonly _stepAttr: import("@angular/core").Signal<string | null>;
   protected readonly _revealable: import("@angular/core").Signal<boolean>;
   protected readonly _shown: import("@angular/core").WritableSignal<boolean>;
-  protected readonly _inputType: import("@angular/core").Signal<"number" | "text" | "email" | "tel" | "password" | "url">;
+  protected readonly _inputType: import("@angular/core").Signal<"number" | "tel" | "text" | "email" | "password" | "url">;
   protected readonly _eyePath: string;
   protected readonly _eyeOffPath: string;
   protected readonly _showRequirements: import("@angular/core").Signal<boolean>;
@@ -6728,7 +6728,7 @@ export declare class FormSectionComponent {
   }, {}, never, ["*"], true, never>;
 }
 export declare class FormRowComponent {
-  readonly cols: import("@angular/core").InputSignal<1 | 2 | 3 | 4>;
+  readonly cols: import("@angular/core").InputSignal<2 | 1 | 3 | 4>;
   static ɵfac: i0.ɵɵFactoryDeclaration<FormRowComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<FormRowComponent, "ui-form-row", never, {
     "cols": {
@@ -6745,7 +6745,7 @@ export declare class FormRowComponent {
  * child simply takes the full width. Keep a numeric span within the row's `cols` (use `all` for the whole row).
  */
 export declare class FormColSpanDirective {
-  readonly uiColSpan: import("@angular/core").InputSignal<"" | "all" | "2" | 2 | "3" | 3>;
+  readonly uiColSpan: import("@angular/core").InputSignal<"" | 2 | "2" | "3" | 3 | "all">;
   protected readonly _class: import("@angular/core").Signal<string>;
   static ɵfac: i0.ɵɵFactoryDeclaration<FormColSpanDirective, never>;
   static ɵdir: i0.ɵɵDirectiveDeclaration<FormColSpanDirective, "[uiColSpan]", never, {
@@ -7364,8 +7364,10 @@ export declare class ListComponent<T = unknown> {
   /** Announcement after a move; receives the row label, the new position (1-based) and the list size. */
   readonly moveAnnouncement: import("@angular/core").InputSignal<(label: string, position: number, total: number) => string>;
   /** Fires with the new array when the user moves a row (`[(items)]`). The list does not change `items` itself. */
-  /** Shows an arrow at the end of every row and makes the row open something: a click or Enter on the row (not on a button or link inside it) emits `itemClick`. Default false: no arrow, rows are not clickable. */
+  /** Makes the row open something: a click or Enter on the row (not on a button or link inside it) emits `itemClick`; the arrow only shows with `[arrow]="true"`. Default false: rows are not clickable. */
   readonly navigable: import("@angular/core").InputSignal<boolean>;
+  /** The arrow at the end of each row, drawn only with `[navigable]`. Default false (hidden): not every clickable list wants one. `[navigable]` alone keeps the click / Enter / focus behaviour; add `[arrow]="true"` to show it. */
+  readonly arrow: import("@angular/core").InputSignal<boolean>;
   /** The row of `[navigable]` that was clicked (or Enter was pressed on). */
   readonly itemClick: import("@angular/core").OutputEmitterRef<T>;
   readonly itemsChange: import("@angular/core").OutputEmitterRef<T[]>;
@@ -7502,6 +7504,11 @@ export declare class ListComponent<T = unknown> {
       "required": false;
       "isSignal": true;
     };
+    "arrow": {
+      "alias": "arrow";
+      "required": false;
+      "isSignal": true;
+    };
   }, {
     "itemClick": "itemClick";
     "itemsChange": "itemsChange";
@@ -7693,13 +7700,15 @@ export interface PanelInfoSection {
    * A small secondary button at the end of the section's header bar (e.g. "Add item" for a list of line items). `action` runs on
    * click; `ariaLabel` is the accessible name when the visible label is not enough (default: the label). The header bar is shown
    * for a section with a `headerAction` even when it has no `title`. Not rendered for a section with no visible items unless
-   * `showEmptyState` keeps the section.
+   * `showEmptyState` keeps the section. `icon` is an optional SVG path (the `d` value, 24x24 grid, same convention as a toolbar action's
+   * `icon`) drawn before the label; it is decorative, so the accessible name stays the label / `ariaLabel`.
    */
   headerAction?: {
     label: string;
     action: () => void;
     ariaLabel?: string;
     disabled?: boolean;
+    icon?: string;
   };
   items: PanelInfoItem[];
   columns?: 2;
@@ -7862,9 +7871,9 @@ export declare class ChipGroupComponent {
   readonly spaceAbove: import("@angular/core").InputSignal<"none" | "sm" | "md">;
   /** Space below the chip group. */
   readonly spaceBelow: import("@angular/core").InputSignal<"none" | "sm" | "md">;
-  protected readonly _gap: import("@angular/core").Signal<"12px" | "6px" | "8px">;
-  protected readonly _spaceAbove: import("@angular/core").Signal<"12px" | "0" | "6px">;
-  protected readonly _spaceBelow: import("@angular/core").Signal<"12px" | "0" | "6px">;
+  protected readonly _gap: import("@angular/core").Signal<"6px" | "12px" | "8px">;
+  protected readonly _spaceAbove: import("@angular/core").Signal<"0" | "6px" | "12px">;
+  protected readonly _spaceBelow: import("@angular/core").Signal<"0" | "6px" | "12px">;
   static ɵfac: i0.ɵɵFactoryDeclaration<ChipGroupComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<ChipGroupComponent, "ui-chip-group", never, {
     "gap": {
@@ -9657,7 +9666,7 @@ export declare class PdfHotspotComponent {
   /** `ready`: clickable; `blocked`: disabled (a prerequisite is missing); `signed`: shows `image`. */
   readonly state: import("@angular/core").InputSignal<"ready" | "blocked" | "signed">;
   /** `warning` gives the ready state an amber look (e.g. for initials), default is blue. */
-  readonly tone: import("@angular/core").InputSignal<"warning" | "primary">;
+  readonly tone: import("@angular/core").InputSignal<"primary" | "warning">;
   /** Text of the ready button (e.g. "Sign Here"). */
   readonly label: import("@angular/core").InputSignal<string>;
   /** Text of the blocked button (e.g. "Add signature above"). */
@@ -9791,7 +9800,7 @@ export declare class DetailCardComponent {
   /** true (default) = the title is displayed in capitals (CSS only); false = shown as written. The text, aria-label and heading name are never changed. */
   readonly uppercaseTitle: import("@angular/core").InputSignal<boolean>;
   /** 1-6 makes the title a real heading for screen readers (role=heading, aria-level); null keeps it plain text. */
-  readonly headingLevel: import("@angular/core").InputSignal<1 | 2 | 3 | 4 | 5 | 6 | null>;
+  readonly headingLevel: import("@angular/core").InputSignal<2 | 1 | 6 | 3 | 4 | 5 | null>;
   /** Optional id for the title text; the card is then labelled by it. Without it the title is the card's aria-label. */
   readonly titleId: import("@angular/core").InputSignal<string>;
   /** Accessible name of the card when the header gives none (no header, or no title). A visible title wins; blank = no name. */
@@ -12234,7 +12243,7 @@ export declare class SetupWizardComponent {
   protected customHintId(): string;
   protected readonly importBlocked: import("@angular/core").Signal<boolean>;
   /** The step's own two parts (`splitLayout`) show as two tabs, one card at a time; this is the open one (it starts on the app's part on every visit). */
-  protected readonly splitTab: import("@angular/core").WritableSignal<"main" | "extra">;
+  protected readonly splitTab: import("@angular/core").WritableSignal<"extra" | "main">;
   protected readonly splitTabs: import("@angular/core").Signal<{
     key: string;
     label: string;
@@ -13166,4 +13175,727 @@ export declare class ReminderAlertsComponent {
     "hidden": "hidden";
   }, never, never, true, never>;
 }
+/** One row of the conversation list. The HOST maps its own record to this shape (phone formatting aside, the component shows the values as given). */
+export interface ConversationItem {
+  id: string;
+  /** Who the conversation is with; also the avatar initial and the thread heading. */
+  name: string;
+  /** Second line under the name, e.g. a phone number already formatted by the host (see `formatConversationPhone`). */
+  subtitle?: string | null;
+  /** ISO instant of the last message: shown as a short relative time ("5m", "2d", "Oct 12"). */
+  lastMessageAt?: string | null;
+  /** The last message's text; cut at 60 characters. Empty shows "No messages". */
+  preview?: string | null;
+  /** Unread messages; above 0 the row is highlighted and shows a count badge. */
+  unreadCount?: number;
+  /** A gray badge on the row, e.g. "Closed" or "Archived". Omit for an open conversation. */
+  statusLabel?: string | null;
+}
+export type ConversationMessageDirection = 'inbound' | 'outbound';
+/** A file shown inside a message bubble. */
+export interface ConversationMedia {
+  url: string;
+  /** MIME type: `image/*` is shown as a picture, `video/*` as a player, anything else as a link. */
+  type?: string | null;
+  fileName?: string | null;
+}
+/** One message of the open thread. */
+export interface ConversationMessage {
+  id: string;
+  direction: ConversationMessageDirection;
+  body?: string | null;
+  /** ISO instant. Drives the time under the bubble and the date separators. */
+  sentAt: string;
+  /** Outbound only: `sent` (✓), `delivered` (✓✓), `failed`, `scheduled`. Other values show nothing. */
+  status?: string | null;
+  media?: ConversationMedia | null;
+  /** Outbound only: who wrote it (e.g. the agent's name), shown before the time. Omit when the sender is always "You". */
+  sender?: string | null;
+  /** A link-style button under the text, e.g. "View transaction"; clicking it emits `(messageAction)` with this message. */
+  action?: ConversationMessageAction | null;
+}
+/** The button a message can carry (see `ConversationMessage.action`). */
+export interface ConversationMessageAction {
+  label: string;
+}
+/** The file waiting to be sent with the next message. */
+export interface ConversationAttachment {
+  fileName: string;
+  /** Shown as a thumbnail when set; otherwise the file name. */
+  previewUrl?: string | null;
+}
+/** What `(send)` reports. */
+export interface ConversationSendEvent {
+  text: string;
+}
+/** A message with the date separator that goes above it ('' when it shares the day of the previous message). */
+export interface ConversationMessageRow {
+  message: ConversationMessage;
+  separator: string;
+}
+/**
+ * Pure display helpers of `ui-conversations` (no Angular). Dates are formatted with an explicit 'en-US' locale and are only ever
+ * read from ISO strings, so Chrome, Edge, Firefox and Safari print the same text.
+ */
+/** "(512) 555-0100"; "+1 (512) 555-0100" for an 11-digit number that starts with 1; anything else is returned as stored ('' for none). */
+export declare function formatConversationPhone(phone: string | null | undefined): string;
+/** The text cut at `len` characters with "..." ('' for none). */
+export declare function truncateConversationText(text: string | null | undefined, len: number): string;
+/** "now", "5m", "3h", "2d", then "Oct 12" (the list's time column). '' for a missing or unreadable date. */
+export declare function formatConversationTime(iso: string | null | undefined, now?: Date): string;
+/** "3:05 PM" (a message's time). '' for an unreadable date. */
+export declare function formatMessageTime(iso: string): string;
+/** "Today", "Yesterday" or "Oct 12, 2026" (the date separator in a thread). '' for an unreadable date (never "Invalid Date"). */
+export declare function conversationDateLabel(iso: string, now?: Date): string;
+/** First letter of the name, upper case, for the avatar ('?' for a blank name). */
+export declare function conversationInitial(name: string | null | undefined): string;
+/** Each message with the date separator that goes above it ('' when it shares the day of the previous message). */
+export declare function groupMessagesByDay(messages: readonly ConversationMessage[], now?: Date): ConversationMessageRow[];
+/** What the status mark beside an outbound message says to a screen reader ('' for a status that shows nothing). */
+export declare function conversationMessageStatusLabel(status: string | null | undefined): string;
+/** The mark shown beside an outbound message: ticks for sent / delivered, the word for the rest. */
+export declare function conversationMessageStatusMark(status: string | null | undefined): string;
+/**
+ * The text-message inbox: a conversation list (search, filter tabs, pagination) on the left, the open thread (header, messages with date
+ * separators and media, composer) in the middle and an optional contact panel on the right. On a phone the list and the thread take turns.
+ *
+ *   <ui-conversations
+ *     [conversations]="rows()" [selected]="open()" [messages]="messages()" [loading]="loading()" [messagesLoading]="threadLoading()"
+ *     [filterTabs]="tabs" [filterCounts]="counts()" [activeFilter]="filter()" [page]="page()" [pageSize]="25" [totalItems]="total()"
+ *     [(draft)]="draft" [sending]="sending()" [canWrite]="canWrite()" [hasContext]="true" [(contextOpen)]="contextOpen"
+ *     (searchChange)="onSearch($event)" (filterChange)="filter.set($event)" (pageChange)="page.set($event)"
+ *     (selectConversation)="open.set($event)" (send)="onSend($event)" ...>
+ *     <div uiConversationsContext> ...contact details... </div>
+ *   </ui-conversations>
+ *
+ * The component keeps NO data and makes NO requests: the host loads, polls, sends, uploads, deletes and changes status, and passes the
+ * results back in. It owns the layout, the keyboard / screen-reader behaviour, the scroll-to-latest rule (the thread follows new messages
+ * only while the user is at its end), the focus moves of the one-column layout and the Enter-to-send rule (Shift+Enter is a new line; the
+ * Enter that confirms an IME composition is not a send). `[canWrite]="false"` is the read-only view: no New / Delete / status / template
+ * buttons and no composer.
+ *
+ * `[allowNew]="false"` / `[allowDelete]="false"` hide the New and Delete buttons for a host that cannot start or delete conversations while the composer
+ * stays (a reply-only inbox such as Portal Messages). A message may carry a `sender` and an `action` link button (`(messageAction)`); a long thread
+ * shows "Load earlier messages" while `[hasEarlier]` (`(loadEarlier)`); a failed thread load shows `[messagesError]` with Retry (`(messagesRetry)`).
+ *
+ * Test ids: conversations, conv-search, conv-filters, new-message-btn, conv-loading, conv-error, conv-retry, conv-empty, conv-item, conv-unread,
+ * conv-arrow, conv-delete-btn, thread-empty, thread-error, thread-retry, load-earlier, msg-sender, msg-action, back-to-list, thread-name, thread-phone, use-template-btn, context-toggle, status-btn, thread-delete-btn,
+ * messages, messages-loading, messages-empty, message, msg-status, attach-btn, attach-input, attachment-preview, attachment-remove,
+ * compose-input, send-btn, compose-opted-out, compose-loading-contact, context-panel, context-close.
+ */
+export declare class ConversationsComponent {
+  readonly conversations: import("@angular/core").InputSignal<readonly ConversationItem[]>;
+  /** The open conversation (null = none: the empty thread shows, and on a phone the list). It need not be on the current list page. */
+  readonly selected: import("@angular/core").InputSignal<ConversationItem | null>;
+  readonly title: import("@angular/core").InputSignal<string>;
+  readonly loading: import("@angular/core").InputSignal<boolean>;
+  /** A failed list load: the message, with a Retry button. */
+  readonly error: import("@angular/core").InputSignal<string | null>;
+  /** The search text (two-way). The host usually reacts to `(searchChange)`, which fires after the search box's own debounce. */
+  readonly searchText: import("@angular/core").ModelSignal<string>;
+  readonly searchPlaceholder: import("@angular/core").InputSignal<string>;
+  readonly searchAriaLabel: import("@angular/core").InputSignal<string>;
+  /** Search and filter tabs are hidden until the host says the first load is done (they would flash while loading). */
+  readonly showFilters: import("@angular/core").InputSignal<boolean>;
+  /** Filter tabs; none = no filter row. The empty value `''` is the "All" tab. */
+  readonly filterTabs: import("@angular/core").InputSignal<QuickFilterTab[]>;
+  readonly filterCounts: import("@angular/core").InputSignal<Record<string, number>>;
+  readonly activeFilter: import("@angular/core").InputSignal<string>;
+  readonly filterAriaLabel: import("@angular/core").InputSignal<string>;
+  /** 1-based page, page size and total of the list. */
+  readonly page: import("@angular/core").InputSignal<number>;
+  readonly pageSize: import("@angular/core").InputSignal<number>;
+  readonly totalItems: import("@angular/core").InputSignal<number>;
+  readonly paginationAriaLabel: import("@angular/core").InputSignal<string>;
+  readonly listAriaLabel: import("@angular/core").InputSignal<string>;
+  readonly loadingLabel: import("@angular/core").InputSignal<string>;
+  readonly emptyTitle: import("@angular/core").InputSignal<string>;
+  readonly emptyMessage: import("@angular/core").InputSignal<string>;
+  /** The empty-list text for a read-only user (who has no + button). */
+  readonly emptyReadOnlyMessage: import("@angular/core").InputSignal<string>;
+  readonly filteredEmptyTitle: import("@angular/core").InputSignal<string>;
+  readonly filteredEmptyMessage: import("@angular/core").InputSignal<string>;
+  readonly noMessagesText: import("@angular/core").InputSignal<string>;
+  /** Shows the + (New) button for a writer. `false` for a host that cannot start conversations. */
+  readonly allowNew: import("@angular/core").InputSignal<boolean>;
+  /** Shows the bins (row and thread header) for a writer. `false` for a host that cannot delete conversations. */
+  readonly allowDelete: import("@angular/core").InputSignal<boolean>;
+  /** The arrow at the end of each conversation row, drawn inside the row so its highlight covers it. Default false (hidden); `true` where the arrow helps (rows that open a thread on a phone). */
+  readonly showRowArrow: import("@angular/core").InputSignal<boolean>;
+  readonly newLabel: import("@angular/core").InputSignal<string>;
+  readonly newTooltip: import("@angular/core").InputSignal<string>;
+  readonly deleteRowLabel: import("@angular/core").InputSignal<string>;
+  readonly messages: import("@angular/core").InputSignal<readonly ConversationMessage[]>;
+  readonly messagesLoading: import("@angular/core").InputSignal<boolean>;
+  /** A failed thread load: the message, with a Retry button (`(messagesRetry)`). */
+  readonly messagesError: import("@angular/core").InputSignal<string | null>;
+  /** The loaded messages are only the newest ones: a "Load earlier messages" button shows above them. */
+  readonly hasEarlier: import("@angular/core").InputSignal<boolean>;
+  readonly loadingEarlier: import("@angular/core").InputSignal<boolean>;
+  readonly loadEarlierLabel: import("@angular/core").InputSignal<string>;
+  /** The thread header's Close / Reopen button: its label (also the tooltip); null = no button. */
+  readonly statusActionLabel: import("@angular/core").InputSignal<string | null>;
+  /** `close` (a check) or `reopen` (a circular arrow): which icon the status button shows. */
+  readonly statusActionIcon: import("@angular/core").InputSignal<"close" | "reopen">;
+  readonly statusChanging: import("@angular/core").InputSignal<boolean>;
+  /** Shows the "Use a template" button (disabled with the composer). */
+  readonly templatesEnabled: import("@angular/core").InputSignal<boolean>;
+  readonly templateLabel: import("@angular/core").InputSignal<string>;
+  readonly deleteThreadLabel: import("@angular/core").InputSignal<string>;
+  readonly backLabel: import("@angular/core").InputSignal<string>;
+  readonly threadAriaLabel: import("@angular/core").InputSignal<string>;
+  readonly messagesAriaLabel: import("@angular/core").InputSignal<string>;
+  readonly threadEmptyTitle: import("@angular/core").InputSignal<string>;
+  readonly threadEmptyMessage: import("@angular/core").InputSignal<string>;
+  readonly noMessagesWriteText: import("@angular/core").InputSignal<string>;
+  readonly noMessagesReadText: import("@angular/core").InputSignal<string>;
+  readonly youLabel: import("@angular/core").InputSignal<string>;
+  readonly openMediaLabel: import("@angular/core").InputSignal<string>;
+  readonly imageFallbackName: import("@angular/core").InputSignal<string>;
+  readonly fileFallbackName: import("@angular/core").InputSignal<string>;
+  /** Shows the contact-info toggle. The panel's content is the host's, projected with the `uiConversationsContext` attribute. */
+  readonly hasContext: import("@angular/core").InputSignal<boolean>;
+  /** The panel is open (two-way). It closes itself on Escape, the X and (one column) the backdrop, and when the conversation is closed. */
+  readonly contextOpen: import("@angular/core").ModelSignal<boolean>;
+  readonly contextTitle: import("@angular/core").InputSignal<string>;
+  readonly showContextLabel: import("@angular/core").InputSignal<string>;
+  readonly hideContextLabel: import("@angular/core").InputSignal<string>;
+  readonly closeContextLabel: import("@angular/core").InputSignal<string>;
+  /** Read-only view: no New / Delete / status / template buttons and no composer. */
+  readonly canWrite: import("@angular/core").InputSignal<boolean>;
+  /** The message being typed (two-way). The host clears it after a successful send. */
+  readonly draft: import("@angular/core").ModelSignal<string>;
+  readonly sending: import("@angular/core").InputSignal<boolean>;
+  /** The composer is locked (e.g. the contact opted out): the box, attach and template buttons are disabled and nothing can be sent. */
+  readonly composerDisabled: import("@angular/core").InputSignal<boolean>;
+  /** A host-side reason nothing can be sent right now (e.g. the contact is still loading); the Send button is disabled. */
+  readonly sendBlocked: import("@angular/core").InputSignal<boolean>;
+  /** A warning under the composer, e.g. "This contact has opted out of text messages." */
+  readonly composerNotice: import("@angular/core").InputSignal<string>;
+  /** A polite status line under the composer (a live region), e.g. "Loading contact...". */
+  readonly composerStatus: import("@angular/core").InputSignal<string>;
+  /** An error on the message box. */
+  readonly composerError: import("@angular/core").InputSignal<string>;
+  /** Longest message the box accepts (1600 = the SMS provider's limit for one send). */
+  readonly maxLength: import("@angular/core").InputSignal<number>;
+  readonly attachment: import("@angular/core").InputSignal<ConversationAttachment | null>;
+  readonly uploading: import("@angular/core").InputSignal<boolean>;
+  readonly attachEnabled: import("@angular/core").InputSignal<boolean>;
+  readonly acceptedFiles: import("@angular/core").InputSignal<string>;
+  readonly maxFileSize: import("@angular/core").InputSignal<number | null>;
+  readonly typeMessage: import("@angular/core").InputSignal<string>;
+  readonly sizeMessage: import("@angular/core").InputSignal<string>;
+  readonly composeLabel: import("@angular/core").InputSignal<string>;
+  readonly composePlaceholder: import("@angular/core").InputSignal<string>;
+  readonly sendLabel: import("@angular/core").InputSignal<string>;
+  readonly attachLabel: import("@angular/core").InputSignal<string>;
+  readonly removeAttachmentLabel: import("@angular/core").InputSignal<string>;
+  readonly attachmentPreviewLabel: import("@angular/core").InputSignal<string>;
+  /** "Now" for the relative times and date separators; null = the real clock. For tests and demos. */
+  readonly now: import("@angular/core").InputSignal<Date | null>;
+  readonly searchChange: import("@angular/core").OutputEmitterRef<string>;
+  readonly filterChange: import("@angular/core").OutputEmitterRef<string>;
+  readonly pageChange: import("@angular/core").OutputEmitterRef<number>;
+  /** A row was clicked or opened with the keyboard. */
+  readonly selectConversation: import("@angular/core").OutputEmitterRef<ConversationItem>;
+  /** Back (one column): the host clears `selected`; the focus returns to the row that was open. */
+  readonly back: import("@angular/core").OutputEmitterRef<void>;
+  readonly newConversation: import("@angular/core").OutputEmitterRef<void>;
+  readonly retry: import("@angular/core").OutputEmitterRef<void>;
+  /** The bin on a row, or in the thread header. The host asks for confirmation. */
+  readonly deleteConversation: import("@angular/core").OutputEmitterRef<ConversationItem>;
+  /** The Close / Reopen button of the open conversation. */
+  readonly statusChange: import("@angular/core").OutputEmitterRef<ConversationItem>;
+  readonly templateRequest: import("@angular/core").OutputEmitterRef<void>;
+  readonly send: import("@angular/core").OutputEmitterRef<ConversationSendEvent>;
+  /** Files accepted by the attach picker (type and size already checked against `acceptedFiles` / `maxFileSize`). */
+  readonly filesSelected: import("@angular/core").OutputEmitterRef<File[]>;
+  readonly attachmentRemove: import("@angular/core").OutputEmitterRef<void>;
+  /** An image in a bubble was clicked: the host opens it (usually in a new tab). */
+  readonly mediaOpen: import("@angular/core").OutputEmitterRef<string>;
+  /** The link-style button of a message (`ConversationMessage.action`) was clicked. */
+  readonly messageAction: import("@angular/core").OutputEmitterRef<ConversationMessage>;
+  /** "Load earlier messages": the host puts the older page above the loaded messages. */
+  readonly loadEarlier: import("@angular/core").OutputEmitterRef<void>;
+  /** Retry after a failed thread load. */
+  readonly messagesRetry: import("@angular/core").OutputEmitterRef<void>;
+  protected readonly titleId: string;
+  protected readonly skeletonRows: number[];
+  protected readonly skeletonBubbles: number[];
+  protected readonly trackConversation: (c: ConversationItem) => string;
+  protected readonly initial: typeof conversationInitial;
+  protected readonly statusLabel: typeof conversationMessageStatusLabel;
+  protected readonly statusMark: typeof conversationMessageStatusMark;
+  private readonly injector;
+  private readonly host;
+  private readonly threadHeading;
+  private readonly messagesEl;
+  private readonly contextPanel;
+  private readonly fileInput;
+  /** True while the thread is scrolled to (or within NEAR_BOTTOM_PX of) its end; kept by the scroll handler. */
+  private atBottom;
+  private lastThreadId;
+  protected readonly filtering: import("@angular/core").Signal<boolean>;
+  protected readonly emptyText: import("@angular/core").Signal<string>;
+  protected readonly messageRows: import("@angular/core").Signal<import("@forgeroute/ui").ConversationMessageRow[]>;
+  protected readonly contextVisible: import("@angular/core").Signal<boolean>;
+  /** Something to send (text or a file), the composer is open and no request is running. */
+  readonly canSend: import("@angular/core").Signal<boolean>;
+  constructor();
+  protected relativeTime(iso: string | null | undefined): string;
+  protected preview(text: string | null | undefined): string;
+  protected time(message: ConversationMessage): string;
+  /** A row was clicked or opened with the keyboard. */
+  protected onRowOpen(conv: ConversationItem): void;
+  protected onBack(): void;
+  protected onMessagesScroll(): void;
+  protected toggleContext(): void;
+  /** Closes the contact panel; `restoreFocus` puts the focus back on the toggle that opened it. */
+  protected closeContext(restoreFocus?: boolean): void;
+  protected openFilePicker(): void;
+  protected onComposeKeydown(event: KeyboardEvent): void;
+  protected sendMessage(): void;
+  private clock;
+  private singleColumn;
+  private scrollToBottom;
+  static ɵfac: i0.ɵɵFactoryDeclaration<ConversationsComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<ConversationsComponent, "ui-conversations", never, {
+    "conversations": {
+      "alias": "conversations";
+      "required": false;
+      "isSignal": true;
+    };
+    "selected": {
+      "alias": "selected";
+      "required": false;
+      "isSignal": true;
+    };
+    "title": {
+      "alias": "title";
+      "required": false;
+      "isSignal": true;
+    };
+    "loading": {
+      "alias": "loading";
+      "required": false;
+      "isSignal": true;
+    };
+    "error": {
+      "alias": "error";
+      "required": false;
+      "isSignal": true;
+    };
+    "searchText": {
+      "alias": "searchText";
+      "required": false;
+      "isSignal": true;
+    };
+    "searchPlaceholder": {
+      "alias": "searchPlaceholder";
+      "required": false;
+      "isSignal": true;
+    };
+    "searchAriaLabel": {
+      "alias": "searchAriaLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "showFilters": {
+      "alias": "showFilters";
+      "required": false;
+      "isSignal": true;
+    };
+    "filterTabs": {
+      "alias": "filterTabs";
+      "required": false;
+      "isSignal": true;
+    };
+    "filterCounts": {
+      "alias": "filterCounts";
+      "required": false;
+      "isSignal": true;
+    };
+    "activeFilter": {
+      "alias": "activeFilter";
+      "required": false;
+      "isSignal": true;
+    };
+    "filterAriaLabel": {
+      "alias": "filterAriaLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "page": {
+      "alias": "page";
+      "required": false;
+      "isSignal": true;
+    };
+    "pageSize": {
+      "alias": "pageSize";
+      "required": false;
+      "isSignal": true;
+    };
+    "totalItems": {
+      "alias": "totalItems";
+      "required": false;
+      "isSignal": true;
+    };
+    "paginationAriaLabel": {
+      "alias": "paginationAriaLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "listAriaLabel": {
+      "alias": "listAriaLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "loadingLabel": {
+      "alias": "loadingLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "emptyTitle": {
+      "alias": "emptyTitle";
+      "required": false;
+      "isSignal": true;
+    };
+    "emptyMessage": {
+      "alias": "emptyMessage";
+      "required": false;
+      "isSignal": true;
+    };
+    "emptyReadOnlyMessage": {
+      "alias": "emptyReadOnlyMessage";
+      "required": false;
+      "isSignal": true;
+    };
+    "filteredEmptyTitle": {
+      "alias": "filteredEmptyTitle";
+      "required": false;
+      "isSignal": true;
+    };
+    "filteredEmptyMessage": {
+      "alias": "filteredEmptyMessage";
+      "required": false;
+      "isSignal": true;
+    };
+    "noMessagesText": {
+      "alias": "noMessagesText";
+      "required": false;
+      "isSignal": true;
+    };
+    "allowNew": {
+      "alias": "allowNew";
+      "required": false;
+      "isSignal": true;
+    };
+    "allowDelete": {
+      "alias": "allowDelete";
+      "required": false;
+      "isSignal": true;
+    };
+    "showRowArrow": {
+      "alias": "showRowArrow";
+      "required": false;
+      "isSignal": true;
+    };
+    "newLabel": {
+      "alias": "newLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "newTooltip": {
+      "alias": "newTooltip";
+      "required": false;
+      "isSignal": true;
+    };
+    "deleteRowLabel": {
+      "alias": "deleteRowLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "messages": {
+      "alias": "messages";
+      "required": false;
+      "isSignal": true;
+    };
+    "messagesLoading": {
+      "alias": "messagesLoading";
+      "required": false;
+      "isSignal": true;
+    };
+    "messagesError": {
+      "alias": "messagesError";
+      "required": false;
+      "isSignal": true;
+    };
+    "hasEarlier": {
+      "alias": "hasEarlier";
+      "required": false;
+      "isSignal": true;
+    };
+    "loadingEarlier": {
+      "alias": "loadingEarlier";
+      "required": false;
+      "isSignal": true;
+    };
+    "loadEarlierLabel": {
+      "alias": "loadEarlierLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "statusActionLabel": {
+      "alias": "statusActionLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "statusActionIcon": {
+      "alias": "statusActionIcon";
+      "required": false;
+      "isSignal": true;
+    };
+    "statusChanging": {
+      "alias": "statusChanging";
+      "required": false;
+      "isSignal": true;
+    };
+    "templatesEnabled": {
+      "alias": "templatesEnabled";
+      "required": false;
+      "isSignal": true;
+    };
+    "templateLabel": {
+      "alias": "templateLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "deleteThreadLabel": {
+      "alias": "deleteThreadLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "backLabel": {
+      "alias": "backLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "threadAriaLabel": {
+      "alias": "threadAriaLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "messagesAriaLabel": {
+      "alias": "messagesAriaLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "threadEmptyTitle": {
+      "alias": "threadEmptyTitle";
+      "required": false;
+      "isSignal": true;
+    };
+    "threadEmptyMessage": {
+      "alias": "threadEmptyMessage";
+      "required": false;
+      "isSignal": true;
+    };
+    "noMessagesWriteText": {
+      "alias": "noMessagesWriteText";
+      "required": false;
+      "isSignal": true;
+    };
+    "noMessagesReadText": {
+      "alias": "noMessagesReadText";
+      "required": false;
+      "isSignal": true;
+    };
+    "youLabel": {
+      "alias": "youLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "openMediaLabel": {
+      "alias": "openMediaLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "imageFallbackName": {
+      "alias": "imageFallbackName";
+      "required": false;
+      "isSignal": true;
+    };
+    "fileFallbackName": {
+      "alias": "fileFallbackName";
+      "required": false;
+      "isSignal": true;
+    };
+    "hasContext": {
+      "alias": "hasContext";
+      "required": false;
+      "isSignal": true;
+    };
+    "contextOpen": {
+      "alias": "contextOpen";
+      "required": false;
+      "isSignal": true;
+    };
+    "contextTitle": {
+      "alias": "contextTitle";
+      "required": false;
+      "isSignal": true;
+    };
+    "showContextLabel": {
+      "alias": "showContextLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "hideContextLabel": {
+      "alias": "hideContextLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "closeContextLabel": {
+      "alias": "closeContextLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "canWrite": {
+      "alias": "canWrite";
+      "required": false;
+      "isSignal": true;
+    };
+    "draft": {
+      "alias": "draft";
+      "required": false;
+      "isSignal": true;
+    };
+    "sending": {
+      "alias": "sending";
+      "required": false;
+      "isSignal": true;
+    };
+    "composerDisabled": {
+      "alias": "composerDisabled";
+      "required": false;
+      "isSignal": true;
+    };
+    "sendBlocked": {
+      "alias": "sendBlocked";
+      "required": false;
+      "isSignal": true;
+    };
+    "composerNotice": {
+      "alias": "composerNotice";
+      "required": false;
+      "isSignal": true;
+    };
+    "composerStatus": {
+      "alias": "composerStatus";
+      "required": false;
+      "isSignal": true;
+    };
+    "composerError": {
+      "alias": "composerError";
+      "required": false;
+      "isSignal": true;
+    };
+    "maxLength": {
+      "alias": "maxLength";
+      "required": false;
+      "isSignal": true;
+    };
+    "attachment": {
+      "alias": "attachment";
+      "required": false;
+      "isSignal": true;
+    };
+    "uploading": {
+      "alias": "uploading";
+      "required": false;
+      "isSignal": true;
+    };
+    "attachEnabled": {
+      "alias": "attachEnabled";
+      "required": false;
+      "isSignal": true;
+    };
+    "acceptedFiles": {
+      "alias": "acceptedFiles";
+      "required": false;
+      "isSignal": true;
+    };
+    "maxFileSize": {
+      "alias": "maxFileSize";
+      "required": false;
+      "isSignal": true;
+    };
+    "typeMessage": {
+      "alias": "typeMessage";
+      "required": false;
+      "isSignal": true;
+    };
+    "sizeMessage": {
+      "alias": "sizeMessage";
+      "required": false;
+      "isSignal": true;
+    };
+    "composeLabel": {
+      "alias": "composeLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "composePlaceholder": {
+      "alias": "composePlaceholder";
+      "required": false;
+      "isSignal": true;
+    };
+    "sendLabel": {
+      "alias": "sendLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "attachLabel": {
+      "alias": "attachLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "removeAttachmentLabel": {
+      "alias": "removeAttachmentLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "attachmentPreviewLabel": {
+      "alias": "attachmentPreviewLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "now": {
+      "alias": "now";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "searchText": "searchTextChange";
+    "contextOpen": "contextOpenChange";
+    "draft": "draftChange";
+    "searchChange": "searchChange";
+    "filterChange": "filterChange";
+    "pageChange": "pageChange";
+    "selectConversation": "selectConversation";
+    "back": "back";
+    "newConversation": "newConversation";
+    "retry": "retry";
+    "deleteConversation": "deleteConversation";
+    "statusChange": "statusChange";
+    "templateRequest": "templateRequest";
+    "send": "send";
+    "filesSelected": "filesSelected";
+    "attachmentRemove": "attachmentRemove";
+    "mediaOpen": "mediaOpen";
+    "messageAction": "messageAction";
+    "loadEarlier": "loadEarlier";
+    "messagesRetry": "messagesRetry";
+  }, never, ["[uiConversationsContext]"], true, never>;
+}
 export type { CalendarDay, CalendarRange, CalendarViewMode };