@coxwave/tap-kit-types 2.0.3 → 2.0.6

package/dist/index.d.ts

@@ -2,10 +2,10 @@ import * as CSS from 'csstype';
 import { ReactNode, CSSProperties } from 'react';
 
 /**
- * Alarm display duration (18 seconds total)
- * 말풍선 발생 후, 12초 뒤에 서서히 사라짐 (전체 시간 18초)
+ * Alarm display duration (16 seconds total)
+ * 12초 유지 + 4초 fade out = 16초 total
  */
-declare const ALARM_DURATION = 18000;
+declare const ALARM_DURATION = 16000;
 /**
  * Base style type for all elements
  * Uses csstype for accurate CSS property types
@@ -85,15 +85,101 @@ type AlarmType = "basic:welcome" | "basic:default" | "feat:quiz" | "feat:guide"
  * Complete alarm message definition
  * UI is fully defined via JSON Component Descriptor
  * Click behavior is simple: open chat + send message (if provided in content.payload)
- * Duration is always 18 seconds (handled in useAlarmEffects)
+ * Duration is always 16 seconds (12s visible + 4s fade, handled in useAlarmEffects)
  */
 interface AlarmMessageInstanceType {
     type: AlarmType;
     content: AlarmElement;
 }
 
-type TapMessageType = "tap:ready" | "tap:close" | "timeline:seek" | "alarm:click" | "alarm:fadeIn" | "popUp:open" | "popUp:close" | "material:view:open" | "material:view:close" | "material:view:error" | "container:mode:change" | "container:mode:change:ack" | "container:layout:state:changed" | "viewport:resize" | "config:update" | "GA_EVENT";
-type TapMessage = TapReadyMessage | TapCloseMessage | TimelineSeekMessage | AlarmClickMessage | AlarmFadeInMessage | PopUpOpenMessage | PopUpCloseMessage | MaterialViewOpenMessage | MaterialViewCloseMessage | MaterialViewErrorMessage | ContainerModeChangeMessage | ContainerModeChangeAckMessage | ContainerLayoutStateChangedMessage | ViewportResizeMessage | ConfigUpdateMessage | GAEventMessage;
+/**
+ * Styling Types
+ */
+/**
+ * Display mode for TapKit container (user-facing configuration)
+ *
+ * - "inline": Embedded at element position
+ * - "floating": Compact widget floating in document.body
+ * - "sidebar": Full-height sidebar in document.body
+ */
+type DisplayMode = "inline" | "floating" | "sidebar";
+/**
+ * Layout mode for runtime layout switching
+ *
+ * Excludes "inline" because inline mode doesn't participate in layout toggling.
+ * Used by ContainerStateStore, localStorage persistence, and layout manager.
+ */
+type LayoutMode = "floating" | "sidebar";
+type PositionType = {
+    top?: string;
+    left?: string;
+    right?: string;
+    bottom?: string;
+};
+/**
+ * Floating mode configuration
+ * Includes position, size, and style settings for floating container
+ */
+type FloatingConfig = {
+    /** Position (default: top: "50px", right: "24px") */
+    position?: PositionType;
+    /** Width (default: "340px") */
+    width?: string;
+    /** Height (default: "calc(100% - 116px)") */
+    height?: string;
+    /** Border radius (default: "16px") */
+    borderRadius?: string;
+    /** Expanded width for PDF viewer (default: "min(90vw, 1200px)") */
+    expandedWidth?: string;
+    /** Expanded height for PDF viewer (default: "90vh") */
+    expandedHeight?: string;
+    /** Expanded top position for PDF viewer (default: "5vh") */
+    expandedTop?: string;
+    /** Expanded right position for PDF viewer (default: "5vw") */
+    expandedRight?: string;
+};
+/**
+ * Sidebar Configuration
+ */
+type SidebarConfig = {
+    /** Maximum width of the sidebar (default: "min(50%, 1000px)") */
+    maxWidth?: string;
+    /** Expanded maximum width for PDF viewer (default: "min(70%, 1400px)") */
+    expandedMaxWidth?: string;
+    /** Minimum viewport width to enable sidebar mode (default: 768) */
+    minViewportWidth?: number;
+};
+/**
+ * Container Configuration (SSOT - Type Level)
+ *
+ * This is the SINGLE SOURCE OF TRUTH for container configuration at the TYPE level.
+ * - Public API: TapKitInitParams.container
+ * - Internal: Container class configuration
+ * - Protocol: ConfigUpdateMessage.container mirrors this structure
+ *
+ * When modifying this type, also update ConfigUpdateMessage.container in @coxwave/tap-messages
+ *
+ * @example
+ * // Custom styling for floating/sidebar modes
+ * const config: ContainerConfig = {
+ *   floatingConfig: { width: "400px", position: { top: "80px" } },
+ *   sidebarConfig: { maxWidth: "800px" }
+ * }
+ */
+type ContainerConfig = {
+    /**
+     * Display mode
+     * @see DisplayMode
+     */
+    mode?: DisplayMode;
+    /** Floating layout configuration (applied when SDK auto-creates container in floating layout) */
+    floatingConfig?: FloatingConfig;
+    /** Sidebar layout configuration (applied when SDK auto-creates container in sidebar layout) */
+    sidebarConfig?: SidebarConfig;
+};
+
+type TapMessageType = "tap:ready" | "tap:close" | "timeline:seek" | "alarm:click" | "alarm:fadeIn" | "popUp:open" | "popUp:close" | "material:view:open" | "material:view:close" | "material:view:error" | "html:view:open" | "html:view:close" | "container:mode:change" | "container:mode:change:ack" | "container:layout:state:changed" | "viewport:resize" | "config:update" | "GA_EVENT";
+type TapMessage = TapReadyMessage | TapCloseMessage | TimelineSeekMessage | AlarmClickMessage | AlarmFadeInMessage | PopUpOpenMessage | PopUpCloseMessage | MaterialViewOpenMessage | MaterialViewCloseMessage | MaterialViewErrorMessage | HtmlViewOpenMessage | HtmlViewCloseMessage | ContainerModeChangeMessage | ContainerModeChangeAckMessage | ContainerLayoutStateChangedMessage | ViewportResizeMessage | ConfigUpdateMessage | GAEventMessage;
 interface TapReadyMessage {
     type: "tap:ready";
     gaId: string;
@@ -155,6 +241,30 @@ interface MaterialViewErrorMessage {
     error: "fetch_failed" | "expired_url" | "extraction_failed" | "unknown";
     message?: string;
 }
+/**
+ * HTML View Open Request (iframe → parent, simple post pattern)
+ * Requests parent to open HTML viewer overlay
+ *
+ * Supports two content sources:
+ * - htmlUrl: Load HTML from URL (iframe src)
+ * - htmlContent: Render HTML string directly (iframe srcdoc)
+ */
+interface HtmlViewOpenMessage {
+    type: "html:view:open";
+    /** URL to load HTML content from */
+    htmlUrl?: string;
+    /** HTML string to render directly */
+    htmlContent?: string;
+    /** Optional title for the viewer header */
+    title?: string;
+}
+/**
+ * HTML View Close Request (iframe → parent, simple post pattern)
+ * Requests parent to close HTML viewer overlay
+ */
+interface HtmlViewCloseMessage {
+    type: "html:view:close";
+}
 /**
  * Container Mode Change Request (iframe → parent, call/handle pattern)
  *
@@ -226,14 +336,7 @@ interface ConfigUpdateMessage {
     courseId?: string;
     clipId?: string;
     clipPlayHead?: number;
-    /**
-     * Display mode
-     * - "inline": Container rendered at <tap-kit> position (embedded in page)
-     * - "floating": Container floats in document.body as compact widget
-     * - "sidebar": Container floats in document.body as full-height sidebar
-     * Default: "inline"
-     */
-    mode?: "inline" | "floating" | "sidebar";
+    mode?: DisplayMode;
     /**
      * Allow user to toggle between floating and sidebar layouts
      * @default true
@@ -2038,6 +2141,15 @@ declare const MaterialViewErrorSchema: ObjectSchema<{
     readonly error: UnionSchema<[LiteralSchema<"fetch_failed", undefined>, LiteralSchema<"expired_url", undefined>, LiteralSchema<"extraction_failed", undefined>, LiteralSchema<"unknown", undefined>], undefined>;
     readonly message: OptionalSchema<StringSchema<undefined>, undefined>;
 }, undefined>;
+declare const HtmlViewOpenSchema: ObjectSchema<{
+    readonly type: LiteralSchema<"html:view:open", undefined>;
+    readonly htmlUrl: OptionalSchema<StringSchema<undefined>, undefined>;
+    readonly htmlContent: OptionalSchema<StringSchema<undefined>, undefined>;
+    readonly title: OptionalSchema<StringSchema<undefined>, undefined>;
+}, undefined>;
+declare const HtmlViewCloseSchema: ObjectSchema<{
+    readonly type: LiteralSchema<"html:view:close", undefined>;
+}, undefined>;
 declare const ContainerModeChangeSchema: ObjectSchema<{
     readonly type: LiteralSchema<"container:mode:change", undefined>;
     readonly mode: UnionSchema<[LiteralSchema<"floating", undefined>, LiteralSchema<"sidebar", undefined>], undefined>;
@@ -2137,6 +2249,13 @@ declare const TapMessageSchema: UnionSchema<[ObjectSchema<{
     readonly materialId: StringSchema<undefined>;
     readonly error: UnionSchema<[LiteralSchema<"fetch_failed", undefined>, LiteralSchema<"expired_url", undefined>, LiteralSchema<"extraction_failed", undefined>, LiteralSchema<"unknown", undefined>], undefined>;
     readonly message: OptionalSchema<StringSchema<undefined>, undefined>;
+}, undefined>, ObjectSchema<{
+    readonly type: LiteralSchema<"html:view:open", undefined>;
+    readonly htmlUrl: OptionalSchema<StringSchema<undefined>, undefined>;
+    readonly htmlContent: OptionalSchema<StringSchema<undefined>, undefined>;
+    readonly title: OptionalSchema<StringSchema<undefined>, undefined>;
+}, undefined>, ObjectSchema<{
+    readonly type: LiteralSchema<"html:view:close", undefined>;
 }, undefined>, ObjectSchema<{
     readonly type: LiteralSchema<"container:mode:change", undefined>;
     readonly mode: UnionSchema<[LiteralSchema<"floating", undefined>, LiteralSchema<"sidebar", undefined>], undefined>;
@@ -2371,6 +2490,76 @@ type SeekTimelineParamsType = {
     clipId: string;
     clipPlayHead: number;
 };
+/**
+ * TapKit Ready Event - Fired when iframe is initialized and ready
+ *
+ * @example
+ * ```typescript
+ * document.addEventListener('tapkit:ready', (e) => {
+ *   console.log('TapKit ready! GA ID:', e.detail.gaId);
+ * });
+ * ```
+ */
+interface TapKitReadyEvent extends CustomEvent<{
+    gaId: string;
+}> {
+}
+/**
+ * TapKit Close Event - Fired when chat is closed from within iframe
+ *
+ * @example
+ * ```typescript
+ * document.addEventListener('tapkit:close', () => {
+ *   console.log('Chat closed');
+ * });
+ * ```
+ */
+interface TapKitCloseEvent extends CustomEvent<undefined> {
+}
+/**
+ * TapKit Timeline Seek Event - Fired when user clicks timeline in chat
+ *
+ * @example
+ * ```typescript
+ * document.addEventListener('tapkit:timeline:seek', (e) => {
+ *   videoElement.currentTime = e.detail.clipPlayHead;
+ * });
+ * ```
+ */
+interface TapKitTimelineSeekEvent extends CustomEvent<{
+    clipId: string;
+    clipPlayHead: number;
+}> {
+}
+/**
+ * TapKit Material View Open Event - Fired when PDF/document viewer opens
+ *
+ * @example
+ * ```typescript
+ * document.addEventListener('tapkit:material:view:open', (e) => {
+ *   console.log('Material opened:', e.detail.materialId);
+ * });
+ * ```
+ */
+interface TapKitMaterialViewOpenEvent extends CustomEvent<{
+    materialId: string;
+    presignedUrl: string;
+    pageStart?: number;
+    pageEnd?: number;
+}> {
+}
+/**
+ * TapKit Material View Close Event - Fired when PDF/document viewer closes
+ *
+ * @example
+ * ```typescript
+ * document.addEventListener('tapkit:material:view:close', () => {
+ *   console.log('Material viewer closed');
+ * });
+ * ```
+ */
+interface TapKitMaterialViewCloseEvent extends CustomEvent<undefined> {
+}
 /**
  * Shortcut Key Configuration
  */
@@ -2411,16 +2600,19 @@ interface VideoPlayerAdapter {
  *
  * @example
  * ```typescript
- * // HTML5 Video
+ * // HTML5 Video (recommended - clipId auto-tracked)
  * const videoElement = document.querySelector('video');
- * sdk.video.bind(videoElement, 'clip-123');
+ * sdk.video.bind(videoElement);  // clipId from SDK config, auto-updates with setCourse()
  *
  * // Custom Adapter
  * const adapter = {
  *   getCurrentTime: () => player.currentTime,
  *   setCurrentTime: (time) => { player.currentTime = time; }
  * };
- * sdk.video.bind(adapter, 'clip-123');
+ * sdk.video.bind(adapter);
+ *
+ * // Manual clipId (for special cases)
+ * sdk.video.bind(videoElement, 'specific-clip-id');
  * ```
  */
 type VideoPlayerConfig = HTMLVideoElement | VideoPlayerAdapter;
@@ -2453,87 +2645,17 @@ interface TapKitInstance {
     /** Hide chat container */
     hide(): void;
     /**
-     * Internal config update method (soft-private, discouraged)
-     *
-     * Accepts any config key-value pairs for advanced configuration.
-     * Type is intentionally generic to hide implementation details.
-     *
-     * @deprecated Use public APIs instead. This is kept for backward compatibility.
-     * Prefer using Symbol API via Symbol.for("tapkit.config") for advanced config.
-     *
-     * @internal Soft-private method (starts with _)
+     * Update course information
+     * @param course - Course info (courseId and clipId required, userId and clipPlayHead optional)
      */
-    _updateConfig?(options: Record<string, unknown>): void;
+    setCourse(course: Partial<Course> & {
+        courseId: string;
+        clipId: string;
+    }): void;
 }
 /** TapKit constructor type */
 type TapKitConstructor = new (config: TapKitConfig) => TapKitInstance;
 
-/**
- * Styling Types
- */
-type PositionType = {
-    top?: string;
-    left?: string;
-    right?: string;
-    bottom?: string;
-};
-/**
- * Floating mode configuration
- * Includes position, size, and style settings for floating container
- */
-type FloatingConfig = {
-    /** Position (default: top: "50px", right: "24px") */
-    position?: PositionType;
-    /** Width (default: "340px") */
-    width?: string;
-    /** Height (default: "calc(100% - 116px)") */
-    height?: string;
-    /** Border radius (default: "16px") */
-    borderRadius?: string;
-    /** Expanded width for PDF viewer (default: "min(90vw, 1200px)") */
-    expandedWidth?: string;
-    /** Expanded height for PDF viewer (default: "90vh") */
-    expandedHeight?: string;
-    /** Expanded top position for PDF viewer (default: "5vh") */
-    expandedTop?: string;
-    /** Expanded right position for PDF viewer (default: "5vw") */
-    expandedRight?: string;
-};
-/**
- * Sidebar Configuration
- */
-type SidebarConfig = {
-    /** Maximum width of the sidebar (default: "min(50%, 1000px)") */
-    maxWidth?: string;
-    /** Expanded maximum width for PDF viewer (default: "min(70%, 1400px)") */
-    expandedMaxWidth?: string;
-    /** Minimum viewport width to enable sidebar mode (default: 768) */
-    minViewportWidth?: number;
-};
-/**
- * Container Configuration (SSOT - Type Level)
- *
- * This is the SINGLE SOURCE OF TRUTH for container configuration at the TYPE level.
- * - Public API: TapKitInitParams.container
- * - Internal: Container class configuration
- * - Protocol: ConfigUpdateMessage.container mirrors this structure
- *
- * When modifying this type, also update ConfigUpdateMessage.container in @coxwave/tap-messages
- *
- * @example
- * // Custom styling for floating/sidebar modes
- * const config: ContainerConfig = {
- *   floatingConfig: { width: "400px", position: { top: "80px" } },
- *   sidebarConfig: { maxWidth: "800px" }
- * }
- */
-type ContainerConfig = {
-    /** Floating layout configuration (applied when SDK auto-creates container in floating layout) */
-    floatingConfig?: FloatingConfig;
-    /** Sidebar layout configuration (applied when SDK auto-creates container in sidebar layout) */
-    sidebarConfig?: SidebarConfig;
-};
-
 /**
  * Type declarations for <tap-button> Web Component
  *
@@ -2834,6 +2956,167 @@ interface TapContainerAttributes {
   onDestroy?: () => void;
 }
 
+/**
+ * Type declarations for <tap-html-viewer> Web Component
+ *
+ * Provides TypeScript support for using <tap-html-viewer> in JSX/TSX.
+ * The actual Web Component is registered by tap-kit-core when loaded.
+ */
+
+
+
+// React 19 requires module augmentation based on tsconfig jsx setting
+// - "jsx": "react-jsx" → augment "react/jsx-runtime"
+// - "jsx": "preserve" → augment "react" (Next.js default)
+
+// For Next.js (jsx: preserve)
+declare module "react" {
+  namespace JSX {
+    interface IntrinsicElements {
+      "tap-html-viewer": TapHtmlViewerAttributes;
+    }
+  }
+}
+
+// For CRA, Vite (jsx: react-jsx)
+declare module "react/jsx-runtime" {
+  namespace JSX {
+    interface IntrinsicElements {
+      "tap-html-viewer": TapHtmlViewerAttributes;
+    }
+  }
+}
+
+/**
+ * Configuration for opening HTML viewer
+ */
+interface HtmlViewConfig {
+  /**
+   * URL to load HTML content from (uses iframe src)
+   */
+  htmlUrl?: string;
+
+  /**
+   * HTML string to render directly (uses iframe srcdoc)
+   */
+  htmlContent?: string;
+
+  /**
+   * Optional title for the viewer header
+   */
+  title?: string;
+}
+
+/**
+ * Public API interface for TapHtmlViewerElement Web Component
+ *
+ * This interface defines the contract that tap-kit-core's TapHtmlViewerElement must implement.
+ * It provides type-safe access to the Web Component's public API.
+ *
+ * The HTML viewer displays HTML content in a sandboxed iframe overlay
+ * positioned relative to a container element.
+ */
+interface ITapHtmlViewerElement extends HTMLElement {
+  /**
+   * Container element reference for positioning
+   * Must be set before calling open()
+   */
+  containerElement: HTMLElement | null;
+
+  /**
+   * Open HTML viewer with configuration
+   *
+   * Displays HTML content in a sandboxed iframe overlay.
+   * Content source: htmlUrl (external) or htmlContent (inline).
+   *
+   * @param config - HTML view configuration
+   * @fires open - When viewer is successfully displayed
+   */
+  open(config: HtmlViewConfig): void;
+
+  /**
+   * Close HTML viewer and cleanup
+   *
+   * Hides overlay and resets state.
+   *
+   * @fires close - When viewer is closed
+   */
+  close(): void;
+
+  /**
+   * Update overlay position relative to container
+   *
+   * Automatically called on container resize/move.
+   * Can be manually triggered if needed.
+   */
+  updatePosition(): void;
+
+  /**
+   * Hide overlay without closing viewer
+   *
+   * Called when container is hidden. Preserves viewer state
+   * so it can be shown again when container becomes visible.
+   */
+  hideOverlay(): void;
+
+  /**
+   * Show overlay (if viewer has content)
+   *
+   * Called when container is shown. Only displays overlay
+   * if viewer has content loaded.
+   */
+  showOverlay(): void;
+
+  /**
+   * Check if viewer is currently visible
+   *
+   * @returns true if visible, false otherwise
+   */
+  readonly isVisible: boolean;
+}
+
+/**
+ * Props/Attributes for <tap-html-viewer> Web Component
+ */
+interface TapHtmlViewerAttributes {
+  /**
+   * Element ID attribute
+   */
+  id?: string;
+
+  /**
+   * CSS class name(s)
+   */
+  className?: string;
+
+  /**
+   * Container element reference for positioning
+   * Required before calling open()
+   */
+  containerElement?: HTMLElement | null;
+
+  /**
+   * Child content (not typically used for tap-html-viewer)
+   * The component automatically creates overlay content
+   */
+  children?: ReactNode;
+
+  /**
+   * Custom inline styles
+   */
+  style?: CSSProperties;
+
+  /**
+   * Event handler for when viewer is successfully displayed
+   */
+  onOpen?: () => void;
+
+  /**
+   * Event handler for when viewer is closed
+   */
+  onClose?: () => void;
+}
+
 /**
  * TapKit Web Component Type Definitions
  *
@@ -2859,7 +3142,22 @@ interface EventManager {
  * VideoController type (matches TapKitInstance.video)
  */
 interface VideoController {
-  bind: (config: VideoPlayerConfig, clipId: string) => void;
+  /**
+   * Bind video player for timeline synchronization
+   *
+   * @param config - HTMLVideoElement or VideoPlayerAdapter
+   * @param clipId - Optional clipId. If not provided, uses SDK config (auto-tracks changes from setCourse)
+   *
+   * @example
+   * ```typescript
+   * // Auto-tracking (recommended) - clipId syncs with setCourse()
+   * kit.video.bind(videoElement);
+   *
+   * // Manual clipId (for special cases)
+   * kit.video.bind(videoElement, 'specific-clip-id');
+   * ```
+   */
+  bind: (config: VideoPlayerConfig, clipId?: string) => void;
   unbind: () => void;
 }
 
@@ -3342,6 +3640,28 @@ interface TapMaterialViewerAttributes {
 
 
 declare global {
+  /**
+   * TapKit CustomEvent types for document.addEventListener
+   *
+   * @example
+   * ```typescript
+   * document.addEventListener('tapkit:ready', (e) => {
+   *   console.log(e.detail.gaId); // Type-safe!
+   * });
+   *
+   * document.addEventListener('tapkit:timeline:seek', (e) => {
+   *   videoElement.currentTime = e.detail.clipPlayHead; // Type-safe!
+   * });
+   * ```
+   */
+  interface DocumentEventMap {
+    "tapkit:ready": TapKitReadyEvent;
+    "tapkit:close": TapKitCloseEvent;
+    "tapkit:timeline:seek": TapKitTimelineSeekEvent;
+    "tapkit:material:view:open": TapKitMaterialViewOpenEvent;
+    "tapkit:material:view:close": TapKitMaterialViewCloseEvent;
+  }
+
   interface Window {
     TapKit?: TapKitConstructor;
     createTapKit?: (config: {
@@ -3381,4 +3701,4 @@ declare global {
   function cancelIdleCallback(handle: number): void;
 }
 
-export { ALARM_DURATION, type AlarmClickMessage, AlarmClickSchema, type AlarmElement, type AlarmElementProps, AlarmElementPropsSchema, AlarmElementSchema, type AlarmFadeInMessage, AlarmFadeInSchema, AlarmMessageInstanceSchema, type AlarmMessageInstanceType, type AlarmPayload, type AlarmType, type CSSStyle, CSSStyleSchema, type ConfigUpdateMessage, ConfigUpdateSchema, type ContainerConfig, type ContainerLayoutStateChangedMessage, ContainerLayoutStateChangedSchema, type ContainerModeChangeAckMessage, ContainerModeChangeAckSchema, type ContainerModeChangeMessage, ContainerModeChangeSchema, type ContainerVisibility, type Course, type EventManager, type FloatingConfig, type GAEventMessage, GAEventSchema, type ITapButtonElement, type ITapContainerElement, type ITapKitElement, type ITapMaterialViewerElement, TapKitInitializationError as InitializationError, type MaterialViewCloseMessage, MaterialViewCloseSchema, type MaterialViewConfig, type MaterialViewErrorMessage, MaterialViewErrorSchema, type MaterialViewOpenMessage, MaterialViewOpenSchema, MaterialViewerError, type PopUpCloseMessage, PopUpCloseSchema, type PopUpOpenMessage, PopUpOpenSchema, type PositionType, type SeekTimelineParamsType, type ShortcutKeyPropertiesType, type SidebarConfig, TAP_BUTTON_CLICK_EVENT, TAP_ERROR_MARKER, type TapButtonAttributes, type TapButtonClickEventDetail, type TapCloseMessage, TapCloseSchema, type TapContainerAttributes, type TapErrorOptions, type TapKitConfig, type TapKitConfigOptions, TapKitConfigurationError, type TapKitConstructor, type TapKitElement, type TapKitElementEventMap, TapKitError, TapKitIframeError, type TapKitInitParams, TapKitInitializationError, type TapKitInstance, TapKitLoaderError, TapKitMessageError, type TapKitRuntimeConfig, type TapMaterialViewerAttributes, type TapMessage, type TapMessageRecord, TapMessageSchema, type TapMessageType, type TapReadyMessage, TapReadySchema, type TimelineSeekMessage, TimelineSeekSchema, type VideoController, type VideoPlayerAdapter, type VideoPlayerConfig, type ViewportResizeMessage, ViewportResizeSchema };
+export { ALARM_DURATION, type AlarmClickMessage, AlarmClickSchema, type AlarmElement, type AlarmElementProps, AlarmElementPropsSchema, AlarmElementSchema, type AlarmFadeInMessage, AlarmFadeInSchema, AlarmMessageInstanceSchema, type AlarmMessageInstanceType, type AlarmPayload, type AlarmType, type CSSStyle, CSSStyleSchema, type ConfigUpdateMessage, ConfigUpdateSchema, type ContainerConfig, type ContainerLayoutStateChangedMessage, ContainerLayoutStateChangedSchema, type ContainerModeChangeAckMessage, ContainerModeChangeAckSchema, type ContainerModeChangeMessage, ContainerModeChangeSchema, type ContainerVisibility, type Course, type DisplayMode, type EventManager, type FloatingConfig, type GAEventMessage, GAEventSchema, type HtmlViewCloseMessage, HtmlViewCloseSchema, type HtmlViewConfig, type HtmlViewOpenMessage, HtmlViewOpenSchema, type ITapButtonElement, type ITapContainerElement, type ITapHtmlViewerElement, type ITapKitElement, type ITapMaterialViewerElement, TapKitInitializationError as InitializationError, type LayoutMode, type MaterialViewCloseMessage, MaterialViewCloseSchema, type MaterialViewConfig, type MaterialViewErrorMessage, MaterialViewErrorSchema, type MaterialViewOpenMessage, MaterialViewOpenSchema, MaterialViewerError, type PopUpCloseMessage, PopUpCloseSchema, type PopUpOpenMessage, PopUpOpenSchema, type PositionType, type SeekTimelineParamsType, type ShortcutKeyPropertiesType, type SidebarConfig, TAP_BUTTON_CLICK_EVENT, TAP_ERROR_MARKER, type TapButtonAttributes, type TapButtonClickEventDetail, type TapCloseMessage, TapCloseSchema, type TapContainerAttributes, type TapErrorOptions, type TapHtmlViewerAttributes, type TapKitConfig, type TapKitConfigOptions, TapKitConfigurationError, type TapKitConstructor, type TapKitElement, type TapKitElementEventMap, TapKitError, TapKitIframeError, type TapKitInitParams, TapKitInitializationError, type TapKitInstance, TapKitLoaderError, TapKitMessageError, type TapKitRuntimeConfig, type TapMaterialViewerAttributes, type TapMessage, type TapMessageRecord, TapMessageSchema, type TapMessageType, type TapReadyMessage, TapReadySchema, type TimelineSeekMessage, TimelineSeekSchema, type VideoController, type VideoPlayerAdapter, type VideoPlayerConfig, type ViewportResizeMessage, ViewportResizeSchema };

package/dist/index.js

@@ -158,7 +158,7 @@ var MaterialViewerError = class _MaterialViewerError extends TapKitError {
 };
 
 // src/protocol/alarm.ts
-var ALARM_DURATION = 18e3;
+var ALARM_DURATION = 16e3;
 
 // ../../node_modules/.pnpm/valibot@1.1.0_typescript@5.9.2/node_modules/valibot/dist/index.js
 var store;
@@ -819,6 +819,15 @@ var MaterialViewErrorSchema = object({
   ]),
   message: optional(string())
 });
+var HtmlViewOpenSchema = object({
+  type: literal("html:view:open"),
+  htmlUrl: optional(string()),
+  htmlContent: optional(string()),
+  title: optional(string())
+});
+var HtmlViewCloseSchema = object({
+  type: literal("html:view:close")
+});
 var ContainerModeChangeSchema = object({
   type: literal("container:mode:change"),
   mode: union([literal("floating"), literal("sidebar")]),
@@ -908,6 +917,8 @@ var TapMessageSchema = union([
   MaterialViewOpenSchema,
   MaterialViewCloseSchema,
   MaterialViewErrorSchema,
+  HtmlViewOpenSchema,
+  HtmlViewCloseSchema,
   ContainerModeChangeSchema,
   ContainerModeChangeAckSchema,
   ContainerLayoutStateChangedSchema,
@@ -919,6 +930,6 @@ var TapMessageSchema = union([
 // src/tap-button.d.ts
 var TAP_BUTTON_CLICK_EVENT = "tap-button:click";
 
-export { ALARM_DURATION, AlarmClickSchema, AlarmElementPropsSchema, AlarmElementSchema, AlarmFadeInSchema, AlarmMessageInstanceSchema, CSSStyleSchema, ConfigUpdateSchema, ContainerLayoutStateChangedSchema, ContainerModeChangeAckSchema, ContainerModeChangeSchema, GAEventSchema, TapKitInitializationError as InitializationError, MaterialViewCloseSchema, MaterialViewErrorSchema, MaterialViewOpenSchema, MaterialViewerError, PopUpCloseSchema, PopUpOpenSchema, TAP_BUTTON_CLICK_EVENT, TAP_ERROR_MARKER, TapCloseSchema, TapKitConfigurationError, TapKitError, TapKitIframeError, TapKitInitializationError, TapKitLoaderError, TapKitMessageError, TapMessageSchema, TapReadySchema, TimelineSeekSchema, ViewportResizeSchema };
+export { ALARM_DURATION, AlarmClickSchema, AlarmElementPropsSchema, AlarmElementSchema, AlarmFadeInSchema, AlarmMessageInstanceSchema, CSSStyleSchema, ConfigUpdateSchema, ContainerLayoutStateChangedSchema, ContainerModeChangeAckSchema, ContainerModeChangeSchema, GAEventSchema, HtmlViewCloseSchema, HtmlViewOpenSchema, TapKitInitializationError as InitializationError, MaterialViewCloseSchema, MaterialViewErrorSchema, MaterialViewOpenSchema, MaterialViewerError, PopUpCloseSchema, PopUpOpenSchema, TAP_BUTTON_CLICK_EVENT, TAP_ERROR_MARKER, TapCloseSchema, TapKitConfigurationError, TapKitError, TapKitIframeError, TapKitInitializationError, TapKitLoaderError, TapKitMessageError, TapMessageSchema, TapReadySchema, TimelineSeekSchema, ViewportResizeSchema };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map