@treeui/mcp 0.2.0 → 0.3.0

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-06-26T22:57:20.487Z",
+  generatedAt: "2026-07-15T22:47:49.302Z",
   packageName: "@treeui/vue",
-  packageVersion: "0.8.0",
+  packageVersion: "0.13.0",
   decisionGuides: [
     {
       id: "single-choice",
@@ -234,6 +234,50 @@ var treeui_catalog_default = {
           notes: []
         }
       ]
+    },
+    {
+      id: "data-viz-choice",
+      question: "Visualize numeric data",
+      options: [
+        {
+          use: "TStat",
+          when: [
+            "The story is a single headline number, optionally with a trend and delta.",
+            "It is not a plot \u2014 prefer the number over a chart when one value says it."
+          ],
+          notes: []
+        },
+        {
+          use: "TSparkline",
+          when: [
+            "You want an inline micro-trend next to a value, in a table cell, or in text.",
+            "No axes, legend, or tooltip are needed."
+          ],
+          notes: []
+        },
+        {
+          use: "TChart",
+          when: [
+            "You need line, area, or bar plots with axes, gridlines, legend, and hover tooltip.",
+            "There are one or more series over shared categories."
+          ],
+          notes: []
+        },
+        {
+          use: "TDonutChart",
+          when: [
+            "The data is a part-of-whole breakdown (donut or pie)."
+          ],
+          notes: []
+        },
+        {
+          use: "TProgress",
+          when: [
+            "You are showing completion toward a single target, not a distribution or trend."
+          ],
+          notes: []
+        }
+      ]
     }
   ],
   recipes: [
@@ -283,11 +327,28 @@ var treeui_catalog_default = {
         "Set end `min` from the selected start time when appropriate."
       ]
     },
