@react-md/core 1.0.0-next.0

package/dist/positioning/utils.js

@@ -0,0 +1,245 @@
+/**
+ * Creates the `left` style value for an element that should be fixed to the
+ * (outer) left of the container element. So the right bounds of the fixed
+ * element will be equal to the left bounds of the container element (before the
+ * xMargin is applied).
+ *
+ * @internal
+ */ export function getLeftCoord({ xMargin, elWidth, initialX, containerRect }) {
+    return (initialX ?? containerRect.left) - elWidth - xMargin;
+}
+/**
+ * Creates the `left` style value for an element that should be fixed to the
+ * inner-left of the container element. So the left bounds of both the container
+ * and fixed elements will overlap (before the xMargin is applied)
+ *
+ * @internal
+ */ export function getInnerLeftCoord({ xMargin, initialX, containerRect }) {
+    return (initialX ?? containerRect.left) + xMargin;
+}
+/**
+ * Creates the `left` style value for an element that should be fixed to the
+ * center of the container element. So the center point of the fixed element
+ * should be the center point of the container element.
+ *
+ * Note: Unlike all the other horizontal positioning logic, the center position
+ * does not use the xMargin.
+ *
+ * @internal
+ */ export function getCenterXCoord({ elWidth, initialX, containerRect }) {
+    const containerCenter = containerRect.width / 2;
+    const elementCenter = elWidth / 2;
+    return (initialX ?? containerRect.left + containerCenter) - elementCenter;
+}
+/**
+ * Creates the `left` style value for an element that should be fixed to the
+ * inner-right of the container element. So the right bounds for both the
+ * container and fixed elements will overlap (before the xMargin is applied).
+ *
+ * @internal
+ */ export function getInnerRightCoord({ xMargin, elWidth, initialX, containerRect }) {
+    return (initialX ?? containerRect.left + containerRect.width) - elWidth - xMargin;
+}
+/**
+ * Creates the `left` style value for an element that should be fixed to the
+ * (outer) right of the container element. So the left bounds of the fixed
+ * element will overlap with the right bounds of the container element (before
+ * the xMargin is applied).
+ *
+ * @internal
+ */ export function getRightCoord({ xMargin, initialX, containerRect }) {
+    return (initialX ?? containerRect.left + containerRect.width) + xMargin;
+}
+/**
+ * Creates the `top` style value for an element that should be fixed above the
+ * container element. So the bottom bounds of the fixed element will overlap
+ * with the top bounds of the container element (before the yMargin is applied).
+ *
+ * @internal
+ */ export function getAboveCoord({ yMargin, initialY, elHeight, containerRect }) {
+    return (initialY ?? containerRect.top) - elHeight - yMargin;
+}
+/**
+ * Creates the `top` style value for an element that should be fixed to the top
+ * of the container element. So the top bounds for both the container and fixed
+ * elements will overlap (before the yMargin is applied).
+ *
+ * @internal
+ */ export function getTopCoord({ yMargin, initialY, containerRect }) {
+    return (initialY ?? containerRect.top) + yMargin;
+}
+/**
+ * Creates the `top` style value for an element that should be fixed vertically
+ * centered relative to the container element. So the vertical center point for
+ * the fixed element should overlap the vertical center point of the container
+ * element.
+ *
+ * Note: Unlike all the other vertical positioning logic, the center position
+ * does not use the yMargin.
+ *
+ * @internal
+ */ export function getCenterYCoord({ yMargin, elHeight, initialY, containerRect }) {
+    const containerCenter = containerRect.height / 2;
+    const elementCenter = elHeight / 2;
+    return (initialY ?? containerRect.top + containerCenter + yMargin) - elementCenter;
+}
+/**
+ * Creates the `top` style value for an element that should be fixed to the
+ * bottom of the container element. So the top bounds of the fixed element
+ * should overlap the bottom bounds of the container element (before the yMargin
+ * is applied).
+ *
+ * @internal
+ */ export function getBottomCoord({ yMargin, initialY, elHeight, containerRect }) {
+    return (initialY ?? containerRect.top + containerRect.height) - elHeight - yMargin;
+}
+/**
+ * Creates the `top` style value for an element that should be fixed to the
+ * bottom of the container element. So the bottom bounds of both the container
+ * and fixed elements should overlap (before the yMargin is applied).
+ *
+ * @internal
+ */ export function getBelowCoord({ yMargin, initialY, containerRect }) {
+    return (initialY ?? containerRect.top + containerRect.height) + yMargin;
+}
+/**
+ * This is a simple util that'll generate a css `transform-origin` string so
+ * that the fixed element can animate from the correct point based on the
+ * provided anchor.
+ *
+ * @param options - The anchor that should be used to create the transform origin
+ * for.
+ * @returns the transform origin string
+ * @internal
+ */ export function getTransformOrigin(options) {
+    const { transformOriginY: yPosition } = options;
+    let x = "0";
+    switch(options.x){
+        case "right":
+        case "inner-left":
+            x = "0";
+            break;
+        case "center":
+            x = "50%";
+            break;
+        case "left":
+        case "inner-right":
+            x = "100%";
+            break;
+        default:
+            x = "0";
+    }
+    let y = "0";
+    if (typeof yPosition === "number") {
+        y = `${yPosition}px`;
+    } else {
+        switch(options.y){
+            case "above":
+            case "bottom":
+                y = "100%";
+                break;
+            case "center":
+                y = "50%";
+                break;
+            case "below":
+            case "top":
+                y = "0";
+                break;
+            default:
+                y = "0";
+        }
+    }
+    return `${x} ${y}`;
+}
+/**
+ * Attempts to find a sizing container based on the provided HTMLElement. By
+ * default, the sizing element will just be the provided element unless:
+ * - the item has a known role within react-md that can target known classes
+ * - the item has a `data-sizing-selector` attribute that is a valid query
+ *   selector for the nested item.
+ *
+ * NOTE: The `data-sizing-selector` will be run from the current element instead
+ * of the `document`.
+ *
+ * @param el - The element to find a sizing container for.
+ * @returns the sizing container relative to the provided element, or `null` if
+ * none could be found.
+ * @throws This error will be thrown if using the `data-query-selector` and the
+ * query selector does not return an element on the page.
+ * @internal
+ */ export function findSizingContainer(el) {
+    if (!el) {
+        return null;
+    }
+    if (/(tree|list)item/.test(el.getAttribute("role") || "")) {
+        const content = el.querySelector(".rmd-tree-item__content, .rmd-item-text");
+        if (content) {
+            return content;
+        }
+    } else if (el.getAttribute("type") === "file") {
+        const label = document.querySelector(`[for="${el.id}"]`);
+        if (label) {
+            return label;
+        }
+    }
+    const data = el.getAttribute("data-sizing-selector");
+    if (data) {
+        const content = el.querySelector(data);
+        if (content) {
+            return content;
+        }
+        if (process.env.NODE_ENV !== "production") {
+            throw new Error("Unable to find a child element using the `data-sizing-selector`");
+        }
+    }
+    return el;
+}
+/**
+ * This util is used to get the "true" `element.getBoundingClientRect()` that
+ * ensures that transitions using transforms don't mess up the sizing so that
+ * position calculations are easier to do.
+ *
+ * @param element - The element to get a rect for.
+ * @returns either a DOMRect for the element
+ * @internal
+ */ export function getElementRect(element) {
+    const cloned = element.cloneNode(true);
+    // remove the id so there won't be two elements with the same id on the page
+    cloned.removeAttribute("id");
+    // remove the role just in case the role would alert screen readers once added
+    // to the dom
+    cloned.removeAttribute("role");
+    // ensure the cloned node won't shift the page or be visible
+    cloned.style.position = "fixed";
+    cloned.style.visibility = "hidden";
+    // reset positioning to get a "pure" calculation. otherwise this will mess up
+    // the height and width if the element is able to line wrap.
+    cloned.style.left = "";
+    cloned.style.top = "";
+    cloned.style.right = "";
+    cloned.style.bottom = "";
+    // reset transforms so that custom animations don't mess with the sizing
+    cloned.style.transform = "none";
+    const parent = element.parentElement || document.body;
+    parent.appendChild(cloned);
+    const rect = cloned.getBoundingClientRect();
+    parent.removeChild(cloned);
+    return rect;
+}
+/**
+ * @remarks \@since 4.0.0
+ * @internal
+ */ export function isWithinViewport(options) {
+    const { fixedElement, fixedToElement } = options;
+    const fixedElementRect = fixedElement.getBoundingClientRect();
+    const fixedToElementRect = fixedToElement.getBoundingClientRect();
+    const vh = window.innerHeight;
+    const vw = window.innerWidth;
+    const top = Math.min(fixedElementRect.top, fixedToElementRect.top);
+    const right = Math.max(fixedElementRect.right, fixedToElementRect.right);
+    const bottom = Math.max(fixedElementRect.bottom, fixedToElementRect.bottom);
+    const left = Math.min(fixedElementRect.left, fixedToElementRect.left);
+    return bottom >= 0 && top <= vh && right >= 0 && left <= vw;
+}
+
+//# sourceMappingURL=utils.js.map

