@okta/odyssey-contribution-tooling 1.48.0 → 1.49.0

package/dist/cjs/test-selectors/querySelector.cjs

@@ -0,0 +1,111 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.querySelector = exports.captureElement = void 0;
+var _getByQuerySelector = require("./getByQuerySelector.cjs");
+var _getComputedAccessibleText = require("./getComputedAccessibleText.cjs");
+var _linkedHtmlSelectors = require("./linkedHtmlSelectors.cjs");
+var _sanityChecks = require("./sanityChecks.cjs");
+/*!
+ * Copyright (c) 2024-present, Okta, Inc. and/or its affiliates. All rights reserved.
+ * The Okta software accompanied by this notice is provided pursuant to the Apache License, Version 2.0 (the "License.")
+ *
+ * You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+ * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *
+ * See the License for the specific language governing permissions and limitations under the License.
+ */
+
+const captureElement = ({
+  containerElement,
+  queryMethod,
+  querySelectorOptions,
+  role,
+  testSelector
+}) => {
+  if ("elementSelector" in testSelector && querySelectorOptions) {
+    const sharedProps = {
+      element: containerElement,
+      queryMethod,
+      queryOptions: Object.fromEntries(Object.entries(testSelector.elementSelector.options).map(([testSelectorOptionKey, testingLibraryOptionKey]) => [testingLibraryOptionKey, querySelectorOptions[testSelectorOptionKey]]))
+    };
+    if (testSelector.elementSelector.method === "ByRole") {
+      return (0, _getByQuerySelector.getByRoleQuerySelector)({
+        ...sharedProps,
+        role: Array.isArray(testSelector.elementSelector.role) || role ? role || "" : testSelector.elementSelector.role
+      });
+    }
+    return (0, _getByQuerySelector.getByTextQuerySelector)({
+      ...sharedProps,
+      selectionMethod: testSelector.elementSelector.method,
+      text: testSelector.elementSelector.text
+    });
+  } else if ("isControlledElement" in testSelector && testSelector.isControlledElement) {
+    try {
+      return (0, _linkedHtmlSelectors.getControlledElement)({
+        element: containerElement
+      });
+    } catch (error) {
+      if (queryMethod === "query") {
+        return null;
+      }
+      throw error;
+    }
+  }
+  return null;
+};
+exports.captureElement = captureElement;
+const querySelector = testSelector => props => {
+  const {
+    element: containerElement,
+    queryMethod
+  } = props;
+  const capturedElement = captureElement({
+    containerElement,
+    queryMethod: queryMethod || "get",
+    querySelectorOptions: "options" in props ? props.options : undefined,
+    role: "role" in props ? props.role : undefined,
+    testSelector
+  });
+  const getAccessibleText = labelName => {
+    if (!capturedElement) {
+      throw new _sanityChecks.ElementError("No child HTML element available", containerElement);
+    }
+    if (!("accessibleText" in testSelector)) {
+      throw new Error("Missing `accessibleText` in `TestSelector`");
+    }
+    return (0, _getComputedAccessibleText.getComputedAccessibleText)({
+      element: capturedElement,
+      type: testSelector.accessibleText[labelName]
+    });
+  };
+  const selectChild = childProps => {
+    if (!capturedElement) {
+      throw new _sanityChecks.ElementError("No child HTML element available", containerElement);
+    }
+    if (!("children" in testSelector)) {
+      throw new Error("Missing `children` in `TestSelector`");
+    }
+    return querySelector(testSelector.children[childProps.name])({
+      element: capturedElement,
+      queryMethod: childProps.queryMethod,
+      ...("options" in childProps && childProps.options ? {
+        options: childProps.options
+      } : {}),
+      ...("role" in childProps && childProps.role ? {
+        role: childProps.role
+      } : {})
+    });
+  };
+  return {
+    element: capturedElement,
+    getAccessibleText: getAccessibleText,
+    selectChild: selectChild
+  };
+};
+exports.querySelector = querySelector;
+//# sourceMappingURL=querySelector.cjs.map

