@fabio.caffarello/react-design-system 3.13.0 → 4.0.0

package/dist/granular/ui/primitives/Tooltip/Tooltip.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tooltip.js","sources":["../../../../../src/ui/primitives/Tooltip/Tooltip.tsx"],"sourcesContent":["\"use client\";\n\nimport type {\n  HTMLAttributes,\n  ReactNode,\n  KeyboardEvent,\n  FocusEvent,\n  ReactElement,\n} from \"react\";\nimport {\n  forwardRef,\n  useState,\n  useRef,\n  useEffect,\n  useId,\n  cloneElement,\n  isValidElement,\n} from \"react\";\nimport { getBorderWidthClass } from \"../../tokens/borders\";\nimport { getRadiusClass } from \"../../tokens/radius\";\nimport { getShadowClass } from \"../../tokens/shadows\";\nimport { getSpacingClass } from \"../../tokens/spacing\";\nimport { getTypographySize } from \"../../tokens/typography\";\nimport { getZIndexClass } from \"../../tokens/z-index\";\nimport { cn, cva, mergeRefs } from \"../../utils\";\n\nexport interface TooltipProps extends HTMLAttributes<HTMLDivElement> {\n  content: string;\n  children: ReactNode;\n  position?: \"top\" | \"bottom\" | \"left\" | \"right\";\n  delay?: number;\n  \"aria-label\"?: string;\n  /**\n   * When true, the tooltip wrapper won't interfere with absolute positioning of children.\n   * The wrapper will use `position: static` instead of `position: relative`.\n   */\n  preservePositioning?: boolean;\n}\n\n/**\n * Tooltip Component\n *\n * A tooltip component for displaying additional information on hover.\n * Follows Atomic Design principles as an Atom component.\n *\n * @example\n * ```tsx\n * <Tooltip content=\"This is a tooltip\">\n *   <Button>Hover me</Button>\n * </Tooltip>\n * ```\n */\nconst Tooltip = forwardRef<HTMLDivElement, TooltipProps>(function Tooltip(\n  {\n    content,\n    children,\n    position = \"top\",\n    delay = 200,\n    className = \"\",\n    \"aria-label\": _ariaLabel,\n    preservePositioning = false,\n    ...props\n  },\n  ref,\n) {\n  const [isVisible, setIsVisible] = useState(false);\n  const timeoutIdRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const tooltipRef = useRef<HTMLDivElement>(null);\n  const triggerRef = useRef<HTMLElement | null>(null);\n\n  // Stable per-instance ID for the tooltip popup. useId is SSR-safe and\n  // stable across renders — the previous Math.random() approach generated\n  // a fresh ID on every render, which silently breaks the\n  // aria-describedby <-> tooltip id pairing observed by assistive tech\n  // across re-renders.\n  const tooltipId = `tooltip-${useId()}`;\n\n  const handleMouseEnter = () => {\n    const id = setTimeout(() => {\n      setIsVisible(true);\n    }, delay);\n    timeoutIdRef.current = id;\n  };\n\n  const handleMouseLeave = () => {\n    if (timeoutIdRef.current) {\n      clearTimeout(timeoutIdRef.current);\n      timeoutIdRef.current = null;\n    }\n    setIsVisible(false);\n  };\n\n  const handleFocus = () => {\n    // Show tooltip immediately on focus (no delay for keyboard users)\n    setIsVisible(true);\n  };\n\n  const handleBlur = () => {\n    setIsVisible(false);\n  };\n\n  const handleKeyDown = (e: KeyboardEvent) => {\n    if (e.key === \"Escape\") {\n      setIsVisible(false);\n      triggerRef.current?.blur();\n    }\n  };\n\n  // Cleanup timeout on unmount\n  useEffect(() => {\n    return () => {\n      if (timeoutIdRef.current) {\n        clearTimeout(timeoutIdRef.current);\n        timeoutIdRef.current = null;\n      }\n    };\n  }, []);\n\n  // Close tooltip when clicking outside\n  useEffect(() => {\n    if (!isVisible) return;\n\n    const handleClickOutside = (event: MouseEvent) => {\n      if (\n        tooltipRef.current &&\n        !tooltipRef.current.contains(event.target as Node) &&\n        triggerRef.current &&\n        !triggerRef.current.contains(event.target as Node)\n      ) {\n        setIsVisible(false);\n      }\n    };\n\n    document.addEventListener(\"mousedown\", handleClickOutside);\n    return () => {\n      document.removeEventListener(\"mousedown\", handleClickOutside);\n    };\n  }, [isVisible]);\n\n  // Helper to get arrow border color\n  // Uses complete classes that Tailwind can detect\n  const getArrowBorderColor = (\n    position: \"top\" | \"bottom\" | \"left\" | \"right\",\n  ): string => {\n    // Arrow follows the tooltip body's surface-inverse color so the\n    // triangle's point visually merges into the body.\n    const borderMap: Record<\"top\" | \"bottom\" | \"left\" | \"right\", string> = {\n      top: \"border-t-surface-inverse\",\n      bottom: \"border-b-surface-inverse\",\n      left: \"border-l-surface-inverse\",\n      right: \"border-r-surface-inverse\",\n    };\n    return borderMap[position];\n  };\n\n  // Tooltip variants using CVA\n  const tooltipVariants = cva(\n    cn(\n      \"absolute\",\n      getZIndexClass(\"tooltip\"),\n      getSpacingClass(\"sm\", \"px\"),\n      getSpacingClass(\"xs\", \"py\"),\n      getTypographySize(\"caption\"),\n      \"text-fg-inverse\",\n      \"bg-surface-inverse\",\n      getRadiusClass(\"md\"),\n      getShadowClass(\"lg\"),\n      \"whitespace-nowrap\",\n    ),\n    {\n      variants: {\n        position: {\n          top: cn(\n            \"bottom-full\",\n            \"left-1/2\",\n            \"transform\",\n            \"-translate-x-1/2\",\n            getSpacingClass(\"sm\", \"mb\"),\n          ),\n          bottom: cn(\n            \"top-full\",\n            \"left-1/2\",\n            \"transform\",\n            \"-translate-x-1/2\",\n            getSpacingClass(\"sm\", \"mt\"),\n          ),\n          left: cn(\n            \"right-full\",\n            \"top-1/2\",\n            \"transform\",\n            \"-translate-y-1/2\",\n            getSpacingClass(\"sm\", \"mr\"),\n          ),\n          right: cn(\n            \"left-full\",\n            \"top-1/2\",\n            \"transform\",\n            \"-translate-y-1/2\",\n            getSpacingClass(\"sm\", \"ml\"),\n          ),\n        },\n      },\n      defaultVariants: {\n        position: \"top\",\n      },\n    },\n  );\n\n  const arrowVariants = cva(\n    cn(\n      \"absolute\",\n      \"w-0\",\n      \"h-0\",\n      getBorderWidthClass(\"thick\"),\n      \"border-transparent\",\n    ),\n    {\n      variants: {\n        position: {\n          top: cn(\n            \"top-full\",\n            \"left-1/2\",\n            \"transform\",\n            \"-translate-x-1/2\",\n            getArrowBorderColor(\"top\"),\n          ),\n          bottom: cn(\n            \"bottom-full\",\n            \"left-1/2\",\n            \"transform\",\n            \"-translate-x-1/2\",\n            getArrowBorderColor(\"bottom\"),\n          ),\n          left: cn(\n            \"left-full\",\n            \"top-1/2\",\n            \"transform\",\n            \"-translate-y-1/2\",\n            getArrowBorderColor(\"left\"),\n          ),\n          right: cn(\n            \"right-full\",\n            \"top-1/2\",\n            \"transform\",\n            \"-translate-y-1/2\",\n            getArrowBorderColor(\"right\"),\n          ),\n        },\n      },\n      defaultVariants: {\n        position: \"top\",\n      },\n    },\n  );\n\n  // Clone children to add accessibility props\n  const childrenWithProps = isValidElement(children)\n    ? (() => {\n        const childElement = children as ReactElement<\n          HTMLAttributes<HTMLElement> & { ref?: React.Ref<HTMLElement> }\n        >;\n        const existingProps = childElement.props;\n        const existingRef = existingProps.ref;\n\n        return cloneElement(childElement, {\n          ref: mergeRefs<HTMLElement>(triggerRef, existingRef),\n          \"aria-describedby\": isVisible\n            ? tooltipId\n            : existingProps[\"aria-describedby\"],\n          onMouseEnter: (e: React.MouseEvent<HTMLElement>) => {\n            handleMouseEnter();\n            existingProps.onMouseEnter?.(e);\n          },\n          onMouseLeave: (e: React.MouseEvent<HTMLElement>) => {\n            handleMouseLeave();\n            existingProps.onMouseLeave?.(e);\n          },\n          onFocus: (e: FocusEvent<HTMLElement>) => {\n            handleFocus();\n            existingProps.onFocus?.(e);\n          },\n          onBlur: (e: FocusEvent<HTMLElement>) => {\n            handleBlur();\n            existingProps.onBlur?.(e);\n          },\n          onKeyDown: (e: KeyboardEvent<HTMLElement>) => {\n            handleKeyDown(e);\n            existingProps.onKeyDown?.(e);\n          },\n        } as Partial<typeof existingProps>);\n      })()\n    : children;\n\n  // When preservePositioning is true, use static positioning to avoid interfering\n  // with absolute positioned children. The tooltip will still be positioned correctly\n  // using absolute positioning relative to the viewport/nearest positioned ancestor.\n  const wrapperClassName = preservePositioning\n    ? cn(\"static\", \"inline-block\", className)\n    : cn(\"relative\", \"inline-block\", className);\n\n  return (\n    <div ref={ref} className={wrapperClassName} {...props}>\n      {childrenWithProps}\n      {isVisible && (\n        <div\n          ref={tooltipRef}\n          id={tooltipId}\n          className={cn(tooltipVariants({ position }))}\n          role=\"tooltip\"\n          aria-live=\"polite\"\n        >\n          {content}\n          <div className={cn(arrowVariants({ position }))} aria-hidden=\"true\" />\n        </div>\n      )}\n    </div>\n  );\n});\n\nTooltip.displayName = \"Tooltip\";\n\nexport default Tooltip;\n"],"names":["Tooltip","forwardRef","_a","ref","_b","content","children","position","delay","className","_ariaLabel","preservePositioning","props","__objRest","isVisible","setIsVisible","useState","timeoutIdRef","useRef","tooltipRef","triggerRef","tooltipId","useId","handleMouseEnter","id","handleMouseLeave","handleFocus","handleBlur","handleKeyDown","e","useEffect","handleClickOutside","event","getArrowBorderColor","tooltipVariants","cva","cn","getZIndexClass","getSpacingClass","getTypographySize","getRadiusClass","getShadowClass","arrowVariants","getBorderWidthClass","childrenWithProps","isValidElement","childElement","existingProps","existingRef","cloneElement","mergeRefs","wrapperClassName","__spreadProps","__spreadValues","jsxs","jsx"],"mappings":"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"}
+{"version":3,"file":"Tooltip.js","sources":["../../../../../src/ui/primitives/Tooltip/Tooltip.tsx"],"sourcesContent":["\"use client\";\n\nimport type {\n  HTMLAttributes,\n  ReactNode,\n  KeyboardEvent,\n  FocusEvent,\n  ReactElement,\n} from \"react\";\nimport {\n  forwardRef,\n  useState,\n  useRef,\n  useEffect,\n  useId,\n  cloneElement,\n  isValidElement,\n} from \"react\";\nimport { getBorderWidthClass } from \"../../tokens/borders\";\nimport { getRadiusClass } from \"../../tokens/radius\";\nimport { getShadowClass } from \"../../tokens/shadows\";\nimport { getSpacingClass } from \"../../tokens/spacing\";\nimport { getTypographySize } from \"../../tokens/typography\";\nimport { getZIndexClass } from \"../../tokens/z-index\";\nimport { cn, cva, mergeRefs } from \"../../utils\";\n\nexport interface TooltipProps extends HTMLAttributes<HTMLDivElement> {\n  content: string;\n  children: ReactNode;\n  position?: \"top\" | \"bottom\" | \"left\" | \"right\";\n  delay?: number;\n  \"aria-label\"?: string;\n  /**\n   * When true, the tooltip wrapper won't interfere with absolute positioning of children.\n   * The wrapper will use `position: static` instead of `position: relative`.\n   */\n  preservePositioning?: boolean;\n}\n\n/**\n * Tooltip Component\n *\n * A tooltip component for displaying additional information on hover.\n *\n * @example\n * ```tsx\n * <Tooltip content=\"This is a tooltip\">\n *   <Button>Hover me</Button>\n * </Tooltip>\n * ```\n */\nconst Tooltip = forwardRef<HTMLDivElement, TooltipProps>(function Tooltip(\n  {\n    content,\n    children,\n    position = \"top\",\n    delay = 200,\n    className = \"\",\n    \"aria-label\": _ariaLabel,\n    preservePositioning = false,\n    ...props\n  },\n  ref,\n) {\n  const [isVisible, setIsVisible] = useState(false);\n  const timeoutIdRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const tooltipRef = useRef<HTMLDivElement>(null);\n  const triggerRef = useRef<HTMLElement | null>(null);\n\n  // Stable per-instance ID for the tooltip popup. useId is SSR-safe and\n  // stable across renders — the previous Math.random() approach generated\n  // a fresh ID on every render, which silently breaks the\n  // aria-describedby <-> tooltip id pairing observed by assistive tech\n  // across re-renders.\n  const tooltipId = `tooltip-${useId()}`;\n\n  const handleMouseEnter = () => {\n    const id = setTimeout(() => {\n      setIsVisible(true);\n    }, delay);\n    timeoutIdRef.current = id;\n  };\n\n  const handleMouseLeave = () => {\n    if (timeoutIdRef.current) {\n      clearTimeout(timeoutIdRef.current);\n      timeoutIdRef.current = null;\n    }\n    setIsVisible(false);\n  };\n\n  const handleFocus = () => {\n    // Show tooltip immediately on focus (no delay for keyboard users)\n    setIsVisible(true);\n  };\n\n  const handleBlur = () => {\n    setIsVisible(false);\n  };\n\n  const handleKeyDown = (e: KeyboardEvent) => {\n    if (e.key === \"Escape\") {\n      setIsVisible(false);\n      triggerRef.current?.blur();\n    }\n  };\n\n  // Cleanup timeout on unmount\n  useEffect(() => {\n    return () => {\n      if (timeoutIdRef.current) {\n        clearTimeout(timeoutIdRef.current);\n        timeoutIdRef.current = null;\n      }\n    };\n  }, []);\n\n  // Close tooltip when clicking outside\n  useEffect(() => {\n    if (!isVisible) return;\n\n    const handleClickOutside = (event: MouseEvent) => {\n      if (\n        tooltipRef.current &&\n        !tooltipRef.current.contains(event.target as Node) &&\n        triggerRef.current &&\n        !triggerRef.current.contains(event.target as Node)\n      ) {\n        setIsVisible(false);\n      }\n    };\n\n    document.addEventListener(\"mousedown\", handleClickOutside);\n    return () => {\n      document.removeEventListener(\"mousedown\", handleClickOutside);\n    };\n  }, [isVisible]);\n\n  // Helper to get arrow border color\n  // Uses complete classes that Tailwind can detect\n  const getArrowBorderColor = (\n    position: \"top\" | \"bottom\" | \"left\" | \"right\",\n  ): string => {\n    // Arrow follows the tooltip body's surface-inverse color so the\n    // triangle's point visually merges into the body.\n    const borderMap: Record<\"top\" | \"bottom\" | \"left\" | \"right\", string> = {\n      top: \"border-t-surface-inverse\",\n      bottom: \"border-b-surface-inverse\",\n      left: \"border-l-surface-inverse\",\n      right: \"border-r-surface-inverse\",\n    };\n    return borderMap[position];\n  };\n\n  // Tooltip variants using CVA\n  const tooltipVariants = cva(\n    cn(\n      \"absolute\",\n      getZIndexClass(\"tooltip\"),\n      getSpacingClass(\"sm\", \"px\"),\n      getSpacingClass(\"xs\", \"py\"),\n      getTypographySize(\"caption\"),\n      \"text-fg-inverse\",\n      \"bg-surface-inverse\",\n      getRadiusClass(\"md\"),\n      getShadowClass(\"lg\"),\n      \"whitespace-nowrap\",\n    ),\n    {\n      variants: {\n        position: {\n          top: cn(\n            \"bottom-full\",\n            \"left-1/2\",\n            \"transform\",\n            \"-translate-x-1/2\",\n            getSpacingClass(\"sm\", \"mb\"),\n          ),\n          bottom: cn(\n            \"top-full\",\n            \"left-1/2\",\n            \"transform\",\n            \"-translate-x-1/2\",\n            getSpacingClass(\"sm\", \"mt\"),\n          ),\n          left: cn(\n            \"right-full\",\n            \"top-1/2\",\n            \"transform\",\n            \"-translate-y-1/2\",\n            getSpacingClass(\"sm\", \"mr\"),\n          ),\n          right: cn(\n            \"left-full\",\n            \"top-1/2\",\n            \"transform\",\n            \"-translate-y-1/2\",\n            getSpacingClass(\"sm\", \"ml\"),\n          ),\n        },\n      },\n      defaultVariants: {\n        position: \"top\",\n      },\n    },\n  );\n\n  const arrowVariants = cva(\n    cn(\n      \"absolute\",\n      \"w-0\",\n      \"h-0\",\n      getBorderWidthClass(\"thick\"),\n      \"border-transparent\",\n    ),\n    {\n      variants: {\n        position: {\n          top: cn(\n            \"top-full\",\n            \"left-1/2\",\n            \"transform\",\n            \"-translate-x-1/2\",\n            getArrowBorderColor(\"top\"),\n          ),\n          bottom: cn(\n            \"bottom-full\",\n            \"left-1/2\",\n            \"transform\",\n            \"-translate-x-1/2\",\n            getArrowBorderColor(\"bottom\"),\n          ),\n          left: cn(\n            \"left-full\",\n            \"top-1/2\",\n            \"transform\",\n            \"-translate-y-1/2\",\n            getArrowBorderColor(\"left\"),\n          ),\n          right: cn(\n            \"right-full\",\n            \"top-1/2\",\n            \"transform\",\n            \"-translate-y-1/2\",\n            getArrowBorderColor(\"right\"),\n          ),\n        },\n      },\n      defaultVariants: {\n        position: \"top\",\n      },\n    },\n  );\n\n  // Clone children to add accessibility props\n  const childrenWithProps = isValidElement(children)\n    ? (() => {\n        const childElement = children as ReactElement<\n          HTMLAttributes<HTMLElement> & { ref?: React.Ref<HTMLElement> }\n        >;\n        const existingProps = childElement.props;\n        const existingRef = existingProps.ref;\n\n        return cloneElement(childElement, {\n          ref: mergeRefs<HTMLElement>(triggerRef, existingRef),\n          \"aria-describedby\": isVisible\n            ? tooltipId\n            : existingProps[\"aria-describedby\"],\n          onMouseEnter: (e: React.MouseEvent<HTMLElement>) => {\n            handleMouseEnter();\n            existingProps.onMouseEnter?.(e);\n          },\n          onMouseLeave: (e: React.MouseEvent<HTMLElement>) => {\n            handleMouseLeave();\n            existingProps.onMouseLeave?.(e);\n          },\n          onFocus: (e: FocusEvent<HTMLElement>) => {\n            handleFocus();\n            existingProps.onFocus?.(e);\n          },\n          onBlur: (e: FocusEvent<HTMLElement>) => {\n            handleBlur();\n            existingProps.onBlur?.(e);\n          },\n          onKeyDown: (e: KeyboardEvent<HTMLElement>) => {\n            handleKeyDown(e);\n            existingProps.onKeyDown?.(e);\n          },\n        } as Partial<typeof existingProps>);\n      })()\n    : children;\n\n  // When preservePositioning is true, use static positioning to avoid interfering\n  // with absolute positioned children. The tooltip will still be positioned correctly\n  // using absolute positioning relative to the viewport/nearest positioned ancestor.\n  const wrapperClassName = preservePositioning\n    ? cn(\"static\", \"inline-block\", className)\n    : cn(\"relative\", \"inline-block\", className);\n\n  return (\n    <div ref={ref} className={wrapperClassName} {...props}>\n      {childrenWithProps}\n      {isVisible && (\n        <div\n          ref={tooltipRef}\n          id={tooltipId}\n          className={cn(tooltipVariants({ position }))}\n          role=\"tooltip\"\n          aria-live=\"polite\"\n        >\n          {content}\n          <div className={cn(arrowVariants({ position }))} aria-hidden=\"true\" />\n        </div>\n      )}\n    </div>\n  );\n});\n\nTooltip.displayName = \"Tooltip\";\n\nexport default Tooltip;\n"],"names":["Tooltip","forwardRef","_a","ref","_b","content","children","position","delay","className","_ariaLabel","preservePositioning","props","__objRest","isVisible","setIsVisible","useState","timeoutIdRef","useRef","tooltipRef","triggerRef","tooltipId","useId","handleMouseEnter","id","handleMouseLeave","handleFocus","handleBlur","handleKeyDown","e","useEffect","handleClickOutside","event","getArrowBorderColor","tooltipVariants","cva","cn","getZIndexClass","getSpacingClass","getTypographySize","getRadiusClass","getShadowClass","arrowVariants","getBorderWidthClass","childrenWithProps","isValidElement","childElement","existingProps","existingRef","cloneElement","mergeRefs","wrapperClassName","__spreadProps","__spreadValues","jsxs","jsx"],"mappings":"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"}

