@quadrel-enterprise-ui/framework 21.5.1 → 21.7.0

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.
@@ -597,6 +597,13 @@ const quadrelIconNames = flatten(quadrelIcons.map(icon => icon.name));
597
597
 
598
598
  /**
599
599
  * The component **QdIcon** can be used to display the icons available in the framework.
600
+ *
601
+ * @parent button[qdButtonStack] {supported}
602
+ * description: Replaces the arrow the stack button renders by default. It is the only slot that names an
603
+ * icon.
604
+ *
605
+ * @parent button[qdIconButton] {supported}
606
+ * description: The icon is what an icon button shows. Its slot takes one qd-icon and nothing else.
600
607
  */
601
608
  class QdIconComponent {
602
609
  elementRef = inject(ElementRef);
@@ -995,6 +1002,26 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
995
1002
  /**
996
1003
  * The **QdButton** component, as the name suggests, provides a simple button.<br />
997
1004
  * It is possible to bind it to either a `button` tag or to an `a` tag.
1005
+ *
1006
+ * @slot default {text}
1007
+ * description: Holds the label of the button.
1008
+ * enforcedBy: none
1009
+ *
1010
+ * @parent qd-button-grid {supported}
1011
+ * description: Several buttons in a row belong in a button grid, which spaces and wraps them.
1012
+ *
1013
+ * @parent qd-grid {supported}
1014
+ * description: For a single button that takes its own cell in a form layout.
1015
+ *
1016
+ * @parent qd-dialog-action {supported}
1017
+ * description: The buttons of a dialog go into its action area, not into the dialog body.
1018
+ *
1019
+ * @parent qd-tile-button-list {supported}
1020
+ * description: The actions of a tile go into its button list, as the last row of the tile.
1021
+ *
1022
+ * @parent qd-section {unsupported}
1023
+ * description: A bare button in a section has no grid around it, so it lines up with nothing.
1024
+ * instead: Put it into the qd-grid that holds the form fields, in a cell of its own.
998
1025
  */
999
1026
  class QdButtonComponent {
1000
1027
  buttonLink = inject(QdButtonLinkDirective, { optional: true, host: true });
@@ -1075,6 +1102,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
1075
1102
  * Paragraph
1076
1103
  * </qd-text-section-paragraph>
1077
1104
  * </qd-text-section>
1105
+ *
1106
+ * @slot default {quadrel}
1107
+ * description: Holds the qd-text-section-headline and qd-text-section-paragraph elements of the text
1108
+ * section.
1109
+ * enforcedBy: none
1110
+ *
1111
+ * @parent qd-page-control-panel {supported}
1112
+ * description: The panel names the text section in a slot and renders it above the panel sections.
1113
+ *
1114
+ * @parent qd-dialog-confirmation {supported}
1115
+ * description: Marked with qdDialogConfirmInfo, qdDialogConfirmSuccess or qdDialogConfirmError, it is the
1116
+ * text the confirmation dialog shows in that state.
1078
1117
  */
1079
1118
  class QdTextSectionComponent {
1080
1119
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: QdTextSectionComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
@@ -1089,6 +1128,17 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
1089
1128
  * The **QdTextSectionParagraph** component creates a body text inside the **QdTextSectionContainer**.
1090
1129
  *
1091
1130
  * * @see parent component: **QdTextSection**.
1131
+ *
1132
+ * @slot default {text}
1133
+ * description: Carries the body text of the text section.
1134
+ * enforcedBy: none
1135
+ *
1136
+ * @parent qd-text-section {supported}
1137
+ * description: The body text of a text section, below the headline.
1138
+ *
1139
+ * @parent qd-section {unsupported}
1140
+ * description: A paragraph on its own has no headline to belong to and none of the text spacing.
1141
+ * instead: Wrap it in a qd-text-section, together with the headline.
1092
1142
  */
1093
1143
  class QdTextSectionParagraphComponent {
1094
1144
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: QdTextSectionParagraphComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
@@ -1099,6 +1149,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
1099
1149
  args: [{ selector: 'qd-text-section-paragraph', host: { class: 'qd-text-section-paragraph-wrapper' }, standalone: false, template: "<p class=\"qd-text-section-paragraph\"><ng-content></ng-content></p>\n", styles: [":host{display:block;margin:1rem 1rem 1.5rem}:host{margin:0 0 1.5rem}.qd-text-section-paragraph{padding:0;margin:0;color:#171717;font-size:.875rem;font-weight:300;line-height:1.375rem}\n"] }]
1100
1150
  }] });
1101
1151
 
1152
+ /**
1153
+ * The **QdDialogAction** component holds the buttons of a dialog.
1154
+ *
1155
+ * * @see parent component **QdDialog**.
1156
+ *
1157
+ * @slot default {quadrel}
1158
+ * description: Holds the dialog buttons, written with the qdButton directive.
1159
+ * enforcedBy: none
1160
+ *
1161
+ * @parent qd-dialog {supported}
1162
+ * description: The only place for dialog buttons. The dialog names it in a slot and puts it in the footer.
1163
+ */
1102
1164
  class QdDialogActionComponent {
1103
1165
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: QdDialogActionComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
1104
1166
  static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "21.2.17", type: QdDialogActionComponent, isStandalone: false, selector: "qd-dialog-action", ngImport: i0, template: "<ng-content></ng-content>\n", styles: [":host{display:flex;column-gap:.625rem}\n"], changeDetection: i0.ChangeDetectionStrategy.OnPush });
@@ -1293,6 +1355,20 @@ const QD_PAGE_DIALOG_WITH_BREADCRUMBS_HOST = new InjectionToken('QD_PAGE_DIALOG_
1293
1355
  /**
1294
1356
  * **QdDialogService**: Service for managing dialogs in the application.
1295
1357
  * This service provides methods to open, close, and manage the handling of dialog data.
1358
+ *
1359
+ * @slot open {custom-component}
1360
+ * description: Renders your component inside a dialog. Its template should be built with qd-dialog.
1361
+ * enforcedBy: none
1362
+ *
1363
+ * @slot openFullscreen {custom-component}
1364
+ * description: Renders your component inside a fullscreen dialog.
1365
+ * enforcedBy: none
1366
+ *
1367
+ * @slot dialog {custom-markup}
1368
+ * description: Renders a route of your application inside the page dialog. openPageDialogWithBreadcrumbs
1369
+ * opens it and navigates there, navigateInsideDialog moves on to another route. This is an exit
1370
+ * point: whatever the route renders ends up here.
1371
+ * enforcedBy: router-config
1296
1372
  */
1297
1373
  class QdDialogService {
1298
1374
  dialog = inject(Dialog);
@@ -1430,6 +1506,16 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
1430
1506
  /**
1431
1507
  * The **QdIconButton** can only display icons, in contrast to the **QdButton**. <br />
1432
1508
  * It is possible to bind it to either a `button` tag or to an `a` tag.
1509
+ *
1510
+ * @slot default {quadrel}
1511
+ * description: Holds the qd-icon that is shown inside the button.
1512
+ * enforcedBy: none
1513
+ *
1514
+ * @parent qd-tile-button-list {supported}
1515
+ * description: The compact action of a tile, next to the other tile buttons.
1516
+ *
1517
+ * @parent qd-button-grid {supported}
1518
+ * description: Lines up with the labelled buttons of the same row.
1433
1519
  */
1434
1520
  class QdIconButtonComponent {
1435
1521
  /**
@@ -1513,7 +1599,20 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
1513
1599
  * You have unsaved changes!
1514
1600
  * </form>
1515
1601
  * </qd-dialog>
1516
- * */
1602
+ *
1603
+ *
1604
+ * @slot qd-page-info-banner {quadrel}
1605
+ * description: Holds the banner strip between the title and the body.
1606
+ * enforcedBy: ng-content-select
1607
+ *
1608
+ * @slot default {custom-markup}
1609
+ * description: Carries the body of the dialog, which the app owns completely.
1610
+ * enforcedBy: none
1611
+ *
1612
+ * @slot qd-dialog-action {quadrel}
1613
+ * description: Takes an extra dialog button that the config cannot express.
1614
+ * enforcedBy: ng-content-select
1615
+ */
1517
1616
  class QdDialogComponent {
1518
1617
  dialogRef = inject(DialogRef);
1519
1618
  dialog = inject(QdConfirmationDialogOpenerService);
@@ -1878,7 +1977,6 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
1878
1977
  }]
1879
1978
  }] });
1880
1979
 
1881
- // @ts-strict-ignore
1882
1980
  class QdMockButtonComponent {
1883
1981
  disabled = false;
1884
1982
  color = 'primary';
@@ -2043,7 +2141,6 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
2043
2141
 
2044
2142
  const chipStateDefault = 'info';
2045
2143
 
2046
- // @ts-strict-ignore
2047
2144
  class QdMockChipComponent {
2048
2145
  state = chipStateDefault;
2049
2146
  close = false;
@@ -2146,7 +2243,6 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
2146
2243
  }]
2147
2244
  }] });
2148
2245
 
2149
- // @ts-strict-ignore
2150
2246
  class QdMockContactCardComponent {
2151
2247
  contactData;
2152
2248
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: QdMockContactCardComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
@@ -2238,7 +2334,6 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
2238
2334
  }]
2239
2335
  }] });
2240
2336
 
2241
- // @ts-strict-ignore
2242
2337
  class QdMockPopoverOnClickDirective {
2243
2338
  viewContainerRef = inject(ViewContainerRef);
2244
2339
  hostRef = inject(ElementRef);
@@ -2291,7 +2386,8 @@ class QdMockPopoverOnClickDirective {
2291
2386
  const templateRootNode = this.getTemplateRootNode();
2292
2387
  if (!templateRootNode)
2293
2388
  return false;
2294
- return Array.prototype.some.call([templateRootNode, ...(templateRootNode?.getElementsByTagName(event.target.tagName) || [])], element => element === event.target);
2389
+ const elementsWithSameTag = templateRootNode.getElementsByTagName(event.target.tagName);
2390
+ return [templateRootNode, ...Array.from(elementsWithSameTag)].some(element => element === event.target);
2295
2391
  }
2296
2392
  getTemplateRootNode() {
2297
2393
  return this._embeddedView?.rootNodes?.[0];
@@ -5782,7 +5878,6 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
5782
5878
  }]
5783
5879
  }] });
5784
5880
 
5785
- // @ts-strict-ignore
5786
5881
  /**
5787
5882
  * @description Renders just a blank element.
5788
5883
  *
@@ -5865,6 +5960,10 @@ const qdHasContent = (value) => value !== '' && value !== undefined && value !==
5865
5960
 
5866
5961
  /**
5867
5962
  * The **QdChip** component can visualize different statuses.
5963
+ *
5964
+ * @slot default {text}
5965
+ * description: Carries the label text of the chip.
5966
+ * enforcedBy: none
5868
5967
  */
5869
5968
  class QdChipComponent {
5870
5969
  element = inject(ElementRef);
@@ -5909,7 +6008,7 @@ class QdChipComponent {
5909
6008
  this.renderer.setAttribute(this.element.nativeElement, 'class', this.classes);
5910
6009
  }
5911
6010
  isLabelEmpty() {
5912
- return this.label?.nativeElement?.innerHTML?.replace(/\s*/g, '') === '';
6011
+ return this.label.nativeElement.innerHTML.replace(/\s*/g, '') === '';
5913
6012
  }
5914
6013
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: QdChipComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
5915
6014
  static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.17", type: QdChipComponent, isStandalone: false, selector: "qd-chip", inputs: { state: "state", close: "close", data: "data", testId: ["data-test-id", "testId"] }, outputs: { closeClickEmitter: "closeClickEmitter" }, viewQueries: [{ propertyName: "label", first: true, predicate: ["label"], descendants: true }], usesOnChanges: true, ngImport: i0, template: "<span #label [class]=\"'qd-chip__label'\" [attr.data-test-id]=\"testId + '-caption'\"><ng-content></ng-content></span>\n@if (close) {\n<qd-icon\n [icon]=\"'times'\"\n (click)=\"$event.stopPropagation(); clickClose()\"\n [attr.data-test-id]=\"testId + '-close'\"\n></qd-icon>\n}\n", styles: [".qd-chip{display:inline-flex;padding:0 .5rem;border-width:.0625rem;border-style:solid;border-radius:1rem;cursor:default;font-size:.8125rem;font-weight:400;line-height:1.5rem;white-space:nowrap}.qd-chip .qd-icon{display:flex;cursor:pointer;font-size:1.25rem}.qd-chip.info{border-color:#069;color:#069}.qd-chip.positive{border-color:#00813a;color:#00813a}.qd-chip.warning{border-color:#ff9b00;color:#ff9b00}.qd-chip.critical{border-color:#c70023;color:#c70023}.qd-chip.inactive{border-color:#979797;background:#d5d5d5;color:#979797}qd-filter-category .qd-chip.qd-chip{border-color:#757575;background:#757575;color:#fff;font-size:.75rem}qd-filter-category .qd-chip.qd-chip:hover,qd-filter-category .qd-chip.qd-chip:focus{background:#333}.qd-chip.neutral{border-color:#757575;color:#171717}qd-layout-page-process-header .qd-chip{padding:0 1rem;border-radius:1rem;line-height:1.75rem}.panel-type-control .qd-chip{padding:0 .5rem;border:.0625rem solid;border-radius:1rem;background:none;line-height:1.5rem}.panel-type-control .qd-chip:before{display:inline-block;width:.625rem;height:.625rem;border-radius:50%;margin-right:.625rem;background:red;content:\"\"}.qd-chip.empty{display:none}\n"], dependencies: [{ kind: "component", type: QdIconComponent, selector: "qd-icon", inputs: ["icon", "status"] }], encapsulation: i0.ViewEncapsulation.None });
@@ -6141,7 +6240,6 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
6141
6240
  type: Input
6142
6241
  }] } });
6143
6242
 
6144
- // @ts-strict-ignore
6145
6243
  /**
6146
6244
  * @description Renders one or multiple chips.
6147
6245
  *
@@ -6177,13 +6275,14 @@ class QdDataFacetsChipComponent {
6177
6275
  this._chipsSubject.next(this.getChips());
6178
6276
  }
6179
6277
  getChips() {
6180
- if (!qdHasContent(this.data))
6278
+ const data = this.data;
6279
+ if (data === undefined || !qdHasContent(data))
6181
6280
  return [];
6182
- const chips = Array.isArray(this.data) ? this.data : [this.data];
6281
+ const chips = Array.isArray(data) ? data : [data];
6183
6282
  return chips.map(chip => this.toChip(chip)).filter(chip => qdHasContent(chip.label));
6184
6283
  }
6185
6284
  toChip(chip) {
6186
- const label = this.getLabel(chip);
6285
+ const label = this.getLabel(chip) ?? '';
6187
6286
  return {
6188
6287
  label,
6189
6288
  state: this.config?.state?.[label] || this.getState(chip) || chipStateDefault
@@ -6984,6 +7083,50 @@ function qdMergeParams(parts) {
6984
7083
  return qdWrapParams(merged);
6985
7084
  }
6986
7085
 
7086
+ const MEMORY_LIMIT = 20;
7087
+ /**
7088
+ * Remembers the view params of the routes a user has visited, so returning to one can restore them.
7089
+ *
7090
+ * Holds the most recent {@link MEMORY_LIMIT} paths and drops the oldest beyond that. The memory
7091
+ * lives in the browser tab only — a reload starts over.
7092
+ */
7093
+ class QdRouteAddressMemory {
7094
+ _byPath = new Map();
7095
+ remember(path, params) {
7096
+ this._byPath.delete(path);
7097
+ this._byPath.set(path, params);
7098
+ if (this._byPath.size <= MEMORY_LIMIT)
7099
+ return;
7100
+ const oldest = this._byPath.keys().next().value;
7101
+ if (oldest !== undefined)
7102
+ this._byPath.delete(oldest);
7103
+ }
7104
+ recall(path) {
7105
+ return this._byPath.get(path);
7106
+ }
7107
+ forget(path) {
7108
+ this._byPath.delete(path);
7109
+ }
7110
+ }
7111
+ /**
7112
+ * Strips the query string and the fragment, so `/orders?page=2#top` and `/orders` are one path.
7113
+ */
7114
+ function qdPathOf(url) {
7115
+ return url.split('#')[0].split('?')[0];
7116
+ }
7117
+ /**
7118
+ * Appends params to a path, keeping any the path already carries.
7119
+ */
7120
+ function qdAppendQueryParams(path, params) {
7121
+ const entries = Object.entries(params);
7122
+ if (entries.length === 0)
7123
+ return path;
7124
+ const [base, existing] = path.split('#')[0].split('?');
7125
+ const search = new URLSearchParams(existing);
7126
+ entries.forEach(([key, value]) => search.set(key, value));
7127
+ return `${base}?${search.toString()}`;
7128
+ }
7129
+
6987
7130
  /**
6988
7131
  * Framework-wide funnel for syncing application state with the URL `?key=value` query string.
6989
7132
  *
@@ -7056,6 +7199,7 @@ class QdRouterQueryParamHubService {
7056
7199
  _destroyRef = inject(DestroyRef);
7057
7200
  _ownership = new Map();
7058
7201
  _ownerLabels = new WeakMap();
7202
+ _addressMemory = new QdRouteAddressMemory();
7059
7203
  _destroyClaims = new WeakMap();
7060
7204
  _navigationSettledSubject = new ReplaySubject(1);
7061
7205
  _pendingParams = {};
@@ -7068,6 +7212,7 @@ class QdRouterQueryParamHubService {
7068
7212
  return;
7069
7213
  this.replayCurrentRouterStateForLateSubscribers(this._router);
7070
7214
  this.forwardSettlingRouterEventsToNavigationSettled(this._router);
7215
+ this.rememberViewParamsBeforeLeaving(this._router);
7071
7216
  }
7072
7217
  /**
7073
7218
  * Returns whether the hub can sync at all. False when the consuming injector has neither a
@@ -7119,24 +7264,43 @@ class QdRouterQueryParamHubService {
7119
7264
  * is not registered.
7120
7265
  */
7121
7266
  claim(keys, owner, destroyRef, featureLabel) {
7267
+ const conflicts = this.reserveKeys(keys, owner, destroyRef, featureLabel);
7268
+ if (conflicts.length === 0)
7269
+ return true;
7270
+ const existingOwner = this._ownership.get(conflicts[0]);
7271
+ console.error(this.formatOwnershipConflictMessage(conflicts, this._ownerLabels.get(existingOwner)));
7272
+ return false;
7273
+ }
7274
+ /**
7275
+ * Like `claim()`, but silent when the keys are taken.
7276
+ *
7277
+ * For callers that handle the failure themselves. A logged error would mislead there, and it
7278
+ * turns Jest runs red.
7279
+ */
7280
+ tryClaim(keys, owner, destroyRef, featureLabel) {
7281
+ return this.reserveKeys(keys, owner, destroyRef, featureLabel).length === 0;
7282
+ }
7283
+ /**
7284
+ * Reading only — never takes a key away from a later `claim()`.
7285
+ */
7286
+ isClaimed(key) {
7287
+ return this._ownership.has(key);
7288
+ }
7289
+ reserveKeys(keys, owner, destroyRef, featureLabel) {
7122
7290
  const conflicts = [];
7123
7291
  for (const key of keys) {
7124
7292
  const existing = this._ownership.get(key);
7125
7293
  if (existing && existing !== owner)
7126
7294
  conflicts.push(key);
7127
7295
  }
7128
- if (conflicts.length > 0) {
7129
- const existingOwner = this._ownership.get(conflicts[0]);
7130
- const existingLabel = this._ownerLabels.get(existingOwner);
7131
- console.error(this.formatOwnershipConflictMessage(conflicts, existingLabel));
7132
- return false;
7133
- }
7296
+ if (conflicts.length > 0)
7297
+ return conflicts;
7134
7298
  keys.forEach(key => this._ownership.set(key, owner));
7135
7299
  if (featureLabel)
7136
7300
  this._ownerLabels.set(owner, featureLabel);
7137
7301
  if (destroyRef && keys.length > 0)
7138
7302
  this.registerAutoRelease(owner, keys, destroyRef);
7139
- return true;
7303
+ return [];
7140
7304
  }
