@treeui/mcp 0.4.0 → 0.4.1

package/dist/index.cjs

@@ -47,9 +47,9 @@ module.exports = __toCommonJS(index_exports);
 
 // src/generated/treeui.catalog.json
 var treeui_catalog_default = {
-  generatedAt: "2026-07-18T01:52:38.578Z",
+  generatedAt: "2026-07-18T19:02:09.022Z",
   packageName: "@treeui/vue",
-  packageVersion: "0.14.0",
+  packageVersion: "0.15.0",
   decisionGuides: [
     {
       id: "single-choice",
@@ -993,6 +993,22 @@ var treeui_catalog_default = {
           type: "boolean",
           default: "true"
         },
+        {
+          name: "showCollapseButton",
+          type: "boolean",
+          default: "true",
+          note: "Renders the built-in collapse toggle in the sidebar footer. Desktop only, and only when `collapsible` is set \u2014 no need to wire your own."
+        },
+        {
+          name: "collapseLabel",
+          type: "string",
+          default: "Collapse sidebar"
+        },
+        {
+          name: "expandLabel",
+          type: "string",
+          default: "Expand sidebar"
+        },
         {
           name: "menuLabel",
           type: "string",
@@ -1027,14 +1043,26 @@ var treeui_catalog_default = {
         {
           name: "header"
         },
+        {
+          name: "header-start"
+        },
+        {
+          name: "sidebar-header"
+        },
         {
           name: "sidebar"
         },
+        {
+          name: "sidebar-footer"
+        },
         {
           name: "default"
         },
         {
           name: "menu-icon"
+        },
+        {
+          name: "collapse-icon"
         }
       ],
       a11y: [
@@ -1062,7 +1090,10 @@ var treeui_catalog_default = {
         "left_and_right_variants: true",
         "locks_body_scroll_while_drawer_open: true",
         "overlay_click_closes_when_enabled: true",
-        "exposes_slot_props_with_mobile_collapsed_and_toggles: true"
+        "exposes_slot_props_with_mobile_collapsed_and_toggles: true",
+        "sidebar_footer_pinned_to_bottom: true",
+        "sidebar_header_and_footer_inset_to_align_with_nav_icons: true",
+        "header_mirrors_shell_columns_when_header_start_is_used: true"
       ],
       selection: {
         keywords: [
@@ -1371,6 +1402,18 @@ var treeui_catalog_default = {
           name: "type",
           type: "button | submit | reset",
           default: "button"
+        },
+        {
+          name: "block",
+          type: "boolean",
+          default: "false",
+          note: "Stretches the button to the full width of its container. Useful for menu rows and mobile CTAs."
+        },
+        {
+          name: "align",
+          type: "start | center | end",
+          default: "center",
+          note: "Content alignment; only meaningful together with `block`. Use `start` for left-aligned icon+label menu rows."
         }
       ],
       events: [
@@ -1436,7 +1479,6 @@ var treeui_catalog_default = {
           values: [
             "outline",
             "soft",
-            "solid",
             "inset"
           ]
         },
@@ -1475,7 +1517,8 @@ var treeui_catalog_default = {
       a11y: [],
       behavior: [
         "body_wrapper_class: t-card__body",
-        "solid_variant_rescopes_color_tokens_for_nested_content: true"
+        'variant_effects: {"outline":"Base surface with a default border. The styling baseline \u2014 the `t-card--outline` class is emitted but carries no CSS rule of its own.","soft":"Subtle tinted surface (bg-subtle), same border and shadow as outline.","inset":"Same tinted surface as soft, but with no shadow, so it reads as recessed inside another surface."}',
+        "note: No card variant inverts its surface, so nested content inherits the normal color tokens. For a high-emphasis card, use a brand-colored border rather than an inverted background."
       ],
       selection: {
         keywords: [
@@ -1804,6 +1847,92 @@ var treeui_catalog_default = {
       },
       recipes: []
     },
+    {
+      name: "TColorSwatch",
+      aliases: [],
+      package: "@treeui/vue",
+      kind: "form",
+      category: "Data Entry",
+      status: "available",
+      purpose: "Pick a colour from a row of preset swatches, with an optional native colour input for an arbitrary value. Built for accent/brand pickers.",
+      sourceFile: "packages/vue/src/components/TColorSwatch.vue",
+      storyFile: "apps/docs/src/stories/ColorSwatch.stories.ts",
+      storyTitle: "Components/Data Entry/ColorSwatch",
+      manifestFile: "docs/ai/COMPONENTS/color-swatch.yaml",
+      props: [
+        {
+          name: "modelValue",
+          type: "string",
+          default: "undefined",
+          note: "Selected colour as a hex string. Matching is case-insensitive."
+        },
+        {
+          name: "options",
+          type: "TColorSwatchOption[]",
+          default: "[]",
+          note: "Preset swatches, each `{ label, value }`. `label` becomes the button's accessible name."
+        },
+        {
+          name: "allowCustom",
+          type: "boolean",
+          default: "false",
+          note: 'Appends a native `<input type="color">` for values outside the presets.'
+        },
+        {
+          name: "size",
+          type: "TSize",
+          default: "md",
+          values: [
+            "sm",
+            "md",
+            "lg"
+          ]
+        },
+        {
+          name: "label",
+          type: "string",
+          default: "Color",
+          note: 'Accessible label for the swatch group (`role="group"`).'
+        },
+        {
+          name: "customLabel",
+          type: "string",
+          default: "Custom color"
+        },
+        {
+          name: "disabled",
+          type: "boolean",
+          default: "false"
+        }
+      ],
+      events: [
+        {
+          name: "update:modelValue"
+        }
+      ],
+      slots: [],
+      a11y: [
+        'Wrapper is `role="group"` labelled by `label`.',
+        "Each swatch is a native button with `aria-pressed` reflecting selection and `aria-label` from the option label.",
+        "Selection is conveyed by an outline (not colour alone), since the swatch's own colour is the content."
+      ],
+      behavior: [
+        "emits_on_preset_click: true",
+        "emits_on_custom_input: true",
+        "blocks_interaction_when_disabled: true"
+      ],
+      selection: {
+        keywords: [],
+        useWhen: [],
+        avoidWhen: [],
+        alternatives: []
+      },
+      setup: {
+        required: [],
+        notes: []
+      },
+      recipes: []
+    },
     {
       name: "TCombobox",
       aliases: [],
@@ -3787,6 +3916,20 @@ var treeui_catalog_default = {
             "lg"
           ]
         },
+        {
+          name: "width",
+          type: "TFieldWidth",
+          default: "full",
+          values: [
+            "xs",
+            "sm",
+            "md",
+            "lg",
+            "xl",
+            "full"
+          ],
+          note: "Inline-size cap (max-inline-size). Fluid by default; use instead of an inline width style."
+        },
         {
           name: "disabled",
           type: "boolean",
@@ -3871,6 +4014,43 @@ var treeui_catalog_default = {
         "tag-input"
       ]
     },
+    {
+      name: "TKbd",
+      aliases: [],
+      package: "@treeui/vue",
+      kind: "primitive",
+      category: "Data Display",
+      status: "available",
+      purpose: "Keyboard-key hint (e.g. \u2318K, Esc, Ctrl) rendered as a native <kbd> with the library's chip styling.",
+      sourceFile: "packages/vue/src/components/TKbd.vue",
+      storyFile: "apps/docs/src/stories/Kbd.stories.ts",
+      storyTitle: "Components/Data Display/Kbd",
+      manifestFile: "docs/ai/COMPONENTS/kbd.yaml",
+      props: [],
+      events: [],
+      slots: [
+        {
+          name: "default"
+        }
+      ],
+      a11y: [
+        "Uses the native <kbd> element so assistive tech announces it as keyboard input."
+      ],
+      behavior: [
+        "renders_native_kbd_element: true"
+      ],
+      selection: {
+        keywords: [],
+        useWhen: [],
+        avoidWhen: [],
+        alternatives: []
+      },
+      setup: {
+        required: [],
+        notes: []
+      },
+      recipes: []
+    },
     {
       name: "TLink",
       aliases: [],
@@ -5521,6 +5701,20 @@ var treeui_catalog_default = {
             "lg"
           ]
         },
+        {
+          name: "width",
+          type: "TFieldWidth",
+          default: "full",
+          values: [
+            "xs",
+            "sm",
+            "md",
+            "lg",
+            "xl",
+            "full"
+          ],
+          note: "Inline-size cap (max-inline-size). Fluid by default; use instead of an inline width style."
+        },
         {
           name: "disabled",
           type: "boolean",
@@ -5935,6 +6129,46 @@ var treeui_catalog_default = {
       },
       recipes: []
     },
+    {
+      name: "TSpacer",
+      aliases: [],
+      package: "@treeui/vue",
+      kind: "layout",
+      category: "Layout",
+      status: "available",
+      purpose: "Flexible spacer that absorbs free space between siblings in a flex layout (e.g. TStack), replacing hand-written margin:auto / flex:1.",
+      sourceFile: "packages/vue/src/components/TSpacer.vue",
+      storyFile: "apps/docs/src/stories/Spacer.stories.ts",
+      storyTitle: "Components/Layout/Spacer",
+      manifestFile: "docs/ai/COMPONENTS/spacer.yaml",
+      props: [
+        {
+          name: "as",
+          type: "string",
+          default: "div"
+        }
+      ],
+      events: [],
+      slots: [],
+      a11y: [
+        "Rendered with aria-hidden='true'; it is a layout-only element with no content."
+      ],
+      behavior: [
+        "grows_to_fill_free_space: true",
+        "pushes_siblings_apart_or_to_ends: true"
+      ],
+      selection: {
+        keywords: [],
+        useWhen: [],
+        avoidWhen: [],
+        alternatives: []
+      },
+      setup: {
+        required: [],
+        notes: []
+      },
+      recipes: []
+    },
     {
       name: "TSparkline",
       aliases: [],
@@ -6107,6 +6341,82 @@ var treeui_catalog_default = {
       },
       recipes: []
     },
+    {
+      name: "TSplit",
+      aliases: [],
+      package: "@treeui/vue",
+      kind: "layout",
+      category: "Layout",
+      status: "available",
+      purpose: "Responsive two-pane layout (a wider main pane + a narrower aside) that sits side by side and stacks to one column when narrow \u2014 no media query.",
+      sourceFile: "packages/vue/src/components/TSplit.vue",
+      storyFile: "apps/docs/src/stories/Split.stories.ts",
+      storyTitle: "Components/Layout/Split",
+      manifestFile: "docs/ai/COMPONENTS/split.yaml",
+      props: [
+        {
+          name: "as",
+          type: "string",
+          default: "div"
+        },
+        {
+          name: "gap",
+          type: "string",
+          default: "var(--tree-space-5)"
+        },
+        {
+          name: "ratio",
+          type: "number",
+          default: "2",
+          note: "How many times faster the main pane grows than the aside pane."
+        },
+        {
+          name: "minWidth",
+          type: "string",
+          default: "18rem",
+          note: "Min width each pane keeps before the layout wraps to a single column (flex-wrap, no @media)."
+        },
+        {
+          name: "side",
+          type: "start | end",
+          default: "end",
+          note: "Which side the aside pane sits on when side by side."
+        },
+        {
+          name: "align",
+          type: "string",
+          default: "start",
+          note: "Cross-axis alignment (align-items)."
+        }
+      ],
+      events: [],
+      slots: [
+        {
+          name: "default"
+        },
+        {
+          name: "aside"
+        }
+      ],
+      a11y: [
+        "Layout-only wrapper; semantics come from the slotted content."
+      ],
+      behavior: [
+        "wraps_to_single_column_when_narrow: true",
+        "media_query_free: true"
+      ],
+      selection: {
+        keywords: [],
+        useWhen: [],
+        avoidWhen: [],
+        alternatives: []
+      },
+      setup: {
+        required: [],
+        notes: []
+      },
+      recipes: []
+    },
     {
       name: "TStack",
       aliases: [],
@@ -6158,6 +6468,12 @@ var treeui_catalog_default = {
           name: "reverse",
           type: "boolean",
           default: "false"
+        },
+        {
+          name: "grow",
+          type: "boolean",
+          default: "false",
+          note: "Expands the stack to fill available space along its parent's main axis (flex: 1 with min-size 0). Use it to make a sidebar column fill its container height."
         }
       ],
       events: [],
@@ -6205,6 +6521,80 @@ var treeui_catalog_default = {
         "chart-surface"
       ]
     },
+    {
+      name: "TStackItem",
+      aliases: [],
+      package: "@treeui/vue",
+      kind: "layout",
+      category: "Layout",
+      status: "available",
+      purpose: "Per-child flex control inside a TStack \u2014 grow, shrink, basis, min width and align-self \u2014 so one item can fill the row without hand-written CSS.",
+      sourceFile: "packages/vue/src/components/TStackItem.vue",
+      storyFile: "apps/docs/src/stories/StackItem.stories.ts",
+      storyTitle: "Components/Layout/StackItem",
+      manifestFile: "docs/ai/COMPONENTS/stack-item.yaml",
+      props: [
+        {
+          name: "as",
+          type: "string",
+          default: "div"
+        },
+        {
+          name: "grow",
+          type: "boolean | number",
+          default: "false",
+          note: "true = flex-grow 1; a number sets the grow factor."
+        },
+        {
+          name: "shrink",
+          type: "boolean | number",
+          default: "undefined",
+          note: "false prevents shrinking; a number sets the shrink factor."
+        },
+        {
+          name: "basis",
+          type: "string",
+          default: "undefined",
+          note: "flex-basis (initial main-axis size)."
+        },
+        {
+          name: "minWidth",
+          type: "string",
+          default: "undefined",
+          note: "Minimum main-axis size before it wraps/shrinks."
+        },
+        {
+          name: "align",
+          type: "string",
+          default: "undefined",
+          note: "Per-item cross-axis alignment (align-self)."
+        }
+      ],
+      events: [],
+      slots: [
+        {
+          name: "default"
+        }
+      ],
+      a11y: [
+        "Layout-only wrapper; semantics come from the slotted content."
+      ],
+      behavior: [
+        "controls_single_flex_child: true",
+        "defaults_min_inline_size_zero: true"
+      ],
+      selection: {
+        keywords: [],
+        useWhen: [],
+        avoidWhen: [],
+        alternatives: []
+      },
+      setup: {
+        required: [],
+        notes: []
+      },
+      recipes: []
+    },
     {
       name: "TStat",
       aliases: [],
@@ -6807,6 +7197,95 @@ var treeui_catalog_default = {
         "tag-input"
       ]
     },
+    {
+      name: "TText",
+      aliases: [],
+      package: "@treeui/vue",
+      kind: "primitive",
+      category: "Data Display",
+      status: "available",
+      purpose: "Typography primitive for body text, labels and headings \u2014 size, tone, weight and truncation from tokens, with no hand-written CSS.",
+      sourceFile: "packages/vue/src/components/TText.vue",
+      storyFile: "apps/docs/src/stories/Text.stories.ts",
+      storyTitle: "Components/Data Display/Text",
+      manifestFile: "docs/ai/COMPONENTS/text.yaml",
+      props: [
+        {
+          name: "as",
+          type: "string",
+          default: "span",
+          note: "Render element. Use `p`, `h1`\u2013`h6`, `label`, `small`, `strong`, \u2026 for correct semantics."
+        },
+        {
+          name: "size",
+          type: "TTextSize",
+          default: "undefined",
+          values: [
+            "xs",
+            "sm",
+            "md",
+            "lg",
+            "xl",
+            "2xl",
+            "3xl"
+          ],
+          note: "Maps to --tree-font-size-*. Omitted = inherit."
+        },
+        {
+          name: "tone",
+          type: "TTextTone",
+          default: "default",
+          values: [
+            "default",
+            "muted",
+            "inverse",
+            "brand"
+          ],
+          note: "`default` inherits the current colour; others map to --tree-color-text-* / brand."
+        },
+        {
+          name: "weight",
+          type: "TTextWeight",
+          default: "undefined",
+          values: [
+            "regular",
+            "medium",
+            "semibold",
+            "bold"
+          ]
+        },
+        {
+          name: "truncate",
+          type: "boolean",
+          default: "false",
+          note: "Clip to a single line with an ellipsis."
+        }
+      ],
+      events: [],
+      slots: [
+        {
+          name: "default"
+        }
+      ],
+      a11y: [
+        "Choose `as` to convey the correct semantics (e.g. headings via h1\u2013h6); TText adds only visual styling."
+      ],
+      behavior: [
+        "semantic_element_controlled_by_as: true",
+        "token_driven_size_tone_weight: true"
+      ],
+      selection: {
+        keywords: [],
+        useWhen: [],
+        avoidWhen: [],
+        alternatives: []
+      },
+      setup: {
+        required: [],
+        notes: []
+      },
+      recipes: []
+    },
     {
       name: "TTextarea",
       aliases: [],
@@ -6835,6 +7314,20 @@ var treeui_catalog_default = {
             "lg"
           ]
         },
+        {
+          name: "width",
+          type: "TFieldWidth",
+          default: "full",
+          values: [
+            "xs",
+            "sm",
+            "md",
+            "lg",
+            "xl",
+            "full"
+          ],
+          note: "Inline-size cap (max-inline-size). Fluid by default; use instead of an inline width style."
+        },
         {
           name: "disabled",
           type: "boolean",

package/dist/index.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@treeui/mcp",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Model Context Protocol server and AI catalog for TreeUI.",
   "type": "module",
   "main": "./dist/index.cjs",