@vmscloud/moz-ui-grid-vue 0.1.41 → 0.2.1

package/dist/locale/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * grid-vue 자체 locale — 엑셀 업로드 팝업·엑셀 스토어·타임아웃 매니저가 쓰는 `Grid.*` 문자열 부분집합.
+ *
+ * 원본: 레거시 UI 컴포넌트 패키지(GitHub Packages 전용)의 `src/shared/locale/{ko,en,ja,zh}.ts` 중 `Grid` 절.
+ * 그 패키지의 `useMozLocale`(Symbol inject) 을 더 이상 쓰지 않기 위해
+ * 필요한 키만 복제했다(ITSM-2026-002564). 원본 사전에 없던 키(clientExcelImport, importMode*,
+ * conflict*, clientExcelImportProgress)는 옛 SFC 의 한국어 리터럴을 ko 로 두고 나머지 언어를 새로 채웠다.
+ *
+ * 언어 선택은 `MozGrid` 의 `locale` prop 이 결정한다(wrapper 의 GridChrome 과 같은 create-time 단일 값).
+ * 모듈 수준 단일 사전이며 기본은 ko.
+ */
+export type GridVueLocaleCode = 'ko' | 'en' | 'ja' | 'zh';
+export interface GridVueLocaleMessages {
+    clientExcelImport: string;
+    clientExcelImportProgress: string;
+    importMode: string;
+    importModeReplace: string;
+    importModeAppend: string;
+    importModeUpsert: string;
+    conflictStrategy: string;
+    conflictError: string;
+    conflictSkip: string;
+    conflictUpdate: string;
+    excelInvalidExcel: string;
+    overwriteSelected: string;
+    dropHerePrefix: string;
+    dropHereMiddle: string;
+    dropHereSuffix: string;
+    click: string;
+    drag: string;
+    check: string;
+    cancel: string;
+    alreadyExcelProgress: string;
+    downloadFail: string;
+    toastSaveSuccess: string;
+    toastSaveError: string;
+    requestTimedOut: string;
+}
+export declare const koKR: GridVueLocaleMessages;
+export declare const enUS: GridVueLocaleMessages;
+export declare const jaJP: GridVueLocaleMessages;
+export declare const zhCN: GridVueLocaleMessages;
+/** `'en-US'`, `'ja'`, `'zh-CN'` 같은 코드를 지원 언어로 정규화. 모르는 값은 ko. */
+export declare function normalizeGridVueLocale(locale: string | undefined | null): GridVueLocaleCode;
+/** 현재 언어를 바꾼다. `MozGrid` 가 `locale` prop 으로 호출한다. undefined 는 ko. */
+export declare function setGridVueLocale(locale?: string | null): GridVueLocaleCode;
+export declare function getGridVueLocaleCode(): GridVueLocaleCode;
+/** 현재 언어의 문자열 사전. */
+export declare function getGridVueLocale(): GridVueLocaleMessages;

package/dist/{legacy/store → store}/index.d.ts

@@ -8,9 +8,9 @@ export declare const useExcelStore: import('pinia').StoreDefinition<"excelPopup"
     showPopup: import('vue').Ref<boolean, boolean>;
     isOverwrite: import('vue').Ref<boolean, boolean>;
     exportFormat: import('vue').Ref<import('./excelStore').ExcelFormat, import('./excelStore').ExcelFormat>;
-    excelInfo: import('vue').Ref<import('../types').IExcelInfo, import('../types').IExcelInfo>;
-    excelAPI: import('vue').Ref<import('../types').IExcelAPI, import('../types').IExcelAPI>;
-    file: import('vue').Ref<import('../types').FileParameter | null, import('../types').FileParameter | null>;
+    excelInfo: import('vue').Ref<import('..').IExcelInfo, import('..').IExcelInfo>;
+    excelAPI: import('vue').Ref<import('..').IExcelAPI, import('..').IExcelAPI>;
+    file: import('vue').Ref<import('..').FileParameter | null, import('..').FileParameter | null>;
     excelFileMap: Map<string, string>;
     downloadInfo: import('vue').Ref<{
         current?: number | undefined;
@@ -29,14 +29,14 @@ export declare const useExcelStore: import('pinia').StoreDefinition<"excelPopup"
         fileName?: string | undefined;
         notiDatetime?: string | undefined;
     } | null>;
-    initialize: (info?: import('../types').IExcelInfo, api?: import('../types').IExcelAPI) => void;
-    setInfo: (info: import('../types').IExcelInfo) => void;
+    initialize: (info?: import('..').IExcelInfo, api?: import('..').IExcelAPI) => void;
+    setInfo: (info: import('..').IExcelInfo) => void;
     newExcelInfo: (gridKeys: string[], flexGrid: any) => {
-        keyColumns: import('../types').IExcelInfo["keyColumns"];
-        columnLayout: import('../types').IExcelInfo["columnLayout"];
-        columnMap: import('../types').IExcelInfo["columnMap"];
+        keyColumns: import('..').IExcelInfo["keyColumns"];
+        columnLayout: import('..').IExcelInfo["columnLayout"];
+        columnMap: import('..').IExcelInfo["columnMap"];
     };
