@homebound/beam 2.378.1 → 2.379.1

package/dist/utils/rtlUtils.cjs

@@ -0,0 +1,226 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/utils/rtlUtils.tsx
+var rtlUtils_exports = {};
+__export(rtlUtils_exports, {
+  blur: () => import_rtl_utils.blur,
+  cell: () => cell,
+  cellAnd: () => cellAnd,
+  cellOf: () => cellOf,
+  change: () => import_rtl_utils.change,
+  click: () => import_rtl_utils.click,
+  clickAndWait: () => import_rtl_utils.clickAndWait,
+  focus: () => import_rtl_utils.focus,
+  getOptions: () => getOptions,
+  getSelected: () => getSelected,
+  input: () => import_rtl_utils.input,
+  row: () => row,
+  rowAnd: () => rowAnd,
+  select: () => select,
+  selectAndWait: () => selectAndWait,
+  tableSnapshot: () => tableSnapshot,
+  type: () => import_rtl_utils.type,
+  typeAndWait: () => import_rtl_utils.typeAndWait,
+  wait: () => import_rtl_utils.wait
+});
+module.exports = __toCommonJS(rtlUtils_exports);
+var import_rtl_utils = require("@homebound/rtl-utils");
+var import_react = require("@testing-library/react");
+
+// src/utils/defaultTestId.ts
+var import_change_case = require("change-case");
+
+// src/utils/index.ts
+function fail(message) {
+  throw new Error(message || "Failed");
+}
+
+// src/utils/rtlUtils.tsx
+function cell(r, row2, column) {
+  return cellOf(r, "gridTable", row2, column);
+}
+function cellOf(r, tableTestId, rowNum, column) {
+  return row(r, rowNum, tableTestId).childNodes[column];
+}
+function cellAnd(r, row2, column, testId) {
+  return cell(r, row2, column).querySelector(`[data-testid="${testId}"]`) || fail(`Element not found ${(0, import_react.prettyDOM)(cell(r, row2, column))}`);
+}
+function row(r, row2, tableTestId = "gridTable") {
+  const dataRows = Array.from(r.getByTestId(tableTestId).querySelectorAll("[data-gridrow]"));
+  return dataRows[row2];
+}
+function rowAnd(r, rowNum, testId) {
+  const e = row(r, rowNum);
+  return e.querySelector(`[data-testid="${testId}"]`) || fail(`Element not found ${(0, import_react.prettyDOM)(e)}`);
+}
+function tableSnapshot(r, columnNames = []) {
+  const tableEl = r.getByTestId("gridTable");
+  const dataRows = Array.from(tableEl.querySelectorAll("[data-gridrow]"));
+  const hasExpandableHeader = !!tableEl.querySelector(`[data-testid="expandableColumn"]`);
+  let tableDataAsStrings = dataRows.map((row2) => {
+    return Array.from(row2.childNodes).map(getTextFromTableCellNode);
+  });
+  if (columnNames.length > 0) {
+    const headerCells = tableDataAsStrings[0];
+    if (headerCells) {
+      const columnIndices = columnNames.map((name) => {
+        const i = headerCells.indexOf(name);
+        if (i === -1) throw new Error(`Could not find header '${name}' in ${headerCells.join(", ")}`);
+        return i;
+      });
+      tableDataAsStrings = tableDataAsStrings.map((row2) => columnIndices.map((index) => row2[index]));
+    }
+  }
+  return toMarkupTableString(tableDataAsStrings, hasExpandableHeader);
+}
+function toMarkupTableString(tableRows, hasExpandableHeader) {
+  const columnWidths = tableRows.reduce((acc, row2) => {
+    row2.forEach((cell2, columnIndex) => {
+      const cellWidth = cell2?.length ?? 0;
+      const currentMaxWidth = acc.get(columnIndex) ?? 0;
+      if (cellWidth > currentMaxWidth || !currentMaxWidth) acc.set(columnIndex, cellWidth);
+    });
+    return acc;
+  }, /* @__PURE__ */ new Map());
+  const wrapTableRowEnds = (str) => `| ${str} |`;
+  const rowsWithPaddingAndDividers = tableRows.map((tableCells) => {
+    const formattedRow = tableCells.map((cell2, columnIndex) => {
+      const cellWidth = columnWidths.get(columnIndex) ?? 0;
+      return cell2?.padEnd(cellWidth, " ") || "";
+    }).join(" | ");
+    return wrapTableRowEnds(formattedRow);
+  });
+  const headerDivider = Array.from(columnWidths.values()).map((width) => "-".repeat(width) ?? "").join(" | ");
+  const headerDividerRowNumber = hasExpandableHeader ? 2 : 1;
+  rowsWithPaddingAndDividers.splice(headerDividerRowNumber, 0, wrapTableRowEnds(headerDivider));
+  return `
+${rowsWithPaddingAndDividers.join("\n")}
+`;
+}
+function getTextFromTableCellNode(node) {
+  if (node.nodeType === Node.ELEMENT_NODE) {
+    const element = node;
+    const maybeInput = element.getElementsByTagName("input")[0];
+    if (maybeInput) return maybeInput.value;
+    const maybeTextarea = element.getElementsByTagName("textarea")[0];
+    if (maybeTextarea) return maybeTextarea.value;
+    const maybeSelect = element.getElementsByTagName("select")[0];
+    if (maybeSelect) return maybeSelect.value;
+  }
+  return node.textContent;
+}
+function select(select2, value) {
+  assertListBoxInput(select2);
+  ensureListBoxOpen(select2);
+  const optionValues = Array.isArray(value) ? value : [value];
+  optionValues.forEach((optionValue) => selectOption(select2, optionValue));
+}
+async function selectAndWait(select2, value) {
+  await (0, import_rtl_utils.allowAndWaitForAsyncBehavior)(() => ensureListBoxOpen(select2));
+  return (0, import_rtl_utils.allowAndWaitForAsyncBehavior)(() => {
+    const optionValues = Array.isArray(value) ? value : [value];
+    optionValues.forEach((optionValue) => selectOption(select2, optionValue));
+  });
+}
+function ensureListBoxOpen(select2) {
+  const expanded = select2.getAttribute("aria-expanded") === "true";
+  if (!expanded) {
+    (0, import_rtl_utils.click)(select2);
+  }
+}
+function selectOption(select2, optionValue) {
+  const listbox = findListBox(select2);
+  const options = listbox.querySelectorAll("[role=option]");
+  const optionToSelect = Array.from(options).find(
+    (o) => o.dataset.key === optionValue || o.dataset.label === optionValue
+  );
+  if (!optionToSelect) {
+    throw new Error(`Could not find option with value or text content of ${optionValue}`);
+  }
+  if (optionToSelect.getAttribute("aria-disabled")) {
+    throw new Error(`Cannot select disabled option ${optionValue}`);
+  }
+  (0, import_rtl_utils.click)(optionToSelect);
+}
+function getSelected(select2) {
+  if (isSelectElement(select2)) {
+    throw new Error("Beam getSelected helper does not support <select> elements");
+  }
+  if (!isInputOrTextAreaElement(select2) && select2.dataset.readonly === "true") {
+    return select2.textContent ?? void 0;
+  }
+  ensureListBoxOpen(select2);
+  const listbox = findListBox(select2);
+  const options = listbox.querySelectorAll("[role=option]");
+  const selections = Array.from(options).filter((o) => o.getAttribute("aria-selected") === "true").map((o) => o.dataset.label ?? o.dataset.key ?? "").filter((o) => !!o);
+  return selections.length > 0 ? selections.length > 1 ? selections : selections[0] : void 0;
+}
+function getOptions(select2) {
+  assertListBoxInput(select2);
+  ensureListBoxOpen(select2);
+  const listbox = findListBox(select2);
+  const options = listbox.querySelectorAll("[role=option]");
+  return Array.from(options).map((o) => o.dataset.label ?? o.dataset.key ?? "").filter((o) => !!o);
+}
+function findListBox(select2) {
+  if (select2.tagName === "DIV") fail("SelectField is readOnly");
+  const listboxId = select2.getAttribute("aria-controls") || fail("aria-controls attribute not found, the SelectField is probably readOnly");
+  return document.getElementById(listboxId) || fail("listbox not found");
+}
+function assertListBoxInput(select2) {
+  if (isSelectElement(select2)) {
+    throw new Error("Beam getOptions helper does not support <select> elements");
+  }
+  if (!isInputOrTextAreaElement(select2)) {
+    throw new Error(
+      `Expected element to be INPUT or TEXTAREA, but got ${select2.nodeName}. This field may be read-only. In that case we cannot get the list of options`
+    );
+  }
+  return true;
+}
+function isSelectElement(element) {
+  return element.nodeName === "SELECT";
+}
+function isInputOrTextAreaElement(element) {
+  return element.nodeName === "INPUT" || element.nodeName === "TEXTAREA";
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  blur,
+  cell,
+  cellAnd,
+  cellOf,
+  change,
+  click,
+  clickAndWait,
+  focus,
+  getOptions,
+  getSelected,
+  input,
+  row,
+  rowAnd,
+  select,
+  selectAndWait,
+  tableSnapshot,
+  type,
+  typeAndWait,
+  wait
+});
+//# sourceMappingURL=rtlUtils.cjs.map

