create-wervt 0.2.15 → 0.2.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (33) hide show
  1. package/index.js +2 -0
  2. package/package.json +2 -2
  3. package/template/.claude/skills/nuxt-ui/SKILL.md +85 -243
  4. package/template/.claude/skills/nuxt-ui/references/components.md +184 -313
  5. package/template/.claude/skills/nuxt-ui/references/guidelines/component-selection.md +124 -0
  6. package/template/.claude/skills/nuxt-ui/references/guidelines/conventions.md +372 -0
  7. package/template/.claude/skills/nuxt-ui/references/guidelines/design-system.md +378 -0
  8. package/template/.claude/skills/nuxt-ui/references/guidelines/forms.md +235 -0
  9. package/template/.claude/skills/nuxt-ui/references/layouts/chat.md +140 -77
  10. package/template/.claude/skills/nuxt-ui/references/layouts/dashboard.md +33 -19
  11. package/template/.claude/skills/nuxt-ui/references/layouts/docs.md +23 -12
  12. package/template/.claude/skills/nuxt-ui/references/layouts/editor.md +49 -63
  13. package/template/.claude/skills/nuxt-ui/references/layouts/{page.md → landing.md} +43 -118
  14. package/template/.claude/skills/nuxt-ui/references/recipes/auth.md +162 -0
  15. package/template/.claude/skills/nuxt-ui/references/recipes/data-tables.md +249 -0
  16. package/template/.claude/skills/nuxt-ui/references/recipes/navigation.md +90 -0
  17. package/template/.claude/skills/nuxt-ui/references/recipes/overlays.md +177 -0
  18. package/template/.claude/skills/nuxt-ui-mobile/SKILL.md +38 -10
  19. package/template/.claude/skills/nuxt-ui-mobile/references/identity.md +127 -0
  20. package/template/.claude/skills/nuxt-ui-mobile/references/patterns.md +1 -0
  21. package/template/.claude/skills/nuxt-ui-mobile/references/review-checklist.md +14 -6
  22. package/template/.claude/skills/nuxt-ui-mobile/references/tokens.md +1 -1
  23. package/template/.claude/skills/nuxt-ui-mobile/template/app/assets/css/main.css +9 -9
  24. package/template/.claude/skills/nuxt-ui-mobile/template/app/components/mobile/ListSection.vue +7 -3
  25. package/template/.claude/skills/nuxt-ui-mobile/template/app/components/mobile/NavBar.vue +13 -4
  26. package/template/.claude/skills/nuxt-ui-mobile/template/nuxt.config.ts +2 -1
  27. package/template/.claude/skills/wervt-logs/SKILL.md +16 -13
  28. package/template/AGENTS.md +120 -8
  29. package/template/golar.config.ts +5 -0
  30. package/template/package.json +7 -4
  31. package/template/pnpm-workspace.yaml +2 -0
  32. package/template/.claude/skills/nuxt-ui/references/composables.md +0 -127
  33. package/template/.claude/skills/nuxt-ui/references/theming.md +0 -427
@@ -1,377 +1,248 @@
1
1
  # Components
2
2
 
3
- 125+ Vue components powered by Tailwind CSS and Reka UI. For any component's theme slots, read the generated theme file (Nuxt: `.nuxt/ui/<component>.ts`, Vue: `node_modules/.nuxt-ui/ui/<component>.ts`).
3
+ Quick-reference index of all 125+ components. For full API docs (props, slots, events, examples), use the MCP `get-component` or `get-component-metadata` tools.
4
4
 
5
5
  ## Layout
6
6
 
7
- Core structural components for organizing your application's layout.
8
-
9
7
  | Component | Purpose |
10
8
  |---|---|
