@dereekb/dbx-components-mcp 14.10.0 → 14.12.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: "14.10.0",
+  version: "14.12.0",
   sideEffects: false,
   type: "module",
   bin: {
@@ -22,8 +22,8 @@ var package_default = {
     "ts-morph": "^21.0.0"
   },
   peerDependencies: {
-    "@dereekb/dbx-cli": "14.10.0",
-    "@dereekb/util": "14.10.0"
+    "@dereekb/dbx-cli": "14.12.0",
+    "@dereekb/util": "14.12.0"
   }
 };
 

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

@@ -1616,6 +1616,122 @@
         "format-date-range"
       ]
     },
+    {
+      "slug": "date-or-day-string-range-to-date-range",
+      "name": "dateOrDayStringRangeToDateRange",
+      "kind": "function",
+      "category": "date",
+      "module": "@dereekb/date",
+      "subpath": "date/date.range.string",
+      "signature": "dateOrDayStringRangeToDateRange(range: DateOrDayStringRange): DateRange",
+      "description": "Converts a {@link DateOrDayStringRange} to a {@link DateRange} by parsing any string values to the start of their respective days.",
+      "params": [
+        {
+          "name": "range",
+          "type": "DateOrDayStringRange",
+          "description": "- The range with Date or string values.",
+          "optional": false
+        }
+      ],
+      "returns": "A DateRange with concrete Date objects.",
+      "tags": [
+        "date",
+        "range",
+        "day",
+        "string",
+        "iso8601",
+        "parse",
+        "convert",
+        "to",
+        "or",
+        "dateordaystringrangetodaterange"
+      ],
+      "example": "const range = dateOrDayStringRangeToDateRange({ start: '2024-01-01', end: '2024-01-31' });\n// range.start and range.end are Date objects at start of day",
+      "relatedSlugs": [
+        "date-or-day-string-range-to-iso8601-day-string-range",
+        "iso8601-day-string-range-params-to-date-range"
+      ]
+    },
+    {
+      "slug": "date-or-day-string-range-to-iso8601-day-string-range",
+      "name": "dateOrDayStringRangeToISO8601DayStringRange",
+      "kind": "function",
+      "category": "date",
+      "module": "@dereekb/date",
+      "subpath": "date/date.range.string",
+      "signature": "dateOrDayStringRangeToISO8601DayStringRange(range: DateOrDayStringRange): ISO8601DayStringRange",
+      "description": "Converts a {@link DateOrDayStringRange} to an {@link ISO8601DayStringRange} by formatting any Date values as ISO 8601 day strings using the system timezone.",
+      "params": [
+        {
+          "name": "range",
+          "type": "DateOrDayStringRange",
+          "description": "- The range with Date or string values.",
+          "optional": false
+        }
+      ],
+      "returns": "A range with both start and end as ISO 8601 day strings.",
+      "tags": [
+        "date",
+        "range",
+        "day",
+        "string",
+        "iso8601",
+        "params",
+        "url",
+        "query",
+        "route",
+        "format",
+        "convert",
+        "to",
+        "or",
+        "dateordaystringrangetoiso8601daystringrange"
+      ],
+      "example": "const stringRange = dateOrDayStringRangeToISO8601DayStringRange({\n  start: new Date('2024-01-01T10:00:00Z'),\n  end: '2024-01-31'\n});\n// stringRange.start === '2024-01-01', stringRange.end === '2024-01-31'",
+      "relatedSlugs": [
+        "date-or-day-string-range-to-date-range",
+        "iso8601-day-string-range-params-to-date-range"
+      ]
+    },
+    {
+      "slug": "iso8601-day-string-range-params-to-date-range",
+      "name": "iso8601DayStringRangeParamsToDateRange",
+      "kind": "function",
+      "category": "date",
+      "module": "@dereekb/date",
+      "subpath": "date/date.range.string",
+      "signature": "iso8601DayStringRangeParamsToDateRange(params: Maybe<ISO8601DayStringRangeParams>): Maybe<DateRange>",
+      "description": "Converts {@link ISO8601DayStringRangeParams} to a {@link DateRange}, reading the days in the system timezone.\n\nUnlike {@link dateOrDayStringRangeToDateRange}, the values are checked first, and the range ends at the end of the end day.\nA start that is missing or not a valid ISO 8601 day string returns undefined. An end that is missing, invalid, or before the\nstart is ignored, so the range covers just the start day.",
+      "params": [
+        {
+          "name": "params",
+          "type": "Maybe<ISO8601DayStringRangeParams>",
+          "description": "- The params to read, typically the current route's params.",
+          "optional": false
+        }
+      ],
+      "returns": "The date range, or undefined when there is no valid start day.",
+      "tags": [
+        "date",
+        "range",
+        "day",
+        "string",
+        "iso8601",
+        "params",
+        "url",
+        "query",
+        "route",
+        "parse",
+        "validate",
+        "convert",
+        "to",
+        "iso8601daystringrangeparamstodaterange"
+      ],
+      "example": "iso8601DayStringRangeParamsToDateRange({ start: '2026-10-14', end: '2026-10-20' });\n// { start: 2026-10-14T00:00:00, end: 2026-10-20T23:59:59.999 } (system timezone)\n\niso8601DayStringRangeParamsToDateRange({ start: '2026-10-14' });\n// { start: 2026-10-14T00:00:00, end: 2026-10-14T23:59:59.999 }\n\niso8601DayStringRangeParamsToDateRange({ start: 'tomorrow' });\n// undefined",
+      "relatedSlugs": [
+        "date-or-day-string-range-to-iso8601-day-string-range",
+        "date-or-day-string-range-to-date-range"
+      ]
+    },
     {
       "slug": "date-range-days-count",
       "name": "dateRangeDaysCount",

package/generated/dereekb-dbx-core.filters.mcp.generated.json

@@ -108,6 +108,31 @@
         "dbx__ref__dbx-component-patterns"
       ]
     },
