@react-md/core 6.0.2 → 6.2.0

package/dist/progress/LinearProgress.d.ts

@@ -1,5 +1,5 @@
 import { type CSSProperties, type HTMLAttributes } from "react";
-import { type LabelRequiredForA11y } from "../types.js";
+import { type LabelRequiredForA11y, type PropsWithRef } from "../types.js";
 import { type ProgressProps } from "./types.js";
 /**
  * @since 6.0.0 Added the `theme` prop
@@ -15,6 +15,10 @@ export interface LinearProgressProps extends Omit<HTMLAttributes<HTMLSpanElement
      * An optional className to apply to the progress bar.
      */
     barClassName?: string;
+    /**
+     * @since 6.1.0
+     */
+    barProps?: PropsWithRef<HTMLAttributes<HTMLSpanElement>>;
     /**
      * Boolean if the progress should be reversed. This will change the progress
      * direction from `left-to-right` to be `right-to-left`. If the current

package/dist/progress/LinearProgress.js

@@ -1,11 +1,8 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { cnb } from "cnbuilder";
 import { forwardRef, useMemo } from "react";
-import { cssUtils } from "../cssUtils.js";
 import { useEnsuredId } from "../useEnsuredId.js";
-import { bem } from "../utils/bem.js";
 import { getPercentage } from "../utils/getPercentage.js";
-const styles = bem("rmd-linear-progress");
+import { linearProgress, linearProgressBar } from "./linearProgressStyles.js";
 /**
  * @example Indeterminate Example
  * ```tsx
@@ -34,7 +31,7 @@ const styles = bem("rmd-linear-progress");
  * @since 6.0.0 Supports rendering as any of the theme colors and
  * requires a label for accessibility.
  */ export const LinearProgress = /*#__PURE__*/ forwardRef(function LinearProgress(props, ref) {
-    const { id: propId, style: propStyle, className, barStyle: propBarStyle, barClassName, min = 0, max = 100, value, reverse = false, theme = "primary", disableTransition = false, vertical = false, verticalHeight = 240, ...remaining } = props;
+    const { id: propId, style: propStyle, className, barStyle: propBarStyle, barClassName, barProps, min = 0, max = 100, value, reverse, theme, disableTransition, vertical, verticalHeight = 240, ...remaining } = props;
     const id = useEnsuredId(propId, "linear-progress");
     const style = useMemo(()=>{
         if (!vertical || verticalHeight === null) {
@@ -72,8 +69,7 @@ const styles = bem("rmd-linear-progress");
         propBarStyle,
         vertical
     ]);
-    const determinate = typeof progress === "number";
-    const indeterminate = !determinate;
+    const indeterminate = typeof progress !== "number";
     return /*#__PURE__*/ _jsx("span", {
         ...remaining,
         id: id,
@@ -83,30 +79,22 @@ const styles = bem("rmd-linear-progress");
         "aria-valuemin": min,
         "aria-valuemax": max,
         "aria-valuenow": value,
-        className: cnb(styles({
+        className: linearProgress({
+            className,
+            theme,
             vertical,
-            horizontal: !vertical,
-            determinate,
             indeterminate
-        }), theme !== "current-color" && cssUtils({
-            textColor: theme
-        }), className),
+        }),
         children: /*#__PURE__*/ _jsx("span", {
+            ...barProps,
             style: barStyle,
-            className: cnb(styles("bar", {
+            className: linearProgressBar({
+                className: barClassName,
+                reverse,
                 vertical,
-                "vertical-reverse": vertical && reverse,
-                horizontal: !vertical,
-                "horizontal-reverse": !vertical && reverse,
-                animate: !disableTransition && determinate,
-                determinate,
                 indeterminate,
-                "determinate-reverse": determinate && reverse && !vertical,
-                "determinate-vertical-reverse": determinate && reverse && vertical,
-                "indeterminate-reverse": indeterminate && reverse && !vertical,
-                "indeterminate-vertical": indeterminate && vertical,
-                "indeterminate-vertical-reverse": indeterminate && reverse && vertical
-            }), barClassName)
+                disableTransition
+            })
         })
     });
 });

package/dist/progress/LinearProgress.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/progress/LinearProgress.tsx"],"sourcesContent":["import { cnb } from \"cnbuilder\";\nimport {\n  type CSSProperties,\n  type HTMLAttributes,\n  forwardRef,\n  useMemo,\n} from \"react\";\n\nimport { cssUtils } from \"../cssUtils.js\";\nimport { type LabelRequiredForA11y } from \"../types.js\";\nimport { useEnsuredId } from \"../useEnsuredId.js\";\nimport { bem } from \"../utils/bem.js\";\nimport { getPercentage } from \"../utils/getPercentage.js\";\nimport { type ProgressProps } from \"./types.js\";\n\n/**\n * @since 6.0.0 Added the `theme` prop\n */\nexport interface LinearProgressProps\n  extends Omit<HTMLAttributes<HTMLSpanElement>, \"id\" | \"children\">,\n    ProgressProps {\n  /**\n   * An optional style to apply to the progress bar. This will be merged with\n   * the current width or height tracking the progress when a `value` is also\n   * provided.\n   */\n  barStyle?: CSSProperties;\n\n  /**\n   * An optional className to apply to the progress bar.\n   */\n  barClassName?: string;\n\n  /**\n   * Boolean if the progress should be reversed. This will change the progress\n   * direction from `left-to-right` to be `right-to-left`. If the current\n   * language is a rtl language and this prop is enabled, the direction will\n   * still be `left-to-right`.\n   *\n   * @defaultValue `false`\n   */\n  reverse?: boolean;\n\n  /**\n   * Boolean if the progress should be vertical instead of horizontal.  When\n   * this prop is set, you should also set the `verticalHeight` prop to a height\n   * value you want for your progress bar.\n   *\n   * @defaultValue `false`\n   */\n  vertical?: boolean;\n\n  /**\n   * Since there isn't really a good way to have \"auto height\", you'll need to\n   * manually set the progress bar's height with this prop to some pixel value.\n   * If you'd prefer to set the height in Sass/css, set this value to `null`\n   * instead since this value would be passed down as a `height` inline style.\n   *\n   * @defaultValue `240`\n   */\n  verticalHeight?: number | null;\n}\n\nconst styles = bem(\"rmd-linear-progress\");\n\n/**\n * @example Indeterminate Example\n * ```tsx\n * import { LinearProgress } from \"@react-md/core/progress/LinearProgress\";\n * import { type ReactElement } from \"react\";\n *\n * function Example(): ReactElement {\n *   return <LinearProgress aria-label=\"Loading\" />;\n * }\n * ```\n *\n * @example Determinate Example\n * ```tsx\n * import { LinearProgress } from \"@react-md/core/progress/LinearProgress\";\n * import { useState, type ReactElement } from \"react\";\n *\n * function Example(): ReactElement {\n *   // a number from 0 - 100\n *   const [progress, setProgress] = useState(0);\n *\n *   return <LinearProgress aria-label=\"File upload\" value={progress} />;\n * }\n * ```\n *\n * @see {@link https://react-md.dev/components/progress#linear-progress | Progress Demos}\n * @since 6.0.0 Supports rendering as any of the theme colors and\n * requires a label for accessibility.\n */\nexport const LinearProgress = forwardRef<\n  HTMLSpanElement,\n  LabelRequiredForA11y<LinearProgressProps>\n>(function LinearProgress(props, ref) {\n  const {\n    id: propId,\n    style: propStyle,\n    className,\n    barStyle: propBarStyle,\n    barClassName,\n    min = 0,\n    max = 100,\n    value,\n    reverse = false,\n    theme = \"primary\",\n    disableTransition = false,\n    vertical = false,\n    verticalHeight = 240,\n    ...remaining\n  } = props;\n\n  const id = useEnsuredId(propId, \"linear-progress\");\n  const style = useMemo(() => {\n    if (!vertical || verticalHeight === null) {\n      return propStyle;\n    }\n\n    return {\n      ...propStyle,\n      height: verticalHeight,\n    };\n  }, [propStyle, vertical, verticalHeight]);\n\n  let progress: number | undefined;\n  if (typeof value === \"number\") {\n    progress = getPercentage({ min, max, value, validate: true });\n  }\n  const barStyle = useMemo(() => {\n    if (typeof progress !== \"number\") {\n      return propBarStyle;\n    }\n\n    const key = vertical ? \"height\" : \"width\";\n    return {\n      ...propBarStyle,\n      [key]: `${progress * 100}%`,\n    };\n  }, [progress, propBarStyle, vertical]);\n\n  const determinate = typeof progress === \"number\";\n  const indeterminate = !determinate;\n  return (\n    <span\n      {...remaining}\n      id={id}\n      ref={ref}\n      style={style}\n      role=\"progressbar\"\n      aria-valuemin={min}\n      aria-valuemax={max}\n      aria-valuenow={value}\n      className={cnb(\n        styles({\n          vertical,\n          horizontal: !vertical,\n          determinate,\n          indeterminate,\n        }),\n        theme !== \"current-color\" && cssUtils({ textColor: theme }),\n        className\n      )}\n    >\n      <span\n        style={barStyle}\n        className={cnb(\n          styles(\"bar\", {\n            vertical,\n            \"vertical-reverse\": vertical && reverse,\n            horizontal: !vertical,\n            \"horizontal-reverse\": !vertical && reverse,\n            animate: !disableTransition && determinate,\n            determinate,\n            indeterminate,\n            \"determinate-reverse\": determinate && reverse && !vertical,\n            \"determinate-vertical-reverse\": determinate && reverse && vertical,\n            \"indeterminate-reverse\": indeterminate && reverse && !vertical,\n            \"indeterminate-vertical\": indeterminate && vertical,\n            \"indeterminate-vertical-reverse\":\n              indeterminate && reverse && vertical,\n          }),\n          barClassName\n        )}\n      />\n    </span>\n  );\n});\n"],"names":["cnb","forwardRef","useMemo","cssUtils","useEnsuredId","bem","getPercentage","styles","LinearProgress","props","ref","id","propId","style","propStyle","className","barStyle","propBarStyle","barClassName","min","max","value","reverse","theme","disableTransition","vertical","verticalHeight","remaining","height","progress","validate","key","determinate","indeterminate","span","role","aria-valuemin","aria-valuemax","aria-valuenow","horizontal","textColor","animate"],"mappings":";AAAA,SAASA,GAAG,QAAQ,YAAY;AAChC,SAGEC,UAAU,EACVC,OAAO,QACF,QAAQ;AAEf,SAASC,QAAQ,QAAQ,iBAAiB;AAE1C,SAASC,YAAY,QAAQ,qBAAqB;AAClD,SAASC,GAAG,QAAQ,kBAAkB;AACtC,SAASC,aAAa,QAAQ,4BAA4B;AAmD1D,MAAMC,SAASF,IAAI;AAEnB;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BC,GACD,OAAO,MAAMG,+BAAiBP,WAG5B,SAASO,eAAeC,KAAK,EAAEC,GAAG;IAClC,MAAM,EACJC,IAAIC,MAAM,EACVC,OAAOC,SAAS,EAChBC,SAAS,EACTC,UAAUC,YAAY,EACtBC,YAAY,EACZC,MAAM,CAAC,EACPC,MAAM,GAAG,EACTC,KAAK,EACLC,UAAU,KAAK,EACfC,QAAQ,SAAS,EACjBC,oBAAoB,KAAK,EACzBC,WAAW,KAAK,EAChBC,iBAAiB,GAAG,EACpB,GAAGC,WACJ,GAAGlB;IAEJ,MAAME,KAAKP,aAAaQ,QAAQ;IAChC,MAAMC,QAAQX,QAAQ;QACpB,IAAI,CAACuB,YAAYC,mBAAmB,MAAM;YACxC,OAAOZ;QACT;QAEA,OAAO;YACL,GAAGA,SAAS;YACZc,QAAQF;QACV;IACF,GAAG;QAACZ;QAAWW;QAAUC;KAAe;IAExC,IAAIG;IACJ,IAAI,OAAOR,UAAU,UAAU;QAC7BQ,WAAWvB,cAAc;YAAEa;YAAKC;YAAKC;YAAOS,UAAU;QAAK;IAC7D;IACA,MAAMd,WAAWd,QAAQ;QACvB,IAAI,OAAO2B,aAAa,UAAU;YAChC,OAAOZ;QACT;QAEA,MAAMc,MAAMN,WAAW,WAAW;QAClC,OAAO;YACL,GAAGR,YAAY;YACf,CAACc,IAAI,EAAE,GAAGF,WAAW,IAAI,CAAC,CAAC;QAC7B;IACF,GAAG;QAACA;QAAUZ;QAAcQ;KAAS;IAErC,MAAMO,cAAc,OAAOH,aAAa;IACxC,MAAMI,gBAAgB,CAACD;IACvB,qBACE,KAACE;QACE,GAAGP,SAAS;QACbhB,IAAIA;QACJD,KAAKA;QACLG,OAAOA;QACPsB,MAAK;QACLC,iBAAejB;QACfkB,iBAAejB;QACfkB,iBAAejB;QACfN,WAAWf,IACTO,OAAO;YACLkB;YACAc,YAAY,CAACd;YACbO;YACAC;QACF,IACAV,UAAU,mBAAmBpB,SAAS;YAAEqC,WAAWjB;QAAM,IACzDR;kBAGF,cAAA,KAACmB;YACCrB,OAAOG;YACPD,WAAWf,IACTO,OAAO,OAAO;gBACZkB;gBACA,oBAAoBA,YAAYH;gBAChCiB,YAAY,CAACd;gBACb,sBAAsB,CAACA,YAAYH;gBACnCmB,SAAS,CAACjB,qBAAqBQ;gBAC/BA;gBACAC;gBACA,uBAAuBD,eAAeV,WAAW,CAACG;gBAClD,gCAAgCO,eAAeV,WAAWG;gBAC1D,yBAAyBQ,iBAAiBX,WAAW,CAACG;gBACtD,0BAA0BQ,iBAAiBR;gBAC3C,kCACEQ,iBAAiBX,WAAWG;YAChC,IACAP;;;AAKV,GAAG"}
+{"version":3,"sources":["../../src/progress/LinearProgress.tsx"],"sourcesContent":["import {\n  type CSSProperties,\n  type HTMLAttributes,\n  forwardRef,\n  useMemo,\n} from \"react\";\n\nimport { type LabelRequiredForA11y, type PropsWithRef } from \"../types.js\";\nimport { useEnsuredId } from \"../useEnsuredId.js\";\nimport { getPercentage } from \"../utils/getPercentage.js\";\nimport { linearProgress, linearProgressBar } from \"./linearProgressStyles.js\";\nimport { type ProgressProps } from \"./types.js\";\n\n/**\n * @since 6.0.0 Added the `theme` prop\n */\nexport interface LinearProgressProps\n  extends Omit<HTMLAttributes<HTMLSpanElement>, \"id\" | \"children\">,\n    ProgressProps {\n  /**\n   * An optional style to apply to the progress bar. This will be merged with\n   * the current width or height tracking the progress when a `value` is also\n   * provided.\n   */\n  barStyle?: CSSProperties;\n\n  /**\n   * An optional className to apply to the progress bar.\n   */\n  barClassName?: string;\n\n  /**\n   * @since 6.1.0\n   */\n  barProps?: PropsWithRef<HTMLAttributes<HTMLSpanElement>>;\n\n  /**\n   * Boolean if the progress should be reversed. This will change the progress\n   * direction from `left-to-right` to be `right-to-left`. If the current\n   * language is a rtl language and this prop is enabled, the direction will\n   * still be `left-to-right`.\n   *\n   * @defaultValue `false`\n   */\n  reverse?: boolean;\n\n  /**\n   * Boolean if the progress should be vertical instead of horizontal.  When\n   * this prop is set, you should also set the `verticalHeight` prop to a height\n   * value you want for your progress bar.\n   *\n   * @defaultValue `false`\n   */\n  vertical?: boolean;\n\n  /**\n   * Since there isn't really a good way to have \"auto height\", you'll need to\n   * manually set the progress bar's height with this prop to some pixel value.\n   * If you'd prefer to set the height in Sass/css, set this value to `null`\n   * instead since this value would be passed down as a `height` inline style.\n   *\n   * @defaultValue `240`\n   */\n  verticalHeight?: number | null;\n}\n\n/**\n * @example Indeterminate Example\n * ```tsx\n * import { LinearProgress } from \"@react-md/core/progress/LinearProgress\";\n * import { type ReactElement } from \"react\";\n *\n * function Example(): ReactElement {\n *   return <LinearProgress aria-label=\"Loading\" />;\n * }\n * ```\n *\n * @example Determinate Example\n * ```tsx\n * import { LinearProgress } from \"@react-md/core/progress/LinearProgress\";\n * import { useState, type ReactElement } from \"react\";\n *\n * function Example(): ReactElement {\n *   // a number from 0 - 100\n *   const [progress, setProgress] = useState(0);\n *\n *   return <LinearProgress aria-label=\"File upload\" value={progress} />;\n * }\n * ```\n *\n * @see {@link https://react-md.dev/components/progress#linear-progress | Progress Demos}\n * @since 6.0.0 Supports rendering as any of the theme colors and\n * requires a label for accessibility.\n */\nexport const LinearProgress = forwardRef<\n  HTMLSpanElement,\n  LabelRequiredForA11y<LinearProgressProps>\n>(function LinearProgress(props, ref) {\n  const {\n    id: propId,\n    style: propStyle,\n    className,\n    barStyle: propBarStyle,\n    barClassName,\n    barProps,\n    min = 0,\n    max = 100,\n    value,\n    reverse,\n    theme,\n    disableTransition,\n    vertical,\n    verticalHeight = 240,\n    ...remaining\n  } = props;\n\n  const id = useEnsuredId(propId, \"linear-progress\");\n  const style = useMemo(() => {\n    if (!vertical || verticalHeight === null) {\n      return propStyle;\n    }\n\n    return {\n      ...propStyle,\n      height: verticalHeight,\n    };\n  }, [propStyle, vertical, verticalHeight]);\n\n  let progress: number | undefined;\n  if (typeof value === \"number\") {\n    progress = getPercentage({ min, max, value, validate: true });\n  }\n  const barStyle = useMemo(() => {\n    if (typeof progress !== \"number\") {\n      return propBarStyle;\n    }\n\n    const key = vertical ? \"height\" : \"width\";\n    return {\n      ...propBarStyle,\n      [key]: `${progress * 100}%`,\n    };\n  }, [progress, propBarStyle, vertical]);\n\n  const indeterminate = typeof progress !== \"number\";\n  return (\n    <span\n      {...remaining}\n      id={id}\n      ref={ref}\n      style={style}\n      role=\"progressbar\"\n      aria-valuemin={min}\n      aria-valuemax={max}\n      aria-valuenow={value}\n      className={linearProgress({\n        className,\n        theme,\n        vertical,\n        indeterminate,\n      })}\n    >\n      <span\n        {...barProps}\n        style={barStyle}\n        className={linearProgressBar({\n          className: barClassName,\n          reverse,\n          vertical,\n          indeterminate,\n          disableTransition,\n        })}\n      />\n    </span>\n  );\n});\n"],"names":["forwardRef","useMemo","useEnsuredId","getPercentage","linearProgress","linearProgressBar","LinearProgress","props","ref","id","propId","style","propStyle","className","barStyle","propBarStyle","barClassName","barProps","min","max","value","reverse","theme","disableTransition","vertical","verticalHeight","remaining","height","progress","validate","key","indeterminate","span","role","aria-valuemin","aria-valuemax","aria-valuenow"],"mappings":";AAAA,SAGEA,UAAU,EACVC,OAAO,QACF,QAAQ;AAGf,SAASC,YAAY,QAAQ,qBAAqB;AAClD,SAASC,aAAa,QAAQ,4BAA4B;AAC1D,SAASC,cAAc,EAAEC,iBAAiB,QAAQ,4BAA4B;AAwD9E;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BC,GACD,OAAO,MAAMC,+BAAiBN,WAG5B,SAASM,eAAeC,KAAK,EAAEC,GAAG;IAClC,MAAM,EACJC,IAAIC,MAAM,EACVC,OAAOC,SAAS,EAChBC,SAAS,EACTC,UAAUC,YAAY,EACtBC,YAAY,EACZC,QAAQ,EACRC,MAAM,CAAC,EACPC,MAAM,GAAG,EACTC,KAAK,EACLC,OAAO,EACPC,KAAK,EACLC,iBAAiB,EACjBC,QAAQ,EACRC,iBAAiB,GAAG,EACpB,GAAGC,WACJ,GAAGnB;IAEJ,MAAME,KAAKP,aAAaQ,QAAQ;IAChC,MAAMC,QAAQV,QAAQ;QACpB,IAAI,CAACuB,YAAYC,mBAAmB,MAAM;YACxC,OAAOb;QACT;QAEA,OAAO;YACL,GAAGA,SAAS;YACZe,QAAQF;QACV;IACF,GAAG;QAACb;QAAWY;QAAUC;KAAe;IAExC,IAAIG;IACJ,IAAI,OAAOR,UAAU,UAAU;QAC7BQ,WAAWzB,cAAc;YAAEe;YAAKC;YAAKC;YAAOS,UAAU;QAAK;IAC7D;IACA,MAAMf,WAAWb,QAAQ;QACvB,IAAI,OAAO2B,aAAa,UAAU;YAChC,OAAOb;QACT;QAEA,MAAMe,MAAMN,WAAW,WAAW;QAClC,OAAO;YACL,GAAGT,YAAY;YACf,CAACe,IAAI,EAAE,GAAGF,WAAW,IAAI,CAAC,CAAC;QAC7B;IACF,GAAG;QAACA;QAAUb;QAAcS;KAAS;IAErC,MAAMO,gBAAgB,OAAOH,aAAa;IAC1C,qBACE,KAACI;QACE,GAAGN,SAAS;QACbjB,IAAIA;QACJD,KAAKA;QACLG,OAAOA;QACPsB,MAAK;QACLC,iBAAehB;QACfiB,iBAAehB;QACfiB,iBAAehB;QACfP,WAAWT,eAAe;YACxBS;YACAS;YACAE;YACAO;QACF;kBAEA,cAAA,KAACC;YACE,GAAGf,QAAQ;YACZN,OAAOG;YACPD,WAAWR,kBAAkB;gBAC3BQ,WAAWG;gBACXK;gBACAG;gBACAO;gBACAR;YACF;;;AAIR,GAAG"}

