@dereekb/dbx-components-mcp 13.43.0 → 14.0.0

package/dbx-components-mcp.js

@@ -10,7 +10,7 @@ var __export = (target, all) => {
 // packages/dbx-components-mcp/package.json
 var package_default = {
   name: "@dereekb/dbx-components-mcp",
-  version: "13.43.0",
+  version: "14.0.0",
   type: "module",
   bin: {
     "dbx-components-mcp": "dbx-components-mcp.js"
@@ -21,8 +21,8 @@ var package_default = {
     "ts-morph": "^21.0.0"
   },
   peerDependencies: {
-    "@dereekb/dbx-cli": "13.43.0",
-    "@dereekb/util": "13.43.0"
+    "@dereekb/dbx-cli": "14.0.0",
+    "@dereekb/util": "14.0.0"
   }
 };
 
@@ -2139,7 +2139,15 @@ var FIREBASE_MODELS = [
         converter: "optionalFirestoreDate()",
         tsType: "Maybe<Date>",
         optional: true,
-        description: "The date the space was submitted, if it was. Its presence IS the lock."
+        description: "The date the CURRENT submission was made, if the space is submitted. Its presence IS the lock."
+      },
+      {
+        name: "fsat",
+        longName: "firstSubmittedAt",
+        converter: "optionalFirestoreDate()",
+        tsType: "Maybe<Date>",
+        optional: true,
+        description: "The date the space was FIRST submitted, if it ever was."
       },
       {
         name: "cpat",
@@ -2156,6 +2164,46 @@ var FIREBASE_MODELS = [
         tsType: "Maybe<Date>",
         optional: true,
         description: "The date this space becomes eligible for the expiration sweep, if it expires at all."
+      },
+      {
+        name: "lat",
+        longName: "locksAt",
+        converter: "optionalFirestoreDate()",
+        tsType: "Maybe<Date>",
+        optional: true,
+        description: "The date reopening stops being possible \u2014 the instant the submission becomes FULLY LOCKED."
+      },
+      {
+        name: "lby",
+        longName: "lockedBy",
+        converter: "optionalFirestoreUID()",
+        tsType: "Maybe<FirebaseAuthUserId>",
+        optional: true,
+        description: "The user who locked the submission early, when a caller did rather than the deadline passing."
+      },
+      {
+        name: "rc",
+        longName: "reopenCount",
+        converter: "firestoreNumber({ default: 0 })",
+        tsType: "number",
+        optional: false,
+        description: "Monotonic count of times this space has been REOPENED after a submission."
+      },
+      {
+        name: "rat",
+        longName: "reopenedAt",
+        converter: "optionalFirestoreDate()",
+        tsType: "Maybe<Date>",
+        optional: true,
+        description: "The date the space was last reopened, if it ever was."
+      },
+      {
+        name: "rby",
+        longName: "reopenedBy",
+        converter: "optionalFirestoreUID()",
+        tsType: "Maybe<FirebaseAuthUserId>",
+        optional: true,
+        description: "The user who last reopened the space."
       }
     ],
     enums: [
@@ -2212,7 +2260,7 @@ var FIREBASE_MODELS = [
         description: "Processing state of a submitted {@link FormSpace}."
       }
     ],
-    detectionHints: ["t", "n", "ps", "m", "uc", "f", "pn", "pat", "uat", "sat", "cpat", "eat"],
+    detectionHints: ["t", "n", "ps", "m", "uc", "f", "pn", "pat", "uat", "sat", "fsat", "cpat", "eat", "lat", "lby", "rc", "rat", "rby"],
     description: "A type-registered container for a client-side form: its in-progress JSON, its uploads, and its submission state.",
     modelGroup: "FormSpace",
     collectionKind: "root",
@@ -10121,6 +10169,7 @@ var PropertyAccumulator = class {
   constructor(context) {
     this.context = context;
   }
+  context;
   entries = [];
   index = /* @__PURE__ */ new Map();
   add(entry) {
@@ -21510,7 +21559,6 @@ import { DbxActionConfirmConfig } from '@dereekb/dbx-web';
 
 @Component({
   selector: 'app-danger-zone',
-  standalone: true,
   imports: [DbxCardBoxComponent, DbxBarDirective, DbxButtonComponent, DbxActionDirective, DbxActionConfirmDirective],
   template: \`
     <dbx-card-box header="Danger zone" icon="warning">
@@ -21527,8 +21575,7 @@ import { DbxActionConfirmConfig } from '@dereekb/dbx-web';
         </dbx-button>
       </dbx-bar>
     </dbx-card-box>
-  \`,
-  changeDetection: ChangeDetectionStrategy.OnPush
+  \`
 })
 export class DangerZoneComponent {
   readonly deleteAccountAction = /* DbxActionContextStoreSourceInstance<...> */ null;
@@ -21579,7 +21626,6 @@ interface Item {
 
 @Component({
   selector: 'app-items-page',
-  standalone: true,
   imports: [DbxSectionPageComponent, DbxListComponent, DbxListEmptyContentComponent, DbxPagebarComponent, DbxButtonComponent, DbxActionDirective],
   template: \`
     <dbx-section-page header="Items" icon="list" scroll="body">
@@ -21594,8 +21640,7 @@ interface Item {
         </dbx-list-empty-content>
       </dbx-list>
     </dbx-section-page>
-  \`,
-  changeDetection: ChangeDetectionStrategy.OnPush
+  \`
 })
 export class ItemsPageComponent {
   readonly items$: Observable<ListLoadingState<Item>> = /* ... */ null!;
@@ -21641,7 +21686,6 @@ interface Item {
 
 @Component({
   selector: 'app-items-loaded',
-  standalone: true,
   imports: [CommonModule, DbxLoadingComponent, DbxListComponent, DbxListEmptyContentComponent, DbxIntroActionSectionComponent],
   template: \`
     <dbx-loading [state]="state$ | async" text="Loading items...">
@@ -21657,8 +21701,7 @@ interface Item {
         </dbx-list>
       </dbx-intro-action-section>
     </dbx-loading>
-  \`,
-  changeDetection: ChangeDetectionStrategy.OnPush
+  \`
 })
 export class ItemsLoadedComponent {
   readonly state$: Observable<ListLoadingState<Item>> = /* ... */ null!;
@@ -21707,7 +21750,6 @@ import { MatInputModule } from '@angular/material/input';
 
 @Component({
   selector: 'app-account-settings',
-  standalone: true,
   imports: [DbxSectionComponent, DbxBarDirective, DbxButtonComponent, DbxButtonSpacerDirective, DbxActionDirective, ReactiveFormsModule, MatFormFieldModule, MatInputModule],
   template: \`
     <dbx-section header="Account" icon="person" hint="Update your profile">
@@ -21724,8 +21766,7 @@ import { MatInputModule } from '@angular/material/input';
         <dbx-button text="Cancel" stroked (btnClick)="cancel()"></dbx-button>
       </dbx-bar>
     </dbx-section>
-  \`,
-  changeDetection: ChangeDetectionStrategy.OnPush
+  \`
 })
 export class AccountSettingsComponent {
   private readonly fb = inject(FormBuilder);
@@ -21762,7 +21803,6 @@ import { UIRouterModule } from '@uirouter/angular';
 
 @Component({
   selector: 'app-shell',
-  standalone: true,
   imports: [DbxSidenavPageComponent, DbxSidenavComponent, DbxContentPageDirective, UIRouterModule],
   template: \`
     <dbx-sidenav-page>
@@ -21771,8 +21811,7 @@ import { UIRouterModule } from '@uirouter/angular';
         <ui-view></ui-view>
       </div>
     </dbx-sidenav-page>
-  \`,
-  changeDetection: ChangeDetectionStrategy.OnPush
+  \`
 })
 export class AppShellComponent {
   readonly navAnchors: ClickableAnchor[] = [
@@ -21823,7 +21862,6 @@ interface Member {
 
 @Component({
   selector: 'app-members-page',
-  standalone: true,
   imports: [CommonModule, MatButtonModule, MatIconModule, DbxSectionPageComponent, DbxTwoColumnComponent, DbxTwoColumnRightComponent, DbxListComponent],
   template: \`
     <dbx-section-page header="Members" icon="group" scroll="body">
@@ -21835,8 +21873,7 @@ interface Member {
         </dbx-two-column-right>
       </dbx-two-column>
     </dbx-section-page>
-  \`,
-  changeDetection: ChangeDetectionStrategy.OnPush
+  \`
 })
 export class MembersPageComponent {
   readonly members$: Observable<ListLoadingState<Member>> = /* ... */ null!;
@@ -25365,6 +25402,96 @@ var RULE_CATALOG = [
     whenItApplies: "When a key on `<app>SystemStateStoredDataConverterMap` is neither a local `<NAME>_SYSTEM_STATE_TYPE` constant nor an imported identifier.",
     whenItDoesNotApply: "Keys imported from upstream packages \u2014 those are detected via `importedIdentifiers` and skipped.",
     canonicalFix: "Either declare the missing constant locally or import it from the upstream package that owns it."
+  },
+  {
+    code: "WORKSPACE_DEPLOY_ENVIRONMENT_FILE_MISSING",
+    source: "dbx_workspace_validate",
+    severity: "error",
+    title: "A configuration's file-replacement or esbuild-config path does not exist on disk",
+    whatItFlags: "A configuration's file-replacement or esbuild-config path does not exist on disk.",
+    whenItApplies: "When a `fileReplacements` `replace` / `with` path, or a configuration's `esbuildConfig` path, names a file that is absent from the working tree.",
+    whenItDoesNotApply: "Generated files produced by an earlier target in the same pipeline \u2014 declare them as that target's `outputs` so the dependency is explicit, or the reference is genuinely broken.",
+    canonicalFix: "Create the missing file or correct the path. An Angular build fails loudly on a missing replacement, but an esbuild `additionalProperties: true` schema accepts a bad path silently."
+  },
+  {
+    code: "WORKSPACE_DEPLOY_ENVIRONMENT_FILE_UNREFERENCED",
+    source: "dbx_workspace_validate",
+    severity: "warning",
+    title: "An `environment.<name>.ts` file exists but no build configuration references it",
+    whatItFlags: "An `environment.<name>.ts` file exists but no build configuration references it.",
+    whenItApplies: "When a file matching `environment.*.ts` sits in a project's `src/environments/` directory and appears in no configuration's `fileReplacements`, and no `esbuildConfig` file references it.",
+    whenItDoesNotApply: "The base `environment.ts` (always the replacement source, never a target), and environment files imported directly by application code rather than swapped in by the build.",
+    canonicalFix: "Add the configuration that consumes it, or delete the file. An unreachable environment file reads as a working deploy lane that does not exist \u2014 the file is edited, reviewed, and never compiled."
+  },
+  {
+    code: "WORKSPACE_DEPLOY_HOSTING_TARGET_MISSING",
+    source: "dbx_workspace_validate",
+    severity: "error",
+    title: "A deploy command targets a firebase hosting target that `firebase.json` does not declare",
+    whatItFlags: "A deploy command targets a firebase hosting target that `firebase.json` does not declare.",
+    whenItApplies: "When a deploy command runs `firebase deploy --only hosting:<target>` and `<target>` matches no `target` (or `site`) entry under `hosting` in `firebase.json`.",
+    whenItDoesNotApply: "Workspaces that resolve hosting targets through `.firebaserc` target aliases the scanner does not read \u2014 verify manually if this misfires.",
+    canonicalFix: "Add the hosting entry to `firebase.json`, or point the command at a declared target. `firebase deploy` fails on an unknown hosting target, so this breaks the lane outright."
+  },
+  {
+    code: "WORKSPACE_DEPLOY_LANE_ASYMMETRIC",
+    source: "dbx_workspace_validate",
+    severity: "warning",
+    title: "A deploy lane is wired on one side of the app/api pair but not the other",
+    whatItFlags: "A deploy lane is wired on one side of the app/api pair but not the other.",
+    whenItApplies: "When one project in the workspace declares `ci-deploy-<lane>` and a sibling project that declares at least one other `ci-deploy-*` lane does not declare this one.",
+    whenItDoesNotApply: "Projects deliberately deployed on their own cadence, and workspaces with a single deployable project. Suppress by giving the sibling the lane, or accept the warning.",
+    canonicalFix: "Add the missing `ci-deploy-<lane>` target to the sibling project. A lane present on the API but not the web app (or vice versa) deploys half an application and leaves the two halves on different builds."
+  },
+  {
+    code: "WORKSPACE_DEPLOY_LANE_NO_ENVIRONMENT_SELECTION",
+    source: "dbx_workspace_validate",
+    severity: "error",
+    title: "A deploy lane builds a configuration that selects no environment file",
+    whatItFlags: "A deploy lane builds a configuration that selects no environment file.",
+    whenItApplies: "When a `ci-deploy-<lane>` target builds a configuration that provides no environment-selection mechanism for its executor \u2014 no `fileReplacements` for an Angular `application` build, or no lane-specific `esbuildConfig` for an `@nx/esbuild:esbuild` build.",
+    whenItDoesNotApply: "Non-deploy configurations such as `development`, which are expected to compile the base `environment.ts`. Only configurations reachable from a `ci-deploy-*` target are checked.",
+    canonicalFix: "Add the `fileReplacements` entry (or the lane's `esbuildConfig`) to the configuration. Without it the lane deploys the unreplaced `environment.ts` \u2014 localhost URLs, dev credentials, and any developer-only function map \u2014 to a live project."
+  },
+  {
+    code: "WORKSPACE_TARGET_OUTPUT_ESCAPES_ROOT",
+    source: "dbx_workspace_validate",
+    severity: "error",
+    title: "A target's `outputs` entry resolves outside the workspace root",
+    whatItFlags: "A target's `outputs` entry resolves outside the workspace root.",
+    whenItApplies: 'When an `outputs` entry \u2014 after `{options.<name>}` substitution from the target\'s own options \u2014 resolves to a path above the workspace root. The common shape is `outputs: ["{options.reportsDirectory}"]` with a `../../`-relative option value.',
+    whenItDoesNotApply: "Entries anchored by `{workspaceRoot}` or `{projectRoot}`, and entries whose `{options.<name>}` token has no resolvable value (skipped rather than guessed).",
+    canonicalFix: 'Anchor the entry explicitly, e.g. `"{workspaceRoot}/coverage/{projectRoot}"`. Nx refuses to cache an output it cannot place inside the workspace and will report the task as flaky instead of failing loudly.'
+  },
+  {
+    code: "WORKSPACE_TARGET_REF_CONFIGURATION_MISSING",
+    source: "dbx_workspace_validate",
+    severity: "error",
+    title: "An `nx run <project>:<target>:<configuration>` reference names a configuration the target does not declare",
+    whatItFlags: "An `nx run <project>:<target>:<configuration>` reference names a configuration the target does not declare.",
+    whenItApplies: "Whenever a reference carries a configuration segment and the target's `configurations` map has no such key.",
+    whenItDoesNotApply: "Targets that declare no `configurations` at all \u2014 Nx tolerates a configuration argument there, so it is not reported.",
+    canonicalFix: "Rename the reference to a declared configuration (a `prod` / `production` mismatch is the usual cause), or add the configuration to the target. Nx does NOT error on an unknown configuration: `create-task-graph.js` silently substitutes `defaultConfiguration`, so a mismatch here ships whatever that default builds \u2014 and ships the base options with no configuration merged at all when no default is set."
+  },
+  {
+    code: "WORKSPACE_TARGET_REF_PROJECT_MISSING",
+    source: "dbx_workspace_validate",
+    severity: "error",
+    title: "An `nx run <project>:...` reference names a project that does not exist in the workspace",
+    whatItFlags: "An `nx run <project>:...` reference names a project that does not exist in the workspace.",
+    whenItApplies: "When a target reference in a `project.json` command, CI config, shell script, or npm script names a project with no matching entry in the workspace project graph.",
+    whenItDoesNotApply: "References built from shell variables or CI interpolation the scanner cannot resolve \u2014 those are skipped rather than reported.",
+    canonicalFix: "Create the project, or update the reference to the project's real name. A renamed or deleted project leaves these references behind and they only fail at deploy time."
+  },
+  {
+    code: "WORKSPACE_TARGET_REF_TARGET_MISSING",
+    source: "dbx_workspace_validate",
+    severity: "error",
+    title: "An `nx run <project>:<target>` reference names a target the project does not declare",
+    whatItFlags: "An `nx run <project>:<target>` reference names a target the project does not declare.",
+    whenItApplies: "When the referenced project exists but has no target by that name (after `nx.json` `targetDefaults` are accounted for).",
+    whenItDoesNotApply: "Targets contributed by an inferred-target plugin the scanner does not evaluate \u2014 declare the plugin's targets explicitly if this misfires.",
+    canonicalFix: "Add the target to the project, or point the reference at an existing one. This is the single most common way a CI lane silently stops doing anything."
   }
 ];
 
@@ -38745,11 +38872,12 @@ function matchKindForRadius(exact, raw) {
   if (exact.defaults.light === raw || exact.defaults.dark === raw) return "(exact-match design-system corner token).";
   return "(idiomatic full / pill radius \u2014 design system token).";
 }
-function findExactRoleToken(registry, raw, role) {
+function findExactRoleToken(params) {
+  const { registry, raw, role, isAllowed } = params;
   const candidates = registry.byRole.get(role) ?? [];
   let result;
   for (const entry of candidates) {
-    if (entry.defaults.light === raw || entry.defaults.dark === raw) {
+    if ((entry.defaults.light === raw || entry.defaults.dark === raw) && (isAllowed === void 0 || isAllowed(entry))) {
       result = entry;
       break;
     }
@@ -38894,7 +39022,7 @@ var hardcodedRadius = (input) => {
     const colonIndex = input.scss.indexOf(":", match.index);
     if (colonIndex !== -1 && isInsideScssVarDeclaration(input.scss, colonIndex)) continue;
     const raw = match[1];
-    let exact = findExactRoleToken(input.tokenRegistry, raw, "radius");
+    let exact = findExactRoleToken({ registry: input.tokenRegistry, raw, role: "radius" });
     if (exact === void 0 && FULL_RADIUS_SYNONYMS.has(raw)) {
       exact = input.tokenRegistry.findByCssVariable("--mat-sys-corner-full");
     }
@@ -38925,7 +39053,7 @@ var hardcodedShadow = (input) => {
     if (match.index === void 0) continue;
     const raw = match[1].trim();
     if (raw.startsWith("var(") || raw === "none") continue;
-    const exact = findExactRoleToken(input.tokenRegistry, raw, "elevation");
+    const exact = findExactRoleToken({ registry: input.tokenRegistry, raw, role: "elevation" });
     const fix = exact === void 0 ? 'Hardcoded `box-shadow:` declarations should map to one of the `--mat-sys-level0..5` elevation tokens, or wrap the surface in `<dbx-content-box [elevate]="true">` so the shadow comes from the design system.' : `Replace this hardcoded shadow with \`box-shadow: var(${exact.cssVariable})\` or use \`<dbx-content-box [elevate]="true">\` to apply the elevation through the wrapper component.`;
     matches.push({
       id: "hardcoded-shadow",
@@ -38970,12 +39098,13 @@ var hardcodedHintColor = (input) => {
   return matches;
 };
 var HARDCODED_PADDING_RE = /(?:padding|margin)\s*(?:-(?:top|right|bottom|left))?\s*:\s*(\d+(?:\.\d+)?px)(?!\s*\))/gi;
+var DBX_PADDING_SCALE_RE = /^--dbx-padding-\d+$/;
 var hardcodedPadding = (input) => {
   const matches = [];
   for (const match of input.scss.matchAll(HARDCODED_PADDING_RE)) {
     if (match.index === void 0) continue;
     const raw = match[1];
-    const exact = findExactRoleToken(input.tokenRegistry, raw, "spacing");
+    const exact = findExactRoleToken({ registry: input.tokenRegistry, raw, role: "spacing", isAllowed: (entry) => DBX_PADDING_SCALE_RE.test(entry.cssVariable) });
     if (exact !== void 0) {
       const utility = exact.utilityClasses?.[0];
       const fix = ["Replace `" + match[0].trim() + "` with `var(" + exact.cssVariable + ")`" + (utility === void 0 ? "" : ` (or use the \`${utility}\` utility class on the host element)`) + "."].join("\n");
@@ -45205,8 +45334,7 @@ import { type Work } from '@dereekb/rxjs';
         dbxActionForm
         [dbxFormSource]="settings$"></my-settings-form>
     </div>
-  \`,
-  standalone: true
+  \`
 })
 export class SettingsAutosaveComponent {
   private readonly store = inject(SettingsDocumentStore);
@@ -45250,8 +45378,7 @@ import { type Work } from '@dereekb/rxjs';
         icon="delete"
         dbxActionButton></dbx-button>
     </ng-container>
-  \`,
-  standalone: true
+  \`
 })
 export class DeleteAccountButtonComponent {
   private readonly accountStore = inject(AccountDocumentStore);
@@ -45315,8 +45442,7 @@ import { type Work } from '@dereekb/rxjs';
         <dbx-button text="Archive" dbxActionButton></dbx-button>
       </ng-container>
     </div>
-  \`,
-  standalone: true
+  \`
 })
 export class ContentToolbarComponent {
   private readonly store = inject(ArticleDocumentStore);
@@ -45370,8 +45496,7 @@ import { type WorkUsingContext } from '@dereekb/rxjs';
       <dbx-button [raised]="true" text="Save" dbxActionButton></dbx-button>
       <dbx-error dbxActionError></dbx-error>
     </form>
-  \`,
-  standalone: true
+  \`
 })
 export class EditProfilePageComponent {
   private readonly profileStore = inject(ProfileDocumentStore);
@@ -45441,8 +45566,7 @@ type ConsentDecision = { readonly outcome: 'approved'; readonly value: ConsentFo
         }
       </div>
     }
-  \`,
-  standalone: true
+  \`
 })
 export class ConsentPageComponent {
   readonly defaults$ = this.store.defaults$;
@@ -45489,8 +45613,7 @@ import { DbxActionContextMachine } from '@dereekb/dbx-core';
     <div [dbxActionSource]="actionSource()">
       <child-component></child-component>
     </div>
-  \`,
-  standalone: true
+  \`
 })
 export class ParentComponent {
   readonly machine = new DbxActionContextMachine<MyValue, MyResult>();
@@ -45510,8 +45633,7 @@ export class ParentComponent {
     <ng-container dbxAction dbxActionValue="hello">
       <dbx-button [raised]="true" text="Submit" dbxActionButton></dbx-button>
     </ng-container>
-  \`,
-  standalone: true
+  \`
 })
 export class ChildComponent {}`
   },
@@ -45554,8 +45676,7 @@ import { type IsEqualFunction } from '@dereekb/rxjs';
       <my-tag-form #form></my-tag-form>
       <dbx-button text="Save" dbxActionButton></dbx-button>
     </div>
-  \`,
-  standalone: true
+  \`
 })
 export class TagEditorComponent {
   private readonly store = inject(TagCollectionStore);
@@ -52884,7 +53005,7 @@ function relativeOrAbsolute(from, target) {
   const rel = relative20(from, target);
   if (rel.length === 0) return ".";
   if (rel.startsWith("..")) return target;
-  return rel.split("\\").join("/");
+  return rel.replaceAll("\\", "/");
 }
 
 // packages/dbx-components-mcp/src/tools/mcp-config/init.ts
@@ -53013,19 +53134,19 @@ async function planRootConfig(input) {
 }
 function defaultOutFor(input) {
   const targetAbs = resolve66(input.snapshot.workspaceRoot, ".tmp/dbx-mcp", `${input.slug}.${clusterFilenameSegment(input.cluster)}.json`);
-  return relative21(dirname22(input.scanConfigPath), targetAbs).split("\\").join("/");
+  return relative21(dirname22(input.scanConfigPath), targetAbs).replaceAll("\\", "/");
 }
 function resolveScanOut(scanConfigPath, out) {
   return resolve66(dirname22(scanConfigPath), out);
 }
 function relativeFromConfig(snapshot, absolute) {
   const configDir = snapshot.configPath === null ? snapshot.workspaceRoot : dirname22(snapshot.configPath);
-  return relative21(configDir, absolute).split("\\").join("/");
+  return relative21(configDir, absolute).replaceAll("\\", "/");
 }
 function workspaceRel(workspaceRoot, absolute) {
   const rel = relative21(workspaceRoot, absolute);
   if (rel.length === 0) return ".";
-  return rel.split("\\").join("/");
+  return rel.replaceAll("\\", "/");
 }
 function serializeJson(value) {
   return `${JSON.stringify(value, null, 2)}

package/generated/dereekb-date.utils.mcp.generated.json

@@ -22,7 +22,7 @@
           "optional": false
         }
       ],
-      "returns": "A factory function that produces a clamped {@link DateCellRangeWithRange } from optional start/end input.",
+      "returns": "A factory function that produces a clamped {@link DateCellRangeWithRange} from optional start/end input.",
       "tags": [
         "date",
         "cell",
@@ -55,7 +55,7 @@
         {
           "name": "config",
           "type": "DateCellTiming | DateCallIndexRangeFromDatesFactoryConfig",
-          "description": "- A {@link DateCellTiming } or full factory configuration.",
+          "description": "- A {@link DateCellTiming} or full factory configuration.",
           "optional": false
         },
         {
@@ -65,7 +65,7 @@
           "optional": true
         }
       ],
-      "returns": "A clamped {@link DateCellRangeWithRange } derived from the timing and input.",
+      "returns": "A clamped {@link DateCellRangeWithRange} derived from the timing and input.",
       "tags": [
         "date",
         "cell",
@@ -104,7 +104,7 @@
           "optional": true
         }
       ],
-      "returns": "A {@link DateCellRangeWithRange } covering only the completed day indexes.",
+      "returns": "A {@link DateCellRangeWithRange} covering only the completed day indexes.",
       "tags": [
         "date",
         "cell",
@@ -177,7 +177,7 @@
           "optional": false
         }
       ],
-      "returns": "A {@link DateCellIndexRange } with exclusive `maxIndex`.",
+      "returns": "A {@link DateCellIndexRange} with exclusive `maxIndex`.",
       "tags": [
         "date",
         "cell",
@@ -212,7 +212,7 @@
           "optional": false
         }
       ],
-      "returns": "A {@link DateCellRangeWithRange } with inclusive `to`.",
+      "returns": "A {@link DateCellRangeWithRange} with inclusive `to`.",
       "tags": [
         "date",
         "cell",
@@ -259,7 +259,7 @@
           "optional": true
         }
       ],
-      "returns": "A {@link DateCellIndexRange } representing the computed index bounds.",
+      "returns": "A {@link DateCellIndexRange} representing the computed index bounds.",
       "tags": [
         "date",
         "cell",
@@ -365,7 +365,7 @@
           "optional": false
         }
       ],
-      "returns": "A factory function that expands date cell blocks into {@link DateCellDurationSpan } arrays.",
+      "returns": "A factory function that expands date cell blocks into {@link DateCellDurationSpan} arrays.",
       "tags": [
         "date",
         "cell",
@@ -401,7 +401,7 @@
           "optional": false
         }
       ],
-      "returns": "A factory that computes {@link DateCellDayTimingInfo } for any date or day index.",
+      "returns": "A factory that computes {@link DateCellDayTimingInfo} for any date or day index.",
       "tags": [
         "date",
         "cell",
@@ -438,7 +438,7 @@
           "optional": false
         }
       ],
