@react-md/core 1.0.0-next.12 → 1.0.0-next.14

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

@@ -1,20 +1,20 @@
 import { type ResizeObserverManager } from "../useResizeObserver.js";
 /**
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */
 export interface ResizeObserverEntrySize {
     height?: number;
     width?: number;
 }
 /**
- * @remarks \@since 6.0.0
+ * @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
+ * @since 6.0.0
  */
 export declare const createResizeObserverEntry: GetResizeObserverEntryMock;
 /**
@@ -22,7 +22,7 @@ export declare const createResizeObserverEntry: GetResizeObserverEntryMock;
  * exist in jsdom. You normally should not use this directly and instead use the
  * {@link setupResizeObserverMock} instead.
  *
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */
 export declare class ResizeObserverMock implements ResizeObserver {
     callback: ResizeObserverCallback;
@@ -35,8 +35,7 @@ export declare class ResizeObserverMock implements ResizeObserver {
      * Triggers the resize event for a specific element. This must be wrapped in
      * `act`.
      *
-     * @example
-     * Main Usage
+     * @example Main Usage
      * ```tsx
      * import {
      *   cleanupResizeObserverAfterEach,
@@ -114,7 +113,7 @@ export declare class ResizeObserverMock implements ResizeObserver {
     resizeAllElements: (getEntry?: GetResizeObserverEntryMock) => void;
 }
 /**
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */
 export interface SetupResizeObserverMockOptions {
     /**
@@ -138,8 +137,7 @@ export interface SetupResizeObserverMockOptions {
 /**
  * Initializes the `ResizeObserverMock` to be used for tests.
  *
- * @example
- * Main Usage
+ * @example Main Usage
  * ```tsx
  * import { useCallback, useState } from "react";
  * import {
@@ -204,11 +202,11 @@ export interface SetupResizeObserverMockOptions {
  * })
  * ```
  *
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */
 export declare function setupResizeObserverMock(options?: SetupResizeObserverMockOptions): ResizeObserverMock;
 /**
  * @see {@link setupResizeObserverMock}
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */
 export declare function cleanupResizeObserverAfterEach(restoreAllMocks?: boolean): void;

package/dist/test-utils/ResizeObserver.js

@@ -17,7 +17,7 @@ import { resizeObserverManager } from "../useResizeObserver.js";
  * This is mostly an internal function to be used with the {@link ResizeObserverMock}
  * and {@link setupResizeObserverMock}
  *
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */ export const createResizeObserverEntry = (target, size)=>{
     const contentRect = target.getBoundingClientRect();
     if (typeof size?.height === "number") {
@@ -47,7 +47,7 @@ import { resizeObserverManager } from "../useResizeObserver.js";
  * exist in jsdom. You normally should not use this directly and instead use the
  * {@link setupResizeObserverMock} instead.
  *
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */ export class ResizeObserverMock {
     constructor(callback){
         _define_property(this, "callback", void 0);
@@ -59,8 +59,7 @@ import { resizeObserverManager } from "../useResizeObserver.js";
    * Triggers the resize event for a specific element. This must be wrapped in
    * `act`.
    *
-   * @example
-   * Main Usage
+   * @example Main Usage
    * ```tsx
    * import {
    *   cleanupResizeObserverAfterEach,
@@ -173,8 +172,7 @@ import { resizeObserverManager } from "../useResizeObserver.js";
 /**
  * Initializes the `ResizeObserverMock` to be used for tests.
  *
- * @example
- * Main Usage
+ * @example Main Usage
  * ```tsx
  * import { useCallback, useState } from "react";
  * import {
@@ -239,7 +237,7 @@ import { resizeObserverManager } from "../useResizeObserver.js";
  * })
  * ```
  *
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */ export function setupResizeObserverMock(options = {}) {
     const { raf, manager = resizeObserverManager } = options;
     const resizeObserver = new ResizeObserverMock((entries)=>{
@@ -257,7 +255,7 @@ import { resizeObserverManager } from "../useResizeObserver.js";
 }
 /**
  * @see {@link setupResizeObserverMock}
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */ export function cleanupResizeObserverAfterEach(restoreAllMocks = true) {
     afterEach(()=>{
         resizeObserverManager.frame = 0;

package/dist/test-utils/ResizeObserver.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/test-utils/ResizeObserver.ts"],"sourcesContent":["import { afterEach, jest } from \"@jest/globals\";\nimport {\n  resizeObserverManager,\n  type ResizeObserverManager,\n} from \"../useResizeObserver.js\";\n\n/**\n * @remarks \\@since 6.0.0\n */\nexport interface ResizeObserverEntrySize {\n  height?: number;\n  width?: number;\n}\n\n/**\n * @remarks \\@since 6.0.0\n */\nexport type GetResizeObserverEntryMock = (\n  target: Element,\n  size?: ResizeObserverEntrySize\n) => ResizeObserverEntry;\n\n/**\n * This is mostly an internal function to be used with the {@link ResizeObserverMock}\n * and {@link setupResizeObserverMock}\n *\n * @remarks \\@since 6.0.0\n */\nexport const createResizeObserverEntry: GetResizeObserverEntryMock = (\n  target,\n  size\n) => {\n  const contentRect = target.getBoundingClientRect();\n  if (typeof size?.height === \"number\") {\n    contentRect.height = size.height;\n  }\n  if (typeof size?.width === \"number\") {\n    contentRect.width = size.width;\n  }\n\n  const boxSize: ResizeObserverSize = {\n    blockSize: contentRect.height,\n    inlineSize: contentRect.width,\n  };\n\n  return {\n    target,\n    contentRect,\n    borderBoxSize: [boxSize],\n    contentBoxSize: [boxSize],\n    devicePixelContentBoxSize: [],\n  };\n};\n\n/**\n * This is the default ResizeObserver implementation if it does not already\n * exist in jsdom. You normally should not use this directly and instead use the\n * {@link setupResizeObserverMock} instead.\n *\n * @remarks \\@since 6.0.0\n */\nexport class ResizeObserverMock implements ResizeObserver {\n  elements: Set<Element>;\n\n  constructor(public callback: ResizeObserverCallback) {\n    this.elements = new Set();\n  }\n\n  observe = (target: Element): void => {\n    this.elements.add(target);\n    this.resizeAllElements(createResizeObserverEntry);\n  };\n\n  unobserve = (target: Element): void => {\n    this.elements.delete(target);\n  };\n\n  disconnect = (): void => {\n    this.elements.clear();\n  };\n\n  /**\n   * Triggers the resize event for a specific element. This must be wrapped in\n   * `act`.\n   *\n   * @example\n   * Main Usage\n   * ```tsx\n   * import {\n   *   cleanupResizeObserverAfterEach,\n   *   setupResizeObserverMock,\n   * } from \"@react-md/core/test-utils\";\n   * import { useResizeObserver } from \"@react-md/core\";\n   * import { ExampleComponent } from \"../ExampleComponent.js\";\n   *\n   * cleanupResizeObserverAfterEach();\n   *\n   * describe(\"ExampleComponent\", () => {\n   *   it(\"should do stuff\", () => {\n   *     const observer = setupResizeObserverMock();\n   *     render(<ExampleComponent />)\n   *\n   *     const resizeTarget = screen.getByTestId(\"resize-target\")\n   *\n   *     // you can trigger with a custom change\n   *     act(() => {\n   *       observer.resizeElement(resizeTarget, { height: 100, width: 100 });\n   *     });\n   *     // expect resize changes\n   *   });\n   * })\n   * ```\n   */\n  resizeElement = (\n    target: Element,\n    changesOrGetEntry:\n      | GetResizeObserverEntryMock\n      | ResizeObserverEntrySize\n      | ResizeObserverEntry = createResizeObserverEntry\n  ): void => {\n    if (!this.elements.has(target)) {\n      throw new Error(\n        \"The `ResizeObserverMock` is not watching the target element and cannot be resized\"\n      );\n    }\n\n    let entry: ResizeObserverEntry;\n    if (typeof changesOrGetEntry === \"function\") {\n      entry = changesOrGetEntry(target);\n    } else if (!(\"contentRect\" in changesOrGetEntry)) {\n      entry = createResizeObserverEntry(target, changesOrGetEntry);\n    } else {\n      entry = changesOrGetEntry;\n    }\n\n    this.callback([entry], this);\n  };\n\n  /**\n   * You'll normally want to use {@link resizeElement} instead, but this can be\n   * used to resize all the watched elements at once.\n   *\n   * @example\n   * ```tsx\n   * import {\n   *   act,\n   *   createResizeObserverEntry,\n   *   render,\n   *   screen,\n   *   setupResizeObserverMock,\n   * } from \"@react-md/core/test-utils\";\n   *\n   * const observer = setupResizeObserverMock();\n   * const { container } = render(<Test />)\n   * expect(container).toMatchSnapshot()\n   *\n   * const target1 = screen.getByTestId('target-1');\n   * const target2 = screen.getByTestId('target-2');\n   * const target3 = screen.getByTestId('target-3');\n   *\n   * act(() => {\n   *   observer.resizeAllElements((element) => {\n   *     let height: number | undefined;\n   *     let width: number | undefined;\n   *     switch (element) {\n   *       case target1:\n   *         height = 400;\n   *         width = 250;\n   *         break;\n   *       case target2:\n   *         height = 100;\n   *         width = 380;\n   *         break;\n   *       case target3:\n   *         height = 24;\n   *         width = 24;\n   *         break;\n   *     }\n   *\n   *     return createResizeObserverEntry(element, { height, width });\n   *   });\n   * });\n   * expect(container).toMatchSnapshot()\n   * ```\n   */\n  resizeAllElements = (getEntry = createResizeObserverEntry): void => {\n    const entries = [...this.elements].map((element) => getEntry(element));\n    this.callback(entries, this);\n  };\n}\n\n/**\n * @remarks \\@since 6.0.0\n */\nexport interface SetupResizeObserverMockOptions {\n  /**\n   * Set this to `true` to mimic the real `ResizeObserver` behavior where the\n   * updates occur after an animation frame instead of invoking immediately.\n   *\n   * Keeping this as `false` is recommended since this option was only added to\n   * make testing this function itself easier.\n   *\n   * @defaultValue `false`\n   */\n  raf?: boolean;\n\n  /**\n   * Keeping this as the `resizeObserverManager` is recommended since this\n   * option was only added to make testing this function easier itself.\n   *\n   * @defaultValue `resizeObserverManager`\n   */\n  manager?: ResizeObserverManager;\n}\n\n/**\n * Initializes the `ResizeObserverMock` to be used for tests.\n *\n * @example\n * Main Usage\n * ```tsx\n * import { useCallback, useState } from \"react\";\n * import {\n *   cleanupResizeObserverAfterEach,\n *   render,\n *   screen,\n *   setupResizeObserverMock,\n * } from \"@react-md/core/test-utils\";\n * import { useResizeObserver } from \"@react-md/core\";\n *\n * function ExampleComponent() {\n *   const [size, setSize] = useState({ height: 0, width: 0 });\n *   const ref = useResizeObserver({\n *     onUpdate: useCallback((entry) => {\n *       setSize({\n *         height: entry.contentRect.height,\n *         width: entry.contentRect.width,\n *       });\n *     });\n *   });\n *\n *   return (\n *     <>\n *       <div data-testid=\"size\">{JSON.stringify(size)}</div>\n *       <div data-testid=\"resize-target\" ref={ref} />\n *     </>\n *   );\n * }\n *\n * cleanupResizeObserverAfterEach();\n *\n * describe(\"ExampleComponent\", () => {\n *   it(\"should do stuff\", () => {\n *     const observer = setupResizeObserverMock();\n *     render(<ExampleComponent />)\n *\n *     const size = screen.getByTestId(\"size\");\n *     const resizeTarget = screen.getByTestId(\"resize-target\")\n *\n *     // jsdom sets all element sizes to 0 by default\n *     expect(size).toHaveTextContent(JSON.stringify({ height: 0, width: 0 }));\n *\n *     // you can trigger with a custom change\n *     act(() => {\n *       observer.resizeElement(resizeTarget, { height: 100, width: 100 });\n *     });\n *     expect(size).toHaveTextContent(JSON.stringify({ height: 100, width: 100 }));\n *\n *     // or you can mock the `getBoundingClientRect` result\n *     jest.spyOn(resizeTarget, \"getBoundingClientRect\")\n *       .mockReturnValue({\n *         ...document.body.getBoundingClientRect(),\n *         height: 200,\n *         width: 200,\n *       }):\n *\n *     act(() => {\n *       observer.resizeElement(resizeTarget);\n *     });\n *     expect(size).toHaveTextContent(JSON.stringify({ height: 200, width: 200 }));\n *   });\n * })\n * ```\n *\n * @remarks \\@since 6.0.0\n */\nexport function setupResizeObserverMock(\n  options: SetupResizeObserverMockOptions = {}\n): ResizeObserverMock {\n  const { raf, manager = resizeObserverManager } = options;\n\n  const resizeObserver = new ResizeObserverMock((entries) => {\n    if (raf) {\n      window.cancelAnimationFrame(manager.frame);\n      manager.frame = window.requestAnimationFrame(() => {\n        manager.handleResizeEntries(entries);\n      });\n    } else {\n      manager.handleResizeEntries(entries);\n    }\n  });\n  manager.sharedObserver = resizeObserver;\n  return resizeObserver;\n}\n\n/**\n * @see {@link setupResizeObserverMock}\n * @remarks \\@since 6.0.0\n */\nexport function cleanupResizeObserverAfterEach(restoreAllMocks = true): void {\n  afterEach(() => {\n    resizeObserverManager.frame = 0;\n    resizeObserverManager.subscriptions = new Map();\n    resizeObserverManager.sharedObserver = undefined;\n\n    if (restoreAllMocks) {\n      jest.restoreAllMocks();\n    }\n  });\n}\n"],"names":["afterEach","jest","resizeObserverManager","createResizeObserverEntry","target","size","contentRect","getBoundingClientRect","height","width","boxSize","blockSize","inlineSize","borderBoxSize","contentBoxSize","devicePixelContentBoxSize","ResizeObserverMock","constructor","callback","elements","observe","unobserve","disconnect","resizeElement","resizeAllElements","add","delete","clear","changesOrGetEntry","has","Error","entry","getEntry","entries","map","element","Set","setupResizeObserverMock","options","raf","manager","resizeObserver","window","cancelAnimationFrame","frame","requestAnimationFrame","handleResizeEntries","sharedObserver","cleanupResizeObserverAfterEach","restoreAllMocks","subscriptions","Map","undefined"],"rangeMappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;","mappings":"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"}
+{"version":3,"sources":["../../src/test-utils/ResizeObserver.ts"],"sourcesContent":["import { afterEach, jest } from \"@jest/globals\";\nimport {\n  resizeObserverManager,\n  type ResizeObserverManager,\n} from \"../useResizeObserver.js\";\n\n/**\n * @since 6.0.0\n */\nexport interface ResizeObserverEntrySize {\n  height?: number;\n  width?: number;\n}\n\n/**\n * @since 6.0.0\n */\nexport type GetResizeObserverEntryMock = (\n  target: Element,\n  size?: ResizeObserverEntrySize\n) => ResizeObserverEntry;\n\n/**\n * This is mostly an internal function to be used with the {@link ResizeObserverMock}\n * and {@link setupResizeObserverMock}\n *\n * @since 6.0.0\n */\nexport const createResizeObserverEntry: GetResizeObserverEntryMock = (\n  target,\n  size\n) => {\n  const contentRect = target.getBoundingClientRect();\n  if (typeof size?.height === \"number\") {\n    contentRect.height = size.height;\n  }\n  if (typeof size?.width === \"number\") {\n    contentRect.width = size.width;\n  }\n\n  const boxSize: ResizeObserverSize = {\n    blockSize: contentRect.height,\n    inlineSize: contentRect.width,\n  };\n\n  return {\n    target,\n    contentRect,\n    borderBoxSize: [boxSize],\n    contentBoxSize: [boxSize],\n    devicePixelContentBoxSize: [],\n  };\n};\n\n/**\n * This is the default ResizeObserver implementation if it does not already\n * exist in jsdom. You normally should not use this directly and instead use the\n * {@link setupResizeObserverMock} instead.\n *\n * @since 6.0.0\n */\nexport class ResizeObserverMock implements ResizeObserver {\n  elements: Set<Element>;\n\n  constructor(public callback: ResizeObserverCallback) {\n    this.elements = new Set();\n  }\n\n  observe = (target: Element): void => {\n    this.elements.add(target);\n    this.resizeAllElements(createResizeObserverEntry);\n  };\n\n  unobserve = (target: Element): void => {\n    this.elements.delete(target);\n  };\n\n  disconnect = (): void => {\n    this.elements.clear();\n  };\n\n  /**\n   * Triggers the resize event for a specific element. This must be wrapped in\n   * `act`.\n   *\n   * @example Main Usage\n   * ```tsx\n   * import {\n   *   cleanupResizeObserverAfterEach,\n   *   setupResizeObserverMock,\n   * } from \"@react-md/core/test-utils\";\n   * import { useResizeObserver } from \"@react-md/core\";\n   * import { ExampleComponent } from \"../ExampleComponent.js\";\n   *\n   * cleanupResizeObserverAfterEach();\n   *\n   * describe(\"ExampleComponent\", () => {\n   *   it(\"should do stuff\", () => {\n   *     const observer = setupResizeObserverMock();\n   *     render(<ExampleComponent />)\n   *\n   *     const resizeTarget = screen.getByTestId(\"resize-target\")\n   *\n   *     // you can trigger with a custom change\n   *     act(() => {\n   *       observer.resizeElement(resizeTarget, { height: 100, width: 100 });\n   *     });\n   *     // expect resize changes\n   *   });\n   * })\n   * ```\n   */\n  resizeElement = (\n    target: Element,\n    changesOrGetEntry:\n      | GetResizeObserverEntryMock\n      | ResizeObserverEntrySize\n      | ResizeObserverEntry = createResizeObserverEntry\n  ): void => {\n    if (!this.elements.has(target)) {\n      throw new Error(\n        \"The `ResizeObserverMock` is not watching the target element and cannot be resized\"\n      );\n    }\n\n    let entry: ResizeObserverEntry;\n    if (typeof changesOrGetEntry === \"function\") {\n      entry = changesOrGetEntry(target);\n    } else if (!(\"contentRect\" in changesOrGetEntry)) {\n      entry = createResizeObserverEntry(target, changesOrGetEntry);\n    } else {\n      entry = changesOrGetEntry;\n    }\n\n    this.callback([entry], this);\n  };\n\n  /**\n   * You'll normally want to use {@link resizeElement} instead, but this can be\n   * used to resize all the watched elements at once.\n   *\n   * @example\n   * ```tsx\n   * import {\n   *   act,\n   *   createResizeObserverEntry,\n   *   render,\n   *   screen,\n   *   setupResizeObserverMock,\n   * } from \"@react-md/core/test-utils\";\n   *\n   * const observer = setupResizeObserverMock();\n   * const { container } = render(<Test />)\n   * expect(container).toMatchSnapshot()\n   *\n   * const target1 = screen.getByTestId('target-1');\n   * const target2 = screen.getByTestId('target-2');\n   * const target3 = screen.getByTestId('target-3');\n   *\n   * act(() => {\n   *   observer.resizeAllElements((element) => {\n   *     let height: number | undefined;\n   *     let width: number | undefined;\n   *     switch (element) {\n   *       case target1:\n   *         height = 400;\n   *         width = 250;\n   *         break;\n   *       case target2:\n   *         height = 100;\n   *         width = 380;\n   *         break;\n   *       case target3:\n   *         height = 24;\n   *         width = 24;\n   *         break;\n   *     }\n   *\n   *     return createResizeObserverEntry(element, { height, width });\n   *   });\n   * });\n   * expect(container).toMatchSnapshot()\n   * ```\n   */\n  resizeAllElements = (getEntry = createResizeObserverEntry): void => {\n    const entries = [...this.elements].map((element) => getEntry(element));\n    this.callback(entries, this);\n  };\n}\n\n/**\n * @since 6.0.0\n */\nexport interface SetupResizeObserverMockOptions {\n  /**\n   * Set this to `true` to mimic the real `ResizeObserver` behavior where the\n   * updates occur after an animation frame instead of invoking immediately.\n   *\n   * Keeping this as `false` is recommended since this option was only added to\n   * make testing this function itself easier.\n   *\n   * @defaultValue `false`\n   */\n  raf?: boolean;\n\n  /**\n   * Keeping this as the `resizeObserverManager` is recommended since this\n   * option was only added to make testing this function easier itself.\n   *\n   * @defaultValue `resizeObserverManager`\n   */\n  manager?: ResizeObserverManager;\n}\n\n/**\n * Initializes the `ResizeObserverMock` to be used for tests.\n *\n * @example Main Usage\n * ```tsx\n * import { useCallback, useState } from \"react\";\n * import {\n *   cleanupResizeObserverAfterEach,\n *   render,\n *   screen,\n *   setupResizeObserverMock,\n * } from \"@react-md/core/test-utils\";\n * import { useResizeObserver } from \"@react-md/core\";\n *\n * function ExampleComponent() {\n *   const [size, setSize] = useState({ height: 0, width: 0 });\n *   const ref = useResizeObserver({\n *     onUpdate: useCallback((entry) => {\n *       setSize({\n *         height: entry.contentRect.height,\n *         width: entry.contentRect.width,\n *       });\n *     });\n *   });\n *\n *   return (\n *     <>\n *       <div data-testid=\"size\">{JSON.stringify(size)}</div>\n *       <div data-testid=\"resize-target\" ref={ref} />\n *     </>\n *   );\n * }\n *\n * cleanupResizeObserverAfterEach();\n *\n * describe(\"ExampleComponent\", () => {\n *   it(\"should do stuff\", () => {\n *     const observer = setupResizeObserverMock();\n *     render(<ExampleComponent />)\n *\n *     const size = screen.getByTestId(\"size\");\n *     const resizeTarget = screen.getByTestId(\"resize-target\")\n *\n *     // jsdom sets all element sizes to 0 by default\n *     expect(size).toHaveTextContent(JSON.stringify({ height: 0, width: 0 }));\n *\n *     // you can trigger with a custom change\n *     act(() => {\n *       observer.resizeElement(resizeTarget, { height: 100, width: 100 });\n *     });\n *     expect(size).toHaveTextContent(JSON.stringify({ height: 100, width: 100 }));\n *\n *     // or you can mock the `getBoundingClientRect` result\n *     jest.spyOn(resizeTarget, \"getBoundingClientRect\")\n *       .mockReturnValue({\n *         ...document.body.getBoundingClientRect(),\n *         height: 200,\n *         width: 200,\n *       }):\n *\n *     act(() => {\n *       observer.resizeElement(resizeTarget);\n *     });\n *     expect(size).toHaveTextContent(JSON.stringify({ height: 200, width: 200 }));\n *   });\n * })\n * ```\n *\n * @since 6.0.0\n */\nexport function setupResizeObserverMock(\n  options: SetupResizeObserverMockOptions = {}\n): ResizeObserverMock {\n  const { raf, manager = resizeObserverManager } = options;\n\n  const resizeObserver = new ResizeObserverMock((entries) => {\n    if (raf) {\n      window.cancelAnimationFrame(manager.frame);\n      manager.frame = window.requestAnimationFrame(() => {\n        manager.handleResizeEntries(entries);\n      });\n    } else {\n      manager.handleResizeEntries(entries);\n    }\n  });\n  manager.sharedObserver = resizeObserver;\n  return resizeObserver;\n}\n\n/**\n * @see {@link setupResizeObserverMock}\n * @since 6.0.0\n */\nexport function cleanupResizeObserverAfterEach(restoreAllMocks = true): void {\n  afterEach(() => {\n    resizeObserverManager.frame = 0;\n    resizeObserverManager.subscriptions = new Map();\n    resizeObserverManager.sharedObserver = undefined;\n\n    if (restoreAllMocks) {\n      jest.restoreAllMocks();\n    }\n  });\n}\n"],"names":["afterEach","jest","resizeObserverManager","createResizeObserverEntry","target","size","contentRect","getBoundingClientRect","height","width","boxSize","blockSize","inlineSize","borderBoxSize","contentBoxSize","devicePixelContentBoxSize","ResizeObserverMock","constructor","callback","elements","observe","unobserve","disconnect","resizeElement","resizeAllElements","add","delete","clear","changesOrGetEntry","has","Error","entry","getEntry","entries","map","element","Set","setupResizeObserverMock","options","raf","manager","resizeObserver","window","cancelAnimationFrame","frame","requestAnimationFrame","handleResizeEntries","sharedObserver","cleanupResizeObserverAfterEach","restoreAllMocks","subscriptions","Map","undefined"],"rangeMappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;","mappings":"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"}

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

@@ -2,48 +2,47 @@ import { jest } from "@jest/globals";
 /**
  * @see {@link spyOnMatchMedia} instead
  * @internal
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */
 export declare const BASE_MEDIA_QUERY_LIST: MediaQueryList;
-/** @remarks \@since 6.0.0 */
+/** @since 6.0.0 */
 export type MatchMediaMatcher = (query: string) => boolean;
 /**
  * @see {@link spyOnMatchMedia} for usage
- * @remarks \@since 6.0.0
+ * @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
+ * @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
+ * @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
+ * @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
+ * @since 6.0.0
  * @returns `true` for both desktop and large desktop media queries
  */
 export declare const matchAnyDesktop: MatchMediaMatcher;
 /**
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */
 export type MatchMediaSpiedFunction = jest.SpiedFunction<typeof window.matchMedia> & {
     /**
-     * @example
-     * Default Behavior
+     * @example Default Behavior
      * ```tsx
      * const matchMedia = spyOnMatchMedia();
      * render(<Test />);
@@ -54,8 +53,7 @@ export type MatchMediaSpiedFunction = jest.SpiedFunction<typeof window.matchMedi
      * // expect phone results
      * ```
      *
-     * @example
-     * Custom Act Behavior
+     * @example Custom Act Behavior
      * ```tsx
      * const matchMedia = spyOnMatchMedia();
      * const { rerender } = render(<Test />);
@@ -71,8 +69,7 @@ export type MatchMediaSpiedFunction = jest.SpiedFunction<typeof window.matchMedi
     changeViewport(matcher: MatchMediaMatcher, disableAct?: boolean): void;
 };
 /**
- * @example
- * Default Behavior
+ * @example Default Behavior
  * ```tsx
  * import { matchPhone, render, spyOnMatchMedia } from "@react-md/test-utils";
  *
@@ -85,8 +82,7 @@ export type MatchMediaSpiedFunction = jest.SpiedFunction<typeof window.matchMedi
  * // expect phone results
  * ```
  *
- * @example
- * Set Default Media
+ * @example Set Default Media
  * ```tsx
  * import { matchPhone, render, spyOnMatchMedia } from "@react-md/test-utils";
  *
@@ -96,6 +92,6 @@ export type MatchMediaSpiedFunction = jest.SpiedFunction<typeof window.matchMedi
  * // expect phone results
  * ```
  *
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */
 export declare function spyOnMatchMedia(defaultMatch?: MatchMediaMatcher): MatchMediaSpiedFunction;

package/dist/test-utils/matchMedia.js

@@ -7,7 +7,7 @@ const noop = ()=>{
 /**
  * @see {@link spyOnMatchMedia} instead
  * @internal
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */ export const BASE_MEDIA_QUERY_LIST = {
     media: "",
     matches: false,
@@ -20,32 +20,31 @@ const noop = ()=>{
 };
 /**
  * @see {@link spyOnMatchMedia} for usage
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  * @returns `true` for phone media queries
  */ export const matchPhone = (query)=>query.includes(`${DEFAULT_PHONE_MAX_WIDTH}`);
 /**
  * @see {@link spyOnMatchMedia} for usage
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  * @returns `true` for tablet media queries
  */ export const matchTablet = (query)=>query.includes(`${DEFAULT_TABLET_MIN_WIDTH}`);
 /**
  * @see {@link spyOnMatchMedia} for usage
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  * @returns `true` for desktop media queries
  */ export const matchDesktop = (query)=>query.includes(`${DEFAULT_DESKTOP_MIN_WIDTH}`);
 /**
  * @see {@link spyOnMatchMedia} for usage
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  * @returns `true` for large desktop media queries
  */ export const matchLargeDesktop = (query)=>query.includes(`${DEFAULT_DESKTOP_LARGE_MIN_WIDTH}`);
 /**
  * @see {@link spyOnMatchMedia} for usage
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  * @returns `true` for both desktop and large desktop media queries
  */ export const matchAnyDesktop = (query)=>matchDesktop(query) || matchLargeDesktop(query);
 /**
- * @example
- * Default Behavior
+ * @example Default Behavior
  * ```tsx
  * import { matchPhone, render, spyOnMatchMedia } from "@react-md/test-utils";
  *
@@ -58,8 +57,7 @@ const noop = ()=>{
  * // expect phone results
  * ```
  *
- * @example
- * Set Default Media
+ * @example Set Default Media
  * ```tsx
  * import { matchPhone, render, spyOnMatchMedia } from "@react-md/test-utils";
  *
@@ -69,7 +67,7 @@ const noop = ()=>{
  * // expect phone results
  * ```
  *
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */ export function spyOnMatchMedia(defaultMatch = matchDesktop) {
     const listeners = new Map();
     const matchMedia = jest.spyOn(window, "matchMedia").mockImplementation((query)=>({

package/dist/test-utils/matchMedia.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/test-utils/matchMedia.ts"],"sourcesContent":["import { jest } from \"@jest/globals\";\nimport { act } from \"@testing-library/react\";\nimport {\n  DEFAULT_DESKTOP_LARGE_MIN_WIDTH,\n  DEFAULT_DESKTOP_MIN_WIDTH,\n  DEFAULT_PHONE_MAX_WIDTH,\n  DEFAULT_TABLET_MIN_WIDTH,\n} from \"../media-queries/appSize.js\";\n\nconst noop = (): void => {\n  // do nothing\n};\n\n/**\n * @see {@link spyOnMatchMedia} instead\n * @internal\n * @remarks \\@since 6.0.0\n */\nexport const BASE_MEDIA_QUERY_LIST: MediaQueryList = {\n  media: \"\",\n  matches: false,\n  onchange: noop,\n  addListener: noop,\n  addEventListener: noop,\n  removeEventListener: noop,\n  removeListener: noop,\n  dispatchEvent: () => false,\n};\n\n/** @remarks \\@since 6.0.0 */\nexport type MatchMediaMatcher = (query: string) => boolean;\n\n/**\n * @see {@link spyOnMatchMedia} for usage\n * @remarks \\@since 6.0.0\n * @returns `true` for phone media queries\n */\nexport const matchPhone: MatchMediaMatcher = (query) =>\n  query.includes(`${DEFAULT_PHONE_MAX_WIDTH}`);\n\n/**\n * @see {@link spyOnMatchMedia} for usage\n * @remarks \\@since 6.0.0\n * @returns `true` for tablet media queries\n */\nexport const matchTablet: MatchMediaMatcher = (query) =>\n  query.includes(`${DEFAULT_TABLET_MIN_WIDTH}`);\n\n/**\n * @see {@link spyOnMatchMedia} for usage\n * @remarks \\@since 6.0.0\n * @returns `true` for desktop media queries\n */\nexport const matchDesktop: MatchMediaMatcher = (query) =>\n  query.includes(`${DEFAULT_DESKTOP_MIN_WIDTH}`);\n\n/**\n * @see {@link spyOnMatchMedia} for usage\n * @remarks \\@since 6.0.0\n * @returns `true` for large desktop media queries\n */\nexport const matchLargeDesktop: MatchMediaMatcher = (query) =>\n  query.includes(`${DEFAULT_DESKTOP_LARGE_MIN_WIDTH}`);\n\n/**\n * @see {@link spyOnMatchMedia} for usage\n * @remarks \\@since 6.0.0\n * @returns `true` for both desktop and large desktop media queries\n */\nexport const matchAnyDesktop: MatchMediaMatcher = (query) =>\n  matchDesktop(query) || matchLargeDesktop(query);\n\n/**\n * @remarks \\@since 6.0.0\n */\nexport type MatchMediaSpiedFunction = jest.SpiedFunction<\n  typeof window.matchMedia\n> & {\n  /**\n   * @example\n   * Default Behavior\n   * ```tsx\n   * const matchMedia = spyOnMatchMedia();\n   * render(<Test />);\n   *\n   * // expect desktop results\n   *\n   * matchMedia.changeViewport(matchPhone);\n   * // expect phone results\n   * ```\n   *\n   * @example\n   * Custom Act Behavior\n   * ```tsx\n   * const matchMedia = spyOnMatchMedia();\n   * const { rerender } = render(<Test />);\n   *\n   * // expect desktop results\n   *\n   * matchMedia.changeViewport(matchPhone, false);\n   * rerender(<Test key=\"new-key\" />);\n   *\n   * // expect phone results\n   * ```\n   */\n  changeViewport(matcher: MatchMediaMatcher, disableAct?: boolean): void;\n};\n\n/**\n * @example\n * Default Behavior\n * ```tsx\n * import { matchPhone, render, spyOnMatchMedia } from \"@react-md/test-utils\";\n *\n * const matchMedia = spyOnMatchMedia();\n * render(<Test />);\n *\n * // expect desktop results\n *\n * matchMedia.changeViewport(matchPhone);\n * // expect phone results\n * ```\n *\n * @example\n * Set Default Media\n * ```tsx\n * import { matchPhone, render, spyOnMatchMedia } from \"@react-md/test-utils\";\n *\n * const matchMedia = spyOnMatchMedia(matchPhone);\n * render(<Test />);\n *\n * // expect phone results\n * ```\n *\n * @remarks \\@since 6.0.0\n */\nexport function spyOnMatchMedia(\n  defaultMatch: MatchMediaMatcher = matchDesktop\n): MatchMediaSpiedFunction {\n  type Listener = (event: MediaQueryListEvent) => void;\n\n  const listeners = new Map<string, Listener>();\n  const matchMedia = jest\n    .spyOn(window, \"matchMedia\")\n    .mockImplementation((query) => ({\n      ...BASE_MEDIA_QUERY_LIST,\n      addEventListener(type: string, listener: Listener | EventListenerObject) {\n        /* c8 ignore start */\n        if (typeof listener !== \"function\" || type !== \"change\") {\n          return;\n        }\n        /* c8 ignore stop */\n\n        listeners.set(query, listener);\n      },\n      removeEventListener(\n        type: string,\n        listener: Listener | EventListenerObject\n      ) {\n        /* c8 ignore start */\n        if (typeof listener !== \"function\" || type !== \"change\") {\n          return;\n        }\n        /* c8 ignore stop */\n\n        listeners.delete(query);\n      },\n      matches: defaultMatch(query),\n    }));\n\n  const changeViewport = (\n    matcher: MatchMediaMatcher,\n    disableAct = false\n  ): void => {\n    const update = (): void => {\n      window.dispatchEvent(new Event(\"resize\"));\n\n      const event = new Event(\"change\");\n      listeners.forEach((listener, query) => {\n        listener({\n          ...event,\n          media: \"\",\n          matches: matcher(query),\n        });\n      });\n    };\n    if (disableAct) {\n      update();\n    } else {\n      act(update);\n    }\n  };\n\n  const mock = matchMedia as MatchMediaSpiedFunction;\n  mock.changeViewport = changeViewport;\n\n  return mock;\n}\n"],"names":["jest","act","DEFAULT_DESKTOP_LARGE_MIN_WIDTH","DEFAULT_DESKTOP_MIN_WIDTH","DEFAULT_PHONE_MAX_WIDTH","DEFAULT_TABLET_MIN_WIDTH","noop","BASE_MEDIA_QUERY_LIST","media","matches","onchange","addListener","addEventListener","removeEventListener","removeListener","dispatchEvent","matchPhone","query","includes","matchTablet","matchDesktop","matchLargeDesktop","matchAnyDesktop","spyOnMatchMedia","defaultMatch","listeners","Map","matchMedia","spyOn","window","mockImplementation","type","listener","set","delete","changeViewport","matcher","disableAct","update","Event","event","forEach","mock"],"rangeMappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;","mappings":"AAAA,SAASA,IAAI,QAAQ,gBAAgB;AACrC,SAASC,GAAG,QAAQ,yBAAyB;AAC7C,SACEC,+BAA+B,EAC/BC,yBAAyB,EACzBC,uBAAuB,EACvBC,wBAAwB,QACnB,8BAA8B;AAErC,MAAMC,OAAO;AACX,aAAa;AACf;AAEA;;;;CAIC,GACD,OAAO,MAAMC,wBAAwC;IACnDC,OAAO;IACPC,SAAS;IACTC,UAAUJ;IACVK,aAAaL;IACbM,kBAAkBN;IAClBO,qBAAqBP;IACrBQ,gBAAgBR;IAChBS,eAAe,IAAM;AACvB,EAAE;AAKF;;;;CAIC,GACD,OAAO,MAAMC,aAAgC,CAACC,QAC5CA,MAAMC,QAAQ,CAAC,CAAC,EAAEd,wBAAwB,CAAC,EAAE;AAE/C;;;;CAIC,GACD,OAAO,MAAMe,cAAiC,CAACF,QAC7CA,MAAMC,QAAQ,CAAC,CAAC,EAAEb,yBAAyB,CAAC,EAAE;AAEhD;;;;CAIC,GACD,OAAO,MAAMe,eAAkC,CAACH,QAC9CA,MAAMC,QAAQ,CAAC,CAAC,EAAEf,0BAA0B,CAAC,EAAE;AAEjD;;;;CAIC,GACD,OAAO,MAAMkB,oBAAuC,CAACJ,QACnDA,MAAMC,QAAQ,CAAC,CAAC,EAAEhB,gCAAgC,CAAC,EAAE;AAEvD;;;;CAIC,GACD,OAAO,MAAMoB,kBAAqC,CAACL,QACjDG,aAAaH,UAAUI,kBAAkBJ,OAAO;AAsClD;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BC,GACD,OAAO,SAASM,gBACdC,eAAkCJ,YAAY;IAI9C,MAAMK,YAAY,IAAIC;IACtB,MAAMC,aAAa3B,KAChB4B,KAAK,CAACC,QAAQ,cACdC,kBAAkB,CAAC,CAACb,QAAW,CAAA;YAC9B,GAAGV,qBAAqB;YACxBK,kBAAiBmB,IAAY,EAAEC,QAAwC;gBACrE,mBAAmB,GACnB,IAAI,OAAOA,aAAa,cAAcD,SAAS,UAAU;oBACvD;gBACF;gBACA,kBAAkB,GAElBN,UAAUQ,GAAG,CAAChB,OAAOe;YACvB;YACAnB,qBACEkB,IAAY,EACZC,QAAwC;gBAExC,mBAAmB,GACnB,IAAI,OAAOA,aAAa,cAAcD,SAAS,UAAU;oBACvD;gBACF;gBACA,kBAAkB,GAElBN,UAAUS,MAAM,CAACjB;YACnB;YACAR,SAASe,aAAaP;QACxB,CAAA;IAEF,MAAMkB,iBAAiB,CACrBC,SACAC,aAAa,KAAK;QAElB,MAAMC,SAAS;YACbT,OAAOd,aAAa,CAAC,IAAIwB,MAAM;YAE/B,MAAMC,QAAQ,IAAID,MAAM;YACxBd,UAAUgB,OAAO,CAAC,CAACT,UAAUf;gBAC3Be,SAAS;oBACP,GAAGQ,KAAK;oBACRhC,OAAO;oBACPC,SAAS2B,QAAQnB;gBACnB;YACF;QACF;QACA,IAAIoB,YAAY;YACdC;QACF,OAAO;YACLrC,IAAIqC;QACN;IACF;IAEA,MAAMI,OAAOf;IACbe,KAAKP,cAAc,GAAGA;IAEtB,OAAOO;AACT"}
+{"version":3,"sources":["../../src/test-utils/matchMedia.ts"],"sourcesContent":["import { jest } from \"@jest/globals\";\nimport { act } from \"@testing-library/react\";\nimport {\n  DEFAULT_DESKTOP_LARGE_MIN_WIDTH,\n  DEFAULT_DESKTOP_MIN_WIDTH,\n  DEFAULT_PHONE_MAX_WIDTH,\n  DEFAULT_TABLET_MIN_WIDTH,\n} from \"../media-queries/appSize.js\";\n\nconst noop = (): void => {\n  // do nothing\n};\n\n/**\n * @see {@link spyOnMatchMedia} instead\n * @internal\n * @since 6.0.0\n */\nexport const BASE_MEDIA_QUERY_LIST: MediaQueryList = {\n  media: \"\",\n  matches: false,\n  onchange: noop,\n  addListener: noop,\n  addEventListener: noop,\n  removeEventListener: noop,\n  removeListener: noop,\n  dispatchEvent: () => false,\n};\n\n/** @since 6.0.0 */\nexport type MatchMediaMatcher = (query: string) => boolean;\n\n/**\n * @see {@link spyOnMatchMedia} for usage\n * @since 6.0.0\n * @returns `true` for phone media queries\n */\nexport const matchPhone: MatchMediaMatcher = (query) =>\n  query.includes(`${DEFAULT_PHONE_MAX_WIDTH}`);\n\n/**\n * @see {@link spyOnMatchMedia} for usage\n * @since 6.0.0\n * @returns `true` for tablet media queries\n */\nexport const matchTablet: MatchMediaMatcher = (query) =>\n  query.includes(`${DEFAULT_TABLET_MIN_WIDTH}`);\n\n/**\n * @see {@link spyOnMatchMedia} for usage\n * @since 6.0.0\n * @returns `true` for desktop media queries\n */\nexport const matchDesktop: MatchMediaMatcher = (query) =>\n  query.includes(`${DEFAULT_DESKTOP_MIN_WIDTH}`);\n\n/**\n * @see {@link spyOnMatchMedia} for usage\n * @since 6.0.0\n * @returns `true` for large desktop media queries\n */\nexport const matchLargeDesktop: MatchMediaMatcher = (query) =>\n  query.includes(`${DEFAULT_DESKTOP_LARGE_MIN_WIDTH}`);\n\n/**\n * @see {@link spyOnMatchMedia} for usage\n * @since 6.0.0\n * @returns `true` for both desktop and large desktop media queries\n */\nexport const matchAnyDesktop: MatchMediaMatcher = (query) =>\n  matchDesktop(query) || matchLargeDesktop(query);\n\n/**\n * @since 6.0.0\n */\nexport type MatchMediaSpiedFunction = jest.SpiedFunction<\n  typeof window.matchMedia\n> & {\n  /**\n   * @example Default Behavior\n   * ```tsx\n   * const matchMedia = spyOnMatchMedia();\n   * render(<Test />);\n   *\n   * // expect desktop results\n   *\n   * matchMedia.changeViewport(matchPhone);\n   * // expect phone results\n   * ```\n   *\n   * @example Custom Act Behavior\n   * ```tsx\n   * const matchMedia = spyOnMatchMedia();\n   * const { rerender } = render(<Test />);\n   *\n   * // expect desktop results\n   *\n   * matchMedia.changeViewport(matchPhone, false);\n   * rerender(<Test key=\"new-key\" />);\n   *\n   * // expect phone results\n   * ```\n   */\n  changeViewport(matcher: MatchMediaMatcher, disableAct?: boolean): void;\n};\n\n/**\n * @example Default Behavior\n * ```tsx\n * import { matchPhone, render, spyOnMatchMedia } from \"@react-md/test-utils\";\n *\n * const matchMedia = spyOnMatchMedia();\n * render(<Test />);\n *\n * // expect desktop results\n *\n * matchMedia.changeViewport(matchPhone);\n * // expect phone results\n * ```\n *\n * @example Set Default Media\n * ```tsx\n * import { matchPhone, render, spyOnMatchMedia } from \"@react-md/test-utils\";\n *\n * const matchMedia = spyOnMatchMedia(matchPhone);\n * render(<Test />);\n *\n * // expect phone results\n * ```\n *\n * @since 6.0.0\n */\nexport function spyOnMatchMedia(\n  defaultMatch: MatchMediaMatcher = matchDesktop\n): MatchMediaSpiedFunction {\n  type Listener = (event: MediaQueryListEvent) => void;\n\n  const listeners = new Map<string, Listener>();\n  const matchMedia = jest\n    .spyOn(window, \"matchMedia\")\n    .mockImplementation((query) => ({\n      ...BASE_MEDIA_QUERY_LIST,\n      addEventListener(type: string, listener: Listener | EventListenerObject) {\n        /* c8 ignore start */\n        if (typeof listener !== \"function\" || type !== \"change\") {\n          return;\n        }\n        /* c8 ignore stop */\n\n        listeners.set(query, listener);\n      },\n      removeEventListener(\n        type: string,\n        listener: Listener | EventListenerObject\n      ) {\n        /* c8 ignore start */\n        if (typeof listener !== \"function\" || type !== \"change\") {\n          return;\n        }\n        /* c8 ignore stop */\n\n        listeners.delete(query);\n      },\n      matches: defaultMatch(query),\n    }));\n\n  const changeViewport = (\n    matcher: MatchMediaMatcher,\n    disableAct = false\n  ): void => {\n    const update = (): void => {\n      window.dispatchEvent(new Event(\"resize\"));\n\n      const event = new Event(\"change\");\n      listeners.forEach((listener, query) => {\n        listener({\n          ...event,\n          media: \"\",\n          matches: matcher(query),\n        });\n      });\n    };\n    if (disableAct) {\n      update();\n    } else {\n      act(update);\n    }\n  };\n\n  const mock = matchMedia as MatchMediaSpiedFunction;\n  mock.changeViewport = changeViewport;\n\n  return mock;\n}\n"],"names":["jest","act","DEFAULT_DESKTOP_LARGE_MIN_WIDTH","DEFAULT_DESKTOP_MIN_WIDTH","DEFAULT_PHONE_MAX_WIDTH","DEFAULT_TABLET_MIN_WIDTH","noop","BASE_MEDIA_QUERY_LIST","media","matches","onchange","addListener","addEventListener","removeEventListener","removeListener","dispatchEvent","matchPhone","query","includes","matchTablet","matchDesktop","matchLargeDesktop","matchAnyDesktop","spyOnMatchMedia","defaultMatch","listeners","Map","matchMedia","spyOn","window","mockImplementation","type","listener","set","delete","changeViewport","matcher","disableAct","update","Event","event","forEach","mock"],"rangeMappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;","mappings":"AAAA,SAASA,IAAI,QAAQ,gBAAgB;AACrC,SAASC,GAAG,QAAQ,yBAAyB;AAC7C,SACEC,+BAA+B,EAC/BC,yBAAyB,EACzBC,uBAAuB,EACvBC,wBAAwB,QACnB,8BAA8B;AAErC,MAAMC,OAAO;AACX,aAAa;AACf;AAEA;;;;CAIC,GACD,OAAO,MAAMC,wBAAwC;IACnDC,OAAO;IACPC,SAAS;IACTC,UAAUJ;IACVK,aAAaL;IACbM,kBAAkBN;IAClBO,qBAAqBP;IACrBQ,gBAAgBR;IAChBS,eAAe,IAAM;AACvB,EAAE;AAKF;;;;CAIC,GACD,OAAO,MAAMC,aAAgC,CAACC,QAC5CA,MAAMC,QAAQ,CAAC,CAAC,EAAEd,wBAAwB,CAAC,EAAE;AAE/C;;;;CAIC,GACD,OAAO,MAAMe,cAAiC,CAACF,QAC7CA,MAAMC,QAAQ,CAAC,CAAC,EAAEb,yBAAyB,CAAC,EAAE;AAEhD;;;;CAIC,GACD,OAAO,MAAMe,eAAkC,CAACH,QAC9CA,MAAMC,QAAQ,CAAC,CAAC,EAAEf,0BAA0B,CAAC,EAAE;AAEjD;;;;CAIC,GACD,OAAO,MAAMkB,oBAAuC,CAACJ,QACnDA,MAAMC,QAAQ,CAAC,CAAC,EAAEhB,gCAAgC,CAAC,EAAE;AAEvD;;;;CAIC,GACD,OAAO,MAAMoB,kBAAqC,CAACL,QACjDG,aAAaH,UAAUI,kBAAkBJ,OAAO;AAoClD;;;;;;;;;;;;;;;;;;;;;;;;;CAyBC,GACD,OAAO,SAASM,gBACdC,eAAkCJ,YAAY;IAI9C,MAAMK,YAAY,IAAIC;IACtB,MAAMC,aAAa3B,KAChB4B,KAAK,CAACC,QAAQ,cACdC,kBAAkB,CAAC,CAACb,QAAW,CAAA;YAC9B,GAAGV,qBAAqB;YACxBK,kBAAiBmB,IAAY,EAAEC,QAAwC;gBACrE,mBAAmB,GACnB,IAAI,OAAOA,aAAa,cAAcD,SAAS,UAAU;oBACvD;gBACF;gBACA,kBAAkB,GAElBN,UAAUQ,GAAG,CAAChB,OAAOe;YACvB;YACAnB,qBACEkB,IAAY,EACZC,QAAwC;gBAExC,mBAAmB,GACnB,IAAI,OAAOA,aAAa,cAAcD,SAAS,UAAU;oBACvD;gBACF;gBACA,kBAAkB,GAElBN,UAAUS,MAAM,CAACjB;YACnB;YACAR,SAASe,aAAaP;QACxB,CAAA;IAEF,MAAMkB,iBAAiB,CACrBC,SACAC,aAAa,KAAK;QAElB,MAAMC,SAAS;YACbT,OAAOd,aAAa,CAAC,IAAIwB,MAAM;YAE/B,MAAMC,QAAQ,IAAID,MAAM;YACxBd,UAAUgB,OAAO,CAAC,CAACT,UAAUf;gBAC3Be,SAAS;oBACP,GAAGQ,KAAK;oBACRhC,OAAO;oBACPC,SAAS2B,QAAQnB;gBACnB;YACF;QACF;QACA,IAAIoB,YAAY;YACdC;QACF,OAAO;YACLrC,IAAIqC;QACN;IACF;IAEA,MAAMI,OAAOf;IACbe,KAAKP,cAAc,GAAGA;IAEtB,OAAOO;AACT"}

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

@@ -2,12 +2,12 @@ import { type Queries, type RenderOptions, type RenderResult, type queries } fro
 import { type ReactElement } from "react";
 import { type CoreProvidersProps } from "../CoreProviders.js";
 /**
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */
 export interface ReactMDRenderOptions<Q extends Queries = typeof queries, Container extends Element | DocumentFragment = HTMLElement, BaseElement extends Element | DocumentFragment = Container> extends RenderOptions<Q, Container, BaseElement> {
     rmdConfig?: Omit<CoreProvidersProps, "children">;
 }
 /**
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */
 export declare function rmdRender<Q extends Queries = typeof queries, Container extends Element | DocumentFragment = HTMLElement, BaseElement extends Element | DocumentFragment = Container>(ui: ReactElement, options?: ReactMDRenderOptions<Q, Container, BaseElement>): RenderResult<Q, Container, BaseElement>;

package/dist/test-utils/render.js

@@ -3,7 +3,7 @@ import { render } from "@testing-library/react";
 import { Fragment } from "react";
 import { CoreProviders } from "../CoreProviders.js";
 /**
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */ export function rmdRender(ui, options = {}) {
     const { wrapper: Wrapper = Fragment, rmdConfig, ...renderOptions } = options;
     return render(ui, {

package/dist/test-utils/render.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/test-utils/render.tsx"],"sourcesContent":["import {\n  render,\n  type Queries,\n  type RenderOptions,\n  type RenderResult,\n  type queries,\n} from \"@testing-library/react\";\nimport { Fragment, type ReactElement } from \"react\";\nimport { CoreProviders, type CoreProvidersProps } from \"../CoreProviders.js\";\n\n/**\n * @remarks \\@since 6.0.0\n */\nexport interface ReactMDRenderOptions<\n  Q extends Queries = typeof queries,\n  Container extends Element | DocumentFragment = HTMLElement,\n  BaseElement extends Element | DocumentFragment = Container,\n> extends RenderOptions<Q, Container, BaseElement> {\n  rmdConfig?: Omit<CoreProvidersProps, \"children\">;\n}\n\n/**\n * @remarks \\@since 6.0.0\n */\nexport function rmdRender<\n  Q extends Queries = typeof queries,\n  Container extends Element | DocumentFragment = HTMLElement,\n  BaseElement extends Element | DocumentFragment = Container,\n>(\n  ui: ReactElement,\n  options: ReactMDRenderOptions<Q, Container, BaseElement> = {}\n): RenderResult<Q, Container, BaseElement> {\n  const { wrapper: Wrapper = Fragment, rmdConfig, ...renderOptions } = options;\n\n  return render(ui, {\n    ...renderOptions,\n    wrapper: function ReactMDTestWrapper(props) {\n      return (\n        <CoreProviders {...rmdConfig}>\n          <Wrapper>{props.children}</Wrapper>\n        </CoreProviders>\n      );\n    },\n  });\n}\n"],"names":["render","Fragment","CoreProviders","rmdRender","ui","options","wrapper","Wrapper","rmdConfig","renderOptions","ReactMDTestWrapper","props","children"],"rangeMappings":";;;;;;;;;;;;;;;;;;;","mappings":";AAAA,SACEA,MAAM,QAKD,yBAAyB;AAChC,SAASC,QAAQ,QAA2B,QAAQ;AACpD,SAASC,aAAa,QAAiC,sBAAsB;AAa7E;;CAEC,GACD,OAAO,SAASC,UAKdC,EAAgB,EAChBC,UAA2D,CAAC,CAAC;IAE7D,MAAM,EAAEC,SAASC,UAAUN,QAAQ,EAAEO,SAAS,EAAE,GAAGC,eAAe,GAAGJ;IAErE,OAAOL,OAAOI,IAAI;QAChB,GAAGK,aAAa;QAChBH,SAAS,SAASI,mBAAmBC,KAAK;YACxC,qBACE,KAACT;gBAAe,GAAGM,SAAS;0BAC1B,cAAA,KAACD;8BAASI,MAAMC,QAAQ;;;QAG9B;IACF;AACF"}
+{"version":3,"sources":["../../src/test-utils/render.tsx"],"sourcesContent":["import {\n  render,\n  type Queries,\n  type RenderOptions,\n  type RenderResult,\n  type queries,\n} from \"@testing-library/react\";\nimport { Fragment, type ReactElement } from \"react\";\nimport { CoreProviders, type CoreProvidersProps } from \"../CoreProviders.js\";\n\n/**\n * @since 6.0.0\n */\nexport interface ReactMDRenderOptions<\n  Q extends Queries = typeof queries,\n  Container extends Element | DocumentFragment = HTMLElement,\n  BaseElement extends Element | DocumentFragment = Container,\n> extends RenderOptions<Q, Container, BaseElement> {\n  rmdConfig?: Omit<CoreProvidersProps, \"children\">;\n}\n\n/**\n * @since 6.0.0\n */\nexport function rmdRender<\n  Q extends Queries = typeof queries,\n  Container extends Element | DocumentFragment = HTMLElement,\n  BaseElement extends Element | DocumentFragment = Container,\n>(\n  ui: ReactElement,\n  options: ReactMDRenderOptions<Q, Container, BaseElement> = {}\n): RenderResult<Q, Container, BaseElement> {\n  const { wrapper: Wrapper = Fragment, rmdConfig, ...renderOptions } = options;\n\n  return render(ui, {\n    ...renderOptions,\n    wrapper: function ReactMDTestWrapper(props) {\n      return (\n        <CoreProviders {...rmdConfig}>\n          <Wrapper>{props.children}</Wrapper>\n        </CoreProviders>\n      );\n    },\n  });\n}\n"],"names":["render","Fragment","CoreProviders","rmdRender","ui","options","wrapper","Wrapper","rmdConfig","renderOptions","ReactMDTestWrapper","props","children"],"rangeMappings":";;;;;;;;;;;;;;;;;;;","mappings":";AAAA,SACEA,MAAM,QAKD,yBAAyB;AAChC,SAASC,QAAQ,QAA2B,QAAQ;AACpD,SAASC,aAAa,QAAiC,sBAAsB;AAa7E;;CAEC,GACD,OAAO,SAASC,UAKdC,EAAgB,EAChBC,UAA2D,CAAC,CAAC;IAE7D,MAAM,EAAEC,SAASC,UAAUN,QAAQ,EAAEO,SAAS,EAAE,GAAGC,eAAe,GAAGJ;IAErE,OAAOL,OAAOI,IAAI;QAChB,GAAGK,aAAa;QAChBH,SAAS,SAASI,mBAAmBC,KAAK;YACxC,qBACE,KAACT;gBAAe,GAAGM,SAAS;0BAC1B,cAAA,KAACD;8BAASI,MAAMC,QAAQ;;;QAG9B;IACF;AACF"}

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

@@ -16,8 +16,7 @@ import { jest } from "@jest/globals";
  * });
  * ```
  *
- * @example
- * Automatic Cleanup
+ * @example Automatic Cleanup
  * ```ts
  * import { useImmediateRaf } from "@react-md/core/test-utils";
  *
@@ -34,6 +33,6 @@ import { jest } from "@jest/globals";
  * });
  * ```
  *
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */
 export declare const useImmediateRaf: () => jest.SpiedFunction<typeof requestAnimationFrame>;

package/dist/test-utils/timers.js

@@ -16,8 +16,7 @@ import { jest } from "@jest/globals";
  * });
  * ```
  *
- * @example
- * Automatic Cleanup
+ * @example Automatic Cleanup
  * ```ts
  * import { useImmediateRaf } from "@react-md/core/test-utils";
  *
@@ -34,7 +33,7 @@ import { jest } from "@jest/globals";
  * });
  * ```
  *
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */ export const useImmediateRaf = ()=>jest.spyOn(window, "requestAnimationFrame").mockImplementation((cb)=>{
         cb(0);
         return 0;

package/dist/test-utils/timers.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/test-utils/timers.ts"],"sourcesContent":["import { jest } from \"@jest/globals\";\n\n/**\n * @example\n * ```ts\n * import { useImmediateRaf } from \"@react-md/core/test-utils\";\n *\n * describe(\"some test suite\", () => {\n *   it(\"should test something with requestAnimationFrame\", () => {\n *     const raf = useImmediateRaf();\n *\n *     // do some testing with requestAnimationFrame\n *\n *     // reset to original at the end of the test\n *     raf.mockRestore()\n *   });\n * });\n * ```\n *\n * @example\n * Automatic Cleanup\n * ```ts\n * import { useImmediateRaf } from \"@react-md/core/test-utils\";\n *\n * afterEach(() => {\n *   jest.restoreAllMocks();\n * });\n *\n * describe(\"some test suite\", () => {\n *   it(\"should test something with requestAnimationFrame\", () => {\n *     const raf = useImmediateRaf();\n *\n *     // do some testing with requestAnimationFrame\n *   });\n * });\n * ```\n *\n * @remarks \\@since 6.0.0\n */\nexport const useImmediateRaf = (): jest.SpiedFunction<\n  typeof requestAnimationFrame\n> =>\n  jest.spyOn(window, \"requestAnimationFrame\").mockImplementation((cb) => {\n    cb(0);\n    return 0;\n  });\n"],"names":["jest","useImmediateRaf","spyOn","window","mockImplementation","cb"],"rangeMappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;","mappings":"AAAA,SAASA,IAAI,QAAQ,gBAAgB;AAErC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCC,GACD,OAAO,MAAMC,kBAAkB,IAG7BD,KAAKE,KAAK,CAACC,QAAQ,yBAAyBC,kBAAkB,CAAC,CAACC;QAC9DA,GAAG;QACH,OAAO;IACT,GAAG"}
+{"version":3,"sources":["../../src/test-utils/timers.ts"],"sourcesContent":["import { jest } from \"@jest/globals\";\n\n/**\n * @example\n * ```ts\n * import { useImmediateRaf } from \"@react-md/core/test-utils\";\n *\n * describe(\"some test suite\", () => {\n *   it(\"should test something with requestAnimationFrame\", () => {\n *     const raf = useImmediateRaf();\n *\n *     // do some testing with requestAnimationFrame\n *\n *     // reset to original at the end of the test\n *     raf.mockRestore()\n *   });\n * });\n * ```\n *\n * @example Automatic Cleanup\n * ```ts\n * import { useImmediateRaf } from \"@react-md/core/test-utils\";\n *\n * afterEach(() => {\n *   jest.restoreAllMocks();\n * });\n *\n * describe(\"some test suite\", () => {\n *   it(\"should test something with requestAnimationFrame\", () => {\n *     const raf = useImmediateRaf();\n *\n *     // do some testing with requestAnimationFrame\n *   });\n * });\n * ```\n *\n * @since 6.0.0\n */\nexport const useImmediateRaf = (): jest.SpiedFunction<\n  typeof requestAnimationFrame\n> =>\n  jest.spyOn(window, \"requestAnimationFrame\").mockImplementation((cb) => {\n    cb(0);\n    return 0;\n  });\n"],"names":["jest","useImmediateRaf","spyOn","window","mockImplementation","cb"],"rangeMappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;","mappings":"AAAA,SAASA,IAAI,QAAQ,gBAAgB;AAErC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCC,GACD,OAAO,MAAMC,kBAAkB,IAG7BD,KAAKE,KAAK,CAACC,QAAQ,yBAAyBC,kBAAkB,CAAC,CAACC;QAC9DA,GAAG;QACH,OAAO;IACT,GAAG"}

package/dist/theme/LocalStorageColorSchemeProvider.d.ts

@@ -1,7 +1,7 @@
 import { type ReactElement, type ReactNode } from "react";
 import { type ColorSchemeMode } from "./useColorScheme.js";
 /**
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */
 export interface LocalStorageColorSchemeProviderProps {
     /**
@@ -90,6 +90,6 @@ export interface LocalStorageColorSchemeProviderProps {
  * );
  * ```
  *
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */
 export declare function LocalStorageColorSchemeProvider(props: LocalStorageColorSchemeProviderProps): ReactElement;

package/dist/theme/LocalStorageColorSchemeProvider.js

@@ -66,7 +66,7 @@ import { useColorSchemeProvider } from "./useColorSchemeProvider.js";
  * );
  * ```
  *
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */ export function LocalStorageColorSchemeProvider(props) {
     const { localStorageKey = "", defaultColorSchemeMode = "light", disableMetaTag, children } = props;
     const { value: colorSchemeMode, setValue: setColorSchemeMode } = useLocalStorage({

package/dist/theme/LocalStorageColorSchemeProvider.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/theme/LocalStorageColorSchemeProvider.tsx"],"sourcesContent":["\"use client\";\nimport { type ReactElement, type ReactNode } from \"react\";\nimport { useLocalStorage } from \"../useLocalStorage.js\";\nimport { ColorSchemeProvider, type ColorSchemeMode } from \"./useColorScheme.js\";\nimport { useColorSchemeProvider } from \"./useColorSchemeProvider.js\";\n\n/**\n * @remarks \\@since 6.0.0\n */\nexport interface LocalStorageColorSchemeProviderProps {\n  /**\n   * Set this to `true` to prevent a `<meta name=\"color-scheme\" content=\"{COLOR_SCHEME}\">`\n   * from being added to the `document.head`.\n   *\n   * @defaultValue `false`\n   */\n  disableMetaTag?: boolean;\n\n  /**\n   * Set this to a string like `\"colorScheme\"` if you want to store the user's\n   * color scheme preference in local storage.\n   *\n   * @defaultValue `\"\"`\n   */\n  localStorageKey?: string;\n\n  /**\n   * The current color scheme mode that is being used by your app. This should\n   * match the `$color-scheme` SCSS variable.\n   *\n   * @defaultValue `\"light\"`\n   */\n  defaultColorSchemeMode?: ColorSchemeMode;\n\n  children: ReactNode;\n}\n\n/**\n * An optional implementation of the {@link ColorSchemeProvider} that supports\n * storing the value in local storage if the\n * {@link LocalStorageColorSchemeProviderProps.localStorageKey} is provided.\n *\n * @example\n * ```tsx\n * import {\n *   LocalStorageColorSchemeProvider,\n *   SegmentedButtonContainer,\n *   SegmentedButton,\n *   useColorScheme,\n * } from \"@react-md/core\";\n * import { createRoot } from \"react-dom/client\";\n *\n * function MyComponent(): ReactElement {\n *   const { colorScheme, colorSchemeMode, setColorSchemeMode } = useColorScheme();\n *   // colorScheme: \"light\" | \"dark\"\n *   // colorSchemeMode: \"light\" | \"dark\" | \"system\"\n *\n *   return (\n *     <>\n *       The current color scheme is {colorScheme}\n *       <SegmentedButtonContainer>\n *         <SegmentedButton\n *           selected={colorSchemeMode === \"light\"}\n *           onClick={() => {\n *             setColorSchemeMode(\"light\")\n *           }}\n *         >\n *           Light\n *         </SegmentedButton>\n *         <SegmentedButton\n *           selected={colorSchemeMode === \"dark\"}\n *           onClick={() => {\n *             setColorSchemeMode(\"dark\")\n *           }}\n *         >\n *           Dark\n *         </SegmentedButton>\n *         <SegmentedButton\n *           selected={colorSchemeMode === \"system\"}\n *           onClick={() => {\n *             setColorSchemeMode(\"system\")\n *           }}\n *         >\n *           System\n *         </SegmentedButton>\n *       </SegmentedButtonContainer>\n *     </>\n *   )l\n * }\n *\n * const container = document.getElementById(\"root\");\n * const root = createRoot(container);\n *\n * root.render(\n *   <LocalStorageColorSchemeProvider defaultColorSchemeMode=\"system\">\n *     <MyComponent />\n *   </LocalStorageColorSchemeProvider>\n * );\n * ```\n *\n * @remarks \\@since 6.0.0\n */\nexport function LocalStorageColorSchemeProvider(\n  props: LocalStorageColorSchemeProviderProps\n): ReactElement {\n  const {\n    localStorageKey = \"\",\n    defaultColorSchemeMode = \"light\",\n    disableMetaTag,\n    children,\n  } = props;\n\n  const { value: colorSchemeMode, setValue: setColorSchemeMode } =\n    useLocalStorage({\n      key: localStorageKey,\n      defaultValue: defaultColorSchemeMode,\n      deserializer: (item) =>\n        item === \"light\" || item === \"dark\" || item === \"system\"\n          ? item\n          : defaultColorSchemeMode,\n    });\n\n  const value = useColorSchemeProvider({\n    disableMetaTag,\n    colorSchemeMode,\n    setColorSchemeMode,\n  });\n\n  return <ColorSchemeProvider value={value}>{children}</ColorSchemeProvider>;\n}\n"],"names":["useLocalStorage","ColorSchemeProvider","useColorSchemeProvider","LocalStorageColorSchemeProvider","props","localStorageKey","defaultColorSchemeMode","disableMetaTag","children","value","colorSchemeMode","setValue","setColorSchemeMode","key","defaultValue","deserializer","item"],"rangeMappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;","mappings":"AAAA;;AAEA,SAASA,eAAe,QAAQ,wBAAwB;AACxD,SAASC,mBAAmB,QAA8B,sBAAsB;AAChF,SAASC,sBAAsB,QAAQ,8BAA8B;AAiCrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgEC,GACD,OAAO,SAASC,gCACdC,KAA2C;IAE3C,MAAM,EACJC,kBAAkB,EAAE,EACpBC,yBAAyB,OAAO,EAChCC,cAAc,EACdC,QAAQ,EACT,GAAGJ;IAEJ,MAAM,EAAEK,OAAOC,eAAe,EAAEC,UAAUC,kBAAkB,EAAE,GAC5DZ,gBAAgB;QACda,KAAKR;QACLS,cAAcR;QACdS,cAAc,CAACC,OACbA,SAAS,WAAWA,SAAS,UAAUA,SAAS,WAC5CA,OACAV;IACR;IAEF,MAAMG,QAAQP,uBAAuB;QACnCK;QACAG;QACAE;IACF;IAEA,qBAAO,KAACX;QAAoBQ,OAAOA;kBAAQD;;AAC7C"}
+{"version":3,"sources":["../../src/theme/LocalStorageColorSchemeProvider.tsx"],"sourcesContent":["\"use client\";\nimport { type ReactElement, type ReactNode } from \"react\";\nimport { useLocalStorage } from \"../useLocalStorage.js\";\nimport { ColorSchemeProvider, type ColorSchemeMode } from \"./useColorScheme.js\";\nimport { useColorSchemeProvider } from \"./useColorSchemeProvider.js\";\n\n/**\n * @since 6.0.0\n */\nexport interface LocalStorageColorSchemeProviderProps {\n  /**\n   * Set this to `true` to prevent a `<meta name=\"color-scheme\" content=\"{COLOR_SCHEME}\">`\n   * from being added to the `document.head`.\n   *\n   * @defaultValue `false`\n   */\n  disableMetaTag?: boolean;\n\n  /**\n   * Set this to a string like `\"colorScheme\"` if you want to store the user's\n   * color scheme preference in local storage.\n   *\n   * @defaultValue `\"\"`\n   */\n  localStorageKey?: string;\n\n  /**\n   * The current color scheme mode that is being used by your app. This should\n   * match the `$color-scheme` SCSS variable.\n   *\n   * @defaultValue `\"light\"`\n   */\n  defaultColorSchemeMode?: ColorSchemeMode;\n\n  children: ReactNode;\n}\n\n/**\n * An optional implementation of the {@link ColorSchemeProvider} that supports\n * storing the value in local storage if the\n * {@link LocalStorageColorSchemeProviderProps.localStorageKey} is provided.\n *\n * @example\n * ```tsx\n * import {\n *   LocalStorageColorSchemeProvider,\n *   SegmentedButtonContainer,\n *   SegmentedButton,\n *   useColorScheme,\n * } from \"@react-md/core\";\n * import { createRoot } from \"react-dom/client\";\n *\n * function MyComponent(): ReactElement {\n *   const { colorScheme, colorSchemeMode, setColorSchemeMode } = useColorScheme();\n *   // colorScheme: \"light\" | \"dark\"\n *   // colorSchemeMode: \"light\" | \"dark\" | \"system\"\n *\n *   return (\n *     <>\n *       The current color scheme is {colorScheme}\n *       <SegmentedButtonContainer>\n *         <SegmentedButton\n *           selected={colorSchemeMode === \"light\"}\n *           onClick={() => {\n *             setColorSchemeMode(\"light\")\n *           }}\n *         >\n *           Light\n *         </SegmentedButton>\n *         <SegmentedButton\n *           selected={colorSchemeMode === \"dark\"}\n *           onClick={() => {\n *             setColorSchemeMode(\"dark\")\n *           }}\n *         >\n *           Dark\n *         </SegmentedButton>\n *         <SegmentedButton\n *           selected={colorSchemeMode === \"system\"}\n *           onClick={() => {\n *             setColorSchemeMode(\"system\")\n *           }}\n *         >\n *           System\n *         </SegmentedButton>\n *       </SegmentedButtonContainer>\n *     </>\n *   )l\n * }\n *\n * const container = document.getElementById(\"root\");\n * const root = createRoot(container);\n *\n * root.render(\n *   <LocalStorageColorSchemeProvider defaultColorSchemeMode=\"system\">\n *     <MyComponent />\n *   </LocalStorageColorSchemeProvider>\n * );\n * ```\n *\n * @since 6.0.0\n */\nexport function LocalStorageColorSchemeProvider(\n  props: LocalStorageColorSchemeProviderProps\n): ReactElement {\n  const {\n    localStorageKey = \"\",\n    defaultColorSchemeMode = \"light\",\n    disableMetaTag,\n    children,\n  } = props;\n\n  const { value: colorSchemeMode, setValue: setColorSchemeMode } =\n    useLocalStorage({\n      key: localStorageKey,\n      defaultValue: defaultColorSchemeMode,\n      deserializer: (item) =>\n        item === \"light\" || item === \"dark\" || item === \"system\"\n          ? item\n          : defaultColorSchemeMode,\n    });\n\n  const value = useColorSchemeProvider({\n    disableMetaTag,\n    colorSchemeMode,\n    setColorSchemeMode,\n  });\n\n  return <ColorSchemeProvider value={value}>{children}</ColorSchemeProvider>;\n}\n"],"names":["useLocalStorage","ColorSchemeProvider","useColorSchemeProvider","LocalStorageColorSchemeProvider","props","localStorageKey","defaultColorSchemeMode","disableMetaTag","children","value","colorSchemeMode","setValue","setColorSchemeMode","key","defaultValue","deserializer","item"],"rangeMappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;","mappings":"AAAA;;AAEA,SAASA,eAAe,QAAQ,wBAAwB;AACxD,SAASC,mBAAmB,QAA8B,sBAAsB;AAChF,SAASC,sBAAsB,QAAQ,8BAA8B;AAiCrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgEC,GACD,OAAO,SAASC,gCACdC,KAA2C;IAE3C,MAAM,EACJC,kBAAkB,EAAE,EACpBC,yBAAyB,OAAO,EAChCC,cAAc,EACdC,QAAQ,EACT,GAAGJ;IAEJ,MAAM,EAAEK,OAAOC,eAAe,EAAEC,UAAUC,kBAAkB,EAAE,GAC5DZ,gBAAgB;QACda,KAAKR;QACLS,cAAcR;QACdS,cAAc,CAACC,OACbA,SAAS,WAAWA,SAAS,UAAUA,SAAS,WAC5CA,OACAV;IACR;IAEF,MAAMG,QAAQP,uBAAuB;QACnCK;QACAG;QACAE;IACF;IAEA,qBAAO,KAACX;QAAoBQ,OAAOA;kBAAQD;;AAC7C"}

package/dist/theme/ThemeProvider.d.ts

@@ -24,7 +24,7 @@ declare module "react" {
         "--rmd-outline-grey-color"?: string;
     }
 }
-/** @remarks \@since 6.0.0 */
+/** @since 6.0.0 */
 export interface ThemeColors {
     primaryColor: string;
     onPrimaryColor: string;
@@ -37,28 +37,27 @@ export interface ThemeColors {
     successColor: string;
     onSuccessColor: string;
 }
-/** @remarks \@since 6.0.0 */
+/** @since 6.0.0 */
 export interface ThemeTextColors {
     textPrimaryColor: string;
     textSecondaryColor: string;
     textHintColor: string;
     textDisabledColor: string;
 }
-/** @remarks \@since 6.0.0 */
+/** @since 6.0.0 */
 export interface ConfigurableThemeColors extends ThemeColors, ThemeTextColors {
     backgroundColor: string;
 }
-/** @remarks \@since 6.0.0 */
+/** @since 6.0.0 */
 export type ConfigurableThemeColorsName = keyof ConfigurableThemeColors;
-/** @remarks \@since 6.0.0 */
+/** @since 6.0.0 */
 export interface ThemeContext extends ConfigurableThemeColors {
     /**
-     * This will be `true` if a `theme` wsa not provided to the {@link ThemeProvider}
+     * This will be `true` if a `theme` was not provided to the {@link ThemeProvider}
      */
     derived: boolean;
     /**
-     * @example
-     * Simple Example
+     * @example Simple Example
      * ```tsx
      * import { getDerivedTheme, useHtmlClassName, useTheme } from "@react-md/core";
      * import { useEffect } from "react";
@@ -84,20 +83,19 @@ export interface ThemeContext extends ConfigurableThemeColors {
      */
     setDerivedTheme: UseStateSetter<Readonly<ConfigurableThemeColors>>;
 }
-/** @remarks \@since 6.0.0 */
+/** @since 6.0.0 */
 export declare const DEFAULT_THEME_COLORS: Readonly<ThemeColors>;
-/** @remarks \@since 6.0.0 */
+/** @since 6.0.0 */
 export declare const DEFAULT_LIGHT_THEME: Readonly<ConfigurableThemeColors>;
-/** @remarks \@since 6.0.0 */
+/** @since 6.0.0 */
 export declare const DEFAULT_DARK_THEME: Readonly<ConfigurableThemeColors>;
-/** @remarks \@since 6.0.0 */
+/** @since 6.0.0 */
 export declare const getDerivedTheme: (container?: Element) => Readonly<ConfigurableThemeColors>;
 /**
  * This hook can be used to access the current theme set by the
  * {@link ThemeProvider}.
  *
- * @example
- * Simple Example
+ * @example Simple Example
  * ```tsx
  * import { useTheme } from "@react-md/core";
  * import type { ReactElement } from "react";
@@ -109,16 +107,16 @@ export declare const getDerivedTheme: (container?: Element) => Readonly<Configur
  * }
  * ```
  *
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  * @throws "The `ThemeProvider` has not been initialized."
  */
 export declare function useTheme(): Readonly<ThemeContext>;
 /**
  * @internal
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */
 export declare function useTheme(allowUndefined: true): Readonly<ThemeContext> | undefined;
-/** @remarks \@since 6.0.0 */
+/** @since 6.0.0 */
 export interface ThemeProviderProps {
     /**
      * When this is `undefined`, the theme will be derived by computing the
@@ -191,8 +189,7 @@ export interface ThemeProviderProps {
  * );
  * ```
  *
- * @example
- * Automatically Deriving the Theme
+ * @example Automatically Deriving the Theme
  * ```tsx
  * import {
  *   CoreProviders,
@@ -217,6 +214,6 @@ export interface ThemeProviderProps {
  * );
  * ```
  *
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */
 export declare function ThemeProvider(props: ThemeProviderProps): ReactElement;