@forgeroute/ui 0.4.28 → 0.4.31

package/package.json

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

package/types/forgeroute-ui.d.ts

@@ -2491,7 +2491,7 @@ export declare class AudioPlayerComponent {
   /** Accessible name of the player. */
   readonly ariaLabel: import("@angular/core").InputSignal<string>;
   /** How much to load before play: 'metadata' (default), 'auto' or 'none'. */
-  readonly preload: import("@angular/core").InputSignal<"metadata" | "none" | "auto">;
+  readonly preload: import("@angular/core").InputSignal<"none" | "auto" | "metadata">;
   /** Fires when the browser can't load or decode the source. */
   readonly playbackError: import("@angular/core").OutputEmitterRef<void>;
   protected readonly failed: import("@angular/core").WritableSignal<boolean>;
@@ -3766,7 +3766,7 @@ export declare class ButtonComponent {
    * `ghost-start`: a ghost button for list / section toggles - a full-width row with its content aligned to the start, transparent
    * background, hover tint and the normal focus ring. Pair it with `ariaExpanded` / `ariaPressed`; the label may contain a heading element.
    */
-  readonly variant: import("@angular/core").InputSignal<"link" | "primary" | "secondary" | "danger" | "warning" | "ghost" | "ghost-start" | "tab" | "icon" | "icon-danger">;
+  readonly variant: import("@angular/core").InputSignal<"primary" | "secondary" | "danger" | "warning" | "link" | "ghost" | "ghost-start" | "tab" | "icon" | "icon-danger">;
   /** Renders an anchor to this route instead of a button (use with `variant="link"` for an inline text link). `['/settings']` or `'/settings'`. While `disabled` or `loading` it renders a non-clickable `<span role="link" aria-disabled>` with no href (like `href`). */
   readonly routerLink: import("@angular/core").InputSignal<string | readonly unknown[] | null>;
   /** Query params of the `routerLink` (e.g. `{ section: 'deal-defaults' }`). */
@@ -3787,7 +3787,7 @@ export declare class ButtonComponent {
    */
   readonly href: import("@angular/core").InputSignal<string | null>;
   /** Where to open the `href` (`_blank` = a new tab). */
-  readonly target: import("@angular/core").InputSignal<"_blank" | "_self" | "_parent" | "_top" | null>;
+  readonly target: import("@angular/core").InputSignal<"_self" | "_blank" | "_parent" | "_top" | null>;
   /** `rel` of the `href` link. A `_blank` target always gets `noopener noreferrer` added. */
   readonly rel: import("@angular/core").InputSignal<string | null>;
   /** The href when it is allowed (http, https, mailto, tel, sms or a relative URL), else null. */
@@ -3812,7 +3812,7 @@ export declare class ButtonComponent {
   readonly color: import("@angular/core").InputSignal<string | undefined>;
   readonly active: import("@angular/core").InputSignal<boolean>;
   readonly size: import("@angular/core").InputSignal<"sm" | "md" | "lg" | "xs">;
-  readonly type: import("@angular/core").InputSignal<"button" | "reset" | "submit">;
+  readonly type: import("@angular/core").InputSignal<"reset" | "submit" | "button">;
   readonly disabled: import("@angular/core").InputSignal<boolean>;
   readonly loading: import("@angular/core").InputSignal<boolean>;
   readonly fullWidth: import("@angular/core").InputSignal<boolean>;
@@ -4427,7 +4427,7 @@ export declare class TextInputComponent implements ControlValueAccessor, Validat
   readonly passwordRequirements: import("@angular/core").InputSignal<boolean>;
   /** Rules for `passwordRequirements`; default = the library's five rules (8+ characters, upper, lower, digit, special). */
   readonly passwordRules: import("@angular/core").InputSignal<readonly PasswordRule[] | undefined>;
-  readonly type: import("@angular/core").InputSignal<"number" | "text" | "password" | "email" | "tel" | "url">;
+  readonly type: import("@angular/core").InputSignal<"number" | "text" | "email" | "tel" | "password" | "url">;
   readonly maxlength: import("@angular/core").InputSignal<number | undefined>;
   readonly required: import("@angular/core").InputSignal<boolean>;
   readonly autocomplete: import("@angular/core").InputSignal<string>;
@@ -4436,7 +4436,7 @@ export declare class TextInputComponent implements ControlValueAccessor, Validat
    * `search`, `text`, `none`). Empty (default) = the browser's default for the field, except `type="tel"`, which keeps `tel`.
    * It only picks the keyboard; it does not restrict what can be typed or pasted.
    */
-  readonly inputmode: import("@angular/core").InputSignal<"" | "text" | "email" | "search" | "none" | "tel" | "url" | "decimal" | "numeric">;
+  readonly inputmode: import("@angular/core").InputSignal<"" | "none" | "text" | "search" | "email" | "tel" | "url" | "decimal" | "numeric">;
   readonly readonly: import("@angular/core").InputSignal<boolean>;
   readonly hint: import("@angular/core").InputSignal<string>;
   readonly error: import("@angular/core").InputSignal<string>;
@@ -4500,7 +4500,7 @@ export declare class TextInputComponent implements ControlValueAccessor, Validat
   protected readonly _stepAttr: import("@angular/core").Signal<string | null>;
   protected readonly _revealable: import("@angular/core").Signal<boolean>;
   protected readonly _shown: import("@angular/core").WritableSignal<boolean>;
-  protected readonly _inputType: import("@angular/core").Signal<"number" | "text" | "password" | "email" | "tel" | "url">;
+  protected readonly _inputType: import("@angular/core").Signal<"number" | "text" | "email" | "tel" | "password" | "url">;
   protected readonly _eyePath: string;
   protected readonly _eyeOffPath: string;
   protected readonly _showRequirements: import("@angular/core").Signal<boolean>;
@@ -5848,7 +5848,7 @@ export declare class DropdownComponent {
   readonly loader: import("@angular/core").InputSignal<(() => Promise<DropdownItem[]>) | null>;
   readonly active: import("@angular/core").InputSignal<boolean>;
   readonly activeValue: import("@angular/core").InputSignal<string>;
-  readonly variant: import("@angular/core").InputSignal<"button" | "badge">;
+  readonly variant: import("@angular/core").InputSignal<"badge" | "button">;
   readonly menuWidth: import("@angular/core").InputSignal<string>;
   /**
    * Accessible name. Set it when the trigger has no meaningful visible text. Applied as `aria-label` on the
@@ -6046,7 +6046,7 @@ export declare class FormRowComponent {
  * child simply takes the full width. Keep a numeric span within the row's `cols` (use `all` for the whole row).
  */
 export declare class FormColSpanDirective {
-  readonly uiColSpan: import("@angular/core").InputSignal<"" | "all" | 2 | "2" | 3 | "3">;
+  readonly uiColSpan: import("@angular/core").InputSignal<"" | "2" | "3" | 2 | 3 | "all">;
   protected readonly _class: import("@angular/core").Signal<string>;
   static ɵfac: i0.ɵɵFactoryDeclaration<FormColSpanDirective, never>;
   static ɵdir: i0.ɵɵDirectiveDeclaration<FormColSpanDirective, "[uiColSpan]", never, {
@@ -7076,7 +7076,7 @@ export declare class ChipGroupComponent {
   readonly spaceAbove: import("@angular/core").InputSignal<"none" | "sm" | "md">;
   /** Space below the chip group. */
   readonly spaceBelow: import("@angular/core").InputSignal<"none" | "sm" | "md">;
-  protected readonly _gap: import("@angular/core").Signal<"8px" | "6px" | "12px">;
+  protected readonly _gap: import("@angular/core").Signal<"6px" | "12px" | "8px">;
   protected readonly _spaceAbove: import("@angular/core").Signal<"0" | "6px" | "12px">;
   protected readonly _spaceBelow: import("@angular/core").Signal<"0" | "6px" | "12px">;
   static ɵfac: i0.ɵɵFactoryDeclaration<ChipGroupComponent, never>;
@@ -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;
@@ -11242,6 +11277,8 @@ export declare class SetupWizardComponent {
   protected isConnected(i: SetupIntegration): boolean;
   protected detailFor(i: SetupIntegration): string;
   protected connect(i: SetupIntegration): void;
+  /** SVG path of a library icon (the buttons' leading / trailing glyph). */
+  protected iconD(name: string): string;
   protected areaCodeLabelFor(i: SetupIntegration): string;
   /** Sends the browser to the provider's authorization page. */
   protected redirect(url: string): void;
@@ -11361,14 +11398,12 @@ type EditorTab = 'edit' | 'preview' | 'mobile';
 type RightTab = 'blocks' | 'variables' | 'video';
 /**
  * `ui-email-template-editor` - the full-page, block-based email template editor (details, assignments, block canvas with drag and drop,
- * rich-text toolbar, preview / mobile preview, content blocks, merge variables, video library, test send and AI draft).
+ * rich-text toolbar, preview / mobile preview, content blocks, merge variables, video library, test send).
  *
  * The component owns the editing behaviour and holds no HTTP: the host loads the template (`[template]`), supplies what differs per app
  * (`categories`, `assignmentOptions`, `variableGroups`, `blockGroups`, `videos`, `videoDefaults`, `maxBodyLength`, permissions) and reacts to
- * `(save)`, `(testSend)`, `(aiGenerate)`, `(videosRequested)`, `(back)` and `(useAsMine)`. After a request the host calls back:
- * `markSaved(id)` (a create succeeded), `closeTestSend()` and `addGeneratedHtml(html)`.
- *
- * Project an element with the `uiSubjectAction` attribute to put a host control (e.g. an AI copy button) at the end of the Subject label line.
+ * `(save)`, `(testSend)`, `(videosRequested)` and `(useAsMine)`. After a request the host calls back:
+ * `markSaved(id)` (a create succeeded) and `closeTestSend()`.
  *
  * Message limit: `maxBodyLength` is measured on the serialised HTML. An untouched stored body that is already longer than the limit is
  * accepted unchanged (legacy rows), exactly as the server does.
@@ -11388,12 +11423,8 @@ export declare class EmailTemplateEditorComponent {
   readonly textEnabled: import("@angular/core").InputSignal<boolean>;
   readonly variableGroups: import("@angular/core").InputSignal<EmailTemplateVariableGroup[]>;
   readonly blockGroups: import("@angular/core").InputSignal<EmailTemplateBlockGroup[]>;
-  readonly aiExamples: import("@angular/core").InputSignal<string[]>;
   readonly namePlaceholder: import("@angular/core").InputSignal<string>;
   readonly subjectPlaceholder: import("@angular/core").InputSignal<string>;
-  readonly backLabel: import("@angular/core").InputSignal<string>;
-  readonly createLabel: import("@angular/core").InputSignal<string>;
-  readonly editLabel: import("@angular/core").InputSignal<string>;
   readonly systemNote: import("@angular/core").InputSignal<string>;
   readonly readOnlyNote: import("@angular/core").InputSignal<string>;
   /** Prefix of the ids of the field errors the editor renders (`<prefix>-body-error`). */
@@ -11405,21 +11436,24 @@ export declare class EmailTemplateEditorComponent {
   readonly fullAccess: import("@angular/core").InputSignal<boolean>;
   /** A built-in template: shown read-only; a member with full access can copy it ((useAsMine)). */
   readonly systemTemplate: import("@angular/core").InputSignal<boolean>;
-  readonly aiEnabled: import("@angular/core").InputSignal<boolean>;
   readonly testSendEnabled: import("@angular/core").InputSignal<boolean>;
-  readonly videosEnabled: import("@angular/core").InputSignal<boolean>;
   readonly saving: import("@angular/core").InputSignal<boolean>;
   readonly testSending: import("@angular/core").InputSignal<boolean>;
-  readonly aiGenerating: import("@angular/core").InputSignal<boolean>;
-  readonly videos: import("@angular/core").InputSignal<EmailTemplateVideo[]>;
+  /**
+   * The host's videos. `null` (the default) = this app has no videos: the Video tab is not shown at all. Any list - even an empty one while the
+   * host loads it on demand (see `(videosRequested)`) - turns the Video tab on.
+   */
+  readonly videos: import("@angular/core").InputSignal<EmailTemplateVideo[] | null>;
+  /** Hides the Video tab completely even when `videos` is passed. */
+  readonly hideVideos: import("@angular/core").InputSignal<boolean>;
+  readonly videosEnabled: import("@angular/core").Signal<boolean>;
+  protected readonly videoList: import("@angular/core").Signal<EmailTemplateVideo[]>;
   readonly videosLoading: import("@angular/core").InputSignal<boolean>;
   readonly videoDefaults: import("@angular/core").InputSignal<EmailTemplateVideoDefaults>;
   readonly videoLink: import("@angular/core").InputSignal<EmailTemplateVideoLinkFn>;
   readonly noVideosHint: import("@angular/core").InputSignal<string>;
-  readonly back: import("@angular/core").OutputEmitterRef<void>;
   readonly save: import("@angular/core").OutputEmitterRef<EmailTemplateSavePayload>;
   readonly testSend: import("@angular/core").OutputEmitterRef<string>;
-  readonly aiGenerate: import("@angular/core").OutputEmitterRef<string>;
   /** The Video tab was opened (the host loads the library once). */
   readonly videosRequested: import("@angular/core").OutputEmitterRef<void>;
   readonly useAsMine: import("@angular/core").OutputEmitterRef<void>;
@@ -11472,8 +11506,6 @@ export declare class EmailTemplateEditorComponent {
   readonly imageAlt: import("@angular/core").WritableSignal<string>;
   readonly showTestSendDialog: import("@angular/core").WritableSignal<boolean>;
   readonly testSendEmail: import("@angular/core").WritableSignal<string>;
-  readonly showAiPanel: import("@angular/core").WritableSignal<boolean>;
-  readonly aiPrompt: import("@angular/core").WritableSignal<string>;
   readonly showAssignmentConfig: import("@angular/core").WritableSignal<boolean>;
   readonly configTarget: import("@angular/core").WritableSignal<AssignmentView | null>;
   readonly configEmail: import("@angular/core").WritableSignal<boolean>;
@@ -11507,7 +11539,15 @@ export declare class EmailTemplateEditorComponent {
   readonly bodyError: import("@angular/core").Signal<string>;
   /** "Active From / To" only apply when the template is not "all year"; when both are given To may not be before From. */
   readonly datesError: import("@angular/core").Signal<"" | "Active To must be on or after Active From.">;
+  /** Errors are held back until the user has had a chance to act: a field is blurred, the message is edited, or Save was clicked while something is invalid. */
+  readonly submitAttempted: import("@angular/core").WritableSignal<boolean>;
+  readonly nameTouched: import("@angular/core").WritableSignal<boolean>;
+  readonly subjectTouched: import("@angular/core").WritableSignal<boolean>;
+  readonly nameErrorShown: import("@angular/core").Signal<string>;
+  readonly subjectErrorShown: import("@angular/core").Signal<string>;
+  readonly bodyErrorShown: import("@angular/core").Signal<string>;
   readonly canSave: import("@angular/core").Signal<boolean>;
+  /** Save is offered to members who can write; clicking it while a rule fails shows the messages instead of sending anything. */
   readonly saveDisabled: import("@angular/core").Signal<boolean>;
   private normalizedLink;
   /** Why Insert is disabled: nothing for an empty field, a message for an address that is not a link. */
@@ -11519,20 +11559,16 @@ export declare class EmailTemplateEditorComponent {
   readonly canSendTest: import("@angular/core").Signal<boolean>;
   /** The test email is the SAVED template: true when the editor holds changes that were not saved yet. */
   readonly hasUnsavedChanges: import("@angular/core").Signal<boolean>;
-  readonly canGenerate: import("@angular/core").Signal<boolean>;
   constructor();
   /** A create succeeded: the template now has an id (Test Send becomes available) and what is on screen is the saved version. */
   markSaved(id?: string | null): void;
   /** The test email was sent: close the dialog. */
   closeTestSend(): void;
-  /** The AI draft arrived: add it as a new block and close the AI panel. */
-  addGeneratedHtml(html: string): void;
   private applyTemplate;
   onSave(): void;
   private snapshot;
   private serialize;
   private htmlToBlocks;
-  private stripBlockWrappers;
   private genId;
   private editorFor;
   /** Copies each block's HTML from its DOM element (before saving / preview). */
@@ -11598,8 +11634,6 @@ export declare class EmailTemplateEditorComponent {
   insertImageFromUrl(): void;
   openTestSendDialog(): void;
   onTestSend(): void;
-  openAiPanel(): void;
-  onAiGenerate(): void;
   openVideoTab(): void;
   insertVideo(video: EmailTemplateVideo): void;
   formatDuration(seconds: number | null | undefined): string;
@@ -11658,11 +11692,6 @@ export declare class EmailTemplateEditorComponent {
       "required": false;
       "isSignal": true;
     };
-    "aiExamples": {
-      "alias": "aiExamples";
-      "required": false;
-      "isSignal": true;
-    };
     "namePlaceholder": {
       "alias": "namePlaceholder";
       "required": false;
@@ -11673,21 +11702,6 @@ export declare class EmailTemplateEditorComponent {
       "required": false;
       "isSignal": true;
     };
-    "backLabel": {
-      "alias": "backLabel";
-      "required": false;
-      "isSignal": true;
-    };
-    "createLabel": {
-      "alias": "createLabel";
-      "required": false;
-      "isSignal": true;
-    };
-    "editLabel": {
-      "alias": "editLabel";
-      "required": false;
-      "isSignal": true;
-    };
     "systemNote": {
       "alias": "systemNote";
       "required": false;
@@ -11723,21 +11737,11 @@ export declare class EmailTemplateEditorComponent {
       "required": false;
       "isSignal": true;
     };
-    "aiEnabled": {
-      "alias": "aiEnabled";
-      "required": false;
-      "isSignal": true;
-    };
     "testSendEnabled": {
       "alias": "testSendEnabled";
       "required": false;
       "isSignal": true;
     };
-    "videosEnabled": {
-      "alias": "videosEnabled";
-      "required": false;
-      "isSignal": true;
-    };
     "saving": {
       "alias": "saving";
       "required": false;
@@ -11748,13 +11752,13 @@ export declare class EmailTemplateEditorComponent {
       "required": false;
       "isSignal": true;
     };
-    "aiGenerating": {
-      "alias": "aiGenerating";
+    "videos": {
+      "alias": "videos";
       "required": false;
       "isSignal": true;
     };
-    "videos": {
-      "alias": "videos";
+    "hideVideos": {
+      "alias": "hideVideos";
       "required": false;
       "isSignal": true;
     };
@@ -11779,13 +11783,11 @@ export declare class EmailTemplateEditorComponent {
       "isSignal": true;
     };
   }, {
-    "back": "back";
     "save": "save";
     "testSend": "testSend";
-    "aiGenerate": "aiGenerate";
     "videosRequested": "videosRequested";
     "useAsMine": "useAsMine";
-  }, never, ["[uiSubjectAction]"], true, never>;
+  }, never, never, true, never>;
 }
 /** The text a new template's first block starts with: it is a prompt, not content, so a template still holding only this has no message. */
 export declare const EMAIL_TEMPLATE_START_TEXT = "Start writing your email...";