@coxwave/tap-kit 2.0.1 → 2.0.3

package/dist/react.js

@@ -1,3 +1,378 @@
-'use strict';var B=require('react'),jsxRuntime=require('react/jsx-runtime');function _interopDefault(e){return e&&e.__esModule?e:{default:e}}var B__default=/*#__PURE__*/_interopDefault(B);var R={"tap-kit:ready":"onReady","tap-kit:error":"onError"},k=Object.keys(R);var X=B__default.default.forwardRef(function({control:t,containerId:i,...s},a){let o=B.useRef(null);B.useImperativeHandle(a,()=>o.current,[]),B.useEffect(()=>{let d=o.current;if(d)return t.setInstance(d),()=>{t.setInstance(null);}},[t.setInstance]),B.useEffect(()=>{let d=o.current;if(!d)return;let l=[];for(let c of k){let p=R[c],_=t.handlers[p];if(_){let f=m=>{let T=m;p==="onError"&&T.detail?.error?_(T.detail.error):p==="onReady"&&_();};d.addEventListener(c,f),l.push({event:c,handler:f});}}return ()=>{for(let{event:c,handler:p}of l)d.removeEventListener(c,p);}},[t]);let{options:r}=t;return jsxRuntime.jsx("tap-kit",{ref:o,"api-key":r.apiKey,"user-id":r.userId,"course-id":r.courseId,"clip-id":r.clipId,"clip-play-head":r.clipPlayHead,language:r.language,"button-id":r.buttonId,"container-id":i,mode:r.mode,debug:r.debug,"tap-url":r.tapUrl,"api-url":r.apiUrl,environment:r.environment,...s})});var W=typeof __DEFAULT_CDN_LOADER_URL__<"u"?__DEFAULT_CDN_LOADER_URL__:"https://files.edutap.ai/tap-sdk/loader.js",Y=4e3,h=500;function Z(){return window?.__TAP_KIT_LOADER_URL__?window.__TAP_KIT_LOADER_URL__:W}function j(){return typeof window<"u"&&!!window.__TAP_KIT_CORE_URL__}function ee(){return window.__TAP_KIT_CORE_URL__||""}function N(n,t,i){let s=Date.now(),a=()=>{if(window.TapKit&&window.TapKitLoaded===true){window.__TAP_KIT_LOADER_LOADED__=true,window.__TAP_KIT_LOADER_LOADING__=void 0,n();return}if(Date.now()-s>i){window.__TAP_KIT_LOADER_LOADING__=void 0,t(new Error(`TapKit loader timeout: SDK not available after ${i}ms`));return}typeof requestIdleCallback<"u"?requestIdleCallback(a,{timeout:h}):setTimeout(a,h);};return a}function H(n=Y){if(window.__TAP_KIT_LOADER_LOADED__&&window.TapKit)return Promise.resolve();if(window.__TAP_KIT_LOADER_LOADING__)return window.__TAP_KIT_LOADER_LOADING__;let t=new Promise((i,s)=>{if(typeof document>"u"){s(new Error("TapKit requires browser environment (document is undefined)"));return}if(j()){if(window.TapKit&&window.TapKitLoaded===true){window.__TAP_KIT_LOADER_LOADED__=true,window.__TAP_KIT_LOADER_LOADING__=void 0,i();return}let d=ee(),l=document.createElement("script");l.src=d,l.async=true,l.onload=()=>{window.TapKit?(window.TapKitLoaded=true,window.__TAP_KIT_LOADER_LOADED__=true,window.__TAP_KIT_LOADER_LOADING__=void 0,i()):(window.__TAP_KIT_LOADER_LOADING__=void 0,s(new Error("TapKit not available after loading local core")));},l.onerror=()=>{window.__TAP_KIT_LOADER_LOADING__=void 0,s(new Error(`Failed to load local TapKit core: ${d}`));},document.head.appendChild(l);return}let a=Z(),o=document.createElement("script");o.src=a,o.async=true,o.onload=()=>{N(i,s,n)();},o.onerror=()=>{window.__TAP_KIT_LOADER_LOADING__=void 0,s(new Error(`Failed to load TapKit CDN loader: ${a}`));};let r=document.querySelector(`script[src="${a}"]`);r?(r.addEventListener("load",()=>{N(i,s,n)();}),r.addEventListener("error",()=>s(new Error(`Failed to load TapKit CDN loader: ${a}`)))):document.head.appendChild(o);});return window.__TAP_KIT_LOADER_LOADING__=t,t}function ne(n){let{onReady:t,onError:i,onTimelineSeek:s,onAlarmFadeIn:a,...o}=n;return o}function te(n){return {onReady:n.onReady,onError:n.onError,onTimelineSeek:n.onTimelineSeek,onAlarmFadeIn:n.onAlarmFadeIn}}function re(n,t){let i=[];return t.onTimelineSeek&&i.push(n.events.onTimelineSeek(t.onTimelineSeek)),t.onAlarmFadeIn&&i.push(n.events.onAlarmFadeIn(t.onAlarmFadeIn)),i}function ie(n){let{onReady:t,onError:i,apiKey:s,userId:a,courseId:o,clipId:r,clipPlayHead:d,language:l,buttonId:c,mode:p="floating",debug:_,tapUrl:f,apiUrl:m,environment:T}=n,u=B.useRef(null),I=B.useRef(null),[E,O]=B.useState(false),[x,M]=B.useState(null),K=B.useRef(true),F=B.useCallback(e=>{I.current=e;},[]),b=B.useCallback(e=>{u.current=e;},[]);B.useEffect(()=>{K.current=true;let e=null;async function D(){try{if(await H(),await customElements.whenDefined("tap-kit"),!K.current||!I.current)return;if(!window.createTapKit)throw new Error("createTapKit not available after loading CDN");if(e=window.createTapKit({apiKey:s,userId:a,courseId:o,clipId:r,clipPlayHead:d,language:l,buttonId:c,mode:p,debug:_,tapUrl:f,apiUrl:m,environment:T}),I.current.appendChild(e),u.current=e,await e.ready,!K.current)return;O(!0),t&&t();}catch(w){let P=w instanceof Error?w:new Error(String(w));K.current&&(M(P),i&&i(P));}}return D(),()=>{K.current=false,e&&(e.remove(),u.current=null),O(false);}},[s,t,i]),B.useEffect(()=>{let e=u.current;!e||!E||(a!==void 0&&(e.userId=a),o!==void 0&&(e.courseId=o),r!==void 0&&(e.clipId=r),d!==void 0&&(e.clipPlayHead=d),l!==void 0&&(e.language=l),c!==void 0&&(e.buttonId=c),p!==void 0&&(e.mode=p),_!==void 0&&(e.debug=_),f!==void 0&&(e.tapUrl=f),m!==void 0&&(e.apiUrl=m),T!==void 0&&(e.environment=T));},[E,a,o,r,d,l,c,p,_,f,m,T]);let C=B.useMemo(()=>ne(n),[n]),L=B.useMemo(()=>te(n),[n]);B.useEffect(()=>{let e=u.current;if(!e||!E)return;let D=re(e,L);return ()=>{for(let w of D)w();}},[E,L]);let G=B.useMemo(()=>({setInstance:b,options:C,handlers:L}),[b,C,L]),V=B.useCallback(()=>{u.current&&u.current.show();},[]),$=B.useCallback(()=>{u.current&&u.current.hide();},[]),q=B.useCallback(e=>{u.current&&u.current.setCourse(e);},[]);return {element:u.current,ref:u,elementRef:F,control:G,isReady:E,error:x,show:V,hide:$,setCourse:q}}
-exports.TapKit=X;exports.useTapKit=ie;//# sourceMappingURL=react.js.map
+'use strict';
+
+var React = require('react');
+var jsxRuntime = require('react/jsx-runtime');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var React__default = /*#__PURE__*/_interopDefault(React);
+
+// src/react/TapKit.tsx
+
+// src/react/types.ts
+var EVENT_HANDLER_MAP = {
+  "tap-kit:ready": "onReady",
+  "tap-kit:error": "onError"
+};
+var EVENT_NAMES = Object.keys(
+  EVENT_HANDLER_MAP
+);
+var TapKit = React__default.default.forwardRef(
+  function TapKit2({ control, ...htmlProps }, forwardedRef) {
+    const elementRef = React.useRef(null);
+    React.useImperativeHandle(
+      forwardedRef,
+      () => elementRef.current,
+      []
+    );
+    const setElementRef = React.useCallback(
+      (element) => {
+        elementRef.current = element;
+        if (element && control.options.apiKey) {
+          element.apiKey = control.options.apiKey;
+        }
+        control.setInstance(element);
+      },
+      [control.setInstance, control.options.apiKey]
+    );
+    const handlersRef = React.useRef(control.handlers);
+    handlersRef.current = control.handlers;
+    React.useEffect(() => {
+      const element = elementRef.current;
+      if (!element) return;
+      const listeners = [];
+      for (const eventName of EVENT_NAMES) {
+        const handlerKey = EVENT_HANDLER_MAP[eventName];
+        const listener = (e) => {
+          const handler = handlersRef.current[handlerKey];
+          if (!handler) return;
+          const customEvent = e;
+          if (handlerKey === "onError" && customEvent.detail?.error) {
+            handler(customEvent.detail.error);
+          } else if (handlerKey === "onReady") {
+            handler();
+          }
+        };
+        element.addEventListener(eventName, listener);
+        listeners.push({ event: eventName, handler: listener });
+      }
+      return () => {
+        for (const { event, handler } of listeners) {
+          element.removeEventListener(event, handler);
+        }
+      };
+    }, []);
+    const { options, isCdnLoaded } = control;
+    if (!isCdnLoaded) {
+      return null;
+    }
+    return /* @__PURE__ */ jsxRuntime.jsx(
+      "tap-kit",
+      {
+        ref: setElementRef,
+        "user-id": options.userId,
+        "course-id": options.courseId,
+        "clip-id": options.clipId,
+        "clip-play-head": options.clipPlayHead,
+        language: options.language,
+        "button-id": options.buttonId,
+        mode: options.mode,
+        debug: options.debug,
+        "tap-url": options.tapUrl,
+        "api-url": options.apiUrl,
+        environment: options.environment,
+        ...htmlProps
+      }
+    );
+  }
+);
+
+// src/loader.ts
+var DEFAULT_CDN_LOADER_URL = typeof __DEFAULT_CDN_LOADER_URL__ !== "undefined" ? __DEFAULT_CDN_LOADER_URL__ : "https://files.edutap.ai/tap-sdk/loader.js";
+var DEFAULT_TIMEOUT_MS = 4e3;
+var IDLE_CALLBACK_TIMEOUT_MS = 500;
+function getLoaderURL() {
+  return window?.__TAP_KIT_LOADER_URL__ ? window.__TAP_KIT_LOADER_URL__ : DEFAULT_CDN_LOADER_URL;
+}
+function isLocalCoreMode() {
+  return typeof window !== "undefined" && !!window.__TAP_KIT_CORE_URL__;
+}
+function getLocalCoreURL() {
+  return window.__TAP_KIT_CORE_URL__ || "";
+}
+function createSDKChecker(resolve, reject, timeoutMs) {
+  const startTime = Date.now();
+  const checkSDK = () => {
+    if (window.TapKit && window.TapKitLoaded === true) {
+      window.__TAP_KIT_LOADER_LOADED__ = true;
+      window.__TAP_KIT_LOADER_LOADING__ = void 0;
+      resolve();
+      return;
+    }
+    const elapsed = Date.now() - startTime;
+    if (elapsed > timeoutMs) {
+      window.__TAP_KIT_LOADER_LOADING__ = void 0;
+      reject(
+        new Error(
+          `TapKit loader timeout: SDK not available after ${timeoutMs}ms`
+        )
+      );
+      return;
+    }
+    if (typeof requestIdleCallback !== "undefined") {
+      requestIdleCallback(checkSDK, { timeout: IDLE_CALLBACK_TIMEOUT_MS });
+    } else {
+      setTimeout(checkSDK, IDLE_CALLBACK_TIMEOUT_MS);
+    }
+  };
+  return checkSDK;
+}
+function loadCDNLoader(timeoutMs = DEFAULT_TIMEOUT_MS) {
+  if (window.__TAP_KIT_LOADER_LOADED__ && window.TapKit) {
+    return Promise.resolve();
+  }
+  if (window.__TAP_KIT_LOADER_LOADING__) {
+    return window.__TAP_KIT_LOADER_LOADING__;
+  }
+  const loadingPromise = new Promise((resolve, reject) => {
+    if (typeof document === "undefined") {
+      reject(
+        new Error(
+          "TapKit requires browser environment (document is undefined)"
+        )
+      );
+      return;
+    }
+    if (isLocalCoreMode()) {
+      if (window.TapKit && window.TapKitLoaded === true) {
+        window.__TAP_KIT_LOADER_LOADED__ = true;
+        window.__TAP_KIT_LOADER_LOADING__ = void 0;
+        resolve();
+        return;
+      }
+      const coreURL = getLocalCoreURL();
+      const script2 = document.createElement("script");
+      script2.src = coreURL;
+      script2.async = true;
+      script2.onload = () => {
+        if (window.TapKit) {
+          window.TapKitLoaded = true;
+          window.__TAP_KIT_LOADER_LOADED__ = true;
+          window.__TAP_KIT_LOADER_LOADING__ = void 0;
+          resolve();
+        } else {
+          window.__TAP_KIT_LOADER_LOADING__ = void 0;
+          reject(new Error("TapKit not available after loading local core"));
+        }
+      };
+      script2.onerror = () => {
+        window.__TAP_KIT_LOADER_LOADING__ = void 0;
+        reject(new Error(`Failed to load local TapKit core: ${coreURL}`));
+      };
+      document.head.appendChild(script2);
+      return;
+    }
+    const loaderURL = getLoaderURL();
+    const script = document.createElement("script");
+    script.src = loaderURL;
+    script.async = true;
+    script.onload = () => {
+      const checkSDK = createSDKChecker(resolve, reject, timeoutMs);
+      checkSDK();
+    };
+    script.onerror = () => {
+      window.__TAP_KIT_LOADER_LOADING__ = void 0;
+      reject(new Error(`Failed to load TapKit CDN loader: ${loaderURL}`));
+    };
+    const existingScript = document.querySelector(`script[src="${loaderURL}"]`);
+    if (existingScript) {
+      existingScript.addEventListener("load", () => {
+        const checkSDK = createSDKChecker(resolve, reject, timeoutMs);
+        checkSDK();
+      });
+      existingScript.addEventListener(
+        "error",
+        () => reject(new Error(`Failed to load TapKit CDN loader: ${loaderURL}`))
+      );
+    } else {
+      document.head.appendChild(script);
+    }
+  });
+  window.__TAP_KIT_LOADER_LOADING__ = loadingPromise;
+  return loadingPromise;
+}
+
+// src/react/useTapKit.ts
+function extractHandlers(options) {
+  return {
+    onReady: options.onReady,
+    onError: options.onError,
+    onTimelineSeek: options.onTimelineSeek,
+    onAlarmFadeIn: options.onAlarmFadeIn
+  };
+}
+function useTapKit(options) {
+  const elementRef = React.useRef(null);
+  const [isCdnLoaded, setIsCdnLoaded] = React.useState(false);
+  const [isReady, setIsReady] = React.useState(false);
+  const [error, setError] = React.useState(null);
+  const handlersRef = React.useRef(extractHandlers(options));
+  handlersRef.current = extractHandlers(options);
+  React.useEffect(() => {
+    loadCDNLoader().then(() => {
+      setIsCdnLoaded(true);
+    }).catch((err) => {
+      const loadError = err instanceof Error ? err : new Error("Failed to load TapKit CDN");
+      setError(loadError);
+      handlersRef.current.onError?.(loadError);
+    });
+  }, []);
+  const setInstance = React.useCallback((instance) => {
+    elementRef.current = instance;
+    if (!instance) {
+      setIsReady(false);
+      return;
+    }
+    const handleReady = () => {
+      setIsReady(true);
+      handlersRef.current.onReady?.();
+    };
+    const handleError = (e) => {
+      const customEvent = e;
+      const err = customEvent.detail?.error ?? new Error("Unknown error");
+      setError(err);
+      handlersRef.current.onError?.(err);
+    };
+    instance.addEventListener("tap-kit:ready", handleReady);
+    instance.addEventListener("tap-kit:error", handleError);
+    if (instance.isInitialized) {
+      setIsReady(true);
+    }
+    const setupEventHandlers = () => {
+      if (instance.events && typeof instance.events.onTimelineSeek === "function") {
+        if (handlersRef.current.onTimelineSeek) {
+          instance.events.onTimelineSeek(handlersRef.current.onTimelineSeek);
+        }
+        if (handlersRef.current.onAlarmFadeIn) {
+          instance.events.onAlarmFadeIn(handlersRef.current.onAlarmFadeIn);
+        }
+      }
+    };
+    if (instance.ready && typeof instance.ready.then === "function") {
+      instance.ready.then(setupEventHandlers).catch(() => {
+      });
+    } else if (instance.isInitialized) {
+      setupEventHandlers();
+    } else {
+      instance.addEventListener("tap-kit:ready", setupEventHandlers, {
+        once: true
+      });
+    }
+  }, []);
+  const configOptions = React.useMemo(
+    () => ({
+      apiKey: options.apiKey,
+      userId: options.userId,
+      courseId: options.courseId,
+      clipId: options.clipId,
+      clipPlayHead: options.clipPlayHead,
+      language: options.language,
+      buttonId: options.buttonId,
+      mode: options.mode,
+      debug: options.debug,
+      tapUrl: options.tapUrl,
+      apiUrl: options.apiUrl,
+      environment: options.environment
+    }),
+    [
+      options.apiKey,
+      options.userId,
+      options.courseId,
+      options.clipId,
+      options.clipPlayHead,
+      options.language,
+      options.buttonId,
+      options.mode,
+      options.debug,
+      options.tapUrl,
+      options.apiUrl,
+      options.environment
+    ]
+  );
+  const handlers = React.useMemo(
+    () => ({
+      onReady: handlersRef.current.onReady,
+      onError: handlersRef.current.onError,
+      onTimelineSeek: handlersRef.current.onTimelineSeek,
+      onAlarmFadeIn: handlersRef.current.onAlarmFadeIn
+    }),
+    // Empty deps - handlers are accessed via ref which is always up-to-date
+    []
+  );
+  const control = React.useMemo(
+    () => ({
+      setInstance,
+      options: configOptions,
+      handlers,
+      isCdnLoaded
+    }),
+    [setInstance, configOptions, handlers, isCdnLoaded]
+  );
+  const show = React.useCallback(() => {
+    if (!elementRef.current) {
+      console.warn("[useTapKit] Cannot show: element not mounted");
+      return;
+    }
+    elementRef.current.show();
+  }, []);
+  const hide = React.useCallback(() => {
+    if (!elementRef.current) {
+      console.warn("[useTapKit] Cannot hide: element not mounted");
+      return;
+    }
+    elementRef.current.hide();
+  }, []);
+  const setCourse = React.useCallback(
+    (course) => {
+      if (!elementRef.current) {
+        console.warn("[useTapKit] Cannot setCourse: element not mounted");
+        return;
+      }
+      elementRef.current.setCourse(course);
+    },
+    []
+  );
+  const video = React.useMemo(
+    () => ({
+      bind: (adapter, clipId) => {
+        if (!elementRef.current) {
+          console.warn("[useTapKit] Cannot bind video: element not mounted");
+          return;
+        }
+        if (!elementRef.current.video) {
+          console.warn("[useTapKit] Cannot bind video: video controller not available");
+          return;
+        }
+        elementRef.current.video.bind(adapter, clipId);
+      },
+      unbind: () => {
+        elementRef.current?.video?.unbind();
+      }
+    }),
+    []
+  );
+  return {
+    control,
+    isReady,
+    error,
+    show,
+    hide,
+    setCourse,
+    video
+  };
+}
+
+exports.TapKit = TapKit;
+exports.useTapKit = useTapKit;
+//# sourceMappingURL=react.js.map
 //# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/react/types.ts","../src/react/TapKit.tsx","../src/loader.ts","../src/react/useTapKit.ts"],"names":["EVENT_HANDLER_MAP","EVENT_NAMES","TapKit","React","control","containerId","htmlProps","forwardedRef","elementRef","useRef","useImperativeHandle","useEffect","element","listeners","eventName","handlerKey","handler","listener","e","customEvent","event","options","jsx","DEFAULT_CDN_LOADER_URL","DEFAULT_TIMEOUT_MS","IDLE_CALLBACK_TIMEOUT_MS","getLoaderURL","isLocalCoreMode","getLocalCoreURL","createSDKChecker","resolve","reject","timeoutMs","startTime","checkSDK","loadCDNLoader","loadingPromise","coreURL","script","loaderURL","existingScript","extractConfig","onReady","onError","onTimelineSeek","onAlarmFadeIn","config","extractHandlers","createEventBindings","handlers","unsubscribers","useTapKit","apiKey","userId","courseId","clipId","clipPlayHead","language","buttonId","mode","debug","tapUrl","apiUrl","environment","containerRef","isReady","setIsReady","useState","error","setError","isMountedRef","setContainerRef","useCallback","node","setInstance","instance","init","err","configOptions","useMemo","unsubscribe","show","hide","setCourse","course"],"mappings":"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","file":"react.js","sourcesContent":["/**\n * React-specific type definitions for TapKit\n *\n * Defines event handler types and control patterns for React integration.\n */\n\nimport type { TapKitElement } from \"@coxwave/tap-kit-types\";\n\n/**\n * Event handler type definitions for TapKit Web Component\n *\n * Maps CustomEvent types to React callback signatures.\n */\nexport interface TapKitEventHandlers {\n  /**\n   * Called when TapKit SDK is ready\n   * @example onReady={() => console.log('TapKit ready!')}\n   */\n  onReady?: () => void;\n\n  /**\n   * Called when initialization or runtime error occurs\n   * @example onError={(error) => console.error('TapKit error:', error)}\n   */\n  onError?: (error: Error) => void;\n\n  /**\n   * Called when timeline seek event occurs\n   * @example onTimelineSeek={(clipPlayHead, clipId) => console.log('Seek:', clipPlayHead)}\n   */\n  onTimelineSeek?: (clipPlayHead: number, clipId: string) => void;\n\n  /**\n   * Called when alarm fade-in occurs\n   * @example onAlarmFadeIn={(messageInfo) => console.log('Alarm:', messageInfo)}\n   */\n  onAlarmFadeIn?: (messageInfo: unknown) => void;\n}\n\n/**\n * Control object pattern for managing TapKit instance\n *\n * Separates instance management (setInstance) from configuration (options)\n * and event handling (handlers). Inspired by ChatKit's control pattern.\n *\n * @example\n * ```tsx\n * const tapkit = useTapKit({ apiKey: 'key', onReady: () => {} });\n * <TapKit control={tapkit.control} />\n * ```\n */\nexport interface TapKitControl<T> {\n  /**\n   * Set the TapKit element instance reference\n   *\n   * Called by TapKit component to register the element instance.\n   * Enables imperative control via useTapKit methods.\n   */\n  setInstance: (instance: TapKitElement | null) => void;\n\n  /**\n   * Configuration options (non-function values)\n   *\n   * All options except event handlers.\n   */\n  options: T;\n\n  /**\n   * Event handler callbacks (function values)\n   *\n   * Separated from options for easier event listener management.\n   */\n  handlers: TapKitEventHandlers;\n}\n\n/**\n * Map of TapKit event names to their handler keys\n *\n * Used for automatic event listener binding in TapKit component.\n *\n * @internal\n */\nexport const EVENT_HANDLER_MAP = {\n  \"tap-kit:ready\": \"onReady\",\n  \"tap-kit:error\": \"onError\",\n} as const;\n\n/**\n * List of TapKit event names\n *\n * @internal\n */\nexport const EVENT_NAMES = Object.keys(\n  EVENT_HANDLER_MAP,\n) as (keyof typeof EVENT_HANDLER_MAP)[];\n","/**\n * TapKit React Component\n *\n * Declarative React wrapper for <tap-kit> Web Component.\n * Use this with useTapKit hook for a clean separation of control and rendering.\n *\n * @example\n * ```tsx\n * 'use client';\n *\n * import { TapKit, useTapKit } from '@coxwave/tap-kit/react';\n *\n * function MyApp() {\n *   const tapkit = useTapKit({\n *     apiKey: 'your-key',\n *     userId: 'user-123',\n *     courseId: 'course-456',\n *     clipId: 'clip-789',\n *     onReady: () => console.log('TapKit ready!'),\n *     onError: (error) => console.error('Error:', error),\n *   });\n *\n *   return (\n *     <div>\n *       <button onClick={tapkit.show} disabled={!tapkit.isReady}>\n *         Show Chat\n *       </button>\n *       <TapKit control={tapkit.control} style={{ height: '600px' }} />\n *     </div>\n *   );\n * }\n * ```\n *\n * **Note for Next.js App Router users:**\n * Make sure to add 'use client' at the top of your component file.\n *\n * @see https://edutap-ai-docs.vercel.app/docs/guides/react\n */\n\nimport type { TapKitElement } from \"@coxwave/tap-kit-types\";\nimport React, { useEffect, useImperativeHandle, useRef } from \"react\";\nimport type { TapKitControl } from \"./types\";\nimport { EVENT_HANDLER_MAP, EVENT_NAMES } from \"./types\";\n\n/**\n * Props for TapKit React component\n */\nexport interface TapKitProps\n  extends Omit<\n    React.HTMLAttributes<TapKitElement>,\n    \"children\" | \"dangerouslySetInnerHTML\"\n  > {\n  /**\n   * Control object from useTapKit hook\n   *\n   * Provides instance management, configuration, and event handlers.\n   */\n  control: TapKitControl<any>;\n\n  /**\n   * Custom container element ID (optional)\n   *\n   * If provided, TapKit will use this element as container.\n   */\n  containerId?: string;\n}\n\n// Augment JSX namespace to support <tap-kit> custom element\ndeclare global {\n  namespace JSX {\n    interface IntrinsicElements {\n      \"tap-kit\": React.DetailedHTMLProps<\n        React.HTMLAttributes<TapKitElement>,\n        TapKitElement\n      > & {\n        \"api-key\"?: string;\n        \"user-id\"?: string;\n        \"course-id\"?: string;\n        \"clip-id\"?: string;\n        \"clip-play-head\"?: number;\n        language?: \"ko\" | \"en\";\n        \"button-id\"?: string;\n        \"container-id\"?: string;\n        mode?: \"inline\" | \"floating\" | \"sidebar\";\n        debug?: boolean;\n        \"tap-url\"?: string;\n        \"api-url\"?: string;\n        environment?: \"dev\" | \"prod\" | \"staging\" | \"demo\";\n      };\n    }\n  }\n}\n\n/**\n * TapKit React Component\n *\n * Renders <tap-kit> Web Component with React integration.\n * Automatically manages instance lifecycle and event listeners.\n *\n * **Ref Access**: The forwarded ref provides direct access to the TapKitElement:\n * ```tsx\n * const tapkitRef = useRef<TapKitElement>(null);\n * <TapKit ref={tapkitRef} control={...} />\n * // tapkitRef.current?.show()\n * ```\n */\nexport const TapKit = React.forwardRef<TapKitElement, TapKitProps>(\n  function TapKit({ control, containerId, ...htmlProps }, forwardedRef) {\n    const elementRef = useRef<TapKitElement | null>(null);\n\n    // Forward TapKitElement to parent\n    useImperativeHandle(\n      forwardedRef,\n      () => elementRef.current as TapKitElement,\n      [],\n    );\n\n    // Register element instance with control\n    useEffect(() => {\n      const element = elementRef.current;\n      if (!element) return;\n\n      control.setInstance(element);\n\n      return () => {\n        control.setInstance(null);\n      };\n    }, [control.setInstance]);\n\n    // Register event listeners\n    useEffect(() => {\n      const element = elementRef.current;\n      if (!element) return;\n\n      const listeners: Array<{\n        event: string;\n        handler: EventListener;\n      }> = [];\n\n      // Bind CustomEvent listeners (tap-kit:ready, tap-kit:error)\n      for (const eventName of EVENT_NAMES) {\n        const handlerKey =\n          EVENT_HANDLER_MAP[eventName as keyof typeof EVENT_HANDLER_MAP];\n        const handler = control.handlers[handlerKey];\n\n        if (handler) {\n          const listener = (e: Event) => {\n            const customEvent = e as CustomEvent;\n            if (handlerKey === \"onError\" && customEvent.detail?.error) {\n              // onError receives error directly\n              // biome-ignore lint/suspicious/noExplicitAny: Handler type is validated at runtime\n              (handler as any)(customEvent.detail.error);\n            } else if (handlerKey === \"onReady\") {\n              // onReady receives no arguments\n              // biome-ignore lint/suspicious/noExplicitAny: Handler type is validated at runtime\n              (handler as any)();\n            }\n          };\n\n          element.addEventListener(eventName, listener);\n          listeners.push({ event: eventName, handler: listener });\n        }\n      }\n\n      return () => {\n        // Cleanup all event listeners\n        for (const { event, handler } of listeners) {\n          element.removeEventListener(event, handler);\n        }\n      };\n    }, [control]);\n\n    const { options } = control;\n\n    // Render <tap-kit> Web Component directly\n    return (\n      <tap-kit\n        ref={elementRef}\n        api-key={options.apiKey}\n        user-id={options.userId}\n        course-id={options.courseId}\n        clip-id={options.clipId}\n        clip-play-head={options.clipPlayHead}\n        language={options.language}\n        button-id={options.buttonId}\n        container-id={containerId}\n        mode={options.mode}\n        debug={options.debug}\n        tap-url={options.tapUrl}\n        api-url={options.apiUrl}\n        environment={options.environment}\n        {...htmlProps}\n      />\n    );\n  },\n);\n","/**\n * CDN loader for TapKit\n * Dynamically loads the TapKit SDK from CDN\n *\n * For local testing, you can override the loader URL:\n * window.__TAP_KIT_LOADER_URL__ = '/tap-kit-core/loader.js';\n *\n * For local development (bypass loader, load IIFE directly):\n * window.__TAP_KIT_CORE_URL__ = '/packages/tap-kit-core/dist/index.global.js';\n */\n\n// Build-time constant injected by tsup define\ndeclare const __DEFAULT_CDN_LOADER_URL__: string;\n\nconst DEFAULT_CDN_LOADER_URL =\n  typeof __DEFAULT_CDN_LOADER_URL__ !== \"undefined\"\n    ? __DEFAULT_CDN_LOADER_URL__\n    : \"https://files.edutap.ai/tap-sdk/loader.js\";\nconst DEFAULT_TIMEOUT_MS = 4000; // 4 seconds total timeout\nconst IDLE_CALLBACK_TIMEOUT_MS = 500; // 500ms for requestIdleCallback\n\n/**\n * Get the loader URL from window override or default CDN\n */\nfunction getLoaderURL(): string {\n  return window?.__TAP_KIT_LOADER_URL__\n    ? window.__TAP_KIT_LOADER_URL__\n    : DEFAULT_CDN_LOADER_URL;\n}\n\n/**\n * Check if local core mode is enabled\n * When __TAP_KIT_CORE_URL__ is set, directly load the IIFE bundle\n * This bypasses the loader.js and loads tap-kit-core directly\n */\nfunction isLocalCoreMode(): boolean {\n  return typeof window !== \"undefined\" && !!window.__TAP_KIT_CORE_URL__;\n}\n\n/**\n * Get the local core URL\n */\nfunction getLocalCoreURL(): string {\n  return window.__TAP_KIT_CORE_URL__ || \"\";\n}\n\n/**\n * Creates a SDK checker function with timeout and retry logic\n * Uses requestIdleCallback to avoid blocking browser rendering\n * @param resolve - Promise resolve function\n * @param reject - Promise reject function\n * @param timeoutMs - Maximum time to wait for SDK to load (milliseconds)\n * @returns Checker function to be called repeatedly\n */\nfunction createSDKChecker(\n  resolve: (value: void | PromiseLike<void>) => void,\n  reject: (reason?: unknown) => void,\n  timeoutMs: number,\n): () => void {\n  const startTime = Date.now();\n\n  const checkSDK = (): void => {\n    // Check if real TapKit is loaded (not just stub)\n    // Stub has TapKitLoaded flag set to true by loader.js after real SDK loads\n    if (window.TapKit && window.TapKitLoaded === true) {\n      window.__TAP_KIT_LOADER_LOADED__ = true;\n      window.__TAP_KIT_LOADER_LOADING__ = undefined;\n      resolve();\n      return;\n    }\n\n    const elapsed = Date.now() - startTime;\n\n    // Check if exceeded timeout\n    if (elapsed > timeoutMs) {\n      window.__TAP_KIT_LOADER_LOADING__ = undefined;\n      reject(\n        new Error(\n          `TapKit loader timeout: SDK not available after ${timeoutMs}ms`,\n        ),\n      );\n      return;\n    }\n\n    // Use requestIdleCallback for better performance\n    // Falls back to setTimeout if not available\n    if (typeof requestIdleCallback !== \"undefined\") {\n      requestIdleCallback(checkSDK, { timeout: IDLE_CALLBACK_TIMEOUT_MS });\n    } else {\n      setTimeout(checkSDK, IDLE_CALLBACK_TIMEOUT_MS);\n    }\n  };\n\n  return checkSDK;\n}\n\n/**\n * Loads the CDN loader script\n * The loader will then fetch versions.json and load the appropriate SDK version\n *\n * If __TAP_KIT_CORE_URL__ is set, bypasses loader and loads IIFE directly\n *\n * @param timeoutMs - Maximum time to wait for SDK to load (default: 4000ms)\n * @returns Promise that resolves when SDK is loaded\n * @throws {Error} If loader fails to load or times out\n */\nexport function loadCDNLoader(\n  timeoutMs: number = DEFAULT_TIMEOUT_MS,\n): Promise<void> {\n  // If already loaded, return immediately\n  if (window.__TAP_KIT_LOADER_LOADED__ && window.TapKit) {\n    return Promise.resolve();\n  }\n\n  // If currently loading, return the existing promise\n  if (window.__TAP_KIT_LOADER_LOADING__) {\n    return window.__TAP_KIT_LOADER_LOADING__;\n  }\n\n  // Create loading promise\n  const loadingPromise = new Promise<void>((resolve, reject) => {\n    if (typeof document === \"undefined\") {\n      reject(\n        new Error(\n          \"TapKit requires browser environment (document is undefined)\",\n        ),\n      );\n      return;\n    }\n\n    // Local core mode: Load IIFE directly\n    if (isLocalCoreMode()) {\n      // Check if TapKit is already loaded (from other pages in playground)\n      if (window.TapKit && window.TapKitLoaded === true) {\n        window.__TAP_KIT_LOADER_LOADED__ = true;\n        window.__TAP_KIT_LOADER_LOADING__ = undefined;\n        resolve();\n        return;\n      }\n\n      const coreURL = getLocalCoreURL();\n\n      const script = document.createElement(\"script\");\n      script.src = coreURL;\n      script.async = true;\n\n      script.onload = () => {\n        // IIFE directly sets window.TapKit\n        // Set the loaded flag manually since we bypass loader.js\n        if (window.TapKit) {\n          window.TapKitLoaded = true;\n          window.__TAP_KIT_LOADER_LOADED__ = true;\n          window.__TAP_KIT_LOADER_LOADING__ = undefined;\n          resolve();\n        } else {\n          window.__TAP_KIT_LOADER_LOADING__ = undefined;\n          reject(new Error(\"TapKit not available after loading local core\"));\n        }\n      };\n\n      script.onerror = () => {\n        window.__TAP_KIT_LOADER_LOADING__ = undefined;\n        reject(new Error(`Failed to load local TapKit core: ${coreURL}`));\n      };\n\n      document.head.appendChild(script);\n      return;\n    }\n\n    // CDN mode: Load loader.js\n    const loaderURL = getLoaderURL();\n    const script = document.createElement(\"script\");\n    script.src = loaderURL;\n    script.async = true;\n\n    script.onload = () => {\n      // The loader script will load the actual SDK\n      // We need to wait a bit for the loader to fetch and load the SDK\n      const checkSDK = createSDKChecker(resolve, reject, timeoutMs);\n      checkSDK();\n    };\n\n    script.onerror = () => {\n      window.__TAP_KIT_LOADER_LOADING__ = undefined;\n      reject(new Error(`Failed to load TapKit CDN loader: ${loaderURL}`));\n    };\n\n    // Check if script already exists\n    const existingScript = document.querySelector(`script[src=\"${loaderURL}\"]`);\n\n    if (existingScript) {\n      // Script already added but not yet loaded\n      existingScript.addEventListener(\"load\", () => {\n        const checkSDK = createSDKChecker(resolve, reject, timeoutMs);\n        checkSDK();\n      });\n      existingScript.addEventListener(\"error\", () =>\n        reject(new Error(`Failed to load TapKit CDN loader: ${loaderURL}`)),\n      );\n    } else {\n      document.head.appendChild(script);\n    }\n  });\n\n  window.__TAP_KIT_LOADER_LOADING__ = loadingPromise;\n  return loadingPromise;\n}\n","/**\n * useTapKit Hook - Advanced imperative control of TapKit Web Component\n *\n * This hook provides direct access to the TapKitElement instance and full\n * control over its lifecycle. Use this when you need:\n * - Direct element manipulation\n * - Custom rendering logic\n * - Imperative control over Web Component behavior\n *\n * For most use cases, prefer the `<TapKit />` component which provides a\n * simpler declarative API.\n *\n * @param options - TapKit configuration\n * @returns Object with element reference, state, and control methods\n *\n * @example Advanced control with custom rendering\n * ```tsx\n * 'use client';\n *\n * import { useTapKit } from '@coxwave/tap-kit/react';\n *\n * function MyComponent() {\n *   const { element, elementRef, show, hide, isReady, error } = useTapKit({\n *     apiKey: 'your-key',\n *     userId: 'user-123',\n *     courseId: 'course-456',\n *     clipId: 'clip-789',\n *   });\n *\n *   // Direct element access for advanced operations\n *   useEffect(() => {\n *     if (element) {\n *       // Direct manipulation of TapKitElement\n *       console.log('Element mounted:', element);\n *     }\n *   }, [element]);\n *\n *   return (\n *     <div>\n *       <button onClick={show} disabled={!isReady}>Show Chat</button>\n *       <button onClick={hide}>Hide Chat</button>\n *       {error && <p>Error: {error.message}</p>}\n *       <div ref={elementRef} /> // Container for Web Component\n *     </div>\n *   );\n * }\n * ```\n *\n * @see TapKit - Use this component for simpler declarative API\n */\n\nimport type { TapKitConfig, TapKitElement } from \"@coxwave/tap-kit-types\";\nimport { useCallback, useEffect, useMemo, useRef, useState } from \"react\";\nimport { loadCDNLoader } from \"../loader\";\nimport type { TapKitControl, TapKitEventHandlers } from \"./types\";\n\nexport interface UseTapKitOptions extends TapKitConfig, TapKitEventHandlers {\n  /** User ID */\n  userId?: string;\n  /** Course ID */\n  courseId?: string;\n  /** Clip ID */\n  clipId?: string;\n  /** Clip playhead position */\n  clipPlayHead?: number;\n  /** Language */\n  language?: \"ko\" | \"en\";\n  /** Custom button element ID */\n  buttonId?: string;\n  /** Display mode */\n  mode?: \"inline\" | \"floating\" | \"sidebar\";\n  /** Debug mode */\n  debug?: boolean;\n  /** TAP Frontend URL */\n  tapUrl?: string;\n  /** API Backend URL */\n  apiUrl?: string;\n  /** Environment */\n  environment?: \"dev\" | \"prod\" | \"staging\" | \"demo\";\n}\n\n/**\n * Configuration options type (non-function values)\n */\ntype TapKitOptions = Omit<UseTapKitOptions, keyof TapKitEventHandlers>;\n\n/**\n * Extract configuration from options (pure function)\n */\nfunction extractConfig(options: UseTapKitOptions): TapKitOptions {\n  const { onReady, onError, onTimelineSeek, onAlarmFadeIn, ...config } =\n    options;\n  return config;\n}\n\n/**\n * Extract event handlers from options (pure function)\n */\nfunction extractHandlers(options: UseTapKitOptions): TapKitEventHandlers {\n  return {\n    onReady: options.onReady,\n    onError: options.onError,\n    onTimelineSeek: options.onTimelineSeek,\n    onAlarmFadeIn: options.onAlarmFadeIn,\n  };\n}\n\n/**\n * Create event bindings for TapKitElement (pure function)\n */\nfunction createEventBindings(\n  element: TapKitElement,\n  handlers: TapKitEventHandlers,\n): Array<() => void> {\n  const unsubscribers: Array<() => void> = [];\n\n  if (handlers.onTimelineSeek) {\n    unsubscribers.push(element.events.onTimelineSeek(handlers.onTimelineSeek));\n  }\n\n  if (handlers.onAlarmFadeIn) {\n    unsubscribers.push(element.events.onAlarmFadeIn(handlers.onAlarmFadeIn));\n  }\n\n  return unsubscribers;\n}\n\nexport interface UseTapKitReturn {\n  /** Web Component element reference */\n  element: TapKitElement | null;\n  /** Ref object for direct element access */\n  ref: React.RefObject<TapKitElement | null>;\n  /** Container ref to attach element */\n  elementRef: React.RefCallback<HTMLDivElement>;\n  /** Control object for TapKit component */\n  control: TapKitControl<TapKitOptions>;\n  /** Whether TapKit is ready */\n  isReady: boolean;\n  /** Error during initialization */\n  error: Error | null;\n  /** Show chat interface */\n  show: () => void;\n  /** Hide chat interface */\n  hide: () => void;\n  /** Set course information */\n  setCourse: (course: {\n    courseId: string;\n    clipId: string;\n    userId?: string;\n    clipPlayHead?: number;\n  }) => void;\n}\n\n/**\n * Hook for managing TapKit Web Component\n *\n * Automatically loads CDN, creates Web Component, and provides control methods.\n *\n * @param options - TapKit configuration with event handlers\n * @returns Methods to control TapKit instance and control object\n */\nexport function useTapKit(options: UseTapKitOptions): UseTapKitReturn {\n  const {\n    // Event handlers (used in init effect)\n    onReady,\n    onError,\n    // Configuration\n    apiKey,\n    userId,\n    courseId,\n    clipId,\n    clipPlayHead,\n    language,\n    buttonId,\n    mode = \"floating\",\n    debug,\n    tapUrl,\n    apiUrl,\n    environment,\n  } = options;\n\n  const elementRef = useRef<TapKitElement | null>(null);\n  const containerRef = useRef<HTMLDivElement | null>(null);\n  const [isReady, setIsReady] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const isMountedRef = useRef(true);\n\n  // Ref callback to attach container\n  const setContainerRef = useCallback((node: HTMLDivElement | null) => {\n    containerRef.current = node;\n  }, []);\n\n  // Set instance callback for control pattern\n  const setInstance = useCallback((instance: TapKitElement | null) => {\n    elementRef.current = instance;\n  }, []);\n\n  // Initialize Web Component\n  // biome-ignore lint/correctness/useExhaustiveDependencies: We intentionally only re-initialize when apiKey changes. Other props are updated dynamically via the second useEffect.\n  useEffect(() => {\n    isMountedRef.current = true;\n    let element: TapKitElement | null = null;\n\n    async function init() {\n      try {\n        // Load CDN\n        await loadCDNLoader();\n\n        // Wait for custom element definition\n        await customElements.whenDefined(\"tap-kit\");\n\n        if (!isMountedRef.current || !containerRef.current) return;\n\n        // Create Web Component\n        if (!window.createTapKit) {\n          throw new Error(\"createTapKit not available after loading CDN\");\n        }\n\n        element = window.createTapKit({\n          apiKey,\n          userId,\n          courseId,\n          clipId,\n          clipPlayHead,\n          language,\n          buttonId,\n          mode,\n          debug,\n          tapUrl,\n          apiUrl,\n          environment,\n        });\n\n        containerRef.current.appendChild(element);\n        elementRef.current = element;\n\n        // Wait for ready\n        await element.ready;\n\n        if (!isMountedRef.current) return;\n        setIsReady(true);\n\n        // Call onReady handler if provided\n        if (onReady) {\n          onReady();\n        }\n      } catch (err) {\n        const error = err instanceof Error ? err : new Error(String(err));\n        console.error(\"[useTapKit] Initialization failed:\", error);\n        if (isMountedRef.current) {\n          setError(error);\n          // Call onError handler if provided\n          if (onError) {\n            onError(error);\n          }\n        }\n      }\n    }\n\n    init();\n\n    return () => {\n      isMountedRef.current = false;\n      if (element) {\n        element.remove();\n        elementRef.current = null;\n      }\n      setIsReady(false);\n    };\n  }, [apiKey, onReady, onError]); // Re-initialize on apiKey or handlers change\n\n  // Update properties when options change\n  useEffect(() => {\n    const element = elementRef.current;\n    if (!element || !isReady) return;\n\n    if (userId !== undefined) element.userId = userId;\n    if (courseId !== undefined) element.courseId = courseId;\n    if (clipId !== undefined) element.clipId = clipId;\n    if (clipPlayHead !== undefined) element.clipPlayHead = clipPlayHead;\n    if (language !== undefined) element.language = language;\n    if (buttonId !== undefined) element.buttonId = buttonId;\n    if (mode !== undefined) element.mode = mode;\n    if (debug !== undefined) element.debug = debug;\n    if (tapUrl !== undefined) element.tapUrl = tapUrl;\n    if (apiUrl !== undefined) element.apiUrl = apiUrl;\n    if (environment !== undefined) element.environment = environment;\n  }, [\n    isReady,\n    userId,\n    courseId,\n    clipId,\n    clipPlayHead,\n    language,\n    buttonId,\n    mode,\n    debug,\n    tapUrl,\n    apiUrl,\n    environment,\n  ]);\n\n  // Separate configuration options from event handlers (memoized)\n  const configOptions = useMemo(() => extractConfig(options), [options]);\n\n  const handlers = useMemo(() => extractHandlers(options), [options]);\n\n  // Register event listeners for EventManager callbacks\n  useEffect(() => {\n    const element = elementRef.current;\n    if (!element || !isReady) return;\n\n    const unsubscribers = createEventBindings(element, handlers);\n\n    return () => {\n      for (const unsubscribe of unsubscribers) {\n        unsubscribe();\n      }\n    };\n  }, [isReady, handlers]);\n\n  // Create control object\n  const control = useMemo<TapKitControl<TapKitOptions>>(\n    () => ({\n      setInstance,\n      options: configOptions,\n      handlers,\n    }),\n    [setInstance, configOptions, handlers],\n  );\n\n  // Methods\n  const show = useCallback(() => {\n    if (!elementRef.current) {\n      console.warn(\"[useTapKit] Cannot show: element not mounted\");\n      return;\n    }\n    elementRef.current.show();\n  }, []);\n\n  const hide = useCallback(() => {\n    if (!elementRef.current) {\n      console.warn(\"[useTapKit] Cannot hide: element not mounted\");\n      return;\n    }\n    elementRef.current.hide();\n  }, []);\n\n  const setCourse = useCallback(\n    (course: {\n      courseId: string;\n      clipId: string;\n      userId?: string;\n      clipPlayHead?: number;\n    }) => {\n      if (!elementRef.current) {\n        console.warn(\"[useTapKit] Cannot setCourse: element not mounted\");\n        return;\n      }\n      elementRef.current.setCourse(course);\n    },\n    [],\n  );\n\n  return {\n    element: elementRef.current,\n    ref: elementRef,\n    elementRef: setContainerRef,\n    control,\n    isReady,\n    error,\n    show,\n    hide,\n    setCourse,\n  };\n}\n"]}
