@okta/odyssey-contribution-tooling 1.47.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"getComputedAccessibleText.cjs","names":["_domAccessibilityApi","require","_getComputedAccessibleErrorMessageText","accessibleTextSelector","exports","description","computeAccessibleDescription","errorMessage","getComputedAccessibleErrorMessageText","label","computeAccessibleName","getComputedAccessibleText","element","type"],"sources":["../../../src/test-selectors/getComputedAccessibleText.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  computeAccessibleDescription,\n  computeAccessibleName,\n} from \"dom-accessibility-api\";\n\nimport { getComputedAccessibleErrorMessageText } from \"./getComputedAccessibleErrorMessageText.js\";\nimport { type AccessibleTextSelectorValue } from \"./testSelector.js\";\n\nexport const accessibleTextSelector = {\n  description: computeAccessibleDescription,\n  errorMessage: getComputedAccessibleErrorMessageText,\n  label: computeAccessibleName,\n} as const satisfies Record<\n  AccessibleTextSelectorValue,\n  (element: HTMLElement) => string\n>;\n\nexport const getComputedAccessibleText = ({\n  element,\n  type,\n}: {\n  element: HTMLElement;\n  type: AccessibleTextSelectorValue;\n}) => accessibleTextSelector[type](element);\n"],"mappings":";;;;;;AAYA,IAAAA,oBAAA,GAAAC,OAAA;AAKA,IAAAC,sCAAA,GAAAD,OAAA;AAjBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAUO,MAAME,sBAAsB,GAAAC,OAAA,CAAAD,sBAAA,GAAG;EACpCE,WAAW,EAAEC,iDAA4B;EACzCC,YAAY,EAAEC,4EAAqC;EACnDC,KAAK,EAAEC;AACT,CAGC;AAEM,MAAMC,yBAAyB,GAAGA,CAAC;EACxCC,OAAO;EACPC;AAIF,CAAC,KAAKV,sBAAsB,CAACU,IAAI,CAAC,CAACD,OAAO,CAAC;AAACR,OAAA,CAAAO,yBAAA,GAAAA,yBAAA","ignoreList":[]}

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

@@ -0,0 +1,50 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _linkedHtmlSelectors = require("./linkedHtmlSelectors.cjs");
+Object.keys(_linkedHtmlSelectors).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _linkedHtmlSelectors[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _linkedHtmlSelectors[key];
+    }
+  });
+});
+var _queryOdysseySelector = require("./queryOdysseySelector.cjs");
+Object.keys(_queryOdysseySelector).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _queryOdysseySelector[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _queryOdysseySelector[key];
+    }
+  });
+});
+var _querySelector = require("./querySelector.cjs");
+Object.keys(_querySelector).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _querySelector[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _querySelector[key];
+    }
+  });
+});
+var _testSelector = require("./testSelector.cjs");
+Object.keys(_testSelector).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _testSelector[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _testSelector[key];
+    }
+  });
+});
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["_linkedHtmlSelectors","require","Object","keys","forEach","key","exports","defineProperty","enumerable","get","_queryOdysseySelector","_querySelector","_testSelector"],"sources":["../../../src/test-selectors/index.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\nexport * from \"./linkedHtmlSelectors.js\";\nexport * from \"./queryOdysseySelector.js\";\nexport * from \"./querySelector.js\";\nexport * from \"./testSelector.js\";\n"],"mappings":";;;;;AAYA,IAAAA,oBAAA,GAAAC,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAH,oBAAA,EAAAI,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAL,oBAAA,CAAAK,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAT,oBAAA,CAAAK,GAAA;IAAA;EAAA;AAAA;AACA,IAAAK,qBAAA,GAAAT,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAO,qBAAA,EAAAN,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAK,qBAAA,CAAAL,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAC,qBAAA,CAAAL,GAAA;IAAA;EAAA;AAAA;AACA,IAAAM,cAAA,GAAAV,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAQ,cAAA,EAAAP,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAM,cAAA,CAAAN,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAE,cAAA,CAAAN,GAAA;IAAA;EAAA;AAAA;AACA,IAAAO,aAAA,GAAAX,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAS,aAAA,EAAAR,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAO,aAAA,CAAAP,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAG,aAAA,CAAAP,GAAA;IAAA;EAAA;AAAA","ignoreList":[]}

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

