feat(core): rename private and public methods and properties

examples/js/app.ts

@@ -4,7 +4,7 @@ import {
   autocomplete,
   AutocompleteSource,
   getAlgoliaHits,
-  reverseHighlightItem,
+  reverseHighlightHit,
 } from '@algolia/autocomplete-js';
 import { createRecentSearchesPlugin } from '@algolia/autocomplete-plugin-recent-searches';
 import '@algolia/autocomplete-plugin-recent-searches/style';
@@ -40,17 +40,19 @@ autocomplete<Hit<QuerySuggestionHit>>({
     }).then(([hits]) => {
       return [
         {
-          getInputValue: ({ suggestion }) => suggestion.query,
-          getSuggestions() {
+          getItemInputValue({ item }) {
+            return item.query;
+          },
+          getItems() {
             return hits;
           },
           templates: {
             item({ item }) {
               return `
                 <div class="item-icon">${searchIcon}</div>
                 <div>
-                  ${reverseHighlightItem({
-                    item,
+                  ${reverseHighlightHit({
+                    hit: item,
                     attribute: 'query',
                   })}
                 </div>

packages/autocomplete-core/src/__tests__/autocomplete.test.ts

@@ -1,41 +1,41 @@
 import { createAutocomplete } from '..';
 
-function createSuggestion(items = []) {
+function createCollection(items = []) {
   return {
     source: {
-      getInputValue: ({ suggestion }) => suggestion.label,
-      getSuggestionUrl: () => undefined,
+      getItemInputValue: ({ item }) => item.label,
+      getItemUrl: () => undefined,
       onHighlight: () => {},
       onSelect: () => {},
-      getSuggestions: () => items,
+      getItems: () => items,
     },
     items,
   };
 }
 
 describe('createAutocomplete', () => {
-  test('setHighlightedIndex', () => {
+  test('setSelectedItemId', () => {
     const onStateChange = jest.fn();
-    const { setHighlightedIndex } = createAutocomplete({
+    const { setSelectedItemId } = createAutocomplete({
       getSources: () => [],
       onStateChange,
     });
 
-    setHighlightedIndex(1);
+    setSelectedItemId(1);
 
     expect(onStateChange).toHaveBeenCalledTimes(1);
     expect(onStateChange).toHaveBeenCalledWith(
       expect.objectContaining({
-        state: expect.objectContaining({ highlightedIndex: 1 }),
+        state: expect.objectContaining({ selectedItemId: 1 }),
       })
     );
 
-    setHighlightedIndex(null);
+    setSelectedItemId(null);
 
     expect(onStateChange).toHaveBeenCalledTimes(2);
     expect(onStateChange).toHaveBeenCalledWith(
       expect.objectContaining({
-        state: expect.objectContaining({ highlightedIndex: null }),
+        state: expect.objectContaining({ selectedItemId: null }),
       })
     );
   });
@@ -57,20 +57,20 @@ describe('createAutocomplete', () => {
     );
   });
 
-  test('setSuggestions', () => {
+  test('setCollections', () => {
     const onStateChange = jest.fn();
-    const { setSuggestions } = createAutocomplete({
+    const { setCollections } = createAutocomplete({
       getSources: () => [],
       onStateChange,
     });
-    const suggestions = [createSuggestion()];
+    const collections = [createCollection()];
 
-    setSuggestions(suggestions);
+    setCollections(collections);
 
     expect(onStateChange).toHaveBeenCalledTimes(1);
     expect(onStateChange).toHaveBeenCalledWith(
       expect.objectContaining({
-        state: expect.objectContaining({ suggestions }),
+        state: expect.objectContaining({ collections }),
       })
     );
   });

packages/autocomplete-core/src/createAutocomplete.ts

@@ -19,9 +19,9 @@ export function createAutocomplete<
   const store = createStore(stateReducer, props, [completionStateEnhancer]);
 
   const {
-    setHighlightedIndex,
+    setSelectedItemId,
     setQuery,
-    setSuggestions,
+    setCollections,
     setIsOpen,
     setStatus,
     setContext,
@@ -38,9 +38,9 @@ export function createAutocomplete<
   } = getPropGetters<TItem, TEvent, TMouseEvent, TKeyboardEvent>({
     store,
     props,
-    setHighlightedIndex,
+    setSelectedItemId,
     setQuery,
-    setSuggestions,
+    setCollections,
     setIsOpen,
     setStatus,
     setContext,
@@ -53,9 +53,9 @@ export function createAutocomplete<
       event: new Event('input'),
       store,
       props,
-      setHighlightedIndex,
+      setSelectedItemId,
       setQuery,
-      setSuggestions,
+      setCollections,
       setIsOpen,
       setStatus,
       setContext,
@@ -67,9 +67,9 @@ export function createAutocomplete<
   }
 
   return {
-    setHighlightedIndex,
+    setSelectedItemId,
     setQuery,
-    setSuggestions,
+    setCollections,
     setIsOpen,
     setStatus,
     setContext,

packages/autocomplete-core/src/getAutocompleteSetters.ts

@@ -7,29 +7,29 @@ interface GetAutocompleteSettersOptions<TItem> {
 export function getAutocompleteSetters<TItem>({
   store,
 }: GetAutocompleteSettersOptions<TItem>) {
-  const setHighlightedIndex: AutocompleteApi<TItem>['setHighlightedIndex'] = (
+  const setSelectedItemId: AutocompleteApi<TItem>['setSelectedItemId'] = (
     value
   ) => {
-    store.send('setHighlightedIndex', value);
+    store.send('setSelectedItemId', value);
   };
 
   const setQuery: AutocompleteApi<TItem>['setQuery'] = (value) => {
     store.send('setQuery', value);
   };
 
-  const setSuggestions: AutocompleteApi<TItem>['setSuggestions'] = (
+  const setCollections: AutocompleteApi<TItem>['setCollections'] = (
     rawValue
   ) => {
     let baseItemId = 0;
-    const value = rawValue.map((suggestion) => ({
-      ...suggestion,
-      items: suggestion.items.map((item) => ({
+    const value = rawValue.map((collection) => ({
+      ...collection,
+      items: collection.items.map((item) => ({
         ...item,
         __autocomplete_id: baseItemId++,
       })),
     }));
 
-    store.send('setSuggestions', value);
+    store.send('setCollections', value);
   };
 
   const setIsOpen: AutocompleteApi<TItem>['setIsOpen'] = (value) => {
@@ -45,9 +45,9 @@ export function getAutocompleteSetters<TItem>({
   };
 
   return {
-    setHighlightedIndex,
+    setSelectedItemId,
     setQuery,
-    setSuggestions,
+    setCollections,
     setIsOpen,
     setStatus,
     setContext,

packages/autocomplete-core/src/getCompletion.ts

@@ -1,5 +1,5 @@
 import { InternalAutocompleteOptions, AutocompleteState } from './types';
-import { getHighlightedItem } from './utils';
+import { getSelectedItem } from './utils';
 
 interface GetCompletionProps<TItem> {
   state: AutocompleteState<TItem>;
@@ -13,28 +13,30 @@ export function getCompletion<TItem>({
   if (
     props.enableCompletion === false ||
     state.isOpen === false ||
-    state.highlightedIndex === null ||
+    state.selectedItemId === null ||
     state.status === 'stalled'
   ) {
     return null;
   }
 
-  const { itemValue } = getHighlightedItem({ state })!;
+  const { itemInputValue } = getSelectedItem({ state })!;
 
   // The completion should appear only if the _first_ characters of the query
-  // match with the suggestion.
+  // match with the item.
   if (
     state.query.length > 0 &&
-    itemValue.toLocaleLowerCase().indexOf(state.query.toLocaleLowerCase()) === 0
+    itemInputValue
+      .toLocaleLowerCase()
+      .indexOf(state.query.toLocaleLowerCase()) === 0
   ) {
-    // If the query typed has a different case than the suggestion, we want
+    // If the query typed has a different case than the item, we want
     // to show the completion matching the case of the query. This makes both
     // strings overlap correctly.
     // Example:
     //  - query: 'Gui'
-    //  - suggestion: 'guitar'
+    //  - item: 'guitar'
     //  => completion: 'Guitar'
-    const completion = state.query + itemValue.slice(state.query.length);
+    const completion = state.query + itemInputValue.slice(state.query.length);
 
     if (completion === state.query) {
       return null;

packages/autocomplete-core/src/getDefaultProps.ts

@@ -19,7 +19,7 @@ export function getDefaultProps<TItem>(
     openOnFocus: false,
     placeholder: '',
     autoFocus: false,
-    defaultHighlightedIndex: null,
+    defaultSelectedItemId: null,
     enableCompletion: false,
     stallThreshold: 300,
     environment,
@@ -31,10 +31,10 @@ export function getDefaultProps<TItem>(
     id: props.id ?? generateAutocompleteId(),
     // The following props need to be deeply defaulted.
     initialState: {
-      highlightedIndex: null,
+      selectedItemId: null,
       query: '',
       completion: null,
-      suggestions: [],
+      collections: [],
       isOpen: false,
       status: 'idle',
       statusContext: {},
@@ -83,22 +83,18 @@ export function getDefaultProps<TItem>(
         );
     },
     navigator: {
-      navigate({ suggestionUrl }) {
-        environment.location.assign(suggestionUrl);
+      navigate({ itemUrl }) {
+        environment.location.assign(itemUrl);
       },
-      navigateNewTab({ suggestionUrl }) {
-        const windowReference = environment.open(
-          suggestionUrl,
-          '_blank',
-          'noopener'
-        );
+      navigateNewTab({ itemUrl }) {
+        const windowReference = environment.open(itemUrl, '_blank', 'noopener');
 
         if (windowReference) {
           windowReference.focus();
         }
       },
-      navigateNewWindow({ suggestionUrl }) {
-        environment.open(suggestionUrl, '_blank', 'noopener');
+      navigateNewWindow({ itemUrl }) {
+        environment.open(itemUrl, '_blank', 'noopener');
       },
       ...props.navigator,
     },