@react-md/core 1.0.0-next.8 → 1.0.0-next.9

package/dist/searching/fuzzy.d.ts

@@ -0,0 +1,128 @@
+import { type TextExtractor } from "../types.js";
+import { type BaseSearchOptions } from "./types.js";
+/**
+ * @example
+ * ```tsx
+ * import { createFuzzyRegExp, toSearchQuery } from "@react-md/core":
+ * import { useDeferredValue, useMemo, useState, type ReactElement } from "react";
+ *
+ * function Example(): ReactElement {
+ *   const [value, setValue] = useState("");
+ *   const deferredValue = useDeferredValue(value)
+ *
+ *   const match = useMemo(() => {
+ *     const query = toSearchQuery(deferredValue);
+ *     if (!query) {
+ *       return;
+ *     }
+ *
+ *     const fuzzyRegExp = createFuzzyRegExp(query);
+ *     return options.find(option => fuzzyRegExp.test(option.label)):
+ *   }, [options])
+ *
+ *   if (match) {
+ *     // do something
+ *   }
+ * }
+ *
+ * ```
+ *
+ * @remarks \@since 6.0.0
+ * @see {@link fuzzySearch}
+ */
+export declare function createFuzzyRegExp(query: string): RegExp;
+/**
+ * @remarks \@since 6.0.0
+ */
+export type FuzzySearchOptions<T> = BaseSearchOptions<T>;
+/**
+ * Filters a list by making sure that all the letters appear in order ignoring
+ * case, punctuation, whitespace, and special characters. This is kind of the
+ * same filtering that appears in text editors.
+ *
+ * @example
+ * Simple Example
+ * ```ts
+ * const list = [
+ *   "at",
+ *   "charAt",
+ *   "charCodeAt",
+ *   "codePointAt",
+ *   "concat",
+ *   "constructor",
+ *   "endsWith",
+ *   "includes",
+ *   "indexOf",
+ *   "lastIndexOf",
+ *   "length",
+ *   "localeCompare",
+ *   "match",
+ *   "matchAll",
+ *   "normalize",
+ *   "padEnd",
+ *   "padStart",
+ *   "repeat",
+ *   "replace",
+ *   "replaceAll",
+ *   "search",
+ *   "slice",
+ *   "split",
+ *   "startsWith",
+ *   "substring",
+ *   "toLocaleLowerCase",
+ *   "toLocaleUpperCase",
+ *   "toLowerCase",
+ *   "toString",
+ *   "toUpperCase",
+ *   "trim",
+ *   "trimEnd",
+ *   "trimStart",
+ *   "valueOf",
+ * ];
+ *
+ * fuzzySearch({
+ *   list,
+ *   query: "la",
+ * });
+ * // [
+ * //   "lastIndexOf",
+ * //    ^^
+ * //   "localeCompare",
+ * //    ^  ^
+ * //   "replace",
+ * //       ^^
+ * //   "replaceAll",
+ * //       ^^
+ * //   "toLocaleLowerCase",
+ * //      ^  ^
+ * //   "toLocaleUpperCase",
+ * //      ^  ^
+ * //   "toLowerCase",
+ * //      ^     ^
+ * // ]
+ *
+ * fuzzySearch({
+ *   list,
+ *   query: "ad",
+ *   type: "search",
+ * });
+ * // "charCodeAt"
+ *  //    ^   ^
+ * ```
+ *
+ * @remarks \@since 6.0.0
+ */
+export declare function fuzzySearch<T extends string>(options: Omit<FuzzySearchOptions<T>, "extractor"> & {
+    type?: "filter";
+}): readonly T[];
+export declare function fuzzySearch<T extends string>(options: Omit<FuzzySearchOptions<T>, "extractor"> & {
+    type?: "search";
+}): T | undefined;
+export declare function fuzzySearch<T>(option: FuzzySearchOptions<T> & {
+    extractor: TextExtractor<T>;
+    type?: "filter";
+}): readonly T[];
+export declare function fuzzySearch<T>(option: FuzzySearchOptions<T> & {
+    extractor: TextExtractor<T>;
+    type?: "search";
+}): T | undefined;

package/dist/searching/fuzzy.js

