@react-md/core 1.0.0-next.19 → 1.0.0-next.20

package/dist/useLocalStorage.js

@@ -1,377 +0,0 @@
-"use client";
-import { useCallback, useEffect, useRef, useState } from "react";
-import { useSsr } from "./SsrProvider.js";
-import { useIsomorphicLayoutEffect } from "./useIsomorphicLayoutEffect.js";
-import { identity } from "./utils/identity.js";
-/**
- * @since 6.0.0
- */ export const defaultLocalStorageSerializer = (value)=>typeof value === "string" ? value : `${value}`;
-/**
- * You'll most likely want to use {@link useLocalStorage} instead, but this is a
- * low-level util to "safely" get an item from local storage.
- *
- * @example
- * ```ts
- * import { getItemFromStorage } from "@react-md/core";
- *
- * const values = ["a", "b", "c", "d"] as const;
- *
- * const item1 = getItemFromStorage({
- *   key: "testKey",
- *   fallback: values[0],
- *   deserializer(item) {
- *     if (!values.includes(item)) {
- *       return values[0]
- *     }
- *
- *     return item;
- *   },
- * });
- *
- * const item2 = getItemFromStorage({
- *   key: "anotherKey",
- *   fallback: -1,
- * });
- *
- * const item3 = getItemFromStorage({
- *   key: "anotherKey",
- *   fallback: -1,
- *   storage: sessionStorage,
- * });
- * ```
- *
- * @since 6.0.0
- */ export const getItemFromStorage = (options)=>{
-    const { key, fallback, storage = localStorage, deserializer = JSON.parse } = options;
-    if (!key) {
-        return fallback;
-    }
-    try {
-        const value = storage.getItem(key);
-        return !value ? fallback : deserializer(value);
-    } catch  {
-        return fallback;
-    }
-};
-/**
- * You'll most likely want to use {@link useLocalStorage} instead, but this is a
- * low-level util to "safely" get an item from local storage.
- *
- * @example
- * ```ts
- * import { identity, getItemFromStorage } from "@react-md/core";
- *
- * const values = ["a", "b", "c", "d"] as const;
- *
- * setItemInStorage({
- *   key: "testKey",
- *   value: values[0],
- *   // store string value as-is
- *   serializer: identity,
- * });
- *
- * setItemInStorage({
- *   key: "anotherKey",
- *   value: 100,
- * });
- *
- * setItemInStorage({
- *   key: "anotherKey",
- *   value: 100,
- *   storage: sessionStorage,
- * });
- * ```
- *
- * @since 6.0.0
- */ export const setItemInStorage = (options)=>{
-    const { key, value, storage = localStorage, serializer = JSON.stringify } = options;
-    if (!key) {
-        return;
-    }
-    try {
-        storage.setItem(key, serializer(value));
-    } catch  {
-    //
-    }
-};
-/**
- * @since 6.0.0
- * @internal
- */ export const removeItemFromStorage = (options)=>{
-    const { key, storage = localStorage } = options;
-    if (!key) {
-        return;
-    }
-    try {
-        storage.removeItem(key);
-    } catch  {
-    // do nothing
-    }
-};
-/**
- * @example Simple Example
- * ```tsx
- * import type { ReactElement } from "react";
- * import { TextField, useLocalStorage } from "@react-md/core";
- *
- * function Example(): ReactElement {
- *   const { value, setValue } = useLocalStorage({
- *     key: "savedSearch",
- *     defaultValue: "",
- *   });
- *
- *   return (
- *     <TextField
- *       label="Search"
- *       placeholder="Search..."
- *       type="search"
- *       value={value}
- *       onChange={(event) => {
- *         setValue(event.currentTarget.value)
- *       }}
- *     />
- *   );
- * }
- * ```
- *
- * @example Type-safe Objects
- * ```tsx
- * import type { ReactElement } from "react";
- * import { useLocalStorage } from "@react-md/core";
- *
- * interface ExpectedSchema {
- *   label: string;
- *   value: string;
- *   // others
- * }
- *
- * function Example(): ReactElement {
- *   const { value, setValue } = useLocalStorage<ExpectedSchema | null>({
- *     key: "someKey",
- *     defaultValue: null,
- *
- *     // this is optional: you can create a custom deserializer to validate
- *     // the stored value to prevent people manually updating local storage in
- *     // the dev tools
- *     deserializer(item) {
- *       const parsed = JSON.parse(item):
- *       const { label, value } = parsed;
- *       if (typeof label !== 'string' || typeof value !== 'string') {
- *         return null;
- *       }
- *
- *       return { label, value };
- *     }
- *   });
- *
- *   // do something
- *   // value will be `ExpectedSchema | null`
- * }
- * ```
- *
- * @example Manual Persistence
- * ```tsx
- * import type { ReactElement } from "react";
- * import { Button, Checkbox, Form, useLocalStorage } from "@react-md/core";
- *
- * function Example(): ReactElement {
- *   const { value, setValue, remove, persist } = useLocalStorage({
- *     key: "someKey",
- *     manual: true,
- *     defaultValue: false,
- *   });
- *
- *   return (
- *     <Form
- *       onSubmit={() => {
- *         // current value will be saved into local storage
- *         persist();
- *       }}
- *       onReset={() => {
- *         // "someKey" will be removed from local storage
- *         remove();
- *       }}
- *     >
- *       <Checkbox
- *         label="Allow cookies"
- *         checked={value}
- *         onChange={(event) =>
- *           setValue(event.currentTarget.checked);
- *         }
- *       />
- *       <Button type="reset">Decline</Button>
- *       <Button type="submit">Save</Button>
- *     </Form>
- *   );
- * }
- * ```
- *
- * Note: Using the same local storage key in multiple parts in your app will not
- * update all instances with that value. The value will only be updated if it
- * was updated in a separate tab with the `"storage"` event. You must setup your
- * own context to share values or another state manager solution.
- *
- * @example Shared Value
- * ```tsx
- * const context = createContext(null);
- * const { Provider } = context;
- *
- * export function useSomeValue(): string {
- *   const value = useContext(context);
- *   if (!value) {
- *     throw new Error()
- *   }
- *
- *   return value;
- * }
- *
- * function Example({ children }: { children: ReactNode }) {
- *   const { value, setValue, remove, persist } = useLocalStorage({
- *     key: "someKey",
- *     defaultValue: "",
- *
- *     // optional
- *     manual: true,
- *   });
- *
- *   return (
- *     <Provider
- *       value={useMemo(() => ({
- *         value,
- *         setValue,
- *
- *         // remove and persist are optional
- *         remove,
- *         persist,
- *       }), [value, setValue, remove, persist])}
- *     >
- *       {children}
- *     </Provider>
- *   );
- * }
- *
- * function SomeChildComponent() {
- *   const { value, setValue } = useSomeValue();
- *   // do stuff
- * }
- * ```
- *
- * @since 6.0.0
- */ export function useLocalStorage(options) {
-    const { key, defaultValue, manual = false } = options;
-    const [initialValue] = useState(defaultValue);
-    // this allows for strings to automatically be stored as-is instead of adding
-    // additional quotes around then with JSON.stringify
-    const raw = options.raw ?? typeof initialValue === "string";
-    const serializer = options.serializer ?? (raw ? defaultLocalStorageSerializer : JSON.stringify);
-    const deserializer = options.deserializer ?? (raw && typeof initialValue === "string" ? identity : JSON.parse);
-    const ssr = useSsr();
-    const [value, setStoredValue] = useState(()=>{
-        if (ssr) {
-            return initialValue;
-        }
-        const value = getItemFromStorage({
-            key,
-            fallback: initialValue,
-            deserializer
-        });
-        if (!manual) {
-            setItemInStorage({
-                key,
-                value,
-                serializer
-            });
-        }
-        return value;
-    });
-    const config = useRef({
-        key,
-        value,
-        manual,
-        serializer,
-        deserializer,
-        defaultValue: initialValue
-    });
-    useIsomorphicLayoutEffect(()=>{
-        config.current = {
-            key,
-            value,
-            manual,
-            serializer,
-            deserializer,
-            defaultValue: initialValue
-        };
-    });
-    const setValue = useCallback((valueOrDispatcher)=>{
-        const { key, manual, serializer } = config.current;
-        setStoredValue((prevValue)=>{
-            const nextValue = valueOrDispatcher instanceof Function ? valueOrDispatcher(prevValue) : valueOrDispatcher;
-            if (!manual) {
-                setItemInStorage({
-                    key,
-                    value: nextValue,
-                    serializer
-                });
-            }
-            return nextValue;
-        });
-    }, []);
-    const remove = useCallback(()=>{
-        removeItemFromStorage({
-            key: config.current.key
-        });
-    }, []);
-    const persist = useCallback(()=>{
-        const { key, value, serializer } = config.current;
-        setItemInStorage({
-            key,
-            value,
-            serializer
-        });
-    }, []);
-    useEffect(()=>{
-        const { defaultValue, deserializer, manual } = config.current;
-        if (manual || !ssr) {
-            return;
-        }
-        setValue(getItemFromStorage({
-            key,
-            fallback: defaultValue,
-            deserializer
-        }));
-    }, [
-        key,
-        ssr,
-        setValue
-    ]);
-    // update the value if another tab changed the local storage value
-    useEffect(()=>{
-        if (!key) {
-            return;
-        }
-        const callback = (event)=>{
-            const { defaultValue, deserializer } = config.current;
-            if (event.key === key) {
-                setStoredValue(getItemFromStorage({
-                    key,
-                    fallback: defaultValue,
-                    deserializer
-                }));
-            }
-        };
-        window.addEventListener("storage", callback);
-        return ()=>{
-            window.removeEventListener("storage", callback);
-        };
-    }, [
-        key
-    ]);
-    return {
-        value,
-        setValue,
-        remove,
-        persist
-    };
-}
-
-//# sourceMappingURL=useLocalStorage.js.map

