@rchemist/listgrid 0.2.13 → 0.2.15

package/dist/listgrid/components/fields/InlineMapField.d.ts

@@ -9,6 +9,13 @@ import { RenderType } from '../../config/Config';
 interface InlineMapFieldProps extends FormFieldProps {
     config?: InlineMapConfig | undefined;
 }
+/**
+ * InlineMap 의 pendingRef.value 가 비어있는지 판정.
+ * - undefined / null → blank
+ * - Map / 객체 → entries 가 0개면 blank
+ * - 배열 (KeyValue[]) → 길이 0 이면 blank
+ */
+export declare function isInlineMapValueBlank(value: unknown): boolean;
 export declare class InlineMapField extends FormField<InlineMapField> {
     config?: InlineMapConfig | undefined;
     pendingRef: {
@@ -17,6 +24,14 @@ export declare class InlineMapField extends FormField<InlineMapField> {
     constructor(name: string, order: number, config?: InlineMapConfig);
     isDirty(): boolean;
     getSaveValue(entityForm: EntityForm, renderType?: RenderType): Promise<any>;
+    /**
+     * 사용자가 InlineMap UI 에서 입력한 값은 `pendingRef.current.value` 에 누적되며,
+     * `getSaveValue`/`isDirty` 시점에서야 form value 로 반영됩니다.
+     * 따라서 검증 단계의 `isBlank` 도 pendingRef 가 modified 된 경우에는
+     * pendingRef 값을 우선해서 봐야 합니다. 그렇지 않으면 사용자가 값을 입력했음에도
+     * "필수 값입니다" 검증에 막혀 저장이 차단됩니다.
+     */
+    isBlank(renderType?: RenderType): Promise<boolean>;
     /**
      * InlineMapField 핵심 렌더링 로직
      */

package/dist/listgrid/components/fields/InlineMapField.js

@@ -2,6 +2,27 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { FormField } from './abstract';
 import { InlineMap } from '../../ui';
 import { getInputRendererParameters } from '../helper/FieldRendererHelper';
+/**
+ * InlineMap 의 pendingRef.value 가 비어있는지 판정.
+ * - undefined / null → blank
+ * - Map / 객체 → entries 가 0개면 blank
+ * - 배열 (KeyValue[]) → 길이 0 이면 blank
+ */
+export function isInlineMapValueBlank(value) {
+    if (value === undefined || value === null) {
+        return true;
+    }
+    if (Array.isArray(value)) {
+        return value.length === 0;
+    }
+    if (value instanceof Map) {
+        return value.size === 0;
+    }
+    if (typeof value === 'object') {
+        return Object.keys(value).length === 0;
+    }
+    return false;
+}
 export class InlineMapField extends FormField {
     constructor(name, order, config) {
         super(name, order, 'inlineMap');
@@ -20,6 +41,20 @@ export class InlineMapField extends FormField {
         }
         return super.getSaveValue(entityForm, renderType);
     }
+    /**
+     * 사용자가 InlineMap UI 에서 입력한 값은 `pendingRef.current.value` 에 누적되며,
+     * `getSaveValue`/`isDirty` 시점에서야 form value 로 반영됩니다.
+     * 따라서 검증 단계의 `isBlank` 도 pendingRef 가 modified 된 경우에는
+     * pendingRef 값을 우선해서 봐야 합니다. 그렇지 않으면 사용자가 값을 입력했음에도
+     * "필수 값입니다" 검증에 막혀 저장이 차단됩니다.
+     */
+    async isBlank(renderType = 'create') {
+        if (this.pendingRef.current.modified) {
+            const pendingValue = this.pendingRef.current.value;
+            return isInlineMapValueBlank(pendingValue);
+        }
+        return super.isBlank(renderType);
+    }
     /**
      * InlineMapField 핵심 렌더링 로직
      */

package/dist/listgrid/transfer/Provider/ExcelProvider.js

@@ -64,10 +64,22 @@ export const ExcelDownload = async (props) => {
             }),
         ];
         let ws = XLSX.utils.aoa_to_sheet(aoaData);
+        const wb = XLSX.utils.book_new();
+        // 만약 skipHeader 가 false 라면 맨 처음 행을 제거한다.
+        if (!skipHeader) {
+            // 워크시트 데이터를 JSON으로 변환
+            const jsonData = XLSX.utils.sheet_to_json(ws, { header: 1 }); // header: 1 -> 배열 형태
+            // jsonData.shift(); // 첫 번째 행 제거
+            // jsonData로 새로운 워크시트 생성
+            ws = XLSX.utils.aoa_to_sheet(jsonData);
+        }
+        // 첫 두 행 스타일 적용
+        const range = XLSX.utils.decode_range(ws['!ref'] || 'A1');
         // 필드 정보를 이용해 셀 타입 및 서식 지정
+        // 워크시트 재생성(sheet_to_json -> aoa_to_sheet) 이후에 적용해야
+        // cell.t / cell.z 가 보존된다. 재생성 이전에 적용하면 라운드트립 과정에서 손실됨.
         if (props.fields && props.fields.length > 0) {
             const fieldMap = new Map(props.fields.map((f) => [f.getName(), f]));
-            const range = XLSX.utils.decode_range(ws['!ref'] || 'A1');
             for (let R = 1; R <= range.e.r; ++R) {
                 // 헤더 이후 데이터 행부터
                 for (let C = 0; C <= range.e.c; ++C) {
@@ -94,17 +106,6 @@ export const ExcelDownload = async (props) => {
                 }
             }
         }
-        const wb = XLSX.utils.book_new();
-        // 만약 skipHeader 가 false 라면 맨 처음 행을 제거한다.
-        if (!skipHeader) {
-            // 워크시트 데이터를 JSON으로 변환
-            const jsonData = XLSX.utils.sheet_to_json(ws, { header: 1 }); // header: 1 -> 배열 형태
-            // jsonData.shift(); // 첫 번째 행 제거
-            // jsonData로 새로운 워크시트 생성
-            ws = XLSX.utils.aoa_to_sheet(jsonData);
-        }
-        // 첫 두 행 스타일 적용
-        const range = XLSX.utils.decode_range(ws['!ref'] || 'A1');
         if (!skipHeader) {
             for (let C = range.s.c; C <= range.e.c; C++) {
                 const cell_address = XLSX.utils.encode_cell({ r: 0, c: C });

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@rchemist/listgrid",
-    "version": "0.2.13",
+    "version": "0.2.15",
     "private": false,
     "description": "Framework-free React CRUD UI engine — primitive-based design system, data-attr theming, and a full list/form renderer for RCM-framework-style entity backends.",
     "keywords": [