package/dist/cjs/test-selectors/querySelector.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"querySelector.cjs","names":["_getByQuerySelector","require","_getComputedAccessibleText","_linkedHtmlSelectors","_sanityChecks","captureElement","containerElement","queryMethod","querySelectorOptions","role","testSelector","sharedProps","element","queryOptions","Object","fromEntries","entries","elementSelector","options","map","testSelectorOptionKey","testingLibraryOptionKey","method","getByRoleQuerySelector","Array","isArray","getByTextQuerySelector","selectionMethod","text","isControlledElement","getControlledElement","error","exports","querySelector","props","capturedElement","undefined","getAccessibleText","labelName","ElementError","Error","getComputedAccessibleText","type","accessibleText","selectChild","childProps","children","name"],"sources":["../../../src/test-selectors/querySelector.ts"],"sourcesContent":["/*!\n * Copyright (c) 2024-present, Okta, Inc. and/or its affiliates. All rights reserved.\n * The Okta software accompanied by this notice is provided pursuant to the Apache License, Version 2.0 (the \"License.\")\n *\n * You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0.\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS, WITHOUT\n * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n *\n * See the License for the specific language governing permissions and limitations under the License.\n */\n\nimport {\n  getByRoleQuerySelector,\n  getByTextQuerySelector,\n  type QueryMethod,\n} from \"./getByQuerySelector.js\";\nimport { getComputedAccessibleText } from \"./getComputedAccessibleText.js\";\nimport { getControlledElement } from \"./linkedHtmlSelectors.js\";\nimport { ElementError } from \"./sanityChecks.js\";\nimport {\n  type AccessibleTextSelector,\n  type AriaRole,\n  type ElementChildSelector,\n  type ElementSelector,\n  type TestSelector,\n} from \"./testSelector.js\";\n\nexport type InnerQuerySelectorProps<\n  LocalTestSelector extends TestSelector,\n  LocalQueryMethod extends QueryMethod,\n> = {\n  /**\n   * Testing Library method used to query elements.\n   */\n  queryMethod?: LocalQueryMethod;\n} & (LocalTestSelector extends ElementSelector\n  ? LocalTestSelector[\"elementSelector\"] extends {\n      role: infer Role;\n    }\n    ? Role extends AriaRole[]\n      ? {\n          /**\n           * Role is used when you have an optional `role`; otherwise, it's baked into the metadata.\n           */\n          role: Role[number];\n        }\n      : object\n    : object\n  : object) &\n  (LocalTestSelector extends ElementSelector\n    ? {\n        /**\n         * Helps narrow down HTML selection to the correct element.\n         */\n        options: Record<\n          keyof LocalTestSelector[\"elementSelector\"][\"options\"],\n          string | RegExp\n        >;\n      }\n    : object);\n\nexport const captureElement = <\n  LocalTestSelector extends TestSelector,\n  QuerySelectorOptions extends Record<string, string | RegExp>,\n  LocalQueryMethod extends QueryMethod = \"get\",\n>({\n  containerElement,\n  queryMethod,\n  querySelectorOptions,\n  role,\n  testSelector,\n}: {\n  containerElement: HTMLElement;\n  queryMethod: LocalQueryMethod;\n  querySelectorOptions?: QuerySelectorOptions;\n  role?: AriaRole;\n  testSelector: LocalTestSelector;\n}) => {\n  if (\"elementSelector\" in testSelector && querySelectorOptions) {\n    const sharedProps = {\n      element: containerElement,\n      queryMethod,\n      queryOptions: Object.fromEntries(\n        Object.entries(testSelector.elementSelector.options).map(\n          ([testSelectorOptionKey, testingLibraryOptionKey]) => [\n            testingLibraryOptionKey,\n            querySelectorOptions[testSelectorOptionKey],\n          ],\n        ),\n      ),\n    };\n\n    if (testSelector.elementSelector.method === \"ByRole\") {\n      return getByRoleQuerySelector({\n        ...sharedProps,\n        role:\n          Array.isArray(testSelector.elementSelector.role) || role\n            ? role || \"\"\n            : testSelector.elementSelector.role,\n      });\n    }\n\n    return getByTextQuerySelector({\n      ...sharedProps,\n      selectionMethod: testSelector.elementSelector.method,\n      text: testSelector.elementSelector.text,\n    });\n  } else if (\n    \"isControlledElement\" in testSelector &&\n    testSelector.isControlledElement\n  ) {\n    try {\n      return getControlledElement({ element: containerElement });\n    } catch (error) {\n      if (queryMethod === \"query\") {\n        return null;\n      }\n\n      throw error;\n    }\n  }\n\n  return null;\n};\n\nexport const querySelector =\n  <LocalTestSelector extends TestSelector>(\n    /**\n     * Selectors object including children and accessible text selections.\n     */\n    testSelector: LocalTestSelector,\n  ) =>\n  <LocalQueryMethod extends QueryMethod = \"get\">(\n    props: {\n      /**\n       * Refers to Testing Library's canvas. This is usually `screen`, but Storybook uses `within(canvas)`.\n       */\n      element: HTMLElement;\n    } & InnerQuerySelectorProps<LocalTestSelector, LocalQueryMethod>,\n  ) => {\n    const { element: containerElement, queryMethod } = props;\n\n    const capturedElement = captureElement({\n      containerElement,\n      queryMethod: queryMethod || (\"get\" as const),\n      querySelectorOptions: \"options\" in props ? props.options : undefined,\n      role: \"role\" in props ? (props.role as AriaRole) : undefined,\n      testSelector,\n    });\n\n    const getAccessibleText = <\n      LabelName extends LocalTestSelector extends AccessibleTextSelector\n        ? keyof LocalTestSelector[\"accessibleText\"]\n        : never,\n    >(\n      labelName: LabelName,\n    ) => {\n      if (!capturedElement) {\n        throw new ElementError(\n          \"No child HTML element available\",\n          containerElement,\n        );\n      }\n\n      if (!(\"accessibleText\" in testSelector)) {\n        throw new Error(\"Missing `accessibleText` in `TestSelector`\");\n      }\n\n      return getComputedAccessibleText({\n        element: capturedElement,\n        type: testSelector.accessibleText[labelName],\n      });\n    };\n\n    const selectChild = <\n      ChildName extends LocalTestSelector extends ElementChildSelector\n        ? keyof LocalTestSelector[\"children\"]\n        : keyof ElementChildSelector,\n      ChildQueryMethod extends QueryMethod = \"get\",\n    >(\n      childProps: {\n        name: ChildName;\n      } & InnerQuerySelectorProps<\n        LocalTestSelector extends ElementChildSelector\n          ? LocalTestSelector[\"children\"][ChildName]\n          : TestSelector,\n        ChildQueryMethod\n      >,\n    ) => {\n      if (!capturedElement) {\n        throw new ElementError(\n          \"No child HTML element available\",\n          containerElement,\n        );\n      }\n\n      if (!(\"children\" in testSelector)) {\n        throw new Error(\"Missing `children` in `TestSelector`\");\n      }\n\n      type Options = Record<\n        LocalTestSelector extends ElementChildSelector\n          ? LocalTestSelector[\"children\"][ChildName] extends ElementSelector\n            ? keyof LocalTestSelector[\"children\"][ChildName][\"elementSelector\"][\"options\"]\n            : never\n          : never,\n        string | RegExp\n      >;\n\n      return querySelector(\n        testSelector.children[\n          childProps.name\n        ] as LocalTestSelector extends ElementChildSelector\n          ? LocalTestSelector[\"children\"][ChildName]\n          : TestSelector,\n      )(\n        // @ts-expect-error: Type '{ role?: AriaRole | undefined; options?: Record<LocalTestSelector extends ElementChildSelector ? LocalTestSelector[\"children\"][ChildName] extends TestSelector ? keyof LocalTestSelector[\"children\"][ChildName][\"selector\"][\"options\"] : string : string, string | RegExp> | undefined; element: HTMLElement...' is not assignable to type '(LocalTestSelector extends ElementChildSelector ? LocalTestSelector[\"children\"][ChildName] : TestSelector) extends { ...; } ? Role extends AriaRole[] ? { ...; } : object : object'.ts(2345)\n        // `as testSelector.children[ChildName]` narrows the props down enough that TypeScript errors here. We're passing the correct information, but it doesn't know that, and it's difficult to fix this. -Kevin Ghadyani\n        {\n          element: capturedElement,\n          queryMethod: childProps.queryMethod,\n          ...(\"options\" in childProps && childProps.options\n            ? {\n                options: childProps.options as Options,\n              }\n            : {}),\n          ...(\"role\" in childProps && childProps.role\n            ? {\n                role: childProps.role as AriaRole,\n              }\n            : {}),\n        },\n      );\n    };\n\n    return {\n      element: capturedElement as LocalQueryMethod extends \"get\"\n        ? HTMLElement\n        : HTMLElement | null,\n      getAccessibleText:\n        getAccessibleText as LocalTestSelector extends AccessibleTextSelector\n          ? typeof getAccessibleText\n          : never,\n      selectChild: selectChild as LocalTestSelector extends ElementChildSelector\n        ? typeof selectChild\n        : never,\n    };\n  };\n"],"mappings":"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","ignoreList":[]}

