@bimatrix-aud-platform/aud_mcp_server 1.1.57 → 1.1.63

package/dist/generators/compact.d.ts

@@ -0,0 +1,16 @@
+/**
+ * compact 모드 유틸리티
+ *
+ * 생성된 MTSD JSON에서 기본값과 동일한 속성을 제거하여
+ * 간소화된 .design.json 형태로 변환합니다.
+ */
+/** Element JSON에서 기본값 속성을 제거 */
+export declare function compactElement(element: Record<string, any>): Record<string, any>;
+/** GridColumn JSON에서 기본값 속성을 제거 */
+export declare function compactGridColumn(column: Record<string, any>): Record<string, any>;
+/** DataSource JSON에서 기본값 속성을 제거 */
+export declare function compactDataSource(ds: Record<string, any>): Record<string, any>;
+/** OlapField JSON에서 기본값 속성을 제거 */
+export declare function compactOlapField(field: Record<string, any>): Record<string, any>;
+/** OlapField 배열 전체를 compact 처리 */
+export declare function compactOlapFields(fields: Record<string, any>[]): Record<string, any>[];

package/dist/generators/compact.js

@@ -0,0 +1,299 @@
+/**
+ * compact 모드 유틸리티
+ *
+ * 생성된 MTSD JSON에서 기본값과 동일한 속성을 제거하여
+ * 간소화된 .design.json 형태로 변환합니다.
+ */
+import { defaultStyle, defaultDocking, defaultValidator, ELEMENT_DEFAULTS_MAP, } from "./defaults.js";
+// ============================================
+// 공통 유틸
+// ============================================
+/** 깊은 비교 (키 순서 무관) */
+function deepEqual(a, b) {
+    if (a === b)
+        return true;
+    if (a == null || b == null)
+        return false;
+    if (typeof a !== typeof b)
+        return false;
+    if (typeof a !== "object")
+        return a === b;
+    if (Array.isArray(a) !== Array.isArray(b))
+        return false;
+    if (Array.isArray(a)) {
+        if (a.length !== b.length)
+            return false;
+        for (let i = 0; i < a.length; i++) {
+            if (!deepEqual(a[i], b[i]))
+                return false;
+        }
+        return true;
+    }
+    const keysA = Object.keys(a);
+    const keysB = Object.keys(b);
+    if (keysA.length !== keysB.length)
+        return false;
+    for (const key of keysA) {
+        if (!b.hasOwnProperty(key))
+            return false;
+        if (!deepEqual(a[key], b[key]))
+            return false;
+    }
+    return true;
+}
+/** 객체에서 기본값과 동일한 속성을 제거. 빈 객체가 되면 undefined 반환 */
+function stripMatchingDefaults(obj, defaults, keepKeys) {
+    const result = {};
+    let hasValue = false;
+    for (const [key, value] of Object.entries(obj)) {
+        if (keepKeys && keepKeys.has(key)) {
+            result[key] = value;
+            hasValue = true;
+            continue;
+        }
+        if (key in defaults && deepEqual(value, defaults[key])) {
+            continue; // 기본값과 동일하면 제거
+        }
+        result[key] = value;
+        hasValue = true;
+    }
+    return hasValue ? result : undefined;
+}
+// ============================================
+// Element compact
+// ============================================
+/** Element JSON에서 기본값 속성을 제거 */
+export function compactElement(element) {
+    const result = {};
+    const type = element.Type;
+    // 필수 속성 유지
+    result.Type = type;
+    result.Id = element.Id;
+    result.Name = element.Name;
+    // Position: Left/Top/Width/Height만 유지, 기본 Docking/ZIndex/TabIndex 제거
+    if (element.Position) {
+        const pos = element.Position;
+        const compactPos = {
+            Left: pos.Left,
+            Top: pos.Top,
+            Width: pos.Width,
+            Height: pos.Height,
+        };
+        // ZIndex: 기본값(0 또는 1)이 아닌 경우만 유지
+        if (pos.ZIndex !== undefined && pos.ZIndex !== 0 && pos.ZIndex !== 1) {
+            compactPos.ZIndex = pos.ZIndex;
+        }
+        // TabIndex: 0이 아닌 경우만 유지
+        if (pos.TabIndex !== undefined && pos.TabIndex !== 0) {
+            compactPos.TabIndex = pos.TabIndex;
+        }
+        // Docking: 기본값이 아닌 경우만 유지
+        if (pos.Docking && !deepEqual(pos.Docking, defaultDocking())) {
+            compactPos.Docking = pos.Docking;
+        }
+        result.Position = compactPos;
+    }
+    // Style: Type=0(Skin)이면 Style 전체 제거, Type!=0이면 기본값 비교
+    if (element.Style) {
+        const style = element.Style;
+        const styleType = style.Type;
+        if (styleType === undefined || styleType === 0) {
+            // Skin 모드: BoxStyle이 있으면 BoxStyle만 유지
+            if (style.BoxStyle && style.BoxStyle !== "") {
+                result.Style = { Type: 0, BoxStyle: style.BoxStyle };
+            }
+            // BoxStyle도 없으면 Style 전체 생략
+        }
+        else {
+            // Type!=0 (커스텀 스타일): 기본값과 비교하여 제거
+            const defStyle = defaultStyle();
+            const compactStyle = { Type: styleType };
+            if (style.BoxStyle !== undefined && style.BoxStyle !== "") {
+                compactStyle.BoxStyle = style.BoxStyle;
+            }
+            if (style.Background && !deepEqual(style.Background, defStyle.Background)) {
+                compactStyle.Background = style.Background;
+            }
+            if (style.Border && !deepEqual(style.Border, defStyle.Border)) {
+                compactStyle.Border = style.Border;
+            }
+            if (style.Font && !deepEqual(style.Font, defStyle.Font)) {
+                compactStyle.Font = style.Font;
+            }
+            result.Style = compactStyle;
+        }
+    }
+    // Visible: true(기본값)이면 제거
+    if (element.Visible === false) {
+        result.Visible = false;
+    }
+    // Enabled: true(기본값)이면 제거
+    if (element.Enabled === false) {
+        result.Enabled = false;
+    }
+    // TabStop: true(기본값)이면 제거
+    if (element.TabStop === false) {
+        result.TabStop = false;
+    }
+    // DataSource: 빈 문자열이면 제거
+    if (element.DataSource && element.DataSource !== "") {
+        result.DataSource = element.DataSource;
+    }
+    // 타입별 기본값 제거
+    const defaultsFactory = ELEMENT_DEFAULTS_MAP[type];
+    const typeDefaults = defaultsFactory ? defaultsFactory() : {};
+    // 처리 완료 키
+    const processedKeys = new Set([
+        "Type", "Id", "Name", "Position", "Style",
+        "Visible", "Enabled", "TabStop", "DataSource",
+    ]);
+    // 나머지 속성: 타입 기본값과 다른 것만 유지
+    for (const [key, value] of Object.entries(element)) {
+        if (processedKeys.has(key))
+            continue;
+        if (key in typeDefaults && deepEqual(value, typeDefaults[key]))
+            continue;
+        result[key] = value;
+    }
+    return result;
+}
+// ============================================
+// GridColumn compact
+// ============================================
+/** GridColumn JSON에서 기본값 속성을 제거 */
+export function compactGridColumn(column) {
+    const result = {};
+    // Name 필수
+    result.Name = column.Name;
+    // Caption: Name과 같으면 제거
+    if (column.Caption && column.Caption !== column.Name) {
+        result.Caption = column.Caption;
+    }
+    // Width: 100이면 제거
+    if (column.Width !== undefined && column.Width !== 100) {
+        result.Width = column.Width;
+    }
+    // Validator: 기본값이면 제거
+    if (column.Validator && !deepEqual(column.Validator, defaultValidator())) {
+        result.Validator = column.Validator;
+    }
+    // KeyType: 0이면 제거
+    if (column.KeyType !== undefined && column.KeyType !== 0) {
+        result.KeyType = column.KeyType;
+    }
+    // HeaderPosition: "center"이면 제거
+    if (column.HeaderPosition && column.HeaderPosition !== "center") {
+        result.HeaderPosition = column.HeaderPosition;
+    }
+    // ColumnType: 0이면 제거
+    if (column.ColumnType !== undefined && column.ColumnType !== 0) {
+        result.ColumnType = column.ColumnType;
+    }
+    // 나머지 속성은 그대로 유지
+    const processedKeys = new Set([
+        "Name", "Caption", "Width", "Validator", "KeyType",
+        "HeaderPosition", "ColumnType",
+    ]);
+    for (const [key, value] of Object.entries(column)) {
+        if (processedKeys.has(key))
+            continue;
+        result[key] = value;
+    }
+    return result;
+}
+// ============================================
+// DataSource compact
+// ============================================
+/** DataSource JSON에서 기본값 속성을 제거 */
+export function compactDataSource(ds) {
+    const result = {};
+    // 필수 속성
+    result.Id = ds.Id;
+    result.Name = ds.Name;
+    // ConnectionCode: 빈 문자열이 아니면 유지
+    if (ds.ConnectionCode) {
+        result.ConnectionCode = ds.ConnectionCode;
+    }
+    // DSType: 0(기본값)이면 제거
+    if (ds.DSType !== undefined && ds.DSType !== 0) {
+        result.DSType = ds.DSType;
+    }
+    // SQL: 빈 문자열이면 제거
+    if (ds.SQL && ds.SQL !== "") {
+        result.SQL = ds.SQL;
+    }
+    // UseMeta/UseCache/Encrypted: false(기본값)이면 제거
+    if (ds.UseMeta === true)
+        result.UseMeta = true;
+    if (ds.UseCache === true)
+        result.UseCache = true;
+    if (ds.Encrypted === true)
+        result.Encrypted = true;
+    // Params: 빈 배열이면 제거
+    if (ds.Params && ds.Params.length > 0) {
+        result.Params = ds.Params;
+    }
+    // Columns: 빈 배열이면 제거
+    if (ds.Columns && ds.Columns.length > 0) {
+        result.Columns = ds.Columns;
+    }
+    // 나머지 pass-through
+    const processedKeys = new Set([
+        "Id", "Name", "ConnectionCode", "DSType", "SQL",
+        "UseMeta", "UseCache", "Encrypted", "Params", "Columns",
+    ]);
+    for (const [key, value] of Object.entries(ds)) {
+        if (processedKeys.has(key))
+            continue;
+        result[key] = value;
+    }
+    return result;
+}
+// ============================================
+// OlapField compact
+// ============================================
+/** OlapField JSON에서 기본값 속성을 제거 */
+export function compactOlapField(field) {
+    const result = {};
+    // 필수: Key, Caption
+    result.Key = field.Key;
+    if (field.Caption && field.Caption !== field.Key) {
+        result.Caption = field.Caption;
+    }
+    // Category: 0(Dimension)이 기본, 명시적으로 유지
+    if (field.Category !== undefined) {
+        result.Category = field.Category;
+    }
+    // Area: 0(Hidden)이 아닌 경우 유지
+    if (field.Area !== undefined && field.Area !== 0) {
+        result.Area = field.Area;
+    }
+    // SummaryType: 0(None)이 아닌 경우 유지
+    if (field.SummaryType !== undefined && field.SummaryType !== 0) {
+        result.SummaryType = field.SummaryType;
+    }
+    // Format: 빈 문자열이 아닌 경우 유지
+    if (field.Format && field.Format !== "") {
+        result.Format = field.Format;
+    }
+    // Width: 100이 아닌 경우 유지
+    if (field.Width !== undefined && field.Width !== 100) {
+        result.Width = field.Width;
+    }
+    // SortType: 0(None)이 아닌 경우 유지
+    if (field.SortType !== undefined && field.SortType !== 0) {
+        result.SortType = field.SortType;
+    }
+    // DataType: 명시적으로 유지 (Dimension/Measure 구분에 중요)
+    if (field.DataType !== undefined) {
+        result.DataType = field.DataType;
+    }
+    // 나머지 boolean/기본값들은 제거
+    // 이하 속성들은 거의 항상 기본값이므로 compact에서 생략
+    // Visible, Expanded, MoveAble, SortAble, FilterAble, AllowFilter, etc.
+    return result;
+}
+/** OlapField 배열 전체를 compact 처리 */
+export function compactOlapFields(fields) {
+    return fields.map(compactOlapField);
+}