package/dist/progress/circularProgressStyles.d.ts

@@ -0,0 +1,62 @@
+import { type ProgressTheme } from "./types.js";
+/**
+ * @since 6.2.0
+ */
+export interface CircularProgressClassNameOptions {
+    className?: string;
+    /**
+     * @defaultValue `"primary"`
+     * @since 6.0.0
+     */
+    theme?: ProgressTheme;
+    /**
+     * Set to `true` to render as a smaller size.
+     *
+     * @defaultValue `false`
+     * @since 2.3.0
+     * @since 6.0.0 Renamed from `small`
+     */
+    dense?: boolean;
+    /**
+     * Boolean if the circular progress should be centered using left and right
+     * margins.
+     *
+     * @defaultValue `false`
+     * @since 6.0.0 Renamed from `centered`
+     */
+    disableCentered?: boolean;
+}
+/**
+ * @since 6.2.0
+ */
+export declare function circularProgress(options?: CircularProgressClassNameOptions): string;
+/**
+ * @since 6.2.0
+ */
+export interface CircularProgressSvgClassNameOptions {
+    className?: string;
+    /** @defaultValue `false` */
+    indeterminate?: boolean;
+    /** @defaultValue `false` */
+    disableShrink?: boolean;
+}
+/**
+ * @since 6.2.0
+ */
+export declare function circularProgressSvg(options?: CircularProgressSvgClassNameOptions): string;
+/**
+ * @since 6.2.0
+ */
+export interface CircularProgressCircleClassNameOptions {
+    className?: string;
+    /** @defaultValue `false` */
+    indeterminate?: boolean;
+    /** @defaultValue `false` */
+    disableShrink?: boolean;
+    /** @defaultValue `false` */
+    disableTransition?: boolean;
+}
+/**
+ * @since 6.2.0
+ */
+export declare function circularProgressCircle(options?: CircularProgressCircleClassNameOptions): string;