package/dist/cjs/test-selectors/sanityChecks.cjs

@@ -0,0 +1,43 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.validateHtmlElement = exports.normalizeText = exports.getWindow = exports.ElementError = void 0;
+/*!
+ * Copyright (c) 2024-present, Okta, Inc. and/or its affiliates. All rights reserved.
+ * The Okta software accompanied by this notice is provided pursuant to the Apache License, Version 2.0 (the "License.")
+ *
+ * You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+ * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *
+ * See the License for the specific language governing permissions and limitations under the License.
+ */class ElementError extends Error {
+  constructor(message, element) {
+    super(message);
+    this.name = "ElementError";
+    console.error("ElementError", element);
+  }
+}
+exports.ElementError = ElementError;
+const normalizeText = text => {
+  return text.replace(/\s+/g, " ").trim();
+};
+exports.normalizeText = normalizeText;
+const getWindow = htmlElement => {
+  if (!htmlElement || !htmlElement.ownerDocument || !htmlElement.ownerDocument.defaultView) {
+    throw new ElementError("Expected element to have a `window`", htmlElement);
+  }
+  return htmlElement.ownerDocument.defaultView;
+};
+exports.getWindow = getWindow;
+const validateHtmlElement = htmlElement => {
+  const window = getWindow(htmlElement);
+  if (!(htmlElement instanceof window.SVGElement) && !(htmlElement instanceof window.HTMLElement)) {
+    throw new ElementError("Expected element to be an HTMLElement or an SVGElement", htmlElement);
+  }
+};
+exports.validateHtmlElement = validateHtmlElement;
+//# sourceMappingURL=sanityChecks.cjs.map