+    {
+      "kind": "directive",
+      "slug": "map-route-params",
+      "selector": "[dbxFilterMapRouteParams]",
+      "className": "DbxFilterMapRouteParamsDirective",
+      "module": "@dereekb/dbx-core",
+      "description": "Loads the filter of a keyed entry in an ancestor {@link FilterMap} from the current route params, so a link can open the page on a specific filter.\n\nThe params' filter becomes the key's default filter when the page loads, and a later change to the params (such as a link to\nthe same page with other params) sets the key's filter. When {@link DbxFilterMapRouteParamsConfig.paramsFromFilter} is set,\nevery change to the key is also written back to the URL, so reloading the page keeps the filter.\n\nThe params must be declared on the current route (for UIRouter, as query params of an ancestor state, ideally `dynamic: true`\nso writing them does not reload the state). Do not use it together with {@link DbxFilterMapStorageDirective} on the same key,\nsince both set the key's default filter.",
+      "inputs": [
+        {
+          "name": "dbxFilterMapRouteParams",
+          "type": "Maybe<DbxFilterMapRouteParamsConfig<F>>",
+          "description": "The key to load and how to read and write its params."
+        }
+      ],
+      "outputs": [],
+      "example": "<div dbxFilterMap>\n  <my-filter-button [dbxFilterMapSourceConnector]=\"'list'\" [dbxFilterMapRouteParams]=\"routeParamsConfig\"></my-filter-button>\n</div>",
+      "relatedSlugs": [
+        "map",
+        "map-storage",
+        "map-source-connector"
+      ],
+      "skillRefs": [
+        "dbx__ref__dbx-component-patterns"
+      ]
+    },
     {
       "kind": "directive",
       "slug": "map-source",
@@ -151,7 +176,8 @@
       "relatedSlugs": [
         "map",
         "map-source-connector",
-        "map-merge-source"
+        "map-merge-source",
+        "map-route-params"
       ],
       "skillRefs": [
         "dbx__ref__dbx-component-patterns"

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

@@ -176,6 +176,27 @@
       "generic": "<T = unknown>",
       "configInterface": "DbxForgeComponentFieldConfig<T>"
     },
+    {
+      "slug": "radio",
+      "factoryName": "dbxForgeRadioField",
+      "tier": "field-factory",
+      "produces": "T",
+      "arrayOutput": "no",
+      "description": "Radio button group for picking exactly one value, wrapped in a form-field container. Use for small static option sets where every option should be visible at once.\n\nThe wrapper provides the Material outlined form-field appearance (notched outline with floating label, hint/error subscript), matching the checkbox, toggle, and slider fields.\n\nOptions are passed at the top level of the config, not inside `props`. A `null` option value can represent an \"any\"/\"none\" choice; the form omits the key from its output when that option is selected.\nSet `nullable: true` alongside a `null` option, otherwise a `null` value (including `value: null` as the default) resolves to no selection instead of checking that option.",
+      "example": "dbxForgeRadioField<number>({\n  key: 'minPay',\n  label: 'Minimum Pay Rate',\n  layout: 'vertical',\n  options: [\n    { label: '$120+', value: 120 },\n    { label: '$150+', value: 150 }\n  ]\n})",
+      "properties": [
+        {
+          "name": "layout",
+          "type": "Maybe<DbxForgeRadioFieldLayout>",
+          "description": "How the radio buttons are laid out. Defaults to `'horizontal'`.",
+          "required": false
+        }
+      ],
+      "wrapperPattern": "material-form-field-wrapped",
+      "ngFormType": "radio",
+      "generic": "<T = unknown>",
+      "configInterface": "DbxForgeRadioFieldConfig<T>"
+    },
     {
       "slug": "value-selection",
       "factoryName": "dbxForgeValueSelectionField",

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

@@ -1066,6 +1066,93 @@
         "--dbx-padding-3"
       ]
     },