package/dist/progress/circularProgressStyles.js

@@ -0,0 +1,38 @@
+import { cnb } from "cnbuilder";
+import { cssUtils } from "../cssUtils.js";
+import { bem } from "../utils/bem.js";
+const styles = bem("rmd-circular-progress");
+/**
+ * @since 6.2.0
+ */ export function circularProgress(options = {}) {
+    const { className, theme = "primary", dense, disableCentered } = options;
+    return cnb(styles({
+        dense,
+        centered: !disableCentered
+    }), theme !== "current-color" && cssUtils({
+        textColor: theme
+    }), className);
+}
+/**
+ * @since 6.2.0
+ */ export function circularProgressSvg(options = {}) {
+    const { className, indeterminate, disableShrink } = options;
+    return cnb(styles("svg", {
+        determinate: !indeterminate,
+        indeterminate: indeterminate && !disableShrink,
+        "rotate-only": indeterminate && disableShrink
+    }), className);
+}
+/**
+ * @since 6.2.0
+ */ export function circularProgressCircle(options = {}) {
+    const { className, indeterminate, disableShrink, disableTransition } = options;
+    return cnb(styles("circle", {
+        animate: !disableTransition && !indeterminate,
+        determinate: !indeterminate,
+        indeterminate: indeterminate && !disableShrink,
+        "rotate-only": indeterminate && disableShrink
+    }), className);
+}
+
+//# sourceMappingURL=circularProgressStyles.js.map

