# Changelog

All notable changes to this project will be documented in this file.

## 6.5.6 - 2026-07-31

### Fixed
- Fixed `tembro add` so missing package dependencies are installed even when requested component files already exist or are skipped by conflict handling.
- Completed registry dependency metadata for source-copy components that import external packages such as `lucide-react`, `cmdk`, `@base-ui/react`, and `class-variance-authority`.

## 6.5.5 - 2026-07-30

### Fixed
- Restored concrete source-copy styling for card, data table toolbar, and input group button variants that previously had empty Tailwind variant branches.
- Removed overly glassy backdrop blur styling from copied component surfaces and integrations so `npx tembro add <name>` produces cleaner, self-contained UI defaults.

## 6.5.4 - 2026-07-30

### Fixed
- Restored self-contained Tailwind styling for the source-copy `badge` component variants, tones, sizes, dots, and removable controls so `npx tembro add badge` works without relying on showcase theme selectors.

## 6.5.3 - 2026-07-29

### Added
- Added package-maintainer `AGENTS.md` guidance and focused local skills for registry, CLI, release, showcase, component quality, and validation work.

### Changed
- Expanded `npx tembro agents` output with practical component, design-system, accessibility, testing, architecture, and delivery playbooks for consumer projects.
- Polished generated agent skill titles and trigger copy.
- Kept publish-time validation on the faster `release:publish` gate while retaining the full `release:gate` for high-risk releases.

## 6.5.2 - 2026-07-29

### Changed
- Improved the generated `npx tembro agents` playbook structure for consumer projects.

## 6.5.1 - 2026-07-29

### Fixed
- Restored self-contained Tailwind styling for the source-copy `button` component variants and sizes so `npx tembro add button` works without relying on showcase theme selectors.

## 6.5.0 - 2026-07-27

### Changed
- Kept the 6.5 registry focused on real component source-copy entries.
- Removed unpublished block and template entries from public registry metadata, presets, docs copy, and showcase search.

### Fixed
- Restored missing source-copy files for registry entries that were already listed by the CLI: `scroll-box`, `description-list`, `data-grid`, `quick-action-grid`, `section`, and `advanced-command-menu`.

## 6.4.0 - 2026-07-27

### Added
- Added package manager detection from `package.json#packageManager`, npm/pnpm/Yarn/Bun lockfiles, and `npm_config_user_agent`.
- Added `--pm npm|pnpm|yarn|bun` overrides to install-capable CLI flows: `init`, `add`, `preset`, and `showcase`.
- Added CLI contract coverage for package manager help output, `packageManager` detection, and explicit `--pm` overrides.

### Changed
- Documented npm, pnpm, Yarn, and Bun command variants for init and source-copy workflows.
- Kept registry dependency metadata package-manager neutral so the CLI remains responsible for generating install commands.

## 6.3.0 - 2026-07-23

### Changed
- Improved UI/UX for `Menubar`: refined borders, subtle backdrop blur, and smoother transitions.
- Improved UI/UX for `Tabs`: made active state more prominent with bold text and contrast background.
- Improved UI/UX for `Slider`: enhanced the track visibility and added hover scaling to the thumb.
- Improved UI/UX for `Tag`: rounded corners and enhanced hover effects for a cleaner look.
- Fixed `ResizablePanel` resize interactions failing due to React proxy component wrappers during hot-reload.
- Fixed `ChartCard` to properly display metric data and fallback charts.
- Fixed `Tooltip` text display rendering issue that prevented content from rendering.

### Removed
- Fully removed `Section`, `Scroll Box`, `Quick Action Grid`, `Number Input`, `Description List`, `Data Grid`, and `Advanced Command Menu` from the registry and component catalog to reduce bloat.

## 6.1.0 - 2026-07-18

### Added

- Added 10 product-grade public components: `MultiSelect`, `ActionToast`, `ChartCard`, `AsyncBoundary`, `AdvancedCommandMenu`, `PermissionsMatrix`, `CalendarRangeScheduler`, `FileManager`, `CalendarDateTimePicker`, and `DataGrid`.
- Added registry `kind` metadata so real components, presets, aliases, hooks, utilities, and internal entries are separated instead of being counted as one mixed component list.
- Added dashboard, calendar, command, feedback, file management, data grid, chart, notification, input, and permissions coverage to the source-copy registry.

