Releases # Changelog New features and fixes, explained in plain English. ## Registry 0.14.2 (published) 2026-11-16: Improve keyboard navigation, action feedback, and selected colors across Vue components. - Selected tabs use the page background in both themes and show an outline during keyboard focus. - Combobox and Composer suggestions use more distinct highlight colors, including their supporting text. - Current page numbers and toggle labels remain readable while the selection moves. - The default and starter dark palettes give loading placeholders and hover surfaces a distinct fill. - Calendars share date navigation, and tabs, toolbars, and menus share the keyboard rules they have in common. - FileUpload and Composer reuse previews for retained files and release them when the files are removed. - The registry and installer catch invalid file paths before installation, and docs copy buttons show consistent feedback. - DataTable headings are easier to read, column resize handles keep clear of sort buttons, and row tooltips stay above the header. - SearchInput shows one clear button, and pointer-opened menus no longer highlight the first action automatically. - VirtualList follows native scrollbar movement while measuring rows of different heights. - FileUpload previews the active file inside its drop zone and lets you add more files without clearing the selection. - Form can focus the first invalid field, and nested menus are easier to reach with a pointer. Packages: {"@getweini/vue":"0.7.9"} ## Registry 0.13.4 (published) 2026-11-12: Keep dialogs compact when a stylesheet resets their height. Packages: {"@getweini/vue":"0.7.6"} ## Registry 0.13.3 (published) 2026-11-12: Use Pearl and Obsidian as the default colors and improve the mobile docs. - Pearl uses warm light surfaces and Obsidian uses near-black dark surfaces, with blue actions in both modes. - Toggle groups scroll inside narrow layouts so every button stays reachable. - The mobile docs put search and theme controls in the navigation menu and use icon-only copy buttons. Packages: {"@getweini/vue":"0.7.6"} ## Registry 0.13.2 (published) 2026-11-03: Keep tabs and verification forms steady, and show component previews sooner. - Tab labels keep a steady size when hovered or pressed. - Table and DataTable heading and body colors finish their theme changes together. - PIN inputs and the OTP verification block reserve room for short validation messages so controls stay in place. - Component pages preserve their first paint during hydration, load previews sooner, and keep navigation consistent at trailing-slash URLs. Packages: {"@getweini/vue":"0.7.5"} ## Registry 0.13.0 (published) 2026-10-25: Add avatar groups and chips, expand the block gallery, and improve component colors, spacing, and motion. - Compose AvatarGroup and AvatarGroupCount with existing Avatar parts for overlapping members, shared sizes and shapes, and an app-owned overflow disclosure. Explicit Avatar props override group defaults. - Chip adds static category and status labels with default, secondary, and destructive variants, independent filled, outline, and ghost modes, optional CSS colors, and prefix and suffix slots. - DataTable supports separate header and cell alignment, configurable tabular digits, and header prefix and suffix templates. Breaking change for DataTable users of @getweini/vue and installed registry source: currency columns previously aligned to end and number columns to center automatically; all formats now default to inline-start. Set align: 'end' for currency columns and align: 'center' for number columns to preserve the previous layout. - ActivityTimeline places timestamps below titles and actions inside detail cards. Structured content uses the content slot while existing text entries remain supported. - The block gallery includes 42 copyable interfaces with improved previews and installation guidance, including authentication, dashboards, forms, marketing, settings, and workspace examples. - Default theme corners, nested menu and tab surfaces, joined field seams, and control background clipping stay consistent across sizes and themes. Existing radius overrides remain supported. - Component colors distinguish selection, warnings, destructive actions, disabled and invalid controls, placeholders, and supporting text. Optional control-border, mention, mention-foreground, and warning-indicator tokens preserve custom-theme fallbacks. - Navigation dropdowns shrink to the active panel, TagsInput uses even insets and concentric tag corners, and reorderable rows preserve their corner treatment while dragging. - NumberInput step buttons respond to successful pointer, keyboard, method, and focused wheel changes, including repeated steps, bounds, and reduced motion. Stepper selection and responsive layouts receive smoother motion and spacing. - Table and DataTable examples show formatted dates, aligned headers, colored chips, and accessible row actions with an activity history sheet. Docs navigation and compact controls use consistent spacing and current-page treatment. Packages: {"@getweini/vue":"0.7.5"} ## Registry 0.10.1 (published) 2026-10-24: Browse and copy complete Vue interface blocks, with reliable button slot rendering. - Explore 17 website blocks for authentication, settings, dashboards, navigation, tables, and feedback. Preview mobile, tablet, desktop, dark, and right-to-left layouts, then copy the Vue source and component install command. - Buttons and component-backed primitives preserve Vue slot context when mounted during an update, preventing slot warnings while keeping links, disabled states, and child composition intact. Packages: {"@getweini/vue":"0.7.1"} ## Registry 0.10.0 (published) 2026-10-19: Make chart categories distinct and improve theme consistency and high-contrast states. - RangeSlider handles have smoother circular edges at rest and during interaction. - Keyboard behavior change: Composer and Textarea continue numbered and bullet lists with Ctrl/Cmd+Enter. Press it again on the empty item to leave the list. Previously this shortcut sent a list draft in Composer; use the send button or move outside the list to send with Ctrl/Cmd+Enter. - Appearance change: chart-1 through chart-5 now identify unrelated categories with distinct colors. Use chart-sequential-1 through chart-sequential-5 to keep the former Weini blue ramps, or override the chart tokens in your own theme. - Alerts use paired subtle status surfaces, foregrounds, and borders. Existing custom themes keep working through fallback values; Alert props and variants are unchanged. - InlineEdit uses a simple solid underline while editing. - Stepper keeps the active circle and moving outline at the same size, fixing the doubled ring on the current step. - Carousel dots lift on hover, squash on press, and morph continuously with native scrolling. Reduced motion keeps updates instant. - Tabs, single-selection toggle groups, and pagination use fluid selection markers. Switches, sliders, ratings, steppers, and reorderable lists respond to direct interaction while preserving stable targets and reduced-motion alternatives. - Dark utilities also apply to the element carrying the dark class. The editable starter has distinct small shadows and ships from one canonical source in the CLI. - Keyboard focus, checked, selected, invalid, and open states gain targeted high-contrast indicators. - The theming guide publishes generated light and dark token values and chart examples. Guides explain component choices, runtime requirements, and the optional Vee Validate beta peer. - Compatibility: controls retain their shared border appearance. Existing token overrides and edited installed files remain application-owned. Packages: {"@getweini/vue":"0.7.0"} ## Registry 0.9.2 (published) 2026-10-19: Add nine editable components, richer text editing, and smoother motion. - Browse slides, copy text, edit values in place, display moving content, collect star ratings, and reorder items with editable Vue components. - Inline editing inherits surrounding typography, places the caret where you click, and shows an underline only while editing. Rating stars use golden yellow fills. - The component navigation marks the six new components with a New badge. - The marquee moves more slowly by default and includes an image-logo example. - Reorderable lists follow the pointer smoothly, can share items across lists in a board, and drag from the whole row by default without opening an item after a drag. - Carousel dots stay round, with controls below the slides, over the cards, or hidden. - Action palettes can show recent actions and groups, announce search results, and open with a shortcut. - Form controls use the same border token as other outlined surfaces. - Dark mode has a lighter charcoal page, a deeper sidebar, and lighter form fields and outlined buttons. - Composer is built from small parts: a growing text field, mentions, file attachments, dictation through a small application adapter, and a send button. Use only the parts you need and arrange the action buttons your way. - Mention people, groups, issues, or other application records, with avatars in suggestions and rounded, padded references in saved messages. - Applications control delivery and uploads, keeping the draft until a message has been sent successfully. - Type "- " or "1. " at the start of a line in Composer to start a list. Enter continues it, Enter on an empty item ends it, and Tab and Shift+Tab change its depth. Use Ctrl or Cmd+Enter to send from inside a list. - The expand button in Composer is always visible, not only after the text wraps. - Textarea now shows real bullet and numbered lists that continue as you type, with the same look as Composer. It still works with forms. Its element is now an editable field instead of a native textarea, and it has an optional expand button. - Tabs keep their selected background during server rendering and respect reduced motion. - Single-selection toggle groups slide the background between options; multiple selections keep their own highlights. - Stepper connectors fill toward the current step in horizontal, vertical, and right-to-left layouts. - Pagination always slides the selected background to the new page, even when the visible page range changes. - Toasts now grow into place with a gentle spring and leave quickly without bouncing. The new spring motion tokens are available to your own styles. - Menus, pickers, tooltips, dialogs, sheets, and drawers open with a gentle spring, and dialogs, alert dialogs, and sheets now animate closed instead of disappearing. Switches, radio buttons, tabs, and loading buttons use the same spring. - Date and time pickers keep the selected time visible while their opening animation plays. - Dismissing a focused toast keeps keyboard focus in the remaining notifications during its exit animation. - Nested menus stay aligned when opened during the parent menu animation. Component documentation registers page metadata before loading its details. - The new Island is a floating pill that springs between a compact and an expanded state, like a live activity. - All of these keep their selected appearance during server rendering and respect reduced motion. - Select and multi-select open, close, and respond to the keyboard the same way, with no change to how you use them. - Success and warning colors now use the same color format as the rest of the theme, with the same appearance. - Shadows grow steadily from the smallest to the largest size, and dark theme shadows are easier to see. - The installer is checked for type mistakes and its health check is easier to maintain, with no change to its commands. Packages: {"@getweini/vue":"0.6.2"} ## Registry 0.6.2 (published) 2026-10-13: Keep table actions stable and prevent panels, notifications, and narrow content from overflowing. - Keep the table in place when labelled filters are replaced by bulk actions, including at mobile widths. - Keep navigation panels inside the screen and let tall panels scroll in either reading direction. - Wrap long notification text and keep focused notification actions visible while navigating with the keyboard. - Apply field styling once, stack narrow inline details, and wrap long activity timestamps. - Show the correct avatar fallback when an image finishes loading or fails before hydration. Packages: {"@getweini/vue":"0.3.1"} ## Registry 0.6.1 (published) 2026-09-30: Add DataTable and five productivity components, dynamic VirtualList rows, and searchable documentation. - Install DataTable with sorting, filters, search, selection, pagination, resizable columns, custom cells, and asynchronous row and bulk actions for client or server data. - Enter and validate repeated values with TagsInput, choose date and time in one DateTimePicker panel, and display structured details, metrics, and activity with DescriptionList, Stat, and ActivityTimeline. - Let VirtualList measure dynamic row heights, preserve the visible row as content changes, and refine scrollToIndex after measuring its destination. - Join InputGroup fields and actions with clean seams and use consistent resize dividers in DataTable and Resizable. - Use editable English defaults and partial localeText overrides for the new input components and DataTable. - Install custom DataTable cells without a Vue type resolution error through CLI 0.4.1, and keep Nuxt imports correct when dependencies are already installed or customized. - Search the documentation, copy or open pages with AI tools, read Markdown versions, and use updated guides and live examples. Packages: {"@getweini/vue":"0.3.0"} ## Registry 0.5.0 (published) 2026-09-27: This release updates editable Vue components, forms, menus, installation, and the live documentation examples. - Buttons, icon buttons, split buttons, toolbar actions, pagination, sidebar actions, toggles, and common overlay triggers give a subtle press response that respects reduced-motion settings. - Breaking change for installed Vue forms: the Field wrapper is removed. Replace it with a native label linked to a named control, and use the control error slot for validation messages. Forms support Vee Validate, Zod, Yup, or Kern; see the forms guide for migration examples. - Tooltips, menus, pickers, and other triggered panels share consistent arrows, floating surfaces, and spacing. - All component previews and executable examples load the current Weini UI source, so appearance changes show up without manually updating preview copies. - The CLI keeps Nuxt component imports working when an installed dependency is named index.vue. Packages: {"@getweini/vue":"0.2.0"} ## Registry 0.4.0 (published) 2026-09-26: Setup now preserves existing application configuration, controls keep form values and keyboard focus in sync, and component downloads include only the required source. Documentation examples are executable and API guidance follows the installed contracts. Package pages now include beginner setup instructions and clearer descriptions. Packages: {"@getweini/vue":"0.1.2"} ## Registry 0.3.0 (unreleased) 2026-09-25: Vue components now keep appearance and layout easy to edit while @getweini/vue owns their interaction behavior. Visual variants have clear edit points, with public APIs and install paths preserved. ## Registry 0.2.0 (unreleased) 2026-09-25: Weini now installs editable Vue components with shared behavior, types, styling, and optional fonts from @getweini/vue. The CLI guides first-time setup and can update styling and fonts in existing projects. Packages: {"@getweini/vue":"0.1.0"} ## Registry 0.1.4 (published) 2026-09-24: Vue and Nuxt route links now render Weini button and link content without a missing asChild property warning. ## Registry 0.1.3 (published) 2026-09-24: Links, buttons, and dialog triggers now compose with Vue and Nuxt components. Pagination can use real route links, date controls can share one server-rendered reference date, and NumberInput only steps on wheel when enabled. ## Registry 0.1.2 (published) 2026-09-24: Buttons can now render as links for navigation while keeping Weini styles and native link behavior. ## Registry 0.1.1 (published) 2026-09-24: Calendar range selections now use the same continuous day band and rounded endpoints as DatePickerRange. ## CLI 0.1.1 (published) 2026-09-24: Choose a copyable command for npm, pnpm, Yarn, or Bun. The Weini command now adds TypeScript when a new Vue project needs it. ## Registry 0.1.0 (published) 2026-09-23: The first Weini UI components are available as editable Vue source. Add only the components you need with the Weini command. --- Components # Choose a component Start with what you want the person using your app to do. Open a component to try it and copy a working example. ## Help someone take an action - [Button](https://ui.weini.lu/components/button): An action button or styled link with editable variants, sizes, and a loading state. - [IconButton](https://ui.weini.lu/components/icon-button): An icon-only button with an accessible label, loading state, and three sizes. - [ButtonGroup](https://ui.weini.lu/components/button-group): Groups related controls horizontally or vertically without changing their behavior. - [Toggle](https://ui.weini.lu/components/toggle): A native two-state button with pressed semantics. - [ToggleGroup](https://ui.weini.lu/components/toggle-group): Coordinates a roving set of single- or multiple-selection toggle buttons. - [SplitButton](https://ui.weini.lu/components/split-button): Combines a primary native action with a separate keyboard-accessible menu. - [Action Surface](https://ui.weini.lu/components/action-surface): Define an action once and present it consistently through palettes, context menus, sheets, toolbars, and opt-in shortcuts. - [Toolbar](https://ui.weini.lu/components/toolbar): A roving-focus group for buttons, links, separators, and toggle groups. - [CopyButton](https://ui.weini.lu/components/copy-button): A button that copies text to the clipboard and confirms the result visually and to assistive technology. ## Collect an answer - [Form](https://ui.weini.lu/components/form): Connects named controls to Vee Validate or Kern form state. - [Input](https://ui.weini.lu/components/input): A text field that keeps native input behavior and supports prefix and suffix slots. - [NumberInput](https://ui.weini.lu/components/number-input): A native number field with step buttons and optional units. - [Checkbox](https://ui.weini.lu/components/checkbox): A native checkbox for boolean or array models, including mixed state. - [RadioGroup](https://ui.weini.lu/components/radio-group): Native radios grouped by a fieldset and legend. - [Select](https://ui.weini.lu/components/select): A select-only combobox with keyboard navigation and typeahead. - [MultiSelect](https://ui.weini.lu/components/multi-select): A multi-select listbox with removable chips and overflow. - [Textarea](https://ui.weini.lu/components/textarea): A multi-line text field with real bullet and numbered lists, the same look as Composer, and form support. - [Switch](https://ui.weini.lu/components/switch): A labelled on/off control built on a native checkbox. - [Label](https://ui.weini.lu/components/label): A visible label with optional required and disabled styling. - [Combobox](https://ui.weini.lu/components/combobox): An editable, typo-tolerant input that filters a listbox and stores the selected option value. - [PasswordInput](https://ui.weini.lu/components/password-input): A native password field with a localized visibility toggle. - [SearchInput](https://ui.weini.lu/components/search-input): A native search field with a localized clear action. - [Slider](https://ui.weini.lu/components/slider): A styled native range input with optional visible value formatting. - [RangeSlider](https://ui.weini.lu/components/range-slider): A bounded interval control composed from two native range inputs. - [FileUpload](https://ui.weini.lu/components/file-upload): Pick or drop files, see image thumbnails and file details, and preview images and PDFs. - [PinInput / OTP](https://ui.weini.lu/components/pin-input): A multi-cell PIN or one-time-code input with paste and complete handling. - [DatePicker](https://ui.weini.lu/components/date-picker): A polished calendar picker with localized formatting and native form behavior. - [DatePickerRange](https://ui.weini.lu/components/date-picker-range): A two-month range picker with continuous selection bands and native form values. - [TimePicker](https://ui.weini.lu/components/time-picker): A compact custom time picker with step-aware hour, minute, and second lists. - [Input Group](https://ui.weini.lu/components/input-group): Compose a native input with attached actions and shared focus styling. - [Calendar](https://ui.weini.lu/components/calendar): An inline keyboard-accessible single-date or date-range calendar. - [TagsInput](https://ui.weini.lu/components/tags-input): Enter, paste, validate, remove, and submit multiple string values in one field. - [DateTimePicker](https://ui.weini.lu/components/date-time-picker): One date and time field with a shared calendar and time selection panel. - [Rating](https://ui.weini.lu/components/rating): A star rating built on native radio inputs, with half steps, a read-only display, and form submission. - [InlineEdit](https://ui.weini.lu/components/inline-edit): Edit a value in place with keyboard save and cancel controls. - [Composer](https://ui.weini.lu/components/composer): A message composer built from a field, mentions, attachments, dictation, and send parts. ## Show information - [Card](https://ui.weini.lu/components/card): A composable surface for related content and actions. - [Badge](https://ui.weini.lu/components/badge): A compact status or category label. - [Chip](https://ui.weini.lu/components/chip): A compact, colored label for categories and statuses. - [Separator](https://ui.weini.lu/components/separator): A horizontal or vertical rule between related sections. - [Avatar](https://ui.weini.lu/components/avatar): An image that shows your fallback content while loading or when the image fails. - [Avatar Group](https://ui.weini.lu/components/avatar-group): A compact overlapping group of avatars with an optional overflow count. - [Alert](https://ui.weini.lu/components/alert): A static notice surface with composable title, description, action, and icon regions. - [Progress](https://ui.weini.lu/components/progress): A native progress element for determinate or indeterminate work. - [EmptyState](https://ui.weini.lu/components/empty-state): A composable presentation layout for empty results and first-use states. - [Skeleton](https://ui.weini.lu/components/skeleton): A decorative placeholder block for loading layouts. - [Table](https://ui.weini.lu/components/table): Compose responsive data tables with semantic rows, headers, and cells. - [DataTable](https://ui.weini.lu/components/data-table): Render rows, filters, sorting, selection, and pagination from column definitions. - [Spinner](https://ui.weini.lu/components/spinner): A compact, reduced-motion-aware loading indicator. - [VirtualList](https://ui.weini.lu/components/virtual-list): Render long lists efficiently with fixed or dynamic row heights and native scrolling. - [Tree](https://ui.weini.lu/components/tree): A finite hierarchical collection with expansion, selection, roving focus, and typeahead. - [DescriptionList](https://ui.weini.lu/components/description-list): Responsive semantic key-value details with concise item composition. - [Stat](https://ui.weini.lu/components/stat): A dashboard metric with independent direction, tone, context, and loading state. - [ActivityTimeline](https://ui.weini.lu/components/activity-timeline): A semantic activity feed with status markers, links, timestamps, optional detail cards, and loading state. - [Marquee](https://ui.weini.lu/components/marquee): A seamless, pausable looping ticker for logos, quotes, or announcements that stops under reduced motion. - [Carousel](https://ui.weini.lu/components/carousel): A swipeable snap carousel with arrows, slide dots, and accessible autoplay. - [Reorderable List](https://ui.weini.lu/components/reorderable-list): A keyboard and pointer accessible list that reports committed item moves. - [MentionText](https://ui.weini.lu/components/mention-text): Renders message text with structured entity mentions. - [Island](https://ui.weini.lu/components/island): A floating rounded panel that springs between a compact and an expanded live-activity state. ## Open more information - [Popover](https://ui.weini.lu/components/popover): A non-modal panel for a few interactive controls. - [DropdownMenu](https://ui.weini.lu/components/dropdown-menu): A keyboard accessible list of actions. - [Tooltip](https://ui.weini.lu/components/tooltip): Short, non-interactive help on hover or focus. - [Toast](https://ui.weini.lu/components/toast): Brief, non-blocking notifications for actions and status updates. - [Dialog](https://ui.weini.lu/components/dialog): A native top-layer modal with a stationary header and footer and a scrollable body. - [AlertDialog](https://ui.weini.lu/components/alert-dialog): A confirmation modal that initially focuses its cancel action. - [Sheet](https://ui.weini.lu/components/sheet): A top-layer edge panel with a stationary header and footer and scrollable body. - [Drawer](https://ui.weini.lu/components/drawer): A bottom sheet for focused choices, with a drag handle and directional swipe to dismiss. - [ContextMenu](https://ui.weini.lu/components/context-menu): A pointer-, keyboard-, and long-press-invoked menu positioned at the interaction point. - [Hover Card](https://ui.weini.lu/components/hover-card): A preview panel opened by hover, focus, or click. ## Move around the app - [Tabs](https://ui.weini.lu/components/tabs): Switch related views while keeping each panel mounted. - [Breadcrumb](https://ui.weini.lu/components/breadcrumb): A native breadcrumb navigation composition with real links and a current page. - [Pagination](https://ui.weini.lu/components/pagination): Page navigation with buttons or real Vue router links. - [Accordion](https://ui.weini.lu/components/accordion): A keyboard-navigable disclosure group with single or multiple open sections. - [Stepper](https://ui.weini.lu/components/stepper): An ordered process navigator with an active-step panel and optional linear flow. - [Link](https://ui.weini.lu/components/link): A styled native anchor or Vue router link that preserves link behavior. - [NavigationMenu](https://ui.weini.lu/components/navigation-menu): Semantic website navigation with disclosure content, active links, and managed keyboard focus. - [Sidebar](https://ui.weini.lu/components/sidebar): A responsive app sidebar with collapsible groups and a mobile drawer. - [Menubar](https://ui.weini.lu/components/menubar): A persistent desktop-style command bar with managed top-level and nested menu focus. ## Arrange content - [AspectRatio](https://ui.weini.lu/components/aspect-ratio): A CSS aspect-ratio wrapper for media and previews. - [Kbd](https://ui.weini.lu/components/kbd): A native keyboard-input hint for shortcuts and commands. - [VisuallyHidden](https://ui.weini.lu/components/visually-hidden): Visually hide text while keeping it available to assistive technology. - [Collapsible](https://ui.weini.lu/components/collapsible): A controlled or uncontrolled disclosure region with native trigger semantics. - [ScrollArea](https://ui.weini.lu/components/scroll-area): A styled native scrolling viewport with reactive edge state. - [Resizable](https://ui.weini.lu/components/resizable): Keyboard- and pointer-resizable horizontal or vertical panel groups. --- # Accordion A keyboard-navigable disclosure group with single or multiple open sections. ## Interactive showcase ## Install Run in your project **npm** ```sh npx @getweini/cli@latest add accordion ``` **pnpm** ```sh pnpm dlx @getweini/cli@latest add accordion ``` **yarn** ```sh yarn dlx @getweini/cli@latest add accordion ``` **bun** ```sh bunx --bun @getweini/cli@latest add accordion ``` ## Start with this example Import the files copied by the install command, then place the component in your Vue template. The text and values in the example belong to your app; change them to fit your task. ```vue ``` Each trigger is linked to its panel. Arrow keys, Home, and End move between enabled triggers. Place AccordionItem, AccordionTrigger, and AccordionContent inside Accordion. ## When to use it ### Frequently asked questions Reveal answers on demand in a compact list. ### Grouped settings Allow several independent setting sections to remain open. ## More examples ### FAQ One question stays open at a time. ```vue ``` ### Multiple sections Use an array model when several panels can stay expanded. ```vue ``` ## Complete API Every public prop, model, event, slot, and exposed member of the installed Vue parts is listed below. “Not set” means you can leave that value out; “Required” means you must provide it. Native HTML attributes also work where the component uses a native element. ### Accordion | Name | Kind | Type or signature | Default | What it does | | --- | --- | --- | --- | --- | | multiple | prop | boolean \| undefined | Not set | Allow more than one item or file to be selected. | | collapsible | prop | boolean \| undefined | Not set | Allow this panel to collapse. | | disabled | prop | boolean \| undefined | Not set | Prevent interaction and show the disabled state. | | modelValue | model | string \| string[] \| undefined | "" | Current value. Use v-model to keep it in sync with your page. | | update:modelValue | event | [value: string \| string[]] | — | Requests a new model value from the parent. | | default | slot | {} | Optional | Content shown inside Accordion. | ### AccordionContent | Name | Kind | Type or signature | Default | What it does | | --- | --- | --- | --- | --- | | default | slot | {} | Optional | Content shown inside AccordionContent. | ### AccordionItem | Name | Kind | Type or signature | Default | What it does | | --- | --- | --- | --- | --- | | value | prop | string | Required | Value represented by this control or option. | | disabled | prop | boolean \| undefined | Not set | Prevent interaction and show the disabled state. | | default | slot | { open: boolean; } | Optional | Content shown inside AccordionItem. | ### AccordionTrigger | Name | Kind | Type or signature | Default | What it does | | --- | --- | --- | --- | --- | | headingLevel | prop | 2 \| 3 \| 4 \| 5 \| 6 \| undefined | 3 | Choose the heading level used for this title. | | default | slot | {} | Optional | Content shown inside AccordionTrigger. | ### Public types ```ts // packages/frameworks/vue/components/accordion/types.ts export interface AccordionProps { multiple?: boolean collapsible?: boolean disabled?: boolean } export interface AccordionItemProps { value: string disabled?: boolean } export interface AccordionTriggerProps { headingLevel?: 2 | 3 | 4 | 5 | 6 } ``` ## Implementation notes - Choose collapsible when a single-selection accordion should allow every panel to close. - Use multiple for independent sections, and give each item a stable value. ## Accessibility and localization - Triggers and panels have linked ARIA relationships; arrow keys, Home, and End navigate enabled triggers. [Source contract and editing guidance](https://github.com/weini-org/weiniUI/blob/develop/packages/frameworks/vue/components/accordion/README.md) --- # Action Surface Define an action once and present it consistently through palettes, context menus, sheets, toolbars, and opt-in shortcuts. ## Interactive showcase ## Install Run in your project **npm** ```sh npx @getweini/cli@latest add action-surface ``` **pnpm** ```sh pnpm dlx @getweini/cli@latest add action-surface ``` **yarn** ```sh yarn dlx @getweini/cli@latest add action-surface ``` **bun** ```sh bunx --bun @getweini/cli@latest add action-surface ``` ## Start with this example Import the files copied by the install command, then place the component in your Vue template. The text and values in the example belong to your app; change them to fit your task. ```vue ``` The toolbar fills its container, shares space between actions, and moves lower-priority actions into More actions when space is tight. In the palette, Up and Down highlight commands while search keeps focus; Enter runs the highlighted command. The example also shows grouped commands, a recent section, a `mod+k` toggle, and an announced result count. Your app supplies execution, confirmation, and undo behavior. Shortcuts do not run while typing in editable controls. ## When to use it ### Command palette Expose a searchable set of application commands from a deliberate button or shortcut. ### Shared action catalog Present the same action definitions through a toolbar and context menu while handling selections centrally. ## More examples ### Searchable commands The provider handles one selection event for all action surfaces. ```vue ``` ### Context and toolbar actions The same definitions appear in a context menu and responsive toolbar. Higher-priority commands stay visible first; less frequent actions move into the toolbar overflow when space is limited. ```vue ``` ## Complete API Every public prop, model, event, slot, and exposed member of the installed Vue parts is listed below. “Not set” means you can leave that value out; “Required” means you must provide it. Native HTML attributes also work where the component uses a native element. ### ActionContextMenu | Name | Kind | Type or signature | Default | What it does | | --- | --- | --- | --- | --- | | label | prop | string | Required | Visible or accessible name for this item. | | longPressDelay | prop | number \| undefined | Not set | Time a touch must be held before opening the menu. | | trigger | slot | () => unknown | Required | Content for the trigger area of ActionContextMenu. | | item | slot | (props: { action: ActionDefinition; }) => unknown | Required | Content for the item area of ActionContextMenu. | ### ActionPalette | Name | Kind | Type or signature | Default | What it does | | --- | --- | --- | --- | --- | | open | model | boolean \| undefined | Not set | Current open state. Use v-model:open to keep it in sync with your page. | | defaultOpen | prop | boolean \| undefined | false | Starting open state when the parent does not control open. | | hotkey | prop | string \| undefined | Not set | Shortcut that toggles the palette from anywhere, e.g. `mod+k`. | | recent | prop | readonly string[] \| undefined | Not set | Action ids to list first while the search is empty. Needs `messages.recent`. | | messages | prop | ActionPaletteMessages | Required | Supply the text this component displays for its built-in actions and states. | | update:open | event | [open: boolean] | — | Requests a new open value from the parent. | | openChange | event | [open: boolean] | — | Emitted after this value or state changes. | | item | slot | (props: { action: ActionDefinition; active: boolean; }) => unknown | Required | Content for the item area of ActionPalette. | ### ActionProvider | Name | Kind | Type or signature | Default | What it does | | --- | --- | --- | --- | --- | | actions | prop | readonly ActionDefinition[] | Required | Provide the actions shown by this component. | | select | event | [selection: ActionSelection] | — | Emitted when the user selects an item. | | shortcutConflict | event | [conflict: ActionShortcutConflict] | — | Emitted when shortcut conflict happens. | | default | slot | (props: { actions: readonly ActionDefinition[]; select: (action: ActionDefinition, source: ActionSource) => void; }) => unknown | Required | Content shown inside ActionProvider. | ### ActionSheet | Name | Kind | Type or signature | Default | What it does | | --- | --- | --- | --- | --- | | open | model | boolean \| undefined | Not set | Current open state. Use v-model:open to keep it in sync with your page. | | defaultOpen | prop | boolean \| undefined | false | Starting open state when the parent does not control open. | | messages | prop | ActionSheetMessages | Required | Supply the text this component displays for its built-in actions and states. | | side | prop | "top" \| "right" \| "bottom" \| "left" \| undefined | "bottom" | Choose the side on which this content appears. | | update:open | event | [open: boolean] | — | Requests a new open value from the parent. | | openChange | event | [open: boolean] | — | Emitted after this value or state changes. | | trigger | slot | () => unknown | Required | Content for the trigger area of ActionSheet. | | item | slot | (props: { action: ActionDefinition; }) => unknown | Required | Content for the item area of ActionSheet. | ### ActionShortcut | Name | Kind | Type or signature | Default | What it does | | --- | --- | --- | --- | --- | | actionId | prop | string | Required | Identify the action this item activates. | | shortcut | prop | string \| undefined | Not set | Keyboard shortcut displayed beside this action. | | source | prop | ActionSource \| undefined | "palette" | Data source used to populate this component. | | conflict | event | [conflict: ActionShortcutConflict] | — | Emitted when conflict happens. | | default | slot | { action: ActionDefinition \| undefined; } | Optional | Content shown inside ActionShortcut. | ### ActionToolbar | Name | Kind | Type or signature | Default | What it does | | --- | --- | --- | --- | --- | | messages | prop | ActionToolbarMessages | Required | Supply the text this component displays for its built-in actions and states. | | item | slot | (props: { action: ActionDefinition; overflow: boolean; }) => unknown | Required | Content for the item area of ActionToolbar. | ### Public types ```ts // packages/frameworks/vue/components/action-surface/types.ts // ------- TYPES ------- export interface ActionDefinition { id: string label: string description?: string keywords?: readonly string[] group?: string shortcut?: string disabled?: boolean destructive?: boolean priority?: number } export type ActionSource = 'palette' | 'context-menu' | 'sheet' | 'toolbar' export interface ActionSelection { action: ActionDefinition source: ActionSource } export interface ActionPaletteMessages { label: string searchLabel: string searchPlaceholder?: string clearSearch: string empty: string /** Heading for the `recent` actions. Recent actions are only shown when this is set. */ recent?: string /** Polite result count announced while searching, e.g. `(n) => `${n} results``. */ results?: (count: number) => string } export interface ActionSheetMessages { label: string } export interface ActionToolbarMessages { label: string overflow: string } export interface ActionShortcutConflict { shortcut: string actionIds: readonly string[] } export interface ActionProviderProps { actions: readonly ActionDefinition[] } export interface ActionPaletteProps { open?: boolean defaultOpen?: boolean /** Shortcut that toggles the palette from anywhere, e.g. `mod+k`. */ hotkey?: string /** Action ids to list first while the search is empty. Needs `messages.recent`. */ recent?: readonly string[] messages: ActionPaletteMessages } export interface ActionContextMenuProps { label: string longPressDelay?: number } export interface ActionSheetProps { open?: boolean defaultOpen?: boolean messages: ActionSheetMessages side?: 'top' | 'right' | 'bottom' | 'left' } export interface ActionToolbarProps { messages: ActionToolbarMessages } export interface ActionShortcutProps { actionId: string shortcut?: string source?: ActionSource } ``` ## Implementation notes - ActionProvider emits an action and its source; the application performs authorization and side effects. - ActionToolbar moves lower-priority actions into an overflow menu when space is limited. ## Accessibility and localization - Supply the required message objects in the application’s language. - Shortcuts are registered only through ActionShortcut; a displayed shortcut is merely a hint. - The palette hotkey ignores editable controls and IME composition. The result count uses the localized `messages.results` callback. [Source contract and editing guidance](https://github.com/weini-org/weiniUI/blob/develop/packages/frameworks/vue/components/action-surface/README.md) --- # ActivityTimeline A semantic activity feed with status markers, links, timestamps, slots, and loading state. ## Interactive showcase ## Install Run in your project **npm** ```sh npx @getweini/cli@latest add activity-timeline ``` **pnpm** ```sh pnpm dlx @getweini/cli@latest add activity-timeline ``` **yarn** ```sh yarn dlx @getweini/cli@latest add activity-timeline ``` **bun** ```sh bunx --bun @getweini/cli@latest add activity-timeline ``` ## Start with this example Import the files copied by the install command, then place the component in your Vue template. The text and values in the example belong to your app; change them to fit your task. ```vue ``` ActivityTimeline renders an ordered list with compact status markers and timestamps below each title. Use `datetime` for the machine-readable value and provide `href` when the event title opens a record. The component owns the timeline and detail-card layout; your app supplies domain fields, badges, avatars, or other content through the scoped slots. The `content` slot adds a bordered detail card below the event description. Compose it with components such as `DescriptionList` for labelled fields. When `content` is present, `actions` appears inside that card below the supplied content; without `content`, actions remain directly below the event text. ## When to use it ### Order history Show delivery, payment, and review events in sequence. ### Audit trail Link events to their source records while keeping timestamps scannable. ## More examples ### Numbered workflow Replace the default marker while preserving list structure. ```vue ``` ### Loading history Reserve four activity rows and mark the list as busy. ```vue ``` ## Complete API Every public prop, model, event, slot, and exposed member of the installed Vue parts is listed below. “Not set” means you can leave that value out; “Required” means you must provide it. Native HTML attributes also work where the component uses a native element. ### ActivityTimeline | Name | Kind | Type or signature | Default | What it does | | --- | --- | --- | --- | --- | | items | prop | readonly ActivityTimelineEntry[] | Required | Data items displayed by this component. | | loading | prop | boolean \| undefined | false | Show that an action is in progress and prevent repeat activation. | | loadingCount | prop | number \| undefined | 3 | Controls the loading count behavior of ActivityTimeline. | | marker | slot | ((props: { item: ActivityTimelineEntry; index: number; }) => unknown) \| undefined | Optional | Content for the marker area of ActivityTimeline. | | title | slot | ((props: { item: ActivityTimelineEntry; index: number; }) => unknown) \| undefined | Optional | Content for the title area of ActivityTimeline. | | description | slot | ((props: { item: ActivityTimelineEntry; index: number; }) => unknown) \| undefined | Optional | Content for the description area of ActivityTimeline. | | time | slot | ((props: { item: ActivityTimelineEntry; index: number; }) => unknown) \| undefined | Optional | Content for the time area of ActivityTimeline. | | content | slot | ((props: { item: ActivityTimelineEntry; index: number; }) => unknown) \| undefined | Optional | Content for the content area of ActivityTimeline. | | actions | slot | ((props: { item: ActivityTimelineEntry; index: number; }) => unknown) \| undefined | Optional | Content for the actions area of ActivityTimeline. | | empty | slot | (() => unknown) \| undefined | Optional | Content for the empty area of ActivityTimeline. | ### Public types ```ts // packages/frameworks/vue/components/activity-timeline/types.ts import type { Component } from 'vue' export type ActivityTimelineTone = 'default' | 'info' | 'success' | 'warning' | 'destructive' export interface ActivityTimelineEntry { id: string | number title: string description?: string timestamp?: string datetime?: string href?: string icon?: Component tone?: ActivityTimelineTone } export interface ActivityTimelineProps { items: readonly ActivityTimelineEntry[] loading?: boolean loadingCount?: number } ``` ## Implementation notes - Provide datetime when timestamp is human-readable so machines retain the precise value. - Use href for events that open a detail record; leave it out when the title is informational rather than interactive. Replace the example's `#` demo links with your application's record URLs. ## Accessibility and localization - Keep activity in chronological or reverse-chronological order and use link titles that make sense out of context. [Source contract and editing guidance](https://github.com/weini-org/weiniUI/blob/develop/packages/frameworks/vue/components/activity-timeline/README.md) --- # AlertDialog A confirmation modal that initially focuses its cancel action. ## Interactive showcase ## Install Run in your project **npm** ```sh npx @getweini/cli@latest add alert-dialog ``` **pnpm** ```sh pnpm dlx @getweini/cli@latest add alert-dialog ``` **yarn** ```sh yarn dlx @getweini/cli@latest add alert-dialog ``` **bun** ```sh bunx --bun @getweini/cli@latest add alert-dialog ``` ## Start with this example Import the files copied by the install command, then place the component in your Vue template. The text and values in the example belong to your app; change them to fit your task. ```vue ``` Clicking the backdrop does not dismiss an alert dialog. Use AlertDialogHeader’s #icon slot to place an icon beside the title. The body scrolls when content is long, and focus starts on Cancel. ## When to use it ### Confirm deletion Ask for an explicit decision before removing data that cannot be recovered. ### Confirm broad changes Explain the scope of a high-impact update before applying it. ## More examples ### Delete a project Cancel receives initial focus. ```vue ``` ### Confirm bulk update Use controlled state when the parent coordinates the operation. ```vue ``` ## Complete API Every public prop, model, event, slot, and exposed member of the installed Vue parts is listed below. “Not set” means you can leave that value out; “Required” means you must provide it. Native HTML attributes also work where the component uses a native element. ### AlertDialog | Name | Kind | Type or signature | Default | What it does | | --- | --- | --- | --- | --- | | open | model | boolean \| undefined | Not set | Current open state. Use v-model:open to keep it in sync with your page. | | defaultOpen | prop | boolean \| undefined | false | Starting open state when the parent does not control open. | | disabled | prop | boolean \| undefined | false | Prevent interaction and show the disabled state. | | update:open | event | [open: boolean] | — | Requests a new open value from the parent. | | openChange | event | [open: boolean] | — | Emitted after this value or state changes. | | default | slot | {} | Optional | Content shown inside AlertDialog. | ### AlertDialogAction | Name | Kind | Type or signature | Default | What it does | | --- | --- | --- | --- | --- | | asChild | prop | boolean \| undefined | Not set | Use one child element as the control instead of adding another wrapper. | | default | slot | {} | Optional | Content shown inside AlertDialogAction. | ### AlertDialogBody | Name | Kind | Type or signature | Default | What it does | | --- | --- | --- | --- | --- | | default | slot | {} | Optional | Content shown inside AlertDialogBody. | ### AlertDialogCancel | Name | Kind | Type or signature | Default | What it does | | --- | --- | --- | --- | --- | | asChild | prop | boolean \| undefined | Not set | Use one child element as the control instead of adding another wrapper. | | default | slot | {} | Optional | Content shown inside AlertDialogCancel. | ### AlertDialogContent | Name | Kind | Type or signature | Default | What it does | | --- | --- | --- | --- | --- | | fullscreen | prop | boolean \| undefined | false | Fill the available viewport with the dialog content. | | size | prop | DialogSize \| undefined | "md" | Choose the visual size. Medium is the usual default where available. | | dismissOnBackdrop | prop | boolean \| undefined | false | Allow a click outside the dialog content to close it. | | persistent | prop | boolean \| undefined | Not set | Keep the dialog open when the backdrop is clicked. | | default | slot | {} | Optional | Content shown inside AlertDialogContent. | ### AlertDialogDescription | Name | Kind | Type or signature | Default | What it does | | --- | --- | --- | --- | --- | | default | slot | {} | Optional | Content shown inside AlertDialogDescription. | ### AlertDialogFooter | Name | Kind | Type or signature | Default | What it does | | --- | --- | --- | --- | --- | | default | slot | {} | Optional | Content shown inside AlertDialogFooter. | ### AlertDialogHeader | Name | Kind | Type or signature | Default | What it does | | --- | --- | --- | --- | --- | | default | slot | () => unknown | Required | Content shown inside AlertDialogHeader. | | icon | slot | (() => unknown) \| undefined | Optional | Content for the icon area of AlertDialogHeader. | | actions | slot | (() => unknown) \| undefined | Optional | Content for the actions area of AlertDialogHeader. | ### AlertDialogTitle | Name | Kind | Type or signature | Default | What it does | | --- | --- | --- | --- | --- | | default | slot | {} | Optional | Content shown inside AlertDialogTitle. | ### AlertDialogTrigger | Name | Kind | Type or signature | Default | What it does | | --- | --- | --- | --- | --- | | disabled | prop | boolean \| undefined | false | Prevent interaction and show the disabled state. | | asChild | prop | boolean \| undefined | Not set | Use one child element as the control instead of adding another wrapper. | | default | slot | {} | Optional | Content shown inside AlertDialogTrigger. | ### Public types ```ts // packages/frameworks/vue/components/alert-dialog/types.ts // ------- IMPORTS ------- import type { DialogContentProps, DialogProps, DialogTriggerProps } from '../dialog/types' // ------- TYPES ------- export type AlertDialogProps = DialogProps export type AlertDialogContentProps = DialogContentProps export type AlertDialogTriggerProps = DialogTriggerProps // packages/frameworks/vue/components/dialog/types.ts // ------- TYPES ------- export type DialogSize = 'sm' | 'md' | 'lg' | 'xl' export interface DialogProps { open?: boolean defaultOpen?: boolean disabled?: boolean } export interface DialogContentProps { fullscreen?: boolean size?: DialogSize dismissOnBackdrop?: boolean persistent?: boolean } export interface DialogTriggerProps { disabled?: boolean asChild?: boolean } export interface DialogCloseProps { asChild?: boolean } ``` ## Implementation notes - AlertDialogAction and AlertDialogCancel close the surface; application code performs the actual operation. - Backdrop dismissal is disabled by default so an accidental click does not confirm or discard the decision. ## Accessibility and localization - Explain the consequence in the title and description, including any icon meaning. - The cancel control receives initial focus and Escape returns focus to the trigger. [Source contract and editing guidance](https://github.com/weini-org/weiniUI/blob/develop/packages/frameworks/vue/components/alert-dialog/README.md) --- # Alert A static notice surface with composable title, description, action, and icon regions. ## Interactive showcase ## Install Run in your project **npm** ```sh npx @getweini/cli@latest add alert ``` **pnpm** ```sh pnpm dlx @getweini/cli@latest add alert ``` **yarn** ```sh yarn dlx @getweini/cli@latest add alert ``` **bun** ```sh bunx --bun @getweini/cli@latest add alert ``` ## Start with this example Import the files copied by the install command, then place the component in your Vue template. The text and values in the example belong to your app; change them to fit your task. ```vue ``` No live-region role is added by default. Use alert only for urgent content inserted dynamically, status for polite updates, and neither for ordinary static page content. ## When to use it ### Form outcome Confirm that a save finished or explain what prevented submission. ### Persistent notice Keep an important policy or deadline visible with a relevant action. ## More examples ### Saved confirmation A polite status works for an update inserted after an action. ```vue ``` ### Static deadline A notice already present at page load does not need a live-region role. ```vue ``` ## Complete API Every public prop, model, event, slot, and exposed member of the installed Vue parts is listed below. “Not set” means you can leave that value out; “Required” means you must provide it. Native HTML attributes also work where the component uses a native element. ### Alert | Name | Kind | Type or signature | Default | What it does | | --- | --- | --- | --- | --- | | variant | prop | "default" \| "info" \| "success" \| "warning" \| "destructive" \| undefined | "default" | Choose the visual treatment for this component. | | role | prop | "alert" \| "status" \| undefined | Not set | Set the semantic role announced to assistive technology. | | default | slot | () => unknown | Required | Content shown inside Alert. | | icon | slot | (() => unknown) \| undefined | Optional | Content for the icon area of Alert. | ### AlertAction | Name | Kind | Type or signature | Default | What it does | | --- | --- | --- | --- | --- | | default | slot | () => unknown | Required | Content shown inside AlertAction. | ### AlertDescription | Name | Kind | Type or signature | Default | What it does | | --- | --- | --- | --- | --- | | default | slot | () => unknown | Required | Content shown inside AlertDescription. | ### AlertTitle | Name | Kind | Type or signature | Default | What it does | | --- | --- | --- | --- | --- | | as | prop | "h2" \| "h3" \| "h4" \| "h5" \| "h6" \| undefined | "h3" | Choose the HTML element or Vue component used for this control. | | default | slot | () => unknown | Required | Content shown inside AlertTitle. | ### Public types ```ts // packages/frameworks/vue/components/alert/types.ts import type { alertVariants } from './styles' // ------- TYPES ------- export interface AlertProps { variant?: keyof typeof alertVariants role?: 'alert' | 'status' } export interface AlertTitleProps { as?: 'h2' | 'h3' | 'h4' | 'h5' | 'h6' } // packages/frameworks/vue/components/alert/styles.ts // Add or change an Alert color here; the public variant type follows these keys. export const alertVariants = { default: 'border-border bg-card text-card-foreground', info: 'border-info-subtle-border bg-info-subtle text-info-subtle-foreground', success: 'border-success-subtle-border bg-success-subtle text-success-subtle-foreground', warning: 'border-warning-subtle-border bg-warning-subtle text-warning-subtle-foreground', destructive: 'border-destructive-subtle-border bg-destructive-subtle text-destructive-subtle-foreground', } as const ``` ## Implementation notes - Content in the icon slot is decorative and hidden from assistive technology. - Use status for routine changes and alert only for urgent dynamically inserted messages. - Give the action a specific label that describes where it goes or what it does. ## Accessibility and localization - An alert role on static initial content may interrupt screen-reader navigation unnecessarily. [Source contract and editing guidance](https://github.com/weini-org/weiniUI/blob/develop/packages/frameworks/vue/components/alert/README.md) --- # AspectRatio A CSS aspect-ratio wrapper for media and previews. ## Interactive showcase ## Install Run in your project **npm** ```sh npx @getweini/cli@latest add aspect-ratio ``` **pnpm** ```sh pnpm dlx @getweini/cli@latest add aspect-ratio ``` **yarn** ```sh yarn dlx @getweini/cli@latest add aspect-ratio ``` **bun** ```sh bunx --bun @getweini/cli@latest add aspect-ratio ``` ## Start with this example Import the files copied by the install command, then place the component in your Vue template. The text and values in the example belong to your app; change them to fit your task. ```vue ``` Give images meaningful alternative text when they convey information. ## When to use it ### Media gallery Keep image tiles the same shape while assets load. ### Video preview Preserve a widescreen preview inside a flexible card. ## More examples ### Gallery thumbnail The wrapper sets shape while the image fills it. ```vue ``` ### Widescreen preview A string ratio can represent a familiar format. ```vue