package/dist/positioning/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/positioning/utils.ts"],"sourcesContent":["import type { PositionAnchor } from \"./types.js\";\n\n/** @internal */\nexport interface XCoordConfig {\n  xMargin: number;\n  elWidth: number;\n  initialX?: number;\n  containerRect: DOMRect;\n}\n\n/** @internal */\nexport interface YCoordConfig {\n  yMargin: number;\n  elHeight: number;\n  initialY?: number;\n  containerRect: DOMRect;\n}\n\ntype Left = number;\ntype Top = number;\n\n/**\n * Creates the `left` style value for an element that should be fixed to the\n * (outer) left of the container element. So the right bounds of the fixed\n * element will be equal to the left bounds of the container element (before the\n * xMargin is applied).\n *\n * @internal\n */\nexport function getLeftCoord({\n  xMargin,\n  elWidth,\n  initialX,\n  containerRect,\n}: XCoordConfig): Left {\n  return (initialX ?? containerRect.left) - elWidth - xMargin;\n}\n\n/**\n * Creates the `left` style value for an element that should be fixed to the\n * inner-left of the container element. So the left bounds of both the container\n * and fixed elements will overlap (before the xMargin is applied)\n *\n * @internal\n */\nexport function getInnerLeftCoord({\n  xMargin,\n  initialX,\n  containerRect,\n}: XCoordConfig): Left {\n  return (initialX ?? containerRect.left) + xMargin;\n}\n\n/**\n * Creates the `left` style value for an element that should be fixed to the\n * center of the container element. So the center point of the fixed element\n * should be the center point of the container element.\n *\n * Note: Unlike all the other horizontal positioning logic, the center position\n * does not use the xMargin.\n *\n * @internal\n */\nexport function getCenterXCoord({\n  elWidth,\n  initialX,\n  containerRect,\n}: XCoordConfig): Left {\n  const containerCenter = containerRect.width / 2;\n  const elementCenter = elWidth / 2;\n  return (initialX ?? containerRect.left + containerCenter) - elementCenter;\n}\n\n/**\n * Creates the `left` style value for an element that should be fixed to the\n * inner-right of the container element. So the right bounds for both the\n * container and fixed elements will overlap (before the xMargin is applied).\n *\n * @internal\n */\nexport function getInnerRightCoord({\n  xMargin,\n  elWidth,\n  initialX,\n  containerRect,\n}: XCoordConfig): Left {\n  return (\n    (initialX ?? containerRect.left + containerRect.width) - elWidth - xMargin\n  );\n}\n\n/**\n * Creates the `left` style value for an element that should be fixed to the\n * (outer) right of the container element. So the left bounds of the fixed\n * element will overlap with the right bounds of the container element (before\n * the xMargin is applied).\n *\n * @internal\n */\nexport function getRightCoord({\n  xMargin,\n  initialX,\n  containerRect,\n}: XCoordConfig): Left {\n  return (initialX ?? containerRect.left + containerRect.width) + xMargin;\n}\n\n/**\n * Creates the `top` style value for an element that should be fixed above the\n * container element. So the bottom bounds of the fixed element will overlap\n * with the top bounds of the container element (before the yMargin is applied).\n *\n * @internal\n */\nexport function getAboveCoord({\n  yMargin,\n  initialY,\n  elHeight,\n  containerRect,\n}: YCoordConfig): Top {\n  return (initialY ?? containerRect.top) - elHeight - yMargin;\n}\n\n/**\n * Creates the `top` style value for an element that should be fixed to the top\n * of the container element. So the top bounds for both the container and fixed\n * elements will overlap (before the yMargin is applied).\n *\n * @internal\n */\nexport function getTopCoord({\n  yMargin,\n  initialY,\n  containerRect,\n}: YCoordConfig): Top {\n  return (initialY ?? containerRect.top) + yMargin;\n}\n\n/**\n * Creates the `top` style value for an element that should be fixed vertically\n * centered relative to the container element. So the vertical center point for\n * the fixed element should overlap the vertical center point of the container\n * element.\n *\n * Note: Unlike all the other vertical positioning logic, the center position\n * does not use the yMargin.\n *\n * @internal\n */\nexport function getCenterYCoord({\n  yMargin,\n  elHeight,\n  initialY,\n  containerRect,\n}: YCoordConfig): Top {\n  const containerCenter = containerRect.height / 2;\n  const elementCenter = elHeight / 2;\n  return (\n    (initialY ?? containerRect.top + containerCenter + yMargin) - elementCenter\n  );\n}\n\n/**\n * Creates the `top` style value for an element that should be fixed to the\n * bottom of the container element. So the top bounds of the fixed element\n * should overlap the bottom bounds of the container element (before the yMargin\n * is applied).\n *\n * @internal\n */\nexport function getBottomCoord({\n  yMargin,\n  initialY,\n  elHeight,\n  containerRect,\n}: YCoordConfig): Top {\n  return (\n    (initialY ?? containerRect.top + containerRect.height) - elHeight - yMargin\n  );\n}\n\n/**\n * Creates the `top` style value for an element that should be fixed to the\n * bottom of the container element. So the bottom bounds of both the container\n * and fixed elements should overlap (before the yMargin is applied).\n *\n * @internal\n */\nexport function getBelowCoord({\n  yMargin,\n  initialY,\n  containerRect,\n}: YCoordConfig): Top {\n  return (initialY ?? containerRect.top + containerRect.height) + yMargin;\n}\n\n/**\n * @remarks \\@since 6.0.0\n * @internal\n */\nexport interface TransformOriginOptions extends PositionAnchor {\n  transformOriginY?: number;\n}\n\n/**\n * This is a simple util that'll generate a css `transform-origin` string so\n * that the fixed element can animate from the correct point based on the\n * provided anchor.\n *\n * @param options - The anchor that should be used to create the transform origin\n * for.\n * @returns the transform origin string\n * @internal\n */\nexport function getTransformOrigin(options: TransformOriginOptions): string {\n  const { transformOriginY: yPosition } = options;\n\n  let x = \"0\";\n  switch (options.x) {\n    case \"right\":\n    case \"inner-left\":\n      x = \"0\";\n      break;\n    case \"center\":\n      x = \"50%\";\n      break;\n    case \"left\":\n    case \"inner-right\":\n      x = \"100%\";\n      break;\n    default:\n      x = \"0\";\n  }\n\n  let y = \"0\";\n  if (typeof yPosition === \"number\") {\n    y = `${yPosition}px`;\n  } else {\n    switch (options.y) {\n      case \"above\":\n      case \"bottom\":\n        y = \"100%\";\n        break;\n      case \"center\":\n        y = \"50%\";\n        break;\n      case \"below\":\n      case \"top\":\n        y = \"0\";\n        break;\n      default:\n        y = \"0\";\n    }\n  }\n\n  return `${x} ${y}`;\n}\n\n/**\n * Attempts to find a sizing container based on the provided HTMLElement. By\n * default, the sizing element will just be the provided element unless:\n * - the item has a known role within react-md that can target known classes\n * - the item has a `data-sizing-selector` attribute that is a valid query\n *   selector for the nested item.\n *\n * NOTE: The `data-sizing-selector` will be run from the current element instead\n * of the `document`.\n *\n * @param el - The element to find a sizing container for.\n * @returns the sizing container relative to the provided element, or `null` if\n * none could be found.\n * @throws This error will be thrown if using the `data-query-selector` and the\n * query selector does not return an element on the page.\n * @internal\n */\nexport function findSizingContainer(\n  el: HTMLElement | null\n): HTMLElement | null {\n  if (!el) {\n    return null;\n  }\n\n  if (/(tree|list)item/.test(el.getAttribute(\"role\") || \"\")) {\n    const content = el.querySelector(\n      \".rmd-tree-item__content, .rmd-item-text\"\n    ) as HTMLElement;\n    if (content) {\n      return content;\n    }\n  } else if (el.getAttribute(\"type\") === \"file\") {\n    const label = document.querySelector<HTMLLabelElement>(`[for=\"${el.id}\"]`);\n    if (label) {\n      return label;\n    }\n  }\n\n  const data = el.getAttribute(\"data-sizing-selector\");\n  if (data) {\n    const content = el.querySelector(data) as HTMLElement;\n    if (content) {\n      return content;\n    }\n\n    if (process.env.NODE_ENV !== \"production\") {\n      throw new Error(\n        \"Unable to find a child element using the `data-sizing-selector`\"\n      );\n    }\n  }\n\n  return el;\n}\n\n/**\n * This util is used to get the \"true\" `element.getBoundingClientRect()` that\n * ensures that transitions using transforms don't mess up the sizing so that\n * position calculations are easier to do.\n *\n * @param element - The element to get a rect for.\n * @returns either a DOMRect for the element\n * @internal\n */\nexport function getElementRect(element: HTMLElement): DOMRect {\n  const cloned = element.cloneNode(true) as HTMLElement;\n  // remove the id so there won't be two elements with the same id on the page\n  cloned.removeAttribute(\"id\");\n\n  // remove the role just in case the role would alert screen readers once added\n  // to the dom\n  cloned.removeAttribute(\"role\");\n\n  // ensure the cloned node won't shift the page or be visible\n  cloned.style.position = \"fixed\";\n  cloned.style.visibility = \"hidden\";\n\n  // reset positioning to get a \"pure\" calculation. otherwise this will mess up\n  // the height and width if the element is able to line wrap.\n  cloned.style.left = \"\";\n  cloned.style.top = \"\";\n  cloned.style.right = \"\";\n  cloned.style.bottom = \"\";\n\n  // reset transforms so that custom animations don't mess with the sizing\n  cloned.style.transform = \"none\";\n\n  const parent = element.parentElement || document.body;\n  parent.appendChild(cloned);\n\n  const rect = cloned.getBoundingClientRect();\n  parent.removeChild(cloned);\n\n  return rect;\n}\n\n/**\n * @remarks \\@since 4.0.0\n * @internal\n */\ninterface IsWithinViewportOptions {\n  fixedElement: HTMLElement;\n  fixedToElement: HTMLElement;\n}\n\n/**\n * @remarks \\@since 4.0.0\n * @internal\n */\nexport function isWithinViewport(options: IsWithinViewportOptions): boolean {\n  const { fixedElement, fixedToElement } = options;\n  const fixedElementRect = fixedElement.getBoundingClientRect();\n  const fixedToElementRect = fixedToElement.getBoundingClientRect();\n  const vh = window.innerHeight;\n  const vw = window.innerWidth;\n  const top = Math.min(fixedElementRect.top, fixedToElementRect.top);\n  const right = Math.max(fixedElementRect.right, fixedToElementRect.right);\n  const bottom = Math.max(fixedElementRect.bottom, fixedToElementRect.bottom);\n  const left = Math.min(fixedElementRect.left, fixedToElementRect.left);\n\n  return bottom >= 0 && top <= vh && right >= 0 && left <= vw;\n}\n"],"names":["getLeftCoord","xMargin","elWidth","initialX","containerRect","left","getInnerLeftCoord","getCenterXCoord","containerCenter","width","elementCenter","getInnerRightCoord","getRightCoord","getAboveCoord","yMargin","initialY","elHeight","top","getTopCoord","getCenterYCoord","height","getBottomCoord","getBelowCoord","getTransformOrigin","options","transformOriginY","yPosition","x","y","findSizingContainer","el","test","getAttribute","content","querySelector","label","document","id","data","process","env","NODE_ENV","Error","getElementRect","element","cloned","cloneNode","removeAttribute","style","position","visibility","right","bottom","transform","parent","parentElement","body","appendChild","rect","getBoundingClientRect","removeChild","isWithinViewport","fixedElement","fixedToElement","fixedElementRect","fixedToElementRect","vh","window","innerHeight","vw","innerWidth","Math","min","max"],"mappings":"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"}