@@ -0,0 +1,33 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isRegExpString = exports.interpolateString = 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.
+ */
+
+const isRegExpString = string => /^\/*(.+)\/$/.test(string);
+exports.isRegExpString = isRegExpString;
+const interpolateString = (string, replacements) => {
+  const interpolatedString = eval(`
+    ${Object.entries(replacements).map(([variableName, value]) => `const ${variableName} = ${typeof value === "string" ? JSON.stringify(value) : value};`).join("")}
+
+    \`${string}\`
+  `);
+  if (isRegExpString(interpolatedString)) {
+    return eval(interpolatedString);
+  }
+  return interpolatedString;
+};
+exports.interpolateString = interpolateString;
+//# sourceMappingURL=interpolateString.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interpolateString.cjs","names":["isRegExpString","string","test","exports","interpolateString","replacements","interpolatedString","eval","Object","entries","map","variableName","value","JSON","stringify","join"],"sources":["../../../src/test-selectors/interpolateString.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\nexport const isRegExpString = (string: string) => /^\\/*(.+)\\/$/.test(string);\n\n/** @deprecated This function is only to be used to interpolate strings in unit tests. It uses `eval` internally which could be unsafe if it wasn't done explicitly in our testing environment. */\nexport const interpolateString = (\n  string: string,\n  replacements: Record<string, string | RegExp>,\n) => {\n  // Writes out all replacement pairs as \"const variableName = value\" because we don't know which we want. Then at the end, we `return` the value we want by simply adding it as the last thing in eval'd code.\n  const interpolatedString = eval(`\n    ${Object.entries(replacements)\n      .map(\n        ([variableName, value]) =>\n          `const ${variableName} = ${\n            typeof value === \"string\" ? JSON.stringify(value) : value\n          };`,\n      )\n      .join(\"\")}\n\n    \\`${string}\\`\n  `) as string;\n\n  if (isRegExpString(interpolatedString)) {\n    // If this string matches the RegExp format, we know that it's a RegExp, and we'll evaluate it to one. TypeScript has no way of knowing the resulting type, so we have to set that ourselves.\n    return eval(interpolatedString) as RegExp;\n  }\n\n  // This interpolated string is just a string.\n  return interpolatedString;\n};\n"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEO,MAAMA,cAAc,GAAIC,MAAc,IAAK,aAAa,CAACC,IAAI,CAACD,MAAM,CAAC;AAACE,OAAA,CAAAH,cAAA,GAAAA,cAAA;AAGtE,MAAMI,iBAAiB,GAAGA,CAC/BH,MAAc,EACdI,YAA6C,KAC1C;EAEH,MAAMC,kBAAkB,GAAGC,IAAI,CAAC;AAClC,MAAMC,MAAM,CAACC,OAAO,CAACJ,YAAY,CAAC,CAC3BK,GAAG,CACF,CAAC,CAACC,YAAY,EAAEC,KAAK,CAAC,KACpB,SAASD,YAAY,MACnB,OAAOC,KAAK,KAAK,QAAQ,GAAGC,IAAI,CAACC,SAAS,CAACF,KAAK,CAAC,GAAGA,KAAK,GAE/D,CAAC,CACAG,IAAI,CAAC,EAAE,CAAC;AACf;AACA,QAAQd,MAAM;AACd,GAAG,CAAW;EAEZ,IAAID,cAAc,CAACM,kBAAkB,CAAC,EAAE;IAEtC,OAAOC,IAAI,CAACD,kBAAkB,CAAC;EACjC;EAGA,OAAOA,kBAAkB;AAC3B,CAAC;AAACH,OAAA,CAAAC,iBAAA,GAAAA,iBAAA","ignoreList":[]}

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

@@ -0,0 +1,40 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getControlledElement = void 0;
+var _domAccessibilityApi = require("dom-accessibility-api");
+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 getControlledElement = ({
+  element,
+  role
+}) => {
+  if (element instanceof HTMLInputElement && element.list) {
+    return element.list;
+  }
+  if (element.getAttribute("aria-expanded") === "false") {
+    throw new _sanityChecks.ElementError("Popup isn't open in ARIA; therefore, it cannot be captured.", element);
+  }
+  const linkedElementIds = element.getAttribute("aria-controls") || element.getAttribute("aria-owns");
+  if (!linkedElementIds) {
+    throw new _sanityChecks.ElementError("Popup isn't linked; therefore, it cannot be captured.", element);
+  }
+  const linkedElement = linkedElementIds.split(" ").map(linkedElementId => element.ownerDocument.getElementById(linkedElementId)).filter(linkedElement => Boolean(linkedElement)).find(linkedElement => role ? (0, _domAccessibilityApi.getRole)(linkedElement) === role : Boolean(linkedElement));
+  if (!linkedElement) {
+    throw new _sanityChecks.ElementError("Controlled element isn't available; therefore, it cannot be captured.", element);
+  }
+  return linkedElement;
+};
+exports.getControlledElement = getControlledElement;
+//# sourceMappingURL=linkedHtmlSelectors.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"linkedHtmlSelectors.cjs","names":["_domAccessibilityApi","require","_sanityChecks","getControlledElement","element","role","HTMLInputElement","list","getAttribute","ElementError","linkedElementIds","linkedElement","split","map","linkedElementId","ownerDocument","getElementById","filter","Boolean","find","getRole","exports"],"sources":["../../../src/test-selectors/linkedHtmlSelectors.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 { getRole } from \"dom-accessibility-api\";\nimport { type AriaRole } from \"react\";\n\nimport { ElementError } from \"./sanityChecks.js\";\n\n/**\n * For `aria-haspopup`:\n * @see https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-haspopup\n * For `datalist`:\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/datalist\n */\nexport const getControlledElement = ({\n  element,\n  role,\n}: {\n  element: HTMLElement;\n  /** If this element controls multiple items, it might be valuable to help narrow down the specific item's `role`. */\n  role?: AriaRole;\n}) => {\n  if (element instanceof HTMLInputElement && element.list) {\n    return element.list;\n  }\n\n  if (element.getAttribute(\"aria-expanded\") === \"false\") {\n    throw new ElementError(\n      \"Popup isn't open in ARIA; therefore, it cannot be captured.\",\n      element,\n    );\n  }\n\n  const linkedElementIds =\n    element.getAttribute(\"aria-controls\") || element.getAttribute(\"aria-owns\");\n\n  if (!linkedElementIds) {\n    throw new ElementError(\n      \"Popup isn't linked; therefore, it cannot be captured.\",\n      element,\n    );\n  }\n\n  const linkedElement = linkedElementIds\n    .split(\" \")\n    .map((linkedElementId) =>\n      element.ownerDocument.getElementById(linkedElementId),\n    )\n    // This can be `.filter(Boolean)` when Inferred Type Predicates is in TypeScript (which should be part of the version we're using): https://www.typescriptlang.org/docs/handbook/release-notes/typescript-5-5.html#:~:text=Inferred%20Type%20Predicates,Thanks%20Dan!\n    .filter((linkedElement): linkedElement is HTMLElement =>\n      Boolean(linkedElement),\n    )\n    .find((linkedElement) =>\n      role ? getRole(linkedElement) === role : Boolean(linkedElement),\n    );\n\n  if (!linkedElement) {\n    throw new ElementError(\n      \"Controlled element isn't available; therefore, it cannot be captured.\",\n      element,\n    );\n  }\n\n  return linkedElement;\n};\n"],"mappings":";;;;;;AAYA,IAAAA,oBAAA,GAAAC,OAAA;AAGA,IAAAC,aAAA,GAAAD,OAAA;AAfA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,GAaO,MAAME,oBAAoB,GAAGA,CAAC;EACnCC,OAAO;EACPC;AAKF,CAAC,KAAK;EACJ,IAAID,OAAO,YAAYE,gBAAgB,IAAIF,OAAO,CAACG,IAAI,EAAE;IACvD,OAAOH,OAAO,CAACG,IAAI;EACrB;EAEA,IAAIH,OAAO,CAACI,YAAY,CAAC,eAAe,CAAC,KAAK,OAAO,EAAE;IACrD,MAAM,IAAIC,0BAAY,CACpB,6DAA6D,EAC7DL,OACF,CAAC;EACH;EAEA,MAAMM,gBAAgB,GACpBN,OAAO,CAACI,YAAY,CAAC,eAAe,CAAC,IAAIJ,OAAO,CAACI,YAAY,CAAC,WAAW,CAAC;EAE5E,IAAI,CAACE,gBAAgB,EAAE;IACrB,MAAM,IAAID,0BAAY,CACpB,uDAAuD,EACvDL,OACF,CAAC;EACH;EAEA,MAAMO,aAAa,GAAGD,gBAAgB,CACnCE,KAAK,CAAC,GAAG,CAAC,CACVC,GAAG,CAAEC,eAAe,IACnBV,OAAO,CAACW,aAAa,CAACC,cAAc,CAACF,eAAe,CACtD,CAAC,CAEAG,MAAM,CAAEN,aAAa,IACpBO,OAAO,CAACP,aAAa,CACvB,CAAC,CACAQ,IAAI,CAAER,aAAa,IAClBN,IAAI,GAAG,IAAAe,4BAAO,EAACT,aAAa,CAAC,KAAKN,IAAI,GAAGa,OAAO,CAACP,aAAa,CAChE,CAAC;EAEH,IAAI,CAACA,aAAa,EAAE;IAClB,MAAM,IAAIF,0BAAY,CACpB,uEAAuE,EACvEL,OACF,CAAC;EACH;EAEA,OAAOO,aAAa;AACtB,CAAC;AAACU,OAAA,CAAAlB,oBAAA,GAAAA,oBAAA","ignoreList":[]}

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

@@ -0,0 +1,34 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.queryOdysseySelector = exports.odysseyTestSelector = void 0;
+var _AutocompleteTestSelector = require("./AutocompleteTestSelector.cjs");
+var _CalloutTestSelector = require("./CalloutTestSelector.cjs");
+var _querySelector = require("./querySelector.cjs");
+var _SelectTestSelector = require("./SelectTestSelector.cjs");
+var _TabsTestSelector = require("./TabsTestSelector.cjs");
+var _TextFieldTestSelector = require("./TextFieldTestSelector.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 odysseyTestSelector = exports.odysseyTestSelector = {
+  Autocomplete: _AutocompleteTestSelector.AutocompleteTestSelector,
+  Callout: _CalloutTestSelector.CalloutTestSelector,
+  Select: _SelectTestSelector.SelectTestSelector,
+  Tabs: _TabsTestSelector.TabsTestSelector,
+  TextField: _TextFieldTestSelector.TextFieldTestSelector
+};
+const queryOdysseySelector = componentName => (0, _querySelector.querySelector)(odysseyTestSelector[componentName]);
+exports.queryOdysseySelector = queryOdysseySelector;
+//# sourceMappingURL=queryOdysseySelector.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queryOdysseySelector.cjs","names":["_AutocompleteTestSelector","require","_CalloutTestSelector","_querySelector","_SelectTestSelector","_TabsTestSelector","_TextFieldTestSelector","odysseyTestSelector","exports","Autocomplete","AutocompleteTestSelector","Callout","CalloutTestSelector","Select","SelectTestSelector","Tabs","TabsTestSelector","TextField","TextFieldTestSelector","queryOdysseySelector","componentName","querySelector"],"sources":["../../../src/test-selectors/queryOdysseySelector.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 { AutocompleteTestSelector } from \"./AutocompleteTestSelector.js\";\nimport { CalloutTestSelector } from \"./CalloutTestSelector.js\";\nimport { querySelector } from \"./querySelector.js\";\nimport { SelectTestSelector } from \"./SelectTestSelector.js\";\nimport { TabsTestSelector } from \"./TabsTestSelector.js\";\nimport { type TestSelector } from \"./testSelector.js\";\nimport { TextFieldTestSelector } from \"./TextFieldTestSelector.js\";\n\nexport const odysseyTestSelector = {\n  Autocomplete: AutocompleteTestSelector,\n  Callout: CalloutTestSelector,\n  Select: SelectTestSelector,\n  Tabs: TabsTestSelector,\n  TextField: TextFieldTestSelector,\n} as const satisfies Record<string, TestSelector>;\n\nexport const queryOdysseySelector = <\n  ComponentName extends keyof typeof odysseyTestSelector,\n>(\n  /**\n   * Name of the component you want to select within.\n   */\n  componentName: ComponentName,\n) => querySelector(odysseyTestSelector[componentName]);\n"],"mappings":";;;;;;AAYA,IAAAA,yBAAA,GAAAC,OAAA;AACA,IAAAC,oBAAA,GAAAD,OAAA;AACA,IAAAE,cAAA,GAAAF,OAAA;AACA,IAAAG,mBAAA,GAAAH,OAAA;AACA,IAAAI,iBAAA,GAAAJ,OAAA;AAEA,IAAAK,sBAAA,GAAAL,OAAA;AAlBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAUO,MAAMM,mBAAmB,GAAAC,OAAA,CAAAD,mBAAA,GAAG;EACjCE,YAAY,EAAEC,kDAAwB;EACtCC,OAAO,EAAEC,wCAAmB;EAC5BC,MAAM,EAAEC,sCAAkB;EAC1BC,IAAI,EAAEC,kCAAgB;EACtBC,SAAS,EAAEC;AACb,CAAiD;AAE1C,MAAMC,oBAAoB,GAM/BC,aAA4B,IACzB,IAAAC,4BAAa,EAACd,mBAAmB,CAACa,aAAa,CAAC,CAAC;AAACZ,OAAA,CAAAW,oBAAA,GAAAA,oBAAA","ignoreList":[]}

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":[]}