@coxwave/tap-kit-types 2.0.9 → 2.1.1

package/dist/index.d.ts

@@ -2647,9 +2647,25 @@ type ContainerVisibility = "open" | "closed";
  *
  * @example
  * ```typescript
- * const adapter = {
+ * // Simple adapter (backward compatible)
+ * const simpleAdapter: VideoPlayerAdapter = {
  *   getCurrentTime: () => player.currentTime,
- *   setCurrentTime: (time) => { player.currentTime = time; }
+ *   setCurrentTime: (time) => {
+ *     player.currentTime = time;
+ *   }
+ * };
+ *
+ * // Cross-clip seeking adapter (recommended)
+ * const crossClipAdapter: VideoPlayerAdapter = {
+ *   getCurrentTime: () => player.currentTime,
+ *   setCurrentTime: (time, clipId) => {
+ *     // clipId enables cross-clip seeking (e.g., jump to different lecture)
+ *     if (clipId && clipId !== currentClipId) {
+ *       loadClip(clipId).then(() => player.currentTime = time);
+ *     } else {
+ *       player.currentTime = time;
+ *     }
+ *   }
  * };
  * ```
  */
@@ -2659,9 +2675,9 @@ interface VideoPlayerAdapter {
     /**
      * Set playback time in seconds
      * @param time - Playback time in seconds
-     * @param clipId - ClipId from the seek request (for cross-clip seeking)
+     * @param clipId - ClipId from the seek request (for cross-clip seeking). Optional for backward compatibility.
      */
-    setCurrentTime: (time: number, clipId: string) => void;
+    setCurrentTime: (time: number, clipId?: string) => void;
 }
 /**
  * Video Player Configuration
@@ -2673,10 +2689,13 @@ interface VideoPlayerAdapter {
  * const videoElement = document.querySelector('video');
  * sdk.video.bind(videoElement);  // clipId from SDK config, auto-updates with setCourse()
  *
- * // Custom Adapter
- * const adapter = {
+ * // Custom Adapter (YouTube, Vimeo, etc.)
+ * const adapter: VideoPlayerAdapter = {
  *   getCurrentTime: () => player.currentTime,
- *   setCurrentTime: (time) => { player.currentTime = time; }
+ *   setCurrentTime: (time, clipId) => {
+ *     // clipId enables cross-clip seeking (e.g., jump to different lecture)
+ *     player.currentTime = time;
+ *   }
  * };
  * sdk.video.bind(adapter);
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coxwave/tap-kit-types",
-  "version": "2.0.9",
+  "version": "2.1.1",
   "type": "module",
   "description": "Shared TypeScript types for TapKit SDK packages",
   "main": "dist/index.js",