package/dist/cjs/test-selectors/sanityChecks.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanityChecks.cjs","names":["ElementError","Error","constructor","message","element","name","console","error","exports","normalizeText","text","replace","trim","getWindow","htmlElement","ownerDocument","defaultView","validateHtmlElement","window","SVGElement","HTMLElement"],"sources":["../../../src/test-selectors/sanityChecks.ts"],"sourcesContent":["/*!\n * Copyright (c) 2024-present, Okta, Inc. and/or its affiliates. All rights reserved.\n * The Okta software accompanied by this notice is provided pursuant to the Apache License, Version 2.0 (the \"License.\")\n *\n * You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0.\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS, WITHOUT\n * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n *\n * See the License for the specific language governing permissions and limitations under the License.\n */\n\n// Code modified from: https://github.com/testing-library/jest-dom/blob/main/src/utils.js\n\nexport class ElementError extends Error {\n  constructor(message: string, element: HTMLElement) {\n    super(message);\n\n    this.name = \"ElementError\";\n\n    console.error(\"ElementError\", element);\n  }\n}\n\nexport const normalizeText = (text: string) => {\n  return text.replace(/\\s+/g, \" \").trim();\n};\n\nexport const getWindow = (htmlElement: HTMLElement) => {\n  if (\n    !htmlElement ||\n    !htmlElement.ownerDocument ||\n    !htmlElement.ownerDocument.defaultView\n  ) {\n    throw new ElementError(\"Expected element to have a `window`\", htmlElement);\n  }\n\n  return htmlElement.ownerDocument.defaultView;\n};\n\nexport const validateHtmlElement = (htmlElement: HTMLElement) => {\n  const window = getWindow(htmlElement);\n\n  if (\n    !(htmlElement instanceof window.SVGElement) &&\n    !(htmlElement instanceof window.HTMLElement)\n  ) {\n    throw new ElementError(\n      \"Expected element to be an HTMLElement or an SVGElement\",\n      htmlElement,\n    );\n  }\n};\n"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,GAIO,MAAMA,YAAY,SAASC,KAAK,CAAC;EACtCC,WAAWA,CAACC,OAAe,EAAEC,OAAoB,EAAE;IACjD,KAAK,CAACD,OAAO,CAAC;IAEd,IAAI,CAACE,IAAI,GAAG,cAAc;IAE1BC,OAAO,CAACC,KAAK,CAAC,cAAc,EAAEH,OAAO,CAAC;EACxC;AACF;AAACI,OAAA,CAAAR,YAAA,GAAAA,YAAA;AAEM,MAAMS,aAAa,GAAIC,IAAY,IAAK;EAC7C,OAAOA,IAAI,CAACC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAACC,IAAI,CAAC,CAAC;AACzC,CAAC;AAACJ,OAAA,CAAAC,aAAA,GAAAA,aAAA;AAEK,MAAMI,SAAS,GAAIC,WAAwB,IAAK;EACrD,IACE,CAACA,WAAW,IACZ,CAACA,WAAW,CAACC,aAAa,IAC1B,CAACD,WAAW,CAACC,aAAa,CAACC,WAAW,EACtC;IACA,MAAM,IAAIhB,YAAY,CAAC,qCAAqC,EAAEc,WAAW,CAAC;EAC5E;EAEA,OAAOA,WAAW,CAACC,aAAa,CAACC,WAAW;AAC9C,CAAC;AAACR,OAAA,CAAAK,SAAA,GAAAA,SAAA;AAEK,MAAMI,mBAAmB,GAAIH,WAAwB,IAAK;EAC/D,MAAMI,MAAM,GAAGL,SAAS,CAACC,WAAW,CAAC;EAErC,IACE,EAAEA,WAAW,YAAYI,MAAM,CAACC,UAAU,CAAC,IAC3C,EAAEL,WAAW,YAAYI,MAAM,CAACE,WAAW,CAAC,EAC5C;IACA,MAAM,IAAIpB,YAAY,CACpB,wDAAwD,EACxDc,WACF,CAAC;EACH;AACF,CAAC;AAACN,OAAA,CAAAS,mBAAA,GAAAA,mBAAA","ignoreList":[]}

