feat(fixture): expose unofficial queriesFor helper

(until we have an official API for \`Locator\` queries that doesn't require
a **@playwright/test** fixture)

Author: jrolfs

lib/fixture/index.ts

@@ -7,6 +7,7 @@ import {
   installTestingLibraryFixture,
   queriesFixture as locatorQueriesFixture,
   options,
+  queriesFor,
   registerSelectorsFixture,
   withinFixture,
 } from './locator'
@@ -35,9 +36,11 @@ interface LocatorFixtures extends Partial<Config> {
 
 export {configure} from '..'
 
-export type {ElementHandleFixtures as TestingLibraryFixtures}
-export {elementHandleQueriesFixture as fixture}
-export {elementHandleFixtures as fixtures}
-export type {LocatorFixtures}
-export {locatorQueriesFixture}
-export {locatorFixtures}
+export type {ElementHandleFixtures as TestingLibraryFixtures, LocatorFixtures}
+export {
+  locatorFixtures,
+  locatorQueriesFixture,
+  elementHandleQueriesFixture as fixture,
+  elementHandleFixtures as fixtures,
+  queriesFor,
+}

lib/fixture/locator/helpers.ts

@@ -92,6 +92,20 @@ const createFindQuery =
     return locator
   }
 
+/**
+ * Given a `Page` or `Locator` instance, return an object of Testing Library
+ * query methods that return a `Locator` instance for the queried element
+ *
+ * @internal this API is not currently intended for public usage and may be
+ * removed or changed outside of semantic release versioning. If possible, you
+ * should use the `locatorFixtures` with **@playwright/test** instead.
+ * @see {@link locatorFixtures}
+ *
+ * @param pageOrLocator `Page` or `Locator` instance to use as the query root
+ * @param config Testing Library configuration to apply to queries
+ *
+ * @returns object containing scoped Testing Library query methods
+ */
 const queriesFor = (pageOrLocator: Page | Locator, config?: Partial<Config>) =>
   allQueryNames.reduce(
     (rest, query) => ({

lib/fixture/locator/index.ts

@@ -6,3 +6,4 @@ export {
   withinFixture,
 } from './fixtures'
 export type {Queries} from './fixtures'
+export {queriesFor} from './helpers'