@quadrel-enterprise-ui/framework 21.12.0 → 21.12.2-beta.349.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@quadrel-enterprise-ui/framework",
3
- "version": "21.12.0",
3
+ "version": "21.12.2-beta.349.1",
4
4
  "exports": {
5
5
  "./jest-preset": "./jest-preset.js",
6
6
  "./package.json": {
@@ -146,6 +146,8 @@
146
146
  "i18n.contact.city.placeholder": "Ort",
147
147
  "i18n.contact.phoneNumber.placeholder": "Telefon",
148
148
  "i18n.contact.emailAddress.placeholder": "E-Mail",
149
+ "i18n.qd.table.a11y.moreActions": "Weitere Aktionen",
150
+ "i18n.qd.table.a11y.selectRow": "Zeile auswählen",
149
151
  "i18n.qd.table.pagination.pageSize": "Einträge pro Seite:",
150
152
  "i18n.qd.table.pagination.of": "von",
151
153
  "i18n.qd.table.pagination.entries": "Einträgen",
@@ -134,6 +134,8 @@
134
134
  "i18n.qd.form.error.uploadFailed": "File upload failed.",
135
135
  "i18n.qd.form.placeholder.prefix": "Ex.",
136
136
  "i18n.qd.form.placeholder.selectFile": "Select file",
137
+ "i18n.qd.table.a11y.moreActions": "More actions",
138
+ "i18n.qd.table.a11y.selectRow": "Select row",
137
139
  "i18n.qd.table.pagination.pageSize": "Entries per page:",
138
140
  "i18n.qd.table.pagination.of": "of",
139
141
  "i18n.qd.table.pagination.entries": "entries",
@@ -134,6 +134,8 @@
134
134
  "i18n.qd.form.error.uploadFailed": "Le téléversement a échoué.",
135
135
  "i18n.qd.form.placeholder.prefix": "Ex.",
136
136
  "i18n.qd.form.placeholder.selectFile": "Sélectionner un fichier",
137
+ "i18n.qd.table.a11y.moreActions": "Autres actions",
138
+ "i18n.qd.table.a11y.selectRow": "Sélectionner la ligne",
137
139
  "i18n.qd.table.pagination.pageSize": "Entrées par page:",
138
140
  "i18n.qd.table.pagination.of": "des",
139
141
  "i18n.qd.table.pagination.entries": "entrées",
@@ -134,6 +134,8 @@
134
134
  "i18n.qd.form.error.uploadFailed": "Il caricamento del file non è riuscito.",
135
135
  "i18n.qd.form.placeholder.prefix": "Ad es.",
136
136
  "i18n.qd.form.placeholder.selectFile": "Seleziona un file",
137
+ "i18n.qd.table.a11y.moreActions": "Altre azioni",
138
+ "i18n.qd.table.a11y.selectRow": "Seleziona riga",
137
139
  "i18n.qd.table.pagination.pageSize": "Voci per pagina:",
138
140
  "i18n.qd.table.pagination.of": "di",
139
141
  "i18n.qd.table.pagination.entries": "voci",
@@ -1953,7 +1953,7 @@ interface QdDataFacetsChipConfig {
1953
1953
  */
1954
1954
  isTranslated?: boolean;
1955
1955
  /**
1956
- * @description With this mapping you can define the chip state for each label.
1956
+ * @description With this mapping you can define the chip state for each label. Without an entry, a chip keeps its own state or gets 'info'.
1957
1957
  */
1958
1958
  state?: {
1959
1959
  [label: string]: QdChipState;
@@ -2097,12 +2097,13 @@ interface QdDataFacetsLinkRefreshConfig {
2097
2097
  */
2098
2098
  isEnabled?: boolean;
2099
2099
  /**
2100
- * @description Page number to load when refreshing the table.
2100
+ * @description Page index to load when refreshing the table.
2101
2101
  *
2102
- * - If specified, the table will jump to this page after the refresh.
2103
- * - If omitted, the current page is preserved.
2102
+ * - The page index starts at 0.
2103
+ * - If specified, the table jumps to this page after the refresh.
2104
+ * - If omitted, the table loads the first page.
2104
2105
  *
2105
- * @default current page
2106
+ * @default 0
2106
2107
  */
2107
2108
  page?: number;
2108
2109
  }
@@ -2205,6 +2206,8 @@ interface QdTablePrimaryAction<T extends string> {
2205
2206
  *
2206
2207
  * - Accepts row data and its index.
2207
2208
  * - Returns `void` for synchronous actions or `Observable<boolean>` for asynchronous ones.
2209
+ * - The table subscribes to a returned `Observable` only with `refresh.isEnabled: true`. Otherwise subscribe yourself.
2210
+ * - Without a handler, rows still look clickable, but a click only logs a warning. `highlightOnRevisit` and `refresh` then do nothing.
2208
2211
  *
2209
2212
  * Example:
2210
2213
  * ```typescript
@@ -2229,6 +2232,7 @@ interface QdTablePrimaryAction<T extends string> {
2229
2232
  * Upon revisiting the table, that row is briefly highlighted to help the user regain orientation.
2230
2233
  *
2231
2234
  * **Requirements:**
2235
+ * - A `handler` must be set. Without it, the row is not remembered.
2232
2236
  * - A `uid` must be set on the table configuration to persist the state across navigation.
2233
2237
  * - Set `trackRowBy` on the table config or provide a `uid` on each row for reliable identification.
2234
2238
  *
@@ -2259,6 +2263,7 @@ interface QdTableSecondaryAction<T extends string> {
2259
2263
  * The table then only logs a warning.
2260
2264
  * A row keeps its subscription when the config is rebuilt. A new `Observable` takes effect with the next row object.
2261
2265
  * If `isDisabled` is set too, `availability` wins.
2266
+ * Without `availability`, the deprecated `isDisabled` decides. Without both, the entry is available.
2262
2267
  *
2263
2268
  * @example
2264
2269
  * ```ts
@@ -2269,8 +2274,6 @@ interface QdTableSecondaryAction<T extends string> {
2269
2274
  * map(item => (item.status === 'DRAFT' ? 'available' : 'notShown'))
2270
2275
  * )
2271
2276
  * ```
2272
- *
2273
- * @default 'available'
2274
2277
  */
2275
2278
  availability?: QdActionAvailability | Observable<QdActionAvailability> | ((row: QdTableDataRow<T>) => QdActionAvailability | Observable<QdActionAvailability>);
2276
2279
  /**
@@ -2284,6 +2287,9 @@ interface QdTableSecondaryAction<T extends string> {
2284
2287
  *
2285
2288
  * - Accepts row data and its index.
2286
2289
  * - Returns `void` for synchronous actions or `Observable<boolean>` for asynchronous ones.
2290
+ * - The table subscribes to a returned `Observable` only with `refresh.isEnabled: true`. Otherwise subscribe yourself.
2291
+ * - Without a handler, the entry is still shown and clickable. A click only emits `secondaryActionOutput` and logs a warning.
2292
+ * `confirmationMessage`, `refresh` and `highlightOnRevisit` then have no effect.
2287
2293
  *
2288
2294
  * Example:
2289
2295
  * ```typescript
@@ -2341,7 +2347,8 @@ interface QdTableSecondaryAction<T extends string> {
2341
2347
  * {
2342
2348
  * type: 'delete',
2343
2349
  * confirmationMessage: { i18n: 'i18n.app.remove.entry.confirmation' },
2344
- * handler: ({ rowData }) => this.service.delete(rowData.id)
2350
+ * handler: ({ rowData }) => this.service.delete(rowData.id).pipe(map(() => true)),
2351
+ * refresh: { isEnabled: true }
2345
2352
  * }
2346
2353
  * ```
2347
2354
  */
@@ -2350,7 +2357,7 @@ interface QdTableSecondaryAction<T extends string> {
2350
2357
  };
2351
2358
  }
2352
2359
  /**
2353
- * @description Defines the secondaryAction type for the table. For 'edit', 'delete' & 'view' types, an icon will be provided.
2360
+ * @description Defines the secondaryAction type for the table.
2354
2361
  */
2355
2362
  type QdTableConfigSecondaryActionType = 'edit' | 'delete' | 'view' | string;
2356
2363
  /**
@@ -2358,7 +2365,7 @@ type QdTableConfigSecondaryActionType = 'edit' | 'delete' | 'view' | string;
2358
2365
  */
2359
2366
  interface QdTableConfigSelection<T extends string> {
2360
2367
  /**
2361
- * @description Defines the selection type for the table.
2368
+ * @description Defines the selection type for the table. Without a type, the selection column stays empty and no row can be selected.
2362
2369
  */
2363
2370
  type?: QdTableConfigSelectionType;
2364
2371
  /**
@@ -2376,11 +2383,14 @@ interface QdTableConfigSelection<T extends string> {
2376
2383
  /**
2377
2384
  * @description Set to emit the initial selection in the selection output.
2378
2385
  *
2386
+ * With `false`, the table does not emit the pre-selection at start.
2387
+ * If the pre-selected rows arrive later, for example from a resolver, the table still emits them once.
2388
+ *
2379
2389
  * * @default: false
2380
2390
  */
2381
2391
  emitOutputInitially?: boolean;
2382
2392
  /**
2383
- * @description Defines a handler that is triggered by a selection.
2393
+ * @description Defines a handler that is called with the selected rows whenever the selection changes. The list is empty when no row is selected.
2384
2394
  */
2385
2395
  handler?: (selectedRows: QdTableSelectedRows<T>) => void;
2386
2396
  /**
@@ -4549,6 +4559,8 @@ type QdTableConfigColumnType =
4549
4559
  }
4550
4560
  /**
4551
4561
  * @description Renders the status with status indicator.
4562
+ *
4563
+ * * Note: Level and state come from the cell value. Do not set `options`. It has no effect, and in development mode Angular logs an error for each status cell.
4552
4564
  */
4553
4565
  | {
4554
4566
  type: 'status';
@@ -4563,7 +4575,7 @@ type QdTableConfigColumnType =
4563
4575
  /**
4564
4576
  * @description Renders a date and time either with default format or with the format specified in the provided options.
4565
4577
  *
4566
- * * Note: Like the Angular DatePipe it is based on, the content type "dateTime" can handle multiple input types: string | number | Date
4578
+ * * Note: The content type "date" accepts string | number | Date. A number is read as a Unix timestamp in seconds, not in milliseconds.
4567
4579
  */
4568
4580
  | {
4569
4581
  type: 'date';
@@ -4612,18 +4624,19 @@ interface QdTableConfig<T extends string> {
4612
4624
  /**
4613
4625
  * @description Defines a list of secondary actions that can be executed per Click/Tab of an item in the menu.
4614
4626
  *
4615
- * * @example
4616
4627
  * This is how the two actions "edit" and "delete" are created.
4628
+ *
4629
+ * @example
4617
4630
  * ```ts
4618
4631
  * secondaryActions: [
4619
4632
  * {
4620
4633
  * type: 'edit',
4621
- * handler: rowData => doSomethingWith(rowData)
4634
+ * handler: ({ rowData }) => doSomethingWith(rowData)
4622
4635
  * },
4623
4636
  * {
4624
4637
  * type: 'delete',
4625
- * isDisabled: true,
4626
- * handler: rowData => doSomethingWith(rowData)
4638
+ * availability: 'blocked',
4639
+ * handler: ({ rowData }) => doSomethingWith(rowData)
4627
4640
  * }
4628
4641
  * ]
4629
4642
  * ```
@@ -4632,12 +4645,14 @@ interface QdTableConfig<T extends string> {
4632
4645
  /**
4633
4646
  * @description Defines the primary action that can be executed by clicking on a row.
4634
4647
  *
4635
- * @example
4636
4648
  * You provide a primary action like this.
4637
- * ``ts
4649
+ *
4650
+ * @example
4651
+ * ```ts
4638
4652
  * primaryAction: {
4639
- * handler: row => openModal(row)
4653
+ * handler: ({ rowData }) => openModal(rowData)
4640
4654
  * }
4655
+ * ```
4641
4656
  */
4642
4657
  primaryAction?: QdTablePrimaryAction<T>;
4643
4658
  /**
@@ -4656,9 +4671,10 @@ interface QdTableConfig<T extends string> {
4656
4671
  /**
4657
4672
  * @description Sets the translation keys (plural) for the table headings and more, as the 'context' for instance.
4658
4673
  *
4659
- * * @example: "i18n.my.table.<column>".
4674
+ * Without `i18ns`, the column headers show the column key and the row menu shows the action type, each with a capital first letter.
4675
+ * The empty state view and columns with `isTranslated` need `i18ns`. Otherwise they show a key that starts with "undefined".
4660
4676
  *
4661
- * If none exits, the value is rendered without translation.
4677
+ * * @example: "i18n.my.table.<column>".
4662
4678
  */
4663
4679
  i18ns?: string;
4664
4680
  /**
@@ -4680,18 +4696,18 @@ interface QdTableConfig<T extends string> {
4680
4696
  */
4681
4697
  whichColumnFillsWidth?: QdTableFillingColumn;
4682
4698
  /**
4683
- * @description Enables "viewonly" mode for the table.
4699
+ * @description Sets the operation mode for the secondary actions of the table.
4684
4700
  *
4685
- * When set to `true`, the table displays its content as read-only.
4686
- * Combined with `secondaryActions`, this can be used to selectively show or hide secondary actions
4687
- * based on the operation mode (`'view'` or `'edit'`) used in the Quadrel framework.
4701
+ * Only secondary actions with an `operationMode` are affected.
4702
+ * The rest of the table does not become read-only.
4688
4703
  *
4689
- * * If `viewonly` is explicitly set, it overrides the global operation mode
4690
- * (which is normally controlled through external events).
4691
- * This gives you full control: for example, setting `viewonly: false` will allow edit actions to be shown,
4692
- * even if the global mode would normally hide them.
4704
+ * - `true` shows the actions for `'view'`.
4705
+ * - `false` shows the actions for `'edit'`.
4706
+ * - When not set, the table follows the operation mode of the page.
4707
+ * When no page is open, the table acts like `false`.
4708
+ * A table outside a page follows the mode of a page that is open at the same time.
4693
4709
  *
4694
- * * @default false
4710
+ * A set value overrides the operation mode of the page.
4695
4711
  */
4696
4712
  viewonly?: boolean;
4697
4713
  /**
@@ -4713,6 +4729,10 @@ interface QdTableConfig<T extends string> {
4713
4729
  * - `number` sets the page index to refresh.
4714
4730
  * - `undefined` triggers a general refresh (current page stays the same).
4715
4731
  *
4732
+ * Keep the same Observable instance when you replace the config.
4733
+ * With a new instance, the table drops the old subscription and subscribes to the new one.
4734
+ * Values it replays right away do not trigger a refresh.
4735
+ *
4716
4736
  * @example
4717
4737
  * ```ts
4718
4738
  * refresh$.next(); // refresh current page
@@ -4781,7 +4801,10 @@ interface QdTableConfigColumnBase<T> {
4781
4801
  */
4782
4802
  sort?: QdTableConfigColumnSort;
4783
4803
  /**
4784
- * @description Defines the breakpoint at which the column is hidden. Use for mobile devices.
4804
+ * @description Not supported.
4805
+ *
4806
+ * The table ignores this field. A column cannot be hidden per breakpoint.
4807
+ * `columnMapping` sets how many columns show. Extra columns move into one cell together with the main column.
4785
4808
  */
4786
4809
  hiddenAt?: QdBreakpoint;
4787
4810
  /**
@@ -4808,8 +4831,6 @@ interface QdTableConfigColumnSort {
4808
4831
  }
4809
4832
  /**
4810
4833
  * @description Maximum number of columns depending on the current breakpoint.
4811
- *
4812
- * * @default: { xs: 1, sm: 2, md: 4, lg: 6, xl: 8, xxl: 10 }
4813
4834
  */
4814
4835
  type QdMaxColumnsCount = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15;
4815
4836
  type QdTableConfigColumn<T> = QdTableConfigColumnType & QdTableConfigColumnBase<T>;
@@ -4818,9 +4839,11 @@ type QdTableConfigColumn<T> = QdTableConfigColumnType & QdTableConfigColumnBase<
4818
4839
  */
4819
4840
  interface QdTablePagination {
4820
4841
  /**
4821
- * @description Initial pagination page size
4842
+ * @description Initial pagination page size.
4843
+ *
4844
+ * Without `pageSizeDefault`, the table uses the first entry of `pageSizes`. Without `pageSizes`, it uses 25.
4822
4845
  *
4823
- * * @default 25
4846
+ * * @default the first entry of `pageSizes`, otherwise 25
4824
4847
  */
4825
4848
  pageSizeDefault?: number;
4826
4849
  /**
@@ -4847,8 +4870,8 @@ interface QdTablePagination {
4847
4870
  *
4848
4871
  * **Validation**
4849
4872
  * - `page`: positive integer, otherwise falls back to 1.
4850
- * - `size`: must be one of `pageSizes`; if `pageSizes` is omitted, an internal sanity range applies.
4851
- * - Invalid values are ignored; the default is used instead.
4873
+ * - `size`: must be one of `pageSizes`. Without `pageSizes`, any whole number from 1 to 1000 is valid.
4874
+ * - An invalid `size` falls back to `pageSizeDefault`, then to the first entry of `pageSizes`, then to 25.
4852
4875
  * - Out-of-range pages (e.g. `?page=99` with 5 pages) auto-correct via the resolver.
4853
4876
  *
4854
4877
  * **Multiple tables on one page**
@@ -4912,7 +4935,8 @@ interface QdTableEmptyStateView {
4912
4935
  action?: boolean;
4913
4936
  /**
4914
4937
  * @description Defines a handler that is triggered by a click/tap on the call-to-action button.
4915
- * Will only be triggered if "action" is set to "true
4938
+ * Will only be triggered if "action" is set to "true".
4939
+ * Without a handler, the click only emits `emptyStateActionOutput`.
4916
4940
  */
4917
4941
  handler?: () => void;
4918
4942
  /**
@@ -5011,10 +5035,12 @@ declare class QdMockTableDataTextComponent {
5011
5035
 
5012
5036
  declare class QdMockTableEmptyStateComponent {
5013
5037
  config: any;
5038
+ i18ns: any;
5039
+ testId: any;
5014
5040
  getI18n: any;
5015
5041
  handleClick: any;
5016
5042
  static ɵfac: i0.ɵɵFactoryDeclaration<QdMockTableEmptyStateComponent, never>;
5017
- static ɵcmp: i0.ɵɵComponentDeclaration<QdMockTableEmptyStateComponent, "qd-table-empty-state", never, { "config": { "alias": "config"; "required": false; }; }, {}, never, never, false, never>;
5043
+ static ɵcmp: i0.ɵɵComponentDeclaration<QdMockTableEmptyStateComponent, "qd-table-empty-state", never, { "config": { "alias": "config"; "required": false; }; "i18ns": { "alias": "i18ns"; "required": false; }; "testId": { "alias": "data-test-id"; "required": false; }; }, {}, never, never, false, never>;
5018
5044
  }
5019
5045
 
5020
5046
  declare class QdMockTableHeadComponent {
@@ -7761,7 +7787,7 @@ declare class QdInputComponent implements OnInit, OnChanges, OnDestroy, ControlV
7761
7787
  get numberOfCharacters(): number;
7762
7788
  get hasMaxLength(): boolean;
7763
7789
  get maxLength(): number | undefined;
7764
- get valueAsList(): string[];
7790
+ get valueAsList(): Array<string | null>;
7765
7791
  ngOnInit(): void;
7766
7792
  ngOnChanges(changes: SimpleChanges): void;
7767
7793
  ngOnDestroy(): void;
@@ -15999,6 +16025,11 @@ declare class QdContextSelectionChipComponent {
15999
16025
  * }
16000
16026
  * ```
16001
16027
  *
16028
+ * The resolver gets `context` on every call. It maps each context id to its selection:
16029
+ * a `QdPageSelectedContext` (`{ value, label }`), or an array of them for a multi context.
16030
+ * It is `{}` before the first selection and after `clear()`.
16031
+ * If the user confirms the dialog with nothing picked, the key stays with `undefined` or `[]`.
16032
+ *
16002
16033
  * @parent qd-section {supported}
16003
16034
  * description: Put it on the table inside the section that owns the context, so both read the same state.
16004
16035
  */
@@ -16048,7 +16079,8 @@ declare class QdConnectorTableFilterDirective<T extends string> implements After
16048
16079
  private tableComponent;
16049
16080
  private toolbarComponentsService;
16050
16081
  /**
16051
- * @description Configuration of the filter used to connect to the table.
16082
+ * Configuration of the filter used to connect to the table. <br />
16083
+ * Here `emitOutputsInitially` is always `true`, so the table loads at once. A `false` value is ignored.
16052
16084
  */
16053
16085
  qdConnectToFilter: QdFilterConfigData;
16054
16086
  filterComponent: QdFilterComponent;
@@ -16239,7 +16271,8 @@ declare class QdConnectorTableSearchDirective<T extends string> implements After
16239
16271
  private tableComponent;
16240
16272
  private toolbarComponentsService;
16241
16273
  /**
16242
- * @description Configuration of the search used to connect to the table.
16274
+ * Configuration of the search used to connect to the table. <br />
16275
+ * Here `emitEmptySearch` defaults to `true`. Set it to `false` to turn it off.
16243
16276
  */
16244
16277
  qdConnectToSearch: QdSearchOptions;
16245
16278
  searchComponent: QdSearchComponent;
@@ -16510,15 +16543,25 @@ interface QdTableResolvedData<T extends string> {
16510
16543
  interface QdTableDataResolverProps<T extends string> {
16511
16544
  /**
16512
16545
  * The index of the page to resolve. Corresponds to the 'page' parameter in Pageable.
16546
+ * Counting starts at 0. The first request uses 0, or the page from the URL with `pagination.connectWithRouter`.
16547
+ * It goes back to 0 when the filter, search, context, sort or page size changes.
16548
+ * Not set when the table has no pagination.
16513
16549
  */
16514
16550
  page?: number;
16515
16551
  /**
16516
16552
  * The number of items per page. Corresponds to the 'size' parameter in Pageable.
16553
+ * Starts with the size from the URL with `pagination.connectWithRouter`.
16554
+ * Otherwise it starts with `pageSizeDefault`, else the first entry of `pageSizes`, else 25.
16555
+ * Not set when the table has no pagination.
16517
16556
  */
16518
16557
  size?: number;
16519
16558
  /**
16520
16559
  * The Sort object. To obtain the query string compliant with Spring Boot's conventions, use the free
16521
16560
  * function `qdSortParameterize(sort)`, or `qdTableQueryParameterize(props)` to serialize the whole bundle.
16561
+ *
16562
+ * With pagination, it holds one entry per column with a `sort` config.
16563
+ * Unsorted or disabled columns have `QdSortDirection.NONE`. If no column has a `sort` config, it is `[]`.
16564
+ * Without pagination, it is only sent with a refresh.
16522
16565
  */
16523
16566
  sort?: QdTableStateSort<T>[];
16524
16567
  /**
@@ -16775,8 +16818,10 @@ declare class QdTableComponent<T extends string> implements OnInit, OnChanges, O
16775
16818
  private readonly resolverService;
16776
16819
  private readonly confirmationDialogService;
16777
16820
  private readonly sortRouterConnector;
16821
+ private readonly destroyRef;
16778
16822
  /**
16779
16823
  * Configuration of the table. The generic type specifies the column definition. <br />
16824
+ * Required. Without a config, the table throws an error on init and shows nothing. <br />
16780
16825
  *
16781
16826
  * **Usage:**
16782
16827
  *
@@ -16823,27 +16868,30 @@ declare class QdTableComponent<T extends string> implements OnInit, OnChanges, O
16823
16868
  */
16824
16869
  set data(data: QdTableData<T>);
16825
16870
  /**
16826
- * A static test ID for integration tests can be set. <br />
16827
- * The value for the HTML attribute [data-test-id].
16871
+ * The root of the test IDs of the table. <br />
16872
+ * The host gets `<value>-<uid>`. Without `uid`, it gets `<value>-` plus a random ID. <br />
16873
+ * Inner elements start with the value, for example `<value>-element` and `<value>-row-0`. <br />
16874
+ * The empty state view gets the test ID `<value>-empty-state`.
16828
16875
  */
16829
16876
  testId: string;
16830
16877
  /**
16831
- * Emits an event when an secondary action is triggered. The return value contains the row-specific data. <br />
16878
+ * Emits an event when a secondary action is triggered. The return value contains the row-specific data. <br />
16832
16879
  * `secondaryActions` must be defined in the table configuration.
16833
16880
  *
16834
16881
  * * @returns EventEmitter with generic type: QdTableRecentSecondaryAction
16835
16882
  */
16836
16883
  secondaryActionOutput: EventEmitter<QdTableRecentSecondaryAction<T>>;
16837
16884
  /**
16838
- * Outputs an event when one or more lines are selected. The return value contains the row-specific data. <br />
16885
+ * Emits the selected rows whenever the selection changes, also when a row is unselected. <br />
16886
+ * The list is empty when no row is selected. <br />
16839
16887
  * `multiSelect` or `singleSelect` must be activated in the table configuration.
16840
16888
  *
16841
16889
  * * @returns EventEmitter with generic type: QdTableSelectedRows
16842
16890
  */
16843
16891
  selectedRowsOutput: EventEmitter<QdTableSelectedRows<T>>;
16844
16892
  /**
16845
- * The event is triggered when the no contents are present. <br />
16846
- * The `emptyStateView` must be enabled in the table configuration.
16893
+ * Emits when the user clicks the call-to-action button of the empty state. <br />
16894
+ * Needs `emptyStateView.action: true` in the table configuration.
16847
16895
  */
16848
16896
  emptyStateActionOutput: EventEmitter<any>;
16849
16897
  private paginator?;
@@ -16877,7 +16925,11 @@ declare class QdTableComponent<T extends string> implements OnInit, OnChanges, O
16877
16925
  private initializeScrollAnchorService;
16878
16926
  private updateFillingWidthServiceTableConfig;
16879
16927
  private initializeEmptyStateService;
16928
+ private initializeEmptyStateView;
16880
16929
  private initializeRowSelectionService;
16930
+ private updateRowSelectionServiceTableConfig;
16931
+ private subscribeToDeselectAll;
16932
+ private updateConfigObservables;
16881
16933
  private initializeSecondaryActionsService;
16882
16934
  private whenSecondaryActionAvailable$;
16883
16935
  private initializePushEventsService;
@@ -16885,7 +16937,9 @@ declare class QdTableComponent<T extends string> implements OnInit, OnChanges, O
16885
16937
  private initRefresh;
16886
16938
  private triggerRefresh;
16887
16939
  private validateConfig;
16940
+ private validateSelectionTracking;
16888
16941
  private hasHighlightOnRevisit;
16942
+ private hasTranslatedColumn;
16889
16943
  static ɵfac: i0.ɵɵFactoryDeclaration<QdTableComponent<any>, never>;
16890
16944
  static ɵcmp: i0.ɵɵComponentDeclaration<QdTableComponent<any>, "qd-table", never, { "config": { "alias": "config"; "required": false; }; "data": { "alias": "data"; "required": false; }; "testId": { "alias": "data-test-id"; "required": false; }; }, { "secondaryActionOutput": "secondaryActionOutput"; "selectedRowsOutput": "selectedRowsOutput"; "emptyStateActionOutput": "emptyStateActionOutput"; }, never, never, false, never>;
16891
16945
  }
@@ -17298,6 +17352,7 @@ declare class QdTableBodyComponent<T extends string> implements OnInit, OnDestro
17298
17352
  private tableStoreService;
17299
17353
  private resolverService;
17300
17354
  private cdr;
17355
+ private readonly destroyRef;
17301
17356
  config: QdTableConfig<T>;
17302
17357
  data: QdTableDataRow<T>[];
17303
17358
  testId?: string;
@@ -17319,6 +17374,9 @@ declare class QdTableBodyComponent<T extends string> implements OnInit, OnDestro
17319
17374
  declare class QdTableEmptyStateComponent implements OnInit, OnChanges {
17320
17375
  private readonly emptyStateService;
17321
17376
  config: QdTableEmptyStateView;
17377
+ i18ns?: string;
17378
+ testId: string;
17379
+ get dataTestId(): string;
17322
17380
  translationParameter: {
17323
17381
  [key: string]: string;
17324
17382
  };
@@ -17327,7 +17385,7 @@ declare class QdTableEmptyStateComponent implements OnInit, OnChanges {
17327
17385
  getI18n(): string;
17328
17386
  handleClick(): void;
17329
17387
  static ɵfac: i0.ɵɵFactoryDeclaration<QdTableEmptyStateComponent, never>;
17330
- static ɵcmp: i0.ɵɵComponentDeclaration<QdTableEmptyStateComponent, "qd-table-empty-state", never, { "config": { "alias": "config"; "required": false; }; }, {}, never, never, false, never>;
17388
+ static ɵcmp: i0.ɵɵComponentDeclaration<QdTableEmptyStateComponent, "qd-table-empty-state", never, { "config": { "alias": "config"; "required": false; }; "i18ns": { "alias": "i18ns"; "required": false; }; "testId": { "alias": "data-test-id"; "required": false; }; }, {}, never, never, false, never>;
17331
17389
  }
17332
17390
 
17333
17391
  declare class QdTableHeadComponent<T extends string> implements OnInit {
@@ -17475,34 +17533,37 @@ declare class QdTablePaginatorPageSizeDirective<T extends string> implements OnI
17475
17533
  interface MenuEntry {
17476
17534
  key: string;
17477
17535
  type: QdTableConfigSecondaryActionType;
17478
- i18n: string;
17536
+ i18n?: string;
17537
+ label: string;
17479
17538
  isBlocked: boolean;
17480
17539
  }
17481
17540
  declare class QdTableRowActionsSecondaryMenuComponent<T extends string> implements OnChanges, OnInit, OnDestroy {
17482
17541
  private readonly actionsService;
17483
17542
  private readonly tableStore;
17484
17543
  private readonly eventBroker;
17544
+ private readonly destroyRef;
17485
17545
  rowIndex: QdTableRowIndex;
17486
17546
  rowData: QdTableDataRow<T>;
17487
17547
  actions?: QdTableSecondaryAction<T>[];
17488
- i18ns: string;
17548
+ i18ns?: string;
17489
17549
  testId: string;
17490
17550
  viewonly?: boolean;
17491
17551
  trackRowBy?: (row: QdTableDataRow<T>) => string | number;
17492
17552
  private _isViewonly;
17553
+ private _viewModeSubscription?;
17554
+ private _operationMode$?;
17493
17555
  private _isInitialized;
17494
17556
  private _isEvaluating;
17495
17557
  private _countsByType;
17496
17558
  private readonly _resolutions;
17497
17559
  private readonly _states$;
17498
17560
  private readonly _entries$;
17499
- private readonly _destroy$;
17500
17561
  readonly entries$: Observable<MenuEntry[]>;
17501
17562
  ngOnChanges(changes: SimpleChanges): void;
17502
17563
  ngOnInit(): void;
17503
17564
  ngOnDestroy(): void;
17504
17565
  onActionClick(type: QdTableConfigSecondaryActionType): void;
17505
- private initViewMode;
17566
+ private followViewMode;
17506
17567
  private isAvailable;
17507
17568
  private settledAvailability$;
17508
17569
  private holdsRow;
@@ -18271,6 +18332,7 @@ interface QdShellServiceNavigationConfig {
18271
18332
  * @description Determines if the logout should be handled in the service-navigation or not.
18272
18333
  * If set to false, then the application must perform the logout itself.
18273
18334
  * To perform the logout by yourself, a logoutHandler can be configured that will be called with the logoutUrl.
18335
+ * Is set to false automatically if useQdAuthLogout is active.
18274
18336
  *
18275
18337
  * * web component: 'handle-logout'
18276
18338
  *
@@ -18280,10 +18342,24 @@ interface QdShellServiceNavigationConfig {
18280
18342
  /**
18281
18343
  * @description Will be called when the logout is triggered if handleLogout is set to false. Then you can perform
18282
18344
  * the logout by yourself in the handler. The logoutUrl will be passed to the logoutHandler.
18345
+ * If a logoutHandler is configured, it takes precedence over useQdAuthLogout.
18283
18346
  *
18284
18347
  * * web component: 'logoutTriggered' output
18285
18348
  */
18286
18349
  logoutHandler?: (logoutUrl: string) => void;
18350
+ /**
18351
+ * @description Ends both the Keycloak session and the PAMS session when the user logs out in the service navigation.
18352
+ * The logout is first performed via QD Auth (Keycloak) and then continued with the PAMS logout of the service navigation.
18353
+ * handleLogout is set to false automatically.
18354
+ *
18355
+ * Requires QD Auth with support for `logoutAndContinueTo`. Without it, the logout is handled by the service navigation only.
18356
+ * Ignored if a logoutHandler is configured.
18357
+ *
18358
+ * * Note: The default will change to true with the next major version.
18359
+ *
18360
+ * * @default: false
18361
+ */
18362
+ useQdAuthLogout?: boolean;
18287
18363
  /**
18288
18364
  * @description Links displayed in the profile menu. You can also add a badge for each input, and they also handle different languages.
18289
18365
  *
@@ -19155,6 +19231,7 @@ declare class QdShellServiceNavigationComponent implements OnInit, OnDestroy, Af
19155
19231
  private _config;
19156
19232
  private _destroyed$;
19157
19233
  private _attributesHaveBeenSet$;
19234
+ private _qdAuthLogoutUnavailableWarningLogged;
19158
19235
  private readonly localeService;
19159
19236
  ngOnInit(): void;
19160
19237
  private setPamsEnvironment;
@@ -19165,8 +19242,10 @@ declare class QdShellServiceNavigationComponent implements OnInit, OnDestroy, Af
19165
19242
  ngOnDestroy(): void;
19166
19243
  handleLanguageChange($event: any): void;
19167
19244
  handleLoginStatusChange($event: any): void;
19168
- handleLogoutTriggered($event: any): void;
19245
+ handleLogoutTriggered($event: Event | string): void;
19169
19246
  private passConfig;
19247
+ private shouldUseQdAuthLogout;
19248
+ private logQdAuthLogoutUnavailableWarning;
19170
19249
  private setAttributesForServiceNavigation;
19171
19250
  private useLanguage;
19172
19251
  static ɵfac: i0.ɵɵFactoryDeclaration<QdShellServiceNavigationComponent, never>;