docs: add <HoverSensor> docs

Author: streamich

README.md

@@ -50,6 +50,7 @@ const MyComponent = mock();
   - [Sensors](./docs/Sensors.md)
      - [`<BatterySensor>`](./docs/BatterySensor.md), [`withBattery()`](./docs/BatterySensor.md#withbattery), and [`@withBattery`](./docs/BatterySensor.md#withbattery-1)
      - [`<GeoLocationSensor>`](./docs/GeoLocationSensor.md), [`withGeoLocation()`](./docs/GeoLocationSensor.md#withgeolocation-hoc), and [`@withGeoLocation`](./docs/GeoLocationSensor.md#withgeolocation-decorator)
+     - [`<HoverSensor>`](./docs/HoverSensor.md), [`withHover()`](./docs/HoverSensor.md#withhover-hoc), and [`@withHover`](./docs/HoverSensor.md#withhover-decorator)
      - [`<MediaDeviceSensor>`](./docs/MediaDeviceSensor.md), [`withMediaDevices()`](./docs/MediaDeviceSensor.md#withmediadevices), and [`@withMediaDevices`](./docs/MediaDeviceSensor.md#withmediadevices-1)
      - [`<MediaSensor>`](./docs/MediaSensor.md), [`withMedia()`](./docs/MediaSensor.md#withmedia), and [`@withMedia`](./docs/MediaSensor.md#withmedia-1)
      - [`<MotionSensor>`](./docs/MotionSensor.md), [`withMotion()`](./docs/MotionSensor.md#withmotion-hoc), and [`@withMotion`](./docs/MotionSensor.md#withmotion-decorator)
@@ -65,7 +66,6 @@ const MyComponent = mock();
         - [`<ViewportScrollSensor>`](./docs/ViewportSensor.md#viewportscrollsensor) and [`<ViewportObserverSensor>`](./docs/ViewportSensor.md#viewportobserversensor)
      - [`<WindowScrollSensor>`](./docs/WindowScrollSensor.md), [`withWindowScroll()`](./docs/WindowScrollSensor.md#withwindowscroll-hoc), and [`@withWindowScroll`](./docs/WindowScrollSensor.md#withwindowscroll-decorator)
      - [`<WindowSizeSensor>`](./docs/WindowSizeSensor.md), [`withWindowSize()`](./docs/WindowSizeSensor.md#withwindowsize-hoc), and [`@withWindowSize`](./docs/WindowSizeSensor.md#withwindowsize-decorator)
-     - `HoverSensor`, `withHover()`, and `@withHover`
      - `ActiveSensor`, `withActive()`, and `@withActive`
      - `FocusSensor`, `withFocus()`, and `@withFocus`
   - Generators

docs/HoverSensor.md

@@ -0,0 +1,67 @@
+# `<HoverSensor>`
+
+Render prop that tracks elements hover status. Attaches to the root element, or provides a binding, if `bond` prop specified.
+
+## Example
+
+Use it as FaCC, attach to root element
+
+```jsx
+import {HoverSensor} from 'libreact/lib/HoverSensor';
+
+<HoverSensor>{({isHover}) =>
+  <div>{isHover ? 'hovered' : 'no hovered'}</div>
+}</HoverSensor>
+```
+
+Use `bond` to bind to any element
+
+```jsx
+import {HoverSensor} from 'libreact/lib/HoverSensor';
+
+<HoverSensor bond>{({bond, isHover}) =>
+  <div>
+    <div {...bond}>{isHover ? 'hovered' : 'no hovered'}</div>
+  </div>
+}</HoverSensor>
+```
+
+
+## Props
+
+Prop signature
+
+```ts
+interface IHoverSensorProps {
+  bond?: boolean | string;
+}
+```
+
+, where
+
+  - `bond` - optional, string, specifies the bond name. If boolean and set to `true`, bond with name `"bond"` is created.
+
+
+## `withHover()` HOC
+
+HOC that merges `hover` prop into enhanced component's props. With HOC interface you always have to use bond.
+
+```jsx
+import {withHover} from 'libreact/lib/HoverSensor';
+
+const MyCompWithHover = withHover(MyComp);
+```
+
+
+## `@withHover` decorator
+
+React stateful component decorator that adds `hover` prop.
+
+```js
+import {withHover} from 'libreact/lib/HoverSensor';
+
+@withHover
+class MyComp extends Component {
+
+}
+```