@react-md/core 1.0.0-next.0

package/dist/utils/getClientPosition.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @internal
+ * @remarks \@since 6.0.0
+ */
+export interface ClientPositionMouseEvent {
+    clientX: number;
+    clientY: number;
+}
+/**
+ * @internal
+ * @remarks \@since 6.0.0
+ */
+export interface ClientPositionTouchEvent {
+    changedTouches: {
+        [index: number]: ClientPositionMouseEvent;
+    };
+}
+export type ClientPositionEvent = ClientPositionMouseEvent | ClientPositionTouchEvent;
+/**
+ * @internal
+ * @remarks \@since 6.0.0
+ */
+export interface ClientPositionOptions {
+    event: ClientPositionEvent;
+    vertical: boolean;
+}
+/**
+ * @internal
+ * @remarks \@since 6.0.0
+ */
+export declare const getClientPosition: (options: ClientPositionOptions) => number;

package/dist/utils/getClientPosition.js

@@ -0,0 +1,17 @@
+/**
+ * @internal
+ * @remarks \@since 6.0.0
+ */ /**
+ * @internal
+ * @remarks \@since 6.0.0
+ */ export const getClientPosition = (options)=>{
+    const { event, vertical } = options;
+    const key = vertical ? "clientY" : "clientX";
+    if ("clientX" in event) {
+        return event[key];
+    }
+    // this should pretty much always be defined
+    return event.changedTouches[0]?.[key] || 0;
+};
+
+//# sourceMappingURL=getClientPosition.js.map

package/dist/utils/getClientPosition.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/getClientPosition.ts"],"sourcesContent":["/**\n * @internal\n * @remarks \\@since 6.0.0\n */\nexport interface ClientPositionMouseEvent {\n  clientX: number;\n  clientY: number;\n}\n\n/**\n * @internal\n * @remarks \\@since 6.0.0\n */\nexport interface ClientPositionTouchEvent {\n  changedTouches: {\n    [index: number]: ClientPositionMouseEvent;\n  };\n}\n\nexport type ClientPositionEvent =\n  | ClientPositionMouseEvent\n  | ClientPositionTouchEvent;\n\n/**\n * @internal\n * @remarks \\@since 6.0.0\n */\nexport interface ClientPositionOptions {\n  event: ClientPositionEvent;\n  vertical: boolean;\n}\n\n/**\n * @internal\n * @remarks \\@since 6.0.0\n */\nexport const getClientPosition = (options: ClientPositionOptions): number => {\n  const { event, vertical } = options;\n\n  const key = vertical ? \"clientY\" : \"clientX\";\n  if (\"clientX\" in event) {\n    return event[key];\n  }\n\n  // this should pretty much always be defined\n  return event.changedTouches[0]?.[key] || 0;\n};\n"],"names":["getClientPosition","options","event","vertical","key","changedTouches"],"mappings":"AAAA;;;CAGC,GA6BD;;;CAGC,GACD,OAAO,MAAMA,oBAAoB,CAACC;IAChC,MAAM,EAAEC,KAAK,EAAEC,QAAQ,EAAE,GAAGF;IAE5B,MAAMG,MAAMD,WAAW,YAAY;IACnC,IAAI,aAAaD,OAAO;QACtB,OAAOA,KAAK,CAACE,IAAI;IACnB;IAEA,4CAA4C;IAC5C,OAAOF,MAAMG,cAAc,CAAC,EAAE,EAAE,CAACD,IAAI,IAAI;AAC3C,EAAE"}

package/dist/utils/getPercentage.d.ts

@@ -0,0 +1,34 @@
+/** @remarks \@since 4.0.1 */
+export interface GetPercentageOptions {
+    /**
+     * The min value allowed.
+     */
+    min: number;
+    /**
+     * The max value allowed.
+     */
+    max: number;
+    /**
+     * The current value
+     */
+    value: number;
+    /**
+     * Boolean if the min, max, and value options should be validated to make sure
+     * they are within the correct range relative to each other.
+     *
+     * @defaultValue `false`
+     */
+    validate?: boolean;
+}
+/**
+ * Gets the current percentage based on the min, max, and current value.
+ *
+ * @returns the percentage that the `value` is between the `min` and `max`
+ * values.
+ *
+ * @remarks
+ * \@since 4.0.1 uses an object for options instead of multiple arguments.
+ * \@since 6.0.0 Updated to be included in the public API and `validate`
+ * defaults to `false` instead of `true`.
+ */
+export declare function getPercentage(options: GetPercentageOptions): number;

package/dist/utils/getPercentage.js

@@ -0,0 +1,27 @@
+/** @remarks \@since 4.0.1 */ /**
+ * Gets the current percentage based on the min, max, and current value.
+ *
+ * @returns the percentage that the `value` is between the `min` and `max`
+ * values.
+ *
+ * @remarks
+ * \@since 4.0.1 uses an object for options instead of multiple arguments.
+ * \@since 6.0.0 Updated to be included in the public API and `validate`
+ * defaults to `false` instead of `true`.
+ */ export function getPercentage(options) {
+    const { min, max, value, validate = false } = options;
+    if (validate) {
+        if (min >= max) {
+            throw new RangeError("A range must have the min value less than the max value");
+        }
+        if (value > max || value < min) {
+            throw new RangeError("A value must be between the min and max values");
+        }
+    }
+    const range = max - min;
+    const start = value - min;
+    const percentage = start / range;
+    return Math.max(0, Math.min(Math.abs(percentage), 1));
+}
+
+//# sourceMappingURL=getPercentage.js.map

