@rchemist/listgrid 0.2.14 → 0.3.1

package/dist/listgrid/config/EntityForm.js

@@ -368,10 +368,17 @@ export class EntityForm extends EntityFormExtensions {
             result.errors = ['삭제할 대상이 없습니다.'];
             return result;
         }
-        const url = `${this.getUrl()}/delete`;
-        const formData = {};
-        formData['revisionEntityName'] = this.getRevisionEntityName();
-        formData['ids'] = idList;
+        // v0.3.0+ — rcm-framework 0.1.0 endpoint 표준 (Decision #31).
+        // bulk delete = DELETE {url} + RequestBody BulkDeleteRequest{ids,revisionEntityName?}.
+        // RFC 9110 *서버 명시 지원* 영역. 0.1.0 baseline (axios 최신) 자연 지원.
+        const url = this.getUrl();
+        const formData = {
+            ids: idList,
+        };
+        const revisionEntityName = this.getRevisionEntityName();
+        if (revisionEntityName) {
+            formData['revisionEntityName'] = revisionEntityName;
+        }
         const response = await getExternalApiDataWithError({
             url: url,
             method: 'DELETE',
@@ -525,7 +532,10 @@ export class EntityForm extends EntityFormExtensions {
             return { actionType: renderType, entityForm: form.withErrors(submitFormData.errors), errors };
         }
         else {
-            const targetUrl = renderType === 'create' ? `${this.getUrl()}/add` : `${this.getUrl()}/${this.id}`;
+            // v0.3.0+ — rcm-framework 0.1.0 endpoint 표준 (Decision #31).
+            //   create = POST {url}        (was POST {url}/add in 0.0.5 line)
+            //   update = PUT  {url}/{id}   (unchanged)
+            const targetUrl = renderType === 'create' ? this.getUrl() : `${this.getUrl()}/${this.id}`;
             const method = renderType === 'create' ? 'POST' : 'PUT';
             // 서버 extension 처리를 위한 헤더 추가
             const extensionPoint = renderType === 'create' ? ExtensionPoint.PRE_CREATE : ExtensionPoint.PRE_UPDATE;

package/dist/listgrid/form/Type.js

@@ -30,8 +30,10 @@ export class PageResult {
             /**
              * 만약 serverSide가 true 라면 넘어 온 url 을 파라미터로 포함해 내부 프록시 api 를 호출하고 그 결과를 response 로 받는다.
              */
+            // v0.3.0+ — rcm-framework 0.1.0 endpoint 표준 (Decision #31).
+            // 검색은 POST {url}/search (RequestBody SearchRequest). underscore prefix 거부.
             const response = await callExternalHttpRequest({
-                url: url,
+                url: `${url}/search`,
                 method: 'POST',
                 formData: searchForm,
                 ...(extensionOptions?.entityFormName !== undefined
@@ -61,7 +63,12 @@ export class PageResult {
                 }
                 return PageResult.createEmptyResult(searchForm).withErrors(response.error ?? '데이터 로딩 중 오류가 발생했습니다.');
             }
-            const newSearchForm = SearchForm.deserialize(response.data.searchForm);
+            // v0.3.0+ — server echo 호환:
+            //   0.0.5 line: response.data.searchForm (deserialize)
+            //   0.1.0 line (Decision #31 SearchResponse): response.data.searchRequest (echo only)
+            // 둘 다 없으면 client 가 보낸 원본 searchForm 보존 (page/pageSize/sorts/filters 유지).
+            const echoForm = response.data.searchForm ?? response.data.searchRequest;
+            const newSearchForm = echoForm ? SearchForm.deserialize(echoForm) : searchForm;
             if (searchForm.hasPreservedFilters()) {
                 searchForm.getPreservedFilters().forEach((filter) => {
                     if (isTrue(filter.remove)) {
@@ -75,16 +82,19 @@ export class PageResult {
                     }
                 });
             }
-            // list 또는 content 필드 확인
+            // list (0.0.5) 또는 content (Spring Data Page<T> / SearchResponse 0.1.0) 흡수.
             const listData = response.data.list || response.data.content || [];
             const responseList = listData.map((item) => ({
                 ...item,
                 id: String(item.id), // id를 문자열로 강제 변환
             }));
+            // pagination 메타: totalCount/totalPage (0.0.5) 또는 totalElements/totalPages (0.1.0).
+            const totalCount = response.data.totalCount ?? response.data.totalElements ?? 0;
+            const totalPage = response.data.totalPage ?? response.data.totalPages ?? 0;
             return new PageResult({
                 list: responseList,
-                totalCount: response.data.totalCount,
-                totalPage: response.data.totalPage,
+                totalCount,
+                totalPage,
                 searchForm: newSearchForm,
             });
         }

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.14",
+    "version": "0.3.1",
     "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": [