7141
7305
  formatOwnershipConflictMessage(conflicts, existingLabel) {
7142
7306
  const keysList = conflicts.map(key => `"${key}"`).join(', ');
@@ -7146,7 +7310,10 @@ class QdRouterQueryParamHubService {
7146
7310
  const lines = [
7147
7311
  `Quadrel Framework | Router Query Param Hub - ${paramHeader} ${keysList} ${verb} already owned by ${ownerPhrase}.`
7148
7312
  ];
7149
- if (existingLabel) {
7313
+ if (existingLabel?.hasUid) {
7314
+ lines.push(`Every router-connected ${existingLabel.name} on a view needs its own param keys.`, `Please give each of the ${existingLabel.plural} a distinct uid, or set connectWithRouter: false on the extra ones.`);
7315
+ }
7316
+ else if (existingLabel) {
7150
7317
  lines.push(`Only one router-connected ${existingLabel.name} is allowed per view.`, `Please set connectWithRouter: false on all additional ${existingLabel.plural}.`);
7151
7318
  }
7152
7319
  else {
@@ -7187,6 +7354,51 @@ class QdRouterQueryParamHubService {
7187
7354
  snapshotQueryParam(key) {
7188
7355
  return this._activatedRoute?.snapshot.queryParamMap.get(key) ?? undefined;
7189
7356
  }
7357
+ /**
7358
+ * Reserves a whole namespace, so no second instance can use the same `uid`.
7359
+ *
7360
+ * Claiming the params alone misses two tables that sync different features: they contend for no
7361
+ * key, yet share one namespace and one store entry.
7362
+ */
7363
+ claimNamespace(namespace, owner, messageFeature, destroyRef, featureLabel) {
7364
+ if (this.tryClaim([namespaceReservationKey(namespace)], owner, destroyRef, featureLabel))
7365
+ return true;
7366
+ const name = featureLabel?.name.toLowerCase() ?? 'instance';
7367
+ console.error(`Quadrel Framework | ${messageFeature} - Config key "uid" must be unique on a view. ` +
7368
+ `Got "${namespace}". Another ${name} already uses it, so both share one state.`);
7369
+ return false;
7370
+ }
7371
+ /**
7372
+ * Puts the view params a path last carried back into it.
7373
+ *
7374
+ * Used by the shell back button so a filtered overview comes back the way the user left it.
7375
+ *
7376
+ * @returns The path with its remembered params, or unchanged when nothing is remembered.
7377
+ */
7378
+ restoreAddress(path) {
7379
+ const remembered = this._addressMemory.recall(qdPathOf(path));
7380
+ return remembered ? qdAppendQueryParams(path, remembered) : path;
7381
+ }
7382
+ /**
7383
+ * Navigates to another route behind every write that is still pending.
7384
+ *
7385
+ * A param write scheduled a moment earlier would otherwise overtake the navigation and land on
7386
+ * the route the user just left.
7387
+ */
7388
+ navigateToUrl(url) {
7389
+ const router = this._router;
7390
+ if (!router)
7391
+ return;
7392
+ this._navigationChain = this._navigationChain.catch(() => undefined).then(() => router.navigateByUrl(url));
7393
+ }
7394
+ /**
7395
+ * Tells whether a param carries more than one value, as in `?sort=a&sort=b`.
7396
+ *
7397
+ * `snapshotQueryParam()` would silently return only the first.
7398
+ */
7399
+ hasRepeatedQueryParam(key) {
7400
+ return (this._activatedRoute?.snapshot.queryParamMap.getAll(key).length ?? 0) > 1;
7401
+ }
7190
7402
  /**
7191
7403
  * Schedules a query-param update.
7192
7404
  *
@@ -7238,6 +7450,23 @@ class QdRouterQueryParamHubService {
7238
7450
  .pipe(filter(event => event instanceof NavigationEnd || event instanceof NavigationCancel || event instanceof NavigationError), takeUntilDestroyed(this._destroyRef))
7239
7451
  .subscribe(() => this._navigationSettledSubject.next());
7240
7452
  }
7453
+ rememberViewParamsBeforeLeaving(router) {
7454
+ router.events
7455
+ .pipe(filter(event => event instanceof NavigationStart), takeUntilDestroyed(this._destroyRef))
7456
+ .subscribe(() => this._addressMemory.remember(qdPathOf(router.url ?? ''), this.collectViewParams()));
7457
+ }
7458
+ collectViewParams() {
7459
+ const snapshot = this._activatedRoute?.snapshot?.queryParams ?? {};
7460
+ const collected = {};
7461
+ this._ownership.forEach((owner, key) => {
7462
+ if (!this._ownerLabels.get(owner)?.isViewState)
7463
+ return;
7464
+ const value = snapshot[key];
7465
+ if (typeof value === 'string')
7466
+ collected[key] = value;
7467
+ });
7468
+ return collected;
7469
+ }
7241
7470
  registerAutoRelease(owner, keys, destroyRef) {
7242
7471
  const existingClaims = this._destroyClaims.get(destroyRef);
7243
7472
  if (existingClaims) {
@@ -7272,6 +7501,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
7272
7501
  type: Injectable,
7273
7502
  args: [{ providedIn: 'root' }]
7274
7503
  }], ctorParameters: () => [] });
7504
+ /**
7505
+ * Builds the name a namespace reservation is held under.
7506
+ *
7507
+ * The colon cannot appear in a `uid` and never in a param key, so a reservation can never collide
7508
+ * with a real query param.
7509
+ *
7510
+ * @param namespace The `uid` being reserved.
7511
+ * @returns The internal name of the reservation.
7512
+ */
7513
+ function namespaceReservationKey(namespace) {
7514
+ return `uid:${namespace}`;
7515
+ }
7275
7516
 
7276
7517
  class QdRwdDisabledDirective {
7277
7518
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: QdRwdDisabledDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive });
@@ -9754,6 +9995,12 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
9754
9995
  * ```html
9755
9996
  * <qd-checkbox-chips [(values)]="values" [config]="config"></qd-checkbox-chips>
9756
9997
  * ```
9998
+ *
9999
+ * @parent qd-grid {supported}
10000
+ * description: A form field goes into a grid cell, so labels and field widths line up across the form.
10001
+ *
10002
+ * @parent qd-subgrid {supported}
10003
+ * description: For a field that belongs to a subgroup of the form and follows its own column count.
9757
10004
  */
9758
10005
  class QdCheckboxChipsComponent {
9759
10006
  checkboxChipsService = inject(QdCheckboxChipsService, { self: true });
@@ -10246,6 +10493,12 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
10246
10493
  * ```html
10247
10494
  * <qd-checkboxes [(values)]="values" [config]="config"></qd-checkboxes>
10248
10495
  * ```
10496
+ *
10497
+ * @parent qd-grid {supported}
10498
+ * description: A form field goes into a grid cell, so labels and field widths line up across the form.
10499
+ *
10500
+ * @parent qd-subgrid {supported}
10501
+ * description: For a field that belongs to a subgroup of the form and follows its own column count.
10249
10502
  */
10250
10503
  class QdCheckboxesComponent {
10251
10504
  checkboxesService = inject(QdCheckboxesService);
@@ -11202,21 +11455,22 @@ function qdDelayAndHold(options = {}) {
11202
11455
  : of(state)));
11203
11456
  }
11204
11457
 
11205
- // @ts-strict-ignore
11206
11458
  class QdTranslateService {
11207
11459
  translateService = inject(TranslateService);
11208
11460
  translate(translatable) {
11209
- let translation;
11210
11461
  if (translatable.i18n) {
11211
- translation = this.translateService.instant(translatable.i18n);
11462
+ const translation = this.translateService.instant(translatable.i18n);
11463
+ return translation || '';
11212
11464
  }
11213
- else if (translatable.translation) {
11214
- translation = translatable.translation[this.translateService.currentLang || 'de'];
11465
+ if (translatable.translation) {
11466
+ const language = this.translateService.currentLang || 'de';
11467
+ const translation = translatable.translation[language];
11215
11468
  if (translation === undefined) {
11216
11469
  console.error(`Quadrel Framework | QdTranslate - Language "${this.translateService.currentLang}" is not implemented.`);
11217
11470
  }
11471
+ return translation || '';
11218
11472
  }
11219
- return translation || '';
11473
+ return '';
11220
11474
  }
11221
11475
  get currentLang() {
11222
11476
  return this.translateService.currentLang;
@@ -11620,6 +11874,12 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
11620
11874
  * ```html
11621
11875
  * <qd-dropdown [(value)]="value" [config]="config"></qd-dropdown>
11622
11876
  * ```
11877
+ *
11878
+ * @parent qd-grid {supported}
11879
+ * description: A form field goes into a grid cell, so labels and field widths line up across the form.
11880
+ *
11881
+ * @parent qd-subgrid {supported}
11882
+ * description: For a field that belongs to a subgroup of the form and follows its own column count.
11623
11883
  */
11624
11884
  class QdDropdownComponent {
11625
11885
  translateService = inject(TranslateService);
@@ -12353,6 +12613,16 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
12353
12613
  * }
12354
12614
  * }
12355
12615
  * ```
12616
+ *
12617
+ * @slot [qdIconButton] {quadrel}
12618
+ * description: Puts an icon button into the suffix of the field, next to the status icons.
12619
+ * enforcedBy: ng-content-select
12620
+ *
12621
+ * @parent qd-grid {supported}
12622
+ * description: A form field goes into a grid cell, so labels and field widths line up across the form.
12623
+ *
12624
+ * @parent qd-subgrid {supported}
12625
+ * description: For a field that belongs to a subgroup of the form and follows its own column count.
12356
12626
  */
12357
12627
  class QdInputComponent {
12358
12628
  actionEmitterService = inject(QdFormsActionEmitterService);
@@ -12944,6 +13214,12 @@ const DEFAULT_LANGUAGE = 'de';
12944
13214
  * ```html
12945
13215
  * <qd-datepicker [(value)]="value" [config]="config"></qd-datepicker>
12946
13216
  * ```
13217
+ *
13218
+ * @parent qd-grid {supported}
13219
+ * description: A form field goes into a grid cell, so labels and field widths line up across the form.
13220
+ *
13221
+ * @parent qd-subgrid {supported}
13222
+ * description: For a field that belongs to a subgroup of the form and follows its own column count.
12947
13223
  */
12948
13224
  class QdDatepickerComponent {
12949
13225
  actionEmitterService = inject(QdFormsActionEmitterService);
@@ -13603,6 +13879,12 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
13603
13879
  *
13604
13880
  * When the full form is submitted, the file's metadata (such as name, type, and size) is included.
13605
13881
  * This allows the backend to perform cleanup tasks, like removing temporary uploads that were not saved.
13882
+ *
13883
+ * @parent qd-grid {supported}
13884
+ * description: A form field goes into a grid cell, so labels and field widths line up across the form.
13885
+ *
13886
+ * @parent qd-subgrid {supported}
13887
+ * description: For a field that belongs to a subgroup of the form and follows its own column count.
13606
13888
  */
13607
13889
  class QdFileUploadComponent {
13608
13890
  controlContainer = inject(ControlContainer, { optional: true, host: true, skipSelf: true });
@@ -14325,6 +14607,12 @@ const validatorsDroppedWithOptsWarning = 'Quadrel Framework | QdForms - QdFormCo
14325
14607
  * ```html
14326
14608
  * <qd-multi-input [(values)]="values" [config]="config"></qd-multi-input>
14327
14609
  * ```
14610
+ *
14611
+ * @parent qd-grid {supported}
14612
+ * description: A form field goes into a grid cell, so labels and field widths line up across the form.
14613
+ *
14614
+ * @parent qd-subgrid {supported}
14615
+ * description: For a field that belongs to a subgroup of the form and follows its own column count.
14328
14616
  */
14329
14617
  class QdMultiInputComponent {
14330
14618
  hostRef = inject(ElementRef);
@@ -14903,6 +15191,12 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
14903
15191
  * ```html
14904
15192
  * <qd-pin-code [(value)]="value" [config]="config"></qd-pin-code>
14905
15193
  * ```
15194
+ *
15195
+ * @parent qd-grid {supported}
15196
+ * description: A form field goes into a grid cell, so labels and field widths line up across the form.
15197
+ *
15198
+ * @parent qd-subgrid {supported}
15199
+ * description: For a field that belongs to a subgroup of the form and follows its own column count.
14906
15200
  */
14907
15201
  class QdPinCodeComponent {
14908
15202
  pinCodeService = inject(QdPinCodeService);
@@ -15369,6 +15663,12 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
15369
15663
  * ```html
15370
15664
  * <qd-radio-buttons [(value)]="value" [config]="config"></qd-radio-buttons>
15371
15665
  * ```
15666
+ *
15667
+ * @parent qd-grid {supported}
15668
+ * description: A form field goes into a grid cell, so labels and field widths line up across the form.
15669
+ *
15670
+ * @parent qd-subgrid {supported}
15671
+ * description: For a field that belongs to a subgroup of the form and follows its own column count.
15372
15672
  */
15373
15673
  class QdRadioButtonsComponent {
15374
15674
  radioButtonsService = inject(QdRadioButtonsService);
@@ -15864,6 +16164,12 @@ const getPlainTextFromHtml = (input, parserFactory = () => new DOMParser()) => {
15864
16164
  * ```html
15865
16165
  * <qd-richtext [(value)]="value" [config]="config"></qd-richtext>
15866
16166
  * ```
16167
+ *
16168
+ * @parent qd-grid {supported}
16169
+ * description: A form field goes into a grid cell, so labels and field widths line up across the form.
16170
+ *
16171
+ * @parent qd-subgrid {supported}
16172
+ * description: For a field that belongs to a subgroup of the form and follows its own column count.
15867
16173
  */
15868
16174
  class QdRichtextComponent {
15869
16175
  controlContainer = inject(ControlContainer, { optional: true, host: true, skipSelf: true });
@@ -16644,6 +16950,12 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
16644
16950
  * ```html
16645
16951
  * <qd-switches [(values)]="values" [config]="config"></qd-switches>
16646
16952
  * ```
16953
+ *
16954
+ * @parent qd-grid {supported}
16955
+ * description: A form field goes into a grid cell, so labels and field widths line up across the form.
16956
+ *
16957
+ * @parent qd-subgrid {supported}
16958
+ * description: For a field that belongs to a subgroup of the form and follows its own column count.
16647
16959
  */
16648
16960
  class QdSwitchesComponent {
16649
16961
  switchesService = inject(QdSwitchesService);
@@ -16910,6 +17222,12 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
16910
17222
  * ```html
16911
17223
  * <qd-textarea [(value)]="value" [config]="config"></qd-textarea>
16912
17224
  * ```
17225
+ *
17226
+ * @parent qd-grid {supported}
17227
+ * description: A form field goes into a grid cell, so labels and field widths line up across the form.
17228
+ *
17229
+ * @parent qd-subgrid {supported}
17230
+ * description: For a field that belongs to a subgroup of the form and follows its own column count.
16913
17231
  */
16914
17232
  class QdTextareaComponent {
16915
17233
  actionEmitterService = inject(QdFormsActionEmitterService);
@@ -17756,6 +18074,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
17756
18074
  * | remove() | context: string, id: string | Removes specific notification. | - |
17757
18075
  * | removeAll() | context: string | Removes all notifications in context. | - |
17758
18076
  * | reset() | - | Clear all notifications. | - |
18077
+ *
18078
+ * @slot qd-notification-content {quadrel}
18079
+ * description: Takes the message of an inline notification when the app needs markup instead of plain text.
18080
+ * enforcedBy: ng-content-select
17759
18081
  */
17760
18082
  class QdNotificationComponent {
17761
18083
  notificationService = inject(QdNotificationsService);
@@ -17833,6 +18155,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
17833
18155
 
17834
18156
  /**
17835
18157
  * **QdNotificationContent**: a container for the content of a single **QdNotification** item.
18158
+ *
18159
+ * @slot default {custom-markup}
18160
+ * description: Carries the message of one inline notification, any markup the app owns.
18161
+ * enforcedBy: none
18162
+ *
18163
+ * @parent qd-notification {supported}
18164
+ * description: The only place for it. The notification names this element and nothing else in its slot.
17836
18165
  */
17837
18166
  class QdNotificationContentComponent {
17838
18167
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: QdNotificationContentComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
@@ -18052,6 +18381,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
18052
18381
  * The **QdTextSectionHeadline** component creates a headline inside the **QdTextSectionContainer**.
18053
18382
  *
18054
18383
  * * @see parent component: **QdTextSection**.
18384
+ *
18385
+ * @slot default {text}
18386
+ * description: Carries the headline text of the text section.
18387
+ * enforcedBy: none
18388
+ *
18389
+ * @parent qd-text-section {supported}
18390
+ * description: The headline of a text section. It carries the heading style the section expects.
18055
18391
  */
18056
18392
  class QdTextSectionHeadlineComponent {
18057
18393
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: QdTextSectionHeadlineComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
@@ -18080,6 +18416,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
18080
18416
  * The **QdButtonGrid** component provides a container that allows to arrange multiple buttons horizontally.
18081
18417
  *
18082
18418
  * * @see parent component **QdButton**.
18419
+ *
18420
+ * @slot button {quadrel}
18421
+ * description: Takes the buttons that the app wants to arrange in a row.
18422
+ * enforcedBy: ng-content-select
18423
+ *
18424
+ * @parent qd-section {supported}
18425
+ * description: Groups the buttons that belong to the content of a section, below it.
18083
18426
  */
18084
18427
  class QdButtonGridComponent {
18085
18428
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: QdButtonGridComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
@@ -18094,6 +18437,17 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
18094
18437
  * With the **QdButtonStackButton** you can display and set up various states in the process.
18095
18438
  *
18096
18439
  * @see parent component **QdButtonStack**.
18440
+ *
18441
+ * @slot default {text}
18442
+ * description: Holds the label of the stack button.
18443
+ * enforcedBy: none
18444
+ *
18445
+ * @slot qd-icon {quadrel}
18446
+ * description: Takes an icon that replaces the one the component renders itself.
18447
+ * enforcedBy: ng-content-select
18448
+ *
18449
+ * @parent qd-button-stack {supported}
18450
+ * description: The only place for it. The stack names this button in a slot and stacks the entries.
18097
18451
  */
18098
18452
  class QdButtonStackButtonComponent {
18099
18453
  /**
@@ -18126,6 +18480,17 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
18126
18480
  * With the **QdButtonStack** component you can display and set up various states in the process.
18127
18481
  *
18128
18482
  * * @see child component **QdButtonStackButton**.
18483
+ *
18484
+ * @slot button[qdButtonStack] {quadrel}
18485
+ * description: Takes the stack buttons in the order the app writes them.
18486
+ * enforcedBy: ng-content-select
18487
+ *
18488
+ * @slot button[qd-button-stack] {quadrel}
18489
+ * description: The dash-style selector of v20. No directive answers to it any more, so a button written
18490
+ * this way is projected but not a stack button.
18491
+ * enforcedBy: ng-content-select
18492
+ * status: deprecated
18493
+ * instead: Write qdButtonStack, as the v20 to v21 migration guide says.
18129
18494
  */
18130
18495
  class QdButtonStackComponent {
18131
18496
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: QdButtonStackComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
@@ -18177,6 +18542,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
18177
18542
  * <!-- Secondary style (used as an action within a QdSection) -->
18178
18543
  * <button qdButtonGhost [qdMenuButton]="menuConfig">Open Menu</button>
18179
18544
  * ```
18545
+ *
18546
+ * @slot default {text}
18547
+ * description: Holds the label of the button that opens the menu.
18548
+ * enforcedBy: none
18549
+ *
18550
+ * @parent qd-button-grid {supported}
18551
+ * description: Groups the menu button with the other buttons that belong to the same content.
18180
18552
  */
18181
18553
  class QdMenuButtonComponent {
18182
18554
  qdButtonGhost = inject(QdButtonGhostDirective, { optional: true, host: true });
@@ -18193,7 +18565,7 @@ class QdMenuButtonComponent {
18193
18565
  }
18194
18566
  constructor() {
18195
18567
  const isViewportAdaptiveEnabled = inject(QD_VIEWPORT_ADAPTIVE_ENABLED, { optional: true });
18196
- this.onlyIconOnSmallViewport = isViewportAdaptiveEnabled;
18568
+ this.onlyIconOnSmallViewport = isViewportAdaptiveEnabled ?? false;
18197
18569
  }
18198
18570
  ngOnInit() {
18199
18571
  if (!this.config)
@@ -18322,6 +18694,16 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
18322
18694
  * <qd-input qdColumn="2" />
18323
18695
  * <qd-input qdColumn="3" />
18324
18696
  * </qd-grid>
18697
+ *
18698
+ * @parent qd-grid {supported}
18699
+ * description: Put the marker on a cell of a grid. It reads the column count from the grid around it.
18700
+ *
18701
+ * @parent qd-subgrid {supported}
18702
+ * description: The same inside a subgroup, where the subgrid sets the column count instead.
18703
+ *
18704
+ * @parent [qdColumns] {unsupported}
18705
+ * description: The marker works there, but the qdColumns directive is on its way out.
18706
+ * instead: Put the cell into a qd-grid.
18325
18707
  */
18326
18708
  class QdColumnDirective {
18327
18709
  _renderer = inject(Renderer2);
@@ -18653,6 +19035,11 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
18653
19035
  * <qd-input qdColumn="2" />
18654
19036
  * <qd-input qdColumn="3" />
18655
19037
  * </div>
19038
+ *
19039
+ * @parent qd-section {unsupported}
19040
+ * description: It turns your own element into a grid, and that is what qd-grid is for. The directive is on
19041
+ * its way out.
19042
+ * instead: Use a qd-grid.
18656
19043
  */
18657
19044
  class QdColumnsDirective {
18658
19045
  _renderer = inject(Renderer2);
@@ -18847,6 +19234,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
18847
19234
  * <qd-grid [formGroup]="form">
18848
19235
  * <qd-input formControlName="name" [config]="{ label: { i18n: 'i18n.name' } }" />
18849
19236
  * </qd-grid>
19237
+ *
19238
+ * @slot default {quadrel}
19239
+ * description: Takes the cells of the grid: form fields and other Quadrel components, each with the
19240
+ * qdColumn directive.
19241
+ * enforcedBy: none
19242
+ *
19243
+ * @parent qd-section {supported}
19244
+ * description: The normal way to lay out the content of a section, above all for form fields.
18850
19245
  */
18851
19246
  class QdGridComponent {
18852
19247
  _renderer = inject(Renderer2);
@@ -18917,6 +19312,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
18917
19312
  * <qd-input qdColumn="4" />
18918
19313
  * <qd-subgrid>
18919
19314
  * </qd-grid>
19315
+ *
19316
+ * @slot default {quadrel}
19317
+ * description: Takes the cells of one subgroup inside a qd-grid, each with the qdColumn directive.
19318
+ * enforcedBy: none
19319
+ *
19320
+ * @parent qd-grid {supported}
19321
+ * description: The only place for a subgrid. It groups cells inside a grid and starts its own column count.
18920
19322
  */
18921
19323
  class QdSubgridComponent {
18922
19324
  gridService = inject(QdGridService);
@@ -18971,6 +19373,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
18971
19373
  * <qd-input qdColumn="3" qdColumnBreakBefore /> <!-- will be placed in a new row -->
18972
19374
  * <qd-input qdColumn="3" />
18973
19375
  * </qd-grid>
19376
+ *
19377
+ * @parent qd-grid {supported}
19378
+ * description: Put it on a grid cell that has to start a new row. It only means something next to qdColumn.
18974
19379
  */
18975
19380
  class QdColumnBreakBeforeDirective {
18976
19381
  _renderer = inject(Renderer2);
@@ -19024,6 +19429,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
19024
19429
  * <qd-input qdColumn="2" />
19025
19430
  * <qd-input qdColumn="3" />
19026
19431
  * </qd-grid>
19432
+ *
19433
+ * @parent qd-grid {supported}
19434
+ * description: Put it on a grid cell that has to keep the next cell in its row. It works next to qdColumn.
19027
19435
  */
19028
19436
  class QdColumnNextInSameRowDirective {
19029
19437
  _renderer = inject(Renderer2);
@@ -19844,6 +20252,27 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
19844
20252
  * <qd-text-section qdDialogConfirmationError>Your custom error content</qd-text-section>
19845
20253
  * </qd-dialog-confirmation>
19846
20254
  * ```
20255
+ *
20256
+ * @slot [qdDialogConfirmInfo] {custom-markup}
20257
+ * description: Holds the content the dialog shows while it asks for confirmation.
20258
+ * enforcedBy: ng-content-select
20259
+ * status: defect
20260
+ * instead: Write the bare attribute qdDialogConfirmInfo on your element. The qdDialogConfirmationInfo
20261
+ * directive does not reach this slot.
20262
+ *
20263
+ * @slot [qdDialogConfirmSuccess] {custom-markup}
20264
+ * description: Holds the content the dialog shows after the confirmation succeeded.
20265
+ * enforcedBy: ng-content-select
20266
+ * status: defect
20267
+ * instead: Write the bare attribute qdDialogConfirmSuccess on your element. The
20268
+ * qdDialogConfirmationSuccess directive does not reach this slot.
20269
+ *
20270
+ * @slot [qdDialogConfirmError] {custom-markup}
20271
+ * description: Holds the content the dialog shows after the confirmation failed.
20272
+ * enforcedBy: ng-content-select
20273
+ * status: defect
20274
+ * instead: Write the bare attribute qdDialogConfirmError on your element. The qdDialogConfirmationError
20275
+ * directive does not reach this slot.
19847
20276
  */
19848
20277
  class QdDialogConfirmationComponent {
19849
20278
  confirmationResolver = inject(QD_DIALOG_CONFIRMATION_RESOLVER_TOKEN, {
@@ -19909,6 +20338,10 @@ class QdDialogConfirmationComponent {
19909
20338
  this.dialogRef?.close();
19910
20339
  }
19911
20340
  confirm() {
20341
+ if (!this.confirmationResolver) {
20342
+ console.error('Quadrel Framework | QdDialogConfirmation - Please provide a confirmation resolver.');
20343
+ return;
20344
+ }
19912
20345
  this.dialogService.startConfirmation();
19913
20346
  this._confirmSubscription.add(this.confirmationResolver.resolve().subscribe({
19914
20347
  next: () => this.handleSuccess(),
@@ -21084,6 +21517,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
21084
21517
  *
21085
21518
  * If your application needs authorization or custom download logic,
21086
21519
  * handle the download through your backend or file manager.
21520
+ *
21521
+ * @parent qd-section {supported}
21522
+ * description: The file list is the content of its own section, with the section title naming it.
21087
21523
  */
21088
21524
  class QdFileCollectorComponent {
21089
21525
  sectionActionService = inject(QdSectionToolbarActionService, { optional: true });
@@ -23150,6 +23586,204 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
23150
23586
  args: ['attr.data-test-id']
23151
23587
  }] } });
23152
23588
 
23589
+ const NAMESPACE_SEPARATOR = '.';
23590
+ const NAMESPACE_PATTERN = /^[A-Za-z0-9_-]+$/;
23591
+ /**
23592
+ * A namespace is part of every key of its instance, so it stays short enough to keep the address
23593
+ * readable.
23594
+ */
23595
+ const QD_QUERY_PARAM_NAMESPACE_MAX_LENGTH = 64;
23596
+ /**
23597
+ * Builds the key an adapter reads and writes: the plain one, or `<namespace>.<key>`.
23598
+ */
23599
+ function qdBuildQueryParamKey(namespace, key) {
23600
+ if (!namespace)
23601
+ return key;
23602
+ return namespace + NAMESPACE_SEPARATOR + key;
23603
+ }
23604
+ /**
23605
+ * The value ends up in the address bar, so it must survive a round trip without escaping and must
23606
+ * not contain the separator. Letters, digits, dashes and underscores only.
23607
+ */
23608
+ function qdIsUsableQueryParamNamespace(namespace) {
23609
+ if (!namespace || namespace.length > QD_QUERY_PARAM_NAMESPACE_MAX_LENGTH)
23610
+ return false;
23611
+ return NAMESPACE_PATTERN.test(namespace);
23612
+ }
23613
+
23614
+ const holds = new WeakMap();
23615
+ /**
23616
+ * Moves the values of an address saved before the namespace into the prefixed keys.
23617
+ *
23618
+ * Only one instance adopts a given key. The plain key is held until the end of the turn, so a
23619
+ * plain instance that connects in the same turn can still take it back and keep its value.
23620
+ *
23621
+ * @returns The params whose plain key this instance may keep reading.
23622
+ *
23623
+ * @deprecated v21 only. In v22 delete this file and its two calls in `query-param-binding.tools.ts`.
23624
+ */
23625
+ function qdAdoptPlainAddress(request) {
23626
+ const { hub, params, namespace } = request;
23627
+ const hold = holdOf(hub);
23628
+ const adoptable = params.filter(param => isAdoptable(hub, param, namespace));
23629
+ const adopted = adoptable.filter(param => hub.tryClaim([param], hold.owner));
23630
+ if (adopted.length === 0)
23631
+ return adopted;
23632
+ Promise.resolve().then(() => dropPlainKeys(hub, hold, adopted));
23633
+ hub.write(buildPrefixedValues(hub, adopted, namespace), { replaceUrl: true });
23634
+ return adopted;
23635
+ }
23636
+ /**
23637
+ * Lets an instance without a namespace take its plain keys back from an adoption in the same turn.
23638
+ *
23639
+ * @deprecated v21 only. Goes away with `qdAdoptPlainAddress`.
23640
+ */
23641
+ function qdTakeBackPlainAddress(hub, params) {
23642
+ const hold = holdOf(hub);
23643
+ for (const param of params) {
23644
+ const wasHeld = hub.isClaimed(param);
23645
+ hub.release([param], hold.owner);
23646
+ if (wasHeld && !hub.isClaimed(param))
23647
+ hold.takenBack.add(param);
23648
+ }
23649
+ }
23650
+ function holdOf(hub) {
23651
+ let hold = holds.get(hub);
23652
+ if (!hold) {
23653
+ hold = { owner: {}, takenBack: new Set() };
23654
+ holds.set(hub, hold);
23655
+ }
23656
+ return hold;
23657
+ }
23658
+ function isAdoptable(hub, param, namespace) {
23659
+ if (hub.isClaimed(param))
23660
+ return false;
23661
+ if (!hasValue(hub.snapshotQueryParam(param)))
23662
+ return false;
23663
+ return !hasValue(hub.snapshotQueryParam(qdBuildQueryParamKey(namespace, param)));
23664
+ }
23665
+ /**
23666
+ * A key that is present but empty, as in `?orders.page=`, names no value.
23667
+ */
23668
+ function hasValue(value) {
23669
+ return value !== undefined && value !== '';
23670
+ }
23671
+ function buildPrefixedValues(hub, params, namespace) {
23672
+ const values = {};
23673
+ for (const param of params)
23674
+ values[qdBuildQueryParamKey(namespace, param)] = hub.snapshotQueryParam(param);
23675
+ return values;
23676
+ }
23677
+ function dropPlainKeys(hub, hold, params) {
23678
+ const dropped = {};
23679
+ for (const param of params) {
23680
+ if (!hold.takenBack.delete(param))
23681
+ dropped[param] = undefined;
23682
+ }
23683
+ hub.release(params, hold.owner);
23684
+ hub.write(dropped, { replaceUrl: true });
23685
+ }
23686
+
23687
+ /**
23688
+ * Reserves the query-param keys of one instance and hands back a binding per param.
23689
+ *
23690
+ * An instance with a namespace writes keys prefixed with it, so a table with `uid: 'orders'` writes
23691
+ * `?orders.page=2`. An instance without one writes the plain names, which only one instance per page
23692
+ * can do. An unusable namespace is reported and treated as none.
23693
+ *
23694
+ * Call once per instance.
23695
+ */
23696
+ function qdBindQueryParams(request) {
23697
+ const { hub, params, ownsNamespace, owner, destroyRef, featureLabel, messageFeature } = request;
23698
+ const namespace = resolveUsableNamespace(request.namespace, messageFeature);
23699
+ if (namespace === undefined) {
23700
+ qdTakeBackPlainAddress(hub, params);
23701
+ const claimed = hub.claim(params, owner, destroyRef, featureLabel);
23702
+ if (claimed)
23703
+ dropRepeatedValues(hub, params);
23704
+ return createBindings(claimed, undefined, []);
23705
+ }
23706
+ if (ownsNamespace === true && !hub.claimNamespace(namespace, owner, messageFeature, destroyRef, featureLabel)) {
23707
+ return createBindings(false, undefined, []);
23708
+ }
23709
+ const prefixed = params.map(param => qdBuildQueryParamKey(namespace, param));
23710
+ if (!hub.claim(prefixed, owner, destroyRef, featureLabel))
23711
+ return createBindings(false, undefined, []);
23712
+ dropRepeatedValues(hub, prefixed);
23713
+ const adoptedParams = qdAdoptPlainAddress({ hub, params, namespace });
23714
+ return createBindings(true, namespace, adoptedParams);
23715
+ }
23716
+ /**
23717
+ * A namespace that cannot stand in a URL is reported and dropped, so the instance writes the plain
23718
+ * keys the way it did before namespaces existed.
23719
+ */
23720
+ function resolveUsableNamespace(namespace, messageFeature) {
23721
+ if (namespace === undefined || qdIsUsableQueryParamNamespace(namespace))
23722
+ return namespace;
23723
+ console.error(`Quadrel Framework | ${messageFeature} - Config key "uid" must be 1 to ${QD_QUERY_PARAM_NAMESPACE_MAX_LENGTH} characters long and contain only letters, digits, dashes and underscores. Got "${namespace}". The plain query params are used instead.`);
23724
+ return undefined;
23725
+ }
23726
+ /**
23727
+ * Removes params the address carries more than once, since they name no single state.
23728
+ *
23729
+ * Replaces the history entry, so going back still leads where the user came from.
23730
+ */
23731
+ function dropRepeatedValues(hub, keys) {
23732
+ const repeated = keys.filter(key => hub.hasRepeatedQueryParam(key));
23733
+ if (repeated.length === 0)
23734
+ return;
23735
+ const rewrite = {};
23736
+ repeated.forEach(key => (rewrite[key] = undefined));
23737
+ hub.write(rewrite, { replaceUrl: true });
23738
+ }
23739
+ /**
23740
+ * Angular hands back an array for a repeated key, as in `?sort=a&sort=b`. That counts as absent.
23741
+ */
23742
+ function readSingleValue(value) {
23743
+ return typeof value === 'string' ? value : undefined;
23744
+ }
23745
+ function createBindings(claimed, namespace, adoptedParams) {
23746
+ return {
23747
+ claimed,
23748
+ namespace,
23749
+ bindingFor: (param) => {
23750
+ const key = qdBuildQueryParamKey(namespace, param);
23751
+ const plainKey = adoptedParams.includes(param) ? param : undefined;
23752
+ return {
23753
+ key,
23754
+ read: (lookup) => {
23755
+ const own = readSingleValue(lookup(key));
23756
+ if (own !== undefined && own !== '')
23757
+ return own;
23758
+ if (plainKey === undefined)
23759
+ return own;
23760
+ return readSingleValue(lookup(plainKey)) ?? own;
23761
+ }
23762
+ };
23763
+ }
23764
+ };
23765
+ }
23766
+
23767
+ /**
23768
+ * Holds the URL namespace of one section, so filter and search share the prefix of its table.
23769
+ *
23770
+ * @deprecated Planned for removal in v22.
23771
+ */
23772
+ class QdSectionUrlNamespaceService {
23773
+ _namespace;
23774
+ set(namespace) {
23775
+ this._namespace = namespace;
23776
+ }
23777
+ get() {
23778
+ return this._namespace;
23779
+ }
23780
+ static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: QdSectionUrlNamespaceService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
23781
+ static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: QdSectionUrlNamespaceService });
23782
+ }
23783
+ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: QdSectionUrlNamespaceService, decorators: [{
23784
+ type: Injectable
23785
+ }] });
23786
+
23153
23787
  function parseFilterUrlParameter(filterUrlParameter) {
23154
23788
  return filterUrlParameter
23155
23789
  .split(getNotEscapedSplitRegExp(CATEGORY_SEPARATOR))
@@ -23177,19 +23811,24 @@ function unescape(escapedString) {
23177
23811
  }
23178
23812
 
23179
23813
  const FILTER_PARAM_NAME = 'filter';
23180
- const OWNED_PARAMS$4 = [FILTER_PARAM_NAME];
23181
- const FEATURE_LABEL$4 = { name: 'Filter', plural: 'filters' };
23814
+ const FEATURE_LABEL$4 = {
23815
+ name: 'Filter',
23816
+ plural: 'filters',
23817
+ hasUid: true,
23818
+ isViewState: true
23819
+ };
23182
23820
  /**
23183
- * Per-view adapter that syncs `QdFilterComponent` selection with the URL `?filter=` query
23184
- * param via `QdRouterQueryParamHubService`. Reads/parses on activation, writes on selection
23185
- * change. Coordination, ownership, and write batching are delegated to the hub — see its
23186
- * JSDoc for details. Behavior contracts live in `filter-router-connector.service.spec.ts`
23187
- * and `router-query-param-hub.integration.cy.ts`.
23821
+ * Per-view adapter that syncs `QdFilterComponent` selection with its filter query param.
23822
+ *
23823
+ * The param carries the namespace of its section, so a filter in a section whose table has
23824
+ * `uid: 'orders'` syncs `?orders.filter=`. Ownership and write batching belong to the hub.
23188
23825
  */
23189
23826
  class QdFilterRouterConnectorService {
23190
23827
  _filterService = inject(QdFilterService);
23191
23828
  _hub = inject(QdRouterQueryParamHubService);
23829
+ _sectionNamespace = inject(QdSectionUrlNamespaceService, { optional: true });
23192
23830
  _destroyRef = inject(DestroyRef);
23831
+ _filter;
23193
23832
  _connectedFilter;
23194
23833
  _readSubscription;
23195
23834
  _writeSubscription;
@@ -23203,7 +23842,7 @@ class QdFilterRouterConnectorService {
23203
23842
  return of(false);
23204
23843
  if (this._connectedFilter === filterComponent)
23205
23844
  return this._activatedRouteChecked$;
23206
- if (!this._hub.claim(OWNED_PARAMS$4, this, this._destroyRef, FEATURE_LABEL$4))
23845
+ if (!this.reserveParamKey())
23207
23846
  return of(false);
23208
23847
  this._connectedFilter = filterComponent;
23209
23848
  this._activatedRouteCheckedSubject = new ReplaySubject(1);
@@ -23212,6 +23851,20 @@ class QdFilterRouterConnectorService {
23212
23851
  this.subscribeToFilterChanges();
23213
23852
  return this._activatedRouteChecked$;
23214
23853
  }
23854
+ reserveParamKey() {
23855
+ const bindings = qdBindQueryParams({
23856
+ hub: this._hub,
23857
+ params: [FILTER_PARAM_NAME],
23858
+ namespace: this._sectionNamespace?.get(),
23859
+ ownsNamespace: false,
23860
+ owner: this,
23861
+ destroyRef: this._destroyRef,
23862
+ featureLabel: FEATURE_LABEL$4,
23863
+ messageFeature: 'QdFilter'
23864
+ });
23865
+ this._filter = bindings.bindingFor(FILTER_PARAM_NAME);
23866
+ return bindings.claimed;
23867
+ }
23215
23868
  tearDownConnection() {
23216
23869
  this._connectedFilter = undefined;
23217
23870
  this._readSubscription?.unsubscribe();
@@ -23220,7 +23873,7 @@ class QdFilterRouterConnectorService {
23220
23873
  subscribeToUrlChanges() {
23221
23874
  let isFirstEmit = true;
23222
23875
  this._readSubscription = this._hub.navigationSettled$
23223
- .pipe(switchMap(() => this._hub.queryParams()), map(queryParams => queryParams[FILTER_PARAM_NAME]), distinctUntilChanged(), switchMap(rawFilter => this._filterService.selectFilterDataById$(this._connectedFilter.filterId).pipe(take(1), map(filterData => ({ rawFilter, filterData })))), takeUntilDestroyed(this._destroyRef))
23876
+ .pipe(switchMap(() => this._hub.queryParams()), map(queryParams => this._filter.read(key => queryParams[key])), distinctUntilChanged(), switchMap(rawFilter => this._filterService.selectFilterDataById$(this._connectedFilter.filterId).pipe(take(1), map(filterData => ({ rawFilter, filterData })))), takeUntilDestroyed(this._destroyRef))
23224
23877
  .subscribe(({ rawFilter, filterData }) => {
23225
23878
  const emptySelection = filterData
23226
23879
  .map(category => ({ [category.category]: [] }))
@@ -23246,9 +23899,9 @@ class QdFilterRouterConnectorService {
23246
23899
  .pipe(distinctUntilChanged(), switchMap(filterUrlParameter => this._hub.navigationSettled$.pipe(take(1), map(() => filterUrlParameter))), takeUntilDestroyed(this._destroyRef))
23247
23900
  .subscribe(filterUrlParameter => {
23248
23901
  const target = filterUrlParameter || undefined;
23249
- if (this._hub.snapshotQueryParam(FILTER_PARAM_NAME) === target)
23902
+ if (this._hub.snapshotQueryParam(this._filter.key) === target)
23250
23903
  return;
23251
- this._hub.write({ [FILTER_PARAM_NAME]: target }, { replaceUrl: true });
23904
+ this._hub.write({ [this._filter.key]: target }, { replaceUrl: true });
23252
23905
  });
23253
23906
  }
23254
23907
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: QdFilterRouterConnectorService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
@@ -23434,6 +24087,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
23434
24087
  * preselection, and "Back to preselection" when the config starts with active items. It restores
23435
24088
  * the initial state. With instant filtering (`isInstantFiltering`) the apply and reset buttons
23436
24089
  * are hidden and the filter applies on every change.
24090
+ *
24091
+ * @parent qd-section {supported}
24092
+ * description: The section toolbar is where a filter belongs. A connector directive wires it to the
24093
+ * content.
23437
24094
  */
23438
24095
  class QdFilterComponent {
23439
24096
  filterService = inject(QdFilterService);
@@ -23933,6 +24590,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
23933
24590
  * The **QdContainerPairsCaption** is the key for a single key-value pair.
23934
24591
  *
23935
24592
  * * @see parent component: **QdContainerPairsItem**
24593
+ *
24594
+ * @slot default {text}
24595
+ * description: Carries the key of a key value pair.
24596
+ * enforcedBy: none
24597
+ *
24598
+ * @parent qd-container-pairs-item {supported}
24599
+ * description: The key half of one pair. The item names it in a slot and puts it before the value.
23936
24600
  */
23937
24601
  class QdContainerPairsCaptionComponent {
23938
24602
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: QdContainerPairsCaptionComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
@@ -23961,6 +24625,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
23961
24625
  * <qd-container-pairs-value>value</qd-container-pairs-value>
23962
24626
  * </qd-container-pairs-item>
23963
24627
  * </qd-container-pairs>
24628
+ *
24629
+ * @slot qd-container-pairs-header {quadrel}
24630
+ * description: Names the list, above all pairs.
24631
+ * enforcedBy: ng-content-select
24632
+ *
24633
+ * @slot default {quadrel}
24634
+ * description: Holds the qd-container-pairs-item elements of the list.
24635
+ * enforcedBy: none
23964
24636
  */
23965
24637
  class QdContainerPairsContainerComponent {
23966
24638
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: QdContainerPairsContainerComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
@@ -23975,6 +24647,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
23975
24647
  * The **QdContainerPairsHeader** is a header that can be placed inside a **QdContainerPair**.
23976
24648
  *
23977
24649
  * * @see parent component: **QdContainerPairs**
24650
+ *
24651
+ * @slot default {text}
24652
+ * description: Carries the headline of the pairs list.
24653
+ * enforcedBy: none
24654
+ *
24655
+ * @parent qd-container-pairs {supported}
24656
+ * description: The headline of the whole pairs list, rendered above the items.
23978
24657
  */
23979
24658
  class QdContainerPairsHeaderComponent {
23980
24659
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: QdContainerPairsHeaderComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
@@ -23990,6 +24669,17 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
23990
24669
  *
23991
24670
  * * @see parent component: **QdContainerPairs**
23992
24671
  * * @see child components: **QdContainerPairsCaption**, **QdContainerPairsValue**
24672
+ *
24673
+ * @slot qd-container-pairs-caption {quadrel}
24674
+ * description: Holds the key of the pair.
24675
+ * enforcedBy: ng-content-select
24676
+ *
24677
+ * @slot qd-container-pairs-value {quadrel}
24678
+ * description: Holds the value of the pair.
24679
+ * enforcedBy: ng-content-select
24680
+ *
24681
+ * @parent qd-container-pairs {supported}
24682
+ * description: One item per pair. The container gives the list its layout and spacing.
23993
24683
  */
23994
24684
  class QdContainerPairsItemComponent {
23995
24685
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: QdContainerPairsItemComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
@@ -24004,6 +24694,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
24004
24694
  * The **QdContainerPairsValue** is the value for a single key-value pair.
24005
24695
  *
24006
24696
  * * @see parent component: **QdContainerPairsItem**
24697
+ *
24698
+ * @slot default {text}
24699
+ * description: Carries the value of a key value pair.
24700
+ * enforcedBy: none
24701
+ *
24702
+ * @parent qd-container-pairs-item {supported}
24703
+ * description: The value half of one pair. The item names it in a slot and puts it after the key.
24007
24704
  */
24008
24705
  class QdContainerPairsValueComponent {
24009
24706
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: QdContainerPairsValueComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
@@ -24018,6 +24715,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
24018
24715
  * The **QdHorizontalPairsCaption** is the key for a single key-value pair.
24019
24716
  *
24020
24717
  * * @see parent component: **QdHorizontalPairsItem**
24718
+ *
24719
+ * @slot default {text}
24720
+ * description: Carries the key of a pair.
24721
+ * enforcedBy: none
24722
+ *
24723
+ * @parent qd-horizontal-pairs-item {supported}
24724
+ * description: The key half of one pair. The item renders key and value in the order they are written.
24021
24725
  */
24022
24726
  class QdHorizontalPairsCaptionComponent {
24023
24727
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: QdHorizontalPairsCaptionComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
@@ -24042,6 +24746,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
24042
24746
  * <qd-horizontal-pairs-value>value</qd-horizontal-pairs-value>
24043
24747
  * </qd-horizontal-pairs-item>
24044
24748
  * </qd-horizontal-pairs>
24749
+ *
24750
+ * @slot default {quadrel}
24751
+ * description: Holds the qd-horizontal-pairs-item elements of the list.
24752
+ * enforcedBy: none
24045
24753
  */
24046
24754
  class QdHorizontalPairsComponent {
24047
24755
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: QdHorizontalPairsComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
@@ -24057,6 +24765,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
24057
24765
  *
24058
24766
  * * @see parent component: **QdHorizontalPairs**
24059
24767
  * * @see child components: **QdHorizontalPairsCaption**, **QdHorizontalPairsValue**
24768
+ *
24769
+ * @slot default {quadrel}
24770
+ * description: Holds one qd-horizontal-pairs-caption and one qd-horizontal-pairs-value.
24771
+ * enforcedBy: none
24772
+ *
24773
+ * @parent qd-horizontal-pairs {supported}
24774
+ * description: One item per pair. The container puts the pairs in a row and spaces them.
24060
24775
  */
24061
24776
  class QdHorizontalPairsItemComponent {
24062
24777
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: QdHorizontalPairsItemComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
@@ -24071,6 +24786,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
24071
24786
  * The **QdHorizontalPairsValue** is the value for a single key-value pair.
24072
24787
  *
24073
24788
  * * @see parent component: **QdHorizontalPairsItem**
24789
+ *
24790
+ * @slot default {text}
24791
+ * description: Carries the value of a pair.
24792
+ * enforcedBy: none
24793
+ *
24794
+ * @parent qd-horizontal-pairs-item {supported}
24795
+ * description: The value half of one pair, written next to the caption.
24074
24796
  */
24075
24797
  class QdHorizontalPairsValueComponent {
24076
24798
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: QdHorizontalPairsValueComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
@@ -24085,6 +24807,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
24085
24807
  * The **QdStatusPairsCaption** is the key for a single key-value pair.
24086
24808
  *
24087
24809
  * * @see parent component: **QdStatusPairsItem**
24810
+ *
24811
+ * @slot default {text}
24812
+ * description: Carries the key of a pair.
24813
+ * enforcedBy: none
24814
+ *
24815
+ * @parent qd-status-pairs-item {supported}
24816
+ * description: The key half of one pair, written before the value.
24088
24817
  */
24089
24818
  class QdStatusPairsCaptionComponent {
24090
24819
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: QdStatusPairsCaptionComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
@@ -24101,6 +24830,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
24101
24830
  * The message is displayed when a single **QdStatusPairsItem** is set to "Error".
24102
24831
  *
24103
24832
  * * @see parent component: **QdStatusPairs**
24833
+ *
24834
+ * @slot default {text}
24835
+ * description: Carries the error message that belongs to the pair. Rendered only while the pair is in an
24836
+ * error state.
24837
+ * enforcedBy: none
24838
+ *
24839
+ * @parent qd-status-pairs {supported}
24840
+ * description: The list picks up the error with a ContentChild query and shows it under the failing pair.
24104
24841
  */
24105
24842
  class QdStatusPairsErrorComponent {
24106
24843
  ref = inject(ChangeDetectorRef);
@@ -24122,6 +24859,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
24122
24859
  *
24123
24860
  * * @see parent component: **QdStatusPairs**
24124
24861
  * * @see child components: **QdStatusPairsCaption**, **QdStatusPairsValue**
24862
+ *
24863
+ * @slot default {quadrel}
24864
+ * description: Holds one qd-status-pairs-caption, one qd-status-pairs-value and at most one
24865
+ * qd-status-pairs-error.
24866
+ * enforcedBy: none
24867
+ *
24868
+ * @parent qd-status-pairs {supported}
24869
+ * description: One item per pair. The container gives the list its layout and reads the error state.
24125
24870
  */
24126
24871
  class QdStatusPairsItemComponent {
24127
24872
  /**
@@ -24164,6 +24909,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
24164
24909
  * </qd-status-pairs-item>
24165
24910
  * <qd-status-pairs-error>error</qd-status-pairs-error>
24166
24911
  * </qd-status-pairs>
24912
+ *
24913
+ * @slot default {quadrel}
24914
+ * description: Holds the qd-status-pairs-item elements of the status list.
24915
+ * enforcedBy: none
24916
+ *
24917
+ * @parent qd-panel-section {supported}
24918
+ * description: The panel section names the status pairs in a slot and renders them below its title.
24167
24919
  */
24168
24920
  class QdStatusPairsComponent {
24169
24921
  statusPairErrorRef;
@@ -24194,6 +24946,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
24194
24946
  * The **QdStatusPairsValue** is the value for a single key-value pair.
24195
24947
  *
24196
24948
  * * @see parent component: **QdStatusPairsItem**
24949
+ *
24950
+ * @slot default {text}
24951
+ * description: Carries the value of a pair.
24952
+ * enforcedBy: none
24953
+ *
24954
+ * @parent qd-status-pairs-item {supported}
24955
+ * description: The value half of one pair, written after the key.
24197
24956
  */
24198
24957
  class QdStatusPairsValueComponent {
24199
24958
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: QdStatusPairsValueComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
@@ -24287,6 +25046,11 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
24287
25046
  * <qd-navigation-tiles>
24288
25047
  * <a qd-navigation-tile title="Home" icon="home" routerLink="/home"></a>
24289
25048
  * </qd-navigation-tiles>
25049
+ *
25050
+ * @slot [qd-navigation-tile] {quadrel}
25051
+ * description: Takes the tiles of the navigation, which the app writes as anchors with the
25052
+ * qd-navigation-tile attribute.
25053
+ * enforcedBy: ng-content-select
24290
25054
  */
24291
25055
  class NavigationTilesComponent {
24292
25056
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: NavigationTilesComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
@@ -24385,19 +25149,23 @@ function searchReducer(state, action) {
24385
25149
 
24386
25150
  const PHRASE_PRESELECT_SEPARATOR = '|';
24387
25151
  const SEARCH_PARAM_NAME = 'search';
24388
- const OWNED_PARAMS$3 = [SEARCH_PARAM_NAME];
24389
- const FEATURE_LABEL$3 = { name: 'Search', plural: 'searches' };
25152
+ const FEATURE_LABEL$3 = {
25153
+ name: 'Search',
25154
+ plural: 'searches',
25155
+ hasUid: true,
25156
+ isViewState: true
25157
+ };
24390
25158
  /**
24391
- * Per-view adapter that syncs `QdSearchComponent` phrase and preselection with the URL
24392
- * `?search=` query param via `QdRouterQueryParamHubService`. Reads/parses on activation,
24393
- * writes when the search service emits a submit. Coordination, ownership, and write
24394
- * batching are delegated to the hub — see its JSDoc for details. Behavior contracts live
24395
- * in `search-router-connector.service.spec.ts` and
24396
- * `router-query-param-hub.integration.cy.ts`.
25159
+ * Per-view adapter that syncs `QdSearchComponent` phrase and preselection with its search param.
25160
+ *
25161
+ * The param carries the namespace of its section, so a search in a section whose table has
25162
+ * `uid: 'orders'` syncs `?orders.search=`. Ownership and write batching belong to the hub.
24397
25163
  */
24398
25164
  class QdSearchRouterConnectorService {
24399
25165
  _hub = inject(QdRouterQueryParamHubService);
25166
+ _sectionNamespace = inject(QdSectionUrlNamespaceService, { optional: true });
24400
25167
  _destroyRef = inject(DestroyRef);
25168
+ _search;
24401
25169
  _connectedSearch;
24402
25170
  _readSubscription;
24403
25171
  _writeSubscription;
@@ -24411,7 +25179,7 @@ class QdSearchRouterConnectorService {
24411
25179
  return of(false);
24412
25180
  if (this._connectedSearch === searchComponent)
24413
25181
  return this._activatedRouteChecked$;
24414
- if (!this._hub.claim(OWNED_PARAMS$3, this, this._destroyRef, FEATURE_LABEL$3))
25182
+ if (!this.reserveParamKey())
24415
25183
  return of(false);
24416
25184
  this._connectedSearch = searchComponent;
24417
25185
  this._activatedRouteCheckedSubject = new ReplaySubject(1);
@@ -24420,6 +25188,20 @@ class QdSearchRouterConnectorService {
24420
25188
  this.subscribeToSearchChanges();
24421
25189
  return this._activatedRouteChecked$;
24422
25190
  }
25191
+ reserveParamKey() {
25192
+ const bindings = qdBindQueryParams({
25193
+ hub: this._hub,
25194
+ params: [SEARCH_PARAM_NAME],
25195
+ namespace: this._sectionNamespace?.get(),
25196
+ ownsNamespace: false,
25197
+ owner: this,
25198
+ destroyRef: this._destroyRef,
25199
+ featureLabel: FEATURE_LABEL$3,
25200
+ messageFeature: 'QdSearch'
25201
+ });
25202
+ this._search = bindings.bindingFor(SEARCH_PARAM_NAME);
25203
+ return bindings.claimed;
25204
+ }
24423
25205
  tearDownConnection() {
24424
25206
  this._connectedSearch = undefined;
24425
25207
  this._readSubscription?.unsubscribe();
@@ -24428,7 +25210,7 @@ class QdSearchRouterConnectorService {
24428
25210
  subscribeToUrlChanges() {
24429
25211
  let isFirstEmit = true;
24430
25212
  this._readSubscription = this._hub.navigationSettled$
24431
- .pipe(switchMap(() => this._hub.queryParams()), map(queryParams => queryParams[SEARCH_PARAM_NAME]), distinctUntilChanged(), takeUntilDestroyed(this._destroyRef))
25213
+ .pipe(switchMap(() => this._hub.queryParams()), map(queryParams => this._search.read(key => queryParams[key])), distinctUntilChanged(), takeUntilDestroyed(this._destroyRef))
24432
25214
  .subscribe(rawSearch => {
24433
25215
  if (typeof rawSearch === 'string' && this._connectedSearch) {
24434
25216
  const [phrase, preSelect] = rawSearch
@@ -24451,9 +25233,9 @@ class QdSearchRouterConnectorService {
24451
25233
  this._writeSubscription = this._connectedSearch.searchService.searchPostBody$.pipe(switchMap(searchData => this._hub.navigationSettled$.pipe(take(1), map(() => searchData))), takeUntilDestroyed(this._destroyRef)).subscribe(({ phrase, preSelect }) => {
24452
25234
  const serialized = this.escape(phrase) + (preSelect ? PHRASE_PRESELECT_SEPARATOR + this.escape(preSelect) : '');
24453
25235
  const target = serialized || undefined;
24454
- if (this._hub.snapshotQueryParam(SEARCH_PARAM_NAME) === target)
25236
+ if (this._hub.snapshotQueryParam(this._search.key) === target)
24455
25237
  return;
24456
- this._hub.write({ [SEARCH_PARAM_NAME]: target }, { replaceUrl: false });
25238
+ this._hub.write({ [this._search.key]: target }, { replaceUrl: false });
24457
25239
  });
24458
25240
  }
24459
25241
  getNotEscapedSplitRegExp() {
@@ -26163,6 +26945,77 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
26163
26945
  type: Injectable
26164
26946
  }] });
26165
26947
 
26948
+ const SORT_PARAM_NAME$1 = 'sort';
26949
+ const PAGE_PARAM_NAME$1 = 'page';
26950
+ const SIZE_PARAM_NAME$1 = 'size';
26951
+ const FEATURE_LABEL$2 = {
26952
+ name: 'Table',
26953
+ plural: 'tables',
26954
+ hasUid: true,
26955
+ isViewState: true
26956
+ };
26957
+ /**
26958
+ * Decides once per table which query-param keys it uses, and hands a binding to every adapter.
26959
+ *
26960
+ * Sort and pagination connect in different lifecycle phases. Deciding per adapter would let one
26961
+ * table end up with `sort` and `orders.page` at the same time, so the choice is made here.
26962
+ *
26963
+ * Provided per table. The first `reserve()` settles it; later calls return the same outcome.
26964
+ */
26965
+ class QdTableUrlNamespaceService {
26966
+ _hub = inject(QdRouterQueryParamHubService);
26967
+ _sectionNamespace = inject(QdSectionUrlNamespaceService, { optional: true });
26968
+ _destroyRef = inject(DestroyRef);
26969
+ _bindings;
26970
+ _isSettled = false;
26971
+ /**
26972
+ * Reserves every key this table needs, in one go. Only the keys the config actually syncs.
26973
+ */
26974
+ reserve(config) {
26975
+ if (this._isSettled)
26976
+ return this._bindings?.claimed === true;
26977
+ this._isSettled = true;
26978
+ const params = this.collectSyncedParams(config);
26979
+ if (params.length === 0)
26980
+ return false;
26981
+ this._bindings = qdBindQueryParams({
26982
+ hub: this._hub,
26983
+ params,
26984
+ namespace: config.uid,
26985
+ ownsNamespace: true,
26986
+ owner: this,
26987
+ destroyRef: this._destroyRef,
26988
+ featureLabel: FEATURE_LABEL$2,
26989
+ messageFeature: 'QdTable'
26990
+ });
26991
+ if (this._bindings.claimed && this._bindings.namespace)
26992
+ this._sectionNamespace?.set(this._bindings.namespace);
26993
+ return this._bindings.claimed;
26994
+ }
26995
+ /**
26996
+ * Call only after `reserve()` returned true.
26997
+ */
26998
+ bindingFor(param) {
26999
+ return this._bindings.bindingFor(param);
27000
+ }
27001
+ collectSyncedParams(config) {
27002
+ const params = [];
27003
+ const sort = config.sort;
27004
+ const pagination = config.pagination;
27005
+ if (typeof sort === 'object' && sort.connectWithRouter === true)
27006
+ params.push(SORT_PARAM_NAME$1);
27007
+ if (typeof pagination === 'object' && pagination.connectWithRouter === true) {
27008
+ params.push(PAGE_PARAM_NAME$1, SIZE_PARAM_NAME$1);
27009
+ }
27010
+ return params;
27011
+ }
27012
+ static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: QdTableUrlNamespaceService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
27013
+ static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: QdTableUrlNamespaceService });
27014
+ }
27015
+ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: QdTableUrlNamespaceService, decorators: [{
27016
+ type: Injectable
27017
+ }] });
27018
+
26166
27019
  class QdTableSecondaryActionsService {
26167
27020
  _configSubject = new ReplaySubject(1);
26168
27021
  set configs(config) {
@@ -26188,8 +27041,6 @@ var QdPaginatorDirection;
26188
27041
 
26189
27042
  const PAGE_PARAM_NAME = 'page';
26190
27043
  const SIZE_PARAM_NAME = 'size';
26191
- const OWNED_PARAMS$2 = [PAGE_PARAM_NAME, SIZE_PARAM_NAME];
26192
- const FEATURE_LABEL$2 = { name: 'Table', plural: 'tables' };
26193
27044
  const SIZE_SANITY_MAX = 1000;
26194
27045
  /**
26195
27046
  * Per-view adapter that syncs `QdTablePaginatorComponent` page and size with the URL
@@ -26197,10 +27048,11 @@ const SIZE_SANITY_MAX = 1000;
26197
27048
  * synchronously on connect (so cross-adapter store reducers cannot stomp on the deep-linked
26198
27049
  * page), then keeps store and URL in sync. Coordination, ownership, and write batching are
26199
27050
  * delegated to the hub — see its JSDoc for details. Behavior contracts live in
26200
- * `pagination-router-connector.service.spec.ts` and `router-query-param-hub.integration.cy.ts`.
27051
+ * `pagination-router-connector.service.spec.ts` and `router-query-param-hub.service.cy.ts`.
26201
27052
  */
26202
27053
  class QdTablePaginationRouterConnectorService {
26203
27054
  _hub = inject(QdRouterQueryParamHubService);
27055
+ _namespaceService = inject(QdTableUrlNamespaceService);
26204
27056
  _destroyRef = inject(DestroyRef);
26205
27057
  _connection;
26206
27058
  _readSubscription;
@@ -26208,14 +27060,18 @@ class QdTablePaginationRouterConnectorService {
26208
27060
  _activatedRouteCheckedSubject = new ReplaySubject(1);
26209
27061
  _activatedRouteChecked$ = this._activatedRouteCheckedSubject.asObservable();
26210
27062
  _hasInitialUrlBeenSet = false;
27063
+ _page;
27064
+ _size;
26211
27065
  constructor() {
26212
27066
  this._destroyRef.onDestroy(() => this.tearDownConnection());
26213
27067
  }
26214
27068
  connectPaginationWithRouter(paginator, tableStoreService) {
26215
27069
  if (!paginator.shouldConnectWithRouter() || !this._hub.isAvailable())
26216
27070
  return of(false);
26217
- if (!this._hub.claim(OWNED_PARAMS$2, this, this._destroyRef, FEATURE_LABEL$2))
27071
+ if (!this._namespaceService.reserve(paginator.config))
26218
27072
  return of(false);
27073
+ this._page = this._namespaceService.bindingFor(PAGE_PARAM_NAME);
27074
+ this._size = this._namespaceService.bindingFor(SIZE_PARAM_NAME);
26219
27075
  this._connection = {
26220
27076
  paginator: paginator,
26221
27077
  tableStoreService: tableStoreService
@@ -26230,10 +27086,7 @@ class QdTablePaginationRouterConnectorService {
26230
27086
  }
26231
27087
  applyInitialUrlSynchronously() {
26232
27088
  const { tableStoreService, paginator } = this._connection;
26233
- const params = this.parseUrlParams({
26234
- [PAGE_PARAM_NAME]: this._hub.snapshotQueryParam(PAGE_PARAM_NAME),
26235
- [SIZE_PARAM_NAME]: this._hub.snapshotQueryParam(SIZE_PARAM_NAME)
26236
- });
27089
+ const params = this.parseUrlParams(key => this._hub.snapshotQueryParam(key));
26237
27090
  const pageSize = params.size ?? paginator.getPageSizeDefault();
26238
27091
  const pageIndex = params.page !== undefined ? params.page - 1 : 0;
26239
27092
  let currentInfo;
@@ -26260,7 +27113,7 @@ class QdTablePaginationRouterConnectorService {
26260
27113
  const { tableStoreService } = this._connection;
26261
27114
  let isFirstEmit = true;
26262
27115
  this._readSubscription = this._hub.navigationSettled$
26263
- .pipe(switchMap(() => this._hub.queryParams()), map(queryParams => this.parseUrlParams(queryParams)), distinctUntilChanged((a, b) => a.page === b.page && a.size === b.size), switchMap(params => combineLatest([tableStoreService.pageChangeInfo$(), tableStoreService.totalCount$()]).pipe(take(1), map(([currentInfo, totalCount]) => ({ params, currentInfo, totalCount })))))
27116
+ .pipe(switchMap(() => this._hub.queryParams()), map(queryParams => this.parseUrlParams(key => queryParams[key])), distinctUntilChanged((a, b) => a.page === b.page && a.size === b.size), switchMap(params => combineLatest([tableStoreService.pageChangeInfo$(), tableStoreService.totalCount$()]).pipe(take(1), map(([currentInfo, totalCount]) => ({ params, currentInfo, totalCount })))))
26264
27117
  .subscribe(({ params, currentInfo, totalCount }) => {
26265
27118
  const target = this.toStoreState(params);
26266
27119
  const isChanged = !currentInfo || currentInfo.pageIndex !== target.pageIndex || currentInfo.pageSize !== target.pageSize;
@@ -26285,19 +27138,19 @@ class QdTablePaginationRouterConnectorService {
26285
27138
  this._hasInitialUrlBeenSet = true;
26286
27139
  const targetPage = String(pageIndex + 1);
26287
27140
  const targetSize = String(pageSize);
26288
- const urlAlreadyMatches = this._hub.snapshotQueryParam(PAGE_PARAM_NAME) === targetPage &&
26289
- this._hub.snapshotQueryParam(SIZE_PARAM_NAME) === targetSize;
27141
+ const urlAlreadyMatches = this._hub.snapshotQueryParam(this._page.key) === targetPage &&
27142
+ this._hub.snapshotQueryParam(this._size.key) === targetSize;
26290
27143
  if (urlAlreadyMatches)
26291
27144
  return;
26292
- this._hub.write({ [PAGE_PARAM_NAME]: targetPage, [SIZE_PARAM_NAME]: targetSize }, { replaceUrl });
27145
+ this._hub.write({ [this._page.key]: targetPage, [this._size.key]: targetSize }, { replaceUrl });
26293
27146
  }
26294
- parseUrlParams(queryParams) {
27147
+ parseUrlParams(lookup) {
26295
27148
  const result = {};
26296
- const rawPage = queryParams[PAGE_PARAM_NAME];
27149
+ const rawPage = this._page.read(lookup);
26297
27150
  if (typeof rawPage === 'string' && this.isValidPositiveIntegerString(rawPage)) {
26298
27151
  result.page = Number(rawPage);
26299
27152
  }
26300
- const rawSize = queryParams[SIZE_PARAM_NAME];
27153
+ const rawSize = this._size.read(lookup);
26301
27154
  if (typeof rawSize === 'string' &&
26302
27155
  this.isValidPositiveIntegerString(rawSize) &&
26303
27156
  this.isValidSize(Number(rawSize))) {
@@ -26662,8 +27515,6 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
26662
27515
  }] } });
26663
27516
 
26664
27517
  const SORT_PARAM_NAME = 'sort';
26665
- const OWNED_PARAMS$1 = [SORT_PARAM_NAME];
26666
- const FEATURE_LABEL$1 = { name: 'Table', plural: 'tables' };
26667
27518
  const SEGMENT_SEPARATOR = ',';
26668
27519
  const COLUMN_DIRECTION_SEPARATOR = '.';
26669
27520
  /**
@@ -26672,10 +27523,11 @@ const COLUMN_DIRECTION_SEPARATOR = '.';
26672
27523
  * only; multi-segment URLs use the first valid entry and warn), writes when the store's
26673
27524
  * `tableSort$` selector emits. Coordination, ownership, and write batching are delegated
26674
27525
  * to the hub — see its JSDoc for details. Behavior contracts live in
26675
- * `sort-router-connector.service.spec.ts` and `router-query-param-hub.integration.cy.ts`.
27526
+ * `sort-router-connector.service.spec.ts` and `router-query-param-hub.service.cy.ts`.
26676
27527
  */
26677
27528
  class QdTableSortRouterConnectorService {
26678
27529
  _hub = inject(QdRouterQueryParamHubService);
27530
+ _namespaceService = inject(QdTableUrlNamespaceService);
26679
27531
  _destroyRef = inject(DestroyRef);
26680
27532
  _connection;
26681
27533
  _readSubscription;
@@ -26684,14 +27536,16 @@ class QdTableSortRouterConnectorService {
26684
27536
  _activatedRouteChecked$ = this._activatedRouteCheckedSubject.asObservable();
26685
27537
  _hasInitialUrlBeenSet = false;
26686
27538
  _hasWarnedMultiSegment = false;
27539
+ _sort;
26687
27540
  constructor() {
26688
27541
  this._destroyRef.onDestroy(() => this.tearDownConnection());
26689
27542
  }
26690
27543
  connectSortWithRouter(table, tableStoreService) {
26691
27544
  if (!this.shouldConnect(table) || !this._hub.isAvailable())
26692
27545
  return of(false);
26693
- if (!this._hub.claim(OWNED_PARAMS$1, this, this._destroyRef, FEATURE_LABEL$1))
27546
+ if (!this._namespaceService.reserve(table.config))
26694
27547
  return of(false);
27548
+ this._sort = this._namespaceService.bindingFor(SORT_PARAM_NAME);
26695
27549
  this._connection = {
26696
27550
  table: table,
26697
27551
  tableStoreService: tableStoreService,
@@ -26716,7 +27570,7 @@ class QdTableSortRouterConnectorService {
26716
27570
  const { tableStoreService } = this._connection;
26717
27571
  let isFirstEmit = true;
26718
27572
  this._readSubscription = this._hub.navigationSettled$
26719
- .pipe(switchMap(() => this._hub.queryParams()), map(queryParams => (typeof queryParams[SORT_PARAM_NAME] === 'string' ? queryParams[SORT_PARAM_NAME] : '')), distinctUntilChanged(), map(raw => this.parseRawSortValue(raw)), withLatestFrom(tableStoreService.tableSort$()))
27573
+ .pipe(switchMap(() => this._hub.queryParams()), map(queryParams => this._sort.read(key => queryParams[key]) ?? ''), distinctUntilChanged(), map(raw => this.parseRawSortValue(raw)), withLatestFrom(tableStoreService.tableSort$()))
26720
27574
  .subscribe(([segments, currentSort]) => {
26721
27575
  if (segments.length === 1) {
26722
27576
  const [{ column, direction }] = segments;
@@ -26746,9 +27600,9 @@ class QdTableSortRouterConnectorService {
26746
27600
  writeUrl(serialized) {
26747
27601
  const replaceUrl = !this._hasInitialUrlBeenSet;
26748
27602
  this._hasInitialUrlBeenSet = true;
26749
- if (this._hub.snapshotQueryParam(SORT_PARAM_NAME) === serialized)
27603
+ if (this._hub.snapshotQueryParam(this._sort.key) === serialized)
26750
27604
  return;
26751
- this._hub.write({ [SORT_PARAM_NAME]: serialized }, { replaceUrl });
27605
+ this._hub.write({ [this._sort.key]: serialized }, { replaceUrl });
26752
27606
  }
26753
27607
  shouldConnect(table) {
26754
27608
  const sortConfig = table.config.sort;
@@ -27414,6 +28268,12 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
27414
28268
  * ]
27415
28269
  * };
27416
28270
  * ```
28271
+ *
28272
+ * @parent qd-section {supported}
28273
+ * description: A table is the content of a section. The section frame carries its title, search and filter.
28274
+ *
28275
+ * @parent qd-panel-section {supported}
28276
+ * description: For a compact table inside a control panel, where the panel section names it in a slot.
27417
28277
  */
27418
28278
  class QdTableComponent {
27419
28279
  element = inject(ElementRef);
@@ -27740,6 +28600,7 @@ class QdTableComponent {
27740
28600
  QdTableScrollAnchorService,
27741
28601
  QdTableResolverService,
27742
28602
  QdTableExternalActionResultService,
28603
+ QdTableUrlNamespaceService,
27743
28604
  QdTableSortRouterConnectorService
27744
28605
  ], viewQueries: [{ propertyName: "paginator", first: true, predicate: QdTablePaginatorComponent, descendants: true }], usesOnChanges: true, ngImport: i0, template: "<table [class]=\"'qd-table__table'\" [attr.data-test-id]=\"testId + '-element'\">\n <tr qd-table-head [config]=\"config\" [data-test-id]=\"testId\"></tr>\n <tbody qd-table-body [config]=\"config\" [data]=\"(data$ | async) ?? []\" [data-test-id]=\"testId\"></tbody>\n</table>\n\n@if (hasPagination) {\n<qd-table-paginator [config]=\"config\" [data-test-id]=\"testId\"></qd-table-paginator>\n} @if (hasEmptyStateView$ | async) {\n<qd-table-empty-state [config]=\"config.emptyStateView\"></qd-table-empty-state>\n}\n", styles: [":host{display:inline-flex;flex-direction:column}:host .qd-table__table{background:#fff;border-spacing:0;color:#171717;font-size:.875rem;font-weight:400;line-height:2.5rem}:host .qd-table__head,:host .qd-table__body{vertical-align:center}:host .qd-table__head{background:#e5e5e5;text-align:left}:host .qd-table__head ::ng-deep .qd-table__head-cell{font-weight:600}:host .qd-table__body{color:#171717}:host ::ng-deep .qd-table__head-cell,:host ::ng-deep .qd-table__body-cell{padding:.125rem 1rem 0;vertical-align:top}:host ::ng-deep .qd-table__head-cell--selection,:host ::ng-deep .qd-table__body-cell--selection{width:1.875rem;padding-top:.1875rem;text-align:center}:host ::ng-deep .qd-table__head-cell--actions-inline-menu,:host ::ng-deep .qd-table__body-cell--actions-inline-menu{padding-top:.125rem;vertical-align:top}:host.main-column-fills-width.table-has-remaining-width:not(.table-has-right-aligned-filling-column) ::ng-deep th.main-column,:host.main-column-fills-width.table-has-remaining-width:not(.table-has-right-aligned-filling-column) ::ng-deep td.main-column{width:100%}:host.main-column-fills-width.table-has-remaining-width ::ng-deep th:not(.main-column),:host.main-column-fills-width.table-has-remaining-width ::ng-deep td:not(.main-column){white-space:nowrap}:host.last-column-fills-width.table-has-remaining-width:not(.table-has-right-aligned-filling-column) ::ng-deep th.last-column,:host.last-column-fills-width.table-has-remaining-width:not(.table-has-right-aligned-filling-column) ::ng-deep td.last-column{width:100%}:host.last-column-fills-width.table-has-remaining-width ::ng-deep th:not(.last-column),:host.last-column-fills-width.table-has-remaining-width ::ng-deep td:not(.last-column){white-space:nowrap}:host.harmonized{width:100%}\n"], dependencies: [{ kind: "component", type: QdTableBodyComponent, selector: "[qd-table-body]", inputs: ["config", "data", "data-test-id"] }, { kind: "component", type: QdTableEmptyStateComponent, selector: "qd-table-empty-state", inputs: ["config"] }, { kind: "component", type: QdTableHeadComponent, selector: "[qd-table-head]", inputs: ["config", "data-test-id"] }, { kind: "component", type: QdTablePaginatorComponent, selector: "qd-table-paginator", inputs: ["config", "data-test-id"] }, { kind: "pipe", type: i1$1.AsyncPipe, name: "async" }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
27745
28606
  }
@@ -27756,6 +28617,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
27756
28617
  QdTableScrollAnchorService,
27757
28618
  QdTableResolverService,
27758
28619
  QdTableExternalActionResultService,
28620
+ QdTableUrlNamespaceService,
27759
28621
  QdTableSortRouterConnectorService
27760
28622
  ], changeDetection: ChangeDetectionStrategy.OnPush, host: {
27761
28623
  '[class.qd-table]': 'true',
@@ -27892,6 +28754,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
27892
28754
  * }
27893
28755
  * }
27894
28756
  * ```
28757
+ *
28758
+ * @parent qd-section {supported}
28759
+ * description: Put it on the table inside the section that owns the context, so both read the same state.
27895
28760
  */
27896
28761
  class QdConnectorTableContextDirective {
27897
28762
  tableComponent = inject(QdTableComponent, { host: true });
@@ -27967,6 +28832,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
27967
28832
  * doSomethingFancyWith(filter, …)
27968
28833
  * }
27969
28834
  * ```
28835
+ *
28836
+ * @parent qd-section {supported}
28837
+ * description: Put it on the table inside the section that carries the filter. Both have to share a
28838
+ * section.
27970
28839
  */
27971
28840
  class QdConnectorTableFilterDirective {
27972
28841
  tableComponent = inject(QdTableComponent, { host: true });
@@ -28053,6 +28922,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
28053
28922
  * doSomethingFancyWith(search, …)
28054
28923
  * }
28055
28924
  * ```
28925
+ *
28926
+ * @parent qd-section {supported}
28927
+ * description: Put it on the table inside the section whose toolbar carries the search field.
28056
28928
  */
28057
28929
  class QdConnectorTableSearchDirective {
28058
28930
  tableComponent = inject(QdTableComponent, { host: true });
@@ -28142,6 +29014,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
28142
29014
  * <!-- Section content -->
28143
29015
  * </qd-section>
28144
29016
  * ```
29017
+ *
29018
+ * @parent qd-page {supported}
29019
+ * description: Put the marker on your own component inside a page, so it takes the place of a qd-section.
28145
29020
  */
28146
29021
  class QdSectionAdapterDirective {
28147
29022
  elementRef = inject(ElementRef);
@@ -28416,6 +29291,25 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
28416
29291
  * };
28417
29292
  * }
28418
29293
  * ```
29294
+ *
29295
+ * @slot default {quadrel}
29296
+ * description: Holds the content of the section, one kind per section: a qd-table, a qd-grid with form
29297
+ * fields, or another Quadrel component.
29298
+ * enforcedBy: none
29299
+ *
29300
+ * @parent qd-page {supported}
29301
+ * description: The standard place for a section on an overview or inspect page.
29302
+ *
29303
+ * @parent qd-page-tab {supported}
29304
+ * description: One section per tab. The tab projects with a bare ng-content, so nothing enforces it.
29305
+ *
29306
+ * @parent qd-page-step {supported}
29307
+ * description: One section per step, the same shape as a tab.
29308
+ *
29309
+ * @parent qd-page-control-panel {unsupported}
29310
+ * description: The panel projects it, but a section brings the frame of the page body, not the spacing of a
29311
+ * panel.
29312
+ * instead: qd-panel-section is the section built for the control panel and carries its spacing.
28419
29313
  */
28420
29314
  class QdSectionComponent {
28421
29315
  searchService = inject(QdSearchService);
@@ -28511,11 +29405,11 @@ class QdSectionComponent {
28511
29405
  this._outputSubscriptions = [];
28512
29406
  }
28513
29407
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: QdSectionComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
28514
- static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.17", type: QdSectionComponent, isStandalone: false, selector: "qd-section", inputs: { config: "config" }, outputs: { searchQueryStringOutput: "searchQueryStringOutput", searchPostBodyOutput: "searchPostBodyOutput", actionOutput: "actionOutput", filterQueryStringOutput: "filterQueryStringOutput", filterPostBodyOutput: "filterPostBodyOutput", filterValueChangeOutput: "filterValueChangeOutput" }, host: { properties: { "class.no-horizontal-padding-mobile": "noHorizontalPaddingMobile" }, classAttribute: "qd-section" }, providers: [QdSectionToolbarActionService, QdSearchService, QdToolbarComponentsService], usesOnChanges: true, ngImport: i0, template: "<section>\n <qd-section-toolbar [className]=\"'qd-section__toolbar'\" [config]=\"config\"></qd-section-toolbar>\n\n @if (!config.collapse?.isContentHidden) {\n <div class=\"qd-section__content\"><ng-content></ng-content></div>\n }\n</section>\n", styles: ["qd-section{display:block;padding:1rem 1.25rem;background-color:#efefef}@media(max-width:599.98px){qd-section.no-horizontal-padding-mobile{padding:.9375rem 0 3.125rem}qd-section.no-horizontal-padding-mobile qd-section-toolbar{margin:0 .9375rem .3125rem}}.qd-section{display:block}.qd-section:has(+.qd-section){border-bottom:rgb(213,213,213) solid .0625rem}@media(max-width:959.98px){.qd-section{padding:.75rem}}\n"], dependencies: [{ kind: "component", type: QdSectionToolbarComponent, selector: "qd-section-toolbar", inputs: ["config"] }], encapsulation: i0.ViewEncapsulation.None });
29408
+ static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.17", type: QdSectionComponent, isStandalone: false, selector: "qd-section", inputs: { config: "config" }, outputs: { searchQueryStringOutput: "searchQueryStringOutput", searchPostBodyOutput: "searchPostBodyOutput", actionOutput: "actionOutput", filterQueryStringOutput: "filterQueryStringOutput", filterPostBodyOutput: "filterPostBodyOutput", filterValueChangeOutput: "filterValueChangeOutput" }, host: { properties: { "class.no-horizontal-padding-mobile": "noHorizontalPaddingMobile" }, classAttribute: "qd-section" }, providers: [QdSectionToolbarActionService, QdSearchService, QdToolbarComponentsService, QdSectionUrlNamespaceService], usesOnChanges: true, ngImport: i0, template: "<section>\n <qd-section-toolbar [className]=\"'qd-section__toolbar'\" [config]=\"config\"></qd-section-toolbar>\n\n @if (!config.collapse?.isContentHidden) {\n <div class=\"qd-section__content\"><ng-content></ng-content></div>\n }\n</section>\n", styles: ["qd-section{display:block;padding:1rem 1.25rem;background-color:#efefef}@media(max-width:599.98px){qd-section.no-horizontal-padding-mobile{padding:.9375rem 0 3.125rem}qd-section.no-horizontal-padding-mobile qd-section-toolbar{margin:0 .9375rem .3125rem}}.qd-section{display:block}.qd-section:has(+.qd-section){border-bottom:rgb(213,213,213) solid .0625rem}@media(max-width:959.98px){.qd-section{padding:.75rem}}\n"], dependencies: [{ kind: "component", type: QdSectionToolbarComponent, selector: "qd-section-toolbar", inputs: ["config"] }], encapsulation: i0.ViewEncapsulation.None });
28515
29409
  }
28516
29410
  i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: QdSectionComponent, decorators: [{
28517
29411
  type: Component,
28518
- args: [{ selector: 'qd-section', providers: [QdSectionToolbarActionService, QdSearchService, QdToolbarComponentsService], host: {
29412
+ args: [{ selector: 'qd-section', providers: [QdSectionToolbarActionService, QdSearchService, QdToolbarComponentsService, QdSectionUrlNamespaceService], host: {
28519
29413
  class: 'qd-section',
28520
29414
  '[class.no-horizontal-padding-mobile]': 'noHorizontalPaddingMobile'
28521
29415
  }, encapsulation: ViewEncapsulation.None, standalone: false, template: "<section>\n <qd-section-toolbar [className]=\"'qd-section__toolbar'\" [config]=\"config\"></qd-section-toolbar>\n\n @if (!config.collapse?.isContentHidden) {\n <div class=\"qd-section__content\"><ng-content></ng-content></div>\n }\n</section>\n", styles: ["qd-section{display:block;padding:1rem 1.25rem;background-color:#efefef}@media(max-width:599.98px){qd-section.no-horizontal-padding-mobile{padding:.9375rem 0 3.125rem}qd-section.no-horizontal-padding-mobile qd-section-toolbar{margin:0 .9375rem .3125rem}}.qd-section{display:block}.qd-section:has(+.qd-section){border-bottom:rgb(213,213,213) solid .0625rem}@media(max-width:959.98px){.qd-section{padding:.75rem}}\n"] }]
@@ -29483,6 +30377,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
29483
30377
 
29484
30378
  /**
29485
30379
  * The **QdTree** allows to visualize hierarchical data.
30380
+ *
30381
+ * @parent qd-section {supported}
30382
+ * description: A tree is the content of a section, the same way a table is.
29486
30383
  */
29487
30384
  class QdTreeComponent {
29488
30385
  element = inject(ElementRef);
@@ -29860,6 +30757,21 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
29860
30757
  * </qd-page-control-panel>
29861
30758
  * </qd-page>
29862
30759
  * ```
30760
+ *
30761
+ * @slot qd-text-section {quadrel}
30762
+ * description: Takes a qd-text-section, written directly into the panel.
30763
+ * enforcedBy: ng-content-select
30764
+ *
30765
+ * @slot qd-panel-section {quadrel}
30766
+ * description: Takes a qd-panel-section, the place for the content of the panel.
30767
+ * enforcedBy: ng-content-select
30768
+ *
30769
+ * @slot qd-section {quadrel}
30770
+ * description: Takes a qd-section, written directly into the panel.
30771
+ * enforcedBy: ng-content-select
30772
+ *
30773
+ * @parent qd-page {supported}
30774
+ * description: The only place for a control panel.
29863
30775
  */
29864
30776
  class QdPageControlPanelComponent {
29865
30777
  config;
@@ -29955,6 +30867,12 @@ var QdFooterActionType;
29955
30867
  /**
29956
30868
  * **QdPageFooter** provides an empty container inside the **QdPage**. <br />
29957
30869
  * Note: This component is still in WIP status!
30870
+ *
30871
+ * @slot default {text}
30872
+ * visibility: internal
30873
+ * description: Carries the content that qd-page re-projects from its [qdPageFooter] slot, in front of the
30874
+ * configured action buttons.
30875
+ * enforcedBy: none
29958
30876
  */
29959
30877
  class QdPageFooterComponent {
29960
30878
  footerService = inject(QdPageFooterService);
@@ -30049,6 +30967,19 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
30049
30967
  * ...
30050
30968
  * </qd-dialog>
30051
30969
  * ```
30970
+ *
30971
+ * @parent qd-page {supported}
30972
+ * description: Shows a message that applies to the whole page, above the body.
30973
+ *
30974
+ * @parent qd-page-tab {supported}
30975
+ * description: Shows a message that only applies to this tab. A page level banner stays visible next to it.
30976
+ *
30977
+ * @parent qd-page-step {supported}
30978
+ * description: Shows a message that only applies to this step, the same shape as in a tab.
30979
+ *
30980
+ * @parent qd-dialog {supported}
30981
+ * description: Shows a message that applies to the whole dialog, between its title and its body. The dialog
30982
+ * names the banner in a slot of its own.
30052
30983
  */
30053
30984
  class QdPageInfoBannerComponent {
30054
30985
  /**
@@ -30521,6 +31452,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
30521
31452
  * </div>
30522
31453
  * </qd-page>
30523
31454
  * ```
31455
+ *
31456
+ * @parent qd-page {supported}
31457
+ * description: Put the marker on your own element inside qd-page. The page moves it into the object header,
31458
+ * next to the page actions.
30524
31459
  */
30525
31460
  class QdPageHeaderExtensionDirective {
30526
31461
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: QdPageHeaderExtensionDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive });
@@ -31530,6 +32465,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
31530
32465
  * </qd-page-step>
31531
32466
  * </qd-page-stepper>
31532
32467
  * ```
32468
+ *
32469
+ * @parent qd-page {supported}
32470
+ * description: Put the marker on your own component inside a page, so it takes the place of a
32471
+ * qd-page-stepper.
31533
32472
  */
31534
32473
  class QdPageStepperAdapterDirective {
31535
32474
  elementRef = inject(ElementRef);
@@ -31656,6 +32595,13 @@ const QD_PAGE_STEP_RESOLVER_TOKEN = new InjectionToken('QD_PAGE_STEP_RESOLVER_TO
31656
32595
  // @ts-strict-ignore
31657
32596
  /**
31658
32597
  * The **QdPageStepper** allows linear navigation through process steps within a **QdPage**.
32598
+ *
32599
+ * @slot qd-page-step {quadrel}
32600
+ * description: Holds the steps of the process. The app writes one qd-page-step per step.
32601
+ * enforcedBy: content-children
32602
+ *
32603
+ * @parent qd-page {supported}
32604
+ * description: The page renders the stepper for the create and custom page types, above the page body.
31659
32605
  */
31660
32606
  class QdPageStepperComponent extends CdkStepper {
31661
32607
  footerService = inject(QdPageFooterService, { optional: true });
@@ -31955,6 +32901,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
31955
32901
  * </qd-page-tab>
31956
32902
  * </qd-page-tabs>
31957
32903
  * ```
32904
+ *
32905
+ * @parent qd-page {supported}
32906
+ * description: Put the marker on your own component inside a page, so it takes the place of a qd-page-tabs.
31958
32907
  */
31959
32908
  class QdPageTabsAdapterDirective {
31960
32909
  elementRef = inject(ElementRef);
@@ -32064,6 +33013,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
32064
33013
  // @ts-strict-ignore
32065
33014
  /**
32066
33015
  * The **QdPageTab** is a single tab inside the **QdPageTabs** within a **QdPage**.
33016
+ *
33017
+ * @slot qd-page-info-banner {quadrel}
33018
+ * description: Shows messages that belong to this tab, in a banner strip above the tab content.
33019
+ * enforcedBy: ng-content-select
33020
+ *
33021
+ * @slot default {quadrel}
33022
+ * description: Carries the content of the tab, usually one qd-section. Rendered only while this tab is
33023
+ * selected.
33024
+ * enforcedBy: none
33025
+ *
33026
+ * @parent qd-page-tabs {supported}
33027
+ * description: The only place for a tab. The tabs component collects them and renders the selected one.
32067
33028
  */
32068
33029
  class QdPageTabComponent {
32069
33030
  _pageTabs = inject(forwardRef(() => QdPageTabsComponent));
@@ -32161,14 +33122,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
32161
33122
 
32162
33123
  const TAB_PARAM_NAME = 'tab';
32163
33124
  const OWNED_PARAMS = [TAB_PARAM_NAME];
32164
- const FEATURE_LABEL = { name: 'Page Tabs', plural: 'page tabs' };
33125
+ const FEATURE_LABEL$1 = { name: 'Page Tabs', plural: 'page tabs', isViewState: true };
32165
33126
  /**
32166
33127
  * Per-view adapter that syncs `QdPageTabsComponent` selection with the URL `?tab=` query
32167
33128
  * param via `QdRouterQueryParamHubService`. Reads on activation and selects the matching
32168
33129
  * tab (with fallback for unknown/disabled names), writes on `tabSelection`. Coordination,
32169
33130
  * ownership, and write batching are delegated to the hub — see its JSDoc for details.
32170
33131
  * Behavior contracts live in `page-tabs-router-connector.service.spec.ts` and
32171
- * `router-query-param-hub.integration.cy.ts`.
33132
+ * `router-query-param-hub.service.cy.ts`.
32172
33133
  *
32173
33134
  * Note: this is the only connector that writes synchronously without gating on
32174
33135
  * `navigationSettled$`. Required for the deep-link case where `ngAfterViewInit` fires
@@ -32192,7 +33153,7 @@ class QdPageTabsRouterConnectorService {
32192
33153
  return of(false);
32193
33154
  if (this._connectedComponent === component)
32194
33155
  return this._activatedRouteChecked$;
32195
- if (!this._hub.claim(OWNED_PARAMS, this, this._destroyRef, FEATURE_LABEL))
33156
+ if (!this._hub.claim(OWNED_PARAMS, this, this._destroyRef, FEATURE_LABEL$1))
32196
33157
  return of(false);
32197
33158
  this._connectedComponent = component;
32198
33159
  this._hasInitialUrlBeenSet = false;
@@ -32458,6 +33419,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
32458
33419
  * - Browser back/forward buttons work with tab navigation
32459
33420
  * - If an invalid tab name is provided in URL, the first available tab is selected
32460
33421
  * - If no tab parameter is present, the `selectedIndex` or first non-disabled tab is selected
33422
+ *
33423
+ * @slot qd-page-tab {quadrel}
33424
+ * description: Holds the tabs of this page. The app writes one qd-page-tab per tab.
33425
+ * enforcedBy: content-children
33426
+ *
33427
+ * @parent qd-page {supported}
33428
+ * description: The page renders the tabs for the overview, inspect and custom page types, above the body.
32461
33429
  */
32462
33430
  class QdPageTabsComponent {
32463
33431
  footerService = inject(QdPageFooterService, { optional: true });
@@ -33111,6 +34079,54 @@ const SAFE_BOTTOM_OFFSET_PX = 64;
33111
34079
  * <!-- Place content here that doesn’t fit the other page types -->
33112
34080
  * </qd-page>
33113
34081
  * ```
34082
+ *
34083
+ * @slot [qdPageHeaderExtension] {custom-markup}
34084
+ * description: Puts an app owned control into the object header, next to the page actions.
34085
+ * enforcedBy: ng-content-select
34086
+ *
34087
+ * @slot qd-page-info-banner {quadrel}
34088
+ * description: Shows page wide messages in a banner strip under the object header.
34089
+ * enforcedBy: ng-content-select
34090
+ *
34091
+ * @slot qd-page-stepper {quadrel}
34092
+ * description: Holds the step navigation and the step content of the page.
34093
+ * enforcedBy: ng-content-select
34094
+ *
34095
+ * @slot [qdPageStepperAdapter] {custom-component}
34096
+ * description: Takes an app component that wraps its own qd-page-stepper.
34097
+ * enforcedBy: adapter-validation
34098
+ *
34099
+ * @slot qd-page-tabs {quadrel}
34100
+ * description: Holds the tab navigation and the tab content of the page.
34101
+ * enforcedBy: ng-content-select
34102
+ *
34103
+ * @slot [qdPageTabsAdapter] {custom-component}
34104
+ * description: Takes an app component that wraps its own qd-page-tabs.
34105
+ * enforcedBy: adapter-validation
34106
+ *
34107
+ * @slot qd-section {quadrel}
34108
+ * description: Carries the body of the page as one or more sections.
34109
+ * enforcedBy: ng-content-select
34110
+ *
34111
+ * @slot [qdSectionAdapter] {custom-component}
34112
+ * description: Takes an app component that wraps its own qd-section.
34113
+ * enforcedBy: adapter-validation
34114
+ *
34115
+ * @slot [qdPageFooter] {custom-markup}
34116
+ * description: Puts app owned content into the page footer, outside the scrollable main area, in front of
34117
+ * the configured buttons.
34118
+ * enforcedBy: ng-content-select
34119
+ *
34120
+ * @slot qd-page-control-panel {quadrel}
34121
+ * description: Holds the side panel with extra information about the shown object.
34122
+ * enforcedBy: ng-content-select
34123
+ *
34124
+ * @slot default {custom-markup}
34125
+ * description: Carries free page content when config.pageType is 'custom'.
34126
+ * enforcedBy: projection-guard
34127
+ *
34128
+ * @parent qd-shell {supported}
34129
+ * description: A page is what the shell routes to. The shell renders it in its router outlet.
33114
34130
  */
33115
34131
  class QdPageComponent {
33116
34132
  pageStoreService = inject(QdPageStoreService);
@@ -33665,6 +34681,17 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
33665
34681
  type: Injectable
33666
34682
  }] });
33667
34683
 
34684
+ /**
34685
+ * The **QdPanelSectionTextParagraph** component shows a text paragraph with an optional title
34686
+ * inside a **QdPanelSection**.
34687
+ *
34688
+ * @slot default {text}
34689
+ * description: Carries the text of the paragraph.
34690
+ * enforcedBy: none
34691
+ *
34692
+ * @parent qd-panel-section {supported}
34693
+ * description: The text body of a panel section, rendered as the last part of its body.
34694
+ */
33668
34695
  class QdPanelSectionTextParagraphComponent {
33669
34696
  /**
33670
34697
  * The configuration of the panel section text paragraph.
@@ -33780,6 +34807,25 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
33780
34807
  * My Panel Section Text
33781
34808
  * </qd-panel-section-text-paragraph>
33782
34809
  * </qd-text-section>
34810
+ *
34811
+ * @slot qd-panel-section-status {quadrel}
34812
+ * description: Shows a status line with a title at the top of the panel body.
34813
+ * enforcedBy: ng-content-select
34814
+ *
34815
+ * @slot qd-status-pairs {quadrel}
34816
+ * description: Shows caption and value pairs inside the panel.
34817
+ * enforcedBy: ng-content-select
34818
+ *
34819
+ * @slot qd-table {quadrel}
34820
+ * description: Shows tabular data inside the panel.
34821
+ * enforcedBy: ng-content-select
34822
+ *
34823
+ * @slot qd-panel-section-text-paragraph {quadrel}
34824
+ * description: Shows one or more text paragraphs, each with an optional title.
34825
+ * enforcedBy: ng-content-select
34826
+ *
34827
+ * @parent qd-page-control-panel {supported}
34828
+ * description: The section built for the control panel. It carries the spacing the panel expects.
33783
34829
  */
33784
34830
  class QdPanelSectionComponent {
33785
34831
  actionService = inject(QdPanelSectionActionService);
@@ -33991,14 +35037,19 @@ const loadJavascriptAsset = (path, scriptElementAttributes = {}) => {
33991
35037
  };
33992
35038
 
33993
35039
  // @ts-strict-ignore
35040
+ const LANG_PARAM_NAME = 'lang';
35041
+ const FEATURE_LABEL = { name: 'Shell', plural: 'shells', isViewState: false };
33994
35042
  class QdLanguageFromUrlService {
33995
35043
  router = inject(Router, { optional: true });
33996
35044
  activatedRoute = inject(ActivatedRoute, { optional: true });
35045
+ _hub = inject(QdRouterQueryParamHubService);
33997
35046
  _navigationPending$;
33998
35047
  _navigationEnded$;
35048
+ _ownsLangParam = false;
33999
35049
  constructor() {
34000
35050
  if (!this.router || !this.activatedRoute)
34001
35051
  return;
35052
+ this._ownsLangParam = this._hub.isAvailable() && this._hub.claim([LANG_PARAM_NAME], this, undefined, FEATURE_LABEL);
34002
35053
  const navigationPendingSubject = new ReplaySubject(1);
34003
35054
  this._navigationPending$ = navigationPendingSubject.asObservable();
34004
35055
  this._navigationEnded$ = this._navigationPending$.pipe(filter(navigationPending => !navigationPending));
@@ -34021,14 +35072,14 @@ class QdLanguageFromUrlService {
34021
35072
  return this._navigationEnded$.pipe(switchMap(() => this.activatedRoute.queryParams), filter(queryParams => queryParams.hasOwnProperty('lang')), map(queryParams => queryParams['lang']));
34022
35073
  }
34023
35074
  removeLangParameterFromUrlAfterNavigation() {
35075
+ if (!this.router || !this.activatedRoute)
35076
+ return;
34024
35077
  this._navigationPending$
34025
35078
  .pipe(debounceTime(300), filter(navigationPending => !navigationPending), switchMap(() => this.activatedRoute.queryParams), take(1))
34026
35079
  .subscribe(queryParams => {
34027
- if (!queryParams['lang'])
35080
+ if (!queryParams[LANG_PARAM_NAME] || !this._ownsLangParam)
34028
35081
  return;
34029
- const newQueryParams = { ...queryParams };
34030
- delete newQueryParams['lang'];
34031
- this.router.navigate([], { relativeTo: this.activatedRoute, queryParams: newQueryParams, replaceUrl: true });
35082
+ this._hub.write({ [LANG_PARAM_NAME]: undefined }, { replaceUrl: true });
34032
35083
  });
34033
35084
  }
34034
35085
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: QdLanguageFromUrlService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
@@ -34561,6 +35612,27 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
34561
35612
  type: Injectable
34562
35613
  }] });
34563
35614
 
35615
+ const MARKER = '__qdBackToOverview';
35616
+ /**
35617
+ * Marks a shell back link so the overview comes back the way the user left it — same filter, sort
35618
+ * and page.
35619
+ *
35620
+ * Put it in the route data of the detail page. Route params such as `:orderId` are substituted as
35621
+ * usual. Nothing is restored after a reload, because the memory lives in the browser tab only.
35622
+ *
35623
+ * @example data: { previousHref: qdBackToOverview('/orders') }
35624
+ */
35625
+ function qdBackToOverview(path) {
35626
+ const href = () => path;
35627
+ return Object.defineProperty(href, MARKER, { value: true });
35628
+ }
35629
+ /**
35630
+ * Tells whether a resolved back link asked for its params to be restored.
35631
+ */
35632
+ function qdRestoresOverviewAddress(previousHref) {
35633
+ return typeof previousHref === 'function' && previousHref[MARKER] === true;
35634
+ }
35635
+
34564
35636
  // @ts-strict-ignore
34565
35637
  class QdShellToolbarItemComponent {
34566
35638
  /**
@@ -34650,6 +35722,8 @@ class QdShellHeaderComponent {
34650
35722
  isCommentsDisplayed = false;
34651
35723
  isServiceNavigationOpened = true;
34652
35724
  _previousHref;
35725
+ _hub = inject(QdRouterQueryParamHubService);
35726
+ _restoresAddress = false;
34653
35727
  _routeParams;
34654
35728
  _routeParamsSubscription;
34655
35729
  _breakpointSubscription;
@@ -34658,6 +35732,7 @@ class QdShellHeaderComponent {
34658
35732
  const shellLeftService = this.shellLeftService;
34659
35733
  const shellRightService = this.shellRightService;
34660
35734
  this.backLinkDisplayed$ = navigationService.getPreviousHref$().pipe(withLatestFrom$1(navigationService.getRouteComponentInstance$()), switchMap(([previousHref, routeComponentInstance]) => {
35735
+ this._restoresAddress = qdRestoresOverviewAddress(previousHref);
34661
35736
  if (typeof previousHref === 'function')
34662
35737
  previousHref = previousHref(routeComponentInstance);
34663
35738
  return isObservable(previousHref) ? previousHref.pipe(take(1)) : of(previousHref);
@@ -34679,7 +35754,12 @@ class QdShellHeaderComponent {
34679
35754
  handleBackClick() {
34680
35755
  if (this._previousHref == null)
34681
35756
  return;
34682
- this.navigationService.navigateByUrl(this.insertRouteParams(this._previousHref));
35757
+ const url = this.insertRouteParams(this._previousHref);
35758
+ if (!this._restoresAddress) {
35759
+ this.navigationService.navigateByUrl(url);
35760
+ return;
35761
+ }
35762
+ this._hub.navigateToUrl(this._hub.restoreAddress(url));
34683
35763
  }
34684
35764
  insertRouteParams(url) {
34685
35765
  const routeParams = this._routeParams;
@@ -35104,6 +36184,11 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
35104
36184
  type: Input
35105
36185
  }] } });
35106
36186
 
36187
+ /**
36188
+ * Shows a list of comments and lets the user add one through a dialog.
36189
+ *
36190
+ * The text of a comment is rendered as HTML. See `QdComment.comment`.
36191
+ */
35107
36192
  class QdCommentsComponent {
35108
36193
  translateService = inject(TranslateService);
35109
36194
  dialogService = inject(QdDialogService);
@@ -35185,7 +36270,8 @@ const DEFAULT_SHELL_CONFIG = {
35185
36270
  * path: '',
35186
36271
  * component: AppHomeComponent,
35187
36272
  * data: {
35188
- * isHome: true
36273
+ * isHome: true,
36274
+ * previousHref: qdBackToOverview('/orders') // shell back button restores filter, sort and page like browser back
35189
36275
  * }
35190
36276
  * }```
35191
36277
  *
@@ -35199,6 +36285,18 @@ const DEFAULT_SHELL_CONFIG = {
35199
36285
  * isInternal: true
35200
36286
  * ...
35201
36287
  * }
36288
+ *
36289
+ * @slot primary {custom-markup}
36290
+ * description: Renders the component of the active route, usually a page built with qd-page. This is an
36291
+ * exit point: whatever the route renders ends up here, and nothing checks it.
36292
+ * enforcedBy: router-config
36293
+ *
36294
+ * @slot qd-comments {quadrel}
36295
+ * description: Takes the comments panel of the app, which renders only while the header toggle shows
36296
+ * comments.
36297
+ * enforcedBy: ng-content-select
36298
+ * status: deprecated
36299
+ * instead: Put the comments into qd-page. The slot moves there in v22.
35202
36300
  */
35203
36301
  class QdShellComponent {
35204
36302
  searchService = inject(QdSearchService);
@@ -35427,6 +36525,19 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
35427
36525
  }]
35428
36526
  }] });
35429
36527
 
36528
+ /**
36529
+ * **QdTilesTitle** renders the headline above a group of tiles.
36530
+ *
36531
+ * The component answers to two selectors. `qd-tiles-container-title` is the
36532
+ * older one and is kept so existing apps keep working.
36533
+ *
36534
+ * @slot default {text}
36535
+ * description: Carries the headline text of the tile group.
36536
+ * enforcedBy: none
36537
+ *
36538
+ * @parent qd-tiles {supported}
36539
+ * description: The headline above a group of tiles. The container names it in a slot and renders it first.
36540
+ */
35430
36541
  class QdTilesTitleComponent {
35431
36542
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: QdTilesTitleComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
35432
36543
  static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "21.2.17", type: QdTilesTitleComponent, isStandalone: false, selector: "qd-tiles-title, qd-tiles-container-title", ngImport: i0, template: "<section class=\"qd-tiles-container-headline-wrapper\">\n <h2 class=\"qd-tiles-container-headline\"><ng-content></ng-content></h2>\n</section>\n" });
@@ -35436,6 +36547,16 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
35436
36547
  args: [{ selector: 'qd-tiles-title, qd-tiles-container-title', standalone: false, template: "<section class=\"qd-tiles-container-headline-wrapper\">\n <h2 class=\"qd-tiles-container-headline\"><ng-content></ng-content></h2>\n</section>\n" }]
35437
36548
  }] });
35438
36549
 
36550
+ /**
36551
+ * **QdTileButtonList** groups the actions of a tile and lays them out in a row.
36552
+ *
36553
+ * @slot default {quadrel}
36554
+ * description: Holds the actions of the tile: Quadrel buttons such as qdButton or qdIconButton.
36555
+ * enforcedBy: none
36556
+ *
36557
+ * @parent qd-tile {supported}
36558
+ * description: The actions of one tile. The tile names it in a slot and renders it as the last row.
36559
+ */
35439
36560
  class QdTileButtonListComponent {
35440
36561
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: QdTileButtonListComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
35441
36562
  static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "21.2.17", type: QdTileButtonListComponent, isStandalone: false, selector: "qd-tile-button-list", host: { classAttribute: "qd-tile-button-list" }, ngImport: i0, template: `<ng-content></ng-content>`, isInline: true });
@@ -35450,6 +36571,16 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
35450
36571
  }]
35451
36572
  }] });
