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

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

@@ -123,6 +123,68 @@
       ],
       "configInterface": "DbxForgeUsernameLoginFieldUsernameConfigInput"
     },
+    {
+      "slug": "website-url",
+      "factoryName": "dbxForgeWebsiteUrlField",
+      "tier": "field-factory",
+      "produces": "string",
+      "arrayOutput": "no",
+      "description": "Website url input with website url validation.\n\nDefaults to the key `'website'` and label `'Website Url'` unless overridden in the config.\n\nWhen a `baseUrl` is configured (e.g. `'https://linkedin.com/in/'`), the base url is shown as a prefix and the user only types the relative path\nthat follows it (e.g. a username). Pasting a full url, or a url without the protocol, removes the base url from the input. The `valueMode`\ndetermines whether the full url or only the relative path is saved. The `requirePrefix`, `allowPorts`, and `validDomains` validation options\nonly apply when no base url is configured.",
+      "example": "const field = dbxForgeWebsiteUrlField();\nconst linkedInField = dbxForgeWebsiteUrlField({ key: 'linkedIn', label: 'LinkedIn', baseUrl: 'https://linkedin.com/in/' });\nconst linkedInUsernameField = dbxForgeWebsiteUrlField({ key: 'linkedInUsername', label: 'LinkedIn', baseUrl: 'https://linkedin.com/in/', valueMode: 'relative' });",
+      "properties": [
+        {
+          "name": "autocomplete",
+          "type": "FieldAutocompleteAttributeOption",
+          "description": "",
+          "required": false
+        },
+        {
+          "name": "notWebsiteUrlMessage",
+          "type": "DynamicText",
+          "description": "Optional override for the \"is not a valid website url\" error message.",
+          "required": false
+        },
+        {
+          "name": "notWebsiteUrlWithPrefixMessage",
+          "type": "DynamicText",
+          "description": "Optional override for the \"is not a valid website url with an http/https prefix\" error message.",
+          "required": false
+        },
+        {
+          "name": "notWebsiteUrlWithExpectedDomainMessage",
+          "type": "DynamicText",
+          "description": "Optional override for the \"is not a valid website url with an expected domain\" error message.",
+          "required": false
+        },
+        {
+          "name": "valueMode",
+          "type": "DbxForgeWebsiteUrlFieldValueMode",
+          "description": "The value saved when a base url is configured.\n\n- `'url'`: the full website url, e.g. `https://linkedin.com/in/dereekb`\n- `'relative'`: only the relative path that follows the base url, e.g. `dereekb`\n\nDefaults to `'url'`.",
+          "required": false
+        },
+        {
+          "name": "notWebsiteUrlWithExpectedBaseUrlMessage",
+          "type": "DynamicText",
+          "description": "Optional override for the \"is not a website url with the expected base url\" error message.\n\nOnly used when a base url is configured.",
+          "required": false
+        },
+        {
+          "name": "type (props)",
+          "type": "DbxForgeTextFieldInputType",
+          "description": "HTML input type. Defaults to `'text'`.",
+          "required": false
+        },
+        {
+          "name": "valueMode (props)",
+          "type": "DbxForgeWebsiteUrlFieldValueMode",
+          "description": "The value saved when a base url is configured.\n\nDefaults to `'url'`.",
+          "required": false
+        }
+      ],
+      "wrapperPattern": "unwrapped",
+      "ngFormType": "websiteurl",
+      "configInterface": "DbxForgeWebsiteUrlFieldConfig"
+    },
     {
       "slug": "checklist",
       "factoryName": "dbxForgeChecklistField",

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

@@ -584,6 +584,194 @@
         "--dbx-padding-2"
       ]
     },