11
- | `UApp` | **Required** root wrapper for toasts, tooltips, overlays |
12
- | `UHeader` | Responsive header with mobile menu (`#title`, `#default`, `#right`, `#body`) |
13
- | `UFooter` | Footer (`#left`, `#default`, `#right`, `#top`, `#bottom`) |
9
+ | `UApp` | **Required** root wrapper — toasts, tooltips, overlays, i18n |
10
+ | `UHeader` | Responsive header with mobile menu |
11
+ | `UFooter` | Footer with left/right/top/bottom slots |
14
12
  | `UFooterColumns` | Multi-column footer with link groups |
15
- | `UMain` | Main content area (respects `--ui-header-height`) |
16
- | `UContainer` | Centered max-width container (`--ui-container`) |
13
+ | `UMain` | Main content area |
14
+ | `UContainer` | Centered max-width container |
15
+ | `USplitter` | Resizable panels separated by draggable handles |
16
+ | `ULink` | Enhanced link — NuxtLink/RouterLink with active states |
17
17
 
18
18
  ## Element
19
19
 
20
- Essential UI building blocks.
21
-
22
- | Component | Key props |
20
+ | Component | Purpose |
23
21
  |---|---|
24
- | `UButton` | `label`, `icon`, `color`, `variant`, `size`, `loading`, `disabled`, `to` |
25
- | `UBadge` | `label`, `color`, `variant`, `size` |
26
- | `UAvatar` | `src`, `alt`, `icon`, `text`, `size` |
27
- | `UAvatarGroup` | `max`, `size` — wraps multiple `UAvatar` |
28
- | `UIcon` | `name`, `size` |
29
- | `UCard` | `variant` — slots: `#header`, `#default`, `#footer` |
30
- | `UAlert` | `title`, `description`, `icon`, `color`, `variant`, `close` |
31
- | `UBanner` | `title`, `icon`, `close` — sticky top banner |
32
- | `UChip` | `color`, `size`, `position` — notification dot on children |
33
- | `UKbd` | `value` — keyboard key display |
34
- | `USeparator` | `label`, `icon`, `orientation`, `type` |
35
- | `USkeleton` | `class` — loading placeholder |
36
- | `UProgress` | `value`, `max`, `color`, `size` |
37
- | `UCalendar` | `v-model`, `range` (boolean), `multiple` (boolean) |
38
- | `UCollapsible` | `v-model:open` — animated expand/collapse |
39
- | `UFieldGroup` | Groups form inputs horizontally/vertically |
22
+ | `UButton` | Buttons — links, actions, icons, loading states |
23
+ | `UBadge` | Labels, tags, status indicators |
24
+ | `UAvatar` | User photos, initials, icons |
25
+ | `UAvatarGroup` | Stacked avatars with `max` limit |
26
+ | `UIcon` | Iconify icons (`i-{collection}-{name}`) |
27
+ | `UCard` | Bordered container with header/body/footer |
28
+ | `UAlert` | Inline messages — info, warning, error, success |
29
+ | `UBanner` | App-wide sticky announcement bar |
30
+ | `UChip` | Notification dot overlay on children |
31
+ | `UKbd` | Keyboard key display |
32
+ | `USeparator` | Divider line with optional label |
33
+ | `USkeleton` | Loading placeholder |
34
+ | `UProgress` | Progress bar |
35
+ | `UProgressGroup` | Segmented progress bar with a list of items |
36
+ | `UToast` | Toast notification (shown via `useToast`) |
37
+ | `UCalendar` | Date calendar (single, range, multiple) |
38
+ | `UCollapsible` | Animated expand/collapse |
39
+ | `UFieldGroup` | Group form inputs horizontally |
40
+ | `UMarquee` | Scrolling content ticker |
41
+ | `UCarousel` | Image/content carousel with autoplay |
42
+ | `UEmpty` | Empty state placeholder with icon, title, actions |
43
+ | `UError` | Error display with retry action |
44
+ | `UScrollArea` | Scrollable area with custom scrollbar |
45
+ | `UTimeline` | Timeline display for events and activity |
46
+ | `UUser` | User display — avatar + name + description |
47
+ | `UTheme` | Scoped `ui` class overrides and prop defaults for a subtree |
40
48
 
41
49
  ## Form