-      "returns": "True if the input is a {@link DateCellTimingRelativeIndexFactory }.",
+      "returns": "True if the input is a {@link DateCellTimingRelativeIndexFactory}.",
       "tags": [
         "date",
         "cell",
@@ -810,7 +810,7 @@
           "optional": false
         }
       ],
-      "returns": "A new {@link FullDateCellTiming } with the requested aspects replaced.",
+      "returns": "A new {@link FullDateCellTiming} with the requested aspects replaced.",
       "tags": [
         "date",
         "cell",

package/generated/dereekb-dbx-form.forge-fields.mcp.generated.json

@@ -1773,8 +1773,8 @@
           "required": false
         },
         {
-          "name": "description",
-          "type": "string",
+          "name": "hint",
+          "type": "DynamicText",
           "description": "",
           "required": false
         },

package/generated/dereekb-dbx-web.ui-components.mcp.generated.json

@@ -108,12 +108,6 @@
           "description": "",
           "required": false
         },
-        {
-          "name": "customButtonColor",
-          "type": "Maybe<string>",
-          "description": "",
-          "required": false
-        },
         {
           "name": "customTextColor",
           "type": "Maybe<string>",

package/generated/dereekb-demo.dbx-docs-ui-examples.mcp.generated.json

@@ -31,7 +31,7 @@
           "className": "DocActionFormWithSecondaryFormComponent",
           "role": "form",
           "selector": "doc-action-form-with-secondary-form",
-          "classSource": "@Component({\n  template: DBX_FORGE_FORM_COMPONENT_TEMPLATE,\n  selector: 'doc-action-form-with-secondary-form',\n  providers: dbxForgeFormComponentProviders(),\n  standalone: true,\n  imports: [DbxForgeFormComponentImportsModule],\n  changeDetection: ChangeDetectionStrategy.OnPush\n})\nexport class DocActionFormWithSecondaryFormComponent extends AbstractSyncForgeFormDirective<DocActionFormWithSecondaryFormValue> {\n  readonly formConfig: FormConfig = {\n    fields: [\n      dbxForgeTextField({\n        key: 'reason',\n        label: 'Reason',\n        required: true,\n        description: 'The Approve handler receives this value via dbxActionForm. Type something to enable Approve.'\n      })\n    ]\n  } as FormConfig;\n}"
+          "classSource": "@Component({\n  template: DBX_FORGE_FORM_COMPONENT_TEMPLATE,\n  selector: 'doc-action-form-with-secondary-form',\n  providers: dbxForgeFormComponentProviders(),\n  imports: [DbxForgeFormComponentImportsModule]\n})\nexport class DocActionFormWithSecondaryFormComponent extends AbstractSyncForgeFormDirective<DocActionFormWithSecondaryFormValue> {\n  readonly formConfig: FormConfig = {\n    fields: [\n      dbxForgeTextField({\n        key: 'reason',\n        label: 'Reason',\n        required: true,\n        hint: 'The Approve handler receives this value via dbxActionForm. Type something to enable Approve.'\n      })\n    ]\n  } as FormConfig;\n}"
         },
         {
           "kind": "interface",
@@ -72,21 +72,21 @@
           "className": "DocManualActionsItemListComponent",
           "role": "list",
           "selector": "doc-manual-actions-item-list",
-          "classSource": "@Component({\n  selector: 'doc-manual-actions-item-list',\n  template: DEFAULT_LIST_WRAPPER_COMPONENT_CONFIGURATION_TEMPLATE,\n  imports: [DbxListWrapperComponentImportsModule],\n  host: {\n    class: 'dbx-list-auto-height dbx-list-no-hover-effects dbx-list-no-item-padding'\n  },\n  changeDetection: ChangeDetectionStrategy.OnPush,\n  standalone: true\n})\nexport class DocManualActionsItemListComponent extends AbstractDbxSelectionListWrapperDirective<ManualActionItemValue> {\n  constructor() {\n    super({\n      componentClass: DocManualActionsItemListViewComponent,\n      defaultSelectionMode: 'view'\n    });\n  }\n}"
+          "classSource": "@Component({\n  selector: 'doc-manual-actions-item-list',\n  template: DEFAULT_LIST_WRAPPER_COMPONENT_CONFIGURATION_TEMPLATE,\n  imports: [DbxListWrapperComponentImportsModule],\n  host: {\n    class: 'dbx-list-auto-height dbx-list-no-hover-effects dbx-list-no-item-padding'\n  }\n})\nexport class DocManualActionsItemListComponent extends AbstractDbxSelectionListWrapperDirective<ManualActionItemValue> {\n  constructor() {\n    super({\n      componentClass: DocManualActionsItemListViewComponent,\n      defaultSelectionMode: 'view'\n    });\n  }\n}"
         },
         {
           "kind": "component",
           "className": "DocManualActionsItemListViewComponent",
           "role": "view",
           "selector": "doc-manual-actions-item-list-view",
-          "classSource": "@Component({\n  selector: 'doc-manual-actions-item-list-view',\n  template: DEFAULT_DBX_SELECTION_VALUE_LIST_COMPONENT_CONFIGURATION_TEMPLATE,\n  imports: [DbxSelectionValueListViewComponentImportsModule],\n  providers: provideDbxListView(DocManualActionsItemListViewComponent),\n  host: {\n    class: 'dbx-list-item-p0'\n  },\n  changeDetection: ChangeDetectionStrategy.OnPush,\n  standalone: true\n})\nexport class DocManualActionsItemListViewComponent extends AbstractDbxSelectionListViewDirective<ManualActionItemValue> {\n  // Drop `icon` (rows render no tile) and `anchor` (button owns it; row stays non-clickable).\n  readonly config: DbxSelectionValueListViewConfig<ManualActionItemValueWithSelection> = {\n    componentClass: DocManualActionsItemListViewItemComponent,\n    mapValuesToItemValues: (values) => of(values.map((value) => ({ ...value, itemValue: value, icon: undefined, anchor: undefined })))\n  };\n}"
+          "classSource": "@Component({\n  selector: 'doc-manual-actions-item-list-view',\n  template: DEFAULT_DBX_SELECTION_VALUE_LIST_COMPONENT_CONFIGURATION_TEMPLATE,\n  imports: [DbxSelectionValueListViewComponentImportsModule],\n  providers: provideDbxListView(DocManualActionsItemListViewComponent),\n  host: {\n    class: 'dbx-list-item-p0'\n  }\n})\nexport class DocManualActionsItemListViewComponent extends AbstractDbxSelectionListViewDirective<ManualActionItemValue> {\n  // Drop `icon` (rows render no tile) and `anchor` (button owns it; row stays non-clickable).\n  readonly config: DbxSelectionValueListViewConfig<ManualActionItemValueWithSelection> = {\n    componentClass: DocManualActionsItemListViewItemComponent,\n    mapValuesToItemValues: (values) => of(values.map((value) => ({ ...value, itemValue: value, icon: undefined, anchor: undefined })))\n  };\n}"
         },
         {
           "kind": "component",
           "className": "DocManualActionsItemListViewItemComponent",
           "role": "item",
           "selector": "doc-manual-actions-item-list-view-item",
-          "classSource": "@Component({\n  selector: 'doc-manual-actions-item-list-view-item',\n  template: `\n    <div class=\"dbx-list-item-padded dbx-list-two-line-item\">\n      <div class=\"item-left\">\n        <span class=\"dbx-text-title-medium\">{{ title }}</span>\n        <span class=\"item-details\">{{ detail }}</span>\n      </div>\n      <div class=\"item-right\">\n        <dbx-anchor [anchor]=\"anchor\">\n          @if (buttonRaised) {\n            <dbx-button [raised]=\"true\" color=\"primary\" class=\"dbx-nowrap\" [text]=\"buttonText\"></dbx-button>\n          } @else {\n            <dbx-button [stroked]=\"true\" class=\"dbx-nowrap\" [text]=\"buttonText\"></dbx-button>\n          }\n        </dbx-anchor>\n      </div>\n    </div>\n  `,\n  imports: [MatButtonModule, DbxButtonComponent, DbxAnchorComponent],\n  changeDetection: ChangeDetectionStrategy.OnPush,\n  standalone: true\n})\nexport class DocManualActionsItemListViewItemComponent extends AbstractDbxValueListViewItemComponent<ManualActionItemValue> {\n  get title(): string {\n    return this.itemValue.title;\n  }\n\n  get detail(): string {\n    return this.itemValue.detail;\n  }\n\n  get buttonText(): string {\n    return this.itemValue.buttonText;\n  }\n\n  get buttonRaised(): Maybe<boolean> {\n    return this.itemValue.buttonRaised;\n  }\n\n  get anchor(): Maybe<ClickableAnchor> {\n    return this.itemValue.anchor;\n  }\n}"
+          "classSource": "@Component({\n  selector: 'doc-manual-actions-item-list-view-item',\n  template: `\n    <div class=\"dbx-list-item-padded dbx-list-two-line-item\">\n      <div class=\"item-left\">\n        <span class=\"dbx-text-title-medium\">{{ title }}</span>\n        <span class=\"item-details\">{{ detail }}</span>\n      </div>\n      <div class=\"item-right\">\n        <dbx-anchor [anchor]=\"anchor\">\n          @if (buttonRaised) {\n            <dbx-button [raised]=\"true\" color=\"primary\" class=\"dbx-nowrap\" [text]=\"buttonText\"></dbx-button>\n          } @else {\n            <dbx-button [stroked]=\"true\" class=\"dbx-nowrap\" [text]=\"buttonText\"></dbx-button>\n          }\n        </dbx-anchor>\n      </div>\n    </div>\n  `,\n  imports: [MatButtonModule, DbxButtonComponent, DbxAnchorComponent]\n})\nexport class DocManualActionsItemListViewItemComponent extends AbstractDbxValueListViewItemComponent<ManualActionItemValue> {\n  get title(): string {\n    return this.itemValue.title;\n  }\n\n  get detail(): string {\n    return this.itemValue.detail;\n  }\n\n  get buttonText(): string {\n    return this.itemValue.buttonText;\n  }\n\n  get buttonRaised(): Maybe<boolean> {\n    return this.itemValue.buttonRaised;\n  }\n\n  get anchor(): Maybe<ClickableAnchor> {\n    return this.itemValue.anchor;\n  }\n}"
         },
         {
           "kind": "interface",
@@ -128,21 +128,21 @@
           "className": "DocWorthKnowingItemListComponent",
           "role": "list",
           "selector": "doc-worth-knowing-item-list",
-          "classSource": "@Component({\n  selector: 'doc-worth-knowing-item-list',\n  template: DEFAULT_LIST_WRAPPER_COMPONENT_CONFIGURATION_TEMPLATE,\n  imports: [DbxListWrapperComponentImportsModule],\n  host: {\n    class: 'dbx-list-no-hover-effects dbx-list-no-item-padding'\n  },\n  changeDetection: ChangeDetectionStrategy.OnPush,\n  standalone: true\n})\nexport class DocWorthKnowingItemListComponent extends AbstractDbxSelectionListWrapperDirective<WorthKnowingItemValue> {\n  constructor() {\n    super({\n      componentClass: DocWorthKnowingItemListViewComponent,\n      defaultSelectionMode: 'view'\n    });\n  }\n}"
+          "classSource": "@Component({\n  selector: 'doc-worth-knowing-item-list',\n  template: DEFAULT_LIST_WRAPPER_COMPONENT_CONFIGURATION_TEMPLATE,\n  imports: [DbxListWrapperComponentImportsModule],\n  host: {\n    class: 'dbx-list-no-hover-effects dbx-list-no-item-padding'\n  }\n})\nexport class DocWorthKnowingItemListComponent extends AbstractDbxSelectionListWrapperDirective<WorthKnowingItemValue> {\n  constructor() {\n    super({\n      componentClass: DocWorthKnowingItemListViewComponent,\n      defaultSelectionMode: 'view'\n    });\n  }\n}"
         },
         {
           "kind": "component",
           "className": "DocWorthKnowingItemListViewComponent",
           "role": "view",
           "selector": "doc-worth-knowing-item-list-view",
-          "classSource": "@Component({\n  selector: 'doc-worth-knowing-item-list-view',\n  template: DEFAULT_DBX_SELECTION_VALUE_LIST_COMPONENT_CONFIGURATION_TEMPLATE,\n  imports: [DbxSelectionValueListViewComponentImportsModule],\n  providers: provideDbxListView(DocWorthKnowingItemListViewComponent),\n  host: {\n    class: 'dbx-list-item-p0'\n  },\n  changeDetection: ChangeDetectionStrategy.OnPush,\n  standalone: true\n})\nexport class DocWorthKnowingItemListViewComponent extends AbstractDbxSelectionListViewDirective<WorthKnowingItemValue> {\n  // Drop `icon` (template paints its own tile) and `anchor` (button owns it; row stays non-clickable).\n  readonly config: DbxSelectionValueListViewConfig<WorthKnowingItemValueWithSelection> = {\n    componentClass: DocWorthKnowingItemListViewItemComponent,\n    mapValuesToItemValues: (values) => of(values.map((value) => ({ ...value, itemValue: value, icon: undefined, anchor: undefined })))\n  };\n}"
+          "classSource": "@Component({\n  selector: 'doc-worth-knowing-item-list-view',\n  template: DEFAULT_DBX_SELECTION_VALUE_LIST_COMPONENT_CONFIGURATION_TEMPLATE,\n  imports: [DbxSelectionValueListViewComponentImportsModule],\n  providers: provideDbxListView(DocWorthKnowingItemListViewComponent),\n  host: {\n    class: 'dbx-list-item-p0'\n  }\n})\nexport class DocWorthKnowingItemListViewComponent extends AbstractDbxSelectionListViewDirective<WorthKnowingItemValue> {\n  // Drop `icon` (template paints its own tile) and `anchor` (button owns it; row stays non-clickable).\n  readonly config: DbxSelectionValueListViewConfig<WorthKnowingItemValueWithSelection> = {\n    componentClass: DocWorthKnowingItemListViewItemComponent,\n    mapValuesToItemValues: (values) => of(values.map((value) => ({ ...value, itemValue: value, icon: undefined, anchor: undefined })))\n  };\n}"
         },
         {
           "kind": "component",
           "className": "DocWorthKnowingItemListViewItemComponent",
           "role": "item",
           "selector": "doc-worth-knowing-item-list-view-item",
-          "classSource": "@Component({\n  selector: 'doc-worth-knowing-item-list-view-item',\n  template: `\n    <div class=\"dbx-list-item-padded dbx-list-two-line-item dbx-list-two-line-item-with-icon\">\n      <dbx-icon-tile class=\"item-icon\" [icon]=\"icon\" dbxColor=\"primary\" [dbxColorTone]=\"18\"></dbx-icon-tile>\n      <div class=\"item-left\">\n        <span class=\"dbx-text-title-medium\">{{ title }}</span>\n        <span class=\"item-details\">{{ detail }}</span>\n      </div>\n      @if (buttonText) {\n        <div class=\"item-right\">\n          <dbx-anchor [anchor]=\"anchor\">\n            <dbx-button [stroked]=\"true\" class=\"dbx-nowrap\" [text]=\"buttonText\"></dbx-button>\n          </dbx-anchor>\n        </div>\n      }\n    </div>\n  `,\n  imports: [MatButtonModule, DbxColorDirective, DbxIconTileComponent, DbxButtonComponent, DbxAnchorComponent],\n  changeDetection: ChangeDetectionStrategy.OnPush,\n  standalone: true\n})\nexport class DocWorthKnowingItemListViewItemComponent extends AbstractDbxValueListViewItemComponent<WorthKnowingItemValue> {\n  get icon(): string {\n    return this.itemValue.icon;\n  }\n\n  get title(): string {\n    return this.itemValue.title;\n  }\n\n  get detail(): string {\n    return this.itemValue.detail;\n  }\n\n  get buttonText(): Maybe<string> {\n    return this.itemValue.buttonText;\n  }\n\n  get anchor(): Maybe<ClickableAnchor> {\n    return this.itemValue.anchor;\n  }\n}"
+          "classSource": "@Component({\n  selector: 'doc-worth-knowing-item-list-view-item',\n  template: `\n    <div class=\"dbx-list-item-padded dbx-list-two-line-item dbx-list-two-line-item-with-icon\">\n      <dbx-icon-tile class=\"item-icon\" [icon]=\"icon\" dbxColor=\"primary\" [dbxColorTone]=\"18\"></dbx-icon-tile>\n      <div class=\"item-left\">\n        <span class=\"dbx-text-title-medium\">{{ title }}</span>\n        <span class=\"item-details\">{{ detail }}</span>\n      </div>\n      @if (buttonText) {\n        <div class=\"item-right\">\n          <dbx-anchor [anchor]=\"anchor\">\n            <dbx-button [stroked]=\"true\" class=\"dbx-nowrap\" [text]=\"buttonText\"></dbx-button>\n          </dbx-anchor>\n        </div>\n      }\n    </div>\n  `,\n  imports: [MatButtonModule, DbxColorDirective, DbxIconTileComponent, DbxButtonComponent, DbxAnchorComponent]\n})\nexport class DocWorthKnowingItemListViewItemComponent extends AbstractDbxValueListViewItemComponent<WorthKnowingItemValue> {\n  get icon(): string {\n    return this.itemValue.icon;\n  }\n\n  get title(): string {\n    return this.itemValue.title;\n  }\n\n  get detail(): string {\n    return this.itemValue.detail;\n  }\n\n  get buttonText(): Maybe<string> {\n    return this.itemValue.buttonText;\n  }\n\n  get anchor(): Maybe<ClickableAnchor> {\n    return this.itemValue.anchor;\n  }\n}"
         },
         {
           "kind": "interface",
@@ -241,21 +241,21 @@
           "className": "DocAnchorButtonItemListComponent",
           "role": "list",
           "selector": "doc-anchor-button-item-list",
-          "classSource": "@Component({\n  selector: 'doc-anchor-button-item-list',\n  template: DEFAULT_LIST_WRAPPER_COMPONENT_CONFIGURATION_TEMPLATE,\n  imports: [DbxListWrapperComponentImportsModule],\n  host: {\n    class: 'dbx-list-no-hover-effects dbx-list-card-items-list'\n  },\n  changeDetection: ChangeDetectionStrategy.OnPush,\n  standalone: true\n})\nexport class DocAnchorButtonItemListComponent extends AbstractDbxSelectionListWrapperDirective<AnchorButtonItemValue> {\n  constructor() {\n    super({\n      componentClass: DocAnchorButtonItemListViewComponent,\n      defaultSelectionMode: 'view'\n    });\n  }\n}"
+          "classSource": "@Component({\n  selector: 'doc-anchor-button-item-list',\n  template: DEFAULT_LIST_WRAPPER_COMPONENT_CONFIGURATION_TEMPLATE,\n  imports: [DbxListWrapperComponentImportsModule],\n  host: {\n    class: 'dbx-list-no-hover-effects dbx-list-card-items-list'\n  }\n})\nexport class DocAnchorButtonItemListComponent extends AbstractDbxSelectionListWrapperDirective<AnchorButtonItemValue> {\n  constructor() {\n    super({\n      componentClass: DocAnchorButtonItemListViewComponent,\n      defaultSelectionMode: 'view'\n    });\n  }\n}"
         },
         {
           "kind": "component",
           "className": "DocAnchorButtonItemListViewComponent",
           "role": "view",
           "selector": "doc-anchor-button-item-list-view",
-          "classSource": "@Component({\n  selector: 'doc-anchor-button-item-list-view',\n  template: DEFAULT_DBX_SELECTION_VALUE_LIST_COMPONENT_CONFIGURATION_TEMPLATE,\n  imports: [DbxSelectionValueListViewComponentImportsModule],\n  providers: provideDbxListView(DocAnchorButtonItemListViewComponent),\n  host: {\n    class: 'dbx-list-item-p0'\n  },\n  changeDetection: ChangeDetectionStrategy.OnPush,\n  standalone: true\n})\nexport class DocAnchorButtonItemListViewComponent extends AbstractDbxSelectionListViewDirective<AnchorButtonItemValue> {\n  // Drop `icon` (template paints its own tile) and `anchor` (button owns it; row stays non-clickable).\n  readonly config: DbxSelectionValueListViewConfig<AnchorButtonItemValueWithSelection> = {\n    componentClass: DocAnchorButtonItemListViewItemComponent,\n    mapValuesToItemValues: (values) => of(values.map((value) => ({ ...value, itemValue: value, icon: undefined, anchor: undefined })))\n  };\n}"
+          "classSource": "@Component({\n  selector: 'doc-anchor-button-item-list-view',\n  template: DEFAULT_DBX_SELECTION_VALUE_LIST_COMPONENT_CONFIGURATION_TEMPLATE,\n  imports: [DbxSelectionValueListViewComponentImportsModule],\n  providers: provideDbxListView(DocAnchorButtonItemListViewComponent),\n  host: {\n    class: 'dbx-list-item-p0'\n  }\n})\nexport class DocAnchorButtonItemListViewComponent extends AbstractDbxSelectionListViewDirective<AnchorButtonItemValue> {\n  // Drop `icon` (template paints its own tile) and `anchor` (button owns it; row stays non-clickable).\n  readonly config: DbxSelectionValueListViewConfig<AnchorButtonItemValueWithSelection> = {\n    componentClass: DocAnchorButtonItemListViewItemComponent,\n    mapValuesToItemValues: (values) => of(values.map((value) => ({ ...value, itemValue: value, icon: undefined, anchor: undefined })))\n  };\n}"
         },
         {
           "kind": "component",
           "className": "DocAnchorButtonItemListViewItemComponent",
           "role": "item",
           "selector": "doc-anchor-button-item-list-view-item",
-          "classSource": "@Component({\n  selector: 'doc-anchor-button-item-list-view-item',\n  template: `\n    <div class=\"dbx-list-item-padded-thick dbx-list-two-line-item dbx-list-two-line-item-with-icon\">\n      <dbx-icon-tile class=\"item-icon\" [icon]=\"icon\" dbxColor=\"primary\" [dbxColorTone]=\"18\"></dbx-icon-tile>\n      <div class=\"item-left\">\n        <span class=\"dbx-text-title-medium dbx-pb1\">{{ title }}</span>\n        <span class=\"item-details dbx-pb2\">{{ progress }} of {{ total }} complete</span>\n        <mat-progress-bar mode=\"determinate\" [value]=\"progressPercent\"></mat-progress-bar>\n      </div>\n      <div class=\"item-right\">\n        <dbx-anchor [anchor]=\"anchor\">\n          <button mat-flat-button>{{ buttonText }}</button>\n        </dbx-anchor>\n      </div>\n    </div>\n  `,\n  imports: [MatButtonModule, MatProgressBar, DbxColorDirective, DbxIconTileComponent, DbxAnchorComponent],\n  changeDetection: ChangeDetectionStrategy.OnPush,\n  standalone: true\n})\nexport class DocAnchorButtonItemListViewItemComponent extends AbstractDbxValueListViewItemComponent<AnchorButtonItemValue> {\n  get icon(): string {\n    return this.itemValue.icon;\n  }\n\n  get title(): string {\n    return this.itemValue.title;\n  }\n\n  get progress(): number {\n    return this.itemValue.progress;\n  }\n\n  get total(): number {\n    return this.itemValue.total;\n  }\n\n  get buttonText(): string {\n    return this.itemValue.buttonText;\n  }\n\n  get anchor(): ClickableAnchor {\n    return this.itemValue.anchor;\n  }\n\n  get progressPercent(): number {\n    return this.total > 0 ? Math.min(100, Math.round((this.progress / this.total) * 100)) : 0;\n  }\n}"
+          "classSource": "@Component({\n  selector: 'doc-anchor-button-item-list-view-item',\n  template: `\n    <div class=\"dbx-list-item-padded-thick dbx-list-two-line-item dbx-list-two-line-item-with-icon\">\n      <dbx-icon-tile class=\"item-icon\" [icon]=\"icon\" dbxColor=\"primary\" [dbxColorTone]=\"18\"></dbx-icon-tile>\n      <div class=\"item-left\">\n        <span class=\"dbx-text-title-medium dbx-pb1\">{{ title }}</span>\n        <span class=\"item-details dbx-pb2\">{{ progress }} of {{ total }} complete</span>\n        <mat-progress-bar mode=\"determinate\" [value]=\"progressPercent\"></mat-progress-bar>\n      </div>\n      <div class=\"item-right\">\n        <dbx-anchor [anchor]=\"anchor\">\n          <button mat-flat-button>{{ buttonText }}</button>\n        </dbx-anchor>\n      </div>\n    </div>\n  `,\n  imports: [MatButtonModule, MatProgressBar, DbxColorDirective, DbxIconTileComponent, DbxAnchorComponent]\n})\nexport class DocAnchorButtonItemListViewItemComponent extends AbstractDbxValueListViewItemComponent<AnchorButtonItemValue> {\n  get icon(): string {\n    return this.itemValue.icon;\n  }\n\n  get title(): string {\n    return this.itemValue.title;\n  }\n\n  get progress(): number {\n    return this.itemValue.progress;\n  }\n\n  get total(): number {\n    return this.itemValue.total;\n  }\n\n  get buttonText(): string {\n    return this.itemValue.buttonText;\n  }\n\n  get anchor(): ClickableAnchor {\n    return this.itemValue.anchor;\n  }\n\n  get progressPercent(): number {\n    return this.total > 0 ? Math.min(100, Math.round((this.progress / this.total) * 100)) : 0;\n  }\n}"
         },
         {
           "kind": "interface",
@@ -291,21 +291,21 @@
           "className": "DocAnchorRowItemListComponent",
           "role": "list",
           "selector": "doc-anchor-row-item-list",
-          "classSource": "@Component({\n  selector: 'doc-anchor-row-item-list',\n  template: DEFAULT_LIST_WRAPPER_COMPONENT_CONFIGURATION_TEMPLATE,\n  imports: [DbxListWrapperComponentImportsModule],\n  changeDetection: ChangeDetectionStrategy.OnPush,\n  host: {\n    class: 'dbx-list-card-items-list'\n  },\n  standalone: true\n})\nexport class DocAnchorRowItemListComponent extends AbstractDbxSelectionListWrapperDirective<AnchorRowItemValue> {\n  constructor() {\n    super({\n      componentClass: DocAnchorRowItemListViewComponent,\n      defaultSelectionMode: 'view'\n    });\n  }\n}"
+          "classSource": "@Component({\n  selector: 'doc-anchor-row-item-list',\n  template: DEFAULT_LIST_WRAPPER_COMPONENT_CONFIGURATION_TEMPLATE,\n  imports: [DbxListWrapperComponentImportsModule],\n  host: {\n    class: 'dbx-list-card-items-list'\n  }\n})\nexport class DocAnchorRowItemListComponent extends AbstractDbxSelectionListWrapperDirective<AnchorRowItemValue> {\n  constructor() {\n    super({\n      componentClass: DocAnchorRowItemListViewComponent,\n      defaultSelectionMode: 'view'\n    });\n  }\n}"
         },
         {
           "kind": "component",
           "className": "DocAnchorRowItemListViewComponent",
           "role": "view",
           "selector": "doc-anchor-row-item-list-view",
-          "classSource": "@Component({\n  selector: 'doc-anchor-row-item-list-view',\n  template: DEFAULT_DBX_SELECTION_VALUE_LIST_COMPONENT_CONFIGURATION_TEMPLATE,\n  imports: [DbxSelectionValueListViewComponentImportsModule],\n  providers: provideDbxListView(DocAnchorRowItemListViewComponent),\n  host: {\n    class: 'dbx-list-item-p0'\n  },\n  changeDetection: ChangeDetectionStrategy.OnPush,\n  standalone: true\n})\nexport class DocAnchorRowItemListViewComponent extends AbstractDbxSelectionListViewDirective<AnchorRowItemValue> {\n  readonly config: DbxSelectionValueListViewConfig<AnchorRowItemValueWithSelection> = {\n    componentClass: DocAnchorRowItemListViewItemComponent,\n    mapValuesToItemValues: (values) => of(values.map((value) => ({ ...value, itemValue: value, icon: undefined })))\n  };\n}"
+          "classSource": "@Component({\n  selector: 'doc-anchor-row-item-list-view',\n  template: DEFAULT_DBX_SELECTION_VALUE_LIST_COMPONENT_CONFIGURATION_TEMPLATE,\n  imports: [DbxSelectionValueListViewComponentImportsModule],\n  providers: provideDbxListView(DocAnchorRowItemListViewComponent),\n  host: {\n    class: 'dbx-list-item-p0'\n  }\n})\nexport class DocAnchorRowItemListViewComponent extends AbstractDbxSelectionListViewDirective<AnchorRowItemValue> {\n  readonly config: DbxSelectionValueListViewConfig<AnchorRowItemValueWithSelection> = {\n    componentClass: DocAnchorRowItemListViewItemComponent,\n    mapValuesToItemValues: (values) => of(values.map((value) => ({ ...value, itemValue: value, icon: undefined })))\n  };\n}"
         },
         {
           "kind": "component",
           "className": "DocAnchorRowItemListViewItemComponent",
           "role": "item",
           "selector": "doc-anchor-row-item-list-view-item",
-          "classSource": "@Component({\n  selector: 'doc-anchor-row-item-list-view-item',\n  template: `\n    <div class=\"dbx-list-item-padded-thick dbx-list-two-line-item dbx-list-two-line-item-with-icon\">\n      <dbx-icon-tile class=\"item-icon\" [icon]=\"icon\" dbxColor=\"primary\" [dbxColorTone]=\"18\"></dbx-icon-tile>\n      <div class=\"item-left\">\n        <span class=\"dbx-text-title-medium dbx-pb1\">{{ title }}</span>\n        <span class=\"item-details dbx-pb2\">{{ progress }} of {{ total }} complete</span>\n        <mat-progress-bar mode=\"determinate\" [value]=\"progressPercent\"></mat-progress-bar>\n      </div>\n      <div class=\"item-right\">\n        <mat-icon>chevron_right</mat-icon>\n      </div>\n    </div>\n  `,\n  imports: [MatIconModule, MatProgressBar, DbxColorDirective, DbxIconTileComponent],\n  changeDetection: ChangeDetectionStrategy.OnPush,\n  standalone: true\n})\nexport class DocAnchorRowItemListViewItemComponent extends AbstractDbxValueListViewItemComponent<AnchorRowItemValue> {\n  get icon(): string {\n    return this.itemValue.icon;\n  }\n\n  get title(): string {\n    return this.itemValue.title;\n  }\n\n  get progress(): number {\n    return this.itemValue.progress;\n  }\n\n  get total(): number {\n    return this.itemValue.total;\n  }\n\n  get progressPercent(): number {\n    return this.total > 0 ? Math.min(100, Math.round((this.progress / this.total) * 100)) : 0;\n  }\n}"
+          "classSource": "@Component({\n  selector: 'doc-anchor-row-item-list-view-item',\n  template: `\n    <div class=\"dbx-list-item-padded-thick dbx-list-two-line-item dbx-list-two-line-item-with-icon\">\n      <dbx-icon-tile class=\"item-icon\" [icon]=\"icon\" dbxColor=\"primary\" [dbxColorTone]=\"18\"></dbx-icon-tile>\n      <div class=\"item-left\">\n        <span class=\"dbx-text-title-medium dbx-pb1\">{{ title }}</span>\n        <span class=\"item-details dbx-pb2\">{{ progress }} of {{ total }} complete</span>\n        <mat-progress-bar mode=\"determinate\" [value]=\"progressPercent\"></mat-progress-bar>\n      </div>\n      <div class=\"item-right\">\n        <mat-icon>chevron_right</mat-icon>\n      </div>\n    </div>\n  `,\n  imports: [MatIconModule, MatProgressBar, DbxColorDirective, DbxIconTileComponent]\n})\nexport class DocAnchorRowItemListViewItemComponent extends AbstractDbxValueListViewItemComponent<AnchorRowItemValue> {\n  get icon(): string {\n    return this.itemValue.icon;\n  }\n\n  get title(): string {\n    return this.itemValue.title;\n  }\n\n  get progress(): number {\n    return this.itemValue.progress;\n  }\n\n  get total(): number {\n    return this.itemValue.total;\n  }\n\n  get progressPercent(): number {\n    return this.total > 0 ? Math.min(100, Math.round((this.progress / this.total) * 100)) : 0;\n  }\n}"
         },
         {
           "kind": "interface",
@@ -339,21 +339,21 @@
           "className": "DocProgressItemListComponent",
           "role": "list",
           "selector": "doc-progress-item-list",
-          "classSource": "@Component({\n  selector: 'doc-progress-item-list',\n  template: DEFAULT_LIST_WRAPPER_COMPONENT_CONFIGURATION_TEMPLATE,\n  imports: [DbxListWrapperComponentImportsModule],\n  host: {\n    class: 'dbx-list-no-hover-effects dbx-list-card-items-list'\n  },\n  changeDetection: ChangeDetectionStrategy.OnPush,\n  standalone: true\n})\nexport class DocProgressItemListComponent extends AbstractDbxSelectionListWrapperDirective<ProgressItemValue> {\n  constructor() {\n    super({\n      componentClass: DocProgressItemListViewComponent,\n      defaultSelectionMode: 'view'\n    });\n  }\n}"
+          "classSource": "@Component({\n  selector: 'doc-progress-item-list',\n  template: DEFAULT_LIST_WRAPPER_COMPONENT_CONFIGURATION_TEMPLATE,\n  imports: [DbxListWrapperComponentImportsModule],\n  host: {\n    class: 'dbx-list-no-hover-effects dbx-list-card-items-list'\n  }\n})\nexport class DocProgressItemListComponent extends AbstractDbxSelectionListWrapperDirective<ProgressItemValue> {\n  constructor() {\n    super({\n      componentClass: DocProgressItemListViewComponent,\n      defaultSelectionMode: 'view'\n    });\n  }\n}"
         },
         {
           "kind": "component",
           "className": "DocProgressItemListViewComponent",
           "role": "view",
           "selector": "doc-progress-item-list-view",
-          "classSource": "@Component({\n  selector: 'doc-progress-item-list-view',\n  template: DEFAULT_DBX_SELECTION_VALUE_LIST_COMPONENT_CONFIGURATION_TEMPLATE,\n  imports: [DbxSelectionValueListViewComponentImportsModule],\n  providers: provideDbxListView(DocProgressItemListViewComponent),\n  host: {\n    class: 'dbx-list-item-p0'\n  },\n  changeDetection: ChangeDetectionStrategy.OnPush,\n  standalone: true\n})\nexport class DocProgressItemListViewComponent extends AbstractDbxSelectionListViewDirective<ProgressItemValue> {\n  readonly config: DbxSelectionValueListViewConfig<ProgressItemValueWithSelection> = {\n    componentClass: DocProgressItemListViewItemComponent,\n    mapValuesToItemValues: (values) => of(values.map((value) => ({ ...value, itemValue: value, icon: undefined })))\n  };\n}"
+          "classSource": "@Component({\n  selector: 'doc-progress-item-list-view',\n  template: DEFAULT_DBX_SELECTION_VALUE_LIST_COMPONENT_CONFIGURATION_TEMPLATE,\n  imports: [DbxSelectionValueListViewComponentImportsModule],\n  providers: provideDbxListView(DocProgressItemListViewComponent),\n  host: {\n    class: 'dbx-list-item-p0'\n  }\n})\nexport class DocProgressItemListViewComponent extends AbstractDbxSelectionListViewDirective<ProgressItemValue> {\n  readonly config: DbxSelectionValueListViewConfig<ProgressItemValueWithSelection> = {\n    componentClass: DocProgressItemListViewItemComponent,\n    mapValuesToItemValues: (values) => of(values.map((value) => ({ ...value, itemValue: value, icon: undefined })))\n  };\n}"
         },
         {
           "kind": "component",
           "className": "DocProgressItemListViewItemComponent",
           "role": "item",
           "selector": "doc-progress-item-list-view-item",
-          "classSource": "@Component({\n  selector: 'doc-progress-item-list-view-item',\n  template: `\n    <div class=\"dbx-list-item-padded-thick dbx-list-two-line-item dbx-list-two-line-item-with-icon doc-progress-item\">\n      <dbx-icon-tile class=\"item-icon\" [icon]=\"icon\" dbxColor=\"primary\" [dbxColorTone]=\"18\"></dbx-icon-tile>\n      <div class=\"item-left\">\n        <span class=\"dbx-text-title-medium dbx-pb1\">{{ title }}</span>\n        <span class=\"item-details dbx-pb2\">{{ progress }} of {{ total }} complete</span>\n        <mat-progress-bar mode=\"determinate\" [value]=\"progressPercent\"></mat-progress-bar>\n      </div>\n      <div class=\"item-right\">\n        <button mat-flat-button>View requirements</button>\n      </div>\n    </div>\n  `,\n  imports: [MatButtonModule, MatProgressBar, DbxColorDirective, DbxIconTileComponent],\n  changeDetection: ChangeDetectionStrategy.OnPush,\n  standalone: true\n})\nexport class DocProgressItemListViewItemComponent extends AbstractDbxValueListViewItemComponent<ProgressItemValue> {\n  get icon(): string {\n    return this.itemValue.icon;\n  }\n\n  get title(): string {\n    return this.itemValue.title;\n  }\n\n  get progress(): number {\n    return this.itemValue.progress;\n  }\n\n  get total(): number {\n    return this.itemValue.total;\n  }\n\n  get progressPercent(): number {\n    return this.total > 0 ? Math.min(100, Math.round((this.progress / this.total) * 100)) : 0;\n  }\n}"
+          "classSource": "@Component({\n  selector: 'doc-progress-item-list-view-item',\n  template: `\n    <div class=\"dbx-list-item-padded-thick dbx-list-two-line-item dbx-list-two-line-item-with-icon doc-progress-item\">\n      <dbx-icon-tile class=\"item-icon\" [icon]=\"icon\" dbxColor=\"primary\" [dbxColorTone]=\"18\"></dbx-icon-tile>\n      <div class=\"item-left\">\n        <span class=\"dbx-text-title-medium dbx-pb1\">{{ title }}</span>\n        <span class=\"item-details dbx-pb2\">{{ progress }} of {{ total }} complete</span>\n        <mat-progress-bar mode=\"determinate\" [value]=\"progressPercent\"></mat-progress-bar>\n      </div>\n      <div class=\"item-right\">\n        <button mat-flat-button>View requirements</button>\n      </div>\n    </div>\n  `,\n  imports: [MatButtonModule, MatProgressBar, DbxColorDirective, DbxIconTileComponent]\n})\nexport class DocProgressItemListViewItemComponent extends AbstractDbxValueListViewItemComponent<ProgressItemValue> {\n  get icon(): string {\n    return this.itemValue.icon;\n  }\n\n  get title(): string {\n    return this.itemValue.title;\n  }\n\n  get progress(): number {\n    return this.itemValue.progress;\n  }\n\n  get total(): number {\n    return this.itemValue.total;\n  }\n\n  get progressPercent(): number {\n    return this.total > 0 ? Math.min(100, Math.round((this.progress / this.total) * 100)) : 0;\n  }\n}"
         },
         {
           "kind": "interface",
@@ -386,21 +386,21 @@
           "className": "DocTwoLineItemListComponent",
           "role": "list",
           "selector": "doc-two-line-item-list",
-          "classSource": "@Component({\n  selector: 'doc-two-line-item-list',\n  template: DEFAULT_LIST_WRAPPER_COMPONENT_CONFIGURATION_TEMPLATE,\n  imports: [DbxListWrapperComponentImportsModule],\n  changeDetection: ChangeDetectionStrategy.OnPush,\n  standalone: true\n})\nexport class DocTwoLineItemListComponent extends AbstractDbxSelectionListWrapperDirective<TwoLineItemValue> {\n  constructor() {\n    super({\n      componentClass: DocTwoLineItemListViewComponent,\n      defaultSelectionMode: 'view'\n    });\n  }\n}"
+          "classSource": "@Component({\n  selector: 'doc-two-line-item-list',\n  template: DEFAULT_LIST_WRAPPER_COMPONENT_CONFIGURATION_TEMPLATE,\n  imports: [DbxListWrapperComponentImportsModule]\n})\nexport class DocTwoLineItemListComponent extends AbstractDbxSelectionListWrapperDirective<TwoLineItemValue> {\n  constructor() {\n    super({\n      componentClass: DocTwoLineItemListViewComponent,\n      defaultSelectionMode: 'view'\n    });\n  }\n}"
         },
         {
           "kind": "component",
           "className": "DocTwoLineItemListViewComponent",
           "role": "view",
           "selector": "doc-two-line-item-list-view",
-          "classSource": "@Component({\n  selector: 'doc-two-line-item-list-view',\n  template: DEFAULT_DBX_SELECTION_VALUE_LIST_COMPONENT_CONFIGURATION_TEMPLATE,\n  imports: [DbxSelectionValueListViewComponentImportsModule],\n  providers: provideDbxListView(DocTwoLineItemListViewComponent),\n  changeDetection: ChangeDetectionStrategy.OnPush,\n  standalone: true\n})\nexport class DocTwoLineItemListViewComponent extends AbstractDbxSelectionListViewDirective<TwoLineItemValue> {\n  readonly config: DbxSelectionValueListViewConfig<TwoLineItemValueWithSelection> = {\n    componentClass: DocTwoLineItemListViewItemComponent,\n    mapValuesToItemValues: (values) => of(values.map((value) => ({ ...value, itemValue: value, icon: value.icon })))\n  };\n}"
+          "classSource": "@Component({\n  selector: 'doc-two-line-item-list-view',\n  template: DEFAULT_DBX_SELECTION_VALUE_LIST_COMPONENT_CONFIGURATION_TEMPLATE,\n  imports: [DbxSelectionValueListViewComponentImportsModule],\n  providers: provideDbxListView(DocTwoLineItemListViewComponent)\n})\nexport class DocTwoLineItemListViewComponent extends AbstractDbxSelectionListViewDirective<TwoLineItemValue> {\n  readonly config: DbxSelectionValueListViewConfig<TwoLineItemValueWithSelection> = {\n    componentClass: DocTwoLineItemListViewItemComponent,\n    mapValuesToItemValues: (values) => of(values.map((value) => ({ ...value, itemValue: value, icon: value.icon })))\n  };\n}"
         },
         {
           "kind": "component",
           "className": "DocTwoLineItemListViewItemComponent",
           "role": "item",
           "selector": "doc-two-line-item-list-view-item",
-          "classSource": "@Component({\n  selector: 'doc-two-line-item-list-view-item',\n  template: `\n    <div class=\"dbx-list-item-padded dbx-list-two-line-item\">\n      <div class=\"item-left\">\n        <span class=\"item-title\">{{ title }}</span>\n        @if (details) {\n          <span class=\"item-details\">{{ details }}</span>\n        }\n        @if (footnote) {\n          <span class=\"item-details-footnote\">{{ footnote }}</span>\n        }\n      </div>\n      <dbx-spacer></dbx-spacer>\n      <div class=\"item-right\">\n        @if (status) {\n          <dbx-chip [small]=\"true\" [color]=\"statusColor\">{{ status }}</dbx-chip>\n        }\n      </div>\n    </div>\n  `,\n  imports: [DbxSpacerDirective, DbxChipDirective],\n  changeDetection: ChangeDetectionStrategy.OnPush,\n  standalone: true\n})\nexport class DocTwoLineItemListViewItemComponent extends AbstractDbxValueListViewItemComponent<TwoLineItemValue> {\n  get title(): string {\n    return this.itemValue.title;\n  }\n\n  get details(): Maybe<string> {\n    return this.itemValue.details;\n  }\n\n  get footnote(): Maybe<string> {\n    return this.itemValue.footnote;\n  }\n\n  get status(): Maybe<TwoLineItemValue['status']> {\n    return this.itemValue.status;\n  }\n\n  get statusColor(): TwoLineItemStatusColor {\n    return this.status ? STATUS_COLOR[this.status] : 'grey';\n  }\n}"
+          "classSource": "@Component({\n  selector: 'doc-two-line-item-list-view-item',\n  template: `\n    <div class=\"dbx-list-item-padded dbx-list-two-line-item\">\n      <div class=\"item-left\">\n        <span class=\"item-title\">{{ title }}</span>\n        @if (details) {\n          <span class=\"item-details\">{{ details }}</span>\n        }\n        @if (footnote) {\n          <span class=\"item-details-footnote\">{{ footnote }}</span>\n        }\n      </div>\n      <dbx-spacer></dbx-spacer>\n      <div class=\"item-right\">\n        @if (status) {\n          <dbx-chip [small]=\"true\" [color]=\"statusColor\">{{ status }}</dbx-chip>\n        }\n      </div>\n    </div>\n  `,\n  imports: [DbxSpacerDirective, DbxChipDirective]\n})\nexport class DocTwoLineItemListViewItemComponent extends AbstractDbxValueListViewItemComponent<TwoLineItemValue> {\n  get title(): string {\n    return this.itemValue.title;\n  }\n\n  get details(): Maybe<string> {\n    return this.itemValue.details;\n  }\n\n  get footnote(): Maybe<string> {\n    return this.itemValue.footnote;\n  }\n\n  get status(): Maybe<TwoLineItemValue['status']> {\n    return this.itemValue.status;\n  }\n\n  get statusColor(): TwoLineItemStatusColor {\n    return this.status ? STATUS_COLOR[this.status] : 'grey';\n  }\n}"
         },
         {
           "kind": "interface",
@@ -452,7 +452,7 @@
         "dbx-link-hover"
       ],
       "info": "<p>\n  Composes a marketing-style support page out of Angular Material cards plus dbx-web's\n  <code>&lt;dbx-button&gt;</code>\n  ,\n  <code>&lt;dbx-anchor&gt;</code>\n  , and\n  <code>&lt;dbx-icon-tile&gt;</code>\n  : an outlined hero\n  <code>&lt;mat-card&gt;</code>\n  for the search/CTA row and a responsive grid of outlined topic\n  <code>&lt;mat-card&gt;</code>\n  boxes whose rows are individual\n  <code>&lt;dbx-anchor [anchor]&gt;</code>\n  click targets.\n</p>\n<p>\n  The topic grid uses Angular Flex Layout's CSS-Grid directives —\n  <code>gdColumns=\"repeat(auto-fit, minmax(320px, 1fr))\"</code>\n  +\n  <code>gdGap</code>\n  — so the cards auto-collapse 3 → 2 → 1 columns as the viewport narrows, with no breakpoint media queries or wrapping\n  <code>fxFlex</code>\n  shells needed. The hero CTA + search row uses\n  <code>fxLayout=\"row\"</code>\n  with\n  <code>fxLayout.lt-md=\"column\"</code>\n  so it stacks below the tablet breakpoint. The CTA itself composes the\n  <code>.dbx-grow-button</code>\n  +\n  <code>.dbx-button-big</code>\n  utilities (full-width, taller mat-button) instead of hand-rolled\n  <code>::ng-deep</code>\n  width / height overrides.\n</p>\n<p>\n  Topic-card avatars are\n  <code>&lt;dbx-icon-tile [round]&gt;</code>\n  with\n  <code>dbxColor=\"primary\"</code>\n  +\n  <code>[dbxColorTone]=\"18\"</code>\n  for the tonal swatch. Each card body is a plain\n  <code>&lt;ul&gt;</code>\n  /\n  <code>&lt;li&gt;</code>\n  so the browser's default disc marker supplies the bullet, and topic links use\n  <code>[dbxTextColor]=\"'primary'\"</code>\n  for the link color plus a\n  <code>&lt;span class=\"dbx-link-hover\"&gt;</code>\n  wrapper around the projected label for the hover-only-underline affordance. The\n  <code>.dbx-link-hover</code>\n  /\n  <code>.dbx-link</code>\n  utilities pair with\n  <code>.dbx-u</code>\n  —\n  <code>.dbx-link</code>\n  is always underlined,\n  <code>.dbx-link-hover</code>\n  underlines on hover, both keep a pointer cursor. The class lives on the projected\n  <code>&lt;span&gt;</code>\n  rather than the\n  <code>&lt;dbx-anchor&gt;</code>\n  host because\n  <code>dbx-anchor</code>\n  's internal\n  <code>&lt;a class=\"dbx-anchor-a\"&gt;</code>\n  bakes in\n  <code>text-decoration: none</code>\n  and would strip a host-level\n  <code>.dbx-link</code>\n  .\n</p>\n<p>\n  Each topic row supplies a\n  <code>ClickableAnchor</code>\n  with an\n  <code>onClick</code>\n  callback to\n  <code>dbx-anchor</code>\n  ; the callback opens a\n  <code>MatSnackBar</code>\n  with a \"Dismiss\" action so every link demonstrably triggers a button-bearing popup. Swap the\n  <code>onClick</code>\n  for a\n  <code>ref</code>\n  /\n  <code>url</code>\n  to route or open externally instead.\n</p>",