### Changed

- Simplified the primary component surface by moving duplicate or composable entries into `alias`, `preset`, `hook`, `utility`, or `internal` kinds.
- Expanded dashboard preset coverage with `async-boundary`, `chart-card`, and `multi-select` so generated apps exercise richer real-project UI states.

## 6.0.3 - 2026-07-18

### Fixed

- Fixed the showcase template sidebar import path so generated workbenches use the canonical `layout/sidebar` component.

## 6.0.2 - 2026-07-18

### Fixed

- Added an npm peer-resolution fallback for CLI dependency installs so existing projects with older rich text editor peer packages can still upgrade through `tembro add`.

## 6.0.1 - 2026-07-18

### Fixed

- Pinned Tiptap install specs used by the CLI so rich text editor dependencies resolve as one compatible package family during `tembro add`.

## 6.0.0 - 2026-07-18

### Added

- Added `NumberField`, `ToggleGroup`, and `Toolbar` as canonical product UI primitives.

### Removed

- Removed duplicate composition wrappers from code and registry: `loading-state`, `page-state`, `page-header`, `page-container`, `section-header`, `sidebar-nav`, `sticky-footer-bar`, and `progress-ring`.

### Changed

- Updated `DataTable` loading customization to use `StateView` props and made `ProgressCircle` independent from the removed ring alias.

## 5.0.0 - 2026-07-18

### Added

- Added `HoverCard`, `Menubar`, and `NavigationMenu` as real source-copy primitives backed by Base UI.

### Removed

- Removed composed page/pattern components from the package code and registry: `form-builder`, `page-toolbar`, `bulk-action-bar`, `detail-layout`, `settings-page`, `data-view`, `resource-page`, and `resource-detail-page`.
- Removed related root exports, CLI registry entries, docs surface entries, and source-copy vendor files for those pattern components.

### Changed

- Kept `empty-state` as the only `patterns` component because it is still a reusable primitive-level surface.

## 4.2.1 - 2026-07-18

### Changed

- Hardened `PopoverContent` with default surface background, border, text color and shadow so combobox and dropdown panels do not blend into content behind them.
- Republished the expanded 4.2 component surface with the popover layering fix included in CLI source-copy assets.

## 4.2.0 - 2026-07-18

### Added

- Added source-copy `Combobox` with grouped options, search, clear controls, controlled/uncontrolled state, custom renderers and custom filtering.
- Promoted common primitives to the documented public surface: `textarea`, `combobox`, `async-select`, `switch`, `radio-group`, `dropdown-menu`, `popover`, `tooltip`, `pagination`, `toast`, `notification-center` and `breadcrumbs`.
- Added chat demo snippets and registry/showcase coverage for newly promoted components.

### Changed

- Moved composed page-pattern surfaces such as `resource-page`, `settings-page`, `data-view`, `detail-layout`, `page-toolbar`, `bulk-action-bar` and `form-builder` out of the primary install surface so the component set focuses on reusable primitives.

## 4.1.0 - 2026-07-17

### Added

- Added reusable chat workspace primitives for conversation lists, messages, replies, attachments, reactions, typing states, delivery status, and message composition.
- Added named theme support with `data-theme`, color-scheme mapping, system mode, theme cycling, and built-in light, dark, and dim presets.
- Added Kanban WIP limits, controlled selection, rich task metadata, add-card/add-column actions, density, column sizing, and move policies.

### Changed

- Expanded Sidebar with inset/floating/offcanvas variants, search, persistence, keyboard collapse, item actions, accessible collapsed labels, and corrected mobile drawer geometry.
- Expanded RichTextEditor with grouped responsive controls, headings, block tools, link actions, format clearing, sticky/compact toolbar modes, and word/character counts.
- Improved Badge dot, pulse, avatar, icon, remove, focus, and interactive states; centered tag and clear icons and removed duplicate native search cancel controls.
- Corrected ActivityFeed and Timeline connector alignment and strengthened viewport-only sidebar/main scrolling behavior.

## 4.0.1 - 2026-07-17

### Changed