package/dist/useLocalStorage.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/useLocalStorage.ts"],"sourcesContent":["\"use client\";\nimport { useCallback, useEffect, useRef, useState } from \"react\";\nimport { useSsr } from \"./SsrProvider.js\";\nimport type { UseStateInitializer, UseStateSetter } from \"./types.js\";\nimport { useIsomorphicLayoutEffect } from \"./useIsomorphicLayoutEffect.js\";\nimport { identity } from \"./utils/identity.js\";\n\n/** @since 6.0.0 */\nexport type LocalStorageSerializer<T> = (value: T) => string;\n/** @since 6.0.0 */\nexport type LocalStorageDeserializer<T> = (item: string) => T;\n\n/** @since 6.0.0 */\nexport interface LocalStorageHookOptions<T> {\n  /**\n   * The local storage key name to use.\n   *\n   * This can be set to an empty string for internal usage of conditionally\n   * saving items to local storage.\n   */\n  key: string;\n\n  /**\n   * The default value to use if an item does not exist in local storage.\n   */\n  defaultValue: UseStateInitializer<T>;\n\n  /**\n   * Set this to `true` if the `value` should not persist to local storage\n   * immediately whenever it changes. You will manually need to call\n   * {@link LocalStorageHookReturnValue.persist} instead.\n   *\n   * @see {@link LocalStorageHookReturnValue.persist} for an example.\n   * @defaultValue `false`\n   */\n  manual?: boolean;\n\n  /**\n   * Set this to `true` to update:\n   *\n   * - the default {@link serializer} to be:\n   * ```\n   * typeof value === \"string\" ? value : `${value}`\n   * ```\n   * - the default {@link deserializer} to not call `JSON.parse` if the\n   *   {@link defaultValue} is a string.\n   *\n   * @defaultValue `typeof defaultValue === 'string'`\n   */\n  raw?: boolean;\n\n  /**\n   * An optional function to serialize the `value` before storing it in local\n   * storage.\n   *\n   * @defaultValue `JSON.stringify`\n   */\n  serializer?: LocalStorageSerializer<T>;\n\n  /**\n   * An optional function to deserialize the `value` if the item existed in\n   * local storage.\n   *\n   * @defaultValue `JSON.parse`\n   */\n  deserializer?: LocalStorageDeserializer<T>;\n}\n\n/**\n * @since 6.0.0\n */\nexport const defaultLocalStorageSerializer = (value: unknown): string =>\n  typeof value === \"string\" ? value : `${value}`;\n\n/** @since 6.0.0 */\nexport interface GetItemFromStorageOptions<T> {\n  /**\n   * The storage key to use\n   */\n  key: string;\n\n  /**\n   * A value to use when the {@link key} does not exist in storage or there is\n   * an error deserializing the value.\n   */\n  fallback: T;\n\n  /** @see {@link LocalStorageHookOptions.deserializer} */\n  deserializer?: LocalStorageDeserializer<T>;\n\n  /** @defaultValue `localStorage` */\n  storage?: Storage;\n}\n\n/**\n * You'll most likely want to use {@link useLocalStorage} instead, but this is a\n * low-level util to \"safely\" get an item from local storage.\n *\n * @example\n * ```ts\n * import { getItemFromStorage } from \"@react-md/core\";\n *\n * const values = [\"a\", \"b\", \"c\", \"d\"] as const;\n *\n * const item1 = getItemFromStorage({\n *   key: \"testKey\",\n *   fallback: values[0],\n *   deserializer(item) {\n *     if (!values.includes(item)) {\n *       return values[0]\n *     }\n *\n *     return item;\n *   },\n * });\n *\n * const item2 = getItemFromStorage({\n *   key: \"anotherKey\",\n *   fallback: -1,\n * });\n *\n * const item3 = getItemFromStorage({\n *   key: \"anotherKey\",\n *   fallback: -1,\n *   storage: sessionStorage,\n * });\n * ```\n *\n * @since 6.0.0\n */\nexport const getItemFromStorage = <T>(\n  options: GetItemFromStorageOptions<T>\n): T => {\n  const {\n    key,\n    fallback,\n    storage = localStorage,\n    deserializer = JSON.parse as LocalStorageDeserializer<T>,\n  } = options;\n  if (!key) {\n    return fallback;\n  }\n\n  try {\n    const value = storage.getItem(key);\n    return !value ? fallback : deserializer(value);\n  } catch {\n    return fallback;\n  }\n};\n\n/** @since 6.0.0 */\nexport interface SetItemInStorageOptions<T> {\n  key: string;\n  value: T;\n  /** @defaultValue `localStorage` */\n  storage?: Storage;\n\n  /** @see {@link LocalStorageHookOptions.serializer} */\n  serializer?: LocalStorageSerializer<T>;\n}\n\n/**\n * You'll most likely want to use {@link useLocalStorage} instead, but this is a\n * low-level util to \"safely\" get an item from local storage.\n *\n * @example\n * ```ts\n * import { identity, getItemFromStorage } from \"@react-md/core\";\n *\n * const values = [\"a\", \"b\", \"c\", \"d\"] as const;\n *\n * setItemInStorage({\n *   key: \"testKey\",\n *   value: values[0],\n *   // store string value as-is\n *   serializer: identity,\n * });\n *\n * setItemInStorage({\n *   key: \"anotherKey\",\n *   value: 100,\n * });\n *\n * setItemInStorage({\n *   key: \"anotherKey\",\n *   value: 100,\n *   storage: sessionStorage,\n * });\n * ```\n *\n * @since 6.0.0\n */\nexport const setItemInStorage = <T>(\n  options: SetItemInStorageOptions<T>\n): void => {\n  const {\n    key,\n    value,\n    storage = localStorage,\n    serializer = JSON.stringify,\n  } = options;\n  if (!key) {\n    return;\n  }\n\n  try {\n    storage.setItem(key, serializer(value));\n  } catch {\n    //\n  }\n};\n\n/**\n * @since 6.0.0\n * @internal\n */\ninterface RemoveItemFromStorageOptions {\n  key: string;\n\n  /** @defaultValue `localStorage` */\n  storage?: Storage;\n}\n\n/**\n * @since 6.0.0\n * @internal\n */\nexport const removeItemFromStorage = (\n  options: RemoveItemFromStorageOptions\n): void => {\n  const { key, storage = localStorage } = options;\n  if (!key) {\n    return;\n  }\n\n  try {\n    storage.removeItem(key);\n  } catch {\n    // do nothing\n  }\n};\n\n/** @since 6.0.0 */\nexport interface LocalStorageHookReturnValue<T> {\n  value: T;\n\n  /**\n   * Updates the {@link value} in state. When the\n   * {@link LocalStorageHookOptions.manual} option is `false`, the value will\n   * also be updated in local storage immediately.\n   */\n  setValue: UseStateSetter<T>;\n\n  /**\n   * Remove the item from local storage.\n   */\n  remove: () => void;\n\n  /**\n   * Manually persist the current {@link value} into local storage. This is only\n   * useful if the {@link LocalStorageHookOptions.manual} option is `true`.\n   *\n   * @example Manual Persisting\n   * ```tsx\n   * import type { ReactElement } from \"react\";\n   *\n   * function Example(): ReactElement {\n   *   const { value, setValue, persist } = useLocalStorage({\n   *     key: \"someKey\",\n   *     manual: true,\n   *     defaultValue: \"\",\n   *   });\n   *\n   *   return (\n   *     <>\n   *       <Button onClick={closeDialog}>\n   *         Cancel\n   *       </Button>\n   *       <Button\n   *         onClick={async () => {\n   *           await saveToDatabase(value);\n   *           persist();\n   *           closeDialog();\n   *         }}\n   *       >\n   *         Confirm\n   *       </Button>\n   *     </>\n   *   );\n   * }\n   * ```\n   */\n  persist: () => void;\n}\n\n/**\n * @example Simple Example\n * ```tsx\n * import type { ReactElement } from \"react\";\n * import { TextField, useLocalStorage } from \"@react-md/core\";\n *\n * function Example(): ReactElement {\n *   const { value, setValue } = useLocalStorage({\n *     key: \"savedSearch\",\n *     defaultValue: \"\",\n *   });\n *\n *   return (\n *     <TextField\n *       label=\"Search\"\n *       placeholder=\"Search...\"\n *       type=\"search\"\n *       value={value}\n *       onChange={(event) => {\n *         setValue(event.currentTarget.value)\n *       }}\n *     />\n *   );\n * }\n * ```\n *\n * @example Type-safe Objects\n * ```tsx\n * import type { ReactElement } from \"react\";\n * import { useLocalStorage } from \"@react-md/core\";\n *\n * interface ExpectedSchema {\n *   label: string;\n *   value: string;\n *   // others\n * }\n *\n * function Example(): ReactElement {\n *   const { value, setValue } = useLocalStorage<ExpectedSchema | null>({\n *     key: \"someKey\",\n *     defaultValue: null,\n *\n *     // this is optional: you can create a custom deserializer to validate\n *     // the stored value to prevent people manually updating local storage in\n *     // the dev tools\n *     deserializer(item) {\n *       const parsed = JSON.parse(item):\n *       const { label, value } = parsed;\n *       if (typeof label !== 'string' || typeof value !== 'string') {\n *         return null;\n *       }\n *\n *       return { label, value };\n *     }\n *   });\n *\n *   // do something\n *   // value will be `ExpectedSchema | null`\n * }\n * ```\n *\n * @example Manual Persistence\n * ```tsx\n * import type { ReactElement } from \"react\";\n * import { Button, Checkbox, Form, useLocalStorage } from \"@react-md/core\";\n *\n * function Example(): ReactElement {\n *   const { value, setValue, remove, persist } = useLocalStorage({\n *     key: \"someKey\",\n *     manual: true,\n *     defaultValue: false,\n *   });\n *\n *   return (\n *     <Form\n *       onSubmit={() => {\n *         // current value will be saved into local storage\n *         persist();\n *       }}\n *       onReset={() => {\n *         // \"someKey\" will be removed from local storage\n *         remove();\n *       }}\n *     >\n *       <Checkbox\n *         label=\"Allow cookies\"\n *         checked={value}\n *         onChange={(event) =>\n *           setValue(event.currentTarget.checked);\n *         }\n *       />\n *       <Button type=\"reset\">Decline</Button>\n *       <Button type=\"submit\">Save</Button>\n *     </Form>\n *   );\n * }\n * ```\n *\n * Note: Using the same local storage key in multiple parts in your app will not\n * update all instances with that value. The value will only be updated if it\n * was updated in a separate tab with the `\"storage\"` event. You must setup your\n * own context to share values or another state manager solution.\n *\n * @example Shared Value\n * ```tsx\n * const context = createContext(null);\n * const { Provider } = context;\n *\n * export function useSomeValue(): string {\n *   const value = useContext(context);\n *   if (!value) {\n *     throw new Error()\n *   }\n *\n *   return value;\n * }\n *\n * function Example({ children }: { children: ReactNode }) {\n *   const { value, setValue, remove, persist } = useLocalStorage({\n *     key: \"someKey\",\n *     defaultValue: \"\",\n *\n *     // optional\n *     manual: true,\n *   });\n *\n *   return (\n *     <Provider\n *       value={useMemo(() => ({\n *         value,\n *         setValue,\n *\n *         // remove and persist are optional\n *         remove,\n *         persist,\n *       }), [value, setValue, remove, persist])}\n *     >\n *       {children}\n *     </Provider>\n *   );\n * }\n *\n * function SomeChildComponent() {\n *   const { value, setValue } = useSomeValue();\n *   // do stuff\n * }\n * ```\n *\n * @since 6.0.0\n */\nexport function useLocalStorage<T>(\n  options: LocalStorageHookOptions<T>\n): LocalStorageHookReturnValue<T> {\n  const { key, defaultValue, manual = false } = options;\n\n  const [initialValue] = useState(defaultValue);\n  // this allows for strings to automatically be stored as-is instead of adding\n  // additional quotes around then with JSON.stringify\n  const raw = options.raw ?? typeof initialValue === \"string\";\n  const serializer =\n    options.serializer ??\n    (raw ? defaultLocalStorageSerializer : JSON.stringify);\n  const deserializer: LocalStorageDeserializer<T> =\n    options.deserializer ??\n    (raw && typeof initialValue === \"string\" ? identity : JSON.parse);\n\n  const ssr = useSsr();\n  const [value, setStoredValue] = useState<T>(() => {\n    if (ssr) {\n      return initialValue;\n    }\n\n    const value = getItemFromStorage({\n      key,\n      fallback: initialValue,\n      deserializer,\n    });\n    if (!manual) {\n      setItemInStorage({\n        key,\n        value,\n        serializer,\n      });\n    }\n\n    return value;\n  });\n  const config = useRef({\n    key,\n    value,\n    manual,\n    serializer,\n    deserializer,\n    defaultValue: initialValue,\n  } as const);\n  useIsomorphicLayoutEffect(() => {\n    config.current = {\n      key,\n      value,\n      manual,\n      serializer,\n      deserializer,\n      defaultValue: initialValue,\n    };\n  });\n\n  const setValue = useCallback<UseStateSetter<T>>((valueOrDispatcher) => {\n    const { key, manual, serializer } = config.current;\n    setStoredValue((prevValue) => {\n      const nextValue =\n        valueOrDispatcher instanceof Function\n          ? valueOrDispatcher(prevValue)\n          : valueOrDispatcher;\n\n      if (!manual) {\n        setItemInStorage({\n          key,\n          value: nextValue,\n          serializer,\n        });\n      }\n\n      return nextValue;\n    });\n  }, []);\n\n  const remove = useCallback(() => {\n    removeItemFromStorage({\n      key: config.current.key,\n    });\n  }, []);\n\n  const persist = useCallback(() => {\n    const { key, value, serializer } = config.current;\n    setItemInStorage({\n      key,\n      value,\n      serializer,\n    });\n  }, []);\n\n  useEffect(() => {\n    const { defaultValue, deserializer, manual } = config.current;\n    if (manual || !ssr) {\n      return;\n    }\n\n    setValue(\n      getItemFromStorage({\n        key,\n        fallback: defaultValue,\n        deserializer,\n      })\n    );\n  }, [key, ssr, setValue]);\n\n  // update the value if another tab changed the local storage value\n  useEffect(() => {\n    if (!key) {\n      return;\n    }\n\n    const callback = (event: StorageEvent): void => {\n      const { defaultValue, deserializer } = config.current;\n      if (event.key === key) {\n        setStoredValue(\n          getItemFromStorage({\n            key,\n            fallback: defaultValue,\n            deserializer,\n          })\n        );\n      }\n    };\n\n    window.addEventListener(\"storage\", callback);\n    return () => {\n      window.removeEventListener(\"storage\", callback);\n    };\n  }, [key]);\n\n  return {\n    value,\n    setValue,\n    remove,\n    persist,\n  };\n}\n"],"names":["useCallback","useEffect","useRef","useState","useSsr","useIsomorphicLayoutEffect","identity","defaultLocalStorageSerializer","value","getItemFromStorage","options","key","fallback","storage","localStorage","deserializer","JSON","parse","getItem","setItemInStorage","serializer","stringify","setItem","removeItemFromStorage","removeItem","useLocalStorage","defaultValue","manual","initialValue","raw","ssr","setStoredValue","config","current","setValue","valueOrDispatcher","prevValue","nextValue","Function","remove","persist","callback","event","window","addEventListener","removeEventListener"],"mappings":"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"}