package/dist/utils/getPercentage.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/getPercentage.ts"],"sourcesContent":["/** @remarks \\@since 4.0.1 */\nexport interface GetPercentageOptions {\n  /**\n   * The min value allowed.\n   */\n  min: number;\n\n  /**\n   * The max value allowed.\n   */\n  max: number;\n\n  /**\n   * The current value\n   */\n  value: number;\n\n  /**\n   * Boolean if the min, max, and value options should be validated to make sure\n   * they are within the correct range relative to each other.\n   *\n   * @defaultValue `false`\n   */\n  validate?: boolean;\n}\n\n/**\n * Gets the current percentage based on the min, max, and current value.\n *\n * @returns the percentage that the `value` is between the `min` and `max`\n * values.\n *\n * @remarks\n * \\@since 4.0.1 uses an object for options instead of multiple arguments.\n * \\@since 6.0.0 Updated to be included in the public API and `validate`\n * defaults to `false` instead of `true`.\n */\nexport function getPercentage(options: GetPercentageOptions): number {\n  const { min, max, value, validate = false } = options;\n  if (validate) {\n    if (min >= max) {\n      throw new RangeError(\n        \"A range must have the min value less than the max value\"\n      );\n    }\n\n    if (value > max || value < min) {\n      throw new RangeError(\"A value must be between the min and max values\");\n    }\n  }\n\n  const range = max - min;\n  const start = value - min;\n  const percentage = start / range;\n  return Math.max(0, Math.min(Math.abs(percentage), 1));\n}\n"],"names":["getPercentage","options","min","max","value","validate","RangeError","range","start","percentage","Math","abs"],"mappings":"AAAA,2BAA2B,GA0B3B;;;;;;;;;;CAUC,GACD,OAAO,SAASA,cAAcC,OAA6B;IACzD,MAAM,EAAEC,GAAG,EAAEC,GAAG,EAAEC,KAAK,EAAEC,WAAW,KAAK,EAAE,GAAGJ;IAC9C,IAAII,UAAU;QACZ,IAAIH,OAAOC,KAAK;YACd,MAAM,IAAIG,WACR;QAEJ;QAEA,IAAIF,QAAQD,OAAOC,QAAQF,KAAK;YAC9B,MAAM,IAAII,WAAW;QACvB;IACF;IAEA,MAAMC,QAAQJ,MAAMD;IACpB,MAAMM,QAAQJ,QAAQF;IACtB,MAAMO,aAAaD,QAAQD;IAC3B,OAAOG,KAAKP,GAAG,CAAC,GAAGO,KAAKR,GAAG,CAACQ,KAAKC,GAAG,CAACF,aAAa;AACpD"}

package/dist/utils/getRangeDefaultValue.d.ts

@@ -0,0 +1,16 @@
+import type { UseStateInitializer } from "../types.js";
+/**
+ * @internal
+ * @remarks \@since 6.0.0
+ */
+export interface RangeDefaultValueOptions {
+    min: number;
+    max: number;
+    step: number;
+    defaultValue?: UseStateInitializer<number>;
+}
+/**
+ * @internal
+ * @remarks \@since 6.0.0
+ */
+export declare function getRangeDefaultValue(options: RangeDefaultValueOptions): UseStateInitializer<number>;

package/dist/utils/getRangeDefaultValue.js

@@ -0,0 +1,23 @@
+import { getRangeSteps } from "./getRangeSteps.js";
+import { nearest } from "./nearest.js";
+/**
+ * @internal
+ * @remarks \@since 6.0.0
+ */ export function getRangeDefaultValue(options) {
+    const { min, max, step, defaultValue } = options;
+    if (typeof defaultValue !== "undefined") {
+        return defaultValue;
+    }
+    return ()=>nearest({
+            min,
+            max,
+            steps: getRangeSteps({
+                min,
+                max,
+                step
+            }),
+            value: (max - min) / 2
+        });
+}
+
+//# sourceMappingURL=getRangeDefaultValue.js.map

package/dist/utils/getRangeDefaultValue.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/getRangeDefaultValue.ts"],"sourcesContent":["import type { UseStateInitializer } from \"../types.js\";\nimport { getRangeSteps } from \"./getRangeSteps.js\";\nimport { nearest } from \"./nearest.js\";\n\n/**\n * @internal\n * @remarks \\@since 6.0.0\n */\nexport interface RangeDefaultValueOptions {\n  min: number;\n  max: number;\n  step: number;\n  defaultValue?: UseStateInitializer<number>;\n}\n\n/**\n * @internal\n * @remarks \\@since 6.0.0\n */\nexport function getRangeDefaultValue(\n  options: RangeDefaultValueOptions\n): UseStateInitializer<number> {\n  const { min, max, step, defaultValue } = options;\n  if (typeof defaultValue !== \"undefined\") {\n    return defaultValue;\n  }\n\n  return () =>\n    nearest({\n      min,\n      max,\n      steps: getRangeSteps({ min, max, step }),\n      value: (max - min) / 2,\n    });\n}\n"],"names":["getRangeSteps","nearest","getRangeDefaultValue","options","min","max","step","defaultValue","steps","value"],"mappings":"AACA,SAASA,aAAa,QAAQ,qBAAqB;AACnD,SAASC,OAAO,QAAQ,eAAe;AAavC;;;CAGC,GACD,OAAO,SAASC,qBACdC,OAAiC;IAEjC,MAAM,EAAEC,GAAG,EAAEC,GAAG,EAAEC,IAAI,EAAEC,YAAY,EAAE,GAAGJ;IACzC,IAAI,OAAOI,iBAAiB,aAAa;QACvC,OAAOA;IACT;IAEA,OAAO,IACLN,QAAQ;YACNG;YACAC;YACAG,OAAOR,cAAc;gBAAEI;gBAAKC;gBAAKC;YAAK;YACtCG,OAAO,AAACJ,CAAAA,MAAMD,GAAE,IAAK;QACvB;AACJ"}

