sales-frontend-oz 0.0.7 → 0.0.9

package/dist/index.d.cts

@@ -1,2 +1,704 @@
+import { CSSProperties } from 'react';
+import * as sales_frontend_bridge from 'sales-frontend-bridge';
+import { FormInfo, OzdFile, DownloadOzdOptions } from 'sales-frontend-bridge';
+export { DownloadOzdOptions, FormInfo, OzdFile } from 'sales-frontend-bridge';
 
-export {  }
+/**
+ * 형광펜 편집 관련 상수
+ */
+declare const commentPenYellow: string[];
+declare const commentPenPink: string[];
+declare const commentPenGreen: string[];
+declare const commentPenEraser: string[];
+
+/**
+ * 모든페이지 공용으로 쓰는 OZ 뷰어파라미터
+ */
+declare const commonOzParam: string[];
+
+/**
+ * PDF export시 공통으로 필요한 파라미터
+ *
+ * 제공하지 않는 파라미터
+ *  - filename
+ *    - ex) `pdf.filename=test.pdf`
+ *  - pages
+ *    - ex) `export.pages=1-2`
+ *  - userpassword
+ *    - ex) `pdf.userpassword=123213`
+ */
+declare const commonPdfExportParam: string[];
+
+/**
+ * OZ 뷰어에 관련된 이벤트 목록
+ */
+declare enum OZViewerEvent {
+    /**
+     * 보고서 생성 단계별로 발생하는 이벤트
+     * - `OZViewerProgressEvent` 이벤트와 매칭된다
+     * - `viewer.progresscommand=true` 설정이 필요하다
+     * - `OZViewerProgressEvent`와 매칭된다
+     * - 모든 문서가 로딩되면 `OZReportCreated` 이벤트를 트리거시켜주어야 한다
+     */
+    OZProgressCommand = "OZProgressCommand",
+    /**
+     * 에러 발생 시 발생하는 이벤트
+     * - `viewer.errorcommand=true` 설정이 필요하다
+     * - `OZViewerErrorEvent`와 매칭된다
+     */
+    OZErrorCommand = "OZErrorCommand",
+    /**
+     * 화면에 표시되는 페이지가 변경된 후 발생하는 이벤트
+     * - `viewer.pagechangecommand=true` 설정이 필요하다
+     * - `OZViewerChangeEvent`와 매칭된다
+     */
+    OZPageChangeCommand = "OZPageChangeCommand",
+    /**
+     * 화면에 표시되는 보고서가 변경된 후 발생하는 이벤트
+     * - `viewer.reportchangecommand=true` 설정이 필요하다
+     * - `OZViewerChangeEvent`와 매칭된다
+     */
+    OZReportChangeCommand = "OZReportChangeCommand",
+    /**
+     * `OZUserEvent` _TriggerOCXUserEvent 함수 실행 시 발생하는 이벤트
+     * - `OZViewerUserEvent`와 매칭된다
+     */
+    OZUserEvent = "OZUserEvent",
+    /**
+     * `OZPageBindCommand` 페이지가 바인딩된 후 발생하는 이벤트
+     * - `viewer.pagebindcommandinterval` 파라미터에서 설정한 주기별로 동작
+     * - ex) `viewer.pagebindcommandinterval=500`
+     * - `OZViewerPageBindEvent`와 매칭된다
+     */
+    OZPageBindCommand = "OZPageBindCommand",
+    /**
+     * 사용자가 입력 컴포넌트를 클릭하거나 값을 변경하여 이벤트가 실행된 경우 발생되는 이벤트'
+     * - 호환되는 이벤트
+     *   - `OnClick`
+     *   - `OnFinish`
+     *   - `OnFocus`
+     *   - `OnKillFocus`
+     *   -  `OnPause`
+     *   -  `OnPlay`
+     *   -  `OnStop`
+     *   -  `OnValueChanged`
+     * - `eform.inputeventcommand=true` 설정이 필요하다
+     * - `OZEFormInputEvent`와 매칭된다
+     */
+    OZEFormInputEventCommand = "OZEFormInputEventCommand",
+    /**
+     * 보고서 저장 시 발생하는 이벤트
+     * - `OZExportEvent`와 매칭된다
+     */
+    OZExportCommand = "OZExportCommand",
+    /**
+     * 오즈뷰어, (오즈전용)PDF 뷰어 내 버튼 클릭시 발생하는 이벤트
+     * - `OZBtnTouchEvent`와 매칭된다
+     */
+    OZBtnTouchEvent = "btnTouchEvent",
+    /**
+     * `OZProgressCommand` 이벤트가 문서 갯수만큼 불리면 이 이벤트를 트리거한다
+     *  - 웹에서 직접 트리거 하는 이벤트
+     */
+    OZReportCreated = "OZReportCreated"
+}
+/**
+ * TriggerExternal에 사용할 param1인자를 정의한 enum
+ * - GetDraftData 중간저장 서명이미지 추출
+ * - cropimage 서명이미지 크롭
+ */
+declare enum OZTriggerExternalEvent {
+    GetDraftData = "getDraftData",
+    CropImage = "cropimage"
+}
+/**
+ * `OZViewerEvent.OZProgressCommand` 이벤트의 `e.detail` 타입 정의
+ * ```tsx
+ * import { OZViewerEvent } from 'sales-frontend-bridge';
+ * window.addEventListener(OZViewerEvent.OZProgressCommand, (e) => { console.log(e.detail); });
+ * ```
+ *
+ * `step과` `state`는 step => state 방식으로 진행된다
+ *
+ * 예시
+ * ```bash
+ * # step0 뷰어실행
+ * [step=0][state=0] # 뷰어 실행 시작
+ * [step=0][state=1] # 뷰어 실행 완료
+ * # step2 보고서 템플릿 생성
+ * [step=1][state=0] # 보고서 템플릿 생성 시작
+ * [step=1][state=1] # 보고서 템플릿 생성 완료
+ * ```
+ */
+type OZViewerProgressEvent = {
+    /**
+     * 보고서 생성 단계
+     *  - 0 : 뷰어 실행 옵션 설정
+     *  - 1 : 보고서 파일 다운로드
+     *  - 2 : 보고서 템플릿 생성
+     *  - 3 : 데이터 다운로드
+     *  - 4 : 보고서 바인딩
+     */
+    step: '0' | '1' | '2' | '3' | '4';
+    /**
+     * 보고서 생성 상태
+     *  - 1 : 시작
+     *  - 2 : 완료
+     */
+    state: '1' | '2';
+    /** 보고서 이름 */
+    reportname: string;
+};
+/**
+ * `OZViewerEvent.OZErrorCommand` 이벤트의 `e.detail` 타입 정의
+ * ```tsx
+ * import { OZViewerEvent } from 'sales-frontend-bridge';
+ * window.addEventListener(OZViewerEvent.OZErrorCommand, (e) => { console.log(e.detail); });
+ * ```
+ */
+type OZViewerErrorEvent = {
+    /** 에러 메시지 코드 */
+    code: string;
+    /** 에러 기본 메시지 */
+    message: string;
+    /** 에러 상세 메시지 */
+    detailmessage: string;
+    /** 보고서 이름 */
+    reportname: string;
+};
+/**
+ * 두 이벤트의 공용 타입
+ * - `OZViewerEvent.OZPageChangeCommand` 이벤트의 `e.detail` 타입 정의
+ * - `OZViewerEvent.OZReportChangeCommand` 이벤트의 `e.detail` 타입 정의
+ * ```tsx
+ * import { OZViewerEvent } from 'sales-frontend-bridge';
+ * window.addEventListener(OZViewerEvent.OZPageChangeCommand, (e) => { console.log(e.detail); });
+ * window.addEventListener(OZViewerEvent.OZViewerChangeCommand, (e) => { console.log(e.detail); });
+ * ```
+ */
+type OZViewerChangeEvent = {
+    /** 보고서 인덱스(zero-based index) */
+    docindex: number;
+};
+/**
+ * `OZViewerEvent.OZUserEvent` 이벤트의 `e.detail` 타입 정의
+ * ```tsx
+ * import { OZViewerEvent } from 'sales-frontend-bridge';
+ * window.addEventListener(OZViewerEvent.OZUserEvent, (e) => { console.log(e.detail); });
+ * ```
+ */
+type OZViewerUserEvent = {
+    /** _TriggerOCXUserEvent 함수에서 전달한 첫 번째 값 */
+    param1: string;
+    /** _TriggerOCXUserEvent 함수에서 전달한 두 번째 값 */
+    param2: string;
+    /** _TriggerOCXUserEvent 함수에서 전달한 세 번째 값 */
+    param3: string;
+    /** 보고서 인덱스(zero-based index) */
+    docindex: string;
+};
+/**
+ * `OZViewerEvent.OZPageBindCommand` 이벤트의 `e.detail` 타입 정의
+ * ```tsx
+ * import { OZViewerEvent } from 'sales-frontend-bridge';
+ * window.addEventListener(OZViewerEvent.OZPageBindCommand, (e) => { console.log(e.detail); });
+ * ```
+ */
+type OZViewerPageBindEvent = {
+    /** 보고서 인덱스(zero-based index) */
+    docindex: string;
+    /** 바인딩된 페이지 번호 */
+    pagecount: string;
+};
+type OZEFormInputEvent = {
+    /** 보고서 인덱스(zero-based index) */
+    docindex: string;
+    /** 이벤트가 발생한 컴포넌트의 FormID. FormID가 설정되지 않은 경우 컴포넌트의 이름이 리턴됨 */
+    formid: string;
+    eventname: string;
+    mainscreen: boolean;
+};
+type OZExportEvent = {
+    /**
+     * 저장 성공 여부
+     * - `0` 실패
+     * - `1` 성공
+     */
+    code: "0" | "1";
+    /** 파일 경로 */
+    path: string;
+    /** 파일 이름 */
+    filename: string;
+    /** 저장된 페이지 수. 여러 페이지의 보고서를 한 페이지로 저장한 경우에는 1이 리턴됨 */
+    pagecount: string;
+    /**
+     * 뷰어가 실제 저장한 모든 파일의 경로와 이름.
+     *
+     * 파일이 여러 개일 경우 `|`를 구분자로 하여 리턴됨
+     */
+    filepaths: string;
+};
+/**
+ * 상단 전체목록 보기 버튼 내 서식 클릭이벤트
+ * - 선택된 서식의 텍스트가 btnID로 넘어온다
+ */
+type CategoryEvent = {
+    type: "category";
+    /** 자유 입력 가능한 버튼 ID */
+    btnID: string;
+};
+/**
+ * 상단 버튼 클릭 이벤트(전체목록 버튼 제외)
+ * - 예: 나가기 버튼
+ */
+type TopEvent = {
+    type: "top";
+    btnID: "btnExit";
+};
+/**
+ * 성명,서명, 덧쓰기 관련 버튼 클릭 이벤트
+ * - `signatureInProgress` 서명 바로가기 버튼
+ * - `signatureInMissing` 미입력 항목 입력하기 버튼(느낌표 버튼)
+ * - `signatureComplete` 청약문서 최종 확인하기
+ */
+type SignatureEvent = {
+    type: "signature";
+    btnID: "signatureInProgress" | "signatureInMissing" | "signatureComplete";
+};
+/**
+ * pdf 뷰어 내 버튼 클릭 이벤트
+ * - `modify` 성명 서명 덧쓰기 수정하러 가기
+ * - `submit` 최종 제출하기
+ */
+type PdfEvent = {
+    type: "pdf";
+    btnID: "modify" | "submit";
+};
+/**
+ * comment(형광펜) 관련 버튼 클릭 이벤트
+ * - `yellow` 노랑색 형광펜 활성화
+ * - `pink` 분홍색 형광펜 활성화
+ * - `green` 초록색 형광펜 활성화
+ * - `eraser` 지우개 활성화
+ * - `disable` 형광펜 모드 종료
+ */
+type CommentEvent = {
+    type: "comment";
+    btnID: "yellow" | "pink" | "green" | "eraser" | "disable";
+};
+/**
+ * OZ 문서 시스템 내 버튼 클릭 이벤트 통합 타입
+ *
+ * type(카테고리)에 따라 btnID 값이 다르게 제한됩니다.
+ */
+type OZBtnTouchEvent = CategoryEvent | TopEvent | SignatureEvent | PdfEvent | CommentEvent;
+/**
+ * 문서코드별 입력 데이터 및 추가 파라미터 매핑 타입
+ *
+ * 각 문서코드에 대해 `inputJson` (임의의 key-value 쌍)과
+ *
+ * 선택적으로 `extraParam` (기타 추가 파라미터)을 포함하는 객체입니다.
+ *
+ * 예시:
+ * ```javascript
+ * {
+ *     A0010: {
+ *         inputJson: {
+ *             A0010_mynm_sg: 'data:image/png;base64,iVBORw0K...', // 예: 이미지 데이터
+ *             A0010_mysg_sign: 'data:image/png;base64,iVBORw0KG...', // 예: 이미지 데이터
+ *             custom_field: 'some value', // 임의의 데이터도 가능
+ *         },
+ *         args: [`roleCd=11,21`]
+ *         extraParam: [`viewer.zoom=137`]
+ *     },
+ *     C0401: {
+ *         inputJson: {
+ *             mynm_sg: 'data:image/png;base64,iVBORw0K...', // 예: 이미지 데이터
+ *             mysg_sign: 'data:image/png;base64,iVBORw0KG...', // 예: 이미지 데이터
+ *             another_field: 'another value', // 임의의 데이터
+ *         }
+ *     },
+ * }
+ * ```
+ */
+type ExtraDataType = Record<string, {
+    /** connection.inputJson으로 전달할 `{ "key1": "value1", "key2": "value2" }` 형식의 데이터 (예: 문자열, base64 이미지 등) */
+    inputJson?: Record<string, string>;
+    /** connection.arg로 전달할 `["key1=value1", "key2=value2"]` 형식의 데이터 */
+    args?: string[];
+    /** 추가 파라미터 목록 (선택 사항) */
+    extraParam?: string[];
+}>;
+
+declare const wrapperStyle: CSSProperties;
+declare const btnStyle: CSSProperties;
+/**
+ * 테스트용 하드코딩 문서목록
+ */
+declare const DownloadDocumentList: Array<FormInfo>;
+/**
+ * 테스트용 하드코딩 데이터
+ */
+declare const ExtraData: ExtraDataType;
+/** 증번 */
+declare const policyNumber = "300034894";
+/** FP 정보 */
+declare const fpInfo: {
+    uniqNo: string;
+};
+/** 청약작성자목록 - 계약 관계자 코드 */
+declare const roleCode: string[];
+/** native에 전달할  X-DUD-Authorization 토큰 */
+declare const xdudheaders = "Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJXNWRtc1g1MkVWZGV0YThJRy90YmlZY281bnVCdzRZOXhGZjlWakZzdWxnbU00YnkiLCJpYXQiOjE3NjEwNDMyNjgsImV4cCI6MTc2NjI5OTI2OH0.KDnF7ZhkmnEApGCvOcItwcHnLWe5iJu64g93GACT2yo";
+
+/**
+ * documentInfo를 여러가지 형태로 가공해주는 hook
+ */
+declare function useDocumentInfo(initialValue: FormInfo[]): {
+    documentList: sales_frontend_bridge.OzdFile[];
+    documentTemplateMap: Record<string, FormInfo>;
+    documentIndexMap: Record<string, number>;
+    nameTemplateMap: Record<string, FormInfo>;
+    groupIndexes: number[][];
+    isAllComplete: boolean;
+};
+
+type Props<T, R = void> = {
+    event: OZViewerEvent;
+    handler: (e: CustomEvent<T>) => Promise<R>;
+};
+/**
+ * OZ 뷰어 콜백 이벤트를 구독해주는 Hook
+ */
+declare function useOzEventListener<T, R = void>({ event, handler }: Props<T, R>): void;
+
+/**
+ * 전체 서식목록의 하위 버튼 클릭 이벤트 핸들러
+ * - 해당 서식을 누르면 시작 페이지로 이동한다
+ */
+declare function CategoryHandler(documentInfo: FormInfo[], { type, btnID }: CategoryEvent): Promise<void>;
+
+/**
+ * 상단 버튼 중 '전체 서식목록'을 제외한 다른 버튼 클릭 이벤트 핸들러
+ * - 현재는 나가기 버튼밖에 없음
+ */
+declare function TopHandler({ type, btnID }: TopEvent): Promise<void>;
+
+/**
+ * 주석 모드 (형광펜 버튼) 클릭 이벤트 핸들러
+ */
+declare function CommentHandler({ type, btnID }: CommentEvent): Promise<void>;
+/**
+ * 현재 모드가 코멘트(형광펜) 모드인지 확인
+ * - 코멘트 모드일 경우 true
+ * - 편집 모드 등 다른 모드일 경우 false
+ */
+declare function isCommentMode(): Promise<boolean>;
+type commentPenType = "yellow" | "pink" | "green" | "eraser";
+/**
+ * 코멘트 모드를 활성화하며 특정 펜 타입을 적용
+ *
+ * @param type 사용할 코멘트 펜 타입
+ *  - `yellow` (기본값)
+ *  - `pink`
+ *  - `green`
+ *  - `eraser` (지우개)
+ */
+declare function setEnableCommentMode(type?: commentPenType): Promise<sales_frontend_bridge.CommonOzBridgetResponseType<number | null>>;
+/**
+ * 코멘트 모드 비활성화 (편집 모드로 전환)
+ * - 현재 코멘트 모드 상태 여부와 관계없이 항상 편집 모드로 전환함
+ */
+declare function setDisableCommentMode(): Promise<sales_frontend_bridge.CommonOzBridgetResponseType<string>>;
+
+/**
+ * PDF 뷰어 내 버튼 클릭 이벤트 핸들러
+ * - 수정하기 버튼
+ *   - PDF 뷰어를 닫는다
+ * - 최종 제출하기 버튼
+ *   - PDF 뷰어를 닫는다
+ *   - OZ 뷰어를 닫는다
+ *   - 최종제출 화면으로 route
+ */
+declare function PdfHandler({ type, btnID }: PdfEvent): Promise<void>;
+
+/**
+ * 성명, 서명, 덧쓰기 바로가기, 미입력 서명 바로가기, 청약 문서 최종 확인 버튼 클릭 이벤트 핸들러
+ * - 서명 바로가기 버튼 이벤트 핸들러
+ *   - 미입력된 첫번째서명으로 이동 및 사인패드 오픈
+ * - 미입력 항목 입력하기 버튼 이벤트 핸들러
+ *   - 미입력된 첫번째서명으로 이동 및 사인패드 오픈
+ * - 청약문서 최종 확인하기 버튼 이벤트 핸들러
+ *   - 유효성 검사 후 PDF export 및 PDF 뷰어 오픈
+ */
+declare function SignatureHandler({ type, btnID }: SignatureEvent): Promise<void>;
+/**
+ * PDF 저장을 비동기적으로 처리하고, 저장된 파일 경로를 반환하는 함수
+ */
+declare function SaveTotalPdf(): Promise<string>;
+/**
+ * 개별 OZD를 PDF로 저장하는 함수
+ */
+declare function SaveSinglePdf({ startPage, endPage, imageDocumentTypeCode }: OzdFile): Promise<string>;
+
+/**
+ * ### 발생 상황 및 에러 메시지 정리
+ * 1. 비정형에서 OZD 다운로드 시 → 청약문서를 불러오지 못했습니다
+ * 2. 백엔드에서 중간저장 데이터 로딩 시 → 일시적인 오류가 발생했습니다
+ * 3. 오즈뷰어(솔루션) 초기화(OZD 파일 + 중간저장 데이터) 시 → 일시적인 오류가 발생했습니다
+ * 4. 성명/서명/덧쓰기 진행 시 → 일시적인 오류가 발생했습니다
+ * 5. 서식 완료 후 서명 중간저장(비정형 저장) 시 → 일시적인 오류가 발생했습니다
+ * 6. PDF Export(개별문서/통합문서) 시 → 청약문서를 불러오지 못했습니다
+ * 7. PDF 뷰어 초기화(Export된 PDF를 화면에 렌더링) 시 → 청약문서를 불러오지 못했습니다
+ *
+ * ### 에러 발생 시 처리 동작
+ *  - 에러 발생시 재시도 혹은 탈출을 위해 이전 화면으로 돌아간다
+ *  - 1~5단계 에서 에러 발생 시 → 확인버튼 클릭 → OZ 뷰어 종료 브릿지 호출
+ *  - 6~7단계 에서 에러 발생 시 → 확인버튼 클릭 → PDF 뷰어 종료 브릿지 호출
+ *
+ * ### 일반적인 상황에서는 아래 두 함수를 사용하고 커스텀한 상황애서는 showAlert을 직접 조합하여 사용한다
+ */
+/**
+ * OZ 뷰어 및 비정형 처리 과정에서 일시적인 오류가 발생했을 때 표시되는 경고창.
+ * #### 처리 동작
+ * - 확인 버튼 클릭 시 OZ 뷰어 종료 브릿지 호출
+ */
+declare function AlertTemporaryError(): Promise<sales_frontend_bridge.CommonOzBridgetResponseType<"close" | "main" | "sub">>;
+/**
+ * 청약문서를 불러오지 못했을 때 표시되는 경고창.
+ * #### 처리 동작
+ * - 확인 버튼 클릭 시 PDF 뷰어 종료 브릿지 호출
+ */
+declare function AlertDocumentLoadError(): Promise<sales_frontend_bridge.CommonOzBridgetResponseType<"close" | "main" | "sub">>;
+
+/**
+ * OZ 리포트 생성 및 초기화에 필요한 브릿지 유틸
+ */
+type CreateOzParamProps = {
+    documentList: OzdFile[];
+    extraData?: ExtraDataType;
+    /**
+     * 청약을 작성하는 사람들의 roleCode 목록
+     *
+     * ex)`홍길동|11,홍길순|22`
+     */
+    roleCd: string;
+    /**
+     * 지정대리인 정보
+     * - 지정대리인이 없을때 ''
+     * - 지정대리인이 1명일때 ex) `성명|주민등록번호|관계명|관계코드`
+     * - 지정대리인이 2명일때 ex) `성명|주민등록번호|관계명|관계코드`,`성명|주민등록번호|관계명|관계코드`
+     */
+    jijungInfo?: string;
+};
+/**
+ * OZ 리포트 최초 생성시 OZ에 넘길 파라미터를 생성하는 함수
+ */
+declare function CreateOzParam({ documentList, extraData, roleCd, jijungInfo }: CreateOzParamProps): Promise<string[]>;
+/**
+ * 모든 문서에 대해 checkeForm을 Y로 설정하는 명령을 순차적으로 한 번씩 호출합니다.
+ *
+ * 각 호출 사이에 기본 지연(sleep)을 넣어 처리 속도를 조절합니다.
+ * @param reportCount - 리포트 개수 (생략 시 내부에서 자동 계산)
+ */
+declare function setCheckEform(reportCount?: number): Promise<void>;
+/**
+ * 모든 문서에 대해 INPUT_TRIGGER_CLICK 명령을 순차적으로 한 번씩 호출합니다.
+ *
+ * 각 호출 사이에 기본 지연(sleep)을 넣어 처리 속도를 조절합니다.
+ * @param reportCount - 리포트 개수 (생략 시 내부에서 자동 계산)
+ */
+declare function triggerClickOnAllDocuments(reportCount?: number): Promise<void>;
+/**
+ * 모든 문서에 대해 서명 부분 이미지 컷팅 명령을 순차적으로 한 번씩 호출합니다.
+ *
+ * 각 호출 사이에 기본 지연(sleep)을 넣어 처리 속도를 조절합니다.
+ * @param reportCount - 리포트 개수 (생략 시 내부에서 자동 계산)
+ */
+declare function triggerCropImageOnAllDocuments(reportCount?: number): Promise<void>;
+/**
+ * 모든 문서에 대해 전체 페이지 수를 계산하는 명령을 순차적으로 한 번씩 호출합니다.
+ *
+ * 각 호출 사이에 기본 지연(sleep)을 넣어 처리 속도를 조절합니다.
+ * @param reportCount - 리포트 개수 (생략 시 내부에서 자동 계산)
+ */
+declare function getTotalPageOnAllDocuments(reportCount?: number): Promise<number[]>;
+
+/**
+ * ozd, 폰트 등 App 내 리소스를 fetch하는 브릿지 유틸
+ */
+/**
+ * OZD 목록을 다운받는 브릿지
+ */
+declare function fetchDocument(args: DownloadOzdOptions): Promise<{
+    startPage: number;
+    endPage: number;
+    name: string;
+    doc: Array<sales_frontend_bridge.OzdFile>;
+    complete: boolean;
+    focus: boolean;
+}[]>;
+/**
+ * App에 설치된 폰트를 Oz Param 형식으로 불러오는 브릿지
+ */
+declare function fetchFont(): Promise<string[]>;
+/**
+ * 비정형 서버에 성명,서명, 덧쓰기 이미지를 업로드한다
+ * @deprecated 테스트페이지에서만 사용하는 API
+ */
+declare function postFiletoDud(imageStr: string): Promise<any>;
+/**
+ * 비정형에서 중간저장해놓은 서명이미지를 다운받는다
+ * @deprecated 테스트페이지에서만 사용하는 API
+ */
+declare function getFileFromDud(fileMgmtId: string): Promise<string>;
+
+/**
+ * OZ에서 getDraftData 요청 시 반환할 데이터를 생성하는 함수
+ *
+ * - OZ로부터 전달받은 JSON 문자열(`arg`)을 파싱하여 문서 코드(docCd)를 추출하고,
+ *   해당 문서의 JSON 정보를 가져와 필요한 사인 정보만 key-value 형태로 반환한다.
+ * - 사인FormId 값이 null일 경우, getInformation 결과로 채워진다.
+ */
+declare function getDraftDataHandler(rawOzRequest: string, documentIndexMap: Record<string, number>): Promise<Record<string, string>>;
+/**
+ * 주어진 문서 인덱스 목록(`indexList`)에 대해
+ * 각 문서의 중간저장 데이터를 순차적으로 요청합니다.
+ *
+ * 각 페이지 검사 사이에 기본 지연(sleep)을 추가하여 처리 속도를 제어합니다.
+ *
+ * @param indexList - 중간저장 데이터를 요청할 문서의 인덱스 배열
+ */
+declare function triggerDraftDataByIndexList(indexList: number[]): Promise<void>;
+
+/**
+ * 유효성 검사 시 미입력된 컴포넌트에 자동으로 포커스를 맞추도록 설정
+ *
+ * @param reportCount - 리포트 개수 (생략 시 내부에서 자동 계산)
+ */
+declare function enableFocusOnValidation(reportCount?: number): Promise<void>;
+/**
+ * 유효성 검사 시 미입력된 컴포넌트에 포커스가 가지 않도록 설정
+ *
+ * @param reportCount - 리포트 개수 (생략 시 내부에서 자동 계산)
+ */
+declare function disableFocusOnValidation(reportCount?: number): Promise<void>;
+
+/**
+ * OZ 뷰어 함수를 단순 래핑한 브릿지 유틸
+ */
+/**
+ * OZ Viewer 생성 함수
+ * 1. `CreateReport` 함수 호출하여 OZ 리포트 생성
+ * 2. `OZProgressCommand` 이벤트가 `ozd` 개수만큼 발생
+ * 3. `OZProgressCommand` 이벤트 내부에서 `OZReportCreated` 이벤트 발행
+ * 4. `CreateOzViewer` 이벤트가 종료
+ */
+declare function CreateOzViewer(ozParam: string[]): Promise<unknown>;
+/**
+ * 특정 페이지로 스크롤 이동
+ */
+declare function MovePage(page: number): Promise<sales_frontend_bridge.CommonOzBridgetResponseType<string>>;
+/**
+ * 현재 페이지 번호를 구한다(one base index)
+ */
+declare function getCurrentPage(): Promise<number>;
+/**
+ * 랜딩되어있는 보고서들의 전체 페이지 수
+ */
+declare const getTotalPageMemo: {
+    (): Promise<number>;
+    clearCache(): void;
+};
+/**
+ * 랜딩되어있는 보고서의 총 갯수(ozd 파일의 갯수)
+ */
+declare const getReportCountMemo: {
+    (): Promise<number>;
+    clearCache(): void;
+};
+
+/**
+ * OZ 서식 검증용 브릿지 유틸
+ */
+/**
+ * 유효성을 체크할 doc들의 index를 배열로 입력받는다
+ *
+ * 모두 유효하면 true를 리턴한다
+ *
+ * documentInfo의 complete를 계산할때 사용한다
+ *
+ * 서명패드가 열려있는 상태에서 INPUT_CHECK_VALIDITY로 검사하면 서명패드가 꺼져서 onValueChange에서는 INVALID_INFO_JSON을 사용한다
+ */
+declare function checkDocumentsValidityByIndex(indexList: number[]): Promise<boolean>;
+/**
+ * 지정된 페이지 범위에 대해 유효성 검사를 수행합니다.
+ *
+ * 유효성 검사는 1페이지부터 지정된 마지막 페이지까지 진행되며,
+ * 각 페이지 검사 사이에 기본 지연(sleep)을 추가하여 처리 속도를 제어합니다.
+ * - pageChange 이벤트 내부에서는 현재 페이지 이전까지만 검사
+ * - 서명바로가기, 미입력 서명 바로가기, 청약문서 최종 확인하기 버튼을 눌렀을때는 전체 페이지 검사
+ *
+ * @param pageCount - 유효성 검사를 수행할 페이지의 총 개수. (생략하면 자동으로 전체 페이지 수를 계산하여 사용)
+ * @returns 모든 페이지가 유효한 경우 true, 하나라도 유효하지 않으면 false를 반환합니다.
+ */
+declare function validateAllPages(pageCount?: number): Promise<boolean>;
+/**
+ * 페이지 유효성 검사 결과를 캐싱하는 유틸리티
+ *
+ * - 동일 페이지에 대한 중복 호출을 방지
+ * - validation 결과가 false인 경우에는 캐시에 저장하지 않음
+ */
+declare const checkValidPageMemo: {
+    (page: number): Promise<boolean>;
+    clearCache(): void;
+    clearCacheByPage(page: number): void;
+};
+
+/**
+ * 문서 데이터에 페이지 범위를 채워주는 함수
+ * @param {Array} data - 문서 그룹 데이터
+ * @param {Array<number>} pages - 각 문서의 페이지 수
+ * @returns {Array} - startPage, endPage가 채워진 새 데이터
+ */
+declare function categorizeByPageRange(data: FormInfo[], pageCounts: number[]): FormInfo[];
+/**
+ * 주어진 파일 경로에서 파일 이름만 추출합니다.
+ * @param filePath 파일 경로 (예: `/a/b/c/file.ext`)
+ * @returns 파일 경로에서 추출한 파일 이름 (확장자 제외, 예: `file`)
+ * @throws {Error} 유효하지 않은 파일 경로일 경우 예외 처리
+ */
+declare function extractFileName(filePath: string): string;
+declare function getFileListByGlobalIndex(index: number, data: FormInfo[]): FormInfo | null;
+/**
+ * 비동기 처리를 일정 시간 지연시키는 함수
+ * @param ms - 지연 시간 (밀리초). 기본값은 10ms
+ */
+declare function sleep(ms?: number): Promise<void>;
+declare function PromiseWithResolvers<T>(): {
+    promise: Promise<T>;
+    resolve: (value: T | PromiseLike<T>) => void;
+    reject: (reason?: unknown) => void;
+};
+/**
+ * 주어진 입력값이 배열이 아니면 빈 배열을 반환하고, 배열이면 깊은 복사하여 반환합니다.
+ *
+ * @param arg - 입력값으로, 배열일 수도 있고 아닐 수도 있습니다.
+ * @returns 주어진 입력값이 배열이면 깊은 복사본을 반환하고, 배열이 아니면 빈 배열을 반환합니다.
+ */
+declare function ensureArray<T>(arg?: T[]): T[];
+
+/**
+ * 특정 문서 인덱스의 OnValueChanged 핸들러를 debounce 처리하여 반환
+ *
+ * @param docIndex - 문서 인덱스 (string)
+ * @param onValueChanged - debounce 후 실행할 콜백
+ * @returns debounce된 핸들러 함수
+ */
+declare function getDebouncedValueChangeHandler(docIndex: string, onValueChanged: (docIndex: string) => void): ((...args: any[]) => void) | ((idx: string) => void);
+/**
+ * 모든 문서 인덱스의 debounce 핸들러 초기화
+ */
+declare function clearValueChangeDebounceHandlers(): void;
+
+export { AlertDocumentLoadError, AlertTemporaryError, type CategoryEvent, CategoryHandler, type CommentEvent, CommentHandler, CreateOzParam, CreateOzViewer, DownloadDocumentList, ExtraData, type ExtraDataType, MovePage, type OZBtnTouchEvent, type OZEFormInputEvent, type OZExportEvent, OZTriggerExternalEvent, type OZViewerChangeEvent, type OZViewerErrorEvent, OZViewerEvent, type OZViewerPageBindEvent, type OZViewerProgressEvent, type OZViewerUserEvent, type PdfEvent, PdfHandler, PromiseWithResolvers, SaveSinglePdf, SaveTotalPdf, type SignatureEvent, SignatureHandler, type TopEvent, TopHandler, btnStyle, categorizeByPageRange, checkDocumentsValidityByIndex, checkValidPageMemo, clearValueChangeDebounceHandlers, commentPenEraser, commentPenGreen, commentPenPink, commentPenYellow, commonOzParam, commonPdfExportParam, disableFocusOnValidation, enableFocusOnValidation, ensureArray, extractFileName, fetchDocument, fetchFont, fpInfo, getCurrentPage, getDebouncedValueChangeHandler, getDraftDataHandler, getFileFromDud, getFileListByGlobalIndex, getReportCountMemo, getTotalPageMemo, getTotalPageOnAllDocuments, isCommentMode, policyNumber, postFiletoDud, roleCode, setCheckEform, setDisableCommentMode, setEnableCommentMode, sleep, triggerClickOnAllDocuments, triggerCropImageOnAllDocuments, triggerDraftDataByIndexList, useDocumentInfo, useOzEventListener, validateAllPages, wrapperStyle, xdudheaders };