package/src/test-utils/README.md

@@ -1,150 +0,0 @@
-# @react-md/core/test-utils
-
-A collection of polyfills, utils, and test renderers to help with testing
-projects using `react-md`. Everything from `@testing-library/react` and
-`@testing-library/user-event` will be re-exported for convenience.
-
-## Installation
-
-In order to use the test utils, you just have `jest` and the testing library
-dependencies installed.
-
-```sh
-npm install --save-dev \
-  jest \
-  @jest/globals \
-  @jest/types \
-  @testing-library/dom \
-  @testing-library/jest-dom \
-  @testing-library/react \
-  @testing-library/user-event
-```
-
-```sh
-yarn add -D \
-  jest \
-  @jest/globals \
-  @jest/types \
-  @testing-library/dom \
-  @testing-library/jest-dom \
-  @testing-library/react \
-  @testing-library/user-event
-```
-
-```sh
-pnpm add -D \
-  jest \
-  @jest/globals \
-  @jest/types \
-  @testing-library/dom \
-  @testing-library/jest-dom \
-  @testing-library/react \
-  @testing-library/user-event
-```
-
-## Adding Polyfills
-
-```ts
-// jest.config.ts
-import type { Config } from "jest";
-
-const config: Config = {
-  testEnvironment: "jsdom",
-  setupFilesAfterEnv: ["<rootDir>/jest.setup.ts"],
-};
-
-export default config;
-```
-
-```ts
-// jest.setup.ts
-import "@testing-library/jest-dom";
-
-// add all the polyfills
-import "@react-md/core/test-utils/polyfills";
-
-// or pick and choose from the following polyfills as needed
-import "@react-md/core/test-utils/polyfills/IntersectionObserver";
-import "@react-md/core/test-utils/polyfills/mediaQuery";
-import "@react-md/core/test-utils/polyfills/offsetParent";
-import "@react-md/core/test-utils/polyfills/ResizeObserver";
-import "@react-md/core/test-utils/polyfills/scrollIntoView";
-
-// any other setup
-```
-
-## Custom Test Renderer
-
-My preferred method of making all the global context providers, data stores,
-`react-md` configuration, etc available for each test is to create a utility file
-that re-exports everything from `@react-md/core/test-utils`,
-`@testing-library/react`, and `@testing-library/user-event`. The example below
-shows a possible setup.
-
-> See [Custom Renderer](https://testing-library.com/docs/react-testing-library/setup#custom-render) for additional context.
-
-```diff
-// src/__tests__/MyComponent.tsx
--import { render, userEvent } from "@testing-library/react";
-+import { render, userEvent } from "../test-utils";
-```
-
-```tsx
-// src/rmdConfig.tsx
-import type { ReactMDCoreConfiguration } from "@react-md/core";
-
-export const rmdConfig: ReactMDCoreConfiguration = {
-  // any icon overrides. Using material icons as an example
-  icons: {
-    back: <KeyboardArrowLeftIcon />,
-    close: <CloseIcon />,
-    checkbox: <CheckBoxOutlineBlankIcon />,
-    checkboxChecked: <CheckBoxIcon />,
-    checkboxIndeterminate: <IndeterminateCheckBoxIcon />,
-    dropdown: <ArrowDropDownIcon />,
-    error: <ErrorOutlineIcon />,
-    expander: <KeyboardArrowDownIcon />,
-    forward: <KeyboardArrowRightIcon />,
-    menu: <MenuIcon />,
-    notification: <NotificationsIcon />,
-    password: <RemoveRedEyeIcon />,
-    radio: <RadioButtonUncheckedIcon />,
-    radioChecked: <RadioButtonCheckedIcon />,
-    selected: <CheckIcon />,
-    sort: <ArrowUpwardIcon />,
-    upload: <FileUploadIcon />,
-  },
-
-  // any other global changes
-  // ssr: true,
-
-  // colorSchemeMode: "system",
-};
-```
-
-```tsx
-// src/test-utils.tsx
-import type { ReactElement } from "react";
-import type { ReactMDRenderOptions, RenderOptions } from "@react-md/test-utils";
-import { rmdRender } from "@react-md/core/test-utils";
-
-import { rmdConfig } from "./rmdConfig";
-import { MyCustomProviders } from "./MyCustomProviders";
-
-export * from "@react-md/core/test-utils";
-
-export const render = (
-  ui: ReactElement,
-  options?: ReactMDRenderOptions
-): RenderResult =>
-  rmdRender(ui, {
-    ...options,
-    rmdConfig: {
-      ...rmdConfig,
-      ...options?.rmdConfig,
-    },
-    wrapper: ({ children }) => (
-      <MyCustomProviders>{children}</MyCustomProviders>
-    ),
-  });
-```