package/dist/utils/rtlUtils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/rtlUtils.tsx","../../src/utils/defaultTestId.ts","../../src/utils/index.ts"],"sourcesContent":["import {\n  blur as _blur,\n  change as _change,\n  click as _click,\n  clickAndWait as _clickAndWait,\n  focus as _focus,\n  input as _input,\n  type as _type,\n  typeAndWait as _typeAndWait,\n  wait as _wait,\n  allowAndWaitForAsyncBehavior,\n  RenderResult,\n} from \"@homebound/rtl-utils\";\nimport { prettyDOM } from \"@testing-library/react\";\nimport { fail } from \"src/utils/index\";\n\nexport {\n  _blur as blur,\n  _change as change,\n  _click as click,\n  _clickAndWait as clickAndWait,\n  _focus as focus,\n  _input as input,\n  _type as type,\n  _typeAndWait as typeAndWait,\n  _wait as wait,\n};\n\n// This file is a collection of helpers for interacting with Beam components in tests.\n// We keep it separate from the `src/tests/rtl.tsx` file, which is the Beam tests\n// themselves use, which technically does re-export these `rtlUtils.tsx` helpers, but\n// also includes other helpers that are specific to Beam's test suite.\n//\n// (In particular, we cannot include/export any Beam components, i.e. BeamProvider, from\n// this file, because it ends up as a separate bundle in the `package.json` file, which\n// will be treated as separate components/providers than the primary bundle.)\n\nexport function cell(r: RenderResult, row: number, column: number): HTMLElement {\n  return cellOf(r, \"gridTable\", row, column);\n}\n\nexport function cellOf(r: RenderResult, tableTestId: string, rowNum: number, column: number): HTMLElement {\n  return row(r, rowNum, tableTestId).childNodes[column] as HTMLElement;\n}\n\nexport function cellAnd(r: RenderResult, row: number, column: number, testId: string): HTMLElement {\n  return (\n    cell(r, row, column).querySelector(`[data-testid=\"${testId}\"]`) ||\n    fail(`Element not found ${prettyDOM(cell(r, row, column))}`)\n  );\n}\n\nexport function row(r: RenderResult, row: number, tableTestId: string = \"gridTable\"): HTMLElement {\n  const dataRows = Array.from(r.getByTestId(tableTestId).querySelectorAll(\"[data-gridrow]\"));\n  return dataRows[row] as HTMLElement;\n}\n\nexport function rowAnd(r: RenderResult, rowNum: number, testId: string): HTMLElement {\n  const e = row(r, rowNum);\n  return e.querySelector(`[data-testid=\"${testId}\"]`) || fail(`Element not found ${prettyDOM(e)}`);\n}\n\n/** Intended to be used to generate a human-readable text\n * representation of a GridTable using the markdown table syntax.\n * * Example Use: expect(tableSnapshot(r)).toMatchInlineSnapshot(`\n \"\n | Name                     | Value |\n | ------------------------ | ----- |\n | Row 1                    | 200   |\n | Row 2 with a longer name | 300   |\n | Row 3                    | 1000  |\n \"\n `);\n * */\nexport function tableSnapshot(r: RenderResult, columnNames: string[] = []): string {\n  const tableEl = r.getByTestId(\"gridTable\");\n  const dataRows = Array.from(tableEl.querySelectorAll(\"[data-gridrow]\"));\n  const hasExpandableHeader = !!tableEl.querySelector(`[data-testid=\"expandableColumn\"]`);\n\n  let tableDataAsStrings = dataRows.map((row) => {\n    return Array.from(row.childNodes).map(getTextFromTableCellNode);\n  });\n\n  // If the user wants a subset of columns, look for column names\n  if (columnNames.length > 0) {\n    const headerCells = tableDataAsStrings[0];\n    if (headerCells) {\n      const columnIndices = columnNames.map((name) => {\n        const i = headerCells.indexOf(name);\n        if (i === -1) throw new Error(`Could not find header '${name}' in ${headerCells.join(\", \")}`);\n        return i;\n      });\n      tableDataAsStrings = tableDataAsStrings.map((row) => columnIndices.map((index) => row[index]));\n    }\n  }\n\n  return toMarkupTableString(tableDataAsStrings, hasExpandableHeader);\n}\n\nfunction toMarkupTableString(tableRows: (string | null)[][], hasExpandableHeader: boolean): string {\n  // Find the largest width of each column to set a consistent width for each row\n  const columnWidths = tableRows.reduce((acc, row) => {\n    row.forEach((cell, columnIndex) => {\n      const cellWidth = cell?.length ?? 0;\n      const currentMaxWidth = acc.get(columnIndex) ?? 0;\n      if (cellWidth > currentMaxWidth || !currentMaxWidth) acc.set(columnIndex, cellWidth);\n    });\n\n    return acc;\n  }, new Map<number, number>());\n\n  const wrapTableRowEnds = (str: string) => `| ${str} |`;\n\n  const rowsWithPaddingAndDividers = tableRows.map((tableCells) => {\n    const formattedRow = tableCells\n      .map((cell, columnIndex) => {\n        const cellWidth = columnWidths.get(columnIndex) ?? 0;\n        return cell?.padEnd(cellWidth, \" \") || \"\";\n      })\n      .join(\" | \");\n    return wrapTableRowEnds(formattedRow);\n  });\n\n  const headerDivider = Array.from(columnWidths.values())\n    .map((width) => \"-\".repeat(width) ?? \"\")\n    .join(\" | \");\n\n  const headerDividerRowNumber = hasExpandableHeader ? 2 : 1;\n  rowsWithPaddingAndDividers.splice(headerDividerRowNumber, 0, wrapTableRowEnds(headerDivider));\n\n  // Pad a newline on top and bottom for cleaner diffs\n  return `\\n${rowsWithPaddingAndDividers.join(\"\\n\")}\\n`;\n}\n\n/** Prefer showing a `value` from a mocked input vs. the combined text content from an inputs markup */\nfunction getTextFromTableCellNode(node: ChildNode) {\n  if (node.nodeType === Node.ELEMENT_NODE) {\n    const element = node as HTMLElement;\n\n    const maybeInput = element.getElementsByTagName(\"input\")[0];\n    if (maybeInput) return maybeInput.value;\n\n    const maybeTextarea = element.getElementsByTagName(\"textarea\")[0];\n    if (maybeTextarea) return maybeTextarea.value;\n\n    const maybeSelect = element.getElementsByTagName(\"select\")[0];\n    if (maybeSelect) return maybeSelect.value;\n  }\n\n  return node.textContent;\n}\n\n/**\n * Selects an option from the Beam SelectField, MultiSelectField, and TreeSelectField components.\n *\n * For select fields that support multiple selections, subsequent calls to this function will toggle the selection state of an option.\n *\n * @param value The value or label of the option.\n * */\nexport function select(select: HTMLElement, value: string | string[]) {\n  assertListBoxInput(select);\n  ensureListBoxOpen(select);\n  const optionValues = Array.isArray(value) ? value : [value];\n  optionValues.forEach((optionValue) => selectOption(select, optionValue));\n}\n\nexport async function selectAndWait(select: HTMLElement, value: string | string[]): Promise<void> {\n  // To work with React 18, we need to execute these as separate steps, otherwise\n  // the `ensureListBoxOpen` async render won't flush, and the `selectOption` will fail.\n  await allowAndWaitForAsyncBehavior(() => ensureListBoxOpen(select));\n  return allowAndWaitForAsyncBehavior(() => {\n    const optionValues = Array.isArray(value) ? value : [value];\n    optionValues.forEach((optionValue) => selectOption(select, optionValue));\n  });\n}\n\nfunction ensureListBoxOpen(select: HTMLElement): void {\n  const expanded = select.getAttribute(\"aria-expanded\") === \"true\";\n  if (!expanded) {\n    _click(select);\n  }\n}\n\nfunction selectOption(select: HTMLElement, optionValue: string) {\n  const listbox = findListBox(select);\n  const options: NodeListOf<HTMLElement> = listbox.querySelectorAll(\"[role=option]\");\n  // Allow searching for options by their data-key (value) or textContent (label)\n  const optionToSelect = Array.from(options).find(\n    (o: HTMLElement) => o.dataset.key === optionValue || o.dataset.label === optionValue,\n  );\n  if (!optionToSelect) {\n    throw new Error(`Could not find option with value or text content of ${optionValue}`);\n  }\n  if (optionToSelect.getAttribute(\"aria-disabled\")) {\n    throw new Error(`Cannot select disabled option ${optionValue}`);\n  }\n  _click(optionToSelect);\n}\n\nexport function getSelected(select: HTMLElement): string[] | string | undefined {\n  if (isSelectElement(select)) {\n    throw new Error(\"Beam getSelected helper does not support <select> elements\");\n  }\n\n  if (!isInputOrTextAreaElement(select) && select.dataset.readonly === \"true\") {\n    // For read-only fields that render as a 'div'\n    return select.textContent ?? undefined;\n  }\n\n  ensureListBoxOpen(select);\n\n  const listbox = findListBox(select);\n  const options: NodeListOf<HTMLElement> = listbox.querySelectorAll(\"[role=option]\");\n\n  const selections: string[] = Array.from(options)\n    .filter((o: HTMLElement) => o.getAttribute(\"aria-selected\") === \"true\")\n    .map((o: HTMLElement) => o.dataset.label ?? o.dataset.key ?? \"\")\n    // Filter out empty strings\n    .filter((o) => !!o);\n\n  return selections.length > 0 ? (selections.length > 1 ? selections : selections[0]) : undefined;\n}\n\nexport function getOptions(select: HTMLElement): string[] {\n  assertListBoxInput(select);\n  ensureListBoxOpen(select);\n\n  const listbox = findListBox(select);\n  const options: NodeListOf<HTMLElement> = listbox.querySelectorAll(\"[role=option]\");\n\n  return Array.from(options)\n    .map((o: HTMLElement) => o.dataset.label ?? o.dataset.key ?? \"\")\n    .filter((o) => !!o);\n}\n\nfunction findListBox(select: HTMLElement): HTMLElement {\n  if (select.tagName === \"DIV\") fail(\"SelectField is readOnly\");\n  const listboxId =\n    select.getAttribute(\"aria-controls\") ||\n    fail(\"aria-controls attribute not found, the SelectField is probably readOnly\");\n  return document.getElementById(listboxId) || fail(\"listbox not found\");\n}\n\nfunction assertListBoxInput(select: HTMLElement): select is HTMLInputElement | HTMLTextAreaElement {\n  if (isSelectElement(select)) {\n    throw new Error(\"Beam getOptions helper does not support <select> elements\");\n  }\n  if (!isInputOrTextAreaElement(select)) {\n    throw new Error(\n      `Expected element to be INPUT or TEXTAREA, but got ${select.nodeName}. This field may be read-only. In that case we cannot get the list of options`,\n    );\n  }\n  return true;\n}\n\nfunction isSelectElement(element: HTMLElement): element is HTMLSelectElement {\n  return element.nodeName === \"SELECT\";\n}\n\nfunction isInputOrTextAreaElement(element: HTMLElement): element is HTMLInputElement | HTMLTextAreaElement {\n  return element.nodeName === \"INPUT\" || element.nodeName === \"TEXTAREA\";\n}\n","import { camelCase } from \"change-case\";\n\n/**\n * Guesses an id based on a label string, i.e. given `Homeowner Contract`,\n * returns `homeownerContract`.\n *\n * This is useful for our (non-bound) form fields that will probably have a label,\n * but may not have a `data-testid` set by the encompassing page.\n *\n * (Bound form fields typically set their test id from their form-state field's key.)\n */\nexport function defaultTestId(label: string): string {\n  // Strip `m:4` to `m4` to prevent it from becoming `m_4` which our rtl-utils assumes\n  // means \"the 4th element with a data-testid value of 'm'\".\n  return camelCase(label.replace(\":\", \"\"));\n}\n","import { MutableRefObject } from \"react\";\nimport type { CheckboxGroupState, ToggleState } from \"react-stately\";\n\nexport function fail(message?: string): never {\n  throw new Error(message || \"Failed\");\n}\n\n/** Adapts our state to what useToggleState returns in a stateless manner. */\nexport function toToggleState(isSelected: boolean, onChange: (value: boolean) => void): ToggleState {\n  return {\n    isSelected,\n    setSelected: onChange,\n    toggle: () => onChange(!isSelected),\n  };\n}\n\n/** Adapts our state to what use*Group returns in a stateless manner. */\nexport function toGroupState<T extends string>(values: T[], onChange: (value: T[]) => void): CheckboxGroupState {\n  const addValue = (value: T) => onChange([...values, value]);\n  const removeValue = (value: T) => onChange(values.filter((_value) => _value !== value));\n\n  return {\n    value: values,\n    setValue: onChange,\n    isSelected: (value: T) => values.includes(value),\n    addValue,\n    removeValue,\n    toggleValue: (value: T) => (values.includes(value) ? addValue(value) : removeValue(value)),\n    isDisabled: false,\n    isReadOnly: false,\n    // We do not use the validation state, as our Switch groups do not support error states. However, this field is required by the `CheckboxGroupState` so we need to include it.\n    // If we ever update our SwitchGroup component to support error states, we'll need to update this.\n    validationState: \"valid\",\n  };\n}\n\n/**\n * Utility to maybe call a function if undefined with arguments\n *\n * @example\n *  maybeCall(onChange, true)\n *  maybeCall(onBlur)\n *  maybeCall(onSelect, { id: 1, value: \"book 1\"}, true)\n */\nexport function maybeCall(callback: Function | undefined, ...args: any[]) {\n  return callback && callback(...args);\n}\n\nexport * from \"./useTestIds\";\n\n/** Casts `Object.keys` to \"what it should be\", as long as your instance doesn't have keys it shouldn't. */\nexport function safeKeys<T>(instance: T): (keyof T)[] {\n  return Object.getOwnPropertyNames(instance) as any;\n}\n\n// Returns object with specified key removed\nexport const omitKey = <T, K extends keyof T>(key: K, { [key]: _, ...obj }: T) => obj as T;\n\nexport const noop = (..._: any) => {};\n\ntype Entries<T> = {\n  [K in keyof T]: [K, T[K]];\n}[keyof T][];\n\nexport function safeEntries<T extends object>(obj: T): Entries<T> {\n  return Object.entries(obj) as any;\n}\n\nexport class EmptyRef<T> implements MutableRefObject<T> {\n  get current(): T {\n    throw new Error(\"BeamProvider is missing\");\n  }\n\n  set current(_) {\n    throw new Error(\"BeamProvider is missing\");\n  }\n}\n\nexport const isAbsoluteUrl = (url: string) => /^(http(s?)):\\/\\//i.test(url);\n\nexport function areArraysEqual(a: any[], b: any[]): boolean {\n  return a.length === b.length && a.every((val, idx) => val === b[idx]);\n}\n\nexport function isPromise(obj: any | Promise<any>): obj is Promise<any> {\n  return typeof obj === \"object\" && \"then\" in obj && typeof obj.then === \"function\";\n}\n\nexport function isFunction(f: any): f is Function {\n  return typeof f === \"function\";\n}\n\nexport function isDefined<T extends any>(param: T | undefined | null): param is T {\n  return param !== null && param !== undefined;\n}\n\nexport function pluralize(count: number | unknown[], noun: string, pluralNoun?: string): string {\n  if ((Array.isArray(count) ? count.length : count) === 1) return noun;\n  return pluralNoun || `${noun}s`;\n}\n"],"mappings":"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","names":["_blur","_change","_click","_clickAndWait","_focus","_input","_type","_typeAndWait","_wait","row","cell","select","_click"]}