package/dist/granular/ui/providers/DialogContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"DialogContext.js","sources":["../../../../src/ui/providers/DialogContext.tsx"],"sourcesContent":["\"use client\";\n\nimport { createContext, useContext } from \"react\";\n\nexport interface DialogContextValue {\n  isOpen: boolean;\n  onOpenChange: (open: boolean) => void;\n  onClose: () => void;\n  titleId?: string;\n  descriptionId?: string;\n}\n\nexport const DialogContext = createContext<DialogContextValue | undefined>(\n  undefined,\n);\n\nexport function useDialogContext(): DialogContextValue {\n  const context = useContext(DialogContext);\n  if (!context) {\n    throw new Error(\"Dialog components must be used within a Dialog component\");\n  }\n  return context;\n}\n\nexport function useDialogContextOptional(): DialogContextValue | undefined {\n  return useContext(DialogContext);\n}\n"],"names":["DialogContext","createContext","useDialogContext","context","useContext","useDialogContextOptional"],"mappings":";;AAYO,MAAMA,IAAgBC;AAAA,EAC3B;AACF;AAEO,SAASC,IAAuC;AACrD,QAAMC,IAAUC,EAAWJ,CAAa;AACxC,MAAI,CAACG;AACH,UAAM,IAAI,MAAM,0DAA0D;AAE5E,SAAOA;AACT;AAEO,SAASE,IAA2D;AACzE,SAAOD,EAAWJ,CAAa;AACjC;"}
+{"version":3,"file":"DialogContext.js","sources":["../../../../src/ui/providers/DialogContext.tsx"],"sourcesContent":["\"use client\";\n\nimport { createContext, useContext } from \"react\";\n\nexport interface DialogContextValue {\n  isOpen: boolean;\n  onOpenChange: (open: boolean) => void;\n  onClose: () => void;\n  titleId?: string;\n  descriptionId?: string;\n  /** True while at least one Dialog.Title is mounted. */\n  hasTitle: boolean;\n  /** True while at least one Dialog.Description is mounted. */\n  hasDescription: boolean;\n  /** Register a mounted Title; returns an unregister cleanup. */\n  registerTitle: () => () => void;\n  /** Register a mounted Description; returns an unregister cleanup. */\n  registerDescription: () => () => void;\n}\n\nexport const DialogContext = createContext<DialogContextValue | undefined>(\n  undefined,\n);\n\nexport function useDialogContext(): DialogContextValue {\n  const context = useContext(DialogContext);\n  if (!context) {\n    throw new Error(\"Dialog components must be used within a Dialog component\");\n  }\n  return context;\n}\n\nexport function useDialogContextOptional(): DialogContextValue | undefined {\n  return useContext(DialogContext);\n}\n"],"names":["DialogContext","createContext","useDialogContext","context","useContext","useDialogContextOptional"],"mappings":";;AAoBO,MAAMA,IAAgBC;AAAA,EAC3B;AACF;AAEO,SAASC,IAAuC;AACrD,QAAMC,IAAUC,EAAWJ,CAAa;AACxC,MAAI,CAACG;AACH,UAAM,IAAI,MAAM,0DAA0D;AAE5E,SAAOA;AACT;AAEO,SAASE,IAA2D;AACzE,SAAOD,EAAWJ,CAAa;AACjC;"}

