@bimatrix-aud-platform/aud_mcp_server 1.1.37 → 1.1.39

package/dist/generators/report-template.js

@@ -0,0 +1,723 @@
+import { generateId } from "../utils/uuid.js";
+import { parseDocking } from "../utils/docking.js";
+import { parseHexColor } from "../utils/color.js";
+import { generateGridColumns } from "./grid-column.js";
+// ============================================================
+// 2. Schema-Compliant Style Helpers
+// ============================================================
+/** Transparent background (MTSD schema requires Color + flat RGBA) */
+function emptyBg() {
+    return {
+        Color: { R: 0, G: 0, B: 0, A: 0 },
+        ColorR: 0, ColorG: 0, ColorB: 0, ColorA: 0,
+    };
+}
+/** Colored background from hex string */
+function fullBg(hex) {
+    const c = parseHexColor(hex);
+    return {
+        Color: { R: c.R, G: c.G, B: c.B, A: 1 },
+        ColorR: c.R, ColorG: c.G, ColorB: c.B, ColorA: 1,
+    };
+}
+/** Transparent border */
+function emptyBorder() {
+    return {
+        Color: { R: 0, G: 0, B: 0, A: 0 },
+        ColorR: 0, ColorG: 0, ColorB: 0, ColorA: 0,
+        CornerRadius: "0,0,0,0",
+        LineType: "none",
+        Thickness: "0,0,0,0",
+    };
+}
+/** Full border with options */
+function fullBorder(opts = {}) {
+    const c = opts.color ? parseHexColor(opts.color) : { R: 224, G: 224, B: 224, A: 255 };
+    return {
+        Color: { R: c.R, G: c.G, B: c.B, A: 1 },
+        ColorR: c.R, ColorG: c.G, ColorB: c.B, ColorA: 1,
+        CornerRadius: opts.radius || "0,0,0,0",
+        LineType: opts.lineType || "solid",
+        Thickness: opts.thickness || "1,1,1,1",
+    };
+}
+/** Full font with options */
+function fullFont(opts = {}) {
+    const c = opts.color ? parseHexColor(opts.color) : { R: 0, G: 0, B: 0, A: 255 };
+    return {
+        Color: { R: c.R, G: c.G, B: c.B, A: 1 },
+        Size: opts.size ?? 12,
+        Family: opts.family ?? "inherit",
+        Bold: opts.bold ?? false,
+        Italic: opts.italic ?? false,
+        UnderLine: false,
+        HorizontalAlignment: opts.align ?? "left",
+        VerticalAlignment: opts.valign ?? "middle",
+    };
+}
+/** Skin style (Type=0, no custom colors applied) */
+function skinStyle() {
+    return {
+        Type: 0,
+        BoxStyle: "",
+        Background: emptyBg(),
+        Border: emptyBorder(),
+        Font: fullFont(),
+    };
+}
+/** Custom style (Type=2, colors applied) */
+function customStyle(opts = {}) {
+    return {
+        Type: 2,
+        BoxStyle: "",
+        Background: opts.bg ? fullBg(opts.bg) : emptyBg(),
+        Border: opts.border ? fullBorder(opts.border) : emptyBorder(),
+        Font: fullFont(opts.font),
+    };
+}
+// ============================================================
+// 3. Position & Docking Helper
+// ============================================================
+function pos(left, top, width, height, dock, margin) {
+    const docking = dock ? parseDocking(dock) : parseDocking("none");
+    if (margin)
+        docking.Margin = margin;
+    return {
+        Left: left, Top: top, Width: width, Height: height,
+        ZIndex: 1, TabIndex: 0, Docking: docking,
+    };
+}
+// ============================================================
+// 4. Element Factory Functions
+// ============================================================
+function mkLabel(id, name, text, position, fontOpts) {
+    return {
+        Type: "Label",
+        Id: id || generateId("Label"),
+        Name: name,
+        Position: position,
+        Style: fontOpts ? customStyle({ font: fontOpts }) : skinStyle(),
+        LanguageCode: "",
+        Text: text,
+        Cursor: "default",
+        Formula: "",
+        UseTextOverflow: false,
+        UseAutoLineBreak: false,
+        LineSpacing: 0,
+        HasLineSpacing: false,
+        MxBinding: "",
+        MxBindingUseStyle: false,
+    };
+}
+function mkButton(id, name, text, position, styleOpts) {
+    return {
+        Type: "Button",
+        Id: id || generateId("Button"),
+        Name: name,
+        Position: position,
+        Style: styleOpts || skinStyle(),
+        LanguageCode: "",
+        Value: text,
+        Cursor: "pointer",
+        HasNewRadius: false,
+    };
+}
+function mkGroup(id, name, position, children, styleOpts) {
+    // Set InGroup on all children
+    const groupId = id || generateId("Group");
+    for (const child of children) {
+        child.InGroup = groupId;
+    }
+    return {
+        Type: "Group",
+        Id: groupId,
+        Name: name,
+        Position: position,
+        Style: styleOpts || skinStyle(),
+        ChildElements: children,
+    };
+}
+function mkCalendar(id, name, position) {
+    return {
+        Type: "Calendar",
+        Id: id || generateId("Calendar"),
+        Name: name,
+        Position: position,
+        Style: skinStyle(),
+        LanguageCode: "",
+        Value: "",
+        Text: "",
+        InitType: 0,
+        IsReadOnly: false,
+        CalendarType: 0,
+        UseButton: true,
+        AutoRefresh: false,
+        AfterRefresh: "",
+        DataSource: "",
+        MxBinding: "",
+        MxBindingUseStyle: false,
+    };
+}
+function mkDataGrid(id, name, position, columns, dsName) {
+    return {
+        Type: "DataGrid",
+        Id: id || generateId("DataGrid"),
+        Name: name,
+        Position: position,
+        Style: skinStyle(),
+        DataSource: dsName,
+        CellMargin: "2",
+        Columns: columns,
+        UsePPTExport: false,
+        AutoRefresh: false,
+        DoRefresh: false,
+        DoExport: false,
+        ColumnHeaderHeight: 30,
+        RowHeight: 26,
+        ShowHeader: true,
+        SelectRule: 0,
+    };
+}
+function mkChart(id, name, position, dsName) {
+    return {
+        Type: "Chart",
+        Id: id || generateId("Chart"),
+        Name: name,
+        Position: position,
+        Style: skinStyle(),
+        DataSource: dsName,
+        AutoRefresh: false,
+        DoRefresh: false,
+        DoExport: false,
+        PlotOptions: {},
+    };
+}
+function mkTextBox(id, name, position) {
+    return {
+        Type: "TextBox",
+        Id: id || generateId("TextBox"),
+        Name: name,
+        Position: position,
+        Style: skinStyle(),
+        LanguageCode: "",
+        Value: "",
+        Text: "",
+        IsReadOnly: false,
+        Formula: "",
+        MaxLength: 0,
+        MxBinding: "",
+        MxBindingUseStyle: false,
+    };
+}
+function mkComboBox(id, name, position) {
+    return {
+        Type: "ComboBox",
+        Id: id || generateId("ComboBox"),
+        Name: name,
+        Position: position,
+        Style: skinStyle(),
+        DataSource: "",
+        Value: "",
+        Text: "",
+        InitType: 0,
+        RefreshType: 0,
+        IsReadOnly: false,
+        SortType: 0,
+        AutoRefresh: false,
+        AfterRefresh: "",
+        UseAllItems: false,
+        UseAllItemsText: "",
+        DisplayType: 0,
+        DataSourceInfo: { LabelField: "", ValueField: "" },
+        InitValue: "",
+    };
+}
+// ============================================================
+// 5. DataSource Factory
+// ============================================================
+function extractParamsFromSQL(sql) {
+    const paramSet = new Set();
+    const regex = /[@%]?:([A-Za-z_][A-Za-z0-9_]*)/g;
+    let match;
+    while ((match = regex.exec(sql)) !== null) {
+        paramSet.add(match[1]);
+    }
+    return Array.from(paramSet);
+}
+function mkDataSource(name, connection, sql, columns) {
+    const paramNames = extractParamsFromSQL(sql);
+    return {
+        Id: generateId("DS"),
+        Name: name,
+        ConnectionCode: connection,
+        DSType: 0,
+        UseMeta: false,
+        UseCache: false,
+        Encrypted: false,
+        SQL: sql,
+        Params: paramNames.map(n => ({
+            Name: n.startsWith(":") ? n : `:${n}`,
+            ParamType: "String",
+        })),
+        Columns: (columns || []).map(c => ({
+            Name: c.name,
+            Type: c.type || "string",
+        })),
+    };
+}
+// ============================================================
+// 6. Script Generator
+// ============================================================
+function generateSearchListScript(input) {
+    const gridName = "GRD_MAIN";
+    return `import { Matrix } from "@AUD_CLIENT/control/Matrix";
+import { Button } from "@AUD_CLIENT/control/Button";
+import { Calendar } from "@AUD_CLIENT/control/Calendar";
+import { DataGrid } from "@AUD_CLIENT/control/DataGrid";
+
+let Matrix: Matrix;
+
+Matrix.OnDocumentLoadComplete = function (sender, args) {
+    let btnSearch = Matrix.getObject("BTN_SEARCH") as Button;
+    btnSearch.OnClick = btnSearchOnClick;
+};
+
+const btnSearchOnClick = function (sender, args) {
+    let calFrom = Matrix.getObject("CAL_FROM") as Calendar;
+    let calTo = Matrix.getObject("CAL_TO") as Calendar;
+
+    Matrix.SetVariable("VS_YMD_FROM", calFrom.Value);
+    Matrix.SetVariable("VS_YMD_TO", calTo.Value);
+
+    Matrix.doRefresh(["${gridName}"]);
+};
+`;
+}
+function generateCrudScript(input) {
+    const gridName = "GRD_MAIN";
+    return `import { Matrix } from "@AUD_CLIENT/control/Matrix";
+import { Button } from "@AUD_CLIENT/control/Button";
+import { Calendar } from "@AUD_CLIENT/control/Calendar";
+import { DataGrid } from "@AUD_CLIENT/control/DataGrid";
+
+let Matrix: Matrix;
+
+Matrix.OnDocumentLoadComplete = function (sender, args) {
+    let btnSearch = Matrix.getObject("BTN_SEARCH") as Button;
+    let btnSave = Matrix.getObject("BTN_SAVE") as Button;
+    let btnAddRow = Matrix.getObject("BTN_ADD_ROW") as Button;
+    let btnDelRow = Matrix.getObject("BTN_DEL_ROW") as Button;
+
+    btnSearch.OnClick = btnSearchOnClick;
+    btnSave.OnClick = btnSaveOnClick;
+    btnAddRow.OnClick = btnAddRowOnClick;
+    btnDelRow.OnClick = btnDelRowOnClick;
+};
+
+const btnSearchOnClick = function (sender, args) {
+    let calFrom = Matrix.getObject("CAL_FROM") as Calendar;
+    let calTo = Matrix.getObject("CAL_TO") as Calendar;
+
+    Matrix.SetVariable("VS_YMD_FROM", calFrom.Value);
+    Matrix.SetVariable("VS_YMD_TO", calTo.Value);
+
+    Matrix.doRefresh(["${gridName}"]);
+};
+
+const btnSaveOnClick = function (sender, args) {
+    let grd = Matrix.getObject("${gridName}") as DataGrid;
+    Matrix.RunScriptEx(["${gridName}"], "SVC_SAVE", {}, function (p) {
+        if (p.Success) {
+            Matrix.Alert("저장되었습니다.");
+            Matrix.doRefresh(["${gridName}"]);
+        }
+    });
+};
+
+const btnAddRowOnClick = function (sender, args) {
+    let grd = Matrix.getObject("${gridName}") as DataGrid;
+    grd.addRow();
+};
+
+const btnDelRowOnClick = function (sender, args) {
+    let grd = Matrix.getObject("${gridName}") as DataGrid;
+    let row = grd.getSelectedRowIndex();
+    if (row >= 0) {
+        grd.deleteRow(row);
+    }
+};
+`;
+}
+function generateMasterDetailScript(input) {
+    return `import { Matrix } from "@AUD_CLIENT/control/Matrix";
+import { Button } from "@AUD_CLIENT/control/Button";
+import { Calendar } from "@AUD_CLIENT/control/Calendar";
+import { DataGrid } from "@AUD_CLIENT/control/DataGrid";
+
+let Matrix: Matrix;
+
+Matrix.OnDocumentLoadComplete = function (sender, args) {
+    let btnSearch = Matrix.getObject("BTN_SEARCH") as Button;
+    btnSearch.OnClick = btnSearchOnClick;
+
+    let grdMaster = Matrix.getObject("GRD_MASTER") as DataGrid;
+    grdMaster.OnSelectionChanged = grdMasterOnSelectionChanged;
+};
+
+const btnSearchOnClick = function (sender, args) {
+    let calFrom = Matrix.getObject("CAL_FROM") as Calendar;
+    let calTo = Matrix.getObject("CAL_TO") as Calendar;
+
+    Matrix.SetVariable("VS_YMD_FROM", calFrom.Value);
+    Matrix.SetVariable("VS_YMD_TO", calTo.Value);
+
+    Matrix.doRefresh(["GRD_MASTER"]);
+};
+
+const grdMasterOnSelectionChanged = function (sender, args) {
+    let grd = Matrix.getObject("GRD_MASTER") as DataGrid;
+    let row = grd.getSelectedRowIndex();
+    if (row < 0) return;
+
+    let dt = grd.getDataTable();
+    // TODO: Set detail key variable and refresh detail grid
+    // Matrix.SetVariable("VS_MASTER_KEY", dt.getRowValue(row, "KEY_COLUMN"));
+    // Matrix.doRefresh(["GRD_DETAIL"]);
+};
+`;
+}
+function generateDashboardScript(input) {
+    const kpiLabels = (input.kpiCards || []).map(k => k.valueLabel);
+    const kpiLines = kpiLabels.map(lbl => `    let ${lbl.replace("LBL_", "lbl")} = Matrix.getObject("${lbl}") as Label;`).join("\n");
+    return `import { Matrix } from "@AUD_CLIENT/control/Matrix";
+import { Button } from "@AUD_CLIENT/control/Button";
+import { Label } from "@AUD_CLIENT/control/Label";
+import { Calendar } from "@AUD_CLIENT/control/Calendar";
+import { DataGrid } from "@AUD_CLIENT/control/DataGrid";
+import { Chart } from "@AUD_CLIENT/control/Chart";
+
+let Matrix: Matrix;
+
+Matrix.OnDocumentLoadComplete = function (sender, args) {
+    let btnSearch = Matrix.getObject("BTN_SEARCH") as Button;
+    btnSearch.OnClick = btnSearchOnClick;
+};
+
+Matrix.OnDataBindEnd = function (sender, args) {
+    updateKPI();
+};
+
+const btnSearchOnClick = function (sender, args) {
+    let calFrom = Matrix.getObject("CAL_FROM") as Calendar;
+    let calTo = Matrix.getObject("CAL_TO") as Calendar;
+
+    Matrix.SetVariable("VS_YMD_FROM", calFrom.Value);
+    Matrix.SetVariable("VS_YMD_TO", calTo.Value);
+
+    Matrix.doRefresh(["CHART_MAIN", "GRD_MAIN"]);
+};
+
+/** KPI 카드 값 업데이트 */
+const updateKPI = function () {
+    let grd = Matrix.getObject("GRD_MAIN") as DataGrid;
+    let dt = grd.getDataTable();
+
+    if (dt == null || dt.GetRowCount() === 0) return;
+
+    // TODO: KPI 계산 로직을 업무에 맞게 수정하세요
+${kpiLines}
+};
+
+/** 숫자 콤마 포맷 */
+const formatNumber = function (num: number): string {
+    return num.toString().replace(/\\B(?=(\\d{3})+(?!\\d))/g, ",");
+};
+`;
+}
+// ============================================================
+// 7. Template Layout Builders
+// ============================================================
+function buildSearchListLayout(input) {
+    const warnings = [];
+    const elements = [];
+    // IDs
+    const grpHeaderId = generateId("Group");
+    const grpSearchId = generateId("Group");
+    // Header
+    const lblTitle = mkLabel(generateId("Label"), "LBL_TITLE", input.title || input.reportName, pos(15, 10, 300, 30), { size: 18, bold: true, color: "#333333" });
+    const btnSearch = mkButton(generateId("Button"), "BTN_SEARCH", "조회", pos(0, 10, 80, 30, "right", "0,0,15,0"));
+    btnSearch.Position.Docking.HoldSize = true;
+    const grpHeader = mkGroup(grpHeaderId, "GRP_HEADER", pos(0, 0, 1200, 50, "left+right"), [lblTitle, btnSearch], customStyle({
+        bg: "#F8F9FA",
+        border: { thickness: "0,0,1,0", color: "#E0E0E0" },
+    }));
+    elements.push(grpHeader);
+    // Search Conditions
+    const lblFrom = mkLabel(generateId("Label"), "LBL_FROM", "조회기간", pos(15, 10, 60, 25), { size: 12, color: "#555555" });
+    const calFrom = mkCalendar(generateId("Calendar"), "CAL_FROM", pos(80, 8, 130, 28));
+    const lblWave = mkLabel(generateId("Label"), "LBL_WAVE", "~", pos(215, 10, 15, 25), { size: 12, align: "center" });
+    const calTo = mkCalendar(generateId("Calendar"), "CAL_TO", pos(235, 8, 130, 28));
+    const grpSearch = mkGroup(grpSearchId, "GRP_SEARCH", pos(0, 50, 1200, 45, "left+right"), [lblFrom, calFrom, lblWave, calTo], customStyle({ border: { thickness: "0,0,1,0", color: "#E0E0E0" } }));
+    elements.push(grpSearch);
+    // Grid
+    const gridCols = input.gridColumns
+        ? generateGridColumns({ columns: input.gridColumns }).columns
+        : [];
+    const dsName = input.dataSources[0]?.name || "DS_GRID";
+    const grdMain = mkDataGrid(generateId("DataGrid"), "GRD_MAIN", pos(0, 95, 1200, 500, "left+right+bottom"), gridCols, dsName);
+    elements.push(grdMain);
+    return { elements, warnings };
+}
+function buildCrudLayout(input) {
+    const warnings = [];
+    const elements = [];
+    const grpHeaderId = generateId("Group");
+    const grpSearchId = generateId("Group");
+    // Header with multiple buttons
+    const lblTitle = mkLabel(generateId("Label"), "LBL_TITLE", input.title || input.reportName, pos(15, 10, 300, 30), { size: 18, bold: true, color: "#333333" });
+    const btnSearch = mkButton(generateId("Button"), "BTN_SEARCH", "조회", pos(0, 10, 80, 30, "right", "0,0,275,0"));
+    btnSearch.Position.Docking.HoldSize = true;
+    const btnSave = mkButton(generateId("Button"), "BTN_SAVE", "저장", pos(0, 10, 80, 30, "right", "0,0,190,0"));
+    btnSave.Position.Docking.HoldSize = true;
+    const btnAddRow = mkButton(generateId("Button"), "BTN_ADD_ROW", "행추가", pos(0, 10, 80, 30, "right", "0,0,105,0"));
+    btnAddRow.Position.Docking.HoldSize = true;
+    const btnDelRow = mkButton(generateId("Button"), "BTN_DEL_ROW", "행삭제", pos(0, 10, 80, 30, "right", "0,0,15,0"));
+    btnDelRow.Position.Docking.HoldSize = true;
+    const grpHeader = mkGroup(grpHeaderId, "GRP_HEADER", pos(0, 0, 1200, 50, "left+right"), [lblTitle, btnSearch, btnSave, btnAddRow, btnDelRow], customStyle({
+        bg: "#F8F9FA",
+        border: { thickness: "0,0,1,0", color: "#E0E0E0" },
+    }));
+    elements.push(grpHeader);
+    // Search
+    const lblFrom = mkLabel(generateId("Label"), "LBL_FROM", "조회기간", pos(15, 10, 60, 25), { size: 12, color: "#555555" });
+    const calFrom = mkCalendar(generateId("Calendar"), "CAL_FROM", pos(80, 8, 130, 28));
+    const lblWave = mkLabel(generateId("Label"), "LBL_WAVE", "~", pos(215, 10, 15, 25), { size: 12, align: "center" });
+    const calTo = mkCalendar(generateId("Calendar"), "CAL_TO", pos(235, 8, 130, 28));
+    const grpSearch = mkGroup(grpSearchId, "GRP_SEARCH", pos(0, 50, 1200, 45, "left+right"), [lblFrom, calFrom, lblWave, calTo], customStyle({ border: { thickness: "0,0,1,0", color: "#E0E0E0" } }));
+    elements.push(grpSearch);
+    // Grid (editable)
+    const gridCols = input.gridColumns
+        ? generateGridColumns({ columns: input.gridColumns.map(c => ({ ...c, editable: true })) }).columns
+        : [];
+    const dsName = input.dataSources[0]?.name || "DS_GRID";
+    const grdMain = mkDataGrid(generateId("DataGrid"), "GRD_MAIN", pos(0, 95, 1200, 500, "left+right+bottom"), gridCols, dsName);
+    elements.push(grdMain);
+    return { elements, warnings };
+}
+function buildMasterDetailLayout(input) {
+    const warnings = [];
+    const elements = [];
+    const grpHeaderId = generateId("Group");
+    const grpSearchId = generateId("Group");
+    // Header
+    const lblTitle = mkLabel(generateId("Label"), "LBL_TITLE", input.title || input.reportName, pos(15, 10, 300, 30), { size: 18, bold: true, color: "#333333" });
+    const btnSearch = mkButton(generateId("Button"), "BTN_SEARCH", "조회", pos(0, 10, 80, 30, "right", "0,0,15,0"));
+    btnSearch.Position.Docking.HoldSize = true;
+    const grpHeader = mkGroup(grpHeaderId, "GRP_HEADER", pos(0, 0, 1200, 50, "left+right"), [lblTitle, btnSearch], customStyle({
+        bg: "#F8F9FA",
+        border: { thickness: "0,0,1,0", color: "#E0E0E0" },
+    }));
+    elements.push(grpHeader);
+    // Search
+    const lblFrom = mkLabel(generateId("Label"), "LBL_FROM", "조회기간", pos(15, 10, 60, 25), { size: 12, color: "#555555" });
+    const calFrom = mkCalendar(generateId("Calendar"), "CAL_FROM", pos(80, 8, 130, 28));
+    const lblWave = mkLabel(generateId("Label"), "LBL_WAVE", "~", pos(215, 10, 15, 25), { size: 12, align: "center" });
+    const calTo = mkCalendar(generateId("Calendar"), "CAL_TO", pos(235, 8, 130, 28));
+    const grpSearch = mkGroup(grpSearchId, "GRP_SEARCH", pos(0, 50, 1200, 45, "left+right"), [lblFrom, calFrom, lblWave, calTo], customStyle({ border: { thickness: "0,0,1,0", color: "#E0E0E0" } }));
+    elements.push(grpSearch);
+    // Master grid (left side, ~60% width)
+    const gridCols = input.gridColumns
+        ? generateGridColumns({ columns: input.gridColumns }).columns
+        : [];
+    const masterDsName = input.dataSources[0]?.name || "DS_MASTER";
+    const grdMaster = mkDataGrid(generateId("DataGrid"), "GRD_MASTER", pos(0, 95, 700, 500, "left+bottom"), gridCols, masterDsName);
+    elements.push(grdMaster);
+    // Detail panel (right side)
+    const grpDetailId = generateId("Group");
+    const lblDetailTitle = mkLabel(generateId("Label"), "LBL_DETAIL_TITLE", "상세 정보", pos(15, 10, 200, 25), { size: 14, bold: true, color: "#333333" });
+    const grpDetail = mkGroup(grpDetailId, "GRP_DETAIL", pos(710, 95, 490, 500, "right+bottom", "0,0,0,0"), [lblDetailTitle], customStyle({
+        border: { thickness: "1,0,0,0", color: "#E0E0E0" },
+    }));
+    grpDetail.Position.Docking.HoldSize = true;
+    elements.push(grpDetail);
+    warnings.push("master-detail: 상세 패널(GRP_DETAIL)에 업무에 맞는 컨트롤을 추가해주세요.");
+    return { elements, warnings };
+}
+function buildDashboardLayout(input) {
+    const warnings = [];
+    const elements = [];
+    const grpHeaderId = generateId("Group");
+    const grpSearchId = generateId("Group");
+    const grpKpiId = generateId("Group");
+    // Header
+    const lblTitle = mkLabel(generateId("Label"), "LBL_TITLE", input.title || input.reportName, pos(15, 10, 300, 30), { size: 18, bold: true, color: "#333333" });
+    const btnSearch = mkButton(generateId("Button"), "BTN_SEARCH", "조회", pos(0, 10, 80, 30, "right", "0,0,15,0"));
+    btnSearch.Position.Docking.HoldSize = true;
+    const grpHeader = mkGroup(grpHeaderId, "GRP_HEADER", pos(0, 0, 1200, 50, "left+right"), [lblTitle, btnSearch], customStyle({
+        bg: "#F8F9FA",
+        border: { thickness: "0,0,1,0", color: "#E0E0E0" },
+    }));
+    elements.push(grpHeader);
+    // Search
+    const lblFrom = mkLabel(generateId("Label"), "LBL_FROM", "조회기간", pos(15, 10, 60, 25), { size: 12, color: "#555555" });
+    const calFrom = mkCalendar(generateId("Calendar"), "CAL_FROM", pos(80, 8, 130, 28));
+    const lblWave = mkLabel(generateId("Label"), "LBL_WAVE", "~", pos(215, 10, 15, 25), { size: 12, align: "center" });
+    const calTo = mkCalendar(generateId("Calendar"), "CAL_TO", pos(235, 8, 130, 28));
+    const grpSearch = mkGroup(grpSearchId, "GRP_SEARCH", pos(0, 50, 1200, 45, "left+right"), [lblFrom, calFrom, lblWave, calTo], customStyle({ border: { thickness: "0,0,1,0", color: "#E0E0E0" } }));
+    elements.push(grpSearch);
+    // KPI Cards
+    const defaultKpiCards = [
+        { title: "총매출", valueLabel: "LBL_KPI_VAL1", color: "#4A90D9" },
+        { title: "주문건수", valueLabel: "LBL_KPI_VAL2", color: "#50C878" },
+        { title: "고객수", valueLabel: "LBL_KPI_VAL3", color: "#FFB347" },
+        { title: "달성률", valueLabel: "LBL_KPI_VAL4", color: "#FF6B6B" },
+    ];
+    const kpiCards = input.kpiCards && input.kpiCards.length > 0
+        ? input.kpiCards
+        : defaultKpiCards;
+    const kpiChildren = [];
+    const cardWidth = 270;
+    const cardGap = 20;
+    kpiCards.forEach((card, i) => {
+        const cardX = 15 + i * (cardWidth + cardGap);
+        const cardColor = card.color || ["#4A90D9", "#50C878", "#FFB347", "#FF6B6B"][i % 4];
+        const cardId = generateId("Group");
+        const lblCardTitle = mkLabel(generateId("Label"), `LBL_KPI_TTL${i + 1}`, card.title, pos(15, 8, 240, 22), { size: 12, color: "#666666" });
+        const lblCardValue = mkLabel(generateId("Label"), card.valueLabel || `LBL_KPI_VAL${i + 1}`, "-", pos(15, 35, 240, 40), { size: 24, bold: true, color: cardColor });
+        const kpiCard = mkGroup(cardId, `GRP_KPI_CARD${i + 1}`, pos(cardX, 10, cardWidth, 90), [lblCardTitle, lblCardValue], customStyle({
+            bg: "#FFFFFF",
+            border: { thickness: "1,1,1,1", color: "#E0E0E0", radius: "8,8,8,8" },
+        }));
+        kpiChildren.push(kpiCard);
+    });
+    const grpKpi = mkGroup(grpKpiId, "GRP_KPI", pos(0, 95, 1200, 120, "left+right"), kpiChildren);
+    elements.push(grpKpi);
+    // Chart (left)
+    const chartDsName = input.dataSources.find(d => d.name.toUpperCase().includes("CHART"))?.name
+        || input.dataSources[0]?.name || "DS_CHART";
+    const chartMain = mkChart(generateId("Chart"), "CHART_MAIN", pos(5, 220, 595, 380, "left+bottom"), chartDsName);
+    elements.push(chartMain);
+    // Grid (right)
+    const gridCols = input.gridColumns
+        ? generateGridColumns({ columns: input.gridColumns }).columns
+        : [];
+    const gridDsName = input.dataSources.find(d => d.name.toUpperCase().includes("GRID"))?.name
+        || input.dataSources[input.dataSources.length > 1 ? 1 : 0]?.name || "DS_GRID";
+    const grdMain = mkDataGrid(generateId("DataGrid"), "GRD_MAIN", pos(605, 220, 590, 380, "left+right+bottom", "600,0,5,5"), gridCols, gridDsName);
+    elements.push(grdMain);
+    return { elements, warnings };
+}
+// ============================================================
+// 8. Main Entry
+// ============================================================
+export function generateReportTemplate(input) {
+    const warnings = [];
+    const reportCode = generateId("REP");
+    const formId = generateId("Form");
+    const title = input.title || input.reportName;
+    const moduleCode = input.moduleCode || "SD";
+    // --- DataSources ---
+    const dataSources = input.dataSources.map(ds => mkDataSource(ds.name, input.connection, ds.sql, ds.columns));
+    // --- Layout ---
+    let layoutResult;
+    switch (input.templateType) {
+        case "search-list":
+            layoutResult = buildSearchListLayout(input);
+            break;
+        case "crud":
+            layoutResult = buildCrudLayout(input);
+            break;
+        case "master-detail":
+            layoutResult = buildMasterDetailLayout(input);
+            break;
+        case "dashboard":
+            layoutResult = buildDashboardLayout(input);
+            break;
+        default:
+            layoutResult = buildSearchListLayout(input);
+            warnings.push(`알 수 없는 템플릿 타입 '${input.templateType}'. search-list로 대체합니다.`);
+    }
+    warnings.push(...layoutResult.warnings);
+    // --- Script ---
+    let script;
+    switch (input.templateType) {
+        case "search-list":
+            script = generateSearchListScript(input);
+            break;
+        case "crud":
+            script = generateCrudScript(input);
+            break;
+        case "master-detail":
+            script = generateMasterDetailScript(input);
+            break;
+        case "dashboard":
+            script = generateDashboardScript(input);
+            break;
+        default:
+            script = generateSearchListScript(input);
+    }
+    // --- MTSD ---
+    const mtsd = {
+        ReportInfo: {
+            ReportCode: reportCode,
+            FolderCode: "",
+            SavePath: `/${reportCode}.mtsd`,
+            ReportName: input.reportName,
+            Writer: "",
+            WriteDate: "",
+            Editor: "",
+            EditDate: "",
+            TabPosition: 0,
+            UsePersonalConditions: false,
+            DocumentVersion: "3.0.0.0",
+            RefreshType: 0,
+        },
+        DataSources: { Datas: dataSources },
+        ScriptText: "",
+        ServerScriptText: [],
+        Forms: [
+            {
+                Id: formId,
+                Name: "Form1",
+                Activated: true,
+                Visible: true,
+                LanguageCode: "",
+                Style: {
+                    Type: 0,
+                    BoxStyle: "",
+                    Background: emptyBg(),
+                    Border: emptyBorder(),
+                    Font: fullFont(),
+                },
+                Elements: layoutResult.elements,
+            },
+        ],
+        MetaDataSources: {
+            TemplateMeta: { TemplateName: "" },
+            MetaDataSources: [],
+        },
+        EXECUTION_PLANS: [],
+        Variables: [],
+        Modules: [],
+        ResponsiveLayout: [],
+        Langs: [],
+        WorkFlowModules: [],
+        WorkFlowInfo: "",
+    };
+    // --- SQL files ---
+    const sqlFiles = input.dataSources.map(ds => ({
+        name: ds.name,
+        sql: ds.sql,
+    }));
+    return {
+        mtsd,
+        script,
+        dataSources: sqlFiles,
+        reportInfo: {
+            ReportCode: reportCode,
+            ReportName: input.reportName,
+            ModuleCode: moduleCode,
+        },
+        warnings,
+    };
+}