package/dist/progress/CircularProgress.d.ts

@@ -0,0 +1,121 @@
+import { type CSSProperties, type HTMLAttributes } from "react";
+import { type ProgressProps } from "./types.js";
+/**
+ * @remarks \@since 6.0.0
+ * Removed the `determinateRotateDegrees` prop since the determinate state no
+ * longer rotates while increasing value.
+ * Added the `disableShrink` prop.
+ * Renamed the `small` prop to `dense` to match other components.
+ */
+export interface CircularProgressProps extends Omit<HTMLAttributes<HTMLSpanElement>, "id">, ProgressProps {
+    /**
+     * An optional style to apply to the svg within the circular progress. The
+     * values of this style object will be merged with the current determinate
+     * style (if it exists).
+     */
+    svgStyle?: CSSProperties;
+    /**
+     * An optional className to apply to the svg within the circular progress.
+     */
+    svgClassName?: string;
+    /**
+     * An optional style to apply to the circle within the circular progress. The
+     * values of this style object will be merged with the current determinate
+     * style (if it exists).
+     */
+    circleStyle?: CSSProperties;
+    /**
+     * An optional className to apply to the circle within the circular progress.
+     */
+    circleClassName?: string;
+    /**
+     * The radius for the circle. It is generally recommended to have the radius
+     * be 1/2 of the viewbox and minus a few more pixels so that there is some
+     * surrounding padding. You probably shouldn't really be changing this prop
+     * though.
+     *
+     * @defaultValue `30`
+     */
+    radius?: number;
+    /**
+     * The center point for the circle. This should be half of the `viewBox` prop
+     * 99% of the time and probably won't be changed.
+     *
+     * @defaultValue `33`
+     */
+    center?: number;
+    /**
+     * The viewbox for the child svg. I wouldn't recommend changing this value as
+     * you will also need to update the `dashoffset` in both Sass and this prop to
+     * get the animation to look nice again.
+     *
+     * @defaultValue `0 0 66 66`
+     */
+    viewBox?: string;
+    /**
+     * The `stroke-dashoffset` for the circle within the SVG. You probably won't
+     * be changing this value that much as it should match the
+     * `$rmd-progress-circle-dashoffset` Sass variable. This is really just used
+     * to help to create the determinate progress animation.
+     *
+     * @defaultValue `187`
+     */
+    dashoffset?: number;
+    /**
+     * Boolean if the circular progress should be centered using left and right
+     * margins.
+     *
+     * @defaultValue `false`
+     */
+    disableCentered?: boolean;
+    /**
+     * Set to `true` to render as a smaller size.
+     *
+     * @defaultValue `false`
+     * @remarks
+     * \@since 2.3.0
+     * \@since 6.0.0 Renamed from `small`
+     */
+    dense?: boolean;
+    /**
+     * Set this to `true` to update the indeterminate behavior to only rotate
+     * which will increase performance during CPU-intensive tasks or when many
+     * loading spinners are displayed at once on the page.
+     *
+     * @defaultValue `false`
+     * @remarks \@since 6.0.0
+     */
+    disableShrink?: boolean;
+}
+/**
+ * **Server Component**
+ *
+ * @example
+ * Indeterminate Example
+ * ```tsx
+ * import { CircularProgress } from "@react-md/core":
+ * import { type ReactElement } from "react";
+ *
+ * function Example(): ReactElement {
+ *   return <CircularProgress />;
+ * }
+ * ```
+ *
+ * @example
+ * Determinate Example
+ * ```tsx
+ * import { CircularProgress } from "@react-md/core":
+ * import { useState, type ReactElement } from "react";
+ *
+ * function Example(): ReactElement {
+ *   // a number from 0 - 100
+ *   const [progress, setProgress] = useState(0);
+ *
+ *   return <CircularProgress value={progress} />;
+ * }
+ * ```
+ *
+ * @remarks \@since 6.0.0 Updated the determinate circular progress to no longer
+ * rotate while increasing the value.
+ */
+export declare const CircularProgress: import("react").ForwardRefExoticComponent<CircularProgressProps & import("react").RefAttributes<HTMLSpanElement>>;