-      "snippet": "<div class=\"dbx-p4 doc-support-page\">\n  <h1 class=\"dbx-text-headline-large dbx-mb1\">Lorem Ipsum Support</h1>\n  <p class=\"dbx-text-body-large dbx-mb4\">Dolor sit amet — we're here to help you succeed!</p>\n\n  <mat-card appearance=\"outlined\" class=\"dbx-mb4\">\n    <mat-card-content>\n      <h3 class=\"dbx-text-title-medium dbx-mb3\">Need help? We're here.</h3>\n      <div fxLayout=\"row\" fxLayout.lt-md=\"column\" fxLayoutGap=\"var(--dbx-padding-3)\" fxLayoutAlign=\"start stretch\">\n        <dbx-button class=\"dbx-grow-button dbx-button-form-field-height\" fxFlex=\"1 1 50%\" flat icon=\"help_outline\" text=\"Chat with Support\" customButtonColor=\"var(--mat-sys-inverse-surface)\" customTextColor=\"var(--mat-sys-inverse-on-surface)\" (buttonClick)=\"onChatClick()\"></dbx-button>\n        <mat-form-field class=\"dbx-p0\" appearance=\"outline\" fxFlex=\"1 1 50%\" subscriptSizing=\"dynamic\">\n          <input matInput placeholder=\"Search for a topic or question…\" />\n        </mat-form-field>\n      </div>\n    </mat-card-content>\n  </mat-card>\n\n  <div gdColumns=\"repeat(auto-fit, minmax(320px, 1fr))\" gdGap=\"var(--dbx-padding-5)\">\n    @for (group of topics; track group.title) {\n      <mat-card appearance=\"outlined\">\n        <mat-card-content>\n          <div fxLayout=\"row\" fxLayoutAlign=\"start center\" fxLayoutGap=\"var(--dbx-padding-2)\" class=\"dbx-mb3\">\n            <dbx-icon-tile class=\"doc-support-topic-avatar\" [icon]=\"group.icon\" [round]=\"true\"></dbx-icon-tile>\n            <span class=\"dbx-text-title-medium\">{{ group.title }}</span>\n          </div>\n          <ul class=\"doc-support-topic-links\">\n            @for (link of group.links; track link.label) {\n              <li class=\"dbx-pb2\">\n                <dbx-anchor [dbxTextColor]=\"'primary'\" [anchor]=\"anchorFor(link)\">\n                  <span class=\"dbx-link-hover\">{{ link.label }}</span>\n                </dbx-anchor>\n              </li>\n            }\n          </ul>\n        </mat-card-content>\n      </mat-card>\n    }\n  </div>\n</div>",
+      "snippet": "<div class=\"dbx-p4 doc-support-page\">\n  <h1 class=\"dbx-text-headline-large dbx-mb1\">Lorem Ipsum Support</h1>\n  <p class=\"dbx-text-body-large dbx-mb4\">Dolor sit amet — we're here to help you succeed!</p>\n\n  <mat-card appearance=\"outlined\" class=\"dbx-mb4\">\n    <mat-card-content>\n      <h3 class=\"dbx-text-title-medium dbx-mb3\">Need help? We're here.</h3>\n      <div fxLayout=\"row\" fxLayout.lt-md=\"column\" fxLayoutGap=\"var(--dbx-padding-3)\" fxLayoutAlign=\"start stretch\">\n        <dbx-button class=\"dbx-grow-button dbx-button-form-field-height\" fxFlex=\"1 1 50%\" flat icon=\"help_outline\" text=\"Chat with Support\" [buttonStyle]=\"chatButtonStyle\" (buttonClick)=\"onChatClick()\"></dbx-button>\n        <mat-form-field class=\"dbx-p0\" appearance=\"outline\" fxFlex=\"1 1 50%\" subscriptSizing=\"dynamic\">\n          <input matInput placeholder=\"Search for a topic or question…\" />\n        </mat-form-field>\n      </div>\n    </mat-card-content>\n  </mat-card>\n\n  <div gdColumns=\"repeat(auto-fit, minmax(320px, 1fr))\" gdGap=\"var(--dbx-padding-5)\">\n    @for (group of topics; track group.title) {\n      <mat-card appearance=\"outlined\">\n        <mat-card-content>\n          <div fxLayout=\"row\" fxLayoutAlign=\"start center\" fxLayoutGap=\"var(--dbx-padding-2)\" class=\"dbx-mb3\">\n            <dbx-icon-tile class=\"doc-support-topic-avatar\" [icon]=\"group.icon\" [round]=\"true\"></dbx-icon-tile>\n            <span class=\"dbx-text-title-medium\">{{ group.title }}</span>\n          </div>\n          <ul class=\"doc-support-topic-links\">\n            @for (link of group.links; track link.label) {\n              <li class=\"dbx-pb2\">\n                <dbx-anchor [dbxTextColor]=\"'primary'\" [anchor]=\"anchorFor(link)\">\n                  <span class=\"dbx-link-hover\">{{ link.label }}</span>\n                </dbx-anchor>\n              </li>\n            }\n          </ul>\n        </mat-card-content>\n      </mat-card>\n    }\n  </div>\n</div>",
       "uses": []
     }
   ]

