Add more documentation and update the code

docs/hooks.md

@@ -67,5 +67,13 @@ used by other hooks to return a specific set of entities based on their configur
 
 ## `useQueryViewablePostTypes`
 
+This hook is a subset of the `useEntitiesRecords` hook. It is used to retrieve the list of the viewable post types.
 
+## `useQueryViewableTaxonomies`
+
+This hook is a subset of the `useEntitiesRecords` hook. It is used to retrieve the list of the viewable taxonomies.
+
+## `useSearch`
+
+This hook will return a throttled function to search for the entities.
 

sources/client/src/api/fetch.ts

@@ -1,3 +1,6 @@
 import apiFetch from '@wordpress/api-fetch';
 
+/**
+ * @internal
+ */
 export const fetch = apiFetch;

sources/client/src/components/composite-entities-by-kind.tsx

@@ -9,6 +9,12 @@ import { orderSelectedOptionsAtTheTop } from '../utils/order-selected-options-at
 import { uniqueControlOptions } from '../utils/unique-control-options';
 import { Set } from '../vo/set';
 
+/**
+ * A composite component that provides a way to search for entities by kind.
+ *
+ * @public
+ * @param props The component props.
+ */
 export function CompositeEntitiesByKind<E, K>(
 	props: EntitiesSearch.CompositeEntitiesKinds<E, K>
 ): JSX.Element {

sources/client/src/hooks/use-entities-options-storage.ts

@@ -12,6 +12,11 @@ type _Reducer<E, K> = Reducer<
 	EntitiesSearch.StoreAction<E, K>
 >;
 
+/**
+ * @public
+ * @param initialState   The initial state configuration
+ * @param searchEntities The function that will search the entities
+ */
 export function useEntitiesOptionsStorage<E, K>(
 	initialState: Pick<EntitiesSearch.EntitiesState<E, K>, 'entities' | 'kind'>,
 	searchEntities: EntitiesSearch.SearchEntitiesFunction<E, K>

sources/client/src/hooks/use-entity-records.ts

@@ -15,7 +15,7 @@ enum ResolveStatus {
  * This is to guarantee a better flow in the data manipulation, therefore do not count on the data returned by the
  * `records()` as an indicator of the hook status.
  *
- * @internal
+ * @public
  * @param kind      The kind of entity to fetch. E.g. 'root', 'postType', 'taxonomy', etc.
  * @param name      The name of the entity to fetch. E.g. 'post', 'page', 'category', etc.
  * @param queryArgs The query args to pass to the entity fetch. E.g. { per_page: 100 }

sources/client/src/hooks/use-search.ts

@@ -9,6 +9,16 @@ import { Set } from '../vo/set';
 type SearchPhrase = Parameters<EntitiesSearch.SearchControl['onChange']>[0];
 type SearchFunc = (phrase: SearchPhrase) => void;
 
+/**
+ * Build a function to search the entities by a phrase
+ *
+ * @public
+ * @param setSearchPhrase A function to set the search phrase
+ * @param searchEntities  The function that will search the entities
+ * @param kind            The kind of entities to search
+ * @param entities        The entities to exclude from the search
+ * @param dispatch        The dispatch function to update the state
+ */
 export function useSearch<E, K>(
 	setSearchPhrase: (search: string) => void,
 	searchEntities: EntitiesSearch.SearchEntitiesFunction<E, K>,

sources/client/src/index.ts

@@ -1,4 +1,3 @@
-export * from './api/fetch';
 export * from './api/search-entities';
 
 export * from './components/composite-entities-by-kind';