@servicetitan/anvil2 2.3.0 → 2.4.0

package/dist/{useInitialFocus-CdoVwSbr.js → useInitialFocus-BRRbylek.js}

@@ -1,6 +1,6 @@
 import { useCallback, useState, useRef, useEffect } from 'react';
 import { u as useOpenCloseTransitionStates } from './useOpenCloseTransitionStates-CiTYrLGi.js';
-import { t as tabbable } from './index.esm-BZV0wNKZ.js';
+import { t as tabbable } from './index.esm-K9kxJhLx.js';
 
 const useDialogTransitionStates = (ref, openProp, options = {}) => {
   const { onOpenAnimationStart, onCloseAnimationComplete } = options;
@@ -187,4 +187,4 @@ const useInitialFocus = (dialogRef, { computeFocus }) => {
 };
 
 export { useDialogTransitionStates as a, useKeyboardFocusables as b, useInitialFocus as c, useDrillDownContextState as u };
-//# sourceMappingURL=useInitialFocus-CdoVwSbr.js.map
+//# sourceMappingURL=useInitialFocus-BRRbylek.js.map

package/dist/{useInitialFocus-CdoVwSbr.js.map → useInitialFocus-BRRbylek.js.map}

@@ -1 +1 @@
-{"version":3,"file":"useInitialFocus-CdoVwSbr.js","sources":["../src/internal/hooks/useDialogTransitionStates/useDialogTransitionStates.ts","../src/internal/hooks/useKeyboardFocusables/useKeyboardFocusables.ts","../src/components/DrillDown/internal/useDrillDownContextState.ts","../src/components/Dialog/internal/useInitialFocus.ts"],"sourcesContent":["import { RefObject, useCallback } from \"react\";\nimport {\n  useOpenCloseTransitionStates,\n  type OpenCloseTransitionStateEffects,\n} from \"../useOpenCloseTransitionStates\";\n\n/**\n * Effects configuration for dialog transition states\n * @property {() => void} [onOpenAnimationStart] - Callback when opening animation starts\n * @property {() => void} [onCloseAnimationStart] - Callback when closing animation starts\n * @property {() => void} [onOpenAnimationComplete] - Callback when opening animation completes\n * @property {() => void} [onCloseAnimationComplete] - Callback when closing animation completes\n */\n\n/**\n * Custom hook for managing dialog transition states and animations.\n *\n * Features:\n * - Manages dialog open/close transition states\n * - Handles animation timing based on CSS animation duration\n * - Provides callbacks for animation lifecycle events\n * - Supports controlled dialog state management\n * - Automatically handles showModal() and close() calls\n * - Provides utility flags for open/closed states\n *\n * @param ref - The ref to the dialog element\n * @param openProp - The open prop controlling dialog visibility\n * @param options - Additional, optional options including callbacks for animation start, complete, and initialization\n * @returns Object containing dialog state, control functions, and utility flags\n */\n\n/**\n * Effects configuration for dialog transition states\n * @param openProp - The open prop controlling dialog visibility\n * @param options - The effects configuration\n * @returns The dialog transition state\n */\nexport const useDialogTransitionStates = (\n  ref: RefObject<HTMLDialogElement>,\n  openProp: boolean | undefined,\n  options: OpenCloseTransitionStateEffects = {},\n) => {\n  const { onOpenAnimationStart, onCloseAnimationComplete } = options;\n\n  const getDurationMs = useCallback(() => {\n    if (!ref.current || !window) return 0;\n    const duration = window.getComputedStyle(ref.current).animationDuration;\n    return parseFloat(duration) * 1000;\n  }, [ref]);\n\n  const handleOpenAnimationStart = useCallback(() => {\n    if (!ref.current) return;\n    ref.current.showModal();\n    onOpenAnimationStart?.();\n  }, [ref, onOpenAnimationStart]);\n\n  const handleCloseAnimationComplete = useCallback(() => {\n    if (!ref.current) return;\n    ref.current.close();\n    onCloseAnimationComplete?.();\n  }, [ref, onCloseAnimationComplete]);\n\n  return useOpenCloseTransitionStates(openProp, {\n    ...options,\n    onOpenAnimationStart: handleOpenAnimationStart,\n    onCloseAnimationComplete: handleCloseAnimationComplete,\n    durationMs: getDurationMs,\n  });\n};\n","import { RefObject, useEffect, useRef, useState } from \"react\";\nimport { FocusableElement, tabbable } from \"tabbable\";\n\n/**\n * Options for the useKeyboardFocusables hook\n */\ntype OptionProps =\n  | {\n      /**\n       * Disable mutation observer\n       */\n      observeChange: false;\n    }\n  | {\n      /**\n       * Enable mutation observer with optional configuration\n       */\n      observeChange: true;\n      /**\n       * Observe attribute changes\n       */\n      attributes?: boolean;\n      /**\n       * Observe text content changes\n       */\n      characterData?: boolean;\n      /**\n       * Observe child element changes\n       */\n      childList?: boolean;\n      /**\n       * Observe descendant changes\n       */\n      subtree?: boolean;\n    };\n\n/**\n * Custom hook for tracking keyboard focusable elements within a container.\n *\n * Features:\n * - Tracks all keyboard focusable elements within a target container\n * - Supports both ref objects and direct element references\n * - Optional mutation observer for real-time updates\n * - Debounced updates to prevent excessive re-renders\n * - Configurable mutation observer options\n * - Manual update function for immediate refresh\n * - Uses tabbable library for accurate focusable detection\n * - Automatically cleans up mutation observer\n *\n * @param element - Target element or ref to monitor for focusable elements\n * @param options - Configuration options for mutation observer behavior\n * @returns Object containing current focusable elements and update function\n */\nexport const useKeyboardFocusables = (\n  element: RefObject<HTMLElement> | HTMLElement | undefined,\n  options: OptionProps = {\n    observeChange: true,\n    attributes: true,\n    characterData: true,\n    childList: true,\n    subtree: true,\n  },\n) => {\n  const [focusables, setFocusables] = useState<FocusableElement[] | null>(null);\n  const observerRef = useRef<MutationObserver>();\n\n  useEffect(() => {\n    const target = element instanceof HTMLElement ? element : element?.current;\n    if (!target) return;\n    if (!options.observeChange && !focusables) {\n      setFocusables(tabbable(target as Element));\n      return;\n    }\n\n    const mutationCallback = () => {\n      const targetArr = tabbable(target as Element);\n      if (targetArr.length === 0) return;\n      setFocusables(targetArr);\n    };\n\n    const observer = new MutationObserver(mutationCallback);\n    observerRef.current = observer;\n    observer.observe(target, {\n      childList: true, // Observe changes to child elements\n      subtree: true, // Observe changes to descendants of the target\n      attributes: true, // Observe changes to attributes\n      characterData: true, // Observe changes to text content\n    });\n    return () => {\n      observer.disconnect();\n    };\n  }, [element, options, focusables]);\n\n  return { focusables };\n};\n","import { useState, useCallback, useRef } from \"react\";\nimport { DrillDownContextProps } from \"./DrillDownContext\";\n\ntype useDrillDownContextStateParams = {\n  defaultDrillDownIndex?: number;\n};\n\nexport function useDrillDownContextState({\n  defaultDrillDownIndex = 0,\n}: useDrillDownContextStateParams) {\n  const [drillDownIndex, setDrillDownIndex] =\n    useState<DrillDownContextProps[\"index\"]>(undefined);\n  const [registeredIndices, setRegisteredIndices] = useState<\n    DrillDownContextProps[\"registeredIndices\"]\n  >([]);\n  // Track the drilldown path for back navigation\n  const drillDownPath = useRef<number[]>([]);\n  const [onClose, setOnClose] = useState<(() => void)[]>([]);\n  // focus ref for the action that called the Drilldown to open\n  const triggerFocusRef = useRef<HTMLElement | null>(null);\n\n  const restoreFocus = useCallback(() => {\n    requestAnimationFrame(() => {\n      triggerFocusRef.current?.focus();\n      triggerFocusRef.current = null;\n    });\n  }, [triggerFocusRef]);\n\n  const back = useCallback(() => {\n    const newIndex = drillDownPath.current.pop();\n    // Return focus to the trigger element if we're closing the Drilldown\n    if (newIndex == null && triggerFocusRef.current) {\n      setDrillDownIndex(undefined);\n      restoreFocus();\n      return;\n    }\n    setDrillDownIndex(newIndex);\n  }, [setDrillDownIndex, drillDownPath, restoreFocus]);\n\n  const next = useCallback(() => {\n    if (drillDownIndex == null) {\n      // Set focus ref if the Drilldown is opening for the first time\n      triggerFocusRef.current = document.activeElement as HTMLElement;\n      drillDownPath.current = [];\n      setDrillDownIndex(defaultDrillDownIndex);\n      return;\n    }\n    if (registeredIndices && registeredIndices[drillDownIndex + 1] == null) {\n      // Closes the Drilldown if there is no next index\n      drillDownPath.current = [];\n      setDrillDownIndex(undefined);\n      restoreFocus();\n      return;\n    }\n    drillDownPath.current.push(drillDownIndex);\n    setDrillDownIndex(drillDownIndex + 1);\n  }, [\n    drillDownIndex,\n    setDrillDownIndex,\n    defaultDrillDownIndex,\n    drillDownPath,\n    registeredIndices,\n    restoreFocus,\n  ]);\n\n  const setIndexWithinBounds = useCallback(\n    (index: number | undefined) => {\n      // Invalid index, close the Drilldown\n      if (\n        index == null ||\n        index < 0 ||\n        (registeredIndices && registeredIndices[index] == null)\n      ) {\n        setDrillDownIndex(undefined);\n        restoreFocus();\n        return;\n      }\n      // Update the drilldown path for back navigation\n      if (drillDownIndex === undefined) {\n        triggerFocusRef.current = document.activeElement as HTMLElement;\n        drillDownPath.current = [];\n      } else {\n        drillDownPath.current.push(drillDownIndex);\n      }\n      setDrillDownIndex(index);\n    },\n    [\n      drillDownIndex,\n      setDrillDownIndex,\n      drillDownPath,\n      registeredIndices,\n      restoreFocus,\n    ],\n  );\n\n  const setOnCloseForIndex = useCallback(\n    (fn: () => void, index: number) => {\n      setOnClose((arr) => {\n        arr[index] = () => {\n          fn();\n          setDrillDownIndex(undefined);\n          restoreFocus();\n        };\n        return arr;\n      });\n    },\n    [restoreFocus],\n  );\n\n  return {\n    index: drillDownIndex,\n    setIndex: setIndexWithinBounds,\n    back,\n    next,\n    registeredIndices,\n    setRegisteredIndices,\n    onClose,\n    setOnClose: setOnCloseForIndex,\n  };\n}\n","import { RefObject, useEffect } from \"react\";\nimport { FocusableElement, tabbable } from \"tabbable\";\n\nexport type InitialFocusOptions = {\n  /**\n   * Function to pick the initial focus target, given an array of focusable elements\n   */\n  computeFocus?: (focusables: FocusableElement[]) => FocusableElement;\n};\n\n/**\n * Hook to set initial focus for a dialog (e.g. Dialog, Drawer) when it is opened.\n * @param dialogRef - Ref to the dialog element\n * @param options - Options for the hook\n * @param options.computeFocus - Function to pick the initial focus target, given an array of focusable elements\n */\nexport const useInitialFocus = (\n  /**\n   * Ref to the dialog element\n   */\n  dialogRef: RefObject<HTMLDialogElement>,\n  { computeFocus }: InitialFocusOptions,\n) => {\n  useEffect(() => {\n    if (!dialogRef.current) {\n      return () => {};\n    }\n    // Create a MutationObserver to check if dialogRef.current is open or closed\n    const observer = new MutationObserver((mutations) => {\n      mutations.forEach((mutation) => {\n        if (\n          mutation.attributeName === \"open\" &&\n          mutation.target === dialogRef.current &&\n          mutation.target instanceof HTMLDialogElement &&\n          mutation.target.open === true\n        ) {\n          const focusables = tabbable(dialogRef.current);\n          const target = computeFocus?.(focusables) || focusables[0];\n          target?.focus();\n        }\n      });\n    });\n    observer.observe(dialogRef.current, {\n      attributes: true,\n      attributeFilter: [\"open\"],\n    });\n    return () => {\n      observer.disconnect();\n    };\n  }, [dialogRef, computeFocus]);\n};\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"useInitialFocus-BRRbylek.js","sources":["../src/internal/hooks/useDialogTransitionStates/useDialogTransitionStates.ts","../src/internal/hooks/useKeyboardFocusables/useKeyboardFocusables.ts","../src/components/DrillDown/internal/useDrillDownContextState.ts","../src/components/Dialog/internal/useInitialFocus.ts"],"sourcesContent":["import { RefObject, useCallback } from \"react\";\nimport {\n  useOpenCloseTransitionStates,\n  type OpenCloseTransitionStateEffects,\n} from \"../useOpenCloseTransitionStates\";\n\n/**\n * Effects configuration for dialog transition states\n * @property {() => void} [onOpenAnimationStart] - Callback when opening animation starts\n * @property {() => void} [onCloseAnimationStart] - Callback when closing animation starts\n * @property {() => void} [onOpenAnimationComplete] - Callback when opening animation completes\n * @property {() => void} [onCloseAnimationComplete] - Callback when closing animation completes\n */\n\n/**\n * Custom hook for managing dialog transition states and animations.\n *\n * Features:\n * - Manages dialog open/close transition states\n * - Handles animation timing based on CSS animation duration\n * - Provides callbacks for animation lifecycle events\n * - Supports controlled dialog state management\n * - Automatically handles showModal() and close() calls\n * - Provides utility flags for open/closed states\n *\n * @param ref - The ref to the dialog element\n * @param openProp - The open prop controlling dialog visibility\n * @param options - Additional, optional options including callbacks for animation start, complete, and initialization\n * @returns Object containing dialog state, control functions, and utility flags\n */\n\n/**\n * Effects configuration for dialog transition states\n * @param openProp - The open prop controlling dialog visibility\n * @param options - The effects configuration\n * @returns The dialog transition state\n */\nexport const useDialogTransitionStates = (\n  ref: RefObject<HTMLDialogElement>,\n  openProp: boolean | undefined,\n  options: OpenCloseTransitionStateEffects = {},\n) => {\n  const { onOpenAnimationStart, onCloseAnimationComplete } = options;\n\n  const getDurationMs = useCallback(() => {\n    if (!ref.current || !window) return 0;\n    const duration = window.getComputedStyle(ref.current).animationDuration;\n    return parseFloat(duration) * 1000;\n  }, [ref]);\n\n  const handleOpenAnimationStart = useCallback(() => {\n    if (!ref.current) return;\n    ref.current.showModal();\n    onOpenAnimationStart?.();\n  }, [ref, onOpenAnimationStart]);\n\n  const handleCloseAnimationComplete = useCallback(() => {\n    if (!ref.current) return;\n    ref.current.close();\n    onCloseAnimationComplete?.();\n  }, [ref, onCloseAnimationComplete]);\n\n  return useOpenCloseTransitionStates(openProp, {\n    ...options,\n    onOpenAnimationStart: handleOpenAnimationStart,\n    onCloseAnimationComplete: handleCloseAnimationComplete,\n    durationMs: getDurationMs,\n  });\n};\n","import { RefObject, useEffect, useRef, useState } from \"react\";\nimport { FocusableElement, tabbable } from \"tabbable\";\n\n/**\n * Options for the useKeyboardFocusables hook\n */\ntype OptionProps =\n  | {\n      /**\n       * Disable mutation observer\n       */\n      observeChange: false;\n    }\n  | {\n      /**\n       * Enable mutation observer with optional configuration\n       */\n      observeChange: true;\n      /**\n       * Observe attribute changes\n       */\n      attributes?: boolean;\n      /**\n       * Observe text content changes\n       */\n      characterData?: boolean;\n      /**\n       * Observe child element changes\n       */\n      childList?: boolean;\n      /**\n       * Observe descendant changes\n       */\n      subtree?: boolean;\n    };\n\n/**\n * Custom hook for tracking keyboard focusable elements within a container.\n *\n * Features:\n * - Tracks all keyboard focusable elements within a target container\n * - Supports both ref objects and direct element references\n * - Optional mutation observer for real-time updates\n * - Debounced updates to prevent excessive re-renders\n * - Configurable mutation observer options\n * - Manual update function for immediate refresh\n * - Uses tabbable library for accurate focusable detection\n * - Automatically cleans up mutation observer\n *\n * @param element - Target element or ref to monitor for focusable elements\n * @param options - Configuration options for mutation observer behavior\n * @returns Object containing current focusable elements and update function\n */\nexport const useKeyboardFocusables = (\n  element: RefObject<HTMLElement> | HTMLElement | undefined,\n  options: OptionProps = {\n    observeChange: true,\n    attributes: true,\n    characterData: true,\n    childList: true,\n    subtree: true,\n  },\n) => {\n  const [focusables, setFocusables] = useState<FocusableElement[] | null>(null);\n  const observerRef = useRef<MutationObserver>();\n\n  useEffect(() => {\n    const target = element instanceof HTMLElement ? element : element?.current;\n    if (!target) return;\n    if (!options.observeChange && !focusables) {\n      setFocusables(tabbable(target as Element));\n      return;\n    }\n\n    const mutationCallback = () => {\n      const targetArr = tabbable(target as Element);\n      if (targetArr.length === 0) return;\n      setFocusables(targetArr);\n    };\n\n    const observer = new MutationObserver(mutationCallback);\n    observerRef.current = observer;\n    observer.observe(target, {\n      childList: true, // Observe changes to child elements\n      subtree: true, // Observe changes to descendants of the target\n      attributes: true, // Observe changes to attributes\n      characterData: true, // Observe changes to text content\n    });\n    return () => {\n      observer.disconnect();\n    };\n  }, [element, options, focusables]);\n\n  return { focusables };\n};\n","import { useState, useCallback, useRef } from \"react\";\nimport { DrillDownContextProps } from \"./DrillDownContext\";\n\ntype useDrillDownContextStateParams = {\n  defaultDrillDownIndex?: number;\n};\n\nexport function useDrillDownContextState({\n  defaultDrillDownIndex = 0,\n}: useDrillDownContextStateParams) {\n  const [drillDownIndex, setDrillDownIndex] =\n    useState<DrillDownContextProps[\"index\"]>(undefined);\n  const [registeredIndices, setRegisteredIndices] = useState<\n    DrillDownContextProps[\"registeredIndices\"]\n  >([]);\n  // Track the drilldown path for back navigation\n  const drillDownPath = useRef<number[]>([]);\n  const [onClose, setOnClose] = useState<(() => void)[]>([]);\n  // focus ref for the action that called the Drilldown to open\n  const triggerFocusRef = useRef<HTMLElement | null>(null);\n\n  const restoreFocus = useCallback(() => {\n    requestAnimationFrame(() => {\n      triggerFocusRef.current?.focus();\n      triggerFocusRef.current = null;\n    });\n  }, [triggerFocusRef]);\n\n  const back = useCallback(() => {\n    const newIndex = drillDownPath.current.pop();\n    // Return focus to the trigger element if we're closing the Drilldown\n    if (newIndex == null && triggerFocusRef.current) {\n      setDrillDownIndex(undefined);\n      restoreFocus();\n      return;\n    }\n    setDrillDownIndex(newIndex);\n  }, [setDrillDownIndex, drillDownPath, restoreFocus]);\n\n  const next = useCallback(() => {\n    if (drillDownIndex == null) {\n      // Set focus ref if the Drilldown is opening for the first time\n      triggerFocusRef.current = document.activeElement as HTMLElement;\n      drillDownPath.current = [];\n      setDrillDownIndex(defaultDrillDownIndex);\n      return;\n    }\n    if (registeredIndices && registeredIndices[drillDownIndex + 1] == null) {\n      // Closes the Drilldown if there is no next index\n      drillDownPath.current = [];\n      setDrillDownIndex(undefined);\n      restoreFocus();\n      return;\n    }\n    drillDownPath.current.push(drillDownIndex);\n    setDrillDownIndex(drillDownIndex + 1);\n  }, [\n    drillDownIndex,\n    setDrillDownIndex,\n    defaultDrillDownIndex,\n    drillDownPath,\n    registeredIndices,\n    restoreFocus,\n  ]);\n\n  const setIndexWithinBounds = useCallback(\n    (index: number | undefined) => {\n      // Invalid index, close the Drilldown\n      if (\n        index == null ||\n        index < 0 ||\n        (registeredIndices && registeredIndices[index] == null)\n      ) {\n        setDrillDownIndex(undefined);\n        restoreFocus();\n        return;\n      }\n      // Update the drilldown path for back navigation\n      if (drillDownIndex === undefined) {\n        triggerFocusRef.current = document.activeElement as HTMLElement;\n        drillDownPath.current = [];\n      } else {\n        drillDownPath.current.push(drillDownIndex);\n      }\n      setDrillDownIndex(index);\n    },\n    [\n      drillDownIndex,\n      setDrillDownIndex,\n      drillDownPath,\n      registeredIndices,\n      restoreFocus,\n    ],\n  );\n\n  const setOnCloseForIndex = useCallback(\n    (fn: () => void, index: number) => {\n      setOnClose((arr) => {\n        arr[index] = () => {\n          fn();\n          setDrillDownIndex(undefined);\n          restoreFocus();\n        };\n        return arr;\n      });\n    },\n    [restoreFocus],\n  );\n\n  return {\n    index: drillDownIndex,\n    setIndex: setIndexWithinBounds,\n    back,\n    next,\n    registeredIndices,\n    setRegisteredIndices,\n    onClose,\n    setOnClose: setOnCloseForIndex,\n  };\n}\n","import { RefObject, useEffect } from \"react\";\nimport { FocusableElement, tabbable } from \"tabbable\";\n\nexport type InitialFocusOptions = {\n  /**\n   * Function to pick the initial focus target, given an array of focusable elements\n   */\n  computeFocus?: (focusables: FocusableElement[]) => FocusableElement;\n};\n\n/**\n * Hook to set initial focus for a dialog (e.g. Dialog, Drawer) when it is opened.\n * @param dialogRef - Ref to the dialog element\n * @param options - Options for the hook\n * @param options.computeFocus - Function to pick the initial focus target, given an array of focusable elements\n */\nexport const useInitialFocus = (\n  /**\n   * Ref to the dialog element\n   */\n  dialogRef: RefObject<HTMLDialogElement>,\n  { computeFocus }: InitialFocusOptions,\n) => {\n  useEffect(() => {\n    if (!dialogRef.current) {\n      return () => {};\n    }\n    // Create a MutationObserver to check if dialogRef.current is open or closed\n    const observer = new MutationObserver((mutations) => {\n      mutations.forEach((mutation) => {\n        if (\n          mutation.attributeName === \"open\" &&\n          mutation.target === dialogRef.current &&\n          mutation.target instanceof HTMLDialogElement &&\n          mutation.target.open === true\n        ) {\n          const focusables = tabbable(dialogRef.current);\n          const target = computeFocus?.(focusables) || focusables[0];\n          target?.focus();\n        }\n      });\n    });\n    observer.observe(dialogRef.current, {\n      attributes: true,\n      attributeFilter: [\"open\"],\n    });\n    return () => {\n      observer.disconnect();\n    };\n  }, [dialogRef, computeFocus]);\n};\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@servicetitan/anvil2",
-  "version": "2.3.0",
+  "version": "2.4.0",
   "type": "module",
   "types": "./dist/index.d.ts",
   "main": "./dist/index.js",
@@ -59,8 +59,8 @@
     "tabbable": "^6.2.0",
     "tinycolor2": "^1.6.0",
     "uuid": "^10.0.0",
-    "@servicetitan/hammer-icon": "1.2.0",
-    "@servicetitan/hammer-token": "2.5.1"
+    "@servicetitan/hammer-token": "2.5.1",
+    "@servicetitan/hammer-icon": "1.2.0"
   },
   "peerDependencies": {
     "@types/react": "^18 || ^19",