@@ -0,0 +1,54 @@
+import { defaultExtractor, search } from "./utils.js";
+/**
+ * @example
+ * ```tsx
+ * import { createFuzzyRegExp, toSearchQuery } from "@react-md/core":
+ * import { useDeferredValue, useMemo, useState, type ReactElement } from "react";
+ *
+ * function Example(): ReactElement {
+ *   const [value, setValue] = useState("");
+ *   const deferredValue = useDeferredValue(value)
+ *
+ *   const match = useMemo(() => {
+ *     const query = toSearchQuery(deferredValue);
+ *     if (!query) {
+ *       return;
+ *     }
+ *
+ *     const fuzzyRegExp = createFuzzyRegExp(query);
+ *     return options.find(option => fuzzyRegExp.test(option.label)):
+ *   }, [options])
+ *
+ *   if (match) {
+ *     // do something
+ *   }
+ * }
+ *
+ * ```
+ *
+ * @remarks \@since 6.0.0
+ * @see {@link fuzzySearch}
+ */ export function createFuzzyRegExp(query) {
+    return new RegExp(query.split("").join("\\w*").replace(/(\(|\||\)|\\(?!w\*)|\[|\|-|\.|\^|\+|\$|\?|^(?!w)\*)/g, "\\$1")// Couldn't get the matching of two '*' working, so replace them here..
+    .replace(/\*\*/g, "*\\*"), "i");
+}
+export function fuzzySearch(options) {
+    const { list, type = "filter", query, extractor = defaultExtractor("fuzzySearch"), whitespace } = options;
+    // lazy initialize the RegExp since the base `filter` function will modify the
+    // query and never call the filter function if:
+    // - there is no query
+    // - the list is empty
+    let regexp;
+    return search({
+        type,
+        list,
+        query,
+        extractor,
+        whitespace,
+        filter (query, value) {
+            return value.length > 0 && (regexp ??= createFuzzyRegExp(query)).test(value);
+        }
+    });
+}
+
+//# sourceMappingURL=fuzzy.js.map

package/dist/searching/fuzzy.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/searching/fuzzy.ts"],"sourcesContent":["import { type TextExtractor } from \"../types.js\";\nimport { type BaseSearchOptions } from \"./types.js\";\nimport { defaultExtractor, search } from \"./utils.js\";\n\n/**\n * @example\n * ```tsx\n * import { createFuzzyRegExp, toSearchQuery } from \"@react-md/core\":\n * import { useDeferredValue, useMemo, useState, type ReactElement } from \"react\";\n *\n * function Example(): ReactElement {\n *   const [value, setValue] = useState(\"\");\n *   const deferredValue = useDeferredValue(value)\n *\n *   const match = useMemo(() => {\n *     const query = toSearchQuery(deferredValue);\n *     if (!query) {\n *       return;\n *     }\n *\n *     const fuzzyRegExp = createFuzzyRegExp(query);\n *     return options.find(option => fuzzyRegExp.test(option.label)):\n *   }, [options])\n *\n *   if (match) {\n *     // do something\n *   }\n * }\n *\n * ```\n *\n * @remarks \\@since 6.0.0\n * @see {@link fuzzySearch}\n */\nexport function createFuzzyRegExp(query: string): RegExp {\n  return new RegExp(\n    query\n      .split(\"\")\n      .join(\"\\\\w*\")\n      .replace(/(\\(|\\||\\)|\\\\(?!w\\*)|\\[|\\|-|\\.|\\^|\\+|\\$|\\?|^(?!w)\\*)/g, \"\\\\$1\")\n      // Couldn't get the matching of two '*' working, so replace them here..\n      .replace(/\\*\\*/g, \"*\\\\*\"),\n    \"i\"\n  );\n}\n\n/**\n * @remarks \\@since 6.0.0\n */\nexport type FuzzySearchOptions<T> = BaseSearchOptions<T>;\n\n/**\n * Filters a list by making sure that all the letters appear in order ignoring\n * case, punctuation, whitespace, and special characters. This is kind of the\n * same filtering that appears in text editors.\n *\n * @example\n * Simple Example\n * ```ts\n * const list = [\n *   \"at\",\n *   \"charAt\",\n *   \"charCodeAt\",\n *   \"codePointAt\",\n *   \"concat\",\n *   \"constructor\",\n *   \"endsWith\",\n *   \"includes\",\n *   \"indexOf\",\n *   \"lastIndexOf\",\n *   \"length\",\n *   \"localeCompare\",\n *   \"match\",\n *   \"matchAll\",\n *   \"normalize\",\n *   \"padEnd\",\n *   \"padStart\",\n *   \"repeat\",\n *   \"replace\",\n *   \"replaceAll\",\n *   \"search\",\n *   \"slice\",\n *   \"split\",\n *   \"startsWith\",\n *   \"substring\",\n *   \"toLocaleLowerCase\",\n *   \"toLocaleUpperCase\",\n *   \"toLowerCase\",\n *   \"toString\",\n *   \"toUpperCase\",\n *   \"trim\",\n *   \"trimEnd\",\n *   \"trimStart\",\n *   \"valueOf\",\n * ];\n *\n * fuzzySearch({\n *   list,\n *   query: \"la\",\n * });\n * // [\n * //   \"lastIndexOf\",\n * //    ^^\n * //   \"localeCompare\",\n * //    ^  ^\n * //   \"replace\",\n * //       ^^\n * //   \"replaceAll\",\n * //       ^^\n * //   \"toLocaleLowerCase\",\n * //      ^  ^\n * //   \"toLocaleUpperCase\",\n * //      ^  ^\n * //   \"toLowerCase\",\n * //      ^     ^\n * // ]\n *\n * fuzzySearch({\n *   list,\n *   query: \"ad\",\n *   type: \"search\",\n * });\n * // \"charCodeAt\"\n *  //    ^   ^\n * ```\n *\n * @remarks \\@since 6.0.0\n */\nexport function fuzzySearch<T extends string>(\n  options: Omit<FuzzySearchOptions<T>, \"extractor\"> & { type?: \"filter\" }\n): readonly T[];\nexport function fuzzySearch<T extends string>(\n  options: Omit<FuzzySearchOptions<T>, \"extractor\"> & { type?: \"search\" }\n): T | undefined;\nexport function fuzzySearch<T>(\n  option: FuzzySearchOptions<T> & {\n    extractor: TextExtractor<T>;\n    type?: \"filter\";\n  }\n): readonly T[];\nexport function fuzzySearch<T>(\n  option: FuzzySearchOptions<T> & {\n    extractor: TextExtractor<T>;\n    type?: \"search\";\n  }\n): T | undefined;\nexport function fuzzySearch<T>(\n  options: FuzzySearchOptions<T>\n): readonly T[] | T | undefined {\n  const {\n    list,\n    type = \"filter\",\n    query,\n    extractor = defaultExtractor(\"fuzzySearch\"),\n    whitespace,\n  } = options;\n\n  // lazy initialize the RegExp since the base `filter` function will modify the\n  // query and never call the filter function if:\n  // - there is no query\n  // - the list is empty\n  let regexp: RegExp;\n  return search({\n    type,\n    list,\n    query,\n    extractor,\n    whitespace,\n    filter(query, value) {\n      return (\n        value.length > 0 && (regexp ??= createFuzzyRegExp(query)).test(value)\n      );\n    },\n  });\n}\n"],"names":["defaultExtractor","search","createFuzzyRegExp","query","RegExp","split","join","replace","fuzzySearch","options","list","type","extractor","whitespace","regexp","filter","value","length","test"],"mappings":"AAEA,SAASA,gBAAgB,EAAEC,MAAM,QAAQ,aAAa;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BC,GACD,OAAO,SAASC,kBAAkBC,KAAa;IAC7C,OAAO,IAAIC,OACTD,MACGE,KAAK,CAAC,IACNC,IAAI,CAAC,QACLC,OAAO,CAAC,wDAAwD,OACjE,uEAAuE;KACtEA,OAAO,CAAC,SAAS,SACpB;AAEJ;AAsGA,OAAO,SAASC,YACdC,OAA8B;IAE9B,MAAM,EACJC,IAAI,EACJC,OAAO,QAAQ,EACfR,KAAK,EACLS,YAAYZ,iBAAiB,cAAc,EAC3Ca,UAAU,EACX,GAAGJ;IAEJ,8EAA8E;IAC9E,+CAA+C;IAC/C,sBAAsB;IACtB,sBAAsB;IACtB,IAAIK;IACJ,OAAOb,OAAO;QACZU;QACAD;QACAP;QACAS;QACAC;QACAE,QAAOZ,KAAK,EAAEa,KAAK;YACjB,OACEA,MAAMC,MAAM,GAAG,KAAK,AAACH,CAAAA,WAAWZ,kBAAkBC,MAAK,EAAGe,IAAI,CAACF;QAEnE;IACF;AACF"}