package/dist/utils/getRangeSteps.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @internal
+ * @remarks \@since 6.0.0
+ */
+export interface RangeStepsOptions {
+    min: number;
+    max: number;
+    step: number;
+}
+/**
+ * Gets the number of steps in the allowed range of values.
+ *
+ * @internal
+ * @remarks
+ * \@since 2.5.0
+ * \@since 6.0.0 Converted to using an object instead of multiple arguments and
+ * renamed from `getSteps` to `getRangeSteps`.
+ */
+export declare const getRangeSteps: (options: RangeStepsOptions) => number;

package/dist/utils/getRangeSteps.js

@@ -0,0 +1,17 @@
+/**
+ * @internal
+ * @remarks \@since 6.0.0
+ */ /**
+ * Gets the number of steps in the allowed range of values.
+ *
+ * @internal
+ * @remarks
+ * \@since 2.5.0
+ * \@since 6.0.0 Converted to using an object instead of multiple arguments and
+ * renamed from `getSteps` to `getRangeSteps`.
+ */ export const getRangeSteps = (options)=>{
+    const { min, max, step } = options;
+    return Math.abs(max - min) / step;
+};
+
+//# sourceMappingURL=getRangeSteps.js.map

package/dist/utils/getRangeSteps.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/getRangeSteps.ts"],"sourcesContent":["/**\n * @internal\n * @remarks \\@since 6.0.0\n */\nexport interface RangeStepsOptions {\n  min: number;\n  max: number;\n  step: number;\n}\n\n/**\n * Gets the number of steps in the allowed range of values.\n *\n * @internal\n * @remarks\n * \\@since 2.5.0\n * \\@since 6.0.0 Converted to using an object instead of multiple arguments and\n * renamed from `getSteps` to `getRangeSteps`.\n */\nexport const getRangeSteps = (options: RangeStepsOptions): number => {\n  const { min, max, step } = options;\n\n  return Math.abs(max - min) / step;\n};\n"],"names":["getRangeSteps","options","min","max","step","Math","abs"],"mappings":"AAAA;;;CAGC,GAOD;;;;;;;;CAQC,GACD,OAAO,MAAMA,gBAAgB,CAACC;IAC5B,MAAM,EAAEC,GAAG,EAAEC,GAAG,EAAEC,IAAI,EAAE,GAAGH;IAE3B,OAAOI,KAAKC,GAAG,CAACH,MAAMD,OAAOE;AAC/B,EAAE"}

package/dist/utils/identity.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @internal
+ * @remarks \@since 6.0.0
+ */
+export declare const identity: <T>(thing: T) => T;

package/dist/utils/identity.js

@@ -0,0 +1,6 @@
+/**
+ * @internal
+ * @remarks \@since 6.0.0
+ */ export const identity = (thing)=>thing;
+
+//# sourceMappingURL=identity.js.map

package/dist/utils/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/identity.ts"],"sourcesContent":["/**\n * @internal\n * @remarks \\@since 6.0.0\n */\nexport const identity = <T>(thing: T): T => thing;\n"],"names":["identity","thing"],"mappings":"AAAA;;;CAGC,GACD,OAAO,MAAMA,WAAW,CAAIC,QAAgBA,MAAM"}

