@treeui/mcp 0.1.0 → 0.1.1

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 TreeUI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/dist/{chunk-SNF26WKA.js → chunk-LDH2IV6Q.js}

@@ -1,8 +1,8 @@
 // src/generated/treeui.catalog.json
 var treeui_catalog_default = {
-  generatedAt: "2026-04-08T23:21:47.215Z",
+  generatedAt: "2026-04-10T16:42:52.904Z",
   packageName: "@treeui/vue",
-  packageVersion: "0.5.0",
+  packageVersion: "0.6.1",
   decisionGuides: [
     {
       id: "single-choice",
@@ -279,6 +279,37 @@ var treeui_catalog_default = {
         "Use `TCard` only when the stat needs additional arbitrary content."
       ]
     },
+    {
+      id: "color-field",
+      name: "Color field",
+      useWhen: [
+        "A form needs a color selection control without adding a dedicated TreeUI component."
+      ],
+      compose: [
+        "TFormField",
+        'native input[type="color"]'
+      ],
+      notes: [
+        "Wrap the native color input with `TFormField` for label, hint, and error handling."
+      ]
+    },
+    {
+      id: "tag-input",
+      name: "Tag input field",
+      useWhen: [
+        "A form needs freeform tag entry such as domains, labels, or emails."
+      ],
+      compose: [
+        "TFormField",
+        "TInput",
+        "TTag",
+        "TStack"
+      ],
+      notes: [
+        "Keep the draft value in app state and add a tag on Enter or separator keys.",
+        "Use removable `TTag` items below or inside the field wrapper."
+      ]
+    },
     {
       id: "data-listing",
       name: "Data table with paging",
@@ -291,7 +322,23 @@ var treeui_catalog_default = {
         "TStack"
       ],
       notes: [
-        "`TTable` stays focused on structured listing; filters and toolbars compose around it."
+        "`TTable` stays focused on structured listing; filters and toolbars compose around it.",
+        "Use `#cell-{key}` slots when a column renders derived or rich content."
+      ]
+    },
+    {
+      id: "router-backed-tabs",
+      name: "Router-backed tabs",
+      useWhen: [
+        "Tabs should deep-link to app state without turning into primary route navigation."
+      ],
+      compose: [
+        "TTabs",
+        "app router state"
+      ],
+      notes: [
+        "Bind `v-model` to a route param, query param, or derived route name in the app layer.",
+        "Prefer `TNavMenu` when the selection becomes app-section navigation instead of in-place panel switching."
       ]
     },
     {
@@ -309,6 +356,21 @@ var treeui_catalog_default = {
         "Use `TToast` only for the post-confirm success feedback."
       ]
     },
+    {
+      id: "chart-surface",
+      name: "Chart surface",
+      useWhen: [
+        "A screen needs data visualization, but the charting engine should stay external to TreeUI."
+      ],
+      compose: [
+        "TCard",
+        "TStack",
+        "external chart library"
+      ],
+      notes: [
+        "Use TreeUI for the surrounding surface, headings, badges, filters, and empty/loading states."
+      ]
+    },
     {
       id: "anchored-help",
       name: "Anchored help affordance",
@@ -409,7 +471,7 @@ var treeui_catalog_default = {
       TSelect: {
         required: [],
         notes: [
-          "Pass `options` as `{ label, value, disabled? }[]`.",
+          "Pass `options` as `{ label, value, disabled? }[]` where `value` can be `string` or `number`.",
           "Use `placeholder` when no selection has been made."
         ]
       },
@@ -487,6 +549,19 @@ var treeui_catalog_default = {
         notes: [
           "Pass `plans` matching the same core fields used by `TPricingCard`."
         ]
+      },
+      TModal: {
+        required: [],
+        notes: [
+          "Use `v-model:open` for the idiomatic Vue controlled pattern."
+        ]
+      },
+      TBreadcrumb: {
+        required: [],
+        notes: [
+          "Use `href` for native links.",
+          "Use `to` when the app has vue-router and breadcrumb items should render RouterLink."
+        ]
       }
     },
     appPatterns: {
@@ -774,6 +849,19 @@ var treeui_catalog_default = {
             "danger"
           ]
         },
+        {
+          name: "tone",
+          type: "TreeBadgeTone",
+          default: "neutral",
+          values: [
+            "neutral",
+            "success",
+            "warning",
+            "danger",
+            "info"
+          ],
+          description: "Optional semantic tone layered on top of the visual variant."
+        },
         {
           name: "size",
           type: "TreeSize",
@@ -858,7 +946,10 @@ var treeui_catalog_default = {
       },
       setup: {
         required: [],
-        notes: []
+        notes: [
+          "Use `href` for native links.",
+          "Use `to` when the app has vue-router and breadcrumb items should render RouterLink."
+        ]
       },
       recipes: []
     },
@@ -988,7 +1079,8 @@ var treeui_catalog_default = {
           values: [
             "outline",
             "soft",
-            "solid"
+            "solid",
+            "inset"
           ]
         },
         {
@@ -1000,6 +1092,12 @@ var treeui_catalog_default = {
             "md",
             "lg"
           ]
+        },
+        {
+          name: "title",
+          type: "string",
+          default: "undefined",
+          description: "Optional card heading rendered inside the header area."
         }
       ],
       events: [],
@@ -1007,6 +1105,9 @@ var treeui_catalog_default = {
         {
           name: "header"
         },
+        {
+          name: "actions"
+        },
         {
           name: "default"
         },
@@ -1047,7 +1148,9 @@ var treeui_catalog_default = {
         required: [],
         notes: []
       },
-      recipes: []
+      recipes: [
+        "chart-surface"
+      ]
     },
     {
       name: "TCheckbox",
@@ -2693,6 +2796,8 @@ var treeui_catalog_default = {
         "form-field-input",
         "searchable-multi-choice",
         "date-range-form",
+        "color-field",
+        "tag-input",
         "hierarchy-picker"
       ]
     },
@@ -2910,9 +3015,85 @@ var treeui_catalog_default = {
         notes: []
       },
       recipes: [
-        "form-field-input"
+        "form-field-input",
+        "tag-input"
       ]
     },
+    {
+      name: "TLink",
+      legacyAlias: "TreeLink",
+      aliases: [
+        "TreeLink"
+      ],
+      package: "@treeui/vue",
+      kind: "navigation",
+      category: "Navigation",
+      status: "available",
+      purpose: "Inline link with consistent styling, optional RouterLink rendering, and external link support.",
+      sourceFile: "packages/vue/src/components/TreeLink.vue",
+      storyFile: "apps/docs/src/stories/Link.stories.ts",
+      storyTitle: "Components/Navigation/Link",
+      manifestFile: "docs/ai/COMPONENTS/link.yaml",
+      props: [
+        {
+          name: "to",
+          type: "string | Record<string, unknown>",
+          default: "undefined",
+          description: "Route target. When provided and vue-router is available, renders RouterLink."
+        },
+        {
+          name: "href",
+          type: "string",
+          default: "undefined",
+          description: "Native href for anchor elements. Ignored when `to` is provided with vue-router."
+        },
+        {
+          name: "external",
+          type: "boolean",
+          default: "false",
+          description: "Opens link in new tab with rel='noopener noreferrer'."
+        },
+        {
+          name: "disabled",
+          type: "boolean",
+          default: "false"
+        },
+        {
+          name: "variant",
+          type: "TreeLinkVariant",
+          default: "default",
+          values: [
+            "default",
+            "muted",
+            "danger"
+          ]
+        }
+      ],
+      events: [],
+      slots: [
+        {
+          name: "default"
+        }
+      ],
+      a11y: [
+        "semantic_element: a (or RouterLink, or span when disabled)",
+        "aria_disabled: set when disabled",
+        "tabindex: -1 when disabled",
+        "focus_visible: true"
+      ],
+      behavior: [],
+      selection: {
+        keywords: [],
+        useWhen: [],
+        avoidWhen: [],
+        alternatives: []
+      },
+      setup: {
+        required: [],
+        notes: []
+      },
+      recipes: []
+    },
     {
       name: "TMarkdownEditor",
       legacyAlias: "TreeMarkdownEditor",
@@ -3163,7 +3344,9 @@ var treeui_catalog_default = {
       },
       setup: {
         required: [],
-        notes: []
+        notes: [
+          "Use `v-model:open` for the idiomatic Vue controlled pattern."
+        ]
       },
       recipes: []
     },
@@ -3440,7 +3623,7 @@ var treeui_catalog_default = {
       kind: "navigation",
       category: "Layout",
       status: "available",
-      purpose: "App-section navigation menu with roving focus, optional badges, and sidebar-aware collapsed mode.",
+      purpose: "Vertical navigation menu with selection state, keyboard navigation, optional RouterLink rendering, and sidebar integration.",
       sourceFile: "packages/vue/src/components/TreeNavMenu.vue",
       storyFile: "apps/docs/src/stories/NavMenu.stories.ts",
       storyTitle: "Components/Layout/NavMenu",
@@ -3460,7 +3643,7 @@ var treeui_catalog_default = {
           name: "items",
           type: "TreeNavMenuItem[]",
           default: "[]",
-          note: "Array of `{ label, value, shortLabel?, description?, badge?, disabled? }`."
+          note: "Array of `{ label, value, shortLabel?, description?, icon?, to?, badge?, disabled? }`."
         },
         {
           name: "size",
@@ -3504,7 +3687,9 @@ var treeui_catalog_default = {
         "roving_focus: true",
         "home_end_navigation: true",
         "arrow_navigation: true",
-        "activation_keys_select_item: true"
+        "activation_keys_select_item: true",
+        "aria_current: page on selected item",
+        "aria_disabled: on link items when disabled"
       ],
       behavior: [
         "can_be_controlled_or_uncontrolled: true",
@@ -4306,14 +4491,14 @@ var treeui_catalog_default = {
       props: [
         {
           name: "modelValue",
-          type: "string",
+          type: "string | number",
           default: ""
         },
         {
           name: "options",
           type: "TreeSelectOption[]",
           default: "[]",
-          note: "Array of { label: string; value: string; disabled?: boolean }"
+          note: "Array of { label: string; value: string | number; disabled?: boolean }"
         },
         {
           name: "open",
@@ -4387,13 +4572,14 @@ var treeui_catalog_default = {
         "home_end_navigation: true"
       ],
       behavior: [
-        "update_payload_type: string",
+        "update_payload_type: string | number",
         "loading_does_not_disable_by_itself: true",
         "placeholder_shown_as_muted_text: true",
         "chevron_rotates_when_open: true",
         "check_icon_on_selected_option: true",
         "outside_click_closes_dropdown: true",
-        "focus_restores_on_close: true"
+        "focus_restores_on_close: true",
+        "numeric_values_supported_without_string_coercion: true"
       ],
       selection: {
         keywords: [
@@ -4422,7 +4608,7 @@ var treeui_catalog_default = {
       setup: {
         required: [],
         notes: [
-          "Pass `options` as `{ label, value, disabled? }[]`.",
+          "Pass `options` as `{ label, value, disabled? }[]` where `value` can be `string` or `number`.",
           "Use `placeholder` when no selection has been made."
         ]
       },
@@ -4900,7 +5086,9 @@ var treeui_catalog_default = {
         notes: []
       },
       recipes: [
-        "data-listing"
+        "tag-input",
+        "data-listing",
+        "chart-surface"
       ]
     },
     {
@@ -4960,6 +5148,11 @@ var treeui_catalog_default = {
             "down",
             "neutral"
           ]
+        },
+        {
+          name: "loading",
+          type: "boolean",
+          default: "false"
         }
       ],
       events: [],
@@ -4987,7 +5180,8 @@ var treeui_catalog_default = {
       behavior: [
         "value_and_trend_are_optional: true",
         "icon_slot_adds_visual_emphasis: true",
-        "trend_indicator_changes_with_direction: true"
+        "trend_indicator_changes_with_direction: true",
+        "loading_renders_internal_skeleton_placeholders: true"
       ],
       selection: {
         keywords: [
@@ -5425,7 +5619,9 @@ var treeui_catalog_default = {
         required: [],
         notes: []
       },
-      recipes: []
+      recipes: [
+        "router-backed-tabs"
+      ]
     },
     {
       name: "TTag",
@@ -5506,7 +5702,9 @@ var treeui_catalog_default = {
         required: [],
         notes: []
       },
-      recipes: []
+      recipes: [
+        "tag-input"
+      ]
     },
     {
       name: "TTextarea",

package/dist/cli.cjs

@@ -34,9 +34,9 @@ var import_server = require("@modelcontextprotocol/sdk/server/index.js");
 
 // src/generated/treeui.catalog.json
 var treeui_catalog_default = {
-  generatedAt: "2026-04-08T23:21:47.215Z",
+  generatedAt: "2026-04-10T16:42:52.904Z",
   packageName: "@treeui/vue",
-  packageVersion: "0.5.0",
+  packageVersion: "0.6.1",
   decisionGuides: [
     {
       id: "single-choice",
@@ -313,6 +313,37 @@ var treeui_catalog_default = {
         "Use `TCard` only when the stat needs additional arbitrary content."
       ]
     },
+    {
+      id: "color-field",
+      name: "Color field",
+      useWhen: [
+        "A form needs a color selection control without adding a dedicated TreeUI component."
+      ],
+      compose: [
+        "TFormField",
+        'native input[type="color"]'
+      ],
+      notes: [
+        "Wrap the native color input with `TFormField` for label, hint, and error handling."
+      ]
+    },
+    {
+      id: "tag-input",
+      name: "Tag input field",
+      useWhen: [
+        "A form needs freeform tag entry such as domains, labels, or emails."
+      ],
+      compose: [
+        "TFormField",
+        "TInput",
+        "TTag",
+        "TStack"
+      ],
+      notes: [
+        "Keep the draft value in app state and add a tag on Enter or separator keys.",
+        "Use removable `TTag` items below or inside the field wrapper."
+      ]
+    },
     {
       id: "data-listing",
       name: "Data table with paging",
@@ -325,7 +356,23 @@ var treeui_catalog_default = {
         "TStack"
       ],
       notes: [
-        "`TTable` stays focused on structured listing; filters and toolbars compose around it."
+        "`TTable` stays focused on structured listing; filters and toolbars compose around it.",
+        "Use `#cell-{key}` slots when a column renders derived or rich content."
+      ]
+    },
+    {
+      id: "router-backed-tabs",
+      name: "Router-backed tabs",
+      useWhen: [
+        "Tabs should deep-link to app state without turning into primary route navigation."
+      ],
+      compose: [
+        "TTabs",
+        "app router state"
+      ],
+      notes: [
+        "Bind `v-model` to a route param, query param, or derived route name in the app layer.",
+        "Prefer `TNavMenu` when the selection becomes app-section navigation instead of in-place panel switching."
       ]
     },
     {
@@ -343,6 +390,21 @@ var treeui_catalog_default = {
         "Use `TToast` only for the post-confirm success feedback."
       ]
     },
+    {
+      id: "chart-surface",
+      name: "Chart surface",
+      useWhen: [
+        "A screen needs data visualization, but the charting engine should stay external to TreeUI."
+      ],
+      compose: [
+        "TCard",
+        "TStack",
+        "external chart library"
+      ],
+      notes: [
+        "Use TreeUI for the surrounding surface, headings, badges, filters, and empty/loading states."
+      ]
+    },
     {
       id: "anchored-help",
       name: "Anchored help affordance",
@@ -443,7 +505,7 @@ var treeui_catalog_default = {
       TSelect: {
         required: [],
         notes: [
-          "Pass `options` as `{ label, value, disabled? }[]`.",
+          "Pass `options` as `{ label, value, disabled? }[]` where `value` can be `string` or `number`.",
           "Use `placeholder` when no selection has been made."
         ]
       },
@@ -521,6 +583,19 @@ var treeui_catalog_default = {
         notes: [
           "Pass `plans` matching the same core fields used by `TPricingCard`."
         ]
+      },
+      TModal: {
+        required: [],
+        notes: [
+          "Use `v-model:open` for the idiomatic Vue controlled pattern."
+        ]
+      },
+      TBreadcrumb: {
+        required: [],
+        notes: [
+          "Use `href` for native links.",
+          "Use `to` when the app has vue-router and breadcrumb items should render RouterLink."
+        ]
       }
     },
     appPatterns: {
@@ -808,6 +883,19 @@ var treeui_catalog_default = {
             "danger"
           ]
         },
+        {
+          name: "tone",
+          type: "TreeBadgeTone",
+          default: "neutral",
+          values: [
+            "neutral",
+            "success",
+            "warning",
+            "danger",
+            "info"
+          ],
+          description: "Optional semantic tone layered on top of the visual variant."
+        },
         {
           name: "size",
           type: "TreeSize",
@@ -892,7 +980,10 @@ var treeui_catalog_default = {
       },
       setup: {
         required: [],
-        notes: []
+        notes: [
+          "Use `href` for native links.",
+          "Use `to` when the app has vue-router and breadcrumb items should render RouterLink."
+        ]
       },
       recipes: []
     },
@@ -1022,7 +1113,8 @@ var treeui_catalog_default = {
           values: [
             "outline",
             "soft",
-            "solid"
+            "solid",
+            "inset"
           ]
         },
         {
@@ -1034,6 +1126,12 @@ var treeui_catalog_default = {
             "md",
             "lg"
           ]
+        },
+        {
+          name: "title",
+          type: "string",
+          default: "undefined",
+          description: "Optional card heading rendered inside the header area."
         }
       ],
       events: [],
@@ -1041,6 +1139,9 @@ var treeui_catalog_default = {
         {
           name: "header"
         },
+        {
+          name: "actions"
+        },
         {
           name: "default"
         },
@@ -1081,7 +1182,9 @@ var treeui_catalog_default = {
         required: [],
         notes: []
       },
-      recipes: []
+      recipes: [
+        "chart-surface"
+      ]
     },
     {
       name: "TCheckbox",
@@ -2727,6 +2830,8 @@ var treeui_catalog_default = {
         "form-field-input",
         "searchable-multi-choice",
         "date-range-form",
+        "color-field",
+        "tag-input",
         "hierarchy-picker"
       ]
     },
@@ -2944,9 +3049,85 @@ var treeui_catalog_default = {
         notes: []
       },
       recipes: [
-        "form-field-input"
+        "form-field-input",
+        "tag-input"
       ]
     },
+    {
+      name: "TLink",
+      legacyAlias: "TreeLink",
+      aliases: [
+        "TreeLink"
+      ],
+      package: "@treeui/vue",
+      kind: "navigation",
+      category: "Navigation",
+      status: "available",
+      purpose: "Inline link with consistent styling, optional RouterLink rendering, and external link support.",
+      sourceFile: "packages/vue/src/components/TreeLink.vue",
+      storyFile: "apps/docs/src/stories/Link.stories.ts",
+      storyTitle: "Components/Navigation/Link",
+      manifestFile: "docs/ai/COMPONENTS/link.yaml",
+      props: [
+        {
+          name: "to",
+          type: "string | Record<string, unknown>",
+          default: "undefined",
+          description: "Route target. When provided and vue-router is available, renders RouterLink."
+        },
+        {
+          name: "href",
+          type: "string",
+          default: "undefined",
+          description: "Native href for anchor elements. Ignored when `to` is provided with vue-router."
+        },
+        {
+          name: "external",
+          type: "boolean",
+          default: "false",
+          description: "Opens link in new tab with rel='noopener noreferrer'."
+        },
+        {
+          name: "disabled",
+          type: "boolean",
+          default: "false"
+        },
+        {
+          name: "variant",
+          type: "TreeLinkVariant",
+          default: "default",
+          values: [
+            "default",
+            "muted",
+            "danger"
+          ]
+        }
+      ],
+      events: [],
+      slots: [
+        {
+          name: "default"
+        }
+      ],
+      a11y: [
+        "semantic_element: a (or RouterLink, or span when disabled)",
+        "aria_disabled: set when disabled",
+        "tabindex: -1 when disabled",
+        "focus_visible: true"
+      ],
+      behavior: [],
+      selection: {
+        keywords: [],
+        useWhen: [],
+        avoidWhen: [],
+        alternatives: []
+      },
+      setup: {
+        required: [],
+        notes: []
+      },
+      recipes: []
+    },
     {
       name: "TMarkdownEditor",
       legacyAlias: "TreeMarkdownEditor",
@@ -3197,7 +3378,9 @@ var treeui_catalog_default = {
       },
       setup: {
         required: [],
-        notes: []
+        notes: [
+          "Use `v-model:open` for the idiomatic Vue controlled pattern."
+        ]
       },
       recipes: []
     },
@@ -3474,7 +3657,7 @@ var treeui_catalog_default = {
       kind: "navigation",
       category: "Layout",
       status: "available",
-      purpose: "App-section navigation menu with roving focus, optional badges, and sidebar-aware collapsed mode.",
+      purpose: "Vertical navigation menu with selection state, keyboard navigation, optional RouterLink rendering, and sidebar integration.",
       sourceFile: "packages/vue/src/components/TreeNavMenu.vue",
       storyFile: "apps/docs/src/stories/NavMenu.stories.ts",
       storyTitle: "Components/Layout/NavMenu",
@@ -3494,7 +3677,7 @@ var treeui_catalog_default = {
           name: "items",
           type: "TreeNavMenuItem[]",
           default: "[]",
-          note: "Array of `{ label, value, shortLabel?, description?, badge?, disabled? }`."
+          note: "Array of `{ label, value, shortLabel?, description?, icon?, to?, badge?, disabled? }`."
         },
         {
           name: "size",
@@ -3538,7 +3721,9 @@ var treeui_catalog_default = {
         "roving_focus: true",
         "home_end_navigation: true",
         "arrow_navigation: true",
-        "activation_keys_select_item: true"
+        "activation_keys_select_item: true",
+        "aria_current: page on selected item",
+        "aria_disabled: on link items when disabled"
       ],
       behavior: [
         "can_be_controlled_or_uncontrolled: true",
@@ -4340,14 +4525,14 @@ var treeui_catalog_default = {
       props: [
         {
           name: "modelValue",
-          type: "string",
+          type: "string | number",
           default: ""
         },
         {
           name: "options",
           type: "TreeSelectOption[]",
           default: "[]",
-          note: "Array of { label: string; value: string; disabled?: boolean }"
+          note: "Array of { label: string; value: string | number; disabled?: boolean }"
         },
         {
           name: "open",
@@ -4421,13 +4606,14 @@ var treeui_catalog_default = {
         "home_end_navigation: true"
       ],
       behavior: [
-        "update_payload_type: string",
+        "update_payload_type: string | number",
         "loading_does_not_disable_by_itself: true",
         "placeholder_shown_as_muted_text: true",
         "chevron_rotates_when_open: true",
         "check_icon_on_selected_option: true",
         "outside_click_closes_dropdown: true",
-        "focus_restores_on_close: true"
+        "focus_restores_on_close: true",
+        "numeric_values_supported_without_string_coercion: true"
       ],
       selection: {
         keywords: [
@@ -4456,7 +4642,7 @@ var treeui_catalog_default = {
       setup: {
         required: [],
         notes: [
-          "Pass `options` as `{ label, value, disabled? }[]`.",
+          "Pass `options` as `{ label, value, disabled? }[]` where `value` can be `string` or `number`.",
           "Use `placeholder` when no selection has been made."
         ]
       },
@@ -4934,7 +5120,9 @@ var treeui_catalog_default = {
         notes: []
       },
       recipes: [
-        "data-listing"
+        "tag-input",
+        "data-listing",
+        "chart-surface"
       ]
     },
     {
@@ -4994,6 +5182,11 @@ var treeui_catalog_default = {
             "down",
             "neutral"
           ]
+        },
+        {
+          name: "loading",
+          type: "boolean",
+          default: "false"
         }
       ],
       events: [],
@@ -5021,7 +5214,8 @@ var treeui_catalog_default = {
       behavior: [
         "value_and_trend_are_optional: true",
         "icon_slot_adds_visual_emphasis: true",
-        "trend_indicator_changes_with_direction: true"
+        "trend_indicator_changes_with_direction: true",
+        "loading_renders_internal_skeleton_placeholders: true"
       ],
       selection: {
         keywords: [
@@ -5459,7 +5653,9 @@ var treeui_catalog_default = {
         required: [],
         notes: []
       },
-      recipes: []
+      recipes: [
+        "router-backed-tabs"
+      ]
     },
     {
       name: "TTag",
@@ -5540,7 +5736,9 @@ var treeui_catalog_default = {
         required: [],
         notes: []
       },
-      recipes: []
+      recipes: [
+        "tag-input"
+      ]
     },
     {
       name: "TTextarea",

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   createTreeuiMcpServer
-} from "./chunk-SNF26WKA.js";
+} from "./chunk-LDH2IV6Q.js";
 
 // src/cli.ts
 import process from "process";

package/dist/index.cjs

@@ -47,9 +47,9 @@ module.exports = __toCommonJS(index_exports);
 
 // src/generated/treeui.catalog.json
 var treeui_catalog_default = {
-  generatedAt: "2026-04-08T23:21:47.215Z",
+  generatedAt: "2026-04-10T16:42:52.904Z",
   packageName: "@treeui/vue",
-  packageVersion: "0.5.0",
+  packageVersion: "0.6.1",
   decisionGuides: [
     {
       id: "single-choice",
@@ -326,6 +326,37 @@ var treeui_catalog_default = {
         "Use `TCard` only when the stat needs additional arbitrary content."
       ]
     },
+    {
+      id: "color-field",
+      name: "Color field",
+      useWhen: [
+        "A form needs a color selection control without adding a dedicated TreeUI component."
+      ],
+      compose: [
+        "TFormField",
+        'native input[type="color"]'
+      ],
+      notes: [
+        "Wrap the native color input with `TFormField` for label, hint, and error handling."
+      ]
+    },
+    {
+      id: "tag-input",
+      name: "Tag input field",
+      useWhen: [
+        "A form needs freeform tag entry such as domains, labels, or emails."
+      ],
+      compose: [
+        "TFormField",
+        "TInput",
+        "TTag",
+        "TStack"
+      ],
+      notes: [
+        "Keep the draft value in app state and add a tag on Enter or separator keys.",
+        "Use removable `TTag` items below or inside the field wrapper."
+      ]
+    },
     {
       id: "data-listing",
       name: "Data table with paging",
@@ -338,7 +369,23 @@ var treeui_catalog_default = {
         "TStack"
       ],
       notes: [
-        "`TTable` stays focused on structured listing; filters and toolbars compose around it."
+        "`TTable` stays focused on structured listing; filters and toolbars compose around it.",
+        "Use `#cell-{key}` slots when a column renders derived or rich content."
+      ]
+    },
+    {
+      id: "router-backed-tabs",
+      name: "Router-backed tabs",
+      useWhen: [
+        "Tabs should deep-link to app state without turning into primary route navigation."
+      ],
+      compose: [
+        "TTabs",
+        "app router state"
+      ],
+      notes: [
+        "Bind `v-model` to a route param, query param, or derived route name in the app layer.",
+        "Prefer `TNavMenu` when the selection becomes app-section navigation instead of in-place panel switching."
       ]
     },
     {
@@ -356,6 +403,21 @@ var treeui_catalog_default = {
         "Use `TToast` only for the post-confirm success feedback."
       ]
     },
+    {
+      id: "chart-surface",
+      name: "Chart surface",
+      useWhen: [
+        "A screen needs data visualization, but the charting engine should stay external to TreeUI."
+      ],
+      compose: [
+        "TCard",
+        "TStack",
+        "external chart library"
+      ],
+      notes: [
+        "Use TreeUI for the surrounding surface, headings, badges, filters, and empty/loading states."
+      ]
+    },
     {
       id: "anchored-help",
       name: "Anchored help affordance",
@@ -456,7 +518,7 @@ var treeui_catalog_default = {
       TSelect: {
         required: [],
         notes: [
-          "Pass `options` as `{ label, value, disabled? }[]`.",
+          "Pass `options` as `{ label, value, disabled? }[]` where `value` can be `string` or `number`.",
           "Use `placeholder` when no selection has been made."
         ]
       },
@@ -534,6 +596,19 @@ var treeui_catalog_default = {
         notes: [
           "Pass `plans` matching the same core fields used by `TPricingCard`."
         ]
+      },
+      TModal: {
+        required: [],
+        notes: [
+          "Use `v-model:open` for the idiomatic Vue controlled pattern."
+        ]
+      },
+      TBreadcrumb: {
+        required: [],
+        notes: [
+          "Use `href` for native links.",
+          "Use `to` when the app has vue-router and breadcrumb items should render RouterLink."
+        ]
       }
     },
     appPatterns: {
@@ -821,6 +896,19 @@ var treeui_catalog_default = {
             "danger"
           ]
         },
+        {
+          name: "tone",
+          type: "TreeBadgeTone",
+          default: "neutral",
+          values: [
+            "neutral",
+            "success",
+            "warning",
+            "danger",
+            "info"
+          ],
+          description: "Optional semantic tone layered on top of the visual variant."
+        },
         {
           name: "size",
           type: "TreeSize",
@@ -905,7 +993,10 @@ var treeui_catalog_default = {
       },
       setup: {
         required: [],
-        notes: []
+        notes: [
+          "Use `href` for native links.",
+          "Use `to` when the app has vue-router and breadcrumb items should render RouterLink."
+        ]
       },
       recipes: []
     },
@@ -1035,7 +1126,8 @@ var treeui_catalog_default = {
           values: [
             "outline",
             "soft",
-            "solid"
+            "solid",
+            "inset"
           ]
         },
         {
@@ -1047,6 +1139,12 @@ var treeui_catalog_default = {
             "md",
             "lg"
           ]
+        },
+        {
+          name: "title",
+          type: "string",
+          default: "undefined",
+          description: "Optional card heading rendered inside the header area."
         }
       ],
       events: [],
@@ -1054,6 +1152,9 @@ var treeui_catalog_default = {
         {
           name: "header"
         },
+        {
+          name: "actions"
+        },
         {
           name: "default"
         },
@@ -1094,7 +1195,9 @@ var treeui_catalog_default = {
         required: [],
         notes: []
       },
-      recipes: []
+      recipes: [
+        "chart-surface"
+      ]
     },
     {
       name: "TCheckbox",
@@ -2740,6 +2843,8 @@ var treeui_catalog_default = {
         "form-field-input",
         "searchable-multi-choice",
         "date-range-form",
+        "color-field",
+        "tag-input",
         "hierarchy-picker"
       ]
     },
@@ -2957,9 +3062,85 @@ var treeui_catalog_default = {
         notes: []
       },
       recipes: [
-        "form-field-input"
+        "form-field-input",
+        "tag-input"
       ]
     },
+    {
+      name: "TLink",
+      legacyAlias: "TreeLink",
+      aliases: [
+        "TreeLink"
+      ],
+      package: "@treeui/vue",
+      kind: "navigation",
+      category: "Navigation",
+      status: "available",
+      purpose: "Inline link with consistent styling, optional RouterLink rendering, and external link support.",
+      sourceFile: "packages/vue/src/components/TreeLink.vue",
+      storyFile: "apps/docs/src/stories/Link.stories.ts",
+      storyTitle: "Components/Navigation/Link",
+      manifestFile: "docs/ai/COMPONENTS/link.yaml",
+      props: [
+        {
+          name: "to",
+          type: "string | Record<string, unknown>",
+          default: "undefined",
+          description: "Route target. When provided and vue-router is available, renders RouterLink."
+        },
+        {
+          name: "href",
+          type: "string",
+          default: "undefined",
+          description: "Native href for anchor elements. Ignored when `to` is provided with vue-router."
+        },
+        {
+          name: "external",
+          type: "boolean",
+          default: "false",
+          description: "Opens link in new tab with rel='noopener noreferrer'."
+        },
+        {
+          name: "disabled",
+          type: "boolean",
+          default: "false"
+        },
+        {
+          name: "variant",
+          type: "TreeLinkVariant",
+          default: "default",
+          values: [
+            "default",
+            "muted",
+            "danger"
+          ]
+        }
+      ],
+      events: [],
+      slots: [
+        {
+          name: "default"
+        }
+      ],
+      a11y: [
+        "semantic_element: a (or RouterLink, or span when disabled)",
+        "aria_disabled: set when disabled",
+        "tabindex: -1 when disabled",
+        "focus_visible: true"
+      ],
+      behavior: [],
+      selection: {
+        keywords: [],
+        useWhen: [],
+        avoidWhen: [],
+        alternatives: []
+      },
+      setup: {
+        required: [],
+        notes: []
+      },
+      recipes: []
+    },
     {
       name: "TMarkdownEditor",
       legacyAlias: "TreeMarkdownEditor",
@@ -3210,7 +3391,9 @@ var treeui_catalog_default = {
       },
       setup: {
         required: [],
-        notes: []
+        notes: [
+          "Use `v-model:open` for the idiomatic Vue controlled pattern."
+        ]
       },
       recipes: []
     },
@@ -3487,7 +3670,7 @@ var treeui_catalog_default = {
       kind: "navigation",
       category: "Layout",
       status: "available",
-      purpose: "App-section navigation menu with roving focus, optional badges, and sidebar-aware collapsed mode.",
+      purpose: "Vertical navigation menu with selection state, keyboard navigation, optional RouterLink rendering, and sidebar integration.",
       sourceFile: "packages/vue/src/components/TreeNavMenu.vue",
       storyFile: "apps/docs/src/stories/NavMenu.stories.ts",
       storyTitle: "Components/Layout/NavMenu",
@@ -3507,7 +3690,7 @@ var treeui_catalog_default = {
           name: "items",
           type: "TreeNavMenuItem[]",
           default: "[]",
-          note: "Array of `{ label, value, shortLabel?, description?, badge?, disabled? }`."
+          note: "Array of `{ label, value, shortLabel?, description?, icon?, to?, badge?, disabled? }`."
         },
         {
           name: "size",
@@ -3551,7 +3734,9 @@ var treeui_catalog_default = {
         "roving_focus: true",
         "home_end_navigation: true",
         "arrow_navigation: true",
-        "activation_keys_select_item: true"
+        "activation_keys_select_item: true",
+        "aria_current: page on selected item",
+        "aria_disabled: on link items when disabled"
       ],
       behavior: [
         "can_be_controlled_or_uncontrolled: true",
@@ -4353,14 +4538,14 @@ var treeui_catalog_default = {
       props: [
         {
           name: "modelValue",
-          type: "string",
+          type: "string | number",
           default: ""
         },
         {
           name: "options",
           type: "TreeSelectOption[]",
           default: "[]",
-          note: "Array of { label: string; value: string; disabled?: boolean }"
+          note: "Array of { label: string; value: string | number; disabled?: boolean }"
         },
         {
           name: "open",
@@ -4434,13 +4619,14 @@ var treeui_catalog_default = {
         "home_end_navigation: true"
       ],
       behavior: [
-        "update_payload_type: string",
+        "update_payload_type: string | number",
         "loading_does_not_disable_by_itself: true",
         "placeholder_shown_as_muted_text: true",
         "chevron_rotates_when_open: true",
         "check_icon_on_selected_option: true",
         "outside_click_closes_dropdown: true",
-        "focus_restores_on_close: true"
+        "focus_restores_on_close: true",
+        "numeric_values_supported_without_string_coercion: true"
       ],
       selection: {
         keywords: [
@@ -4469,7 +4655,7 @@ var treeui_catalog_default = {
       setup: {
         required: [],
         notes: [
-          "Pass `options` as `{ label, value, disabled? }[]`.",
+          "Pass `options` as `{ label, value, disabled? }[]` where `value` can be `string` or `number`.",
           "Use `placeholder` when no selection has been made."
         ]
       },
@@ -4947,7 +5133,9 @@ var treeui_catalog_default = {
         notes: []
       },
       recipes: [
-        "data-listing"
+        "tag-input",
+        "data-listing",
+        "chart-surface"
       ]
     },
     {
@@ -5007,6 +5195,11 @@ var treeui_catalog_default = {
             "down",
             "neutral"
           ]
+        },
+        {
+          name: "loading",
+          type: "boolean",
+          default: "false"
         }
       ],
       events: [],
@@ -5034,7 +5227,8 @@ var treeui_catalog_default = {
       behavior: [
         "value_and_trend_are_optional: true",
         "icon_slot_adds_visual_emphasis: true",
-        "trend_indicator_changes_with_direction: true"
+        "trend_indicator_changes_with_direction: true",
+        "loading_renders_internal_skeleton_placeholders: true"
       ],
       selection: {
         keywords: [
@@ -5472,7 +5666,9 @@ var treeui_catalog_default = {
         required: [],
         notes: []
       },
-      recipes: []
+      recipes: [
+        "router-backed-tabs"
+      ]
     },
     {
       name: "TTag",
@@ -5553,7 +5749,9 @@ var treeui_catalog_default = {
         required: [],
         notes: []
       },
-      recipes: []
+      recipes: [
+        "tag-input"
+      ]
     },
     {
       name: "TTextarea",

package/dist/index.js

@@ -9,7 +9,7 @@ import {
   recommendComponents,
   searchComponents,
   searchRecipes
-} from "./chunk-SNF26WKA.js";
+} from "./chunk-LDH2IV6Q.js";
 
 // src/catalog-source.ts
 import fs from "fs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@treeui/mcp",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Model Context Protocol server and AI catalog for TreeUI.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -19,15 +19,15 @@
   "files": [
     "dist"
   ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.17.4",
+    "yaml": "^2.8.1"
+  },
   "scripts": {
     "generate:catalog": "node --import tsx scripts/generate-catalog.ts",
     "build": "pnpm run generate:catalog && pnpm exec rimraf dist && pnpm exec tsup src/index.ts src/cli.ts --format esm,cjs --dts",
     "start": "node --import tsx src/cli.ts",
     "test": "pnpm -w exec vitest run packages/mcp/src/catalog.test.ts packages/mcp/src/server.test.ts",
     "typecheck": "pnpm exec tsc -p tsconfig.json --noEmit"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.17.4",
-    "yaml": "^2.8.1"
   }
-}
+}