- Fixed viewport workspaces so the document never competes with `WorkspaceMain` for vertical scrolling.
- Rebalanced light and dark surface, border, elevation, hover, active, and keyboard-focus tokens.
- Added multi-series grouped and stacked bars, multi-series line and gradient area charts, legends, curves, dots, and accessible series tables.
- Improved responsive chart and dashboard composition while preserving the existing single-series API.

## 4.0.0 - 2026-07-17

### Added

- Added the canonical `WorkspaceLayout`, `WorkspaceContent`, `WorkspaceMain`, `WorkspaceHeader`, `SidebarProvider`, and `SidebarTrigger` application shell.
- Added `StateView` as the shared loading, empty, error, success, and informational state primitive.
- Rebuilt bar, line, area, sparkline, and donut charts on Recharts with responsive sizing, tooltips, negative domains, deterministic rendering, and accessible table fallbacks.

### Changed

- Renamed source-copy layout files to `sidebar.tsx` and `workspace-header.tsx`; public components now use their real `Sidebar` and `WorkspaceHeader` names.
- Consolidated `PageState`, `InlineState`, `LoadingState`, `DataState`, `EmptyState`, and `ErrorState` as compatibility adapters over `StateView`.
- Consolidated `Tag` and `Chip` behavior around `Badge`, and removed duplicated status-dot rendering from `StatusLegend`.
- Expanded `Section`, `ResourcePage`, `SplitLayout`, `InfoCard`, and `Badge` configuration while reducing overlapping wrappers.
- Removed showcase/demo source from the production library and CLI vendor payload, reducing the packed package from roughly 5.3 MB unpacked and 3,013 files to roughly 3 MB and 1,200 files.

### Breaking

- Removed package exports for `./showcase` and `./showcase/*`; showcase code is development-only.
- Removed deprecated `AppHeader`, `AppHeaderProps`, and `AppSidebarProps` exports. Use `WorkspaceHeader`, `WorkspaceHeaderProps`, and `SidebarProps`.
- Renamed sidebar `data-slot` values from `app-sidebar*` to `sidebar*`; custom CSS selectors must be updated.

## 3.1.17 - 2026-07-16

- Added production-ready `agenda` and `board` variants, density controls, rich event metadata, selection state, hidden/disabled events, custom rendering, and formatted day labels to `CalendarScheduler`.
- Added a compact trigger variant to `DatePicker` for dense filters, headers, and scheduling toolbars.
- Added compact density to `StatisticCard` and configurable gaps to `StatisticGrid`.
- Added `labelClassName` and a stable inline-flex label layout to `Button`, fixing complex icon/value/action labels that previously stacked vertically.
- Updated the CalendarScheduler showcase and regression coverage for the expanded API.

## 3.1.16 - 2026-07-16

- Fixed composed Card surfaces so `StatisticCard`, `InfoCard`, `ActivityFeed`, and other Card-based components retain base border, background, radius, and variant styling.
- Added compatibility aliases for legacy theme tokens used by installed components.
- Fixed `StatusLegend` surfaces and item borders in light and dark themes.
- Reduced default Card elevation and strengthened the light-theme border for dense application layouts.
- Fixed `FormBuilder` field preset typing so discriminated input and select props remain usable in strongly typed React Hook Form schemas.
- Prevented `ResizablePanel` sizing props from leaking to DOM elements.
- Made `ResourcePage`, `ResourceDetailPage`, and `DetailLayout` reserve an aside column only when aside content exists.

## 3.1.15 - 2026-07-16

- Fixed `NotificationCenter` to use solid, fallback-safe popover surfaces when host apps do not define optional `--aui-*` theme tokens.
- Synced the notification fix into the vendored CLI source used by generated projects.

## 3.1.14 - 2026-07-16

- Fixed Kanban drag-and-drop by adding a native drag/drop fallback while preserving the existing `@dnd-kit` integration.
- Kept Kanban controlled and uncontrolled column updates in sync for drag, drop, and card move callbacks.
- Refreshed registry/showcase package metadata for the 3.1.14 release.

## 3.1.13 - 2026-07-16

- Fixed `LineChart` responsive SVG height so wide dashboard cards no longer stretch line charts into oversized panels.

## 3.1.12 - 2026-07-16

