@todovue/tv-ui 0.1.0

package/dist/demos/tv-theme-button/CHANGELOG.md

@@ -0,0 +1,136 @@
+# Changelog
+
+All notable changes to `@todovue/tv-theme-button` will be documented in this file.
+
+This project adheres to [Semantic Versioning](https://semver.org/).
+
+## [1.2.1] - 2026-01-27
+
+### Changed
+- Simplified the file list in `package.json` to include only essential assets.
+- Simplified the build configuration by removing demo-specific logic.
+- Enhanced GitHub Actions workflows to automate npm package publishing and GitHub release creation.
+- Moved the `@todovue/tv-demo` component import from main.js to `Demo.vue` to localize its usage.
+- Updated build commands to include `README.md` and `CHANGELOG.md` files in the public directory during the build process.
+
+### Added
+- Included the `src` directory in the `package.json` files list to ensure component source files are bundled in the package distribution.
+
+### Removed
+- Eliminated the global import of the `@todovue/tv-demo` component from `main.js`.
+
+### Dependencies
+- Updated `@todovue/tv-demo` to `^1.4.11`.
+- Updated `vue` to `^3.5.27`.
+- Updated `sass` to `^1.97.3`.
+
+## [1.2.0] - 2026-01-20
+
+### Added
+- Introduced a primary color variable to the global style configuration to facilitate easier branding and theme customization.
+- Improved the theme detection logic to more accurately identify system preferences.
+- Implemented a `storage` event listener to ensure theme changes synchronize instantly across multiple open browser tabs or windows.
+- Introduced support for custom colors to allow for more flexible branding and component styling.
+- Added configurable size options `sm` and `lg` to provide greater control over component dimensions.
+- Implemented `rounded` properties to support various border-radius styles across components.
+
+### Dependencies
+- Updated the `@todovue/tv-demo` dependency to `^1.4.4`.
+- Updated the `sass` dependency to `^1.97.2`.
+- Updated the `vite` dependency to `^7.3.1`.
+
+### Changed
+- Enhanced accessibility across components to improve screen reader compatibility and keyboard navigation.
+- Updated the application default to light mode when no specific theme preference is found.
+
+### Performance
+- Improved transition effects and transform properties to ensure smoother animations and better rendering performance.
+
+## [1.1.1] - 2025-12-19
+
+### Added
+- Added automatic publishing to the TODOvue cPanel in `release.yml` for each release, simplifying package distribution and updates.
+- Added `package-lock.json` to the repository to ensure dependency consistency and facilitate version management across development and production environments.
+- Added `darkIcon` prop to customize the dark mode icon. Accepts URLs (http/https), data URIs, local paths, or inline SVG strings.
+- Added `lightIcon` prop to customize the light mode icon. Accepts URLs (http/https), data URIs, local paths, or inline SVG strings.
+- Added prop validators to ensure icon values are valid URLs or SVG strings.
+
+### Changed
+- Changed the `base` option in `vite.config.js` for website deployment in cpanel.
+- Modified `useThemeButton` composable to accept `props` parameter for custom icon support.
+- Modified `iconContent()` function to return an object with `content` and `isUrl` properties instead of just a string.
+- Updated component template to conditionally render `<img>` tags for URLs or `<i>` tags with `v-html` for SVG strings.
+
+### Fixed
+- Fixed repository URL in `package.json` to point to the correct GitHub repository.
+- Fixed the token configuration used to generate the package in the GitHub Actions workflow `release.yml`.
+
+### Dependencies
+- Updated dependency versions in `package.json` to maintain compatibility and benefit from improvements and bug fixes in the used libraries.
+
+## [1.1.0] - 2025-11-21
+
+### Added
+- Added `nux.js` configuration file for Nuxt 4 integration.
+- Added `tsconfig.json` for proper type checking during build.
+- Create `global.d.ts` to declare module for TypeScript users.
+- Added Nuxt module for automatic style injection and auto-registration of the `TvThemeButton` component.
+- The `@todovue/tv-theme-button` component is now externalized from the final build, reducing bundle size.
+- Added `CHANGELOG.md` in script to generate demo and documentation site.
+
+### Dependencies
+- Updated the `@todovue/tv-demo` dependency to `^1.2.1` to ensure compatibility with the latest changes.
+
+### Fixed
+- Fixed files to export in `package.json` to ensure proper module resolution.
+
+## [1.0.3] - 2025-11-15
+
+### Changed
+- Styles are now served as a separate CSS file (`dist/tv-theme-button.css`) generated by Vite during the build process.
+- Users must now explicitly import the stylesheet in their application:
+  - For Vue/Vite SPA: `import '@todovue/tv-theme-button/style.css'` in `main.ts`
+  - For Nuxt 3/4: Add `'@todovue/tv-theme-button/style.css'` to the `css` array in `nuxt.config.ts`
+
+### Added
+- Added `sideEffects` field to `package.json` to support proper tree-shaking with CSS files.
+- Added `./style.css` export path in `package.json` for explicit CSS imports.
+- Improved SSR/SSG compatibility, especially for Nuxt 3/4 applications.
+
+### Dependencies
+- Removed dependency on `vite-plugin-css-injected-by-js` from `devDependencies`
+
+## [1.0.2] - 2025-11-13
+
+### Fixed
+- Fixed SSR hydration error in Nuxt caused by localStorage access during server-side rendering
+- Fixed component import path in demo application
+
+## [1.0.1] - 2025-10-19
+
+###️ Changed
+- The library build now uses `src/entry.ts` (exports both the component and the plugin) instead of directly exporting the `.vue` file.
+- CSS injection via JS has been removed for the library build (it is only kept for the demo), generating a `tv-theme-button.css` file optimized for SSR/Nuxt.
+- Changed node-version to workflows release.yml to 20.
+
+### Added
+- Plugin installation support: `app.use(TvThemeButton)` or `app.use(TvThemeButtonPlugin)`.
+- Explicit export of the style file: `import '@todovue/tv-theme-button/style.css'`.
+- Documentation for usage in SSR and Nuxt 3 applications.
+
+## [1.0.0] - 2025-05-05
+
+### Added
+
+- Initial release of `TvThemeButton`
+- Theme toggle functionality between `light` and `dark` modes
+- `change-theme` event to emit the selected theme
+
+[1.2.1]: https://github.com/TODOvue/tv-theme-button/pull/9/files
+[1.2.0]: https://github.com/TODOvue/tv-theme-button/pull/8/files
+[1.1.1]: https://github.com/TODOvue/tv-theme-button/pull/7/files
+[1.1.0]: https://github.com/TODOvue/tv-theme-button/pull/6/files
+[1.0.3]: https://github.com/TODOvue/tv-theme-button/pull/5/files
+[1.0.2]: https://github.com/TODOvue/tv-theme-button/pull/4/files
+[1.0.1]: https://github.com/TODOvue/tv-theme-button/pull/3/files
+[1.0.0]: https://github.com/TODOvue/tv-theme-button/pull/2/files

package/dist/demos/tv-theme-button/README.md

@@ -0,0 +1,392 @@
+<p align="center"><img width="150" src="https://res.cloudinary.com/dcdfhi8qz/image/upload/v1763663056/uqqtkgp1lg3xdplutpga.png" alt="TODOvue logo">
+</p>
+
+# TODOvue ThemeButton (TvThemeButton)
+A lightweight and customizable Vue 3 theme switcher component that allows users to toggle between light and dark modes. Designed for modern interfaces, it persists the theme preference in localStorage and integrates seamlessly into any Vue 3 project or SSR environment (e.g. Nuxt 3).
+
+[![npm](https://img.shields.io/npm/v/@todovue/tv-theme-button.svg)](https://www.npmjs.com/package/@todovue/tv-theme-button)
+[![npm downloads](https://img.shields.io/npm/dm/@todovue/tv-theme-button.svg)](https://www.npmjs.com/package/@todovue/tv-theme-button)
+[![npm total downloads](https://img.shields.io/npm/dt/@todovue/tv-theme-button.svg)](https://www.npmjs.com/package/@todovue/tv-theme-button)
+![License](https://img.shields.io/github/license/TODOvue/tv-theme-button)
+![Release Date](https://img.shields.io/github/release-date/TODOvue/tv-theme-button)
+![Bundle Size](https://img.shields.io/bundlephobia/minzip/@todovue/tv-theme-button)
+![Node Version](https://img.shields.io/node/v/@todovue/tv-theme-button)
+![Last Commit](https://img.shields.io/github/last-commit/TODOvue/tv-theme-button)
+![Stars](https://img.shields.io/github/stars/TODOvue/tv-theme-button?style=social)
+
+> Demo: https://ui.todovue.blog/themebutton
+
+## Table of Contents
+- [Features](#features)
+- [Installation](#installation)
+- [Quick Start (SPA)](#quick-start-spa)
+- [Nuxt 4 / SSR Usage](#nuxt-4--ssr-usage)
+- [Component Registration Options](#component-registration-options)
+- [Props](#props)
+- [Events](#events)
+- [Customization (Styles / Theming)](#customization-styles--theming)
+- [Accessibility](#accessibility)
+- [SSR Notes](#ssr-notes)
+- [Development](#development)
+- [Changelog](https://github.com/TODOvue/tv-theme-button/blob/main/CHANGELOG.md)
+- [Contributing](https://github.com/TODOvue/tv-theme-button/blob/main/CONTRIBUTING.md)
+- [License](https://github.com/TODOvue/tv-theme-button/blob/main/LICENSE)
+
+## Features
+- **Simple theme toggle**: Switch between light and dark modes with a single click
+- **Persistent state**: Automatically saves theme preference to localStorage (key: `theme`)
+- **Animated transition**: Smooth visual toggle animation between states
+- **Bundled SVG icons**: Pre-bundled light and dark mode icons (no external dependencies)
+- **Event emission**: Emits `change-theme` event with the selected theme value
+- **SSR compatible**: Works in both SPA and Server-Side Rendered (Nuxt 3) environments
+- **Lightweight**: Minimal footprint with CSS injected automatically
+- **Vue 3 Composition API**: Built with modern Vue 3 patterns using composables
+- **Tree-shake friendly**: Vue marked as external in library build
+- **TypeScript support**: Includes type definitions
+
+## Installation
+Using npm:
+```bash
+npm install @todovue/tv-theme-button
+```
+Using yarn:
+```bash
+yarn add @todovue/tv-theme-button
+```
+Using pnpm:
+```bash
+pnpm add @todovue/tv-theme-button
+```
+
+## Quick Start (SPA)
+### Import Styles
+You must explicitly import the component's stylesheet in your application:
+
+```ts
+// main.ts or main.js
+import { createApp } from 'vue'
+import App from './App.vue'
+
+// Import the component styles
+import { TvThemeButton } from '@todovue/tv-theme-button'
+import '@todovue/tv-theme-button/style.css' // Import styles
+
+const app = createApp(App)
+app.component('TvThemeButton', TvThemeButton)
+app.mount('#app')
+```
+
+### Global registration (main.js / main.ts):
+```js
+import { createApp } from 'vue'
+import App from './App.vue'
+import TvThemeButton from '@todovue/tv-theme-button'
+import '@todovue/tv-theme-button/style.css'
+
+createApp(App)
+  .use(TvThemeButton) // enables <TvThemeButton /> globally
+  .mount('#app')
+```
+
+## Nuxt 4 / SSR Usage
+### Import Styles in Nuxt Config
+Add the stylesheet to your `nuxt.config.ts`:
+
+```ts
+// nuxt.config.ts
+export default defineNuxtConfig({
+  modules: [
+    '@todovue/tv-theme-button/nuxt'
+  ]
+})
+```
+
+### Component Registration
+Create a plugin file: `plugins/tv-theme-button.client.ts` (client-only is recommended for localStorage access):
+```ts
+import { defineNuxtPlugin } from '#app'
+import TvThemeButton from '@todovue/tv-theme-button'
+
+export default defineNuxtPlugin(nuxtApp => {
+  nuxtApp.vueApp.use(TvThemeButton)
+})
+```
+
+Use anywhere in your app:
+```vue
+<template>
+  <TvThemeButton @change-theme="onThemeChange" />
+</template>
+
+<script setup>
+const onThemeChange = (theme) => {
+  console.log('Current theme:', theme)
+}
+</script>
+```
+
+### Optional direct import (no plugin):
+```vue
+<script setup>
+import { TvThemeButton } from '@todovue/tv-theme-button'
+</script>
+
+<template>
+  <TvThemeButton @change-theme="handleTheme" />
+</template>
+```
+
+## Component Registration Options
+| Approach                                                                     | When to use                                    |
+|------------------------------------------------------------------------------|------------------------------------------------|
+| Global via `app.use(TvThemeButton)`                                          | Many usages across app / design system install |
+| Local named import `{ TvThemeButton }`                                       | Isolated / code-split contexts                 |
+| Direct default import `import TvThemeButton from '@todovue/tv-theme-button'` | Single usage or manual registration            |
+
+## Props
+| Prop Name     | Type      | Default | Description                                                                                             |
+|---------------|-----------|---------|---------------------------------------------------------------------------------------------------------|
+| `darkIcon`    | `String`  | `null`  | Custom icon for dark mode. Accepts URL (http/https/data:), relative path (/path), or inline SVG string  |
+| `lightIcon`   | `String`  | `null`  | Custom icon for light mode. Accepts URL (http/https/data:), relative path (/path), or inline SVG string |
+| `buttonColor` | `String`  | `null`  | Custom background color for the switch button. Overrides the default theme background.                  |
+| `knobColor`   | `String`  | `null`  | Custom color for the sliding knob.                                                                      |
+| `sunColor`    | `String`  | `null`  | Custom color for the sun icon (light mode icon).                                                        |
+| `moonColor`   | `String`  | `null`  | Custom color for the moon icon (dark mode icon).                                                        |
+| `size`        | `String`  | `'md'`  | Size of the button. Options: `'sm'`, `'md'`, `'lg'`.                                                    |
+| `square`      | `Boolean` | `false` | If true, makes the button square instead of rounded.                                                    |
+
+### Icon Customization
+You can customize the theme icons in three ways:
+
+#### 1. Using Image URLs
+```vue
+<template>
+  <TvThemeButton 
+    dark-icon="https://example.com/moon-icon.png"
+    light-icon="https://example.com/sun-icon.png"
+    @change-theme="handleTheme"
+  />
+</template>
+```
+
+#### 2. Using Local Assets
+```vue
+<template>
+  <TvThemeButton 
+    dark-icon="/icons/moon.svg"
+    light-icon="/icons/sun.svg"
+    @change-theme="handleTheme"
+  />
+</template>
+```
+
+#### 3. Using Inline SVG
+```vue
+<template>
+  <TvThemeButton 
+    :dark-icon="darkSvg"
+    :light-icon="lightSvg"
+    @change-theme="handleTheme"
+  />
+</template>
+
+<script setup>
+const darkSvg = '<svg viewBox="0 0 24 24"><path d="M12 3v1m0 16v1m9-9h-1M4 12H3m15.364 6.364l-.707-.707M6.343 6.343l-.707-.707m12.728 0l-.707.707M6.343 17.657l-.707.707M16 12a4 4 0 11-8 0 4 4 0 018 0z"/></svg>'
+const lightSvg = '<svg viewBox="0 0 24 24"><path d="M20.354 15.354A9 9 0 018.646 3.646 9.003 9.003 0 0012 21a9.003 9.003 0 008.354-5.646z"/></svg>'
+</script>
+```
+
+> **Note:** If no custom icons are provided, the component uses built-in default icons.
+
+### Default Behavior
+- Initial theme is loaded from localStorage (key: `theme`)
+- Falls back to `'dark'` if no saved preference exists
+- Icons and animations are built-in
+
+## Events
+| Event name (kebab) | Emits (camel) | Payload Type        | Description                                                   |
+|--------------------|---------------|---------------------|---------------------------------------------------------------|
+| `change-theme`     | `changeTheme` | `'light' \| 'dark'` | Emitted when user toggles theme. Returns current theme value. |
+
+### Usage Example:
+```vue
+<template>
+  <TvThemeButton @change-theme="applyTheme" />
+</template>
+
+<script setup>
+const applyTheme = (theme) => {
+  // Option 1: Apply CSS class to document
+  document.documentElement.setAttribute('data-theme', theme)
+  
+  // Option 2: Update a Pinia/Vuex store
+  // useThemeStore().setTheme(theme)
+  
+  // Option 3: Update CSS variables
+  if (theme === 'dark') {
+    document.documentElement.style.setProperty('--bg-color', '#1a1a1a')
+    document.documentElement.style.setProperty('--text-color', '#ffffff')
+  } else {
+    document.documentElement.style.setProperty('--bg-color', '#ffffff')
+    document.documentElement.style.setProperty('--text-color', '#000000')
+  }
+}
+</script>
+```
+
+## Customization (Styles / Theming)
+The component comes with default styles that can be customized using CSS variables or by overriding the scoped styles.
+
+### CSS Variables Override:
+```css
+/* In your global CSS or component style */
+.tv-theme-button {
+  /* Customize the switch background */
+  --switch-bg: #e0e0e0;
+  --switch-active-bg: #333;
+  --switch-size: 60px;
+}
+
+.tv-theme-icon {
+  /* Customize icon colors */
+  --icon-color: currentColor;
+}
+```
+
+### Custom Styling:
+```vue
+<style>
+/* Override component styles */
+:deep(.tv-theme-switch) {
+  border-radius: 25px;
+  padding: 4px;
+  background: linear-gradient(to right, #667eea 0%, #764ba2 100%);
+}
+
+:deep(.tv-theme-icon) {
+  width: 24px;
+  height: 24px;
+}
+</style>
+```
+
+### Integration with Theme Systems:
+```vue
+<script setup>
+import { TvThemeButton } from '@todovue/tv-theme-button'
+import { useDark, useToggle } from '@vueuse/core'
+
+// Example with VueUse
+const isDark = useDark()
+
+const handleThemeChange = (theme) => {
+  isDark.value = theme === 'dark'
+}
+</script>
+
+<template>
+  <TvThemeButton @change-theme="handleThemeChange" />
+</template>
+```
+
+## Accessibility
+- **Keyboard accessible**: The toggle button can be activated via click (mouse/touch)
+- **Visual feedback**: Clear visual indication of current theme state
+- **Semantic HTML**: Uses proper div/span structure with click handlers
+
+### Recommended Improvements:
+For better accessibility, wrap the component or add context:
+```vue
+<div role="switch" :aria-checked="currentTheme === 'dark'" aria-label="Toggle dark mode">
+  <TvThemeButton @change-theme="currentTheme = $event" />
+</div>
+```
+
+## SSR Notes
+- **localStorage safe**: Component uses `onMounted` lifecycle hook to safely access localStorage only on client-side
+- **No hydration issues**: Initial state is set client-side, preventing SSR/CSR mismatches
+- **Vite compatible**: SVG icons are bundled via Vite's `import.meta.glob` (works in Vite + Nuxt)
+- **Auto CSS injection**: Styles are automatically injected when you import the library
+- **Client-side plugin recommended**: For Nuxt 3, use `.client.ts` suffix to ensure localStorage access
+
+### Preventing Flash of Unstyled Content (FOUC):
+```html
+<!-- Add to your app.vue or layout -->
+<script setup>
+onMounted(() => {
+  const theme = localStorage.getItem('theme') || 'dark'
+  document.documentElement.setAttribute('data-theme', theme)
+})
+</script>
+```
+
+## Roadmap
+| Feature                                      | Status      | Version |
+|----------------------------------------------|-------------|---------|
+| Add `defaultTheme` prop                      | Planned     | 1.1.0   |
+| Add `storageKey` prop                        | Planned     | 1.1.0   |
+| Custom icon slots/props                      | Planned     | 1.2.0   |
+| Add ARIA attributes internally               | Planned     | 1.2.0   |
+| CSS variables for easy theming               | Considering | 2.0.0   |
+| Animation customization options              | Considering | 2.0.0   |
+| Multiple theme support (not just light/dark) | Considering | 2.0.0   |
+| Expose composable `useThemeButton` publicly  | Considering | 2.0.0   |
+
+## Development
+Clone the repository and install dependencies:
+```bash
+git clone https://github.com/TODOvue/tv-theme-button.git
+cd tv-theme-button
+yarn install
+```
+
+### Available Scripts:
+```bash
+yarn dev          # Run development server with demo playground
+yarn build        # Build library for production
+yarn build:demo   # Build demo site for deployment
+```
+
+Local demo is served from Vite using `index.html` + `src/demo` examples.
+
+### Project Structure:
+```
+tv-theme-button/
+├── src/
+│   ├── components/
+│   │   └── TvThemeButton.vue    # Main component
+│   ├── composable/
+│   │   └── useThemeButton.js    # Composable logic
+│   ├── assets/
+│   │   ├── icons/
+│   │   │   ├── dark.svg         # Dark mode icon
+│   │   │   └── light.svg        # Light mode icon
+│   │   └── scss/                # Styles
+│   ├── entry.ts                  # Library entry point
+│   └── demo/                     # Demo playground
+├── dist/                         # Build output
+└── package.json
+```
+
+## Contributing
+We welcome contributions! Please see our contributing guidelines:
+- [CONTRIBUTING.md](https://github.com/TODOvue/tv-theme-button/blob/main/CONTRIBUTING.md)
+- [CODE_OF_CONDUCT.md](https://github.com/TODOvue/tv-theme-button/blob/main/CODE_OF_CONDUCT.md)
+
+### How to Contribute:
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## License
+MIT © TODOvue
+
+See [LICENSE](https://github.com/TODOvue/tv-theme-button/blob/main/LICENSE) for more information.
+
+## Changelog
+See [CHANGELOG.md](https://github.com/TODOvue/tv-theme-button/blob/main/CHANGELOG.md) for version history and release notes.
+
+### Attributions
+Crafted with ❤️ for the TODOvue component ecosystem

package/dist/demos/tv-toc/CHANGELOG.md

@@ -0,0 +1,80 @@
+# Changelog
+
+All notable changes to `@todovue/tv-toc` 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).
+
+## [1.1.1] - 2026-01-27
+
+### Changed
+- Simplified the file list in `package.json` to include only essential assets.
+- Simplified the build configuration by removing demo-specific logic.
+- Enhanced GitHub Actions workflows to automate npm package publishing and GitHub release creation.
+- Moved the `@todovue/tv-demo` component import from main.js to `Demo.vue` to localize its usage.
+- Updated build commands to include `README.md` and `CHANGELOG.md` files in the public directory during the build process.
+
+### Added
+- Included the `src` directory in the `package.json` files list to ensure component source files are bundled in the package distribution.
+
+### Removed
+- Eliminated the global import of the `@todovue/tv-demo` component from `main.js`.
+
+### Dependencies
+- Updated `@todovue/tv-demo` to `^1.4.11`.
+- Updated `vue` to `^3.5.27`.
+- Updated `sass` to `^1.97.3`.
+
+## [1.1.0] - 2026-01-20
+
+### Added
+- Introduced a customizable marker for Table of Contents (ToC) items to allow for personalized bullet styles or icons.
+- Added an active class property to ToC items, enabling specific styling for the currently viewed section to improve navigation clarity.
+- Added `observerOptions` prop to customize IntersectionObserver behavior (rootMargin, threshold).
+- Introduced a scroll progress indicator to the Table of Contents, providing a visual cue of the user's current position within the document.
+- Implemented collapsible sections in the Table of Contents, allowing users to toggle the visibility of subsections for a cleaner, more focused navigation experience.
+- Introduced animated active indicators to the Table of Contents, providing smooth transitions as the user scrolls through different sections.
+- Added customizable color properties for ToC elements, allowing for deeper integration with specific brand palettes.
+
+### Dependencies
+- Updated `@todovue/tv-demo` to `^1.4.4`.
+- Updated `sass` to `^1.97.2`.
+- Updated `vite` to `^7.3.1`.
+
+## [1.0.2] - 2025-12-27
+
+### Added
+- Added automatic publishing to the TODOvue cPanel in `release.yml` for each release, simplifying package distribution and updates.
+- Added `package-lock.json` to the repository to ensure dependency consistency and facilitate version management across development and production environments.
+
+### Changed
+- Changed the `base` option in `vite.config.js` for website deployment in cpanel.
+
+### Fixed
+- Fixed repository URL in `package.json` to point to the correct GitHub repository.
+- Fixed the token configuration used to generate the package in the GitHub Actions workflow `release.yml`.
+
+### Dependencies
+- Updated dependency versions in `package.json` to maintain compatibility and benefit from improvements and bug fixes in the used libraries.
+
+## [1.0.1] - 2025-11-28
+
+### Fixed
+- Correct CSS file extension for Table of Contents styles.
+
+## [1.0.0] - 2025-11-28
+
+### Added
+- Initial stable release of `@todovue/tv-toc`.
+- `TvToc` Vue 3 component to render a table of contents (TOC) from a `toc` object.
+- Support for nested sections via `children` links.
+- Smooth scrolling to headings using `scrollIntoView` and URL hash update with `history.pushState`.
+- `useToc` composable with `scrollToId` and `formatId` helpers.
+- Minimal default styles and BEM-like CSS classes for easy customization.
+- Vite demo with basic and blog-like TOC examples.
+
+[1.1.1]: https://github.com/TODOvue/tv-toc/pull/5/files
+[1.1.0]: https://github.com/TODOvue/tv-toc/pull/4/files
+[1.0.2]: https://github.com/TODOvue/tv-toc/pull/3/files
+[1.0.1]: https://github.com/TODOvue/tv-toc/pull/2/files
+[1.0.0]: https://github.com/TODOvue/tv-toc/pull/1/files