package/dist/progress/CircularProgress.js

@@ -0,0 +1,104 @@
+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-circular-progress");
+/**
+ * **Server Component**
+ *
+ * @example
+ * Indeterminate Example
+ * ```tsx
+ * import { CircularProgress } from "@react-md/core":
+ * import { type ReactElement } from "react";
+ *
+ * function Example(): ReactElement {
+ *   return <CircularProgress />;
+ * }
+ * ```
+ *
+ * @example
+ * Determinate Example
+ * ```tsx
+ * import { CircularProgress } from "@react-md/core":
+ * import { useState, type ReactElement } from "react";
+ *
+ * function Example(): ReactElement {
+ *   // a number from 0 - 100
+ *   const [progress, setProgress] = useState(0);
+ *
+ *   return <CircularProgress value={progress} />;
+ * }
+ * ```
+ *
+ * @remarks \@since 6.0.0 Updated the determinate circular progress to no longer
+ * rotate while increasing the value.
+ */ export const CircularProgress = /*#__PURE__*/ forwardRef(function CircularProgress(props, ref) {
+    const { id: propId, className, svgStyle, svgClassName, circleStyle: propCircleStyle, circleClassName, value, min = 0, max = 100, radius = 30, center = 33, viewBox = "0 0 66 66", theme = "primary", dense = false, dashoffset = 187, disableShrink = false, disableCentered = false, disableTransition = false, ...remaining } = props;
+    const id = useEnsuredId(propId, "circular-progress");
+    let progress;
+    if (typeof value === "number") {
+        progress = getPercentage({
+            min,
+            max,
+            value,
+            validate: true
+        });
+    }
+    const circleStyle = useMemo(()=>{
+        if (typeof progress !== "number") {
+            return propCircleStyle;
+        }
+        return {
+            ...propCircleStyle,
+            strokeDashoffset: dashoffset - dashoffset * progress
+        };
+    }, [
+        progress,
+        propCircleStyle,
+        dashoffset
+    ]);
+    const determinate = typeof progress === "number";
+    const indeterminate = !determinate;
+    return /*#__PURE__*/ _jsx("span", {
+        ...remaining,
+        id: id,
+        ref: ref,
+        role: "progressbar",
+        "aria-valuemin": min,
+        "aria-valuemax": max,
+        "aria-valuenow": value,
+        className: cnb(styles({
+            dense,
+            centered: !disableCentered
+        }), theme !== "current-color" && cssUtils({
+            textColor: theme
+        }), className),
+        children: /*#__PURE__*/ _jsx("svg", {
+            style: svgStyle,
+            className: cnb(styles("svg", {
+                determinate,
+                indeterminate: indeterminate && !disableShrink,
+                "rotate-only": indeterminate && disableShrink
+            }), svgClassName),
+            viewBox: viewBox,
+            children: /*#__PURE__*/ _jsx("circle", {
+                style: circleStyle,
+                className: cnb(styles("circle", {
+                    animate: !disableTransition && determinate,
+                    determinate,
+                    indeterminate: indeterminate && !disableShrink,
+                    "rotate-only": indeterminate && disableShrink
+                }), circleClassName),
+                r: radius,
+                cx: center,
+                cy: center
+            })
+        })
+    });
+});
+
+//# sourceMappingURL=CircularProgress.js.map