+    {
+      "slug": "card-image-caption",
+      "selector": ".dbx-card-image-captioned",
+      "source": "@dereekb/dbx-web",
+      "module": "@dereekb/dbx-web",
+      "file": "src/lib/layout/card/_card.scss",
+      "line": 301,
+      "declarations": [
+        {
+          "property": "position",
+          "value": "absolute"
+        },
+        {
+          "property": "left",
+          "value": "0"
+        },
+        {
+          "property": "right",
+          "value": "0"
+        },
+        {
+          "property": "bottom",
+          "value": "0"
+        },
+        {
+          "property": "padding",
+          "value": "var(--dbx-padding-2) var(--dbx-padding-4)"
+        },
+        {
+          "property": "color",
+          "value": "white"
+        },
+        {
+          "property": "background",
+          "value": "color-mix(in srgb, var(--mat-sys-scrim, black) 55%, transparent)"
+        },
+        {
+          "property": "white-space",
+          "value": "nowrap"
+        },
+        {
+          "property": "overflow",
+          "value": "hidden"
+        },
+        {
+          "property": "text-overflow",
+          "value": "ellipsis"
+        }
+      ],
+      "role": "layout",
+      "intent": "single-line caption strip across the bottom of a `.dbx-card-image-captioned` image — light text on a translucent `--mat-sys-scrim` wash that stays readable over any picture in light and dark themes; long text ellipsizes. Pair with a type role utility such as `.dbx-text-title-small`.",
+      "seeAlso": [
+        "card-image-captioned",
+        "text-title-small"
+      ],
+      "parent": "card-image-captioned",
+      "selectorContext": ".dbx-card-image-captioned > .dbx-card-image-caption",
+      "tokensRead": [
+        "--dbx-padding-2",
+        "--dbx-padding-4",
+        "--mat-sys-scrim"
+      ]
+    },
+    {
+      "slug": "card-image-captioned",
+      "selector": ".dbx-card-image-captioned",
+      "source": "@dereekb/dbx-web",
+      "module": "@dereekb/dbx-web",
+      "file": "src/lib/layout/card/_card.scss",
+      "line": 285,
+      "declarations": [
+        {
+          "property": "position",
+          "value": "relative"
+        },
+        {
+          "property": "overflow",
+          "value": "hidden"
+        }
+      ],
+      "role": "layout",
+      "intent": "`mat-card-image` wrapper that overlays a `.dbx-card-image-caption` strip on the bottom of its `<img>` (e.g. a place name over a map popup hero) — put `mat-card-image` on this wrapper `<div>` instead of the `<img>`, so the wrapper keeps mat-card's rounded top corners and clips the image to them.",
+      "seeAlso": [
+        "card-image-caption",
+        "text-title-small"
+      ]
+    },
     {
       "slug": "card-select",
       "selector": ".dbx-card-select",

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

@@ -1776,6 +1776,32 @@
       },
       "componentScope": "list"
     },
+    {
+      "cssVariable": "--dbx-mapbox-popup-tip-color",
+      "source": "dbx-web",
+      "role": "color",
+      "intents": [
+        "mapbox popup tip color"
+      ],
+      "description": "Component-scoped override point (`mapbox`) read in `packages/dbx-web/src/lib/extension/mapbox/_mapbox.scss` — set it (from an app, or via the owning dbx directive where one exists) to override; unset, it falls back to `var(--mat-card-elevated-container-color, var(--mat-sys-surface-container-low))`.",
+      "defaults": {
+        "light": "var(--mat-card-elevated-container-color, var(--mat-sys-surface-container-low))"
+      },
+      "componentScope": "mapbox"
+    },
+    {
+      "cssVariable": "--dbx-mapbox-popup-width",
+      "source": "dbx-web",
+      "role": "size",
+      "intents": [
+        "mapbox popup width"
+      ],
+      "description": "Component-scoped override point (`mapbox`) read in `packages/dbx-web/src/lib/extension/mapbox/_mapbox.scss` — set it (from an app, or via the owning dbx directive where one exists) to override; unset, it falls back to `340px`.",
+      "defaults": {
+        "light": "340px"
+      },
+      "componentScope": "mapbox"
+    },
     {
       "cssVariable": "--dbx-navbar-item-border-radius",
       "source": "dbx-web",

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

@@ -808,6 +808,52 @@
       "example": "<dbx-progress-spinner-button [config]=\"cfg\" (btnClick)=\"onClick()\"></dbx-progress-spinner-button>",
       "minimalExample": "<dbx-progress-spinner-button [config]=\"cfg\"></dbx-progress-spinner-button>"
     },