package/dist/searching/toSearchQuery.d.ts

@@ -0,0 +1,5 @@
+import { type WhitespaceFilter } from "./types.js";
+/**
+ * @remarks \@since 6.0.0
+ */
+export declare function toSearchQuery(s: string, whitespace?: WhitespaceFilter): string;

package/dist/searching/toSearchQuery.js

@@ -0,0 +1,13 @@
+/**
+ * @remarks \@since 6.0.0
+ */ export function toSearchQuery(s, whitespace = "keep") {
+    let q = s.toLowerCase();
+    if (whitespace === "ignore") {
+        q = q.replace(/\s/g, "");
+    } else if (whitespace === "trim") {
+        q = q.trim();
+    }
+    return q;
+}
+
+//# sourceMappingURL=toSearchQuery.js.map

package/dist/searching/toSearchQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/searching/toSearchQuery.ts"],"sourcesContent":["import { type WhitespaceFilter } from \"./types.js\";\n\n/**\n * @remarks \\@since 6.0.0\n */\nexport function toSearchQuery(\n  s: string,\n  whitespace: WhitespaceFilter = \"keep\"\n): string {\n  let q = s.toLowerCase();\n  if (whitespace === \"ignore\") {\n    q = q.replace(/\\s/g, \"\");\n  } else if (whitespace === \"trim\") {\n    q = q.trim();\n  }\n\n  return q;\n}\n"],"names":["toSearchQuery","s","whitespace","q","toLowerCase","replace","trim"],"mappings":"AAEA;;CAEC,GACD,OAAO,SAASA,cACdC,CAAS,EACTC,aAA+B,MAAM;IAErC,IAAIC,IAAIF,EAAEG,WAAW;IACrB,IAAIF,eAAe,UAAU;QAC3BC,IAAIA,EAAEE,OAAO,CAAC,OAAO;IACvB,OAAO,IAAIH,eAAe,QAAQ;QAChCC,IAAIA,EAAEG,IAAI;IACZ;IAEA,OAAOH;AACT"}