package/generated/dereekb-firebase-server.utils.mcp.generated.json

@@ -22,7 +22,7 @@
           "optional": false
         }
       ],
-      "returns": "`true` if the input is a Firebase {@link HttpsError }.",
+      "returns": "`true` if the input is a Firebase {@link HttpsError}.",
       "tags": [
         "firebase",
         "https",
@@ -56,7 +56,7 @@
           "optional": false
         }
       ],
-      "returns": "`true` if the input is a Firebase Admin {@link admin.FirebaseError }.",
+      "returns": "`true` if the input is a Firebase Admin {@link admin.FirebaseError}.",
       "tags": [
         "firebase",
         "admin",
@@ -89,7 +89,7 @@
           "optional": false
         }
       ],
-      "returns": "Structured {@link FirebaseServerErrorInfo } with classified error details.",
+      "returns": "Structured {@link FirebaseServerErrorInfo} with classified error details.",
       "tags": [
         "firebase",
         "error",
@@ -246,7 +246,7 @@
         {
           "name": "handleFirebaseErrorFn",
           "type": "ThrowErrorFunction<admin.FirebaseError>",
-          "description": "- Handler that receives the typed {@link admin.FirebaseError }.",
+          "description": "- Handler that receives the typed {@link admin.FirebaseError}.",
           "optional": false
         }
       ],

