@forgeroute/ui 0.4.57 → 0.4.59

package/types/forgeroute-ui.d.ts

@@ -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>;
@@ -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<"primary" | "secondary" | "danger" | "warning" | "link" | "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' }`). */
@@ -4009,7 +4009,7 @@ export declare class ButtonComponent {
   readonly color: import("@angular/core").InputSignal<string | undefined>;
   readonly active: import("@angular/core").InputSignal<boolean>;
   readonly size: import("@angular/core").InputSignal<"sm" | "md" | "lg" | "xs">;
-  readonly type: import("@angular/core").InputSignal<"reset" | "submit" | "button">;
+  readonly type: import("@angular/core").InputSignal<"button" | "reset" | "submit">;
   readonly disabled: import("@angular/core").InputSignal<boolean>;
   readonly loading: import("@angular/core").InputSignal<boolean>;
   readonly fullWidth: import("@angular/core").InputSignal<boolean>;
@@ -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" | "text" | "search" | "email" | "tel" | "url" | "decimal" | "numeric">;
+  readonly inputmode: import("@angular/core").InputSignal<"" | "search" | "text" | "numeric" | "none" | "email" | "tel" | "url" | "decimal">;
   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. */
@@ -6424,7 +6424,7 @@ export declare class DropdownComponent {
   readonly loader: import("@angular/core").InputSignal<(() => Promise<DropdownItem[]>) | null>;
   readonly active: import("@angular/core").InputSignal<boolean>;
   readonly activeValue: import("@angular/core").InputSignal<string>;
-  readonly variant: import("@angular/core").InputSignal<"badge" | "button">;
+  readonly variant: import("@angular/core").InputSignal<"button" | "badge">;
   readonly menuWidth: import("@angular/core").InputSignal<string>;
   /**
    * Fixed width of the trigger as a CSS length (e.g. `'280px'`). Empty (default) = the trigger is as wide as its label. When set, the trigger keeps that
@@ -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<"" | "2" | "3" | 2 | 3 | "all">;
+  readonly uiColSpan: import("@angular/core").InputSignal<"" | 2 | 3 | "2" | "3" | "all">;
   protected readonly _class: import("@angular/core").Signal<string>;
   static ɵfac: i0.ɵɵFactoryDeclaration<FormColSpanDirective, never>;
   static ɵdir: i0.ɵɵDirectiveDeclaration<FormColSpanDirective, "[uiColSpan]", never, {
@@ -12919,4 +12919,967 @@ export declare const DEFAULT_EMAIL_TEMPLATE_VARIABLE_GROUPS: {
  * Content-Security-Policy meta blocks scripts and anything but images / inline styles, and links open nowhere (sandbox, no popups).
  */
 export declare function buildPreviewDocument(bodyHtml: string): string;
+export type ShareOption = 'native' | 'facebook' | 'x' | 'linkedin' | 'email' | 'gmail' | 'outlook' | 'copy';
+interface ShareTile {
+  value: ShareOption;
+  label: string;
+  background: string;
+}
+/**
+ * "Share" control for a public page (an obituary, a blog post, any shareable item). The button opens a floating panel (over the page, so nothing moves)
+ * with one round icon per option and its name underneath, in a row like a phone's share sheet. Phones and tablets get Facebook, X,
+ * LinkedIn, Email (their mail app), Copy link and "More" (the device's own share sheet). Desktops get Gmail and Outlook instead of Email:
+ * a `mailto:` link does nothing on a computer without a mail app, while the webmail compose windows always open. "Link copied" is the library toast. The link is the public page
+ * of the item (never an `?embed=true` widget URL). Theming: `--ui-share-accent` (focus ring and the Copy link tile; default the library `--primary`).
+ *
+ *   <ui-share-menu [url]="pageUrl" [title]="post.title" label="blog post" />
+ */
+export declare class ShareMenuComponent {
+  /** The public page link to share. */
+  readonly url: import("@angular/core").InputSignal<string>;
+  /** The headline: the item's name or title (the X text, the email subject and the share-sheet title). */
+  readonly title: import("@angular/core").InputSignal<string>;
+  /** Used in the accessible name, e.g. "obituary" or "blog post" (→ "Share obituary"). */
+  readonly label: import("@angular/core").InputSignal<string>;
+  /** Unique id of the floating panel (several menus can be on one page). */
+  protected readonly panelId: string;
+  private readonly doc;
+  private readonly toast;
+  private readonly injector;
+  private readonly host;
+  private readonly trigger;
+  private readonly panel;
+  readonly open: import("@angular/core").WritableSignal<boolean>;
+  /** Pixels the panel is moved sideways so it never runs off either edge of the screen (or of the embedding frame). */
+  readonly shiftX: import("@angular/core").WritableSignal<number>;
+  /**
+   * "More" opens the device's own share sheet (Messages, AirDrop, Mail, WhatsApp…). It is offered on touch devices only: a desktop
+   * browser has the other options already, and its share sheet is limited (or absent), so "More" there would look broken.
+   */
+  private readonly isTouchDevice;
+  private readonly canNativeShare;
+  readonly tiles: import("@angular/core").Signal<ShareTile[]>;
+  /** The link each option opens (social sites in a new tab; the mail app in this window). */
+  readonly links: import("@angular/core").Signal<{
+    facebook: string;
+    x: string;
+    linkedin: string;
+    email: string;
+    gmail: string;
+    outlook: string;
+  }>;
+  toggle(event: Event): void;
+  private show;
+  close(returnFocus?: boolean): void;
+  onEscape(): void;
+  onDocumentClick(event: Event): void;
+  onFocusOut(event: FocusEvent): void;
+  /** Left / Right / Home / End move between the options. */
+  onPanelKeydown(event: KeyboardEvent): void;
+  choose(option: ShareOption): void;
+  private nativeShare;
+  /** Phones and tablets: opens the device's mail app with the subject and body filled in. */
+  private email;
+  private copy;
+  private legacyCopy;
+  static ɵfac: i0.ɵɵFactoryDeclaration<ShareMenuComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<ShareMenuComponent, "ui-share-menu", never, {
+    "url": {
+      "alias": "url";
+      "required": true;
+      "isSignal": true;
+    };
+    "title": {
+      "alias": "title";
+      "required": true;
+      "isSignal": true;
+    };
+    "label": {
+      "alias": "label";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}
+/**
+ * The links the public Share control builds. Pure functions so the component and its spec produce the exact same text.
+ * Every value is URL-encoded, so a title holding `&`, `#`, quotes or non-ASCII text can never break out of its query parameter.
+ */
+export declare const facebookShareUrl: (url: string) => string;
+export declare const xShareUrl: (url: string, text: string) => string;
+export declare const linkedInShareUrl: (url: string) => string;
+/** Gmail's compose window (a new tab) with the subject and body filled in: for desktop visitors, who often have no mail app for `mailto:`. */
+export declare const gmailShareUrl: (url: string, title: string) => string;
+/** Outlook.com's compose window (a new tab) with the subject and body filled in. */
+export declare const outlookShareUrl: (url: string, title: string) => string;
+/** `mailto:` with the title as the subject and the title plus the link as the body (encodeURIComponent, never `+` for spaces). */
+export declare const emailShareUrl: (url: string, title: string) => string;
+export type SnackbarType = 'success' | 'error' | 'info';
+/** An optional button inside a snackbar (e.g. "View"): clicking it runs `callback` and closes the snackbar. */
+export interface SnackbarAction {
+  label: string;
+  callback: () => void;
+}
+export interface SnackbarMessage {
+  id: number;
+  message: string;
+  type: SnackbarType;
+  action?: SnackbarAction;
+}
+/**
+ * Stacked, top-right notifications: several can be on screen at once, each closes itself after `duration` ms (0 = stays until closed)
+ * and can carry one action button. Render them once, near the root of the app, with `<ui-snackbar />`.
+ * (`ToastService` / `<ui-toast>` is the single bottom-centre message; this is the stack with actions.)
+ */
+export declare class SnackbarService {
+  private readonly _messages;
+  private nextId;
+  private readonly timers;
+  /** The messages on screen, oldest first (a copy). */
+  messages$(): SnackbarMessage[];
+  showSuccess(message: string, duration?: number): void;
+  showError(message: string, duration?: number): void;
+  showInfo(message: string, duration?: number, action?: SnackbarAction): void;
+  private show;
+  dismiss(id: number): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SnackbarService, never>;
+  static ɵprov: i0.ɵɵInjectableDeclaration<any>;
+}
+/**
+ * The on-screen stack of `SnackbarService` messages (top-right, above the page). Put one `<ui-snackbar />` near the root of the app.
+ * Each message is a library `ui-alert` (green success, red error, blue info) with a close button and, when the message has one, an
+ * action button. Test ids: `success-message` / `error-message` / `info-message` on each message, `snackbar-action` on the action button.
+ */
+export declare class SnackbarComponent {
+  private readonly service;
+  /** The messages on screen. */
+  protected readonly messages: import("@angular/core").Signal<SnackbarMessage[]>;
+  protected variant(m: SnackbarMessage): 'success' | 'danger' | 'info';
+  protected dismiss(id: number): void;
+  /** Runs the action, then closes the message. */
+  protected runAction(m: SnackbarMessage, callback: () => void): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SnackbarComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<SnackbarComponent, "ui-snackbar", never, {}, {}, never, never, true, never>;
+}
+/**
+ * A banner across the top of the page while the browser is offline (`navigator.onLine`, kept current by the window's `online` /
+ * `offline` events). The user can dismiss it; it comes back the next time the connection drops. Put one near the root of the app:
+ *
+ *   <ui-offline-banner />
+ *
+ * `offline` overrides the browser's own state (for an app that does its own connectivity check). Texts can be changed with `title`
+ * and `message`. Test ids: `offline-banner`, `offline-banner-dismiss`.
+ */
+export declare class OfflineBannerComponent {
+  readonly title: import("@angular/core").InputSignal<string>;
+  readonly message: import("@angular/core").InputSignal<string>;
+  /** Forces the state (true = offline); `null` (default) follows the browser. */
+  readonly offline: import("@angular/core").InputSignal<boolean | null>;
+  private readonly browserOffline;
+  private readonly dismissed;
+  protected readonly isOffline: import("@angular/core").Signal<boolean>;
+  protected readonly visible: import("@angular/core").Signal<boolean>;
+  constructor();
+  protected dismiss(): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<OfflineBannerComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<OfflineBannerComponent, "ui-offline-banner", never, {
+    "title": {
+      "alias": "title";
+      "required": false;
+      "isSignal": true;
+    };
+    "message": {
+      "alias": "message";
+      "required": false;
+      "isSignal": true;
+    };
+    "offline": {
+      "alias": "offline";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}
+export type ReminderAlertTone = 'danger' | 'warning' | 'info' | 'neutral';
+export interface ReminderAlertAction {
+  /** Reported by `(action)`; also part of the button's test id (`alert-<id>`). */
+  id: string;
+  label: string;
+  variant?: 'primary' | 'secondary' | 'ghost';
+}
+/** One in-app alert: a due reminder, an event starting soon, anything the user should notice now. The HOST decides what is due and what the buttons do. */
+export interface ReminderAlertItem {
+  id: string;
+  tone: ReminderAlertTone;
+  /** Small uppercase line above the title, e.g. "Overdue Reminder". */
+  label: string;
+  title: string;
+  /** Plain lines under the title (case name, description, due date…). */
+  lines?: string[];
+  /** A small purple pill under the title, e.g. the organization that created the item. */
+  badge?: {
+    label: string;
+    ariaLabel?: string;
+    testId?: string;
+  };
+  actions?: ReminderAlertAction[];
+  /** Accessible name of the hide (X) button; default "Hide alert". */
+  hideLabel?: string;
+  /** Test id of the hide button; default `alert-hide`. */
+  hideTestId?: string;
+}
+/**
+ * The stack of in-app alerts in the top-right corner (above the page, newest app state wins: the host passes the list). Each alert is a
+ * library `ui-alert` with a coloured tone, its label / title / lines, an optional badge, action buttons and a hide (X) button:
+ *
+ *   <ui-reminder-alerts [items]="alerts()" (action)="onAction($event)" (hidden)="hide($event)" />
+ *
+ * `(action)` gives `{ item, actionId }`; `(hidden)` gives the item. The component keeps no state: the host removes an item from `items`
+ * to make it go away (hiding, completing, snoozing are the host's rules). Nothing is drawn for an empty list.
+ */
+export declare class ReminderAlertsComponent {
+  readonly items: import("@angular/core").InputSignal<ReminderAlertItem[]>;
+  /** Accessible name of the region. */
+  readonly ariaLabel: import("@angular/core").InputSignal<string>;
+  /** An action button was clicked. */
+  readonly action: import("@angular/core").OutputEmitterRef<{
+    item: ReminderAlertItem;
+    actionId: string;
+  }>;
+  /** The hide (X) button was clicked. */
+  readonly hidden: import("@angular/core").OutputEmitterRef<ReminderAlertItem>;
+  protected variant(item: ReminderAlertItem): AlertVariant;
+  static ɵfac: i0.ɵɵFactoryDeclaration<ReminderAlertsComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<ReminderAlertsComponent, "ui-reminder-alerts", never, {
+    "items": {
+      "alias": "items";
+      "required": false;
+      "isSignal": true;
+    };
+    "ariaLabel": {
+      "alias": "ariaLabel";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "action": "action";
+    "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-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>;
+  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;
+    };
+    "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 };