open-grid 0.4.0 → 1.0.0

package/dist/types/core/types.d.ts

@@ -157,6 +157,12 @@ export interface ColumnDef<T = any> {
     frozen?: boolean;
     /** 셀 줄바꿈: true 면 nowrap+ellipsis 대신 여러 줄로 표시(rowHeight 확대와 함께 사용) */
     wrap?: boolean;
+    /**
+     * 헤더(컬럼 머리글) 줄바꿈: true 면 헤더 텍스트가 잘리지 않고 여러 줄로 줄바꿈된다.
+     * (셀 본문용 wrap 과 별개로 헤더에만 적용. header 문자열의 '\n' 은 headerWrap 여부와 무관하게 항상 줄바꿈됨)
+     * 줄바꿈된 헤더에 맞춰 헤더 행 높이가 자동으로 늘어난다.
+     */
+    headerWrap?: boolean;
     colSpan?: boolean | ((row: T, rowIndex: number) => boolean);
     rowSpan?: boolean;
     children?: ColumnDef<T>[];
@@ -319,6 +325,7 @@ export interface GridOptions<T = any> {
     worksheets?: WorksheetDef[];
     calcPrecision?: number;
     columnReorder?: boolean;
+    overrideStrict?: boolean;
     onReady?: (grid: OpenGridInstance<T>) => void;
     onCellClick?: (e: CellEvent<T>) => void;
     onCellDblClick?: (e: CellEvent<T>) => void;
@@ -364,7 +371,58 @@ export interface GridOptions<T = any> {
     onCellKeyUp?: (e: CellKeyEvent<T>) => void;
     onCellKeyPress?: (e: CellKeyEvent<T>) => void;
 }
+/** override 레이어 함수: 첫 인자는 안쪽(원본 근접) 함수. orig(...) 호출이 super 처럼 동작. */
+export type OverrideLayerFn = (orig: (...args: any[]) => any, ...args: any[]) => any;
+export interface OverrideCallOptions {
+    /** 동일 메서드 재진입 허용(정당한 재귀). 기본 false. */
+    reentrant?: boolean;
+    /** 'fallback' → 레이어 예외 시 경고 후 원본 실행(멱등 가정, 롤백 불가). 미지정 시 strict. */
+    onError?: 'fallback';
+}
+/** 등록 가능한 알고리즘 슬롯 이름(6종). */
+export type StrategySlot = 'sortComparator' | 'filterPredicate' | 'displayFormatter' | 'cellSerializer' | 'groupKeyFn' | 'summaryOp';
+/** 단일키 정렬 비교자. dir 부호는 호출자(DataLayer)가 적용 — 슬롯은 비교만 반환. */
+export type SortComparatorFn = (a: any, b: any, field: string, dir: 'asc' | 'desc') => number;
+/** 필터 술어. true → 행 포함. */
+export type FilterPredicateFn = (value: any, fi: FilterItem, field: string) => boolean;
+/** 표시값 포맷. getDisplayValue(인스턴스 안전) + 렌더러(formatNumber/formatDate) 공유. */
+export type DisplayFormatterFn = (value: any, field: string, row: any) => string;
+/** export 셀 직렬화. */
+export type CellSerializerFn = (value: any, col: any, row: any) => any;
+/** 그룹 키 산출. remainingFields = 현재 깊이부터의 잔여 필드. */
+export type GroupKeyFn = (row: any, remainingFields: string[]) => any;
+/** 집계 연산. null 반환 시 기본 SUM/AVG/COUNT/MAX/MIN 분기로 폴백. */
+export type SummaryOpFn = (op: string, nums: any[], field: string) => number | null;
+/** 슬롯명 → 시그니처 매핑. */
+export interface StrategyMap {
+    sortComparator: SortComparatorFn;
+    filterPredicate: FilterPredicateFn;
+    displayFormatter: DisplayFormatterFn;
+    cellSerializer: CellSerializerFn;
+    groupKeyFn: GroupKeyFn;
+    summaryOp: SummaryOpFn;
+}
+/** 호출가능 + .strategy 멤버를 가진 하이브리드 override API. */
+export interface OverrideApi<T = any> {
+    /** 메서드 본문 무수정 런타임 래핑(C1-clean). 체이닝 위해 grid 인스턴스 반환. */
+    (name: string, fn: OverrideLayerFn, opts?: OverrideCallOptions): OpenGridInstance<T>;
+    /** 알고리즘 슬롯 등록(Phase 2 매니저 훅포인트). 체이닝 위해 grid 인스턴스 반환. */
+    strategy<K extends StrategySlot>(slot: K, fn: StrategyMap[K]): OpenGridInstance<T>;
+    strategy(slot: string, fn: Function): OpenGridInstance<T>;
+}
 export interface OpenGridInstance<T = any> {
+    /** 공개 메서드를 런타임 래핑하거나(.override) 알고리즘 슬롯을 등록(.strategy). */
+    override: OverrideApi<T>;
+    /** 단일 메서드 원본 복구. */
+    restore(name: string): OpenGridInstance<T>;
+    /** 전체 override + strategy 복구(destroy 시 자동). */
+    restoreAll(): OpenGridInstance<T>;
+    /** 해당 메서드가 override 되어 있는지. */
+    hasOverride(name: string): boolean;
+    /** override 등록된 메서드 이름 목록. */
+    getOverrideNames(): string[];
+    /** strategy 슬롯 조회(미등록 시 fallback 반환). 매니저 read API. */
+    getStrategy<F extends Function>(slot: string, fallback: F): F;
     setData(data: T[]): void;
     getData(): T[];
     getSourceRows(): T[];

package/dist/types/index.d.ts

@@ -1,4 +1,4 @@
-
+import './styles/base.css';
 export { OpenGrid } from './core/OpenGrid.js';
 export { GridShuttle, createGridShuttle } from './core/GridShuttle.js';
 export type { GridShuttleOptions } from './core/GridShuttle.js';

package/dist/types/react/OpenGrid.d.ts

@@ -1,6 +1,6 @@
-import { default as React, CSSProperties } from 'react';
-import { GridOptions, ColumnDef, OpenGridInstance } from '../core/types.js';
-
+import React, { CSSProperties } from 'react';
+import type { GridOptions, ColumnDef, OpenGridInstance } from '../core/types.js';
+import '../styles/base.css';
 export interface OpenGridProps<T extends Record<string, any> = any> {
     data?: T[];
     columns: ColumnDef<T>[];

package/dist/types/vue/types.d.ts

@@ -1,5 +1,4 @@
-import { GridOptions, ColumnDef, OpenGridInstance } from '../core/types.js';
-
+import type { GridOptions, ColumnDef, OpenGridInstance } from '../core/types.js';
 export interface OpenGridProps<T = any> {
     data?: T[];
     columns: ColumnDef<T>[];

package/package.json

@@ -1,99 +1,99 @@
-{
-  "name": "open-grid",
-  "version": "0.4.0",
-  "description": "High-performance, framework-agnostic data grid with Vue 3 and React 18 support",
-  "type": "module",
-  "main": "dist/open-grid.cjs",
-  "module": "dist/open-grid.js",
-  "types": "dist/types/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/open-grid.js",
-      "require": "./dist/open-grid.cjs",
-      "types": "./dist/types/index.d.ts"
-    },
-    "./vue": {
-      "import": "./dist/open-grid-vue.js",
-      "require": "./dist/open-grid-vue.cjs",
-      "types": "./dist/types/vue/index.d.ts"
-    },
-    "./react": {
-      "import": "./dist/open-grid-react.js",
-      "require": "./dist/open-grid-react.cjs",
-      "types": "./dist/types/react/index.d.ts"
-    },
-    "./style.css": "./dist/style.css"
-  },
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "dev": "vite",
-    "build": "tsc && vite build",
-    "build:types": "tsc --emitDeclarationOnly",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "test:e2e": "playwright test",
-    "lint": "eslint src --ext .ts,.tsx,.vue",
-    "preview": "vite preview",
-    "build:deploy": "vite build --config vite.config.deploy.ts",
-    "obfuscate": "node scripts/obfuscate.mjs",
-    "deploy": "npm run build && npm run build:deploy && npm run obfuscate"
-  },
-  "peerDependencies": {
-    "react": ">=18.0.0",
-    "react-dom": ">=18.0.0",
-    "vue": ">=3.0.0"
-  },
-  "peerDependenciesMeta": {
-    "react": {
-      "optional": true
-    },
-    "react-dom": {
-      "optional": true
-    },
-    "vue": {
-      "optional": true
-    }
-  },
-  "devDependencies": {
-    "@playwright/test": "^1.44.0",
-    "@types/react": "^18.3.0",
-    "@types/react-dom": "^18.3.0",
-    "@typescript-eslint/eslint-plugin": "^7.0.0",
-    "@typescript-eslint/parser": "^7.0.0",
-    "@vitejs/plugin-react": "^4.3.0",
-    "@vitejs/plugin-vue": "^5.0.0",
-    "@vitest/coverage-v8": "^1.6.1",
-    "eslint": "^9.0.0",
-    "javascript-obfuscator": "^5.4.3",
-    "jsdom": "^29.1.1",
-    "react": "^18.3.0",
-    "react-dom": "^18.3.0",
-    "typescript": "^5.4.0",
-    "vite": "^5.2.0",
-    "vite-plugin-dts": "^3.9.0",
-    "vitest": "^1.6.0",
-    "vue": "^3.4.0"
-  },
-  "dependencies": {
-    "xlsx": "^0.18.5",
-    "xlsx-js-style": "^1.2.0"
-  },
-  "keywords": [
-    "grid",
-    "datagrid",
-    "table",
-    "vue",
-    "react",
-    "typescript",
-    "virtual-scroll",
-    "editable"
-  ],
-  "license": "MIT",
-  "author": "OPEN_GRID Contributors",
-  "homepage": "https://foxnail.kr/open-grid/demo/v2/index.php"
-}
+{
+  "name": "open-grid",
+  "version": "1.0.0",
+  "description": "High-performance, framework-agnostic data grid with Vue 3 and React 18 support",
+  "type": "module",
+  "main": "dist/open-grid.cjs",
+  "module": "dist/open-grid.js",
+  "types": "dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/open-grid.js",
+      "require": "./dist/open-grid.cjs",
+      "types": "./dist/types/index.d.ts"
+    },
+    "./vue": {
+      "import": "./dist/open-grid-vue.js",
+      "require": "./dist/open-grid-vue.cjs",
+      "types": "./dist/types/vue/index.d.ts"
+    },
+    "./react": {
+      "import": "./dist/open-grid-react.js",
+      "require": "./dist/open-grid-react.cjs",
+      "types": "./dist/types/react/index.d.ts"
+    },
+    "./style.css": "./dist/style.css"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc && vite build",
+    "build:types": "tsc --emitDeclarationOnly",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "test:e2e": "playwright test",
+    "lint": "eslint src --ext .ts,.tsx,.vue",
+    "preview": "vite preview",
+    "build:deploy": "vite build --config vite.config.deploy.ts",
+    "obfuscate": "node scripts/obfuscate.mjs",
+    "deploy": "npm run build && npm run build:deploy && npm run obfuscate"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0",
+    "vue": ">=3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    },
+    "vue": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.44.0",
+    "@types/react": "^18.3.0",
+    "@types/react-dom": "^18.3.0",
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^7.0.0",
+    "@vitejs/plugin-react": "^4.3.0",
+    "@vitejs/plugin-vue": "^5.0.0",
+    "@vitest/coverage-v8": "^1.6.1",
+    "eslint": "^9.0.0",
+    "javascript-obfuscator": "^5.4.3",
+    "jsdom": "^29.1.1",
+    "react": "^18.3.0",
+    "react-dom": "^18.3.0",
+    "typescript": "^5.4.0",
+    "vite": "^5.2.0",
+    "vite-plugin-dts": "^3.9.0",
+    "vitest": "^1.6.0",
+    "vue": "^3.4.0"
+  },
+  "dependencies": {
+    "xlsx": "^0.18.5",
+    "xlsx-js-style": "^1.2.0"
+  },
+  "keywords": [
+    "grid",
+    "datagrid",
+    "table",
+    "vue",
+    "react",
+    "typescript",
+    "virtual-scroll",
+    "editable"
+  ],
+  "license": "MIT",
+  "author": "OPEN_GRID Contributors",
+  "homepage": "https://foxnail.kr/open-grid/demo/v2/index.php"
+}