package/dist/progress/circularProgressStyles.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/progress/circularProgressStyles.ts"],"sourcesContent":["import { cnb } from \"cnbuilder\";\n\nimport { cssUtils } from \"../cssUtils.js\";\nimport { bem } from \"../utils/bem.js\";\nimport { type ProgressTheme } from \"./types.js\";\n\nconst styles = bem(\"rmd-circular-progress\");\n\n/**\n * @since 6.2.0\n */\nexport interface CircularProgressClassNameOptions {\n  className?: string;\n\n  /**\n   * @defaultValue `\"primary\"`\n   * @since 6.0.0\n   */\n  theme?: ProgressTheme;\n\n  /**\n   * Set to `true` to render as a smaller size.\n   *\n   * @defaultValue `false`\n   * @since 2.3.0\n   * @since 6.0.0 Renamed from `small`\n   */\n  dense?: boolean;\n\n  /**\n   * Boolean if the circular progress should be centered using left and right\n   * margins.\n   *\n   * @defaultValue `false`\n   * @since 6.0.0 Renamed from `centered`\n   */\n  disableCentered?: boolean;\n}\n\n/**\n * @since 6.2.0\n */\nexport function circularProgress(\n  options: CircularProgressClassNameOptions = {}\n): string {\n  const { className, theme = \"primary\", dense, disableCentered } = options;\n\n  return cnb(\n    styles({ dense, centered: !disableCentered }),\n    theme !== \"current-color\" && cssUtils({ textColor: theme }),\n    className\n  );\n}\n\n/**\n * @since 6.2.0\n */\nexport interface CircularProgressSvgClassNameOptions {\n  className?: string;\n  /** @defaultValue `false` */\n  indeterminate?: boolean;\n  /** @defaultValue `false` */\n  disableShrink?: boolean;\n}\n\n/**\n * @since 6.2.0\n */\nexport function circularProgressSvg(\n  options: CircularProgressSvgClassNameOptions = {}\n): string {\n  const { className, indeterminate, disableShrink } = options;\n\n  return cnb(\n    styles(\"svg\", {\n      determinate: !indeterminate,\n      indeterminate: indeterminate && !disableShrink,\n      \"rotate-only\": indeterminate && disableShrink,\n    }),\n    className\n  );\n}\n/**\n * @since 6.2.0\n */\nexport interface CircularProgressCircleClassNameOptions {\n  className?: string;\n  /** @defaultValue `false` */\n  indeterminate?: boolean;\n  /** @defaultValue `false` */\n  disableShrink?: boolean;\n  /** @defaultValue `false` */\n  disableTransition?: boolean;\n}\n\n/**\n * @since 6.2.0\n */\nexport function circularProgressCircle(\n  options: CircularProgressCircleClassNameOptions = {}\n): string {\n  const { className, indeterminate, disableShrink, disableTransition } =\n    options;\n\n  return cnb(\n    styles(\"circle\", {\n      animate: !disableTransition && !indeterminate,\n      determinate: !indeterminate,\n      indeterminate: indeterminate && !disableShrink,\n      \"rotate-only\": indeterminate && disableShrink,\n    }),\n    className\n  );\n}\n"],"names":["cnb","cssUtils","bem","styles","circularProgress","options","className","theme","dense","disableCentered","centered","textColor","circularProgressSvg","indeterminate","disableShrink","determinate","circularProgressCircle","disableTransition","animate"],"mappings":"AAAA,SAASA,GAAG,QAAQ,YAAY;AAEhC,SAASC,QAAQ,QAAQ,iBAAiB;AAC1C,SAASC,GAAG,QAAQ,kBAAkB;AAGtC,MAAMC,SAASD,IAAI;AAiCnB;;CAEC,GACD,OAAO,SAASE,iBACdC,UAA4C,CAAC,CAAC;IAE9C,MAAM,EAAEC,SAAS,EAAEC,QAAQ,SAAS,EAAEC,KAAK,EAAEC,eAAe,EAAE,GAAGJ;IAEjE,OAAOL,IACLG,OAAO;QAAEK;QAAOE,UAAU,CAACD;IAAgB,IAC3CF,UAAU,mBAAmBN,SAAS;QAAEU,WAAWJ;IAAM,IACzDD;AAEJ;AAaA;;CAEC,GACD,OAAO,SAASM,oBACdP,UAA+C,CAAC,CAAC;IAEjD,MAAM,EAAEC,SAAS,EAAEO,aAAa,EAAEC,aAAa,EAAE,GAAGT;IAEpD,OAAOL,IACLG,OAAO,OAAO;QACZY,aAAa,CAACF;QACdA,eAAeA,iBAAiB,CAACC;QACjC,eAAeD,iBAAiBC;IAClC,IACAR;AAEJ;AAcA;;CAEC,GACD,OAAO,SAASU,uBACdX,UAAkD,CAAC,CAAC;IAEpD,MAAM,EAAEC,SAAS,EAAEO,aAAa,EAAEC,aAAa,EAAEG,iBAAiB,EAAE,GAClEZ;IAEF,OAAOL,IACLG,OAAO,UAAU;QACfe,SAAS,CAACD,qBAAqB,CAACJ;QAChCE,aAAa,CAACF;QACdA,eAAeA,iBAAiB,CAACC;QACjC,eAAeD,iBAAiBC;IAClC,IACAR;AAEJ"}

package/dist/progress/linearProgressStyles.d.ts

@@ -0,0 +1,38 @@
+import { type ProgressTheme } from "./types.js";
+/**
+ * @since 6.2.0
+ */
+export interface LinearProgressClassNameOptions {
+    className?: string;
+    /**
+     * @defaultValue `"primary"`
+     * @since 6.0.0
+     */
+    theme?: ProgressTheme;
+    /** @defaultValue `false` */
+    vertical?: boolean;
+    /** @defaultValue `false` */
+    indeterminate?: boolean;
+}
+/**
+ * @since 6.2.0
+ */
+export declare function linearProgress(options?: LinearProgressClassNameOptions): string;
+/**
+ * @since 6.2.0
+ */
+export interface LinearProgressBarClassNameOptions {
+    className?: string;
+    /** @defaultValue `false` */
+    reverse?: boolean;
+    /** @defaultValue `false` */
+    vertical?: boolean;
+    /** @defaultValue `false` */
+    indeterminate?: boolean;
+    /** @defaultValue `false` */
+    disableTransition?: boolean;
+}
+/**
+ * @since 6.2.0
+ */
+export declare function linearProgressBar(options?: LinearProgressBarClassNameOptions): string;

package/dist/progress/linearProgressStyles.js

@@ -0,0 +1,38 @@
+import { cnb } from "cnbuilder";
+import { cssUtils } from "../cssUtils.js";
+import { bem } from "../utils/bem.js";
+const styles = bem("rmd-linear-progress");
+/**
+ * @since 6.2.0
+ */ export function linearProgress(options = {}) {
+    const { className, theme = "primary", vertical, indeterminate } = options;
+    return cnb(styles({
+        vertical,
+        horizontal: !vertical,
+        determinate: !indeterminate,
+        indeterminate
+    }), theme !== "current-color" && cssUtils({
+        textColor: theme
+    }), className);
+}
+/**
+ * @since 6.2.0
+ */ export function linearProgressBar(options = {}) {
+    const { className, reverse, vertical, indeterminate, disableTransition } = options;
+    return cnb(styles("bar", {
+        vertical,
+        "vertical-reverse": vertical && reverse,
+        horizontal: !vertical,
+        "horizontal-reverse": !vertical && reverse,
+        animate: !disableTransition && !indeterminate,
+        determinate: !indeterminate,
+        indeterminate,
+        "determinate-reverse": !indeterminate && reverse && !vertical,
+        "determinate-vertical-reverse": !indeterminate && reverse && vertical,
+        "indeterminate-reverse": indeterminate && reverse && !vertical,
+        "indeterminate-vertical": indeterminate && vertical,
+        "indeterminate-vertical-reverse": indeterminate && reverse && vertical
+    }), className);
+}
+
+//# sourceMappingURL=linearProgressStyles.js.map