package/dist/searching/types.d.ts

@@ -0,0 +1,28 @@
+import { type TextExtractor } from "../types.js";
+/**
+ * @remarks \@since 6.0.0
+ */
+export type WhitespaceFilter = "ignore" | "trim" | "keep";
+/**
+ * @remarks \@since 6.0.0
+ */
+export interface BaseSearchOptions<T> {
+    list: readonly T[];
+    /**
+     * @defaultValue `"filter"`
+     */
+    type?: "search" | "filter";
+    /**
+     * The current query string. i.e. `"SeArch"`
+     */
+    query: string;
+    /**
+     * This is required if the list includes anything other than strings.
+     * @see {@link TextExtractor}
+     */
+    extractor?: TextExtractor<T>;
+    /**
+     * @defaultValue `"keep"`
+     */
+    whitespace?: WhitespaceFilter;
+}

package/dist/searching/types.js

@@ -0,0 +1,5 @@
+/**
+ * @remarks \@since 6.0.0
+ */ export { };
+
+//# sourceMappingURL=types.js.map

package/dist/searching/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/searching/types.ts"],"sourcesContent":["import { type TextExtractor } from \"../types.js\";\n\n/**\n * @remarks \\@since 6.0.0\n */\nexport type WhitespaceFilter = \"ignore\" | \"trim\" | \"keep\";\n\n/**\n * @remarks \\@since 6.0.0\n */\nexport interface BaseSearchOptions<T> {\n  list: readonly T[];\n\n  /**\n   * @defaultValue `\"filter\"`\n   */\n  type?: \"search\" | \"filter\";\n\n  /**\n   * The current query string. i.e. `\"SeArch\"`\n   */\n  query: string;\n\n  /**\n   * This is required if the list includes anything other than strings.\n   * @see {@link TextExtractor}\n   */\n  extractor?: TextExtractor<T>;\n\n  /**\n   * @defaultValue `\"keep\"`\n   */\n  whitespace?: WhitespaceFilter;\n}\n"],"names":[],"mappings":"AAOA;;CAEC,GACD,WAuBC"}

package/dist/searching/utils.d.ts