package/dist/utils/rtlUtils.d.cts

@@ -0,0 +1,34 @@
+import { RenderResult } from '@homebound/rtl-utils';
+export { blur, change, click, clickAndWait, focus, input, type, typeAndWait, wait } from '@homebound/rtl-utils';
+
+declare function cell(r: RenderResult, row: number, column: number): HTMLElement;
+declare function cellOf(r: RenderResult, tableTestId: string, rowNum: number, column: number): HTMLElement;
+declare function cellAnd(r: RenderResult, row: number, column: number, testId: string): HTMLElement;
+declare function row(r: RenderResult, row: number, tableTestId?: string): HTMLElement;
+declare function rowAnd(r: RenderResult, rowNum: number, testId: string): HTMLElement;
+/** Intended to be used to generate a human-readable text
+ * representation of a GridTable using the markdown table syntax.
+ * * Example Use: expect(tableSnapshot(r)).toMatchInlineSnapshot(`
+ "
+ | Name                     | Value |
+ | ------------------------ | ----- |
+ | Row 1                    | 200   |
+ | Row 2 with a longer name | 300   |
+ | Row 3                    | 1000  |
+ "
+ `);
+ * */
+declare function tableSnapshot(r: RenderResult, columnNames?: string[]): string;
+/**
+ * Selects an option from the Beam SelectField, MultiSelectField, and TreeSelectField components.
+ *
+ * For select fields that support multiple selections, subsequent calls to this function will toggle the selection state of an option.
+ *
+ * @param value The value or label of the option.
+ * */
+declare function select(select: HTMLElement, value: string | string[]): void;
+declare function selectAndWait(select: HTMLElement, value: string | string[]): Promise<void>;
+declare function getSelected(select: HTMLElement): string[] | string | undefined;
+declare function getOptions(select: HTMLElement): string[];
+
+export { cell, cellAnd, cellOf, getOptions, getSelected, row, rowAnd, select, selectAndWait, tableSnapshot };