42
50
 
43
- Comprehensive form components for user input.
44
-
45
- | Component | Key props |
51
+ | Component | Purpose |
46
52
  |---|---|
47
- | `UInput` | `v-model`, `type`, `placeholder`, `icon`, `loading` |
48
- | `UTextarea` | `v-model`, `rows`, `autoresize`, `maxrows` |
49
- | `USelect` | `v-model`, `items` (flat `T[]` or grouped `T[][]`), `placeholder` |
50
- | `USelectMenu` | `v-model`, `items` (flat `T[]` or grouped `T[][]`), `searchable`, `multiple` |
51
- | `UInputMenu` | `v-model`, `items` (flat `T[]` or grouped `T[][]`), `searchable` — autocomplete |
52
- | `UInputNumber` | `v-model`, `min`, `max`, `step` |
53
- | `UInputDate` | `v-model`, `range` (boolean for range selection), `locale` |
54
- | `UInputTime` | `v-model`, `hour-cycle` (12/24), `granularity` |
55
- | `UInputTags` | `v-model`, `max`, `placeholder` |
56
- | `UPinInput` | `v-model`, `length`, `type`, `mask` |
57
- | `UCheckbox` | `v-model`, `label`, `description` |
58
- | `UCheckboxGroup` | `v-model`, `items`, `orientation` |
59
- | `URadioGroup` | `v-model`, `items`, `orientation` |
60
- | `USwitch` | `v-model`, `label`, `on-icon`, `off-icon` |
61
- | `USlider` | `v-model`, `min`, `max`, `step` |
62
- | `UColorPicker` | `v-model`, `format` (hex/rgb/hsl/cmyk/lab), `size` |
63
- | `UFileUpload` | `v-model`, `accept`, `multiple`, `variant` (area/button) |
64
- | `UForm` | `schema`, `state`, `@submit` — validation wrapper |
65
- | `UFormField` | `name`, `label`, `description`, `hint`, `required` |
66
-
67
- ### Form validation
68
-
69
- Uses Standard Schema — works with Zod, Valibot, Yup, or Joi.
70
-
71
- ```vue
72
- <script setup lang="ts">
73
- import { z } from 'zod'
74
-
75
- const schema = z.object({
76
- email: z.string().email('Invalid email'),
77
- password: z.string().min(8, 'Min 8 characters')
78
- })
79
-
80
- type Schema = z.output<typeof schema>
81
- const state = reactive<Partial<Schema>>({ email: '', password: '' })
82
- const form = ref()
83
-
84
- async function onSubmit() {
85
- await form.value.validate()
86
- }
87
- </script>
88
-
89
- <template>
90
- <UForm ref="form" :schema="schema" :state="state" @submit="onSubmit">
91
- <UFormField name="email" label="Email" required>
92
- <UInput v-model="state.email" type="email" />
93
- </UFormField>
94
-
95
- <UFormField name="password" label="Password" required>
96
- <UInput v-model="state.password" type="password" />
97
- </UFormField>
98
-
99
- <UButton type="submit">Submit</UButton>
100
- </UForm>
101
- </template>
102
- ```
103
-
104
- With Valibot:
105
-
106
- ```vue
107
- <script setup lang="ts">
108
- import * as v from 'valibot'
109
-
110
- const schema = v.object({
111
- email: v.pipe(v.string(), v.email('Invalid email')),
112
- password: v.pipe(v.string(), v.minLength(8, 'Min 8 characters'))
113
- })
114
- </script>
115
- ```
116
-
117
- ### File upload
118
-
119
- ```vue
120
- <script setup>
121
- const files = ref<File[]>([])
122
- </script>
123
-
124
- <template>
125
- <UFileUpload v-model="files" accept="image/*" multiple>
126
- <template #actions="{ open }">
127
- <UButton label="Upload" icon="i-lucide-upload" color="neutral" variant="outline" @click="open()" />
128
- </template>
129
- </UFileUpload>
130
- </template>
131
- ```
53
+ | `UAuthForm` | Pre-built auth form with social providers |
54
+ | `UInput` | Text input — text, email, password, search |
55
+ | `UTextarea` | Multi-line text with autoresize |
56
+ | `USelect` | Native-like dropdown for small lists |
57
+ | `USelectMenu` | Rich searchable dropdown, multi-select, groups |
58
+ | `UInputMenu` | Autocomplete / combobox |
59
+ | `UInputNumber` | Numeric input with +/- controls |
60
+ | `UInputRating` | Rating input |
61
+ | `UInputDate` | Date picker with calendar |
62
+ | `UInputTime` | Time picker (12/24h) |
63
+ | `UInputTags` | Tag/chip input |
64
+ | `UListbox` | Selectable list with search and virtualization |
65
+ | `ULocaleSelect` | Select to switch between locales |
66
+ | `UPinInput` | Verification code input |
67
+ | `UCheckbox` | Single boolean checkbox |
68
+ | `UCheckboxGroup` | Multiple checkboxes |
69
+ | `URadioGroup` | Radio button group |
70
+ | `USwitch` | Toggle switch |
71
+ | `USlider` | Range slider |
72
+ | `UColorPicker` | Color picker (hex/rgb/hsl) |
73
+ | `UFileUpload` | File upload (button or drop area) |
74
+ | `UForm` | Validation wrapper with Standard Schema |
75
+ | `UFormField` | Field wrapper with label, hint, errors |
132
76
 