package/dist/cjs/test-selectors/testSelector.cjs

@@ -0,0 +1,6 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+//# sourceMappingURL=testSelector.cjs.map

package/dist/cjs/test-selectors/testSelector.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"testSelector.cjs","names":[],"sources":["../../../src/test-selectors/testSelector.ts"],"sourcesContent":["/*!\n * Copyright (c) 2024-present, Okta, Inc. and/or its affiliates. All rights reserved.\n * The Okta software accompanied by this notice is provided pursuant to the Apache License, Version 2.0 (the \"License.\")\n *\n * You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0.\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS, WITHOUT\n * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n *\n * See the License for the specific language governing permissions and limitations under the License.\n */\n\nimport {\n  type ByRoleOptions,\n  type SelectorMatcherOptions,\n} from \"@testing-library/react\";\n\nimport {\n  type RoleSelectorMethod,\n  type TextSelectorMethod,\n} from \"./getByQuerySelector.js\";\n\n/**\n * We can't use React's `AriaRole` because it allows any string value. We want to be very specific. This is otherwise copied straight from React's code.\n * @see https://github.com/DefinitelyTyped/DefinitelyTyped/blob/master/types/react/index.d.ts#L2815\n */\nexport type AriaRole =\n  | \"alert\"\n  | \"alertdialog\"\n  | \"application\"\n  | \"article\"\n  | \"banner\"\n  | \"button\"\n  | \"cell\"\n  | \"checkbox\"\n  | \"columnheader\"\n  | \"combobox\"\n  | \"complementary\"\n  | \"contentinfo\"\n  | \"definition\"\n  | \"dialog\"\n  | \"directory\"\n  | \"document\"\n  | \"feed\"\n  | \"figure\"\n  | \"form\"\n  | \"grid\"\n  | \"gridcell\"\n  | \"group\"\n  | \"heading\"\n  | \"img\"\n  | \"link\"\n  | \"list\"\n  | \"listbox\"\n  | \"listitem\"\n  | \"log\"\n  | \"main\"\n  | \"marquee\"\n  | \"math\"\n  | \"menu\"\n  | \"menubar\"\n  | \"menuitem\"\n  | \"menuitemcheckbox\"\n  | \"menuitemradio\"\n  | \"navigation\"\n  | \"none\"\n  | \"note\"\n  | \"option\"\n  | \"presentation\"\n  | \"progressbar\"\n  | \"radio\"\n  | \"radiogroup\"\n  | \"region\"\n  | \"row\"\n  | \"rowgroup\"\n  | \"rowheader\"\n  | \"scrollbar\"\n  | \"search\"\n  | \"searchbox\"\n  | \"separator\"\n  | \"slider\"\n  | \"spinbutton\"\n  | \"status\"\n  | \"switch\"\n  | \"tab\"\n  | \"table\"\n  | \"tablist\"\n  | \"tabpanel\"\n  | \"term\"\n  | \"textbox\"\n  | \"timer\"\n  | \"toolbar\"\n  | \"tooltip\"\n  | \"tree\"\n  | \"treegrid\"\n  | \"treeitem\";\n\nexport type ControlledElementSelector = { isControlledElement?: true };\n\nexport type RoleSelectorOptions = {\n  method: RoleSelectorMethod;\n  options: Record<string, keyof ByRoleOptions>;\n  role: AriaRole | AriaRole[];\n  // | \"UNKNOWN\" // This should be a `Symbol`, but it can't because this is ultimately going to be JSON stringified. This type will allow passing a custom role if the component allows it: `Box`.\n};\n\nexport type TextSelectorOptions = {\n  method: TextSelectorMethod;\n  options: Record<string, keyof SelectorMatcherOptions>;\n  text: string;\n};\n\nexport type ElementSelectorValue = RoleSelectorOptions | TextSelectorOptions;\n\nexport type ElementSelector = {\n  elementSelector: ElementSelectorValue;\n};\n\nexport type ElementChildSelectorValue = Record<\n  string,\n  TestSelector & ControlledElementSelector\n>;\n\nexport type ElementChildSelector = {\n  children: ElementChildSelectorValue;\n};\n\nexport type AccessibleTextSelectorValue =\n  | \"description\"\n  | \"errorMessage\"\n  | \"label\";\n\nexport type AccessibleTextSelector = {\n  /** An \"accessible -> semantic\" name mapping such as \"`description` -> `hint`\" where \"description\" equates to `\"aria-description\"`. */\n  accessibleText: Record<string, AccessibleTextSelectorValue>;\n};\n\nexport type TestSelector =\n  | ElementChildSelector\n  | ElementSelector\n  | (ElementChildSelector & ElementSelector)\n  | (AccessibleTextSelector & ElementSelector)\n  | (ElementChildSelector & AccessibleTextSelector & ElementSelector);\n"],"mappings":"","ignoreList":[]}