[feature] Add useDenormalized() hook selector

[ntucker]

Motivation

The goal is to make useDenormalized() the way useCache() selects data - removing the automatic drilling into results to find the entity inside.

schema:

{
  data: getEntitySchema(this)
}

Before

const article = useResource(Article.detailShape(), { id });

After

const { data: article } = useResource(Article.detailShape(), { id });

Before changing useCache(), we will add this new selector hook and compose it with the 'drill in' behavior to achieve backwards compatible results. While mostly this should be an unnoticed change, we do export the useDenormalized() for those who wish to use it.

Solution

The 'drill in' is now basically all useSchemaSelect() does, and it calls useDenormalized() first to get the initial stuff. Splitting this up now to provide an elegant migration path before we deprecate the old method. 3.0 will use the new method in the normal names, while still providing the old selector in deprecated hooks (so people can just rename for migration). 3.1 will then remove the legacy hooks.

/**
 * Selects the denormalized form from `state` cache.
 *
 * If `result` is not found, will attempt to generate it naturally
 * using params and schema. This increases cache hit rate for many
 * detail shapes.
 */
function useDenormalized<
  Params extends Readonly<object>,
  S extends Schema
>(
  fetchShape: Pick<ReadShape<S, Params, any>, 'schema' | 'getFetchKey'>,
  params: Params | null,
  state: State<any>,
): Denormalized<typeof schema> | null;

Note

Will add useCacheNew() and useResourceNew() in followup PR