133
- ## Data
134
-
135
- Components for displaying and organizing data.
77
+ ## Overlay
136
78
 
137
- | Component | Key props |
79
+ | Component | Purpose |
138
80
  |---|---|
139
- | `UTable` | `data`, `columns`, `loading`, `sticky` |
140
- | `UAccordion` | `items`, `type` (single/multiple), `collapsible` |
141
- | `UCarousel` | `items`, `orientation`, `arrows`, `dots` |
142
- | `UTimeline` | `items` — vertical timeline |
143
- | `UTree` | `items` — hierarchical tree |
144
- | `UUser` | `name`, `description`, `avatar` — user display |
145
- | `UEmpty` | `icon`, `title`, `description` — empty state |
146
- | `UMarquee` | `repeat`, `reverse`, `orientation`, `pauseOnHover` — infinite scroll |
147
- | `UScrollArea` | Custom scrollbar wrapper |
81
+ | `UModal` | Centered dialog — confirmations, forms |
82
+ | `USlideover` | Side panel — details, editing |
83
+ | `UDrawer` | Bottom sheet — mobile actions |
84
+ | `UPopover` | Contextual popup attached to trigger |
85
+ | `UTooltip` | Hover/focus hint (non-interactive) |
86
+ | `UContextMenu` | Right-click menu |
87
+ | `UCommandPalette` | Search + keyboard navigation (Cmd+K) |
148
88
 
149
89
  ## Navigation
150
90
 
151
- Components for user navigation and wayfinding.
152
-
153
- | Component | Key props |
91
+ | Component | Purpose |
154
92
  |---|---|
155
- | `UNavigationMenu` | `items` (flat `T[]` or grouped `T[][]`), `orientation` (horizontal/vertical) |
156
- | `UBreadcrumb` | `items` |
157
- | `UTabs` | `items`, `orientation`, `variant` |
158
- | `UStepper` | `items`, `orientation`, `color` |
159
- | `UPagination` | `v-model`, `total`, `items-per-page` |
160
- | `ULink` | `to`, `active`, `inactive` — styled NuxtLink |
161
- | `UCommandPalette` | `v-model:open`, `groups` (`{ id, label, items }[]`), `placeholder` |
93
+ | `USidebar` | Standalone sidebar with header/body/footer |
94
+ | `UNavigationMenu` | Primary nav — horizontal or vertical |
95
+ | `UTabs` | Tab switcher within a page |
96
+ | `UBreadcrumb` | Location hierarchy |
97
+ | `UDropdownMenu` | Action menu on a trigger |
98
+ | `UPagination` | Page navigation |
99
+ | `UStepper` | Multi-step wizard |
100
+ | `UAccordion` | Collapsible sections |
162
101
 
