Releases: codemonster-ru/vueforge
Releases · codemonster-ru/vueforge
v0.99.0
- Semver checklist:
- Semver impact classified (
minor) - Breaking-change assessment completed (
no) - Deprecations documented (N/A)
- Migration notes added when required (N/A)
- Catalog mapping sync completed (
yes) - Bundle-size check completed (
npm run build && npm run verify:bundle-size)
- Semver impact classified (
- Docs deployment:
- Switched docs deployment from
release.publishedtoworkflow_runafter a successfulpublish to NPM, because GitHub Releases created inside the publish workflow do not trigger downstream release-based workflows. - Added Apache SPA fallback via docs
.htaccessso hosted docs routes survive direct refresh/navigation on shared hosting.
- Switched docs deployment from
- Docs shell:
- Restored VueForge plugin/theme initialization in the docs runtime after removing the legacy
src/exampleentry, fixing docs-only layout/theme regressions. - Added the current package version to the docs header as non-clickable metadata next to the
vueforgebrand. - Reworked component docs
Featurespages to render inline live examples from## Examplesblocks and removed the publicPlaygroundtab from the docs shell. - Refined desktop and mobile docs navigation,
On this page, preview/code block presentation, and responsive docs header/drawer behavior.
- Restored VueForge plugin/theme initialization in the docs runtime after removing the legacy
- Component theme API:
- Extended
PanelMenutheme tokens with separate active state controls for group triggers vs leaf links, plus item typography, chevron size, and group padding hooks. - Added
Tabstheme tokens for default and active tab font weight, and aligned default tab list underline treatment with the docs styling baseline. - Adjusted default
ThemeModeSwitchsegment font weight to a regular weight for calmer header/control presentation.
- Extended
- Testing:
- Stabilized
DateRangePickernull-range coverage by removing dependence on a fixed calendar month in the unit test. - Updated docs preview regression coverage to keep number-prop inference checked while allowing the current textarea preview runtime warning behavior.
- Stabilized
v0.98.0
- Semver checklist:
- Semver impact classified (
minor) - Breaking-change assessment completed (
no) - Deprecations documented (N/A)
- Migration notes added when required (N/A)
- Catalog mapping sync completed (
yes) - Bundle-size check completed (
npm run build && npm run verify:bundle-size)
- Semver impact classified (
- Public API/theming additions:
- Added
ThemeModeSwitchpublic export insrc/index.ts. - Added
ThemeModeSwitchTokensandthemeModeSwitchcomponent token mapping intheme-core. - Registered default
themeModeSwitchtokens in default theme preset.
- Added
- Docs platform updates:
- Added standalone docs app/runtime under
src/docswith generated route tree fromdocs/**/*.md. - Added docs build target (
build:docs) and docs deployment workflow/scripts. - Switched docs static entry artifact from
dist/docs/docs-index.htmlto standarddist/docs/index.htmlvia dedicated docs build root, simplifying static hosting configuration. - Moved docs build root from ad-hoc
docs-siteintoapps/docsto make the docs app entrypoint explicit in project structure. - Removed the legacy
src/exampleruntime and made docs the single dev entrypoint. - Added docs shell UX updates: header search/theme switch, collapsible+animated sidebar, component tabs, sticky
On this page, and robust hash/tab synchronization. - Updated docs routing behavior so
/docs/componentsredirects to first component page and removed index duplication in sidebar navigation. - Hardened docs live playground prop inference/defaults across component pages (function/tuple/object/array/default literal cases) and route/event sync behavior.
- Added standalone docs app/runtime under
- Release/tooling:
- Added bundle-size verification script and budgets to release gates.
- Updated semver checklist enforcement to include bundle-size completion.
- Stabilized
ThemeModeSwitchtheme-override test timing in CI by aligning its timeout with otherThemeProvidertoken-override coverage. - Removed the Playwright visual-regression and benchmark/performance-gate pipeline from active tooling and CI workflows.
- Switched docs deployment to run only from published GitHub releases, so hosted docs track released package versions instead of every
mainpush. - Replaced the SSH docs deployment pipeline with an FTP/FTPS workflow that fits shared-hosting deployment constraints.
- Fixed docs build output path and ESLint ignores so
npm run lintcompletes cleanly after docs/runtime restructuring.
v0.97.0
- Semver checklist:
- Semver impact classified (
minor) - Breaking-change assessment completed (
no) - Deprecations documented (N/A)
- Migration notes added when required (N/A)
- Catalog mapping sync completed (
yes)
- Semver impact classified (
- Data visualization parity (
P1.15) follow-up:- Defined official chart engine adapter strategy (
Chart.jsdefault adapter +ChartAdapterextension interface), documented indocs/guides/chart-engine-adapter-strategy.md, and added adapter contract tests. - Added shared chart data schema contracts (
series,axes,legend,tooltip,annotations) with public exports, validation helper, tests, and guide (docs/guides/chart-data-schema-contracts.md). - Added shared chart accessibility contracts for keyboard navigation, screen-reader summaries, and data-table fallback (
a11ySummary,a11yKeyboardHint,a11yTableFallback) with docs and regression tests. - Added responsive and high-density chart rendering strategy with shared helpers,
Chartruntime high-density props (highDensity*), decimation option injection, and strategy guide (docs/guides/chart-responsive-high-density-strategy.md). - Added chart theming/token contracts for colors, grids, typography, and states: expanded
ChartTokens, default chart theme tokens,createChartThemeOptionshelper, and theming contract guide (docs/guides/chart-theming-token-contracts.md). - Added chart export contracts and print-friendly mode: adapter extension hooks (
exportPng/exportSvg/exportCsv/setPrintMode),Chartexposed export methods,createChartCsvfallback helper, and export/print guide (docs/guides/chart-export-print-contracts.md). - Added chart large-dataset performance baseline to benchmark pipeline: new
Chartsscenario in benchmark runner/view, chart budgets in local/CI budget files, and docs updates for performance budgets/benchmarks. - Added chart visual regression coverage for chart variants and themed mode in visual baseline route and Playwright snapshots (
visual-chart-variants-desktop). - Stabilized chart visual regression snapshot bounds in
VisualRegressionViewto avoid cross-platform 1px height drift (1373pxvs1372px) in CI. - Hardened chart visual regression capture in Playwright by pinning deterministic chart section bounds during the snapshot step, removing environment-specific 1px drift (
1372px/1373px/1374px) intest:visual. - Added chart recipe docs for
executive dashboard,product analytics,finance/reporting, andops monitoringflows. - Added secure chart data-rendering guidance for untrusted labels/tooltips/HTML formatters and exported sanitizer helpers (
sanitizeChartText,escapeChartHtml) with unit tests.
- Defined official chart engine adapter strategy (
- Catalog delta parity (
P1.16) additions:- Added
ThemeProvidercomponent/API for local theme scope overrides per subtree with docs, public export, and unit tests. - Added
DefaultsProvidercomponent/API for local default-prop policies per subtree, plususeComponentDefaults/provideComponentDefaultsconfig helpers, docs, and unit tests. - Added
LocaleProvidercomponent/API for local i18n scope overrides, plusprovideLocaleTextScoperuntime helper and scoped locale precedence tests. - Added
NoSsrutility component for client-only rendering boundaries with fallback slot/placeholder behavior, docs, and SSR+mount tests. - Added
MainLayoutRegionprimitive (mainarea contract) with landmark semantics, constrained-width behavior, theme tokens, docs, and unit tests. - Added
SystemBarcomponent (global top status/utility strip) with fixed/sticky/dense variants, theme tokens, docs, and unit tests. - Added
BottomNavigationcomponent (mobile-first primary navigation) with icon/label/badge patterns, keyboard navigation, route-synced active state, docs, default theme tokens, and unit tests. - Added
Sheetcomponent (generic elevated/flat/outlined/tonal surface container) with header/body/footer sections, default theme tokens, docs, and unit tests. - Added
Windowpager container component for stateful pane switching with controls, keyboard navigation, transition modes, docs, default theme tokens, and unit tests. - Added
AvatarGroupcomponent for overlap/stack avatar clustering with configurable overflow indicator (+N), docs, default theme tokens, and unit tests. - Added
Bannercomponent for inline page-level announcements and actions with severity semantics, sticky mode, dismiss contract, docs, default theme tokens, and unit tests. - Added
SlideGroupcomponent for horizontally scrollable chip/tab/button-style navigation with controls, keyboard selection, docs, default theme tokens, and unit tests. - Added
SnackbarQueuebehavior component for queued toast/snackbar orchestration with imperative enqueue/dequeue API, dedupe support, docs, default theme tokens, and unit tests. - Added
FloatLabelutility component for floating label composition around input/select controls with focus/value state handling, docs, default theme tokens, and unit tests. - Added
IftaLabelutility component for in-field top-aligned label pattern support with docs, default theme tokens, and unit tests. - Added
IconFieldandInputIconhelpers for consistent input icon placement contracts, including docs, default theme tokens, and unit tests. - Added
SelectionControlandSelectionControlGroupprimitives for shared checkbox/radio/switch behavior with grouped state contracts, docs, default theme tokens, and unit tests. - Added
ToggleButtoncomponent parity for binary action toggles (aria-pressed) with state-specific labels/icons, docs, default theme tokens, and unit tests. - Added
Hoverutility wrapper with scoped hover/focus state exposure, open/close delay controls, keyboard parity behavior, docs, default theme token, and unit tests. - Added
Hotkeyutility component/composable for scoped shortcut handling with accessibility-safe defaults (ignoreInputs, scoped focus boundary), docs, and unit tests. - Added
Kbdvisual helper component for keyboard shortcut hints (Ctrl+K) with docs, default theme tokens, and unit tests. - Added
CodeBlockcomponent for read-only syntax-highlighted snippets with copy action/event and custom header action slot, including docs, default theme tokens, and unit tests. - Added
Lazyutility component for deferred subtree mount/render with intersection-triggered activation (once,delay,placeholder) and docs/tests/theme tokens. - Added
Parallaxdecorative motion container with scroll-based offset, axis/reverse/clamp controls, reduced-motion compliance, docs, default theme tokens, and unit tests. - Added shared
Validationutility contracts (normalizeValidationErrors,createValidationMessages,buildValidationDescribedBy,createValidationState) with public exports, docs, tests, and integration inForm/FormField. - Finalized
PassThroughutility contracts with dedicated API docs page and contract tests forresolvePassThrough/withPartClassbehavior (styled vsunstyled, static vs resolver entries). - Closed catalog delta acceptance criteria: synchronized new-item mapping status, documented alias/equivalent API differences, added alias ownership mapping in rollout/API package specs, and clarified
not plannedrationale policy. - Updated roadmap/audit artifacts:
CHECKLIST.md,docs/audits/component-catalog-mapping.md, anddocs/audits/component-compliance-matrix.md. - Removed deferred
Advanced analytics visualssection fromCHECKLIST.mdby product scope decision.
- Added
- Release alignment:
- Bumped package version to
0.97.0inpackage.jsonandpackage-lock.json.
- Bumped package version to
- Developer tooling:
- Added project-level VS Code recommendations in
.vscode/extensions.json(Vue.volar,dbaeumer.vscode-eslint,esbenp.prettier-vscode). - Updated
.vscode/settings.jsonto keep format-on-save with automatic ESLint fixes (source.fixAll.eslint: always). - Added root
.editorconfigaligned with Prettier defaults (indent_size: 4,end_of_line: lf,utf-8, final newline). - Added npm scripts for mass formatting workflows:
format(prettier --write .) andformat:check(prettier --check .). - Added project
markdownlintconfig (.markdownlint.json) and aligned unordered list indentation rule (MD007) with formatter output (indent: 4) to prevent lint-vs-format drift in markdown files. - Finalized markdownlint baseline by ignoring generated/vendor markdown (
.markdownlintignorefornode_modulesanddist), disabling strict line-length enforcement (MD013), and fixing remaining docs warnings (MD038incascadeselect.md,MD059indocs/components/README.md) somarkdownlintruns cleanly across repository markdown.
- Added project-level VS Code recommendations in
v0.96.0
- Semver checklist:
- Semver impact classified (
minor) - Breaking-change assessment completed (
no) - Deprecations documented (N/A)
- Migration notes added when required (N/A)
- Catalog mapping sync completed (
yes)
- Semver impact classified (
- Data visualization parity (
P1.15) additions:- Added
BarChart,LineChart,AreaChart,PieChart,DonutChart,ScatterChart,BubbleChart,Histogram,Heatmap,RadarChart,FunnelChart,TreemapChart,GaugeChart,CandlestickChart, andSparkline. - Added API docs and unit tests for all new chart components.
- Added public exports and related chart types in
src/index.ts. - Updated roadmap/audit artifacts:
CHECKLIST.md,docs/audits/component-catalog-mapping.md, anddocs/audits/component-compliance-matrix.md. - Removed deferred
Advanced analytics visualssection fromCHECKLIST.mdby product scope decision.
- Added
v0.95.0
- Semver checklist:
- Semver impact classified (
minor) - Breaking-change assessment completed (
no) - Deprecations documented (N/A)
- Migration notes added when required (N/A)
- Catalog mapping sync completed (
yes)
- Semver impact classified (
- New component/service scope:
- SaaS/data workflow:
QueryBuilder,AdvancedFilterPanel,SavedViewsManager,DataTableToolbar,BulkActionBar. - Navigation/selection/overlay:
TieredMenu,TabMenu,CascadeSelect,ConfirmPopup,DynamicDialog. - Collaboration/ops:
ActivityFeed,AuditLogViewer,CommentThread,MemberPicker,PermissionMatrix,KPIStatCard,MeterGroup. - Utility/content:
InlineMessage,OverlayBadge,FileManager,JSONViewer,DiffViewer,CodeEditor,Scheduler,BottomSheet,InfiniteScroll. - Programmatic API and helpers:
dynamic-dialog-service(+ tests),overlay-badgedirective,code-editor-adapter(Monaco/CodeMirroradapters), and related component type files.
- SaaS/data workflow:
- Theming/runtime/documentation synchronization for this release scope:
- Added default theme token files for new components and registered them in default theme preset.
- Extended
theme-coretoken types andThemeComponentTokensmappings (including alias mappings such astieredMenu,dynamicDialog,confirmPopup,cascadeSelect). - Extended public exports in
src/index.tsfor components/services/types. - Added docs pages for all new components and updated docs index.
- Updated checklist and audit matrices (
component-catalog-mapping,planned-component-compliance-matrix,component-compliance-matrix).
- Additional fixes/hardening:
KanbanBoardproduction hardening: added keyboard DnD controls, lane virtualization props, regression tests, and swimlane performance benchmark coverage.NotificationCenterSaaS mode hardening: added read/unread filters, grouped rendering modes, per-item action links, and persistence contract (persistKey+persistpayload).CommandPaletteSaaS actions mode: added scoped commands (tabs +scope:query prefixes), entity-aware search fields/events, and recent items with optional local persistence.DataTableSaaS ops mode: added server-driven saved filters UI/contracts, export action hooks with query context, and pending long-running state controls for bulk/export actions.TreeTreeView hardening: added explicitselectionMode, virtualized expanded rendering mode, and async branch loading states/events (loadingKeys,loadOnExpand,loadChildren).AccordionExpansionPanel hardening: addeddense/groupedbehavior with group header/action slots and analytics hooks (itemToggle,itemExpand,itemCollapse,analytics).Ratinghardening for form/review usage: addedprecisionandclearable, improved readonly fractional rendering, and expanded keyboard/RTL accessibility handling.- Added RBAC boundary guide (
docs/guides/rbac-api-boundaries.md) defining UI-only vs backend-enforced authorization responsibilities for SaaS components. - Added SaaS large-dataset validation audit (
docs/audits/saas-large-dataset-validation.md) and extendedDataTable/VirtualScrollertests for loading/empty/error fallback patterns. - Added SaaS i18n/timezone validation audit (
docs/audits/saas-i18n-timezone-validation.md) and extendedActivityFeed/CommentThread/AuditLogViewer/SchedulerAPIs and tests with explicittimeZoneformatting coverage. - Added end-to-end SaaS recipe (
docs/recipes/saas-ops-list-detail-flow.md) covering list/detail workflow composition withDataTable,SavedViewsManager,BulkActionBar,ActivityFeed,CommentThread, andAuditLogViewer. - Added
AppBarcomponent (fixed/sticky/dense variants, action slots, responsive behavior) with default theme tokens, docs, and regression tests. - Added
NavigationRailcomponent (collapsed/expanded states, icon+label patterns, keyboard navigation) with theme tokens, API docs, and regression tests. - Added
Footercomponent (app/page footer layout with left/center/right slots) with responsive stacking behavior, theme tokens, docs, and regression tests. - Added
PageLayoutpreset component forsidebar/content/asidecomposition with responsive off-canvas collapse behavior, docs, and regression tests. - Added
SplitLayoutpresets (master-detail,inspector,editor-preview) with collapse controls, responsive off-canvas behavior, and regression tests. - Added
ResizableSidebarbehavior component with drag resize, collapse toggle, and local/session persistence support for width/state. - Added
StickyRegionutility for sticky headers/subheaders/action bars with configurableedge,offset, and z-index/theming contracts. - Added responsive visibility utility components
ShowandHidewith breakpoint-aware rendering (from/to) and docs/tests coverage. - Added layout contract guide (
docs/guides/layout-breakpoint-spacing-contracts.md) defining shared breakpoints and tokenized spacing scale for shell/page presets. - Expanded SSR/hydration regression suite for responsive layout switching (
AppShell,PageLayout,SplitLayout,StickyRegion) with resize transition assertions. - Expanded must-have a11y regression coverage for collapsible/resizable navigation regions (
NavigationRail,ResizableSidebar,PageLayout) including separator keyboard and Escape-close flows. - Added layout shell recipes (
dashboard,settings,analytics,mobile adaptive) underdocs/recipes/for production-oriented app composition patterns. - Extended visual regression suite with dedicated layout preset snapshots for desktop and mobile breakpoints (
vf-visual-layout-presets). - Stabilized visual regression baseline route by explicitly registering layout preset components in
VisualRegressionViewand refreshing Playwright snapshots (visual-page,visual-layout-presets-desktop,visual-layout-presets-mobile) for CI parity. - Hardened Playwright visual assertions for CI determinism: switched page baseline capture away from
fullPage, added post-navigation root synchronization for mobile viewport, and re-baselined snapshots. - Finalized CI tolerance for cross-platform text rasterization drift by increasing
visual-pagemaxDiffPixelRatioto0.04. - Tree parity hardening: added optional
hasChildrensupport inTree/TreeNode. - Fixed lint blocker in
DataTableToolbar(no-unused-vars). - Fixed type-safety issues in
InfiniteScrollandJSONViewer. - Removed Vue test warning noise by stubbing
RouterLinkin a11y parity tests forNavigationRail. - Recalibrated local/CI performance budgets for unstable p95 metrics (
DataTableandOverlays) to keepperformance:checkgreen.
- Lint/format pipeline alignment:
- Switched ESLint to enforce Prettier output (
prettier/prettier: error) to remove formatter-vs-lint drift. - Applied Prettier normalization to touched files in tests/components/theme tokens to match CI lint expectations.
- Switched ESLint to enforce Prettier output (
v0.94.0
- Semver checklist:
- Semver impact classified (
minor) - Breaking-change assessment completed (
no) - Deprecations documented (N/A)
- Migration notes added when required (N/A)
- Catalog mapping sync completed (
yes)
- Semver impact classified (
- New component/service scope currently present as uncommitted git changes:
- SaaS/data workflow:
QueryBuilder,AdvancedFilterPanel,SavedViewsManager,DataTableToolbar,BulkActionBar. - Navigation/selection/overlay:
TieredMenu,TabMenu,CascadeSelect,ConfirmPopup,DynamicDialog. - Collaboration/ops:
ActivityFeed,AuditLogViewer,CommentThread,MemberPicker,PermissionMatrix,KPIStatCard,MeterGroup. - Utility/content:
InlineMessage,OverlayBadge,FileManager,JSONViewer,DiffViewer,CodeEditor,Scheduler,BottomSheet,InfiniteScroll. - Programmatic API and helpers:
dynamic-dialog-service(+ tests),overlay-badgedirective,code-editor-adapter(Monaco/CodeMirroradapters), and related component type files.
- SaaS/data workflow:
- Theming/runtime/documentation synchronization for the same uncommitted scope:
- Added default theme token files for new components and registered them in default theme preset.
- Extended
theme-coretoken types andThemeComponentTokensmappings (including alias mappings such astieredMenu,dynamicDialog,confirmPopup,cascadeSelect). - Extended public exports in
src/index.tsfor components/services/types. - Added docs pages for all new components and updated docs index.
- Updated checklist and audit matrices (
component-catalog-mapping,planned-component-compliance-matrix,component-compliance-matrix).
- Additional uncommitted fixes/hardening:
- Tree parity hardening: added optional
hasChildrensupport inTree/TreeNode. - Fixed lint blocker in
DataTableToolbar(no-unused-vars). - Fixed type-safety issues in
InfiniteScrollandJSONViewer. - Recalibrated local/CI performance budgets for unstable p95 metrics (
DataTableandOverlays) to keepperformance:checkgreen.
- Tree parity hardening: added optional
- Lint/format pipeline alignment:
- Switched ESLint to enforce Prettier output (
prettier/prettier: error) to remove formatter-vs-lint drift. - Applied Prettier normalization to touched files in tests/components/theme tokens to match CI lint expectations.
- Switched ESLint to enforce Prettier output (
v0.93.0
- Semver checklist:
- Semver impact classified (
minor) - Breaking-change assessment completed (
no) - Deprecations documented (N/A)
- Migration notes added when required (N/A)
- Catalog mapping sync completed (
yes)
- Semver impact classified (
- Nice-to-have parity completion:
- Added
Terminalcommand-log component with copy/clear actions, severity states, auto-scroll, and typedTerminalEntryexport. - Added
Inplacedisplay-edit component with controlled active state (v-model), lifecycle events, and outside/Escape close flows.
- Added
- ICP optional parity completion:
- Added advanced
Autocompletemodes:multiplechips, grouped options, and async-friendly grouping (groupBy). - Added
Messageas migration-focusedAlertalias with shared behavior/tokens and guidance docs. - Added
SidebarasDrawer-backed compatibility alias with legacy prop/event mappings and migration docs. - Completed headless/unstyled hardening: unified contract tests, refreshed matrix, and new unstyled recipe cookbook.
- Added advanced
- High-leverage parity completion:
- Virtualized
Select/Autocompletelarge-list UX with documentedvirtual*/loadMoreOffsetcontracts and hardenedloadMoreregression tests. Imageadvanced mode: preview groups, keyboard navigation, zoom-step controls, and optional download action guidance.Chartadapter hardening: SSR-safe lazy mount controls, resize observer/fallback behavior, and chart-engine policy docs.Iconsystem parity: official@codemonster-ru/vueiconifyintegration, theme contracts, and accessibility/tree-shaking docs.MenuBar/MegaMenu/PanelMenurouting parity: router-active sync and lazy child loading contracts.- Headless parity matrix baseline for key components with slot/part/unstyled coverage and contract tests.
- Virtualized
- Nice-to-have parity completion:
Dockapp launcher navigation pattern with route-aware active sync.Galleriamedia gallery with stage/thumbnails/indicators/autoplay flows.Knobradial input with keyboard and pointer interaction contracts.
- Governance/checklist updates:
- Reordered deferred scorecard block to the queue tail and renamed it to
P2.5 Competitive parity scorecardinCHECKLIST.md.
- Reordered deferred scorecard block to the queue tail and renamed it to
- Performance gate stabilization:
- Calibrated local benchmark thresholds in
scripts/performance-budgets.jsonfor flaky p95 measurements (DataTable.selectionToggleP95Ms,Tree.keyboardNavP95Ms,VirtualScroller.initialRenderP95Ms). - Confirmed green runs for
performance:checkafter calibration.
- Calibrated local benchmark thresholds in
- Type-safety fixes:
- Fixed strict emit typing in
Inplaceopen/close flow. - Hardened benchmark-related unit tests (
Autocomplete,Select,Chart) for strict TypeScript checks. - Exported
Linkprops interface to unblock declaration generation (vite:dts).
- Fixed strict emit typing in
v0.92.0
- Semver checklist:
- Semver impact classified (
minor) - Breaking-change assessment completed (
no) - Deprecations documented (N/A)
- Migration notes added when required (N/A)
- Catalog mapping sync completed (
yes)
- Semver impact classified (
- CI pipeline reliability/performance updates:
- Added npm cache in GitHub Actions jobs and Playwright browser cache (
~/.cache/ms-playwright) forvisual-regressionandperformance-check. - Switched Playwright installation in CI from
npx playwright install --with-deps chromiumtonpx playwright install chromiumto reduce setup time.
- Added npm cache in GitHub Actions jobs and Playwright browser cache (
- Performance check stabilization in CI:
- Added dedicated CI performance budget profile
scripts/performance-budgets.ci.jsonfor noisy shared-runner conditions. - Added
PERF_BUDGETS_FILEsupport to performance scripts (run-performance-benchmarks,verify-performance-budgets,verify-performance-report) and wired it in CI. - Added automatic CI fallback for performance scripts: when
CI=trueandPERF_BUDGETS_FILEis not set, scripts now usescripts/performance-budgets.ci.json. - Kept strict default local budgets in
scripts/performance-budgets.jsonfor developer-side regression control. - Calibrated additional flaky CI thresholds for shared runners:
VirtualScroller.reachEndEmitP95MsandTree.selectionToggleP95Ms. - Calibrated flaky CI threshold for
DataTable.selectionToggleP95Ms.
- Added dedicated CI performance budget profile
- Lint stability fix:
- Refactored
OverlayPanelpopover ref typing to a named type alias to prevent formatter-induced indentation lint failures in CI.
- Refactored
- Core runtime fix (
Link):- Updated
Linkinternals to use optional router injections (routeLocationKey/routerKey) instead of unconditional router hooks. - Fixed non-router usage so rendering anchor-based links no longer depends on
vue-routercontext. - Active-route calculation now safely returns inactive state when router/route providers are absent.
- Updated
- Test updates:
- Removed obsolete
vue-routerhook mocks fromLinkunit tests and aligned tests with injection-based router handling. - Eliminated Vue warning noise in unit test output for link/button scenarios without router providers.
- Removed obsolete
- Component docs expansion (full catalog pages):
- Standardized component pages with explicit quality sections:
Purpose,Responsive,SSR/Hydration, andTesting. - Expanded and normalized these sections across all component docs in
docs/components/*.mdso each page now documents behavior, adaptive constraints, SSR assumptions, and test expectations. - Updated
docs/components/DOCS_TEMPLATE.mdto enforce the expanded structure for future components.
- Standardized component pages with explicit quality sections:
- Planning and parity documentation sync:
- Added/updated parity governance docs: component catalog mapping, implemented/planned compliance matrices, rollout plan, and API package specs.
- Synced alias/canonical decisions and package ownership for overlap-prone items (including
Sidebar,Message,TreeView,ExpansionPanel), and aligned rollout/API package tracks with those decisions.
- Programmatic service APIs baseline:
- Added
DialogServiceandConfirmServiceexports with imperative open/close methods and promise-based resolution flow. - Added service-level unit tests covering stack/queue behavior and close/confirm/cancel resolution semantics.
- Added API docs for service usage and synchronized checklist/catalog/compliance/rollout docs for transition from planned to implemented status.
- Added
TreeTablebaseline:- Added
TreeTablecomponent with hierarchical row rendering, controlled expand/collapse, and single/multiple selection flows. - Added keyboard treegrid contracts (
Arrow,Home/End,Enter/Space) and ARIA row state semantics for expanded/selected levels. - Added default theme tokens, API docs, and compliance/planned matrix sync to transition
TreeTablefrom planned to implemented.
- Added
DataViewbaseline:- Added
DataViewcomponent with list/grid rendering modes, local pagination, and sorting support. - Added server handoff events (
request) for sort/page query orchestration in app-level data fetching flows. - Added default theme tokens, API docs, and compliance/planned matrix sync to transition
DataViewfrom planned to implemented.
- Added
Listboxbaseline:- Added
Listboxcomponent with always-visible single/multi selection modes and grouped options support. - Added keyboard-first navigation (
ArrowUp/ArrowDown,Home/End,Enter/Space) andlistbox/optionARIA semantics. - Added default theme tokens, API docs, and compliance/planned matrix sync to transition
Listboxfrom planned to implemented.
- Added
MenuBarbaseline:- Added
MenuBarcomponent as horizontal app-level navigation wrapper overMenuwith nested item support. - Added dedicated
navlandmark semantics and event forwarding for active route/section changes. - Added default theme tokens, API docs, and compliance/planned matrix sync to transition
MenuBarfrom planned to implemented.
- Added
MegaMenubaseline:- Added
MegaMenucomponent with top-level triggers and multi-column section panels for richer navigation content. - Added baseline keyboard support (
Enter/Space,ArrowLeft/ArrowRight,Escape) and ARIA menubar/menu semantics. - Added default theme tokens, API docs, and compliance/planned matrix sync to transition
MegaMenufrom planned to implemented.
- Added
PanelMenubaseline:- Added
PanelMenucomponent for accordion-style hierarchical navigation with controlledexpandedKeys. - Added nested tree/group semantics and keyboard toggle support (
Enter/Space) for section triggers. - Added default theme tokens, API docs, and compliance/planned matrix sync to transition
PanelMenufrom planned to implemented.
- Added
Carouselbaseline:- Added
Carouselcomponent with controlled slide index (v-model) and optional looped autoplay behavior. - Added keyboard (
ArrowLeft/ArrowRight/Home/End) and touch-swipe navigation contracts with change-source events. - Added default theme tokens, API docs, and compliance/planned matrix sync to transition
Carouselfrom planned to implemented.
- Added
SpeedDialbaseline:- Added
SpeedDialcomponent for floating quick actions with controlled open state (v-model) and directional action layout. - Added keyboard contracts (
Enter/Space/Escape,Arrow,Home/End), menu semantics, and outside-click close behavior. - Added default theme tokens, API docs, and compliance/planned matrix sync to transition
SpeedDialfrom planned to implemented.
- Added
Chartwrapper baseline:- Added
Chartcomponent with adapter-based lifecycle (mount/update/destroy) and built-in loading/empty states. - Added official
createChartJsAdapterhelper for stableChart.jsintegration without hardwiring runtime dependency in core. - Added default theme tokens, API docs, and compliance/planned matrix sync to transition
Chartfrom planned to implemented.
- Added
Imagebaseline:- Added
Imagecomponent with optional preview/lightbox mode and controlled visibility (v-model). - Added close contracts for overlay,
Escape, and close button with focus restore semantics. - Added default theme tokens, API docs, and compliance/planned matrix sync to transition
Imagefrom planned to implemented.
- Added
Skeletonadvanced presets:- Added preset rendering modes for common loading layouts:
table,list, andform. - Added configurable row/column controls for presets and new theme tokens for preset sizing/gaps.
- Expanded unit tests and component docs to cover preset behavior and usage guidance.
- Added preset rendering modes for common loading layouts:
OverlayPanelalias baseline:- Added
OverlayPanelcomponent as aPopover-backed compatibility alias with mapped API (dismissable,closeOnEscape,showCloseIcon). - Added
show/hide/toggleexpose methods and legacy show/hide event aliases (show/onShow,hide/onHide). - Added docs, tests, theme alias mapping, and compliance/planned matrix sync for planned-to-implemented transition.
- Added
- Pass-through / unstyled customization baseline:
- Added shared pass-through utility contracts (
PassThroughOptions, part resolver helpers) with public exports. - Added
ptandunstyledsupport forCarousel,Chart,Image,SpeedDial, andOverlayPanel. - Added documentation guide for part-level attrs/class/style customization and unstyled usage patterns.
- Added shared pass-through utility contracts (
- Must-have parity accessibility regression gate:
- Added consolidated keyboard/ARIA regression suite for must-have parity components.
- Added
docs/accessibility/must-have-parity-a11y-regression.mdwith per-component contract and test mapping. - Marked
P1.11acceptance criterion for keyboard/ARIA documentation + regression coverage as complete.
- Must-have parity SSR/hydration gate:
- Expanded SSR/hydration checks with must-have parity fixture coverage for interactive components.
- Added
docs/audits/must-have-parity-ssr-hydration.mdwith verification scope and suite mapping. - Marked
P1.11acceptance criterion for dynamic SSR/hydration verification as complete.
- Must-have parity responsive gate:
- Added consolidated responsive regression suite for must-have parity components (touch flows, layout adaptation, overflow wrappers).
- Added
docs/audits/must-have-parity-responsive-checks.mdwith component-level responsive verification mapping. - Marked
P1.11acceptance criterion for responsive behavior verification as complete.
- Must-have parity theming token gate:
- Added
docs/audits/must-have-parity-theming-tokens.mdto map must-have components to runtime token keys and docs coverage. - Confirmed theme schema/default mappings and documented token sections for must-have parity components.
- Marked
P1.11acceptance criterion for theming-token e...
- Added
v0.91.0
- Semver checklist:
- Semver impact classified (
patch) - Breaking-change assessment completed (
no) - Deprecations documented (N/A)
- Migration notes added when required (N/A)
- Semver impact classified (
- Testing:
- Isolated
vitestscope tosrc/**/*.test.tsso unit test runs no longer execute Playwright suites; visual checks remain undernpm run test:visual. - Stabilized full-page visual snapshot checks in CI by setting a controlled diff tolerance for cross-platform font rasterization variance.
- Isolated
- Visual regression pipeline baseline:
- Added Playwright-based visual regression pipeline with deterministic Chromium screenshot checks (
npm run test:visual). - Added dedicated visual showcase route (
/visual-regression) and snapshot update workflow (npm run test:visual:update). - Added contributor guidance for visual baseline updates and regression triage.
- Added Playwright-based visual regression pipeline with deterministic Chromium screenshot checks (
- SSR/hydration baseline checks:
- Added dedicated SSR/hydration regression test (
npm run test:ssr) using@vue/server-renderer. - Added baseline coverage for server render output and client hydration mismatch detection on representative core components.
- Added contributor guide for SSR/hydration check scope and usage.
- Added dedicated SSR/hydration regression test (
- Runtime-quality CI coverage:
- Added dedicated CI jobs for SSR/hydration checks and visual regression checks.
- CI now executes
npm run test:ssrandnpm run test:visualas independent quality gates.
- Regression triage playbook:
- Added a shared regression triage playbook for
core,ssr-hydration, andvisual-regressionCI failures. - Documented classification, decision rules, flake handling, and required PR reporting checklist.
- Linked playbook from testing, visual regression, and SSR/hydration contributor guides.
- Added a shared regression triage playbook for
- Locale text runtime API baseline:
- Added global locale text runtime API (
setLocaleText,updateLocaleText,getLocaleText) and plugin option support (localeText). - Wired locale-text fallbacks for component empty/loading/default state labels (
DataTable,Autocomplete,Combobox,MultiSelect,TagInput,TreeSelect,MentionInput,CommandPalette,NotificationCenter,VirtualScroller). - Localized built-in component strings for placeholders, action labels, and accessibility labels in core data/command/selection components.
- Added locale-text runtime tests, component fallback tests, and setup guide documentation.
- Added global locale text runtime API (
- RTL support baseline for critical components:
- Updated critical data/selection/command styles to use logical CSS alignment and spacing (
text-align: start/end,margin-inline-*,padding-inline-*,inset-inline-*). - Added RTL-safe positioning updates for
NotificationCenterandVirtualScrollerpanel/content layout. - Added RTL interaction smoke coverage for
DataTable,CommandPalette, andNotificationCenter. - Added dedicated RTL regression suite covering
DataTable,MultiSelect,TagInput,CommandPalette,NotificationCenter, andVirtualScroller. - Added i18n/RTL setup documentation with plugin/runtime locale examples, RTL enablement, and verification workflow.
- Updated critical data/selection/command styles to use logical CSS alignment and spacing (
- Performance baseline budgets:
- Added baseline performance budget definitions for
DataTable,Tree,VirtualScroller, and key overlays inscripts/performance-budgets.json. - Added budget validation command
npm run verify:performance-budgets. - Added documentation for budget scope and semantics in
docs/audits/performance-budgets.md. - Added benchmark scenario definitions (
scripts/benchmark-scenarios.json) and Playwright-based measurement runner (npm run benchmark:run). - Added a warmup pass in benchmark sampling to remove cold-start outliers from p95 gating and stabilize CI checks.
- Added benchmark report output (
benchmarks/latest.json) and benchmark usage documentation. - Added performance report threshold verifier (
npm run verify:performance-report) and combined gate (npm run performance:check). - Added dedicated CI
performance-checkjob and per-release performance gate in publish workflow. - Added performance guidance and practical limits documentation for heavy components and overlay flows.
- Added baseline performance budget definitions for
- Developer experience:
- Added live playground route for core components (
/playground) with interactive props/state controls and real-time preview. - Added playground regression tests and documentation recipe for developer workflow.
- Added core copy-paste cookbook with reusable layout, table, form, overlay, and command/notification snippets.
- Migrated automation scripts from
.mjsto TypeScript (scripts/*.ts) and switched npm commands tonode --import tsx.
- Added live playground route for core components (
v0.90.0
- Semver checklist:
- Semver impact classified (
minor) - Breaking-change assessment completed (
no) - Deprecations documented (N/A)
- Migration notes added when required (N/A)
- Semver impact classified (
- Release discipline:
- Added semver release checklist documentation and CI/publish enforcement via
npm run verify:semver.
- Added semver release checklist documentation and CI/publish enforcement via
- DataTable advanced baseline:
- Added opt-in column resize support (
columnResize,minColumnWidth, per-columnresizable) with resize event payload and docs. - Added opt-in column reorder support (
columnReorder, controlledcolumnOrder,columnReorderevent) with drag-and-drop behavior. - Added DataTable regression coverage for column resize/reorder behavior and updated advanced docs examples.
- Added opt-in column resize support (
- Tree/TreeSelect keyboard hardening:
- Improved tree keyboard edge-case behavior by skipping disabled nodes during focus traversal and refining
ArrowRightchild navigation behavior. - Improved TreeSelect keyboard flow so keyboard-open focuses tree content and
ArrowDownin search field moves focus into the tree. - Added regression tests and updated accessibility notes for keyboard contracts.
- Added large-dataset regression coverage for expanded tree traversal and TreeSelect filtering behavior.
- Added RTL behavior verification with dedicated Tree/TreeSelect RTL interaction tests and logical CSS property alignment updates.
- Added advanced Tree/TreeSelect docs recipes for controlled state, large trees, and async loading/search usage patterns.
- Improved tree keyboard edge-case behavior by skipping disabled nodes during focus traversal and refining
- Tabs/Accordion/Stepper/Wizard hardening:
- Added keyboard navigation hardening for disclosure and multi-step components (
Accordion,Stepper,Wizard) with arrow/home/end traversal behavior. - Added expanded regression coverage for navigation and state transitions across
Tabs,Accordion,Stepper, andWizard. - Added a dedicated disclosure/multi-step accessibility audit doc and advanced recipes for common settings, onboarding, and FAQ flows.
- Normalized shared API behavior by adding global
disabledsupport toStepperfor consistency with related navigation/disclosure components.
- Added keyboard navigation hardening for disclosure and multi-step components (
- NotificationCenter/Toast/Tour/CommandPalette hardening:
- Added explicit interaction and accessibility contracts for all four components, including close/focus behavior and keyboard expectations.
- Expanded keyboard/focus regression coverage (
Escape/overlay behavior, focus-in/focus-restore, active-option keyboard traversal). - Added overlay layering verification audit and token-order regression checks against the default z-index policy.
- Added practical docs recipes for notification, feedback, onboarding, and global command-launcher usage patterns.
- Date/time locale maturity:
- Added global date/time locale runtime configuration API (
setDateTimeLocale,updateDateTimeLocale,getDateTimeLocale) and plugin install support. - Updated
Calendar,DatePicker,DateRangePicker, andDateTimePickerto use global locale/week-start defaults with per-component override precedence. - Added locale-specific regression tests for global fallback and weekday ordering behavior across date/time components.
- Added date/time locale setup documentation and linked it from component docs.
- Added global date/time locale runtime configuration API (
- Density and motion baseline:
- Added runtime UI preference API for density presets (
normal,comfortable,compact) and reduced-motion toggling. - Added motion token variables and reduced-motion CSS behavior tied to runtime root attributes and OS preference.
- Added density/motion runtime tests and setup documentation for plugin/runtime usage.
- Added runtime UI preference API for density presets (