package/dist/utils/rtlUtils.d.ts

@@ -0,0 +1,34 @@
+import { RenderResult } from '@homebound/rtl-utils';
+export { blur, change, click, clickAndWait, focus, input, type, typeAndWait, wait } from '@homebound/rtl-utils';
+
+declare function cell(r: RenderResult, row: number, column: number): HTMLElement;
+declare function cellOf(r: RenderResult, tableTestId: string, rowNum: number, column: number): HTMLElement;
+declare function cellAnd(r: RenderResult, row: number, column: number, testId: string): HTMLElement;
+declare function row(r: RenderResult, row: number, tableTestId?: string): HTMLElement;
+declare function rowAnd(r: RenderResult, rowNum: number, testId: string): HTMLElement;
+/** Intended to be used to generate a human-readable text
+ * representation of a GridTable using the markdown table syntax.
+ * * Example Use: expect(tableSnapshot(r)).toMatchInlineSnapshot(`
+ "
+ | Name                     | Value |
+ | ------------------------ | ----- |
+ | Row 1                    | 200   |
+ | Row 2 with a longer name | 300   |
+ | Row 3                    | 1000  |
+ "
+ `);
+ * */
+declare function tableSnapshot(r: RenderResult, columnNames?: string[]): string;
+/**
+ * Selects an option from the Beam SelectField, MultiSelectField, and TreeSelectField components.
+ *
+ * For select fields that support multiple selections, subsequent calls to this function will toggle the selection state of an option.
+ *
+ * @param value The value or label of the option.
+ * */
+declare function select(select: HTMLElement, value: string | string[]): void;
+declare function selectAndWait(select: HTMLElement, value: string | string[]): Promise<void>;
+declare function getSelected(select: HTMLElement): string[] | string | undefined;
+declare function getOptions(select: HTMLElement): string[];
+
+export { cell, cellAnd, cellOf, getOptions, getSelected, row, rowAnd, select, selectAndWait, tableSnapshot };