@@ -0,0 +1,21 @@
+import { type TextExtractor } from "../types.js";
+import { type BaseSearchOptions } from "./types.js";
+/**
+ * @remarks \@since 6.0.0
+ * @internal
+ */
+export declare const defaultExtractor: <T>(name: string) => (item: T) => string;
+/**
+ * @internal
+ * @remarks \@since 6.0.0
+ */
+export interface SearchOptions<T> extends BaseSearchOptions<T> {
+    type: "search" | "filter";
+    filter(query: string, value: string): boolean;
+    extractor: TextExtractor<T>;
+}
+/**
+ * @internal
+ * @remarks \@since 6.0.0
+ */
+export declare function search<T>(options: SearchOptions<T>): readonly T[] | T | undefined;

package/dist/searching/utils.js

@@ -0,0 +1,28 @@
+import { toSearchQuery } from "./toSearchQuery.js";
+/**
+ * @remarks \@since 6.0.0
+ * @internal
+ */ export const defaultExtractor = (name)=>(item)=>{
+        if (typeof item === "string") {
+            return item;
+        }
+        throw new Error(`A \`TextExtractor\` must be provided to \`${name}\` for lists that do not contain strings`);
+    };
+/**
+ * @internal
+ * @remarks \@since 6.0.0
+ */ export function search(options) {
+    const { list, type, query, filter, extractor, whitespace = "keep" } = options;
+    const fallback = type === "search" ? undefined : list;
+    if (!list.length) {
+        return fallback;
+    }
+    const q = toSearchQuery(query, whitespace);
+    if (!q) {
+        return fallback;
+    }
+    const fn = type === "search" ? "find" : "filter";
+    return list[fn]((item)=>filter(q, toSearchQuery(extractor(item), whitespace)));
+}
+
+//# sourceMappingURL=utils.js.map

package/dist/searching/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/searching/utils.ts"],"sourcesContent":["import { type TextExtractor } from \"../types.js\";\nimport { toSearchQuery } from \"./toSearchQuery.js\";\nimport { type BaseSearchOptions } from \"./types.js\";\n\n/**\n * @remarks \\@since 6.0.0\n * @internal\n */\nexport const defaultExtractor =\n  <T>(name: string) =>\n  (item: T): string => {\n    if (typeof item === \"string\") {\n      return item;\n    }\n\n    throw new Error(\n      `A \\`TextExtractor\\` must be provided to \\`${name}\\` for lists that do not contain strings`\n    );\n  };\n\n/**\n * @internal\n * @remarks \\@since 6.0.0\n */\nexport interface SearchOptions<T> extends BaseSearchOptions<T> {\n  type: \"search\" | \"filter\";\n  filter(query: string, value: string): boolean;\n  extractor: TextExtractor<T>;\n}\n\n/**\n * @internal\n * @remarks \\@since 6.0.0\n */\nexport function search<T>(\n  options: SearchOptions<T>\n): readonly T[] | T | undefined {\n  const { list, type, query, filter, extractor, whitespace = \"keep\" } = options;\n  const fallback = type === \"search\" ? undefined : list;\n  if (!list.length) {\n    return fallback;\n  }\n\n  const q = toSearchQuery(query, whitespace);\n  if (!q) {\n    return fallback;\n  }\n\n  const fn = type === \"search\" ? \"find\" : \"filter\";\n\n  return list[fn]((item) =>\n    filter(q, toSearchQuery(extractor(item), whitespace))\n  );\n}\n"],"names":["toSearchQuery","defaultExtractor","name","item","Error","search","options","list","type","query","filter","extractor","whitespace","fallback","undefined","length","q","fn"],"mappings":"AACA,SAASA,aAAa,QAAQ,qBAAqB;AAGnD;;;CAGC,GACD,OAAO,MAAMC,mBACX,CAAIC,OACJ,CAACC;QACC,IAAI,OAAOA,SAAS,UAAU;YAC5B,OAAOA;QACT;QAEA,MAAM,IAAIC,MACR,CAAC,0CAA0C,EAAEF,KAAK,wCAAwC,CAAC;IAE/F,EAAE;AAYJ;;;CAGC,GACD,OAAO,SAASG,OACdC,OAAyB;IAEzB,MAAM,EAAEC,IAAI,EAAEC,IAAI,EAAEC,KAAK,EAAEC,MAAM,EAAEC,SAAS,EAAEC,aAAa,MAAM,EAAE,GAAGN;IACtE,MAAMO,WAAWL,SAAS,WAAWM,YAAYP;IACjD,IAAI,CAACA,KAAKQ,MAAM,EAAE;QAChB,OAAOF;IACT;IAEA,MAAMG,IAAIhB,cAAcS,OAAOG;IAC/B,IAAI,CAACI,GAAG;QACN,OAAOH;IACT;IAEA,MAAMI,KAAKT,SAAS,WAAW,SAAS;IAExC,OAAOD,IAAI,CAACU,GAAG,CAAC,CAACd,OACfO,OAAOM,GAAGhB,cAAcW,UAAUR,OAAOS;AAE7C"}

