@forgeroute/ui 0.4.37 → 0.4.39

package/package.json

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

package/types/forgeroute-ui.d.ts

@@ -1056,7 +1056,7 @@ export declare class SelectComponent implements ControlValueAccessor, Validator,
   readonly error: import("@angular/core").InputSignal<string>;
   /** Reveal the built-in error messages now (e.g. after a failed Save click), without waiting for blur. */
   readonly showErrors: import("@angular/core").InputSignal<boolean>;
-  readonly size: import("@angular/core").InputSignal<"default" | "sm">;
+  readonly size: import("@angular/core").InputSignal<"sm" | "default">;
   readonly _disabledInput: import("@angular/core").InputSignal<boolean>;
   private readonly _cvaDisabled;
   protected readonly disabled: import("@angular/core").Signal<boolean>;
@@ -1210,6 +1210,10 @@ export declare class ImportExportComponent {
   private readonly apiBase;
   private readonly toast;
   private readonly cdr;
+  private readonly destroyRef;
+  /** Seconds since the import request started (shown while it runs). */
+  importElapsed: number;
+  private importTimer;
   constructor();
   exporting: boolean;
   exportAll(): void;
@@ -1237,6 +1241,7 @@ export declare class ImportExportComponent {
   closeImport(): void;
   finishImport(): void;
   onFileChange(event: Event): void;
+  private readCsvFile;
   private autoMap;
   get canSubmit(): boolean;
   get unmappedRequiredFields(): string[];
@@ -1247,6 +1252,7 @@ export declare class ImportExportComponent {
   goToPreview(): void;
   get mappedFields(): ImportFieldDef[];
   get previewRows(): Record<string, string>[];
+  private stopImportTimer;
   submitImport(): void;
   static ɵfac: i0.ɵɵFactoryDeclaration<ImportExportComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<ImportExportComponent, "ui-import-export", never, {
@@ -2745,7 +2751,7 @@ export declare class CheckboxComponent implements ControlValueAccessor, Validato
    * clicking it still toggles the box - e.g. a product name that is both the heading of its card and the label of its checkbox.
    * Default null: plain label text, exactly as before. Single mode only.
    */
-  readonly headingLevel: import("@angular/core").InputSignal<1 | 2 | 3 | 4 | 5 | 6 | null>;
+  readonly headingLevel: import("@angular/core").InputSignal<2 | 1 | 3 | 4 | 5 | 6 | null>;
   readonly indeterminate: import("@angular/core").InputSignal<boolean>;
   readonly checked: import("@angular/core").ModelSignal<boolean>;
   /**
@@ -3656,7 +3662,7 @@ export declare class PhoneNumberPickerComponent {
   protected readonly modeCtl: FormControl<string>;
   protected readonly zipCtl: FormControl<string>;
   protected readonly areaCtl: FormControl<string>;
-  protected readonly step: import("@angular/core").WritableSignal<1 | 2 | 3>;
+  protected readonly step: import("@angular/core").WritableSignal<2 | 1 | 3>;
   protected readonly mode: import("@angular/core").WritableSignal<PhoneNumberSearchMode>;
   private readonly _zip;
   private readonly _area;
@@ -3770,7 +3776,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<"primary" | "secondary" | "danger" | "warning" | "link" | "ghost" | "ghost-start" | "tab" | "icon" | "icon-danger">;
+  readonly variant: import("@angular/core").InputSignal<"link" | "primary" | "secondary" | "danger" | "warning" | "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' }`). */
@@ -3809,13 +3815,13 @@ export declare class ButtonComponent {
    * shows when the viewport is narrower than this; from the width itself the long text shows (`640`: >= 640px long, < 640px short, like a
    * `min-width: 640px` switch). Tokens are pure CSS; a number is tracked with `matchMedia`. Default `'md'`.
    */
-  readonly shortBelow: import("@angular/core").InputSignal<number | "sm" | "md" | "lg">;
+  readonly shortBelow: import("@angular/core").InputSignal<number | "sm" | "lg" | "md">;
   /** Classes of the two label spans: the token class, or `btn-sl-narrow` while a pixel breakpoint is active. */
   protected readonly _slClass: import("@angular/core").Signal<string>;
   private readonly _narrow;
   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 size: import("@angular/core").InputSignal<"sm" | "lg" | "md" | "xs">;
   readonly type: import("@angular/core").InputSignal<"reset" | "submit" | "button">;
   readonly disabled: import("@angular/core").InputSignal<boolean>;
   readonly loading: import("@angular/core").InputSignal<boolean>;
@@ -4248,7 +4254,7 @@ export declare class BulkMessagePanelComponent {
   readonly sending: import("@angular/core").InputSignal<boolean>;
   readonly closed: import("@angular/core").OutputEmitterRef<void>;
   readonly send: import("@angular/core").OutputEmitterRef<BulkMessageSendEvent>;
-  readonly channel: import("@angular/core").WritableSignal<"text" | "email">;
+  readonly channel: import("@angular/core").WritableSignal<"email" | "text">;
   private readonly _subject;
   private readonly _body;
   get subject(): string;
@@ -4612,7 +4618,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" | "email" | "tel" | "password" | "url">;
+  readonly type: import("@angular/core").InputSignal<"number" | "email" | "text" | "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>;
@@ -4621,7 +4627,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<"" | "none" | "text" | "search" | "email" | "tel" | "url" | "decimal" | "numeric">;
+  readonly inputmode: import("@angular/core").InputSignal<"" | "email" | "none" | "text" | "search" | "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>;
@@ -4685,7 +4691,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" | "email" | "tel" | "password" | "url">;
+  protected readonly _inputType: import("@angular/core").Signal<"number" | "email" | "text" | "tel" | "password" | "url">;
   protected readonly _eyePath: string;
   protected readonly _eyeOffPath: string;
   protected readonly _showRequirements: import("@angular/core").Signal<boolean>;
@@ -6214,7 +6220,7 @@ export declare class FormSectionComponent {
   }, {}, never, ["*"], true, never>;
 }
 export declare class FormRowComponent {
-  readonly cols: import("@angular/core").InputSignal<1 | 2 | 3 | 4>;
+  readonly cols: import("@angular/core").InputSignal<2 | 1 | 3 | 4>;
   static ɵfac: i0.ɵɵFactoryDeclaration<FormRowComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<FormRowComponent, "ui-form-row", never, {
     "cols": {
@@ -6231,7 +6237,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<"" | "2" | "3" | 2 | 3 | "all">;
+  readonly uiColSpan: import("@angular/core").InputSignal<"" | 2 | "2" | "3" | 3 | "all">;
   protected readonly _class: import("@angular/core").Signal<string>;
   static ɵfac: i0.ɵɵFactoryDeclaration<FormColSpanDirective, never>;
   static ɵdir: i0.ɵɵDirectiveDeclaration<FormColSpanDirective, "[uiColSpan]", never, {
@@ -7169,8 +7175,8 @@ export declare class PanelInfoListComponent {
  * readers announce it as pressed / not pressed. A dismissible chip is a removable tag, not a toggle, so it carries no
  * `aria-pressed` (the ✕ button is named "Remove <label>").
  *
- * Dismissible chips can be removed from the keyboard: Tab to the ✕ (focusable, named "Remove <label>") and press Enter or
- * Space, or press Delete / Backspace while the chip itself is focused.
+ * A dismissible chip is a wrapper of two sibling native buttons (the label and the ✕), never a button inside a button (axe nested-interactive).
+ * Keyboard removal: Tab to the ✕ (named "Remove <label>") and press Enter or Space, or press Delete / Backspace on either button.
  *
  * Dismissible (shows an ✕ button — parent removes the chip on dismiss):
  *   <ui-chip label="Austin" size="sm" [dismissible]="true" (dismiss)="removeCity('Austin')" />
@@ -7210,10 +7216,7 @@ export declare class ChipComponent implements ControlValueAccessor {
   protected _onTouched: () => void;
   protected onClick(): void;
   protected onDismiss(event: Event): void;
-  /**
-   * Keyboard removal: Enter / Space on the focused ✕, or Delete / Backspace on the chip itself (dismissible chips only).
-   * Handled here so the key never also toggles the chip.
-   */
+  /** Delete / Backspace on either button of a dismissible chip removes it (the ✕ itself is a native button: Enter / Space click it). */
   protected onDismissKey(event: Event): void;
   writeValue(v: boolean): void;
   registerOnChange(fn: (v: boolean) => void): void;
@@ -7256,11 +7259,11 @@ export declare class ChipComponent implements ControlValueAccessor {
  */
 export declare class ChipGroupComponent {
   /** Space between each chip. */
-  readonly gap: import("@angular/core").InputSignal<"sm" | "md" | "lg">;
+  readonly gap: import("@angular/core").InputSignal<"sm" | "lg" | "md">;
   /** Space above the chip group. */
-  readonly spaceAbove: import("@angular/core").InputSignal<"none" | "sm" | "md">;
+  readonly spaceAbove: import("@angular/core").InputSignal<"sm" | "none" | "md">;
   /** Space below the chip group. */
-  readonly spaceBelow: import("@angular/core").InputSignal<"none" | "sm" | "md">;
+  readonly spaceBelow: import("@angular/core").InputSignal<"sm" | "none" | "md">;
   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">;
@@ -9168,7 +9171,7 @@ export declare class DetailCardComponent {
   /** true (default) = the title is displayed in capitals (CSS only); false = shown as written. The text, aria-label and heading name are never changed. */
   readonly uppercaseTitle: import("@angular/core").InputSignal<boolean>;
   /** 1-6 makes the title a real heading for screen readers (role=heading, aria-level); null keeps it plain text. */
-  readonly headingLevel: import("@angular/core").InputSignal<1 | 2 | 3 | 4 | 5 | 6 | null>;
+  readonly headingLevel: import("@angular/core").InputSignal<2 | 1 | 3 | 4 | 5 | 6 | null>;
   /** Optional id for the title text; the card is then labelled by it. Without it the title is the card's aria-label. */
   readonly titleId: import("@angular/core").InputSignal<string>;
   /** Accessible name of the card when the header gives none (no header, or no title). A visible title wins; blank = no name. */
@@ -9918,7 +9921,7 @@ export declare class SectionHeaderComponent {
   /** 1px border and 10px corners. */
   readonly bordered: import("@angular/core").InputSignal<boolean>;
   /** Visual size: 'sm', 'md' (default), 'lg' or 'xl'. Independent of `level`; anything else renders as 'md'. */
-  readonly size: import("@angular/core").InputSignal<"sm" | "md" | "lg" | "xl">;
+  readonly size: import("@angular/core").InputSignal<"sm" | "lg" | "md" | "xl">;
   /** Remove the built-in top padding. */
   readonly noPaddingTop: import("@angular/core").InputSignal<boolean>;
   /** Remove the built-in left padding. */
@@ -11002,8 +11005,8 @@ export declare class ShowComponent {
   readonly from: import("@angular/core").InputSignal<ShowBreakpoint | null>;
   readonly below: import("@angular/core").InputSignal<ShowBreakpoint | null>;
   private readonly win;
-  protected readonly fromToken: import("@angular/core").Signal<"sm" | "md" | "lg" | null>;
-  protected readonly belowToken: import("@angular/core").Signal<"sm" | "md" | "lg" | null>;
+  protected readonly fromToken: import("@angular/core").Signal<"sm" | "lg" | "md" | null>;
+  protected readonly belowToken: import("@angular/core").Signal<"sm" | "lg" | "md" | null>;
   protected readonly fromMatch: import("@angular/core").WritableSignal<boolean>;
   protected readonly belowMatch: import("@angular/core").WritableSignal<boolean>;
   constructor();
@@ -11286,6 +11289,8 @@ export interface SetupWizardTexts {
   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;
@@ -11329,7 +11334,7 @@ export interface SetupStep {
   skippable?: boolean;
   /** `custom`: runs on "Save & Continue". Resolve to continue; throw / error to stay on the step (the message is shown in an alert). */
   save?: () => Observable<unknown> | Promise<unknown> | void;
-  /** `custom`: false disables "Save & Continue". */
+  /** `custom` and `integrations`: false disables "Save & Continue" (read on every render, so it can follow signals). */
   canContinue?: () => boolean;
   /** `custom`: text of the continue button (default "Save & Continue"). */
   saveLabel?: string;
@@ -11460,7 +11465,7 @@ export declare class SetupWizardComponent {
   /** 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 splitTab: import("@angular/core").WritableSignal<"extra" | "main">;
   protected readonly splitTabs: import("@angular/core").Signal<{
     key: string;
     label: string;
@@ -11522,6 +11527,11 @@ export declare class SetupWizardComponent {
   protected back(): void;
   protected skip(): void;
   /** Marks the given steps done (ignoring keys that are not steps of this wizard). */
+  /**
+   * Marks steps as done from outside the step templates (unknown keys are ignored), e.g. when the app finds that a step's data already exists after a
+   * page reload, so the user is not asked to import it a second time. Same effect as `wizard.markCompleted(...)` inside a step template.
+   */
+  completeSteps(...keys: string[]): void;
   private markStepsCompleted;
   private markCompleted;
   /** "Save & Continue" of a custom or integrations step: runs the step's hook, then moves on. */
@@ -11753,6 +11763,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;
@@ -11787,6 +11799,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>;
@@ -12066,6 +12081,11 @@ export declare const MAX_EMAIL_ADDRESS_LENGTH = 254;
 export declare const isValidEmailAddress: (address: string) => boolean;
 /** An http(s) address with a real host: no spaces or quotes (the address is written into an HTML attribute) and a dot or `localhost`. */
 export declare function isWebUrl(raw: string): boolean;
+/**
+ * How many characters typed text takes once it is saved, i.e. as `innerHTML` writes a TEXT node: `&`, `<` and `>` become entities and a
+ * non-breaking space (what a browser types for a run of spaces) becomes `&nbsp;`; quotes are not escaped in text, so each counts as one.
+ */
+export declare function serializedTextLength(text: string): number;
 /** Escapes text for HTML text and double-quoted attribute values. */
 export declare function escapeHtml(value: string): string;
 /** True when a block's HTML shows something to a reader: an image or other media, or text once tags, non-breaking spaces and whitespace are gone. */
@@ -12101,4 +12121,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 };