+    {
+      "slug": "button-floating",
+      "selector": ".dbx-button-floating",
+      "source": "@dereekb/dbx-web",
+      "module": "@dereekb/dbx-web",
+      "file": "src/lib/button/_button.scss",
+      "line": 205,
+      "declarations": [
+        {
+          "property": "position",
+          "value": "sticky"
+        },
+        {
+          "property": "z-index",
+          "value": "var(--dbx-button-floating-z-index, 10)"
+        },
+        {
+          "property": "bottom",
+          "value": "$button-floating-offset-y"
+        },
+        {
+          "property": "display",
+          "value": "flex"
+        },
+        {
+          "property": "gap",
+          "value": "var(--dbx-padding-2)"
+        },
+        {
+          "property": "width",
+          "value": "fit-content"
+        },
+        {
+          "property": "margin-left",
+          "value": "auto"
+        },
+        {
+          "property": "--mat-button-protected-container-elevation-shadow",
+          "value": "var(--mat-sys-level3)"
+        },
+        {
+          "property": "--mat-button-protected-focus-container-elevation-shadow",
+          "value": "var(--mat-sys-level3)"
+        },
+        {
+          "property": "--mat-button-protected-pressed-container-elevation-shadow",
+          "value": "var(--mat-sys-level3)"
+        },
+        {
+          "property": "--mat-button-protected-hover-container-elevation-shadow",
+          "value": "var(--mat-sys-level4)"
+        }
+      ],
+      "role": "layout",
+      "intent": "float a button (or a wrapper holding several buttons) over the content with `position: sticky` — pinned `offset-y` from the bottom of its scroll container while its parent section is on screen, right-aligned by default. Raised buttons get FAB-level elevation. Compose with `.dbx-button-floating-top` / `-left` / `-center` to reposition, or `.dbx-button-floating-fixed` to pin to the viewport. Sticky breaks when an ancestor between the host and the scroller sets `overflow`. Tune with `--dbx-button-floating-offset` (or `-offset-x` / `-offset-y`) and `--dbx-button-floating-z-index`",
+      "seeAlso": [
+        "button-floating-fixed",
+        "button-floating-top",
+        "button-floating-left",
+        "button-floating-center",
+        "content-pit-floating-button"
+      ],
+      "tokensRead": [
+        "--dbx-button-floating-z-index",
+        "--dbx-padding-2",
+        "--mat-sys-level3",
+        "--mat-sys-level4"
+      ],
+      "tokensSet": [
+        "--mat-button-protected-container-elevation-shadow",
+        "--mat-button-protected-focus-container-elevation-shadow",
+        "--mat-button-protected-hover-container-elevation-shadow",
+        "--mat-button-protected-pressed-container-elevation-shadow"
+      ]
+    },
+    {
+      "slug": "button-floating-center",
+      "selector": ".dbx-button-floating-center",
+      "source": "@dereekb/dbx-web",
+      "module": "@dereekb/dbx-web",
+      "file": "src/lib/button/_button.scss",
+      "line": 265,
+      "declarations": [
+        {
+          "property": "margin-left",
+          "value": "auto"
+        },
+        {
+          "property": "margin-right",
+          "value": "auto"
+        }
+      ],
+      "role": "layout",
+      "intent": "horizontally center a `.dbx-button-floating` instead of right-aligning it",
+      "seeAlso": [
+        "button-floating",
+        "button-floating-top",
+        "button-floating-left"
+      ],
+      "parent": "button-floating"
+    },
+    {
+      "slug": "button-floating-fixed",
+      "selector": ".dbx-button-floating-fixed",
+      "source": "@dereekb/dbx-web",
+      "module": "@dereekb/dbx-web",
+      "file": "src/lib/button/_button.scss",
+      "line": 226,
+      "declarations": [
+        {
+          "property": "position",
+          "value": "fixed"
+        },
+        {
+          "property": "margin",
+          "value": "0"
+        },
+        {
+          "property": "right",
+          "value": "$button-floating-offset-x"
+        },
+        {
+          "property": "bottom",
+          "value": "$button-floating-offset-y"
+        }
+      ],
+      "role": "layout",
+      "intent": "pin a `.dbx-button-floating` to the viewport with `position: fixed` — a classic floating action button, `offset-x` / `offset-y` from the bottom-right corner by default (composes with `-top` / `-left` / `-center`). Breaks when an ancestor sets `transform`, `filter` or `contain`, which re-anchors fixed positioning to that ancestor",
+      "seeAlso": [
+        "button-floating",
+        "button-floating-top",
+        "button-floating-left",
+        "button-floating-center"
+      ],
+      "parent": "button-floating"
+    },
+    {
+      "slug": "button-floating-left",
+      "selector": ".dbx-button-floating-left",
+      "source": "@dereekb/dbx-web",
+      "module": "@dereekb/dbx-web",
+      "file": "src/lib/button/_button.scss",
+      "line": 250,
+      "declarations": [
+        {
+          "property": "margin-left",
+          "value": "0"
+        },
+        {
+          "property": "margin-right",
+          "value": "auto"
+        }
+      ],
+      "role": "layout",
+      "intent": "align a `.dbx-button-floating` to the left edge instead of the right",
+      "seeAlso": [
+        "button-floating",
+        "button-floating-top",
+        "button-floating-center"
+      ],
+      "parent": "button-floating"
+    },
+    {
+      "slug": "button-floating-top",
+      "selector": ".dbx-button-floating-top",
+      "source": "@dereekb/dbx-web",
+      "module": "@dereekb/dbx-web",
+      "file": "src/lib/button/_button.scss",
+      "line": 240,
+      "declarations": [
+        {
+          "property": "top",
+          "value": "$button-floating-offset-y"
+        },
+        {
+          "property": "bottom",
+          "value": "auto"
+        }
+      ],
+      "role": "layout",
+      "intent": "pin a `.dbx-button-floating` to the top edge (`offset-y` from the top) instead of the bottom — in sticky mode place the host at the start of its section",
+      "seeAlso": [
+        "button-floating",
+        "button-floating-left",
+        "button-floating-center"
+      ],
+      "parent": "button-floating"
+    },
     {
       "slug": "button-form-field-height",
       "selector": ".dbx-button-form-field-height",
@@ -1511,7 +1699,7 @@
         }
       ],
       "role": "layout",
