@forgeroute/ui 0.4.78 → 0.4.79

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

@@ -1,6 +1,7 @@
 import * as i0 from "@angular/core";
 import { EnvironmentProviders, InjectionToken } from "@angular/core";
 import { PDFDocumentProxy } from "pdfjs-dist";
+import { UiLabelsService } from "@forgeroute/ui";
 /** Where pdf.js finds its worker script. Provide it once in the app (`{ provide: PDF_VIEWER_WORKER_SRC, useValue: '/assets/pdf.worker.min.mjs' }`). */
 export declare const PDF_VIEWER_WORKER_SRC: InjectionToken<string>;
 /** Colour of an overlay badge. */
@@ -143,6 +144,7 @@ export declare class PdfViewerUnsupportedError extends Error {
  *   package (the same trade-off as `@forgeroute/ui/charts` and chart.js).
  */
 export declare class PdfViewerComponent {
+  protected readonly labels: UiLabelsService;
   /** PDF URL. Ignored while `data` is set. */
   readonly src: import("@angular/core").InputSignal<string | null>;
   /** PDF bytes. Wins over `src`. */
@@ -161,12 +163,16 @@ export declare class PdfViewerComponent {
   readonly hotspots: import("@angular/core").InputSignal<PdfViewerHotspot[]>;
   /** Accessible name of the viewer. */
   readonly ariaLabel: import("@angular/core").InputSignal<string>;
-  readonly loadingText: import("@angular/core").InputSignal<string>;
-  readonly errorText: import("@angular/core").InputSignal<string>;
+  readonly loadingTextInput: import("@angular/core").InputSignal<string | null>;
+  readonly loadingText: import("@angular/core").Signal<string>;
+  readonly errorTextInput: import("@angular/core").InputSignal<string | null>;
+  readonly errorText: import("@angular/core").Signal<string>;
   /** Shown when the browser cannot run pdf.js (see `checkBrowserSupport`). */
-  readonly unsupportedText: import("@angular/core").InputSignal<string>;
+  readonly unsupportedTextInput: import("@angular/core").InputSignal<string | null>;
+  readonly unsupportedText: import("@angular/core").Signal<string>;
   /** Text of the link that opens `src` in a new tab on such a browser. */
-  readonly openText: import("@angular/core").InputSignal<string>;
+  readonly openTextInput: import("@angular/core").InputSignal<string | null>;
+  readonly openText: import("@angular/core").Signal<string>;
   /** Check for the browser features pdf.js needs before loading it; false = always try to load. */
   readonly checkBrowserSupport: import("@angular/core").InputSignal<boolean>;
   /** The id of the hotspot that was clicked (only a `ready` hotspot can be). */
@@ -270,22 +276,22 @@ export declare class PdfViewerComponent {
       "required": false;
       "isSignal": true;
     };
-    "loadingText": {
+    "loadingTextInput": {
       "alias": "loadingText";
       "required": false;
       "isSignal": true;
     };
-    "errorText": {
+    "errorTextInput": {
       "alias": "errorText";
       "required": false;
       "isSignal": true;
     };
-    "unsupportedText": {
+    "unsupportedTextInput": {
       "alias": "unsupportedText";
       "required": false;
       "isSignal": true;
     };
-    "openText": {
+    "openTextInput": {
       "alias": "openText";
       "required": false;
       "isSignal": true;
@@ -327,16 +333,19 @@ export declare function provideForgeroutePdf(options: ForgeroutePdfOptions): Env
  * Test ids: `document-viewer`, `document-viewer-download`, `document-viewer-print`, `document-viewer-loading`, `document-viewer-error`.
  */
 export declare class DocumentViewerModalComponent {
+  protected readonly labels: UiLabelsService;
   readonly open: import("@angular/core").InputSignal<boolean>;
   /** Shown as the dialog title and used as the Download file name. */
-  readonly fileName: import("@angular/core").InputSignal<string>;
+  readonly fileNameInput: import("@angular/core").InputSignal<string | null>;
+  readonly fileName: import("@angular/core").Signal<string>;
   /** The PDF bytes (null until fetched). */
   readonly data: import("@angular/core").InputSignal<ArrayBuffer | Uint8Array<ArrayBufferLike> | null>;
   /** The host is still fetching the bytes: a skeleton shows. */
   readonly loading: import("@angular/core").InputSignal<boolean>;
   /** The host's message when the fetch failed (empty = no error). */
   readonly error: import("@angular/core").InputSignal<string>;
-  readonly loadingText: import("@angular/core").InputSignal<string>;
+  readonly loadingTextInput: import("@angular/core").InputSignal<string | null>;
+  readonly loadingText: import("@angular/core").Signal<string>;
   readonly closed: import("@angular/core").OutputEmitterRef<void>;
   protected readonly hasData: import("@angular/core").Signal<boolean>;
   private blob;
@@ -351,7 +360,7 @@ export declare class DocumentViewerModalComponent {
       "required": false;
       "isSignal": true;
     };
-    "fileName": {
+    "fileNameInput": {
       "alias": "fileName";
       "required": false;
       "isSignal": true;
@@ -371,7 +380,7 @@ export declare class DocumentViewerModalComponent {
       "required": false;
       "isSignal": true;
     };
-    "loadingText": {
+    "loadingTextInput": {
       "alias": "loadingText";
       "required": false;
       "isSignal": true;
@@ -443,6 +452,7 @@ export interface DocumentSignTexts {
  * `redraw-signature`, `apply-step`, `sign-progress`, `sign-cancel`, `sign-complete`, `pdf-hotspot-<field id>`.
  */
 export declare class DocumentSignModalComponent {
+  protected readonly labels: UiLabelsService;
   readonly open: import("@angular/core").InputSignal<boolean>;
   /** The PDF bytes (null until the host has them). */
   readonly data: import("@angular/core").InputSignal<ArrayBuffer | Uint8Array<ArrayBufferLike> | null>;
@@ -467,6 +477,8 @@ export declare class DocumentSignModalComponent {
   /** The dialog was dismissed (Cancel, Escape, X, backdrop). */
   readonly closed: import("@angular/core").OutputEmitterRef<void>;
   protected readonly t: import("@angular/core").Signal<DocumentSignTexts>;
+  /** Accessible name of the Change button: the dictionary's "Change signature" by default; when the host replaced the visible text ("Redo") it is that text + "signature" (as before the dictionary), so the name still contains what is shown. */
+  protected readonly changeAriaLabel: import("@angular/core").Signal<string>;
   protected readonly typedName: import("@angular/core").WritableSignal<string>;
   protected readonly signature: import("@angular/core").WritableSignal<string | null>;
   /** Field id -> the image applied to it. */

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

@@ -1,7 +1,7 @@
 import * as i0 from "@angular/core";
 import { DestroyRef, InjectionToken, Provider, TemplateRef, WritableSignal } from "@angular/core";
+import { HostResult, PaymentAllocation, PaymentMethodBodyContext, PaymentMethodPlugin, PaymentPluginMethod, UiLabelsService } from "@forgeroute/ui";
 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.
@@ -224,7 +224,8 @@ export declare function outcomeOf(intent: StripeIntentLike): StripeOutcome;
 export declare function normalizeIntent(kind: StripeIntentKind, intent: StripeIntentLike): StripeConfirmedEvent;
 /** A failure from a Stripe error, with the text to show chosen by `display` (see `getStripeErrorMessage`). */
 declare function failureFromError(error: StripeErrorLike | null | undefined, stage: StripeFailureStage, options?: StripeErrorMessageOptions): StripeFailure;
-/** A failure that is not a Stripe error (our own text). */
+/** Our own fixed messages ("Payment system not initialized" ...) in the app's active language; any other text (Stripe's, a host's) is returned as it is. */
+declare function localizeStripeMessage(message: string): string;
 declare function failure(code: string, message: string, stage: StripeFailureStage, stripeMessage?: string): StripeFailure;
 /** An error thrown by a host callback or a request: its own `error.error.message` (HTTP body), `message`, else the fallback. */
 declare function messageOfThrown(err: unknown, fallback: string): string;
@@ -334,6 +335,7 @@ interface StripeA11yMessages {
   verificationNeeded: string;
   actionRequired: string;
 }
+/** The screen-reader messages of the payment form; read on every access, so they follow the app's active language. */
 export declare const STRIPE_A11Y_MESSAGES: Readonly<StripeA11yMessages>;
 /** The exact text shown while the bank-account tab is selected. */
 export declare const STRIPE_ACH_NOTICE = "Signing in to your bank account lets you pay right away. Entering your routing and account numbers instead requires verification with two small deposits, which typically take a couple of days to arrive in your account.";
@@ -384,6 +386,7 @@ interface StripeReadyEvent {
  * Every Stripe.js call and option reproduces what the CRM apps do today; see docs/stripe.md ("Parity with the existing app implementations").
  */
 export declare class StripePaymentComponent {
+  protected readonly labels: UiLabelsService;
   private readonly loader;
   private readonly defaults;
   private readonly doc;
@@ -453,7 +456,8 @@ export declare class StripePaymentComponent {
   /** The host is still creating the intent: show the loading skeleton. */
   readonly pending: import("@angular/core").InputSignal<boolean>;
   /** Accessible name of the payment form (also its visible heading when `required` is set). */
-  readonly label: import("@angular/core").InputSignal<string>;
+  readonly labelInput: import("@angular/core").InputSignal<string | null>;
+  readonly label: import("@angular/core").Signal<string>;
   /** The payment details are required (a required wizard step): a visible heading with a red asterisk is shown above the form. Not shown in `mountOnly` mode. */
   readonly required: import("@angular/core").InputSignal<boolean>;
   /** The `id` of the element container (an app's e2e selector such as `#payment-element`). */
@@ -462,7 +466,8 @@ export declare class StripePaymentComponent {
   readonly mountClass: import("@angular/core").InputSignal<string>;
   /** Show the bank-account notice while that tab is selected. */
   readonly showAchNotice: import("@angular/core").InputSignal<boolean>;
-  readonly achNotice: import("@angular/core").InputSignal<string>;
+  readonly achNoticeInput: import("@angular/core").InputSignal<string | null>;
+  readonly achNotice: import("@angular/core").Signal<string>;
   /** The `data-testid` of the notice (an app's existing e2e selector, e.g. `ach-setup-notice`). */
   readonly achNoticeTestId: import("@angular/core").InputSignal<string>;
   /** The payment method type the host shows before Stripe reports one (cremo: `'card'`); `paymentMethodTypeChange` fires only when the reported type differs from it (or from the last report). */
@@ -479,7 +484,8 @@ export declare class StripePaymentComponent {
   readonly errorFallbackByStage: import("@angular/core").InputSignal<Partial<Record<StripeFailureStage, string>> | null>;
   /** Replacement texts by code: Stripe error codes AND the library's own failure codes (`not_initialized`, `no_payment_method`, `requires_payment_method`, `not_completed`, `authentication_failed`, ...). `{status}` in a text becomes Stripe's status of the intent ("Unexpected payment status: {status}"). */
   readonly errorMessages: import("@angular/core").InputSignal<Record<string, string> | null>;
-  readonly loadErrorMessage: import("@angular/core").InputSignal<string>;
+  readonly loadErrorMessageInput: import("@angular/core").InputSignal<string | null>;
+  readonly loadErrorMessage: import("@angular/core").Signal<string>;
   /** Texts of the screen-reader status region (translate them); missing keys keep the English defaults. */
   readonly a11yMessages: import("@angular/core").InputSignal<Partial<StripeA11yMessages> | null>;
   /**
@@ -750,7 +756,7 @@ export declare class StripePaymentComponent {
       "required": false;
       "isSignal": true;
     };
-    "label": {
+    "labelInput": {
       "alias": "label";
       "required": false;
       "isSignal": true;
@@ -775,7 +781,7 @@ export declare class StripePaymentComponent {
       "required": false;
       "isSignal": true;
     };
-    "achNotice": {
+    "achNoticeInput": {
       "alias": "achNotice";
       "required": false;
       "isSignal": true;
@@ -820,7 +826,7 @@ export declare class StripePaymentComponent {
       "required": false;
       "isSignal": true;
     };
-    "loadErrorMessage": {
+    "loadErrorMessageInput": {
       "alias": "loadErrorMessage";
       "required": false;
       "isSignal": true;
@@ -843,20 +849,21 @@ export declare class StripePaymentComponent {
 /** How a bank account added with micro-deposits is verified: two deposit amounts, the code of one deposit, or the bank is still confirming it. */
 type MicrodepositType = 'amounts' | 'descriptor_code' | 'processing';
 /** The text of the pending-verification card, in one place for the component and its tests. */
+/** The text of the pending-verification card; read on every access, so it follows the app's active language. */
 export declare const MICRODEPOSIT_COPY: {
-  readonly title: "Bank account waiting for verification";
-  readonly processingTitle: "Bank account being confirmed";
-  readonly processing: "Your bank is confirming this account; this usually takes up to a few business days. We will email you when it is ready.";
-  readonly cannotPay: "Until then this account can't be used to pay invoices.";
-  readonly readOnly: "An administrator of your organization can finish the verification.";
-  readonly keepsActive: "Your current payment method stays active until the new bank account is verified.";
-  readonly cancelTitle: "Cancel verification";
-  readonly verifyLabel: "Verify bank account";
-  readonly cancelBase: "Cancel the verification of this bank account? It will not be saved as a payment method and you can add it again later.";
-  readonly cancelKeepsActive: " Your current payment method stays active.";
-  readonly cancelNoOther: " You have no other payment method saved.";
-  readonly tooManyAttempts: "Too many failed attempts. Please try again later or contact support.";
-  readonly codeRequired: "Enter the 6-character code.";
+  readonly title: string;
+  readonly processingTitle: string;
+  readonly processing: string;
+  readonly cannotPay: string;
+  readonly readOnly: string;
+  readonly keepsActive: string;
+  readonly cancelTitle: string;
+  readonly verifyLabel: string;
+  readonly cancelBase: string;
+  readonly cancelKeepsActive: string;
+  readonly cancelNoOther: string;
+  readonly tooManyAttempts: string;
+  readonly codeRequired: string;
 };
 /** "June 5, 2026" in UTC: the arrival date is a calendar day. Empty for no / an invalid date. */
 export declare function microdepositArrivalText(iso: string | null | undefined): string;
@@ -917,6 +924,7 @@ export declare function microdepositCancelMessage(options?: {
  *     [verifying]="busy()" [errorText]="error()" (verify)="verify($event)" (cancelVerification)="cancel()" />
  */
 export declare class MicrodepositVerifyComponent {
+  protected readonly labels: UiLabelsService;
   private readonly service;
   /** `'amounts'` (two deposits), `'descriptor_code'` (one deposit with a code) or `'processing'` (the bank is still confirming; nothing to enter). */
   readonly type: import("@angular/core").InputSignal<MicrodepositType>;
@@ -972,19 +980,19 @@ export declare class MicrodepositVerifyComponent {
   /** Stripe.js mode: a verification attempt failed (the text is already shown). */
   readonly verifyFailed: import("@angular/core").OutputEmitterRef<StripeMicrodepositResult>;
   readonly copy: {
-    readonly title: "Bank account waiting for verification";
-    readonly processingTitle: "Bank account being confirmed";
-    readonly processing: "Your bank is confirming this account; this usually takes up to a few business days. We will email you when it is ready.";
-    readonly cannotPay: "Until then this account can't be used to pay invoices.";
-    readonly readOnly: "An administrator of your organization can finish the verification.";
-    readonly keepsActive: "Your current payment method stays active until the new bank account is verified.";
-    readonly cancelTitle: "Cancel verification";
-    readonly verifyLabel: "Verify bank account";
-    readonly cancelBase: "Cancel the verification of this bank account? It will not be saved as a payment method and you can add it again later.";
-    readonly cancelKeepsActive: " Your current payment method stays active.";
-    readonly cancelNoOther: " You have no other payment method saved.";
-    readonly tooManyAttempts: "Too many failed attempts. Please try again later or contact support.";
-    readonly codeRequired: "Enter the 6-character code.";
+    readonly title: string;
+    readonly processingTitle: string;
+    readonly processing: string;
+    readonly cannotPay: string;
+    readonly readOnly: string;
+    readonly keepsActive: string;
+    readonly cancelTitle: string;
+    readonly verifyLabel: string;
+    readonly cancelBase: string;
+    readonly cancelKeepsActive: string;
+    readonly cancelNoOther: string;
+    readonly tooManyAttempts: string;
+    readonly codeRequired: string;
   };
   readonly first: import("@angular/core").WritableSignal<string | number>;
   readonly second: import("@angular/core").WritableSignal<string | number>;
@@ -1266,6 +1274,7 @@ export declare function stripeConnectNotice(outcome: StripeConnectOutcome): {
  * where `createAccount = () => http.post<StripeConnectAccount>('/connect/create', {})` and `getStatus = () => http.get<StripeConnectStatus>('/connect/status')`.
  */
 export declare class StripeConnectComponent {
+  protected readonly labels: UiLabelsService;
   private readonly destroyRef;
   private readonly injector;
   private readonly host;
@@ -1279,14 +1288,18 @@ export declare class StripeConnectComponent {
   readonly complete: import("@angular/core").ModelSignal<boolean>;
   /** The details were submitted and Stripe is reviewing them. Two-way: set by `check()` / `resume()`. */
   readonly detailsSubmitted: import("@angular/core").ModelSignal<boolean>;
-  readonly title: import("@angular/core").InputSignal<string>;
+  readonly titleInput: import("@angular/core").InputSignal<string | null>;
+  readonly title: import("@angular/core").Signal<string>;
   /** No card around the content: the text and the button sit directly in the host's own card (the setup wizard's step card). `title` is not shown then. */
   readonly bare: import("@angular/core").InputSignal<boolean>;
   /** Shows the card (with "Set Up Payment Account") while there is no account yet. Default false: hosts with their own entry point show nothing and call `start()`. */
   readonly showWhenNoAccount: import("@angular/core").InputSignal<boolean>;
-  readonly startTitle: import("@angular/core").InputSignal<string>;
-  readonly startText: import("@angular/core").InputSignal<string>;
-  readonly startLabel: import("@angular/core").InputSignal<string>;
+  readonly startTitleInput: import("@angular/core").InputSignal<string | null>;
+  readonly startTitle: import("@angular/core").Signal<string>;
+  readonly startTextInput: import("@angular/core").InputSignal<string | null>;
+  readonly startText: import("@angular/core").Signal<string>;
+  readonly startLabelInput: import("@angular/core").InputSignal<string | null>;
+  readonly startLabel: import("@angular/core").Signal<string>;
   /** The buttons cannot be pressed (a read-only user). */
   readonly disabled: import("@angular/core").InputSignal<boolean>;
   /** After a Stripe tab was opened, the state is read again when this tab becomes visible again (the user came back): `(outcome)` then reports `complete` / `verifying` with source `return`. */
@@ -1348,7 +1361,7 @@ export declare class StripeConnectComponent {
       "required": false;
       "isSignal": true;
     };
-    "title": {
+    "titleInput": {
       "alias": "title";
       "required": false;
       "isSignal": true;
@@ -1363,17 +1376,17 @@ export declare class StripeConnectComponent {
       "required": false;
       "isSignal": true;
     };
-    "startTitle": {
+    "startTitleInput": {
       "alias": "startTitle";
       "required": false;
       "isSignal": true;
     };
-    "startText": {
+    "startTextInput": {
       "alias": "startText";
       "required": false;
       "isSignal": true;
     };
-    "startLabel": {
+    "startLabelInput": {
       "alias": "startLabel";
       "required": false;
       "isSignal": true;
@@ -1456,15 +1469,18 @@ export declare const STRIPE_PAYMENT_METHODS: readonly [{
   readonly value: "ACH";
   readonly label: "ACH / Bank Transfer";
 }];
+/** The name of a method in the app's active language. */
+declare const stripeMethodLabel: (value: string, english: string) => string;
 declare const stripeMethodType: (method: string) => "card" | "us_bank_account";
+/** The texts of the Stripe payment method; read on every access, so they follow the app's active language. */
 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.";
+  readonly amountNeeded: string;
+  readonly notCompleted: string;
+  readonly achTitle: string;
+  achMessage: (amount: string) => string;
+  readonly verificationTitle: string;
+  verificationMessage: (amount: string) => string;
+  readonly receiptNote: string;
 };
 /**
  * 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
@@ -1496,14 +1512,16 @@ export declare class StripePaymentMethodComponent extends PaymentMethodPlugin {
   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[]>;
+  readonly methodListInput: import("@angular/core").InputSignal<readonly PaymentPluginMethod[] | null>;
+  readonly methodList: import("@angular/core").Signal<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>;
+  readonly receiptNoteInput: import("@angular/core").InputSignal<string | null>;
+  readonly receiptNote: import("@angular/core").Signal<string>;
   private readonly body;
-  readonly methods: import("@angular/core").InputSignal<readonly PaymentPluginMethod[]>;
+  readonly methods: import("@angular/core").Signal<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, {
@@ -1547,7 +1565,7 @@ export declare class StripePaymentMethodComponent extends PaymentMethodPlugin {
       "required": false;
       "isSignal": true;
     };
-    "methodList": {
+    "methodListInput": {
       "alias": "methodList";
       "required": false;
       "isSignal": true;
@@ -1562,7 +1580,7 @@ export declare class StripePaymentMethodComponent extends PaymentMethodPlugin {
       "required": false;
       "isSignal": true;
     };
-    "receiptNote": {
+    "receiptNoteInput": {
       "alias": "receiptNote";
       "required": false;
       "isSignal": true;