@forgeroute/ui 0.4.30 → 0.4.31

package/package.json

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

package/types/forgeroute-ui.d.ts

@@ -11129,6 +11129,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 +11142,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 +11163,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 +11185,11 @@ export declare class SetupWizardStepDirective {
     };
   }, {}, 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";
 /**
@@ -11204,7 +11230,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 +11242,19 @@ 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 templateFor(key: string): import("@angular/core").TemplateRef<{
+    $implicit: SetupWizardApi;
+  }> | null;
   protected goTo(key: string): void;
   private enter;
   private advanceFrom;
@@ -11227,7 +11262,7 @@ 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;