-      "intent": "recessed surface pit (\"negative elevation\") — a semi-transparent tonal wash of the active dbxColor over `--mat-sys-surface-dim` (the dimmest/greyest M3 surface, the opposite end of the dim/bright pair from `.dbx-content-elevate`) so the lighter surface behind shows through, with a `padding-4` inset, used to visually nest content (e.g. logs, JSON, quoted blocks); rounded by default, opt out with `.dbx-corners-none`",
+      "intent": "recessed surface pit (\"negative elevation\") — a semi-transparent tonal wash of the active dbxColor over `--mat-sys-surface-dim` (the dimmest/greyest M3 surface, the opposite end of the dim/bright pair from `.dbx-content-elevate`) so the lighter surface behind shows through, with a `padding-4` inset, used to visually nest content (e.g. logs, JSON, quoted blocks); rounded by default, opt out with `.dbx-corners-none`. Draws a thin 1px edge derived from its own background (a translucent ink of the active dbxColor + `on-surface` laid over the fill), so the edge follows dbxColor and background overrides — tune it with `--dbx-content-pit-border-width` (`0` removes it), `--dbx-content-pit-border-tone` (percentage), or `--dbx-content-pit-border-color`",
       "seeAlso": [
         "dbx-content-pit-scrollable",
         "dbx-content-border",

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

@@ -430,6 +430,58 @@
       },
       "componentScope": "button"
     },
+    {
+      "cssVariable": "--dbx-button-floating-offset",
+      "source": "dbx-web",
+      "role": "misc",
+      "intents": [
+        "button floating offset"
+      ],
+      "description": "Component-scoped override point (`button`) read in `packages/dbx-web/src/lib/button/_button.scss` — set it (from an app, or via the owning dbx directive where one exists) to override; unset, it falls back to `var(--dbx-padding-4)`.",
+      "defaults": {
+        "light": "var(--dbx-padding-4)"
+      },
+      "componentScope": "button"
+    },
+    {
+      "cssVariable": "--dbx-button-floating-offset-x",
+      "source": "dbx-web",
+      "role": "misc",
+      "intents": [
+        "button floating offset x"
+      ],
+      "description": "Component-scoped override point (`button`) read in `packages/dbx-web/src/lib/button/_button.scss` — set it (from an app, or via the owning dbx directive where one exists) to override; unset, it falls back to `var(--dbx-button-floating-offset, var(--dbx-padding-4))`.",
+      "defaults": {
+        "light": "var(--dbx-button-floating-offset, var(--dbx-padding-4))"
+      },
+      "componentScope": "button"
+    },
+    {
+      "cssVariable": "--dbx-button-floating-offset-y",
+      "source": "dbx-web",
+      "role": "misc",
+      "intents": [
+        "button floating offset y"
+      ],
+      "description": "Component-scoped override point (`button`) read in `packages/dbx-web/src/lib/button/_button.scss` — set it (from an app, or via the owning dbx directive where one exists) to override; unset, it falls back to `var(--dbx-button-floating-offset, var(--dbx-padding-4))`.",
+      "defaults": {
+        "light": "var(--dbx-button-floating-offset, var(--dbx-padding-4))"
+      },
+      "componentScope": "button"
+    },
+    {
+      "cssVariable": "--dbx-button-floating-z-index",
+      "source": "dbx-web",
+      "role": "misc",
+      "intents": [
+        "button floating z index"
+      ],
+      "description": "Component-scoped override point (`button`) read in `packages/dbx-web/src/lib/button/_button.scss` — set it (from an app, or via the owning dbx directive where one exists) to override; unset, it falls back to `10`.",
+      "defaults": {
+        "light": "10"
+      },
+      "componentScope": "button"
+    },
     {
       "cssVariable": "--dbx-button-icon-color",
       "source": "dbx-web",
@@ -991,6 +1043,45 @@
       },
       "componentScope": "content"
     },