package/dist/test-utils/IntersectionObserver.d.ts

@@ -0,0 +1,12 @@
+export declare class IntersectionObserverMock implements IntersectionObserver {
+    callback: IntersectionObserverCallback;
+    root: Document | Element | null;
+    rootMargin: string;
+    thresholds: readonly number[];
+    elements: Set<Element>;
+    constructor(callback: IntersectionObserverCallback, options?: IntersectionObserverInit);
+    observe(target: Element): void;
+    unobserve(target: Element): void;
+    takeRecords(): IntersectionObserverEntry[];
+    disconnect(): void;
+}

package/dist/test-utils/ResizeObserver.d.ts

@@ -0,0 +1,172 @@
+/**
+ * @remarks \@since 6.0.0
+ */
+export interface ResizeObserverEntrySize {
+    height?: number;
+    width?: number;
+}
+/**
+ * @remarks \@since 6.0.0
+ */
+export type GetResizeObserverEntryMock = (target: Element, size?: ResizeObserverEntrySize) => ResizeObserverEntry;
+/**
+ * This is mostly an internal function to be used with the {@link ResizeObserverMock}
+ * and {@link setupResizeObserverMock}
+ *
+ * @remarks \@since 6.0.0
+ */
+export declare const createResizeObserverEntry: GetResizeObserverEntryMock;
+/**
+ * This is the default ResizeObserver implementation if it does not already
+ * exist in jsdom. You normally should not use this directly and instead use the
+ * {@link setupResizeObserverMock} instead.
+ *
+ * @remarks \@since 6.0.0
+ */
+export declare class ResizeObserverMock implements ResizeObserver {
+    callback: ResizeObserverCallback;
+    elements: Set<Element>;
+    constructor(callback: ResizeObserverCallback);
+    observe: (target: Element) => void;
+    unobserve: (target: Element) => void;
+    disconnect: () => void;
+    /**
+     * Triggers the resize event for a specific element. This must be wrapped in
+     * `act`.
+     *
+     * @example
+     * Main Usage
+     * ```tsx
+     * import { useCallback, useState } from "react";
+     * import {
+     *   cleanupResizeObserverAfterEach,
+     *   render,
+     *   screen,
+     *   setupResizeObserverMock,
+     * } from "@react-md/core/test-utils";
+     * import { useResizeObserver } from "@react-md/core";
+     *
+     * function ExampleComponent() {
+     *   const [size, setSize] = useState({ height: 0, width: 0 });
+     *   const ref = useResizeObserver({
+     *     onUpdate: useCallback((entry) => {
+     *       setSize({
+     *         height: entry.contentRect.height,
+     *         width: entry.contentRect.width,
+     *       });
+     *     });
+     *   });
+     *
+     *   return (
+     *     <>
+     *       <div data-testid="size">{JSON.stringify(size)}</div>
+     *       <div data-testid="resize-target" ref={ref} />
+     *     </>
+     *   );
+     * }
+     *
+     * cleanupResizeObserverAfterEach();
+     *
+     * describe("ExampleComponent", () => {
+     *   it("should do stuff", () => {
+     *     const observer = setupResizeObserverMock();
+     *     render(<ExampleComponent />)
+     *
+     *     const size = screen.getByTestId("size");
+     *     const resizeTarget = screen.getByTestId("resize-target")
+     *
+     *     // jsdom sets all element sizes to 0 by default
+     *     expect(size).toHaveTextContent(JSON.stringify({ height: 0, width: 0 }));
+     *
+     *     // you can trigger with a custom change
+     *     act(() => {
+     *       observer.resizeElement(resizeTarget, { height: 100, width: 100 });
+     *     });
+     *     expect(size).toHaveTextContent(JSON.stringify({ height: 100, width: 100 }));
+     *
+     *     // or you can mock the `getBoundingClientRect` result
+     *     jest.spyOn(resizeTarget, "getBoundingClientRect")
+     *       .mockReturnValue({
+     *         ...document.body.getBoundingClientRect(),
+     *         height: 200,
+     *         width: 200,
+     *       }):
+     *
+     *     act(() => {
+     *       observer.resizeElement(resizeTarget);
+     *     });
+     *     expect(size).toHaveTextContent(JSON.stringify({ height: 200, width: 200 }));
+     *   });
+     * })
+     * ```
+     */
+    resizeElement: (target: Element, changesOrGetEntry?: GetResizeObserverEntryMock | ResizeObserverEntrySize | ResizeObserverEntry) => void;
+    /**
+     * You'll normally want to use {@link resizeElement} instead, but this can be
+     * used to resize all the watched elements at once.
+     *
+     * @example
+     * ```tsx
+     * import {
+     *   act,
+     *   createResizeObserverEntry,
+     *   render,
+     *   screen,
+     *   setupResizeObserverMock,
+     * } from "@react-md/core/test-utils";
+     *
+     * const observer = setupResizeObserverMock();
+     * const { container } = render(<Test />)
+     * expect(container).toMatchSnapshot()
+     *
+     * const target1 = screen.getByTestId('target-1');
+     * const target2 = screen.getByTestId('target-2');
+     * const target3 = screen.getByTestId('target-3');
+     *
+     * act(() => {
+     *   observer.resizeAllElements((element) => {
+     *     let height: number | undefined;
+     *     let width: number | undefined;
+     *     switch (element) {
+     *       case target1:
+     *         height = 400;
+     *         width = 250;
+     *         break;
+     *       case target2:
+     *         height = 100;
+     *         width = 380;
+     *         break;
+     *       case target3:
+     *         height = 24;
+     *         width = 24;
+     *         break;
+     *     }
+     *
+     *     return createResizeObserverEntry(element, { height, width });
+     *   });
+     * });
+     * expect(container).toMatchSnapshot()
+     * ```
+     */
+    resizeAllElements: (getEntry?: GetResizeObserverEntryMock) => void;
+}
+/**
+ * Initializes the `ResizeObserverMock` to be used for tests.
+ *
+ * @see {@link ResizeObserverMock.resizeElement} for example usage.
+ *
+ * @param raf - set this to `true` to mimic the real ResizeObserver behavior
+ * where the updates occur after an animation frame instead of invoking
+ * immediately
+ * @param manager - a custom {@link resizeObserverManager} to use for your
+ * tests. You most likely should **not** use this option since it was added to
+ * help testing this function itself.
+ *
+ * @remarks \@since 6.0.0
+ */
+export declare const setupResizeObserverMock: (raf?: boolean, manager?: import("../useResizeObserver.js").ResizeObserverManager) => ResizeObserverMock;
+/**
+ * @see {@link setupResizeObserverMock}
+ * @remarks \@since 6.0.0
+ */
+export declare function cleanupResizeObserverAfterEach(restoreAllMocks?: boolean): void;