163
- ## Overlay
164
-
165
- Floating UI elements that appear above the main content. **All require `<UApp>` wrapper.**
102
+ ## Data
166
103
 
167
- | Component | Key props |
104
+ | Component | Purpose |
168
105
  |---|---|
169
- | `UModal` | `v-model:open`, `title`, `description`, `fullscreen`, `scrollable` |
170
- | `USlideover` | `v-model:open`, `title`, `side` (left/right/top/bottom) |
171
- | `UDrawer` | `v-model:open`, `title`, `handle` |
172
- | `UPopover` | `arrow`, `content: { side, align }`, `openDelay`, `closeDelay` |
173
- | `UTooltip` | `text`, `content: { side }`, `delayDuration` |
174
- | `UDropdownMenu` | `items` (flat `T[]` or grouped `T[][]` with separators, supports nested `children`) |
175
- | `UContextMenu` | `items` (flat `T[]` or grouped `T[][]`) — right-click menu |
176
- | `UToast` | Used via `useToast()` composable |
177
-
178
- ### Modal
179
-
180
- ```vue
181
- <UModal v-model:open="isOpen" title="Edit" description="Edit your profile">
182
- <template #body>Content</template>
183
- <template #footer>
184
- <UButton variant="ghost" @click="isOpen = false">Cancel</UButton>
185
- <UButton @click="save">Save</UButton>
186
- </template>
187
- </UModal>
188
- ```
189
-
190
- Slots: `#content`, `#header`, `#body`, `#footer`
191
-
192
- ### Slideover
193
-
194
- ```vue
195
- <USlideover v-model:open="isOpen" title="Settings" side="right">
196
- <template #body>Content</template>
197
- </USlideover>
198
- ```
199
-
200
- ### Drawer
201
-
202
- ```vue
203
- <UDrawer v-model:open="isOpen" title="Options" handle>
204
- <template #body>Content</template>
205
- </UDrawer>
206
- ```
207
-
208
- ### DropdownMenu
209
-
210
- Items accept a flat array or a nested array (each sub-array is rendered as a group separated by dividers):
211
-
212
- ```vue
213
- <!-- Flat array -->
214
- <UDropdownMenu :items="[
215
- { label: 'Edit', icon: 'i-lucide-pencil', onSelect: () => edit() },
216
- { type: 'separator' },
217
- { label: 'Delete', icon: 'i-lucide-trash', color: 'error' }
218
- ]">
219
- <UButton icon="i-lucide-ellipsis-vertical" variant="ghost" />
220
- </UDropdownMenu>
221
-
222
- <!-- Nested array (groups with automatic separators) -->
223
- <UDropdownMenu :items="[
224
- [{ label: 'Edit', icon: 'i-lucide-pencil' }, { label: 'Duplicate', icon: 'i-lucide-copy' }],
225
- [{ label: 'Delete', icon: 'i-lucide-trash', color: 'error' }]
226
- ]">
227
- <UButton icon="i-lucide-ellipsis-vertical" variant="ghost" />
228
- </UDropdownMenu>
229
- ```
230
-
231
- ### Toast
232
-
233
- ```ts
234
- const toast = useToast()
235
-
236
- toast.add({
237
- title: 'Success',
238
- description: 'Changes saved',
239
- color: 'success',
240
- icon: 'i-lucide-check-circle',
241
- duration: 5000,
242
- actions: [{ label: 'Undo', onClick: () => undo() }]
243
- })
244
- ```
245
-
246
- ### Programmatic overlays
247
-
248
- ```ts
249
- const overlay = useOverlay()
250
-
251
- // create() returns a reusable instance
252
- const confirmDialog = overlay.create(ConfirmDialog)
253
-
254
- // open() returns an object with .result (a Promise)
255
- const { result } = confirmDialog.open({
256
- title: 'Delete?',
257
- message: 'This cannot be undone.'
258
- })
259
-
260
- if (await result) {
261
- // User confirmed
262
- }
263
-
264
- // Inside the overlay component, emit close with a value:
265
- // emit('close', true) or emit('close', false)
266
- ```
267
-
268
- ### CommandPalette
269
-
270
- ```vue
271
- <script setup>
272
- const groups = [{
273
- id: 'actions',
274
- label: 'Actions',
275
- items: [
276
- { label: 'New file', icon: 'i-lucide-file-plus', onSelect: () => {} },
277
- { label: 'Settings', to: '/settings' }
278
- ]
279
- }]
280
-
281
- defineShortcuts({ meta_k: () => { isOpen.value = true } })
282
- </script>
283
-
284
- <UCommandPalette v-model:open="isOpen" :groups="groups" placeholder="Search..." />
285
- ```
286
-
287
- ## Page
106
+ | `UTable` | Data table (TanStack Table) with sorting, selection, pinning |
107
+ | `UTree` | Hierarchical tree view |
288
108
 