package/dist/progress/CircularProgress.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/progress/CircularProgress.tsx"],"sourcesContent":["import { cnb } from \"cnbuilder\";\nimport {\n  forwardRef,\n  useMemo,\n  type CSSProperties,\n  type HTMLAttributes,\n} from \"react\";\nimport { cssUtils } from \"../cssUtils.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 * @remarks \\@since 6.0.0\n * Removed the `determinateRotateDegrees` prop since the determinate state no\n * longer rotates while increasing value.\n * Added the `disableShrink` prop.\n * Renamed the `small` prop to `dense` to match other components.\n */\nexport interface CircularProgressProps\n  extends Omit<HTMLAttributes<HTMLSpanElement>, \"id\">,\n    ProgressProps {\n  /**\n   * An optional style to apply to the svg within the circular progress. The\n   * values of this style object will be merged with the current determinate\n   * style (if it exists).\n   */\n  svgStyle?: CSSProperties;\n\n  /**\n   * An optional className to apply to the svg within the circular progress.\n   */\n  svgClassName?: string;\n\n  /**\n   * An optional style to apply to the circle within the circular progress. The\n   * values of this style object will be merged with the current determinate\n   * style (if it exists).\n   */\n  circleStyle?: CSSProperties;\n\n  /**\n   * An optional className to apply to the circle within the circular progress.\n   */\n  circleClassName?: string;\n\n  /**\n   * The radius for the circle. It is generally recommended to have the radius\n   * be 1/2 of the viewbox and minus a few more pixels so that there is some\n   * surrounding padding. You probably shouldn't really be changing this prop\n   * though.\n   *\n   * @defaultValue `30`\n   */\n  radius?: number;\n\n  /**\n   * The center point for the circle. This should be half of the `viewBox` prop\n   * 99% of the time and probably won't be changed.\n   *\n   * @defaultValue `33`\n   */\n  center?: number;\n\n  /**\n   * The viewbox for the child svg. I wouldn't recommend changing this value as\n   * you will also need to update the `dashoffset` in both Sass and this prop to\n   * get the animation to look nice again.\n   *\n   * @defaultValue `0 0 66 66`\n   */\n  viewBox?: string;\n\n  /**\n   * The `stroke-dashoffset` for the circle within the SVG. You probably won't\n   * be changing this value that much as it should match the\n   * `$rmd-progress-circle-dashoffset` Sass variable. This is really just used\n   * to help to create the determinate progress animation.\n   *\n   * @defaultValue `187`\n   */\n  dashoffset?: number;\n\n  /**\n   * Boolean if the circular progress should be centered using left and right\n   * margins.\n   *\n   * @defaultValue `false`\n   */\n  disableCentered?: boolean;\n\n  /**\n   * Set to `true` to render as a smaller size.\n   *\n   * @defaultValue `false`\n   * @remarks\n   * \\@since 2.3.0\n   * \\@since 6.0.0 Renamed from `small`\n   */\n  dense?: boolean;\n\n  /**\n   * Set this to `true` to update the indeterminate behavior to only rotate\n   * which will increase performance during CPU-intensive tasks or when many\n   * loading spinners are displayed at once on the page.\n   *\n   * @defaultValue `false`\n   * @remarks \\@since 6.0.0\n   */\n  disableShrink?: boolean;\n}\n\nconst styles = bem(\"rmd-circular-progress\");\n\n/**\n * **Server Component**\n *\n * @example\n * Indeterminate Example\n * ```tsx\n * import { CircularProgress } from \"@react-md/core\":\n * import { type ReactElement } from \"react\";\n *\n * function Example(): ReactElement {\n *   return <CircularProgress />;\n * }\n * ```\n *\n * @example\n * Determinate Example\n * ```tsx\n * import { CircularProgress } from \"@react-md/core\":\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 <CircularProgress value={progress} />;\n * }\n * ```\n *\n * @remarks \\@since 6.0.0 Updated the determinate circular progress to no longer\n * rotate while increasing the value.\n */\nexport const CircularProgress = forwardRef<\n  HTMLSpanElement,\n  CircularProgressProps\n>(function CircularProgress(props, ref) {\n  const {\n    id: propId,\n    className,\n    svgStyle,\n    svgClassName,\n    circleStyle: propCircleStyle,\n    circleClassName,\n    value,\n    min = 0,\n    max = 100,\n    radius = 30,\n    center = 33,\n    viewBox = \"0 0 66 66\",\n    theme = \"primary\",\n    dense = false,\n    dashoffset = 187,\n    disableShrink = false,\n    disableCentered = false,\n    disableTransition = false,\n    ...remaining\n  } = props;\n\n  const id = useEnsuredId(propId, \"circular-progress\");\n  let progress: number | undefined;\n  if (typeof value === \"number\") {\n    progress = getPercentage({ min, max, value, validate: true });\n  }\n\n  const circleStyle = useMemo(() => {\n    if (typeof progress !== \"number\") {\n      return propCircleStyle;\n    }\n\n    return {\n      ...propCircleStyle,\n      strokeDashoffset: dashoffset - dashoffset * progress,\n    };\n  }, [progress, propCircleStyle, dashoffset]);\n\n  const determinate = typeof progress === \"number\";\n  const indeterminate = !determinate;\n  return (\n    <span\n      {...remaining}\n      id={id}\n      ref={ref}\n      role=\"progressbar\"\n      aria-valuemin={min}\n      aria-valuemax={max}\n      aria-valuenow={value}\n      className={cnb(\n        styles({ dense, centered: !disableCentered }),\n        theme !== \"current-color\" && cssUtils({ textColor: theme }),\n        className\n      )}\n    >\n      <svg\n        style={svgStyle}\n        className={cnb(\n          styles(\"svg\", {\n            determinate,\n            indeterminate: indeterminate && !disableShrink,\n            \"rotate-only\": indeterminate && disableShrink,\n          }),\n          svgClassName\n        )}\n        viewBox={viewBox}\n      >\n        <circle\n          style={circleStyle}\n          className={cnb(\n            styles(\"circle\", {\n              animate: !disableTransition && determinate,\n              determinate,\n              indeterminate: indeterminate && !disableShrink,\n              \"rotate-only\": indeterminate && disableShrink,\n            }),\n            circleClassName\n          )}\n          r={radius}\n          cx={center}\n          cy={center}\n        />\n      </svg>\n    </span>\n  );\n});\n"],"names":["cnb","forwardRef","useMemo","cssUtils","useEnsuredId","bem","getPercentage","styles","CircularProgress","props","ref","id","propId","className","svgStyle","svgClassName","circleStyle","propCircleStyle","circleClassName","value","min","max","radius","center","viewBox","theme","dense","dashoffset","disableShrink","disableCentered","disableTransition","remaining","progress","validate","strokeDashoffset","determinate","indeterminate","span","role","aria-valuemin","aria-valuemax","aria-valuenow","centered","textColor","svg","style","circle","animate","r","cx","cy"],"mappings":";AAAA,SAASA,GAAG,QAAQ,YAAY;AAChC,SACEC,UAAU,EACVC,OAAO,QAGF,QAAQ;AACf,SAASC,QAAQ,QAAQ,iBAAiB;AAC1C,SAASC,YAAY,QAAQ,qBAAqB;AAClD,SAASC,GAAG,QAAQ,kBAAkB;AACtC,SAASC,aAAa,QAAQ,4BAA4B;AAuG1D,MAAMC,SAASF,IAAI;AAEnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BC,GACD,OAAO,MAAMG,iCAAmBP,WAG9B,SAASO,iBAAiBC,KAAK,EAAEC,GAAG;IACpC,MAAM,EACJC,IAAIC,MAAM,EACVC,SAAS,EACTC,QAAQ,EACRC,YAAY,EACZC,aAAaC,eAAe,EAC5BC,eAAe,EACfC,KAAK,EACLC,MAAM,CAAC,EACPC,MAAM,GAAG,EACTC,SAAS,EAAE,EACXC,SAAS,EAAE,EACXC,UAAU,WAAW,EACrBC,QAAQ,SAAS,EACjBC,QAAQ,KAAK,EACbC,aAAa,GAAG,EAChBC,gBAAgB,KAAK,EACrBC,kBAAkB,KAAK,EACvBC,oBAAoB,KAAK,EACzB,GAAGC,WACJ,GAAGtB;IAEJ,MAAME,KAAKP,aAAaQ,QAAQ;IAChC,IAAIoB;IACJ,IAAI,OAAOb,UAAU,UAAU;QAC7Ba,WAAW1B,cAAc;YAAEc;YAAKC;YAAKF;YAAOc,UAAU;QAAK;IAC7D;IAEA,MAAMjB,cAAcd,QAAQ;QAC1B,IAAI,OAAO8B,aAAa,UAAU;YAChC,OAAOf;QACT;QAEA,OAAO;YACL,GAAGA,eAAe;YAClBiB,kBAAkBP,aAAaA,aAAaK;QAC9C;IACF,GAAG;QAACA;QAAUf;QAAiBU;KAAW;IAE1C,MAAMQ,cAAc,OAAOH,aAAa;IACxC,MAAMI,gBAAgB,CAACD;IACvB,qBACE,KAACE;QACE,GAAGN,SAAS;QACbpB,IAAIA;QACJD,KAAKA;QACL4B,MAAK;QACLC,iBAAenB;QACfoB,iBAAenB;QACfoB,iBAAetB;QACfN,WAAWb,IACTO,OAAO;YAAEmB;YAAOgB,UAAU,CAACb;QAAgB,IAC3CJ,UAAU,mBAAmBtB,SAAS;YAAEwC,WAAWlB;QAAM,IACzDZ;kBAGF,cAAA,KAAC+B;YACCC,OAAO/B;YACPD,WAAWb,IACTO,OAAO,OAAO;gBACZ4B;gBACAC,eAAeA,iBAAiB,CAACR;gBACjC,eAAeQ,iBAAiBR;YAClC,IACAb;YAEFS,SAASA;sBAET,cAAA,KAACsB;gBACCD,OAAO7B;gBACPH,WAAWb,IACTO,OAAO,UAAU;oBACfwC,SAAS,CAACjB,qBAAqBK;oBAC/BA;oBACAC,eAAeA,iBAAiB,CAACR;oBACjC,eAAeQ,iBAAiBR;gBAClC,IACAV;gBAEF8B,GAAG1B;gBACH2B,IAAI1B;gBACJ2B,IAAI3B;;;;AAKd,GAAG"}

