@forgeroute/ui 0.4.42 → 0.4.44

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgeroute/ui",
-  "version": "0.4.42",
+  "version": "0.4.44",
   "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. */
@@ -1375,18 +1375,36 @@ interface SendInAppPayload {
   contactId?: string;
   /** Only present when the Subject field is shown. */
   subject?: string;
+  /** The Message: plain text, or sanitized HTML when `richText` is on (then `bodyIsHtml` is true). */
   body: string;
+  /** Only present (true) when the Message was written in the rich-text editor. */
+  bodyIsHtml?: true;
+  /** Only present when attachments are on and the sender added at least one (base64 contents, like the email form). */
+  attachments?: SendInAppAttachment[];
+}
+/** A file the sender attached, read as base64 (the same shape the email form sends). */
+interface SendInAppAttachment {
+  filename: string;
+  content: string;
+  contentType: string;
 }
 /**
  * The form of a message that is not delivered by email or text but handed to the host's own function (e.g. a client portal message to the
- * agent): "To" card with the name only, an optional Subject, the Message. No address, templates, video, attachments or scheduling, and it makes
- * no request of its own: `sendFn` does the sending. Used by `<ui-send-message-panel recipientMode="in-app">`.
+ * agent): "To" card with the name (and the address when the host gives one), an optional Subject, the Message (plain, or the rich-text editor with
+ * `richText`) and optional attachments (`allowAttachments`). No templates, video or scheduling, and it makes no request of its own: `sendFn` does the sending. Used by `<ui-send-message-panel recipientMode="in-app">`.
  */
 declare class SendInAppComponent implements OnInit {
   private readonly destroyRef;
   private readonly toast;
+  private readonly cdr;
   readonly contactName: import("@angular/core").InputSignal<string>;
   readonly contactId: import("@angular/core").InputSignal<string>;
+  /** The address the message reaches the recipient at; shown under the name when given (the form never asks for one). */
+  readonly contactEmail: import("@angular/core").InputSignal<string>;
+  /** true shows "Attach Files" (any number of files); they are sent in the payload as base64. */
+  readonly allowAttachments: import("@angular/core").InputSignal<boolean>;
+  /** true writes the Message in the rich-text editor (bold, lists, ...); the payload body is then sanitized HTML. */
+  readonly richText: import("@angular/core").InputSignal<boolean>;
   /** Prefills Subject / Message. */
   readonly defaultSubject: import("@angular/core").InputSignal<string>;
   readonly defaultBody: import("@angular/core").InputSignal<string>;
@@ -1404,8 +1422,20 @@ declare class SendInAppComponent implements OnInit {
   readonly sending: import("@angular/core").WritableSignal<boolean>;
   subject: string;
   body: string;
+  attachments: {
+    filename: string;
+    content: string;
+    contentType: string;
+    sizeLabel: string;
+  }[];
   ngOnInit(): void;
+  /** The Message as the limit and the "is it empty" check see it: the text of the rich-text HTML, or the plain text. */
+  private bodyText;
+  /** Rich text only: the HTML is longer than the host's limit (the limit is on what the server stores). */
+  protected richTooLong(): boolean;
   get canSend(): boolean;
+  onFilesSelected(event: Event): void;
+  removeAttachment(index: number): void;
   notifyValid(): void;
   submit(): void;
   static ɵfac: i0.ɵɵFactoryDeclaration<SendInAppComponent, never>;
@@ -1420,6 +1450,21 @@ declare class SendInAppComponent implements OnInit {
       "required": false;
       "isSignal": true;
     };
+    "contactEmail": {
+      "alias": "contactEmail";
+      "required": false;
+      "isSignal": true;
+    };
+    "allowAttachments": {
+      "alias": "allowAttachments";
+      "required": false;
+      "isSignal": true;
+    };
+    "richText": {
+      "alias": "richText";
+      "required": false;
+      "isSignal": true;
+    };
     "defaultSubject": {
       "alias": "defaultSubject";
       "required": false;
@@ -1825,6 +1870,10 @@ export declare class SendMessagePanelComponent {
   readonly sendMessage: import("@angular/core").InputSignal<((payload: SendInAppPayload) => Observable<unknown>) | null>;
   /** `recipientMode="in-app"` only: the longest Message the host's backend accepts; null (default) = no limit. */
   readonly maxBodyLength: import("@angular/core").InputSignal<number | null>;
+  /** `recipientMode="in-app"` only: shows "Attach Files" (any number of files, sent in the payload as base64). Default false. */
+  readonly inAppAttachments: import("@angular/core").InputSignal<boolean>;
+  /** `recipientMode="in-app"` only: the Message is written in the rich-text editor and the payload body is sanitized HTML (`bodyIsHtml`). Default false. */
+  readonly inAppRichText: import("@angular/core").InputSignal<boolean>;
   /** false hides the Subject field in the email form and the in-app form (Send then needs only a Message). Default true. */
   readonly showSubject: import("@angular/core").InputSignal<boolean>;
   /** false hides the "Use Existing Template" tab in the email and text forms (Create Message only; the template picker, `GET /templates`, is never used). Default true. */
@@ -1948,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>;
@@ -2063,6 +2112,16 @@ export declare class SendMessagePanelComponent {
       "required": false;
       "isSignal": true;
     };
+    "inAppAttachments": {
+      "alias": "inAppAttachments";
+      "required": false;
+      "isSignal": true;
+    };
+    "inAppRichText": {
+      "alias": "inAppRichText";
+      "required": false;
+      "isSignal": true;
+    };
     "showSubject": {
       "alias": "showSubject";
       "required": false;
@@ -2327,4 +2386,4 @@ export declare class DocumentMergeCheckComponent {
     "warningsChange": "warningsChange";
   }, never, never, true, never>;
 }
-export type { CreateDocumentRequestBody, DocuSignSendBody, DocumentSentInfo, DocumentSentMessage, DocumentsPayloadExtras, ExistingEnvelopeSendBody, SendDocumentsPayload, SendEmailPayload, SendInAppPayload, SendTextPayload, VideoDefaults, VideoLinkOptions };
+export type { CreateDocumentRequestBody, DocuSignSendBody, DocumentSentInfo, DocumentSentMessage, DocumentsPayloadExtras, ExistingEnvelopeSendBody, SendDocumentsPayload, SendEmailPayload, SendInAppAttachment, SendInAppPayload, SendTextPayload, VideoDefaults, VideoLinkOptions };

package/types/forgeroute-ui.d.ts

@@ -1088,7 +1088,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>;
@@ -2206,7 +2206,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<"hidden" | "visible" | "auto">;
+  readonly bodyOverflow: import("@angular/core").InputSignal<"hidden" | "auto" | "visible">;
   /** `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. */
@@ -2590,7 +2590,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" | "metadata" | "auto">;
+  readonly preload: import("@angular/core").InputSignal<"none" | "auto" | "metadata">;
   /** 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>;
@@ -2844,7 +2844,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<2 | 1 | 5 | 3 | 4 | 6 | null>;
+  readonly headingLevel: import("@angular/core").InputSignal<1 | 2 | 3 | 4 | 5 | 6 | null>;
   readonly indeterminate: import("@angular/core").InputSignal<boolean>;
   readonly checked: import("@angular/core").ModelSignal<boolean>;
   /**
@@ -3755,7 +3755,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<2 | 1 | 3>;
+  protected readonly step: import("@angular/core").WritableSignal<1 | 2 | 3>;
   protected readonly mode: import("@angular/core").WritableSignal<PhoneNumberSearchMode>;
   private readonly _zip;
   private readonly _area;
@@ -3869,7 +3869,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" | "primary" | "secondary" | "danger" | "warning" | "ghost" | "ghost-start" | "tab" | "icon" | "icon-danger">;
+  readonly variant: import("@angular/core").InputSignal<"primary" | "secondary" | "danger" | "warning" | "link" | "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' }`). */
@@ -3890,7 +3890,7 @@ export declare class ButtonComponent {
    */
   readonly href: import("@angular/core").InputSignal<string | null>;
   /** Where to open the `href` (`_blank` = a new tab). */
-  readonly target: import("@angular/core").InputSignal<"_blank" | "_self" | "_parent" | "_top" | null>;
+  readonly target: import("@angular/core").InputSignal<"_self" | "_blank" | "_parent" | "_top" | null>;
   /** `rel` of the `href` link. A `_blank` target always gets `noopener noreferrer` added. */
   readonly rel: import("@angular/core").InputSignal<string | null>;
   /** The href when it is allowed (http, https, mailto, tel, sms or a relative URL), else null. */
@@ -3915,7 +3915,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<"button" | "reset" | "submit">;
+  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>;
@@ -4402,7 +4402,7 @@ export declare class ImportSourceGridComponent {
   /** The `value` of the picked source (highlighted). `tile` only: the `card` appearance does not keep a selection. */
   readonly selected: import("@angular/core").InputSignal<string>;
   /** `tile`: the compact buttons of the import window. `card`: one `ui-detail-card` per source with its own select button (used on a page). */
-  readonly appearance: import("@angular/core").InputSignal<"tile" | "card">;
+  readonly appearance: import("@angular/core").InputSignal<"card" | "tile">;
   /** `card`: disables every card's button (for example while the page is saving). */
   readonly disabled: import("@angular/core").InputSignal<boolean>;
   /** `card`: the text of each card's button. */
@@ -4711,7 +4711,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" | "password" | "tel" | "url">;
+  readonly type: import("@angular/core").InputSignal<"number" | "text" | "email" | "tel" | "password" | "url">;
   readonly maxlength: import("@angular/core").InputSignal<number | undefined>;
   readonly required: import("@angular/core").InputSignal<boolean>;
   readonly autocomplete: import("@angular/core").InputSignal<string>;
@@ -4784,7 +4784,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" | "password" | "tel" | "url">;
+  protected readonly _inputType: import("@angular/core").Signal<"number" | "text" | "email" | "tel" | "password" | "url">;
   protected readonly _eyePath: string;
   protected readonly _eyeOffPath: string;
   protected readonly _showRequirements: import("@angular/core").Signal<boolean>;
@@ -6335,7 +6335,7 @@ export declare class FormSectionComponent {
   }, {}, never, ["*"], true, never>;
 }
 export declare class FormRowComponent {
-  readonly cols: import("@angular/core").InputSignal<2 | 1 | 3 | 4>;
+  readonly cols: import("@angular/core").InputSignal<1 | 2 | 3 | 4>;
   static ɵfac: i0.ɵɵFactoryDeclaration<FormRowComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<FormRowComponent, "ui-form-row", never, {
     "cols": {
@@ -6352,7 +6352,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 | "2" | "3" | 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, {
@@ -9293,7 +9293,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<2 | 1 | 5 | 3 | 4 | 6 | null>;
+  readonly headingLevel: import("@angular/core").InputSignal<1 | 2 | 3 | 4 | 5 | 6 | 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. */
@@ -11463,6 +11463,8 @@ export interface SetupWizardTexts {
   importMore: string;
   /** Shown (and described by the disabled Continue) on an import step with `requireImport` until data came in. */
   importRequired: string;
+  /** Shown (and described by the disabled Save & Continue) on an integrations step with `requireConnection` until one integration is connected. */
+  connectRequired: string;
   /** An import where some rows were refused: the warning's title and text (rows that failed must be fixed and imported again before Continue) and the button that returns to the sources. */
   importErrorsTitle: (errors: number) => string;
   importErrorsText: (imported: number, errors: number) => string;
@@ -11539,6 +11541,8 @@ export interface SetupStep {
   ownActions?: boolean;
   import?: SetupImportStep;
   integrations?: SetupIntegration[];
+  /** Integrations steps: Save & Continue stays disabled until at least one of the step's integrations is connected. Skip stays available. */
+  requireConnection?: boolean;
   /** `integrations`: runs when the step is left with Continue (e.g. to save sender settings). */
   onContinue?: () => Observable<unknown> | Promise<unknown> | void;
   /** Called when the step is shown (load data for a custom step). */
@@ -11646,9 +11650,11 @@ export declare class SetupWizardComponent {
   protected readonly narrow: import("@angular/core").WritableSignal<boolean>;
   /** A step with `splitLayout`: the app's own content gets its own card, side by side with the step card on a wide screen. */
   /** An import step with `requireImport` keeps Continue off until something came in (a CSV import or `markCompleted`, e.g. a live sync). */
+  /** An integrations step with `requireConnection` keeps Save & Continue off until at least one of its integrations is connected (Skip stays the way past). */
+  protected readonly connectBlocked: import("@angular/core").Signal<boolean>;
   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<"extra" | "main">;
+  protected readonly splitTab: import("@angular/core").WritableSignal<"main" | "extra">;
   protected readonly splitTabs: import("@angular/core").Signal<{
     key: string;
     label: string;