289
- Pre-built sections for marketing and content pages.
109
+ ## Dashboard
290
110
 
291
111
  | Component | Purpose |
292
112
  |---|---|
293
- | `UPage` | Multi-column grid (`#left`, `#default`, `#right`) |
294
- | `UPageAside` | Sticky sidebar wrapper (visible from `lg`) |
295
- | `UPageHero` | Hero section with title, description, links, media |
296
- | `UPageSection` | Content section with headline, features grid |
113
+ | `UDashboardGroup` | Root dashboard wrapper |
114
+ | `UDashboardSidebar` | Resizable, collapsible sidebar |
115
+ | `UDashboardPanel` | Content panel with header/body/footer |
116
+ | `UDashboardNavbar` | Panel header bar |
117
+ | `UDashboardToolbar` | Filter/action bar below navbar |
118
+ | `UDashboardResizeHandle` | Resize handle between panels |
119
+ | `UDashboardSidebarToggle` | Mobile sidebar toggle button |
120
+ | `UDashboardSearchButton` | Search button for sidebar |
121
+ | `UDashboardSearch` | Dashboard-level search overlay |
122
+ | `UDashboardSidebarCollapse` | Collapse button for sidebar |
123
+
124
+ ## Page (marketing)
125
+
126
+ | Component | Purpose |
127
+ |---|---|
128
+ | `UPage` | Multi-column layout with left/right sidebars |
129
+ | `UPageHero` | Hero section — title, description, links, media |
130
+ | `UPageSection` | Content section with features grid |
297
131
  | `UPageCTA` | Call to action block |
298
132
  | `UPageHeader` | Page title and description |
299
- | `UPageBody` | Main content area with prose styling |
300
- | `UPageFeature` | Individual feature item |
301
- | `UPageGrid` | Grid layout for cards |
133
+ | `UPageBody` | Main content area |
134
+ | `UPageGrid` | Card grid layout |
302
135
  | `UPageColumns` | Multi-column layout |
303
136
  | `UPageCard` | Content card for grids |
304
- | `UPageLogos` | Logo wall |
305
- | `UPageAnchors` | Anchor links (simpler TOC) |
137
+ | `UPageFeature` | Feature item |
138
+ | `UPageLogos` | Logo cloud |
139
+ | `UPageAside` | Sticky sidebar wrapper |
140
+ | `UPageAnchors` | Simple anchor links |
306
141
  | `UPageLinks` | Related resource links |
307
- | `UPageList` | List items |
308
- | `UBlogPosts` | Responsive grid of blog posts (`orientation`) |
309
- | `UBlogPost` | Individual blog post card |
310
- | `UChangelogVersions` | Changelog version list |
142
+ | `UPageList` | List layout for page items |
143
+
144
+ ## Blog & Changelog
145
+
146
+ | Component | Purpose |
147
+ |---|---|
148
+ | `UBlogPosts` | Blog post grid |
149
+ | `UBlogPost` | Individual post card |
150
+ | `UChangelogVersions` | Changelog list |
311
151
  | `UChangelogVersion` | Individual changelog entry |