package/dist/utils/isElementVisible.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Note: requires the `$disable-display-none-class` variable to remain `false`.
+ *
+ * @remarks \@since 6.0.0
+ */
+export declare const DISPLAY_NONE_CLASS = "rmd-display-none";
+/**
+ * This is a small util to check if an element within react-md is visible by
+ * checking the element and all parents to see if they contain the
+ * {@link DISPLAY_NONE_CLASS}.
+ *
+ * @example
+ * Simple Example
+ * ```tsx
+ * const treeItem = screen.getByRole("treeitem", { name: "Tree Item" });
+ * const subTreeItem = screen.getByRole("treeitem", { Name: "Sub Tree Item" });
+ *
+ * expect(isElementVisible(treeItem)).toBe(true);
+ * expect(isElementVisible(subTreeItem)).toBe(false):
+ *
+ * await user.click(treeItem);
+ * expect(isElementVisible(treeItem)).toBe(true);
+ * expect(isElementVisible(subTreeItem)).toBe(true);
+ * ```
+ * @remarks \@since 6.0.0
+ */
+export declare function isElementVisible(element: HTMLElement | null): boolean;

package/dist/utils/isElementVisible.js

@@ -0,0 +1,39 @@
+/**
+ * Note: requires the `$disable-display-none-class` variable to remain `false`.
+ *
+ * @remarks \@since 6.0.0
+ */ export const DISPLAY_NONE_CLASS = "rmd-display-none";
+/**
+ * This is a small util to check if an element within react-md is visible by
+ * checking the element and all parents to see if they contain the
+ * {@link DISPLAY_NONE_CLASS}.
+ *
+ * @example
+ * Simple Example
+ * ```tsx
+ * const treeItem = screen.getByRole("treeitem", { name: "Tree Item" });
+ * const subTreeItem = screen.getByRole("treeitem", { Name: "Sub Tree Item" });
+ *
+ * expect(isElementVisible(treeItem)).toBe(true);
+ * expect(isElementVisible(subTreeItem)).toBe(false):
+ *
+ * await user.click(treeItem);
+ * expect(isElementVisible(treeItem)).toBe(true);
+ * expect(isElementVisible(subTreeItem)).toBe(true);
+ * ```
+ * @remarks \@since 6.0.0
+ */ export function isElementVisible(element) {
+    if (!element) {
+        return false;
+    }
+    let currentElement = element;
+    while(currentElement){
+        if (currentElement.classList.contains(DISPLAY_NONE_CLASS)) {
+            return false;
+        }
+        currentElement = currentElement.parentElement;
+    }
+    return true;
+}
+
+//# sourceMappingURL=isElementVisible.js.map

package/dist/utils/isElementVisible.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/isElementVisible.ts"],"sourcesContent":["/**\n * Note: requires the `$disable-display-none-class` variable to remain `false`.\n *\n * @remarks \\@since 6.0.0\n */\nexport const DISPLAY_NONE_CLASS = \"rmd-display-none\";\n\n/**\n * This is a small util to check if an element within react-md is visible by\n * checking the element and all parents to see if they contain the\n * {@link DISPLAY_NONE_CLASS}.\n *\n * @example\n * Simple Example\n * ```tsx\n * const treeItem = screen.getByRole(\"treeitem\", { name: \"Tree Item\" });\n * const subTreeItem = screen.getByRole(\"treeitem\", { Name: \"Sub Tree Item\" });\n *\n * expect(isElementVisible(treeItem)).toBe(true);\n * expect(isElementVisible(subTreeItem)).toBe(false):\n *\n * await user.click(treeItem);\n * expect(isElementVisible(treeItem)).toBe(true);\n * expect(isElementVisible(subTreeItem)).toBe(true);\n * ```\n * @remarks \\@since 6.0.0\n */\nexport function isElementVisible(element: HTMLElement | null): boolean {\n  if (!element) {\n    return false;\n  }\n\n  let currentElement: HTMLElement | null = element;\n  while (currentElement) {\n    if (currentElement.classList.contains(DISPLAY_NONE_CLASS)) {\n      return false;\n    }\n\n    currentElement = currentElement.parentElement;\n  }\n\n  return true;\n}\n"],"names":["DISPLAY_NONE_CLASS","isElementVisible","element","currentElement","classList","contains","parentElement"],"mappings":"AAAA;;;;CAIC,GACD,OAAO,MAAMA,qBAAqB,mBAAmB;AAErD;;;;;;;;;;;;;;;;;;;CAmBC,GACD,OAAO,SAASC,iBAAiBC,OAA2B;IAC1D,IAAI,CAACA,SAAS;QACZ,OAAO;IACT;IAEA,IAAIC,iBAAqCD;IACzC,MAAOC,eAAgB;QACrB,IAAIA,eAAeC,SAAS,CAACC,QAAQ,CAACL,qBAAqB;YACzD,OAAO;QACT;QAEAG,iBAAiBA,eAAeG,aAAa;IAC/C;IAEA,OAAO;AACT"}