35452
36573
 
36574
+ /**
36575
+ * **QdTileTextList** groups the text lines of a tile and spaces them evenly.
36576
+ *
36577
+ * @slot default {quadrel}
36578
+ * description: Holds the qd-tile-text-list-item elements of the tile.
36579
+ * enforcedBy: none
36580
+ *
36581
+ * @parent qd-tile {supported}
36582
+ * description: The text body of one tile, between the title and the buttons.
36583
+ */
35453
36584
  class QdTileTextListComponent {
35454
36585
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: QdTileTextListComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
35455
36586
  static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "21.2.17", type: QdTileTextListComponent, isStandalone: false, selector: "qd-tile-text-list", ngImport: i0, template: `<ng-content></ng-content>`, isInline: true, styles: [":host{display:flex;flex-direction:column;color:#757575;gap:.625rem}\n"] });
@@ -35459,6 +36590,16 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
35459
36590
  args: [{ selector: 'qd-tile-text-list', template: `<ng-content></ng-content>`, standalone: false, styles: [":host{display:flex;flex-direction:column;color:#757575;gap:.625rem}\n"] }]
35460
36591
  }] });
35461
36592
 
36593
+ /**
36594
+ * **QdTileTextListItem** renders one text line inside a tile text list.
36595
+ *
36596
+ * @slot default {text}
36597
+ * description: Carries the text of one line.
36598
+ * enforcedBy: none
36599
+ *
36600
+ * @parent qd-tile-text-list {supported}
36601
+ * description: One item per line. The list keeps the lines evenly spaced.
36602
+ */
35462
36603
  class QdTileTextListItemComponent {
35463
36604
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: QdTileTextListItemComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
35464
36605
  static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "21.2.17", type: QdTileTextListItemComponent, isStandalone: false, selector: "qd-tile-text-list-item", ngImport: i0, template: `<ng-content></ng-content>`, isInline: true, styles: [":host{font-size:.875rem;line-height:1.5}\n"] });
