@forgeroute/ui 0.4.50 → 0.4.52

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgeroute/ui",
-  "version": "0.4.50",
+  "version": "0.4.52",
   "peerDependencies": {
     "@angular/common": ">=22.0.0",
     "@angular/core": ">=22.0.0",

package/types/forgeroute-ui-messaging.d.ts

@@ -115,7 +115,7 @@ export declare class TemplatePickerComponent {
   private readonly host;
   private readonly search$;
   /** Filter results to a specific channel: 'email', 'text', or omit for all. */
-  readonly channel: import("@angular/core").InputSignal<"" | "email" | "text">;
+  readonly channel: import("@angular/core").InputSignal<"" | "text" | "email">;
   readonly selectedId: import("@angular/core").InputSignal<string | null>;
   readonly label: import("@angular/core").InputSignal<string>;
   /** Shows the red required asterisk (same as the library inputs) — e.g. when a template must be picked to send. */
@@ -543,7 +543,7 @@ export declare class DocumentSendOptionsComponent implements UiFieldValidity {
   /** API root from FORGEROUTE_CONFIG (e.g. a cross-origin prod API); falls back to same-origin `/api`. */
   private readonly apiBase;
   /** `email` → purpose select + attachment allowed; `text` → link only (purpose fixed to e-signature). */
-  readonly channel: import("@angular/core").InputSignal<"email" | "text">;
+  readonly channel: import("@angular/core").InputSignal<"text" | "email">;
   readonly label: import("@angular/core").InputSignal<string>;
   /** When true, at least one document must be chosen. The message forms leave it false: documents are optional there. */
   readonly required: import("@angular/core").InputSignal<boolean>;
@@ -608,7 +608,7 @@ export declare class DocumentSendOptionsComponent implements UiFieldValidity {
   /** Roles of documents whose row had no `signerRoles` and that the host resolves (`signers().resolveRoles`). */
   readonly roleStates: import("@angular/core").WritableSignal<Record<string, RoleState>>;
   /** The envelope's documents: `loading` / `error` while the panel reads them (`loadDocuments`), `ready` once known. */
-  readonly envelopeStatus: import("@angular/core").WritableSignal<"idle" | "loading" | "ready" | "error">;
+  readonly envelopeStatus: import("@angular/core").WritableSignal<"error" | "loading" | "ready" | "idle">;
   private envelopeSub;
   private readonly roleSubs;
   /** The sender opened the collapsed "Signing options" line. */
@@ -1997,7 +1997,7 @@ export declare class SendMessagePanelComponent {
   readonly activeContact: import("@angular/core").WritableSignal<MessageContact | null>;
   /** What the sender should know about the picked contact before sending (why a channel is missing, what to add). */
   readonly contactNotices: import("@angular/core").Signal<string[]>;
-  readonly channel: import("@angular/core").WritableSignal<"email" | "text">;
+  readonly channel: import("@angular/core").WritableSignal<"text" | "email">;
   readonly valid: import("@angular/core").WritableSignal<boolean>;
   /** Bumped on every fresh open / new contact — re-creates the email and text forms so no draft carries over. */
   readonly formEpoch: import("@angular/core").WritableSignal<number>;

package/types/forgeroute-ui-stripe.d.ts

@@ -1300,7 +1300,7 @@ export declare class StripeConnectComponent {
   readonly navigateTab: import("@angular/core").InputSignal<((url: string) => void) | null>;
   protected readonly visible: import("@angular/core").Signal<boolean>;
   /** Which screen the card shows. */
-  protected readonly state: import("@angular/core").Signal<"none" | "complete" | "verifying" | "incomplete">;
+  protected readonly state: import("@angular/core").Signal<"complete" | "verifying" | "incomplete" | "none">;
   /** What the persistent status region says: the current state, plus "Loading." while a request runs. Empty while nothing is shown. */
   protected readonly liveText: import("@angular/core").Signal<string>;
   /** The user pressed a button that started a request: when the screen then changes, focus moves to the new screen (the pressed button is gone). */

package/types/forgeroute-ui.d.ts

@@ -3815,6 +3815,8 @@ export declare class PhoneNumberPickerComponent {
   constructor();
   protected onPrimary(): void;
   protected onEnter(event: Event): void;
+  /** A field that was swapped out by a mode switch blurs while it is removed: that late blur must not mark the new field touched. */
+  protected onFieldBlur(from: PhoneNumberSearchMode): void;
   /** Typing a non-digit is blocked before it reaches the field. */
   protected onBeforeInput(event: Event): void;
   /** A pasted ZIP+4 / formatted text keeps its first 5 (or 3) digits and replaces the field's text. */
@@ -4158,6 +4160,9 @@ export declare class PillTabsComponent {
   readonly name: import("@angular/core").InputSignal<string>;
   /** Keep every pill at its own width on one line (default false: pills may shrink and wrap their text). On a phone the row scrolls sideways, as it always does. */
   readonly noWrap: import("@angular/core").InputSignal<boolean>;
+  /** 'vertical' stacks the tabs in a column (Up/Down arrows move between them, `aria-orientation="vertical"`). Default 'horizontal' = unchanged. */
+  readonly orientation: import("@angular/core").InputSignal<"vertical" | "horizontal">;
+  protected readonly vertical: () => boolean;
   readonly tabChange: import("@angular/core").OutputEmitterRef<string>;
   /** True while pills are hidden past the start / end edge of the scroll area (drives the fade hints). */
   protected readonly canScrollStart: import("@angular/core").WritableSignal<boolean>;
@@ -4195,6 +4200,11 @@ export declare class PillTabsComponent {
       "required": false;
       "isSignal": true;
     };
+    "orientation": {
+      "alias": "orientation";
+      "required": false;
+      "isSignal": true;
+    };
   }, {
     "tabChange": "tabChange";
   }, never, never, true, never>;
@@ -6049,6 +6059,8 @@ export declare class MultiSelectComponent implements ControlValueAccessor {
   registerOnTouched(fn: () => void): void;
   setDisabledState(d: boolean): void;
   protected onDocumentClick(event: Event): void;
+  /** Escape with the list open closes ONLY the list (focus back on the trigger) and is not passed on, so a surrounding side panel / modal stays open. */
+  protected onEscape(event: Event): void;
   protected toggleOpen(): void;
   protected toggleValue(value: string): void;
   protected remove(value: string): void;
@@ -6305,6 +6317,94 @@ export declare class DropdownComponent {
     "itemClick": "itemClick";
   }, never, never, true, never>;
 }
+/** One insertable merge variable. `value` is what `(picked)` emits (e.g. `{{first_name}}`); `group` puts it under a header. */
+export interface TextTemplateVariable {
+  value: string;
+  label: string;
+  group?: string;
+}
+interface Row$1 {
+  kind: 'group' | 'option';
+  key: string;
+  text: string;
+  variable?: TextTemplateVariable;
+  index?: number;
+}
+/**
+ * "Insert variable" picker for message templates: a button that opens a searchable list of every merge variable.
+ * Type to filter by name (case and accents ignored), or scroll the list; Enter / click picks one and `(picked)` emits its `value`.
+ * The list is positioned against the viewport (never clipped by a scrolling side panel), opens above the button when there is
+ * no room below, and scrolls inside the room it has.
+ *
+ *   <ui-text-template-picker [variables]="variables" (picked)="insert($event)" />
+ */
+export declare class TextTemplatePickerComponent {
+  readonly variables: import("@angular/core").InputSignal<TextTemplateVariable[]>;
+  readonly label: import("@angular/core").InputSignal<string>;
+  readonly searchPlaceholder: import("@angular/core").InputSignal<string>;
+  readonly disabled: import("@angular/core").InputSignal<boolean>;
+  /** The chosen variable's `value`. The list closes and focus returns to the button. */
+  readonly picked: import("@angular/core").OutputEmitterRef<string>;
+  protected readonly _id: string;
+  protected readonly _open: import("@angular/core").WritableSignal<boolean>;
+  protected readonly _query: import("@angular/core").WritableSignal<string>;
+  protected readonly _active: import("@angular/core").WritableSignal<number>;
+  protected readonly _top: import("@angular/core").WritableSignal<number | null>;
+  protected readonly _bottom: import("@angular/core").WritableSignal<number | null>;
+  protected readonly _left: import("@angular/core").WritableSignal<number>;
+  protected readonly _width: import("@angular/core").WritableSignal<number>;
+  protected readonly _maxHeight: import("@angular/core").WritableSignal<number>;
+  private readonly host;
+  private readonly injector;
+  constructor();
+  private static fold;
+  protected readonly _matches: import("@angular/core").Signal<TextTemplateVariable[]>;
+  /** Display rows: group headers (when variables carry a `group`) followed by their options, each option numbered for keyboard navigation. */
+  protected readonly _rows: import("@angular/core").Signal<Row$1[]>;
+  protected readonly _activeId: import("@angular/core").Signal<string | null>;
+  protected readonly _status: import("@angular/core").Signal<string>;
+  protected toggle(): void;
+  protected openFromKey(event: Event): void;
+  private openList;
+  /** Measures the trigger against the viewport: the list goes below it, or above when the room below is smaller, and never grows past the room it has. */
+  private place;
+  protected onQuery(value: string): void;
+  protected onSearchKey(event: KeyboardEvent): void;
+  protected pick(variable: TextTemplateVariable): void;
+  /** Escape closes only the list (and is not passed on), so a surrounding side panel / modal stays open. */
+  protected onEscape(event: Event): void;
+  private close;
+  private scrollActive;
+  protected onDocumentClick(event: Event): void;
+  /** A fixed list would drift from its button when the page resizes (or scrolls, see onAnyScroll); close it instead. */
+  protected onResize(): void;
+  private readonly onAnyScroll;
+  static ɵfac: i0.ɵɵFactoryDeclaration<TextTemplatePickerComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<TextTemplatePickerComponent, "ui-text-template-picker", never, {
+    "variables": {
+      "alias": "variables";
+      "required": false;
+      "isSignal": true;
+    };
+    "label": {
+      "alias": "label";
+      "required": false;
+      "isSignal": true;
+    };
+    "searchPlaceholder": {
+      "alias": "searchPlaceholder";
+      "required": false;
+      "isSignal": true;
+    };
+    "disabled": {
+      "alias": "disabled";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "picked": "picked";
+  }, never, never, true, never>;
+}
 /**
  * A real `<form>` for a group of library fields, so the browser (and assistive tech) treats it as one: it is announced as a
  * "form" landmark when it has a name, and pressing Enter in a field submits it through a `ui-button type="submit"`. Apps do not write
@@ -6501,6 +6601,10 @@ export declare class ListItemComponent {
   protected readonly iconD: () => string | null;
   /** Emitted when the radio/checkbox changes. */
   readonly select: import("@angular/core").OutputEmitterRef<void>;
+  /** A plain interactive row (no radio/checkbox) is itself clickable: click, Enter or Space emit `select`. */
+  protected readonly pressable: () => boolean;
+  protected onRowClick(e: Event): void;
+  protected onRowKey(e: Event): void;
   protected readonly visibleDetails: () => {
     text: string;
     d: string | null;
@@ -8550,6 +8654,7 @@ export declare class DateRangePickerComponent {
    * shows that applied range as the highlighted tab, it does not open an empty From / To card. Clicking the tab reopens it.
    */
   private readonly popoverDismissed;
+  /** `popoverDismissed` is read first on purpose: a linkedSignal is lazy, and its "created closed" start value must be computed before the preset ever becomes custom. */
   protected readonly popoverVisible: import("@angular/core").Signal<boolean>;
   protected readonly popTop: import("@angular/core").WritableSignal<number>;
   protected readonly popRight: import("@angular/core").WritableSignal<number>;