152
+
153
+ ## Pricing
154
+
155
+ | Component | Purpose |
156
+ |---|---|
312
157
  | `UPricingPlans` | Pricing plan cards |
158
+ | `UPricingPlan` | Individual pricing plan card |
313
159
  | `UPricingTable` | Feature comparison table |
314
160
 
315
- ## Dashboard
161
+ ## Prose — Base Typography
316
162
 
317
- Specialized components for admin interfaces with resizable panels and sidebars.
163
+ Standard Markdown elements auto-resolved by Comark/Content/MDC. No `::` prefix needed — they map directly from markdown syntax (`# Heading` → `ProseH1`, `**bold**` → `ProseStrong`, etc.). Themed via `appConfig.ui.prose.<name>`.
164
+
165
+ | Component | Renders | Notable |
166
+ |---|---|---|
167
+ | `H1` `H2` `H3` `H4` | Headings | H1–H3 get anchor links + TOC entries |
168
+ | `P` | Paragraph | |
169
+ | `A` | Link | External links get target/rel handling |
170
+ | `Strong` | Bold | |
171
+ | `Em` | Italic | |
172
+ | `Blockquote` | Blockquote | |
173
+ | `Hr` | Horizontal rule | |
174
+ | `Ul` `Ol` `Li` | Lists | Supports nesting and mixed lists |
175
+ | `Table` `Thead` `Tbody` `Tr` `Th` `Td` | Tables | |
176
+ | `Img` | Image | Zoom on click (`:zoom="false"` to disable), `@nuxt/image` support |
177
+ | `Pre` | Code block | Copy button, filename + icon, line highlighting (`{2,4-6}`), diff |
178
+ | `Code` | Inline code | `color` and `lang` props |
179
+
180
+ ## Prose — Feature Components
181
+
182
+ Nuxt UI-specific Prose components. In markdown files they are used **without the `Prose` prefix** (e.g. `::callout`, `::steps`). In Vue they are referenced as `ProseCallout`, `ProseSteps`, etc. Comark resolves them automatically when `@nuxt/ui` is installed.
183
+
184
+ Nuxt UI also registers shorthand aliases for `Callout`: `::note`, `::tip`, `::warning`, `::caution` (preset `color` + `icon`).
318
185
 
319
186
  | Component | Purpose |
320
187
  |---|---|
321
- | `UDashboardGroup` | Root wrapper — manages sidebar state |
322
- | `UDashboardSidebar` | Resizable/collapsible sidebar (`#header`, `#default`, `#footer`) |
323
- | `UDashboardPanel` | Content panel (`#header`, `#body`, `#footer`) |
324
- | `UDashboardNavbar` | Panel navbar (`#left`, `#default`, `#right`) |
325
- | `UDashboardToolbar` | Toolbar for filters/actions |
326
- | `UDashboardSearch` | Command palette for dashboards |
327
- | `UDashboardSearchButton` | Search trigger button |
328
- | `UDashboardSidebarToggle` | Mobile sidebar toggle |
329
- | `UDashboardSidebarCollapse` | Desktop collapse button |
330
- | `UDashboardResizeHandle` | Custom resize handle |
188
+ | `Callout` | Highlighted note/warning/tip (`color`, `icon`, `to`) |
189
+ | `Badge` | Inline badge/tag |
190
+ | `Kbd` | Keyboard key |
191
+ | `Icon` | Inline Iconify icon |
192
+ | `Prompt` | Terminal prompt block |
193
+ | `Card` `CardGroup` | Content card and card grid |
194
+ | `Steps` | Numbered step list (`level` prop sets heading depth) |
195
+ | `Tabs` `TabsItem` | Tabbed content (`sync` for localStorage, `hash` for scroll-on-change) |
196
+ | `Accordion` `AccordionItem` | Collapsible accordion sections |
197
+ | `Collapsible` | Single collapsible section |
198
+ | `Field` `FieldGroup` | Form field display |
199
+ | `CodeGroup` | Tabbed code blocks |
200
+ | `CodeCollapse` | Collapsible code block |
201
+ | `CodeIcon` | File-type icon in code headers |
202
+ | `CodePreview` | Code + live rendered preview side by side |
203
+ | `CodeTree` | File tree display |
204
+ | `Script` | Script injection |
205
+
206
+ ## Content (Nuxt Content)
331
207
 