package/dist/utils/loop.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @remarks \@since 2.7.0
+ * @internal
+ */
+export interface LoopOptions {
+    /**
+     * The current value that should be modified.
+     */
+    value: number;
+    /**
+     * An optional `min` value that can be used before looping to the `max` value.
+     *
+     * @defaultValue `0`
+     */
+    min?: number;
+    /**
+     * The max number that can be used before looping to the `min` value.
+     */
+    max: number;
+    /**
+     * Boolean if the `value` should be incremented or decremented by `1`.
+     */
+    increment: boolean;
+    /**
+     * Boolean if the looping should be ignored and only the `min`/`max` options
+     * should be respected. In other words, the looping  behavior will be disabled
+     * and the `value` must be: `min >= value <= max`
+     */
+    minmax?: boolean;
+}
+/**
+ * A small util that is used to increment or decrement a number until it reaches
+ * the max value or -1. When that happens, it will loop around to 0 or the max
+ * value respectively. This does not work for different increment numbers or any
+ * values below 0 for now.
+ *
+ * @internal
+ * @param options - {@link LoopOptions}
+ * @remarks \@since 2.7.0 The `min` option was added and the arguments changed to an
+ * object
+ */
+export declare function loop(options: LoopOptions): number;

package/dist/utils/loop.js

@@ -0,0 +1,27 @@
+/**
+ * @remarks \@since 2.7.0
+ * @internal
+ */ /**
+ * A small util that is used to increment or decrement a number until it reaches
+ * the max value or -1. When that happens, it will loop around to 0 or the max
+ * value respectively. This does not work for different increment numbers or any
+ * values below 0 for now.
+ *
+ * @internal
+ * @param options - {@link LoopOptions}
+ * @remarks \@since 2.7.0 The `min` option was added and the arguments changed to an
+ * object
+ */ export function loop(options) {
+    const { value, min = 0, max, increment, minmax = false } = options;
+    let next = value + (increment ? 1 : -1);
+    if (minmax) {
+        next = Math.min(max, Math.max(min, next));
+    } else if (next > max) {
+        next = min;
+    } else if (next < min) {
+        next = max;
+    }
+    return next;
+}
+
+//# sourceMappingURL=loop.js.map

package/dist/utils/loop.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/loop.ts"],"sourcesContent":["/**\n * @remarks \\@since 2.7.0\n * @internal\n */\nexport interface LoopOptions {\n  /**\n   * The current value that should be modified.\n   */\n  value: number;\n\n  /**\n   * An optional `min` value that can be used before looping to the `max` value.\n   *\n   * @defaultValue `0`\n   */\n  min?: number;\n\n  /**\n   * The max number that can be used before looping to the `min` value.\n   */\n  max: number;\n\n  /**\n   * Boolean if the `value` should be incremented or decremented by `1`.\n   */\n  increment: boolean;\n\n  /**\n   * Boolean if the looping should be ignored and only the `min`/`max` options\n   * should be respected. In other words, the looping  behavior will be disabled\n   * and the `value` must be: `min >= value <= max`\n   */\n  minmax?: boolean;\n}\n\n/**\n * A small util that is used to increment or decrement a number until it reaches\n * the max value or -1. When that happens, it will loop around to 0 or the max\n * value respectively. This does not work for different increment numbers or any\n * values below 0 for now.\n *\n * @internal\n * @param options - {@link LoopOptions}\n * @remarks \\@since 2.7.0 The `min` option was added and the arguments changed to an\n * object\n */\nexport function loop(options: LoopOptions): number {\n  const { value, min = 0, max, increment, minmax = false } = options;\n  let next = value + (increment ? 1 : -1);\n  if (minmax) {\n    next = Math.min(max, Math.max(min, next));\n  } else if (next > max) {\n    next = min;\n  } else if (next < min) {\n    next = max;\n  }\n\n  return next;\n}\n"],"names":["loop","options","value","min","max","increment","minmax","next","Math"],"mappings":"AAAA;;;CAGC,GAgCD;;;;;;;;;;CAUC,GACD,OAAO,SAASA,KAAKC,OAAoB;IACvC,MAAM,EAAEC,KAAK,EAAEC,MAAM,CAAC,EAAEC,GAAG,EAAEC,SAAS,EAAEC,SAAS,KAAK,EAAE,GAAGL;IAC3D,IAAIM,OAAOL,QAASG,CAAAA,YAAY,IAAI,CAAC,CAAA;IACrC,IAAIC,QAAQ;QACVC,OAAOC,KAAKL,GAAG,CAACC,KAAKI,KAAKJ,GAAG,CAACD,KAAKI;IACrC,OAAO,IAAIA,OAAOH,KAAK;QACrBG,OAAOJ;IACT,OAAO,IAAII,OAAOJ,KAAK;QACrBI,OAAOH;IACT;IAEA,OAAOG;AACT"}

package/dist/utils/nearest.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @internal
+ * @remarks \@since 6.0.0
+ */
+export interface NearestOptions {
+    min: number;
+    max: number;
+    steps: number;
+    value: number;
+    /** @defaultValue `max - min` */
+    range?: number;
+}
+/**
+ * Rounds a number to the nearest step within a min/max range.
+ *
+ * @see https://stackoverflow.com/a/13635455
+ * @returns the value rounded to the nearest step in the min/max range
+ * @remarks
+ * \@since 2.5.0 Added the `range` param
+ * \@since 6.0.0 Converted to using an object instead of multiple arguments.
+ */
+export declare function nearest(options: NearestOptions): number;

package/dist/utils/nearest.js

