@forgeroute/ui 0.4.30 → 0.4.32

package/package.json

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

package/types/forgeroute-ui.d.ts

@@ -4251,6 +4251,62 @@ export declare class BulkMessagePanelComponent {
     "send": "send";
   }, never, never, true, never>;
 }
+/**
+ * The grid of source cards ("Follow Up Boss", "kvCORE", "Custom CSV" ...) of the import wizard's first step. Used inside the import window and
+ * on its own (the setup wizard shows it inline so the user picks a source without opening the window first).
+ *
+ *   <ui-import-source-grid [sources]="sources" [selected]="picked" ariaLabel="Select your Contact source" (sourceSelect)="picked = $event" />
+ */
+export declare class ImportSourceGridComponent {
+  readonly sources: import("@angular/core").InputSignal<ImportSource[]>;
+  /** 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<"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. */
+  readonly actionLabel: import("@angular/core").InputSignal<string>;
+  /** Accessible name of the list. */
+  readonly ariaLabel: import("@angular/core").InputSignal<string>;
+  /** Emits the `value` of the clicked source. */
+  readonly sourceSelect: import("@angular/core").OutputEmitterRef<string>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<ImportSourceGridComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<ImportSourceGridComponent, "ui-import-source-grid", never, {
+    "sources": {
+      "alias": "sources";
+      "required": true;
+      "isSignal": true;
+    };
+    "selected": {
+      "alias": "selected";
+      "required": false;
+      "isSignal": true;
+    };
+    "appearance": {
+      "alias": "appearance";
+      "required": false;
+      "isSignal": true;
+    };
+    "disabled": {
+      "alias": "disabled";
+      "required": false;
+      "isSignal": true;
+    };
+    "actionLabel": {
+      "alias": "actionLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "ariaLabel": {
+      "alias": "ariaLabel";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "sourceSelect": "sourceSelect";
+  }, never, never, true, never>;
+}
 export interface ActiveConfirm {
   title: string;
   message: string;
@@ -11081,6 +11137,8 @@ export interface SetupWizardTexts {
   exit: string;
   connect: string;
   reconnect: string;
+  /** Button on each source card of an import step. */
+  selectSource: string;
   connected: string;
   importMore: string;
   whatGetsImported: string;
@@ -11117,6 +11175,8 @@ export interface SetupStep {
   /** Unique within the list. */
   key: string;
   label: string;
+  /** Title in the header bar of the card around the step. Omit it and the card has no header bar. */
+  cardTitle?: string;
   /** The paragraph under the heading. */
   description?: string;
   /** `custom` shows the app's own `<ng-template uiSetupStep="key">`; `import` and `integrations` are built in. */
@@ -11129,6 +11189,12 @@ export interface SetupStep {
   canContinue?: () => boolean;
   /** `custom`: text of the continue button (default "Save & Continue"). */
   saveLabel?: string;
+  /**
+   * `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.
+   */
+  ownActions?: boolean;
   import?: SetupImportStep;
   integrations?: SetupIntegration[];
   /** `integrations`: runs when the step is left with Continue (e.g. to save sender settings). */
@@ -11136,6 +11202,13 @@ export interface SetupStep {
   /** Called when the step is shown (load data for a custom step). */
   onEnter?: () => void;
 }
+/** What a custom step's template gets as `let-wizard` when the step draws its own continue button (`ownActions`). */
+export interface SetupWizardApi {
+  /** Runs the step's `save` hook (and shows its error), then moves to the next step. */
+  saveAndContinue(): Promise<void>;
+  /** True while a save is running. */
+  readonly busy: () => boolean;
+}
 /**
  * The integrations every app can offer in a setup step. The endpoints follow the convention the apps' backends already use (`GET <x>/status`,
  * `GET <x>/authorize` answering `{ url }`); an app whose routes differ spreads a preset and overrides what differs:
@@ -11150,11 +11223,19 @@ export declare function setupIntegrations(...keys: (keyof typeof SETUP_INTEGRATI
  *   <ui-setup-wizard [steps]="steps()">
  *     <ng-template uiSetupStep="profile"> …the app's own form… </ng-template>
  *   </ui-setup-wizard>
+ *
+ * A step with `ownActions: true` draws its own continue button: `<ng-template uiSetupStep="profile" let-wizard>` … `(click)="wizard.saveAndContinue()"`.
  */
 export declare class SetupWizardStepDirective {
   /** The `key` of the step this template belongs to. */
   readonly key: import("@angular/core").InputSignal<string>;
-  readonly template: TemplateRef<unknown>;
+  readonly template: TemplateRef<{
+    $implicit: SetupWizardApi;
+  }>;
+  /** Types `let-wizard` in the step's template as `SetupWizardApi`. */
+  static ngTemplateContextGuard(_dir: SetupWizardStepDirective, _ctx: unknown): _ctx is {
+    $implicit: SetupWizardApi;
+  };
   static ɵfac: i0.ɵɵFactoryDeclaration<SetupWizardStepDirective, never>;
   static ɵdir: i0.ɵɵDirectiveDeclaration<SetupWizardStepDirective, "ng-template[uiSetupStep]", never, {
     "key": {
@@ -11164,6 +11245,33 @@ export declare class SetupWizardStepDirective {
     };
   }, {}, never, never, true, never>;
 }
+/**
+ * Content for the right side of a step's card header (a search box, a small action): `<ng-template uiSetupStepHeader="key">…</ng-template>`.
+ * It gets the same `let-wizard` as the step's own template. A step with this template shows the card header even without a `cardTitle`.
+ */
+export declare class SetupWizardStepHeaderDirective {
+  /** The `key` of the step this header content belongs to. */
+  readonly key: import("@angular/core").InputSignal<string>;
+  readonly template: TemplateRef<{
+    $implicit: SetupWizardApi;
+  }>;
+  static ngTemplateContextGuard(_dir: SetupWizardStepHeaderDirective, _ctx: unknown): _ctx is {
+    $implicit: SetupWizardApi;
+  };
+  static ɵfac: i0.ɵɵFactoryDeclaration<SetupWizardStepHeaderDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<SetupWizardStepHeaderDirective, "ng-template[uiSetupStepHeader]", never, {
+    "key": {
+      "alias": "uiSetupStepHeader";
+      "required": true;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}
+/** Splits a description into its first sentence (title) and the rest (text). A single sentence is all title. */
+export declare function splitIntro(description: string): {
+  title: string;
+  text: string;
+};
 /** The key of the summary step the wizard appends to the app's steps. */
 export declare const SETUP_DONE_KEY = "done";
 /**
@@ -11197,6 +11305,7 @@ export declare class SetupWizardComponent {
   /** The step that was just shown (its key). */
   readonly stepChange: import("@angular/core").OutputEmitterRef<string>;
   protected readonly stepTemplates: import("@angular/core").Signal<readonly SetupWizardStepDirective[]>;
+  protected readonly headerTemplates: import("@angular/core").Signal<readonly SetupWizardStepHeaderDirective[]>;
   protected readonly importers: import("@angular/core").Signal<readonly ImportExportComponent[]>;
   protected readonly t: import("@angular/core").Signal<SetupWizardTexts>;
   protected readonly currentKey: import("@angular/core").WritableSignal<string>;
@@ -11204,7 +11313,9 @@ export declare class SetupWizardComponent {
   private readonly skipped;
   private readonly imports;
   private readonly statuses;
-  protected readonly busy: import("@angular/core").WritableSignal<boolean>;
+  readonly busy: import("@angular/core").WritableSignal<boolean>;
+  /** What a custom step's template receives (`let-wizard`). */
+  protected readonly api: SetupWizardApi;
   protected readonly error: import("@angular/core").WritableSignal<string>;
   protected readonly areaCodeOpen: import("@angular/core").WritableSignal<string>;
   protected readonly areaCode: import("@angular/core").WritableSignal<string>;
@@ -11214,12 +11325,22 @@ export declare class SetupWizardComponent {
   protected readonly allSteps: import("@angular/core").Signal<SetupStep[]>;
   protected readonly index: import("@angular/core").Signal<number>;
   protected readonly current: import("@angular/core").Signal<SetupStep>;
+  /** The step's description as a blue header: its first sentence is the title, the rest the text under it. */
+  protected readonly intro: import("@angular/core").Signal<{
+    title: string;
+    text: string;
+  } | null>;
   protected readonly isDone: import("@angular/core").Signal<boolean>;
   protected readonly completedCount: import("@angular/core").Signal<number>;
   protected readonly stepperSteps: import("@angular/core").Signal<StepperStep[]>;
   protected readonly summarySections: import("@angular/core").Signal<PanelInfoSection[]>;
   constructor();
-  protected templateFor(key: string): import("@angular/core").TemplateRef<unknown> | null;
+  protected headerTemplateFor(key: string): import("@angular/core").TemplateRef<{
+    $implicit: SetupWizardApi;
+  }> | null;
+  protected templateFor(key: string): import("@angular/core").TemplateRef<{
+    $implicit: SetupWizardApi;
+  }> | null;
   protected goTo(key: string): void;
   private enter;
   private advanceFrom;
@@ -11227,10 +11348,12 @@ export declare class SetupWizardComponent {
   protected skip(): void;
   private markCompleted;
   /** "Save & Continue" of a custom or integrations step: runs the step's hook, then moves on. */
-  protected saveAndContinue(): Promise<void>;
+  saveAndContinue(): Promise<void>;
   private run;
   /** The message to show for a failure: the server's own `{ message }` (or a thrown error's message); never the HTTP client's technical text. */
   private messageOf;
+  /** A source card was picked on the step itself: opens the import window already past its source step (at the upload step for that source). */
+  protected startImport(key: string, source: string): void;
   protected openImport(key: string): void;
   protected onImported(key: string): void;
   protected importResult(key: string): number | null;
@@ -11264,7 +11387,7 @@ export declare class SetupWizardComponent {
     "finished": "finished";
     "exited": "exited";
     "stepChange": "stepChange";
-  }, ["stepTemplates"], ["[setup-wizard-logo]"], true, never>;
+  }, ["stepTemplates", "headerTemplates"], ["[setup-wizard-logo]"], true, never>;
 }
 /** One automated trigger a template can be assigned to (the host decides which exist). */
 export interface EmailTemplateAssignmentOption {
@@ -11455,7 +11578,7 @@ export declare class EmailTemplateEditorComponent {
   readonly sizeKey: import("@angular/core").WritableSignal<number>;
   readonly headingOptions: SelectOption<string>[];
   readonly fontSizeOptions: SelectOption<string>[];
-  readonly spacingOptions: SelectOption<string>[];
+  readonly spacingTabs: PillTab[];
   readonly ctaTypeOptions: SelectOption<string>[];
   readonly playbackOptions: {
     value: string;