docs(js): document JavaScript API

packages/website/docs/autocomplete-js.md

@@ -0,0 +1,83 @@
+---
+id: autocomplete-js
+title: autocomplete
+---
+
+This function creates a JavaScript autocomplete experience.
+
+## Example
+
+```js title="HTML"
+<div id="autocomplete"></div>
+```
+
+```js title="JavaScript"
+import algoliasearch from 'algoliasearch/lite';
+import {
+  autocomplete,
+  getAlgoliaHits,
+} from '@francoischalifour/autocomplete-js';
+
+const searchClient = algoliasearch(
+  'latency',
+  '6be0576ff61c053d5f9a3225e2a90f76'
+);
+
+const autocomplete = autocomplete({
+  container: '#autocomplete',
+  getSources() {
+    return [
+      {
+        getInputValue: ({ suggestion }) => suggestion.query,
+        getSuggestions({ query }) {
+          return getAlgoliaHits({
+            searchClient,
+            queries: [
+              {
+                indexName: 'instant_search_demo_query_suggestions',
+                query,
+                params: {
+                  hitsPerPage: 4,
+                },
+              },
+            ],
+          });
+        },
+      },
+    ];
+  },
+});
+```
+
+## Reference
+
+`autocomplete` accepts all the props that [`createAutocomplete`](/docs/createAutocomplete#reference) supports.
+
+### Required props
+
+#### `container`
+
+> `string | HTMLElement`
+
+The container for the autocomplete search box.
+
+### Optional props
+
+#### `render`
+
+> `(params: { root: HTMLElement, sections: HTMLElement[], state: AutocompleteState<TItem> }) => void`
+
+Function called to render the autocomplete results. It is useful for rendering sections in different row or column layouts.
+
+The default implementation appends all the sections to the root:
+
+```js
+autocomplete({
+  // ...
+  render({ root, sections }) {
+    for (const section of sections) {
+      root.appendChild(section);
+    }
+  },
+});
+```

packages/website/sidebars.js

@@ -17,9 +17,14 @@ module.exports = {
     API: [
       {
         type: 'category',
-        label: 'Autocomplete',
+        label: 'Core',
         items: ['createAutocomplete'],
       },
+      {
+        type: 'category',
+        label: 'JavaScript',
+        items: ['autocomplete-js'],
+      },
       {
         type: 'category',
         label: 'React',