package/dist/utils/rtlUtils.js

@@ -0,0 +1,188 @@
+import {
+  fail
+} from "../chunk-ZQBDHF22.js";
+
+// src/utils/rtlUtils.tsx
+import {
+  blur as _blur,
+  change as _change,
+  click as _click,
+  clickAndWait as _clickAndWait,
+  focus as _focus,
+  input as _input,
+  type as _type,
+  typeAndWait as _typeAndWait,
+  wait as _wait,
+  allowAndWaitForAsyncBehavior
+} from "@homebound/rtl-utils";
+import { prettyDOM } from "@testing-library/react";
+function cell(r, row2, column) {
+  return cellOf(r, "gridTable", row2, column);
+}
+function cellOf(r, tableTestId, rowNum, column) {
+  return row(r, rowNum, tableTestId).childNodes[column];
+}
+function cellAnd(r, row2, column, testId) {
+  return cell(r, row2, column).querySelector(`[data-testid="${testId}"]`) || fail(`Element not found ${prettyDOM(cell(r, row2, column))}`);
+}
+function row(r, row2, tableTestId = "gridTable") {
+  const dataRows = Array.from(r.getByTestId(tableTestId).querySelectorAll("[data-gridrow]"));
+  return dataRows[row2];
+}
+function rowAnd(r, rowNum, testId) {
+  const e = row(r, rowNum);
+  return e.querySelector(`[data-testid="${testId}"]`) || fail(`Element not found ${prettyDOM(e)}`);
+}
+function tableSnapshot(r, columnNames = []) {
+  const tableEl = r.getByTestId("gridTable");
+  const dataRows = Array.from(tableEl.querySelectorAll("[data-gridrow]"));
+  const hasExpandableHeader = !!tableEl.querySelector(`[data-testid="expandableColumn"]`);
+  let tableDataAsStrings = dataRows.map((row2) => {
+    return Array.from(row2.childNodes).map(getTextFromTableCellNode);
+  });
+  if (columnNames.length > 0) {
+    const headerCells = tableDataAsStrings[0];
+    if (headerCells) {
+      const columnIndices = columnNames.map((name) => {
+        const i = headerCells.indexOf(name);
+        if (i === -1) throw new Error(`Could not find header '${name}' in ${headerCells.join(", ")}`);
+        return i;
+      });
+      tableDataAsStrings = tableDataAsStrings.map((row2) => columnIndices.map((index) => row2[index]));
+    }
+  }
+  return toMarkupTableString(tableDataAsStrings, hasExpandableHeader);
+}
+function toMarkupTableString(tableRows, hasExpandableHeader) {
+  const columnWidths = tableRows.reduce((acc, row2) => {
+    row2.forEach((cell2, columnIndex) => {
+      const cellWidth = cell2?.length ?? 0;
+      const currentMaxWidth = acc.get(columnIndex) ?? 0;
+      if (cellWidth > currentMaxWidth || !currentMaxWidth) acc.set(columnIndex, cellWidth);
+    });
+    return acc;
+  }, /* @__PURE__ */ new Map());
+  const wrapTableRowEnds = (str) => `| ${str} |`;
+  const rowsWithPaddingAndDividers = tableRows.map((tableCells) => {
+    const formattedRow = tableCells.map((cell2, columnIndex) => {
+      const cellWidth = columnWidths.get(columnIndex) ?? 0;
+      return cell2?.padEnd(cellWidth, " ") || "";
+    }).join(" | ");
+    return wrapTableRowEnds(formattedRow);
+  });
+  const headerDivider = Array.from(columnWidths.values()).map((width) => "-".repeat(width) ?? "").join(" | ");
+  const headerDividerRowNumber = hasExpandableHeader ? 2 : 1;
+  rowsWithPaddingAndDividers.splice(headerDividerRowNumber, 0, wrapTableRowEnds(headerDivider));
+  return `
+${rowsWithPaddingAndDividers.join("\n")}
+`;
+}
+function getTextFromTableCellNode(node) {
+  if (node.nodeType === Node.ELEMENT_NODE) {
+    const element = node;
+    const maybeInput = element.getElementsByTagName("input")[0];
+    if (maybeInput) return maybeInput.value;
+    const maybeTextarea = element.getElementsByTagName("textarea")[0];
+    if (maybeTextarea) return maybeTextarea.value;
+    const maybeSelect = element.getElementsByTagName("select")[0];
+    if (maybeSelect) return maybeSelect.value;
+  }
+  return node.textContent;
+}
+function select(select2, value) {
+  assertListBoxInput(select2);
+  ensureListBoxOpen(select2);
+  const optionValues = Array.isArray(value) ? value : [value];
+  optionValues.forEach((optionValue) => selectOption(select2, optionValue));
+}
+async function selectAndWait(select2, value) {
+  await allowAndWaitForAsyncBehavior(() => ensureListBoxOpen(select2));
+  return allowAndWaitForAsyncBehavior(() => {
+    const optionValues = Array.isArray(value) ? value : [value];
+    optionValues.forEach((optionValue) => selectOption(select2, optionValue));
+  });
+}
+function ensureListBoxOpen(select2) {
+  const expanded = select2.getAttribute("aria-expanded") === "true";
+  if (!expanded) {
+    _click(select2);
+  }
+}
+function selectOption(select2, optionValue) {
+  const listbox = findListBox(select2);
+  const options = listbox.querySelectorAll("[role=option]");
+  const optionToSelect = Array.from(options).find(
+    (o) => o.dataset.key === optionValue || o.dataset.label === optionValue
+  );
+  if (!optionToSelect) {
+    throw new Error(`Could not find option with value or text content of ${optionValue}`);
+  }
+  if (optionToSelect.getAttribute("aria-disabled")) {
+    throw new Error(`Cannot select disabled option ${optionValue}`);
+  }
+  _click(optionToSelect);
+}
+function getSelected(select2) {
+  if (isSelectElement(select2)) {
+    throw new Error("Beam getSelected helper does not support <select> elements");
+  }
+  if (!isInputOrTextAreaElement(select2) && select2.dataset.readonly === "true") {
+    return select2.textContent ?? void 0;
+  }
+  ensureListBoxOpen(select2);
+  const listbox = findListBox(select2);
+  const options = listbox.querySelectorAll("[role=option]");
+  const selections = Array.from(options).filter((o) => o.getAttribute("aria-selected") === "true").map((o) => o.dataset.label ?? o.dataset.key ?? "").filter((o) => !!o);
+  return selections.length > 0 ? selections.length > 1 ? selections : selections[0] : void 0;
+}
+function getOptions(select2) {
+  assertListBoxInput(select2);
+  ensureListBoxOpen(select2);
+  const listbox = findListBox(select2);
+  const options = listbox.querySelectorAll("[role=option]");
+  return Array.from(options).map((o) => o.dataset.label ?? o.dataset.key ?? "").filter((o) => !!o);
+}
+function findListBox(select2) {
+  if (select2.tagName === "DIV") fail("SelectField is readOnly");
+  const listboxId = select2.getAttribute("aria-controls") || fail("aria-controls attribute not found, the SelectField is probably readOnly");
+  return document.getElementById(listboxId) || fail("listbox not found");
+}
+function assertListBoxInput(select2) {
+  if (isSelectElement(select2)) {
+    throw new Error("Beam getOptions helper does not support <select> elements");
+  }
+  if (!isInputOrTextAreaElement(select2)) {
+    throw new Error(
+      `Expected element to be INPUT or TEXTAREA, but got ${select2.nodeName}. This field may be read-only. In that case we cannot get the list of options`
+    );
+  }
+  return true;
+}
+function isSelectElement(element) {
+  return element.nodeName === "SELECT";
+}
+function isInputOrTextAreaElement(element) {
+  return element.nodeName === "INPUT" || element.nodeName === "TEXTAREA";
+}
+export {
+  _blur as blur,
+  cell,
+  cellAnd,
+  cellOf,
+  _change as change,
+  _click as click,
+  _clickAndWait as clickAndWait,
+  _focus as focus,
+  getOptions,
+  getSelected,
+  _input as input,
+  row,
+  rowAnd,
+  select,
+  selectAndWait,
+  tableSnapshot,
+  _type as type,
+  _typeAndWait as typeAndWait,
+  _wait as wait
+};
+//# sourceMappingURL=rtlUtils.js.map