@@ -35468,6 +36609,16 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
35468
36609
  args: [{ selector: 'qd-tile-text-list-item', template: `<ng-content></ng-content>`, standalone: false, styles: [":host{font-size:.875rem;line-height:1.5}\n"] }]
35469
36610
  }] });
35470
36611
 
36612
+ /**
36613
+ * **QdTileTitle** renders the headline of one tile.
36614
+ *
36615
+ * @slot default {text}
36616
+ * description: Carries the headline text of the tile.
36617
+ * enforcedBy: none
36618
+ *
36619
+ * @parent qd-tile {supported}
36620
+ * description: The heading of one tile. The tile names it in a slot and renders it first.
36621
+ */
35471
36622
  class QdTileTitleComponent {
35472
36623
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: QdTileTitleComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
35473
36624
  static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "21.2.17", type: QdTileTitleComponent, isStandalone: false, selector: "qd-tile-title", ngImport: i0, template: "<h2 class=\"qd-tile-title\"><ng-content></ng-content></h2>\n", styles: ["qd-tile{position:relative;display:flex;min-width:15.625rem;flex-direction:column;padding:1rem;border:.0625rem solid rgb(213,213,213);margin-bottom:1.5rem;background:#fff;gap:.9375rem}qd-tile.row{flex-direction:row}qd-tile.row .illustration{height:6.25rem}qd-tile.row .illustration img{max-width:none;max-height:100%}qd-tile.disabled{cursor:not-allowed}qd-tile.disabled>*{opacity:.7}qd-tile:first-child{margin-left:0}qd-tile-buttons{margin-top:auto}qd-tile-buttons button{display:block}.qd-tile-button-list button:last-child{margin-bottom:.75rem}.illustration{width:6.25rem}.illustration img{max-width:100%}.content{display:flex;flex-direction:column;align-items:start;justify-content:start;gap:.5rem}.overlay{position:absolute;inset:0}.qd-tile-title{margin:.875rem 0 0;font-size:.875rem;font-weight:500}\n"] });
