@meshmakers/shared-ui 3.4.1490 → 3.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meshmakers/shared-ui",
-  "version": "3.4.1490",
+  "version": "3.5.00",
   "peerDependencies": {
     "@angular/common": "^22.0.0",
     "@angular/core": "^22.0.0",

package/types/meshmakers-shared-ui-assistant-core.d.ts

@@ -352,6 +352,10 @@ interface AssistantMessages {
     composerPlaceholder: string;
     send: string;
     stop: string;
+    /** Greeting of an empty chat, next to the waving OctoBot (AB#3444). */
+    greeting: string;
+    /** Shown next to the thinking OctoBot while a reply streams (AB#3444). */
+    thinking: string;
     conversationLabel: string;
     /** Screen-reader prefix of user turns. */
     youPrefix: string;

package/types/meshmakers-shared-ui-assistant.d.ts

@@ -101,6 +101,11 @@ declare class AssistantPanelComponent {
     protected readonly confirmingDelete: _angular_core.WritableSignal<string | null>;
     /** Session being opened or deleted (its buttons are disabled meanwhile). */
     protected readonly busySession: _angular_core.WritableSignal<string | null>;
+    /**
+     * Greeting of an empty chat (AB#3444): the OctoBot waves once, then rests on its still frame.
+     * Not shown while the assistant is unavailable (the panel says so instead).
+     */
+    protected readonly showGreeting: _angular_core.Signal<boolean>;
     /** Starter questions on an empty thread (transports with `starterQuestions` only). */
     protected readonly showStarters: _angular_core.Signal<boolean>;
     constructor();
@@ -205,6 +210,10 @@ declare class AssistantComposerComponent {
  * A user turn sent through a slash command's `expand` (AB#5621) shows the expanded prompt with the
  * typed command (`slashCommand`) as a small label above it.
  *
+ * While an assistant turn streams it shows the OctoBot `thinking` with "Thinking…" (AB#3444);
+ * once the reply is complete the newest assistant turn keeps the OctoBot as a still frame. The
+ * figure is decorative — the text carries the meaning — and appears at most once in the thread.
+ *
  * The list is an `aria-live` log; it is `aria-busy` while a turn streams so a
  * screen reader announces finished messages instead of every token. Nothing
  * inside it carries its own live role, so each addition is announced once.
@@ -217,6 +226,8 @@ declare class AssistantThreadComponent {
     readonly messages: _angular_core.InputSignal<Partial<AssistantMessages> | null>;
     protected readonly m: _angular_core.Signal<AssistantMessages>;
     protected readonly toolCallComponent: _angular_core.Type<unknown>;
+    /** Id of the newest assistant turn: the only one that shows the resting OctoBot. */
+    protected readonly lastAssistantId: _angular_core.Signal<string | null>;
     protected readonly streaming: _angular_core.Signal<boolean>;
     constructor();
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AssistantThreadComponent, never>;

package/types/meshmakers-shared-ui.d.ts

@@ -92,7 +92,12 @@ type BadgeMappingTable = Record<string, BadgeMapping>;
 interface TableColumn {
     displayName?: string | null;
     field: string;
-    dataType?: 'text' | 'numeric' | 'numericRange' | 'boolean' | 'date' | 'iso8601' | 'bytes' | 'statusIcons' | 'cronExpression' | 'progressBar' | 'badge' | 'component';
+    /**
+     * How the cell renders and filters. `booleanIcon` (AB#5623) shows a boolean as a check / x icon
+     * named "<column>: Yes|No" for screen readers (`role="img"` + `aria-label`, texts from
+     * `messages.booleanYes` / `booleanNo`) and filters like `boolean`; see {@link booleanIcons}.
+     */
+    dataType?: 'text' | 'numeric' | 'numericRange' | 'boolean' | 'booleanIcon' | 'date' | 'iso8601' | 'bytes' | 'statusIcons' | 'cronExpression' | 'progressBar' | 'badge' | 'component';
     format?: string;
     /**
      * Column width in pixels. If not set, the column will auto-size.
@@ -173,6 +178,13 @@ interface TableColumn {
      * a pill for `true` and nothing (rather than a "false" pill) for `false`.
      */
     badgeHideUnmapped?: boolean;
+    /**
+     * Icons of a `booleanIcon` column (AB#5623). Default: a check for `true`, an x for `false`.
+     * Set `false: null` to leave `false` cells empty (flag columns); `null` / `undefined` values
+     * always render an empty cell. Colours default to the theme tokens
+     * `--mm-list-boolean-true-color` / `--mm-list-boolean-false-color`.
+     */
+    booleanIcons?: BooleanIconMapping;
     /**
      * Optional callback that produces the cell's display string.
      * When set, this overrides the default rendering selected by `dataType`.
@@ -209,6 +221,17 @@ interface TableColumn {
      */
     cellInputs?: (item: unknown) => Record<string, unknown>;
 }
+/** Icons of a `booleanIcon` column (AB#5623). */
+interface BooleanIconMapping {
+    /** Icon for `true`. Default: a check icon. */
+    true?: SVGIcon;
+    /** Icon for `false`; `null` = no icon (empty cell). Default: an x icon. */
+    false?: SVGIcon | null;
+    /** CSS colour of the `true` icon. Default: `var(--mm-list-boolean-true-color, var(--kendo-color-success))`. */
+    trueColor?: string;
+    /** CSS colour of the `false` icon. Default: `var(--mm-list-boolean-false-color, var(--kendo-color-subtle))`. */
+    falseColor?: string;
+}
 type ColumnDefinition = string | TableColumn;
 type ContextMenuType = 'contextMenu' | 'actionMenu';
 /**
@@ -281,6 +304,34 @@ interface ListViewMessages {
     pagerNextPage: string;
     /** Grid: no records message. Default: "No records available." */
     noRecords: string;
+    /** Empty state title while a search or filter matches nothing (`emptyState` set, AB#3444). Default: "No results". Optional. */
+    noResultsTitle?: string;
+    /** Empty state text while a search or filter matches nothing (AB#3444). Default: "Nothing matches the current search or filter." Optional. */
+    noResultsText?: string;
+    /** Accessible value of a `booleanIcon` cell that is true (AB#5623). Default: "Yes". Optional. */
+    booleanYes?: string;
+    /** Accessible value of a `booleanIcon` cell that is false (AB#5623). Default: "No". Optional. */
+    booleanNo?: string;
+    /** Accessible name of a `booleanIcon` cell; `{column}` = column name, `{value}` = Yes / No (AB#5623). Default: "{column}: {value}". Optional. */
+    booleanIconLabel?: string;
+}
+/**
+ * Texts of the list's shared empty state (`mm-list-view [emptyState]`, AB#3444). `title` / `text`
+ * describe a list without records ("No data flows yet"); the `filtered*` texts override the
+ * "no results" texts of {@link ListViewMessages} while a search or filter is active.
+ */
+interface MmListEmptyState {
+    title: string;
+    text?: string | null;
+    filteredTitle?: string | null;
+    filteredText?: string | null;
+}
+/** Template context of `mm-list-view [emptyTemplate]` (AB#3444). */
+interface MmListEmptyContext {
+    /** Same as `filtered`. */
+    $implicit: boolean;
+    /** A search, row filter or host filter is active (an empty list means "no results"). */
+    filtered: boolean;
 }
 /**
  * One entry of the list toolbar's command group (row filter, exports, reset,
@@ -400,6 +451,18 @@ declare const MM_ACTION_ICONS: {
     readonly report: SVGIcon;
     /** Restore / roll back to a stored state (e.g. restore a dump); destructive restores are `danger`. */
     readonly restore: SVGIcon;
+    /** Pin to a start page / favourites ("Pin to Home"). */
+    readonly pin: SVGIcon;
+    /** Remove a pin ("Unpin from Home"). */
+    readonly unpin: SVGIcon;
+    /** Merge one item into another (e.g. merge users); usually `danger`. */
+    readonly merge: SVGIcon;
+    /** Reset / set a password. */
+    readonly resetPassword: SVGIcon;
+    /** Fill a past time range from the source data (e.g. rollup backfill). */
+    readonly backfill: SVGIcon;
+    /** Recalculate derived values for a range (e.g. rollup recompute); not the same as `refresh`. */
+    readonly recompute: SVGIcon;
 };
 type MmActionIconName = keyof typeof MM_ACTION_ICONS;
 /** True when the action is disabled (non-empty {@link MmAction.disabledReason}). */
@@ -468,6 +531,13 @@ interface ResolvedListRowAction {
     commandItem?: CommandItem;
     rowAction?: MmListRowAction;
 }
+/**
+ * Human label of a list row (AB#5623) — the row's name in row action names ("Actions for <label>"),
+ * dialog titles and danger confirmations. Reads `field` (a dotted path such as `contact.displayName`
+ * also works, a flat key with dots wins), then each of `fallbacks` (default `rtWellKnownName`,
+ * `rtId`); the first non-blank value wins. `''` when none is set.
+ */
+declare function resolveListRowLabel(row: unknown, field: string | null | undefined, fallbacks?: readonly string[]): string;
 /** Resolves the per-row callbacks of a {@link MmListRowAction}. */
 declare function resolveListRowAction(definition: MmListRowAction, row: unknown): MmAction;
 /** Structural equality of two rendered actions (keeps object identity stable across change detection). */
@@ -501,6 +571,12 @@ declare class ListViewComponent extends CommandBaseService implements OnDestroy,
     protected _showRowFilter: boolean;
     /** Indicates if the data source is currently loading data */
     protected isLoading: _angular_core.WritableSignal<boolean>;
+    /**
+     * Whether the data source reported "not loading" at least once (AB#3444). {@link isLoading}
+     * follows the data source one macrotask late (asyncScheduler), so the first render would
+     * otherwise show the empty state while the first fetch is already in flight.
+     */
+    protected readonly loadSettled: _angular_core.WritableSignal<boolean>;
     /**
      * The component's own width in pixels, kept current via ResizeObserver.
      * `null` until the first measurement (before that, all columns render visible
@@ -682,6 +758,25 @@ declare class ListViewComponent extends CommandBaseService implements OnDestroy,
      * those host filters by itself.
      */
     hasExternalFilters: boolean;
+    /**
+     * Empty state of the list (AB#3444): when set, a list without records shows the shared
+     * `mm-empty-state` — one OctoBot `idle` with {@link MmListEmptyState.title} / `text` — instead
+     * of the plain "No records available." line; while a search, row filter or host filter
+     * ({@link hasExternalFilters}) is active it shows OctoBot `look` with the "no results" texts.
+     * Nothing is shown while the list loads (including before the first fetch answered). The figure appears once per list, never in rows.
+     */
+    emptyState: MmListEmptyState | null;
+    /**
+     * Fully custom empty state (wins over {@link emptyState}). Context: `$implicit` / `filtered`
+     * is `true` while a search or filter is active.
+     */
+    emptyTemplate: TemplateRef<MmListEmptyContext> | null;
+    /**
+     * Whether a search, row filter or host filter narrows the rows right now (sorting does not),
+     * i.e. an empty list means "no results" rather than "no records yet".
+     */
+    protected get isFiltered(): boolean;
+    protected get emptyContext(): MmListEmptyContext;
     /**
      * Whether anything narrows or reorders the default view right now: a row
      * filter, a column sort, free-text search, or host-side filters announced
@@ -820,6 +915,15 @@ declare class ListViewComponent extends CommandBaseService implements OnDestroy,
      */
     protected getCellTitle(element: Record<string, unknown>, column: TableColumn): string | null;
     protected getFilterType(column: TableColumn): 'text' | 'numeric' | 'boolean' | 'date';
+    /**
+     * State of a `booleanIcon` cell (AB#5623): `'true'` / `'false'` for booleans (also the strings
+     * "true" / "false"), `null` for an empty or non-boolean value (empty cell).
+     */
+    protected booleanIconState(element: Record<string, unknown>, column: TableColumn): 'true' | 'false' | null;
+    /** Icon of a `booleanIcon` cell: the column's `booleanIcons`, else check / x; `null` = no icon. */
+    protected booleanIcon(column: TableColumn, state: 'true' | 'false'): SVGIcon$1 | null;
+    /** Accessible name of a `booleanIcon` cell: "<column>: Yes|No" from the messages (AB#5623). */
+    protected booleanIconLabel(column: TableColumn, state: 'true' | 'false'): string;
     /** Input attributes of a read-only boolean cell, cached per column and name (AB#5621). */
     private readonly booleanCellAttributeCache;
     /**
@@ -902,7 +1006,8 @@ declare class ListViewComponent extends CommandBaseService implements OnDestroy,
     protected onSelectOptionActionItem(event: Event, dataItem: unknown, menuItem: MenuItem): Promise<void>;
     /**
      * Row field naming a row for assistive technology (row menu "Actions for <name>", action
-     * buttons "<action> <name>"). Falls back to `rtWellKnownName`, then `rtId`.
+     * buttons "<action> <name>"). Falls back to `rtWellKnownName`, then `rtId`. A dotted path
+     * (`contact.displayName`) reads a nested value (AB#5623).
      */
     rowLabelField: string;
     /** Human name of a row (`rowLabelField`, `rtWellKnownName`, `rtId`), or '' when unknown. */
@@ -941,7 +1046,7 @@ declare class ListViewComponent extends CommandBaseService implements OnDestroy,
      */
     protected readonly commandsIcon: SVGIcon$1;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ListViewComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ListViewComponent, "mm-list-view", never, { "pageSize": { "alias": "pageSize"; "required": false; }; "skip": { "alias": "skip"; "required": false; }; "autoPageSize": { "alias": "autoPageSize"; "required": false; }; "rowIsClickable": { "alias": "rowIsClickable"; "required": false; }; "showRowCheckBoxes": { "alias": "showRowCheckBoxes"; "required": false; }; "showRowSelectAllCheckBox": { "alias": "showRowSelectAllCheckBox"; "required": false; }; "contextMenuType": { "alias": "contextMenuType"; "required": false; }; "leftToolbarActions": { "alias": "leftToolbarActions"; "required": false; }; "rightToolbarActions": { "alias": "rightToolbarActions"; "required": false; }; "actionCommandItems": { "alias": "actionCommandItems"; "required": false; }; "contextMenuCommandItems": { "alias": "contextMenuCommandItems"; "required": false; }; "rowActions": { "alias": "rowActions"; "required": false; }; "maxInlineRowActions": { "alias": "maxInlineRowActions"; "required": false; }; "excelExportFileName": { "alias": "excelExportFileName"; "required": false; }; "pdfExportFileName": { "alias": "pdfExportFileName"; "required": false; }; "pageable": { "alias": "pageable"; "required": false; }; "sortable": { "alias": "sortable"; "required": false; }; "rowFilterEnabled": { "alias": "rowFilterEnabled"; "required": false; }; "searchTextBoxEnabled": { "alias": "searchTextBoxEnabled"; "required": false; }; "persistListState": { "alias": "persistListState"; "required": false; }; "listStateKey": { "alias": "listStateKey"; "required": false; }; "resizable": { "alias": "resizable"; "required": false; }; "actionsColumnWidth": { "alias": "actionsColumnWidth"; "required": false; }; "hideCheckboxesBelow": { "alias": "hideCheckboxesBelow"; "required": false; }; "cardModeBelow": { "alias": "cardModeBelow"; "required": false; }; "collapseCommandsBelow": { "alias": "collapseCommandsBelow"; "required": false; }; "hasExternalFilters": { "alias": "hasExternalFilters"; "required": false; }; "rowClass": { "alias": "rowClass"; "required": false; }; "messages": { "alias": "messages"; "required": false; }; "selectable": { "alias": "selectable"; "required": false; }; "columns": { "alias": "columns"; "required": false; }; "rowLabelField": { "alias": "rowLabelField"; "required": false; }; }, { "rowClicked": "rowClicked"; "rowAction": "rowAction"; "resetFilters": "resetFilters"; }, ["filtersTemplate"], never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ListViewComponent, "mm-list-view", never, { "pageSize": { "alias": "pageSize"; "required": false; }; "skip": { "alias": "skip"; "required": false; }; "autoPageSize": { "alias": "autoPageSize"; "required": false; }; "rowIsClickable": { "alias": "rowIsClickable"; "required": false; }; "showRowCheckBoxes": { "alias": "showRowCheckBoxes"; "required": false; }; "showRowSelectAllCheckBox": { "alias": "showRowSelectAllCheckBox"; "required": false; }; "contextMenuType": { "alias": "contextMenuType"; "required": false; }; "leftToolbarActions": { "alias": "leftToolbarActions"; "required": false; }; "rightToolbarActions": { "alias": "rightToolbarActions"; "required": false; }; "actionCommandItems": { "alias": "actionCommandItems"; "required": false; }; "contextMenuCommandItems": { "alias": "contextMenuCommandItems"; "required": false; }; "rowActions": { "alias": "rowActions"; "required": false; }; "maxInlineRowActions": { "alias": "maxInlineRowActions"; "required": false; }; "excelExportFileName": { "alias": "excelExportFileName"; "required": false; }; "pdfExportFileName": { "alias": "pdfExportFileName"; "required": false; }; "pageable": { "alias": "pageable"; "required": false; }; "sortable": { "alias": "sortable"; "required": false; }; "rowFilterEnabled": { "alias": "rowFilterEnabled"; "required": false; }; "searchTextBoxEnabled": { "alias": "searchTextBoxEnabled"; "required": false; }; "persistListState": { "alias": "persistListState"; "required": false; }; "listStateKey": { "alias": "listStateKey"; "required": false; }; "resizable": { "alias": "resizable"; "required": false; }; "actionsColumnWidth": { "alias": "actionsColumnWidth"; "required": false; }; "hideCheckboxesBelow": { "alias": "hideCheckboxesBelow"; "required": false; }; "cardModeBelow": { "alias": "cardModeBelow"; "required": false; }; "collapseCommandsBelow": { "alias": "collapseCommandsBelow"; "required": false; }; "hasExternalFilters": { "alias": "hasExternalFilters"; "required": false; }; "emptyState": { "alias": "emptyState"; "required": false; }; "emptyTemplate": { "alias": "emptyTemplate"; "required": false; }; "rowClass": { "alias": "rowClass"; "required": false; }; "messages": { "alias": "messages"; "required": false; }; "selectable": { "alias": "selectable"; "required": false; }; "columns": { "alias": "columns"; "required": false; }; "rowLabelField": { "alias": "rowLabelField"; "required": false; }; }, { "rowClicked": "rowClicked"; "rowAction": "rowAction"; "resetFilters": "resetFilters"; }, ["filtersTemplate"], never, true, never>;
 }
 
 declare const upload: {
@@ -3183,6 +3288,29 @@ declare class ActionButtonComponent<TId extends string = string> {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ActionButtonComponent<any>, "mm-action-button", never, { "action": { "alias": "action"; "required": true; "isSignal": true; }; "targetLabel": { "alias": "targetLabel"; "required": false; "isSignal": true; }; "context": { "alias": "context"; "required": false; "isSignal": true; }; "display": { "alias": "display"; "required": false; "isSignal": true; }; "primary": { "alias": "primary"; "required": false; "isSignal": true; }; }, { "triggered": "triggered"; }, never, never, true, never>;
 }
 
+/**
+ * Texts of `mm-row-actions` (G16). `{name}` is replaced by the row label; the `…For` members are
+ * used when the row has a label, the plain ones when it is empty.
+ */
+interface RowActionsMessages {
+    /** Accessible name of the action group: "Actions for {name}". */
+    actionsFor: string;
+    /** Group name without a row label. */
+    actions: string;
+    /** Accessible name and tooltip of the overflow button: "More actions for {name}". */
+    moreActionsFor: string;
+    /** Overflow button without a row label. */
+    moreActions: string;
+}
+declare const DEFAULT_ROW_ACTIONS_MESSAGES: RowActionsMessages;
+/** App-wide translations of `mm-row-actions`. Partial: members left out keep their English default. */
+declare const MM_ROW_ACTIONS_MESSAGES: InjectionToken<Partial<RowActionsMessages>>;
+/**
+ * Merges overrides over {@link DEFAULT_ROW_ACTIONS_MESSAGES}, later sources winning; members that
+ * are missing, `undefined` or `null` keep the earlier value.
+ */
+declare function resolveRowActionsMessages(...overrides: (Partial<RowActionsMessages> | null | undefined)[]): RowActionsMessages;
+
 /** Overflow menu item handed to the Kendo DropDownButton. */
 interface RowActionMenuItem<TId extends string> {
     text: string;
@@ -3197,6 +3325,9 @@ interface RowActionMenuItem<TId extends string> {
  * "More actions for …" menu. Disabled actions stay focusable and announce their reason;
  * in the menu the reason is shown under the item text.
  *
+ * Texts ("Actions for …", "More actions for …") come from {@link MM_ROW_ACTIONS_MESSAGES} and the
+ * `messages` input (the input wins), English by default.
+ *
  * The component only emits — destructive handlers confirm first (danger dialog naming the target).
  *
  * ```html
@@ -3212,12 +3343,16 @@ declare class RowActionsComponent<TId extends string = string> {
     readonly rowLabel: _angular_core.InputSignal<string>;
     /** Slots incl. the overflow button. */
     readonly maxInline: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Translations for this instance; members left out come from `MM_ROW_ACTIONS_MESSAGES`, else English. */
+    readonly messages: _angular_core.InputSignal<Partial<RowActionsMessages> | null>;
     /** Fires for enabled actions only, inline or from the menu. */
     readonly triggered: _angular_core.OutputEmitterRef<MmActionEvent<TId>>;
     private readonly router;
     /** Menu links resolve like the inline `routerLink`: relative to the hosting route. */
     private readonly route;
+    private readonly injectedMessages;
     protected readonly moreIcon: _progress_kendo_svg_icons.SVGIcon;
+    private readonly m;
     protected readonly split: _angular_core.Signal<{
         inline: MmAction<TId>[];
         menu: MmAction<TId>[];
@@ -3227,12 +3362,141 @@ declare class RowActionsComponent<TId extends string = string> {
     protected readonly hasActions: _angular_core.Signal<boolean>;
     protected readonly moreLabel: _angular_core.Signal<string>;
     protected readonly groupLabel: _angular_core.Signal<string>;
+    private format;
     protected onMenuItem(item: RowActionMenuItem<TId>): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<RowActionsComponent<any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<RowActionsComponent<any>, "mm-row-actions", never, { "actions": { "alias": "actions"; "required": true; "isSignal": true; }; "rowLabel": { "alias": "rowLabel"; "required": true; "isSignal": true; }; "maxInline": { "alias": "maxInline"; "required": false; "isSignal": true; }; }, { "triggered": "triggered"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<RowActionsComponent<any>, "mm-row-actions", never, { "actions": { "alias": "actions"; "required": true; "isSignal": true; }; "rowLabel": { "alias": "rowLabel"; "required": true; "isSignal": true; }; "maxInline": { "alias": "maxInline"; "required": false; "isSignal": true; }; "messages": { "alias": "messages"; "required": false; "isSignal": true; }; }, { "triggered": "triggered"; }, never, never, true, never>;
+}
+
+/** The OctoBot animations shipped with shared-ui (AB#3444). */
+type OctoBotAnimation = 'idle' | 'blink' | 'look' | 'swim' | 'thinking' | 'wave';
+/**
+ * Image loading strategy (`loading` attribute): `lazy` (default) defers the request until the
+ * figure nears the viewport; `eager` loads it right away — for places where the figure is visible
+ * immediately (empty states, 404 / turned-off pages), so it does not pop in late.
+ */
+type OctoBotLoading = 'lazy' | 'eager';
+/** Rendered sizes: `sm` 60 px, `md` 120 px, `lg` 240 px (square). */
+type OctoBotSize = 'sm' | 'md' | 'lg';
+/** Pixel edge length of each {@link OctoBotSize}. */
+declare const OCTOBOT_SIZE_PX: Readonly<Record<OctoBotSize, number>>;
+/**
+ * Length of one loop of each animation in ms (identical for all sizes; read from the WebP frame
+ * durations). Used by `playOnce`.
+ */
+declare const OCTOBOT_LOOP_MS: Readonly<Record<OctoBotAnimation, number>>;
+/**
+ * Base URL of the OctoBot images, with a trailing slash. Default `assets/octobot/` (relative to
+ * the document base). The files ship as library assets in
+ * `node_modules/@meshmakers/shared-ui/assets/octobot`; a host app copies them with an
+ * `angular.json` assets entry:
+ *
+ * ```json
+ * { "glob": "**\/*", "input": "node_modules/@meshmakers/shared-ui/assets/octobot", "output": "/assets/octobot" }
+ * ```
+ *
+ * Provide a different value when the app serves them elsewhere (a CDN, a sub path).
+ */
+declare const OCTOBOT_ASSET_BASE_URL: InjectionToken<string>;
+/**
+ * App-wide "show stills only" switch, e.g. bound to a user setting "Reduce animations". When
+ * `true`, every `mm-octobot` shows its still frame regardless of `prefers-reduced-motion`.
+ */
+declare const OCTOBOT_FORCE_STILL: InjectionToken<boolean>;
+/**
+ * `mm-octobot` — the meshmakers OctoBot mascot as a small animated pixel-art image (AB#3444).
+ *
+ * Renders one `<img>` with a fixed width and height (no layout shift), `loading="lazy"` (or
+ * `eager` via the `loading` input),
+ * `decoding="async"` and `image-rendering: pixelated`. The image is an 8-frame animated WebP
+ * loaded by URL from {@link OCTOBOT_ASSET_BASE_URL} — nothing lands in the JS bundle.
+ *
+ * **Reduced motion:** while the user prefers reduced motion (`prefers-reduced-motion: reduce`,
+ * followed live via `matchMedia`), when {@link OCTOBOT_FORCE_STILL} is `true` or when the `still`
+ * input is set, the first frame is shown as a static PNG instead.
+ *
+ * **Accessibility:** without a `label` the figure is decorative (`alt=""`, `aria-hidden="true"`);
+ * the surrounding text must carry the meaning (e.g. "Thinking…" next to `thinking`). With a
+ * `label` the host gets `role="img"` and `aria-label`.
+ *
+ * **Placement rules (host responsibility, see `docs/actions.md` › OctoBot):** at most one
+ * animated OctoBot per view — empty states (once per page), page loading, the assistant panel,
+ * 404 / turned-off pages, onboarding. Never inside repeated elements (list rows, table cells,
+ * cockpit tiles, buttons) and never in toasts or error messages (a still frame is acceptable
+ * there if a figure is wanted at all).
+ *
+ * @example
+ * ```html
+ * <mm-octobot animation="idle" size="md" />
+ * <mm-octobot animation="thinking" size="sm" label="The assistant is thinking" />
+ * ```
+ */
+declare class OctoBotComponent {
+    private readonly baseUrl;
+    private readonly forceStill;
+    /** Which animation to play. Default `idle`. */
+    readonly animation: _angular_core.InputSignal<OctoBotAnimation>;
+    /** Rendered size. Default `md` (120 px). */
+    readonly size: _angular_core.InputSignal<OctoBotSize>;
+    /** Accessible name; when empty the figure is decorative. */
+    readonly label: _angular_core.InputSignal<string | null | undefined>;
+    /** Image loading strategy; `eager` where the figure is visible right away. Default `lazy`. */
+    readonly loading: _angular_core.InputSignal<OctoBotLoading>;
+    /** Show the still frame instead of the animation (e.g. after the assistant finished). */
+    readonly still: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Plays the animation once ({@link OCTOBOT_LOOP_MS}) and then rests on the still frame — for
+     * greetings (`wave`) that should not loop forever. The WebPs themselves loop endlessly.
+     */
+    readonly playOnce: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    private readonly prefersReducedMotion;
+    private readonly played;
+    protected readonly px: _angular_core.Signal<number>;
+    protected readonly showStill: _angular_core.Signal<boolean>;
+    protected readonly src: _angular_core.Signal<string>;
+    constructor();
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<OctoBotComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<OctoBotComponent, "mm-octobot", never, { "animation": { "alias": "animation"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "still": { "alias": "still"; "required": false; "isSignal": true; }; "playOnce": { "alias": "playOnce"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * - `empty`: a list or page has no records yet → OctoBot `idle`.
+ * - `no-results`: a search or filter matches nothing → OctoBot `look`.
+ * - `error`: loading failed → no figure (errors stay sober), `role="alert"`, optional "Try again".
+ */
+type EmptyStateVariant = 'empty' | 'no-results' | 'error';
+/** Default English "Try again" label of {@link EmptyStateComponent}. */
+declare const DEFAULT_EMPTY_STATE_RETRY_LABEL = "Try again";
+/**
+ * `mm-empty-state` — the shared empty / no-results / error block of a page or list (AB#3444).
+ *
+ * One per page or list, never per row. The `empty` and `no-results` variants show one OctoBot
+ * (`idle` / `look`, decorative) above the title; the `error` variant shows no figure and announces
+ * itself as an alert. Project extra actions (e.g. "New data flow") as content.
+ *
+ * @example
+ * ```html
+ * <mm-empty-state heading="No data flows yet" text="Create your first data flow to start processing data." />
+ * <mm-empty-state variant="error" heading="The blueprints could not be loaded." showRetry (retry)="load()" />
+ * ```
+ */
+declare class EmptyStateComponent {
+    readonly variant: _angular_core.InputSignal<EmptyStateVariant>;
+    readonly heading: _angular_core.InputSignal<string>;
+    readonly text: _angular_core.InputSignal<string | null | undefined>;
+    /** OctoBot size of the `empty` / `no-results` variants. Default `md`. */
+    readonly size: _angular_core.InputSignal<OctoBotSize>;
+    /** Shows the "Try again" button (error variant only). */
+    readonly showRetry: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly retryLabel: _angular_core.InputSignal<string>;
+    /** Emitted by the "Try again" button. */
+    readonly retry: _angular_core.OutputEmitterRef<void>;
+    protected readonly figure: _angular_core.Signal<OctoBotAnimation | null>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<EmptyStateComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EmptyStateComponent, "mm-empty-state", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "heading": { "alias": "heading"; "required": true; "isSignal": true; }; "text": { "alias": "text"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "showRetry": { "alias": "showRetry"; "required": false; "isSignal": true; }; "retryLabel": { "alias": "retryLabel"; "required": false; "isSignal": true; }; }, { "retry": "retry"; }, never, ["*"], true, never>;
 }
 
 declare function provideMmSharedUi(): EnvironmentProviders;
 
-export { ActionButtonComponent, BaseFormComponent, BaseTreeDetailComponent, ButtonTypes, BytesToSizePipe, CRON_PRESETS, ConfirmationService, ConfirmationWindowComponent, ConfirmationWindowResult, CopyableTextComponent, CronBuilderComponent, CronHumanizerService, CronParserService, DANGER_CONFIRM_ENVIRONMENT, DANGER_CONFIRM_FALLBACK_WORD, DANGER_CONFIRM_SAFE_FOCUS, DEFAULT_CONFIRMATION_WINDOW_MESSAGES, DEFAULT_CRON_BUILDER_CONFIG, DEFAULT_DANGER_CONFIRMATION_MESSAGES, DEFAULT_ENTITY_SELECT_DIALOG_MESSAGES, DEFAULT_ENTITY_SELECT_INPUT_MESSAGES, DEFAULT_INPUT_DIALOG_MESSAGES, DEFAULT_LIST_VIEW_MESSAGES, DEFAULT_MESSAGE_DETAILS_DIALOG_MESSAGES, DEFAULT_NOTIFICATION_DISPLAY_MESSAGES, DEFAULT_PROGRESS_WINDOW_MESSAGES, DEFAULT_RESPONSIVE_COLSPAN, DEFAULT_SAVE_AS_DIALOG_MESSAGES, DEFAULT_TIME_RANGE_LABELS, DangerConfirmationResult, DangerConfirmationWindowComponent, DataSourceBase, DataSourceTyped, DialogType, EntitySelectDialogComponent, EntitySelectDialogService, EntitySelectInputComponent, FetchResultBase, FetchResultTyped, FileUploadResult, FileUploadService, FormTitleExtraDirective, HAS_UNSAVED_CHANGES, HOUR_INTERVALS, HierarchyDataSource, HierarchyDataSourceBase, ImportStrategyDialogComponent, ImportStrategyDialogResult, ImportStrategyDialogService, ImportStrategyDto, InputDialogComponent, InputService, ListStateService, ListViewComponent, ListViewFiltersDirective, MINUTE_INTERVALS, MM_ACTION_ICONS, MM_ROW_ACTIONS_MAX_INLINE, MessageDetailsDialogComponent, MessageDetailsDialogService, MessageListenerService, MmListViewDataBindingDirective, NOTIFICATION_DISPLAY_OPTIONS, NotificationDisplayService, PascalCasePipe, ProgressValue, ProgressWindowComponent, ProgressWindowService, RELATIVE_WEEKS, RowActionsComponent, SECOND_INTERVALS, SaveAsDialogComponent, SaveAsDialogService, TimeRangePickerComponent, TimeRangeUtils, TreeComponent, UnsavedChangesDirective, UnsavedChangesGuard, UploadFileDialogComponent, WEEKDAYS, WEEKDAY_ABBREVIATIONS, WindowStateService, actionAccessibleName, actionTooltip, applyDangerConfirmEnvironment, dangerConfirmNameMatches, dangerConfirmTypingToken, generateDayOfMonthOptions, generateHourOptions, generateMinuteOptions, isActionDisabled, isActionVisible, provideMmSharedUi, resolveListRowAction, resolveListViewMessages, sameAction, splitRowActions };
-export type { BadgeMapping, BadgeMappingTable, BaseFormConfig, BaseFormMessages, ColumnDefinition, ConfirmationButtonLabels, ConfirmationWindowData, ConfirmationWindowMessages, ContextMenuType, CronBuilderConfig, CronFields, CronPreset, CronSchedule, CronValidationResult, DangerConfirmEnvironment, DangerConfirmationMessages, DangerConfirmationOptions, DialogFetchOptions, DialogFetchResult, DropdownOption, EntitySelectDialogDataSource, EntitySelectDialogMessages, EntitySelectDialogOptions, EntitySelectDialogResult, EntitySelectInputMessages, FetchAgainOptions, FetchDataOptions, FetchResult, FileUploadData, HasUnsavedChanges, InputDialogMessages, ListViewCommand, ListViewMessages, MessageDetailsDialogData, MessageDetailsDialogMessages, MmAction, MmActionContext, MmActionDisplay, MmActionEvent, MmActionIconName, MmActionLink, MmListRowAction, MmListRowActionEvent, NameAvailabilityResult, NodeDroppedEvent, NodeInfo, NotificationDisplayMessages, NotificationDisplayOptions, PersistedListState, ProgressWindowConfig, ProgressWindowData, ProgressWindowMessages, ProgressWindowOptions, ProgressWindowResult, Quarter, RelativeTimeUnit, ResolvedListRowAction, ResponsiveFormBreakPoint, RowActionsView, RowClassFn, SaveAsDialogDataSource, SaveAsDialogMessages, SaveAsDialogOptions, SaveAsDialogResult, ScheduleType, StatusFieldConfig, StatusIconMapping, StatusMapping, TableColumn, TimeRange, TimeRangeISO, TimeRangeOption, TimeRangePickerConfig, TimeRangePickerLabels, TimeRangeSelection, TimeRangeType, TimeRangeZone, UnsavedChangesMessages, Weekday, WindowDimensions };
+export { ActionButtonComponent, BaseFormComponent, BaseTreeDetailComponent, ButtonTypes, BytesToSizePipe, CRON_PRESETS, ConfirmationService, ConfirmationWindowComponent, ConfirmationWindowResult, CopyableTextComponent, CronBuilderComponent, CronHumanizerService, CronParserService, DANGER_CONFIRM_ENVIRONMENT, DANGER_CONFIRM_FALLBACK_WORD, DANGER_CONFIRM_SAFE_FOCUS, DEFAULT_CONFIRMATION_WINDOW_MESSAGES, DEFAULT_CRON_BUILDER_CONFIG, DEFAULT_DANGER_CONFIRMATION_MESSAGES, DEFAULT_EMPTY_STATE_RETRY_LABEL, DEFAULT_ENTITY_SELECT_DIALOG_MESSAGES, DEFAULT_ENTITY_SELECT_INPUT_MESSAGES, DEFAULT_INPUT_DIALOG_MESSAGES, DEFAULT_LIST_VIEW_MESSAGES, DEFAULT_MESSAGE_DETAILS_DIALOG_MESSAGES, DEFAULT_NOTIFICATION_DISPLAY_MESSAGES, DEFAULT_PROGRESS_WINDOW_MESSAGES, DEFAULT_RESPONSIVE_COLSPAN, DEFAULT_ROW_ACTIONS_MESSAGES, DEFAULT_SAVE_AS_DIALOG_MESSAGES, DEFAULT_TIME_RANGE_LABELS, DangerConfirmationResult, DangerConfirmationWindowComponent, DataSourceBase, DataSourceTyped, DialogType, EmptyStateComponent, EntitySelectDialogComponent, EntitySelectDialogService, EntitySelectInputComponent, FetchResultBase, FetchResultTyped, FileUploadResult, FileUploadService, FormTitleExtraDirective, HAS_UNSAVED_CHANGES, HOUR_INTERVALS, HierarchyDataSource, HierarchyDataSourceBase, ImportStrategyDialogComponent, ImportStrategyDialogResult, ImportStrategyDialogService, ImportStrategyDto, InputDialogComponent, InputService, ListStateService, ListViewComponent, ListViewFiltersDirective, MINUTE_INTERVALS, MM_ACTION_ICONS, MM_ROW_ACTIONS_MAX_INLINE, MM_ROW_ACTIONS_MESSAGES, MessageDetailsDialogComponent, MessageDetailsDialogService, MessageListenerService, MmListViewDataBindingDirective, NOTIFICATION_DISPLAY_OPTIONS, NotificationDisplayService, OCTOBOT_ASSET_BASE_URL, OCTOBOT_FORCE_STILL, OCTOBOT_LOOP_MS, OCTOBOT_SIZE_PX, OctoBotComponent, PascalCasePipe, ProgressValue, ProgressWindowComponent, ProgressWindowService, RELATIVE_WEEKS, RowActionsComponent, SECOND_INTERVALS, SaveAsDialogComponent, SaveAsDialogService, TimeRangePickerComponent, TimeRangeUtils, TreeComponent, UnsavedChangesDirective, UnsavedChangesGuard, UploadFileDialogComponent, WEEKDAYS, WEEKDAY_ABBREVIATIONS, WindowStateService, actionAccessibleName, actionTooltip, applyDangerConfirmEnvironment, dangerConfirmNameMatches, dangerConfirmTypingToken, generateDayOfMonthOptions, generateHourOptions, generateMinuteOptions, isActionDisabled, isActionVisible, provideMmSharedUi, resolveListRowAction, resolveListRowLabel, resolveListViewMessages, resolveRowActionsMessages, sameAction, splitRowActions };
+export type { BadgeMapping, BadgeMappingTable, BaseFormConfig, BaseFormMessages, BooleanIconMapping, ColumnDefinition, ConfirmationButtonLabels, ConfirmationWindowData, ConfirmationWindowMessages, ContextMenuType, CronBuilderConfig, CronFields, CronPreset, CronSchedule, CronValidationResult, DangerConfirmEnvironment, DangerConfirmationMessages, DangerConfirmationOptions, DialogFetchOptions, DialogFetchResult, DropdownOption, EmptyStateVariant, EntitySelectDialogDataSource, EntitySelectDialogMessages, EntitySelectDialogOptions, EntitySelectDialogResult, EntitySelectInputMessages, FetchAgainOptions, FetchDataOptions, FetchResult, FileUploadData, HasUnsavedChanges, InputDialogMessages, ListViewCommand, ListViewMessages, MessageDetailsDialogData, MessageDetailsDialogMessages, MmAction, MmActionContext, MmActionDisplay, MmActionEvent, MmActionIconName, MmActionLink, MmListEmptyContext, MmListEmptyState, MmListRowAction, MmListRowActionEvent, NameAvailabilityResult, NodeDroppedEvent, NodeInfo, NotificationDisplayMessages, NotificationDisplayOptions, OctoBotAnimation, OctoBotLoading, OctoBotSize, PersistedListState, ProgressWindowConfig, ProgressWindowData, ProgressWindowMessages, ProgressWindowOptions, ProgressWindowResult, Quarter, RelativeTimeUnit, ResolvedListRowAction, ResponsiveFormBreakPoint, RowActionsMessages, RowActionsView, RowClassFn, SaveAsDialogDataSource, SaveAsDialogMessages, SaveAsDialogOptions, SaveAsDialogResult, ScheduleType, StatusFieldConfig, StatusIconMapping, StatusMapping, TableColumn, TimeRange, TimeRangeISO, TimeRangeOption, TimeRangePickerConfig, TimeRangePickerLabels, TimeRangeSelection, TimeRangeType, TimeRangeZone, UnsavedChangesMessages, Weekday, WindowDimensions };