@dereekb/dbx-web 13.8.0 → 13.10.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.
@@ -394,6 +394,20 @@ class DbxPopoverComponentController extends DbxPopoverController {
394
394
  * Core popover component that renders injected content with position strategy, transition watching, and keyboard close support.
395
395
  *
396
396
  * Coordinates with {@link DbxPopoverCoordinatorService} to ensure only one popover per key is active at a time.
397
+ *
398
+ * @dbxWebComponent
399
+ * @dbxWebSlug popover
400
+ * @dbxWebCategory overlay
401
+ * @dbxWebRelated popup, prompt-confirm, dialog-content
402
+ * @dbxWebSkillRefs dbx__ref__dbx-app-structure
403
+ * @dbxWebMinimalExample ```html
404
+ * <dbx-popover></dbx-popover>
405
+ * ```
406
+ *
407
+ * @example
408
+ * ```html
409
+ * // In a service: this.popoverService.open({ content: MyContentComponent, origin })
410
+ * ```
397
411
  */
398
412
  class DbxPopoverComponent extends AbstractTransitionWatcherDirective {
399
413
  popoverRef = inject((NgPopoverRef));
@@ -967,11 +981,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
967
981
  /**
968
982
  * Progress button that displays a Material progress bar beneath the button while working.
969
983
  *
984
+ * @dbxWebComponent
985
+ * @dbxWebSlug progress-bar-button
986
+ * @dbxWebCategory button
987
+ * @dbxWebRelated button, progress-spinner-button
988
+ * @dbxWebSkillRefs dbx__ref__dbx-ui-building-blocks
989
+ * @dbxWebMinimalExample ```html
990
+ * <dbx-progress-bar-button [config]="cfg"></dbx-progress-bar-button>
991
+ * ```
992
+ *
970
993
  * @example
971
994
  * ```html
972
- * <dbx-progress-bar-button [config]="buttonConfig" (btnClick)="onSave()">
973
- * Save
974
- * </dbx-progress-bar-button>
995
+ * <dbx-progress-bar-button [config]="cfg" (btnClick)="onClick()"></dbx-progress-bar-button>
975
996
  * ```
976
997
  */
977
998
  class DbxProgressBarButtonComponent extends AbstractProgressButtonDirective {
@@ -989,11 +1010,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
989
1010
  * Progress button that overlays a Material progress spinner on the button while working.
990
1011
  * Supports icon-only, FAB, and text button modes with automatic spinner sizing.
991
1012
  *
1013
+ * @dbxWebComponent
1014
+ * @dbxWebSlug progress-spinner-button
1015
+ * @dbxWebCategory button
1016
+ * @dbxWebRelated button, progress-bar-button
1017
+ * @dbxWebSkillRefs dbx__ref__dbx-ui-building-blocks
1018
+ * @dbxWebMinimalExample ```html
1019
+ * <dbx-progress-spinner-button [config]="cfg"></dbx-progress-spinner-button>
1020
+ * ```
1021
+ *
992
1022
  * @example
993
1023
  * ```html
994
- * <dbx-progress-spinner-button [config]="buttonConfig" (btnClick)="onSubmit()">
995
- * Submit
996
- * </dbx-progress-spinner-button>
1024
+ * <dbx-progress-spinner-button [config]="cfg" (btnClick)="onClick()"></dbx-progress-spinner-button>
997
1025
  * ```
998
1026
  */
999
1027
  class DbxProgressSpinnerButtonComponent extends AbstractProgressButtonDirective {
@@ -1120,6 +1148,15 @@ function provideDbxProgressButtonGlobalConfig(config) {
1120
1148
  * custom colors, icons, and floating action button (FAB) mode. Integrates with the dbxAction system
1121
1149
  * for automatic working/disabled state management.
1122
1150
  *
1151
+ * @dbxWebComponent
1152
+ * @dbxWebSlug button
1153
+ * @dbxWebCategory button
1154
+ * @dbxWebRelated icon-button, progress-spinner-button, progress-bar-button
1155
+ * @dbxWebSkillRefs dbx__ref__dbx-ui-building-blocks
1156
+ * @dbxWebMinimalExample ```html
1157
+ * <dbx-button text="Save" raised [dbxAction]="saveAction"></dbx-button>
1158
+ * ```
1159
+ *
1123
1160
  * @example
1124
1161
  * ```html
1125
1162
  * <dbx-button [text]="'Save'" raised [dbxAction]="saveAction">
@@ -1168,11 +1205,10 @@ class DbxButtonComponent extends AbstractDbxButtonDirective {
1168
1205
  customContent = input(false, { ...(ngDevMode ? { debugName: "customContent" } : /* istanbul ignore next */ {}), transform: isDefinedAndNotFalse });
1169
1206
  allowClickPropagation = input(false, { ...(ngDevMode ? { debugName: "allowClickPropagation" } : /* istanbul ignore next */ {}), transform: isDefinedAndNotFalse });
1170
1207
  mode = input(...(ngDevMode ? [undefined, { debugName: "mode" }] : /* istanbul ignore next */ []));
1171
- typeSignal = computed(() => {
1208
+ styleTypeSignal = computed(() => {
1172
1209
  const style = this.buttonStyle();
1173
1210
  let type = this.type() ?? style?.type;
1174
1211
  if (!type) {
1175
- type = 'basic';
1176
1212
  if (this.iconOnly()) {
1177
1213
  type = 'icon';
1178
1214
  }
@@ -1190,7 +1226,7 @@ class DbxButtonComponent extends AbstractDbxButtonDirective {
1190
1226
  }
1191
1227
  }
1192
1228
  return type;
1193
- }, ...(ngDevMode ? [{ debugName: "typeSignal" }] : /* istanbul ignore next */ []));
1229
+ }, ...(ngDevMode ? [{ debugName: "styleTypeSignal" }] : /* istanbul ignore next */ []));
1194
1230
  configSignal = computed(() => {
1195
1231
  // configure custom style
1196
1232
  const customStyle = {};
@@ -1217,7 +1253,7 @@ class DbxButtonComponent extends AbstractDbxButtonDirective {
1217
1253
  const fab = this.fab() || buttonStyle?.fab;
1218
1254
  const mode = this.mode() ?? buttonStyle?.mode;
1219
1255
  const working = this.workingSignal();
1220
- const buttonType = this.typeSignal();
1256
+ const buttonType = this.styleTypeSignal();
1221
1257
  const ariaLabel = this.ariaLabel();
1222
1258
  const config = {
1223
1259
  fab,
@@ -1227,7 +1263,7 @@ class DbxButtonComponent extends AbstractDbxButtonDirective {
1227
1263
  customClass: 'dbx-button ' + (isIconOnlyButton ? 'dbx-button-no-text' : ''),
1228
1264
  text: textValue ?? '',
1229
1265
  hasTextContent,
1230
- buttonType,
1266
+ buttonType: buttonType ?? (isIconOnlyButton ? 'icon' : 'basic'),
1231
1267
  buttonColor,
1232
1268
  barColor: 'accent',
1233
1269
  mode,
@@ -1311,16 +1347,22 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
1311
1347
  /**
1312
1348
  * Adds inline spacing between adjacent buttons. Can be used as an element or attribute.
1313
1349
  *
1314
- * @example
1315
- * ```html
1316
- * <dbx-button text="Cancel"></dbx-button>
1350
+ * @dbxWebComponent
1351
+ * @dbxWebSlug button-spacer
1352
+ * @dbxWebCategory button
1353
+ * @dbxWebRelated bar, spacer, button
1354
+ * @dbxWebSkillRefs dbx__ref__dbx-ui-building-blocks
1355
+ * @dbxWebMinimalExample ```html
1317
1356
  * <dbx-button-spacer></dbx-button-spacer>
1318
- * <dbx-button text="Save" raised></dbx-button>
1319
1357
  * ```
1320
1358
  *
1321
1359
  * @example
1322
1360
  * ```html
1323
- * <span dbxButtonSpacer></span>
1361
+ * <dbx-bar>
1362
+ * <dbx-button text="Save" raised></dbx-button>
1363
+ * <dbx-button-spacer></dbx-button-spacer>
1364
+ * <dbx-button text="Cancel"></dbx-button>
1365
+ * </dbx-bar>
1324
1366
  * ```
1325
1367
  */
1326
1368
  class DbxButtonSpacerDirective {
@@ -1342,18 +1384,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
1342
1384
  * Lightweight button that renders as either an icon-only Material icon button or a text button
1343
1385
  * with an icon prefix, depending on whether text is provided.
1344
1386
  *
1345
- * @deprecated Use `dbx-button` instead. For icon-only buttons use `<dbx-button icon="settings" iconOnly>`.
1346
- * For icon+text buttons use `<dbx-button icon="settings" text="Label">`. The `dbx-button` component
1347
- * supports all the same inputs plus working/loading states, colors, and button style variants.
1348
- *
1349
- * @example
1350
- * ```html
1351
- * <dbx-icon-button icon="settings" (buttonClick)="openSettings()"></dbx-icon-button>
1387
+ * @dbxWebComponent
1388
+ * @dbxWebSlug icon-button
1389
+ * @dbxWebCategory button
1390
+ * @dbxWebRelated button
1391
+ * @dbxWebSkillRefs dbx__migration__migrate-dbx-icon-button
1392
+ * @dbxWebMinimalExample ```html
1393
+ * <dbx-icon-button icon="add"></dbx-icon-button>
1352
1394
  * ```
1353
1395
  *
1354
1396
  * @example
1355
1397
  * ```html
1356
- * <dbx-icon-button icon="add" text="Add Item" (buttonClick)="addItem()"></dbx-icon-button>
1398
+ * <dbx-icon-button icon="delete" color="warn" [dbxAction]="deleteAction"></dbx-icon-button>
1357
1399
  * ```
1358
1400
  */
1359
1401
  class DbxIconButtonComponent extends AbstractDbxButtonDirective {
@@ -2289,10 +2331,20 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
2289
2331
  *
2290
2332
  * Can be used as an element, attribute, or CSS class selector.
2291
2333
  *
2334
+ * @dbxWebComponent
2335
+ * @dbxWebSlug dialog-content
2336
+ * @dbxWebCategory overlay
2337
+ * @dbxWebRelated popover, popup, prompt
2338
+ * @dbxWebSkillRefs dbx__ref__dbx-app-structure
2339
+ * @dbxWebMinimalExample ```html
2340
+ * <div dbxDialogContent>Body</div>
2341
+ * ```
2342
+ *
2292
2343
  * @example
2293
2344
  * ```html
2294
- * <dbx-dialog-content [width]="'wide'">
2295
- * <p>Dialog body content here.</p>
2345
+ * <dbx-dialog-content>
2346
+ * <h2>Confirm</h2>
2347
+ * <p>Are you sure?</p>
2296
2348
  * </dbx-dialog-content>
2297
2349
  * ```
2298
2350
  */
@@ -2691,11 +2743,18 @@ function resizeSignal(inputElement) {
2691
2743
  *
2692
2744
  * Uses a `ResizeObserver` internally via {@link resizeSignal}.
2693
2745
  *
2746
+ * @dbxWebComponent
2747
+ * @dbxWebSlug resized
2748
+ * @dbxWebCategory screen
2749
+ * @dbxWebRelated flex-group
2750
+ * @dbxWebSkillRefs dbx__ref__dbx-ui-building-blocks
2751
+ * @dbxWebMinimalExample ```html
2752
+ * <div (dbxResized)="handle($event)"></div>
2753
+ * ```
2754
+ *
2694
2755
  * @example
2695
2756
  * ```html
2696
- * <div dbxResized (dbxResized)="onResize($event)">
2697
- * Resizable content
2698
- * </div>
2757
+ * <div (dbxResized)="onResized($event)" class="resizable-panel"></div>
2699
2758
  * ```
2700
2759
  */
2701
2760
  class DbxResizedDirective {
@@ -3103,14 +3162,27 @@ const DEFAULT_FILTER_POPOVER_BUTTON_DISPLAY_CONTENT = {
3103
3162
  class DbxFilterPopoverButtonComponent extends AbstractFilterPopoverButtonDirective {
3104
3163
  buttonElement = viewChild('button', { ...(ngDevMode ? { debugName: "buttonElement" } : /* istanbul ignore next */ {}), read: ElementRef });
3105
3164
  disabled = input(...(ngDevMode ? [undefined, { debugName: "disabled" }] : /* istanbul ignore next */ []));
3165
+ /**
3166
+ * @deprecated Use buttonDisplayStyle instead.
3167
+ */
3106
3168
  buttonDisplay = input(DEFAULT_FILTER_POPOVER_BUTTON_DISPLAY_CONTENT, { ...(ngDevMode ? { debugName: "buttonDisplay" } : /* istanbul ignore next */ {}), transform: (x) => x ?? DEFAULT_FILTER_POPOVER_BUTTON_DISPLAY_CONTENT });
3169
+ buttonDisplayStyle = input(...(ngDevMode ? [undefined, { debugName: "buttonDisplayStyle" }] : /* istanbul ignore next */ []));
3170
+ buttonDisplaySignal = computed(() => {
3171
+ const pairDisplay = this.buttonDisplayStyle()?.display;
3172
+ const directDisplay = this.buttonDisplay();
3173
+ if (!pairDisplay && !directDisplay) {
3174
+ return undefined;
3175
+ }
3176
+ return { ...pairDisplay, ...directDisplay };
3177
+ }, ...(ngDevMode ? [{ debugName: "buttonDisplaySignal" }] : /* istanbul ignore next */ []));
3178
+ buttonStyleSignal = computed(() => this.buttonDisplayStyle()?.style, ...(ngDevMode ? [{ debugName: "buttonStyleSignal" }] : /* istanbul ignore next */ []));
3107
3179
  showFilterPopover() {
3108
3180
  const origin = this.buttonElement()?.nativeElement;
3109
3181
  this.showPopover(origin);
3110
3182
  }
3111
3183
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.4", ngImport: i0, type: DbxFilterPopoverButtonComponent, deps: null, target: i0.ɵɵFactoryTarget.Component });
3112
- static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.2.0", version: "21.2.4", type: DbxFilterPopoverButtonComponent, isStandalone: true, selector: "dbx-filter-popover-button", inputs: { disabled: { classPropertyName: "disabled", publicName: "disabled", isSignal: true, isRequired: false, transformFunction: null }, buttonDisplay: { classPropertyName: "buttonDisplay", publicName: "buttonDisplay", isSignal: true, isRequired: false, transformFunction: null } }, viewQueries: [{ propertyName: "buttonElement", first: true, predicate: ["button"], descendants: true, read: ElementRef, isSignal: true }], usesInheritance: true, ngImport: i0, template: `
3113
- <dbx-button #button (buttonClick)="showFilterPopover()" [buttonDisplay]="buttonDisplay()" [disabled]="disabled()" iconOnly></dbx-button>
3184
+ static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.2.0", version: "21.2.4", type: DbxFilterPopoverButtonComponent, isStandalone: true, selector: "dbx-filter-popover-button", inputs: { disabled: { classPropertyName: "disabled", publicName: "disabled", isSignal: true, isRequired: false, transformFunction: null }, buttonDisplay: { classPropertyName: "buttonDisplay", publicName: "buttonDisplay", isSignal: true, isRequired: false, transformFunction: null }, buttonDisplayStyle: { classPropertyName: "buttonDisplayStyle", publicName: "buttonDisplayStyle", isSignal: true, isRequired: false, transformFunction: null } }, viewQueries: [{ propertyName: "buttonElement", first: true, predicate: ["button"], descendants: true, read: ElementRef, isSignal: true }], usesInheritance: true, ngImport: i0, template: `
3185
+ <dbx-button #button (buttonClick)="showFilterPopover()" [buttonDisplay]="buttonDisplaySignal()" [buttonStyle]="buttonStyleSignal()" [disabled]="disabled()"></dbx-button>
3114
3186
  `, isInline: true, dependencies: [{ kind: "component", type: DbxButtonComponent, selector: "dbx-button", inputs: ["bar", "type", "buttonStyle", "color", "spinnerColor", "customButtonColor", "customTextColor", "customSpinnerColor", "basic", "tonal", "raised", "stroked", "flat", "iconOnly", "fab", "customContent", "allowClickPropagation", "mode"] }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
3115
3187
  }
3116
3188
  i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImport: i0, type: DbxFilterPopoverButtonComponent, decorators: [{
@@ -3118,13 +3190,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
3118
3190
  args: [{
3119
3191
  selector: 'dbx-filter-popover-button',
3120
3192
  template: `
3121
- <dbx-button #button (buttonClick)="showFilterPopover()" [buttonDisplay]="buttonDisplay()" [disabled]="disabled()" iconOnly></dbx-button>
3193
+ <dbx-button #button (buttonClick)="showFilterPopover()" [buttonDisplay]="buttonDisplaySignal()" [buttonStyle]="buttonStyleSignal()" [disabled]="disabled()"></dbx-button>
3122
3194
  `,
3123
3195
  imports: [DbxButtonComponent],
3124
3196
  changeDetection: ChangeDetectionStrategy.OnPush,
3125
3197
  standalone: true
3126
3198
  }]
3127
- }], propDecorators: { buttonElement: [{ type: i0.ViewChild, args: ['button', { ...{ read: ElementRef }, isSignal: true }] }], disabled: [{ type: i0.Input, args: [{ isSignal: true, alias: "disabled", required: false }] }], buttonDisplay: [{ type: i0.Input, args: [{ isSignal: true, alias: "buttonDisplay", required: false }] }] } });
3199
+ }], propDecorators: { buttonElement: [{ type: i0.ViewChild, args: ['button', { ...{ read: ElementRef }, isSignal: true }] }], disabled: [{ type: i0.Input, args: [{ isSignal: true, alias: "disabled", required: false }] }], buttonDisplay: [{ type: i0.Input, args: [{ isSignal: true, alias: "buttonDisplay", required: false }] }], buttonDisplayStyle: [{ type: i0.Input, args: [{ isSignal: true, alias: "buttonDisplayStyle", required: false }] }] } });
3128
3200
 
3129
3201
  /**
3130
3202
  * Wraps filter form content with apply/reset buttons, integrating with the action system.
@@ -3321,10 +3393,20 @@ function overrideClickElementEffect(config) {
3321
3393
  *
3322
3394
  * Supports plain content, clickable actions, router segue references, external hrefs, and disabled states.
3323
3395
  *
3396
+ * @dbxWebComponent
3397
+ * @dbxWebSlug anchor
3398
+ * @dbxWebCategory router
3399
+ * @dbxWebRelated anchor-list, navbar, sidenav
3400
+ * @dbxWebSkillRefs dbx__ref__dbx-app-structure
3401
+ * @dbxWebMinimalExample ```html
3402
+ * <dbx-anchor [anchor]="{ url: '/' }">Home</dbx-anchor>
3403
+ * ```
3404
+ *
3324
3405
  * @example
3325
3406
  * ```html
3326
- * <dbx-anchor [anchor]="myAnchor">Click me</dbx-anchor>
3327
- * <span dbx-anchor [anchor]="myAnchor" [block]="true">Block anchor</span>
3407
+ * <dbx-anchor [anchor]="{ ref: 'app.home' }">
3408
+ * <button mat-button>Home</button>
3409
+ * </dbx-anchor>
3328
3410
  * ```
3329
3411
  */
3330
3412
  class DbxAnchorComponent extends AbstractDbxAnchorDirective {
@@ -3443,9 +3525,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
3443
3525
  *
3444
3526
  * Each anchor is expanded and assigned depth-based CSS classes for nested styling.
3445
3527
  *
3528
+ * @dbxWebComponent
3529
+ * @dbxWebSlug anchor-list
3530
+ * @dbxWebCategory router
3531
+ * @dbxWebRelated anchor, sidenav
3532
+ * @dbxWebSkillRefs dbx__ref__dbx-app-structure
3533
+ * @dbxWebMinimalExample ```html
3534
+ * <dbx-anchor-list [anchors]="anchors"></dbx-anchor-list>
3535
+ * ```
3536
+ *
3446
3537
  * @example
3447
3538
  * ```html
3448
- * <dbx-anchor-list [anchors]="navLinks"></dbx-anchor-list>
3539
+ * <dbx-anchor-list [anchors]="navAnchors"></dbx-anchor-list>
3449
3540
  * ```
3450
3541
  */
3451
3542
  class DbxAnchorListComponent {
@@ -4034,6 +4125,20 @@ class DbxPopupComponentController extends DbxPopupController {
4034
4125
  * Core popup component that renders injected content with support for minimize, fullscreen, and normal window states.
4035
4126
  *
4036
4127
  * Coordinates with {@link DbxPopupCoordinatorService} to ensure only one popup per key is active at a time.
4128
+ *
4129
+ * @dbxWebComponent
4130
+ * @dbxWebSlug popup
4131
+ * @dbxWebCategory overlay
4132
+ * @dbxWebRelated popover
4133
+ * @dbxWebSkillRefs dbx__ref__dbx-app-structure
4134
+ * @dbxWebMinimalExample ```html
4135
+ * <dbx-popup></dbx-popup>
4136
+ * ```
4137
+ *
4138
+ * @example
4139
+ * ```html
4140
+ * // In a service: this.popupService.open({ content: MyContentComponent })
4141
+ * ```
4037
4142
  */
4038
4143
  class DbxPopupComponent extends AbstractTransitionWatcherDirective {
4039
4144
  popoverRef = inject((NgPopoverRef));
@@ -4466,13 +4571,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
4466
4571
  * Can be used as a standalone element or as an attribute directive on elements with the `.dbx-section-header` class.
4467
4572
  * Serves as the base class for `DbxSectionComponent` and `DbxSectionPageComponent`.
4468
4573
  *
4574
+ * @dbxWebComponent
4575
+ * @dbxWebSlug section-header
4576
+ * @dbxWebCategory layout
4577
+ * @dbxWebRelated section, subsection
4578
+ * @dbxWebSkillRefs dbx__ref__dbx-ui-building-blocks
4579
+ * @dbxWebMinimalExample ```html
4580
+ * <dbx-section-header header="My Header"></dbx-section-header>
4581
+ * ```
4582
+ *
4469
4583
  * @example
4470
4584
  * ```html
4471
- * <dbx-section-header header="My Header" [h]="2" icon="star" hint="A helpful hint"></dbx-section-header>
4472
- *
4473
- * <div class="dbx-section-header" header="Attribute Usage" [h]="3"></div>
4474
- *
4475
- * <dbx-section-header [headerConfig]="{ header: 'Config Object', h: 2, icon: 'info' }"></dbx-section-header>
4585
+ * <div class="dbx-section-header" header="Custom Layout" [h]="2" icon="info"></div>
4476
4586
  * ```
4477
4587
  */
4478
4588
  class DbxSectionHeaderComponent {
@@ -4624,6 +4734,15 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
4624
4734
  * Displays a content section with a header and body area. The header defaults to an h3 heading
4625
4735
  * and supports optional elevation styling.
4626
4736
  *
4737
+ * @dbxWebComponent
4738
+ * @dbxWebSlug section
4739
+ * @dbxWebCategory layout
4740
+ * @dbxWebRelated subsection, section-page, section-header, intro-action-section
4741
+ * @dbxWebSkillRefs dbx__ref__dbx-ui-building-blocks, dbx__ref__dbx-component-patterns
4742
+ * @dbxWebMinimalExample ```html
4743
+ * <dbx-section header="My Section"><p>Body</p></dbx-section>
4744
+ * ```
4745
+ *
4627
4746
  * @example
4628
4747
  * ```html
4629
4748
  * <dbx-section header="My Section" icon="info" hint="Additional context">
@@ -4637,6 +4756,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
4637
4756
  * ```
4638
4757
  */
4639
4758
  class DbxSectionComponent extends DbxSectionHeaderComponent {
4759
+ /** Apply elevated card styling. */
4640
4760
  elevate = input(false, ...(ngDevMode ? [{ debugName: "elevate" }] : /* istanbul ignore next */ []));
4641
4761
  classConfig = computed(() => {
4642
4762
  return this.elevate() ? 'dbx-section-elevate dbx-content-elevate' : '';
@@ -4679,11 +4799,20 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
4679
4799
  * Renders a subsection within a parent section, using a smaller heading (defaults to h4).
4680
4800
  * Useful for grouping related content under a `dbx-section`.
4681
4801
  *
4802
+ * @dbxWebComponent
4803
+ * @dbxWebSlug subsection
4804
+ * @dbxWebCategory layout
4805
+ * @dbxWebRelated section, section-header
4806
+ * @dbxWebSkillRefs dbx__ref__dbx-ui-building-blocks
4807
+ * @dbxWebMinimalExample ```html
4808
+ * <dbx-subsection header="Details"><p>Body</p></dbx-subsection>
4809
+ * ```
4810
+ *
4682
4811
  * @example
4683
4812
  * ```html
4684
- * <dbx-section header="Parent Section">
4685
- * <dbx-subsection header="Details" icon="settings">
4686
- * <p>Subsection content here.</p>
4813
+ * <dbx-section header="Settings">
4814
+ * <dbx-subsection header="Notifications" icon="notifications">
4815
+ * <p>Subsection body.</p>
4687
4816
  * </dbx-subsection>
4688
4817
  * </dbx-section>
4689
4818
  * ```
@@ -4724,11 +4853,20 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
4724
4853
  /**
4725
4854
  * Renders a styled prompt section with a header, descriptive text, and a hero content slot.
4726
4855
  *
4856
+ * @dbxWebComponent
4857
+ * @dbxWebSlug prompt
4858
+ * @dbxWebCategory overlay
4859
+ * @dbxWebRelated prompt-confirm, dialog-content
4860
+ * @dbxWebSkillRefs dbx__ref__dbx-app-structure
4861
+ * @dbxWebMinimalExample ```html
4862
+ * <dbx-prompt header="Confirm"></dbx-prompt>
4863
+ * ```
4864
+ *
4727
4865
  * @example
4728
4866
  * ```html
4729
- * <dbx-prompt [header]="'Welcome'" [prompt]="'Please sign in to continue.'">
4730
- * <img hero src="logo.png" />
4731
- * <button mat-raised-button>Sign In</button>
4867
+ * <dbx-prompt header="Delete account" prompt="This cannot be undone.">
4868
+ * <button mat-button (click)="cancel()">Cancel</button>
4869
+ * <button mat-flat-button color="warn" (click)="confirm()">Delete</button>
4732
4870
  * </dbx-prompt>
4733
4871
  * ```
4734
4872
  */
@@ -4766,11 +4904,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
4766
4904
  /**
4767
4905
  * Renders a confirmation prompt with customizable title, message, confirm, and cancel buttons.
4768
4906
  *
4907
+ * @dbxWebComponent
4908
+ * @dbxWebSlug prompt-confirm
4909
+ * @dbxWebCategory overlay
4910
+ * @dbxWebRelated prompt, action-confirm
4911
+ * @dbxWebSkillRefs dbx__ref__dbx-app-structure
4912
+ * @dbxWebMinimalExample ```html
4913
+ * <dbx-prompt-confirm [config]="cfg"></dbx-prompt-confirm>
4914
+ * ```
4915
+ *
4769
4916
  * @example
4770
4917
  * ```html
4771
- * <dbx-prompt-confirm [config]="{ title: 'Delete?', prompt: 'This cannot be undone.' }" (confirm)="onConfirm()" (cancel)="onCancel()">
4772
- * <p>Additional content here.</p>
4773
- * </dbx-prompt-confirm>
4918
+ * <dbx-prompt-confirm [config]="{ header: 'Delete?', confirmText: 'Delete', cancelText: 'Cancel' }"></dbx-prompt-confirm>
4774
4919
  * ```
4775
4920
  */
4776
4921
  class DbxPromptConfirmComponent {
@@ -4947,15 +5092,20 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
4947
5092
  * Constrains content to a maximum width with configurable padding. Useful for centering
4948
5093
  * page content and maintaining readable line lengths.
4949
5094
  *
5095
+ * @dbxWebComponent
5096
+ * @dbxWebSlug content-container
5097
+ * @dbxWebCategory layout
5098
+ * @dbxWebRelated content, content-page, content-box
5099
+ * @dbxWebSkillRefs dbx__ref__dbx-ui-building-blocks
5100
+ * @dbxWebMinimalExample ```html
5101
+ * <div dbxContentContainer>Body</div>
5102
+ * ```
5103
+ *
4950
5104
  * @example
4951
5105
  * ```html
4952
- * <dbx-content-container grow="medium" padding="small">
4953
- * <p>Centered content with medium max-width.</p>
5106
+ * <dbx-content-container grow="full" padding="normal">
5107
+ * <p>Page body</p>
4954
5108
  * </dbx-content-container>
4955
- *
4956
- * <div dbxContentContainer grow="full" padding="none" topPadding="small">
4957
- * <p>Full-width content with top padding.</p>
4958
- * </div>
4959
5109
  * ```
4960
5110
  */
4961
5111
  class DbxContentContainerDirective {
@@ -5689,11 +5839,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
5689
5839
  /**
5690
5840
  * Displays a label header above projected content, useful for labeling form fields or data sections.
5691
5841
  *
5842
+ * @dbxWebComponent
5843
+ * @dbxWebSlug label-block
5844
+ * @dbxWebCategory text
5845
+ * @dbxWebRelated detail-block
5846
+ * @dbxWebSkillRefs dbx__ref__dbx-ui-building-blocks
5847
+ * @dbxWebMinimalExample ```html
5848
+ * <dbx-label-block header="Label">Body</dbx-label-block>
5849
+ * ```
5850
+ *
5692
5851
  * @example
5693
5852
  * ```html
5694
- * <dbx-label-block header="Email">
5695
- * <span>user@example.com</span>
5696
- * </dbx-label-block>
5853
+ * <dbx-label-block header="Status"><span>Active</span></dbx-label-block>
5697
5854
  * ```
5698
5855
  */
5699
5856
  class DbxLabelBlockComponent {
@@ -6033,9 +6190,20 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
6033
6190
  * Emits a {@link DbxErrorViewButtonEvent} when the button is clicked, which is typically used
6034
6191
  * to open an error detail popover. Used internally by {@link DbxErrorComponent}.
6035
6192
  *
6193
+ * @dbxWebComponent
6194
+ * @dbxWebSlug error-view
6195
+ * @dbxWebCategory feedback
6196
+ * @dbxWebRelated error, error-snackbar
6197
+ * @dbxWebSkillRefs dbx__ref__dbx-component-patterns
6198
+ * @dbxWebMinimalExample ```html
6199
+ * <dbx-error-view [error]="error"></dbx-error-view>
6200
+ * ```
6201
+ *
6036
6202
  * @example
6037
6203
  * ```html
6038
- * <dbx-error-view icon="warning" [message]="'Something went wrong'" (buttonClick)="onErrorClick($event)"></dbx-error-view>
6204
+ * <dbx-error-view [error]="error">
6205
+ * <dbx-button text="Retry" [dbxAction]="retryAction"></dbx-button>
6206
+ * </dbx-error-view>
6039
6207
  * ```
6040
6208
  */
6041
6209
  class DbxErrorViewComponent {
@@ -6092,12 +6260,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
6092
6260
  * with an icon and message, or a custom error widget registered via {@link DbxErrorWidgetService}.
6093
6261
  * Clicking the error icon opens a popover with detailed error information.
6094
6262
  *
6263
+ * @dbxWebComponent
6264
+ * @dbxWebSlug error
6265
+ * @dbxWebCategory feedback
6266
+ * @dbxWebRelated error-snackbar, error-view, loading
6267
+ * @dbxWebSkillRefs dbx__ref__dbx-component-patterns
6268
+ * @dbxWebMinimalExample ```html
6269
+ * <dbx-error [error]="error"></dbx-error>
6270
+ * ```
6271
+ *
6095
6272
  * @example
6096
6273
  * ```html
6097
- * <dbx-error [error]="myError"></dbx-error>
6098
- *
6099
- * <!-- Icon-only mode, no message text -->
6100
- * <dbx-error [error]="myError" [iconOnly]="true"></dbx-error>
6274
+ * <dbx-error [error]="error$ | async"></dbx-error>
6101
6275
  * ```
6102
6276
  */
6103
6277
  class DbxErrorComponent {
@@ -6201,13 +6375,18 @@ const DEFAULT_LOADING_PROGRESS_DIAMETER = 96;
6201
6375
  * Supports both linear (bar) and circular (spinner) modes with configurable
6202
6376
  * diameter, color, and optional hint text below the indicator.
6203
6377
  *
6204
- * @example
6205
- * ```html
6206
- * <!-- Indeterminate spinner -->
6378
+ * @dbxWebComponent
6379
+ * @dbxWebSlug loading-progress
6380
+ * @dbxWebCategory feedback
6381
+ * @dbxWebRelated loading, basic-loading
6382
+ * @dbxWebSkillRefs dbx__ref__dbx-ui-building-blocks
6383
+ * @dbxWebMinimalExample ```html
6207
6384
  * <dbx-loading-progress></dbx-loading-progress>
6385
+ * ```
6208
6386
  *
6209
- * <!-- Determinate linear bar at 75% -->
6210
- * <dbx-loading-progress [linear]="true" mode="determinate" [value]="75" text="Uploading..."></dbx-loading-progress>
6387
+ * @example
6388
+ * ```html
6389
+ * <dbx-loading-progress mode="bar"></dbx-loading-progress>
6211
6390
  * ```
6212
6391
  */
6213
6392
  class DbxLoadingProgressComponent {
@@ -6274,6 +6453,15 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
6274
6453
  * Prefer using {@link DbxLoadingComponent} (`<dbx-loading>`) which wraps this component with
6275
6454
  * support for {@link LoadingContext} streams.
6276
6455
  *
6456
+ * @dbxWebComponent
6457
+ * @dbxWebSlug basic-loading
6458
+ * @dbxWebCategory feedback
6459
+ * @dbxWebRelated loading, loading-progress, error
6460
+ * @dbxWebSkillRefs dbx__ref__dbx-ui-building-blocks
6461
+ * @dbxWebMinimalExample ```html
6462
+ * <dbx-basic-loading [loading]="true"><p>Content</p></dbx-basic-loading>
6463
+ * ```
6464
+ *
6277
6465
  * @example
6278
6466
  * ```html
6279
6467
  * <dbx-basic-loading [loading]="true" color="accent" text="Loading data...">
@@ -6356,19 +6544,19 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
6356
6544
  * track loading and error state from reactive streams. Also supports manual `loading`
6357
6545
  * and `error` inputs for simpler use cases.
6358
6546
  *
6547
+ * @dbxWebComponent
6548
+ * @dbxWebSlug loading
6549
+ * @dbxWebCategory feedback
6550
+ * @dbxWebRelated basic-loading, loading-progress, error
6551
+ * @dbxWebSkillRefs dbx__ref__dbx-component-patterns
6552
+ * @dbxWebMinimalExample ```html
6553
+ * <dbx-loading [state]="state$ | async">Body</dbx-loading>
6554
+ * ```
6555
+ *
6359
6556
  * @example
6360
6557
  * ```html
6361
- * <!-- With a LoadingContext -->
6362
- * <dbx-loading [context]="myLoadingContext$">
6363
- * <p>Data loaded successfully.</p>
6364
- * </dbx-loading>
6365
- *
6366
- * <!-- With manual loading/error inputs -->
6367
- * <dbx-loading [loading]="isLoading" [error]="loadError" linear [padding]="true">
6368
- * <p>Content here.</p>
6369
- * <ng-container error>
6370
- * <p>Custom error message.</p>
6371
- * </ng-container>
6558
+ * <dbx-loading [state]="state$ | async" text="Loading items...">
6559
+ * <dbx-list [state$]="state$" [config]="listConfig"></dbx-list>
6372
6560
  * </dbx-loading>
6373
6561
  * ```
6374
6562
  */
@@ -6463,10 +6651,19 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
6463
6651
  * Apply to a `<dbx-loading>` element that is within an action context to automatically
6464
6652
  * reflect the action's loading state in the loading component.
6465
6653
  *
6654
+ * @dbxWebComponent
6655
+ * @dbxWebSlug action-loading-context
6656
+ * @dbxWebCategory action
6657
+ * @dbxWebRelated loading, action-snackbar
6658
+ * @dbxWebSkillRefs dbx__ref__dbx-component-patterns
6659
+ * @dbxWebMinimalExample ```html
6660
+ * <button [dbxActionLoadingContext]></button>
6661
+ * ```
6662
+ *
6466
6663
  * @example
6467
6664
  * ```html
6468
- * <dbx-loading dbxActionLoadingContext>
6469
- * <p>Content appears when the action's loading state resolves.</p>
6665
+ * <dbx-loading [state]="ctx.state$ | async">
6666
+ * <button [dbxAction]="saveAction" dbxActionLoadingContext>Save</button>
6470
6667
  * </dbx-loading>
6471
6668
  * ```
6472
6669
  */
@@ -6511,13 +6708,22 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
6511
6708
  /**
6512
6709
  * Adds flexible spacing between sibling elements in a flex container.
6513
6710
  *
6711
+ * @dbxWebComponent
6712
+ * @dbxWebSlug spacer
6713
+ * @dbxWebCategory layout
6714
+ * @dbxWebRelated bar, button-spacer
6715
+ * @dbxWebSkillRefs dbx__ref__dbx-ui-building-blocks
6716
+ * @dbxWebMinimalExample ```html
6717
+ * <dbx-spacer></dbx-spacer>
6718
+ * ```
6719
+ *
6514
6720
  * @example
6515
6721
  * ```html
6516
- * <div class="dbx-flex">
6517
- * <span>Left</span>
6722
+ * <dbx-bar>
6723
+ * <span>Title</span>
6518
6724
  * <dbx-spacer></dbx-spacer>
6519
- * <span>Right</span>
6520
- * </div>
6725
+ * <button mat-button>Action</button>
6726
+ * </dbx-bar>
6521
6727
  * ```
6522
6728
  */
6523
6729
  class DbxSpacerDirective {
@@ -6868,18 +7074,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
6868
7074
  * (loading, success, error). Supports built-in message presets via `dbxActionSnackbarDefault` and
6869
7075
  * custom generator functions via the `dbxActionSnackbar` input.
6870
7076
  *
6871
- * @example
6872
- * ```html
6873
- * <form [dbxAction]="saveAction" dbxActionSnackbar dbxActionSnackbarDefault="save">
6874
- * <!-- Shows "Saving...", "Saved", or "Save Failed" snackbars automatically -->
6875
- * </form>
7077
+ * @dbxWebComponent
7078
+ * @dbxWebSlug action-snackbar
7079
+ * @dbxWebCategory action
7080
+ * @dbxWebRelated action-snackbar-error, action-confirm, error-snackbar
7081
+ * @dbxWebSkillRefs dbx__ref__dbx-component-patterns
7082
+ * @dbxWebMinimalExample ```html
7083
+ * <div [dbxActionSnackbar]="fn"></div>
6876
7084
  * ```
6877
7085
  *
6878
7086
  * @example
6879
7087
  * ```html
6880
- * <div [dbxAction]="deleteAction" [dbxActionSnackbar]="customSnackbarFn" [dbxActionSnackbarUndo]="undoRef">
6881
- * <!-- Custom snackbar with undo support -->
6882
- * </div>
7088
+ * <button [dbxAction]="saveAction" [dbxActionSnackbar]="snackbarFn">Save</button>
6883
7089
  * ```
6884
7090
  */
6885
7091
  class DbxActionSnackbarDirective {
@@ -7023,18 +7229,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
7023
7229
  *
7024
7230
  * NOTE: This directive only works with UI-Router (not Angular Router).
7025
7231
  *
7026
- * @example
7027
- * ```html
7028
- * <form [dbxAction]="saveAction" [dbxActionTransitionSafety]="'dialog'">
7029
- * <!-- Navigating away with unsaved changes shows a confirmation dialog -->
7030
- * </form>
7232
+ * @dbxWebComponent
7233
+ * @dbxWebSlug action-transition-safety
7234
+ * @dbxWebCategory action
7235
+ * @dbxWebRelated action-confirm
7236
+ * @dbxWebSkillRefs dbx__ref__dbx-component-patterns
7237
+ * @dbxWebMinimalExample ```html
7238
+ * <form [dbxActionTransitionSafety]></form>
7031
7239
  * ```
7032
7240
  *
7033
7241
  * @example
7034
7242
  * ```html
7035
- * <form [dbxAction]="autoSaveAction" [dbxActionTransitionSafety]="'auto'">
7036
- * <!-- Auto-triggers save on navigation if possible, otherwise shows dialog -->
7037
- * </form>
7243
+ * <form [dbxAction]="formAction" dbxActionTransitionSafety>...</form>
7038
7244
  * ```
7039
7245
  */
7040
7246
  class DbxActionTransitionSafetyDirective {
@@ -7153,11 +7359,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
7153
7359
  * This directive works with action triggering only, not button clicks.
7154
7360
  * For button-based confirmation, use an appPromptConfirmButton directive instead.
7155
7361
  *
7362
+ * @dbxWebComponent
7363
+ * @dbxWebSlug action-confirm
7364
+ * @dbxWebCategory action
7365
+ * @dbxWebRelated action-snackbar, prompt-confirm
7366
+ * @dbxWebSkillRefs dbx__ref__dbx-component-patterns
7367
+ * @dbxWebMinimalExample ```html
7368
+ * <div [dbxActionConfirm]="cfg"></div>
7369
+ * ```
7370
+ *
7156
7371
  * @example
7157
7372
  * ```html
7158
- * <form [dbxAction]="myAction" [dbxActionConfirm]="{ title: 'Confirm Delete', prompt: 'Are you sure?', readyValue: itemId }">
7159
- * ...
7160
- * </form>
7373
+ * <button [dbxAction]="deleteAction" [dbxActionConfirm]="{ header: 'Delete account?', confirmText: 'Delete' }">Delete</button>
7161
7374
  * ```
7162
7375
  */
7163
7376
  class DbxActionConfirmDirective extends AbstractPromptConfirmDirective {
@@ -7210,18 +7423,18 @@ const DEFAULT_ACTION_KEY_TRIGGER = 'enter';
7210
7423
  * Triggers the parent action context when a specific keyboard key is released.
7211
7424
  * Defaults to the "enter" key. Key names should be lowercase.
7212
7425
  *
7213
- * @example
7214
- * ```html
7215
- * <form [dbxAction]="saveAction" dbxActionKeyTrigger>
7216
- * <!-- Pressing Enter triggers the action -->
7217
- * </form>
7426
+ * @dbxWebComponent
7427
+ * @dbxWebSlug action-key-trigger
7428
+ * @dbxWebCategory action
7429
+ * @dbxWebRelated action-confirm, action-snackbar
7430
+ * @dbxWebSkillRefs dbx__ref__dbx-component-patterns
7431
+ * @dbxWebMinimalExample ```html
7432
+ * <div [dbxActionKeyTrigger]="'enter'"></div>
7218
7433
  * ```
7219
7434
  *
7220
7435
  * @example
7221
7436
  * ```html
7222
- * <div [dbxAction]="searchAction" [dbxActionKeyTrigger]="'escape'">
7223
- * <!-- Pressing Escape triggers the action -->
7224
- * </div>
7437
+ * <form [dbxAction]="saveAction" [dbxActionKeyTrigger]="'cmd+s'">...</form>
7225
7438
  * ```
7226
7439
  */
7227
7440
  class DbxActionKeyTriggerDirective {
@@ -7382,9 +7595,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
7382
7595
  * Supports an optional auto-dismiss timer that pauses while an error detail popover is open.
7383
7596
  * Typically opened via {@link DbxErrorSnackbarService} or the static {@link DbxErrorSnackbarComponent.showErrorSnackbar} method.
7384
7597
  *
7598
+ * @dbxWebComponent
7599
+ * @dbxWebSlug error-snackbar
7600
+ * @dbxWebCategory feedback
7601
+ * @dbxWebRelated error
7602
+ * @dbxWebSkillRefs dbx__ref__dbx-component-patterns
7603
+ * @dbxWebMinimalExample ```html
7604
+ * <dbx-error-snackbar></dbx-error-snackbar>
7605
+ * ```
7606
+ *
7385
7607
  * @example
7386
- * ```typescript
7387
- * DbxErrorSnackbarComponent.showErrorSnackbar(matSnackBar, error, { duration: 5000 });
7608
+ * ```html
7609
+ * // Triggered via DbxErrorSnackbarService.showError(error)
7388
7610
  * ```
7389
7611
  */
7390
7612
  class DbxErrorSnackbarComponent {
@@ -7506,13 +7728,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
7506
7728
  * Subscribes to the action context's error stream and shows a snackbar via {@link DbxErrorSnackbarService}
7507
7729
  * whenever an error occurs. Accepts an optional configuration or a duration in milliseconds as input.
7508
7730
  *
7731
+ * @dbxWebComponent
7732
+ * @dbxWebSlug action-snackbar-error
7733
+ * @dbxWebCategory action
7734
+ * @dbxWebRelated action-snackbar
7735
+ * @dbxWebSkillRefs dbx__ref__dbx-component-patterns
7736
+ * @dbxWebMinimalExample ```html
7737
+ * <div [dbxActionSnackbarError]></div>
7738
+ * ```
7739
+ *
7509
7740
  * @example
7510
7741
  * ```html
7511
- * <!-- Auto-dismiss after 5 seconds -->
7512
- * <div dbxAction [dbxActionSnackbarError]="5000">...</div>
7513
- *
7514
- * <!-- Default behavior, no auto-dismiss -->
7515
- * <div dbxAction dbxActionSnackbarError>...</div>
7742
+ * <button [dbxAction]="saveAction" dbxActionSnackbarError>Save</button>
7516
7743
  * ```
7517
7744
  */
7518
7745
  class DbxActionSnackbarErrorDirective {
@@ -8303,15 +8530,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
8303
8530
  * Wraps content in a recessed "pit" container with optional scrollable overflow and rounded corners.
8304
8531
  * Useful for displaying bounded content areas such as lists or previews with a constrained height.
8305
8532
  *
8533
+ * @dbxWebComponent
8534
+ * @dbxWebSlug content-pit
8535
+ * @dbxWebCategory layout
8536
+ * @dbxWebRelated content-box, content-elevate
8537
+ * @dbxWebSkillRefs dbx__ref__dbx-ui-building-blocks
8538
+ * @dbxWebMinimalExample ```html
8539
+ * <dbx-content-pit>Body</dbx-content-pit>
8540
+ * ```
8541
+ *
8306
8542
  * @example
8307
8543
  * ```html
8308
- * <dbx-content-pit [scrollable]="true" [rounded]="true">
8309
- * <p>Scrollable pit with medium height and rounded corners.</p>
8310
- * </dbx-content-pit>
8311
- *
8312
- * <div dbxContentPit scrollable="large">
8313
- * <p>Large scrollable pit area.</p>
8314
- * </div>
8544
+ * <div dbxContentPit>Inset block</div>
8315
8545
  * ```
8316
8546
  */
8317
8547
  class DbxContentPitDirective {
@@ -9232,10 +9462,21 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
9232
9462
  /**
9233
9463
  * Renders a horizontal bar with a themed background color, used to visually group or separate content.
9234
9464
  *
9465
+ * @dbxWebComponent
9466
+ * @dbxWebSlug bar
9467
+ * @dbxWebCategory layout
9468
+ * @dbxWebRelated bar-header, pagebar, button-spacer
9469
+ * @dbxWebSkillRefs dbx__ref__dbx-ui-building-blocks
9470
+ * @dbxWebMinimalExample ```html
9471
+ * <dbx-bar><button>A</button><button>B</button></dbx-bar>
9472
+ * ```
9473
+ *
9235
9474
  * @example
9236
9475
  * ```html
9237
- * <dbx-bar color="primary">
9238
- * <span>Bar content</span>
9476
+ * <dbx-bar>
9477
+ * <dbx-button text="Save" raised color="primary"></dbx-button>
9478
+ * <dbx-button-spacer></dbx-button-spacer>
9479
+ * <dbx-button text="Cancel" stroked></dbx-button>
9239
9480
  * </dbx-bar>
9240
9481
  * ```
9241
9482
  */
@@ -9263,9 +9504,20 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
9263
9504
  /**
9264
9505
  * A themed header bar displaying an optional icon and text label, useful as a section divider.
9265
9506
  *
9507
+ * @dbxWebComponent
9508
+ * @dbxWebSlug bar-header
9509
+ * @dbxWebCategory layout
9510
+ * @dbxWebRelated bar, pagebar
9511
+ * @dbxWebSkillRefs dbx__ref__dbx-ui-building-blocks
9512
+ * @dbxWebMinimalExample ```html
9513
+ * <dbx-bar-header header="Title"></dbx-bar-header>
9514
+ * ```
9515
+ *
9266
9516
  * @example
9267
9517
  * ```html
9268
- * <dbx-bar-header icon="info" text="Section Title" color="accent"></dbx-bar-header>
9518
+ * <dbx-bar-header header="Members" icon="group">
9519
+ * <button mat-icon-button><mat-icon>add</mat-icon></button>
9520
+ * </dbx-bar-header>
9269
9521
  * ```
9270
9522
  */
9271
9523
  class DbxBarHeaderComponent {
@@ -9312,11 +9564,21 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
9312
9564
  /**
9313
9565
  * A page-level toolbar with left and right content slots, built on Angular Material's mat-toolbar.
9314
9566
  *
9567
+ * @dbxWebComponent
9568
+ * @dbxWebSlug pagebar
9569
+ * @dbxWebCategory layout
9570
+ * @dbxWebRelated bar, navbar
9571
+ * @dbxWebSkillRefs dbx__ref__dbx-ui-building-blocks, dbx__ref__dbx-app-structure
9572
+ * @dbxWebMinimalExample ```html
9573
+ * <dbx-pagebar>Title</dbx-pagebar>
9574
+ * ```
9575
+ *
9315
9576
  * @example
9316
9577
  * ```html
9317
- * <dbx-pagebar color="primary">
9318
- * <span left>Page Title</span>
9319
- * <button right mat-icon-button><mat-icon>settings</mat-icon></button>
9578
+ * <dbx-pagebar>
9579
+ * <h2>Settings</h2>
9580
+ * <span class="spacer"></span>
9581
+ * <button mat-stroked-button>Save</button>
9320
9582
  * </dbx-pagebar>
9321
9583
  * ```
9322
9584
  */
@@ -9436,6 +9698,15 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
9436
9698
  *
9437
9699
  * Supports a named content slot `[sectionHeader]` for custom header actions beside the title.
9438
9700
  *
9701
+ * @dbxWebComponent
9702
+ * @dbxWebSlug card-box
9703
+ * @dbxWebCategory card
9704
+ * @dbxWebRelated card-box-container, section
9705
+ * @dbxWebSkillRefs dbx__ref__dbx-ui-building-blocks
9706
+ * @dbxWebMinimalExample ```html
9707
+ * <dbx-card-box header="Title"><p>Body</p></dbx-card-box>
9708
+ * ```
9709
+ *
9439
9710
  * @example
9440
9711
  * ```html
9441
9712
  * <dbx-card-box [header]="'Settings'" [icon]="'settings'">
@@ -9506,18 +9777,21 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
9506
9777
  *
9507
9778
  * Can be used as an element or as an attribute directive on any host element.
9508
9779
  *
9509
- * @example
9510
- * ```html
9511
- * <dbx-card-box-container>
9512
- * <p>Padded content inside the card box.</p>
9513
- * </dbx-card-box-container>
9780
+ * @dbxWebComponent
9781
+ * @dbxWebSlug card-box-container
9782
+ * @dbxWebCategory card
9783
+ * @dbxWebRelated card-box
9784
+ * @dbxWebSkillRefs dbx__ref__dbx-ui-building-blocks
9785
+ * @dbxWebMinimalExample ```html
9786
+ * <div dbxCardBoxContainer><dbx-card-box></dbx-card-box></div>
9514
9787
  * ```
9515
9788
  *
9516
9789
  * @example
9517
9790
  * ```html
9518
- * <div dbxCardBoxContainer>
9519
- * <p>Padded content using the attribute directive.</p>
9520
- * </div>
9791
+ * <dbx-card-box-container>
9792
+ * <dbx-card-box header="One"></dbx-card-box>
9793
+ * <dbx-card-box header="Two"></dbx-card-box>
9794
+ * </dbx-card-box-container>
9521
9795
  * ```
9522
9796
  */
9523
9797
  class DbxCardBoxContainerDirective {
@@ -9699,11 +9973,25 @@ function provideTwoColumnsContext() {
9699
9973
  *
9700
9974
  * Requires a {@link TwoColumnsContextStore} to be provided by a parent component or directive.
9701
9975
  *
9976
+ * @dbxWebComponent
9977
+ * @dbxWebSlug two-column
9978
+ * @dbxWebCategory layout
9979
+ * @dbxWebRelated two-column-right
9980
+ * @dbxWebSkillRefs dbx__ref__dbx-ui-building-blocks, dbx__ref__dbx-app-structure
9981
+ * @dbxWebMinimalExample ```html
9982
+ * <dbx-two-column>
9983
+ * <div left>Sidebar</div>
9984
+ * <div right>Main</div>
9985
+ * </dbx-two-column>
9986
+ * ```
9987
+ *
9702
9988
  * @example
9703
9989
  * ```html
9704
- * <dbx-two-column [reverseSizing]="false" [inSectionPage]="true">
9705
- * <div left>Navigation sidebar</div>
9706
- * <div right>Main content area</div>
9990
+ * <dbx-two-column [inSectionPage]="true">
9991
+ * <dbx-list left [state$]="state$" [config]="listConfig" />
9992
+ * <dbx-two-column-right right header="Detail">
9993
+ * <p>Selected item detail.</p>
9994
+ * </dbx-two-column-right>
9707
9995
  * </dbx-two-column>
9708
9996
  * ```
9709
9997
  */
@@ -10412,10 +10700,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
10412
10700
  *
10413
10701
  * Automatically selects the active anchor based on the current route and supports configurable breakpoints.
10414
10702
  *
10703
+ * @dbxWebComponent
10704
+ * @dbxWebSlug navbar
10705
+ * @dbxWebCategory navigation
10706
+ * @dbxWebRelated anchor, sidenav, pagebar
10707
+ * @dbxWebSkillRefs dbx__ref__dbx-app-structure
10708
+ * @dbxWebMinimalExample ```html
10709
+ * <dbx-navbar [anchors]="anchors"></dbx-navbar>
10710
+ * ```
10711
+ *
10415
10712
  * @example
10416
10713
  * ```html
10417
- * <dbx-navbar [anchors]="navAnchors" breakpoint="large" buttonMode="menu"></dbx-navbar>
10418
- * <dbx-navbar [anchors]="navAnchors" mode="icon" [showMenuCaret]="true"></dbx-navbar>
10714
+ * <dbx-navbar [anchors]="topNav"></dbx-navbar>
10419
10715
  * ```
10420
10716
  */
10421
10717
  class DbxNavbarComponent extends AbstractTransitionDirective {
@@ -10556,13 +10852,18 @@ function resolveSideNavDisplayMode(mode, allowedModes) {
10556
10852
  * Renders a Material sidenav with an anchor list and automatically transitions between mobile overlay, icon rail, and full sidebar modes.
10557
10853
  * Closes automatically on route transitions in mobile mode.
10558
10854
  *
10855
+ * @dbxWebComponent
10856
+ * @dbxWebSlug sidenav
10857
+ * @dbxWebCategory navigation
10858
+ * @dbxWebRelated sidenav-page, anchor-list
10859
+ * @dbxWebSkillRefs dbx__ref__dbx-app-structure
10860
+ * @dbxWebMinimalExample ```html
10861
+ * <dbx-sidenav [anchors]="anchors"></dbx-sidenav>
10862
+ * ```
10863
+ *
10559
10864
  * @example
10560
10865
  * ```html
10561
- * <dbx-sidenav [anchors]="sidenavLinks" color="primary">
10562
- * <div top>Header Content</div>
10563
- * <div bottom>Footer Content</div>
10564
- * <router-outlet></router-outlet>
10565
- * </dbx-sidenav>
10866
+ * <dbx-sidenav [anchors]="sidenavAnchors"></dbx-sidenav>
10566
10867
  * ```
10567
10868
  */
10568
10869
  class DbxSidenavComponent extends AbstractTransitionWatcherDirective {
@@ -10831,15 +11132,20 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
10831
11132
  *
10832
11133
  * When `mobileOnly` is true, the pagebar is hidden on non-mobile screen sizes.
10833
11134
  *
11135
+ * @dbxWebComponent
11136
+ * @dbxWebSlug sidenav-page
11137
+ * @dbxWebCategory navigation
11138
+ * @dbxWebRelated sidenav, navbar
11139
+ * @dbxWebSkillRefs dbx__ref__dbx-app-structure
11140
+ * @dbxWebMinimalExample ```html
11141
+ * <dbx-sidenav-page>Content</dbx-sidenav-page>
11142
+ * ```
11143
+ *
10834
11144
  * @example
10835
11145
  * ```html
10836
- * <dbx-sidenav [anchors]="links">
10837
- * <dbx-sidenav-page [mobileOnly]="true" color="primary">
10838
- * <span navLeft>Left Nav Content</span>
10839
- * <span navRight>Right Nav Content</span>
10840
- * <p>Page body content</p>
10841
- * </dbx-sidenav-page>
10842
- * </dbx-sidenav>
11146
+ * <dbx-sidenav-page>
11147
+ * <ui-view></ui-view>
11148
+ * </dbx-sidenav-page>
10843
11149
  * ```
10844
11150
  */
10845
11151
  class DbxSidenavPageComponent {
@@ -11064,13 +11370,20 @@ function provideDbxRouterWebUiRouterProviderConfig() {
11064
11370
  * When this component is created, it automatically registers itself with the {@link TwoColumnsContextStore}
11065
11371
  * to indicate that right-side content is present.
11066
11372
  *
11373
+ * @dbxWebComponent
11374
+ * @dbxWebSlug two-column-right
11375
+ * @dbxWebCategory layout
11376
+ * @dbxWebRelated two-column
11377
+ * @dbxWebSkillRefs dbx__ref__dbx-ui-building-blocks, dbx__ref__dbx-app-structure
11378
+ * @dbxWebMinimalExample ```html
11379
+ * <dbx-two-column-right>Body</dbx-two-column-right>
11380
+ * ```
11381
+ *
11067
11382
  * @example
11068
11383
  * ```html
11069
- * <dbx-two-column-right header="Detail View" [showBack]="true" [minRightWidth]="400">
11070
- * <div nav>
11071
- * <button mat-icon-button>Actions</button>
11072
- * </div>
11073
- * <p>Right column content here</p>
11384
+ * <dbx-two-column-right header="Item Detail">
11385
+ * <button nav mat-icon-button><mat-icon>delete</mat-icon></button>
11386
+ * <p>Body content</p>
11074
11387
  * </dbx-two-column-right>
11075
11388
  * ```
11076
11389
  */
@@ -11316,15 +11629,20 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
11316
11629
  * Wraps content in a box container with optional elevation (card-like shadow) and wide layout.
11317
11630
  * Both `elevate` and `wide` default to `true`.
11318
11631
  *
11632
+ * @dbxWebComponent
11633
+ * @dbxWebSlug content-box
11634
+ * @dbxWebCategory layout
11635
+ * @dbxWebRelated content, content-elevate, content-pit
11636
+ * @dbxWebSkillRefs dbx__ref__dbx-ui-building-blocks
11637
+ * @dbxWebMinimalExample ```html
11638
+ * <div dbxContentBox>Body</div>
11639
+ * ```
11640
+ *
11319
11641
  * @example
11320
11642
  * ```html
11321
11643
  * <dbx-content-box>
11322
- * <p>Elevated wide box content.</p>
11644
+ * <p>Summary content</p>
11323
11645
  * </dbx-content-box>
11324
- *
11325
- * <div dbxContentBox [elevate]="false" [wide]="false">
11326
- * <p>Flat, non-wide box content.</p>
11327
- * </div>
11328
11646
  * ```
11329
11647
  */
11330
11648
  class DbxContentBoxDirective {
@@ -11349,14 +11667,19 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
11349
11667
  /**
11350
11668
  * Sets the host element to fill the available page height. Use as a wrapper for page-level content blocks.
11351
11669
  *
11670
+ * @dbxWebComponent
11671
+ * @dbxWebSlug content
11672
+ * @dbxWebCategory layout
11673
+ * @dbxWebRelated content-container, content-page, content-box
11674
+ * @dbxWebSkillRefs dbx__ref__dbx-ui-building-blocks
11675
+ * @dbxWebMinimalExample ```html
11676
+ * <dbx-content>Body</dbx-content>
11677
+ * ```
11678
+ *
11352
11679
  * @example
11353
11680
  * ```html
11354
- * <dbx-content>
11355
- * <p>This content fills the page height.</p>
11356
- * </dbx-content>
11357
- *
11358
11681
  * <div dbxContent>
11359
- * <p>Attribute usage on any element.</p>
11682
+ * <p>Standard content body</p>
11360
11683
  * </div>
11361
11684
  * ```
11362
11685
  */
@@ -11379,15 +11702,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
11379
11702
  * Applies elevation (box-shadow) styling to the host element, giving it a raised card appearance.
11380
11703
  * Elevation is enabled by default and can be toggled off.
11381
11704
  *
11705
+ * @dbxWebComponent
11706
+ * @dbxWebSlug content-elevate
11707
+ * @dbxWebCategory layout
11708
+ * @dbxWebRelated content-box, content-pit
11709
+ * @dbxWebSkillRefs dbx__ref__dbx-ui-building-blocks
11710
+ * @dbxWebMinimalExample ```html
11711
+ * <dbx-content-elevate>Body</dbx-content-elevate>
11712
+ * ```
11713
+ *
11382
11714
  * @example
11383
11715
  * ```html
11384
- * <dbx-content-elevate>
11385
- * <p>Elevated content with shadow.</p>
11386
- * </dbx-content-elevate>
11387
- *
11388
- * <div dbxContentElevate [elevate]="false">
11389
- * <p>Flat content, no elevation.</p>
11390
- * </div>
11716
+ * <div dbxContentElevate>Highlighted block</div>
11391
11717
  * ```
11392
11718
  */
11393
11719
  class DbxContentElevateDirective {
@@ -11411,14 +11737,19 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
11411
11737
  * Sets the host element to fill the full page height with page-level content styling.
11412
11738
  * Similar to `DbxContentDirective` but applies the `dbx-content-page` class for page-specific layout.
11413
11739
  *
11740
+ * @dbxWebComponent
11741
+ * @dbxWebSlug content-page
11742
+ * @dbxWebCategory layout
11743
+ * @dbxWebRelated content-container, section-page
11744
+ * @dbxWebSkillRefs dbx__ref__dbx-ui-building-blocks
11745
+ * @dbxWebMinimalExample ```html
11746
+ * <dbx-content-page>Page</dbx-content-page>
11747
+ * ```
11748
+ *
11414
11749
  * @example
11415
11750
  * ```html
11416
- * <dbx-content-page>
11417
- * <p>Full-page content layout.</p>
11418
- * </dbx-content-page>
11419
- *
11420
11751
  * <div dbxContentPage>
11421
- * <p>Attribute usage on any element.</p>
11752
+ * <dbx-section-page header="Dashboard"><p>...</p></dbx-section-page>
11422
11753
  * </div>
11423
11754
  * ```
11424
11755
  */
@@ -11583,11 +11914,20 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
11583
11914
  * that can be used to adjust styling. When `breakToColumn` is enabled, items will stack vertically
11584
11915
  * on small screens.
11585
11916
  *
11917
+ * @dbxWebComponent
11918
+ * @dbxWebSlug flex-group
11919
+ * @dbxWebCategory layout
11920
+ * @dbxWebRelated flex-size, bar
11921
+ * @dbxWebSkillRefs dbx__ref__dbx-ui-building-blocks
11922
+ * @dbxWebMinimalExample ```html
11923
+ * <div dbxFlexGroup><div dbxFlexSize="1">A</div></div>
11924
+ * ```
11925
+ *
11586
11926
  * @example
11587
11927
  * ```html
11588
- * <div dbxFlexGroup [breakToColumn]="true" breakpoint="tablet">
11589
- * <div [dbxFlexSize]="3">Half width</div>
11590
- * <div [dbxFlexSize]="3">Half width</div>
11928
+ * <div dbxFlexGroup breakpoint="sm">
11929
+ * <div dbxFlexSize="2">Wide</div>
11930
+ * <div dbxFlexSize="1">Narrow</div>
11591
11931
  * </div>
11592
11932
  * ```
11593
11933
  */
@@ -11632,11 +11972,20 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
11632
11972
  * Applies a `dbx-flex-{size}` CSS class to the host element based on the given {@link DbxFlexSize} value.
11633
11973
  * Use within a {@link DbxFlexGroupDirective} to control how much row width this element occupies.
11634
11974
  *
11975
+ * @dbxWebComponent
11976
+ * @dbxWebSlug flex-size
11977
+ * @dbxWebCategory layout
11978
+ * @dbxWebRelated flex-group
11979
+ * @dbxWebSkillRefs dbx__ref__dbx-ui-building-blocks
11980
+ * @dbxWebMinimalExample ```html
11981
+ * <div dbxFlexSize="1"></div>
11982
+ * ```
11983
+ *
11635
11984
  * @example
11636
11985
  * ```html
11637
11986
  * <div dbxFlexGroup>
11638
- * <div [dbxFlexSize]="4">Two-thirds width</div>
11639
- * <div [dbxFlexSize]="2">One-third width</div>
11987
+ * <div dbxFlexSize="2">Twice as wide</div>
11988
+ * <div dbxFlexSize="1">Narrow</div>
11640
11989
  * </div>
11641
11990
  * ```
11642
11991
  */
@@ -12143,9 +12492,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
12143
12492
  /**
12144
12493
  * Renders a value-based list view using a configuration input. Must be used within a parent {@link DbxListView} context.
12145
12494
  *
12495
+ * @dbxWebComponent
12496
+ * @dbxWebSlug list-view
12497
+ * @dbxWebCategory list
12498
+ * @dbxWebRelated list, selection-list-view, list-grid-view, list-accordion-view
12499
+ * @dbxWebSkillRefs dbx__ref__dbx-component-patterns
12500
+ * @dbxWebMinimalExample ```html
12501
+ * <dbx-list-view [config]="rowConfig"></dbx-list-view>
12502
+ * ```
12503
+ *
12146
12504
  * @example
12147
12505
  * ```html
12148
- * <dbx-list-view [config]="listViewConfig"></dbx-list-view>
12506
+ * <dbx-list-view [config]="rowConfig"></dbx-list-view>
12149
12507
  * ```
12150
12508
  */
12151
12509
  class DbxValueListViewComponent extends AbstractDbxValueListViewDirective {
@@ -12361,9 +12719,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
12361
12719
  * Renders a value list as an accordion using a configuration input. Each item renders its own expansion panel.
12362
12720
  * Requires a parent {@link DbxListView} context.
12363
12721
  *
12722
+ * @dbxWebComponent
12723
+ * @dbxWebSlug list-accordion-view
12724
+ * @dbxWebCategory list
12725
+ * @dbxWebRelated list, list-view
12726
+ * @dbxWebSkillRefs dbx__ref__dbx-component-patterns
12727
+ * @dbxWebMinimalExample ```html
12728
+ * <dbx-list-accordion-view [config]="rowConfig"></dbx-list-accordion-view>
12729
+ * ```
12730
+ *
12364
12731
  * @example
12365
12732
  * ```html
12366
- * <dbx-list-accordion-view [config]="accordionConfig"></dbx-list-accordion-view>
12733
+ * <dbx-list-accordion-view [config]="rowConfig"></dbx-list-accordion-view>
12367
12734
  * ```
12368
12735
  */
12369
12736
  class DbxValueListAccordionViewComponent extends AbstractDbxValueListViewDirective {
@@ -12655,9 +13022,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
12655
13022
  /**
12656
13023
  * Renders a value list as a CSS grid using a configuration input. Requires a parent {@link DbxListView} context.
12657
13024
  *
13025
+ * @dbxWebComponent
13026
+ * @dbxWebSlug list-grid-view
13027
+ * @dbxWebCategory list
13028
+ * @dbxWebRelated list, list-view
13029
+ * @dbxWebSkillRefs dbx__ref__dbx-component-patterns
13030
+ * @dbxWebMinimalExample ```html
13031
+ * <dbx-list-grid-view [config]="cellConfig"></dbx-list-grid-view>
13032
+ * ```
13033
+ *
12658
13034
  * @example
12659
13035
  * ```html
12660
- * <dbx-list-grid-view [config]="gridViewConfig"></dbx-list-grid-view>
13036
+ * <dbx-list-grid-view [config]="cellConfig" dbxListGridSize="md"></dbx-list-grid-view>
12661
13037
  * ```
12662
13038
  */
12663
13039
  class DbxValueListGridViewComponent extends AbstractDbxValueListViewDirective {
@@ -12780,9 +13156,18 @@ class AbstractDbxListTitleGroupHeaderComponent {
12780
13156
  * Default group header component that displays a title, optional icon, and optional hint text.
12781
13157
  * Used automatically by {@link DbxListTitleGroupDirective} unless a custom header component is specified.
12782
13158
  *
13159
+ * @dbxWebComponent
13160
+ * @dbxWebSlug list-title-group-header
13161
+ * @dbxWebCategory list
13162
+ * @dbxWebRelated list, list-view
13163
+ * @dbxWebSkillRefs dbx__ref__dbx-component-patterns
13164
+ * @dbxWebMinimalExample ```html
13165
+ * <dbx-list-title-group-header></dbx-list-title-group-header>
13166
+ * ```
13167
+ *
12783
13168
  * @example
12784
13169
  * ```html
12785
- * <dbx-list-title-group-header></dbx-list-title-group-header>
13170
+ * <dbx-list-view [config]="rowConfig" dbxListTitleGroup></dbx-list-view>
12786
13171
  * ```
12787
13172
  */
12788
13173
  class DbxListTitleGroupHeaderComponent extends AbstractDbxListTitleGroupHeaderComponent {
@@ -13018,11 +13403,22 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
13018
13403
  /**
13019
13404
  * Displays centered placeholder content within an empty list. Projects its content into a styled container.
13020
13405
  *
13406
+ * @dbxWebComponent
13407
+ * @dbxWebSlug list-empty-content
13408
+ * @dbxWebCategory list
13409
+ * @dbxWebRelated list
13410
+ * @dbxWebSkillRefs dbx__ref__dbx-component-patterns
13411
+ * @dbxWebMinimalExample ```html
13412
+ * <dbx-list-empty-content>Empty</dbx-list-empty-content>
13413
+ * ```
13414
+ *
13021
13415
  * @example
13022
13416
  * ```html
13023
- * <dbx-list-empty-content>
13024
- * <p>No results found.</p>
13025
- * </dbx-list-empty-content>
13417
+ * <dbx-list [state$]="items$" [config]="listConfig">
13418
+ * <dbx-list-empty-content>
13419
+ * <p>No items yet — add one to get started.</p>
13420
+ * </dbx-list-empty-content>
13421
+ * </dbx-list>
13026
13422
  * ```
13027
13423
  */
13028
13424
  class DbxListEmptyContentComponent {
@@ -13097,11 +13493,18 @@ const DBX_LIST_DEFAULT_THROTTLE_SCROLL = 50;
13097
13493
  *
13098
13494
  * This component is typically wrapped by a higher-level component that provides its configuration via the `config` input.
13099
13495
  *
13496
+ * @dbxWebComponent
13497
+ * @dbxWebSlug list
13498
+ * @dbxWebCategory list
13499
+ * @dbxWebRelated list-view, list-empty-content, list-grid-view, list-accordion-view, selection-list-view
13500
+ * @dbxWebSkillRefs dbx__ref__dbx-component-patterns
13501
+ * @dbxWebMinimalExample ```html
13502
+ * <dbx-list [state$]="items$" [config]="listConfig"></dbx-list>
13503
+ * ```
13504
+ *
13100
13505
  * @example
13101
13506
  * ```html
13102
- * <dbx-list [state]="listState$" [config]="listConfig" [disabled]="isDisabled" [selectionMode]="'select'">
13103
- * <ng-container empty>No items found.</ng-container>
13104
- * </dbx-list>
13507
+ * <dbx-list [state$]="items$" [config]="listConfig" (contentScrolled)="onScroll($event)"></dbx-list>
13105
13508
  * ```
13106
13509
  */
13107
13510
  class DbxListComponent {
@@ -13294,7 +13697,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
13294
13697
  * Default HTML template for list wrapper components. Passes through state, config, and content projection slots to a child `dbx-list`.
13295
13698
  */
13296
13699
  const DEFAULT_LIST_WRAPPER_COMPONENT_CONFIGURATION_TEMPLATE = `
13297
- <dbx-list [state]="currentState$" [config]="configSignal()" [hasMore]="hasMore()" [disabled]="disabled()" [selectionMode]="selectionModeSignal()">
13700
+ <dbx-list [state]="currentState$" [config]="configSignal()" [hasMore]="hasMore()" [disabled]="disabledSignal()" [selectionMode]="selectionModeSignal()">
13298
13701
  <ng-content top select="[top]"></ng-content>
13299
13702
  <ng-content bottom select="[bottom]"></ng-content>
13300
13703
  <ng-content empty select="[empty]"></ng-content>
@@ -13325,7 +13728,9 @@ class AbstractDbxListWrapperDirective {
13325
13728
  _config = new BehaviorSubject(undefined);
13326
13729
  _stateOverride = new BehaviorSubject(undefined);
13327
13730
  _selectionModeOverride = new BehaviorSubject(undefined);
13731
+ _disabledOverride = new BehaviorSubject(undefined);
13328
13732
  _selectionModeOverrideSignal = toSignal(this._selectionModeOverride.pipe(maybeValueFromObservableOrValue()));
13733
+ _disabledOverrideSignal = toSignal(this._disabledOverride.pipe(maybeValueFromObservableOrValue()));
13329
13734
  hasMore = input(undefined, ...(ngDevMode ? [{ debugName: "hasMore" }] : /* istanbul ignore next */ []));
13330
13735
  clickItem = output();
13331
13736
  loadMore = output();
@@ -13335,6 +13740,9 @@ class AbstractDbxListWrapperDirective {
13335
13740
  selectionModeSignal = computed(() => {
13336
13741
  return this._selectionModeOverrideSignal() ?? this.selectionMode();
13337
13742
  }, ...(ngDevMode ? [{ debugName: "selectionModeSignal" }] : /* istanbul ignore next */ []));
13743
+ disabledSignal = computed(() => {
13744
+ return this._disabledOverrideSignal() ?? this.disabled();
13745
+ }, ...(ngDevMode ? [{ debugName: "disabledSignal" }] : /* istanbul ignore next */ []));
13338
13746
  currentState$ = combineLatest([this._stateOverride, toObservable(this.state)]).pipe(map(([stateOverride, state]) => stateOverride ?? state), maybeValueFromObservableOrValue(), shareReplay(1));
13339
13747
  config$ = this._config.pipe(maybeValueFromObservableOrValue(), map((x) => (x ? this._buildListConfig(x) : undefined)), shareReplay(1));
13340
13748
  configSignal = toSignal(this.config$);
@@ -13346,6 +13754,7 @@ class AbstractDbxListWrapperDirective {
13346
13754
  this._config.complete();
13347
13755
  this._stateOverride.complete();
13348
13756
  this._selectionModeOverride.complete();
13757
+ this._disabledOverride.complete();
13349
13758
  }
13350
13759
  setState(stateObs) {
13351
13760
  this._stateOverride.next(stateObs);
@@ -13353,6 +13762,9 @@ class AbstractDbxListWrapperDirective {
13353
13762
  setSelectionMode(selectionMode) {
13354
13763
  this._selectionModeOverride.next(selectionMode);
13355
13764
  }
13765
+ setDisabled(disabled) {
13766
+ this._disabledOverride.next(disabled);
13767
+ }
13356
13768
  _buildListConfig(config) {
13357
13769
  return {
13358
13770
  ...config,
@@ -13547,9 +13959,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
13547
13959
  * Renders a selection-capable list view using a configuration input. Requires a parent {@link DbxListView} context.
13548
13960
  * Switches between selection mode (with checkboxes) and view mode (standard list) based on the parent's selection mode.
13549
13961
  *
13962
+ * @dbxWebComponent
13963
+ * @dbxWebSlug selection-list-view
13964
+ * @dbxWebCategory list
13965
+ * @dbxWebRelated list, list-view
13966
+ * @dbxWebSkillRefs dbx__ref__dbx-component-patterns
13967
+ * @dbxWebMinimalExample ```html
13968
+ * <dbx-selection-list-view [config]="rowConfig"></dbx-selection-list-view>
13969
+ * ```
13970
+ *
13550
13971
  * @example
13551
13972
  * ```html
13552
- * <dbx-selection-list-view [config]="selectionListViewConfig"></dbx-selection-list-view>
13973
+ * <dbx-selection-list-view [config]="rowConfig" selectionMode="multi"></dbx-selection-list-view>
13553
13974
  * ```
13554
13975
  */
13555
13976
  class DbxSelectionValueListViewComponent extends AbstractDbxValueListViewDirective {
@@ -13684,15 +14105,23 @@ function provideDbxListViewWrapper(sourceType) {
13684
14105
  * Displays an introductory message with a call-to-action button. When the button is clicked,
13685
14106
  * the intro is replaced by the projected content. Useful for onboarding or first-time-use flows.
13686
14107
  *
14108
+ * @dbxWebComponent
14109
+ * @dbxWebSlug intro-action-section
14110
+ * @dbxWebCategory feedback
14111
+ * @dbxWebRelated section, list-empty-content
14112
+ * @dbxWebSkillRefs dbx__ref__dbx-ui-building-blocks
14113
+ * @dbxWebMinimalExample ```html
14114
+ * <dbx-intro-action-section hint="Welcome" action="Start"><p>Body</p></dbx-intro-action-section>
14115
+ * ```
14116
+ *
13687
14117
  * @example
13688
14118
  * ```html
13689
14119
  * <dbx-intro-action-section
13690
14120
  * hint="Welcome! Click below to get started."
13691
14121
  * action="Get Started"
13692
- * [showIntro]="isFirstVisit"
13693
- * (showAction)="onGetStarted()">
13694
- * <div info>Additional info shown in the intro state.</div>
13695
- * <p>Main content shown after the action is clicked.</p>
14122
+ * [showIntro]="!hasOnboarded"
14123
+ * (showAction)="markOnboarded()">
14124
+ * <p>Main content shown after the action.</p>
13696
14125
  * </dbx-intro-action-section>
13697
14126
  * ```
13698
14127
  */
@@ -13761,14 +14190,19 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
13761
14190
  * Supports nested section pages that retain proper fixed-height layout. Use for top-level
13762
14191
  * page content that needs a prominent heading.
13763
14192
  *
14193
+ * @dbxWebComponent
14194
+ * @dbxWebSlug section-page
14195
+ * @dbxWebCategory layout
14196
+ * @dbxWebRelated section, content-page
14197
+ * @dbxWebSkillRefs dbx__ref__dbx-ui-building-blocks, dbx__ref__dbx-app-structure
14198
+ * @dbxWebMinimalExample ```html
14199
+ * <dbx-section-page header="Page"><p>Body</p></dbx-section-page>
14200
+ * ```
14201
+ *
13764
14202
  * @example
13765
14203
  * ```html
13766
- * <dbx-section-page header="Page Title" icon="dashboard">
13767
- * <p>Page content here.</p>
13768
- * </dbx-section-page>
13769
- *
13770
- * <dbx-section-page header="Scrollable Body" scroll="body" hint="Only the body scrolls">
13771
- * <div style="height: 2000px">Tall content</div>
14204
+ * <dbx-section-page header="Dashboard" icon="dashboard" scroll="body">
14205
+ * <p>Top-level page content.</p>
13772
14206
  * </dbx-section-page>
13773
14207
  * ```
13774
14208
  */
@@ -14280,11 +14714,19 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
14280
14714
  *
14281
14715
  * Use the `[header]` content slot for extra header-level content and default content for the detail area.
14282
14716
  *
14717
+ * @dbxWebComponent
14718
+ * @dbxWebSlug detail-block
14719
+ * @dbxWebCategory text
14720
+ * @dbxWebRelated label-block
14721
+ * @dbxWebSkillRefs dbx__ref__dbx-ui-building-blocks
14722
+ * @dbxWebMinimalExample ```html
14723
+ * <dbx-detail-block header="Label">Body</dbx-detail-block>
14724
+ * ```
14725
+ *
14283
14726
  * @example
14284
14727
  * ```html
14285
- * <dbx-detail-block icon="person" header="User Info">
14286
- * <span header>Extra header content</span>
14287
- * <p>Detail content goes here.</p>
14728
+ * <dbx-detail-block header="Email" icon="mail">
14729
+ * <p>{{ user.email }}</p>
14288
14730
  * </dbx-detail-block>
14289
14731
  * ```
14290
14732
  */
@@ -14632,11 +15074,18 @@ const DBX_CHIP_DEFAULT_TONE = 18;
14632
15074
  /**
14633
15075
  * Renders a styled chip element with optional small, block, and color modes.
14634
15076
  *
15077
+ * @dbxWebComponent
15078
+ * @dbxWebSlug chip
15079
+ * @dbxWebCategory text
15080
+ * @dbxWebRelated chip-list
15081
+ * @dbxWebSkillRefs dbx__ref__dbx-ui-building-blocks
15082
+ * @dbxWebMinimalExample ```html
15083
+ * <dbx-chip text="Tag"></dbx-chip>
15084
+ * ```
15085
+ *
14635
15086
  * @example
14636
15087
  * ```html
14637
- * <dbx-chip [small]="true">Tag</dbx-chip>
14638
- * <dbx-chip [block]="true">Full Width</dbx-chip>
14639
- * <dbx-chip [color]="'primary'">Primary</dbx-chip>
15088
+ * <dbx-chip text="Active" icon="check" color="primary"></dbx-chip>
14640
15089
  * ```
14641
15090
  */
14642
15091
  class DbxChipDirective {
@@ -14719,10 +15168,21 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
14719
15168
  *
14720
15169
  * Uses {@link DbxChipDirective} internally with `dbx-chip-spacer` class for spacing.
14721
15170
  *
15171
+ * @dbxWebComponent
15172
+ * @dbxWebSlug chip-list
15173
+ * @dbxWebCategory text
15174
+ * @dbxWebRelated chip
15175
+ * @dbxWebSkillRefs dbx__ref__dbx-ui-building-blocks
15176
+ * @dbxWebMinimalExample ```html
15177
+ * <dbx-chip-list></dbx-chip-list>
15178
+ * ```
15179
+ *
14722
15180
  * @example
14723
15181
  * ```html
14724
- * <dbx-chip-list [chips]="[{ label: 'Active', value: 'active', color: 'primary' }, { label: 'Pending', value: 'pending', color: 'accent' }]"></dbx-chip-list>
14725
- * <dbx-chip-list [chips]="chips" [small]="true"></dbx-chip-list>
15182
+ * <dbx-chip-list>
15183
+ * <dbx-chip text="Tag1"></dbx-chip>
15184
+ * <dbx-chip text="Tag2"></dbx-chip>
15185
+ * </dbx-chip-list>
14726
15186
  * ```
14727
15187
  */
14728
15188
  class DbxChipListComponent {
@@ -14967,10 +15427,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
14967
15427
  *
14968
15428
  * Clicking the text or the icon copies the text to the clipboard and optionally shows a snackbar confirmation.
14969
15429
  *
15430
+ * @dbxWebComponent
15431
+ * @dbxWebSlug click-to-copy-text
15432
+ * @dbxWebCategory text
15433
+ * @dbxWebRelated chip
15434
+ * @dbxWebSkillRefs dbx__ref__dbx-ui-building-blocks
15435
+ * @dbxWebMinimalExample ```html
15436
+ * <dbx-click-to-copy-text [text]="value"></dbx-click-to-copy-text>
15437
+ * ```
15438
+ *
14970
15439
  * @example
14971
15440
  * ```html
14972
- * <dbx-click-to-copy-text copyText="some-value">some-value</dbx-click-to-copy-text>
14973
- * <dbx-click-to-copy-text [clickIconToCopyOnly]="true">Click icon only</dbx-click-to-copy-text>
15441
+ * <dbx-click-to-copy-text [text]="userId"></dbx-click-to-copy-text>
14974
15442
  * ```
14975
15443
  */
14976
15444
  class DbxClickToCopyTextComponent {
@@ -15075,7 +15543,7 @@ class DbxZipPreviewEntryListComponent extends AbstractDbxSelectionListWrapperDir
15075
15543
  });
15076
15544
  }
15077
15545
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.4", ngImport: i0, type: DbxZipPreviewEntryListComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
15078
- static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "21.2.4", type: DbxZipPreviewEntryListComponent, isStandalone: true, selector: "dbx-zip-preview-file-entry-list", providers: provideDbxListViewWrapper(DbxZipPreviewEntryListComponent), usesInheritance: true, ngImport: i0, template: "\n <dbx-list [state]=\"currentState$\" [config]=\"configSignal()\" [hasMore]=\"hasMore()\" [disabled]=\"disabled()\" [selectionMode]=\"selectionModeSignal()\">\n <ng-content top select=\"[top]\"></ng-content>\n <ng-content bottom select=\"[bottom]\"></ng-content>\n <ng-content empty select=\"[empty]\"></ng-content>\n <ng-content emptyLoading select=\"[emptyLoading]\"></ng-content>\n <ng-content end select=\"[end]\"></ng-content>\n </dbx-list>", isInline: true, dependencies: [{ kind: "ngmodule", type: DbxListWrapperComponentImportsModule }, { kind: "component", type: DbxListComponent, selector: "dbx-list", inputs: ["padded", "state", "config", "disabled", "selectionMode", "hasMore"], outputs: ["contentScrolled"] }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
15546
+ static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "21.2.4", type: DbxZipPreviewEntryListComponent, isStandalone: true, selector: "dbx-zip-preview-file-entry-list", providers: provideDbxListViewWrapper(DbxZipPreviewEntryListComponent), usesInheritance: true, ngImport: i0, template: "\n <dbx-list [state]=\"currentState$\" [config]=\"configSignal()\" [hasMore]=\"hasMore()\" [disabled]=\"disabledSignal()\" [selectionMode]=\"selectionModeSignal()\">\n <ng-content top select=\"[top]\"></ng-content>\n <ng-content bottom select=\"[bottom]\"></ng-content>\n <ng-content empty select=\"[empty]\"></ng-content>\n <ng-content emptyLoading select=\"[emptyLoading]\"></ng-content>\n <ng-content end select=\"[end]\"></ng-content>\n </dbx-list>", isInline: true, dependencies: [{ kind: "ngmodule", type: DbxListWrapperComponentImportsModule }, { kind: "component", type: DbxListComponent, selector: "dbx-list", inputs: ["padded", "state", "config", "disabled", "selectionMode", "hasMore"], outputs: ["contentScrolled"] }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
15079
15547
  }
15080
15548
  i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImport: i0, type: DbxZipPreviewEntryListComponent, decorators: [{
15081
15549
  type: Component,
@@ -15675,7 +16143,7 @@ class DbxWidgetListGridComponent extends AbstractDbxListWrapperDirective {
15675
16143
  });
15676
16144
  }
15677
16145
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.4", ngImport: i0, type: DbxWidgetListGridComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
15678
- static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "21.2.4", type: DbxWidgetListGridComponent, isStandalone: true, selector: "dbx-widget-grid", usesInheritance: true, ngImport: i0, template: "\n <dbx-list [state]=\"currentState$\" [config]=\"configSignal()\" [hasMore]=\"hasMore()\" [disabled]=\"disabled()\" [selectionMode]=\"selectionModeSignal()\">\n <ng-content top select=\"[top]\"></ng-content>\n <ng-content bottom select=\"[bottom]\"></ng-content>\n <ng-content empty select=\"[empty]\"></ng-content>\n <ng-content emptyLoading select=\"[emptyLoading]\"></ng-content>\n <ng-content end select=\"[end]\"></ng-content>\n </dbx-list>", isInline: true, dependencies: [{ kind: "ngmodule", type: DbxListWrapperComponentImportsModule }, { kind: "component", type: DbxListComponent, selector: "dbx-list", inputs: ["padded", "state", "config", "disabled", "selectionMode", "hasMore"], outputs: ["contentScrolled"] }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
16146
+ static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "21.2.4", type: DbxWidgetListGridComponent, isStandalone: true, selector: "dbx-widget-grid", usesInheritance: true, ngImport: i0, template: "\n <dbx-list [state]=\"currentState$\" [config]=\"configSignal()\" [hasMore]=\"hasMore()\" [disabled]=\"disabledSignal()\" [selectionMode]=\"selectionModeSignal()\">\n <ng-content top select=\"[top]\"></ng-content>\n <ng-content bottom select=\"[bottom]\"></ng-content>\n <ng-content empty select=\"[empty]\"></ng-content>\n <ng-content emptyLoading select=\"[emptyLoading]\"></ng-content>\n <ng-content end select=\"[end]\"></ng-content>\n </dbx-list>", isInline: true, dependencies: [{ kind: "ngmodule", type: DbxListWrapperComponentImportsModule }, { kind: "component", type: DbxListComponent, selector: "dbx-list", inputs: ["padded", "state", "config", "disabled", "selectionMode", "hasMore"], outputs: ["contentScrolled"] }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
15679
16147
  }
15680
16148
  i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImport: i0, type: DbxWidgetListGridComponent, decorators: [{
15681
16149
  type: Component,