- Fixed `BarChart` bars rendering with zero height inside dashboard cards.
- Kept `DataTable` desktop and mobile layouts mutually exclusive at runtime so hidden duplicate cells and badges are not rendered.

## 3.1.11 - 2026-07-16

- Removed the fixed max-width shell from the generated showcase workbench so `tembro init` projects can use the full viewport for component QA.
- Updated generated showcase grids to align items at the start, preventing cards from stretching to unrelated sibling heights on wide dashboards.
- Synced the full-width showcase template into the vendored CLI assets used by the published package.

## 3.1.6 - 2026-07-13

- Fixed duplicate selected indicators in Select options.
- Enforced horizontal icon and label alignment for Button.
- Strengthened centralized Select trigger borders and consumer theme scanning.

## 3.1.5 - 2026-07-13

### Changed

- published the consolidated canonical component surface, reusable showcase architecture, centralized theme styling, and expanded interactive documentation
- synchronized package, CLI, registry, showcase metadata, build output, and npm release versions

## 3.1.4 - 2026-07-13

### Changed

- consolidated Input, Sidebar, Statistic, PageState, and FileUpload documentation around their canonical public APIs with interactive states and production-oriented code samples
- expanded Sidebar documentation with nested routes, React Router rendering, density controls, active indicators, collapsed rail actions, mobile navigation, and account interaction
- expanded FileUpload documentation with controlled progress, retry, validation, rejection messages, sample files, remove, and clear flows
- added compact InlineState coverage and interactive route-level PageState outcomes
- moved Statistic, PageState, and FileUpload visual states into the shared init-managed theme through semantic data slots and light/dark tokens
- improved loading, status, and upload rejection accessibility semantics

### Removed

- removed deprecated duplicate registry aliases and stale showcase routes in favor of the canonical component surfaces

## 3.1.0 - 2026-07-10

### Added

- added `SortableList` with pointer, touch, and keyboard sorting, controlled and uncontrolled state, drag overlays, disabled items, and accessible handles
- rebuilt `KanbanBoard` with real card reordering across lanes, empty-lane drops, canceled-drag recovery, and controlled or uncontrolled board state
- added `VirtualList` for dynamic, accessible virtualization of large collections
- added opt-in row virtualization to `DataTable` with bounded height, overscan, dynamic measurement, sticky headers, and visible-range reporting

### Changed

- added `@dnd-kit/react`, `@dnd-kit/helpers`, and `@tanstack/react-virtual` as focused interaction and performance foundations
- added CLI registry entries, source-copy dependency installation, public demos, and regression coverage for the new components

## 3.0.0 - 2026-07-10

### Breaking changes

- removed the deprecated `FormAsyncSelect`, `FormDateInput`, `FormNumberInput`, `FormPasswordInput`, `FormPhoneInput`, and `FormSearchInput` component exports; use `FormSelect kind="async"` or the matching `FormInput kind` instead
- removed the deprecated `AppSidebar` and `SmartCard` exports; use `Sidebar` and `InfoCard`
- removed `QRCode`, which rendered a QR-like image that was not scannable
- removed the incomplete `RichTextEditor`, `Menubar`, `NavigationMenu`, and `Tour` surfaces instead of presenting partial interaction contracts as production components

### Changed

- made CLI migration aliases resolve to canonical components without copying deprecated source files
- fixed conditional React hook usage in `Input`, `AsyncSelect`, and `Sidebar`, and restored core hooks lint rules
- renamed the implementation module from `smart-card.tsx` to `info-card.tsx`
- made `JsonInput` and `DualListPicker` work in both controlled and uncontrolled modes
- improved `CalendarScheduler` empty states and reduced repeated event filtering
- tightened registry validation so every advertised group member and migration alias must exist in the CLI registry
- added component-quality regression coverage and corrected repository metadata

## 2.0.3 - 2026-07-08

- tightened default radius and shadow tokens so controls render less pill-like out of the box
- polished Button, Input, Select, and Calendar core surfaces for cleaner default spacing and focus states
- added render coverage for clearable canonical Input and multi-month Calendar paging

## 2.0.2 - 2026-07-08

### Changed

