Function wrapAllByQueryWithSuggestion

src/query-helpers.ts:167–207

(
    query: (container: HTMLElement, ...args: Arguments) => HTMLElement[],
    queryAllByName: string,
    variant: Variant,
  )

const wrapAllByQueryWithSuggestion =
  <
    // We actually want `Arguments extends [args: ...unknown[], options?: Options]`
    // But that's not supported by TS so we have to `@ts-expect-error` every callsite
    Arguments extends [...unknown[], WithSuggest],
  >(
    query: (container: HTMLElement, ...args: Arguments) => HTMLElement[],
    queryAllByName: string,
    variant: Variant,
  ) =>
  (container: HTMLElement, ...args: Arguments) => {
    const els = query(container, ...args)

    const [{suggest = getConfig().throwSuggestions} = {}] = args.slice(-1) as [
      WithSuggest,
    ]
    if (els.length && suggest) {
      // get a unique list of all suggestion messages.  We are only going to make a suggestion if
      // all the suggestions are the same
      const uniqueSuggestionMessages = [
        ...new Set(
          els.map(
            element =>
              getSuggestedQuery(element, variant)?.toString() as string,
          ),
        ),
      ]

      if (
        // only want to suggest if all the els have the same suggestion.
        uniqueSuggestionMessages.length === 1 &&
        !queryAllByName.endsWith(
          // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- TODO: Can this be null at runtime?
          getSuggestedQuery(els[0], variant)!.queryName as string,
        )
      ) {
        throw getSuggestionError(uniqueSuggestionMessages[0], container)
      }
    }

    return els
  }

// TODO: This deviates from the published declarations
// However, the implementation always required a dyadic (after `container`) not variadic `queryAllBy` considering the implementation of `makeFindQuery`