@dereekb/dbx-components-mcp 13.31.0 → 13.33.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.31.0",
+  version: "13.33.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.31.0",
-    "@dereekb/util": "13.31.0"
+    "@dereekb/dbx-cli": "13.33.0",
+    "@dereekb/util": "13.33.0"
   }
 };
 
@@ -2072,10 +2072,18 @@ var FIREBASE_MODELS = [
         tsType: "Maybe<NeedsSyncBoolean>",
         optional: true,
         description: "Whether one or more configs need to be synced to their corresponding NotificationBox recipients."
+      },
+      {
+        name: "hc",
+        longName: "healthCheck",
+        converter: "optionalFirestoreNotificationHealthCheck",
+        tsType: "Maybe<NotificationHealthCheck>",
+        optional: true,
+        description: "The result of the most recent notification delivery health check run for this user."
       }
     ],
     enums: [],
-    detectionHints: ["b", "x", "dc", "gc", "bc", "ns"],
+    detectionHints: ["b", "x", "dc", "gc", "bc", "ns", "hc"],
     description: "A global notification user profile that tracks notification preferences and box subscriptions.",
     modelGroup: "Notification",
     collectionKind: "root",
@@ -2566,6 +2574,54 @@ var FIREBASE_MODELS = [
     collectionKind: "root",
     archetypes: ["system-state-singleton"]
   },
+  {
+    name: "UserExternalConnection",
+    identityConst: "userExternalConnectionIdentity",
+    modelType: "userExternalConnection",
+    collectionPrefix: "uec",
+    sourcePackage: "@dereekb/firebase",
+    sourceFile: "packages/firebase/src/lib/model/userexternalconnection/userexternalconnection.ts",
+    fields: [
+      {
+        name: "uid",
+        longName: "uid",
+        converter: "firestoreUID()",
+        optional: false
+      },
+      {
+        name: "e",
+        longName: "entries",
+        converter: "firestoreObjectMap<UserExternalConnectionEntry, FirestoreModelData<UserExternalConnectionEntry>, UserExternalConnectionProviderType>({ objectField: { fields: userExternalConnectionEntryFields } })",
+        tsType: "UserExternalConnectionEntryMap",
+        optional: false,
+        description: "Per-provider connection state, keyed by provider type."
+      },
+      {
+        name: "c",
+        longName: "connectedProviderTypes",
+        converter: "firestoreEnumArray<UserExternalConnectionProviderType>()",
+        tsType: "UserExternalConnectionProviderType[]",
+        optional: false,
+        description: "DERIVED from `e`: every provider type whose entry status is `connected`."
+      },
+      {
+        name: "uat",
+        longName: "updatedAt",
+        converter: "firestoreDate({ saveDefaultAsNow: true })",
+        tsType: "Date",
+        optional: false,
+        description: "Date this document was last updated at."
+      }
+    ],
+    enums: [],
+    detectionHints: ["e", "c", "uat"],
+    description: "The client-readable half of a user's third-party OAuth connection state.",
+    modelGroup: "UserExternalConnection",
+    collectionKind: "root",
+    userKeyedById: true,
+    hasUserUidField: true,
+    archetypes: ["user-keyed-entity-root"]
+  },
   {
     name: "Notification",
     identityConst: "notificationIdentity",

package/generated/dereekb-dbx-web.css-utilities.mcp.generated.json

@@ -33,14 +33,10 @@
       "source": "@dereekb/dbx-web",
       "module": "@dereekb/dbx-web",
       "file": "src/lib/layout/avatar/_avatar.scss",
-      "line": 65,
+      "line": 68,
       "declarations": [
         {
-          "property": "width",
-          "value": "var(#{theming.$dbx-avatar-large-size-var}, 128px)"
-        },
-        {
-          "property": "height",
+          "property": "--dbx-avatar-view-size",
           "value": "var(#{theming.$dbx-avatar-large-size-var}, 128px)"
         }
       ],
@@ -51,7 +47,10 @@
         "avatar-small"
       ],
       "parent": "avatar-view",
