{children}
+export const PageContainer = ({ children, className }: PageContainerProps) => (
+ {children}
);
diff --git a/docs/v2/src/components/index.mdx b/docs/v2/src/components/index.mdx
new file mode 100644
index 0000000..abc0310
--- /dev/null
+++ b/docs/v2/src/components/index.mdx
@@ -0,0 +1,448 @@
+
+> OverlayScrollbars is a javascript scrollbar plugin that hides native scrollbars, provides custom styleable overlay scrollbars and keeps the native functionality and feeling.
+
+## Why
+
+I created this plugin because I hate ugly and space consuming scrollbars. Similar plugins haven't met my requirements in terms of features, quality, simplicity, license or browser support.
+
+## Goals & Features
+
+ - Simple, powerful and good documented API
+ - High browser compatibility - Firefox, Chrome, Opera, Edge, Safari 10+ and IE 11
+ - Can be run on the server - SSR, SSG and ISR support
+ - Tested on various devices - Mobile, Desktop and Tablet
+ - Tested with various (and mixed) inputs - Mouse, touch and pen
+ - Treeshaking - bundle only what you really need
+ - Automatic update detection - no polling
+ - Usage of latest browser features - best performance in new browsers
+ - Bidirectional - LTR or RTL direction support
+ - Simple and effective scrollbar styling
+ - Highly customizable
+ - TypeScript support - fully written in TypeScript
+ - Dependency free - 100% self written to ensure small size and best functionality
+
+## Getting started
+
+#### npm & Node
+OverlayScrollbars can be downloaded from [npm](https://www.npmjs.com/package/overlayscrollbars) or the package manager of your choice:
+```sh
+npm install overlayscrollbars
+```
+After installation it can be imported:
+```js
+import 'overlayscrollbars/overlayscrollbars.css';
+import { OverlayScrollbars } from 'overlayscrollbars';
+```
+
+
+
+
+
+
+You can use OverlayScrollbars without any bundler or package manager.
+Simply download it from the [Releases](https://github.com/KingSora/OverlayScrollbars/releases) or use a [CDN](https://cdnjs.com/libraries/overlayscrollbars).
+
+- Use the javascript files with the `.browser` extension.
+- If you target old browsers use the `.es5` javascript file, for new browsers `.es6`.
+- For production use the javascript / stylesheet files with the `.min` extension.
+
+Embedd OverlayScrollbars manually in your HTML:
+```html
+
+
+```
+
+
+
+## Initialization
+
+> __Note__: During initialization its expected that the CSS file is loaded and parsed by the browser.
+
+You can initialize either directly with an `Element` or with an `Object` where you have more control over the initialization process.
+
+```js
+// simple initialization with an element
+const osInstance = OverlayScrollbars(document.querySelector('#myElement'), {});
+```
+
+### Bridging initialization flickering
+
+If you initialize OverlayScrollbars it needs a few milliseconds to create and append all the elements to the DOM.
+While this period the native scrollbars are still visible and are switched out after the initialization is finished. This is perceived as flickering.
+
+
+ Manual download & embedding
+
+
+You can use OverlayScrollbars without any bundler or package manager.
+Simply download it from the [Releases](https://github.com/KingSora/OverlayScrollbars/releases) or use a [CDN](https://cdnjs.com/libraries/overlayscrollbars).
+
+- Use the javascript files with the `.browser` extension.
+- If you target old browsers use the `.es5` javascript file, for new browsers `.es6`.
+- For production use the javascript / stylesheet files with the `.min` extension.
+
+Embedd OverlayScrollbars manually in your HTML:
+```html
+
+
+```
+
+
+
+
+> __Note__: For now please refer to the TypeScript definitions for a more detailed description of all possibilities.
+
+The only required field is the `target` field. This is the field to which the plugin is applied to.
+If you use the object initialization only with the `target` field, the outcome is equivalent to the element initialization:
+```js
+// Both initializations have the same outcome
+
+OverlayScrollbars(document.querySelector('#myElement'), {});
+OverlayScrollbars({ target: document.querySelector('#myElement') }, {});
+```
+
+In the initialization object you can specify how the library is handling generated elements.
+For example you can appoint an existing element as the `viewport` element. Like this the library won't generate it but take the specified element instead:
+
+ ```js
+OverlayScrollbars({
+ target: document.querySelector('#target'),
+ elements: {
+ viewport: document.querySelector('#viewport'),
+ },
+}, {});
+```
+
+This is very useful if you have a fixed DOM structure and don't want OverlayScrollbars to generate its own elements. Those cases arise very often when you want an other library to work together with OverlayScrollbars.
+
+---
+
+You can also decide to which element the scrollbars should be applied to:
+
+ ```js
+OverlayScrollbars({
+ target: document.querySelector('#target'),
+ scrollbars: {
+ slot: document.querySelector('#target').parentElement,
+ },
+}, {});
+```
+
+---
+
+And last but not least you can decide when the initialization should be canceled:
+ ```js
+OverlayScrollbars({
+ target: document.querySelector('#target'),
+ cancel: {
+ nativeScrollbarsOverlaid: true,
+ body: null,
+ }
+}, {});
+```
+
+In the above example the initialization is canceled when the native scrollbars are overlaid or when your target is a `body` element and the plugin determined that a initialization to the `body` element would affect native functionality like `window.scrollTo`.
+
+
+
+## Options
+
+You can initialize OverlayScrollbars with an initial set of options, which can be changed at any time with the `options` method:
+```js
+OverlayScrollbars(document.querySelector('#myElement'), {
+ overflow: {
+ x: 'hidden',
+ },
+});
+```
+
+
+ Initialization with an Object
+
+
+> __Note__: For now please refer to the TypeScript definitions for a more detailed description of all possibilities.
+
+The only required field is the `target` field. This is the field to which the plugin is applied to.
+If you use the object initialization only with the `target` field, the outcome is equivalent to the element initialization:
+```js
+// Both initializations have the same outcome
+
+OverlayScrollbars(document.querySelector('#myElement'), {});
+OverlayScrollbars({ target: document.querySelector('#myElement') }, {});
+```
+
+In the initialization object you can specify how the library is handling generated elements.
+For example you can appoint an existing element as the `viewport` element. Like this the library won't generate it but take the specified element instead:
+
+ ```js
+OverlayScrollbars({
+ target: document.querySelector('#target'),
+ elements: {
+ viewport: document.querySelector('#viewport'),
+ },
+}, {});
+```
+
+This is very useful if you have a fixed DOM structure and don't want OverlayScrollbars to generate its own elements. Those cases arise very often when you want an other library to work together with OverlayScrollbars.
+
+---
+
+You can also decide to which element the scrollbars should be applied to:
+
+ ```js
+OverlayScrollbars({
+ target: document.querySelector('#target'),
+ scrollbars: {
+ slot: document.querySelector('#target').parentElement,
+ },
+}, {});
+```
+
+---
+
+And last but not least you can decide when the initialization should be canceled:
+ ```js
+OverlayScrollbars({
+ target: document.querySelector('#target'),
+ cancel: {
+ nativeScrollbarsOverlaid: true,
+ body: null,
+ }
+}, {});
+```
+
+In the above example the initialization is canceled when the native scrollbars are overlaid or when your target is a `body` element and the plugin determined that a initialization to the `body` element would affect native functionality like `window.scrollTo`.
+
+
+
+
+
+The default options are:
+```js
+const defaultOptions = {
+ paddingAbsolute: false,
+ showNativeOverlaidScrollbars: false,
+ update: {
+ elementEvents: [['img', 'load']],
+ debounce: [0, 33],
+ attributes: null,
+ ignoreMutation: null,
+ },
+ overflow: {
+ x: 'scroll',
+ y: 'scroll',
+ },
+ scrollbars: {
+ theme: 'os-theme-dark',
+ visibility: 'auto',
+ autoHide: 'never',
+ autoHideDelay: 1300,
+ dragScroll: true,
+ clickScroll: false,
+ pointers: ['mouse', 'touch', 'pen'],
+ },
+};
+```
+
+### `paddingAbsolute`
+
+| type | default |
+| :--- | :--- |
+| `boolean` | `false` |
+
+Indicates whether the padding for the content shall be absolute.
+
+### `showNativeOverlaidScrollbars`
+
+| type | default |
+| :--- | :--- |
+| `boolean` | `false` |
+
+Indicates whether the native overlaid scrollbars shall be visible.
+
+### `update.elementEvents`
+
+| type | default |
+| :--- | :--- |
+| `Array<[string, string]> \| null` | `[['img', 'load']]` |
+
+An array of tuples. The first value in the tuple is an `selector` and the second value are `event names`. The plugin will update itself if any of the elements with the specified selector will emit any specified event. The default value can be interpreted as "The plugin will update itself if any `img` element emits an `load` event."
+
+### `update.debounce`
+
+| type | default |
+| :--- | :--- |
+| `[number, number] \| number \| null` | `[0, 33]` |
+
+> __Note__: If 0 is used for the timeout, `requestAnimationFrame` instead of `setTimeout` is used for the debounce.
+
+Debounces the `MutationObserver` which tracks changes to the content. If a **tuple** is passed, the first value is the timeout and second is the max wait. If only a **number** is passed you specify only the timeout and there is no max wait. With **null** there is no debounce. **Usefull to fine-tune performance.**
+
+### `update.attributes`
+
+| type | default |
+| :--- | :--- |
+| `string[] \| null` | `null` |
+
+> __Note__: There is a base array of attributes that the `MutationObserver` always observes, even if this option is `null`.
+
+An array of additional attributes that the `MutationObserver` should observe for the content.
+
+### `update.ignoreMutation`
+
+| type | default |
+| :--- | :--- |
+| `((mutation) => any) \| null` | `null` |
+
+A function which receives a [`MutationRecord`](https://developer.mozilla.org/en-US/docs/Web/API/MutationRecord) as an argument. If the function returns a truthy value the mutation will be ignored and the plugin won't update. **Usefull to fine-tune performance.**
+
+### `overflow.x`
+
+| type | default |
+| :--- | :--- |
+| `string` | `'scroll'` |
+
+> __Note__: Valid values are: `'hidden'`, `'scroll'`, `'visible'`, `'visible-hidden'` and `'visible-scroll'`.
+
+The overflow behavior for the horizontal (x) axis.
+
+### `overflow.y`
+
+| type | default |
+| :--- | :--- |
+| `string` | `'scroll'` |
+
+> __Note__: Valid values are: `'hidden'`, `'scroll'`, `'visible'`, `'visible-hidden'` and `'visible-scroll'`.
+
+The overflow behavior for the vertical (y) axis.
+
+### `scrollbars.theme`
+
+| type | default |
+| :--- | :--- |
+| `string \| null` | `'os-theme-dark'` |
+
+Applies the specified theme (classname) to the scrollbars.
+
+### `scrollbars.visibility`
+
+| type | default |
+| :--- | :--- |
+| `string` | `'auto'` |
+
+> __Note__: Valid values are: `'visible'`, `'hidden'`, and `'auto'`.
+
+The base visibility of the scrollbars.
+
+### `scrollbars.autoHide`
+
+| type | default |
+| :--- | :--- |
+| `string` | `'never'` |
+
+> __Note__: Valid values are: `'never'`, `'scroll'`, `'leave'` and `'move'`.
+
+The possibility to hide visible scrollbars automatically after a certain user action.
+
+### `scrollbars.autoHideDelay`
+
+| type | default |
+| :--- | :--- |
+| `number` | `1300` |
+
+The delay in milliseconds before the scrollbars are hidden automatically.
+
+### `scrollbars.dragScroll`
+
+| type | default |
+| :--- | :--- |
+| `boolean` | `true` |
+
+Indicates whether you can drag the scrollbar handles for scrolling.
+
+### `scrollbars.clickScroll`
+
+| type | default |
+| :--- | :--- |
+| `boolean` | `false` |
+
+Indicates whether you can click on the scrollbar track for scrolling.
+
+### `scrollbars.pointers`
+
+| type | default |
+| :--- | :--- |
+| `string[] \| null` | `['mouse', 'touch', 'pen']` |
+
+The [`PointerTypes`](https://developer.mozilla.org/en-US/docs/Web/API/PointerEvent/pointerType) the plugin should react to.
+
+
+
+## Events
+
+You can initialize OverlayScrollbars with an initial set of events, which can be managed at any time with the `on` and `off` methods:
+```js
+OverlayScrollbars(document.querySelector('#myElement'), {}, {
+ updated(osInstance, onUpdatedArgs) {
+ // ...
+ }
+});
+```
+
+
+ Options in depth
+
+
+The default options are:
+```js
+const defaultOptions = {
+ paddingAbsolute: false,
+ showNativeOverlaidScrollbars: false,
+ update: {
+ elementEvents: [['img', 'load']],
+ debounce: [0, 33],
+ attributes: null,
+ ignoreMutation: null,
+ },
+ overflow: {
+ x: 'scroll',
+ y: 'scroll',
+ },
+ scrollbars: {
+ theme: 'os-theme-dark',
+ visibility: 'auto',
+ autoHide: 'never',
+ autoHideDelay: 1300,
+ dragScroll: true,
+ clickScroll: false,
+ pointers: ['mouse', 'touch', 'pen'],
+ },
+};
+```
+
+### `paddingAbsolute`
+
+| type | default |
+| :--- | :--- |
+| `boolean` | `false` |
+
+Indicates whether the padding for the content shall be absolute.
+
+### `showNativeOverlaidScrollbars`
+
+| type | default |
+| :--- | :--- |
+| `boolean` | `false` |
+
+Indicates whether the native overlaid scrollbars shall be visible.
+
+### `update.elementEvents`
+
+| type | default |
+| :--- | :--- |
+| `Array<[string, string]> \| null` | `[['img', 'load']]` |
+
+An array of tuples. The first value in the tuple is an `selector` and the second value are `event names`. The plugin will update itself if any of the elements with the specified selector will emit any specified event. The default value can be interpreted as "The plugin will update itself if any `img` element emits an `load` event."
+
+### `update.debounce`
+
+| type | default |
+| :--- | :--- |
+| `[number, number] \| number \| null` | `[0, 33]` |
+
+> __Note__: If 0 is used for the timeout, `requestAnimationFrame` instead of `setTimeout` is used for the debounce.
+
+Debounces the `MutationObserver` which tracks changes to the content. If a **tuple** is passed, the first value is the timeout and second is the max wait. If only a **number** is passed you specify only the timeout and there is no max wait. With **null** there is no debounce. **Usefull to fine-tune performance.**
+
+### `update.attributes`
+
+| type | default |
+| :--- | :--- |
+| `string[] \| null` | `null` |
+
+> __Note__: There is a base array of attributes that the `MutationObserver` always observes, even if this option is `null`.
+
+An array of additional attributes that the `MutationObserver` should observe for the content.
+
+### `update.ignoreMutation`
+
+| type | default |
+| :--- | :--- |
+| `((mutation) => any) \| null` | `null` |
+
+A function which receives a [`MutationRecord`](https://developer.mozilla.org/en-US/docs/Web/API/MutationRecord) as an argument. If the function returns a truthy value the mutation will be ignored and the plugin won't update. **Usefull to fine-tune performance.**
+
+### `overflow.x`
+
+| type | default |
+| :--- | :--- |
+| `string` | `'scroll'` |
+
+> __Note__: Valid values are: `'hidden'`, `'scroll'`, `'visible'`, `'visible-hidden'` and `'visible-scroll'`.
+
+The overflow behavior for the horizontal (x) axis.
+
+### `overflow.y`
+
+| type | default |
+| :--- | :--- |
+| `string` | `'scroll'` |
+
+> __Note__: Valid values are: `'hidden'`, `'scroll'`, `'visible'`, `'visible-hidden'` and `'visible-scroll'`.
+
+The overflow behavior for the vertical (y) axis.
+
+### `scrollbars.theme`
+
+| type | default |
+| :--- | :--- |
+| `string \| null` | `'os-theme-dark'` |
+
+Applies the specified theme (classname) to the scrollbars.
+
+### `scrollbars.visibility`
+
+| type | default |
+| :--- | :--- |
+| `string` | `'auto'` |
+
+> __Note__: Valid values are: `'visible'`, `'hidden'`, and `'auto'`.
+
+The base visibility of the scrollbars.
+
+### `scrollbars.autoHide`
+
+| type | default |
+| :--- | :--- |
+| `string` | `'never'` |
+
+> __Note__: Valid values are: `'never'`, `'scroll'`, `'leave'` and `'move'`.
+
+The possibility to hide visible scrollbars automatically after a certain user action.
+
+### `scrollbars.autoHideDelay`
+
+| type | default |
+| :--- | :--- |
+| `number` | `1300` |
+
+The delay in milliseconds before the scrollbars are hidden automatically.
+
+### `scrollbars.dragScroll`
+
+| type | default |
+| :--- | :--- |
+| `boolean` | `true` |
+
+Indicates whether you can drag the scrollbar handles for scrolling.
+
+### `scrollbars.clickScroll`
+
+| type | default |
+| :--- | :--- |
+| `boolean` | `false` |
+
+Indicates whether you can click on the scrollbar track for scrolling.
+
+### `scrollbars.pointers`
+
+| type | default |
+| :--- | :--- |
+| `string[] \| null` | `['mouse', 'touch', 'pen']` |
+
+The [`PointerTypes`](https://developer.mozilla.org/en-US/docs/Web/API/PointerEvent/pointerType) the plugin should react to.
+
+
+
+
+
+> __Note__: Every event receives the `instance` from which it was fired as the first argument. Always.
+
+### `initialized`
+
+| arguments | description |
+| :--- | :--- |
+| `instance` | The instance which fired the event. |
+
+Is fired after all generated elements, observers and events were appended to the DOM.
+
+### `updated`
+
+| arguments | description |
+| :--- | :--- |
+| `instance` | The instance which fired the event. |
+| `onUpdatedArgs` | An `object` which describes the update in detail. |
+
+> __Note__: If an update was triggered but nothing changed, the event won't be fired.
+
+Is fired after the instace was updated.
+
+### `destroyed`
+
+| arguments | description |
+| :--- | :--- |
+| `instance` | The instance which fired the event. |
+| `canceled` | An `boolean` which indicates whether the initialization was canceled and thus destroyed. |
+
+Is fired after all generated elements, observers and events were removed from the DOM.
+
+
+
+## Instance Methods
+
+> __Note__: For now please refer to the TypeScript definitions for a more detailed description.
+
+```ts
+interface OverlayScrollbars {
+ options(): Options;
+ options(newOptions: DeepPartial
+ Events in depth
+
+
+> __Note__: Every event receives the `instance` from which it was fired as the first argument. Always.
+
+### `initialized`
+
+| arguments | description |
+| :--- | :--- |
+| `instance` | The instance which fired the event. |
+
+Is fired after all generated elements, observers and events were appended to the DOM.
+
+### `updated`
+
+| arguments | description |
+| :--- | :--- |
+| `instance` | The instance which fired the event. |
+| `onUpdatedArgs` | An `object` which describes the update in detail. |
+
+> __Note__: If an update was triggered but nothing changed, the event won't be fired.
+
+Is fired after the instace was updated.
+
+### `destroyed`
+
+| arguments | description |
+| :--- | :--- |
+| `instance` | The instance which fired the event. |
+| `canceled` | An `boolean` which indicates whether the initialization was canceled and thus destroyed. |
+
+Is fired after all generated elements, observers and events were removed from the DOM.
+
+{children};
+};
diff --git a/docs/v2/src/pages/_app.tsx b/docs/v2/src/pages/_app.tsx
index 78753ed..6786983 100644
--- a/docs/v2/src/pages/_app.tsx
+++ b/docs/v2/src/pages/_app.tsx
@@ -1,64 +1,96 @@
import '~/assets/css/tailwind.css';
import '~/assets/css/styles.css';
+import '@~package/overlayscrollbars/overlayscrollbars.css';
+import { useEffect } from 'react';
+import { OverlayScrollbars } from '@~package/overlayscrollbars';
import Head from 'next/head';
+import { MDXProvider } from '@mdx-js/react';
import favicon from '~/assets/favicon.ico';
+import { Pre } from '~/components/md/Pre';
+import { Heading } from '~/components/md/Heading';
+import type { ComponentProps } from 'react';
import type { AppProps } from 'next/app';
+import type { HeadingProps } from '~/components/md/Heading';
-const OverlayScrollbarsDocs = ({ Component, pageProps }: AppProps) => (
-
-
- OverlayScrollbars
-
-
-
-
-
-
-
-
-
-
-
-
- {/* eslint-disable-next-line react/jsx-props-no-spreading */}
-
+const generateHeading = (props: ComponentProps<'h1'>, tag: HeadingProps['tag']) => (
+ // eslint-disable-next-line react/jsx-props-no-spreading
+
+
+ OverlayScrollbars
+
+
+
+
+
+
+
+
+
+
+
+
+ {/* eslint-disable-next-line react/jsx-props-no-spreading */}
+
+
+
+ {children}
+
+
+
+);
+
+const IndexPage: NextPage = () => {
+ const usedByRef = useRef
+
+
+ 
+
+ Overlay Scrollbars
++ A javascript scrollbar plugin that hides native scrollbars, provides custom styleable + overlay scrollbars and keeps the native functionality and feeling. +
+ {separator('used by')} +
+
+
+ {separator(
+
+
+
+
+
+
+ 
+
+
+ 
+
+
+ 
+
+
+ This page is a work in progress. For now refer to the TypeScript definitions for a more
+ detailed documentation.
+
+ Looking for the v1 docs? Follow this link.
+
+ 
+ 
+ 
+ 
+
+
+