@forgeroute/ui 0.4.70 → 0.4.72

package/package.json

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

package/src/_animations.scss

@@ -7,8 +7,11 @@
   to { opacity: 1; }
 }
 
-@keyframes rowFadeUp {
-  from { opacity: 0; transform: translateY(6px); }
+// Entrance of the table header and rows: slides up only, it never fades. The header holds the tabs, search and buttons and the rows hold the
+// cell text, so while they fade in (opacity 0 to 1) an accessibility audit run right after render measures half-transparent text and reports a
+// colour-contrast failure that is gone 300ms later. Moving without changing opacity keeps every pixel of text at full contrast at all times.
+@keyframes slideUp {
+  from { transform: translateY(6px); }
 }
 
 @keyframes dotPulse {
@@ -25,13 +28,13 @@
 // Applied automatically by ui-data-table (rows and cards).
 // The stagger is capped at 8 steps (240ms) so a 50-row page never starts its last row ~1.5s late.
 .alive-row {
-  animation: rowFadeUp .3s ease backwards;
+  animation: slideUp .3s ease backwards;
   animation-delay: calc(min(var(--i, 0), 8) * 30ms);
 }
 
 // ── Page/toolbar header ──
 .alive-header {
-  animation: fadeUp .3s ease both;
+  animation: slideUp .3s ease both;
 }
 
 // ── Detail page cards ──

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

@@ -929,6 +929,8 @@ declare function sendDocuSignRequest(http: HttpClient, apiBase: string, body: Do
  * A failure in step 2 leaves the created request as a draft on the server; the error is surfaced like any send error.
  */
 declare function sendDocumentRequest(http: HttpClient, apiBase: string, body: CreateDocumentRequestBody, templateId?: string): Observable<unknown>;
+/** Shown when a bulk send is attempted without the host's send function (a bulk send has no default endpoint). */
+export declare const BULK_NO_SEND_MESSAGE = "Sending to several recipients is not set up for this page, so nothing was sent.";
 /** What the email form sends — the default `POST <baseUrl>/email-messages` body, or the host's `sendFn` argument. */
 interface SendEmailPayload {
   contactName: string;
@@ -936,6 +938,12 @@ interface SendEmailPayload {
   subject: string;
   body: string;
   contactId?: string;
+  /**
+   * Bulk send only (`ui-send-message-panel` `[recipients]`): the eligible recipients (those with an email address) of ONE send; then `contactName`,
+   * `contactEmail` are '' and `contactId` is undefined. The host function sends to every one of them, filling the personal tags
+   * ({{first_name}} …, left as written in `subject` / `body`) per recipient. Absent for a single contact.
+   */
+  recipients?: MessageContact[];
   scheduledAt?: string;
   attachments?: {
     filename: string;
@@ -973,6 +981,14 @@ declare class SendEmailComponent implements OnInit {
   /** The contact's phone — fills `{{phone}}` (a blank phone makes `{{phone}}` a prompted field). */
   readonly contactPhone: import("@angular/core").InputSignal<string>;
   readonly contactId: import("@angular/core").InputSignal<string>;
+  /**
+   * Bulk mode (set by `ui-send-message-panel` `[recipients]`): the ELIGIBLE recipients of one send. Non-null = bulk: no single address is needed or shown,
+   * the personal tags ({{first_name}} …) stay unresolved and do not block Send, `sendFn` is required, and it is called ONCE with `recipients`.
+   */
+  readonly bulkRecipients: import("@angular/core").InputSignal<MessageContact[] | null>;
+  protected readonly bulk: import("@angular/core").Signal<boolean>;
+  /** Tag keys that stay in the text as written (the host fills them per recipient in a bulk send). */
+  protected get deferredKeys(): readonly string[];
   /** Prefills Subject in "Create Message" mode (e.g. "Estimate #1042 — Kitchen Remodel"). */
   readonly defaultSubject: import("@angular/core").InputSignal<string>;
   /** Prefills Message in "Create Message" mode. */
@@ -1036,6 +1052,13 @@ declare class SendEmailComponent implements OnInit {
   /** false hides the Video section (and its picker, `GET /video-messages`). Default true. */
   readonly showVideo: import("@angular/core").InputSignal<boolean>;
   readonly sent: import("@angular/core").OutputEmitterRef<void>;
+  /** Bulk mode: the value the host's `sendFn` returned and the recipients it was called with, emitted just before `sent`. */
+  readonly bulkResult: import("@angular/core").OutputEmitterRef<{
+    result: unknown;
+    recipients: MessageContact[];
+  }>;
+  /** Bulk mode: the recipients of a send that just started (before the request), `null` when that send failed. Lets the panel pin the send and lock its channel toggle. */
+  readonly bulkSending: import("@angular/core").OutputEmitterRef<MessageContact[] | null>;
   readonly emailAdded: import("@angular/core").OutputEmitterRef<string>;
   readonly validChange: import("@angular/core").OutputEmitterRef<boolean>;
   /** A document send was refused because the document / envelope changed meanwhile (404 / 409): the host refreshes its list. */
@@ -1231,6 +1254,11 @@ declare class SendEmailComponent implements OnInit {
       "required": false;
       "isSignal": true;
     };
+    "bulkRecipients": {
+      "alias": "bulkRecipients";
+      "required": false;
+      "isSignal": true;
+    };
     "defaultSubject": {
       "alias": "defaultSubject";
       "required": false;
@@ -1363,6 +1391,8 @@ declare class SendEmailComponent implements OnInit {
     };
   }, {
     "sent": "sent";
+    "bulkResult": "bulkResult";
+    "bulkSending": "bulkSending";
     "emailAdded": "emailAdded";
     "validChange": "validChange";
     "rejected": "rejected";
@@ -1501,6 +1531,12 @@ interface SendTextPayload {
   contactPhone: string;
   body: string;
   contactId?: string;
+  /**
+   * Bulk send only (`ui-send-message-panel` `[recipients]`): the eligible recipients (phone on file, opted in) of ONE send; then `contactName`,
+   * `contactPhone` are '' and `contactId` is undefined. The host function texts every one of them, filling the personal tags ({{first_name}} …,
+   * left as written in `body`) per recipient. Absent for a single contact.
+   */
+  recipients?: MessageContact[];
   scheduledAt?: string;
   mediaUrl?: string;
   mediaType?: string;
@@ -1524,6 +1560,14 @@ declare class SendTextComponent implements OnInit {
   /** The contact's email — fills `{{email}}` (a blank email makes `{{email}}` a prompted field). */
   readonly contactEmail: import("@angular/core").InputSignal<string>;
   readonly contactId: import("@angular/core").InputSignal<string>;
+  /**
+   * Bulk mode (set by `ui-send-message-panel` `[recipients]`): the ELIGIBLE recipients of one send. Non-null = bulk: no single number is needed or shown,
+   * the personal tags ({{first_name}} …) stay unresolved and do not block Send, `sendFn` is required, and it is called ONCE with `recipients`.
+   */
+  readonly bulkRecipients: import("@angular/core").InputSignal<MessageContact[] | null>;
+  protected readonly bulk: import("@angular/core").Signal<boolean>;
+  /** Tag keys that stay in the text as written (the host fills them per recipient in a bulk send). */
+  protected get deferredKeys(): readonly string[];
   /** Prefills Message in "Create Message" mode. */
   readonly defaultBody: import("@angular/core").InputSignal<string>;
   /** Extra merge variables (e.g. `estimate_number`) used in templates and the preview. */
@@ -1573,6 +1617,13 @@ declare class SendTextComponent implements OnInit {
    */
   readonly videoDefaults: import("@angular/core").InputSignal<VideoDefaults | null>;
   readonly sent: import("@angular/core").OutputEmitterRef<void>;
+  /** Bulk mode: the value the host's `sendFn` returned and the recipients it was called with, emitted just before `sent`. */
+  readonly bulkResult: import("@angular/core").OutputEmitterRef<{
+    result: unknown;
+    recipients: MessageContact[];
+  }>;
+  /** Bulk mode: the recipients of a send that just started (before the request), `null` when that send failed. Lets the panel pin the send and lock its channel toggle. */
+  readonly bulkSending: import("@angular/core").OutputEmitterRef<MessageContact[] | null>;
   readonly phoneAdded: import("@angular/core").OutputEmitterRef<string>;
   readonly validChange: import("@angular/core").OutputEmitterRef<boolean>;
   /** A document send was refused because the document / envelope changed meanwhile (404 / 409): the host refreshes its list. */
@@ -1715,6 +1766,11 @@ declare class SendTextComponent implements OnInit {
       "required": false;
       "isSignal": true;
     };
+    "bulkRecipients": {
+      "alias": "bulkRecipients";
+      "required": false;
+      "isSignal": true;
+    };
     "defaultBody": {
       "alias": "defaultBody";
       "required": false;
@@ -1807,6 +1863,8 @@ declare class SendTextComponent implements OnInit {
     };
   }, {
     "sent": "sent";
+    "bulkResult": "bulkResult";
+    "bulkSending": "bulkSending";
     "phoneAdded": "phoneAdded";
     "validChange": "validChange";
     "rejected": "rejected";
@@ -1825,10 +1883,43 @@ export interface MessageContact {
   phone?: string | null;
   smsOptedIn?: boolean | null;
 }
+/** What `sentBulk` emits after a bulk send (`[recipients]`). */
+export interface BulkSentEvent {
+  channel: 'email' | 'text';
+  /** The recipients the host function was called with (the ones that can receive this channel). */
+  recipients: MessageContact[];
+  /** The selected recipients that were left out (no address / not opted in / text not enabled). */
+  skipped: MessageContact[];
+  /** Whatever the host's `sendEmail` / `sendText` observable emitted. */
+  result: unknown;
+}
+/** The hint under the bulk summary: personal tags are not resolved by the panel. */
+export declare const BULK_MERGE_TAG_HINT = "Personal details such as {{first_name}} are filled in for each recipient when sent.";
 export declare class SendMessagePanelComponent {
   readonly open: import("@angular/core").InputSignal<boolean>;
   readonly contact: import("@angular/core").InputSignal<MessageContact | null>;
   readonly loading: import("@angular/core").InputSignal<boolean>;
+  /**
+   * BULK mode: the selected recipients of ONE send. Non-null with at least one entry (one is still bulk) = the panel opens for all of them:
+   * `contact` is ignored, no contact picker / "add an email" form / per-contact notices, the summary shows "To: N <recipientNoun>" and how many
+   * can receive each channel (email = has an email address; text = has a phone, `smsOptedIn === true` and `textEnabled`). Recipients that can't
+   * receive the active channel are skipped and listed. Sending needs the host's `sendEmail` / `sendText` (no default endpoint): called ONCE with
+   * the usual payload plus `recipients` (only the eligible ones; `contactName` / `contactEmail` / `contactPhone` are ''). Personal tags such as
+   * `{{first_name}}` are NOT resolved by the panel (preview shows them as written, Send is not blocked): the host / server fills them per
+   * recipient. The Documents section, the job picker and a single-recipient `documentEnvelope` are off in bulk mode. Outputs: `sent` then `sentBulk`.
+   * Duplicate `id`s are dropped (first wins). `recipientMode="in-app"` is ignored in bulk mode. null (default) or an empty list = the single-contact panel exactly as before.
+   */
+  readonly recipients: import("@angular/core").InputSignal<MessageContact[] | null>;
+  /**
+   * Bulk mode: the channel to start on when the panel opens (a host with separate "Email" and "Text" bulk buttons passes the clicked one). Used only if
+   * somebody can receive that channel; otherwise the usual default applies (email if anybody has an email, else text). null (default) = the usual default.
+   * `textEnabled` must already be known when the panel opens for `'text'` to take effect (bind `[recipients]` after async settings loaded, or re-open).
+   */
+  readonly initialChannel: import("@angular/core").InputSignal<"email" | "text" | null>;
+  /** Bulk mode: the plural noun in "To: 12 residents" (default `recipients`). */
+  readonly recipientNoun: import("@angular/core").InputSignal<string>;
+  /** Bulk mode: the singular noun used when exactly one is selected; empty = the plural without a trailing "s". */
+  readonly recipientNounSingular: import("@angular/core").InputSignal<string>;
   /** Pass true when Twilio / SMS is enabled in the consuming app's settings. */
   readonly textEnabled: import("@angular/core").InputSignal<boolean>;
   /** Panel header. */
@@ -1880,7 +1971,10 @@ export declare class SendMessagePanelComponent {
   readonly showTemplates: import("@angular/core").InputSignal<boolean>;
   /** false hides the Video section (picker, `GET /video-messages`) in the email and text forms. Default true. */
   readonly showVideo: import("@angular/core").InputSignal<boolean>;
+  /** In-app mode is for one contact: it is ignored in bulk mode. */
   protected readonly inApp: import("@angular/core").Signal<boolean>;
+  protected readonly BULK_NO_SEND_MESSAGE = "Sending to several recipients is not set up for this page, so nothing was sent.";
+  protected readonly BULK_MERGE_TAG_HINT = "Personal details such as {{first_name}} are filled in for each recipient when sent.";
   /** false hides Attach Files / Attach Image and "Schedule for later" in both forms (a host `sendEmail` / `sendText` that can't deliver them). */
   readonly attachmentsAndScheduling: import("@angular/core").InputSignal<boolean>;
   /** Purposes the app's backend supports for documents (default all three); `['ESIGN']` hides the purpose select. */
@@ -1949,6 +2043,43 @@ export declare class SendMessagePanelComponent {
   readonly videoDefaults: import("@angular/core").InputSignal<VideoDefaults | null>;
   /** The Documents section is shown only when the host turned it on AND the user may send documents. */
   protected readonly documentsOn: import("@angular/core").Signal<boolean>;
+  /** `recipients` without duplicates (same `id`: the first wins); every count, payload and `sentBulk` uses this list. */
+  readonly bulkList: import("@angular/core").Signal<MessageContact[]>;
+  /** True when `recipients` holds at least one entry (the single-contact panel otherwise). */
+  readonly bulkMode: import("@angular/core").Signal<boolean>;
+  /** Recipients that can get the email: have a non-blank email address (the format is not checked). */
+  readonly emailRecipients: import("@angular/core").Signal<MessageContact[]>;
+  /** Recipients that can get the text: text enabled, a phone on file and `smsOptedIn === true` (unknown consent is NOT texted, like the single-contact panel). */
+  readonly textRecipients: import("@angular/core").Signal<MessageContact[]>;
+  private readonly activeRecipients;
+  /** The selected recipients the active channel leaves out. */
+  readonly skippedRecipients: import("@angular/core").Signal<MessageContact[]>;
+  readonly bulkNoneEligible: import("@angular/core").Signal<boolean>;
+  /** A bulk send has no default endpoint: the host's function for the active channel is required. */
+  readonly bulkMissingSend: import("@angular/core").Signal<boolean>;
+  readonly bulkBlocked: import("@angular/core").Signal<boolean>;
+  protected readonly hasTarget: import("@angular/core").Signal<boolean>;
+  /** True from the moment a bulk send starts until it succeeds or fails: the channel is locked so the form is not destroyed mid-request. */
+  readonly sending: import("@angular/core").WritableSignal<boolean>;
+  private submitSnapshot;
+  protected readonly recipientWord: import("@angular/core").Signal<string>;
+  private skippedReason;
+  private skippedNames;
+  readonly skippedText: import("@angular/core").Signal<string>;
+  readonly noneEligibleText: import("@angular/core").Signal<string>;
+  /** The one live-region sentence (the alerts are quiet): how many are selected, who can get the active channel and who is skipped. */
+  readonly bulkAnnouncement: import("@angular/core").Signal<string>;
+  /** The eligible recipients handed to the form of a channel (null outside bulk mode). */
+  bulkRecipientsFor(ch: 'email' | 'text'): MessageContact[] | null;
+  /** A bulk send started (the form's recipients) or failed (`null`): pins who was selected / sent to at that moment and locks the channel. */
+  onBulkSending(sent: MessageContact[] | null): void;
+  /** Forgets a bulk send in flight (no `sentBulk` follows): unlocks the channel and drops the snapshot and any stale result. */
+  private resetBulkSend;
+  onBulkResult(e: {
+    result: unknown;
+    recipients: MessageContact[];
+  }): void;
+  private lastBulkResult;
   /**
    * Shows an optional "Job" search under the contact (off by default): the sender may link the message to one of the
    * company's jobs (found with the host's `jobSearch` function). The pick is reported through `jobSelected`; it is cleared whenever the
@@ -1969,6 +2100,8 @@ export declare class SendMessagePanelComponent {
   } | null>;
   readonly closed: import("@angular/core").OutputEmitterRef<void>;
   readonly sent: import("@angular/core").OutputEmitterRef<void>;
+  /** Bulk mode: emitted right after `sent` with what was sent, who was skipped and the host function's result. */
+  readonly sentBulk: import("@angular/core").OutputEmitterRef<BulkSentEvent>;
   readonly emailAdded: import("@angular/core").OutputEmitterRef<string>;
   /** A document / envelope send was refused because it changed meanwhile (404 / 409): the host refreshes its list. */
   readonly rejected: import("@angular/core").OutputEmitterRef<void>;
@@ -2027,6 +2160,26 @@ export declare class SendMessagePanelComponent {
       "required": false;
       "isSignal": true;
     };
+    "recipients": {
+      "alias": "recipients";
+      "required": false;
+      "isSignal": true;
+    };
+    "initialChannel": {
+      "alias": "initialChannel";
+      "required": false;
+      "isSignal": true;
+    };
+    "recipientNoun": {
+      "alias": "recipientNoun";
+      "required": false;
+      "isSignal": true;
+    };
+    "recipientNounSingular": {
+      "alias": "recipientNounSingular";
+      "required": false;
+      "isSignal": true;
+    };
     "textEnabled": {
       "alias": "textEnabled";
       "required": false;
@@ -2241,12 +2394,49 @@ export declare class SendMessagePanelComponent {
     "jobSelected": "jobSelected";
     "closed": "closed";
     "sent": "sent";
+    "sentBulk": "sentBulk";
     "emailAdded": "emailAdded";
     "rejected": "rejected";
     "mapFieldsClick": "mapFieldsClick";
     "phoneAdded": "phoneAdded";
   }, never, never, true, never>;
 }
+/**
+ * Merge-tag helpers shared by the email and text forms, so the Preview pane, the "View Send Preview" modal and the
+ * sent payload all come from the same values.
+ *
+ * Rules:
+ *  - A tag is `{{key}}` (inner spaces allowed: `{{ key }}`); `key` is letters, digits, `_` and `.`.
+ *  - A value counts only when it is non-blank: a blank contact field, market value or `context` entry never
+ *    resolves a tag — the form asks for it instead.
+ *  - Anything still shaped like `{{…}}` after merging blocks sending (the server answers such a body with a 400).
+ */
+/** Every distinct tag key in `text`, in order of first appearance. */
+declare function mergeTagKeys(text: string): string[];
+/** Replaces each tag that has a non-blank value in `values`; other tags are left as written. */
+declare function applyMergeTags(text: string, values: Record<string, string>): string;
+/**
+ * Tags that describe ONE recipient. In a bulk send (several recipients) the form cannot fill them: they stay in the text as written, are
+ * never prompted for and do not block Send; the host / server fills them per recipient.
+ */
+export declare const PERSONAL_TAG_KEYS: readonly string[];
+/**
+ * True while `text` still contains anything shaped like `{{…}}`. Tags whose key is in `ignoreKeys` (a bulk send's per-recipient tags) do not count.
+ */
+declare function hasLeftoverTags(text: string, ignoreKeys?: readonly string[]): boolean;
+/** Copies only the non-blank entries of each source, later sources winning. */
+declare function nonBlankValues(...sources: Record<string, unknown>[]): Record<string, string>;
+/** The current date variables (`month`, `year`, `date`, `today`). */
+declare function dateVars(now?: Date): Record<string, string>;
+/**
+ * Market variables from the `/service-areas` page: the primary area (or the first one). Only values the server
+ * actually returned are kept — with no areas (or a blank value) the tag stays a prompted field.
+ */
+declare function marketVarsFrom(resp: {
+  content?: any[];
+} | null | undefined): Record<string, string>;
+/** Turns a key like `job_name` into the missing-field label "Job Name". */
+declare function formatVarLabel(key: string): string;
 /**
  * ui-document-signers — the signer section of a document send: one required contact per customer signer role of the chosen document
  * (Signer 1 is the recipient, shown read-only) in signing order, and the one read-only countersign line.

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

@@ -1,6 +1,7 @@
 import * as i0 from "@angular/core";
-import { DestroyRef, InjectionToken, Provider, WritableSignal } from "@angular/core";
+import { DestroyRef, InjectionToken, Provider, TemplateRef, WritableSignal } from "@angular/core";
 import { Observable } from "rxjs";
+import { HostResult, PaymentAllocation, PaymentMethodBodyContext, PaymentMethodPlugin, PaymentPluginMethod } from "@forgeroute/ui";
 /**
  * The small part of Stripe.js the library calls, written as plain structural types so the library has NO compile-time or run-time
  * dependency on `@stripe/stripe-js` outside of the lazy loader (`stripe-loader.ts`). The real `Stripe` object satisfies these; so does a hand-written fake.
@@ -1410,4 +1411,162 @@ export declare class StripeConnectComponent {
     "loading": "loadingChange";
   }, never, never, true, never>;
 }
-export type { HandleReturnOptions, MicrodepositStartedBy, MicrodepositStepsContext, MicrodepositType, MicrodepositVerifyData, MicrodepositVerifyEvent, ProvideStripePaymentOptions, StripeA11yMessages, StripeAppearance, StripeBillingDetails, StripeConfirmResult, StripeConfirmedEvent, StripeConnectAccount, StripeConnectFlowOptions, StripeConnectOutcome, StripeConnectState, StripeConnectStatus, StripeConnection, StripeCreateIntentFn, StripeDeferredIntent, StripeElementChange, StripeElementsLike, StripeErrorDisplay, StripeErrorLike, StripeErrorMessageOptions, StripeFailure, StripeFailureStage, StripeIntentKind, StripeIntentLike, StripeLike, StripeLikeWithBankSetup, StripeLoadOptions, StripeLoaderFn, StripeMicrodepositNextAction, StripeMicrodepositResult, StripeOutcome, StripePaymentDefaults, StripePaymentElementLike, StripeReadyEvent, StripeReturnParams, StripeReturnResult, StripeVerification };
+/** What the host's `createIntent` receives: the entered payment and how it is applied to charges. */
+interface StripeIntentContext extends PaymentAllocation {
+  /** The amount the payer owes (before processing fees), in major units (12.5 = $12.50). */
+  amount: number;
+  /** The method value that was selected (`'CARD'` / `'ACH'`). */
+  paymentMethod: string;
+  /** Stripe's name of it: `'card'` or `'us_bank_account'`. */
+  paymentMethodType: 'card' | 'us_bank_account';
+  receivedDate: string;
+  notes: string | null;
+}
+/** What the host's `createIntent` answers. Fees are optional; when given they are shown as rows under the form. */
+interface StripeIntentInfo {
+  clientSecret: string;
+  paymentIntentId: string;
+  stripeFee?: number;
+  platformFee?: number;
+  totalAmount?: number;
+  /** Connect account of a direct charge (passed back to `finalize` / `cancel`). `[stripeAccount]` of the plugin must already be this account: Stripe.js is loaded for it before the form shows. */
+  stripeAccountId?: string | null;
+  /** Shown after "Processing fee" / "Platform fee", e.g. `'2.9% + $0.30'`. */
+  stripeFeeLabel?: string;
+  platformFeeLabel?: string;
+}
+/** The fees of a payment, shown before the payer pays (the host's `estimateFees`) or after the intent exists. */
+interface StripeFees {
+  stripeFee?: number;
+  platformFee?: number;
+  /** What the payer is charged (amount + fees). The Payment Element is created with this amount, so it MUST equal the intent's amount. */
+  totalAmount?: number;
+  stripeFeeLabel?: string;
+  platformFeeLabel?: string;
+}
+interface StripeFeeContext {
+  amount: number;
+  paymentMethod: string;
+  paymentMethodType: 'card' | 'us_bank_account';
+}
+export declare const STRIPE_PAYMENT_METHODS: readonly [{
+  readonly value: "CARD";
+  readonly label: "Card";
+}, {
+  readonly value: "ACH";
+  readonly label: "ACH / Bank Transfer";
+}];
+declare const stripeMethodType: (method: string) => "card" | "us_bank_account";
+export declare const STRIPE_METHOD_TEXTS: {
+  readonly amountNeeded: "Enter an amount to continue.";
+  readonly notCompleted: "Payment was not completed. Please try again or choose another method.";
+  readonly achTitle: "ACH Payment Submitted";
+  readonly achMessage: (amount: string) => string;
+  readonly verificationTitle: "Bank Verification Needed";
+  readonly verificationMessage: (amount: string) => string;
+  readonly receiptNote: "A receipt is sent once the payment has been fully processed and settled.";
+};
+/**
+ * Adds LIVE Card and ACH (Stripe) to `ui-payment-side-panel`. Put it inside the panel only for customers who use Stripe: its presence replaces the
+ * record-only Card / ACH (last 4 digits) with the Payment Element; remove it and the panel is record-only again.
+ *
+ *   <ui-payment-side-panel ...>
+ *     @if (stripeEnabled()) {
+ *       <ui-payment-stripe-method [publishableKey]="key" [createIntent]="createIntent" [finalize]="finalize" [cancel]="cancel" />
+ *     }
+ *   </ui-payment-side-panel>
+ *
+ * The host owns the HTTP: `createIntent(ctx)` (POST create-payment-intent) answers `{ clientSecret, paymentIntentId, fees... }`, `finalize(info)` (POST
+ * process-payment) runs after Stripe took the payment, `cancel(info)` cancels an abandoned intent. Outcomes arrive as the panel's `outcome` events with
+ * kind `'plugin'` and codes `paid`, `processing`, `verification`, `finalize-failed` and `failed`.
+ */
+export declare class StripePaymentMethodComponent extends PaymentMethodPlugin {
+  protected readonly self: this;
+  /** Creates the PaymentIntent on the host's backend (called when the payer presses Pay). */
+  readonly createIntent: import("@angular/core").InputSignal<((ctx: StripeIntentContext) => HostResult<StripeIntentInfo>) | null>;
+  /** Records the payment after Stripe accepted it (succeeded, processing or needs bank verification). A failure here is reported, the payment still counts as taken. */
+  readonly finalize: import("@angular/core").InputSignal<((info: StripeIntentInfo) => HostResult<unknown>) | null>;
+  /** Cancels an intent that was created but not paid (panel closed, another method, a retry). */
+  readonly cancel: import("@angular/core").InputSignal<((info: StripeIntentInfo) => HostResult<unknown>) | null>;
+  /** Optional fee preview before paying; its `totalAmount` becomes the amount of the Payment Element (it must equal the intent's amount). */
+  readonly estimateFees: import("@angular/core").InputSignal<((ctx: StripeFeeContext) => HostResult<StripeFees>) | null>;
+  readonly publishableKey: import("@angular/core").InputSignal<string | null>;
+  /** Connect account for direct charges; Stripe.js is loaded for it. */
+  readonly stripeAccount: import("@angular/core").InputSignal<string | null>;
+  readonly billingDetails: import("@angular/core").InputSignal<StripeBillingDetails | null>;
+  readonly appearance: import("@angular/core").InputSignal<Record<string, unknown> | null>;
+  /** The methods this plugin takes over (default: Card and ACH / Bank Transfer). Pass `[{ value: 'CARD', label: 'Card' }]` for cards only. */
+  readonly methodList: import("@angular/core").InputSignal<readonly PaymentPluginMethod[]>;
+  /** How long a fee estimate may take before Pay is released and "Try again" is offered (ms). */
+  readonly estimateTimeoutMs: import("@angular/core").InputSignal<number>;
+  /** The payer covers fees, so the intent amount is payment + fees: a rejected or empty estimate keeps Pay off (with "Try again") instead of falling back to the base amount, which Stripe would reject as a mismatch. */
+  readonly feesRequired: import("@angular/core").InputSignal<boolean>;
+  readonly receiptNote: import("@angular/core").InputSignal<string>;
+  private readonly body;
+  readonly methods: import("@angular/core").InputSignal<readonly PaymentPluginMethod[]>;
+  readonly template: import("@angular/core").Signal<TemplateRef<PaymentMethodBodyContext> | undefined>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<StripePaymentMethodComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<StripePaymentMethodComponent, "ui-payment-stripe-method", never, {
+    "createIntent": {
+      "alias": "createIntent";
+      "required": false;
+      "isSignal": true;
+    };
+    "finalize": {
+      "alias": "finalize";
+      "required": false;
+      "isSignal": true;
+    };
+    "cancel": {
+      "alias": "cancel";
+      "required": false;
+      "isSignal": true;
+    };
+    "estimateFees": {
+      "alias": "estimateFees";
+      "required": false;
+      "isSignal": true;
+    };
+    "publishableKey": {
+      "alias": "publishableKey";
+      "required": false;
+      "isSignal": true;
+    };
+    "stripeAccount": {
+      "alias": "stripeAccount";
+      "required": false;
+      "isSignal": true;
+    };
+    "billingDetails": {
+      "alias": "billingDetails";
+      "required": false;
+      "isSignal": true;
+    };
+    "appearance": {
+      "alias": "appearance";
+      "required": false;
+      "isSignal": true;
+    };
+    "methodList": {
+      "alias": "methodList";
+      "required": false;
+      "isSignal": true;
+    };
+    "estimateTimeoutMs": {
+      "alias": "estimateTimeoutMs";
+      "required": false;
+      "isSignal": true;
+    };
+    "feesRequired": {
+      "alias": "feesRequired";
+      "required": false;
+      "isSignal": true;
+    };
+    "receiptNote": {
+      "alias": "receiptNote";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}
+export type { HandleReturnOptions, MicrodepositStartedBy, MicrodepositStepsContext, MicrodepositType, MicrodepositVerifyData, MicrodepositVerifyEvent, ProvideStripePaymentOptions, StripeA11yMessages, StripeAppearance, StripeBillingDetails, StripeConfirmResult, StripeConfirmedEvent, StripeConnectAccount, StripeConnectFlowOptions, StripeConnectOutcome, StripeConnectState, StripeConnectStatus, StripeConnection, StripeCreateIntentFn, StripeDeferredIntent, StripeElementChange, StripeElementsLike, StripeErrorDisplay, StripeErrorLike, StripeErrorMessageOptions, StripeFailure, StripeFailureStage, StripeFeeContext, StripeFees, StripeIntentContext, StripeIntentInfo, StripeIntentKind, StripeIntentLike, StripeLike, StripeLikeWithBankSetup, StripeLoadOptions, StripeLoaderFn, StripeMicrodepositNextAction, StripeMicrodepositResult, StripeOutcome, StripePaymentDefaults, StripePaymentElementLike, StripeReadyEvent, StripeReturnParams, StripeReturnResult, StripeVerification };