package/dist/progress/linearProgressStyles.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/progress/linearProgressStyles.ts"],"sourcesContent":["import { cnb } from \"cnbuilder\";\n\nimport { cssUtils } from \"../cssUtils.js\";\nimport { bem } from \"../utils/bem.js\";\nimport { type ProgressTheme } from \"./types.js\";\n\nconst styles = bem(\"rmd-linear-progress\");\n\n/**\n * @since 6.2.0\n */\nexport interface LinearProgressClassNameOptions {\n  className?: string;\n\n  /**\n   * @defaultValue `\"primary\"`\n   * @since 6.0.0\n   */\n  theme?: ProgressTheme;\n\n  /** @defaultValue `false` */\n  vertical?: boolean;\n\n  /** @defaultValue `false` */\n  indeterminate?: boolean;\n}\n\n/**\n * @since 6.2.0\n */\nexport function linearProgress(\n  options: LinearProgressClassNameOptions = {}\n): string {\n  const { className, theme = \"primary\", vertical, indeterminate } = options;\n\n  return cnb(\n    styles({\n      vertical,\n      horizontal: !vertical,\n      determinate: !indeterminate,\n      indeterminate,\n    }),\n    theme !== \"current-color\" && cssUtils({ textColor: theme }),\n    className\n  );\n}\n\n/**\n * @since 6.2.0\n */\nexport interface LinearProgressBarClassNameOptions {\n  className?: string;\n\n  /** @defaultValue `false` */\n  reverse?: boolean;\n  /** @defaultValue `false` */\n  vertical?: boolean;\n  /** @defaultValue `false` */\n  indeterminate?: boolean;\n  /** @defaultValue `false` */\n  disableTransition?: boolean;\n}\n\n/**\n * @since 6.2.0\n */\nexport function linearProgressBar(\n  options: LinearProgressBarClassNameOptions = {}\n): string {\n  const { className, reverse, vertical, indeterminate, disableTransition } =\n    options;\n\n  return cnb(\n    styles(\"bar\", {\n      vertical,\n      \"vertical-reverse\": vertical && reverse,\n      horizontal: !vertical,\n      \"horizontal-reverse\": !vertical && reverse,\n      animate: !disableTransition && !indeterminate,\n      determinate: !indeterminate,\n      indeterminate,\n      \"determinate-reverse\": !indeterminate && reverse && !vertical,\n      \"determinate-vertical-reverse\": !indeterminate && reverse && vertical,\n      \"indeterminate-reverse\": indeterminate && reverse && !vertical,\n      \"indeterminate-vertical\": indeterminate && vertical,\n      \"indeterminate-vertical-reverse\": indeterminate && reverse && vertical,\n    }),\n    className\n  );\n}\n"],"names":["cnb","cssUtils","bem","styles","linearProgress","options","className","theme","vertical","indeterminate","horizontal","determinate","textColor","linearProgressBar","reverse","disableTransition","animate"],"mappings":"AAAA,SAASA,GAAG,QAAQ,YAAY;AAEhC,SAASC,QAAQ,QAAQ,iBAAiB;AAC1C,SAASC,GAAG,QAAQ,kBAAkB;AAGtC,MAAMC,SAASD,IAAI;AAqBnB;;CAEC,GACD,OAAO,SAASE,eACdC,UAA0C,CAAC,CAAC;IAE5C,MAAM,EAAEC,SAAS,EAAEC,QAAQ,SAAS,EAAEC,QAAQ,EAAEC,aAAa,EAAE,GAAGJ;IAElE,OAAOL,IACLG,OAAO;QACLK;QACAE,YAAY,CAACF;QACbG,aAAa,CAACF;QACdA;IACF,IACAF,UAAU,mBAAmBN,SAAS;QAAEW,WAAWL;IAAM,IACzDD;AAEJ;AAkBA;;CAEC,GACD,OAAO,SAASO,kBACdR,UAA6C,CAAC,CAAC;IAE/C,MAAM,EAAEC,SAAS,EAAEQ,OAAO,EAAEN,QAAQ,EAAEC,aAAa,EAAEM,iBAAiB,EAAE,GACtEV;IAEF,OAAOL,IACLG,OAAO,OAAO;QACZK;QACA,oBAAoBA,YAAYM;QAChCJ,YAAY,CAACF;QACb,sBAAsB,CAACA,YAAYM;QACnCE,SAAS,CAACD,qBAAqB,CAACN;QAChCE,aAAa,CAACF;QACdA;QACA,uBAAuB,CAACA,iBAAiBK,WAAW,CAACN;QACrD,gCAAgC,CAACC,iBAAiBK,WAAWN;QAC7D,yBAAyBC,iBAAiBK,WAAW,CAACN;QACtD,0BAA0BC,iBAAiBD;QAC3C,kCAAkCC,iBAAiBK,WAAWN;IAChE,IACAF;AAEJ"}

package/dist/responsive-item/_responsive-item.scss

@@ -6,6 +6,7 @@
 @use "sass:map";
 @use "sass:math";
 @use "../utils";
+@use "../spacing";
 @use "../theme/colors";
 @use "../theme/theme";
 
@@ -85,7 +86,7 @@ $overlay-z-index: 0 !default;
 
 /// The default `ResponsiveItemOverlay` padding.
 /// @type Number
-$overlay-padding: 1rem !default;
+$overlay-padding: spacing.get-var(md) !default;
 
 /// The default width to apply to the `position="left"`, `"position="right"`,
 /// `position="center"`, or `position="absolute-center"`

package/dist/searching/caseInsensitive.d.ts

@@ -1,4 +1,4 @@
-import { type TextExtractor } from "../types.js";
+import { type AutomaticTextExtraction, type TextExtractor } from "../types.js";
 import { type BaseSearchOptions } from "./types.js";
 /**
  * @since 6.0.0
@@ -123,17 +123,33 @@ export interface CaseInsensitiveOptions<T> extends BaseSearchOptions<T>, CaseIns
  * caseInsensitiveSearch({
  *   list: fruits,
  *   query: "ap",
- *   extractor: (item) => item.name,
  * });
  * // [{ name: "Apple", value: 0 }, { name: "Grape", value: 2 }]
  * ```
  *
+ * @example Objects With Custom Names
+ * ```ts
+ * const fruits = [
+ *   { nameField: "Apple", value: 0 },
+ *   { nameField: "Banana", value: 1 },
+ *   { nameField: "Grape", value: 2 },
+ *   { nameField: "Orange", value: 3 },
+ * ];
+ *
+ * caseInsensitiveSearch({
+ *   list: fruits,
+ *   query: "ap",
+ *   extractor: (item) => item.nameField,
+ * });
+ * // [{ nameField: "Apple", value: 0 }, { nameField: "Grape", value: 2 }]
+ * ```
+ *
  * @since 6.0.0
  */