332
- ## Chat
208
+ | Component | Purpose |
209
+ |---|---|
210
+ | `UContentNavigation` | Sidebar navigation from content |
211
+ | `UContentToc` | Table of contents |
212
+ | `UContentSurround` | Prev/next navigation |
213
+ | `UContentSearch` | Search command palette |
214
+ | `UContentSearchButton` | Trigger for content search |
333
215
 
334
- Components for conversational AI interfaces, powered by [Vercel AI SDK](https://ai-sdk.dev/).
216
+ ## Chat (AI)
335
217
 
336
218
  | Component | Purpose |
337
219
  |---|---|
338
- | `UChatMessages` | Scrollable message list with auto-scroll |
339
- | `UChatMessage` | Individual message display |
220
+ | `UChatMessages` | Scrollable message list |
221
+ | `UChatMessage` | Individual message bubble |
222
+ | `UChatReasoning` | Collapsible AI reasoning block |
223
+ | `UChatTool` | Tool invocation status |
224
+ | `UChatShimmer` | Streaming text animation |
340
225
  | `UChatPrompt` | Enhanced textarea for prompts |
341
- | `UChatPromptSubmit` | Submit button with status handling |
226
+ | `UChatPromptSubmit` | Submit button with status |
342
227
  | `UChatPalette` | Chat layout for overlays |
343
228
 
344
229
  ## Editor
345
230
 
346
- Rich text editor powered by [TipTap](https://tiptap.dev/).
347
-
348
231
  | Component | Purpose |
349
232
  |---|---|
350
- | `UEditor` | Editor (`v-model`, `content-type`: json/html/markdown) |
351
- | `UEditorToolbar` | Toolbar (`layout`: fixed/bubble/floating) |
233
+ | `UEditor` | Rich text editor (JSON/HTML/Markdown) |
234
+ | `UEditorToolbar` | Toolbar (fixed/bubble/floating) |
352
235
  | `UEditorDragHandle` | Block drag-and-drop |
353
236
  | `UEditorSuggestionMenu` | Slash command menu |
354
237
  | `UEditorMentionMenu` | @ mention menu |
355
238
  | `UEditorEmojiMenu` | Emoji picker |
356
239
 
357
- ## Content
358
-
359
- Components integrating with `@nuxt/content`.
360
-
361
- | Component | Purpose |
362
- |---|---|
363
- | `UContentNavigation` | Sidebar navigation tree |
364
- | `UContentToc` | Table of contents |
365
- | `UContentSurround` | Prev/next links |
366
- | `UContentSearch` | Search command palette |
367
- | `UContentSearchButton` | Search trigger button |
368
-
369
240
  ## Color Mode
370
241
 
371
242
  | Component | Purpose |
372
243
  |---|---|
373
- | `UColorModeButton` | Toggle light/dark button |
374
- | `UColorModeSwitch` | Toggle light/dark switch |
375
- | `UColorModeSelect` | Dropdown selector |
376
- | `UColorModeAvatar` | Avatar with different src per mode |
377
- | `UColorModeImage` | Image with different src per mode |
244
+ | `UColorModeButton` | Toggle button (light/dark) |
245
+ | `UColorModeSwitch` | Toggle switch (light/dark) |
246
+ | `UColorModeSelect` | Dropdown (light/dark/system) |
247
+ | `UColorModeAvatar` | Avatar that changes with color mode |
248
+ | `UColorModeImage` | Image that changes with color mode |