@visulima/vite-overlay 1.3.7 → 2.0.0-alpha.10

package/CHANGELOG.md

@@ -1,3 +1,172 @@
+## @visulima/vite-overlay [2.0.0-alpha.10](https://github.com/visulima/visulima/compare/@visulima/vite-overlay@2.0.0-alpha.9...@visulima/vite-overlay@2.0.0-alpha.10) (2026-03-26)
+
+### Features
+
+* **web:** auto-generate packages page from workspace metadata ([623e520](https://github.com/visulima/visulima/commit/623e5207693a7fe720f5f2f179593a3654c880e3))
+
+
+### Dependencies
+
+* **@visulima/error:** upgraded to 6.0.0-alpha.7
+* **@visulima/path:** upgraded to 3.0.0-alpha.7
+
+## @visulima/vite-overlay [2.0.0-alpha.9](https://github.com/visulima/visulima/compare/@visulima/vite-overlay@2.0.0-alpha.8...@visulima/vite-overlay@2.0.0-alpha.9) (2026-03-26)
+
+### Bug Fixes
+
+* **vite-overlay:** use workspace:* for internal [@visulima](https://github.com/visulima) deps ([cf5aedc](https://github.com/visulima/visulima/commit/cf5aedcc8621fedf4a1b4f39b574699292f85a5a))
+* **web:** improve build setup with incremental stats caching and prod install ([fe33e75](https://github.com/visulima/visulima/commit/fe33e75827586779b4b3a0c6d57b39f889ee6207))
+
+### Miscellaneous Chores
+
+* visulima website ([#591](https://github.com/visulima/visulima/issues/591)) ([59ab2e2](https://github.com/visulima/visulima/commit/59ab2e2befb03e51cd2088956f83d9b87de6d033))
+* **vite-overlay:** migrate deps to pnpm catalogs ([7553183](https://github.com/visulima/visulima/commit/7553183ae573d60405ab9f5227106eca8073f85c))
+* **vite-overlay:** update dependencies ([d93e9e0](https://github.com/visulima/visulima/commit/d93e9e06cc4563c9c9a087515b6701598057b2b3))
+
+### Code Refactoring
+
+* **vite-overlay:** replace vite-tsconfig-paths with native Vite 8 resolve.tsconfigPaths ([3d1e454](https://github.com/visulima/visulima/commit/3d1e454fd7d2e7178df2c795d50ad93927635a74))
+
+
+### Dependencies
+
+* **@visulima/error:** upgraded to 6.0.0-alpha.6
+* **@visulima/path:** upgraded to 3.0.0-alpha.6
+
+## @visulima/vite-overlay [2.0.0-alpha.8](https://github.com/visulima/visulima/compare/@visulima/vite-overlay@2.0.0-alpha.7...@visulima/vite-overlay@2.0.0-alpha.8) (2026-03-06)
+
+### Bug Fixes
+
+* **vite-overlay:** fix formatting and minor code style issues ([ec96733](https://github.com/visulima/visulima/commit/ec9673362fdf82ff4dacaf03aeb1c59250cd4eb0))
+* **vite-overlay:** replace rolldown-vite alias with vite@8 beta ([0596412](https://github.com/visulima/visulima/commit/0596412d437625183db5909d3b3ad1328293d8ef))
+* **vite-overlay:** resolve ESLint errors and expand braceless if statements ([f837bcd](https://github.com/visulima/visulima/commit/f837bcd2a1a743290b63e7471d843a953fd75b54))
+* **vite-overlay:** show balloon button alongside overlay for client errors ([6b9d8d4](https://github.com/visulima/visulima/commit/6b9d8d414ef1d21ab5ccee5f5a5aebb544d6f2c2))
+* **vite-overlay:** update packem to 2.0.0-alpha.54 ([73b70e3](https://github.com/visulima/visulima/commit/73b70e398cda6ee38aed18fa798bd2198b732024))
+
+### Miscellaneous Chores
+
+* **vite-overlay:** regenerate tanstack hydration example route tree ([11ceaa0](https://github.com/visulima/visulima/commit/11ceaa09ded9ff1223f99646b477b00ceeffea40))
+* **vite-overlay:** update dependencies ([53e7915](https://github.com/visulima/visulima/commit/53e7915ce97385edce947318aac47602bb11c905))
+* year update ([47f4105](https://github.com/visulima/visulima/commit/47f410596ce7190cfea36a073db32e0cec50bbcd))
+
+
+### Dependencies
+
+* **@visulima/error:** upgraded to 6.0.0-alpha.5
+* **@visulima/path:** upgraded to 3.0.0-alpha.5
+
+## @visulima/vite-overlay [2.0.0-alpha.7](https://github.com/visulima/visulima/compare/@visulima/vite-overlay@2.0.0-alpha.6...@visulima/vite-overlay@2.0.0-alpha.7) (2026-03-04)
+
+### Bug Fixes
+
+* added hint to the overlay back ([5df1227](https://github.com/visulima/visulima/commit/5df122779364090d10d60f440e61a595c7e1ee83))
+* **vite-overlay:** clear balloon on HMR update and fix pre-existing TS errors ([6904661](https://github.com/visulima/visulima/commit/69046610f5a5c36ba68539ecb7a088cb767922ca))
+* **vite-overlay:** explicitly override forms plugin background on editor select ([9614446](https://github.com/visulima/visulima/commit/96144461dd00fad5dad3dd1aa3976af1ec34a896)), closes [#fff](https://github.com/visulima/visulima/issues/fff) [select#editor-selector](https://github.com/visulima/select/issues/editor-selector)
+* **vite-overlay:** fix all ESLint errors and prevent e2e specs from running in vitest ([c212416](https://github.com/visulima/visulima/commit/c212416be37c7bbe2276e440401103146838b8e5))
+* **vite-overlay:** fix editor select chevron and options popup in dark/light mode ([69e3274](https://github.com/visulima/visulima/commit/69e327476990e4b37a300f6655bf73af0aba2060))
+* **vite-overlay:** fix syntheticError typo, blank line lint error, and rewrite corrupted docs ([a990844](https://github.com/visulima/visulima/commit/a99084491d19f07704488d10ab4930c5b7b779d0))
+* **vite-overlay:** resolve 10 runtime bugs in error overlay ([da43fcb](https://github.com/visulima/visulima/commit/da43fcb1eeec62e7855c3bcbc9f365613fa9001c))
+
+### Documentation
+
+* **vite-overlay:** fix incorrect BalloonConfig properties and add client API docs ([6f045cf](https://github.com/visulima/visulima/commit/6f045cf186dc9ca7552e3cd21ff959414ddf2b13))
+
+## @visulima/vite-overlay [2.0.0-alpha.6](https://github.com/visulima/visulima/compare/@visulima/vite-overlay@2.0.0-alpha.5...@visulima/vite-overlay@2.0.0-alpha.6) (2026-02-28)
+
+### Features
+
+* **dev-toolbar:** initialize dev-toolbar package  ([#586](https://github.com/visulima/visulima/issues/586)) ([a3ab9d6](https://github.com/visulima/visulima/commit/a3ab9d6e6c768853854b95fa8eee908b95235ea5))
+
+### Documentation
+
+* **error,error-handler,ono,inspector,source-map,vite-overlay:** add comprehensive Fumadocs documentation ([a0c8c92](https://github.com/visulima/visulima/commit/a0c8c92949cff2730fc6122f717fe344c030f366))
+
+### Miscellaneous Chores
+
+* **error-debugging:** update dependencies ([6002ece](https://github.com/visulima/visulima/commit/6002ece1803b2ba8261cff42a362dd6e8ddcc3ee))
+* update lock file maintenance ([d83e716](https://github.com/visulima/visulima/commit/d83e71697b75d24704185b66bb521a934d2db02d))
+
+## @visulima/vite-overlay [2.0.0-alpha.5](https://github.com/visulima/visulima/compare/@visulima/vite-overlay@2.0.0-alpha.4...@visulima/vite-overlay@2.0.0-alpha.5) (2026-01-17)
+
+### Miscellaneous Chores
+
+* **vite-overlay:** update dependencies ([622d520](https://github.com/visulima/visulima/commit/622d5209d4afefc082cbb9eb294d6aeee6f25bcb))
+
+
+### Dependencies
+
+* **@visulima/error:** upgraded to 6.0.0-alpha.4
+
+## @visulima/vite-overlay [2.0.0-alpha.4](https://github.com/visulima/visulima/compare/@visulima/vite-overlay@2.0.0-alpha.3...@visulima/vite-overlay@2.0.0-alpha.4) (2025-12-27)
+
+### Bug Fixes
+
+* **vite-overlay:** update package files ([fd8f5c1](https://github.com/visulima/visulima/commit/fd8f5c13f384d945f3597b00cfdfaf615e100de9))
+
+### Miscellaneous Chores
+
+* **dependencies:** update msw to version 2.12.6, jsdom to version 27.4.0, and [@tanstack](https://github.com/tanstack) packages to version 1.144.0 in package.json files ([1aa0236](https://github.com/visulima/visulima/commit/1aa0236e1f8190eecf7526cf2dc0f369cac02d87))
+* fixed project.json names and schema path ([964722f](https://github.com/visulima/visulima/commit/964722f691db205c7edb9aa6db29e849a647500b))
+
+### Code Refactoring
+
+* **overlay:** improve balloon count display with animation and update styles for consistency ([146c2a7](https://github.com/visulima/visulima/commit/146c2a77b96ce9c61f6ae2d3fb85990fc73eab6b))
+
+
+### Dependencies
+
+* **@visulima/error:** upgraded to 6.0.0-alpha.3
+* **@visulima/path:** upgraded to 3.0.0-alpha.4
+
+## @visulima/vite-overlay [2.0.0-alpha.3](https://github.com/visulima/visulima/compare/@visulima/vite-overlay@2.0.0-alpha.2...@visulima/vite-overlay@2.0.0-alpha.3) (2025-12-11)
+
+### Bug Fixes
+
+* update license information and add badges in README files ([340af5d](https://github.com/visulima/visulima/commit/340af5d227b3450a86da7861eeea5fee63ab4446))
+* update package OG images across multiple packages ([f08e4dd](https://github.com/visulima/visulima/commit/f08e4dd2b105ccb29c8412020a9c2be36d6c1e9e))
+
+### Miscellaneous Chores
+
+* update package dependencies and improve configuration ([4ed22d6](https://github.com/visulima/visulima/commit/4ed22d6511aa8150dcd4ba7b9dccf05dbe2d6adc))
+
+### Code Refactoring
+
+* improve stack trace viewer and resolve original location utilities ([c6ff5c8](https://github.com/visulima/visulima/commit/c6ff5c85714944f34cd3f758eb4fc1d16271f5b6))
+
+
+### Dependencies
+
+* **@visulima/error:** upgraded to 6.0.0-alpha.2
+* **@visulima/path:** upgraded to 3.0.0-alpha.3
+
+## @visulima/vite-overlay [2.0.0-alpha.2](https://github.com/visulima/visulima/compare/@visulima/vite-overlay@2.0.0-alpha.1...@visulima/vite-overlay@2.0.0-alpha.2) (2025-12-11)
+
+### Bug Fixes
+
+* update dependencies and improve error handling in error-debugging packages ([b95fea4](https://github.com/visulima/visulima/commit/b95fea4ef0e0a6777b3dd465603b1dd3c40aa4e8))
+
+## @visulima/vite-overlay [2.0.0-alpha.1](https://github.com/visulima/visulima/compare/@visulima/vite-overlay@1.3.7...@visulima/vite-overlay@2.0.0-alpha.1) (2025-12-07)
+
+### ⚠ BREAKING CHANGES
+
+* change min node version to 22.13
+
+### Bug Fixes
+
+* add new package image, fixed readme rendering on npm, fixed building of packages ([b790ba2](https://github.com/visulima/visulima/commit/b790ba253ea07fef83528fd822a678facf021b5f))
+* update Node.js engine version requirement to >=22.13 in multiple package.json files for improved compatibility ([b828e9a](https://github.com/visulima/visulima/commit/b828e9aeaebfc798eecddccd90e6ec7560c6d36a))
+
+### Miscellaneous Chores
+
+* moved all packages into groups ([0615e9d](https://github.com/visulima/visulima/commit/0615e9d14a8a886e11da529ce150cf31ca973c10))
+* update @anolilab/semantic-release-pnpm and @anolilab/semantic-release-preset to versions 3.2.2 and 12.1.2 across multiple package.json files for improved compatibility ([3921626](https://github.com/visulima/visulima/commit/3921626141fe5da398749bf0ba675f1596f18afb))
+* update dependencies across multiple packages to improve compatibility and performance, including upgrading `@anolilab/semantic-release-pnpm` and `@anolilab/semantic-release-preset` to versions 3.2.0 and 12.1.0 respectively, and updating `react`, `react-dom`, and `next` versions to 19.2.1 and 16.0.7 in various package.json files ([aee8fcd](https://github.com/visulima/visulima/commit/aee8fcd796ae9b8d055903260e7150996ea9f53d))
+
+
+### Dependencies
+
+* **@visulima/error:** upgraded to 6.0.0-alpha.1
+
 ## @visulima/vite-overlay [1.3.7](https://github.com/visulima/visulima/compare/@visulima/vite-overlay@1.3.6...@visulima/vite-overlay@1.3.7) (2025-11-13)
 
 ### Bug Fixes

package/LICENSE.md

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 visulima
+Copyright (c) 2026 visulima
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,15 +1,24 @@
-<div align="center">
-  <h3>Enhanced Error Overlay for Vite</h3>
-  <p>
-    A powerful development tool that provides rich error displays with source mapping, cause chain navigation, and intelligent solutions for Vite applications.
-  </p>
-</div>
+<!-- START_PACKAGE_OG_IMAGE_PLACEHOLDER -->
+
+<a href="https://www.anolilab.com/open-source" align="center">
+
+  <img src="__assets__/package-og.svg" alt="vite-overlay" />
+
+</a>
+
+<h3 align="center">Improved vite overlay</h3>
+
+<!-- END_PACKAGE_OG_IMAGE_PLACEHOLDER -->
 
 <br />
 
 <div align="center">
 
-[![typescript-image]][typescript-url] [![npm-image]][npm-url] [![license-image]][license-url]
+[![typescript-image][typescript-badge]][typescript-url]
+[![mit licence][license-badge]][license]
+[![npm downloads][npm-downloads-badge]][npm-downloads]
+[![Chat][chat-badge]][chat]
+[![PRs Welcome][prs-welcome-badge]][prs-welcome]
 
 </div>
 
@@ -25,9 +34,9 @@
 
 ---
 
-| Light Mode                       | Dark Mode                      | Solution Mode                         |
-| -------------------------------- | ------------------------------ | ------------------------------------- |
-| ![light](./__assets__/light.png) | ![dark](./__assets__/dark.png) | ![light](./__assets__/light-hint.png) |
+| Light Mode                       | Dark Mode                      | Solution Mode                   |
+| -------------------------------- | ------------------------------ | ------------------------------- |
+| ![light](./__assets__/light.jpg) | ![dark](./__assets__/dark.jpg) | ![light](./__assets__/hint.jpg) |
 
 ## Features
 
@@ -93,6 +102,30 @@ export default defineConfig({
             // Whether to show the balloon button in the overlay (default: true)
             showBallonButton: true,
 
+            // Overlay configuration (optional)
+            overlay: {
+                // Balloon button configuration
+                balloon: {
+                    enabled: true,
+                    position: "bottom-right", // "top-left" | "top-right" | "bottom-left" | "bottom-right"
+                    icon: "", // Optional custom icon URL
+                    // Style can be a string or CSS.Properties object
+                    style: {
+                        background: "#ff4628",
+                        color: "#ffffff",
+                    },
+                    // Or as a string:
+                    // style: "background: #ff4628; color: #ffffff;",
+                },
+                // Custom CSS to inject for styling customization
+                // Can be a string or CSS.Properties object
+                customCSS: `
+                    #__v_o__balloon {
+                        border-radius: 20px;
+                    }
+                `,
+            },
+
             // Custom solution finder functions (optional)
             solutionFinders: [],
 
@@ -105,15 +138,19 @@ export default defineConfig({
 
 #### Options
 
-| Option                    | Type               | Default     | Description                                                              |
-| ------------------------- | ------------------ | ----------- | ------------------------------------------------------------------------ |
-| `forwardConsole`          | `boolean`          | `true`      | Enable/disable client-side runtime error logging and overlay display     |
-| `forwardedConsoleMethods` | `string[]`         | `["error"]` | Array of console method names to intercept and forward to overlay        |
-| `reactPluginName`         | `string`           | `undefined` | Custom React plugin name for detection (useful for custom React plugins) |
-| `vuePluginName`           | `string`           | `undefined` | Custom Vue plugin name for detection (useful for custom Vue plugins)     |
-| `showBallonButton`        | `boolean`          | `true`      | Whether to show the floating balloon button for error navigation         |
-| `solutionFinders`         | `SolutionFinder[]` | `[]`        | Array of custom solution finder functions for enhanced error analysis    |
-| `logClientRuntimeError`   | `boolean`          | `undefined` | **@deprecated** Use `forwardConsole` instead                             |
+| Option                    | Type                       | Default     | Description                                                                      |
+| ------------------------- | -------------------------- | ----------- | -------------------------------------------------------------------------------- |
+| `forwardConsole`          | `boolean`                  | `true`      | Enable/disable client-side runtime error logging and overlay display             |
+| `forwardedConsoleMethods` | `string[]`                 | `["error"]` | Array of console method names to intercept and forward to overlay                |
+| `reactPluginName`         | `string`                   | `undefined` | Custom React plugin name for detection (useful for custom React plugins)         |
+| `vuePluginName`           | `string`                   | `undefined` | Custom Vue plugin name for detection (useful for custom Vue plugins)             |
+| `showBallonButton`        | `boolean`                  | `true`      | Whether to show the floating balloon button for error navigation                 |
+| `overlay`                 | `OverlayConfig`            | `undefined` | Overlay configuration options                                                    |
+| `overlay.balloon`         | `BalloonConfig`            | `undefined` | Balloon button configuration                                                     |
+| `overlay.balloon.style`   | `string \| CSS.Properties` | `undefined` | Balloon button styles (string or CSS.Properties object)                          |
+| `overlay.customCSS`       | `string \| CSS.Properties` | `undefined` | Custom CSS to inject for styling customization (string or CSS.Properties object) |
+| `solutionFinders`         | `SolutionFinder[]`         | `[]`        | Array of custom solution finder functions for enhanced error analysis            |
+| `logClientRuntimeError`   | `boolean`                  | `undefined` | **@deprecated** Use `forwardConsole` instead                                     |
 
 ## Error Handling
 
@@ -253,6 +290,133 @@ The error overlay uses a custom design system with CSS custom properties:
 --ono-v-text: #c9d1d9;
 ```
 
+### Custom CSS Injection
+
+You can inject custom CSS to override the default styles of the overlay and button elements. The `overlay.customCSS` option accepts a CSS string (recommended) or a `CSS.Properties` object:
+
+```typescript
+export default defineConfig({
+    plugins: [
+        errorOverlay({
+            overlay: {
+                customCSS: `
+                    /* Customize the balloon button */
+                    #__v_o__balloon {
+                        border-radius: 20px;
+                        box-shadow: 0 4px 12px rgba(0, 0, 0, 0.3);
+                    }
+
+                    /* Customize the overlay panel */
+                    #__v_o__panel {
+                        border-radius: 12px;
+                    }
+
+                    /* Customize the backdrop */
+                    #__v_o__backdrop {
+                        background-color: rgba(0, 0, 0, 0.7);
+                    }
+                `,
+            },
+        }),
+    ],
+});
+```
+
+**Note:** For `customCSS`, using a CSS string is recommended since you need CSS selectors. `CSS.Properties` objects are mainly useful for inline styles (like `balloon.style`).
+
+### Balloon Button Styling
+
+The `balloon.style` option supports both string and `CSS.Properties` object. Using `CSS.Properties` provides type safety and autocomplete:
+
+```typescript
+import type * as CSS from "csstype";
+
+export default defineConfig({
+    plugins: [
+        errorOverlay({
+            overlay: {
+                balloon: {
+                    // Using CSS.Properties object (type-safe with autocomplete)
+                    style: {
+                        background: "#ff4628",
+                        color: "#ffffff",
+                        borderRadius: "20px",
+                    } as CSS.Properties,
+                    // Or using a string:
+                    // style: "background: #ff4628; color: #ffffff; border-radius: 20px;",
+                },
+            },
+        }),
+    ],
+});
+```
+
+**Note:** When using `CSS.Properties`, property names should be in camelCase (e.g., `borderRadius`), and they will be automatically converted to kebab-case CSS properties (e.g., `border-radius`) when applied.
+
+#### Available Element IDs for Customization
+
+The following element IDs can be targeted in your custom CSS:
+
+**Main Overlay Elements:**
+
+- `__v_o__root` - Root container element
+- `__v_o__backdrop` - Backdrop element behind the overlay
+- `__v_o__notch` - Notch container at the top of the overlay
+- `__v_o__panel` - Main panel container
+- `__v_o__overlay` - Overlay content container
+
+**Navigation & Pagination:**
+
+- `__v_o__error-overlay-pagination-previous` - Previous error button
+- `__v_o__error-overlay-pagination-next` - Next error button
+- `__v_o__error-overlay_pagination_count` - Pagination count container
+- `__v_o__pagination_current` - Current page number display
+- `__v_o__pagination_total` - Total page number display
+
+**History:**
+
+- `__v_o__history_toggle` - History toggle button
+- `__v_o__history_indicator` - History indicator container
+- `__v_o__history_count` - History count display
+- `__v_o__history_total` - History total display
+- `__v_o__history_timestamp` - History timestamp display
+- `__v_o__history_layer_depth` - History layer depth container
+- `__v_o__history_layer_depth_1` - History layer depth level 1
+- `__v_o__history_layer_depth_2` - History layer depth level 2
+
+**Header Elements:**
+
+- `__v_o__header` - Header container
+- `__v_o__header_loader` - Header loader skeleton
+- `__v_o__title` - Title container
+- `__v_o__heading` - Error heading/name
+- `__v_o__filelink` - File link button
+- `__v_o__mode` - Mode switch container (original/compiled)
+- `__v_o__copy_error` - Copy error button
+- `__v_o__close` - Close button
+
+**Balloon Button:**
+
+- `__v_o__balloon` - Floating balloon button
+- `__v_o__balloon_count` - Error count badge in balloon
+- `__v_o__balloon_text` - Text label in balloon
+
+**Message & Content:**
+
+- `__v_o__message_loader` - Message loader skeleton
+- `__v_o__message` - Error message container
+- `__v_o__body` - Body container
+- `__v_o__body_loader` - Body loader skeleton
+- `__v_o__solutions` - Solutions container
+- `__v_o__solutions_container` - Solutions content container
+- `__v_o__stacktrace` - Stack trace details element
+
+**Other:**
+
+- `__v_o__editor` - Editor selector container
+- `editor-selector` - Editor selector dropdown
+- `v-o-theme-switch` - Theme switch container
+
 ## Browser Support
 
 The error overlay is designed to work in all modern browsers with at least 1% global market share. This includes:
@@ -303,13 +467,23 @@ pnpm install
 - [Daniel Bannert](https://github.com/prisis)
 - [All Contributors](https://github.com/visulima/visulima/graphs/contributors)
 
+## Made with ❤️ at Anolilab
+
+This is an open source project and will always remain free to use. If you think it's cool, please star it 🌟. [Anolilab](https://www.anolilab.com/open-source) is a Development and AI Studio. Contact us at [hello@anolilab.com](mailto:hello@anolilab.com) if you need any help with these technologies or just want to say hi!
+
 ## License
 
-This project is licensed under the MIT License - see the [MIT][license-url] file for details.
+The visulima vite-overlay is open-sourced software licensed under the [MIT][license]
+
+<!-- badges -->
 
-[typescript-image]: https://img.shields.io/badge/Typescript-294E80.svg?style=for-the-badge&logo=typescript
-[typescript-url]: https://www.typescriptlang.org/ "TypeScript"
-[license-image]: https://img.shields.io/npm/l/@visulima/vite-overlay?color=blueviolet&style=for-the-badge
-[license-url]: LICENSE.md "license"
-[npm-image]: https://img.shields.io/npm/v/@visulima/vite-overlay/latest.svg?style=for-the-badge&logo=npm
-[npm-url]: https://www.npmjs.com/package/@visulima/vite-overlay/v/latest "npm"
+[license-badge]: https://img.shields.io/npm/l/@visulima/vite-overlay?style=for-the-badge
+[license]: https://github.com/visulima/visulima/blob/main/LICENSE
+[npm-downloads-badge]: https://img.shields.io/npm/dm/@visulima/vite-overlay?style=for-the-badge
+[npm-downloads]: https://www.npmjs.com/package/@visulima/vite-overlay
+[prs-welcome-badge]: https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=for-the-badge
+[prs-welcome]: https://github.com/visulima/visulima/blob/main/.github/CONTRIBUTING.md
+[chat-badge]: https://img.shields.io/discord/932323359193186354.svg?style=for-the-badge
+[chat]: https://discord.gg/TtFJY8xkFK
+[typescript-badge]: https://img.shields.io/badge/Typescript-294E80.svg?style=for-the-badge&logo=typescript
+[typescript-url]: https://www.typescriptlang.org/

package/dist/index.d.ts

@@ -1,29 +1,27 @@
-import type { SolutionFinder } from "@visulima/error/solution";
-import type { Plugin } from "vite";
-/**
- * Main Vite plugin for error overlay functionality.
- * Intercepts runtime errors and displays them in a user-friendly overlay.
- * @param options Plugin configuration options
- * @param options.forwardConsole Whether to log client runtime errors (optional)
- * @param options.forwardedConsoleMethods Array of console method names to forward (optional)
- * @param [options.logClientRuntimeError] [deprecated] Use forwardConsole instead
- * @param options.reactPluginName Custom React plugin name (optional)
- * @param options.solutionFinders Custom solution finders (optional)
- * @param options.vuePluginName Custom Vue plugin name (optional)
- * @param options.showBallonButton Whether to show the balloon button (optional)
- * @returns The Vite plugin configuration
- */
+import { SolutionFinder } from '@visulima/error/solution';
+import { Plugin } from 'vite';
+import '@visulima/error/error';
+import { Properties } from 'csstype';
+type BalloonPosition = "top-left" | "top-right" | "bottom-left" | "bottom-right";
+type BalloonStyle = string | Properties;
+interface BalloonConfig {
+  readonly enabled?: boolean;
+  readonly icon?: string;
+  readonly position?: BalloonPosition;
+  readonly style?: BalloonStyle;
+}
+interface OverlayConfig {
+  readonly balloon?: BalloonConfig;
+  readonly customCSS?: string | Properties;
+}
 declare const errorOverlayPlugin: (options?: {
-    forwardConsole?: boolean;
-    forwardedConsoleMethods?: string[];
-    logClientRuntimeError?: boolean;
-    reactPluginName?: string;
-    showBallonButton?: boolean;
-    solutionFinders?: SolutionFinder[];
-    vuePluginName?: string;
+  forwardConsole?: boolean;
+  forwardedConsoleMethods?: string[];
+  logClientRuntimeError?: boolean;
+  overlay?: OverlayConfig;
+  reactPluginName?: string;
+  showBallonButton?: boolean;
+  solutionFinders?: SolutionFinder[];
+  vuePluginName?: string;
 }) => Plugin;
-/**
- * Default export of the Vite error overlay plugin.
- * Use this plugin to enable error overlay functionality in your Vite project.
- */
-export default errorOverlayPlugin;
+export { errorOverlayPlugin as default };