+    {
+      "cssVariable": "--dbx-content-pit-border-color",
+      "source": "dbx-web",
+      "role": "color",
+      "intents": [
+        "content pit border color"
+      ],
+      "description": "Component-scoped override point (`content`) read in `packages/dbx-web/src/lib/layout/content/_content.scss` — set it (from an app, or via the owning dbx directive where one exists) to override; unset, it falls back to `color-mix(in srgb, color-mix(in srgb, #{theming.$dbx-bg-color} 50%, var(--mat-sys-on-surface)) var(--dbx-content-pit-border-tone, 8%), transparent)`.",
+      "defaults": {
+        "light": "color-mix(in srgb, color-mix(in srgb, #{theming.$dbx-bg-color} 50%, var(--mat-sys-on-surface)) var(--dbx-content-pit-border-tone, 8%), transparent)"
+      },
+      "componentScope": "content"
+    },
+    {
+      "cssVariable": "--dbx-content-pit-border-tone",
+      "source": "dbx-web",
+      "role": "misc",
+      "intents": [
+        "content pit border tone"
+      ],
+      "description": "Component-scoped override point (`content`) read in `packages/dbx-web/src/lib/layout/content/_content.scss` — set it (from an app, or via the owning dbx directive where one exists) to override; unset, it falls back to `8%`.",
+      "defaults": {
+        "light": "8%"
+      },
+      "componentScope": "content"
+    },
+    {
+      "cssVariable": "--dbx-content-pit-border-width",
+      "source": "dbx-web",
+      "role": "size",
+      "intents": [
+        "content pit border width"
+      ],
+      "description": "Component-scoped override point (`content`) read in `packages/dbx-web/src/lib/layout/content/_content.scss` — set it (from an app, or via the owning dbx directive where one exists) to override; unset, it falls back to `1px`.",
+      "defaults": {
+        "light": "1px"
+      },
+      "componentScope": "content"
+    },
     {
       "cssVariable": "--dbx-content-pit-opacity",
       "source": "dbx-web",

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

@@ -75,7 +75,7 @@
       "selector": "dbx-button",
       "className": "DbxButtonComponent",
       "module": "@dereekb/dbx-web",
-      "description": "Feature-rich button component that supports loading indicators, multiple Material button styles,\ncustom colors, icons, and floating action button (FAB) mode. Integrates with the dbxAction system\nfor automatic working/disabled state management.",
+      "description": "Feature-rich button component that supports loading indicators, multiple Material button styles,\ncustom colors, icons, and floating action button (FAB / extended FAB) mode. Integrates with the dbxAction system\nfor automatic working/disabled state management.",
       "inputs": [
         {
           "name": "bar",
@@ -165,7 +165,7 @@
         {
           "name": "fab",
           "type": "boolean",
-          "description": "",
+          "description": "Renders a Material FAB, or an extended FAB when the button has text. Combine with {@link iconOnly} for a round icon button.",
           "required": false,
           "default": "false"
         },
@@ -203,6 +203,52 @@
       "example": "<dbx-button [text]=\"'Save'\" raised [dbxAction]=\"saveAction\">\n</dbx-button>",
       "minimalExample": "<dbx-button text=\"Save\" raised [dbxAction]=\"saveAction\"></dbx-button>"
     },
+    {
+      "slug": "button-floating",
+      "category": "button",
+      "kind": "directive",
+      "selector": "[dbxButtonFloating]",
+      "className": "DbxButtonFloatingDirective",
+      "module": "@dereekb/dbx-web",
+      "description": "Floats its host — typically a `dbx-button` with `dbxActionButton`, or a wrapper holding several buttons — over the content\nby applying the `.dbx-button-floating` utility classes.\n\nIn the default `'sticky'` mode the host stays pinned to the edge of its scroll container while its parent section is on\nscreen, which suits a Save button at the end of a long form. Place the host at the end of its section for bottom positions and\nat the start for top positions. Sticky stops working when an ancestor between the host and the scroll container sets\n`overflow`. In `'fixed'` mode the host is pinned to the viewport; fixed positioning is re-anchored to any ancestor that sets\n`transform`, `filter` or `contain`.\n\nSet `fab` on the `dbx-button` for the Material FAB presentation (an extended FAB when it has text). Pair with\n`dbxActionEnforceModified` on the action to keep a floating Save button disabled until the form has changes.",
+      "inputs": [
+        {
+          "name": "dbxButtonFloating",
+          "type": "Maybe<DbxButtonFloatingConfig | DbxButtonFloatingPosition | ''>",
+          "description": "Config for the floating button, or a {@link DbxButtonFloatingPosition} shorthand. Empty when used as a bare attribute.",
+          "required": false
+        },
+        {
+          "name": "dbxButtonFloatingMode",
+          "type": "Maybe<DbxButtonFloatingMode>",
+          "description": "",
+          "required": false
+        },
+        {
+          "name": "dbxButtonFloatingPosition",
+          "type": "Maybe<DbxButtonFloatingPosition>",
+          "description": "",
+          "required": false
+        },
+        {
+          "name": "dbxButtonFloatingOffset",
+          "type": "Maybe<DbxButtonFloatingOffset>",
+          "description": "",
+          "required": false
+        }
+      ],
+      "outputs": [],
+      "relatedSlugs": [
+        "button",
+        "button-spacer",
+        "content-pit"
+      ],
+      "skillRefs": [
+        "dbx__ref__dbx-ui-building-blocks"
+      ],
+      "example": "<div dbxAction dbxActionEnforceModified [dbxActionHandler]=\"handleSave\">\n  <my-form dbxActionForm></my-form>\n  <dbx-button dbxButtonFloating fab color=\"primary\" icon=\"save\" text=\"Save\" dbxActionButton></dbx-button>\n</div>",
+      "minimalExample": "<dbx-button dbxButtonFloating fab color=\"primary\" icon=\"save\" text=\"Save\" dbxActionButton></dbx-button>"
+    },
     {
       "slug": "button-spacer",
       "category": "button",
@@ -757,7 +803,7 @@
       "selector": "dbx-progress-spinner-button,dbx-spinner-button",
       "className": "DbxProgressSpinnerButtonComponent",
       "module": "@dereekb/dbx-web",
-      "description": "Progress button that overlays a Material progress spinner on the button while working.\nSupports icon-only, FAB, and text button modes with automatic spinner sizing.",
+      "description": "Progress button that overlays a Material progress spinner on the button while working.\nSupports icon-only, FAB, extended FAB, and text button modes with automatic spinner sizing.\n\nA `fab` config renders a Material `mat-fab` — an extended FAB when the button has text — while `fab` + `iconOnly` renders a\nround icon button.",
       "inputs": [
         {
           "name": "config",

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

@@ -12369,6 +12369,44 @@
         "read-website-protocol"
       ]
     },
+    {
+      "slug": "website-url-relative-path-functions",
+      "name": "websiteUrlRelativePathFunctions",
+      "kind": "factory",
+      "category": "string",
+      "module": "@dereekb/util",
+      "subpath": "string/url",
+      "signature": "websiteUrlRelativePathFunctions(config: WebsiteUrlRelativePathFunctionsConfig): WebsiteUrlRelativePathFunctions",
+      "description": "Creates {@link WebsiteUrlRelativePathFunctions} for the configured base url.\n\nInputs may be the relative path (`dereekb`), a url without a protocol (`linkedin.com/in/dereekb`), or a full url (`https://www.linkedin.com/in/dereekb/?trk=abc`).\nDomains are compared case-insensitively and a leading `www.` is ignored. Query parameters and trailing slashes are removed from the relative path.",
+      "params": [
+        {
+          "name": "config",
+          "type": "WebsiteUrlRelativePathFunctionsConfig",
+          "description": "- The base url and protocol configuration.",
+          "optional": false
+        }
+      ],
+      "returns": "Functions for reading relative paths and building full website urls.",
+      "tags": [
+        "string",
+        "url",
+        "path",
+        "relative",
+        "base",
+        "slug",
+        "username",
+        "profile",
+        "factory",
+        "website",
+        "functions",
+        "websiteurlrelativepathfunctions"
+      ],
+      "example": "const linkedIn = websiteUrlRelativePathFunctions({ baseUrl: 'https://linkedin.com/in/' });\n\nlinkedIn.toRelativePath('linkedin.com/in/dereekb'); // 'dereekb'\nlinkedIn.toWebsiteUrl('dereekb'); // 'https://linkedin.com/in/dereekb'\nlinkedIn.toWebsiteUrl('https://twitter.com/dereekb'); // undefined",
+      "relatedSlugs": [
+        "isolate-website-path-function",
+        "website-url-details"
+      ]
+    },
     {
       "slug": "expand-flatten-tree-function",
       "name": "expandFlattenTreeFunction",

package/package.json

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