package/generated/dereekb-firebase.utils.mcp.generated.json

@@ -99,7 +99,7 @@
           "optional": false
         }
       ],
-      "returns": "A {@link FirebaseServerError } if the error has structured details, or a generic readable error otherwise.",
+      "returns": "A {@link FirebaseServerError} if the error has structured details, or a generic readable error otherwise.",
       "tags": [
         "firebase",
         "https",
@@ -137,7 +137,7 @@
           "optional": false
         }
       ],
-      "returns": "A {@link ReadableError } with a human-readable message suitable for display.",
+      "returns": "A {@link ReadableError} with a human-readable message suitable for display.",
       "tags": [
         "firebase",
         "auth",
@@ -1433,7 +1433,7 @@
           "optional": false
         }
       ],
-      "returns": "The same data object, now typed as {@link DocumentDataWithIdAndKey }",
+      "returns": "The same data object, now typed as {@link DocumentDataWithIdAndKey}",
       "tags": [
         "firestore",
         "data",
@@ -1478,7 +1478,7 @@
           "optional": false
         }
       ],
-      "returns": "The same data object, now typed as {@link DocumentDataWithIdAndKey }",
+      "returns": "The same data object, now typed as {@link DocumentDataWithIdAndKey}",
       "tags": [
         "firestore",
         "data",
@@ -1553,7 +1553,7 @@
       "category": "firestore",
       "module": "@dereekb/firebase",
       "subpath": "common/firestore/accessor/document.utility",
-      "signature": "useDocumentSnapshotData(): <D extends import(\"/home/circleci/code/packages/firebase/src/lib/common/firestore/accessor/document\").FirestoreDocument<any, import(\"/home/circleci/code/packages/firebase/src/lib/common/firestore/collection/collection\").FirestoreModelIdentity>, O = void>(document: Maybe<D>, use: UseAsync<import(\"/home/circleci/code/packages/firebase/src/lib/common/firestore/accessor/document\").FirestoreDocumentData<D>, O>, defaultValue?: Maybe<AsyncGetterOrValue<O>>) => Promise<Maybe<O>>",
+      "signature": "useDocumentSnapshotData(): <D extends FirestoreDocument<any>, O = void>(document: Maybe<D>, use: UseAsync<import(\"/home/circleci/code/packages/firebase/src/lib/common/firestore/accessor/document\").FirestoreDocumentData<D>, O>, defaultValue?: any) => Promise<Maybe<O>>",
       "description": "Fetches a document's snapshot data (via `snapshot.data()`) and passes it to a `use` callback.\n\nWraps {@link useDocumentSnapshot} with a mapping step that extracts raw data from the snapshot.\nIf the document doesn't exist (data is `undefined`), the `use` callback is not invoked\nand `defaultValue` is returned instead.",
       "params": [],
       "returns": "The result of `use`, or the default value",
@@ -1798,7 +1798,7 @@
           "optional": false
         }
       ],