-    setAPI: (api: import('../types').IExcelAPI) => void;
+    setAPI: (api: import('..').IExcelAPI) => void;
     newExcelApi: (apiKey: string, flexGrid: any, sampleData: Record<string, string>[], fileName: string, refreshCB: () => void, excelUpload: (param?: any, method?: "post") => Promise<any>, autoTransaction: (config: {
         url: string;
         param?: any;
@@ -68,13 +68,13 @@ export declare const useExcelStore: import('pinia').StoreDefinition<"excelPopup"
     registerRefresh: (apiKey: string, cb: () => void) => void;
     unregisterRefresh: (apiKey: string) => void;
     triggerRefreshBySession: (sessionId: string) => boolean;
-}, "file" | "showPopup" | "isOverwrite" | "targetTable" | "exportFormat" | "excelInfo" | "excelAPI" | "excelFileMap" | "downloadInfo">, Pick<{
+}, "file" | "targetTable" | "showPopup" | "isOverwrite" | "exportFormat" | "excelInfo" | "excelAPI" | "excelFileMap" | "downloadInfo">, Pick<{
     showPopup: import('vue').Ref<boolean, boolean>;
     isOverwrite: import('vue').Ref<boolean, boolean>;
     exportFormat: import('vue').Ref<import('./excelStore').ExcelFormat, import('./excelStore').ExcelFormat>;
-    excelInfo: import('vue').Ref<import('../types').IExcelInfo, import('../types').IExcelInfo>;
-    excelAPI: import('vue').Ref<import('../types').IExcelAPI, import('../types').IExcelAPI>;
-    file: import('vue').Ref<import('../types').FileParameter | null, import('../types').FileParameter | null>;
+    excelInfo: import('vue').Ref<import('..').IExcelInfo, import('..').IExcelInfo>;
+    excelAPI: import('vue').Ref<import('..').IExcelAPI, import('..').IExcelAPI>;
+    file: import('vue').Ref<import('..').FileParameter | null, import('..').FileParameter | null>;
     excelFileMap: Map<string, string>;
     downloadInfo: import('vue').Ref<{
         current?: number | undefined;
@@ -93,14 +93,14 @@ export declare const useExcelStore: import('pinia').StoreDefinition<"excelPopup"
         fileName?: string | undefined;
         notiDatetime?: string | undefined;
     } | null>;
-    initialize: (info?: import('../types').IExcelInfo, api?: import('../types').IExcelAPI) => void;
-    setInfo: (info: import('../types').IExcelInfo) => void;
+    initialize: (info?: import('..').IExcelInfo, api?: import('..').IExcelAPI) => void;
+    setInfo: (info: import('..').IExcelInfo) => void;
     newExcelInfo: (gridKeys: string[], flexGrid: any) => {
-        keyColumns: import('../types').IExcelInfo["keyColumns"];
-        columnLayout: import('../types').IExcelInfo["columnLayout"];
-        columnMap: import('../types').IExcelInfo["columnMap"];
+        keyColumns: import('..').IExcelInfo["keyColumns"];
+        columnLayout: import('..').IExcelInfo["columnLayout"];
+        columnMap: import('..').IExcelInfo["columnMap"];
     };
-    setAPI: (api: import('../types').IExcelAPI) => void;
+    setAPI: (api: import('..').IExcelAPI) => void;
     newExcelApi: (apiKey: string, flexGrid: any, sampleData: Record<string, string>[], fileName: string, refreshCB: () => void, excelUpload: (param?: any, method?: "post") => Promise<any>, autoTransaction: (config: {
         url: string;
         param?: any;
@@ -136,9 +136,9 @@ export declare const useExcelStore: import('pinia').StoreDefinition<"excelPopup"
     showPopup: import('vue').Ref<boolean, boolean>;
     isOverwrite: import('vue').Ref<boolean, boolean>;
     exportFormat: import('vue').Ref<import('./excelStore').ExcelFormat, import('./excelStore').ExcelFormat>;
-    excelInfo: import('vue').Ref<import('../types').IExcelInfo, import('../types').IExcelInfo>;
-    excelAPI: import('vue').Ref<import('../types').IExcelAPI, import('../types').IExcelAPI>;
-    file: import('vue').Ref<import('../types').FileParameter | null, import('../types').FileParameter | null>;
+    excelInfo: import('vue').Ref<import('..').IExcelInfo, import('..').IExcelInfo>;
+    excelAPI: import('vue').Ref<import('..').IExcelAPI, import('..').IExcelAPI>;
+    file: import('vue').Ref<import('..').FileParameter | null, import('..').FileParameter | null>;
     excelFileMap: Map<string, string>;
     downloadInfo: import('vue').Ref<{
         current?: number | undefined;
@@ -157,14 +157,14 @@ export declare const useExcelStore: import('pinia').StoreDefinition<"excelPopup"
         fileName?: string | undefined;
         notiDatetime?: string | undefined;
     } | null>;
-    initialize: (info?: import('../types').IExcelInfo, api?: import('../types').IExcelAPI) => void;
-    setInfo: (info: import('../types').IExcelInfo) => void;
+    initialize: (info?: import('..').IExcelInfo, api?: import('..').IExcelAPI) => void;
+    setInfo: (info: import('..').IExcelInfo) => void;
     newExcelInfo: (gridKeys: string[], flexGrid: any) => {
-        keyColumns: import('../types').IExcelInfo["keyColumns"];
-        columnLayout: import('../types').IExcelInfo["columnLayout"];
-        columnMap: import('../types').IExcelInfo["columnMap"];
+        keyColumns: import('..').IExcelInfo["keyColumns"];
+        columnLayout: import('..').IExcelInfo["columnLayout"];
+        columnMap: import('..').IExcelInfo["columnMap"];
     };
-    setAPI: (api: import('../types').IExcelAPI) => void;
+    setAPI: (api: import('..').IExcelAPI) => void;
     newExcelApi: (apiKey: string, flexGrid: any, sampleData: Record<string, string>[], fileName: string, refreshCB: () => void, excelUpload: (param?: any, method?: "post") => Promise<any>, autoTransaction: (config: {
         url: string;
         param?: any;

package/dist/store.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"}),require("pinia");const e=require("./chunks/index-D5KJLBGW.cjs");exports.dataTypeToString=e.dataTypeToString,exports.useExcelDownloadStore=e.useExcelDownloadStore,exports.useExcelStore=e.useExcelStore,exports.useExcelUploadStore=e.useExcelUploadStore;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"}),require("pinia");const e=require("./chunks/index-BLDAzbGv.cjs");exports.dataTypeToString=e.dataTypeToString,exports.useExcelDownloadStore=e.useExcelDownloadStore,exports.useExcelStore=e.useExcelStore,exports.useExcelUploadStore=e.useExcelUploadStore;

package/dist/store.js

@@ -1,8 +1,8 @@
 import "pinia";
-import { d, u, a, b } from "./chunks/index-BDQ0HlwR.js";
+import { h, u, c, d } from "./chunks/index-2qnzL9Zm.js";
 export {
-  d as dataTypeToString,
+  h as dataTypeToString,
   u as useExcelDownloadStore,
-  a as useExcelStore,
-  b as useExcelUploadStore
+  c as useExcelStore,
+  d as useExcelUploadStore
 };

package/dist/stories/FieldId.stories.d.ts

@@ -50,7 +50,7 @@ export declare const Flat: Story;
 /**
  * ## 행 그룹 — 그룹 컬럼과 소계가 `id` 로 지목된다
  *
- * `rowGroup.columns` 와 `subtotals` 는 **컬럼 식별자**로 지정한다.
+ * `rowGroup.columns` 와 `aggregates[].column` 은 **컬럼 식별자**로 지정한다.
  * 소계는 `amount_krw` 하나에만 걸어 두었다.
  *
  * ### 확인할 것

package/dist/stories/FooterAggregateDiagnosis.stories.d.ts

@@ -0,0 +1,17 @@
+import { Meta, StoryObj } from '@storybook/vue3';
+import { default as MozGrid } from '../MozGrid.vue';
+/**
+ * [진단용] ITSM-2026-002455 — Ctrl+Space 푸터 값 vs 드래그 선택 푸터 값 불일치.
+ *
+ * 필터가 걸린 상태에서 같은 컬럼을 Ctrl+Space 로 고를 때와 드래그로 고를 때
+ * wrapper 푸터(평균/개수/최소/최대/합계)의 값이 달라지는지 확인한다.
+ *
+ * 데이터: salary = 100..500 (5행). dept 가 Y 인 2행(200, 400)을 필터로 제외하면
+ * 화면에는 100 / 300 / 500 세 행만 남는다.
+ *
+ * 기대(화면 기준): 합계 900, 개수 3, 평균 300
+ */
+declare const meta: Meta<typeof MozGrid>;
+export default meta;
+type Story = StoryObj<typeof MozGrid>;
+export declare const CtrlSpaceVsDrag: Story;

package/dist/stories/FooterAggregatePivot.stories.d.ts

@@ -0,0 +1,37 @@
+import { Meta, StoryObj } from '@storybook/vue3';
+import { default as MozGrid } from '../MozGrid.vue';
+/**
+ * 선택 방식과 무관하게 푸터 집계가 같아야 한다 — ITSM-2026-002455.
+ *
+ * ## 제보
+ *
+ * 피벗 그리드(스마트리포트)에서 값 컬럼을 **Ctrl+Space** 로 고른 뒤 푸터를 보면
+ * `개수: 1`, 최소·최대·합계가 전부 평균과 같은 값으로 나왔다. 같은 컬럼을
+ * **드래그**로 고르면 `개수: 25`, 합계 39,955.76 처럼 정상으로 보였다.
+ *
+ * ## 원인 (요약)
+ *
+ * `selectionAggregates()` 는 "선택 영역 집계" 하나의 계약인데, 선택 방식마다 서로 다른
+ * 의미의 값을 같은 타입에 담아 돌려주고 있었다.
+ *
+ * | 경로 | 읽던 소스 | 증상 |
+ * |---|---|---|
+ * | 피벗 Ctrl+Space | 컬럼 총합계 스칼라 1개 | `개수: 1`, min=max=sum=avg |
+ * | 플랫 Ctrl+Space | 소스 배열(필터 무시) | 필터로 숨긴 행이 합산 |
+ * | Ctrl+A | 위와 같은 분기 | 동일 |
+ * | 드래그 | 뷰포트에 fetch 된 행만 | 화면 밖 선택 행 누락 |
+ *
+ * 지금은 네 경로 모두 **선택된 셀들의 집계**로 통일돼 있다. 컬럼 전체 선택은 여전히
+ * 셀을 순회하지 않는다(엔진 집계 사용) — 최적화는 유지된다.
+ *
+ * ## 확인 방법
+ *
+ * 1. 값 컬럼(`이익`)을 **드래그**로 전부 선택 → 푸터의 개수·합계를 기억한다.
+ * 2. 같은 컬럼의 셀 하나를 클릭한 뒤 **Ctrl+Space** → 푸터가 **같은 값**이어야 한다.
+ * 3. `필터 적용` 을 누르고 1~2 를 반복 → 숨긴 행이 합산되지 않아야 한다.
+ * 4. `현재 집계 측정` 은 푸터가 읽는 값과 내부 상태를 함께 찍는다.
+ */
+declare const meta: Meta<typeof MozGrid>;
+export default meta;
+type Story = StoryObj<typeof MozGrid>;
+export declare const PivotCtrlSpaceVsDrag: Story;

package/dist/stories/MergedCellCopy.stories.d.ts

@@ -0,0 +1,58 @@
+import { Meta, StoryObj } from '@storybook/vue3';
+import { default as MozGrid } from '../MozGrid.vue';
+/**
+ * 플랫 그리드 병합 셀 복사 — ITSM-2026-002315.
+ *
+ * ## 무엇을 확인하는 스토리인가
+ *
+ * 병합된 셀을 복사하면 블록 하나가 **자기 크기(rowSpan × colSpan)만큼 반복 출력**되던
+ * 결함을 눈으로 재확인하기 위한 것이다. 세로 2행 병합을 고르면 같은 값이 두 줄,
+ * 두 열이 같은 범위로 병합돼 있으면 블록이 통째로 두 번 나왔다.
+ *
+ * ## 고친 뒤의 규칙 — Excel / Google Sheets / Handsontable 과 동일
+ *
+ * 병합 블록은 **앵커(좌상단)에서 한 번만** 값을 내고, 나머지 멤버 자리는 빈 칸으로 둔다.
+ * Handsontable 문서 표현으로는 "keeps only the upper-left value ... and clears other values".
+ * 선택 격자의 행 × 열 모양 자체는 그대로 유지되므로 Excel 에 붙여넣으면 화면에서 보던
+ * 레이아웃이 그대로 재현된다.
+ *
+ * ## 조작 방법
+ *
+ * 1. `부서` / `팀` 열의 병합된 셀을 포함해 범위를 드래그한다.
+ *    (병합 셀을 건드리면 선택은 항상 블록 전체로 확장된다 — Excel 과 같은 동작.)
+ * 2. `복사 결과 보기` 를 누른다. 클립보드로 나가는 TSV 원문이 아래 상자에 뜬다.
+ *    탭은 `→`, 줄바꿈은 `↵` 로 치환해 경계를 눈으로 셀 수 있게 했다.
+ * 3. 병합 블록이 걸친 행 수만큼 값이 반복되지 않고 **첫 행에만** 있는 것을 확인한다.
+ *
+ * `Ctrl+C` 도 같은 경로를 쓴다. 버튼은 클립보드 권한 없이도 결과를 볼 수 있게 한 것뿐이다.
+ *
+ * ## 데이터 구성
+ *
+ * 병합 경계를 눈으로 세기 쉽도록 고정값이며, **열마다 병합 단위가 다르게** 짰다.
+ *
+ * | 행 | 부서 | 팀 | 이름 |
+ * |---|---|---|---|
+ * | 0 | Engineering (3행 병합) | Frontend (2행 병합) | 김철수 |
+ * | 1 | 〃 | 〃 | 이영희 |
+ * | 2 | 〃 | Backend | 박민수 |
+ * | 3 | Design (2행 병합) | UI (2행 병합) | 정수진 |
+ * | 4 | 〃 | 〃 | 최동현 |
+ *
+ * 전체(0~4행 × 4열)를 선택해 복사하면 기대 결과는 이렇다 —
+ * 병합된 자리가 빈 칸이고, 비병합 열(`이름`·`급여`)은 행마다 값이 그대로 나온다.
+ *
+ * ```
+ * Engineering → Frontend → 김철수 → 52000 ↵
+ *             →          → 이영희 → 61000 ↵
+ *             → Backend  → 박민수 → 58000 ↵
+ * Design      → UI       → 정수진 → 47000 ↵
+ *             →          → 최동현 → 49000
+ * ```
+ */
+declare const meta: Meta<typeof MozGrid>;
+export default meta;
+type Story = StoryObj<typeof MozGrid>;
+/**
+ * 세로 병합 · 열마다 다른 병합 단위 — 앵커에서만 값이 나오는지 확인한다.
+ */
+export declare const FlatMergedCopy: Story;

package/dist/stories/Pivot900Rows.stories.d.ts

@@ -0,0 +1,40 @@
+import { Meta, StoryObj } from '@storybook/vue3';
+import { default as MozGrid } from '../MozGrid.vue';
+/**
+ * 900행 피벗 — 표시 행이 뷰포트보다 훨씬 긴 피벗 그리드.
+ *
+ * ## 왜 이 크기인가
+ *
+ * 기존 피벗 스토리는 행이 한 화면에 다 들어오거나(`Grid/MozGrid > Basic`) 반대로
+ * 수십만~5백만 행이라(`Large Pivot`, `Performance/LargeData`) 성능 측정용에 가깝다.
+ * 그 사이가 비어 있어서, **"가상 스크롤이 실제로 돌지만 눈으로 전수 확인은 가능한"**
+ * 크기의 피벗을 따로 둔다.
+ *
+ * 이 크기에서만 드러나는 것들이 있다.
+ *
+ * - 화면에 렌더된 행과 실제 표시 행 수가 크게 벌어진다 → 뷰포트 밖 행을 읽어야 하는
+ *   기능(선택 집계·복사·내보내기)이 화면에 보이는 것만 처리하고 있지 않은지.
+ * - 행 헤더 병합(지점)이 스크롤 경계를 여러 번 가로지른다 → 스크롤 중 병합 셀 렌더/선택.
+ * - 스크롤을 한참 내린 뒤의 N번째 행에서 재현되는 결함. 첫 화면만 보면 놓친다.
+ *
+ * ## 구성
+ *
+ * | | |
+ * |---|---|
+ * | 원본 행 | 3,600 (지점 300 × 제품 3 × 분기 4) |
+ * | 피벗 표시 행 | **900** (지점 × 제품) |
+ * | 값 컬럼 | 4 (분기별 매출 합계) |
+ *
+ * 값은 난수가 아니라 인덱스로 만든 고정값이다 — 스토리를 다시 열어도 같은 숫자가
+ * 나와야 "이 셀이 이 값이어야 한다"를 근거로 말할 수 있다.
+ */
+declare const meta: Meta<typeof MozGrid>;
+export default meta;
+type Story = StoryObj<typeof MozGrid>;
+/**
+ * 지점 × 제품 = 900행, 분기 4열.
+ *
+ * 스크롤을 끝까지 내리면 `지점 300 / 전자` 가 마지막 행이다. 지점 열은 제품 3행마다
+ * 세로 병합되므로, 스크롤 경계에서 병합 셀이 끊기지 않는지도 함께 보인다.
+ */
+export declare const Rows900: Story;

package/dist/stories/PivotReactiveProxy.stories.d.ts

@@ -0,0 +1,118 @@
+import { Meta, StoryObj } from '@storybook/vue3';
+/**
+ * 피벗 lazy proxy × 외부 deep-reactive 충돌 (ITSM-2026-002533)
+ *
+ * ✅ **이 결함은 수정되었다.** 이 스토리는 이제 **회귀 감시용**이다 — 모든 버튼이 초록(정상)
+ * 이어야 한다. 하나라도 빨강(❌)이 나오면 `createLazyPivotRow` 의 보호가 되돌아간 것이다.
+ *
+ * 수정 커밋 기준 실측(Storybook 실브라우저): ①②③ 및 래퍼 경유 A~D 전부 `region 5/5`,
+ * `product 25/25` 정상. 수정 전에는 ②·C·D 에서 `0/25`(전부 빈 셀)였다.
+ *
+ * ---
+ * ### 증상 (수정 전)
+ *
+ * 피벗 모드에서 **행 필드(rowHeader) 셀만** 비어 보이고 값 셀은 정상. 가로로 스크롤하면
+ * 그제서야 값이 나타난다.
+ *
+ * ### 원인
+ *
+ * `createLazyPivotRow`(moz-ui-grid-core `processor/pivotUtils.ts`)의 `get` trap 종단이
+ * 모르는 키를 **무조건 `pivotRow.values` 에게 되물었다**:
+ *
+ * ```ts
+ * return values[prop];        // ← 수정 전: 선언하지 않은 키까지 위임
+ * ```
+ *
+ * grid 가 Vue deep reactive 안에 들어가면 `pivotRow.values` 도 reactive proxy 가 된다.
+ * 그 상태에서 Vue 가 행 객체에게 내부 예약 키를 물으면 lazy proxy 가 `values` 의 답을
+ * 그대로 돌려준다:
+ *
+ * ```
+ * lazyRow['__v_isReactive'] → values['__v_isReactive'] → true       (거짓 자백)
+ * lazyRow['__v_raw']        → values['__v_raw']        → values 원본
+ * ⇒ Vue 는 "이 행은 이미 reactive 고 원본은 values 다" 라 판단해 행을 values 로 교체
+ * ```
+ *
+ * `values` 에는 **rowHeaders(=행 필드)와 `__nodeId` 가 없다.** 그래서 그 컬럼만
+ * `undefined` 가 되어 빈 셀이 된다. 값 컬럼은 `values` 안에 있으니 멀쩡했다 — 이것이
+ * "행 필드만 비는" 이유다.
+ *
+ * **가로 스크롤에서 살아나던 이유**: 행 필드는 `pinned:'left'` 라 최초 1회 칠해진 뒤
+ * `Row.renderCells` 의 Fast-Path(`meta.value === value`)에 걸려 재렌더를 건너뛴다. 가로
+ * 스크롤은 `renderedLeft`/`renderedWidth` 를 바꿔 그 조건을 깨므로 다시 칠해졌다.
+ *
+ * ### 수정 (core)
+ *
+ * ```ts
+ * if (Object.prototype.hasOwnProperty.call(values, prop)) return values[prop];
+ * return undefined;   // 선언한 키 집합 밖은 스스로 undefined 로 답한다
+ * ```
+ *
+ * `ownKeys` trap 이 `Object.keys`(own+enumerable) 기준이라 이 술어와 정확히 동치다.
+ * **특정 프레임워크의 마커 이름에 의존하지 않으므로** Vue·MobX·Solid 어디서도 안전하다.
+ * 같은 커밋에서 `set`/`deleteProperty` trap 부재로 기존 키 덮어쓰기가 유실되던 별개
+ * 결함도 함께 고쳤다.
+ *
+ * ### 소비처 영향: 없음
+ *
+ * 공개 API·설정·타입 변경 없음. 소비처가 고칠 것은 없다. 다만 grid 인스턴스를 deep
+ * reactive 에 보관하는 것은 여전히 권장되지 않는다(행마다 불필요한 reactive 변환 비용).
+ * `shallowRef`/`markRaw` 사용을 권한다.
+ *
+ * ⚠️ **콘솔 경고는 신뢰할 수 없었다.** 구 `warnReactiveWrapOnce` 는 `receiver !== proxy` 로
+ * 감지했는데, 행 객체가 이미 `values` 로 치환된 뒤에는 lazy proxy 를 아예 거치지 않아
+ * 경고가 **한 번도 안 뜬 채** 증상이 났다. 이 수정에서 해당 감지 로직은 제거되었다
+ * (보호가 구조적으로 보장되므로 경고 자체가 불필요해졌다).
+ *
+ * ---
+ * ### 사용법 (회귀 감시)
+ * 1. `[① raw 인스턴스로 생성]` — 정상이어야 한다.
+ * 2. `[② reactive(grid) 로 생성]` — **정상이어야 한다** (수정 전 재현 지점).
+ * 3. `[③ 가로 스크롤 흔들기]` — 정상 유지.
+ */
+declare const meta: Meta;
+export default meta;
+type Story = StoryObj;
+export declare const RowFieldCellsGoBlank: Story;
+/**
+ * **소비처 실제 패턴 재현** — 스마트리포트 `SmartReportComponentMozPivot.vue`
+ *
+ * 실측으로 확인한 재현 조건은 `reactive(grid)` 를 직접 부르는 것이 아니라,
+ * **`@ready` 로 받은 인스턴스를 deep `ref` 에 보관하고 그 참조로 API 를 부르는 것**이다.
+ *
+ * ```ts
+ * // plugin-systems/smart-report/.../SmartReportComponentMozPivot.vue:433
+ * const gridInstance = ref<any>(null);          // ← deep ref (shallowRef 아님)
+ * const onReady = (grid: any) => { gridInstance.value = grid; };
+ * // 이후 ConfigManager/pivotConfigModule 등이 gridInstance.value 로 API 호출
+ * ```
+ *
+ * `ref()` 는 대입되는 객체를 `reactive()` 로 변환하므로 `gridInstance.value` 는 프록시다.
+ * 같은 파일이 `mozGridRef` 도 `ref` 로 잡고 `defineExpose` 로 외부에 노출하므로
+ * 상위 컴포넌트(DataInterface/ConfigManager)에서도 같은 프록시 경로를 탄다.
+ *
+ * ### [사실] 실측 — 수정 전 코드 기준 (jsdom, 30행 피벗)
+ *
+ * | 보관 방식 | `isReactive` | 초기 렌더 | `api.refresh()` 후 |
+ * |---|---|---|---|
+ * | `shallowRef(grid)` | false | region 3/3, product 15/15 | **3/3, 15/15** 정상 |
+ * | **`ref(grid)`** (스마트리포트) | **true** | region 3/3, product 15/15 | **0/3, 0/15** ❌ |
+ *
+ * **초기 렌더는 정상이고 재렌더에서 무너진다** — 제보의 "메뉴 진입 시 데이터가 표현되지
+ * 않는다" 및 "가로 스크롤하면 나온다" 와 일치한다.
+ *
+ * 레포의 다른 스토리들이 이 결함을 못 잡았던 이유도 여기 있다 — 전부 `shallowRef` 를
+ * 쓴다(`grep 'coreConfig = ' src/stories/` 기준 전건). 소비처만 `ref` 였다.
+ *
+ * ### 수정 후
+ *
+ * 두 방식 모두 `region 3/3, product 15/15` 정상. 소비처가 코드를 고칠 필요는 없다.
+ * 다만 `shallowRef` 가 여전히 권장된다 — 행마다 불필요한 reactive 변환 비용이 없다.
+ *
+ * ### 사용법 (회귀 감시)
+ * 1. `[A] ref 에 보관만` — 정상.
+ * 2. `[B] rx.loadData + rx.refresh` — 정상.
+ * 3. `[C] rx.refresh() 단독` — **정상이어야 한다** (수정 전 재현 지점).
+ * 4. `[D] rx.sort()` — **정상이어야 한다** (수정 전 재현 지점).
+ */
+export declare const ViaMozGridWrapper: Story;

package/dist/stories/PivotSettingsPermissions.stories.d.ts

@@ -0,0 +1,6 @@
+import { Meta, StoryObj } from '@storybook/vue3';
+import { default as MozGrid } from '../MozGrid.vue';
+declare const meta: Meta<typeof MozGrid>;
+export default meta;
+type Story = StoryObj<typeof MozGrid>;
+export declare const Disabled: Story;

package/dist/stories/RowGroupAggregates.stories.d.ts

@@ -0,0 +1,57 @@
+import { Meta, StoryObj } from '@storybook/vue3';
+import { default as MozGrid } from '../MozGrid.vue';
+/**
+ * 행 그룹 집계 — `rowGroupConfig.aggregates` 와 레벨별 `scope` (ITSM-2026-002417).
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * 설정 모양
+ * ─────────────────────────────────────────────────────────────────────────────
+ * ```ts
+ * rowGroupConfig: {
+ *   columns: ['department', 'team'],
+ *   aggregates: [
+ *     { column: 'salary', func: 'sum', scope: ['department'] },
+ *     { column: 'salary', func: 'avg', scope: ['department', 'team'] },
+ *     { column: 'id',     func: 'count' },
+ *   ],
+ * }
+ * ```
+ *
+ * - **항목 하나 = 그룹행의 한 자리.** 같은 컬럼에 함수가 여럿 필요하면 항목을 여럿 둔다.
+ * - `func` 는 **항상 명시**한다. (구 `subtotals` 는 컬럼 id 만 담고 함수를 필드의
+ *   `aggregate` 에서 빌려왔는데, 없으면 조용히 `'sum'` 으로 떨어져 문자열 컬럼에
+ *   이상한 값이 나왔다.)
+ * - `scope` 는 **그룹 컬럼 id 경로**다. 배열 인덱스가 아니라 경로인 이유는 사용자가
+ *   그룹 기준을 재정렬해도 설정이 컬럼을 따라가야 하기 때문이다. 생략하면 전 레벨.
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * 확인할 것
+ * ─────────────────────────────────────────────────────────────────────────────
+ * 1. **부서(1단계) 그룹행** — `급여 (Sum)` 과 `ID (Count)` 가 보인다. `Avg` 는 없다.
+ * 2. **팀(2단계) 그룹행** — `급여 (Avg)` 와 `ID (Count)` 가 보인다. `Sum` 은 없다.
+ *    → `scope` 가 표시 위치만 고르는 게 아니라 **집계 단위**를 정한다.
+ *      같은 `salary` 라도 부서 레벨은 부서별 합계, 팀 레벨은 팀별 평균이다.
+ * 3. **`scope` 없는 항목**(`id` 의 `count`)은 두 레벨 **모두**에 나타난다.
+ * 4. 그룹을 접었다 펴도 각 레벨의 집계가 그대로 유지된다.
+ */
+declare const meta: Meta<typeof MozGrid>;
+export default meta;
+type Story = StoryObj<typeof MozGrid>;
+/** 부서 → 팀 2단 그룹. 레벨마다 다른 집계를 건다. */
+export declare const LevelScopedAggregates: Story;
+/**
+ * 초기 접힘 상태 — `defaultExpandLevel` / `defaultCollapsed`.
+ *
+ * `TreeConfig` 의 같은 이름 옵션과 대칭이다. 통합 전에는 선언만 있고 **읽는 코드가 0건**인
+ * 죽은 옵션이었다(트리에서는 동작해서 되는 줄 알기 쉬웠다).
+ *
+ * ### 확인할 것
+ * 1. 처음 렌더에서 **부서 + 팀 그룹행까지** 펼쳐져 보인다(`defaultExpandLevel: 1`).
+ *    팀 아래 데이터 행은 접혀 있다.
+ * 2. 팀을 펼치면 사원 데이터 행이 나온다.
+ * 3. 펼친 뒤 정렬·필터를 걸어도 **사용자가 펼친 상태가 유지된다**
+ *    (초기 상태는 첫 렌더/설정 변경 시에만 적용된다).
+ *
+ * `defaultExpandLevel: 0` 이면 부서만, `defaultCollapsed: true` 면 전 레벨이 접힌다(이쪽이 우선).
+ */
+export declare const InitiallyCollapsed: Story;

package/dist/stories/RowGroupDisabled.stories.d.ts

@@ -0,0 +1,9 @@
+import { Meta, StoryObj } from '@storybook/vue3';
+import { default as MozGrid } from '../MozGrid.vue';
+declare const meta: Meta<typeof MozGrid>;
+export default meta;
+type Story = StoryObj<typeof MozGrid>;
+/** 기존 story ID(grid-rowgroupdisabled--disabled)를 유지한다. */
+export declare const Disabled: Story;
+export declare const LayoutDisabled: Story;
+export declare const FormatDisabled: Story;

package/dist/stories/SummaryFooter.stories.d.ts

@@ -0,0 +1,7 @@
+import { Meta, StoryObj } from '@storybook/vue3';
+import { default as MozGrid } from '../MozGrid.vue';
+declare const meta: Meta<typeof MozGrid>;
+export default meta;
+type Story = StoryObj<typeof MozGrid>;
+/** 기본 OFF. 컬럼 옵션 → 집계 → Footer 표시를 켜서 확인한다. */
+export declare const DefaultOff: Story;

package/dist/{legacy/stories → stories}/_helpers/localDataLoader.d.ts

@@ -1,4 +1,4 @@
-import { DataLoader } from '../../../../../moz-ui-grid-core/src/index.ts';
+import { DataLoader } from '../../../../moz-ui-grid-core/src/index.ts';
 /** DataLoader.fetchData()가 반환하는 데이터 행 타입 */
 type DataRow = Record<string, any>;
 export default class LocalDataLoader extends DataLoader {

package/dist/{legacy/stories → stories}/_helpers/sampleData.d.ts

@@ -41,25 +41,25 @@ export declare function generateTreeData(): ({
     department: string;
     salary: number;
 })[];
-/** 피벗 스토리용 사용 가능한 필드 정의 */
+/**
+ * 피벗 스토리용 사용 가능한 필드 정의 — **원본 컬럼 목록(카탈로그)**.
+ *
+ * 🚨 여기에는 배치 결과를 넣지 않는다. `{ field:'sales', aggregate:'sum', header:'매출 합계' }`
+ *    같은 항목은 "매출을 합계로 **배치한** 결과"이지 원본에 있는 컬럼이 아니다. 카탈로그에
+ *    섞이면 좌측 소스 필드 목록에 같은 field 가 여러 번 나오는데, 카탈로그 항목에는 배치 id 가
+ *    없어(그건 배치의 정체성이다) 그 항목들을 서로 구분할 수 없다.
+ *    집계 배치는 스토리의 `valueFields` 에 선언한다(예: MozGrid.stories 의 LargePivot).
+ *
+ * 항목은 `generateSalesData` 가 만드는 키와 1:1 이다.
+ */
 export declare const salesAvailableFields: ({
     field: string;
     header: string;
     dataType: "number";
-    aggregate?: undefined;
-    width?: undefined;
 } | {
     field: string;
     header: string;
     dataType: "string";
-    aggregate?: undefined;
-    width?: undefined;
-} | {
-    field: string;
-    aggregate: string;
-    header: string;
-    width: number;
-    dataType: "number";
 })[];
 export declare function generateSalesData(count?: number): {
     id: number;