@meshmakers/shared-ui 3.4.1100 → 3.4.1130

package/package.json

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

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

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { Type, OnDestroy, AfterViewInit, EventEmitter, ElementRef, OnInit, InjectionToken, TemplateRef, PipeTransform, OnChanges, SimpleChanges, EnvironmentProviders } from '@angular/core';
+import { TemplateRef, Type, OnDestroy, AfterViewInit, EventEmitter, ElementRef, OnInit, InjectionToken, PipeTransform, OnChanges, SimpleChanges, EnvironmentProviders } from '@angular/core';
 import * as _progress_kendo_svg_icons from '@progress/kendo-svg-icons';
 import { SVGIcon } from '@progress/kendo-svg-icons';
 import { FormGroup, ControlValueAccessor, Validator, FormControl, AbstractControl, ValidationErrors } from '@angular/forms';
@@ -16,6 +16,35 @@ import { AutoCompleteComponent } from '@progress/kendo-angular-dropdowns';
 import { CompositeFilterDescriptor, SortDescriptor, State as State$1 } from '@progress/kendo-data-query';
 import { CanDeactivate } from '@angular/router';
 
+/**
+ * Marks an `<ng-template>` whose contents the list view renders inside its
+ * toolbar, between the host's toolbar actions and the search box.
+ *
+ * It exists so a page can put its own scope/filter controls — view switches,
+ * "only in clarification" toggles and the like — in the SAME band as the
+ * table's search and options, instead of stacking a second strip above the
+ * grid. Those controls steer the table, so they belong with the table's own
+ * controls.
+ *
+ * A directive rather than plain `<ng-content>`: the toolbar itself lives in a
+ * `kendoGridToolbarTemplate`, and content projected with `<ng-content>` cannot
+ * be placed inside an `<ng-template>`. Capturing a TemplateRef and rendering it
+ * with `ngTemplateOutlet` is the way to reach that spot.
+ *
+ * ```html
+ * <mm-list-view ...>
+ *   <ng-template mmListViewFilters>
+ *     <kendo-buttongroup selection="single" [attr.aria-label]="'Ansicht'">…</kendo-buttongroup>
+ *   </ng-template>
+ * </mm-list-view>
+ * ```
+ */
+declare class ListViewFiltersDirective {
+    readonly templateRef: TemplateRef<any>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ListViewFiltersDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<ListViewFiltersDirective, "[mmListViewFilters]", never, {}, {}, never, never, true, never>;
+}
+
 /**
  * Mapping configuration for a single status value to its visual representation
  */