-      "returns": "A {@link LimitedFirestoreDocumentAccessorSnapshotCache } backed by the given accessor.",
+      "returns": "A {@link LimitedFirestoreDocumentAccessorSnapshotCache} backed by the given accessor.",
       "tags": [
         "firestore",
         "cache",

package/generated/dereekb-util.utils.mcp.generated.json

@@ -313,7 +313,7 @@
           "optional": false
         }
       ],
-      "returns": "A {@link BatchCalc } with computed batch counts and remainder.",
+      "returns": "A {@link BatchCalc} with computed batch counts and remainder.",
       "tags": [
         "batch",
         "calculate",
@@ -437,7 +437,7 @@
           "optional": false
         }
       ],
-      "returns": "A {@link SeparateResult } with included and excluded arrays.",
+      "returns": "A {@link SeparateResult} with included and excluded arrays.",
       "tags": [
         "array",
         "separate",
@@ -1002,7 +1002,7 @@
           "optional": false
         }
       ],
-      "returns": "The {@link FunctionType }, or `null` for non-functions.",
+      "returns": "The {@link FunctionType}, or `null` for non-functions.",
       "tags": [
         "type",
         "function",
@@ -2728,7 +2728,7 @@
           "optional": false
         }
       ],
-      "returns": "An {@link AsyncValueCache } that proxies the inner cache with a single-load memoization layer.",
+      "returns": "An {@link AsyncValueCache} that proxies the inner cache with a single-load memoization layer.",
       "tags": [
         "memoize",
         "memo",
@@ -2761,7 +2761,7 @@
           "optional": false
         }
       ],