package/dist/generators/defaults.js

@@ -62,9 +62,9 @@ export function defaultStyle() {
 export function defaultValidator() {
     return {
         ValidateType: 8, // enGridValidateType.None
-        UseGuideMessage: false,
+        UseGuideMessage: true,
         GuideLanguageCode: "",
-        UseErrorMessage: false,
+        UseErrorMessage: true,
         ErrorLanguageCode: "",
     };
 }

package/dist/generators/fixer.js

@@ -1,6 +1,8 @@
 import { readFileSync, writeFileSync } from "fs";
+import { basename } from "path";
 import { randomBytes } from "crypto";
 import { createDefaultOlapField, isNumericColumnType } from "./olap-field.js";
+import { compactOlapField } from "./compact.js";
 /**
  * MTSD 파일을 읽고, 자동 보정 규칙을 적용한 뒤, 파일을 덮어씁니다.
  */
@@ -50,15 +52,17 @@ export function fixMtsd(filePath) {
             }
         }
     }
+    // .design.json 여부 판별 (compact 형식 → 기본값 추가 생략)
+    const isDesignJson = basename(filePath) === ".design.json";
     // 3. 보정 규칙 적용
     // Rule 1: DataSource Name→Id 참조 보정
     fixDataSourceReferences(doc, dsNameToId, dsIdSet, fixes);
     // Rule 2: OlapGrid DataSource 기반 Fields 자동 생성