package/dist/test-utils/data-testid.d.ts

@@ -0,0 +1,7 @@
+/// <reference types="react" />
+declare module "react" {
+    interface HTMLAttributes<T> extends React.AriaAttributes, React.DOMAttributes<T> {
+        "data-testid"?: string | number;
+    }
+}
+export {};

package/dist/test-utils/data-testid.js

@@ -1,2 +1,3 @@
+/// <reference types="react" />
 
 //# sourceMappingURL=data-testid.js.map

package/dist/test-utils/data-testid.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/test-utils/data-testid.ts"],"names":[],"mappings":""}
+{"version":3,"sources":["../../src/test-utils/data-testid.ts"],"sourcesContent":["/// <reference types=\"react\" />\n\ndeclare module \"react\" {\n  interface HTMLAttributes<T>\n    extends React.AriaAttributes,\n      React.DOMAttributes<T> {\n    \"data-testid\"?: string | number;\n  }\n}\n"],"names":[],"mappings":"AAAA,+BAA+B"}

package/dist/test-utils/drag.d.ts

@@ -0,0 +1,26 @@
+interface XYCoords {
+    x: number;
+    y: number;
+}
+interface BaseDragOptions {
+    to?: XYCoords | Element;
+    delta?: XYCoords;
+    steps?: number;
+    duration?: number;
+}
+type DragOptions = BaseDragOptions & ({
+    to: XYCoords | Element;
+    delta?: never;
+} | {
+    delta: XYCoords;
+    to?: never;
+});
+/**
+ * This is internal for now. No idea if it's actually worthwhile though since
+ * you have to mock the `getBoundingClientRect()` to work.
+ *
+ * @internal
+ * @see https://github.com/testing-library/testing-library-docs/blob/c20f8a8931e9f0a158fda9f01bbea8cb45ed1651/docs/example-drag.mdx
+ */
+export declare function drag(element: Element, options: DragOptions): Promise<void>;
+export {};

