@readerseye2/cr_type 1.0.71 → 1.0.72

package/dist/index.d.ts

@@ -2,3 +2,4 @@ export * from './session/session.type';
 export * from './socket';
 export * from './book';
 export * from './ast';
+export * from './viewer/viewerEvent.types';

package/dist/index.js

@@ -19,3 +19,4 @@ __exportStar(require("./session/session.type"), exports);
 __exportStar(require("./socket"), exports); // socket 전체 export
 __exportStar(require("./book"), exports);
 __exportStar(require("./ast"), exports); // AST 타입 (SectionData, Block 등)
+__exportStar(require("./viewer/viewerEvent.types"), exports); // 뷰어 이벤트/스냅샷 타입

package/dist/socket/monitor.types.d.ts

@@ -1,4 +1,4 @@
-import { ViewerEvent, ViewerSnapshot, ReadingSessionInfo } from './reading-section.types';
+import { SocketViewerEvent, ViewerSnapshot, ReadingSessionInfo } from './reading-section.types';
 /** 모니터링 메타 정보 (S3 meta.json) */
 export interface MonitorMeta {
     targetSocketId: string;
@@ -18,7 +18,7 @@ export interface MonitorChunk {
     readingSessionId: string | null;
     sectionId: string | null;
     bookIdx: number | null;
-    events: ViewerEvent[];
+    events: SocketViewerEvent[];
     snapshot: ViewerSnapshot | null;
     /** 청크 생성 주기 (ms) */
     delayMs: number;

package/dist/socket/reading-section.types.d.ts

@@ -1,38 +1,20 @@
-/** 재생에 필요한 뷰어 설정 상태 (CRViewerState의 핵심 필드) */
-export interface ViewerStateSnapshot {
-    mode: 'scroll' | 'page';
-    theme: 'light' | 'dark' | 'sepia' | 'green';
-    fontFamily: string;
-    fontSizePx: number;
-    lineHeight: number;
-    marginX: number;
-    marginY: number;
-    pointerStyle: 'highlight' | 'underline';
-    pointerColor: string;
-    breakMarks: {
-        slash: boolean;
-    };
-    breakGapPx: number;
-    showPointer: boolean;
-    showSplit: boolean;
-}
-/** 뷰어 스냅샷 (현재 상태) */
+import type { ViewerEventType, RecordingViewerState } from '../viewer/viewerEvent.types';
+/** 뷰어 설정 상태 (CRViewerState에서 재사용) */
+export type ViewerStateSnapshot = RecordingViewerState;
+/** 뷰어 스냅샷 (소켓 통신용 - 현재 읽기 상태) */
 export interface ViewerSnapshot {
     viewMode: 'scroll' | 'page';
     globalRunIndex: number;
     pageIndex?: number;
     scrollPosition?: number;
     totalItems: number;
-    /** 뷰어 너비 (재생 시 동일 크기로 렌더링) */
     viewportWidth?: number;
-    /** 뷰어 높이 (재생 시 동일 크기로 렌더링) */
     viewportHeight?: number;
-    /** 뷰어 설정 상태 (재생 시 동일하게 적용) */
     viewerState?: ViewerStateSnapshot;
 }
-/** 뷰어 이벤트 */
-export interface ViewerEvent {
-    type: 'page_change' | 'scroll' | 'overlay_toggle' | 'range_select' | 'quiz_answer' | 'gi_change' | 'global_index_change' | 'section_change' | 'mode_change' | 'settings_change' | 'viewer_state_snapshot' | 'recording_start' | 'recording_stop' | 'audio_control';
+/** 소켓 전송용 뷰어 이벤트 (간소화된 형태) */
+export interface SocketViewerEvent {
+    type: ViewerEventType | 'overlay_toggle' | 'range_select' | 'quiz_answer' | 'gi_change';
     timestamp: number;
     data: Record<string, unknown>;
 }
@@ -83,7 +65,7 @@ export interface SessionProgressPayload {
 }
 /** 이벤트 배치 전송 페이로드 */
 export interface SessionEventPayload {
-    events: ViewerEvent[];
+    events: SocketViewerEvent[];
 }
 /** 세션 구독 페이로드 (Admin용) */
 export interface SessionSubscribePayload {
@@ -125,7 +107,7 @@ export interface SessionProgressResponse {
 /** 세션 이벤트 응답 */
 export interface SessionEventsResponse {
     sessionId: string;
-    events: ViewerEvent[];
+    events: SocketViewerEvent[];
 }
 /** 세션 목록 응답 */
 export interface SessionListResponse {

package/dist/socket/reading-section.types.js

@@ -1,5 +1,5 @@
 "use strict";
 // src/socket/reading-section.types.ts
 // 읽기 섹션 모니터링용 데이터 타입 정의
-// 이벤트 인터페이스는 socket-clientToServerEvents.type.ts, socket-serverToClientEvents.type.ts 참조
+// 뷰어 이벤트 타입은 viewer/viewerEvent.types.ts에서 가져옴
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/socket/socket-serverToClientEvents.type.d.ts

@@ -1,5 +1,5 @@
 import { MessageReadResponse, MessageResponse, NoticeMessageResult } from "./socket-message.types";
-import { ReadingSessionInfo, ViewerEvent, ViewerSnapshot } from "./reading-section.types";
+import { ReadingSessionInfo, SocketViewerEvent, ViewerSnapshot } from "./reading-section.types";
 import { ConnectedUser, ConnectedUsersGrouped } from "./connected-user.types";
 import { MonitorStartedPayload, MonitorChunkPayload, MonitorSessionChangedPayload, MonitorStoppedPayload, MonitorErrorPayload } from "./monitor.types";
 export interface ServerToClientEvents {
@@ -35,7 +35,7 @@ export interface ReadingServerToClientEvents {
     }) => void;
     'reading-section:events': (payload: {
         sessionId: string;
-        events: ViewerEvent[];
+        events: SocketViewerEvent[];
     }) => void;
     'reading-section:error': (payload: {
         message: string;

package/dist/viewer/viewerEvent.types.d.ts

@@ -0,0 +1,132 @@
+export type ViewerMode = 'scroll' | 'page';
+export type ViewerTheme = 'light' | 'dark' | 'sepia' | 'green';
+export type PointerStyle = 'highlight' | 'underline';
+/** 뷰어 전체 상태 (CR_viewer store 상태) */
+export type CRViewerState = {
+    mode: ViewerMode;
+    theme: ViewerTheme;
+    fontFamily: string;
+    fontSizePx: number;
+    lineHeight: number;
+    marginX: number;
+    marginY: number;
+    showOverlays: boolean;
+    isSettingsOpen: boolean;
+    pointerStyle: PointerStyle;
+    pointerColor: string;
+    breakMarks: {
+        slash: boolean;
+    };
+    breakGapPx: number;
+    muteAudio: boolean;
+    audioTargetWpm: number;
+    audioSpeed: number;
+    showPointer: boolean;
+    showSplit: boolean;
+    viewportWidth: number;
+    viewportHeight: number;
+    playbackViewportWidth: number;
+    playbackViewportHeight: number;
+};
+/** 뷰어 이벤트 타입 */
+export type ViewerEventType = 'recording_start' | 'recording_stop' | 'global_index_change' | 'scroll' | 'page_change' | 'section_change' | 'mode_change' | 'settings_change' | 'viewer_state_snapshot' | 'render_start' | 'loading_start' | 'loading_end' | 'viewport_resize' | 'audio_control';
+/** 오디오 상태 스냅샷 */
+export type AudioSnapshot = {
+    status: 'idle' | 'loading' | 'playing' | 'paused' | 'ended' | 'error';
+    currentClip: number;
+    currentTimeMs: number;
+};
+/** 녹화용 뷰어 상태 (Partial - 모든 필드가 필수는 아님) */
+export type RecordingViewerState = Partial<CRViewerState>;
+/** 녹화 시작 시 저장할 초기 스냅샷 */
+export type RecordingSnapshot = {
+    viewerState: RecordingViewerState;
+    globalIndex: number;
+    scrollY?: number;
+    anchorGI?: number;
+    anchorOffsetRatio?: number;
+    currentPage?: number;
+    sectionId: string;
+    viewportWidth: number;
+    viewportHeight: number;
+    audio?: AudioSnapshot;
+};
+/** 기본 이벤트 (뷰어에서 emit) */
+export type ViewerEventBase<T extends ViewerEventType, P = Record<string, unknown>> = {
+    type: T;
+    timestamp: number;
+    payload: P;
+};
+/** 저장용 이벤트 (외부에서 relTime 추가) */
+export type StoredViewerEvent<T extends ViewerEventType, P = Record<string, unknown>> = ViewerEventBase<T, P> & {
+    relTime: number;
+};
+/** 오디오 제어 액션 타입 */
+export type AudioControlAction = 'play' | 'pause' | 'stop';
+export type RecordingStartEvent = ViewerEventBase<'recording_start', {
+    snapshot: RecordingSnapshot;
+}>;
+export type RecordingStopEvent = ViewerEventBase<'recording_stop', {
+    duration: number;
+}>;
+export type GlobalIndexChangeEvent = ViewerEventBase<'global_index_change', {
+    globalIndex: number;
+}>;
+export type ScrollEvent = ViewerEventBase<'scroll', {
+    scrollTop: number;
+    scrollRatio: number;
+    anchorGI: number;
+    anchorOffsetRatio: number;
+}>;
+export type PageChangeEvent = ViewerEventBase<'page_change', {
+    page: number;
+}>;
+export type SectionChangeEvent = ViewerEventBase<'section_change', {
+    sectionId: string;
+}>;
+export type ModeChangeEvent = ViewerEventBase<'mode_change', {
+    mode: ViewerMode;
+}>;
+export type SettingsChangeEvent = ViewerEventBase<'settings_change', {
+    key: keyof CRViewerState;
+    value: unknown;
+}>;
+export type ViewerStateSnapshotEvent = ViewerEventBase<'viewer_state_snapshot', {
+    viewerState: CRViewerState;
+}>;
+export type RenderStartEvent = ViewerEventBase<'render_start', {
+    sectionId: string;
+}>;
+export type LoadingStartEvent = ViewerEventBase<'loading_start', Record<string, never>>;
+export type LoadingEndEvent = ViewerEventBase<'loading_end', {
+    duration: number;
+}>;
+export type ViewportResizeEvent = ViewerEventBase<'viewport_resize', {
+    width: number;
+    height: number;
+}>;
+export type AudioControlEvent = ViewerEventBase<'audio_control', {
+    action: AudioControlAction;
+}>;
+/** 모든 뷰어 이벤트 타입 (Union) */
+export type ViewerEvent = RecordingStartEvent | RecordingStopEvent | GlobalIndexChangeEvent | ScrollEvent | PageChangeEvent | SectionChangeEvent | ModeChangeEvent | SettingsChangeEvent | ViewerStateSnapshotEvent | RenderStartEvent | LoadingStartEvent | LoadingEndEvent | ViewportResizeEvent | AudioControlEvent;
+export type ViewerEventCallback = (event: ViewerEvent) => void;
+/** 저장용 이벤트 (any type) */
+export type StoredEvent = StoredViewerEvent<ViewerEventType, unknown>;
+/** 녹화 청크 */
+export type RecordingChunk = {
+    index: number;
+    startTime: number;
+    endTime: number;
+    snapshot: RecordingSnapshot;
+    events: StoredEvent[];
+};
+/** 녹화 메타데이터 */
+export type RecordingMeta = {
+    id: string;
+    startedAt: number;
+    totalDuration: number;
+    chunkDuration: number;
+    chunkCount: number;
+    sectionId: string;
+};

package/dist/viewer/viewerEvent.types.js

@@ -0,0 +1,5 @@
+"use strict";
+// src/viewer/viewerEvent.types.ts
+// CR_viewer 이벤트 및 스냅샷 타입 정의
+// 모든 프로젝트(CR_viewer, CR_app, CR_admin, CR_ws)에서 이 타입을 사용
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@readerseye2/cr_type",
-  "version": "1.0.71",
+  "version": "1.0.72",
   "description": "CheckReading shared TypeScript types",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",