-    fixOlapGridFields(doc, datas, fixes);
+    fixOlapGridFields(doc, datas, fixes, isDesignJson);
     // Rule 2-2: OlapGrid Fields 내 CreateType=1 (Measures) 필드 보정
     fixOlapMeasuresField(doc, fixes);
     // Rule 3: Enum/Range 값 범위 초과 보정
-    fixEnumAndRangeValues(doc, datas, fixes);
+    fixEnumAndRangeValues(doc, datas, fixes, isDesignJson);
     // Rule 4: Tab > TabItems 내 ChildElements → Controls 노드 이름 보정
     fixTabItemChildElements(doc, fixes);
     // Rule 5: ServerScriptText Key 누락 보정
@@ -111,7 +115,7 @@ function fixDataSourceReferences(doc, dsNameToId, dsIdSet, fixes) {
 }
 // ---- Rule 2: OlapGrid DataSource 기반 Fields 자동 생성 ----
 // createDefaultOlapField, isNumericColumnType는 olap-field.ts에서 import
-function fixOlapGridFields(doc, datas, fixes) {
+function fixOlapGridFields(doc, datas, fixes, isDesignJson) {
     // DataSource Id → DataSource 객체 매핑
     const dsById = new Map();
     for (const ds of datas) {
@@ -193,11 +197,15 @@ function fixOlapGridFields(doc, datas, fixes) {
                     }
                 }
             }
+            // .design.json이면 compact 처리 (기본값 속성 제거)
+            const finalFields = isDesignJson
+                ? newFields.map(compactOlapField)
+                : newFields;
             // iOLAPView 구조 생성/보정
             if (!el.iOLAPView) {
                 el.iOLAPView = {};
             }
-            el.iOLAPView.Fields = newFields;
+            el.iOLAPView.Fields = finalFields;
             fixes.push(`[Rule2] ${path}: DataSource "${ds.Name || ds.Id}" 컬럼 기준 OlapGrid Fields ${newFields.length}개 자동 생성`);
         });
     }
