@mieweb/ui 0.6.1-dev.169 → 0.6.1-dev.170

package/dist/{chunk-DKGUOMBC.cjs → chunk-X7J45FU5.cjs}

@@ -189,5 +189,5 @@ exports.useIsTablet = useIsTablet;
 exports.useKeyboardShortcut = useKeyboardShortcut;
 exports.useMediaQuery = useMediaQuery;
 exports.useScrollSpy = useScrollSpy;
-//# sourceMappingURL=chunk-DKGUOMBC.cjs.map
-//# sourceMappingURL=chunk-DKGUOMBC.cjs.map
+//# sourceMappingURL=chunk-X7J45FU5.cjs.map
+//# sourceMappingURL=chunk-X7J45FU5.cjs.map

package/dist/{chunk-DKGUOMBC.cjs.map → chunk-X7J45FU5.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/hooks/useKeyboardShortcut.ts","../src/hooks/useMediaQuery.ts","../src/hooks/useScrollSpy.ts"],"names":["useCallback","useEffect","useState","useRef","entries"],"mappings":";;;;;AA2CO,SAAS,mBAAA,CACd,GAAA,EACA,QAAA,EACA,OAAA,GAAmC,EAAC,EAC9B;AACN,EAAA,MAAM;AAAA,IACJ,OAAA,GAAU,IAAA;AAAA,IACV,YAAY,EAAC;AAAA,IACb,cAAA,GAAiB,IAAA;AAAA,IACjB,eAAA,GAAkB,KAAA;AAAA,IAClB,YAAA,GAAe;AAAA,GACjB,GAAI,OAAA;AAEJ,EAAA,MAAM,aAAA,GAAgBA,iBAAA;AAAA,IACpB,CAAC,KAAA,KAAyB;AAExB,MAAA,IAAI,YAAA,EAAc;AAChB,QAAA,MAAM,SAAS,KAAA,CAAM,MAAA;AACrB,QAAA,MAAM,OAAA,GAAU,MAAA,CAAO,OAAA,CAAQ,WAAA,EAAY;AAC3C,QAAA,IACE,YAAY,OAAA,IACZ,OAAA,KAAY,cACZ,OAAA,KAAY,QAAA,IACZ,OAAO,iBAAA,EACP;AACA,UAAA;AAAA,QACF;AAAA,MACF;AAGA,MAAA,MAAM,EAAE,IAAA,EAAM,KAAA,EAAO,GAAA,EAAK,MAAK,GAAI,SAAA;AAGnC,MAAA,MAAM,aAAa,IAAA,IAAQ,IAAA;AAC3B,MAAA,IAAI,UAAA,EAAY;AACd,QAAA,IAAI,EAAE,KAAA,CAAM,OAAA,IAAW,KAAA,CAAM,OAAA,CAAA,EAAU;AAAA,MACzC,CAAA,MAAO;AAEL,QAAA,IAAI,KAAA,CAAM,OAAA,IAAW,KAAA,CAAM,OAAA,EAAS;AAAA,MACtC;AAEA,MAAA,IAAI,KAAA,IAAS,CAAC,KAAA,CAAM,QAAA,EAAU;AAC9B,MAAA,IAAI,GAAA,IAAO,CAAC,KAAA,CAAM,MAAA,EAAQ;AAG1B,MAAA,MAAM,QAAA,GACJ,MAAM,GAAA,CAAI,MAAA,KAAW,IAAI,KAAA,CAAM,GAAA,CAAI,WAAA,EAAY,GAAI,KAAA,CAAM,GAAA;AAC3D,MAAA,MAAM,YAAY,GAAA,CAAI,MAAA,KAAW,CAAA,GAAI,GAAA,CAAI,aAAY,GAAI,GAAA;AACzD,MAAA,IAAI,aAAa,SAAA,EAAW;AAE5B,MAAA,IAAI,cAAA,EAAgB;AAClB,QAAA,KAAA,CAAM,cAAA,EAAe;AAAA,MACvB;AACA,MAAA,IAAI,eAAA,EAAiB;AACnB,QAAA,KAAA,CAAM,eAAA,EAAgB;AAAA,MACxB;AAEA,MAAA,QAAA,CAAS,KAAK,CAAA;AAAA,IAChB,CAAA;AAAA,IACA,CAAC,GAAA,EAAK,QAAA,EAAU,SAAA,EAAW,cAAA,EAAgB,iBAAiB,YAAY;AAAA,GAC1E;AAEA,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,CAAC,OAAA,EAAS;AAEd,IAAA,QAAA,CAAS,gBAAA,CAAiB,WAAW,aAAa,CAAA;AAClD,IAAA,OAAO,MAAM,QAAA,CAAS,mBAAA,CAAoB,SAAA,EAAW,aAAa,CAAA;AAAA,EACpE,CAAA,EAAG,CAAC,aAAA,EAAe,OAAO,CAAC,CAAA;AAC7B;AAaO,SAAS,WAAA,CAAY,QAAA,EAAsB,OAAA,GAAU,IAAA,EAAY;AACtE,EAAA,mBAAA,CAAoB,KAAK,QAAA,EAAU;AAAA,IACjC,OAAA;AAAA,IACA,SAAA,EAAW,EAAE,IAAA,EAAM,IAAA,EAAM,MAAM,IAAA,EAAK;AAAA,IACpC,YAAA,EAAc;AAAA;AAAA,GACf,CAAA;AACH;ACxGO,SAAS,cAAc,KAAA,EAAwB;AAEpD,EAAA,MAAM,CAAC,OAAA,EAAS,UAAU,CAAA,GAAIC,eAAkB,MAAM;AAEpD,IAAA,IAAI,OAAO,MAAA,KAAW,WAAA,EAAa,OAAO,KAAA;AAC1C,IAAA,OAAO,MAAA,CAAO,UAAA,CAAW,KAAK,CAAA,CAAE,OAAA;AAAA,EAClC,CAAC,CAAA;AAED,EAAAD,gBAAU,MAAM;AACd,IAAA,IAAI,OAAO,WAAW,WAAA,EAAa;AAEnC,IAAA,MAAM,UAAA,GAAa,MAAA,CAAO,UAAA,CAAW,KAAK,CAAA;AAG1C,IAAA,UAAA,CAAW,WAAW,OAAO,CAAA;AAG7B,IAAA,MAAM,OAAA,GAAU,CAAC,KAAA,KAA+B;AAC9C,MAAA,UAAA,CAAW,MAAM,OAAO,CAAA;AAAA,IAC1B,CAAA;AAGA,IAAA,IAAI,WAAW,gBAAA,EAAkB;AAC/B,MAAA,UAAA,CAAW,gBAAA,CAAiB,UAAU,OAAO,CAAA;AAC7C,MAAA,OAAO,MAAM,UAAA,CAAW,mBAAA,CAAoB,QAAA,EAAU,OAAO,CAAA;AAAA,IAC/D;AAGA,IAAA,UAAA,CAAW,YAAY,OAAO,CAAA;AAC9B,IAAA,OAAO,MAAM,UAAA,CAAW,cAAA,CAAe,OAAO,CAAA;AAAA,EAChD,CAAA,EAAG,CAAC,KAAK,CAAC,CAAA;AAEV,EAAA,OAAO,OAAA;AACT;AAOO,SAAS,WAAA,GAAuB;AACrC,EAAA,OAAO,cAAc,oBAAoB,CAAA;AAC3C;AAGO,SAAS,gBAAA,GAA4B;AAC1C,EAAA,OAAO,cAAc,2CAA2C,CAAA;AAClE;AAGO,SAAS,WAAA,GAAuB;AACrC,EAAA,OAAO,cAAc,4CAA4C,CAAA;AACnE;AAGO,SAAS,YAAA,GAAwB;AACtC,EAAA,OAAO,cAAc,qBAAqB,CAAA;AAC5C;AAGO,SAAS,iBAAA,GAA6B;AAC3C,EAAA,OAAO,cAAc,qBAAqB,CAAA;AAC5C;AAGO,SAAS,mBAAA,GAA+B;AAC7C,EAAA,OAAO,cAAc,qBAAqB,CAAA;AAC5C;AC/CO,SAAS,YAAA,CAAa;AAAA,EAC3B,SAAA;AAAA,EACA,GAAA;AAAA,EACA,UAAA,GAAa,kBAAA;AAAA,EACb,SAAA,GAAY,CAAA;AAAA,EACZ,IAAA;AAAA,EACA,OAAA,GAAU;AACZ,CAAA,GAAyB,EAAC,EAAuB;AAC/C,EAAA,MAAM,CAAC,QAAA,EAAU,WAAW,CAAA,GAAIC,eAAwB,IAAI,CAAA;AAC5D,EAAA,MAAM,cAAA,GAAiBC,YAAA;AAAA,wBACjB,GAAA;AAAI,GACV;AAGA,EAAA,MAAM,MAAA,GAAS,MAAM,OAAA,IAAW,IAAA;AAEhC,EAAAF,gBAAU,MAAM;AACd,IAAA,IAAI,CAAC,OAAA,EAAS;AAEd,IAAA,MAAM,YAAY,MAAA,IAAU,QAAA;AAG5B,IAAA,SAAS,eAAA,GAA6B;AACpC,MAAA,IAAI,MAAiB,EAAC;AACtB,MAAA,IAAI,GAAA,IAAO,GAAA,CAAI,MAAA,GAAS,CAAA,EAAG;AACzB,QAAA,GAAA,GAAM,GAAA,CACH,GAAA,CAAI,CAAC,EAAA,KAAO,QAAA,CAAS,cAAA,CAAe,EAAE,CAAC,CAAA,CACvC,MAAA,CAAO,CAAC,EAAA,KAA0B,OAAO,IAAI,CAAA;AAAA,MAClD,WAAW,SAAA,EAAW;AACpB,QAAA,GAAA,GAAM,KAAA,CAAM,IAAA,CAAK,SAAA,CAAU,gBAAA,CAAiB,SAAS,CAAC,CAAA;AAAA,MACxD;AACA,MAAA,OAAO,GAAA,CAAI,MAAA,CAAO,CAAC,EAAA,KAAO,GAAG,EAAE,CAAA;AAAA,IACjC;AAEA,IAAA,IAAI,oBAAA,GAAoD,IAAA;AACxD,IAAA,IAAI,gBAAA,GAA4C,IAAA;AAEhD,IAAA,SAAS,cAAA,GAA0B;AACjC,MAAA,MAAM,WAAW,eAAA,EAAgB;AACjC,MAAA,IAAI,QAAA,CAAS,MAAA,KAAW,CAAA,EAAG,OAAO,KAAA;AAElC,MAAA,oBAAA,GAAuB,IAAI,oBAAA;AAAA,QACzB,CAACG,QAAAA,KAAY;AACX,UAAA,KAAA,MAAW,SAASA,QAAAA,EAAS;AAC3B,YAAA,IAAI,MAAM,cAAA,EAAgB;AACxB,cAAA,cAAA,CAAe,OAAA,CAAQ,GAAA,CAAI,KAAA,CAAM,MAAA,CAAO,IAAI,KAAK,CAAA;AAAA,YACnD,CAAA,MAAO;AACL,cAAA,cAAA,CAAe,OAAA,CAAQ,MAAA,CAAO,KAAA,CAAM,MAAA,CAAO,EAAE,CAAA;AAAA,YAC/C;AAAA,UACF;AAGA,UAAA,IAAI,cAAA,CAAe,OAAA,CAAQ,IAAA,GAAO,CAAA,EAAG;AACnC,YAAA,IAAI,OAAA,GAAyB,IAAA;AAC7B,YAAA,IAAI,UAAA,GAAa,QAAA;AAEjB,YAAA,KAAA,MAAW,CAAC,EAAA,EAAI,KAAK,CAAA,IAAK,eAAe,OAAA,EAAS;AAChD,cAAA,MAAM,GAAA,GAAM,MAAM,kBAAA,CAAmB,GAAA;AACrC,cAAA,IAAI,MAAM,UAAA,EAAY;AACpB,gBAAA,UAAA,GAAa,GAAA;AACb,gBAAA,OAAA,GAAU,EAAA;AAAA,cACZ;AAAA,YACF;AAEA,YAAA,IAAI,OAAA,EAAS;AACX,cAAA,WAAA,CAAY,OAAO,CAAA;AAAA,YACrB;AAAA,UACF;AAAA,QACF,CAAA;AAAA,QACA;AAAA,UACE,IAAA,EAAM,MAAA;AAAA,UACN,UAAA;AAAA,UACA;AAAA;AACF,OACF;AAEA,MAAA,KAAA,MAAW,MAAM,QAAA,EAAU;AACzB,QAAA,oBAAA,CAAqB,QAAQ,EAAE,CAAA;AAAA,MACjC;AAGA,MAAA,gBAAA,EAAkB,UAAA,EAAW;AAC7B,MAAA,gBAAA,GAAmB,IAAA;AACnB,MAAA,OAAO,IAAA;AAAA,IACT;AAIA,IAAA,IAAI,CAAC,gBAAe,EAAG;AACrB,MAAA,MAAM,SAAA,GAAY,UAAU,QAAA,CAAS,IAAA;AACrC,MAAA,gBAAA,GAAmB,IAAI,iBAAiB,MAAM;AAC5C,QAAA,cAAA,EAAe;AAAA,MACjB,CAAC,CAAA;AACD,MAAA,gBAAA,CAAiB,QAAQ,SAAA,EAAW,EAAE,WAAW,IAAA,EAAM,OAAA,EAAS,MAAM,CAAA;AAAA,IACxE;AAEA,IAAA,MAAM,UAAU,cAAA,CAAe,OAAA;AAC/B,IAAA,OAAO,MAAM;AACX,MAAA,gBAAA,EAAkB,UAAA,EAAW;AAC7B,MAAA,oBAAA,EAAsB,UAAA,EAAW;AACjC,MAAA,OAAA,CAAQ,KAAA,EAAM;AAAA,IAChB,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,SAAA,EAAW,GAAA,EAAK,YAAY,SAAA,EAAW,MAAA,EAAQ,OAAO,CAAC,CAAA;AAE3D,EAAA,OAAO,EAAE,QAAA,EAAS;AACpB","file":"chunk-DKGUOMBC.cjs","sourcesContent":["import { useEffect, useCallback } from 'react';\n\n/**\n * Options for keyboard shortcut hook\n */\nexport interface KeyboardShortcutOptions {\n  /** Whether the shortcut is currently enabled (default: true) */\n  enabled?: boolean;\n  /** Modifier keys required (default: none) */\n  modifiers?: {\n    ctrl?: boolean;\n    shift?: boolean;\n    alt?: boolean;\n    meta?: boolean;\n  };\n  /** Whether to prevent default browser behavior (default: true) */\n  preventDefault?: boolean;\n  /** Whether to stop event propagation (default: false) */\n  stopPropagation?: boolean;\n  /** Element types to ignore when the shortcut is pressed (default: ['INPUT', 'TEXTAREA', 'SELECT']) */\n  ignoreInputs?: boolean;\n}\n\n/**\n * Hook that triggers a callback when a specific keyboard shortcut is pressed.\n * Supports modifier keys (Ctrl, Shift, Alt, Meta) and ignores input fields by default.\n *\n * @param key - The key to listen for (e.g., 'k', 'Enter', 'Escape', '/')\n * @param callback - Function to call when the shortcut is pressed\n * @param options - Configuration options\n *\n * @example\n * ```tsx\n * // Cmd/Ctrl+K to open search\n * useKeyboardShortcut('k', openSearch, { modifiers: { meta: true, ctrl: true } });\n *\n * // Forward slash to focus search (ignoring when typing)\n * useKeyboardShortcut('/', focusSearch);\n *\n * // Escape to close modal\n * useKeyboardShortcut('Escape', closeModal);\n * ```\n */\nexport function useKeyboardShortcut(\n  key: string,\n  callback: (event: KeyboardEvent) => void,\n  options: KeyboardShortcutOptions = {}\n): void {\n  const {\n    enabled = true,\n    modifiers = {},\n    preventDefault = true,\n    stopPropagation = false,\n    ignoreInputs = true,\n  } = options;\n\n  const handleKeyDown = useCallback(\n    (event: KeyboardEvent) => {\n      // Check if we should ignore input fields\n      if (ignoreInputs) {\n        const target = event.target as HTMLElement;\n        const tagName = target.tagName.toUpperCase();\n        if (\n          tagName === 'INPUT' ||\n          tagName === 'TEXTAREA' ||\n          tagName === 'SELECT' ||\n          target.isContentEditable\n        ) {\n          return;\n        }\n      }\n\n      // Check modifiers\n      const { ctrl, shift, alt, meta } = modifiers;\n\n      // For Cmd+K style shortcuts, allow either meta (Mac) or ctrl (Windows/Linux)\n      const metaOrCtrl = meta || ctrl;\n      if (metaOrCtrl) {\n        if (!(event.metaKey || event.ctrlKey)) return;\n      } else {\n        // If no meta/ctrl modifier specified, ensure neither is pressed\n        if (event.metaKey || event.ctrlKey) return;\n      }\n\n      if (shift && !event.shiftKey) return;\n      if (alt && !event.altKey) return;\n\n      // Check key match (case-insensitive for letters)\n      const eventKey =\n        event.key.length === 1 ? event.key.toLowerCase() : event.key;\n      const targetKey = key.length === 1 ? key.toLowerCase() : key;\n      if (eventKey !== targetKey) return;\n\n      if (preventDefault) {\n        event.preventDefault();\n      }\n      if (stopPropagation) {\n        event.stopPropagation();\n      }\n\n      callback(event);\n    },\n    [key, callback, modifiers, preventDefault, stopPropagation, ignoreInputs]\n  );\n\n  useEffect(() => {\n    if (!enabled) return;\n\n    document.addEventListener('keydown', handleKeyDown);\n    return () => document.removeEventListener('keydown', handleKeyDown);\n  }, [handleKeyDown, enabled]);\n}\n\n/**\n * Hook for the common Cmd/Ctrl+K shortcut pattern (command palette, search, etc.)\n *\n * @param callback - Function to call when Cmd/Ctrl+K is pressed\n * @param enabled - Whether the shortcut is active (default: true)\n *\n * @example\n * ```tsx\n * useCommandK(() => setIsOpen(true));\n * ```\n */\nexport function useCommandK(callback: () => void, enabled = true): void {\n  useKeyboardShortcut('k', callback, {\n    enabled,\n    modifiers: { meta: true, ctrl: true },\n    ignoreInputs: false, // Cmd+K should work even in inputs\n  });\n}\n","import { useState, useEffect } from 'react';\n\n/**\n * Hook that tracks whether a media query matches.\n * Uses the native `matchMedia` API for efficient media query tracking.\n *\n * @param query - CSS media query string (e.g., '(min-width: 768px)')\n * @returns Boolean indicating whether the media query matches\n *\n * @example\n * ```tsx\n * function ResponsiveComponent() {\n *   const isMobile = useMediaQuery('(max-width: 767px)');\n *   const isTablet = useMediaQuery('(min-width: 768px) and (max-width: 1023px)');\n *   const isDesktop = useMediaQuery('(min-width: 1024px)');\n *\n *   return (\n *     <div>\n *       {isMobile && <MobileLayout />}\n *       {isTablet && <TabletLayout />}\n *       {isDesktop && <DesktopLayout />}\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useMediaQuery(query: string): boolean {\n  // Initialize with null to indicate SSR/initial state\n  const [matches, setMatches] = useState<boolean>(() => {\n    // Check if we're in a browser environment\n    if (typeof window === 'undefined') return false;\n    return window.matchMedia(query).matches;\n  });\n\n  useEffect(() => {\n    if (typeof window === 'undefined') return;\n\n    const mediaQuery = window.matchMedia(query);\n\n    // Set initial value\n    setMatches(mediaQuery.matches);\n\n    // Handler for media query changes\n    const handler = (event: MediaQueryListEvent) => {\n      setMatches(event.matches);\n    };\n\n    // Modern browsers use addEventListener\n    if (mediaQuery.addEventListener) {\n      mediaQuery.addEventListener('change', handler);\n      return () => mediaQuery.removeEventListener('change', handler);\n    }\n\n    // Fallback for older browsers\n    mediaQuery.addListener(handler);\n    return () => mediaQuery.removeListener(handler);\n  }, [query]);\n\n  return matches;\n}\n\n/**\n * Preset breakpoint hooks following common responsive design patterns\n */\n\n/** Returns true when viewport is smaller than 640px (mobile) */\nexport function useIsMobile(): boolean {\n  return useMediaQuery('(max-width: 639px)');\n}\n\n/** Returns true when viewport is 640px-767px (large mobile / small tablet) */\nexport function useIsSmallTablet(): boolean {\n  return useMediaQuery('(min-width: 640px) and (max-width: 767px)');\n}\n\n/** Returns true when viewport is 768px-1023px (tablet) */\nexport function useIsTablet(): boolean {\n  return useMediaQuery('(min-width: 768px) and (max-width: 1023px)');\n}\n\n/** Returns true when viewport is 1024px or larger (desktop) */\nexport function useIsDesktop(): boolean {\n  return useMediaQuery('(min-width: 1024px)');\n}\n\n/** Returns true when viewport is 1280px or larger (large desktop) */\nexport function useIsLargeDesktop(): boolean {\n  return useMediaQuery('(min-width: 1280px)');\n}\n\n/** Returns true when viewport is smaller than 1024px (mobile/tablet) */\nexport function useIsMobileOrTablet(): boolean {\n  return useMediaQuery('(max-width: 1023px)');\n}\n","import { useEffect, useState, useRef, type RefObject } from 'react';\n\n// =============================================================================\n// Types\n// =============================================================================\n\nexport interface UseScrollSpyOptions {\n  /** CSS selector for the elements to observe (e.g. 'h2, h3, h4') */\n  selectors?: string;\n  /** Explicit list of element IDs to observe (alternative to selectors) */\n  ids?: string[];\n  /** IntersectionObserver root margin (default: '0px 0px -60% 0px') */\n  rootMargin?: string;\n  /** IntersectionObserver threshold (default: 0) */\n  threshold?: number | number[];\n  /** Scroll container element ref. Defaults to document viewport. */\n  root?: RefObject<HTMLElement | null>;\n  /** Whether the hook is active (default: true) */\n  enabled?: boolean;\n}\n\nexport interface UseScrollSpyReturn {\n  /** The ID of the currently active (in-view) element */\n  activeId: string | null;\n}\n\n// =============================================================================\n// Hook\n// =============================================================================\n\n/**\n * Tracks which section is currently in the viewport using IntersectionObserver.\n * Pairs naturally with `TableOfContents` to highlight the active heading.\n *\n * @example\n * ```tsx\n * function DocsPage() {\n *   const { activeId } = useScrollSpy({ selectors: 'h2, h3' });\n *   return (\n *     <aside>\n *       <TableOfContents activeId={activeId} />\n *     </aside>\n *   );\n * }\n * ```\n */\nexport function useScrollSpy({\n  selectors,\n  ids,\n  rootMargin = '0px 0px -60% 0px',\n  threshold = 0,\n  root,\n  enabled = true,\n}: UseScrollSpyOptions = {}): UseScrollSpyReturn {\n  const [activeId, setActiveId] = useState<string | null>(null);\n  const visibleEntries = useRef<Map<string, IntersectionObserverEntry>>(\n    new Map()\n  );\n\n  // Track root.current so the effect re-runs when the ref attaches\n  const rootEl = root?.current ?? null;\n\n  useEffect(() => {\n    if (!enabled) return;\n\n    const container = rootEl ?? document;\n\n    // Resolve target elements from the DOM\n    function resolveElements(): Element[] {\n      let els: Element[] = [];\n      if (ids && ids.length > 0) {\n        els = ids\n          .map((id) => document.getElementById(id))\n          .filter((el): el is HTMLElement => el !== null);\n      } else if (selectors) {\n        els = Array.from(container.querySelectorAll(selectors));\n      }\n      return els.filter((el) => el.id);\n    }\n\n    let intersectionObserver: IntersectionObserver | null = null;\n    let mutationObserver: MutationObserver | null = null;\n\n    function startObserving(): boolean {\n      const elements = resolveElements();\n      if (elements.length === 0) return false;\n\n      intersectionObserver = new IntersectionObserver(\n        (entries) => {\n          for (const entry of entries) {\n            if (entry.isIntersecting) {\n              visibleEntries.current.set(entry.target.id, entry);\n            } else {\n              visibleEntries.current.delete(entry.target.id);\n            }\n          }\n\n          // Pick the topmost visible heading (by DOM order)\n          if (visibleEntries.current.size > 0) {\n            let topmost: string | null = null;\n            let topmostTop = Infinity;\n\n            for (const [id, entry] of visibleEntries.current) {\n              const top = entry.boundingClientRect.top;\n              if (top < topmostTop) {\n                topmostTop = top;\n                topmost = id;\n              }\n            }\n\n            if (topmost) {\n              setActiveId(topmost);\n            }\n          }\n        },\n        {\n          root: rootEl,\n          rootMargin,\n          threshold,\n        }\n      );\n\n      for (const el of elements) {\n        intersectionObserver.observe(el);\n      }\n\n      // Elements found — stop watching for new DOM nodes\n      mutationObserver?.disconnect();\n      mutationObserver = null;\n      return true;\n    }\n\n    // If target elements don't exist yet (e.g. headings mount after ToC),\n    // watch for DOM changes and retry until they appear.\n    if (!startObserving()) {\n      const watchRoot = rootEl ?? document.body;\n      mutationObserver = new MutationObserver(() => {\n        startObserving();\n      });\n      mutationObserver.observe(watchRoot, { childList: true, subtree: true });\n    }\n\n    const entries = visibleEntries.current;\n    return () => {\n      mutationObserver?.disconnect();\n      intersectionObserver?.disconnect();\n      entries.clear();\n    };\n  }, [selectors, ids, rootMargin, threshold, rootEl, enabled]);\n\n  return { activeId };\n}\n"]}
+{"version":3,"sources":["../src/hooks/useKeyboardShortcut.ts","../src/hooks/useMediaQuery.ts","../src/hooks/useScrollSpy.ts"],"names":["useCallback","useEffect","useState","useRef","entries"],"mappings":"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","file":"chunk-X7J45FU5.cjs","sourcesContent":["import { useEffect, useCallback } from 'react';\n\n/**\n * Options for keyboard shortcut hook\n */\nexport interface KeyboardShortcutOptions {\n  /** Whether the shortcut is currently enabled (default: true) */\n  enabled?: boolean;\n  /** Modifier keys required (default: none) */\n  modifiers?: {\n    ctrl?: boolean;\n    shift?: boolean;\n    alt?: boolean;\n    meta?: boolean;\n  };\n  /** Whether to prevent default browser behavior (default: true) */\n  preventDefault?: boolean;\n  /** Whether to stop event propagation (default: false) */\n  stopPropagation?: boolean;\n  /** Element types to ignore when the shortcut is pressed (default: ['INPUT', 'TEXTAREA', 'SELECT']) */\n  ignoreInputs?: boolean;\n}\n\n/**\n * Hook that triggers a callback when a specific keyboard shortcut is pressed.\n * Supports modifier keys (Ctrl, Shift, Alt, Meta) and ignores input fields by default.\n *\n * @param key - The key to listen for (e.g., 'k', 'Enter', 'Escape', '/')\n * @param callback - Function to call when the shortcut is pressed\n * @param options - Configuration options\n *\n * @example\n * ```tsx\n * // Cmd/Ctrl+K to open search\n * useKeyboardShortcut('k', openSearch, { modifiers: { meta: true, ctrl: true } });\n *\n * // Forward slash to focus search (ignoring when typing)\n * useKeyboardShortcut('/', focusSearch);\n *\n * // Escape to close modal\n * useKeyboardShortcut('Escape', closeModal);\n * ```\n */\nexport function useKeyboardShortcut(\n  key: string,\n  callback: (event: KeyboardEvent) => void,\n  options: KeyboardShortcutOptions = {}\n): void {\n  const {\n    enabled = true,\n    modifiers = {},\n    preventDefault = true,\n    stopPropagation = false,\n    ignoreInputs = true,\n  } = options;\n\n  const handleKeyDown = useCallback(\n    (event: KeyboardEvent) => {\n      // Check if we should ignore input fields\n      if (ignoreInputs) {\n        const target = event.target as HTMLElement;\n        const tagName = target.tagName.toUpperCase();\n        if (\n          tagName === 'INPUT' ||\n          tagName === 'TEXTAREA' ||\n          tagName === 'SELECT' ||\n          target.isContentEditable\n        ) {\n          return;\n        }\n      }\n\n      // Check modifiers\n      const { ctrl, shift, alt, meta } = modifiers;\n\n      // For Cmd+K style shortcuts, allow either meta (Mac) or ctrl (Windows/Linux)\n      const metaOrCtrl = meta || ctrl;\n      if (metaOrCtrl) {\n        if (!(event.metaKey || event.ctrlKey)) return;\n      } else {\n        // If no meta/ctrl modifier specified, ensure neither is pressed\n        if (event.metaKey || event.ctrlKey) return;\n      }\n\n      if (shift && !event.shiftKey) return;\n      if (alt && !event.altKey) return;\n\n      // Check key match (case-insensitive for letters)\n      const eventKey =\n        event.key.length === 1 ? event.key.toLowerCase() : event.key;\n      const targetKey = key.length === 1 ? key.toLowerCase() : key;\n      if (eventKey !== targetKey) return;\n\n      if (preventDefault) {\n        event.preventDefault();\n      }\n      if (stopPropagation) {\n        event.stopPropagation();\n      }\n\n      callback(event);\n    },\n    [key, callback, modifiers, preventDefault, stopPropagation, ignoreInputs]\n  );\n\n  useEffect(() => {\n    if (!enabled) return;\n\n    document.addEventListener('keydown', handleKeyDown);\n    return () => document.removeEventListener('keydown', handleKeyDown);\n  }, [handleKeyDown, enabled]);\n}\n\n/**\n * Hook for the common Cmd/Ctrl+K shortcut pattern (command palette, search, etc.)\n *\n * @param callback - Function to call when Cmd/Ctrl+K is pressed\n * @param enabled - Whether the shortcut is active (default: true)\n *\n * @example\n * ```tsx\n * useCommandK(() => setIsOpen(true));\n * ```\n */\nexport function useCommandK(callback: () => void, enabled = true): void {\n  useKeyboardShortcut('k', callback, {\n    enabled,\n    modifiers: { meta: true, ctrl: true },\n    ignoreInputs: false, // Cmd+K should work even in inputs\n  });\n}\n","import { useState, useEffect } from 'react';\n\n/**\n * Hook that tracks whether a media query matches.\n * Uses the native `matchMedia` API for efficient media query tracking.\n *\n * @param query - CSS media query string (e.g., '(min-width: 768px)')\n * @returns Boolean indicating whether the media query matches\n *\n * @example\n * ```tsx\n * function ResponsiveComponent() {\n *   const isMobile = useMediaQuery('(max-width: 767px)');\n *   const isTablet = useMediaQuery('(min-width: 768px) and (max-width: 1023px)');\n *   const isDesktop = useMediaQuery('(min-width: 1024px)');\n *\n *   return (\n *     <div>\n *       {isMobile && <MobileLayout />}\n *       {isTablet && <TabletLayout />}\n *       {isDesktop && <DesktopLayout />}\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useMediaQuery(query: string): boolean {\n  // Initialize with null to indicate SSR/initial state\n  const [matches, setMatches] = useState<boolean>(() => {\n    // Check if we're in a browser environment\n    if (typeof window === 'undefined') return false;\n    return window.matchMedia(query).matches;\n  });\n\n  useEffect(() => {\n    if (typeof window === 'undefined') return;\n\n    const mediaQuery = window.matchMedia(query);\n\n    // Set initial value\n    setMatches(mediaQuery.matches);\n\n    // Handler for media query changes\n    const handler = (event: MediaQueryListEvent) => {\n      setMatches(event.matches);\n    };\n\n    // Modern browsers use addEventListener\n    if (mediaQuery.addEventListener) {\n      mediaQuery.addEventListener('change', handler);\n      return () => mediaQuery.removeEventListener('change', handler);\n    }\n\n    // Fallback for older browsers\n    mediaQuery.addListener(handler);\n    return () => mediaQuery.removeListener(handler);\n  }, [query]);\n\n  return matches;\n}\n\n/**\n * Preset breakpoint hooks following common responsive design patterns\n */\n\n/** Returns true when viewport is smaller than 640px (mobile) */\nexport function useIsMobile(): boolean {\n  return useMediaQuery('(max-width: 639px)');\n}\n\n/** Returns true when viewport is 640px-767px (large mobile / small tablet) */\nexport function useIsSmallTablet(): boolean {\n  return useMediaQuery('(min-width: 640px) and (max-width: 767px)');\n}\n\n/** Returns true when viewport is 768px-1023px (tablet) */\nexport function useIsTablet(): boolean {\n  return useMediaQuery('(min-width: 768px) and (max-width: 1023px)');\n}\n\n/** Returns true when viewport is 1024px or larger (desktop) */\nexport function useIsDesktop(): boolean {\n  return useMediaQuery('(min-width: 1024px)');\n}\n\n/** Returns true when viewport is 1280px or larger (large desktop) */\nexport function useIsLargeDesktop(): boolean {\n  return useMediaQuery('(min-width: 1280px)');\n}\n\n/** Returns true when viewport is smaller than 1024px (mobile/tablet) */\nexport function useIsMobileOrTablet(): boolean {\n  return useMediaQuery('(max-width: 1023px)');\n}\n","import { useEffect, useState, useRef, type RefObject } from 'react';\n\n// =============================================================================\n// Types\n// =============================================================================\n\nexport interface UseScrollSpyOptions {\n  /** CSS selector for the elements to observe (e.g. 'h2, h3, h4') */\n  selectors?: string;\n  /** Explicit list of element IDs to observe (alternative to selectors) */\n  ids?: string[];\n  /** IntersectionObserver root margin (default: '0px 0px -60% 0px') */\n  rootMargin?: string;\n  /** IntersectionObserver threshold (default: 0) */\n  threshold?: number | number[];\n  /** Scroll container element ref. Defaults to document viewport. */\n  root?: RefObject<HTMLElement | null>;\n  /** Whether the hook is active (default: true) */\n  enabled?: boolean;\n}\n\nexport interface UseScrollSpyReturn {\n  /** The ID of the currently active (in-view) element */\n  activeId: string | null;\n}\n\n// =============================================================================\n// Hook\n// =============================================================================\n\n/**\n * Tracks which section is currently in the viewport using IntersectionObserver.\n * Pairs naturally with `TableOfContents` to highlight the active heading.\n *\n * @example\n * ```tsx\n * function DocsPage() {\n *   const { activeId } = useScrollSpy({ selectors: 'h2, h3' });\n *   return (\n *     <aside>\n *       <TableOfContents activeId={activeId} />\n *     </aside>\n *   );\n * }\n * ```\n */\nexport function useScrollSpy({\n  selectors,\n  ids,\n  rootMargin = '0px 0px -60% 0px',\n  threshold = 0,\n  root,\n  enabled = true,\n}: UseScrollSpyOptions = {}): UseScrollSpyReturn {\n  const [activeId, setActiveId] = useState<string | null>(null);\n  const visibleEntries = useRef<Map<string, IntersectionObserverEntry>>(\n    new Map()\n  );\n\n  // Track root.current so the effect re-runs when the ref attaches\n  const rootEl = root?.current ?? null;\n\n  useEffect(() => {\n    if (!enabled) return;\n\n    const container = rootEl ?? document;\n\n    // Resolve target elements from the DOM\n    function resolveElements(): Element[] {\n      let els: Element[] = [];\n      if (ids && ids.length > 0) {\n        els = ids\n          .map((id) => document.getElementById(id))\n          .filter((el): el is HTMLElement => el !== null);\n      } else if (selectors) {\n        els = Array.from(container.querySelectorAll(selectors));\n      }\n      return els.filter((el) => el.id);\n    }\n\n    let intersectionObserver: IntersectionObserver | null = null;\n    let mutationObserver: MutationObserver | null = null;\n\n    function startObserving(): boolean {\n      const elements = resolveElements();\n      if (elements.length === 0) return false;\n\n      intersectionObserver = new IntersectionObserver(\n        (entries) => {\n          for (const entry of entries) {\n            if (entry.isIntersecting) {\n              visibleEntries.current.set(entry.target.id, entry);\n            } else {\n              visibleEntries.current.delete(entry.target.id);\n            }\n          }\n\n          // Pick the topmost visible heading (by DOM order)\n          if (visibleEntries.current.size > 0) {\n            let topmost: string | null = null;\n            let topmostTop = Infinity;\n\n            for (const [id, entry] of visibleEntries.current) {\n              const top = entry.boundingClientRect.top;\n              if (top < topmostTop) {\n                topmostTop = top;\n                topmost = id;\n              }\n            }\n\n            if (topmost) {\n              setActiveId(topmost);\n            }\n          }\n        },\n        {\n          root: rootEl,\n          rootMargin,\n          threshold,\n        }\n      );\n\n      for (const el of elements) {\n        intersectionObserver.observe(el);\n      }\n\n      // Elements found — stop watching for new DOM nodes\n      mutationObserver?.disconnect();\n      mutationObserver = null;\n      return true;\n    }\n\n    // If target elements don't exist yet (e.g. headings mount after ToC),\n    // watch for DOM changes and retry until they appear.\n    if (!startObserving()) {\n      const watchRoot = rootEl ?? document.body;\n      mutationObserver = new MutationObserver(() => {\n        startObserving();\n      });\n      mutationObserver.observe(watchRoot, { childList: true, subtree: true });\n    }\n\n    const entries = visibleEntries.current;\n    return () => {\n      mutationObserver?.disconnect();\n      intersectionObserver?.disconnect();\n      entries.clear();\n    };\n  }, [selectors, ids, rootMargin, threshold, rootEl, enabled]);\n\n  return { activeId };\n}\n"]}

package/dist/chunk-Y4ESBDQ5.cjs

@@ -0,0 +1,552 @@
+'use strict';
+
+var react = require('react');
+
+// src/hooks/useTranscriptEdits.ts
+var DEFAULT_FILLER_WORDS = [
+  "um",
+  "uh",
+  "umm",
+  "uhh",
+  "uh-huh",
+  "mm-hmm",
+  "hmm",
+  "hm",
+  "er",
+  "err",
+  "ah",
+  "ahh",
+  "eh",
+  "oh",
+  "ooh",
+  "like",
+  "you know",
+  "i mean",
+  "so",
+  "well",
+  "actually",
+  "basically",
+  "literally",
+  "right",
+  "okay",
+  "ok"
+];
+var DEFAULT_MIN_SILENCE_MS = 400;
+var DEFAULT_NL_SILENCE_MS = 1500;
+var SILENCE_ANALYSIS_THRESHOLDS = [0.3, 0.4, 0.5, 0.75, 1, 1.5, 2];
+function buildPlaybackSegments(editedWords) {
+  const activeWords = editedWords.filter((w) => !w.deleted);
+  if (activeWords.length === 0) return [];
+  const segments = [];
+  let currentSegment = null;
+  let lastOriginalIndex = -2;
+  let lastWasInserted = false;
+  for (let i = 0; i < editedWords.length; i++) {
+    const ew = editedWords[i];
+    if (ew.deleted) continue;
+    const isConsecutive = !ew.inserted && !lastWasInserted && ew.originalIndex === lastOriginalIndex + 1;
+    if (currentSegment && isConsecutive) {
+      currentSegment.endMs = ew.word.endMs;
+      currentSegment.editedIndices.push(i);
+    } else {
+      if (currentSegment) {
+        segments.push(currentSegment);
+      }
+      currentSegment = {
+        startMs: ew.word.startMs,
+        endMs: ew.word.endMs,
+        editedIndices: [i]
+      };
+    }
+    lastOriginalIndex = ew.originalIndex;
+    lastWasInserted = ew.inserted ?? false;
+  }
+  if (currentSegment) {
+    segments.push(currentSegment);
+  }
+  return segments;
+}
+function getSpeedAtIndex(wordIndex, speedMarkers, defaultSpeed) {
+  const sortedMarkers = [...speedMarkers].sort(
+    (a, b) => a.wordIndex - b.wordIndex
+  );
+  let effectiveSpeed = defaultSpeed;
+  for (const marker of sortedMarkers) {
+    if (marker.wordIndex <= wordIndex) {
+      effectiveSpeed = marker.speed;
+    } else {
+      break;
+    }
+  }
+  return effectiveSpeed;
+}
+function insertSilences(words, minSilenceMs = DEFAULT_MIN_SILENCE_MS, nlSilenceMs = DEFAULT_NL_SILENCE_MS) {
+  if (words.length === 0) return [];
+  const result = [];
+  for (let i = 0; i < words.length; i++) {
+    const word = words[i];
+    if (i === 0 && word.startMs > minSilenceMs) {
+      const isNewline = word.startMs >= nlSilenceMs;
+      result.push({
+        text: `[${(word.startMs / 1e3).toFixed(1)}s]`,
+        startMs: 0,
+        endMs: word.startMs,
+        wordType: isNewline ? "silence-newline" : "silence"
+      });
+    }
+    result.push({ ...word, wordType: word.wordType ?? "word" });
+    if (i < words.length - 1) {
+      const nextWord = words[i + 1];
+      const gapMs = nextWord.startMs - word.endMs;
+      if (gapMs >= minSilenceMs) {
+        const isNewline = gapMs >= nlSilenceMs;
+        result.push({
+          text: `[${(gapMs / 1e3).toFixed(1)}s]`,
+          startMs: word.endMs,
+          endMs: nextWord.startMs,
+          wordType: isNewline ? "silence-newline" : "silence"
+        });
+      }
+    }
+  }
+  return result;
+}
+function initEditableWords(transcript, minSilenceMs = DEFAULT_MIN_SILENCE_MS, nlSilenceMs = DEFAULT_NL_SILENCE_MS) {
+  const wordsWithSilences = insertSilences(
+    transcript.words,
+    minSilenceMs,
+    nlSilenceMs
+  );
+  return wordsWithSilences.map((word, index) => ({
+    originalIndex: index,
+    word,
+    deleted: false
+  }));
+}
+function normalizeWordText(text) {
+  return text.toLowerCase().replace(/[.,!?;:]/g, "");
+}
+function useTranscriptEdits(options) {
+  const {
+    transcript,
+    initialEditedWords,
+    initialUndoStack,
+    onChange,
+    minSilenceMs: initialMinSilenceMs = DEFAULT_MIN_SILENCE_MS,
+    nlSilenceMs: initialNlSilenceMs = DEFAULT_NL_SILENCE_MS
+  } = options;
+  const initializedFromSaved = react.useRef(false);
+  const [editedWords, setEditedWords] = react.useState(
+    () => initialEditedWords || initEditableWords(transcript, initialMinSilenceMs, initialNlSilenceMs)
+  );
+  const [undoStack, setUndoStack] = react.useState(
+    initialUndoStack || []
+  );
+  const [clipboard, setClipboard] = react.useState(null);
+  const [hasEdits, setHasEdits] = react.useState(() => {
+    if (initialEditedWords) {
+      return initialEditedWords.some((ew) => ew.deleted || ew.inserted);
+    }
+    return false;
+  });
+  const [minSilenceMs, setMinSilenceMs] = react.useState(initialMinSilenceMs);
+  const [nlSilenceMs, setNlSilenceMs] = react.useState(initialNlSilenceMs);
+  const [defaultSpeed, setDefaultSpeed] = react.useState(1);
+  const [speedMarkers, setSpeedMarkers] = react.useState([]);
+  const pushUndo = react.useCallback(() => {
+    setUndoStack((prev) => [...prev, editedWords]);
+  }, [editedWords]);
+  const prevTranscriptRef = react.useRef(transcript);
+  react.useEffect(() => {
+    if (prevTranscriptRef.current === transcript) {
+      return;
+    }
+    prevTranscriptRef.current = transcript;
+    setEditedWords(initEditableWords(transcript, minSilenceMs, nlSilenceMs));
+    setUndoStack([]);
+    setHasEdits(false);
+    setClipboard(null);
+    initializedFromSaved.current = false;
+  }, [transcript, minSilenceMs, nlSilenceMs]);
+  react.useEffect(() => {
+    if (!initializedFromSaved.current && initialEditedWords) {
+      initializedFromSaved.current = true;
+      return;
+    }
+    initializedFromSaved.current = true;
+    if (hasEdits || undoStack.length > 0) {
+      onChange?.(editedWords, undoStack);
+    }
+  }, [editedWords, undoStack, hasEdits, onChange, initialEditedWords]);
+  const undo = react.useCallback(() => {
+    if (undoStack.length === 0) return;
+    const previousState = undoStack[undoStack.length - 1];
+    setUndoStack((prev) => prev.slice(0, -1));
+    setEditedWords(previousState);
+    const isOriginal = previousState.every((ew, i) => ew.originalIndex === i && !ew.deleted) && previousState.length === transcript.words.length;
+    setHasEdits(!isOriginal);
+  }, [undoStack, transcript.words.length]);
+  const toggleWordDeleted = react.useCallback(
+    (index) => {
+      const ew = editedWords[index];
+      if (!ew) return;
+      pushUndo();
+      const newEditedWords = [...editedWords];
+      newEditedWords[index] = { ...ew, deleted: !ew.deleted };
+      setEditedWords(newEditedWords);
+      setHasEdits(true);
+    },
+    [editedWords, pushUndo]
+  );
+  const deleteRange = react.useCallback(
+    (indices) => {
+      if (indices.length === 0) return;
+      const anchor = editedWords[indices[0]];
+      if (!anchor) return;
+      pushUndo();
+      const targetDeletedState = !anchor.deleted;
+      setEditedWords((prev) => {
+        const updated = [...prev];
+        for (const i of indices) {
+          if (updated[i]) {
+            updated[i] = { ...updated[i], deleted: targetDeletedState };
+          }
+        }
+        return updated;
+      });
+      setHasEdits(true);
+    },
+    [editedWords, pushUndo]
+  );
+  const cut = react.useCallback(
+    (indices) => {
+      if (indices.length === 0) return;
+      const cutWords = indices.map((i) => editedWords[i]).filter((ew) => ew !== void 0);
+      if (cutWords.length === 0) return;
+      pushUndo();
+      setClipboard({ words: cutWords, operation: "cut" });
+      setEditedWords((prev) => {
+        const updated = [...prev];
+        for (const i of indices) {
+          if (updated[i]) {
+            updated[i] = { ...updated[i], deleted: true };
+          }
+        }
+        return updated;
+      });
+      setHasEdits(true);
+    },
+    [editedWords, pushUndo]
+  );
+  const copy = react.useCallback(
+    (indices) => {
+      const selectedWords = indices.map((i) => editedWords[i]).filter((ew) => ew !== void 0 && !ew.deleted);
+      if (selectedWords.length === 0) return;
+      setClipboard({ words: selectedWords, operation: "copy" });
+    },
+    [editedWords]
+  );
+  const paste = react.useCallback(
+    (atIndex, before = true) => {
+      if (!clipboard) return null;
+      pushUndo();
+      const insertIndex = before ? atIndex : atIndex + 1;
+      setEditedWords((prev) => {
+        const updated = [...prev];
+        const wordsToInsert = clipboard.words.map((w) => ({
+          ...w,
+          deleted: false,
+          inserted: true
+        }));
+        updated.splice(insertIndex, 0, ...wordsToInsert);
+        return updated;
+      });
+      setHasEdits(true);
+      return insertIndex;
+    },
+    [clipboard, pushUndo]
+  );
+  const setWordText = react.useCallback(
+    (index, text) => {
+      const ew = editedWords[index];
+      if (!ew || text === ew.word.text) return;
+      pushUndo();
+      const newEditedWords = [...editedWords];
+      newEditedWords[index] = {
+        ...ew,
+        word: { ...ew.word, text }
+      };
+      setEditedWords(newEditedWords);
+      setHasEdits(true);
+    },
+    [editedWords, pushUndo]
+  );
+  const splitSilence = react.useCallback(
+    (index, durationsSec) => {
+      const ew = editedWords[index];
+      if (!ew || ew.word.wordType !== "silence") return;
+      pushUndo();
+      const silenceStart = ew.word.startMs;
+      const newSilences = [];
+      let currentMs = silenceStart;
+      for (let i = 0; i < durationsSec.length; i++) {
+        const durationMs = Math.round(durationsSec[i] * 1e3);
+        const endMs = currentMs + durationMs;
+        newSilences.push({
+          originalIndex: -1,
+          // Negative indicates a split/inserted silence
+          word: {
+            text: `[${durationsSec[i].toFixed(1)}s]`,
+            startMs: currentMs,
+            endMs,
+            wordType: "silence"
+          },
+          deleted: false,
+          inserted: true
+        });
+        currentMs = endMs;
+      }
+      const newEditedWords = [...editedWords];
+      newEditedWords.splice(index, 1, ...newSilences);
+      setEditedWords(newEditedWords);
+      setHasEdits(true);
+    },
+    [editedWords, pushUndo]
+  );
+  const deleteWord = react.useCallback(
+    (index) => {
+      toggleWordDeleted(index);
+    },
+    [toggleWordDeleted]
+  );
+  const replaceEditedWords = react.useCallback(
+    (next) => {
+      pushUndo();
+      setEditedWords(next);
+      setHasEdits(true);
+    },
+    [pushUndo]
+  );
+  const removeFillers = react.useCallback(
+    (fillerWords, removeSilenceAboveSec) => {
+      const fillerSet = new Set(fillerWords.map((f) => f.toLowerCase()));
+      const silenceThresholdMs = removeSilenceAboveSec !== null ? removeSilenceAboveSec * 1e3 : null;
+      const newEditedWords = editedWords.map((ew) => {
+        if (ew.deleted) return ew;
+        if ((ew.word.wordType === "silence" || ew.word.wordType === "silence-newline") && silenceThresholdMs !== null) {
+          const durationMs = ew.word.endMs - ew.word.startMs;
+          if (durationMs > silenceThresholdMs) {
+            return { ...ew, deleted: true };
+          }
+          return ew;
+        }
+        if (ew.word.wordType !== "silence" && ew.word.wordType !== "silence-newline") {
+          const wordText = normalizeWordText(ew.word.text);
+          if (fillerSet.has(wordText)) {
+            return { ...ew, deleted: true };
+          }
+        }
+        return ew;
+      });
+      const deletedCount = newEditedWords.filter(
+        (ew, i) => ew.deleted && !editedWords[i].deleted
+      ).length;
+      if (deletedCount > 0) {
+        pushUndo();
+        setEditedWords(newEditedWords);
+        setHasEdits(true);
+      }
+    },
+    [editedWords, pushUndo]
+  );
+  const setSilenceThresholds = react.useCallback(
+    (newMinSilenceMs, newNlSilenceMs) => {
+      setMinSilenceMs(newMinSilenceMs);
+      setNlSilenceMs(newNlSilenceMs);
+      const wordDeletedStatus = /* @__PURE__ */ new Map();
+      editedWords.forEach((ew) => {
+        if (ew.word.wordType !== "silence" && ew.word.wordType !== "silence-newline" && ew.originalIndex >= 0) {
+          wordDeletedStatus.set(ew.originalIndex, ew.deleted);
+        }
+      });
+      const newEditedWords = initEditableWords(
+        transcript,
+        newMinSilenceMs,
+        newNlSilenceMs
+      );
+      let wordIdx = 0;
+      const restoredWords = newEditedWords.map((ew) => {
+        if (ew.word.wordType !== "silence" && ew.word.wordType !== "silence-newline") {
+          const wasDeleted = wordDeletedStatus.get(wordIdx) ?? false;
+          wordIdx++;
+          return { ...ew, deleted: wasDeleted };
+        }
+        return ew;
+      });
+      setEditedWords(restoredWords);
+    },
+    [editedWords, transcript]
+  );
+  const getSpeedMarkerAtIndex = react.useCallback(
+    (wordIndex) => {
+      return speedMarkers.find((m) => m.wordIndex === wordIndex);
+    },
+    [speedMarkers]
+  );
+  const toggleSpeedMarker = react.useCallback(
+    (wordIndex, speed) => {
+      setSpeedMarkers((prev) => {
+        const existingIdx = prev.findIndex((m) => m.wordIndex === wordIndex);
+        if (existingIdx >= 0) {
+          if (prev[existingIdx].speed === speed) {
+            return prev.filter((_, i) => i !== existingIdx);
+          }
+          const updated = [...prev];
+          updated[existingIdx] = { wordIndex, speed };
+          return updated;
+        }
+        return [...prev, { wordIndex, speed }].sort(
+          (a, b) => a.wordIndex - b.wordIndex
+        );
+      });
+      setHasEdits(true);
+    },
+    []
+  );
+  const removeSpeedMarker = react.useCallback(
+    (wordIndex) => {
+      const filtered = speedMarkers.filter((m) => m.wordIndex !== wordIndex);
+      if (filtered.length !== speedMarkers.length) {
+        setSpeedMarkers(filtered);
+        setHasEdits(true);
+      }
+    },
+    [speedMarkers]
+  );
+  const getSpeedAtIndexBound = react.useCallback(
+    (index) => {
+      return getSpeedAtIndex(index, speedMarkers, defaultSpeed);
+    },
+    [speedMarkers, defaultSpeed]
+  );
+  const playbackSegments = react.useMemo(
+    () => buildPlaybackSegments(editedWords),
+    [editedWords]
+  );
+  const stats = react.useMemo(() => {
+    const activeWordCount = editedWords.filter(
+      (ew) => !ew.deleted && ew.word.wordType !== "silence"
+    ).length;
+    const activeSilenceCount = editedWords.filter(
+      (ew) => !ew.deleted && ew.word.wordType === "silence"
+    ).length;
+    const deletedWordCount = editedWords.filter(
+      (ew) => ew.deleted && ew.word.wordType !== "silence"
+    ).length;
+    const deletedSilenceCount = editedWords.filter(
+      (ew) => ew.deleted && ew.word.wordType === "silence"
+    ).length;
+    const editedDurationMs = editedWords.reduce((sum, ew, index) => {
+      if (ew.deleted) return sum;
+      const wordDuration = ew.word.endMs - ew.word.startMs;
+      const speed = getSpeedAtIndex(index, speedMarkers, defaultSpeed);
+      return sum + wordDuration / speed;
+    }, 0);
+    return {
+      activeWordCount,
+      activeSilenceCount,
+      deletedWordCount,
+      deletedSilenceCount,
+      editedDurationMs
+    };
+  }, [editedWords, speedMarkers, defaultSpeed]);
+  const fillerAnalysis = react.useMemo(() => {
+    const matchCounts = /* @__PURE__ */ new Map();
+    for (const ew of editedWords) {
+      if (ew.deleted || ew.word.wordType === "silence") continue;
+      const wordText = normalizeWordText(ew.word.text);
+      for (const filler of DEFAULT_FILLER_WORDS) {
+        if (wordText === filler) {
+          matchCounts.set(filler, (matchCounts.get(filler) || 0) + 1);
+        }
+      }
+      matchCounts.set(wordText, (matchCounts.get(wordText) || 0) + 1);
+    }
+    const durations = /* @__PURE__ */ new Map();
+    for (const ew of editedWords) {
+      if (ew.deleted || ew.word.wordType === "silence" || ew.word.wordType === "silence-newline")
+        continue;
+      const wordText = normalizeWordText(ew.word.text);
+      const wordDuration = ew.word.endMs - ew.word.startMs;
+      for (const filler of DEFAULT_FILLER_WORDS) {
+        if (wordText === filler) {
+          durations.set(filler, (durations.get(filler) || 0) + wordDuration);
+        }
+      }
+      durations.set(wordText, (durations.get(wordText) || 0) + wordDuration);
+    }
+    const silenceCounts = SILENCE_ANALYSIS_THRESHOLDS.map((threshold) => {
+      const thresholdMs = threshold * 1e3;
+      let count = 0;
+      let durationMs = 0;
+      for (const ew of editedWords) {
+        if (ew.deleted) continue;
+        if (ew.word.wordType !== "silence" && ew.word.wordType !== "silence-newline")
+          continue;
+        const silenceDuration = ew.word.endMs - ew.word.startMs;
+        if (silenceDuration > thresholdMs) {
+          count++;
+          durationMs += silenceDuration;
+        }
+      }
+      return { threshold, count, durationMs };
+    });
+    return {
+      matchCounts,
+      durations,
+      silenceCounts,
+      defaultFillerWords: DEFAULT_FILLER_WORDS
+    };
+  }, [editedWords]);
+  return {
+    editedWords,
+    undoStack,
+    clipboard,
+    hasEdits,
+    pushUndo,
+    undo,
+    toggleWordDeleted,
+    deleteRange,
+    cut,
+    copy,
+    paste,
+    setWordText,
+    splitSilence,
+    deleteWord,
+    replaceEditedWords,
+    removeFillers,
+    setSilenceThresholds,
+    silenceThresholds: { minSilenceMs, nlSilenceMs },
+    speedMarkers,
+    defaultSpeed,
+    setDefaultSpeed,
+    toggleSpeedMarker,
+    removeSpeedMarker,
+    getSpeedAtIndex: getSpeedAtIndexBound,
+    getSpeedMarkerAtIndex,
+    playbackSegments,
+    stats,
+    fillerAnalysis
+  };
+}
+
+exports.DEFAULT_FILLER_WORDS = DEFAULT_FILLER_WORDS;
+exports.DEFAULT_MIN_SILENCE_MS = DEFAULT_MIN_SILENCE_MS;
+exports.DEFAULT_NL_SILENCE_MS = DEFAULT_NL_SILENCE_MS;
+exports.buildPlaybackSegments = buildPlaybackSegments;
+exports.getSpeedAtIndex = getSpeedAtIndex;
+exports.initEditableWords = initEditableWords;
+exports.insertSilences = insertSilences;
+exports.useTranscriptEdits = useTranscriptEdits;
+//# sourceMappingURL=chunk-Y4ESBDQ5.cjs.map
+//# sourceMappingURL=chunk-Y4ESBDQ5.cjs.map