@forgeroute/ui 0.4.36 → 0.4.38

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgeroute/ui",
-  "version": "0.4.36",
+  "version": "0.4.38",
   "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. */
@@ -1813,7 +1813,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.d.ts

@@ -11279,7 +11279,15 @@ export interface SetupWizardTexts {
   selectSource: string;
   connected: string;
   importMore: string;
+  /** Shown (and described by the disabled Continue) on an import step with `requireImport` until data came in. */
+  importRequired: 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;
+  importAgain: string;
   whatGetsImported: string;
+  /** Title of the card with the summary on the last page. */
+  summaryTitle: string;
   doneTitle: string;
   doneDescription: string;
   doneHint: string;
@@ -11327,14 +11335,23 @@ export interface SetupStep {
   canContinue?: () => boolean;
   /** `custom`: text of the continue button (default "Save & Continue"). */
   saveLabel?: string;
+  /**
+   * Import / integrations steps with app content (`<ng-template uiSetupStep>`): show two tabs below the intro, one card at a time. The first tab holds the app's
+   * content in a card titled `extraTitle`, the second the step's own card. Tab labels: `extraTab` / `mainTab` (default `extraTitle` / `cardTitle`).
+   */
+  splitLayout?: boolean;
+  extraTitle?: string;
+  extraTab?: string;
+  mainTab?: string;
+  /** Status line under the app content of a `splitLayout` step (e.g. "Not connected yet"); read on every render, so it can follow signals. */
+  extraFooter?: () => string;
+  /** Import steps: Continue stays disabled until the data came in (CSV import done with no refused rows, or the app called `markCompleted(key)` after a live sync). Skip stays available. */
+  requireImport?: boolean;
   /**
    * `custom`: the step draws its own continue button (for example in the footer of a `ui-detail-card`), so the wizard does not show its own. The step's
    * template receives the wizard as `let-wizard` and calls `wizard.saveAndContinue()` (runs `save`, then moves on) and reads `wizard.busy()`.
    * Back / Skip stay the wizard's.
    */
-  /** Import / integrations steps with app content: show that content in its own card (titled `extraTitle`) beside the step card on a wide screen, stacked on a phone. */
-  splitLayout?: boolean;
-  extraTitle?: string;
   ownActions?: boolean;
   import?: SetupImportStep;
   integrations?: SetupIntegration[];
@@ -11442,6 +11459,14 @@ export declare class SetupWizardComponent {
   /** Phone layout: the step's Back / Skip / Continue buttons fill the width and stack (primary on top). */
   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). */
+  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<"main" | "extra">;
+  protected readonly splitTabs: import("@angular/core").Signal<{
+    key: string;
+    label: string;
+  }[]>;
   protected readonly split: import("@angular/core").Signal<boolean>;
   /** The steps in walking order. A `done` summary step is appended automatically. */
   readonly steps: import("@angular/core").InputSignal<SetupStep[]>;
@@ -11463,6 +11488,7 @@ export declare class SetupWizardComponent {
   private readonly completed;
   private readonly skipped;
   private readonly imports;
+  private readonly importErrors;
   private readonly statuses;
   readonly busy: import("@angular/core").WritableSignal<boolean>;
   /** What a custom step's template receives (`let-wizard`). */
@@ -11510,6 +11536,7 @@ export declare class SetupWizardComponent {
   protected openImport(key: string): void;
   protected onImported(key: string): void;
   protected importResult(key: string): number | null;
+  protected importErrorCount(key: string): number;
   protected clearImport(key: string): void;
   protected importTitle(key: string): string;
   protected continueFromImport(): void;
@@ -11728,6 +11755,8 @@ export declare class EmailTemplateEditorComponent {
   readonly headingOptions: SelectOption<string>[];
   readonly fontSizeOptions: SelectOption<string>[];
   readonly spacingTabs: PillTab[];
+  /** The grey hint shown in the empty first block. */
+  protected readonly startPlaceholder = "Start writing your email...";
   readonly ctaTypeOptions: SelectOption<string>[];
   readonly playbackOptions: {
     value: string;
@@ -11762,6 +11791,9 @@ export declare class EmailTemplateEditorComponent {
   readonly filteredBlockGroups: import("@angular/core").Signal<EmailTemplateBlockGroup[]>;
   private readonly serialized;
   readonly previewHtml: import("@angular/core").Signal<string>;
+  private readonly sanitizer;
+  /** The Preview / Mobile document: a full page with the email's own styles. It is shown in a sandboxed iframe (no scripts, no popups), so trusting the markup here cannot run anything. */
+  readonly previewDoc: import("@angular/core").Signal<SafeHtml>;
   /** Characters in the body as it is saved. */
   readonly bodyLength: import("@angular/core").Signal<number>;
   readonly bodyHasContent: import("@angular/core").Signal<boolean>;
@@ -12076,4 +12108,9 @@ export declare const DEFAULT_EMAIL_TEMPLATE_VARIABLE_GROUPS: {
     example: string;
   }[];
 }[];
+/**
+ * The document the Preview / Mobile tabs show (inside a sandboxed iframe): the serialised message with the base look of a sent email. A
+ * 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 { CalendarDay, CalendarRange, CalendarViewMode };