+    {
+      "slug": "browser-agent-view",
+      "category": "misc",
+      "kind": "component",
+      "selector": "dbx-browser-agent-view",
+      "className": "DbxBrowserAgentViewComponent",
+      "module": "@dereekb/dbx-web",
+      "description": "Renders the component of the first {@link DbxBrowserAgentViewEntry} whose match matches the current browser agent (OS, browser, and device), falling back to the config's default entry.\n\nAn optional override button lets the user pick another entry. Injected components can inject {@link DbxBrowserAgentViewContext} to read the detected agent or to switch entries.",
+      "inputs": [
+        {
+          "name": "config",
+          "type": "Maybe<DbxBrowserAgentViewConfig>",
+          "description": "",
+          "required": false
+        },
+        {
+          "name": "showOverrideButton",
+          "type": "Maybe<boolean>",
+          "description": "",
+          "required": false
+        }
+      ],
+      "outputs": [],
+      "relatedSlugs": [
+        "widget",
+        "browser-agent-view-override-button"
+      ],
+      "example": "readonly config = makeDbxBrowserAgentViewConfigFromOsMap({\n  ios: { componentClass: IosInstructionsComponent },\n  android: { componentClass: AndroidInstructionsComponent },\n  default: { componentClass: BookmarkInstructionsComponent },\n  showOverrideButton: true\n});\n```\n\n```html\n<dbx-browser-agent-view [config]=\"config\" [(overrideKey)]=\"savedDeviceKey\"></dbx-browser-agent-view>",
+      "minimalExample": "<dbx-browser-agent-view [config]=\"config\"></dbx-browser-agent-view>"
+    },
+    {
+      "slug": "browser-agent-view-override-button",
+      "category": "misc",
+      "kind": "component",
+      "selector": "dbx-browser-agent-view-override-button",
+      "className": "DbxBrowserAgentViewOverrideButtonComponent",
+      "module": "@dereekb/dbx-web",
+      "description": "Button that opens a menu to manually select an entry of the parent {@link DbxBrowserAgentViewComponent}, or to return to the auto-detected entry.\n\nRendered by the view when `showOverrideButton` is enabled, but can also be placed inside the injected content to position it manually.",
+      "inputs": [],
+      "outputs": [],
+      "relatedSlugs": [
+        "browser-agent-view"
+      ],
+      "example": "<!-- inside a component injected by dbx-browser-agent-view -->\n<p>Follow these steps to add the app to your home screen.</p>\n<dbx-browser-agent-view-override-button></dbx-browser-agent-view-override-button>",
+      "minimalExample": "<dbx-browser-agent-view-override-button></dbx-browser-agent-view-override-button>"
+    },
     {
       "slug": "page-title-info",
       "category": "navigation",
@@ -2688,6 +2734,12 @@
           "required": false,
           "default": "false"
         },
+        {
+          "name": "buttonStyle",
+          "type": "Maybe<DbxButtonStyle>",
+          "description": "Style passed to the button when the navbar renders as a button (the \"button\" and \"icon\" modes), such as a flat type and a color.\n\nThe active anchor's activeButton style is used instead, if it has one. Has no effect on the tab bar.",
+          "required": false
+        },
         {
           "name": "fab",
           "type": "boolean",
@@ -2743,7 +2795,7 @@
         },
         {
           "name": "anchors",
-          "type": "Maybe<ClickableAnchorLinkSegueRef[]>",
+          "type": "Maybe<DbxNavbarClickableAnchorLinkSegueRef[]>",
           "description": "",
           "required": false,
           "default": "[]"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/dbx-components-mcp",
-  "version": "14.10.0",
+  "version": "14.12.0",
   "sideEffects": false,
   "type": "module",
   "bin": {
@@ -12,7 +12,7 @@
     "ts-morph": "^21.0.0"
   },
   "peerDependencies": {
-    "@dereekb/dbx-cli": "14.10.0",
-    "@dereekb/util": "14.10.0"
+    "@dereekb/dbx-cli": "14.12.0",
+    "@dereekb/util": "14.12.0"
   }
 }