@@ -207,6 +236,8 @@ interface ListViewMessages {
     refreshData: string;
     /** Tooltip for the "Reset Filters" button. Default: "Reset Filters" */
     resetFilters: string;
+    /** Tooltip for the collapsed command menu. Default: "Commands" */
+    commands: string;
     /** Title for the actions command column. Default: "Actions" */
     actionsColumnTitle: string;
     /** PDF footer page template. Default: "Page {pageNum} of {totalPages}" */
@@ -230,6 +261,16 @@ interface ListViewMessages {
     /** Grid: no records message. Default: "No records available." */
     noRecords: string;
 }
+/**
+ * One entry of the list toolbar's command group (row filter, exports, reset,
+ * refresh). Rendered as a laid-out icon button when the list is wide enough,
+ * and as a menu item once the commands collapse.
+ */
+interface ListViewCommand {
+    id: 'rowFilter' | 'excel' | 'pdf' | 'reset' | 'refresh';
+    text: string;
+    svgIcon: SVGIcon;
+}
 /**
  * Default English messages for the ListViewComponent.
  */
@@ -278,6 +319,11 @@ declare class ListViewComponent extends CommandBaseService implements OnDestroy,
     /** Last measured row height — reused while a page renders no rows (e.g. empty filter result). */
     private lastMeasuredRowHeight;
     private readonly autoPageSizeRecompute$;
+    /**
+     * Host-supplied scope/filter controls, rendered in the toolbar rather than in
+     * a strip of their own above the grid — see ListViewFiltersDirective.
+     */
+    protected filtersTemplate?: ListViewFiltersDirective;
     private gridComponent?;
     private dataBindingDirective?;
     gridContextMenu?: ContextMenuComponent;
@@ -341,6 +387,33 @@ declare class ListViewComponent extends CommandBaseService implements OnDestroy,
      * context-menu trigger should pass something around 100.
      */
     actionsColumnWidth: number;
+    /**
+     * Floor for the actions column HEADER. The header is a translated word, and
+     * at the grid's header font "Actions" needs 73px once the cell's padding is
+     * counted, German "Aktionen" 83px, Spanish "Acciones" 82px.
+     */
+    private static readonly MIN_ACTIONS_HEADER_WIDTH;
+    /** Measured geometry of one flat icon button in a command cell. */
+    private static readonly ACTION_BUTTON_WIDTH;
+    private static readonly ACTION_BUTTON_GAP;
+    private static readonly COMMAND_CELL_PADDING;
+    /**
+     * Buttons the actions cell can render at once: one per non-separator action
+     * item, plus the context-menu button when that menu is shown inline. Item
+     * visibility is evaluated per row, so this is the worst case — which is the
+     * case the column has to be wide enough for.
+     */
+    private get maxActionButtons();
+    /**
+     * The actions column width actually used.
+     *
+     * A host sizes this by eye and gets it wrong in both directions: too narrow
+     * for the header (three Studio lists passed 70 and rendered "ACTIO…") or too
+     * narrow for the buttons (the same 70, and even a 90 that fits the header,
+     * clipped the third button off an archives row). Both floors are computed
+     * rather than guessed, so the column always fits its own content.
+     */
+    protected get effectiveActionsColumnWidth(): number;
     /**
      * Hides the row-checkbox column while the list view is narrower than this many
      * pixels — on phone-sized layouts multi-select via checkboxes is impractical and
@@ -364,6 +437,34 @@ declare class ListViewComponent extends CommandBaseService implements OnDestroy,
      * `null` (the default) keeps the table at every width.
      */
     cardModeBelow: number | null;
+    /**
+     * Below this component width the toolbar's command buttons (row filter,
+     * exports, reset, refresh) collapse into a single overflow menu. Above it
+     * they stay laid out, because reaching a command in one click beats hiding
+     * it behind a menu whenever there is room.
+     *
+     * Measured against the component's OWN width, not the viewport: expanding or
+     * collapsing the app drawer changes the space a list has by ~240px without
+     * the window ever resizing.
+     */
+    collapseCommandsBelow: number;
+    /** True while the command buttons are collapsed into the overflow menu. */
+    protected get commandsCollapsed(): boolean;
+    /**
+     * The commands available right now, in toolbar order. The row filter is
+     * omitted in card mode: cards have no column headers for a filter row to
+     * appear in, and the grid already drops `filterable` there — leaving the
+     * button visible offered to toggle something that cannot exist. Reset stays
+     * available, or a filter set before the switch could never be cleared.
+     */
+    protected get toolbarCommands(): ListViewCommand[];
+    /**
+     * Runs a command by id. Excel and PDF are driven by Kendo's own
+     * `kendoGridExcelCommand` / `kendoGridPDFCommand` directives when the buttons
+     * are laid out; from the overflow menu there is no directive to attach to, so
+     * the grid API is called directly.
+     */
+    protected onCommand(id: string): void;
     protected get isCardMode(): boolean;
     /** First column = the card's title/identity line (AB#4930). */
     protected get cardTitleColumn(): TableColumn | null;
@@ -515,8 +616,16 @@ declare class ListViewComponent extends CommandBaseService implements OnDestroy,
     private buildMenuItems;
     protected getPdfPageText(pageNum: number, totalPages: number): string;
     protected readonly moreVerticalIcon: SVGIcon$1;
+    /**
+     * Sliders, not an ellipsis. Host toolbars conventionally use the vertical
+     * ellipsis for their own overflow group, and two "more" menus side by side
+     * say nothing about which holds what. These commands are the table's options
+     * — filter, exports, refresh — so the icon says "options" and the two menus
+     * are told apart by meaning rather than by dot orientation.
+     */
+    protected readonly commandsIcon: SVGIcon$1;
     static ɵfac: i0.ɵɵFactoryDeclaration<ListViewComponent, never>;
-    static ɵcmp: i0.ɵɵ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; }; "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; }; "rowClass": { "alias": "rowClass"; "required": false; }; "messages": { "alias": "messages"; "required": false; }; "selectable": { "alias": "selectable"; "required": false; }; "columns": { "alias": "columns"; "required": false; }; }, { "rowClicked": "rowClicked"; "resetFilters": "resetFilters"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵ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; }; "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; }; "rowClass": { "alias": "rowClass"; "required": false; }; "messages": { "alias": "messages"; "required": false; }; "selectable": { "alias": "selectable"; "required": false; }; "columns": { "alias": "columns"; "required": false; }; }, { "rowClicked": "rowClicked"; "resetFilters": "resetFilters"; }, ["filtersTemplate"], never, true, never>;
 }
 
 declare const upload: {
@@ -2509,5 +2618,5 @@ declare class WindowStateService {
 
 declare function provideMmSharedUi(): EnvironmentProviders;
 
-export { BaseFormComponent, BaseTreeDetailComponent, ButtonTypes, BytesToSizePipe, CRON_PRESETS, ConfirmationService, ConfirmationWindowComponent, ConfirmationWindowResult, CopyableTextComponent, CronBuilderComponent, CronHumanizerService, CronParserService, DEFAULT_CONFIRMATION_WINDOW_MESSAGES, DEFAULT_CRON_BUILDER_CONFIG, 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, 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, MINUTE_INTERVALS, MessageDetailsDialogComponent, MessageDetailsDialogService, MessageListenerService, MmListViewDataBindingDirective, NotificationDisplayService, PascalCasePipe, ProgressValue, ProgressWindowComponent, ProgressWindowService, RELATIVE_WEEKS, SECOND_INTERVALS, SaveAsDialogComponent, SaveAsDialogService, TimeRangePickerComponent, TimeRangeUtils, TreeComponent, UnsavedChangesDirective, UnsavedChangesGuard, UploadFileDialogComponent, WEEKDAYS, WEEKDAY_ABBREVIATIONS, WindowStateService, generateDayOfMonthOptions, generateHourOptions, generateMinuteOptions, provideMmSharedUi };
-export type { BadgeMapping, BadgeMappingTable, BaseFormConfig, BaseFormMessages, ColumnDefinition, ConfirmationButtonLabels, ConfirmationWindowData, ConfirmationWindowMessages, ContextMenuType, CronBuilderConfig, CronFields, CronPreset, CronSchedule, CronValidationResult, DialogFetchOptions, DialogFetchResult, DropdownOption, EntitySelectDialogDataSource, EntitySelectDialogMessages, EntitySelectDialogOptions, EntitySelectDialogResult, EntitySelectInputMessages, FetchAgainOptions, FetchDataOptions, FetchResult, FileUploadData, HasUnsavedChanges, InputDialogMessages, ListViewMessages, MessageDetailsDialogData, MessageDetailsDialogMessages, NameAvailabilityResult, NodeDroppedEvent, NodeInfo, NotificationDisplayMessages, PersistedListState, ProgressWindowConfig, ProgressWindowData, ProgressWindowMessages, ProgressWindowOptions, ProgressWindowResult, Quarter, RelativeTimeUnit, ResponsiveFormBreakPoint, RowClassFn, SaveAsDialogDataSource, SaveAsDialogMessages, SaveAsDialogOptions, SaveAsDialogResult, ScheduleType, StatusFieldConfig, StatusIconMapping, StatusMapping, TableColumn, TimeRange, TimeRangeISO, TimeRangeOption, TimeRangePickerConfig, TimeRangePickerLabels, TimeRangeSelection, TimeRangeType, TimeRangeZone, UnsavedChangesMessages, Weekday, WindowDimensions };
+export { BaseFormComponent, BaseTreeDetailComponent, ButtonTypes, BytesToSizePipe, CRON_PRESETS, ConfirmationService, ConfirmationWindowComponent, ConfirmationWindowResult, CopyableTextComponent, CronBuilderComponent, CronHumanizerService, CronParserService, DEFAULT_CONFIRMATION_WINDOW_MESSAGES, DEFAULT_CRON_BUILDER_CONFIG, 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, 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, MessageDetailsDialogComponent, MessageDetailsDialogService, MessageListenerService, MmListViewDataBindingDirective, NotificationDisplayService, PascalCasePipe, ProgressValue, ProgressWindowComponent, ProgressWindowService, RELATIVE_WEEKS, SECOND_INTERVALS, SaveAsDialogComponent, SaveAsDialogService, TimeRangePickerComponent, TimeRangeUtils, TreeComponent, UnsavedChangesDirective, UnsavedChangesGuard, UploadFileDialogComponent, WEEKDAYS, WEEKDAY_ABBREVIATIONS, WindowStateService, generateDayOfMonthOptions, generateHourOptions, generateMinuteOptions, provideMmSharedUi };
+export type { BadgeMapping, BadgeMappingTable, BaseFormConfig, BaseFormMessages, ColumnDefinition, ConfirmationButtonLabels, ConfirmationWindowData, ConfirmationWindowMessages, ContextMenuType, CronBuilderConfig, CronFields, CronPreset, CronSchedule, CronValidationResult, DialogFetchOptions, DialogFetchResult, DropdownOption, EntitySelectDialogDataSource, EntitySelectDialogMessages, EntitySelectDialogOptions, EntitySelectDialogResult, EntitySelectInputMessages, FetchAgainOptions, FetchDataOptions, FetchResult, FileUploadData, HasUnsavedChanges, InputDialogMessages, ListViewCommand, ListViewMessages, MessageDetailsDialogData, MessageDetailsDialogMessages, NameAvailabilityResult, NodeDroppedEvent, NodeInfo, NotificationDisplayMessages, PersistedListState, ProgressWindowConfig, ProgressWindowData, ProgressWindowMessages, ProgressWindowOptions, ProgressWindowResult, Quarter, RelativeTimeUnit, ResponsiveFormBreakPoint, RowClassFn, SaveAsDialogDataSource, SaveAsDialogMessages, SaveAsDialogOptions, SaveAsDialogResult, ScheduleType, StatusFieldConfig, StatusIconMapping, StatusMapping, TableColumn, TimeRange, TimeRangeISO, TimeRangeOption, TimeRangePickerConfig, TimeRangePickerLabels, TimeRangeSelection, TimeRangeType, TimeRangeZone, UnsavedChangesMessages, Weekday, WindowDimensions };