@@ -366,7 +374,7 @@ function clampColorRGBA(obj, path, fixes) {
         }
     }
 }
-function fixEnumAndRangeValues(doc, datas, fixes) {
+function fixEnumAndRangeValues(doc, datas, fixes, isDesignJson) {
     // ── 1. ReportInfo ──
     const ri = doc.ReportInfo;
     if (ri) {
@@ -384,14 +392,16 @@ function fixEnumAndRangeValues(doc, datas, fixes) {
         if (form.Style) {
             const fPath = `Form("${form.Name}").Style`;
             fixIntRange(form.Style, "Type", 0, 2, 0, fPath, fixes); // 기본값: 0(Skin)
-            // Background 빈 객체 보정
-            if (!form.Style.Background || typeof form.Style.Background !== "object") {
-                form.Style.Background = { Color: { R: 255, G: 255, B: 255, A: 1 } };
-                fixes.push(`[Rule3] ${fPath}.Background: 누락 → 흰색 기본값 보정`);
-            }
-            else if (!form.Style.Background.Color) {
-                form.Style.Background.Color = { R: 255, G: 255, B: 255, A: 1 };
-                fixes.push(`[Rule3] ${fPath}.Background.Color: 누락 → 흰색 기본값 보정`);
+            // Background 빈 객체 보정 (.design.json에서는 생략 — compact 원칙)
+            if (!isDesignJson) {
+                if (!form.Style.Background || typeof form.Style.Background !== "object") {
+                    form.Style.Background = { Color: { R: 255, G: 255, B: 255, A: 1 } };
+                    fixes.push(`[Rule3] ${fPath}.Background: 누락 → 흰색 기본값 보정`);
+                }
+                else if (!form.Style.Background.Color) {
+                    form.Style.Background.Color = { R: 255, G: 255, B: 255, A: 1 };
+                    fixes.push(`[Rule3] ${fPath}.Background.Color: 누락 → 흰색 기본값 보정`);
+                }
             }
         }
     }
@@ -400,26 +410,29 @@ function fixEnumAndRangeValues(doc, datas, fixes) {
         const elements = form.Elements || [];
         walkElements(elements, (el, path) => {
             // ---- AutoRefresh / DoRefresh / DoExport 필수 속성 보정 ----
+            // .design.json에서는 기본값 추가를 생략 (compact 원칙)
             const type = el.Type;
-            // AutoRefresh 대상: DataGrid, ComboBox, MultiComboBox, OlapGrid, Chart, PieChart, ScatterChart, PolygonChart, TreeGrid, iGrid, WebContainer, Tree
-            const hasAutoRefresh = ["DataGrid", "ComboBox", "MultiComboBox", "OlapGrid", "Chart", "PieChart", "ScatterChart", "PolygonChart", "TreeGrid", "iGrid", "WebContainer", "Tree"];
-            if (hasAutoRefresh.includes(type) && !("AutoRefresh" in el)) {
-                const autoDefault = type === "ComboBox" ? true : false;
-                el.AutoRefresh = autoDefault;
-                fixes.push(`[Rule3] ${path}.AutoRefresh: 누락 → ${autoDefault}`);
-            }
-            // DoRefresh 대상: DataGrid, ComboBox, OlapGrid, Chart, PieChart, ScatterChart, PolygonChart, TreeGrid, iGrid, UserComponent, WebContainer, Tree
-            const hasDoRefresh = ["DataGrid", "ComboBox", "OlapGrid", "Chart", "PieChart", "ScatterChart", "PolygonChart", "TreeGrid", "iGrid", "UserComponent", "WebContainer", "Tree"];
-            if (hasDoRefresh.includes(type) && !("DoRefresh" in el)) {
-                const isCombo = type === "ComboBox";
-                el.DoRefresh = isCombo ? false : true;
-                fixes.push(`[Rule3] ${path}.DoRefresh: 누락 → ${el.DoRefresh}`);
-            }
-            // DoExport 대상: DataGrid, OlapGrid, Chart, PieChart, ScatterChart, PolygonChart, TreeGrid, iGrid, UserComponent, Tab
-            const hasDoExport = ["DataGrid", "OlapGrid", "Chart", "PieChart", "ScatterChart", "PolygonChart", "TreeGrid", "iGrid", "UserComponent", "Tab"];
-            if (hasDoExport.includes(type) && !("DoExport" in el)) {
-                el.DoExport = true;
-                fixes.push(`[Rule3] ${path}.DoExport: 누락 → true`);
+            if (!isDesignJson) {
+                // AutoRefresh 대상: DataGrid, ComboBox, MultiComboBox, OlapGrid, Chart, PieChart, ScatterChart, PolygonChart, TreeGrid, iGrid, WebContainer, Tree
+                const hasAutoRefresh = ["DataGrid", "ComboBox", "MultiComboBox", "OlapGrid", "Chart", "PieChart", "ScatterChart", "PolygonChart", "TreeGrid", "iGrid", "WebContainer", "Tree"];
+                if (hasAutoRefresh.includes(type) && !("AutoRefresh" in el)) {
+                    const autoDefault = type === "ComboBox" ? true : false;
+                    el.AutoRefresh = autoDefault;
+                    fixes.push(`[Rule3] ${path}.AutoRefresh: 누락 → ${autoDefault}`);
+                }
+                // DoRefresh 대상: DataGrid, ComboBox, OlapGrid, Chart, PieChart, ScatterChart, PolygonChart, TreeGrid, iGrid, UserComponent, WebContainer, Tree
+                const hasDoRefresh = ["DataGrid", "ComboBox", "OlapGrid", "Chart", "PieChart", "ScatterChart", "PolygonChart", "TreeGrid", "iGrid", "UserComponent", "WebContainer", "Tree"];
+                if (hasDoRefresh.includes(type) && !("DoRefresh" in el)) {
+                    const isCombo = type === "ComboBox";
+                    el.DoRefresh = isCombo ? false : true;
+                    fixes.push(`[Rule3] ${path}.DoRefresh: 누락 → ${el.DoRefresh}`);
+                }
+                // DoExport 대상: DataGrid, OlapGrid, Chart, PieChart, ScatterChart, PolygonChart, TreeGrid, iGrid, UserComponent, Tab
+                const hasDoExport = ["DataGrid", "OlapGrid", "Chart", "PieChart", "ScatterChart", "PolygonChart", "TreeGrid", "iGrid", "UserComponent", "Tab"];
+                if (hasDoExport.includes(type) && !("DoExport" in el)) {
+                    el.DoExport = true;
+                    fixes.push(`[Rule3] ${path}.DoExport: 누락 → true`);
+                }
             }
             // ---- Style.Type: 커스텀 색상 설정 시 Type=2(Custom) 자동 보정 ----
             // Control.ts UpdateStyle: Type=0(Skin)이면 커스텀 Background/Border/Font CSS 무시됨
@@ -487,45 +500,56 @@ function fixEnumAndRangeValues(doc, datas, fixes) {
             }
             // ---- Style.Background Color (빈 객체 {} 허용 안 됨) ----
             if (el.Style) {
-                if (!el.Style.Background || typeof el.Style.Background !== "object") {
-                    el.Style.Background = { Color: { R: 255, G: 255, B: 255, A: 1 } };
-                    fixes.push(`[Rule3] ${path}.Style.Background: 누락 → 흰색 기본값 보정`);
-                }
-                else if (!el.Style.Background.Color) {
-                    el.Style.Background.Color = { R: 255, G: 255, B: 255, A: 1 };
-                    fixes.push(`[Rule3] ${path}.Style.Background.Color: 누락 → 흰색 기본값 보정`);
+                // .design.json에서는 Background 기본값 추가 생략 (compact 원칙)
+                if (!isDesignJson) {
+                    if (!el.Style.Background || typeof el.Style.Background !== "object") {
+                        el.Style.Background = { Color: { R: 255, G: 255, B: 255, A: 1 } };
+                        fixes.push(`[Rule3] ${path}.Style.Background: 누락 → 흰색 기본값 보정`);
+                    }
+                    else if (!el.Style.Background.Color) {
+                        el.Style.Background.Color = { R: 255, G: 255, B: 255, A: 1 };
+                        fixes.push(`[Rule3] ${path}.Style.Background.Color: 누락 → 흰색 기본값 보정`);
+                    }
                 }
+                // 색상 범위 검증은 항상 수행 (존재하는 값의 유효성 체크)
                 const bg = el.Style.Background;
-                clampColorRGBA(bg, `${path}.Style.Background`, fixes);
-                if (bg.Color)
-                    clampColorRGBA(bg.Color, `${path}.Style.Background.Color`, fixes);
+                if (bg) {
+                    clampColorRGBA(bg, `${path}.Style.Background`, fixes);
+                    if (bg.Color)
+                        clampColorRGBA(bg.Color, `${path}.Style.Background.Color`, fixes);
+                }
             }
             // ---- DataGrid: ColumnHeaderHeight / RowHeight / ShowHeader 필수 ----
             if (el.Type === "DataGrid") {
-                if (!("ColumnHeaderHeight" in el)) {
-                    el.ColumnHeaderHeight = 28;
-                    fixes.push(`[Rule3] ${path}.ColumnHeaderHeight: 누락 → 28`);
-                }
-                if (!("RowHeight" in el)) {
-                    el.RowHeight = 24;
-                    fixes.push(`[Rule3] ${path}.RowHeight: 누락 → 24`);
-                }
-                if (!("ShowHeader" in el)) {
-                    el.ShowHeader = 3;
-                    fixes.push(`[Rule3] ${path}.ShowHeader: 누락 → 3 (Row&Column)`);
-                }
-                fixIntRange(el, "ShowHeader", 0, 3, 3, path, fixes); // 0:None, 1:Row, 2:Column, 3:Row&Column
-                if (!("SelectRule" in el)) {
-                    el.SelectRule = 2;
-                    fixes.push(`[Rule3] ${path}.SelectRule: 누락 → 2 (SingleRange)`);
+                if (!isDesignJson) {
+                    if (!("ColumnHeaderHeight" in el)) {
+                        el.ColumnHeaderHeight = 28;
+                        fixes.push(`[Rule3] ${path}.ColumnHeaderHeight: 누락 → 28`);
+                    }
+                    if (!("RowHeight" in el)) {
+                        el.RowHeight = 24;
+                        fixes.push(`[Rule3] ${path}.RowHeight: 누락 → 24`);
+                    }
+                    if (!("ShowHeader" in el)) {
+                        el.ShowHeader = 3;
+                        fixes.push(`[Rule3] ${path}.ShowHeader: 누락 → 3 (Row&Column)`);
+                    }
+                    if (!("SelectRule" in el)) {
+                        el.SelectRule = 2;
+                        fixes.push(`[Rule3] ${path}.SelectRule: 누락 → 2 (SingleRange)`);
+                    }
                 }
-                fixIntRange(el, "SelectRule", 0, 3, 2, path, fixes); // 0:SingleRow, 1:MultiRow, 2:SingleRange, 3:SingleCell
+                // 범위 검증은 항상 수행 (존재하는 값의 유효성 체크)
+                fixIntRange(el, "ShowHeader", 0, 3, 3, path, fixes);
+                fixIntRange(el, "SelectRule", 0, 3, 2, path, fixes);
             }
             // ---- TreeGrid: ToggleBtnSize 필수 ----
             if (el.Type === "TreeGrid") {
-                if (!("ToggleBtnSize" in el)) {
-                    el.ToggleBtnSize = 10;
-                    fixes.push(`[Rule3] ${path}.ToggleBtnSize: 누락 → 10`);
+                if (!isDesignJson) {
+                    if (!("ToggleBtnSize" in el)) {
+                        el.ToggleBtnSize = 10;
+                        fixes.push(`[Rule3] ${path}.ToggleBtnSize: 누락 → 10`);
+                    }
                 }
             }
             // ---- DataGrid / TreeGrid Columns ----
@@ -544,7 +568,7 @@ function fixEnumAndRangeValues(doc, datas, fixes) {
                 }
             }
             // ---- FileUploadButton: Value / Cursor 필수 ----
-            if (el.Type === "FileUploadButton") {
+            if (el.Type === "FileUploadButton" && !isDesignJson) {
                 if (!("Value" in el)) {
                     el.Value = "upload";
                     fixes.push(`[Rule3] ${path}.Value: 누락 → "upload"`);
@@ -556,7 +580,7 @@ function fixEnumAndRangeValues(doc, datas, fixes) {
             }
             // ---- Chart: PlotOptions 필수 ----
             const isChart = ["Chart", "PieChart", "ScatterChart", "PolygonChart"].includes(type);
-            if (isChart) {
+            if (isChart && !isDesignJson) {
                 if (!el.PlotOptions || typeof el.PlotOptions !== "object") {
                     el.PlotOptions = { Animation: 1000, EnableMouseTracking: true, DataLabels: {}, ConnectNulls: false, AllowOverlap: false };
                     fixes.push(`[Rule3] ${path}.PlotOptions: 누락 → 기본값 생성`);
@@ -587,16 +611,19 @@ function fixEnumAndRangeValues(doc, datas, fixes) {
             }
             // ---- MultiComboBox: InitType / RefreshType 필수 + enum 범위 ----
             if (el.Type === "MultiComboBox") {
-                if (!("InitType" in el)) {
-                    el.InitType = 0;
-                    fixes.push(`[Rule3] ${path}.InitType: 누락 → 0 (CurrentValue)`);
-                }
-                fixIntRange(el, "InitType", 0, 2, 0, path, fixes); // 0:CurrentValue, 1:InitValue, 2:없음
-                if (!("RefreshType" in el)) {
-                    el.RefreshType = 1;
-                    fixes.push(`[Rule3] ${path}.RefreshType: 누락 → 1 (FirstTime)`);
+                if (!isDesignJson) {
+                    if (!("InitType" in el)) {
+                        el.InitType = 0;
+                        fixes.push(`[Rule3] ${path}.InitType: 누락 → 0 (CurrentValue)`);
+                    }
+                    if (!("RefreshType" in el)) {
+                        el.RefreshType = 1;
+                        fixes.push(`[Rule3] ${path}.RefreshType: 누락 → 1 (FirstTime)`);
+                    }
                 }
-                fixIntRange(el, "RefreshType", 0, 2, 1, path, fixes); // 0:None, 1:FirstTime, 2:EveryTime
+                // 범위 검증은 항상 수행
+                fixIntRange(el, "InitType", 0, 2, 0, path, fixes);
+                fixIntRange(el, "RefreshType", 0, 2, 1, path, fixes);
             }
             // ---- OlapGrid Fields ----
             if (el.Type === "OlapGrid") {

package/dist/generators/olap-field.js

@@ -78,6 +78,7 @@ export function createDefaultOlapField(key, caption) {
             MeasureFilterTypeB: 0,
             MeasureAndOrOperator: 2,
         },
+        RelationFields: [],
     };
 }
 // ─── summaryType 문자열 → enum 변환 ───