-      "returns": "An {@link AsyncKeyedValueCache } that proxies the inner cache with a record-level memoization layer.",
+      "returns": "An {@link AsyncKeyedValueCache} that proxies the inner cache with a record-level memoization layer.",
       "tags": [
         "memoize",
         "memo",
@@ -7450,7 +7450,7 @@
         {
           "name": "filter",
           "type": "FilterKeyValueTuplesInput<T>",
-          "description": "- A {@link FilterKeyValueTuplesInput } controlling which values match. Required (no default).",
+          "description": "- A {@link FilterKeyValueTuplesInput} controlling which values match. Required (no default).",
           "optional": false
         }
       ],
@@ -7485,7 +7485,7 @@
         {
           "name": "filter",
           "type": "FilterKeyValueTuplesInput<T>",
-          "description": "- A {@link FilterKeyValueTuplesInput } controlling which values are counted. Defaults to `KeyValueTypleValueFilter.UNDEFINED`.",
+          "description": "- A {@link FilterKeyValueTuplesInput} controlling which values are counted. Defaults to `KeyValueTypleValueFilter.UNDEFINED`.",
           "optional": true
         }
       ],
@@ -7591,7 +7591,7 @@
         {
           "name": "filter",
           "type": "FilterKeyValueTuplesInput<I>",
-          "description": "- A {@link FilterKeyValueTuplesInput } controlling which values are included. Defaults to `KeyValueTypleValueFilter.UNDEFINED`.",
+          "description": "- A {@link FilterKeyValueTuplesInput} controlling which values are included. Defaults to `KeyValueTypleValueFilter.UNDEFINED`.",
           "optional": true
         }
       ],