package/dist/progress/LinearProgress.d.ts

@@ -0,0 +1,74 @@
+import { type CSSProperties, type HTMLAttributes } from "react";
+import { type ProgressProps } from "./types.js";
+/**
+ * @remarks \@since 6.0.0 Added the `theme` prop
+ */
+export interface LinearProgressProps extends Omit<HTMLAttributes<HTMLDivElement>, "id">, ProgressProps {
+    /**
+     * An optional style to apply to the progress bar. This will be merged with
+     * the current width or height tracking the progress when a `value` is also
+     * provided.
+     */
+    barStyle?: CSSProperties;
+    /**
+     * An optional className to apply to the progress bar.
+     */
+    barClassName?: string;
+    /**
+     * 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
+     * language is a rtl language and this prop is enabled, the direction will
+     * still be `left-to-right`.
+     *
+     * @defaultValue `false`
+     */
+    reverse?: boolean;
+    /**
+     * Boolean if the progress should be vertical instead of horizontal.  When
+     * this prop is set, you should also set the `verticalHeight` prop to a height
+     * value you want for your progress bar.
+     *
+     * @defaultValue `false`
+     */
+    vertical?: boolean;
+    /**
+     * Since there isn't really a good way to have "auto height", you'll need to
+     * manually set the progress bar's height with this prop to some pixel value.
+     * If you'd prefer to set the height in Sass/css, set this value to `null`
+     * instead since this value would be passed down as a `height` inline style.
+     *
+     * @defaultValue `240`
+     */
+    verticalHeight?: number | null;
+}
+/**
+ * **Server Component**
+ *
+ * @example
+ * Indeterminate Example
+ * ```tsx
+ * import { LinearProgress } from "@react-md/core";
+ * import { type ReactElement } from "react";
+ *
+ * function Example(): ReactElement {
+ *   return <LinearProgress />;
+ * }
+ * ```
+ *
+ * @example
+ * Determinate Example
+ * ```tsx
+ * import { LinearProgress } from "@react-md/core";
+ * import { useState, type ReactElement } from "react";
+ *
+ * function Example(): ReactElement {
+ *   // a number from 0 - 100
+ *   const [progress, setProgress] = useState(0);
+ *
+ *   return <LinearProgress value={progress} />;
+ * }
+ * ```
+ *
+ * @remarks \@since 6.0.0 Supports rendering as any of the theme colors.
+ */
+export declare const LinearProgress: import("react").ForwardRefExoticComponent<LinearProgressProps & import("react").RefAttributes<HTMLSpanElement>>;