@coxwave/tap-kit-types 0.0.52 → 0.0.63

package/README.md

@@ -1,6 +1,6 @@
 # @coxwave/tap-kit-types
 
-Shared TypeScript types for TapKit SDK packages.
+TypeScript types for the TapKit SDK and `<tap-button>` Web Component.
 
 ## Purpose
 
@@ -17,6 +17,46 @@ npm install @coxwave/tap-kit-types
 pnpm add @coxwave/tap-kit-types
 ```
 
+## Setup
+
+Once you install the package, the global type definitions are automatically available. No additional configuration is needed!
+
+The package exports global type declarations that TypeScript automatically picks up from `node_modules`. This includes:
+
+- **Web Component**: `<tap-button>` element with type-safe attributes
+- **Window extensions**: `Window.TapKit`, loader flags, and debug properties
+- **Browser APIs**: `requestIdleCallback` / `cancelIdleCallback` types
+
+### Manual Setup (Optional)
+
+If the global types are not automatically picked up, you can explicitly include them in your `tsconfig.json`:
+
+```json
+{
+  "include": [
+    "src/**/*",
+    "node_modules/@coxwave/tap-kit-types/dist/index.d.ts"
+  ]
+}
+```
+
+**Note**: Do NOT add this package to `compilerOptions.types` - that option is only for `@types/*` packages. Adding non-`@types` packages there will cause TypeScript errors.
+
+### What Gets Registered
+
+When you install this package, the following global types are automatically available:
+
+- **Web Component**: `<tap-button>` element with type-safe attributes
+- **Window extensions**: `Window.TapKit`, loader flags, and debug properties
+- **Browser APIs**: `requestIdleCallback` / `cancelIdleCallback` types
+
+This allows you to use the Web Component in JSX/TSX without type errors:
+
+```tsx
+// ✅ TypeScript knows about <tap-button>
+<tap-button floating={true} position="bottom-right" size="medium" />
+```
+
 ## Usage
 
 ```typescript
@@ -51,9 +91,12 @@ const params: TapKitInitParams = {
 
 ### Styling
 
-- `ContainerStyle` - Container styling options
+- `ContainerConfig` - Container configuration
+- `ContainerMode` - Container display mode
+- `FloatingConfig` - Floating container settings
+- `SidebarConfig` - Sidebar container settings
 - `PositionType` - Position configuration
-- `CustomStyles` - Backward compatibility alias
+- `ContainerLayoutState` - Container layout state
 
 ### Events
 
@@ -61,6 +104,22 @@ const params: TapKitInitParams = {
 - `ShortcutKeyPropertiesType` - Keyboard shortcut configuration
 - `ContainerVisibility` - Visibility state
 
+### Web Component
+
+- `ITapButtonElement` - Public API interface for `<tap-button>` Web Component
+- `TapButtonAttributes` - Props/Attributes for `<tap-button>` element
+
+```tsx
+// Example usage in React
+<tap-button
+  floating={true}
+  position="bottom-right"
+  size="medium"
+>
+  Custom content
+</tap-button>
+```
+
 ### Errors
 
 - `TapKitError` - Base error class
@@ -70,15 +129,21 @@ const params: TapKitInitParams = {
 - `TapKitLoaderError` - Loader errors
 - `TapKitIframeError` - iframe operation errors
 
+### Instance
+
+- `TapKitInstance` - TapKit SDK instance interface
+- `TapKitConstructor` - TapKit class constructor type
+
+### Video
+
+- `VideoPlayerAdapter` - Video player adapter interface
+- `VideoPlayerConfig` - Video player configuration
+
 ### Re-exports from @coxwave/tap-messages
 
 - `AlarmMessageInstanceType`
 - `AlarmType`
 
-## Version
-
-Current version: 0.1.0
-
 ## License
 
 MIT

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+import { ReactNode, CSSProperties } from 'react';
+
 type AlarmType = "quiz" | "pingMessage" | "callToAction" | "hourSpent" | "default";
 interface AlarmMessageInstanceType {
     message: string;
@@ -21,7 +23,7 @@ interface ConfigUpdateMessage {
     hostOrigin?: string;
     tapUrl?: string;
     apiUrl?: string;
-    environment?: "dev" | "prod" | "demo";
+    environment?: "dev" | "prod" | "demo" | "staging";
     language?: "ko" | "en" | (string & {});
     userId?: string;
     courseId?: string;
@@ -107,7 +109,7 @@ type FloatingConfig = {
  * Sidebar Configuration
  */
 type SidebarConfig = {
-    /** Maximum width of the sidebar (default: "min(50%, 600px)") */
+    /** Maximum width of the sidebar (default: "min(50%, 1000px)") */
     maxWidth?: string;
     /** Minimum viewport width to enable sidebar mode (default: 768) */
     minViewportWidth?: number;
@@ -130,7 +132,7 @@ type SidebarConfig = {
  * // Auto mode with custom styling for both layouts
  * const config: ContainerConfig = {
  *   floatingConfig: { width: "400px", position: { top: "80px" } },
- *   sidebarConfig: { maxWidth: "600px" }
+ *   sidebarConfig: { maxWidth: "800px" }
  * }
  *
  * @example
@@ -208,13 +210,29 @@ type Course = {
 /**
  * SDK Initialization Parameters
  *
+ * Button Options (choose one):
+ * 1. buttonId: Attach to your own button element (provide element ID)
+ * 2. <tap-button>: Use the built-in Web Component (omit buttonId)
+ *
  * @example
  * ```typescript
  * const sdk = new TapSDK({ apiKey: "your-key" });
  *
- * // Minimal initialization (uses all defaults)
+ * // Option 1: Use your own button element
+ * await sdk.init({
+ *   buttonId: "my-chat-button",
+ *   course: { userId: "user1", courseId: "course1", clipId: "clip1" }
+ * });
+ *
+ * // Option 2: Use <tap-button> Web Component (recommended)
+ * // HTML: <tap-button></tap-button>
+ * await sdk.init({
+ *   course: { userId: "user1", courseId: "course1", clipId: "clip1" }
+ * });
+ *
+ * // Custom styled <tap-button>
+ * // HTML: <tap-button position="bottom-left" size="large"></tap-button>
  * await sdk.init({
- *   buttonId: "tap-button",
  *   course: { userId: "user1", courseId: "course1", clipId: "clip1" }
  * });
  *
@@ -236,67 +254,23 @@ type Course = {
  *   course: { userId: "user1", courseId: "course1", clipId: "clip1" },
  *   container: {
  *     mode: "sidebar",
- *     sidebarConfig: { width: "600px", minViewportWidth: 1024 }
+ *     sidebarConfig: { maxWidth: "800px", minViewportWidth: 1024 }
  *   }
  * });
  * ```
  */
 type TapKitInitParams = {
-    buttonId: string;
+    /**
+     * Element ID of your custom button (optional)
+     * If omitted, SDK will use <tap-button> Web Component
+     * @see https://edutap-ai-docs.vercel.app/docs/sdk/button
+     */
+    buttonId?: string;
     course: Course;
     /** Container configuration (optional, uses defaults if omitted) */
     container?: ContainerConfig;
 };
 
-/**
- * Event Types
- */
-/**
- * Timeline seek parameters
- */
-type SeekTimelineParamsType = {
-    clipId: string;
-    clipPlayHead: number;
-};
-/**
- * Shortcut Key Configuration
- */
-type ShortcutKeyPropertiesType = {
-    key: string;
-    modifier: "ctrlKey" | "altKey" | "shiftKey" | "metaKey" | "";
-};
-/**
- * Container Visibility State
- */
-type ContainerVisibility = "open" | "closed";
-
-/**
- * @internal
- * Type-only symbol reference for internal configuration method
- * Actual symbol value: Symbol.for("tapkit.config")
- * Use this type in interface definitions, create actual symbol in implementation packages
- */
-declare const TAPKIT_CONFIG_SYMBOL: unique symbol;
-/** TapKit instance interface - shared by tap-kit-core and tap-sdk */
-interface TapKitInstance {
-    events: {
-        seekTimeline: (params: SeekTimelineParamsType) => void;
-        onTimelineSeek: (callback: (clipPlayHead: number, clipId: string) => void) => () => void;
-        onChatOpened: (handler: () => void) => () => void;
-        onChatClosed: (handler: () => void) => () => void;
-        onAlarmFadeIn: (handler: (messageInfo: AlarmMessageInstanceType) => void) => () => void;
-    };
-    isOpen: boolean;
-    isInitialized: boolean;
-    ready: Promise<void>;
-    init(params: TapKitInitParams): Promise<void>;
-    destroy(): void;
-    /** @internal Advanced configuration API using Symbol.for("tapkit.config") */
-    [TAPKIT_CONFIG_SYMBOL]?(options: TapKitConfigOptions): void;
-}
-/** TapKit constructor type */
-type TapKitConstructor = new (config: TapKitConfig) => TapKitInstance;
-
 /**
  * Error Classes
  */
@@ -354,6 +328,176 @@ declare class TapKitIframeError extends TapKitError {
     static fromPossibleFrameSafeError(error: any): TapKitIframeError | null;
 }
 
+/**
+ * Event Types
+ */
+/**
+ * Timeline seek parameters
+ */
+type SeekTimelineParamsType = {
+    clipId: string;
+    clipPlayHead: number;
+};
+/**
+ * Shortcut Key Configuration
+ */
+type ShortcutKeyPropertiesType = {
+    key: string;
+    modifier: "ctrlKey" | "altKey" | "shiftKey" | "metaKey" | "";
+};
+/**
+ * Container Visibility State
+ */
+type ContainerVisibility = "open" | "closed";
+
+/**
+ * Video Player Integration Types
+ * Supports both HTMLVideoElement and custom player adapters
+ */
+/**
+ * Video Player Adapter Interface
+ * For custom video players (YouTube, Vimeo, Video.js, etc.)
+ *
+ * @example
+ * ```typescript
+ * const adapter = {
+ *   getCurrentTime: () => player.currentTime,
+ *   setCurrentTime: (time) => { player.currentTime = time; }
+ * };
+ * ```
+ */
+interface VideoPlayerAdapter {
+    /** Get current playback time in seconds */
+    getCurrentTime: () => number;
+    /** Set playback time in seconds */
+    setCurrentTime: (time: number) => void;
+}
+/**
+ * Video Player Configuration
+ * Accepts either HTMLVideoElement or custom adapter
+ *
+ * @example
+ * ```typescript
+ * // HTML5 Video
+ * const videoElement = document.querySelector('video');
+ * sdk.video.bind(videoElement, 'clip-123');
+ *
+ * // Custom Adapter
+ * const adapter = {
+ *   getCurrentTime: () => player.currentTime,
+ *   setCurrentTime: (time) => { player.currentTime = time; }
+ * };
+ * sdk.video.bind(adapter, 'clip-123');
+ * ```
+ */
+type VideoPlayerConfig = HTMLVideoElement | VideoPlayerAdapter;
+
+/**
+ * @internal
+ * Type-only symbol reference for internal configuration method
+ * Actual symbol value: Symbol.for("tapkit.config")
+ * Use this type in interface definitions, create actual symbol in implementation packages
+ */
+declare const TAPKIT_CONFIG_SYMBOL: unique symbol;
+/** TapKit instance interface - shared by tap-kit-core and tap-sdk */
+interface TapKitInstance {
+    events: {
+        seekTimeline: (params: SeekTimelineParamsType) => void;
+        onTimelineSeek: (callback: (clipPlayHead: number, clipId: string) => void) => () => void;
+        onAlarmFadeIn: (handler: (messageInfo: AlarmMessageInstanceType) => void) => () => void;
+    };
+    video: {
+        /** Bind video player for timeline synchronization */
+        bind: (config: VideoPlayerConfig, clipId: string) => void;
+        /** Unbind current video player */
+        unbind: () => void;
+    };
+    isOpen: boolean;
+    isInitialized: boolean;
+    ready: Promise<void>;
+    init(params: TapKitInitParams): Promise<() => void>;
+    destroy(): void;
+    /** @internal Advanced configuration API using Symbol.for("tapkit.config") */
+    [TAPKIT_CONFIG_SYMBOL]?(options: TapKitConfigOptions): void;
+}
+/** TapKit constructor type */
+type TapKitConstructor = new (config: TapKitConfig) => TapKitInstance;
+
+/**
+ * Type declarations for <tap-button> Web Component
+ *
+ * Provides TypeScript support for using <tap-button> in JSX/TSX.
+ * The actual Web Component is registered by tap-kit-core when loaded.
+ */
+
+
+
+declare global {
+  namespace JSX {
+    interface IntrinsicElements {
+      "tap-button": TapButtonAttributes;
+    }
+  }
+}
+
+/**
+ * Public API interface for TapButtonElement Web Component
+ *
+ * This interface defines the contract that tap-kit-core's TapButtonElement must implement.
+ * It provides type-safe access to the Web Component's internal structure.
+ */
+interface ITapButtonElement extends HTMLElement {
+  /**
+   * Get the button element from Shadow DOM
+   * Used by tap-kit-core to attach click listeners and manage the button
+   * @returns The button element inside Shadow DOM, or null if not found
+   */
+  getButtonElement(): HTMLButtonElement | null;
+}
+
+/**
+ * Props/Attributes for <tap-button> Web Component
+ */
+interface TapButtonAttributes {
+  /**
+   * Enable floating mode (position: fixed)
+   * When true or omitted: button floats with fixed positioning
+   * When false: button uses static positioning (normal flow)
+   * @default true
+   */
+  floating?: boolean;
+
+  /**
+   * Button position on screen (only applies when floating is true)
+   * @default "bottom-right"
+   */
+  position?:
+    | "bottom-right"
+    | "bottom-left"
+    | "top-right"
+    | "top-left"
+    | "custom";
+
+  /**
+   * Button size preset
+   * @default "medium"
+   */
+  size?: "small" | "medium" | "large";
+
+  /**
+   * Child content (replaces default icon via slot)
+   * Use this to provide custom button content (e.g., custom logo, icon, or text)
+   * If not provided, displays default edutap logo
+   */
+  children?: ReactNode;
+
+  /**
+   * Custom inline styles for positioning
+   * Use position="custom" attribute to enable custom positioning
+   */
+  style?: CSSProperties;
+}
+
 /**
  * Global type definitions for browser environment
  */
@@ -384,4 +528,4 @@ declare global {
   function cancelIdleCallback(handle: number): void;
 }
 
-export { type AlarmMessageInstanceType, type AlarmType, type ContainerConfig, type ContainerLayoutState, type ContainerMode, type ContainerVisibility, type Course, type FloatingConfig, TapKitInitializationError as InitializationError, type PositionType, type SeekTimelineParamsType, type ShortcutKeyPropertiesType, type SidebarConfig, TAPKIT_CONFIG_SYMBOL, TAP_ERROR_MARKER, type TapErrorOptions, type TapKitConfig, type TapKitConfigOptions, TapKitConfigurationError, type TapKitConstructor, TapKitError, TapKitIframeError, type TapKitInitParams, TapKitInitializationError, type TapKitInstance, TapKitLoaderError, TapKitMessageError, type TapKitRuntimeConfig };
+export { type AlarmMessageInstanceType, type AlarmType, type ContainerConfig, type ContainerLayoutState, type ContainerMode, type ContainerVisibility, type Course, type FloatingConfig, type ITapButtonElement, TapKitInitializationError as InitializationError, type PositionType, type SeekTimelineParamsType, type ShortcutKeyPropertiesType, type SidebarConfig, TAPKIT_CONFIG_SYMBOL, TAP_ERROR_MARKER, type TapButtonAttributes, type TapErrorOptions, type TapKitConfig, type TapKitConfigOptions, TapKitConfigurationError, type TapKitConstructor, TapKitError, TapKitIframeError, type TapKitInitParams, TapKitInitializationError, type TapKitInstance, TapKitLoaderError, TapKitMessageError, type TapKitRuntimeConfig, type VideoPlayerAdapter, type VideoPlayerConfig };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/errors.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Error Classes\n */\n\nexport const TAP_ERROR_MARKER = \"__tap_sdk_error__\";\n\nexport interface TapErrorOptions {\n  code?: string;\n  cause?: Error;\n}\n\n/**\n * Base error class for all TapKit errors\n * Supports serialization across iframe boundaries\n */\nexport class TapKitError extends Error {\n  override cause: Error | undefined;\n  code: string | undefined;\n\n  constructor(message: string, options?: TapErrorOptions) {\n    super(message);\n    this.name = \"TapKitError\";\n    this.code = options?.code;\n    this.cause = options?.cause;\n  }\n\n  /**\n   * Restore error from postMessage serialization\n   */\n  static fromPossibleFrameSafeError(error: any): TapKitError | null {\n    if (error instanceof TapKitError) {\n      return error;\n    }\n    if (\n      error &&\n      typeof error === \"object\" &&\n      TAP_ERROR_MARKER in error &&\n      error[TAP_ERROR_MARKER] === \"TapKitError\"\n    ) {\n      const err = new TapKitError(error.message, {\n        code: error.code,\n      });\n      err.stack = error.stack;\n      return err;\n    }\n    return null;\n  }\n}\n\n/**\n * Error thrown when SDK initialization fails\n */\nexport class TapKitInitializationError extends TapKitError {\n  constructor(message: string, options?: TapErrorOptions) {\n    super(message, options);\n    this.name = \"TapKitInitializationError\";\n    this.code = options?.code ?? \"ERR_INITIALIZATION\";\n  }\n\n  static override fromPossibleFrameSafeError(\n    error: any\n  ): TapKitInitializationError | null {\n    if (error instanceof TapKitInitializationError) {\n      return error;\n    }\n    if (\n      error &&\n      typeof error === \"object\" &&\n      TAP_ERROR_MARKER in error &&\n      error[TAP_ERROR_MARKER] === \"TapKitInitializationError\"\n    ) {\n      const err = new TapKitInitializationError(error.message, {\n        code: error.code,\n      });\n      err.stack = error.stack;\n      return err;\n    }\n    return null;\n  }\n}\n\n/**\n * Error thrown when message communication fails\n */\nexport class TapKitMessageError extends TapKitError {\n  constructor(message: string, options?: TapErrorOptions) {\n    super(message, options);\n    this.name = \"TapKitMessageError\";\n    this.code = options?.code ?? \"ERR_MESSAGE\";\n  }\n\n  static override fromPossibleFrameSafeError(\n    error: any\n  ): TapKitMessageError | null {\n    if (error instanceof TapKitMessageError) {\n      return error;\n    }\n    if (\n      error &&\n      typeof error === \"object\" &&\n      TAP_ERROR_MARKER in error &&\n      error[TAP_ERROR_MARKER] === \"TapKitMessageError\"\n    ) {\n      const err = new TapKitMessageError(error.message, {\n        code: error.code,\n      });\n      err.stack = error.stack;\n      return err;\n    }\n    return null;\n  }\n}\n\n/**\n * Error thrown when configuration is invalid\n */\nexport class TapKitConfigurationError extends TapKitError {\n  constructor(message: string, options?: TapErrorOptions) {\n    super(message, options);\n    this.name = \"TapKitConfigurationError\";\n    this.code = options?.code ?? \"ERR_CONFIGURATION\";\n  }\n\n  static override fromPossibleFrameSafeError(\n    error: any\n  ): TapKitConfigurationError | null {\n    if (error instanceof TapKitConfigurationError) {\n      return error;\n    }\n    if (\n      error &&\n      typeof error === \"object\" &&\n      TAP_ERROR_MARKER in error &&\n      error[TAP_ERROR_MARKER] === \"TapKitConfigurationError\"\n    ) {\n      const err = new TapKitConfigurationError(error.message, {\n        code: error.code,\n      });\n      err.stack = error.stack;\n      return err;\n    }\n    return null;\n  }\n}\n\n/**\n * Error thrown when loader fails to fetch or load resources\n */\nexport class TapKitLoaderError extends TapKitError {\n  constructor(message: string, options?: TapErrorOptions) {\n    super(message, options);\n    this.name = \"TapKitLoaderError\";\n    this.code = options?.code ?? \"ERR_LOADER\";\n  }\n\n  static override fromPossibleFrameSafeError(\n    error: any\n  ): TapKitLoaderError | null {\n    if (error instanceof TapKitLoaderError) {\n      return error;\n    }\n    if (\n      error &&\n      typeof error === \"object\" &&\n      TAP_ERROR_MARKER in error &&\n      error[TAP_ERROR_MARKER] === \"TapKitLoaderError\"\n    ) {\n      const err = new TapKitLoaderError(error.message, {\n        code: error.code,\n      });\n      err.stack = error.stack;\n      return err;\n    }\n    return null;\n  }\n}\n\n/**\n * Error thrown when iframe operations fail\n */\nexport class TapKitIframeError extends TapKitError {\n  constructor(message: string, options?: TapErrorOptions) {\n    super(message, options);\n    this.name = \"TapKitIframeError\";\n    this.code = options?.code ?? \"ERR_IFRAME\";\n  }\n\n  static override fromPossibleFrameSafeError(\n    error: any\n  ): TapKitIframeError | null {\n    if (error instanceof TapKitIframeError) {\n      return error;\n    }\n    if (\n      error &&\n      typeof error === \"object\" &&\n      TAP_ERROR_MARKER in error &&\n      error[TAP_ERROR_MARKER] === \"TapKitIframeError\"\n    ) {\n      const err = new TapKitIframeError(error.message, {\n        code: error.code,\n      });\n      err.stack = error.stack;\n      return err;\n    }\n    return null;\n  }\n}\n\n// Backward compatibility alias\nexport { TapKitInitializationError as InitializationError };\n"]}
+{"version":3,"sources":["../src/errors.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Error Classes\n */\n\nexport const TAP_ERROR_MARKER = \"__tap_sdk_error__\";\n\nexport interface TapErrorOptions {\n  code?: string;\n  cause?: Error;\n}\n\n/**\n * Base error class for all TapKit errors\n * Supports serialization across iframe boundaries\n */\nexport class TapKitError extends Error {\n  override cause: Error | undefined;\n  code: string | undefined;\n\n  constructor(message: string, options?: TapErrorOptions) {\n    super(message);\n    this.name = \"TapKitError\";\n    this.code = options?.code;\n    this.cause = options?.cause;\n  }\n\n  /**\n   * Restore error from postMessage serialization\n   */\n  static fromPossibleFrameSafeError(error: any): TapKitError | null {\n    if (error instanceof TapKitError) {\n      return error;\n    }\n    if (\n      error &&\n      typeof error === \"object\" &&\n      TAP_ERROR_MARKER in error &&\n      error[TAP_ERROR_MARKER] === \"TapKitError\"\n    ) {\n      const err = new TapKitError(error.message, {\n        code: error.code,\n      });\n      err.stack = error.stack;\n      return err;\n    }\n    return null;\n  }\n}\n\n/**\n * Error thrown when SDK initialization fails\n */\nexport class TapKitInitializationError extends TapKitError {\n  constructor(message: string, options?: TapErrorOptions) {\n    super(message, options);\n    this.name = \"TapKitInitializationError\";\n    this.code = options?.code ?? \"ERR_INITIALIZATION\";\n  }\n\n  static override fromPossibleFrameSafeError(\n    error: any,\n  ): TapKitInitializationError | null {\n    if (error instanceof TapKitInitializationError) {\n      return error;\n    }\n    if (\n      error &&\n      typeof error === \"object\" &&\n      TAP_ERROR_MARKER in error &&\n      error[TAP_ERROR_MARKER] === \"TapKitInitializationError\"\n    ) {\n      const err = new TapKitInitializationError(error.message, {\n        code: error.code,\n      });\n      err.stack = error.stack;\n      return err;\n    }\n    return null;\n  }\n}\n\n/**\n * Error thrown when message communication fails\n */\nexport class TapKitMessageError extends TapKitError {\n  constructor(message: string, options?: TapErrorOptions) {\n    super(message, options);\n    this.name = \"TapKitMessageError\";\n    this.code = options?.code ?? \"ERR_MESSAGE\";\n  }\n\n  static override fromPossibleFrameSafeError(\n    error: any,\n  ): TapKitMessageError | null {\n    if (error instanceof TapKitMessageError) {\n      return error;\n    }\n    if (\n      error &&\n      typeof error === \"object\" &&\n      TAP_ERROR_MARKER in error &&\n      error[TAP_ERROR_MARKER] === \"TapKitMessageError\"\n    ) {\n      const err = new TapKitMessageError(error.message, {\n        code: error.code,\n      });\n      err.stack = error.stack;\n      return err;\n    }\n    return null;\n  }\n}\n\n/**\n * Error thrown when configuration is invalid\n */\nexport class TapKitConfigurationError extends TapKitError {\n  constructor(message: string, options?: TapErrorOptions) {\n    super(message, options);\n    this.name = \"TapKitConfigurationError\";\n    this.code = options?.code ?? \"ERR_CONFIGURATION\";\n  }\n\n  static override fromPossibleFrameSafeError(\n    error: any,\n  ): TapKitConfigurationError | null {\n    if (error instanceof TapKitConfigurationError) {\n      return error;\n    }\n    if (\n      error &&\n      typeof error === \"object\" &&\n      TAP_ERROR_MARKER in error &&\n      error[TAP_ERROR_MARKER] === \"TapKitConfigurationError\"\n    ) {\n      const err = new TapKitConfigurationError(error.message, {\n        code: error.code,\n      });\n      err.stack = error.stack;\n      return err;\n    }\n    return null;\n  }\n}\n\n/**\n * Error thrown when loader fails to fetch or load resources\n */\nexport class TapKitLoaderError extends TapKitError {\n  constructor(message: string, options?: TapErrorOptions) {\n    super(message, options);\n    this.name = \"TapKitLoaderError\";\n    this.code = options?.code ?? \"ERR_LOADER\";\n  }\n\n  static override fromPossibleFrameSafeError(\n    error: any,\n  ): TapKitLoaderError | null {\n    if (error instanceof TapKitLoaderError) {\n      return error;\n    }\n    if (\n      error &&\n      typeof error === \"object\" &&\n      TAP_ERROR_MARKER in error &&\n      error[TAP_ERROR_MARKER] === \"TapKitLoaderError\"\n    ) {\n      const err = new TapKitLoaderError(error.message, {\n        code: error.code,\n      });\n      err.stack = error.stack;\n      return err;\n    }\n    return null;\n  }\n}\n\n/**\n * Error thrown when iframe operations fail\n */\nexport class TapKitIframeError extends TapKitError {\n  constructor(message: string, options?: TapErrorOptions) {\n    super(message, options);\n    this.name = \"TapKitIframeError\";\n    this.code = options?.code ?? \"ERR_IFRAME\";\n  }\n\n  static override fromPossibleFrameSafeError(\n    error: any,\n  ): TapKitIframeError | null {\n    if (error instanceof TapKitIframeError) {\n      return error;\n    }\n    if (\n      error &&\n      typeof error === \"object\" &&\n      TAP_ERROR_MARKER in error &&\n      error[TAP_ERROR_MARKER] === \"TapKitIframeError\"\n    ) {\n      const err = new TapKitIframeError(error.message, {\n        code: error.code,\n      });\n      err.stack = error.stack;\n      return err;\n    }\n    return null;\n  }\n}\n\n// Backward compatibility alias\nexport { TapKitInitializationError as InitializationError };\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coxwave/tap-kit-types",
-  "version": "0.0.52",
+  "version": "0.0.63",
   "type": "module",
   "description": "Shared TypeScript types for TapKit SDK packages",
   "main": "dist/index.js",
@@ -23,14 +23,16 @@
   ],
   "devDependencies": {
     "tsup": "^8.5.0",
-    "@coxwave/config-eslint": "1.0.0",
-    "@coxwave/tap-messages": "0.0.1",
-    "@coxwave/config-typescript": "1.0.0"
+    "@coxwave/config-typescript": "1.0.0",
+    "@coxwave/tap-messages": "0.0.1"
   },
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",
-    "lint": "eslint .",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
+    "format": "biome format --write .",
+    "typecheck": "tsc --noEmit",
     "publish:npm": "./scripts/publish.sh"
   }
 }