@@ -9778,7 +9778,7 @@
       "signature": "makeDefaultNonConcurrentTaskKeyFactory(): StringFactory<any>",
       "description": "Creates a default non-concurrent task key factory that generates unique incrementing number strings.",
       "params": [],
-      "returns": "A {@link StringFactory } that produces unique keys for identifying non-concurrent tasks.",
+      "returns": "A {@link StringFactory} that produces unique keys for identifying non-concurrent tasks.",
       "tags": [
         "promise",
         "parallel",
@@ -13155,7 +13155,7 @@
         {
           "name": "valueOrFunction",
           "type": "Maybe<boolean | DecisionFunction<T>>",
-          "description": "- Boolean constant, {@link DecisionFunction }, or undefined to use the default.",
+          "description": "- Boolean constant, {@link DecisionFunction}, or undefined to use the default.",
           "optional": false
         },
         {
@@ -13165,7 +13165,7 @@
           "optional": true
         }
       ],
-      "returns": "A {@link DecisionFunction } derived from the input.",
+      "returns": "A {@link DecisionFunction} derived from the input.",
       "tags": [
         "decision",
         "normalize",
@@ -14615,7 +14615,7 @@
           "optional": false
         }
       ],
-      "returns": "A new {@link Modifier } pairing the key with the modify function.",
+      "returns": "A new {@link Modifier} pairing the key with the modify function.",
       "tags": [
         "modifier",
         "mutate",
@@ -14647,7 +14647,7 @@
           "optional": false
         }
       ],
-      "returns": "A single modifier function that applies all mapped modifiers, or {@link NOOP_MODIFIER } if empty.",
+      "returns": "A single modifier function that applies all mapped modifiers, or {@link NOOP_MODIFIER} if empty.",
       "tags": [
         "modifier",
         "map",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/dbx-components-mcp",
-  "version": "13.43.0",
+  "version": "14.0.0",
   "type": "module",
   "bin": {
     "dbx-components-mcp": "dbx-components-mcp.js"
@@ -11,7 +11,7 @@
     "ts-morph": "^21.0.0"
   },
   "peerDependencies": {
-    "@dereekb/dbx-cli": "13.43.0",
-    "@dereekb/util": "13.43.0"
+    "@dereekb/dbx-cli": "14.0.0",
+    "@dereekb/util": "14.0.0"
   }
 }