-      "selectorContext": ".dbx-avatar-large .dbx-avatar-view"
+      "selectorContext": ".dbx-avatar-large .dbx-avatar-view",
+      "tokensSet": [
+        "--dbx-avatar-view-size"
+      ]
     },
     {
       "slug": "avatar-small",
@@ -59,14 +58,10 @@
       "source": "@dereekb/dbx-web",
       "module": "@dereekb/dbx-web",
       "file": "src/lib/layout/avatar/_avatar.scss",
-      "line": 45,
+      "line": 59,
       "declarations": [
         {
-          "property": "width",
-          "value": "var(#{theming.$dbx-avatar-small-size-var}, 32px)"
-        },
-        {
-          "property": "height",
+          "property": "--dbx-avatar-view-size",
           "value": "var(#{theming.$dbx-avatar-small-size-var}, 32px)"
         }
       ],
@@ -77,7 +72,10 @@
         "avatar-large"
       ],
       "parent": "avatar-view",
-      "selectorContext": ".dbx-avatar-small .dbx-avatar-view"
+      "selectorContext": ".dbx-avatar-small .dbx-avatar-view",
+      "tokensSet": [
+        "--dbx-avatar-view-size"
+      ]
     },
     {
       "slug": "avatar-view",
@@ -85,8 +83,12 @@
       "source": "@dereekb/dbx-web",
       "module": "@dereekb/dbx-web",
       "file": "src/lib/layout/avatar/_avatar.scss",
-      "line": 16,
+      "line": 17,
       "declarations": [
+        {
+          "property": "--dbx-avatar-view-size",
+          "value": "var(#{theming.$dbx-avatar-size-var}, 64px)"
+        },
         {
           "property": "position",
           "value": "relative"
@@ -109,11 +111,15 @@
         },
         {
           "property": "width",
-          "value": "var(#{theming.$dbx-avatar-size-var}, 64px)"
+          "value": "var(--dbx-avatar-view-size)"
         },
         {
           "property": "height",
-          "value": "var(#{theming.$dbx-avatar-size-var}, 64px)"
+          "value": "var(--dbx-avatar-view-size)"
+        },
+        {
+          "property": "background-color",
+          "value": "color-mix(in srgb, var(--mat-sys-on-surface) 4%, transparent)"
         }
       ],
       "role": "layout",
@@ -122,10 +128,18 @@
         "avatar-small",
         "avatar-large",
         "avatar-view-circle",
-        "avatar-view-square"
+        "avatar-view-square",
+        "avatar-view-tile"
       ],
       "component": "DbxAvatarViewComponent",