- rebuilt `AppSidebar` into a responsive navigation surface with automatic mobile drawer behavior, overlay dismissal, escape handling, and close-on-select flow
- refreshed the `AppSidebar` and `AppShell` showcase demos so mobile and desktop sidebar behavior are both visible from the docs surface
- synced CLI vendor copies and added navigation render coverage for the new responsive sidebar contract

## 1.0.0 - 2026-07-08

### Changed

- renamed the public npm package to `tembro` so installs and CLI usage can use `npm i tembro` and `npx tembro`
- moved the workspace CLI package to the private internal name `tembro-cli-internal` to avoid npm workspace name collisions
- updated the registry, README, showcase metadata, docs snippets, and fixture smoke imports to use the new `tembro` package name
- reset the public package line to `1.0.0` for the short-name release

## 0.3.24 - 2026-07-02

### Changed

- filled public showcase demo coverage for every component catalog route so docs no longer fall back to missing generic detail states
- added a supplemental showcase registry plus a coverage test to stop new public components from shipping without demo wiring
- refreshed preview registry and source-copy showcase metadata so `azamat-ui` can consume the same complete demo surface after upgrade

## 0.3.23 - 2026-07-02

### Changed

- upgraded `Carousel` from a static slide shell to a usable component with internal state, arrows, dots, loop support, and keyboard navigation
- replaced `SavedFilterSelect` browser `prompt()` saving with an inline input flow so saved-view creation is stylable, testable, and accessible
- rebuilt `ResizablePanel` into an actual split-panel primitive with draggable and keyboard-accessible handles instead of a fake CSS resize shell
- upgraded `MentionInput` into a real trigger-based mention surface with inline suggestions, keyboard selection, and cursor-aware insertion
- synced `JsonInput` validation with controlled values and aligned `TrendCard` success sparkline colors with Tembro theme tokens
- refreshed registry/showcase wiring and CLI vendor copies so the new component behavior ships consistently in both package and source-copy flows

## 0.3.22 - 2026-07-01

### Changed

- stabilized the standalone `test:run` flow by auto-building `dist` before build-output smoke checks when needed
- promoted `InfoCard` as the canonical display-card name while keeping `SmartCard` as a deprecated compatibility alias
- marked compatibility wrappers such as `FormPasswordInput`, `FormAsyncSelect`, and `AppSidebar` more explicitly as migration aliases
- rewrote `PUBLIC_API_INVENTORY.md`, regenerated `PUBLIC_COMPONENT_API.md`, and refreshed `README.md` so source-copy-first canonical APIs lead the docs surface
- rationalized public family surfaces so actions, feedback, charts, navigation, primitives, and upload docs group around canonical component entry points
- refined `Calendar`, `DatePicker`, and `DateRangePicker` popup chrome so installed dark-mode date pickers no longer render with heavy nested panels

## 0.3.19 - 2026-06-30

### Added

- added `Accordion` as the canonical accordion API backed by the existing collapse interaction model
- added `DataList` and `DataListRow` for compact operational list rows with values, metadata, icons and links
- added `KeyValueCard` for concise key/value summaries inside dashboard and detail pages
- added `DataTableSavedFilters` to the public registry groups so saved table filters are discoverable from the CLI registry

### Changed

- synced registry, CLI status metadata, public API inventory and render coverage for the new source-copy components

## 0.3.17 - 2026-06-30

### Changed

- strengthened `Select` trigger, popup, item, focus, invalid and disabled visuals so source-copied selects look styled without relying on extra site CSS
- refined `Table` and `DataTable` surfaces with token-based borders, backgrounds, selected rows, striped rows and shadows
- improved `DataTableToolbar` soft and selection-bar treatment for cleaner dashboard usage
- synced CLI vendor component sources with the published package polish

## 0.3.11 - 2026-06-29

### Changed

- refined `Button` defaults so installed package buttons have calmer radius, clearer focus rings, and better dark-mode contrast
- improved disabled and loading button states so they stay readable without looking like broken outline controls
- reduced heavy hover shadows on primary and destructive actions for cleaner dashboard usage

## 0.3.10 - 2026-06-26

### Changed

- refined the published primitive layer for `Button`, `Input`, `Select`, `Checkbox`, `Switch`, `Tabs`, and `Card` so default surfaces feel flatter, calmer, and more product-ready
- cleaned up shared input chrome, decorator spacing, and clear action affordances so installed field components ship with a stronger default UI