@@ -35485,6 +36636,21 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
35485
36636
  * - **Content**: Show title, texts and buttons in QdTile.
35486
36637
  * - **Disable**: Configure the QdTile to be disabled and do not allow interacting with it.
35487
36638
  * - **Illustration**: Add an illustration in the QdTile and make it appear in row or column with the content.
36639
+ *
36640
+ * @slot qd-tile-title {quadrel}
36641
+ * description: Names the tile, so the user knows what the tile is about.
36642
+ * enforcedBy: ng-content-select
36643
+ *
36644
+ * @slot qd-tile-text-list {quadrel}
36645
+ * description: Describes the tile in one or more lines of text.
36646
+ * enforcedBy: ng-content-select
36647
+ *
36648
+ * @slot qd-tile-button-list {quadrel}
36649
+ * description: Offers the actions of the tile.
36650
+ * enforcedBy: ng-content-select
36651
+ *
36652
+ * @parent qd-tiles {supported}
36653
+ * description: One tile per entry. The container arranges the tiles and keeps their spacing.
35488
36654
  */
35489
36655
  class QdTileComponent {
35490
36656
  config;
@@ -35518,6 +36684,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
35518
36684
 
35519
36685
  /**
35520
36686
  * The **QdTilesContainer** component creates a tile structure and allows you to position tiles in a row.
36687
+ *
36688
+ * @slot qd-tiles-title {quadrel}
36689
+ * description: Names the whole group of tiles.
36690
+ * enforcedBy: ng-content-select
36691
+ *
36692
+ * @slot qd-tiles-container-title {quadrel}
36693
+ * description: The same headline under the older selector of QdTilesTitle.
36694
+ * enforcedBy: ng-content-select
36695
+ *
36696
+ * @slot qd-tile {quadrel}
36697
+ * description: Holds the tiles of the group.
36698
+ * enforcedBy: ng-content-select
35521
36699
  */
35522
36700
  class QdTilesComponent {
35523
36701
  /**
@@ -35728,6 +36906,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
35728
36906
  // @ts-strict-ignore
35729
36907
  /**
35730
36908
  * The **QdPageStep** is a single step inside the **QdPageStepper** within a **QdPage**.
36909
+ *
36910
+ * @slot qd-page-info-banner {quadrel}
36911
+ * description: Shows messages that belong to this step, in a banner strip above the step content.
36912
+ * enforcedBy: ng-content-select
36913
+ *
36914
+ * @slot default {quadrel}
36915
+ * description: Carries the content of the step, usually one qd-section. Rendered only while this step is
36916
+ * selected.
36917
+ * enforcedBy: none
36918
+ *
36919
+ * @parent qd-page-stepper {supported}
36920
+ * description: The only place for a step. The stepper collects its steps and renders the selected one.
35731
36921
  */
35732
36922
  class QdPageStepComponent extends CdkStep {
35733
36923
  translate = inject(TranslateService);
@@ -36063,6 +37253,12 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
36063
37253
  * - In **template data mode**, validators defined in `config.columns` are applied.
36064
37254
  *
36065
37255
  * **Note: Do not combine both approaches. When using `formArrayName`, only the external FormGroup is used for validation and value access.**
37256
+ *
37257
+ * @parent qd-grid {supported}
37258
+ * description: An editable table sits in a grid cell, so it lines up with the fields around it.
37259
+ *
37260
+ * @parent qd-section {supported}
37261
+ * description: For a section whose whole content is the editable table.
36066
37262
  */
36067
37263
  class QdQuickEditComponent {
36068
37264
  fb = inject(FormBuilder);
@@ -36531,5 +37727,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
36531
37727
  * Generated bundle index. Do not edit.
36532
37728
  */
36533
37729
 
36534
- export { APP_ENVIRONMENT, BACKEND_ERROR_CODES, MockLocaleDatePipe, NavigationTileComponent, NavigationTilesComponent, QD_DIALOG_CONFIRMATION_RESOLVER_TOKEN, QD_FILE_MANAGER_TOKEN, QD_FILE_UPLOAD_MANAGER_TOKEN, QD_FORM_OPTIONS_RESOLVER, QD_PAGE_OBJECT_RESOLVER_TOKEN, QD_PAGE_STEP_RESOLVER_TOKEN, QD_POPOVER_TOP_FIRST, QD_SAFE_BOTTOM_OFFSET, QD_TABLE_DATA_RESOLVER_TOKEN, QD_UPLOAD_HTTP_OPTIONS, QdButtonComponent, QdButtonGhostDirective, QdButtonGridComponent, QdButtonLinkDirective, QdButtonModule, QdButtonStackButtonComponent, QdButtonStackComponent, QdCheckboxChipsComponent, QdCheckboxComponent, QdCheckboxesComponent, QdChipComponent, QdChipModule, QdColumnAutoFillDirective, QdColumnBreakBeforeDirective, QdColumnDirective, QdColumnDisableResponsiveColspansDirective, QdColumnFullGridWidthDirective, QdColumnNextInSameRowDirective, QdColumnsDirective, QdColumnsDisableAutoFillDirective, QdColumnsDisableResponsiveColspansDirective, QdColumnsMaxDirective, QdCommentsComponent, QdCommentsModule, QdConnectFormStateToPageDirective, QdConnectorTableContextDirective, QdConnectorTableFilterDirective, QdConnectorTableSearchDirective, QdContactCardComponent, QdContactCardModule, QdContainerPairsCaptionComponent, QdContainerPairsContainerComponent, QdContainerPairsHeaderComponent, QdContainerPairsItemComponent, QdContainerPairsValueComponent, QdContextService, QdCoreModule, QdDatepickerComponent, QdDialogActionComponent, QdDialogAuthSessionEndComponent, QdDialogAuthSessionEndService, QdDialogComponent, QdDialogConfirmationComponent, QdDialogConfirmationErrorDirective, QdDialogConfirmationInfoDirective, QdDialogConfirmationSuccessDirective, QdDialogModule, QdDialogRecordStepperComponent, QdDialogService, QdDialogSize, QdDisabledDirective, QdDropdownComponent, QdFileCollectorComponent, QdFileCollectorModule, QdFileSizePipe$1 as QdFileSizePipe, QdFileUploadComponent, QdFileUploadService, QdFilterComponent, QdFilterFormItemsComponent, QdFilterModule, QdFilterRestParamBuilder, QdFilterService, QdFooterActionType, QdFormArray, QdFormBuilder, QdFormControl, QdFormGroup, QdFormModule, QdFrameworkModule, QdGridComponent, QdGridModule, QdHorizontalPairsCaptionComponent, QdHorizontalPairsComponent, QdHorizontalPairsItemComponent, QdHorizontalPairsValueComponent, QdIconButtonComponent, QdIconComponent, QdIconModule, QdImageComponent, QdImageModule, QdIndeterminateProgressBarComponent, QdInputComponent, QdListModule, QdMenuButtonComponent, QdMockBreakpointService, QdMockButtonComponent, QdMockButtonGhostDirective, QdMockButtonGridComponent, QdMockButtonLinkDirective, QdMockButtonModule, QdMockButtonStackButtonComponent, QdMockButtonStackComponent, QdMockCalendarComponent, QdMockCheckboxChipsComponent, QdMockCheckboxComponent, QdMockCheckboxesComponent, QdMockChipComponent, QdMockChipModule, QdMockColumnDirective, QdMockColumnsDirective, QdMockContactCardComponent, QdMockContactCardModule, QdMockContainerPairsCaptionComponent, QdMockContainerPairsContainerComponent, QdMockContainerPairsHeaderComponent, QdMockContainerPairsItemComponent, QdMockContainerPairsValueComponent, QdMockCoreModule, QdMockCounterBadgeComponent, QdMockDatepickerComponent, QdMockDisabledDirective, QdMockDropdownComponent, QdMockFileCollectorComponent, QdMockFileCollectorModule, QdMockFilterCategoryBooleanComponent, QdMockFilterCategoryComponent, QdMockFilterCategoryDateComponent, QdMockFilterCategoryDateRangeComponent, QdMockFilterCategoryFreeTextComponent, QdMockFilterCategorySelectComponent, QdMockFilterComponent, QdMockFilterFormItemsComponent, QdMockFilterItemBooleanComponent, QdMockFilterItemDateComponent, QdMockFilterItemDateRangeComponent, QdMockFilterItemFreeTextComponent, QdMockFilterItemMultiSelectComponent, QdMockFilterItemSingleSelectComponent, QdMockFilterModule, QdMockFilterService, QdMockFormErrorComponent, QdMockFormGroupErrorComponent, QdMockFormHintComponent, QdMockFormLabelComponent, QdMockFormReadonlyComponent, QdMockFormViewonlyComponent, QdMockFormsModule, QdMockFrameworkModule, QdMockGridModule, QdMockIconButtonComponent, QdMockIconComponent, QdMockIconModule, QdMockImageComponent, QdMockImageModule, QdMockIndeterminateProgressBarComponent, QdMockInputComponent, QdMockListModule, QdMockNavigationTileComponent, QdMockNavigationTilesComponent, QdMockNavigationTilesModule, QdMockNotificationComponent, QdMockNotificationContentComponent, QdMockNotificationsComponent, QdMockNotificationsModule, QdMockNotificationsService, QdMockPageComponent, QdMockPageModule, QdMockPercentageProgressBarComponent, QdMockPinCodeComponent, QdMockPopoverOnClickDirective, QdMockProgressBarModule, QdMockRadioButtonsComponent, QdMockRwdDisabledDirective, QdMockSearchComponent, QdMockSearchModule, QdMockSectionComponent, QdMockSectionModule, QdMockShellComponent, QdMockShellFooterComponent, QdMockShellHeaderBannerComponent, QdMockShellHeaderComponent, QdMockShellHeaderSearchComponent, QdMockShellModule, QdMockShellToolbarComponent, QdMockShellToolbarItemComponent, QdMockStatusIndicatorCaptionComponent, QdMockStatusIndicatorComponent, QdMockStatusIndicatorItemComponent, QdMockStatusIndicatorModule, QdMockStatusPairsCaptionComponent, QdMockStatusPairsComponent, QdMockStatusPairsErrorComponent, QdMockStatusPairsItemComponent, QdMockStatusPairsValueComponent, QdMockSwitchComponent, QdMockSwitchesComponent, QdMockTableComponent, QdMockTableModule, QdMockTextSectionComponent, QdMockTextSectionHeadlineComponent, QdMockTextSectionModule, QdMockTextSectionParagraphComponent, QdMockTextareaComponent, QdMockTileButtonListComponent, QdMockTileComponent, QdMockTileTextListComponent, QdMockTileTextListItemComponent, QdMockTileTitleComponent, QdMockTilesContainerComponent, QdMockTilesContainerTitleComponent, QdMockTilesModule, QdMockTranslatePipe, QdMockVisuallyHiddenDirective, QdMultiInputComponent, QdNavigationTilesModule, QdNotificationComponent, QdNotificationContentComponent, QdNotificationsComponent, QdNotificationsHttpInterceptorService, QdNotificationsModule, QdNotificationsService, QdNotificationsSnackbarListenerDirective, QdNumberInputService, QdPageComponent, QdPageControlPanelComponent, QdPageFooterComponent, QdPageFooterCustomContentDirective, QdPageHeaderExtensionDirective, QdPageInfoBannerComponent, QdPageModule, QdPageStepComponent, QdPageStepperAdapterDirective, QdPageStepperComponent, QdPageStepperModule, QdPageStoreService, QdPageTabComponent, QdPageTabsAdapterDirective, QdPageTabsComponent, QdPageTabsModule, QdPanelSectionActionsComponent, QdPanelSectionComponent, QdPanelSectionModule, QdPanelSectionStatusComponent, QdPanelSectionTextParagraphComponent, QdPendingChangesGuardDirective, QdPercentageProgressBarComponent, QdPinCodeComponent, QdPlaceholderPipe, QdProgressBarModule, QdProjectionGuardComponent, QdPushEventsService, QdQuickEditComponent, QdQuickEditModule, QdRadioButtonsComponent, QdRichtextComponent, QdRouterQueryParamHubService, QdRwdDisabledDirective, QdSearchComponent, QdSearchModule, QdSearchService, QdSectionAdapterDirective, QdSectionComponent, QdSectionModule, QdSectionToolbarComponent, QdShellComponent, QdShellModule, QdSortDirection, QdSpinnerComponent, QdSpinnerModule, QdStatusIndicatorComponent, QdStatusIndicatorModule, QdStatusPairsCaptionComponent, QdStatusPairsComponent, QdStatusPairsErrorComponent, QdStatusPairsItemComponent, QdStatusPairsValueComponent, QdSubgridComponent, QdSwitchComponent, QdSwitchesComponent, QdTableComponent, QdTableModule, QdTextSectionComponent, QdTextSectionHeadlineComponent, QdTextSectionModule, QdTextSectionParagraphComponent, QdTextareaComponent, QdTileButtonListComponent, QdTileComponent, QdTileTextListComponent, QdTileTextListItemComponent, QdTileTitleComponent, QdTilesComponent, QdTilesModule, QdTilesTitleComponent, QdTooltipIconComponent, QdTreeComponent, QdTreeModule, QdTreeRowExpanderService, QdUploadErrorType, QdValidators, QdViewportAdaptiveDirective, QdVisuallyHiddenDirective, WHITELIST_ERROR_CODES, chipStateDefault, createMetadataStream, qdFilterParameterize, qdMergeParams, qdPageTabParameterize, qdPaginationParameterize, qdSearchParameterize, qdSortParameterize, qdTableQueryParameterize, qdWrapParams, quadrelIconNames, updateHtmlLang };
37730
+ export { APP_ENVIRONMENT, BACKEND_ERROR_CODES, MockLocaleDatePipe, NavigationTileComponent, NavigationTilesComponent, QD_DIALOG_CONFIRMATION_RESOLVER_TOKEN, QD_FILE_MANAGER_TOKEN, QD_FILE_UPLOAD_MANAGER_TOKEN, QD_FORM_OPTIONS_RESOLVER, QD_PAGE_OBJECT_RESOLVER_TOKEN, QD_PAGE_STEP_RESOLVER_TOKEN, QD_POPOVER_TOP_FIRST, QD_SAFE_BOTTOM_OFFSET, QD_TABLE_DATA_RESOLVER_TOKEN, QD_UPLOAD_HTTP_OPTIONS, QdButtonComponent, QdButtonGhostDirective, QdButtonGridComponent, QdButtonLinkDirective, QdButtonModule, QdButtonStackButtonComponent, QdButtonStackComponent, QdCheckboxChipsComponent, QdCheckboxComponent, QdCheckboxesComponent, QdChipComponent, QdChipModule, QdColumnAutoFillDirective, QdColumnBreakBeforeDirective, QdColumnDirective, QdColumnDisableResponsiveColspansDirective, QdColumnFullGridWidthDirective, QdColumnNextInSameRowDirective, QdColumnsDirective, QdColumnsDisableAutoFillDirective, QdColumnsDisableResponsiveColspansDirective, QdColumnsMaxDirective, QdCommentsComponent, QdCommentsModule, QdConnectFormStateToPageDirective, QdConnectorTableContextDirective, QdConnectorTableFilterDirective, QdConnectorTableSearchDirective, QdContactCardComponent, QdContactCardModule, QdContainerPairsCaptionComponent, QdContainerPairsContainerComponent, QdContainerPairsHeaderComponent, QdContainerPairsItemComponent, QdContainerPairsValueComponent, QdContextService, QdCoreModule, QdDatepickerComponent, QdDialogActionComponent, QdDialogAuthSessionEndComponent, QdDialogAuthSessionEndService, QdDialogComponent, QdDialogConfirmationComponent, QdDialogConfirmationErrorDirective, QdDialogConfirmationInfoDirective, QdDialogConfirmationSuccessDirective, QdDialogModule, QdDialogRecordStepperComponent, QdDialogService, QdDialogSize, QdDisabledDirective, QdDropdownComponent, QdFileCollectorComponent, QdFileCollectorModule, QdFileSizePipe$1 as QdFileSizePipe, QdFileUploadComponent, QdFileUploadService, QdFilterComponent, QdFilterFormItemsComponent, QdFilterModule, QdFilterRestParamBuilder, QdFilterService, QdFooterActionType, QdFormArray, QdFormBuilder, QdFormControl, QdFormGroup, QdFormModule, QdFrameworkModule, QdGridComponent, QdGridModule, QdHorizontalPairsCaptionComponent, QdHorizontalPairsComponent, QdHorizontalPairsItemComponent, QdHorizontalPairsValueComponent, QdIconButtonComponent, QdIconComponent, QdIconModule, QdImageComponent, QdImageModule, QdIndeterminateProgressBarComponent, QdInputComponent, QdListModule, QdMenuButtonComponent, QdMockBreakpointService, QdMockButtonComponent, QdMockButtonGhostDirective, QdMockButtonGridComponent, QdMockButtonLinkDirective, QdMockButtonModule, QdMockButtonStackButtonComponent, QdMockButtonStackComponent, QdMockCalendarComponent, QdMockCheckboxChipsComponent, QdMockCheckboxComponent, QdMockCheckboxesComponent, QdMockChipComponent, QdMockChipModule, QdMockColumnDirective, QdMockColumnsDirective, QdMockContactCardComponent, QdMockContactCardModule, QdMockContainerPairsCaptionComponent, QdMockContainerPairsContainerComponent, QdMockContainerPairsHeaderComponent, QdMockContainerPairsItemComponent, QdMockContainerPairsValueComponent, QdMockCoreModule, QdMockCounterBadgeComponent, QdMockDatepickerComponent, QdMockDisabledDirective, QdMockDropdownComponent, QdMockFileCollectorComponent, QdMockFileCollectorModule, QdMockFilterCategoryBooleanComponent, QdMockFilterCategoryComponent, QdMockFilterCategoryDateComponent, QdMockFilterCategoryDateRangeComponent, QdMockFilterCategoryFreeTextComponent, QdMockFilterCategorySelectComponent, QdMockFilterComponent, QdMockFilterFormItemsComponent, QdMockFilterItemBooleanComponent, QdMockFilterItemDateComponent, QdMockFilterItemDateRangeComponent, QdMockFilterItemFreeTextComponent, QdMockFilterItemMultiSelectComponent, QdMockFilterItemSingleSelectComponent, QdMockFilterModule, QdMockFilterService, QdMockFormErrorComponent, QdMockFormGroupErrorComponent, QdMockFormHintComponent, QdMockFormLabelComponent, QdMockFormReadonlyComponent, QdMockFormViewonlyComponent, QdMockFormsModule, QdMockFrameworkModule, QdMockGridModule, QdMockIconButtonComponent, QdMockIconComponent, QdMockIconModule, QdMockImageComponent, QdMockImageModule, QdMockIndeterminateProgressBarComponent, QdMockInputComponent, QdMockListModule, QdMockNavigationTileComponent, QdMockNavigationTilesComponent, QdMockNavigationTilesModule, QdMockNotificationComponent, QdMockNotificationContentComponent, QdMockNotificationsComponent, QdMockNotificationsModule, QdMockNotificationsService, QdMockPageComponent, QdMockPageModule, QdMockPercentageProgressBarComponent, QdMockPinCodeComponent, QdMockPopoverOnClickDirective, QdMockProgressBarModule, QdMockRadioButtonsComponent, QdMockRwdDisabledDirective, QdMockSearchComponent, QdMockSearchModule, QdMockSectionComponent, QdMockSectionModule, QdMockShellComponent, QdMockShellFooterComponent, QdMockShellHeaderBannerComponent, QdMockShellHeaderComponent, QdMockShellHeaderSearchComponent, QdMockShellModule, QdMockShellToolbarComponent, QdMockShellToolbarItemComponent, QdMockStatusIndicatorCaptionComponent, QdMockStatusIndicatorComponent, QdMockStatusIndicatorItemComponent, QdMockStatusIndicatorModule, QdMockStatusPairsCaptionComponent, QdMockStatusPairsComponent, QdMockStatusPairsErrorComponent, QdMockStatusPairsItemComponent, QdMockStatusPairsValueComponent, QdMockSwitchComponent, QdMockSwitchesComponent, QdMockTableComponent, QdMockTableModule, QdMockTextSectionComponent, QdMockTextSectionHeadlineComponent, QdMockTextSectionModule, QdMockTextSectionParagraphComponent, QdMockTextareaComponent, QdMockTileButtonListComponent, QdMockTileComponent, QdMockTileTextListComponent, QdMockTileTextListItemComponent, QdMockTileTitleComponent, QdMockTilesContainerComponent, QdMockTilesContainerTitleComponent, QdMockTilesModule, QdMockTranslatePipe, QdMockVisuallyHiddenDirective, QdMultiInputComponent, QdNavigationTilesModule, QdNotificationComponent, QdNotificationContentComponent, QdNotificationsComponent, QdNotificationsHttpInterceptorService, QdNotificationsModule, QdNotificationsService, QdNotificationsSnackbarListenerDirective, QdNumberInputService, QdPageComponent, QdPageControlPanelComponent, QdPageFooterComponent, QdPageFooterCustomContentDirective, QdPageHeaderExtensionDirective, QdPageInfoBannerComponent, QdPageModule, QdPageStepComponent, QdPageStepperAdapterDirective, QdPageStepperComponent, QdPageStepperModule, QdPageStoreService, QdPageTabComponent, QdPageTabsAdapterDirective, QdPageTabsComponent, QdPageTabsModule, QdPanelSectionActionsComponent, QdPanelSectionComponent, QdPanelSectionModule, QdPanelSectionStatusComponent, QdPanelSectionTextParagraphComponent, QdPendingChangesGuardDirective, QdPercentageProgressBarComponent, QdPinCodeComponent, QdPlaceholderPipe, QdProgressBarModule, QdProjectionGuardComponent, QdPushEventsService, QdQuickEditComponent, QdQuickEditModule, QdRadioButtonsComponent, QdRichtextComponent, QdRouterQueryParamHubService, QdRwdDisabledDirective, QdSearchComponent, QdSearchModule, QdSearchService, QdSectionAdapterDirective, QdSectionComponent, QdSectionModule, QdSectionToolbarComponent, QdShellComponent, QdShellModule, QdSortDirection, QdSpinnerComponent, QdSpinnerModule, QdStatusIndicatorComponent, QdStatusIndicatorModule, QdStatusPairsCaptionComponent, QdStatusPairsComponent, QdStatusPairsErrorComponent, QdStatusPairsItemComponent, QdStatusPairsValueComponent, QdSubgridComponent, QdSwitchComponent, QdSwitchesComponent, QdTableComponent, QdTableModule, QdTextSectionComponent, QdTextSectionHeadlineComponent, QdTextSectionModule, QdTextSectionParagraphComponent, QdTextareaComponent, QdTileButtonListComponent, QdTileComponent, QdTileTextListComponent, QdTileTextListItemComponent, QdTileTitleComponent, QdTilesComponent, QdTilesModule, QdTilesTitleComponent, QdTooltipIconComponent, QdTreeComponent, QdTreeModule, QdTreeRowExpanderService, QdUploadErrorType, QdValidators, QdViewportAdaptiveDirective, QdVisuallyHiddenDirective, WHITELIST_ERROR_CODES, chipStateDefault, createMetadataStream, qdBackToOverview, qdFilterParameterize, qdMergeParams, qdPageTabParameterize, qdPaginationParameterize, qdSearchParameterize, qdSortParameterize, qdTableQueryParameterize, qdWrapParams, quadrelIconNames, updateHtmlLang };
36535
37731
  //# sourceMappingURL=quadrel-enterprise-ui-framework.mjs.map