feat: useTableUtils hook (#1281)

resolves #1280

packages/jsapi-components/src/useTableUtils.test.tsx

@@ -0,0 +1,16 @@
+import React from 'react';
+import { ApiContext } from '@deephaven/jsapi-bootstrap';
+import dh from '@deephaven/jsapi-shim';
+import { TableUtils } from '@deephaven/jsapi-utils';
+import { renderHook } from '@testing-library/react-hooks';
+import useTableUtils from './useTableUtils';
+
+const wrapper = ({ children }) => (
+  <ApiContext.Provider value={dh}>{children}</ApiContext.Provider>
+);
+
+it('should return a TableUtils instance based on the current dh api context', () => {
+  const { result } = renderHook(() => useTableUtils(), { wrapper });
+  expect(result.current.dh).toBe(dh);
+  expect(result.current).toBeInstanceOf(TableUtils);
+});

packages/jsapi-components/src/useTableUtils.ts

@@ -0,0 +1,11 @@
+import { useMemo } from 'react';
+import { useApi } from '@deephaven/jsapi-bootstrap';
+import { TableUtils } from '@deephaven/jsapi-utils';
+
+/**
+ * Get a `TableUtils` instance using `dh` api from the current context.
+ */
+export default function useTableUtils(): TableUtils {
+  const dh = useApi();
+  return useMemo(() => new TableUtils(dh), [dh]);
+}