@bimatrix-aud-platform/aud_mcp_server 1.1.14 → 1.1.16

package/schemas/json2.interface.ts

@@ -0,0 +1,503 @@
+/**
+ * MX-GRID WorkBook (.json2) 파일 구조 인터페이스
+ * .json2 파일은 MX-GRID 엑셀 기반 스프레드시트 워크북을 정의합니다.
+ *
+ * 참조: WorkBook.java - CreateWorkBookByJson()
+ */
+
+// ============================================
+// 루트 인터페이스
+// ============================================
+
+/**
+ * .json2 파일 최상위 구조
+ */
+export interface IJson2Document {
+  /** 기본 폰트명 (예: '맑은 고딕') */
+  FontName?: string;
+  /** 기본 폰트 크기 (기본값: 11) */
+  FontSize?: number;
+  /** 워크북 버전 */
+  Version?: number;
+  /** 열 너비 픽셀 비율 */
+  ColumnWidthPixelRate?: number;
+  /** 스타일 정의 배열 */
+  Styles?: IStyle[];
+  /** 워크시트 배열 (필수, 최소 1개) */
+  WorkSheets: IWorkSheet[];
+  /** 시트 이름 목록 (시트 순서 재배치용) */
+  SheetNames?: string[];
+  /** 이름 정의(Named Range) 배열 */
+  Names?: INameDef[];
+  /** 데이터 바인딩 정의 배열 */
+  DataBinding?: IDataBinding[];
+}
+
+// ============================================
+// 스타일
+// ============================================
+
+/**
+ * 셀 스타일 정의
+ */
+export interface IStyle {
+  /** 스타일 식별자 (예: 'S0', 'S1') */
+  Name: string;
+  /** CSS-like 폰트 문자열 (예: 'font-family:맑은 고딕;font-size:10;font-weight:bold;font-color:#000000;') */
+  Font?: string;
+  /** CSS-like 테두리 문자열 (예: 'border-left:Thin,#000000;border-top:Thin,#000000;') */
+  Border?: string;
+  /** 배경색 (예: '#dce6f2' 또는 'solid,#FFEBF1DE') */
+  Fill?: string;
+  /** 숫자/날짜 포맷 (예: '#,##0.00', 'yyyy-MM-dd') */
+  Format?: string;
+  /** 가로 정렬 */
+  Horizontal?: "center" | "left" | "right" | "general" | "fill" | "justify" | "distributed";
+  /** 세로 정렬 */
+  Vertical?: "center" | "top" | "bottom" | "justify" | "distributed";
+  /** 텍스트 줄바꿈 */
+  WrapText?: boolean;
+  /** 들여쓰기 수준 */
+  IndentLevel?: number;
+  /** 셀에 맞추기 */
+  ShrinkToFit?: boolean;
+  /** 텍스트 회전 각도 */
+  RotationAngle?: number;
+  /** 셀 잠금 여부 */
+  IsLocked?: boolean;
+}
+
+// ============================================
+// 워크시트
+// ============================================
+
+/**
+ * 워크시트 정의
+ */
+export interface IWorkSheet {
+  /** 시트 이름 */
+  Name: string;
+  /** 기본 행 높이 */
+  DefaultRowHeight?: number;
+  /** 기본 행 높이 (픽셀) */
+  DefaultRowHeightPixel?: number;
+  /** 기본 열 너비 (픽셀) */
+  DefaultColumnWidthPixel?: number;
+  /** CRUD 활성화 여부 */
+  CRUD?: boolean;
+  /** 뷰 타입 */
+  ViewType?: string;
+  /** 확대/축소 비율 (기본값: 100) */
+  Zoom?: number;
+  /** 활성 시트 여부 */
+  Active?: boolean;
+  /** 시트 표시 여부 (기본값: true) */
+  Visible?: boolean;
+  /** 눈금선 표시 여부 */
+  DisplayGridlines?: boolean;
+  /** 시트 보호 설정 */
+  Protection?: IProtection;
+  /** 수평 페이지 나누기 위치 */
+  HPageBreaks?: number[];
+  /** 수직 페이지 나누기 위치 */
+  VPageBreaks?: number[];
+  /** 틀 고정 설정 */
+  FreezePanes?: IFreezePanes;
+  /** 페이지 설정 */
+  PageSetup?: IPageSetup;
+  /** 열 정의 배열 */
+  Columns?: IColumn[];
+  /** 행 정의 배열 */
+  Rows?: IRow[];
+  /** 셀 데이터 배열 */
+  Ranges?: ICellRange[];
+  /** 내장 컨트롤 배열 (차트, 이미지, 데이터그리드 등) */
+  Controls?: IControl[];
+  /** 도형/이미지 배열 */
+  Shapes?: IShape[];
+  /** 조건부 서식 배열 */
+  FormatConditions?: IFormatCondition[];
+  /** 데이터 유효성 검사 배열 */
+  Validators?: IValidator[];
+  /** 스파크라인 그룹 배열 */
+  SparkLineGroups?: object[];
+  /** 내장 차트 배열 */
+  xlCharts?: IXlChart[];
+}
+
+// ============================================
+// 열/행 정의
+// ============================================
+
+/**
+ * 열 정의
+ */
+export interface IColumn {
+  /** 열 인덱스 (1부터 시작) */
+  Index: number;
+  /** 열 너비 (Excel 단위) */
+  Width?: number;
+  /** 열 너비 (픽셀) */
+  PixelWidth?: number;
+}
+
+/**
+ * 행 정의
+ */
+export interface IRow {
+  /** 행 인덱스 (1부터 시작) */
+  Index: number;
+  /** 행 높이 (Excel 단위) */
+  Height?: number;
+  /** 행 높이 (픽셀) */
+  PixelHeight?: number;
+}
+
+// ============================================
+// 셀 데이터
+// ============================================
+
+/**
+ * 셀 타입 코드
+ */
+export type TCellType = 0 | 1 | 2 | 3 | 4 | 5 | -1;
+// 0=String, 1=Number, 2=Date, 3=Boolean, 4=Empty, 5=Error, -1=Null
+
+/**
+ * 셀 데이터 정의
+ */
+export interface ICellRange {
+  /** 셀 주소 (예: 'A1' 또는 'B2:C3') */
+  Range: string;
+  /** 셀 값 (문자열, 숫자, 불리언, null 등) */
+  Value?: any;
+  /** 표시 텍스트 */
+  Text?: string;
+  /** 셀 수식 (예: '=SUM(A1:A10)') */
+  Formula?: string;
+  /** 셀 타입 */
+  Type?: TCellType;
+  /** 열 병합 수 */
+  ColSpan?: number;
+  /** 행 병합 수 */
+  RowSpan?: number;
+  /** 스타일 이름(문자열) 또는 인라인 스타일 객체 */
+  Style?: string | object;
+  /** 셀 포맷 (예: '#,##0') */
+  Format?: string;
+  /** 배열 수식 인덱스 */
+  ArrayIndex?: number;
+  /** 배열 수식 범위 */
+  ArrayRange?: object;
+  /** 리치 텍스트 폰트 설정 */
+  FontSettings?: IFontSetting[];
+  /** 사용자 정의 속성 */
+  Properties?: object;
+  /** 편집 가능 여부 */
+  Editable?: boolean;
+  /** 수정 여부 */
+  IsModified?: boolean;
+  /** 유효성 검사 인덱스 */
+  Validator?: number;
+  /** 마스크 포맷 */
+  MaskFormat?: string;
+}
+
+/**
+ * 리치 텍스트 폰트 설정
+ */
+export interface IFontSetting {
+  /** 텍스트 내용 */
+  Text?: string;
+  /** 수식 */
+  Formula?: string;
+  /** 폰트 색상 (hex) */
+  FontColor?: string;
+  /** 폰트명 */
+  FontName?: string;
+  /** 폰트 크기 */
+  FontSize?: number;
+  /** 폰트 포인트 크기 */
+  FontPoint?: number;
+  /** 굵게 */
+  Bold?: boolean;
+  /** 기울임 */
+  Italic?: boolean;
+  /** 밑줄 (UnderLine) */
+  UnderLine?: boolean;
+  /** 밑줄 (Underline) */
+  Underline?: boolean;
+}
+
+// ============================================
+// 컨트롤/도형/차트
+// ============================================
+
+/**
+ * 내장 컨트롤 (차트, 이미지, 데이터그리드 등)
+ * Type: 15=Image, 16=TableLayout, 18=PivotGrid, 19=DataGrid,
+ *       20=TreeGrid, 21=Chart, 22=Pie, 25=Scatter, 26=Polygon,
+ *       27=iGrid, 28=GroupGrid
+ */
+export interface IControl {
+  /** 컨트롤 이름 */
+  Name: string;
+  /** 컨트롤 타입 코드 */
+  Type: number;
+  /** 표시 영역 */
+  Range: string;
+  /** 이미지 파일명 */
+  FileName?: string;
+  /** Base64 인코딩 데이터 */
+  Value?: string;
+  /** 너비 (픽셀) */
+  Width?: number;
+  /** 높이 (픽셀) */
+  Height?: number;
+  [key: string]: any;
+}
+
+/**
+ * 도형/이미지 객체
+ */
+export interface IShape {
+  /** 도형 이름 */
+  Name: string;
+  /** Z 순서 */
+  ZIndex?: number;
+  /** 왼쪽 위치 */
+  Left?: number;
+  /** 위쪽 위치 */
+  Top?: number;
+  /** 너비 */
+  Width?: number;
+  /** 높이 */
+  Height?: number;
+  /** 위치 고정 여부 */
+  FixPos?: boolean;
+  /** 아래쪽 여백 */
+  MarginBottom?: number;
+  /** 위쪽 여백 */
+  MarginTop?: number;
+  /** 왼쪽 여백 */
+  MarginLeft?: number;
+  /** 오른쪽 여백 */
+  MarginRight?: number;
+  /** 왼쪽 상단 셀 주소 */
+  TopLeftCell?: string;
+  /** 오른쪽 하단 셀 주소 */
+  BottomRightCell?: string;
+  /** Base64 인코딩 이미지 */
+  BASE64?: string;
+  /** 텍스트 내용 */
+  Text?: string;
+  /** 수식 */
+  Formula?: string;
+  /** 스타일 참조 */
+  Style?: string;
+  /** 도형 타입 */
+  Type?: number;
+  [key: string]: any;
+}
+
+/**
+ * 내장 차트 객체
+ */
+export interface IXlChart {
+  /** 차트 이름 */
+  Name?: string;
+  /** 차트 유형 코드 */
+  ChartType?: number;
+  /** 카테고리 역순 */
+  CategoryReverse?: boolean;
+  /** 역순 조건 */
+  Reverse?: string;
+  /** 차트 위치 */
+  Range?: string;
+  /** 데이터 시리즈 배열 */
+  DataRange?: IDataRangeSeries[];
+  /** 차트 설정 JSON 문자열 */
+  Json?: string;
+  [key: string]: any;
+}
+
+/**
+ * 차트 데이터 시리즈
+ */
+export interface IDataRangeSeries {
+  /** 시리즈 이름 */
+  Name?: string;
+  /** 라벨 */
+  Label?: string;
+  /** 데이터 범위 참조 */
+  Data?: string;
+  /** 값 배열 */
+  Values?: any[];
+  [key: string]: any;
+}
+
+// ============================================
+// 조건부 서식 / 유효성 검사
+// ============================================
+
+/**
+ * 조건부 서식 규칙
+ */
+export interface IFormatCondition {
+  /** 조건 유형 */
+  Type?: number;
+  /** 우선순위 */
+  Priority?: number;
+  /** 적용 범위 */
+  Ranges?: string;
+  /** 스타일 */
+  Style?: string;
+  /** 조건 수식 1 */
+  Formula1?: string;
+  /** 조건 수식 2 */
+  Formula2?: string;
+  /** 연산자 */
+  Operator?: number;
+  /** 조건 충족 시 중지 */
+  StopIfTrue?: boolean;
+  /** 값 표시 여부 */
+  ShowValue?: boolean;
+  /** 테두리 */
+  Border?: string;
+  /** 색상 */
+  Color?: string;
+  /** 방향 */
+  Direction?: number;
+  [key: string]: any;
+}
+
+/**
+ * 데이터 유효성 검사 규칙
+ */
+export interface IValidator {
+  /** 유효성 검사 유형 */
+  Type?: number;
+  /** 검증 수식 1 */
+  Formula1?: string;
+  /** 연산자 */
+  Operator?: number;
+  /** 빈 값 무시 */
+  IgnoreBlank?: boolean;
+  /** 셀 내 드롭다운 표시 */
+  InCellDropDown?: boolean;
+  /** 입력 메시지 표시 */
+  ShowInput?: boolean;
+  /** 오류 메시지 표시 */
+  ShowError?: boolean;
+  /** 입력 메시지 제목 */
+  InputTitle?: string;
+  /** 입력 메시지 */
+  InputMessage?: string;
+  /** 오류 메시지 제목 */
+  ErrorTitle?: string;
+  /** 오류 메시지 */
+  ErrorMessage?: string;
+  /** 적용 범위 */
+  Ranges?: string;
+  [key: string]: any;
+}
+
+// ============================================
+// 페이지/보호 설정
+// ============================================
+
+/**
+ * 틀 고정 설정
+ */
+export interface IFreezePanes {
+  /** 고정 행 (0부터) */
+  Row?: number;
+  /** 고정 열 (0부터) */
+  Column?: number;
+}
+
+/**
+ * 페이지 설정
+ */
+export interface IPageSetup {
+  LeftMargin?: number;
+  RightMargin?: number;
+  TopMargin?: number;
+  BottomMargin?: number;
+  HeaderMargin?: number;
+  FooterMargin?: number;
+  Orientation?: "portrait" | "landscape";
+  PaperSize?: number;
+  Zoom?: number;
+  FitToWidth?: number;
+  FitToHeight?: number;
+  IsPercentScale?: boolean;
+  CenterHorizontally?: boolean;
+  CenterVertically?: boolean;
+  PrintArea?: string;
+  LeftHeader?: string;
+  CenterHeader?: string;
+  RightHeader?: string;
+  LeftFooter?: string;
+  CenterFooter?: string;
+  RightFooter?: string;
+}
+
+/**
+ * 시트 보호 설정
+ */
+export interface IProtection {
+  /** 잠긴 셀 선택 허용 */
+  AllowSelectingLockedCell?: boolean;
+  /** 잠기지 않은 셀 선택 허용 */
+  AllowSelectingUnlockedCell?: boolean;
+  /** 보호 활성화 */
+  IsProtected?: boolean;
+  /** 보호 비밀번호 */
+  Password?: string;
+  [key: string]: any;
+}
+
+// ============================================
+// 이름 정의 / 데이터 바인딩
+// ============================================
+
+/**
+ * 이름 정의 (Named Range)
+ */
+export interface INameDef {
+  /** 이름 (예: '_VIEW_AREA_', '_D_DATA', 'CRUD_TABLE1') */
+  Name: string;
+  /** 참조 수식 (예: "='V1'!$A$1:$B$3") */
+  RefersTo: string;
+  /** 수식 여부 */
+  IsFormula?: boolean;
+  /** 숨김 여부 */
+  Hidden?: boolean;
+  /** 대상 시트명 */
+  SheetName?: string;
+  /** 참조 범위 배열 */
+  Ranges?: { SheetName?: string; Range?: string }[];
+}
+
+/**
+ * 데이터 바인딩 정의
+ */
+export interface IDataBinding {
+  /** 바인딩 코드 */
+  Code: string;
+  /** 바인딩 이름 */
+  Name: string;
+  /** 대상 시트명 */
+  Sheet: string;
+  /** 컬럼 헤더 출력 여부 */
+  WriteColumns?: boolean;
+  /** 상단 행 인덱스 */
+  Top?: number;
+  /** 좌측 열 인덱스 */
+  Left?: number;
+  /** 하단 행 인덱스 */
+  Bottom?: number;
+  /** 우측 열 인덱스 */
+  Right?: number;
+}