+    {
+      id: "app-shell",
+      name: "Full-viewport application shell",
+      useWhen: [
+        "The app needs a header plus side navigation that fills the whole screen and adapts to mobile.",
+        "The layout must use the full page width on large monitors, not a centered column."
+      ],
+      compose: [
+        "TAppShell",
+        "TNavMenu"
+      ],
+      notes: [
+        "`TAppShell` orchestrates the header, sidebar, and fluid content in one component; put a `TNavMenu` in its `sidebar` slot and it inherits collapsed state automatically.",
+        "Leave `mobile` unset to auto-switch at `breakpoint` (default 768px), or bind it to force mobile; the sidebar becomes an off-canvas drawer with a header menu button.",
+        "Mount it at the app root. Wrap only inner regions in `TContainer` if a specific area needs a constrained reading width."
+      ]
+    },
     {
       id: "sidebar-shell",
       name: "Sidebar application shell",
       useWhen: [
-        "The screen needs persistent section navigation."
+        "The screen needs persistent section navigation and you are composing the shell by hand."
       ],
       compose: [
         "TSidebar",
@@ -296,7 +357,8 @@ var treeui_catalog_default = {
         "TContainer"
       ],
       notes: [
-        "Let `TNavMenu` inherit collapsed state from `TSidebar` when possible."
+        "Let `TNavMenu` inherit collapsed state from `TSidebar` when possible.",
+        "Prefer `TAppShell` (recipe `app-shell`) when you also need full-viewport sizing and a responsive mobile drawer."
       ]
     },
     {
@@ -394,15 +456,38 @@ var treeui_catalog_default = {
       id: "chart-surface",
       name: "Chart surface",
       useWhen: [
-        "A screen needs data visualization, but the charting engine should stay external to TreeUI."
+        "A screen needs data visualization inside a framed, titled surface."
       ],
       compose: [
         "TCard",
         "TStack",
-        "external chart library"
+        "TChart",
+        "TSelect"
+      ],
+      notes: [
+        "Prefer the native TChart / TDonutChart / TSparkline \u2014 no external charting library is required.",
+        "Use TreeUI for the surrounding surface, headings, badges, range filters, and empty/loading states.",
+        "TChart has its own loading and empty slots; you can still wrap it in TCard for the frame.",
+        "Only reach for an external chart engine for chart types TreeUI does not cover yet (e.g. scatter, heatmap)."
+      ]
+    },
+    {
+      id: "metric-dashboard",
+      name: "Metric dashboard",
+      useWhen: [
+        "A dashboard shows KPIs alongside trends and breakdowns."
+      ],
+      compose: [
+        "TStat",
+        "TSparkline",
+        "TChart",
+        "TDonutChart",
+        "TGrid"
       ],
       notes: [
-        "Use TreeUI for the surrounding surface, headings, badges, filters, and empty/loading states."
+        "Lead with TStat tiles; embed a TSparkline in a stat's meta slot for the inline trend.",
+        "Use one TChart for the main time series and a TDonutChart for a part-of-whole split.",
+        "Keep series colors stable across the dashboard \u2014 rely on the --tree-color-chart-* order, do not remap by rank."
       ]
     },
     {
@@ -552,17 +637,27 @@ var treeui_catalog_default = {
           "Use `accept`, `multiple`, and size limits in the app layer to constrain uploads."
         ]
       },
+      TAppShell: {
+        required: [],
+        notes: [
+          "Mount at the app root; it fills the viewport (100dvh, full width) and scrolls its content region independently.",
+          "Put navigation in the `sidebar` slot (e.g. `TNavMenu`) \u2014 it inherits collapsed state from the shell provider like `TSidebar`.",
+          "Leave `mobile` unset to auto-switch to an off-canvas drawer at `breakpoint`, or bind `mobile` to control it explicitly.",
+          "Use `v-model:collapsed` for the desktop rail and `v-model:sidebarOpen` for the mobile drawer when the app persists layout state."
+        ]
+      },
       TSidebar: {
         required: [],
         notes: [
           "Pair with `TNavMenu` for app-section navigation.",
-          "Use controlled `collapsed` state when the app shell persists layout preferences."
+          "Use controlled `collapsed` state when the app shell persists layout preferences.",
+          "Prefer `TAppShell` when you also want full-viewport sizing, a top header, and a responsive mobile drawer."
         ]
       },
       TNavMenu: {
         required: [],
         notes: [
-          "When nested inside `TSidebar`, `collapsed` can be inherited from the sidebar provider."
+          "When nested inside `TSidebar` or `TAppShell`, `collapsed` can be inherited from the sidebar provider."
         ]
       },
       TTreeView: {
@@ -596,6 +691,32 @@ var treeui_catalog_default = {
           "Use `href` for native links.",
           "Use `to` when the app has vue-router and breadcrumb items should render RouterLink."
         ]
+      },
+      TChart: {
+        required: [],
+        notes: [
+          "Pass `series` as `{ name, data, color? }[]` and `labels` as a parallel `string[]` (one label per data index).",
+          "Set `type` to `line`, `area`, or `bar`; use `stacked` only with `bar`.",
+          "Series colors come from `--tree-color-chart-1..8` in order; pass `color` per series to override \u2014 do not remap colors when the series set changes.",
+          "Pass `valueFormat: (n) => string` to format axis and tooltip values (currency, compact, etc.).",
+          "No charting library or provider is required \u2014 the SVG and geometry are built in."
+        ]
+      },
+      TSparkline: {
+        required: [],
+        notes: [
+          "Pass `data` as `number[]`; there are no axes, legend, or tooltip by design.",
+          "Size it with `width`/`height`; use it inside `TStat`, table cells, or text.",
+          "Always keep a visible number nearby \u2014 a sparkline supplements a value, it does not replace it."
+        ]
+      },
+      TDonutChart: {
+        required: [],
+        notes: [
+          "Pass `segments` as `{ label, value, color? }[]`; non-positive values are dropped.",
+          "Set `thickness: 0` for a full pie; keep the default for a donut with a center readout.",
+          "Use the `center` slot (donut only) for a custom center; otherwise it shows the total or the hovered slice."
+        ]
       }
     },
     appPatterns: {
@@ -609,6 +730,9 @@ var treeui_catalog_default = {
       commonCompositions: [
         "TFormField + input-like control",
         "TGrid + TStat",
+        "TStat + TSparkline",
+        "TCard + TChart",
+        "TAppShell + TNavMenu",
         "TSidebar + TNavMenu",
         "TTable + TPagination",
         "TPricing + TPricingCard"
@@ -769,6 +893,211 @@ var treeui_catalog_default = {
       },
       recipes: []
     },
+    {
+      name: "TAppShell",
+      aliases: [],
+      package: "@treeui/vue",
+      kind: "layout",
+      category: "Layout",
+      status: "available",
+      purpose: "Full-viewport application shell with a top header, a persistent side navigation, and a fluid content area that collapses the sidebar into an off-canvas drawer on small screens.",
+      sourceFile: "packages/vue/src/components/TAppShell.vue",
+      storyFile: "apps/docs/src/stories/AppShell.stories.ts",
+      storyTitle: "Components/Layout/AppShell",
+      manifestFile: "docs/ai/COMPONENTS/app-shell.yaml",
+      props: [
+        {
+          name: "as",
+          type: "string",
+          default: "div"
+        },
+        {
+          name: "side",
+          type: "TSidebarSide",
+          default: "left",
+          values: [
+            "left",
+            "right"
+          ]
+        },
+        {
+          name: "sidebarWidth",
+          type: "string",
+          default: "17.5rem"
+        },
+        {
+          name: "collapsedWidth",
+          type: "string",
+          default: "4.75rem"
+        },
+        {
+          name: "collapsible",
+          type: "boolean",
+          default: "false"
+        },
+        {
+          name: "collapsed",
+          type: "boolean",
+          default: "undefined"
+        },
+        {
+          name: "defaultCollapsed",
+          type: "boolean",
+          default: "false"
+        },
+        {
+          name: "mobile",
+          type: "boolean",
+          default: "undefined"
+        },
+        {
+          name: "breakpoint",
+          type: "string",
+          default: "768px"
+        },
+        {
+          name: "sidebarOpen",
+          type: "boolean",
+          default: "undefined"
+        },
+        {
+          name: "defaultSidebarOpen",
+          type: "boolean",
+          default: "false"
+        },
+        {
+          name: "closeOnEscape",
+          type: "boolean",
+          default: "true"
+        },
+        {
+          name: "closeOnOverlay",
+          type: "boolean",
+          default: "true"
+        },
+        {
+          name: "showMenuButton",
+          type: "boolean",
+          default: "true"
+        },
+        {
+          name: "menuLabel",
+          type: "string",
+          default: "Open menu"
+        },
+        {
+          name: "closeLabel",
+          type: "string",
+          default: "Close menu"
+        },
+        {
+          name: "sidebarLabel",
+          type: "string",
+          default: "Sidebar"
+        }
+      ],
+      events: [
+        {
+          name: "update:collapsed"
+        },
+        {
+          name: "collapse-change"
+        },
+        {
+          name: "update:sidebarOpen"
+        },
+        {
+          name: "sidebar-open-change"
+        }
+      ],
+      slots: [
+        {
+          name: "header"
+        },
+        {
+          name: "sidebar"
+        },
+        {
+          name: "default"
+        },
+        {
+          name: "menu-icon"
+        }
+      ],
+      a11y: [
+        "role: dialog",
+        "aria_modal: true",
+        "focus_trap: true",
+        "restores_focus_on_close: true",
+        "escape_closes_when_enabled: true",
+        "menu_button_aria_expanded: true",
+        "menu_button_aria_controls_drawer: true",
+        "sidebar_labelled_by_sidebar_label: true"
+      ],
+      behavior: [
+        "fills_viewport_full_width_and_height: true",
+        "header_spans_full_width_above_sidebar_and_content: true",
+        "content_area_scrolls_independently: true",
+        "auto_switches_to_mobile_at_breakpoint_when_mobile_undefined: true",
+        "mobile_prop_forces_mobile_mode: true",
+        "mobile_sidebar_becomes_off_canvas_drawer: true",
+        "auto_menu_button_in_header_on_mobile: true",
+        "controlled_and_uncontrolled_collapsed_state: true",
+        "controlled_and_uncontrolled_sidebar_open_state: true",
+        "provides_collapsed_state_to_descendants: true",
+        "drawer_reports_collapsed_false_to_descendants_and_slots: true",
+        "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"
+      ],
+      selection: {
+        keywords: [
+          "app shell",
+          "layout",
+          "dashboard",
+          "admin",
+          "header sidebar",
+          "full screen",
+          "responsive shell",
+          "off-canvas"
+        ],
+        useWhen: [
+          "You need a full-viewport application layout with a header, a side navigation, and a fluid content area.",
+          "The layout should use the entire page width (not a centered max-width) and switch the sidebar to an off-canvas drawer on small screens."
+        ],
+        avoidWhen: [
+          "You only need one region (just a top bar, or just a side rail) \u2014 compose TNavbar or TSidebar directly.",
+          "The page content should be centered with a readable max width \u2014 use TContainer inside the shell content instead."
+        ],
+        alternatives: [
+          {
+            component: "TSidebar",
+            when: "You want a standalone collapsible side rail without the header/content orchestration or responsive drawer."
+          },
+          {
+            component: "TNavbar",
+            when: "You only need the top application bar."
+          },
+          {
+            component: "TDrawer",
+            when: "You need a general temporary overlay panel rather than the shell's responsive navigation."
+          }
+        ]
+      },
+      setup: {
+        required: [],
+        notes: [
+          "Mount at the app root; it fills the viewport (100dvh, full width) and scrolls its content region independently.",
+          "Put navigation in the `sidebar` slot (e.g. `TNavMenu`) \u2014 it inherits collapsed state from the shell provider like `TSidebar`.",
+          "Leave `mobile` unset to auto-switch to an off-canvas drawer at `breakpoint`, or bind `mobile` to control it explicitly.",
+          "Use `v-model:collapsed` for the desktop rail and `v-model:sidebarOpen` for the mobile drawer when the app persists layout state."
+        ]
+      },
+      recipes: [
+        "app-shell"
+      ]
+    },
     {
       name: "TAvatar",
       aliases: [],
@@ -1130,7 +1459,8 @@ var treeui_catalog_default = {
       ],
       a11y: [],
       behavior: [
-        "body_wrapper_class: tree-card__body"
+        "body_wrapper_class: t-card__body",
+        "solid_variant_rescopes_color_tokens_for_nested_content: true"
       ],
       selection: {
         keywords: [
@@ -1165,6 +1495,202 @@ var treeui_catalog_default = {
         "chart-surface"
       ]
     },
+    {
+      name: "TChart",
+      aliases: [],
+      package: "@treeui/vue",
+      kind: "data-display",
+      category: "Data Display",
+      status: "available",
+      purpose: "Lightweight cartesian chart (line, area, bar) for multi-series data, with axes, gridlines, hover tooltip, legend, and an accessible data table. No external charting dependency.",
+      sourceFile: "packages/vue/src/components/TChart.vue",
+      storyFile: "apps/docs/src/stories/Chart.stories.ts",
+      storyTitle: "Components/Data Display/Chart",
+      manifestFile: "docs/ai/COMPONENTS/chart.yaml",
+      props: [
+        {
+          name: "type",
+          type: "TChartType",
+          default: "line",
+          values: [
+            "line",
+            "area",
+            "bar"
+          ]
+        },
+        {
+          name: "series",
+          type: "TChartSeries[]",
+          default: "[]",
+          note: "Each item is { name: string; data: number[]; color?: string }."
+        },
+        {
+          name: "labels",
+          type: "string[]",
+          default: "[]",
+          note: "X-axis categories, aligned index-for-index to each series' data."
+        },
+        {
+          name: "height",
+          type: "number",
+          default: "260",
+          note: "Width is fluid (measured via ResizeObserver)."
+        },
+        {
+          name: "smooth",
+          type: "boolean",
+          default: "false",
+          note: "Curved line/area."
+        },
+        {
+          name: "stacked",
+          type: "boolean",
+          default: "false",
+          note: "Stacks bar series; ignored for line/area. Negative values are clamped to 0 in stacked mode (grouped mode renders them)."
+        },
+        {
+          name: "showGrid",
+          type: "boolean",
+          default: "true"
+        },
+        {
+          name: "showLegend",
+          type: "boolean",
+          default: "auto (true when more than one series)"
+        },
+        {
+          name: "showXAxis",
+          type: "boolean",
+          default: "true"
+        },
+        {
+          name: "showYAxis",
+          type: "boolean",
+          default: "true"
+        },
+        {
+          name: "showTooltip",
+          type: "boolean",
+          default: "true"
+        },
+        {
+          name: "showPoints",
+          type: "boolean",
+          default: "false",
+          note: "Always draw markers on line/area points."
+        },
+        {
+          name: "yTicks",
+          type: "number",
+          default: "5"
+        },
+        {
+          name: "valueFormat",
+          type: "(value: number) => string",
+          default: "locale integers for |value| >= 1000"
+        },
+        {
+          name: "minY",
+          type: "number",
+          default: "auto"
+        },
+        {
+          name: "maxY",
+          type: "number",
+          default: "auto"
+        },
+        {
+          name: "animated",
+          type: "boolean",
+          default: "true",
+          note: "Draw-in animation; disabled under prefers-reduced-motion."
+        },
+        {
+          name: "loading",
+          type: "boolean",
+          default: "false"
+        },
+        {
+          name: "ariaLabel",
+          type: "string",
+          default: "auto-generated summary"
+        }
+      ],
+      events: [
+        {
+          name: "point-click",
+          payload: "{ index: number; label: string; values: { name: string; value: number; color: string }[] }"
+        }
+      ],
+      slots: [
+        {
+          name: "legend"
+        },
+        {
+          name: "tooltip"
+        },
+        {
+          name: "empty"
+        }
+      ],
+      a11y: [
+        "SVG is aria-hidden; a visually-hidden <table> mirrors the series data for assistive tech.",
+        "Legend defaults on for multiple series so identity is not color-only.",
+        "Provide a meaningful ariaLabel describing what the chart shows."
+      ],
+      behavior: [
+        "colors_auto_assign_from_chart_palette: --tree-color-chart-1..8, cycling; per-series color overrides",
+        "bar_zero_baseline: true",
+        "line_domain_uses_nice_ticks: true",
+        "hover_shows_crosshair_and_tooltip: true"
+      ],
+      selection: {
+        keywords: [
+          "chart",
+          "graph",
+          "line chart",
+          "area chart",
+          "bar chart",
+          "plot",
+          "dashboard",
+          "time series",
+          "analytics"
+        ],
+        useWhen: [
+          "You need a line, area, or bar chart with axes, gridlines, legend, and a hover tooltip.",
+          "One or more series share a set of category labels."
+        ],
+        avoidWhen: [
+          "A single value tells the story \u2014 use TStat.",
+          "You only need an inline trend with no axes \u2014 use TSparkline.",
+          "The data is a part-of-whole breakdown \u2014 use TDonutChart."
+        ],
+        alternatives: [
+          {
+            component: "TSparkline",
+            when: "The trend should be inline and axis-less."
+          },
+          {
+            component: "TDonutChart",
+            when: "The data is proportional (parts of a whole)."
+          }
+        ]
+      },
+      setup: {
+        required: [],
+        notes: [
+          "Pass `series` as `{ name, data, color? }[]` and `labels` as a parallel `string[]` (one label per data index).",
+          "Set `type` to `line`, `area`, or `bar`; use `stacked` only with `bar`.",
+          "Series colors come from `--tree-color-chart-1..8` in order; pass `color` per series to override \u2014 do not remap colors when the series set changes.",
+          "Pass `valueFormat: (n) => string` to format axis and tooltip values (currency, compact, etc.).",
+          "No charting library or provider is required \u2014 the SVG and geometry are built in."
+        ]
+      },
+      recipes: [
+        "chart-surface",
+        "metric-dashboard"
+      ]
+    },
     {
       name: "TCheckbox",
       aliases: [],
@@ -2136,6 +2662,142 @@ var treeui_catalog_default = {
       },
       recipes: []
     },
+    {
+      name: "TDonutChart",
+      aliases: [],
+      package: "@treeui/vue",
+      kind: "data-display",
+      category: "Data Display",
+      status: "available",
+      purpose: "Part-of-whole chart rendered as a donut (default) or full pie, with a legend, percentages, an interactive center readout, and an accessible label.",
+      sourceFile: "packages/vue/src/components/TDonutChart.vue",
+      storyFile: "apps/docs/src/stories/DonutChart.stories.ts",
+      storyTitle: "Components/Data Display/Donut Chart",
+      manifestFile: "docs/ai/COMPONENTS/donut-chart.yaml",
+      props: [
+        {
+          name: "segments",
+          type: "TDonutSegment[]",
+          default: "[]",
+          note: "Each item is { label: string; value: number; color?: string }. Non-positive values are omitted."
+        },
+        {
+          name: "size",
+          type: "number",
+          default: "200",
+          note: "Square canvas in px."
+        },
+        {
+          name: "thickness",
+          type: "number",
+          default: "26",
+          note: "Ring thickness; 0 renders a full pie."
+        },
+        {
+          name: "gap",
+          type: "number",
+          default: "2",
+          note: "Gap between slices, in degrees."
+        },
+        {
+          name: "rounded",
+          type: "boolean",
+          default: "false",
+          note: "Round the ends of donut segments (widens the gap to make room). Best with a thinner ring."
+        },
+        {
+          name: "showLegend",
+          type: "boolean",
+          default: "true"
+        },
+        {
+          name: "showPercent",
+          type: "boolean",
+          default: "true"
+        },
+        {
+          name: "centerLabel",
+          type: "string",
+          default: "Total",
+          note: "Donut only; ignored for pie."
+        },
+        {
+          name: "centerValue",
+          type: "string | number",
+          default: "auto (sum of values)"
+        },
+        {
+          name: "valueFormat",
+          type: "(value: number) => string",
+          default: "locale integers for |value| >= 1000"
+        },
+        {
+          name: "loading",
+          type: "boolean",
+          default: "false"
+        },
+        {
+          name: "ariaLabel",
+          type: "string",
+          default: "auto-generated summary"
+        }
+      ],
+      events: [],
+      slots: [
+        {
+          name: "center"
+        },
+        {
+          name: "empty"
+        }
+      ],
+      a11y: [
+        "Renders role=img with an aria-label summarizing the chart.",
+        "Legend + percentages give a non-visual reading of each slice."
+      ],
+      behavior: [
+        "colors_auto_assign_from_chart_palette: --tree-color-chart-1..8, cycling; per-segment color overrides",
+        "hovering_a_slice_dims_the_rest_and_updates_center: true",
+        "center_shows_total_or_the_hovered_segment: true"
+      ],
+      selection: {
+        keywords: [
+          "donut",
+          "doughnut",
+          "pie",
+          "proportion",
+          "share",
+          "breakdown",
+          "part of whole",
+          "percentage"
+        ],
+        useWhen: [
+          "You are showing how a total splits into a handful of categories.",
+          "A donut center readout (total or hovered slice) is useful."
+        ],
+        avoidWhen: [
+          "There are many categories or precise comparison matters \u2014 use TChart bars.",
+          "The data is a trend over time \u2014 use TChart or TSparkline."
+        ],
+        alternatives: [
+          {
+            component: "TChart",
+            when: "Precise magnitude comparison across categories is needed (bars)."
+          }
+        ]
+      },
+      setup: {
+        required: [],
+        notes: [
+          "Pass `segments` as `{ label, value, color? }[]`; non-positive values are dropped.",
+          "Set `thickness: 0` for a full pie; keep the default for a donut with a center readout.",
+          "Use the `center` slot (donut only) for a custom center; otherwise it shows the total or the hovered slice."
+        ]
+      },
+      recipes: [
+        "metric-dashboard"
+      ]
+    },
     {
       name: "TDrawer",
       aliases: [],
@@ -2337,6 +2999,16 @@ var treeui_catalog_default = {
           name: "label",
           type: "string",
           default: ""
+        },
+        {
+          name: "align",
+          type: "TDropdownAlign",
+          default: "start",
+          values: [
+            "start",
+            "end"
+          ],
+          note: "Horizontal alignment of the menu relative to the trigger. Use `end` when the trigger sits near the right edge of a clipping container (e.g. a table actions column)."
         }
       ],
       events: [
@@ -2372,7 +3044,8 @@ var treeui_catalog_default = {
       behavior: [
         "outside_click_closes_menu: true",
         "focus_restores_on_close: true",
-        "chevron_rotates_when_open: true"
+        "chevron_rotates_when_open: true",
+        "menu_grows_to_fit_items_without_wrapping: true"
       ],
       selection: {
         keywords: [
@@ -2872,7 +3545,8 @@ var treeui_catalog_default = {
       },
       recipes: [
         "date-range-form",
-        "stat-grid"
+        "stat-grid",
+        "metric-dashboard"
       ]
     },
     {
@@ -3762,10 +4436,11 @@ var treeui_catalog_default = {
       setup: {
         required: [],
         notes: [
-          "When nested inside `TSidebar`, `collapsed` can be inherited from the sidebar provider."
+          "When nested inside `TSidebar` or `TAppShell`, `collapsed` can be inherited from the sidebar provider."
         ]
       },
       recipes: [
+        "app-shell",
         "sidebar-shell"
       ]
     },
@@ -4592,7 +5267,8 @@ var treeui_catalog_default = {
         "check_icon_on_selected_option: true",
         "outside_click_closes_dropdown: true",
         "focus_restores_on_close: true",
-        "numeric_values_supported_without_string_coercion: true"
+        "numeric_values_supported_without_string_coercion: true",
+        "listbox_flips_above_trigger_when_space_below_is_insufficient: true"
       ],
       selection: {
         keywords: [
@@ -4625,7 +5301,9 @@ var treeui_catalog_default = {
           "Use `placeholder` when no selection has been made."
         ]
       },
-      recipes: []
+      recipes: [
+        "chart-surface"
+      ]
     },
     {
       name: "TSelectableList",
@@ -4847,7 +5525,8 @@ var treeui_catalog_default = {
         "controlled_and_uncontrolled_collapsed_state: true",
         "provides_collapsed_state_to_descendants: true",
         "left_and_right_variants: true",
-        "exposes_slot_props_with_collapsed_state: true"
+        "exposes_slot_props_with_collapsed_state: true",
+        "collapsed_state_centers_header_and_footer_content: true"
       ],
       selection: {
         keywords: [
@@ -4872,7 +5551,8 @@ var treeui_catalog_default = {
         required: [],
         notes: [
           "Pair with `TNavMenu` for app-section navigation.",
-          "Use controlled `collapsed` state when the app shell persists layout preferences."
+          "Use controlled `collapsed` state when the app shell persists layout preferences.",
+          "Prefer `TAppShell` when you also want full-viewport sizing, a top header, and a responsive mobile drawer."
         ]
       },
       recipes: [
@@ -4942,6 +5622,129 @@ var treeui_catalog_default = {
       },
       recipes: []
     },
+    {
+      name: "TSparkline",
+      aliases: [],
+      package: "@treeui/vue",
+      kind: "data-display",
+      category: "Data Display",
+      status: "available",
+      purpose: "Tiny, axis-less inline trend chart (line, area, or bar) sized for stat tiles, table cells, and running text.",
+      sourceFile: "packages/vue/src/components/TSparkline.vue",
+      storyFile: "apps/docs/src/stories/Sparkline.stories.ts",
+      storyTitle: "Components/Data Display/Sparkline",
+      manifestFile: "docs/ai/COMPONENTS/sparkline.yaml",
+      props: [
+        {
+          name: "data",
+          type: "number[]",
+          default: "[]"
+        },
+        {
+          name: "type",
+          type: "line | area | bar",
+          default: "line"
+        },
+        {
+          name: "color",
+          type: "string",
+          default: "var(--tree-color-chart-1)",
+          note: "Any CSS color."
+        },
+        {
+          name: "width",
+          type: "number",
+          default: "120"
+        },
+        {
+          name: "height",
+          type: "number",
+          default: "32"
+        },
+        {
+          name: "smooth",
+          type: "boolean",
+          default: "false",
+          note: "Curved line/area."
+        },
+        {
+          name: "strokeWidth",
+          type: "number",
+          default: "2",
+          note: "Line/area only."
+        },
+        {
+          name: "min",
+          type: "number",
+          default: "data min"
+        },
+        {
+          name: "max",
+          type: "number",
+          default: "data max"
+        },
+        {
+          name: "showLastPoint",
+          type: "boolean",
+          default: "false",
+          note: "Marker on the final point (line/area)."
+        },
+        {
+          name: "ariaLabel",
+          type: "string",
+          default: "Trend sparkline"
+        }
+      ],
+      events: [],
+      slots: [],
+      a11y: [
+        "Renders role=img with an aria-label; pass a specific one for meaningful trends.",
+        "Pair with a visible number \u2014 a sparkline supplements a value, it does not replace it."
+      ],
+      behavior: [
+        "no_axes_or_legend: true",
+        "flat_series_renders_centered: true",
+        "scales_to_intrinsic_width_and_height: true"
+      ],
+      selection: {
+        keywords: [
+          "sparkline",
+          "mini chart",
+          "inline chart",
+          "micro trend",
+          "trend line",
+          "table chart"
+        ],
+        useWhen: [
+          "You want a compact trend beside a value, in a table cell, or inline in text.",
+          "No axes, legend, or tooltip are required."
+        ],
+        avoidWhen: [
+          "You need axes, multiple labeled series, or a tooltip \u2014 use TChart."
+        ],
+        alternatives: [
+          {
+            component: "TChart",
+            when: "The chart needs axes, a legend, or a tooltip."
+          },
+          {
+            component: "TStat",
+            when: "A single value with a trend badge is enough."
+          }
+        ]
+      },
+      setup: {
+        required: [],
+        notes: [
+          "Pass `data` as `number[]`; there are no axes, legend, or tooltip by design.",
+          "Size it with `width`/`height`; use it inside `TStat`, table cells, or text.",
+          "Always keep a visible number nearby \u2014 a sparkline supplements a value, it does not replace it."
+        ]
+      },
+      recipes: [
+        "metric-dashboard"
+      ]
+    },
     {
       name: "TSpinner",
       aliases: [],
@@ -5195,6 +5998,10 @@ var treeui_catalog_default = {
           {
             component: "TCard",
             when: "The content is not a metric."
+          },
+          {
+            component: "TSparkline",
+            when: "You want to show the metric's trend as an inline mini-chart."
           }
         ]
       },
@@ -5203,7 +6010,8 @@ var treeui_catalog_default = {
         notes: []
       },
       recipes: [
-        "stat-grid"
+        "stat-grid",
+        "metric-dashboard"
       ]
     },
     {