package/dist/utils/rtlUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/rtlUtils.tsx"],"sourcesContent":["import {\n  blur as _blur,\n  change as _change,\n  click as _click,\n  clickAndWait as _clickAndWait,\n  focus as _focus,\n  input as _input,\n  type as _type,\n  typeAndWait as _typeAndWait,\n  wait as _wait,\n  allowAndWaitForAsyncBehavior,\n  RenderResult,\n} from \"@homebound/rtl-utils\";\nimport { prettyDOM } from \"@testing-library/react\";\nimport { fail } from \"src/utils/index\";\n\nexport {\n  _blur as blur,\n  _change as change,\n  _click as click,\n  _clickAndWait as clickAndWait,\n  _focus as focus,\n  _input as input,\n  _type as type,\n  _typeAndWait as typeAndWait,\n  _wait as wait,\n};\n\n// This file is a collection of helpers for interacting with Beam components in tests.\n// We keep it separate from the `src/tests/rtl.tsx` file, which is the Beam tests\n// themselves use, which technically does re-export these `rtlUtils.tsx` helpers, but\n// also includes other helpers that are specific to Beam's test suite.\n//\n// (In particular, we cannot include/export any Beam components, i.e. BeamProvider, from\n// this file, because it ends up as a separate bundle in the `package.json` file, which\n// will be treated as separate components/providers than the primary bundle.)\n\nexport function cell(r: RenderResult, row: number, column: number): HTMLElement {\n  return cellOf(r, \"gridTable\", row, column);\n}\n\nexport function cellOf(r: RenderResult, tableTestId: string, rowNum: number, column: number): HTMLElement {\n  return row(r, rowNum, tableTestId).childNodes[column] as HTMLElement;\n}\n\nexport function cellAnd(r: RenderResult, row: number, column: number, testId: string): HTMLElement {\n  return (\n    cell(r, row, column).querySelector(`[data-testid=\"${testId}\"]`) ||\n    fail(`Element not found ${prettyDOM(cell(r, row, column))}`)\n  );\n}\n\nexport function row(r: RenderResult, row: number, tableTestId: string = \"gridTable\"): HTMLElement {\n  const dataRows = Array.from(r.getByTestId(tableTestId).querySelectorAll(\"[data-gridrow]\"));\n  return dataRows[row] as HTMLElement;\n}\n\nexport function rowAnd(r: RenderResult, rowNum: number, testId: string): HTMLElement {\n  const e = row(r, rowNum);\n  return e.querySelector(`[data-testid=\"${testId}\"]`) || fail(`Element not found ${prettyDOM(e)}`);\n}\n\n/** Intended to be used to generate a human-readable text\n * representation of a GridTable using the markdown table syntax.\n * * Example Use: expect(tableSnapshot(r)).toMatchInlineSnapshot(`\n \"\n | Name                     | Value |\n | ------------------------ | ----- |\n | Row 1                    | 200   |\n | Row 2 with a longer name | 300   |\n | Row 3                    | 1000  |\n \"\n `);\n * */\nexport function tableSnapshot(r: RenderResult, columnNames: string[] = []): string {\n  const tableEl = r.getByTestId(\"gridTable\");\n  const dataRows = Array.from(tableEl.querySelectorAll(\"[data-gridrow]\"));\n  const hasExpandableHeader = !!tableEl.querySelector(`[data-testid=\"expandableColumn\"]`);\n\n  let tableDataAsStrings = dataRows.map((row) => {\n    return Array.from(row.childNodes).map(getTextFromTableCellNode);\n  });\n\n  // If the user wants a subset of columns, look for column names\n  if (columnNames.length > 0) {\n    const headerCells = tableDataAsStrings[0];\n    if (headerCells) {\n      const columnIndices = columnNames.map((name) => {\n        const i = headerCells.indexOf(name);\n        if (i === -1) throw new Error(`Could not find header '${name}' in ${headerCells.join(\", \")}`);\n        return i;\n      });\n      tableDataAsStrings = tableDataAsStrings.map((row) => columnIndices.map((index) => row[index]));\n    }\n  }\n\n  return toMarkupTableString(tableDataAsStrings, hasExpandableHeader);\n}\n\nfunction toMarkupTableString(tableRows: (string | null)[][], hasExpandableHeader: boolean): string {\n  // Find the largest width of each column to set a consistent width for each row\n  const columnWidths = tableRows.reduce((acc, row) => {\n    row.forEach((cell, columnIndex) => {\n      const cellWidth = cell?.length ?? 0;\n      const currentMaxWidth = acc.get(columnIndex) ?? 0;\n      if (cellWidth > currentMaxWidth || !currentMaxWidth) acc.set(columnIndex, cellWidth);\n    });\n\n    return acc;\n  }, new Map<number, number>());\n\n  const wrapTableRowEnds = (str: string) => `| ${str} |`;\n\n  const rowsWithPaddingAndDividers = tableRows.map((tableCells) => {\n    const formattedRow = tableCells\n      .map((cell, columnIndex) => {\n        const cellWidth = columnWidths.get(columnIndex) ?? 0;\n        return cell?.padEnd(cellWidth, \" \") || \"\";\n      })\n      .join(\" | \");\n    return wrapTableRowEnds(formattedRow);\n  });\n\n  const headerDivider = Array.from(columnWidths.values())\n    .map((width) => \"-\".repeat(width) ?? \"\")\n    .join(\" | \");\n\n  const headerDividerRowNumber = hasExpandableHeader ? 2 : 1;\n  rowsWithPaddingAndDividers.splice(headerDividerRowNumber, 0, wrapTableRowEnds(headerDivider));\n\n  // Pad a newline on top and bottom for cleaner diffs\n  return `\\n${rowsWithPaddingAndDividers.join(\"\\n\")}\\n`;\n}\n\n/** Prefer showing a `value` from a mocked input vs. the combined text content from an inputs markup */\nfunction getTextFromTableCellNode(node: ChildNode) {\n  if (node.nodeType === Node.ELEMENT_NODE) {\n    const element = node as HTMLElement;\n\n    const maybeInput = element.getElementsByTagName(\"input\")[0];\n    if (maybeInput) return maybeInput.value;\n\n    const maybeTextarea = element.getElementsByTagName(\"textarea\")[0];\n    if (maybeTextarea) return maybeTextarea.value;\n\n    const maybeSelect = element.getElementsByTagName(\"select\")[0];\n    if (maybeSelect) return maybeSelect.value;\n  }\n\n  return node.textContent;\n}\n\n/**\n * Selects an option from the Beam SelectField, MultiSelectField, and TreeSelectField components.\n *\n * For select fields that support multiple selections, subsequent calls to this function will toggle the selection state of an option.\n *\n * @param value The value or label of the option.\n * */\nexport function select(select: HTMLElement, value: string | string[]) {\n  assertListBoxInput(select);\n  ensureListBoxOpen(select);\n  const optionValues = Array.isArray(value) ? value : [value];\n  optionValues.forEach((optionValue) => selectOption(select, optionValue));\n}\n\nexport async function selectAndWait(select: HTMLElement, value: string | string[]): Promise<void> {\n  // To work with React 18, we need to execute these as separate steps, otherwise\n  // the `ensureListBoxOpen` async render won't flush, and the `selectOption` will fail.\n  await allowAndWaitForAsyncBehavior(() => ensureListBoxOpen(select));\n  return allowAndWaitForAsyncBehavior(() => {\n    const optionValues = Array.isArray(value) ? value : [value];\n    optionValues.forEach((optionValue) => selectOption(select, optionValue));\n  });\n}\n\nfunction ensureListBoxOpen(select: HTMLElement): void {\n  const expanded = select.getAttribute(\"aria-expanded\") === \"true\";\n  if (!expanded) {\n    _click(select);\n  }\n}\n\nfunction selectOption(select: HTMLElement, optionValue: string) {\n  const listbox = findListBox(select);\n  const options: NodeListOf<HTMLElement> = listbox.querySelectorAll(\"[role=option]\");\n  // Allow searching for options by their data-key (value) or textContent (label)\n  const optionToSelect = Array.from(options).find(\n    (o: HTMLElement) => o.dataset.key === optionValue || o.dataset.label === optionValue,\n  );\n  if (!optionToSelect) {\n    throw new Error(`Could not find option with value or text content of ${optionValue}`);\n  }\n  if (optionToSelect.getAttribute(\"aria-disabled\")) {\n    throw new Error(`Cannot select disabled option ${optionValue}`);\n  }\n  _click(optionToSelect);\n}\n\nexport function getSelected(select: HTMLElement): string[] | string | undefined {\n  if (isSelectElement(select)) {\n    throw new Error(\"Beam getSelected helper does not support <select> elements\");\n  }\n\n  if (!isInputOrTextAreaElement(select) && select.dataset.readonly === \"true\") {\n    // For read-only fields that render as a 'div'\n    return select.textContent ?? undefined;\n  }\n\n  ensureListBoxOpen(select);\n\n  const listbox = findListBox(select);\n  const options: NodeListOf<HTMLElement> = listbox.querySelectorAll(\"[role=option]\");\n\n  const selections: string[] = Array.from(options)\n    .filter((o: HTMLElement) => o.getAttribute(\"aria-selected\") === \"true\")\n    .map((o: HTMLElement) => o.dataset.label ?? o.dataset.key ?? \"\")\n    // Filter out empty strings\n    .filter((o) => !!o);\n\n  return selections.length > 0 ? (selections.length > 1 ? selections : selections[0]) : undefined;\n}\n\nexport function getOptions(select: HTMLElement): string[] {\n  assertListBoxInput(select);\n  ensureListBoxOpen(select);\n\n  const listbox = findListBox(select);\n  const options: NodeListOf<HTMLElement> = listbox.querySelectorAll(\"[role=option]\");\n\n  return Array.from(options)\n    .map((o: HTMLElement) => o.dataset.label ?? o.dataset.key ?? \"\")\n    .filter((o) => !!o);\n}\n\nfunction findListBox(select: HTMLElement): HTMLElement {\n  if (select.tagName === \"DIV\") fail(\"SelectField is readOnly\");\n  const listboxId =\n    select.getAttribute(\"aria-controls\") ||\n    fail(\"aria-controls attribute not found, the SelectField is probably readOnly\");\n  return document.getElementById(listboxId) || fail(\"listbox not found\");\n}\n\nfunction assertListBoxInput(select: HTMLElement): select is HTMLInputElement | HTMLTextAreaElement {\n  if (isSelectElement(select)) {\n    throw new Error(\"Beam getOptions helper does not support <select> elements\");\n  }\n  if (!isInputOrTextAreaElement(select)) {\n    throw new Error(\n      `Expected element to be INPUT or TEXTAREA, but got ${select.nodeName}. This field may be read-only. In that case we cannot get the list of options`,\n    );\n  }\n  return true;\n}\n\nfunction isSelectElement(element: HTMLElement): element is HTMLSelectElement {\n  return element.nodeName === \"SELECT\";\n}\n\nfunction isInputOrTextAreaElement(element: HTMLElement): element is HTMLInputElement | HTMLTextAreaElement {\n  return element.nodeName === \"INPUT\" || element.nodeName === \"TEXTAREA\";\n}\n"],"mappings":"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","names":["row","cell","select"]}