@meshmakers/shared-ui 3.4.1480 → 3.5.0

package/README.md

@@ -137,6 +137,10 @@ Configurable data grid with Kendo Grid integration.
 
 **Features:** Pagination, sorting, filtering, row selection, search, context menus, action menus, Excel/PDF export, toolbar actions, column types (text, numeric, boolean, date, bytes, status icons, cron expressions).
 
+Empty state (AB#3444): `[emptyState]="{ title, text }"` shows the shared `mm-empty-state` (OctoBot `idle`) for a list without records and the "no results" variant (OctoBot `look`) while a search or filter is active; `[emptyTemplate]` replaces it. Without either the list keeps the plain "No records available." line.
+
+The toolbar's "Reset Filters" button only appears while something narrows the default view: a row filter, a column sort, a free-text search, or host-side filters. Hosts with their own quick-view/bar filters announce them via `[hasExternalFilters]="myBarFilterIsSet"` so the button shows (and `(resetFilters)` lets them clear those filters when it is clicked).
+
 ```html
 <mm-list-view
   appMyDataSource
@@ -182,6 +186,33 @@ Hierarchical tree view with Kendo TreeView, drag-drop support, and expandable no
 
 Display text with a one-click copy-to-clipboard button.
 
+### Actions (`mm-row-actions`, `mm-action-button`)
+
+Row, toolbar and page actions from one shared `MmAction` definition (id, label, icon, danger,
+disabled reason, visible): icon buttons with tooltip and a row-specific accessible name, max. 3
+inline slots with a "More actions" menu, focusable disabled actions that announce their reason,
+and a canonical verb→icon map (`MM_ACTION_ICONS`). See [Actions](docs/actions.md).
+
+```html
+<mm-row-actions [actions]="actionsFor(row)" [rowLabel]="row.name" (triggered)="onAction($event, row)" />
+<mm-action-button [action]="refresh" context="toolbar" (triggered)="reload()" />
+```
+
+### OctoBot (`mm-octobot`, `mm-empty-state`)
+
+The meshmakers mascot as a small animated pixel-art image (`idle`, `blink`, `look`, `swim`,
+`thinking`, `wave`; `sm`/`md`/`lg`), loaded by URL from the library assets (copy
+`node_modules/@meshmakers/shared-ui/assets/octobot` to `/assets/octobot` in `angular.json`;
+base URL via `OCTOBOT_ASSET_BASE_URL`). Decorative unless labelled; still frame under
+`prefers-reduced-motion`. `mm-empty-state` is the shared empty / no-results / error block, and
+`mm-list-view [emptyState]` renders it once per list. Placement rules (never in rows, tiles,
+buttons, toasts or errors): see [OctoBot](docs/octobot.md).
+
+```html
+<mm-octobot animation="wave" size="md" playOnce />
+<mm-list-view [emptyState]="{ title: 'No data flows yet', text: 'Create your first data flow.' }" ...></mm-list-view>
+```
+
 ### EntitySelectInputComponent (`mm-entity-select-input`)
 
 Autocomplete input for entity selection with dialog fallback.
@@ -196,6 +227,9 @@ All complex dialogs are opened via injected services:
 | | `showYesNoCancelConfirmationDialog()` | Yes/No/Cancel with result |
 | | `showOkCancelConfirmationDialog()` | Ok/Cancel confirmation |
 | | `showOkDialog()` | Ok-only information dialog |
+| | `showDestructiveConfirmationDialog(title, message, confirmLabel, cancelLabel = 'Cancel')` | Destructive action: verb labels (e.g. Rotate / Cancel), confirming button styled as danger |
+
+All confirmation dialogs are `min(320px, 100vw − 32px)` to `min(560px, 100vw − 32px)` wide, so a long message wraps instead of stretching the dialog across the viewport.
 | `InputService` | — | Text input dialog |
 | `FileUploadService` | — | File upload dialog |
 | `ProgressWindowService` | `showDeterminateProgress()` | Progress bar with percentage |
@@ -206,6 +240,18 @@ All complex dialogs are opened via injected services:
 | `ImportStrategyDialogService` | — | Import strategy selection |
 | `MessageDetailsDialogService` | — | Detailed message/error display |
 
+Toast stacking is configurable with `NOTIFICATION_DISPLAY_OPTIONS`: identical visible toasts (same
+type, text and details) are never stacked twice (`dedupe`, default on); `errorHideAfter` /
+`warningHideAfter` (ms, default 0 = until interaction or navigation) auto-hide non-critical errors
+and warnings — a caller passing `hideAfter: 0` still gets a sticky one, and `stickyWithDetails`
+keeps every error/warning that has details; a timed toast pauses while hovered or focused;
+`maxVisible` (default 0 = unlimited) hides the oldest toast of the lowest severity, so an error or
+warning is never dropped for a success or info.
+
+```typescript
+{ provide: NOTIFICATION_DISPLAY_OPTIONS, useValue: { errorHideAfter: 10000, warningHideAfter: 8000, stickyWithDetails: true, maxVisible: 3 } }
+```
+
 See [Progress Window Usage](src/lib/progress-window/USAGE.md) for progress dialog examples.
 
 ## Data Sources
@@ -266,6 +312,8 @@ Data binding directive for `ListViewComponent`, managing data source and paginat
 
 ## Detailed Documentation
 
+- [Actions](docs/actions.md) — `mm-row-actions`, `mm-action-button`, `MmAction`, canonical icons
+- [OctoBot](docs/octobot.md) — `mm-octobot`, `mm-empty-state`, assets, placement rules
 - [Time Range Picker](docs/time-range-picker.md) — Full API reference, configuration, examples
 - [Unsaved Changes Guard](docs/unsaved-changes-guard.md) — Implementation guide with checklists
 - [Progress Window Usage](src/lib/progress-window/USAGE.md) — Progress dialog examples, migration from Angular Material