@work-rjkashyap/unified-ui 0.2.1 → 0.2.2

package/CHANGELOG.md

@@ -1,299 +1,183 @@
-# Unified UI Changelog
-All notable changes to the Unified UI design system will be documented in this file.
+# Changelog
+All notable changes to the **Unified UI** design system will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
----
 ## [Unreleased]
-### Planned
-- Migration guide — mapping from legacy `--ds-*` tokens to new plain `--*` tokens
-- `UnifiedUIProvider` component for optional auto CSS injection
-- Component tests with Vitest + Testing Library
----
-
+## [0.2.2] — 2026-03-07
+### 🚀 Features
+- Add dynamic favicon (icon.tsx) and Apple touch icon using the CircuitBoard logo
+- Add OG image generation (opengraph-image.tsx) with branded design, CTA, and tech stack
+- Add OpenGraph and Twitter card metadata to root layout
+- Fix docs OG route to display "Unified UI" instead of "My App"
+- Optimize OG title (59 chars) and description (160 chars) for SEO best practices
+### 🐛 Bug Fixes
+- Enhance changelog script to scan all commits if no tags are found ([fdbb105](https://github.com/imrj05/unified-ui/commit/fdbb105c47e4afa1f999b0eddfe884a903b76466))
+- Update component links from /docs/components to /components ([d511280](https://github.com/imrj05/unified-ui/commit/d511280063616413efb9235d81d21eabf467b2ca))
+### 🔧 Refactors
+- **changelog-renderer:** Enhance changelog parsing and rendering logic
+- Improved parsing logic to handle multi-line items and indented sub-items.
+  - Added support for section titles with emojis by stripping them before processing.
+  - Enhanced section color mapping to include additional categories and keywords.
+  - Refactored the rendering of changelog items and sections for better readability and maintainability.
+  - Updated the stats calculation to normalize section titles for accurate feature and fix counts. ([f3b47fe](https://github.com/imrj05/unified-ui/commit/f3b47fe55a9c7637570e833b6256b2adb969dbcc))
+### 🏗️ Miscellaneous
+- **changelog:** Auto-update unreleased entries [skip ci] ([6658a0a](https://github.com/imrj05/unified-ui/commit/6658a0a50017a21e4fe868d86381ea0b9a76601e))
+- **changelog:** Auto-update unreleased entries [skip ci] ([8dc0ab8](https://github.com/imrj05/unified-ui/commit/8dc0ab8f9ed198e4b0da315a91869ca374626fd5))
+- Stop tracking CHANGELOG.md locally ([4973cf5](https://github.com/imrj05/unified-ui/commit/4973cf5a401970d23922e39e7590187a40497307))
+### Other
+- Add CHANGELOG for packages/unified-ui ([06dc82a](https://github.com/imrj05/unified-ui/commit/06dc82a36328e9a289adea9eaade36abd0f49bdf))
+- Add changelog generator and update workflow
+Add .github/scripts/generate-changelog.sh and call it from the
+changelog workflow. Also add .zed/settings.json with editor/assistant
+settings. ([bbd4f82](https://github.com/imrj05/unified-ui/commit/bbd4f827837dd91acbf5be5005ca3c4cc50c38aa))
+- Ignore CI changelog and set workflow shell to bash ([ac4da0a](https://github.com/imrj05/unified-ui/commit/ac4da0a4851cfd75930bc8208df04fc395963bfc))
+- Merge branch 'main' of github.com:imrj05/unified-ui ([1ae2200](https://github.com/imrj05/unified-ui/commit/1ae2200684ee757e24fa6ba7f7a342c76dc4d959))
+- Automate changelog and release workflow
+Add a custom changelog workflow that parses Conventional Commits and
+prepends entries into packages/unified-ui/CHANGELOG.md without
+overwriting
+hand-written release notes. Overhaul the release pipeline to validate
+tag
+versions, build and publish the design system, promote [Unreleased] → a
+versioned changelog entry, and create the GitHub Release with notes.
+Update cliff.toml comments to reflect its role for GitHub release notes. ([a1167e7](https://github.com/imrj05/unified-ui/commit/a1167e7bef2fb78093408738c450a8d2da70f3af))
 ## [0.2.1] — 2026-03-06
-### Fixed
-- **CLI: Registry URL** — Fixed the hardcoded registry base URL in the CLI from `unified-ui.vercel.app` (a different, unrelated Vercel project) to the correct `unified-ui-rajeshwar.vercel.app`. This caused `npx @work-rjkashyap/unified-ui add <component>` to fail with a 404 error for all users of the published npm package.
-- **CLI: `$schema` URL** — Updated the default `$schema` reference in `unified-ui.json` config to point to the correct registry domain.
-
-### Changed
-- **Homepage text sizes** — Increased font sizes across all homepage sections (Hero, Features, Showcase, Testimonials/Why, CTA, Footer) for improved readability. Bumped headings, descriptions, card titles, labels, code blocks, and stat numbers up by roughly one Tailwind size step (e.g. `text-[10px]` → `text-xs`, `text-xs` → `text-sm`, `text-sm` → `text-base`).
-
-### Added
-- **Automated changelog generation** — Added GitHub Actions workflow (`.github/workflows/changelog.yml`) that auto-generates changelog entries from Conventional Commit messages on every push to `main`. Uses `git-cliff` to parse `feat:`, `fix:`, `refactor:`, `chore:` prefixes and appends to `CHANGELOG.md`.
-
----
-
+### 🐛 Bug Fixes
+- Update placeholder API key in ConfirmDialog documentation ([6ca53c5](https://github.com/imrj05/unified-ui/commit/6ca53c5d1cecaee31afb376b860908981d9bf04c))
+### 🔧 Refactors
+- Clean up formatting and remove unnecessary whitespace in ConfirmDialog documentation ([a8c382f](https://github.com/imrj05/unified-ui/commit/a8c382fbdcf0038b9e85160e472e45ac98da7579))
+### Other
+- Add automated changelog and release workflows
+Include git-cliff config and CI workflows for changelog generation
+and releases
+- Add cliff.toml and .github/workflows/changelog.yml to auto-generate
+  packages/unified-ui/CHANGELOG.md from Conventional Commits on pushes
+  to main
+- Add .github/workflows/release.yml to validate tag, build the design
+  system, publish to npm, and create a GitHub Release with changelog
+  notes
+- Add server-side changelog page and renderer under src to surface the
+  generated CHANGELOG.md in the docs site
+- Commit generated CHANGELOG.md and bump @work-rjkashyap/unified-ui to
+  0.2.1 ([8e036bd](https://github.com/imrj05/unified-ui/commit/8e036bdf7e9004f43a28f01a8a220a49f4afd8fd))
+- Use unified-ui-rajeshwar registry
+Add a build:registry step to the root build script; update CLI and
+registry build scripts to use the new registry homepage and tweak
+imports/formatting. Bump typography and spacing across home components
+for improved readability. ([c55b091](https://github.com/imrj05/unified-ui/commit/c55b091dfb5843ad1a89230740cf5646f918f897))
+- Format Confirm Dialog MDX and fix examples
+Adjust whitespace and indentation in
+content/components/confirm-dialog.mdx.
+Separate the AlertDialog primitives example from the barrel import and
+clean
+up code fences for usage, variants, and preview snippets. ([50a0c83](https://github.com/imrj05/unified-ui/commit/50a0c830ac27441b9fdcd6bb415f2bf8d7f6e260))
 ## [0.2.0] — 2026-03-05
-### Added
-#### 40 New Components
-- **AlertDialog** — Radix-based modal confirmation dialog with composable header/body/footer
-- **AspectRatio** — Radix-based responsive aspect-ratio container
-- **Banner** — Full-width notification banner with variants
-- **Calendar** — Date calendar component for date selection
-- **Callout** — Highlighted contextual message block with icon support
-- **Carousel** — Scrollable content carousel with navigation controls
-- **Code** — Styled code block with syntax formatting
-- **Collapsible** — Radix-based expandable/collapsible content region
-- **Combobox** — Searchable dropdown with keyboard navigation and filtering
-- **Command** — Command palette / search interface (cmdk-style)
-- **ConfirmDialog** — Simplified confirmation dialog with accept/cancel actions
-- **ContextMenu** — Radix-based right-click context menu with items, sub-menus, and shortcuts
-- **CopyButton** — Click-to-copy button with success feedback
-- **DataList** — Key-value display list for structured data
-- **DatePicker** — Calendar-powered date input with popover picker
-- **EmptyState** — Placeholder for empty content areas with icon, title, description, and action
-- **FileUpload** — Drag-and-drop file upload zone with file list management
-- **FormField** — Form field wrapper with label, description, error message, and validation state
-- **HoverCard** — Radix-based hover-triggered floating card
-- **InputGroup** — Grouped input with addon/prefix/suffix slots
-- **Kbd** — Keyboard shortcut key display
-- **Label** — Standalone form label component (extracted from primitives)
-- **Menubar** — Radix-based horizontal menu bar with dropdowns, checkbox items, and radio items
-- **NavigationMenu** — Radix-based site navigation with flyout content panels
-- **NumberInput** — Numeric input with increment/decrement controls
-- **PinInput** — Multi-digit OTP / PIN code input with auto-focus advancement
-- **Progress** — Determinate and indeterminate progress bar with label
-- **Resizable** — Resizable panel layout powered by `react-resizable-panels`
-- **ScrollArea** — Radix-based custom scrollbar container (vertical + horizontal)
-- **SearchInput** — Input with search icon, clear button, and keyboard shortcut hint
-- **Sidebar** — Collapsible application sidebar with sections, items, and nested groups
-- **Slider** — Radix-based range slider with single and multi-thumb support
-- **Spinner** — Loading spinner with size variants
-- **Stat** — Statistic display with label, value, and trend indicator
-- **Steps** — Multi-step progress indicator with vertical/horizontal orientation
-- **Tag** — Compact label/tag with removable action
-- **Timeline** — Vertical timeline with customizable markers and connectors
-- **Toggle** — Radix-based toggle button with multiple visual variants, sizes, and icon support
-- **ToggleGroup** — Radix-based single/multi toggle group with shared styling
-- **VisuallyHidden** — Accessible screen-reader-only content wrapper
-
-#### 13 New Motion Presets
-- **`shakeX`** — Horizontal shake for invalid input feedback
-- **`springHover`** — Spring-based hover micro-interaction
-- **`springPress`** — Spring-based press micro-interaction
-- **`countUp`** — Animated number count-up
-- **`crossfade`** — Crossfade transition between elements
-- **`dragDismiss`** — Drag-to-dismiss gesture preset
-- **`numberRoll`** — Rolling number transition
-- **`revealMask`** — Mask-based content reveal
-- **`slidePanelTop`** — Directional slide panel from top
-- **`slidePanelBottom`** — Directional slide panel from bottom
-- **`slidePanelLeft`** — Directional slide panel from left
-- **`slidePanelRight`** — Directional slide panel from right
-
-### Changed
-#### Component Refactors
-- **Accordion** — Major rewrite with improved variant composition and accessibility
-- **Breadcrumb** — Refactored with enhanced composability and truncation logic
-- **Button** — Expanded with new variants and improved styles (618 lines changed)
-- **Card** — Restructured composable sub-components
-- **Checkbox** — Overhauled with `CheckboxGroup` improvements
-- **DataTable** — Major refactor with enhanced filtering, sorting, and pagination (3480 lines changed)
-- **Dialog** — Restructured with improved sizing and scroll behavior
-- **DropdownMenu** — Refactored sub-component exports and styling
-- **Input** — Enhanced with new slot patterns and error states
-- **Pagination** — Rewritten with improved responsive behavior
-- **Popover** — Cleaned up code structure and formatting
-- **Radio** — Refactored `RadioGroup` / `RadioGroupItem` / `RadioCard` styling
-- **Select** — Updated compositional sub-component pattern
-- **Sheet** — Improved directional slide-out behavior
-- **Switch** — Enhanced with new size and label options
-- **Table** — Expanded density and styling options
-- **Tabs** — Reworked variant composition for underline/segment/pills
-- **Textarea** — Improved auto-resize and character count logic
-- **Toast** — Major refactor with improved stacking and animations (1209 lines changed)
-
-#### Code Cleanup
-- Cleaned up formatting and structure in **NavigationMenu**, **Popover**, and **ScrollArea** components
-- Updated `styles.css` with restructured CSS custom properties and new token categories
-- Improved `tokens/colors.ts` with expanded palette definitions
-- Updated `utils/contrast.ts` with refined WCAG checking utilities
-- Updated `motion/presets.ts` — `reduceMotion()` signature cleaned up (unused parameter prefixed with `_`)
-
-#### Other
-- Updated `UNIFIED_UI_VERSION` exported constant from `"0.1.2"` to `"0.2.0"`
-- Component count increased from 23 to 63+
-- Barrel exports in `components/index.ts` and `src/index.ts` expanded for all new components
----
-## [0.1.2] — 2026-03-03
-### Added
-#### Theme Customizer System
-- **`ThemeCustomizerProvider`** — React context provider for runtime theme management with `localStorage` persistence and cross-tab sync via `StorageEvent`
-- **`useThemeCustomizer()`** — hook exposing `config`, `setColorPreset`, `setRadius`, `setFont`, `setShadow`, `setSurfaceStyle`, `resetConfig`, `isDefault`, `generateCSS`
-- **`ThemeCustomizer`** — drop-in UI component with color swatch picker, radius preview, font preview, shadow/surface style toggles, "Copy CSS" button, and reset
-- **13 color presets**: 5 neutral (`Zinc`, `Slate`, `Gray`, `Stone`, `Neutral`) + 8 chromatic (`Blue`, `Green`, `Violet`, `Rose`, `Orange`, `Red`, `Teal`, `Brand`)
-- **7 radius presets**: None (0px) through XL (16px), default 10px
-- **5 font presets**: Outfit, Inter, System, Serif, Mono
-- **4 shadow presets**: None, Subtle, Default, Heavy (each with light/dark scales)
-- **3 surface style presets**: Bordered, Elevated, Mixed
-- `ThemeConfig` type, `DEFAULT_THEME_CONFIG`, `buildThemeOverrides()`, `generateThemeCSS()` utilities
-- `COLOR_PRESET_KEYS`, `COLOR_PRESETS`, `getColorPreset`, `getFontPreset`, `getRadiusPreset`, `getShadowPreset` helpers
-- Exported types: `ColorPreset`, `ColorPresetKey`, `FontPreset`, `RadiusPreset`, `ShadowPreset`, `SurfaceStylePreset`, `PresetSemanticColors`, `ThemeCustomizerContextValue`, `ThemeCustomizerProps`, `ThemeCustomizerProviderProps`
-#### New Tokens
-- `neutral` color palette added to `tokens/colors`
-- New CSS custom properties: `--card`, `--card-foreground`, `--popover`, `--popover-foreground`, `--accent`, `--accent-foreground`, `--destructive`, `--destructive-foreground`, `--ring`, `--radius`, `--chart-1` through `--chart-5`, `--sidebar-*` (8 tokens)
-#### Select Sub-component Exports
-- Newly exported: `SelectContent`, `SelectContentProps`, `SelectTrigger`, `SelectTriggerProps`, `SelectValue`, `SelectScrollUpButton`, `SelectScrollUpButtonProps`, `SelectScrollDownButton`, `SelectScrollDownButtonProps`
-### Changed
-#### Color Format: RGB → oklch
-- All color tokens migrated from RGB channel strings (e.g. `"79 70 229"`) to complete `oklch()` values (e.g. `"oklch(0.585 0.233 277.117)"`)
-- Affects all palettes: `slate`, `gray`, `zinc`, `brand`, `blue`, `green`, `red`, `amber`, `teal`
-- Semantic colors (light + dark) updated to use oklch values
-- Shadow tokens updated from `rgba()` to `oklch()` syntax
-- `dsColorVar()` now returns `var(--{name})` and uses `color-mix(in oklch, ...)` for alpha variants instead of `rgb(... / alpha)`
-#### CSS Variable Prefix Removal (`--ds-*` → `--*`)
-- Removed the `PREFIX` constant from `contract.ts`
-- All CSS custom properties simplified: `--ds-color-primary` → `--primary`, `--ds-radius-md` → `--radius-md`, `--ds-shadow-lg` → `--shadow-lg`, `--ds-z-modal` → `--z-modal`, `--ds-duration-fast` → `--duration-fast`, `--ds-easing-standard` → `--easing-standard`, `--ds-font-sans` → `--font-sans`
-- All Tailwind utility classes updated: `bg-ds-primary` → `bg-primary`, `text-ds-foreground` → `text-foreground`, `rounded-ds-md` → `rounded-md`, etc.
-- All 25 components, 3 primitives, and all utilities updated for the new naming
-#### Focus Ring System Overhaul
-- Redesigned from ring-based (`focus-visible:ring-2 focus-visible:ring-ds-focus-ring focus-visible:ring-offset-2`) to border-based (`focus-visible:border-border-strong`) focus indicators
-- All focus ring variants updated: `focusRingClasses`, `focusRingInsetClasses`, `focusRingCompactClasses`, `focusWithinRingClasses`, `focusRingGroupRingClasses`, `focusRingGroupTriggerClasses`
-#### Component Updates
-- **Button** — Added `not-prose no-underline` to base styles to prevent prose typography overrides on `<a>` buttons
-- **Select** — Refactored to compositional sub-component pattern; removed `SelectProps` type (use sub-component props instead)
-- **DropdownMenu** — Major refactor (618 lines changed)
-- **Popover** — Major refactor (332 lines changed)
-- **DataTable** — Updated for new token naming and focus styles
-#### Other
-- Updated `UNIFIED_UI_VERSION` exported constant from `"0.1.1"` to `"0.1.2"`
-- `@theme` block in `styles.css` completely rewritten with plain `--{name}` properties and new token categories
-- `dsVar()` now generates `--{category}-{name}` (was `--ds-{category}-{name}`)
----
+### 🚀 Features
+- Enhance component previews and theme customizer
+- Added VSCodeCodeBlock for improved code display in ComponentPage.
+  - Introduced CustomizerPanel for theme customization options including color, radius, font, shadow, and surface styles.
+  - Updated input-previews to streamline imports.
+  - Renamed Tag components to Badge for consistency and clarity in tag previews.
+  - Implemented ThemeToggle previews for various configurations and sizes.
+  - Enhanced ThemeCustomizerTrigger with mode selection for light, dark, and system themes.
+  - Updated MDX components to include new previews and components for better documentation. ([7148072](https://github.com/imrj05/unified-ui/commit/7148072478ceb2857e40c70251380c4be244ede1))
+- Add Toggle component and related previews
+- Implemented Toggle component using Radix UI's Toggle primitive with support for multiple visual variants, sizes, and icons.
+  - Added Toggle to the unified-ui index for export.
+  - Created navigation component previews for ContextMenu, Menubar, Steps, and Command, showcasing various states and interactions.
+  - Updated MDX components to include new previews for documentation. ([63b0f57](https://github.com/imrj05/unified-ui/commit/63b0f57dcc8150f5648b7541b8d93d70f42ebd45))
+### 🔧 Refactors
+- Clean up component code formatting and structure in navigation menu, popover, and scroll area ([c0935d9](https://github.com/imrj05/unified-ui/commit/c0935d92ca5324338f590d25a2406ca85e0921f3))
+## [0.1.2] — 2026-03-02
+### 🚀 Features
+- Integrate theme customizer and improve UI components
+- Added ThemeCustomizerProvider and ThemeCustomizerTrigger to layout for theme customization.
+  - Updated button styles to enhance focus visibility and hover effects.
+  - Refactored collapsible component to improve readability and maintainability.
+  - Updated navigation menu and popover components to use new radix-ui imports.
+  - Enhanced data table demo with consistent text color updates.
+  - Improved scroll area component for better overflow handling.
+  - Updated TypeScript configuration to include new unified-ui paths for better module resolution. ([69bb594](https://github.com/imrj05/unified-ui/commit/69bb5940835fb0d45f29d21e4bf4bb44f67c66e1))
+### 🏗️ Miscellaneous
+- Bump version to 0.1.2 and update changelog ([b09bbbf](https://github.com/imrj05/unified-ui/commit/b09bbbf4de830fad0211f8491e622436dc0ce783))
+### Other
+- Regenerate package-lock
+Bump @biomejs/biome to 2.4.4 and shikijs packages to 3.23.0.
+Consolidate duplicated @radix-ui/react-slot entries into one resolved
+entry. Lockfile churn from dependency updates only. ([2d0f0ed](https://github.com/imrj05/unified-ui/commit/2d0f0ed95660e49b64c5135e27e732747541b2b1))
+- Revise README with expanded overview and docs ([f67f910](https://github.com/imrj05/unified-ui/commit/f67f910d6542877e57f6ad54b62d10538021b5f8))
 ## [0.1.1] — 2026-02-28
-### Added
-#### DataTable Component
-- **DataTable** — Full-featured data table powered by TanStack Table (`@tanstack/react-table` ≥ 8.0.0)
-  - Column sorting, filtering (text + faceted), row selection, column visibility toggles
-  - Built-in pagination with configurable page sizes
-  - `useDataTable` hook for headless table state management
-  - `createColumnHelper` re-export for type-safe column definitions
-  - Exported types: `DataTableProps`, `DataTableColumnMeta`, `DataTableFacetedFilter`, `UseDataTableOptions`, `UseDataTableReturn`, `ColumnDef`, `ColumnFiltersState`, `PaginationState`, `Row`, `RowSelectionState`, `SortingState`, `VisibilityState`
-  - `@tanstack/react-table` added as an optional peer dependency
-#### Motion Hooks
-- `useMotion()` — hook for accessing motion presets with reduced-motion awareness
-- `useMotionProps()` — hook that returns spread-ready motion props
-- `useMotionSpringConfig()` — hook for accessing spring configuration tokens
-- `useReducedMotion()` — hook for detecting `prefers-reduced-motion` user preference
-- `MotionSafe` — wrapper component that conditionally renders motion based on user preference
-### Changed
-- Updated `UNIFIED_UI_VERSION` exported constant from `"0.1.0"` to `"0.1.1"`
-- Component count updated from 22 to 23 across documentation and metadata
-- Package description updated to reflect 23+ components
-### Fixed
-- Removed self-referential dependency (`@work-rjkashyap/unified-ui` depending on itself) from `package.json`
-- Added missing `homepage` and `bugs` fields to `package.json`
-- Added `funding` field to `package.json`
-- Expanded `keywords` in `package.json` for better npm discoverability (`tailwind-css-v4`, `design-tokens`, `css-variables`, `theming`, `dark-mode`, `typescript`, `tree-shakeable`)
----
+### Other
+- Add DataTable, docs overhaul, and bump version
+Implement a full DataTable component (TanStack Table) and export
+hooks/types.
+Bump UNIFIED_UI_VERSION to 0.1.1 and update package metadata (homepage,
+bugs,
+funding). Revamp many MDX component pages to use interactive
+ComponentPage
+previews and update icons/imports. Add ToastPreview demo component and
+adjust
+site links/README/CHANGELOG accordingly. ([8fb7338](https://github.com/imrj05/unified-ui/commit/8fb7338ca305daac24a6b595bf1ea30022d1e250))
+- Add DataTable component and docs
+Introduce DataTable powered by TanStack Table with sorting,
+filtering, pagination, row selection, column visibility and a
+useDataTable hook. Add a DataTableDemo component and a full MDX
+documentation page. Also add a global hide-scrollbar CSS utility
+and miscellaneous layout/formatting updates to notebook/sidebar
+components. ([f10f8f0](https://github.com/imrj05/unified-ui/commit/f10f8f0fbc04321d545a0b1abe2e538a861b140b))
+- Add @work-rjkashyap/unified-ui dependency
+Move framer-motion to optionalDependencies and reorder devDependencies.
+Format typesVersions arrays and update package-lock.json accordingly ([a3dec68](https://github.com/imrj05/unified-ui/commit/a3dec6872110b6db3de18ccb3152e8a3b4a3fd85))
 ## [0.1.0] — 2026-02-27
-### Added
-#### Design Tokens
-- Color palettes: `slate`, `gray`, `zinc`, `neutral`, `red`, `green`, `blue`, `amber`, `teal`, `brand`, `pure`
-- Semantic color mappings for light and dark themes (`semanticLight`, `semanticDark`)
-- Spacing scale (0–96 + custom values)
-- Typography tokens: `fontFamily` (display, sans, serif, mono, inherit), `fontSize`, `fontWeight`, `lineHeight`, `letterSpacing`, typography variant presets
-- Radius scale (`none` through `full`)
-- Shadow scale with light and dark variants
-- Z-index scale (`hide`, `base`, `dropdown`, `sticky`, `overlay`, `modal`, `popover`, `toast`, `max`)
-- Motion tokens: `duration`, `easing`, `spring`, `stagger` (with CSS and seconds variants)
-#### Theme System
-- CSS variable contract mapping all tokens to plain CSS custom properties
-- `DSThemeProvider` component with light/dark/system mode support
-- `useDSTheme()` hook for programmatic theme access
-- `buildLightThemeVars()` / `buildDarkThemeVars()` / `buildThemeCSS()` utilities
-- `cssVar()` helper for type-safe CSS variable references
-#### Typography System
-- Multi-font architecture with four font families:
-  - **Outfit** (`--font-outfit`) — primary sans-serif UI typeface
-  - **Inter** (`--font-inter`) — display / headings
-  - **Lora** (`--font-lora`) — serif / editorial
-  - **JetBrains Mono** (`--font-jetbrains`) — monospace / code
-- `font` prop on `Typography` component for runtime font switching
-- Graceful fallback to system font stacks when web fonts are unavailable
-#### Tailwind CSS v4 Integration
-- `styles.css` with full `@theme` block mapping all tokens to Tailwind utilities
-- Direct Tailwind utilities for colors, radius, shadows, transitions, fonts (no prefix)
-- Font CSS custom properties (`--font-outfit`, `--font-inter`, `--font-lora`, `--font-jetbrains`)
-#### Primitive Components
-- **Typography** — polymorphic text component with `variant`, `font`, `color`, `align`, `truncate` props
-- **Heading** — semantic heading (h1–h6) with automatic size mapping
-- **Subheading** — secondary heading variant
-- **Body** — paragraph text with size variants
-- **Caption** — small supporting text
-- **Label** — form label with required indicator support
-- **Overline** — uppercase label text
-- **InlineCode** — inline code formatting
-- **Container** — responsive max-width wrapper (`sm` through `2xl`)
-- **Stack** — flexbox layout with `direction`, `gap`, `align`, `justify`
-- **Grid** — CSS grid layout with responsive column configuration
-- **Divider** — horizontal/vertical separator with label support
-#### Composite Components (22 total)
-- **Button** — primary, secondary, outline, ghost, danger, link variants; sm/md/lg sizes; icon-only mode; loading state
-- **Input** — text input with prefix/suffix slots, error state, disabled state
-- **Textarea** — auto-resize support, character count, error state
-- **Select** — Radix-based with groups, labels, separators; searchable variant
-- **Checkbox** — with `CheckboxGroup` for managing groups; indeterminate state
-- **Radio** — `RadioGroup` + `RadioGroupItem` + `RadioCard` variant
-- **Switch** — toggle with label positioning (start/end), sizes
-- **Card** — composable `Card` / `CardHeader` / `CardBody` / `CardFooter`; elevated, outline, ghost variants
-- **Badge** — default, secondary, outline, success, warning, danger variants; sm/md/lg sizes
-- **Avatar** — image with fallback initials, status indicator, `AvatarGroup` stacking
-- **Tooltip** — Radix-based with configurable side, align, delay
-- **Popover** — Radix-based with arrow, close button, controlled/uncontrolled
-- **DropdownMenu** — full Radix menu with items, checkbox items, radio items, sub-menus, shortcuts
-- **Dialog** — modal with sm/md/lg/xl/full sizes; composable header/body/footer; scroll locking
-- **Sheet** — slide-out drawer from top/right/bottom/left; sm/md/lg/xl sizes
-- **Tabs** — underline, segment, pills variants; horizontal/vertical orientation
-- **Accordion** — single/multiple mode; default/bordered/ghost variants; sm/md/lg sizes
-- **Toast** — portal-based with stacking, auto-dismiss, pause-on-hover, progress bar, `useToast()` hook
-- **Alert** — info, success, warning, error variants with icon, title, description
-- **Skeleton** — base `Skeleton` + `SkeletonText`, `SkeletonCircle`, `SkeletonRect` presets; pulse animation
-- **Table** — semantic table with striped rows, hover highlight, sticky header, responsive wrapper; compact/default/relaxed density
-- **Pagination** — page numbers with ellipsis, prev/next, compact variant, controlled/uncontrolled
-- **Breadcrumb** — composable sub-components + `BreadcrumbNav` shorthand; truncation with ellipsis
-#### Motion System
-- Fade presets: `fadeIn`, `fadeInFast`, `fadeInSlow`
-- Slide presets: `slideUp`, `slideUpSm`, `slideUpLg`, `slideUpSpring`, `slideDown`, `slideDownSm`, `slideLeft`, `slideRight`, `slideInFromLeft`, `slideInFromRight`, `slideInFromBottom`
-- Scale presets: `scaleIn`, `scaleInLg`, `scaleInSpring`
-- Blur presets: `blurIn`, `blurInSubtle`
-- Overlay/modal: `overlayBackdrop`, `modalContent`, `modalContentSpring`
-- Toast: `toastSlideIn`, `toastSlideUp`
-- Expand/collapse: `expandHeight`, `expandHeightSlow`
-- Micro-interactions: `press`, `tapScale`, `hoverScale`, `hoverLift`, `pop`, `popSubtle`
-- Loading: `pulse`, `spin`
-- Stagger containers: `staggerContainer`, `staggerContainerFast`, `staggerContainerSlow`
-- `motionProps()` spread helper for clean JSX usage
-- `reduceMotion` / `withReducedMotion()` utilities for `prefers-reduced-motion` support
-#### Utilities
-- `cn()` — class name merger (clsx + tailwind-merge)
-- `mergeSlots()` — slot-based class merging for composite components
-- `composeRefs()` — compose multiple React refs into one
-- `dsAttr()` / `dsDataAttrs()` — data attribute generators for component identification
-- `dsStateAttr()` — conditional data attribute for component states
-- `dsVar()` / `dsColorVar()` — CSS custom property reference helpers
-- `typedKeys()` — type-safe `Object.keys`
-- `noop` — no-operation function
-- Focus ring utilities: `focusRingClasses`, `focusRingInsetClasses`, `focusRingCompactClasses`, `focusWithinRingClasses`, `focusRingGroupRingClasses`, `focusRingGroupTriggerClasses`, `focusRingVariantOverrides`
-- WCAG contrast checking: `checkHexContrast`, `checkDSContrast`, `auditContrast`, `contrastRatio`, `relativeLuminance`, `meetsAA`, `meetsAAA`, `meetsNonTextAA`, `parseHex`, `parseRGBString`, `toRGBString`
-- Polymorphic component types: `AsProp`, `PolymorphicProps`, `PolymorphicPropsWithRef`, `PolymorphicRef`, `PolymorphicComponent`
-- Slot types: `SlotClasses`, `SlotConfig`, `SlotDefinition`, `SlotRenderFn`, `Slots`
-- Component types: `ComponentSize`, `ComponentIntent`, `ChildrenProps`, `OptionalChildrenProps`
-#### Package & Build
-- `tsup` build pipeline producing ESM (`.mjs`) and CJS (`.cjs`) with TypeScript declarations (`.d.ts` / `.d.cts`)
-- 7 entry points: `index`, `tokens`, `theme`, `primitives`, `components`, `motion`, `utils`
-- Selective `"use client"` directive — applied only to client entry points (not tokens/utils)
-- Radix UI packages externalized as optional peer dependencies
-- Tree-shakeable with code splitting enabled
-- `styles.css` exported as `@work-rjkashyap/unified-ui/styles.css` for Tailwind `@theme` integration
-- `@unified-ui/*` TypeScript path aliases (zero relative cross-directory imports)
-#### Infrastructure
-- `UNIFIED_UI_VERSION` exported constant for runtime version checking
-- `.npmignore` for clean package distribution
-- `sideEffects` field for optimal tree-shaking
-- Conditional `exports` map with full `import`/`require`/`types` resolution
-- `typesVersions` fallback for older TypeScript resolvers
----
-_Design system: Unified UI_
-_Maintainer: Rajeshwar Kashyap_
-_Repository: [github.com/imrj05/unified-ui](https://github.com/imrj05/unified-ui)_
+### 🚀 Features
+- Publish @work-rjkashyap/unified-ui@0.1.0 to npm
+Rename package scope from @unified-ui/react to
+  @work-rjkashyap/unified-ui
+  to match npm organization ownership.
+  Updated references across 39 files:
+  - packages/unified-ui/package.json (package name)
+  - Root package.json (workspace scripts + dependency)
+  - src/app/global.css (CSS import)
+  - All 22 component MDX docs (imports + code examples)
+  - 8 design system MDX docs (tokens, colors, motion, etc.)
+  - README.md, TODO.md, copilot-instructions.md ([4872c9a](https://github.com/imrj05/unified-ui/commit/4872c9a6b68b99eee42c8f3e2795b3c46ad22ade))
+- Enhance layout components and navigation
+- Refactored HomeLayout to improve structure and readability.
+  - Updated Nav component to include type safety for link items and improved rendering logic.
+  - Enhanced DocsLayout and DocsSidebar for better sidebar management and navigation.
+  - Added new legal, company, and resource sources in the source loader for better content organization.
+  - Improved styling and responsiveness in various layout components. ([c6f5803](https://github.com/imrj05/unified-ui/commit/c6f58032da8c7e07b3b1d3877ccc93b076875ad6))
+- Add new components including Collapsible, Popover, Scroll Area, and Navigation Menu; update existing components with icons ([8907f41](https://github.com/imrj05/unified-ui/commit/8907f410b1d4abd94ff3613e32bf082b0c24a2c3))
+- Enhance HomePage layout and HeroSection design, improve sidebar component structure ([e894c85](https://github.com/imrj05/unified-ui/commit/e894c85dbb9b18bb41fe1020602df20912d983d6))
+- Update layout components with new Logo and navigation structure, enhance HeroSection design ([6a5bb28](https://github.com/imrj05/unified-ui/commit/6a5bb28aaea526e8b643b3fc805e54180bc31d4f))
+- Add showcase and testimonials sections, enhance layout components
+- Introduced `ShowcaseSection` component showcasing key features with interactive elements.
+  - Added `TestimonialsSection` component to display user feedback and experiences.
+  - Created `ComponentPage` layout for displaying component details, including preview and code tabs.
+  - Implemented `Logo` component for branding in the layout.
+  - Developed `Nav` component for navigation with links to documentation and components.
+  - Added `NavbarLinkItem` and `Navbar` components for structured navigation.
+  - Created `DocsSidebar` for sidebar navigation with page tree and tabs.
+  - Defined `SIDEBAR_TABS` for easy management of sidebar navigation items. ([88212b5](https://github.com/imrj05/unified-ui/commit/88212b5b150e0c41d5f87a87ffc4de1619fd7e84))
+- Add sidebar link item and page tree components
+- Implemented `createLinkItemRenderer` for rendering sidebar items based on the page tree structure.
+  - Added `createPageTreeRenderer` to manage the rendering of page tree items, including folders and separators.
+  - Introduced a dropdown component for sidebar tabs with enhanced accessibility and styling.
+  - Created utility functions for managing sidebar tabs and their properties.
+  - Added theme toggle functionality with improved user experience.
+  - Developed a table of contents (TOC) component with dynamic resizing and rendering based on headings.
+  - Enhanced UI components including buttons, collapsibles, navigation menus, and popovers for better usability and aesthetics.
+  - Introduced utility functions for merging refs and normalizing URLs. ([1b5c1da](https://github.com/imrj05/unified-ui/commit/1b5c1dad14d4720dc37cf3f388ea30d7afc5efae))
+### 🔧 Refactors
+- Streamline HomeLayout component structure and improve readability ([4b3321d](https://github.com/imrj05/unified-ui/commit/4b3321de6a308a3a93938ed4af0e6d07f0bf17c9))
+- Improve layout components and sidebar functionality
+- Refactored LayoutContext and LayoutContextProvider for better readability and performance.
+  - Updated LayoutHeader and LayoutBody components to enhance styling and structure.
+  - Adjusted sidebar components to improve usability and visual consistency.
+  - Enhanced ThemeToggle component to support button type and improved accessibility.
+  - Added a new StatusPage component to display system status and incident history.
+  - Updated Popover and ScrollArea components for better z-index management and scroll behavior. ([1ae241f](https://github.com/imrj05/unified-ui/commit/1ae241f315563fd789bc176bdb0c45226ee1160a))
+- Improve code formatting and readability across layout components ([08653fd](https://github.com/imrj05/unified-ui/commit/08653fdb7bccc8201ea9c826c663d0b2298a85a4))
+- Format code for improved readability in HomeLayout component ([830877e](https://github.com/imrj05/unified-ui/commit/830877e2120c14ae964ca79186e99992fd4b9a9b))
+### Other
+- Initial commit from Create Fumadocs App ([8fd3237](https://github.com/imrj05/unified-ui/commit/8fd3237b58fb87870e9db4b5aac9ec98060d2362))