@@ -0,0 +1,27 @@
+/**
+ * @internal
+ * @remarks \@since 6.0.0
+ */ /**
+ * Rounds a number to the nearest step within a min/max range.
+ *
+ * @see https://stackoverflow.com/a/13635455
+ * @returns the value rounded to the nearest step in the min/max range
+ * @remarks
+ * \@since 2.5.0 Added the `range` param
+ * \@since 6.0.0 Converted to using an object instead of multiple arguments.
+ */ export function nearest(options) {
+    const { min, max, steps, value, range = max - min } = options;
+    if (min === max) {
+        return max;
+    }
+    const rounded = Math.round((value - min) * steps / range) / steps;
+    const zeroToOne = Math.min(Math.max(rounded, 0), 1);
+    // have to calculate the number of allowed decimal places since decimal
+    // precision gets weird:
+    // 0.28 * 100 === 28.000000000000004
+    const step = range / steps;
+    const decimals = Number.isInteger(step) ? range % steps : step.toString().split(".")[1].length;
+    return Math.min(max, Math.max(min, parseFloat((zeroToOne * range + min).toFixed(decimals))));
+}
+
+//# sourceMappingURL=nearest.js.map

package/dist/utils/nearest.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/nearest.ts"],"sourcesContent":["/**\n * @internal\n * @remarks \\@since 6.0.0\n */\nexport interface NearestOptions {\n  min: number;\n  max: number;\n  steps: number;\n  value: number;\n\n  /** @defaultValue `max - min` */\n  range?: number;\n}\n\n/**\n * Rounds a number to the nearest step within a min/max range.\n *\n * @see https://stackoverflow.com/a/13635455\n * @returns the value rounded to the nearest step in the min/max range\n * @remarks\n * \\@since 2.5.0 Added the `range` param\n * \\@since 6.0.0 Converted to using an object instead of multiple arguments.\n */\nexport function nearest(options: NearestOptions): number {\n  const { min, max, steps, value, range = max - min } = options;\n  if (min === max) {\n    return max;\n  }\n\n  const rounded = Math.round(((value - min) * steps) / range) / steps;\n  const zeroToOne = Math.min(Math.max(rounded, 0), 1);\n\n  // have to calculate the number of allowed decimal places since decimal\n  // precision gets weird:\n  // 0.28 * 100 === 28.000000000000004\n  const step = range / steps;\n  const decimals = Number.isInteger(step)\n    ? range % steps\n    : step.toString().split(\".\")[1].length;\n\n  return Math.min(\n    max,\n    Math.max(min, parseFloat((zeroToOne * range + min).toFixed(decimals)))\n  );\n}\n"],"names":["nearest","options","min","max","steps","value","range","rounded","Math","round","zeroToOne","step","decimals","Number","isInteger","toString","split","length","parseFloat","toFixed"],"mappings":"AAAA;;;CAGC,GAWD;;;;;;;;CAQC,GACD,OAAO,SAASA,QAAQC,OAAuB;IAC7C,MAAM,EAAEC,GAAG,EAAEC,GAAG,EAAEC,KAAK,EAAEC,KAAK,EAAEC,QAAQH,MAAMD,GAAG,EAAE,GAAGD;IACtD,IAAIC,QAAQC,KAAK;QACf,OAAOA;IACT;IAEA,MAAMI,UAAUC,KAAKC,KAAK,CAAC,AAAEJ,CAAAA,QAAQH,GAAE,IAAKE,QAASE,SAASF;IAC9D,MAAMM,YAAYF,KAAKN,GAAG,CAACM,KAAKL,GAAG,CAACI,SAAS,IAAI;IAEjD,uEAAuE;IACvE,wBAAwB;IACxB,oCAAoC;IACpC,MAAMI,OAAOL,QAAQF;IACrB,MAAMQ,WAAWC,OAAOC,SAAS,CAACH,QAC9BL,QAAQF,QACRO,KAAKI,QAAQ,GAAGC,KAAK,CAAC,IAAI,CAAC,EAAE,CAACC,MAAM;IAExC,OAAOT,KAAKN,GAAG,CACbC,KACAK,KAAKL,GAAG,CAACD,KAAKgB,WAAW,AAACR,CAAAA,YAAYJ,QAAQJ,GAAE,EAAGiB,OAAO,CAACP;AAE/D"}

package/dist/utils/parseCssLengthUnit.d.ts

@@ -0,0 +1,38 @@
+/** @internal */
+export interface ParseCssLengthUnitOptions {
+    /**
+     *
+     */
+    value: number | string;
+    /**
+     * @defaultValue `16`
+     */
+    fallbackFontSize?: number;
+    /**
+     * @defaultValue `document.documentElement`
+     */
+    container?: Element | null;
+}
+/**
+ * This is used to convert CSS length units into a number. At this time, it really only supports
+ * - `px`
+ * - `rem`
+ * - `em` (if {@link ParseCssLengthUnitOptions.container} is provided)
+ *
+ * @example
+ * Simple Example
+ * ```ts
+ * parseCssLengthUnit({ value: "24px" }) // 24
+ * parseCssLengthUnit({ value: "3.5rem" }) // 56
+ * parseCssLengthUnit({
+ *   value: "3em",
+ *   container: document.querySelector(SOME_QUERY),
+ * }); // container's computed fontSize * 3
+ * ```
+ *
+ * @see {@link https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_blocks/Values_and_units#lengths}
+ * @internal
+ * @remarks
+ * \@since 6.0.0 This was renamed from `unitToNumber`
+ */
+export declare function parseCssLengthUnit(options: ParseCssLengthUnitOptions): number;

package/dist/utils/parseCssLengthUnit.js

@@ -0,0 +1,39 @@
+/** @internal */ /**
+ * This is used to convert CSS length units into a number. At this time, it really only supports
+ * - `px`
+ * - `rem`
+ * - `em` (if {@link ParseCssLengthUnitOptions.container} is provided)
+ *
+ * @example
+ * Simple Example
+ * ```ts
+ * parseCssLengthUnit({ value: "24px" }) // 24
+ * parseCssLengthUnit({ value: "3.5rem" }) // 56
+ * parseCssLengthUnit({
+ *   value: "3em",
+ *   container: document.querySelector(SOME_QUERY),
+ * }); // container's computed fontSize * 3
+ * ```
+ *
+ * @see {@link https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_blocks/Values_and_units#lengths}
+ * @internal
+ * @remarks
+ * \@since 6.0.0 This was renamed from `unitToNumber`
+ */ export function parseCssLengthUnit(options) {
+    const { value, container, fallbackFontSize = 16 } = options;
+    if (typeof value === "number") {
+        return value;
+    }
+    const parsed = parseFloat(value);
+    if (/px$/i.test(value)) {
+        return parsed;
+    }
+    if (typeof window === "undefined") {
+        return parsed * fallbackFontSize;
+    }
+    const styleContainer = !container || /rem$/i.test(value) ? document.documentElement : container;
+    const fontSize = parseFloat(window.getComputedStyle(styleContainer).fontSize || `${fallbackFontSize}px`);
+    return parsed * fontSize;
+}
+
+//# sourceMappingURL=parseCssLengthUnit.js.map

package/dist/utils/parseCssLengthUnit.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/parseCssLengthUnit.ts"],"sourcesContent":["/** @internal */\nexport interface ParseCssLengthUnitOptions {\n  /**\n   *\n   */\n  value: number | string;\n\n  /**\n   * @defaultValue `16`\n   */\n  fallbackFontSize?: number;\n\n  /**\n   * @defaultValue `document.documentElement`\n   */\n  container?: Element | null;\n}\n\n/**\n * This is used to convert CSS length units into a number. At this time, it really only supports\n * - `px`\n * - `rem`\n * - `em` (if {@link ParseCssLengthUnitOptions.container} is provided)\n *\n * @example\n * Simple Example\n * ```ts\n * parseCssLengthUnit({ value: \"24px\" }) // 24\n * parseCssLengthUnit({ value: \"3.5rem\" }) // 56\n * parseCssLengthUnit({\n *   value: \"3em\",\n *   container: document.querySelector(SOME_QUERY),\n * }); // container's computed fontSize * 3\n * ```\n *\n * @see {@link https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_blocks/Values_and_units#lengths}\n * @internal\n * @remarks\n * \\@since 6.0.0 This was renamed from `unitToNumber`\n */\nexport function parseCssLengthUnit(options: ParseCssLengthUnitOptions): number {\n  const { value, container, fallbackFontSize = 16 } = options;\n\n  if (typeof value === \"number\") {\n    return value;\n  }\n\n  const parsed = parseFloat(value);\n  if (/px$/i.test(value)) {\n    return parsed;\n  }\n\n  if (typeof window === \"undefined\") {\n    return parsed * fallbackFontSize;\n  }\n\n  const styleContainer =\n    !container || /rem$/i.test(value) ? document.documentElement : container;\n\n  const fontSize = parseFloat(\n    window.getComputedStyle(styleContainer).fontSize || `${fallbackFontSize}px`\n  );\n\n  return parsed * fontSize;\n}\n"],"names":["parseCssLengthUnit","options","value","container","fallbackFontSize","parsed","parseFloat","test","window","styleContainer","document","documentElement","fontSize","getComputedStyle"],"mappings":"AAAA,cAAc,GAkBd;;;;;;;;;;;;;;;;;;;;;CAqBC,GACD,OAAO,SAASA,mBAAmBC,OAAkC;IACnE,MAAM,EAAEC,KAAK,EAAEC,SAAS,EAAEC,mBAAmB,EAAE,EAAE,GAAGH;IAEpD,IAAI,OAAOC,UAAU,UAAU;QAC7B,OAAOA;IACT;IAEA,MAAMG,SAASC,WAAWJ;IAC1B,IAAI,OAAOK,IAAI,CAACL,QAAQ;QACtB,OAAOG;IACT;IAEA,IAAI,OAAOG,WAAW,aAAa;QACjC,OAAOH,SAASD;IAClB;IAEA,MAAMK,iBACJ,CAACN,aAAa,QAAQI,IAAI,CAACL,SAASQ,SAASC,eAAe,GAAGR;IAEjE,MAAMS,WAAWN,WACfE,OAAOK,gBAAgB,CAACJ,gBAAgBG,QAAQ,IAAI,CAAC,EAAER,iBAAiB,EAAE,CAAC;IAG7E,OAAOC,SAASO;AAClB"}

package/dist/utils/randomInt.d.ts

@@ -0,0 +1,16 @@
+/** @remarks \@since 6.0.0 */
+export interface RandomIntOptions {
+    /** @defaultValue `0` */
+    min?: number;
+    /** @defaultValue `10` */
+    max?: number;
+}
+/**
+ * Generates a random integer between a min and max value. Defaults
+ * to 0-10.
+ *
+ * @param options - the {@link RandomIntOptions}
+ * @returns a random number
+ * @remarks \@since 6.0.0
+ */
+export declare function randomInt(options?: RandomIntOptions): number;

package/dist/utils/randomInt.js

@@ -0,0 +1,13 @@
+/** @remarks \@since 6.0.0 */ /**
+ * Generates a random integer between a min and max value. Defaults
+ * to 0-10.
+ *
+ * @param options - the {@link RandomIntOptions}
+ * @returns a random number
+ * @remarks \@since 6.0.0
+ */ export function randomInt(options = {}) {
+    const { min = 0, max = 10 } = options;
+    return Math.floor(Math.random() * (max - min)) + min;
+}
+
+//# sourceMappingURL=randomInt.js.map

package/dist/utils/randomInt.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/randomInt.ts"],"sourcesContent":["/** @remarks \\@since 6.0.0 */\nexport interface RandomIntOptions {\n  /** @defaultValue `0` */\n  min?: number;\n  /** @defaultValue `10` */\n  max?: number;\n}\n\n/**\n * Generates a random integer between a min and max value. Defaults\n * to 0-10.\n *\n * @param options - the {@link RandomIntOptions}\n * @returns a random number\n * @remarks \\@since 6.0.0\n */\nexport function randomInt(options: RandomIntOptions = {}): number {\n  const { min = 0, max = 10 } = options;\n\n  return Math.floor(Math.random() * (max - min)) + min;\n}\n"],"names":["randomInt","options","min","max","Math","floor","random"],"mappings":"AAAA,2BAA2B,GAQ3B;;;;;;;CAOC,GACD,OAAO,SAASA,UAAUC,UAA4B,CAAC,CAAC;IACtD,MAAM,EAAEC,MAAM,CAAC,EAAEC,MAAM,EAAE,EAAE,GAAGF;IAE9B,OAAOG,KAAKC,KAAK,CAACD,KAAKE,MAAM,KAAMH,CAAAA,MAAMD,GAAE,KAAMA;AACnD"}

package/dist/utils/wait.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @example
+ * Wait some duration
+ * ```ts
+ * import { wait } from "@react-md/core";
+ *
+ * console.log('start');
+ * await wait(5000);
+ * console.log('it has been five seconds');
+ * ```
+ *
+ * This util was just added to support random waits for mocking data and random
+ * throttling.
+ *
+ * @remarks \@since 6.0.0
+ */
+export declare const wait: (ms: number) => Promise<void>;

package/dist/utils/wait.js

@@ -0,0 +1,18 @@
+/**
+ * @example
+ * Wait some duration
+ * ```ts
+ * import { wait } from "@react-md/core";
+ *
+ * console.log('start');
+ * await wait(5000);
+ * console.log('it has been five seconds');
+ * ```
+ *
+ * This util was just added to support random waits for mocking data and random
+ * throttling.
+ *
+ * @remarks \@since 6.0.0
+ */ export const wait = (ms)=>new Promise((resolve)=>setTimeout(()=>resolve(), ms));
+
+//# sourceMappingURL=wait.js.map

package/dist/utils/wait.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/wait.ts"],"sourcesContent":["/**\n * @example\n * Wait some duration\n * ```ts\n * import { wait } from \"@react-md/core\";\n *\n * console.log('start');\n * await wait(5000);\n * console.log('it has been five seconds');\n * ```\n *\n * This util was just added to support random waits for mocking data and random\n * throttling.\n *\n * @remarks \\@since 6.0.0\n */\nexport const wait = (ms: number): Promise<void> =>\n  new Promise((resolve) => setTimeout(() => resolve(), ms));\n"],"names":["wait","ms","Promise","resolve","setTimeout"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD,OAAO,MAAMA,OAAO,CAACC,KACnB,IAAIC,QAAQ,CAACC,UAAYC,WAAW,IAAMD,WAAWF,KAAK"}

package/dist/utils/withinRange.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @internal
+ * @remarks \@since 6.0.0
+ */
+export interface WithinRangeOptions {
+    min: number | undefined;
+    max: number | undefined;
+    value: number;
+}
+/**
+ * A simple util that will ensure that a number is within the optional min and
+ * max values.
+ *
+ * @returns the updated value
+ * @remarks
+ * \@since 2.5.0
+ * \@since 6.0.0 Converted to using an object instead of multiple arguments.
+ */
+export declare function withinRange(options: WithinRangeOptions): number;