package/dist/granular/ui/providers/DialogProvider.js

@@ -1,32 +1,36 @@
 "use client";
-import { jsx as n } from "react/jsx-runtime";
-import { useState as v, useEffect as y } from "react";
-import { DialogContext as a } from "./DialogContext.js";
-import { useFocusRestore as p } from "../hooks/useFocusRestore.js";
-function P({
-  children: i,
+import { jsx as C } from "react/jsx-runtime";
+import { useState as r, useCallback as l, useEffect as T } from "react";
+import { DialogContext as w } from "./DialogContext.js";
+import { useFocusRestore as P } from "../hooks/useFocusRestore.js";
+function F({
+  children: u,
   open: e,
-  defaultOpen: l = !1,
-  onOpenChange: t,
-  titleId: f,
-  descriptionId: u
+  defaultOpen: f = !1,
+  onOpenChange: s,
+  titleId: d,
+  descriptionId: m
 }) {
-  const [c, d] = v(l), o = e !== void 0 ? e : c, s = (r) => {
-    e === void 0 && d(r), t == null || t(r);
+  const [a, p] = r(f), [v, i] = r(0), [y, n] = r(0), D = l(() => (i((t) => t + 1), () => i((t) => t - 1)), []), b = l(() => (n((t) => t + 1), () => n((t) => t - 1)), []), o = e !== void 0 ? e : a, c = (t) => {
+    e === void 0 && p(t), s == null || s(t);
   };
-  p(o), y(() => (o ? document.body.style.overflow = "hidden" : document.body.style.overflow = "", () => {
+  P(o), T(() => (o ? document.body.style.overflow = "hidden" : document.body.style.overflow = "", () => {
     document.body.style.overflow = "";
   }), [o]);
-  const m = {
+  const x = {
     isOpen: o,
-    onOpenChange: s,
-    onClose: () => s(!1),
-    titleId: f,
-    descriptionId: u
+    onOpenChange: c,
+    onClose: () => c(!1),
+    titleId: d,
+    descriptionId: m,
+    hasTitle: v > 0,
+    hasDescription: y > 0,
+    registerTitle: D,
+    registerDescription: b
   };
-  return /* @__PURE__ */ n(a.Provider, { value: m, children: i });
+  return /* @__PURE__ */ C(w.Provider, { value: x, children: u });
 }
 export {
-  P as DialogProvider
+  F as DialogProvider
 };
 //# sourceMappingURL=DialogProvider.js.map

package/dist/granular/ui/providers/DialogProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"DialogProvider.js","sources":["../../../../src/ui/providers/DialogProvider.tsx"],"sourcesContent":["\"use client\";\n\nimport { useState, useEffect, type ReactNode } from \"react\";\nimport { DialogContext, type DialogContextValue } from \"./DialogContext\";\nimport { useFocusRestore } from \"../hooks/useFocusRestore\";\n\nexport interface DialogProviderProps {\n  children: ReactNode;\n  open?: boolean;\n  defaultOpen?: boolean;\n  onOpenChange?: (open: boolean) => void;\n  titleId?: string;\n  descriptionId?: string;\n}\n\nexport function DialogProvider({\n  children,\n  open: controlledOpen,\n  defaultOpen = false,\n  onOpenChange,\n  titleId,\n  descriptionId,\n}: DialogProviderProps) {\n  const [uncontrolledOpen, setUncontrolledOpen] = useState(defaultOpen);\n\n  // Use controlled or uncontrolled state\n  const isOpen =\n    controlledOpen !== undefined ? controlledOpen : uncontrolledOpen;\n  const setIsOpen = (newOpen: boolean) => {\n    if (controlledOpen === undefined) {\n      setUncontrolledOpen(newOpen);\n    }\n    onOpenChange?.(newOpen);\n  };\n\n  // Modal focus restore — consumed from the shared hook introduced in\n  // Phase 3 PR 1. Replaces an inline `previousActiveElement` ref +\n  // `setTimeout(0)` block that this hook now owns. Timing identity is\n  // preserved (the hook uses setTimeout(0)), so Dialog.test.tsx's\n  // restore tests do not need to change.\n  useFocusRestore(isOpen);\n\n  // Prevent body scroll when dialog is open\n  useEffect(() => {\n    if (isOpen) {\n      document.body.style.overflow = \"hidden\";\n    } else {\n      document.body.style.overflow = \"\";\n    }\n    return () => {\n      document.body.style.overflow = \"\";\n    };\n  }, [isOpen]);\n\n  const contextValue: DialogContextValue = {\n    isOpen,\n    onOpenChange: setIsOpen,\n    onClose: () => setIsOpen(false),\n    titleId,\n    descriptionId,\n  };\n\n  return (\n    <DialogContext.Provider value={contextValue}>\n      {children}\n    </DialogContext.Provider>\n  );\n}\n"],"names":["DialogProvider","children","controlledOpen","defaultOpen","onOpenChange","titleId","descriptionId","uncontrolledOpen","setUncontrolledOpen","useState","isOpen","setIsOpen","newOpen","useFocusRestore","useEffect","contextValue","DialogContext"],"mappings":";;;;;AAeO,SAASA,EAAe;AAAA,EAC7B,UAAAC;AAAA,EACA,MAAMC;AAAA,EACN,aAAAC,IAAc;AAAA,EACd,cAAAC;AAAA,EACA,SAAAC;AAAA,EACA,eAAAC;AACF,GAAwB;AACtB,QAAM,CAACC,GAAkBC,CAAmB,IAAIC,EAASN,CAAW,GAG9DO,IACJR,MAAmB,SAAYA,IAAiBK,GAC5CI,IAAY,CAACC,MAAqB;AACtC,IAAIV,MAAmB,UACrBM,EAAoBI,CAAO,GAE7BR,KAAA,QAAAA,EAAeQ;AAAA,EACjB;AAOA,EAAAC,EAAgBH,CAAM,GAGtBI,EAAU,OACJJ,IACF,SAAS,KAAK,MAAM,WAAW,WAE/B,SAAS,KAAK,MAAM,WAAW,IAE1B,MAAM;AACX,aAAS,KAAK,MAAM,WAAW;AAAA,EACjC,IACC,CAACA,CAAM,CAAC;AAEX,QAAMK,IAAmC;AAAA,IACvC,QAAAL;AAAA,IACA,cAAcC;AAAA,IACd,SAAS,MAAMA,EAAU,EAAK;AAAA,IAC9B,SAAAN;AAAA,IACA,eAAAC;AAAA,EAAA;AAGF,2BACGU,EAAc,UAAd,EAAuB,OAAOD,GAC5B,UAAAd,GACH;AAEJ;"}
+{"version":3,"file":"DialogProvider.js","sources":["../../../../src/ui/providers/DialogProvider.tsx"],"sourcesContent":["\"use client\";\n\nimport { useState, useEffect, useCallback, type ReactNode } from \"react\";\nimport { DialogContext, type DialogContextValue } from \"./DialogContext\";\nimport { useFocusRestore } from \"../hooks/useFocusRestore\";\n\nexport interface DialogProviderProps {\n  children: ReactNode;\n  open?: boolean;\n  defaultOpen?: boolean;\n  onOpenChange?: (open: boolean) => void;\n  titleId?: string;\n  descriptionId?: string;\n}\n\nexport function DialogProvider({\n  children,\n  open: controlledOpen,\n  defaultOpen = false,\n  onOpenChange,\n  titleId,\n  descriptionId,\n}: DialogProviderProps) {\n  const [uncontrolledOpen, setUncontrolledOpen] = useState(defaultOpen);\n\n  // Presence tracking so DialogContent only emits aria-labelledby /\n  // aria-describedby when a Title / Description is actually mounted.\n  // Without this the dialog always pointed those IDREFs at ids that\n  // only exist when the corresponding subcomponent is rendered — a\n  // dangling reference for every title-only (or bare) dialog.\n  const [titleCount, setTitleCount] = useState(0);\n  const [descriptionCount, setDescriptionCount] = useState(0);\n\n  const registerTitle = useCallback(() => {\n    setTitleCount((c) => c + 1);\n    return () => setTitleCount((c) => c - 1);\n  }, []);\n  const registerDescription = useCallback(() => {\n    setDescriptionCount((c) => c + 1);\n    return () => setDescriptionCount((c) => c - 1);\n  }, []);\n\n  // Use controlled or uncontrolled state\n  const isOpen =\n    controlledOpen !== undefined ? controlledOpen : uncontrolledOpen;\n  const setIsOpen = (newOpen: boolean) => {\n    if (controlledOpen === undefined) {\n      setUncontrolledOpen(newOpen);\n    }\n    onOpenChange?.(newOpen);\n  };\n\n  // Modal focus restore — consumed from the shared hook introduced in\n  // Phase 3 PR 1. Replaces an inline `previousActiveElement` ref +\n  // `setTimeout(0)` block that this hook now owns. Timing identity is\n  // preserved (the hook uses setTimeout(0)), so Dialog.test.tsx's\n  // restore tests do not need to change.\n  useFocusRestore(isOpen);\n\n  // Prevent body scroll when dialog is open\n  useEffect(() => {\n    if (isOpen) {\n      document.body.style.overflow = \"hidden\";\n    } else {\n      document.body.style.overflow = \"\";\n    }\n    return () => {\n      document.body.style.overflow = \"\";\n    };\n  }, [isOpen]);\n\n  const contextValue: DialogContextValue = {\n    isOpen,\n    onOpenChange: setIsOpen,\n    onClose: () => setIsOpen(false),\n    titleId,\n    descriptionId,\n    hasTitle: titleCount > 0,\n    hasDescription: descriptionCount > 0,\n    registerTitle,\n    registerDescription,\n  };\n\n  return (\n    <DialogContext.Provider value={contextValue}>\n      {children}\n    </DialogContext.Provider>\n  );\n}\n"],"names":["DialogProvider","children","controlledOpen","defaultOpen","onOpenChange","titleId","descriptionId","uncontrolledOpen","setUncontrolledOpen","useState","titleCount","setTitleCount","descriptionCount","setDescriptionCount","registerTitle","useCallback","c","registerDescription","isOpen","setIsOpen","newOpen","useFocusRestore","useEffect","contextValue","DialogContext"],"mappings":";;;;;AAeO,SAASA,EAAe;AAAA,EAC7B,UAAAC;AAAA,EACA,MAAMC;AAAA,EACN,aAAAC,IAAc;AAAA,EACd,cAAAC;AAAA,EACA,SAAAC;AAAA,EACA,eAAAC;AACF,GAAwB;AACtB,QAAM,CAACC,GAAkBC,CAAmB,IAAIC,EAASN,CAAW,GAO9D,CAACO,GAAYC,CAAa,IAAIF,EAAS,CAAC,GACxC,CAACG,GAAkBC,CAAmB,IAAIJ,EAAS,CAAC,GAEpDK,IAAgBC,EAAY,OAChCJ,EAAc,CAACK,MAAMA,IAAI,CAAC,GACnB,MAAML,EAAc,CAACK,MAAMA,IAAI,CAAC,IACtC,CAAA,CAAE,GACCC,IAAsBF,EAAY,OACtCF,EAAoB,CAACG,MAAMA,IAAI,CAAC,GACzB,MAAMH,EAAoB,CAACG,MAAMA,IAAI,CAAC,IAC5C,CAAA,CAAE,GAGCE,IACJhB,MAAmB,SAAYA,IAAiBK,GAC5CY,IAAY,CAACC,MAAqB;AACtC,IAAIlB,MAAmB,UACrBM,EAAoBY,CAAO,GAE7BhB,KAAA,QAAAA,EAAegB;AAAA,EACjB;AAOA,EAAAC,EAAgBH,CAAM,GAGtBI,EAAU,OACJJ,IACF,SAAS,KAAK,MAAM,WAAW,WAE/B,SAAS,KAAK,MAAM,WAAW,IAE1B,MAAM;AACX,aAAS,KAAK,MAAM,WAAW;AAAA,EACjC,IACC,CAACA,CAAM,CAAC;AAEX,QAAMK,IAAmC;AAAA,IACvC,QAAAL;AAAA,IACA,cAAcC;AAAA,IACd,SAAS,MAAMA,EAAU,EAAK;AAAA,IAC9B,SAAAd;AAAA,IACA,eAAAC;AAAA,IACA,UAAUI,IAAa;AAAA,IACvB,gBAAgBE,IAAmB;AAAA,IACnC,eAAAE;AAAA,IACA,qBAAAG;AAAA,EAAA;AAGF,2BACGO,EAAc,UAAd,EAAuB,OAAOD,GAC5B,UAAAtB,GACH;AAEJ;"}