package/dist/test-utils/index.d.ts

@@ -0,0 +1,7 @@
+export * from "@testing-library/react";
+export * from "@testing-library/user-event";
+export * from "./IntersectionObserver.js";
+export * from "./ResizeObserver.js";
+export * from "./matchMedia.js";
+export * from "./render.js";
+export * from "./timers.js";

package/dist/test-utils/jest-setup.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test-utils/matchMedia.d.ts

@@ -0,0 +1,101 @@
+import { jest } from "@jest/globals";
+/**
+ * @see {@link spyOnMatchMedia} instead
+ * @internal
+ * @remarks \@since 6.0.0
+ */
+export declare const BASE_MEDIA_QUERY_LIST: MediaQueryList;
+/** @remarks \@since 6.0.0 */
+export type MatchMediaMatcher = (query: string) => boolean;
+/**
+ * @see {@link spyOnMatchMedia} for usage
+ * @remarks \@since 6.0.0
+ * @returns `true` for phone media queries
+ */
+export declare const matchPhone: MatchMediaMatcher;
+/**
+ * @see {@link spyOnMatchMedia} for usage
+ * @remarks \@since 6.0.0
+ * @returns `true` for tablet media queries
+ */
+export declare const matchTablet: MatchMediaMatcher;
+/**
+ * @see {@link spyOnMatchMedia} for usage
+ * @remarks \@since 6.0.0
+ * @returns `true` for desktop media queries
+ */
+export declare const matchDesktop: MatchMediaMatcher;
+/**
+ * @see {@link spyOnMatchMedia} for usage
+ * @remarks \@since 6.0.0
+ * @returns `true` for large desktop media queries
+ */
+export declare const matchLargeDesktop: MatchMediaMatcher;
+/**
+ * @see {@link spyOnMatchMedia} for usage
+ * @remarks \@since 6.0.0
+ * @returns `true` for both desktop and large desktop media queries
+ */
+export declare const matchAnyDesktop: MatchMediaMatcher;
+/**
+ * @remarks \@since 6.0.0
+ */
+export type MatchMediaSpiedFunction = jest.SpiedFunction<typeof window.matchMedia> & {
+    /**
+     * @example
+     * Default Behavior
+     * ```tsx
+     * const matchMedia = spyOnMatchMedia();
+     * render(<Test />);
+     *
+     * // expect desktop results
+     *
+     * matchMedia.changeViewport(matchPhone);
+     * // expect phone results
+     * ```
+     *
+     * @example
+     * Custom Act Behavior
+     * ```tsx
+     * const matchMedia = spyOnMatchMedia();
+     * const { rerender } = render(<Test />);
+     *
+     * // expect desktop results
+     *
+     * matchMedia.changeViewport(matchPhone, false);
+     * rerender(<Test key="new-key" />);
+     *
+     * // expect phone results
+     * ```
+     */
+    changeViewport(matcher: MatchMediaMatcher, disableAct?: boolean): void;
+};
+/**
+ * @example
+ * Default Behavior
+ * ```tsx
+ * import { matchPhone, render, spyOnMatchMedia } from "@react-md/test-utils";
+ *
+ * const matchMedia = spyOnMatchMedia();
+ * render(<Test />);
+ *
+ * // expect desktop results
+ *
+ * matchMedia.changeViewport(matchPhone);
+ * // expect phone results
+ * ```
+ *
+ * @example
+ * Set Default Media
+ * ```tsx
+ * import { matchPhone, render, spyOnMatchMedia } from "@react-md/test-utils";
+ *
+ * const matchMedia = spyOnMatchMedia(matchPhone);
+ * render(<Test />);
+ *
+ * // expect phone results
+ * ```
+ *
+ * @remarks \@since 6.0.0
+ */
+export declare function spyOnMatchMedia(defaultMatch?: MatchMediaMatcher): MatchMediaSpiedFunction;

package/dist/test-utils/polyfills/IntersectionObserver.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test-utils/polyfills/ResizeObserver.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test-utils/polyfills/TextDecoder.d.ts

@@ -0,0 +1 @@
+export {};