-export declare function caseInsensitiveSearch<T extends string>(options: Omit<CaseInsensitiveOptions<T>, "extractor"> & {
+export declare function caseInsensitiveSearch<T extends AutomaticTextExtraction>(options: CaseInsensitiveOptions<T> & {
     type?: "filter";
 }): readonly T[];
-export declare function caseInsensitiveSearch<T extends string>(options: Omit<CaseInsensitiveOptions<T>, "extractor"> & {
+export declare function caseInsensitiveSearch<T extends AutomaticTextExtraction>(options: CaseInsensitiveOptions<T> & {
     type: "search";
 }): T | undefined;
 export declare function caseInsensitiveSearch<T>(options: CaseInsensitiveOptions<T> & {

package/dist/searching/caseInsensitive.js

@@ -1,4 +1,8 @@
 import { defaultExtractor, search } from "./utils.js";
+/**
+ * @since 6.2.0
+ * @internal
+ */ const DEFAULT_EXTRACTOR = defaultExtractor("caseInsensitiveSearch");
 /**
  * @since 6.0.0
  */ export function isCaseInsensitiveMatch(options) {
@@ -10,7 +14,7 @@ import { defaultExtractor, search } from "./utils.js";
     return matchIndex !== -1;
 }
 export function caseInsensitiveSearch(options) {
-    const { list, type = "filter", query, extractor = defaultExtractor("caseInsensitiveSearch"), startsWith, whitespace } = options;
+    const { list, type = "filter", query, extractor = DEFAULT_EXTRACTOR, startsWith, whitespace } = options;
     return search({
         type,
         list,

package/dist/searching/caseInsensitive.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/searching/caseInsensitive.ts"],"sourcesContent":["import { type TextExtractor } from \"../types.js\";\nimport { type BaseSearchOptions } from \"./types.js\";\nimport { defaultExtractor, search } from \"./utils.js\";\n\n/**\n * @since 6.0.0\n */\nexport interface CaseInsensitiveStartsWithOptions {\n  /**\n   * Set this to `true` if the item in the list must start with the query\n   * instead of only including it.\n   *\n   * @example Search Example\n   * ```ts\n   * const fruits = [\"Banana\", \"Grape\", \"Apple\", \"Orange\"];\n   *\n   * caseInsensitiveSearch({\n   *   list: fruits,\n   *   query: \"ap\",\n   *   type: \"search\",\n   * });\n   * // \"Grape\"\n   *\n   * caseInsensitiveSearch({\n   *   list: fruits,\n   *   query: \"ap\",\n   *   type: \"search\",\n   *   startsWith: true,\n   * });\n   * // \"Apple\"\n   * ```\n   *\n   * @example Filter Example\n   * ```ts\n   * const fruits = [\"Apple\", \"Banana\", \"Grape\", \"Orange\"];\n   *\n   * caseInsensitiveSearch({\n   *   list: fruits,\n   *   query: \"ap\",\n   * });\n   * // [\"Apple\", \"Grape\"]\n   *\n   * caseInsensitiveSearch({\n   *   list: fruits,\n   *   query: \"ap\",\n   *   startsWith: true,\n   * });\n   * // [\"Apple\"]\n   * ```\n   *\n   * @defaultValue `false`\n   */\n  startsWith?: boolean;\n}\n\n/**\n * @since 6.0.0\n */\nexport interface IsCaseInsensitiveMatchOptions\n  extends CaseInsensitiveStartsWithOptions {\n  /**\n   * The current search query.\n   */\n  query: string;\n\n  /**\n   * The current value to compare against.\n   */\n  value: string;\n}\n\n/**\n * @since 6.0.0\n */\nexport function isCaseInsensitiveMatch(\n  options: IsCaseInsensitiveMatchOptions\n): boolean {\n  const { query, value, startsWith } = options;\n  const matchIndex = value.indexOf(query);\n  if (startsWith) {\n    return matchIndex === 0;\n  }\n\n  return matchIndex !== -1;\n}\n\n/**\n * @since 6.0.0\n */\nexport interface CaseInsensitiveOptions<T>\n  extends BaseSearchOptions<T>,\n    CaseInsensitiveStartsWithOptions {}\n\n/**\n * @example String list\n * ```ts\n * const fruits = [\"Apple\", \"Banana\", \"Grape\", \"Orange\"];\n *\n * caseInsensitiveSearch({\n *   list: fruits,\n *   query: \"ap\",\n * });\n * // [\"Apple\", \"Grape\"]\n *\n * caseInsensitiveSearch({\n *   list: fruits,\n *   query: \"ap\",\n *   startsWith: true,\n * });\n * // [\"Apple\"]\n *\n * caseInsensitiveSearch({\n *   list: fruits,\n *   query: \"  a p\",\n * });\n * // []\n *\n * caseInsensitiveSearch({\n *   list: fruits,\n *   query: \"  a p\",\n *   whitespace: \"ignore\",\n * });\n * // [\"Apple\", \"Grape\"]\n *\n * caseInsensitiveSearch({\n *   list: fruits,\n *   query: \"  ap  \",\n *   whitespace: \"trim\",\n * });\n * // [\"Apple\", \"Grape\"]\n * ```\n *\n * @example Objects\n * ```ts\n * const fruits = [\n *   { name: \"Apple\", value: 0 },\n *   { name: \"Banana\", value: 1 },\n *   { name: \"Grape\", value: 2 },\n *   { name: \"Orange\", value: 3 },\n * ];\n *\n * caseInsensitiveSearch({\n *   list: fruits,\n *   query: \"ap\",\n *   extractor: (item) => item.name,\n * });\n * // [{ name: \"Apple\", value: 0 }, { name: \"Grape\", value: 2 }]\n * ```\n *\n * @since 6.0.0\n */\nexport function caseInsensitiveSearch<T extends string>(\n  options: Omit<CaseInsensitiveOptions<T>, \"extractor\"> & { type?: \"filter\" }\n): readonly T[];\nexport function caseInsensitiveSearch<T extends string>(\n  options: Omit<CaseInsensitiveOptions<T>, \"extractor\"> & { type: \"search\" }\n): T | undefined;\nexport function caseInsensitiveSearch<T>(\n  options: CaseInsensitiveOptions<T> & {\n    extractor: TextExtractor<T>;\n    type?: \"filter\";\n  }\n): readonly T[];\nexport function caseInsensitiveSearch<T>(\n  options: CaseInsensitiveOptions<T> & {\n    extractor: TextExtractor<T>;\n    type: \"search\";\n  }\n): T | undefined;\nexport function caseInsensitiveSearch<T>(\n  options: CaseInsensitiveOptions<T>\n): readonly T[] | T | undefined {\n  const {\n    list,\n    type = \"filter\",\n    query,\n    extractor = defaultExtractor(\"caseInsensitiveSearch\"),\n    startsWith,\n    whitespace,\n  } = options;\n\n  return search({\n    type,\n    list,\n    query,\n    extractor,\n    whitespace,\n    filter(q, value) {\n      return isCaseInsensitiveMatch({\n        query: q,\n        value,\n        startsWith,\n      });\n    },\n  });\n}\n"],"names":["defaultExtractor","search","isCaseInsensitiveMatch","options","query","value","startsWith","matchIndex","indexOf","caseInsensitiveSearch","list","type","extractor","whitespace","filter","q"],"mappings":"AAEA,SAASA,gBAAgB,EAAEC,MAAM,QAAQ,aAAa;AAqEtD;;CAEC,GACD,OAAO,SAASC,uBACdC,OAAsC;IAEtC,MAAM,EAAEC,KAAK,EAAEC,KAAK,EAAEC,UAAU,EAAE,GAAGH;IACrC,MAAMI,aAAaF,MAAMG,OAAO,CAACJ;IACjC,IAAIE,YAAY;QACd,OAAOC,eAAe;IACxB;IAEA,OAAOA,eAAe,CAAC;AACzB;AAqFA,OAAO,SAASE,sBACdN,OAAkC;IAElC,MAAM,EACJO,IAAI,EACJC,OAAO,QAAQ,EACfP,KAAK,EACLQ,YAAYZ,iBAAiB,wBAAwB,EACrDM,UAAU,EACVO,UAAU,EACX,GAAGV;IAEJ,OAAOF,OAAO;QACZU;QACAD;QACAN;QACAQ;QACAC;QACAC,QAAOC,CAAC,EAAEV,KAAK;YACb,OAAOH,uBAAuB;gBAC5BE,OAAOW;gBACPV;gBACAC;YACF;QACF;IACF;AACF"}
+{"version":3,"sources":["../../src/searching/caseInsensitive.ts"],"sourcesContent":["import { type AutomaticTextExtraction, type TextExtractor } from \"../types.js\";\nimport { type BaseSearchOptions } from \"./types.js\";\nimport { defaultExtractor, search } from \"./utils.js\";\n\n/**\n * @since 6.2.0\n * @internal\n */\nconst DEFAULT_EXTRACTOR = defaultExtractor(\"caseInsensitiveSearch\");\n\n/**\n * @since 6.0.0\n */\nexport interface CaseInsensitiveStartsWithOptions {\n  /**\n   * Set this to `true` if the item in the list must start with the query\n   * instead of only including it.\n   *\n   * @example Search Example\n   * ```ts\n   * const fruits = [\"Banana\", \"Grape\", \"Apple\", \"Orange\"];\n   *\n   * caseInsensitiveSearch({\n   *   list: fruits,\n   *   query: \"ap\",\n   *   type: \"search\",\n   * });\n   * // \"Grape\"\n   *\n   * caseInsensitiveSearch({\n   *   list: fruits,\n   *   query: \"ap\",\n   *   type: \"search\",\n   *   startsWith: true,\n   * });\n   * // \"Apple\"\n   * ```\n   *\n   * @example Filter Example\n   * ```ts\n   * const fruits = [\"Apple\", \"Banana\", \"Grape\", \"Orange\"];\n   *\n   * caseInsensitiveSearch({\n   *   list: fruits,\n   *   query: \"ap\",\n   * });\n   * // [\"Apple\", \"Grape\"]\n   *\n   * caseInsensitiveSearch({\n   *   list: fruits,\n   *   query: \"ap\",\n   *   startsWith: true,\n   * });\n   * // [\"Apple\"]\n   * ```\n   *\n   * @defaultValue `false`\n   */\n  startsWith?: boolean;\n}\n\n/**\n * @since 6.0.0\n */\nexport interface IsCaseInsensitiveMatchOptions\n  extends CaseInsensitiveStartsWithOptions {\n  /**\n   * The current search query.\n   */\n  query: string;\n\n  /**\n   * The current value to compare against.\n   */\n  value: string;\n}\n\n/**\n * @since 6.0.0\n */\nexport function isCaseInsensitiveMatch(\n  options: IsCaseInsensitiveMatchOptions\n): boolean {\n  const { query, value, startsWith } = options;\n  const matchIndex = value.indexOf(query);\n  if (startsWith) {\n    return matchIndex === 0;\n  }\n\n  return matchIndex !== -1;\n}\n\n/**\n * @since 6.0.0\n */\nexport interface CaseInsensitiveOptions<T>\n  extends BaseSearchOptions<T>,\n    CaseInsensitiveStartsWithOptions {}\n\n/**\n * @example String list\n * ```ts\n * const fruits = [\"Apple\", \"Banana\", \"Grape\", \"Orange\"];\n *\n * caseInsensitiveSearch({\n *   list: fruits,\n *   query: \"ap\",\n * });\n * // [\"Apple\", \"Grape\"]\n *\n * caseInsensitiveSearch({\n *   list: fruits,\n *   query: \"ap\",\n *   startsWith: true,\n * });\n * // [\"Apple\"]\n *\n * caseInsensitiveSearch({\n *   list: fruits,\n *   query: \"  a p\",\n * });\n * // []\n *\n * caseInsensitiveSearch({\n *   list: fruits,\n *   query: \"  a p\",\n *   whitespace: \"ignore\",\n * });\n * // [\"Apple\", \"Grape\"]\n *\n * caseInsensitiveSearch({\n *   list: fruits,\n *   query: \"  ap  \",\n *   whitespace: \"trim\",\n * });\n * // [\"Apple\", \"Grape\"]\n * ```\n *\n * @example Objects\n * ```ts\n * const fruits = [\n *   { name: \"Apple\", value: 0 },\n *   { name: \"Banana\", value: 1 },\n *   { name: \"Grape\", value: 2 },\n *   { name: \"Orange\", value: 3 },\n * ];\n *\n * caseInsensitiveSearch({\n *   list: fruits,\n *   query: \"ap\",\n * });\n * // [{ name: \"Apple\", value: 0 }, { name: \"Grape\", value: 2 }]\n * ```\n *\n * @example Objects With Custom Names\n * ```ts\n * const fruits = [\n *   { nameField: \"Apple\", value: 0 },\n *   { nameField: \"Banana\", value: 1 },\n *   { nameField: \"Grape\", value: 2 },\n *   { nameField: \"Orange\", value: 3 },\n * ];\n *\n * caseInsensitiveSearch({\n *   list: fruits,\n *   query: \"ap\",\n *   extractor: (item) => item.nameField,\n * });\n * // [{ nameField: \"Apple\", value: 0 }, { nameField: \"Grape\", value: 2 }]\n * ```\n *\n * @since 6.0.0\n */\nexport function caseInsensitiveSearch<T extends AutomaticTextExtraction>(\n  options: CaseInsensitiveOptions<T> & { type?: \"filter\" }\n): readonly T[];\nexport function caseInsensitiveSearch<T extends AutomaticTextExtraction>(\n  options: CaseInsensitiveOptions<T> & { type: \"search\" }\n): T | undefined;\nexport function caseInsensitiveSearch<T>(\n  options: CaseInsensitiveOptions<T> & {\n    extractor: TextExtractor<T>;\n    type?: \"filter\";\n  }\n): readonly T[];\nexport function caseInsensitiveSearch<T>(\n  options: CaseInsensitiveOptions<T> & {\n    extractor: TextExtractor<T>;\n    type: \"search\";\n  }\n): T | undefined;\nexport function caseInsensitiveSearch<T>(\n  options: CaseInsensitiveOptions<T>\n): readonly T[] | T | undefined {\n  const {\n    list,\n    type = \"filter\",\n    query,\n    extractor = DEFAULT_EXTRACTOR,\n    startsWith,\n    whitespace,\n  } = options;\n\n  return search({\n    type,\n    list,\n    query,\n    extractor,\n    whitespace,\n    filter(q, value) {\n      return isCaseInsensitiveMatch({\n        query: q,\n        value,\n        startsWith,\n      });\n    },\n  });\n}\n"],"names":["defaultExtractor","search","DEFAULT_EXTRACTOR","isCaseInsensitiveMatch","options","query","value","startsWith","matchIndex","indexOf","caseInsensitiveSearch","list","type","extractor","whitespace","filter","q"],"mappings":"AAEA,SAASA,gBAAgB,EAAEC,MAAM,QAAQ,aAAa;AAEtD;;;CAGC,GACD,MAAMC,oBAAoBF,iBAAiB;AAqE3C;;CAEC,GACD,OAAO,SAASG,uBACdC,OAAsC;IAEtC,MAAM,EAAEC,KAAK,EAAEC,KAAK,EAAEC,UAAU,EAAE,GAAGH;IACrC,MAAMI,aAAaF,MAAMG,OAAO,CAACJ;IACjC,IAAIE,YAAY;QACd,OAAOC,eAAe;IACxB;IAEA,OAAOA,eAAe,CAAC;AACzB;AAqGA,OAAO,SAASE,sBACdN,OAAkC;IAElC,MAAM,EACJO,IAAI,EACJC,OAAO,QAAQ,EACfP,KAAK,EACLQ,YAAYX,iBAAiB,EAC7BK,UAAU,EACVO,UAAU,EACX,GAAGV;IAEJ,OAAOH,OAAO;QACZW;QACAD;QACAN;QACAQ;QACAC;QACAC,QAAOC,CAAC,EAAEV,KAAK;YACb,OAAOH,uBAAuB;gBAC5BE,OAAOW;gBACPV;gBACAC;YACF;QACF;IACF;AACF"}

package/dist/searching/fuzzy.d.ts

@@ -1,4 +1,4 @@
-import { type TextExtractor } from "../types.js";
+import { type AutomaticTextExtraction, type TextExtractor } from "../types.js";
 import { type BaseSearchOptions } from "./types.js";
 /**
  * @example
@@ -112,10 +112,10 @@ export type FuzzySearchOptions<T> = BaseSearchOptions<T>;
  *
  * @since 6.0.0
  */
-export declare function fuzzySearch<T extends string>(options: Omit<FuzzySearchOptions<T>, "extractor"> & {
+export declare function fuzzySearch<T extends AutomaticTextExtraction>(options: FuzzySearchOptions<T> & {
     type?: "filter";
 }): readonly T[];
-export declare function fuzzySearch<T extends string>(options: Omit<FuzzySearchOptions<T>, "extractor"> & {
+export declare function fuzzySearch<T extends AutomaticTextExtraction>(options: FuzzySearchOptions<T> & {
     type?: "search";
 }): T | undefined;
 export declare function fuzzySearch<T>(option: FuzzySearchOptions<T> & {

package/dist/searching/fuzzy.js

@@ -1,4 +1,8 @@
 import { defaultExtractor, search } from "./utils.js";
+/**
+ * @since 6.2.0
+ * @internal
+ */ const DEFAULT_EXTRACTOR = defaultExtractor("fuzzySearch");
 /**
  * @example
  * ```tsx
@@ -34,7 +38,7 @@ import { defaultExtractor, search } from "./utils.js";
     .replace(/\*\*/g, "*\\*"), "i");
 }
 export function fuzzySearch(options) {
-    const { list, type = "filter", query, extractor = defaultExtractor("fuzzySearch"), whitespace } = options;
+    const { list, type = "filter", query, extractor = DEFAULT_EXTRACTOR, whitespace } = options;
     // lazy initialize the RegExp since the base `filter` function will modify the
     // query and never call the filter function if:
     // - there is no query

package/dist/searching/fuzzy.js.map

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

package/dist/searching/utils.d.ts

@@ -2,9 +2,10 @@ import { type TextExtractor } from "../types.js";
 import { type BaseSearchOptions } from "./types.js";
 /**
  * @since 6.0.0
+ * @since 6.2.0 Added support for `item.name` and `item.label`.
  * @internal
  */
-export declare const defaultExtractor: (name: string) => (item: unknown) => string;
+export declare const defaultExtractor: (usageName: string, propName?: string) => (item: unknown) => string;
 /**
  * @internal
  * @since 6.0.0

package/dist/searching/utils.js

@@ -1,12 +1,21 @@
 import { toSearchQuery } from "./toSearchQuery.js";
 /**
  * @since 6.0.0
+ * @since 6.2.0 Added support for `item.name` and `item.label`.
  * @internal
- */ export const defaultExtractor = (name)=>(item)=>{
+ */ export const defaultExtractor = (usageName, propName = "extractor")=>(item)=>{
         if (typeof item === "string") {
             return item;
         }
-        throw new Error(`A \`TextExtractor\` must be provided to \`${name}\` for lists that do not contain strings`);
+        if (item && typeof item === "object") {
+            if ("label" in item && typeof item.label === "string") {
+                return item.label;
+            }
+            if ("name" in item && typeof item.name === "string") {
+                return item.name;
+            }
+        }
+        throw new Error(`\`${usageName}\` requires the \`${propName}\` prop for lists that do not contain strings or known object types.`);
     };
 /**
  * @internal

package/dist/searching/utils.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/searching/utils.ts"],"sourcesContent":["import { type TextExtractor } from \"../types.js\";\nimport { toSearchQuery } from \"./toSearchQuery.js\";\nimport { type BaseSearchOptions } from \"./types.js\";\n\n/**\n * @since 6.0.0\n * @internal\n */\nexport const defaultExtractor =\n  (name: string) =>\n  (item: unknown): string => {\n    if (typeof item === \"string\") {\n      return item;\n    }\n\n    throw new Error(\n      `A \\`TextExtractor\\` must be provided to \\`${name}\\` for lists that do not contain strings`\n    );\n  };\n\n/**\n * @internal\n * @since 6.0.0\n */\nexport interface SearchOptions<T> extends BaseSearchOptions<T> {\n  type: \"search\" | \"filter\";\n  filter: (query: string, value: string) => boolean;\n  extractor: TextExtractor<T>;\n}\n\n/**\n * @internal\n * @since 6.0.0\n */\nexport function search<T>(\n  options: SearchOptions<T>\n): readonly T[] | T | undefined {\n  const { list, type, query, filter, extractor, whitespace = \"keep\" } = options;\n  const fallback = type === \"search\" ? undefined : list;\n  if (!list.length) {\n    return fallback;\n  }\n\n  const q = toSearchQuery(query, whitespace);\n  if (!q) {\n    return fallback;\n  }\n\n  const fn = type === \"search\" ? \"find\" : \"filter\";\n  return list[fn]((item) =>\n    filter(q, toSearchQuery(extractor(item), whitespace))\n  );\n}\n"],"names":["toSearchQuery","defaultExtractor","name","item","Error","search","options","list","type","query","filter","extractor","whitespace","fallback","undefined","length","q","fn"],"mappings":"AACA,SAASA,aAAa,QAAQ,qBAAqB;AAGnD;;;CAGC,GACD,OAAO,MAAMC,mBACX,CAACC,OACD,CAACC;QACC,IAAI,OAAOA,SAAS,UAAU;YAC5B,OAAOA;QACT;QAEA,MAAM,IAAIC,MACR,CAAC,0CAA0C,EAAEF,KAAK,wCAAwC,CAAC;IAE/F,EAAE;AAYJ;;;CAGC,GACD,OAAO,SAASG,OACdC,OAAyB;IAEzB,MAAM,EAAEC,IAAI,EAAEC,IAAI,EAAEC,KAAK,EAAEC,MAAM,EAAEC,SAAS,EAAEC,aAAa,MAAM,EAAE,GAAGN;IACtE,MAAMO,WAAWL,SAAS,WAAWM,YAAYP;IACjD,IAAI,CAACA,KAAKQ,MAAM,EAAE;QAChB,OAAOF;IACT;IAEA,MAAMG,IAAIhB,cAAcS,OAAOG;IAC/B,IAAI,CAACI,GAAG;QACN,OAAOH;IACT;IAEA,MAAMI,KAAKT,SAAS,WAAW,SAAS;IACxC,OAAOD,IAAI,CAACU,GAAG,CAAC,CAACd,OACfO,OAAOM,GAAGhB,cAAcW,UAAUR,OAAOS;AAE7C"}
+{"version":3,"sources":["../../src/searching/utils.ts"],"sourcesContent":["import { type TextExtractor } from \"../types.js\";\nimport { toSearchQuery } from \"./toSearchQuery.js\";\nimport { type BaseSearchOptions } from \"./types.js\";\n\n/**\n * @since 6.0.0\n * @since 6.2.0 Added support for `item.name` and `item.label`.\n * @internal\n */\nexport const defaultExtractor =\n  (usageName: string, propName = \"extractor\") =>\n  (item: unknown): string => {\n    if (typeof item === \"string\") {\n      return item;\n    }\n\n    if (item && typeof item === \"object\") {\n      if (\"label\" in item && typeof item.label === \"string\") {\n        return item.label;\n      }\n\n      if (\"name\" in item && typeof item.name === \"string\") {\n        return item.name;\n      }\n    }\n\n    throw new Error(\n      `\\`${usageName}\\` requires the \\`${propName}\\` prop for lists that do not contain strings or known object types.`\n    );\n  };\n\n/**\n * @internal\n * @since 6.0.0\n */\nexport interface SearchOptions<T> extends BaseSearchOptions<T> {\n  type: \"search\" | \"filter\";\n  filter: (query: string, value: string) => boolean;\n  extractor: TextExtractor<T>;\n}\n\n/**\n * @internal\n * @since 6.0.0\n */\nexport function search<T>(\n  options: SearchOptions<T>\n): readonly T[] | T | undefined {\n  const { list, type, query, filter, extractor, whitespace = \"keep\" } = options;\n  const fallback = type === \"search\" ? undefined : list;\n  if (!list.length) {\n    return fallback;\n  }\n\n  const q = toSearchQuery(query, whitespace);\n  if (!q) {\n    return fallback;\n  }\n\n  const fn = type === \"search\" ? \"find\" : \"filter\";\n  return list[fn]((item) =>\n    filter(q, toSearchQuery(extractor(item), whitespace))\n  );\n}\n"],"names":["toSearchQuery","defaultExtractor","usageName","propName","item","label","name","Error","search","options","list","type","query","filter","extractor","whitespace","fallback","undefined","length","q","fn"],"mappings":"AACA,SAASA,aAAa,QAAQ,qBAAqB;AAGnD;;;;CAIC,GACD,OAAO,MAAMC,mBACX,CAACC,WAAmBC,WAAW,WAAW,GAC1C,CAACC;QACC,IAAI,OAAOA,SAAS,UAAU;YAC5B,OAAOA;QACT;QAEA,IAAIA,QAAQ,OAAOA,SAAS,UAAU;YACpC,IAAI,WAAWA,QAAQ,OAAOA,KAAKC,KAAK,KAAK,UAAU;gBACrD,OAAOD,KAAKC,KAAK;YACnB;YAEA,IAAI,UAAUD,QAAQ,OAAOA,KAAKE,IAAI,KAAK,UAAU;gBACnD,OAAOF,KAAKE,IAAI;YAClB;QACF;QAEA,MAAM,IAAIC,MACR,CAAC,EAAE,EAAEL,UAAU,kBAAkB,EAAEC,SAAS,oEAAoE,CAAC;IAErH,EAAE;AAYJ;;;CAGC,GACD,OAAO,SAASK,OACdC,OAAyB;IAEzB,MAAM,EAAEC,IAAI,EAAEC,IAAI,EAAEC,KAAK,EAAEC,MAAM,EAAEC,SAAS,EAAEC,aAAa,MAAM,EAAE,GAAGN;IACtE,MAAMO,WAAWL,SAAS,WAAWM,YAAYP;IACjD,IAAI,CAACA,KAAKQ,MAAM,EAAE;QAChB,OAAOF;IACT;IAEA,MAAMG,IAAInB,cAAcY,OAAOG;IAC/B,IAAI,CAACI,GAAG;QACN,OAAOH;IACT;IAEA,MAAMI,KAAKT,SAAS,WAAW,SAAS;IACxC,OAAOD,IAAI,CAACU,GAAG,CAAC,CAAChB,OACfS,OAAOM,GAAGnB,cAAcc,UAAUV,OAAOW;AAE7C"}