-      "scope": "component-class"
+      "scope": "component-class",
+      "tokensRead": [
+        "--dbx-avatar-view-size",
+        "--mat-sys-on-surface"
+      ],
+      "tokensSet": [
+        "--dbx-avatar-view-size"
+      ]
     },
     {
       "slug": "avatar-view-circle",
@@ -133,7 +147,7 @@
       "source": "@dereekb/dbx-web",
       "module": "@dereekb/dbx-web",
       "file": "src/lib/layout/avatar/_avatar.scss",
-      "line": 125,
+      "line": 141,
       "declarations": [
         {
           "property": "border-radius",
@@ -148,13 +162,34 @@
       ],
       "parent": "avatar-view"
     },
+    {
+      "slug": "avatar-view-img-contain",
+      "selector": ".dbx-avatar-view-img-contain",
+      "source": "@dereekb/dbx-web",
+      "module": "@dereekb/dbx-web",
+      "file": "src/lib/layout/avatar/_avatar.scss",
+      "line": 85,
+      "declarations": [
+        {
+          "property": "object-fit",
+          "value": "contain"
+        }
+      ],
+      "role": "layout",
+      "intent": "fits the whole avatar image inside the box instead of cropping it — the default in tile mode, where the image is a brand logo",
+      "seeAlso": [
+        "avatar-view-tile"
+      ],
+      "parent": "avatar-view",
+      "component": "DbxAvatarViewComponent"
+    },
     {
       "slug": "avatar-view-initials",
       "selector": ".dbx-avatar-view-initials",
       "source": "@dereekb/dbx-web",
       "module": "@dereekb/dbx-web",
       "file": "src/lib/layout/avatar/_avatar.scss",
-      "line": 101,
+      "line": 103,
       "declarations": [
         {
           "property": "display",
@@ -208,7 +243,7 @@
       "source": "@dereekb/dbx-web",
       "module": "@dereekb/dbx-web",
       "file": "src/lib/layout/avatar/_avatar.scss",
-      "line": 134,
+      "line": 150,
       "declarations": [
         {
           "property": "border-radius",
@@ -227,6 +262,42 @@
         "--mat-sys-corner-medium"
       ]
     },
+    {
+      "slug": "avatar-view-tile",
+      "selector": ".dbx-avatar-view-tile",
+      "source": "@dereekb/dbx-web",
+      "module": "@dereekb/dbx-web",
+      "file": "src/lib/layout/avatar/_avatar.scss",
+      "line": 168,
+      "declarations": [
+        {
+          "property": "--dbx-icon-tile-padding",
+          "value": "var(--dbx-avatar-tile-padding, calc(var(--dbx-avatar-view-size) * #{$tile-padding-to-avatar-size-ratio}))"
+        },
+        {
+          "property": "--dbx-icon-tile-icon-size",
+          "value": "var(--dbx-avatar-tile-icon-size, calc(var(--dbx-avatar-view-size) * #{$icon-to-avatar-size-ratio}))"
+        }
+      ],
+      "role": "layout",
+      "intent": "icon-tile presentation for `.dbx-avatar-view` — the avatar keeps its box size while `.dbx-icon-tile` supplies padding, shape and the `[dbxColor]` surface. Customize with `--dbx-avatar-tile-padding` / `--dbx-avatar-tile-icon-size`.",
+      "seeAlso": [
+        "icon-tile",
+        "avatar-view",
+        "avatar-view-img-contain"
+      ],
+      "parent": "avatar-view",
+      "component": "DbxAvatarViewComponent",
+      "tokensRead": [
+        "--dbx-avatar-tile-icon-size",
+        "--dbx-avatar-tile-padding",
+        "--dbx-avatar-view-size"
+      ],
+      "tokensSet": [
+        "--dbx-icon-tile-icon-size",
+        "--dbx-icon-tile-padding"
+      ]
+    },
     {
       "slug": "bar",
       "selector": ".dbx-bar",

package/generated/dereekb-dbx-web.tokens.mcp.generated.json

@@ -252,6 +252,47 @@
       },
       "componentScope": "avatar"
     },
+    {
+      "cssVariable": "--dbx-avatar-tile-icon-size",
+      "source": "dbx-web",
+      "role": "size",
+      "intents": [
+        "avatar tile icon size"
+      ],
+      "description": "Component-scoped override point (`avatar`) read in `packages/dbx-web/src/lib/layout/avatar/_avatar.scss` — set it (from an app, or via the owning dbx directive where one exists) to override; unset, it falls back to `calc(var(--dbx-avatar-view-size) * 0.65)`.",
+      "defaults": {
+        "light": "calc(var(--dbx-avatar-view-size) * 0.65)"
+      },
+      "componentScope": "avatar"
+    },
+    {
+      "cssVariable": "--dbx-avatar-tile-padding",
+      "source": "dbx-web",
+      "role": "spacing",
+      "intents": [
+        "avatar tile padding",
+        "avatar tile padding spacing"
+      ],
+      "description": "Component-scoped override point (`avatar`) read in `packages/dbx-web/src/lib/layout/avatar/_avatar.scss` — set it (from an app, or via the owning dbx directive where one exists) to override; unset, it falls back to `calc(var(--dbx-avatar-view-size) * 0.15)`.",
+      "defaults": {
+        "light": "calc(var(--dbx-avatar-view-size) * 0.15)"
+      },
+      "componentScope": "avatar"
+    },
+    {
+      "cssVariable": "--dbx-avatar-view-size",
+      "source": "dbx-web",
+      "role": "size",
+      "intents": [
+        "resolved avatar size",
+        "current avatar diameter"
+      ],
+      "description": "Resolved avatar box size. Every avatar measurement derives from this one value so the small/large variants and the tile presentation each have a single number to scale from. Apps override the public `--dbx-avatar-size` (or the small/large tokens) rather than this.",
+      "defaults": {
+        "light": "var(#{theming.$dbx-avatar-size-var}, 64px)"
+      },
+      "componentScope": "avatar"
+    },
     {
       "cssVariable": "--dbx-bg-color-current",
       "scssVariable": "$dbx-bg-color-var",
@@ -1240,13 +1281,14 @@
       "source": "dbx-web",
       "role": "size",
       "intents": [
-        "icon tile icon size"
+        "icon tile icon size",
+        "tile glyph size"
       ],
-      "description": "Component-scoped token (`text`) declared in `packages/dbx-web/src/lib/layout/text/_text.scss`. Add a sassdoc `///` block above the declaration for richer guidance.",
+      "description": "Icon tile glyph size, as a tile avatar resolves it. See `--dbx-avatar-tile-icon-size` to override.",
       "defaults": {
-        "light": "var(--dbx-step-block-badge-icon-size, 18px)"
+        "light": "var(--dbx-avatar-tile-icon-size, calc(var(--dbx-avatar-view-size) * 0.65))"
       },
-      "componentScope": "text"
+      "componentScope": "avatar"
     },
     {
       "cssVariable": "--dbx-icon-tile-min-width",
@@ -1267,13 +1309,13 @@
       "role": "spacing",
       "intents": [
         "icon tile padding",
-        "icon tile padding spacing"
+        "tile inset"
       ],
-      "description": "Component-scoped token (`text`) declared in `packages/dbx-web/src/lib/layout/text/_text.scss`. Add a sassdoc `///` block above the declaration for richer guidance.",
+      "description": "Icon tile padding, as a tile avatar resolves it. See `--dbx-avatar-tile-padding` to override.",
       "defaults": {
-        "light": "0"
+        "light": "var(--dbx-avatar-tile-padding, calc(var(--dbx-avatar-view-size) * 0.15))"
       },
-      "componentScope": "text"
+      "componentScope": "avatar"
     },
     {
       "cssVariable": "--dbx-icon-tile-width",

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

@@ -12,7 +12,7 @@
       "selector": "[dbxActionConfirm]",
       "className": "DbxActionConfirmDirective",
       "module": "@dereekb/dbx-web",
-      "description": "Displays a confirmation dialog when the action is triggered. If the user confirms,\nthe configured ready value is passed to the action. If the user cancels, the action is rejected.\n\nThis directive works with action triggering only, not button clicks.\nFor button-based confirmation, use an appPromptConfirmButton directive instead.",
+      "description": "Displays a confirmation dialog when the action is triggered. If the user confirms,\nthe configured ready value is passed to the action. If the user cancels, the action is rejected.\n\nA config with `autoConfirm` true shows no dialog and marks the action ready immediately. This lets a\ntemplate bind the same input for actions that need confirmation and actions that do not.\n\nThis directive works with action triggering only, not button clicks.\nFor button-based confirmation, use an appPromptConfirmButton directive instead.",
       "inputs": [
         {
           "name": "dbxActionConfirm",
@@ -980,6 +980,122 @@
       "example": "<dbx-prompt-confirm [config]=\"{ header: 'Delete?', confirmText: 'Delete', cancelText: 'Cancel' }\"></dbx-prompt-confirm>",
       "minimalExample": "<dbx-prompt-confirm [config]=\"cfg\"></dbx-prompt-confirm>"
     },
+    {
+      "slug": "avatar",
+      "category": "layout",
+      "kind": "component",
+      "selector": "dbx-avatar",
+      "className": "DbxAvatarComponent",
+      "module": "@dereekb/dbx-web",
+      "description": "Renders an avatar by dynamically injecting the appropriate avatar view component based on the provided context.\n\nMerges individual input properties with the optional `context` input and delegates rendering\nto the component resolved by {@link DbxAvatarViewService}. Supports size variants via CSS classes.\n\nRenders an image when one is available, then name initials on a curated color, then a Material icon.\nWith `[avatarTile]` the avatar takes the `<dbx-icon-tile>` presentation — every `--dbx-icon-tile-*`\ncustomization applies and `[avatarColor]` / `[avatarColorTone]` paint the tile surface — which makes\nit the right choice for a branded row (a connected app, an integration) rather than a person.",
+      "inputs": [
+        {
+          "name": "context",
+          "type": "DbxAvatarContext",
+          "description": "",
+          "required": false
+        },
+        {
+          "name": "avatarSelector",
+          "type": "Maybe<DbxAvatarSelector>",
+          "description": "",
+          "required": false
+        },
+        {
+          "name": "avatarUid",
+          "type": "Maybe<AuthUserIdentifier>",
+          "description": "",
+          "required": false
+        },
+        {
+          "name": "avatarUrl",
+          "type": "Maybe<WebsiteUrlWithPrefix>",
+          "description": "",
+          "required": false
+        },
+        {
+          "name": "avatarName",
+          "type": "Maybe<string>",
+          "description": "",
+          "required": false
+        },
+        {
+          "name": "avatarKey",
+          "type": "Maybe<DbxAvatarKey>",
+          "description": "",
+          "required": false
+        },
+        {
+          "name": "avatarIcon",
+          "type": "Maybe<string>",
+          "description": "",
+          "required": false
+        },
+        {
+          "name": "avatarStyle",
+          "type": "Maybe<DbxAvatarStyle>",
+          "description": "",
+          "required": false
+        },
+        {
+          "name": "avatarSize",
+          "type": "Maybe<DbxAvatarSize>",
+          "description": "",
+          "required": false,
+          "default": "undefined"
+        },
+        {
+          "name": "avatarHideOnError",
+          "type": "Maybe<boolean>",
+          "description": "",
+          "required": false
+        },
+        {
+          "name": "avatarTile",
+          "type": "Maybe<boolean>",
+          "description": "",
+          "required": false
+        },
+        {
+          "name": "avatarColor",
+          "type": "Maybe<DbxColorInput>",
+          "description": "",
+          "required": false
+        },
+        {
+          "name": "avatarColorTone",
+          "type": "Maybe<DbxColorTone>",
+          "description": "",
+          "required": false
+        },
+        {
+          "name": "avatarImageFit",
+          "type": "Maybe<DbxAvatarImageFit>",
+          "description": "",
+          "required": false
+        },
+        {
+          "name": "avatarImageFilter",
+          "type": "Maybe<string>",
+          "description": "",
+          "required": false
+        },
+        {
+          "name": "avatarIgnoreDefaultUrl",
+          "type": "Maybe<boolean>",
+          "description": "",
+          "required": false
+        }
+      ],
+      "outputs": [],
+      "relatedSlugs": [
+        "icon-tile",
+        "dbx-color",
+        "avatar-view"
+      ],
+      "example": "<dbx-avatar [avatarUrl]=\"user.photoUrl\" [avatarStyle]=\"'circle'\" [avatarSize]=\"'large'\"></dbx-avatar>",
+      "minimalExample": "<dbx-avatar [avatarUrl]=\"user.photoUrl\"></dbx-avatar>"
+    },
     {
       "slug": "bar",
       "category": "layout",
@@ -1913,14 +2029,7 @@
       "className": "DbxColorDirective",
       "module": "@dereekb/dbx-web",
       "description": "Provides themed color *tokens* to the host element — it never paints a background itself.\n\nAccepts either a {@link DbxThemeColor} string (e.g. `'primary'`, `'success'`) or a {@link DbxColorConfig}\nobject carrying arbitrary CSS color values (any hex, `rgb()`, `hsl()`, `var(...)`, `color-mix(...)`, etc.).\nThe directive sets the `--dbx-bg-color-current` / `--dbx-color-current` (and tone) custom properties and adds the\n`.dbx-color` marker class, leaving the actual painting to either the explicit `.dbx-color-bg` utility on the same\nelement or a colored-surface component's own `.dbx-color`-scoped SCSS (e.g. `<dbx-bar>`, `<dbx-button>`, `<dbx-loading>`,\n`<dbx-icon-tile>`, `<mat-card>`) that reads the inherited tokens.\n\nOptionally set {@link dbxColorTone} (0-100) to control background opacity for a tonal/muted appearance.\nWhen tonal mode is active, the `dbx-color-tonal` CSS class is added and a CSS rule overrides the text\ncolor to the vibrant color (via `--dbx-bg-color-current`).\n\nThe standalone `[dbxColorTone]` input wins over `config.tone` when both are set; the same precedence\napplies to tonal mode.",
-      "inputs": [
-        {
-          "name": "dbxColorTone",
-          "type": "Maybe<DbxColorTone>",
-          "description": "Background tone level (0-100). When set, the background becomes semi-transparent\nand text color switches to the vibrant theme color for a tonal appearance.",
-          "required": false
-        }
-      ],
+      "inputs": [],
       "outputs": [],
       "relatedSlugs": [
         "text-color",

package/generated/dereekb-firebase.model-snapshot-fields.mcp.generated.json

@@ -871,11 +871,48 @@
         "sub",
         "firestoresubobject"
       ],
-      "example": "// Nested address object with its own converters\nconst addressField = firestoreSubObject<Address>({\n  objectField: {\n    street: firestoreString(),\n    city: firestoreString(),\n    zip: firestoreString()\n  }\n});",
+      "example": "// Nested address object with its own converters\nconst addressField = firestoreSubObject<Address>({\n  objectField: {\n    fields: {\n      street: firestoreString(),\n      city: firestoreString(),\n      zip: firestoreString()\n    }\n  }\n});",
       "relatedSlugs": [
         "firestore-object-array"
       ]
     },
+    {
+      "slug": "firestore-object-map",
+      "name": "firestoreObjectMap",
+      "kind": "factory",
+      "category": "map",
+      "module": "@dereekb/firebase",
+      "subpath": "common/firestore/snapshot/snapshot.field",
+      "signature": "firestoreObjectMap(config: FirestoreObjectMapFieldConfig<T, O, S>): ModelFieldMapFunctionsWithDefaultsConfig<V, Maybe<D>>",
+      "description": "Creates a field mapping configuration for a Firestore map whose values are complex objects.\n\nThis is the map-keyed counterpart to {@link firestoreObjectArray}: each value in the map is\nconverted using its own set of field converters (via `objectField` or `firestoreField`), so\nnested `Date`/enum/array fields round-trip properly.\n\nOn write, null/undefined values are filtered from each object to match Firestore semantics, and\nempty values (including objects with no keys) are removed from the map entirely.\n\nNOTE: this exists instead of passing a sub-object's `mapFunctions.to`/`.from` directly to\n{@link firestoreEncodedObjectMap}. That encoder is invoked as `mapFn(value, key)` by\n`mapObjectMap()`, while a `ModelMapFunctions`' second parameter is the accumulator *target* — so\nthe map key string would be used as the write target and the conversion would throw at runtime.\nThe arity is wrapped here, once, rather than at each call site.",
+      "optional": false,
+      "params": [
+        {
+          "name": "config",
+          "type": "FirestoreObjectMapFieldConfig<T, O, S>",
+          "description": "- Configuration including the per-value conversions and optional map filtering.",
+          "optional": false
+        }
+      ],
+      "returns": "A field mapping configuration for object map values.",
+      "tags": [
+        "map",
+        "record",
+        "dictionary",
+        "object",
+        "nested",
+        "embedded",
+        "structured",
+        "factory",
+        "firestore",
+        "firestoreobjectmap"
+      ],
+      "example": "// Map of provider id -> connection entry\nconst entriesField = firestoreObjectMap<UserExternalConnectionEntry, FirestoreModelData<UserExternalConnectionEntry>, UserExternalConnectionProviderType>({\n  objectField: { fields: userExternalConnectionEntryFields }\n});",
+      "relatedSlugs": [
+        "firestore-sub-object",
+        "firestore-object-array"
+      ]
+    },
     {
       "slug": "firestore-lat-lng-string",
       "name": "firestoreLatLngString",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/dbx-components-mcp",
-  "version": "13.31.0",
+  "version": "13.33.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.31.0",
-    "@dereekb/util": "13.31.0"
+    "@dereekb/dbx-cli": "13.33.0",
+    "@dereekb/util": "13.33.0"
   }
 }