+{"version":3,"sources":["../src/react/types.ts","../src/react/TapKit.tsx","../src/loader.ts","../src/react/useTapKit.ts"],"names":["React","TapKit","useRef","useImperativeHandle","useCallback","useEffect","jsx","script","useState","useMemo"],"mappings":";;;;;;;;;;;;AAyFO,IAAM,iBAAA,GAAoB;AAAA,EAC/B,eAAA,EAAiB,SAAA;AAAA,EACjB,eAAA,EAAiB;AACnB,CAAA;AAOO,IAAM,cAAc,MAAA,CAAO,IAAA;AAAA,EAChC;AACF,CAAA;ACEO,IAAM,SAASA,sBAAA,CAAM,UAAA;AAAA,EAC1B,SAASC,OAAAA,CAAO,EAAE,SAAS,GAAG,SAAA,IAAa,YAAA,EAAc;AACvD,IAAA,MAAM,UAAA,GAAaC,aAA6B,IAAI,CAAA;AAGpD,IAAAC,yBAAA;AAAA,MACE,YAAA;AAAA,MACA,MAAM,UAAA,CAAW,OAAA;AAAA,MACjB;AAAC,KACH;AAGA,IAAA,MAAM,aAAA,GAAgBC,iBAAA;AAAA,MACpB,CAAC,OAAA,KAAkC;AACjC,QAAA,UAAA,CAAW,OAAA,GAAU,OAAA;AAIrB,QAAA,IAAI,OAAA,IAAW,OAAA,CAAQ,OAAA,CAAQ,MAAA,EAAQ;AACrC,UAAA,OAAA,CAAQ,MAAA,GAAS,QAAQ,OAAA,CAAQ,MAAA;AAAA,QACnC;AAEA,QAAA,OAAA,CAAQ,YAAY,OAAO,CAAA;AAAA,MAC7B,CAAA;AAAA,MACA,CAAC,OAAA,CAAQ,WAAA,EAAa,OAAA,CAAQ,QAAQ,MAAM;AAAA,KAC9C;AAIA,IAAA,MAAM,WAAA,GAAcF,YAAA,CAAO,OAAA,CAAQ,QAAQ,CAAA;AAC3C,IAAA,WAAA,CAAY,UAAU,OAAA,CAAQ,QAAA;AAG9B,IAAAG,eAAA,CAAU,MAAM;AACd,MAAA,MAAM,UAAU,UAAA,CAAW,OAAA;AAC3B,MAAA,IAAI,CAAC,OAAA,EAAS;AAEd,MAAA,MAAM,YAGD,EAAC;AAGN,MAAA,KAAA,MAAW,aAAa,WAAA,EAAa;AACnC,QAAA,MAAM,UAAA,GACJ,kBAAkB,SAA2C,CAAA;AAG/D,QAAA,MAAM,QAAA,GAAW,CAAC,CAAA,KAAa;AAC7B,UAAA,MAAM,OAAA,GAAU,WAAA,CAAY,OAAA,CAAQ,UAAU,CAAA;AAC9C,UAAA,IAAI,CAAC,OAAA,EAAS;AAEd,UAAA,MAAM,WAAA,GAAc,CAAA;AACpB,UAAA,IAAI,UAAA,KAAe,SAAA,IAAa,WAAA,CAAY,MAAA,EAAQ,KAAA,EAAO;AAGzD,YAAC,OAAA,CAAgB,WAAA,CAAY,MAAA,CAAO,KAAK,CAAA;AAAA,UAC3C,CAAA,MAAA,IAAW,eAAe,SAAA,EAAW;AAGnC,YAAC,OAAA,EAAgB;AAAA,UACnB;AAAA,QACF,CAAA;AAEA,QAAA,OAAA,CAAQ,gBAAA,CAAiB,WAAW,QAAQ,CAAA;AAC5C,QAAA,SAAA,CAAU,KAAK,EAAE,KAAA,EAAO,SAAA,EAAW,OAAA,EAAS,UAAU,CAAA;AAAA,MACxD;AAEA,MAAA,OAAO,MAAM;AAEX,QAAA,KAAA,MAAW,EAAE,KAAA,EAAO,OAAA,EAAQ,IAAK,SAAA,EAAW;AAC1C,UAAA,OAAA,CAAQ,mBAAA,CAAoB,OAAO,OAAO,CAAA;AAAA,QAC5C;AAAA,MACF,CAAA;AAAA,IACF,CAAA,EAAG,EAAE,CAAA;AAEL,IAAA,MAAM,EAAE,OAAA,EAAS,WAAA,EAAY,GAAI,OAAA;AAIjC,IAAA,IAAI,CAAC,WAAA,EAAa;AAChB,MAAA,OAAO,IAAA;AAAA,IACT;AAIA,IAAA,uBACEC,cAAA;AAAA,MAAC,SAAA;AAAA,MAAA;AAAA,QACC,GAAA,EAAK,aAAA;AAAA,QACL,WAAS,OAAA,CAAQ,MAAA;AAAA,QACjB,aAAW,OAAA,CAAQ,QAAA;AAAA,QACnB,WAAS,OAAA,CAAQ,MAAA;AAAA,QACjB,kBAAgB,OAAA,CAAQ,YAAA;AAAA,QACxB,UAAU,OAAA,CAAQ,QAAA;AAAA,QAClB,aAAW,OAAA,CAAQ,QAAA;AAAA,QACnB,MAAM,OAAA,CAAQ,IAAA;AAAA,QACd,OAAO,OAAA,CAAQ,KAAA;AAAA,QACf,WAAS,OAAA,CAAQ,MAAA;AAAA,QACjB,WAAS,OAAA,CAAQ,MAAA;AAAA,QACjB,aAAa,OAAA,CAAQ,WAAA;AAAA,QACpB,GAAG;AAAA;AAAA,KACN;AAAA,EAEJ;AACF;;;ACjMA,IAAM,sBAAA,GACJ,OAAO,0BAAA,KAA+B,WAAA,GAClC,0BAAA,GACA,2CAAA;AACN,IAAM,kBAAA,GAAqB,GAAA;AAC3B,IAAM,wBAAA,GAA2B,GAAA;AAKjC,SAAS,YAAA,GAAuB;AAC9B,EAAA,OAAO,MAAA,EAAQ,sBAAA,GACX,MAAA,CAAO,sBAAA,GACP,sBAAA;AACN;AAOA,SAAS,eAAA,GAA2B;AAClC,EAAA,OAAO,OAAO,MAAA,KAAW,WAAA,IAAe,CAAC,CAAC,MAAA,CAAO,oBAAA;AACnD;AAKA,SAAS,eAAA,GAA0B;AACjC,EAAA,OAAO,OAAO,oBAAA,IAAwB,EAAA;AACxC;AAUA,SAAS,gBAAA,CACP,OAAA,EACA,MAAA,EACA,SAAA,EACY;AACZ,EAAA,MAAM,SAAA,GAAY,KAAK,GAAA,EAAI;AAE3B,EAAA,MAAM,WAAW,MAAY;AAG3B,IAAA,IAAI,MAAA,CAAO,MAAA,IAAU,MAAA,CAAO,YAAA,KAAiB,IAAA,EAAM;AACjD,MAAA,MAAA,CAAO,yBAAA,GAA4B,IAAA;AACnC,MAAA,MAAA,CAAO,0BAAA,GAA6B,MAAA;AACpC,MAAA,OAAA,EAAQ;AACR,MAAA;AAAA,IACF;AAEA,IAAA,MAAM,OAAA,GAAU,IAAA,CAAK,GAAA,EAAI,GAAI,SAAA;AAG7B,IAAA,IAAI,UAAU,SAAA,EAAW;AACvB,MAAA,MAAA,CAAO,0BAAA,GAA6B,MAAA;AACpC,MAAA,MAAA;AAAA,QACE,IAAI,KAAA;AAAA,UACF,kDAAkD,SAAS,CAAA,EAAA;AAAA;AAC7D,OACF;AACA,MAAA;AAAA,IACF;AAIA,IAAA,IAAI,OAAO,wBAAwB,WAAA,EAAa;AAC9C,MAAA,mBAAA,CAAoB,QAAA,EAAU,EAAE,OAAA,EAAS,wBAAA,EAA0B,CAAA;AAAA,IACrE,CAAA,MAAO;AACL,MAAA,UAAA,CAAW,UAAU,wBAAwB,CAAA;AAAA,IAC/C;AAAA,EACF,CAAA;AAEA,EAAA,OAAO,QAAA;AACT;AAYO,SAAS,aAAA,CACd,YAAoB,kBAAA,EACL;AAEf,EAAA,IAAI,MAAA,CAAO,yBAAA,IAA6B,MAAA,CAAO,MAAA,EAAQ;AACrD,IAAA,OAAO,QAAQ,OAAA,EAAQ;AAAA,EACzB;AAGA,EAAA,IAAI,OAAO,0BAAA,EAA4B;AACrC,IAAA,OAAO,MAAA,CAAO,0BAAA;AAAA,EAChB;AAGA,EAAA,MAAM,cAAA,GAAiB,IAAI,OAAA,CAAc,CAAC,SAAS,MAAA,KAAW;AAC5D,IAAA,IAAI,OAAO,aAAa,WAAA,EAAa;AACnC,MAAA,MAAA;AAAA,QACE,IAAI,KAAA;AAAA,UACF;AAAA;AACF,OACF;AACA,MAAA;AAAA,IACF;AAGA,IAAA,IAAI,iBAAgB,EAAG;AAErB,MAAA,IAAI,MAAA,CAAO,MAAA,IAAU,MAAA,CAAO,YAAA,KAAiB,IAAA,EAAM;AACjD,QAAA,MAAA,CAAO,yBAAA,GAA4B,IAAA;AACnC,QAAA,MAAA,CAAO,0BAAA,GAA6B,MAAA;AACpC,QAAA,OAAA,EAAQ;AACR,QAAA;AAAA,MACF;AAEA,MAAA,MAAM,UAAU,eAAA,EAAgB;AAEhC,MAAA,MAAMC,OAAAA,GAAS,QAAA,CAAS,aAAA,CAAc,QAAQ,CAAA;AAC9C,MAAAA,QAAO,GAAA,GAAM,OAAA;AACb,MAAAA,QAAO,KAAA,GAAQ,IAAA;AAEf,MAAAA,OAAAA,CAAO,SAAS,MAAM;AAGpB,QAAA,IAAI,OAAO,MAAA,EAAQ;AACjB,UAAA,MAAA,CAAO,YAAA,GAAe,IAAA;AACtB,UAAA,MAAA,CAAO,yBAAA,GAA4B,IAAA;AACnC,UAAA,MAAA,CAAO,0BAAA,GAA6B,MAAA;AACpC,UAAA,OAAA,EAAQ;AAAA,QACV,CAAA,MAAO;AACL,UAAA,MAAA,CAAO,0BAAA,GAA6B,MAAA;AACpC,UAAA,MAAA,CAAO,IAAI,KAAA,CAAM,+CAA+C,CAAC,CAAA;AAAA,QACnE;AAAA,MACF,CAAA;AAEA,MAAAA,OAAAA,CAAO,UAAU,MAAM;AACrB,QAAA,MAAA,CAAO,0BAAA,GAA6B,MAAA;AACpC,QAAA,MAAA,CAAO,IAAI,KAAA,CAAM,CAAA,kCAAA,EAAqC,OAAO,EAAE,CAAC,CAAA;AAAA,MAClE,CAAA;AAEA,MAAA,QAAA,CAAS,IAAA,CAAK,YAAYA,OAAM,CAAA;AAChC,MAAA;AAAA,IACF;AAGA,IAAA,MAAM,YAAY,YAAA,EAAa;AAC/B,IAAA,MAAM,MAAA,GAAS,QAAA,CAAS,aAAA,CAAc,QAAQ,CAAA;AAC9C,IAAA,MAAA,CAAO,GAAA,GAAM,SAAA;AACb,IAAA,MAAA,CAAO,KAAA,GAAQ,IAAA;AAEf,IAAA,MAAA,CAAO,SAAS,MAAM;AAGpB,MAAA,MAAM,QAAA,GAAW,gBAAA,CAAiB,OAAA,EAAS,MAAA,EAAQ,SAAS,CAAA;AAC5D,MAAA,QAAA,EAAS;AAAA,IACX,CAAA;AAEA,IAAA,MAAA,CAAO,UAAU,MAAM;AACrB,MAAA,MAAA,CAAO,0BAAA,GAA6B,MAAA;AACpC,MAAA,MAAA,CAAO,IAAI,KAAA,CAAM,CAAA,kCAAA,EAAqC,SAAS,EAAE,CAAC,CAAA;AAAA,IACpE,CAAA;AAGA,IAAA,MAAM,cAAA,GAAiB,QAAA,CAAS,aAAA,CAAc,CAAA,YAAA,EAAe,SAAS,CAAA,EAAA,CAAI,CAAA;AAE1E,IAAA,IAAI,cAAA,EAAgB;AAElB,MAAA,cAAA,CAAe,gBAAA,CAAiB,QAAQ,MAAM;AAC5C,QAAA,MAAM,QAAA,GAAW,gBAAA,CAAiB,OAAA,EAAS,MAAA,EAAQ,SAAS,CAAA;AAC5D,QAAA,QAAA,EAAS;AAAA,MACX,CAAC,CAAA;AACD,MAAA,cAAA,CAAe,gBAAA;AAAA,QAAiB,OAAA;AAAA,QAAS,MACvC,MAAA,CAAO,IAAI,MAAM,CAAA,kCAAA,EAAqC,SAAS,EAAE,CAAC;AAAA,OACpE;AAAA,IACF,CAAA,MAAO;AACL,MAAA,QAAA,CAAS,IAAA,CAAK,YAAY,MAAM,CAAA;AAAA,IAClC;AAAA,EACF,CAAC,CAAA;AAED,EAAA,MAAA,CAAO,0BAAA,GAA6B,cAAA;AACpC,EAAA,OAAO,cAAA;AACT;;;ACpIA,SAAS,gBAAgB,OAAA,EAAgD;AACvE,EAAA,OAAO;AAAA,IACL,SAAS,OAAA,CAAQ,OAAA;AAAA,IACjB,SAAS,OAAA,CAAQ,OAAA;AAAA,IACjB,gBAAgB,OAAA,CAAQ,cAAA;AAAA,IACxB,eAAe,OAAA,CAAQ;AAAA,GACzB;AACF;AAyCO,SAAS,UAAU,OAAA,EAA4C;AAEpE,EAAA,MAAM,UAAA,GAAaL,aAA6B,IAAI,CAAA;AAGpD,EAAA,MAAM,CAAC,WAAA,EAAa,cAAc,CAAA,GAAIM,eAAS,KAAK,CAAA;AACpD,EAAA,MAAM,CAAC,OAAA,EAAS,UAAU,CAAA,GAAIA,eAAS,KAAK,CAAA;AAC5C,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAIA,eAAuB,IAAI,CAAA;AAGrD,EAAA,MAAM,WAAA,GAAcN,YAAAA,CAAO,eAAA,CAAgB,OAAO,CAAC,CAAA;AACnD,EAAA,WAAA,CAAY,OAAA,GAAU,gBAAgB,OAAO,CAAA;AAG7C,EAAAG,gBAAU,MAAM;AACd,IAAA,aAAA,EAAc,CACX,KAAK,MAAM;AACV,MAAA,cAAA,CAAe,IAAI,CAAA;AAAA,IACrB,CAAC,CAAA,CACA,KAAA,CAAM,CAAC,GAAA,KAAQ;AACd,MAAA,MAAM,YACJ,GAAA,YAAe,KAAA,GAAQ,GAAA,GAAM,IAAI,MAAM,2BAA2B,CAAA;AACpE,MAAA,QAAA,CAAS,SAAS,CAAA;AAClB,MAAA,WAAA,CAAY,OAAA,CAAQ,UAAU,SAAS,CAAA;AAAA,IACzC,CAAC,CAAA;AAAA,EACL,CAAA,EAAG,EAAE,CAAA;AAGL,EAAA,MAAM,WAAA,GAAcD,iBAAAA,CAAY,CAAC,QAAA,KAAmC;AAClE,IAAA,UAAA,CAAW,OAAA,GAAU,QAAA;AAErB,IAAA,IAAI,CAAC,QAAA,EAAU;AACb,MAAA,UAAA,CAAW,KAAK,CAAA;AAChB,MAAA;AAAA,IACF;AAGA,IAAA,MAAM,cAAc,MAAM;AACxB,MAAA,UAAA,CAAW,IAAI,CAAA;AACf,MAAA,WAAA,CAAY,QAAQ,OAAA,IAAU;AAAA,IAChC,CAAA;AAEA,IAAA,MAAM,WAAA,GAAc,CAAC,CAAA,KAAa;AAChC,MAAA,MAAM,WAAA,GAAc,CAAA;AACpB,MAAA,MAAM,MAAM,WAAA,CAAY,MAAA,EAAQ,KAAA,IAAS,IAAI,MAAM,eAAe,CAAA;AAClE,MAAA,QAAA,CAAS,GAAG,CAAA;AACZ,MAAA,WAAA,CAAY,OAAA,CAAQ,UAAU,GAAG,CAAA;AAAA,IACnC,CAAA;AAEA,IAAA,QAAA,CAAS,gBAAA,CAAiB,iBAAiB,WAAW,CAAA;AACtD,IAAA,QAAA,CAAS,gBAAA,CAAiB,iBAAiB,WAAW,CAAA;AAGtD,IAAA,IAAI,SAAS,aAAA,EAAe;AAC1B,MAAA,UAAA,CAAW,IAAI,CAAA;AAAA,IACjB;AAGA,IAAA,MAAM,qBAAqB,MAAM;AAC/B,MAAA,IACE,SAAS,MAAA,IACT,OAAO,QAAA,CAAS,MAAA,CAAO,mBAAmB,UAAA,EAC1C;AACA,QAAA,IAAI,WAAA,CAAY,QAAQ,cAAA,EAAgB;AACtC,UAAA,QAAA,CAAS,MAAA,CAAO,cAAA,CAAe,WAAA,CAAY,OAAA,CAAQ,cAAc,CAAA;AAAA,QACnE;AACA,QAAA,IAAI,WAAA,CAAY,QAAQ,aAAA,EAAe;AACrC,UAAA,QAAA,CAAS,MAAA,CAAO,aAAA,CAAc,WAAA,CAAY,OAAA,CAAQ,aAAa,CAAA;AAAA,QACjE;AAAA,MACF;AAAA,IACF,CAAA;AAGA,IAAA,IAAI,SAAS,KAAA,IAAS,OAAO,QAAA,CAAS,KAAA,CAAM,SAAS,UAAA,EAAY;AAC/D,MAAA,QAAA,CAAS,KAAA,CAAM,IAAA,CAAK,kBAAkB,CAAA,CAAE,MAAM,MAAM;AAAA,MAEpD,CAAC,CAAA;AAAA,IACH,CAAA,MAAA,IAAW,SAAS,aAAA,EAAe;AAEjC,MAAA,kBAAA,EAAmB;AAAA,IACrB,CAAA,MAAO;AAEL,MAAA,QAAA,CAAS,gBAAA,CAAiB,iBAAiB,kBAAA,EAAoB;AAAA,QAC7D,IAAA,EAAM;AAAA,OACP,CAAA;AAAA,IACH;AAAA,EACF,CAAA,EAAG,EAAE,CAAA;AAIL,EAAA,MAAM,aAAA,GAAgBK,aAAA;AAAA,IACpB,OAAO;AAAA,MACL,QAAQ,OAAA,CAAQ,MAAA;AAAA,MAChB,QAAQ,OAAA,CAAQ,MAAA;AAAA,MAChB,UAAU,OAAA,CAAQ,QAAA;AAAA,MAClB,QAAQ,OAAA,CAAQ,MAAA;AAAA,MAChB,cAAc,OAAA,CAAQ,YAAA;AAAA,MACtB,UAAU,OAAA,CAAQ,QAAA;AAAA,MAClB,UAAU,OAAA,CAAQ,QAAA;AAAA,MAClB,MAAM,OAAA,CAAQ,IAAA;AAAA,MACd,OAAO,OAAA,CAAQ,KAAA;AAAA,MACf,QAAQ,OAAA,CAAQ,MAAA;AAAA,MAChB,QAAQ,OAAA,CAAQ,MAAA;AAAA,MAChB,aAAa,OAAA,CAAQ;AAAA,KACvB,CAAA;AAAA,IACA;AAAA,MACE,OAAA,CAAQ,MAAA;AAAA,MACR,OAAA,CAAQ,MAAA;AAAA,MACR,OAAA,CAAQ,QAAA;AAAA,MACR,OAAA,CAAQ,MAAA;AAAA,MACR,OAAA,CAAQ,YAAA;AAAA,MACR,OAAA,CAAQ,QAAA;AAAA,MACR,OAAA,CAAQ,QAAA;AAAA,MACR,OAAA,CAAQ,IAAA;AAAA,MACR,OAAA,CAAQ,KAAA;AAAA,MACR,OAAA,CAAQ,MAAA;AAAA,MACR,OAAA,CAAQ,MAAA;AAAA,MACR,OAAA,CAAQ;AAAA;AACV,GACF;AAIA,EAAA,MAAM,QAAA,GAAWA,aAAA;AAAA,IACf,OAAO;AAAA,MACL,OAAA,EAAS,YAAY,OAAA,CAAQ,OAAA;AAAA,MAC7B,OAAA,EAAS,YAAY,OAAA,CAAQ,OAAA;AAAA,MAC7B,cAAA,EAAgB,YAAY,OAAA,CAAQ,cAAA;AAAA,MACpC,aAAA,EAAe,YAAY,OAAA,CAAQ;AAAA,KACrC,CAAA;AAAA;AAAA,IAEA;AAAC,GACH;AAGA,EAAA,MAAM,OAAA,GAAUA,aAAA;AAAA,IACd,OAAO;AAAA,MACL,WAAA;AAAA,MACA,OAAA,EAAS,aAAA;AAAA,MACT,QAAA;AAAA,MACA;AAAA,KACF,CAAA;AAAA,IACA,CAAC,WAAA,EAAa,aAAA,EAAe,QAAA,EAAU,WAAW;AAAA,GACpD;AAGA,EAAA,MAAM,IAAA,GAAOL,kBAAY,MAAM;AAC7B,IAAA,IAAI,CAAC,WAAW,OAAA,EAAS;AACvB,MAAA,OAAA,CAAQ,KAAK,8CAA8C,CAAA;AAC3D,MAAA;AAAA,IACF;AACA,IAAA,UAAA,CAAW,QAAQ,IAAA,EAAK;AAAA,EAC1B,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,MAAM,IAAA,GAAOA,kBAAY,MAAM;AAC7B,IAAA,IAAI,CAAC,WAAW,OAAA,EAAS;AACvB,MAAA,OAAA,CAAQ,KAAK,8CAA8C,CAAA;AAC3D,MAAA;AAAA,IACF;AACA,IAAA,UAAA,CAAW,QAAQ,IAAA,EAAK;AAAA,EAC1B,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,MAAM,SAAA,GAAYA,iBAAAA;AAAA,IAChB,CAAC,MAAA,KAKK;AACJ,MAAA,IAAI,CAAC,WAAW,OAAA,EAAS;AACvB,QAAA,OAAA,CAAQ,KAAK,mDAAmD,CAAA;AAChE,QAAA;AAAA,MACF;AACA,MAAA,UAAA,CAAW,OAAA,CAAQ,UAAU,MAAM,CAAA;AAAA,IACrC,CAAA;AAAA,IACA;AAAC,GACH;AAGA,EAAA,MAAM,KAAA,GAAQK,aAAA;AAAA,IACZ,OAAO;AAAA,MACL,IAAA,EAAM,CACJ,OAAA,EAIA,MAAA,KACG;AACH,QAAA,IAAI,CAAC,WAAW,OAAA,EAAS;AACvB,UAAA,OAAA,CAAQ,KAAK,oDAAoD,CAAA;AACjE,UAAA;AAAA,QACF;AACA,QAAA,IAAI,CAAC,UAAA,CAAW,OAAA,CAAQ,KAAA,EAAO;AAC7B,UAAA,OAAA,CAAQ,KAAK,+DAA+D,CAAA;AAC5E,UAAA;AAAA,QACF;AACA,QAAA,UAAA,CAAW,OAAA,CAAQ,KAAA,CAAM,IAAA,CAAK,OAAA,EAAS,MAAM,CAAA;AAAA,MAC/C,CAAA;AAAA,MACA,QAAQ,MAAM;AACZ,QAAA,UAAA,CAAW,OAAA,EAAS,OAAO,MAAA,EAAO;AAAA,MACpC;AAAA,KACF,CAAA;AAAA,IACA;AAAC,GACH;AAEA,EAAA,OAAO;AAAA,IACL,OAAA;AAAA,IACA,OAAA;AAAA,IACA,KAAA;AAAA,IACA,IAAA;AAAA,IACA,IAAA;AAAA,IACA,SAAA;AAAA,IACA;AAAA,GACF;AACF","file":"react.js","sourcesContent":["/**\n * React-specific type definitions for TapKit\n *\n * Defines event handler types and control patterns for React integration.\n */\n\nimport type { TapKitElement } from \"@coxwave/tap-kit-types\";\n\n/**\n * Event handler type definitions for TapKit Web Component\n *\n * Maps CustomEvent types to React callback signatures.\n */\nexport interface TapKitEventHandlers {\n  /**\n   * Called when TapKit SDK is ready\n   * @example onReady={() => console.log('TapKit ready!')}\n   */\n  onReady?: () => void;\n\n  /**\n   * Called when initialization or runtime error occurs\n   * @example onError={(error) => console.error('TapKit error:', error)}\n   */\n  onError?: (error: Error) => void;\n\n  /**\n   * Called when timeline seek event occurs\n   * @example onTimelineSeek={(clipPlayHead, clipId) => console.log('Seek:', clipPlayHead)}\n   */\n  onTimelineSeek?: (clipPlayHead: number, clipId: string) => void;\n\n  /**\n   * Called when alarm fade-in occurs\n   * @example onAlarmFadeIn={(messageInfo) => console.log('Alarm:', messageInfo)}\n   */\n  onAlarmFadeIn?: (messageInfo: unknown) => void;\n}\n\n/**\n * Control object pattern for managing TapKit instance\n *\n * Separates instance management (setInstance) from configuration (options)\n * and event handling (handlers). Inspired by ChatKit's control pattern.\n *\n * @example\n * ```tsx\n * const tapkit = useTapKit({ apiKey: 'key', onReady: () => {} });\n * <TapKit control={tapkit.control} />\n * ```\n */\nexport interface TapKitControl<T> {\n  /**\n   * Set the TapKit element instance reference\n   *\n   * Called by TapKit component to register the element instance.\n   * Enables imperative control via useTapKit methods.\n   */\n  setInstance: (instance: TapKitElement | null) => void;\n\n  /**\n   * Configuration options (non-function values)\n   *\n   * All options except event handlers.\n   */\n  options: T;\n\n  /**\n   * Event handler callbacks (function values)\n   *\n   * Separated from options for easier event listener management.\n   */\n  handlers: TapKitEventHandlers;\n\n  /**\n   * Whether CDN is loaded and Web Component is available\n   *\n   * @internal Used by TapKit component to delay rendering\n   */\n  isCdnLoaded: boolean;\n}\n\n/**\n * Map of TapKit event names to their handler keys\n *\n * Used for automatic event listener binding in TapKit component.\n *\n * @internal\n */\nexport const EVENT_HANDLER_MAP = {\n  \"tap-kit:ready\": \"onReady\",\n  \"tap-kit:error\": \"onError\",\n} as const;\n\n/**\n * List of TapKit event names\n *\n * @internal\n */\nexport const EVENT_NAMES = Object.keys(\n  EVENT_HANDLER_MAP,\n) as (keyof typeof EVENT_HANDLER_MAP)[];\n","/**\n * TapKit React Component\n *\n * Declarative React wrapper for <tap-kit> Web Component.\n * Use this with useTapKit hook for a clean separation of control and rendering.\n *\n * @example\n * ```tsx\n * 'use client';\n *\n * import { TapKit, useTapKit } from '@coxwave/tap-kit/react';\n *\n * function MyApp() {\n *   const tapkit = useTapKit({\n *     apiKey: 'your-key',\n *     userId: 'user-123',\n *     courseId: 'course-456',\n *     clipId: 'clip-789',\n *     onReady: () => console.log('TapKit ready!'),\n *     onError: (error) => console.error('Error:', error),\n *   });\n *\n *   return (\n *     <div>\n *       <button onClick={tapkit.show} disabled={!tapkit.isReady}>\n *         Show Chat\n *       </button>\n *       <TapKit control={tapkit.control} style={{ height: '600px' }} />\n *     </div>\n *   );\n * }\n * ```\n *\n * **Note for Next.js App Router users:**\n * Make sure to add 'use client' at the top of your component file.\n *\n * @see https://edutap-ai-docs.vercel.app/docs/guides/react\n */\n\nimport type { TapKitElement } from \"@coxwave/tap-kit-types\";\nimport React, {\n  useCallback,\n  useEffect,\n  useImperativeHandle,\n  useRef,\n} from \"react\";\nimport type { TapKitControl } from \"./types\";\nimport { EVENT_HANDLER_MAP, EVENT_NAMES } from \"./types\";\n\n/**\n * Props for TapKit React component\n */\nexport interface TapKitProps\n  extends Omit<\n    React.HTMLAttributes<TapKitElement>,\n    \"children\" | \"dangerouslySetInnerHTML\"\n  > {\n  /**\n   * Control object from useTapKit hook\n   *\n   * Provides instance management, configuration, and event handlers.\n   */\n  control: TapKitControl<any>;\n}\n\n// Augment JSX namespace to support <tap-kit> custom element\ndeclare global {\n  namespace JSX {\n    interface IntrinsicElements {\n      \"tap-kit\": React.DetailedHTMLProps<\n        React.HTMLAttributes<TapKitElement>,\n        TapKitElement\n      > & {\n        \"api-key\"?: string;\n        \"user-id\"?: string;\n        \"course-id\"?: string;\n        \"clip-id\"?: string;\n        \"clip-play-head\"?: number;\n        language?: \"ko\" | \"en\";\n        \"button-id\"?: string;\n        mode?: \"inline\" | \"floating\" | \"sidebar\";\n        debug?: boolean;\n        \"tap-url\"?: string;\n        \"api-url\"?: string;\n        environment?: \"dev\" | \"prod\" | \"staging\" | \"demo\";\n      };\n    }\n  }\n}\n\n/**\n * TapKit React Component\n *\n * Renders <tap-kit> Web Component with React integration.\n * Automatically manages instance lifecycle and event listeners.\n *\n * **Ref Access**: The forwarded ref provides direct access to the TapKitElement:\n * ```tsx\n * const tapkitRef = useRef<TapKitElement>(null);\n * <TapKit ref={tapkitRef} control={...} />\n * // tapkitRef.current?.show()\n * ```\n */\nexport const TapKit = React.forwardRef<TapKitElement, TapKitProps>(\n  function TapKit({ control, ...htmlProps }, forwardedRef) {\n    const elementRef = useRef<TapKitElement | null>(null);\n\n    // Forward TapKitElement to parent\n    useImperativeHandle(\n      forwardedRef,\n      () => elementRef.current as TapKitElement,\n      [],\n    );\n\n    // Callback ref to register element when mounted\n    const setElementRef = useCallback(\n      (element: TapKitElement | null) => {\n        elementRef.current = element;\n\n        // Set apiKey as property (not attribute) - required for LitElement\n        // apiKey has { attribute: false } so it won't work via HTML attribute\n        if (element && control.options.apiKey) {\n          element.apiKey = control.options.apiKey;\n        }\n\n        control.setInstance(element);\n      },\n      [control.setInstance, control.options.apiKey],\n    );\n\n    // Store handlers in ref to avoid effect re-runs on handler reference changes\n    // Handlers are stable via useMemo in useTapKit, but use ref for extra safety\n    const handlersRef = useRef(control.handlers);\n    handlersRef.current = control.handlers;\n\n    // Register event listeners (only once per element mount)\n    useEffect(() => {\n      const element = elementRef.current;\n      if (!element) return;\n\n      const listeners: Array<{\n        event: string;\n        handler: EventListener;\n      }> = [];\n\n      // Bind CustomEvent listeners (tap-kit:ready, tap-kit:error)\n      for (const eventName of EVENT_NAMES) {\n        const handlerKey =\n          EVENT_HANDLER_MAP[eventName as keyof typeof EVENT_HANDLER_MAP];\n\n        // Use closure over handlersRef to always get latest handler\n        const listener = (e: Event) => {\n          const handler = handlersRef.current[handlerKey];\n          if (!handler) return;\n\n          const customEvent = e as CustomEvent;\n          if (handlerKey === \"onError\" && customEvent.detail?.error) {\n            // onError receives error directly\n            // biome-ignore lint/suspicious/noExplicitAny: Handler type is validated at runtime\n            (handler as any)(customEvent.detail.error);\n          } else if (handlerKey === \"onReady\") {\n            // onReady receives no arguments\n            // biome-ignore lint/suspicious/noExplicitAny: Handler type is validated at runtime\n            (handler as any)();\n          }\n        };\n\n        element.addEventListener(eventName, listener);\n        listeners.push({ event: eventName, handler: listener });\n      }\n\n      return () => {\n        // Cleanup all event listeners\n        for (const { event, handler } of listeners) {\n          element.removeEventListener(event, handler);\n        }\n      };\n    }, []); // Empty deps - listeners use ref for handlers\n\n    const { options, isCdnLoaded } = control;\n\n    // Wait for CDN to load before rendering Web Component\n    // Without this, <tap-kit> is just an HTMLUnknownElement without methods\n    if (!isCdnLoaded) {\n      return null;\n    }\n\n    // Render <tap-kit> Web Component directly\n    // Note: apiKey is set via ref callback (property-only in LitElement)\n    return (\n      <tap-kit\n        ref={setElementRef}\n        user-id={options.userId}\n        course-id={options.courseId}\n        clip-id={options.clipId}\n        clip-play-head={options.clipPlayHead}\n        language={options.language}\n        button-id={options.buttonId}\n        mode={options.mode}\n        debug={options.debug}\n        tap-url={options.tapUrl}\n        api-url={options.apiUrl}\n        environment={options.environment}\n        {...htmlProps}\n      />\n    );\n  },\n);\n","/**\n * CDN loader for TapKit\n * Dynamically loads the TapKit SDK from CDN\n *\n * For local testing, you can override the loader URL:\n * window.__TAP_KIT_LOADER_URL__ = '/tap-kit-core/loader.js';\n *\n * For local development (bypass loader, load IIFE directly):\n * window.__TAP_KIT_CORE_URL__ = '/packages/tap-kit-core/dist/index.global.js';\n */\n\n// Build-time constant injected by tsup define\ndeclare const __DEFAULT_CDN_LOADER_URL__: string;\n\nconst DEFAULT_CDN_LOADER_URL =\n  typeof __DEFAULT_CDN_LOADER_URL__ !== \"undefined\"\n    ? __DEFAULT_CDN_LOADER_URL__\n    : \"https://files.edutap.ai/tap-sdk/loader.js\";\nconst DEFAULT_TIMEOUT_MS = 4000; // 4 seconds total timeout\nconst IDLE_CALLBACK_TIMEOUT_MS = 500; // 500ms for requestIdleCallback\n\n/**\n * Get the loader URL from window override or default CDN\n */\nfunction getLoaderURL(): string {\n  return window?.__TAP_KIT_LOADER_URL__\n    ? window.__TAP_KIT_LOADER_URL__\n    : DEFAULT_CDN_LOADER_URL;\n}\n\n/**\n * Check if local core mode is enabled\n * When __TAP_KIT_CORE_URL__ is set, directly load the IIFE bundle\n * This bypasses the loader.js and loads tap-kit-core directly\n */\nfunction isLocalCoreMode(): boolean {\n  return typeof window !== \"undefined\" && !!window.__TAP_KIT_CORE_URL__;\n}\n\n/**\n * Get the local core URL\n */\nfunction getLocalCoreURL(): string {\n  return window.__TAP_KIT_CORE_URL__ || \"\";\n}\n\n/**\n * Creates a SDK checker function with timeout and retry logic\n * Uses requestIdleCallback to avoid blocking browser rendering\n * @param resolve - Promise resolve function\n * @param reject - Promise reject function\n * @param timeoutMs - Maximum time to wait for SDK to load (milliseconds)\n * @returns Checker function to be called repeatedly\n */\nfunction createSDKChecker(\n  resolve: (value: void | PromiseLike<void>) => void,\n  reject: (reason?: unknown) => void,\n  timeoutMs: number,\n): () => void {\n  const startTime = Date.now();\n\n  const checkSDK = (): void => {\n    // Check if real TapKit is loaded (not just stub)\n    // Stub has TapKitLoaded flag set to true by loader.js after real SDK loads\n    if (window.TapKit && window.TapKitLoaded === true) {\n      window.__TAP_KIT_LOADER_LOADED__ = true;\n      window.__TAP_KIT_LOADER_LOADING__ = undefined;\n      resolve();\n      return;\n    }\n\n    const elapsed = Date.now() - startTime;\n\n    // Check if exceeded timeout\n    if (elapsed > timeoutMs) {\n      window.__TAP_KIT_LOADER_LOADING__ = undefined;\n      reject(\n        new Error(\n          `TapKit loader timeout: SDK not available after ${timeoutMs}ms`,\n        ),\n      );\n      return;\n    }\n\n    // Use requestIdleCallback for better performance\n    // Falls back to setTimeout if not available\n    if (typeof requestIdleCallback !== \"undefined\") {\n      requestIdleCallback(checkSDK, { timeout: IDLE_CALLBACK_TIMEOUT_MS });\n    } else {\n      setTimeout(checkSDK, IDLE_CALLBACK_TIMEOUT_MS);\n    }\n  };\n\n  return checkSDK;\n}\n\n/**\n * Loads the CDN loader script\n * The loader will then fetch versions.json and load the appropriate SDK version\n *\n * If __TAP_KIT_CORE_URL__ is set, bypasses loader and loads IIFE directly\n *\n * @param timeoutMs - Maximum time to wait for SDK to load (default: 4000ms)\n * @returns Promise that resolves when SDK is loaded\n * @throws {Error} If loader fails to load or times out\n */\nexport function loadCDNLoader(\n  timeoutMs: number = DEFAULT_TIMEOUT_MS,\n): Promise<void> {\n  // If already loaded, return immediately\n  if (window.__TAP_KIT_LOADER_LOADED__ && window.TapKit) {\n    return Promise.resolve();\n  }\n\n  // If currently loading, return the existing promise\n  if (window.__TAP_KIT_LOADER_LOADING__) {\n    return window.__TAP_KIT_LOADER_LOADING__;\n  }\n\n  // Create loading promise\n  const loadingPromise = new Promise<void>((resolve, reject) => {\n    if (typeof document === \"undefined\") {\n      reject(\n        new Error(\n          \"TapKit requires browser environment (document is undefined)\",\n        ),\n      );\n      return;\n    }\n\n    // Local core mode: Load IIFE directly\n    if (isLocalCoreMode()) {\n      // Check if TapKit is already loaded (from other pages in playground)\n      if (window.TapKit && window.TapKitLoaded === true) {\n        window.__TAP_KIT_LOADER_LOADED__ = true;\n        window.__TAP_KIT_LOADER_LOADING__ = undefined;\n        resolve();\n        return;\n      }\n\n      const coreURL = getLocalCoreURL();\n\n      const script = document.createElement(\"script\");\n      script.src = coreURL;\n      script.async = true;\n\n      script.onload = () => {\n        // IIFE directly sets window.TapKit\n        // Set the loaded flag manually since we bypass loader.js\n        if (window.TapKit) {\n          window.TapKitLoaded = true;\n          window.__TAP_KIT_LOADER_LOADED__ = true;\n          window.__TAP_KIT_LOADER_LOADING__ = undefined;\n          resolve();\n        } else {\n          window.__TAP_KIT_LOADER_LOADING__ = undefined;\n          reject(new Error(\"TapKit not available after loading local core\"));\n        }\n      };\n\n      script.onerror = () => {\n        window.__TAP_KIT_LOADER_LOADING__ = undefined;\n        reject(new Error(`Failed to load local TapKit core: ${coreURL}`));\n      };\n\n      document.head.appendChild(script);\n      return;\n    }\n\n    // CDN mode: Load loader.js\n    const loaderURL = getLoaderURL();\n    const script = document.createElement(\"script\");\n    script.src = loaderURL;\n    script.async = true;\n\n    script.onload = () => {\n      // The loader script will load the actual SDK\n      // We need to wait a bit for the loader to fetch and load the SDK\n      const checkSDK = createSDKChecker(resolve, reject, timeoutMs);\n      checkSDK();\n    };\n\n    script.onerror = () => {\n      window.__TAP_KIT_LOADER_LOADING__ = undefined;\n      reject(new Error(`Failed to load TapKit CDN loader: ${loaderURL}`));\n    };\n\n    // Check if script already exists\n    const existingScript = document.querySelector(`script[src=\"${loaderURL}\"]`);\n\n    if (existingScript) {\n      // Script already added but not yet loaded\n      existingScript.addEventListener(\"load\", () => {\n        const checkSDK = createSDKChecker(resolve, reject, timeoutMs);\n        checkSDK();\n      });\n      existingScript.addEventListener(\"error\", () =>\n        reject(new Error(`Failed to load TapKit CDN loader: ${loaderURL}`)),\n      );\n    } else {\n      document.head.appendChild(script);\n    }\n  });\n\n  window.__TAP_KIT_LOADER_LOADING__ = loadingPromise;\n  return loadingPromise;\n}\n","/**\n * useTapKit Hook - ChatKit-style control for TapKit Web Component\n *\n * This hook provides a control object to manage TapKit through the\n * <TapKit /> component. Inspired by OpenAI's ChatKit pattern.\n *\n * @example\n * ```tsx\n * 'use client';\n *\n * import { TapKit, useTapKit } from '@coxwave/tap-kit/react';\n *\n * function MyApp() {\n *   const tapkit = useTapKit({\n *     apiKey: 'your-key',\n *     userId: 'user-123',\n *     courseId: 'course-456',\n *     clipId: 'clip-789',\n *     onReady: () => console.log('Ready!'),\n *     onError: (error) => console.error(error),\n *   });\n *\n *   return (\n *     <div>\n *       <button onClick={tapkit.show} disabled={!tapkit.isReady}>\n *         Ask AI Tutor\n *       </button>\n *       <TapKit control={tapkit.control} />\n *     </div>\n *   );\n * }\n * ```\n */\n\nimport type { TapKitElement } from \"@coxwave/tap-kit-types\";\nimport { useCallback, useEffect, useMemo, useRef, useState } from \"react\";\nimport { loadCDNLoader } from \"../loader\";\nimport type { TapKitControl, TapKitEventHandlers } from \"./types\";\n\nexport interface UseTapKitOptions extends TapKitEventHandlers {\n  /** API Key (required) */\n  apiKey: string;\n  /** User ID */\n  userId?: string;\n  /** Course ID */\n  courseId?: string;\n  /** Clip ID */\n  clipId?: string;\n  /** Clip playhead position */\n  clipPlayHead?: number;\n  /** Language */\n  language?: \"ko\" | \"en\";\n  /** Custom button element ID */\n  buttonId?: string;\n  /** Display mode */\n  mode?: \"inline\" | \"floating\" | \"sidebar\";\n  /** Debug mode */\n  debug?: boolean;\n  /** TAP Frontend URL */\n  tapUrl?: string;\n  /** API Backend URL */\n  apiUrl?: string;\n  /** Environment */\n  environment?: \"dev\" | \"prod\" | \"staging\" | \"demo\";\n}\n\n/**\n * Configuration options type (non-function values)\n */\nexport type TapKitOptions = Omit<UseTapKitOptions, keyof TapKitEventHandlers>;\n\n/**\n * Extract event handlers from options (pure function)\n */\nfunction extractHandlers(options: UseTapKitOptions): TapKitEventHandlers {\n  return {\n    onReady: options.onReady,\n    onError: options.onError,\n    onTimelineSeek: options.onTimelineSeek,\n    onAlarmFadeIn: options.onAlarmFadeIn,\n  };\n}\n\nexport interface UseTapKitReturn {\n  /** Control object for <TapKit /> component */\n  control: TapKitControl<TapKitOptions>;\n  /** Whether TapKit is ready */\n  isReady: boolean;\n  /** Error during initialization */\n  error: Error | null;\n  /** Show chat interface */\n  show: () => void;\n  /** Hide chat interface */\n  hide: () => void;\n  /** Set course information */\n  setCourse: (course: {\n    courseId: string;\n    clipId: string;\n    userId?: string;\n    clipPlayHead?: number;\n  }) => void;\n  /** Video adapter control */\n  video: {\n    /** Bind video player for timeline synchronization */\n    bind: (\n      adapter: {\n        getCurrentTime: () => number;\n        setCurrentTime: (time: number) => void;\n      },\n      clipId: string,\n    ) => void;\n    /** Unbind current video player */\n    unbind: () => void;\n  };\n}\n\n/**\n * Hook for managing TapKit Web Component (ChatKit Pattern)\n *\n * Returns a control object to pass to <TapKit /> component.\n * The component handles rendering, this hook handles state and methods.\n */\nexport function useTapKit(options: UseTapKitOptions): UseTapKitReturn {\n  // Element ref - set by <TapKit /> component via control.setInstance\n  const elementRef = useRef<TapKitElement | null>(null);\n\n  // State\n  const [isCdnLoaded, setIsCdnLoaded] = useState(false);\n  const [isReady, setIsReady] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n\n  // Store handlers in refs to avoid stale closures\n  const handlersRef = useRef(extractHandlers(options));\n  handlersRef.current = extractHandlers(options);\n\n  // Load CDN on mount (defines <tap-kit> Web Component)\n  useEffect(() => {\n    loadCDNLoader()\n      .then(() => {\n        setIsCdnLoaded(true);\n      })\n      .catch((err) => {\n        const loadError =\n          err instanceof Error ? err : new Error(\"Failed to load TapKit CDN\");\n        setError(loadError);\n        handlersRef.current.onError?.(loadError);\n      });\n  }, []);\n\n  // Set instance callback - called by <TapKit /> component\n  const setInstance = useCallback((instance: TapKitElement | null) => {\n    elementRef.current = instance;\n\n    if (!instance) {\n      setIsReady(false);\n      return;\n    }\n\n    // Listen for ready event\n    const handleReady = () => {\n      setIsReady(true);\n      handlersRef.current.onReady?.();\n    };\n\n    const handleError = (e: Event) => {\n      const customEvent = e as CustomEvent<{ error: Error }>;\n      const err = customEvent.detail?.error ?? new Error(\"Unknown error\");\n      setError(err);\n      handlersRef.current.onError?.(err);\n    };\n\n    instance.addEventListener(\"tap-kit:ready\", handleReady);\n    instance.addEventListener(\"tap-kit:error\", handleError);\n\n    // Check if already ready\n    if (instance.isInitialized) {\n      setIsReady(true);\n    }\n\n    // Setup EventManager callbacks when ready\n    const setupEventHandlers = () => {\n      if (\n        instance.events &&\n        typeof instance.events.onTimelineSeek === \"function\"\n      ) {\n        if (handlersRef.current.onTimelineSeek) {\n          instance.events.onTimelineSeek(handlersRef.current.onTimelineSeek);\n        }\n        if (handlersRef.current.onAlarmFadeIn) {\n          instance.events.onAlarmFadeIn(handlersRef.current.onAlarmFadeIn);\n        }\n      }\n    };\n\n    // Check if ready property exists (may not be available immediately)\n    if (instance.ready && typeof instance.ready.then === \"function\") {\n      instance.ready.then(setupEventHandlers).catch(() => {\n        // Ignore - error already handled by tap-kit:error event\n      });\n    } else if (instance.isInitialized) {\n      // Already initialized, setup handlers immediately\n      setupEventHandlers();\n    } else {\n      // Fallback: wait for ready event then setup handlers\n      instance.addEventListener(\"tap-kit:ready\", setupEventHandlers, {\n        once: true,\n      });\n    }\n  }, []);\n\n  // Memoize config options using individual values to prevent infinite re-renders\n  // (options object is recreated on every render, so we must depend on primitives)\n  const configOptions = useMemo(\n    () => ({\n      apiKey: options.apiKey,\n      userId: options.userId,\n      courseId: options.courseId,\n      clipId: options.clipId,\n      clipPlayHead: options.clipPlayHead,\n      language: options.language,\n      buttonId: options.buttonId,\n      mode: options.mode,\n      debug: options.debug,\n      tapUrl: options.tapUrl,\n      apiUrl: options.apiUrl,\n      environment: options.environment,\n    }),\n    [\n      options.apiKey,\n      options.userId,\n      options.courseId,\n      options.clipId,\n      options.clipPlayHead,\n      options.language,\n      options.buttonId,\n      options.mode,\n      options.debug,\n      options.tapUrl,\n      options.apiUrl,\n      options.environment,\n    ],\n  );\n\n  // Store handlers in stable ref (already done above with handlersRef)\n  // Use ref-based handlers for control to maintain stability\n  const handlers = useMemo(\n    () => ({\n      onReady: handlersRef.current.onReady,\n      onError: handlersRef.current.onError,\n      onTimelineSeek: handlersRef.current.onTimelineSeek,\n      onAlarmFadeIn: handlersRef.current.onAlarmFadeIn,\n    }),\n    // Empty deps - handlers are accessed via ref which is always up-to-date\n    [],\n  );\n\n  // Create control object\n  const control = useMemo<TapKitControl<TapKitOptions>>(\n    () => ({\n      setInstance,\n      options: configOptions,\n      handlers,\n      isCdnLoaded,\n    }),\n    [setInstance, configOptions, handlers, isCdnLoaded],\n  );\n\n  // Methods\n  const show = useCallback(() => {\n    if (!elementRef.current) {\n      console.warn(\"[useTapKit] Cannot show: element not mounted\");\n      return;\n    }\n    elementRef.current.show();\n  }, []);\n\n  const hide = useCallback(() => {\n    if (!elementRef.current) {\n      console.warn(\"[useTapKit] Cannot hide: element not mounted\");\n      return;\n    }\n    elementRef.current.hide();\n  }, []);\n\n  const setCourse = useCallback(\n    (course: {\n      courseId: string;\n      clipId: string;\n      userId?: string;\n      clipPlayHead?: number;\n    }) => {\n      if (!elementRef.current) {\n        console.warn(\"[useTapKit] Cannot setCourse: element not mounted\");\n        return;\n      }\n      elementRef.current.setCourse(course);\n    },\n    [],\n  );\n\n  // Video adapter control\n  const video = useMemo(\n    () => ({\n      bind: (\n        adapter: {\n          getCurrentTime: () => number;\n          setCurrentTime: (time: number) => void;\n        },\n        clipId: string,\n      ) => {\n        if (!elementRef.current) {\n          console.warn(\"[useTapKit] Cannot bind video: element not mounted\");\n          return;\n        }\n        if (!elementRef.current.video) {\n          console.warn(\"[useTapKit] Cannot bind video: video controller not available\");\n          return;\n        }\n        elementRef.current.video.bind(adapter, clipId);\n      },\n      unbind: () => {\n        elementRef.current?.video?.unbind();\n      },\n    }),\n    [],\n  );\n\n  return {\n    control,\n    isReady,\n    error,\n    show,\n    hide,\n    setCourse,\n    video,\n  };\n}\n"]}