## 0.3.9 - 2026-06-26

### Changed

- refined `Badge` defaults so status labels look calmer, flatter, and more product-ready out of the box
- simplified the Badge docs surface to remove heavy card-in-card composition around a small primitive

## 0.3.8 - 2026-06-26

### Changed

- polished the published input field chrome, decorator spacing, and clear action treatment
- reduced nested-card noise in the docs input showcase and cleaned up the live field composition
- moved detail-page side rails to wider breakpoints so preview content no longer collides with related panels

## 0.3.7 - 2026-06-26

### Fixed

- restored the full root export contract so published package consumers receive patterns, families, and complete public component barrels from `tembro`

## 0.3.6 - 2026-06-26

### Changed

- refined the base input, decorator, and clear action visuals for a cleaner published default field surface
- softened tabs, cards, dialogs, popovers, and dropdown menus so overlay-heavy docs routes match the newer surface system

### Added

- added `Button` loading, loading label, left icon, right icon, and `md`/`xl` size API coverage
- added `Card` variants, tones, density, interactive, selected, and disabled state APIs
- added `Badge` tone, size, dot, left icon, and right icon APIs for status-heavy dashboard UI
- added `ClearableInput` Escape-to-clear and focus-after-clear behavior
- added `SearchInput` loading, result count, shortcut, and debounced value callback support
- added `InputDecorator` density, tone, leading/trailing class hooks, and pointer-event control
- added `NumberInput` prefix/suffix support through the shared input decorator
- added `DateInput` optional leading calendar icon support
- added `PhoneInput` icon and country-code display options
- added `PasswordInput` Caps Lock warning and autocomplete defaults
- added `SimpleSelect` clearable, searchable, loading, empty-state, keyword, and custom option rendering APIs
- added reusable form field splitting utilities for future direct form wrapper refactors
- added `PageHeader` variants, tones, sizes, leading content, footer, and class hooks
- added `StatCard` loading skeleton, helper text, value prefix/suffix, trend label, and badge-backed trend rendering
- added `DataTableToolbar` variants, density, and heading/action class hooks
- added `AppInput` / `UniversalInput` as the single public input wrapper for text, clearable, search, number, phone, and date input kinds
- added `FormAppInput` as the single React Hook Form wrapper for the same input kinds
- added real component primitives: `RadioGroup`, `Kbd`, `HoverCard`, `StatusDot`, `SectionHeader`, `AlertDialog`, and `Drawer`
- added `UserCard`, `NavTabs`, and `FileDropzone` for dashboard identity, navigation, and upload flows
- added `ScrollBox`, `RightClickMenu`, `ProgressCircle`, and `MetricCard` as additional real reusable UI components

### Changed

- moved `NumberInput`, `DateInput`, `MaskedInput`, and `PhoneInput` onto the shared `InputDecorator` surface for more consistent visual behavior
- improved the route-level dashboard foundation by aligning `PageHeader`, `StatCard`, and `DataTableToolbar` with the newer surface/tone APIs
- registered `app-input` and `form-app-input` so CLI/source-copy discovery can prefer the universal input wrappers
- hardened `AppInput` and `FormAppInput` typing so specialized props are routed more safely by kind
- routed `FormSearchInput`, `FormNumberInput`, `FormPhoneInput`, and `FormDateInput` through `FormAppInput` as compatibility wrapper migrations
- exported `StatusDot`, `UserCard`, `ProgressCircle`, `SectionHeader`, `NavTabs`, `FileDropzone`, `ScrollBox`, and `RightClickMenu` from their public surfaces
- re-routed compatibility wrappers back onto the canonical `FormInput` surface so docs and implementation stay aligned
- clarified README and universal-input docs to teach `Input` / `FormInput` first while keeping aliases for migration

### Docs

- aligned the component maturity matrix with the current `Button` public API
- documented the universal input API in `UNIVERSAL_INPUT.md`
- added a render-time public API snapshot test for documented root exports

## 0.2.3 - 2026-06-23

### Added

- new `Stack`, `Inline`, and `Grid` layout helpers for common vertical, horizontal, and grid composition

### Changed

- aligned package, CLI, and registry versions for the next public release