beautiful-grid 1.0.15 → 1.0.17

package/README.md

@@ -583,6 +583,17 @@ const columns: BGridColumn<Item>[] = [
 ];
 ```
 
+`createSelectEditorPlugin` options:
+- `options`: List of `{ value, label, disabled? }` entries.
+- `allowCustomValue?: boolean`: Set `true` to allow pasting arbitrary values not present in `options` (default: `false`, rejecting unlisted values with `parseValueFailed`). Automatically preserves numeric types when option values are numeric.
+- `copyMode?: 'label' | 'value'`: Controls clipboard copy output (`'label'` by default when label is text, or `'value'`). Matching during paste prioritizes the configured `copyMode` to prevent label/value collisions.
+- `allowEmpty?: boolean`: Set `true` to allow clearing cell values when pasting empty text (default: `false`).
+- `emptyValue?: Value | null`: Value written when empty text is pasted with `allowEmpty: true` (default: `''`).
+- `allowDisabledOptions?: boolean`: Set `true` to allow pasting options marked `disabled: true` (default: `false`, rejecting disabled options).
+- `parseClipboardText?`: Override custom clipboard parsing and validation logic.
+- `getClipboardText?`: Override custom clipboard text retrieval logic.
+- `openOnMount?: boolean`: Automatically opens native picker on editor activation (default: `true`).
+
 #### Editor Icons (Lookup & Quick Triggers)
 
 Add inline trigger icons beside cell values using `editorIcon`:
@@ -649,35 +660,40 @@ Configure active cell handling and keyboard behavior with `cellNavigationOptions
 
 ---
 
-### 5. Cell Selection & Clipboard (Excel-compatible)
+### 5. Cell Range Selection & Clipboard Integration
 
 Cell range selection and clipboard copy/paste are enabled by default.
 
 ```typescript jsx
 <BGrid
-  width={800}
-  height={400}
-  columns={columns}
   data={data}
+  columns={columns}
+  editable
   rowKey='id'
   cellSelectionOptions={{
     enabled: true,
+    multiSelectFocusMode: 'first',
     clearOnEscape: true,
     clearOnOutsideClick: true,
     maxClipboardCells: 100000,
-    maxClipboardTextLength: 8 * 1024 * 1024,
-    onCopyError: error => console.warn('Copy skipped:', error),
-    onPasteError: error => console.warn('Paste failed:', error),
-    createRowOnPaste: ({ rowIndex, clipboardRow, columns }) => ({
+    createRowOnPaste: ({ rowIndex, clipboardRow }) => ({
+      status: BGridDataItemStatus.new,
       values: createNewRowModel(clipboardRow),
     }),
   }}
 />
 ```
 
-- `Ctrl+C` / `Cmd+C`: Copies selected cells as Tab-separated (`\t`) values and CRLF (`\r\n`) lines, directly pasteable into Excel or Google Sheets.
-- `Ctrl+V` / `Cmd+V`: Pastes clipboard matrix starting from the focused cell across editable columns.
-- Customize copied text on a per-column basis with `getClipboardText: ({ value, values }) => string`.
+- `Ctrl+C` / `Cmd+C`: Copies selected cells as Tab-separated (`\t`) values and CRLF (`\r\n`) lines, directly pasteable into Excel or Google Sheets. Columns configured with `createSelectEditorPlugin` copy the display `label` by default.
+- `Ctrl+V` / `Cmd+V`: Pastes clipboard values across editable columns:
+  - **Single cell fill**: Pasting a 1×1 value into a multi-cell selection fills every cell in the selected range.
+  - **Pattern tiling (Repeat)**: Pasting an $n \times m$ matrix into an $N \times M$ selection whose dimensions are exact integer multiples ($N \pmod n = 0$ and $M \pmod m = 0$) tiles/repeats the pattern across the entire selection.
+  - **Non-multiple fallback**: When the selection is not an exact multiple, the matrix pastes once starting at the top-left of the selected range (or focused cell if no range).
+- `multiSelectFocusMode: 'last'` makes the last cell selected by a drag the active cell. The default is `'first'` for backward compatibility.
+- **Paste validation & editor protection**:
+  - `createSelectEditorPlugin` validates pasted text against option values and string labels, mapping labels back to values with $O(1)$ indexed lookup.
+  - By default, unlisted values and disabled options are rejected and reported as `parseValueFailed` through `onPasteError`, preventing data corruption. Set `allowCustomValue: true` on the select editor plugin to allow arbitrary inputs.
+- Customize copied text on a per-column basis with `getClipboardText: ({ value, values }) => string`, or restore/validate custom types with `parseClipboardText: (text, context) => parsedValue`.
 
 ---
 
@@ -1118,7 +1134,7 @@ Below is a categorized reference of `<BGrid>` props. For exact TypeScript types,
 | `onChangeData`          | `(index, columnIndex, item, column, meta) => void` | -            | Callback fired after a cell edit commits.                    |
 | `onClick`               | `(params: BGridClickParams<T>) => void`            | -            | Cell click callback.                                         |
 | `cellNavigationOptions` | `BGridCellNavigationOptions`                       | -            | Active cell focus, arrow key navigation, and repeat options. |
-| `cellSelectionOptions`  | `BGridCellSelectionOptions`                        | -            | Range drag selection and clipboard copy/paste options.       |
+| `cellSelectionOptions`  | `BGridCellSelectionOptions`                        | -            | Range drag selection, active-cell focus, and clipboard copy/paste options. |
 
 #### Additional Features & Overlays
 

package/cjs/components/CellTextEditorGateway.js

@@ -386,7 +386,7 @@ function CellTextEditorGateway(_a) {
                 event.preventDefault();
                 void commit(event.shiftKey ? 'prev' : 'next');
             }
-        }, onBlur: function (event) {
+        }, onBlur: function () {
             if (!cellEditSession || !isTextEditing)
                 return;
             if (composingRef.current) {

package/cjs/components/ColResizer.js

@@ -80,7 +80,6 @@ function ColResizer(_a) {
     var setColumnResizing = (0, store_1.useAppStore)(function (s) { return s.setColumnResizing; });
     var endCellEdit = (0, store_1.useAppStore)(function (s) { return s.endCellEdit; });
     var disabled = (0, store_1.useAppStore)(function (s) { return s.disabled; });
-    var columnsGroup = (0, store_1.useAppStore)(function (s) { return s.columnsGroup; });
     var onPointerDownResizerHandle = React.useCallback(function (evt, columnIndex) {
         var _a, _b;
         if (disabled)

package/cjs/components/Pagination.js

@@ -48,7 +48,7 @@ var React = __importStar(require("react"));
 var shallow_1 = require("zustand/react/shallow");
 var store_1 = require("../store");
 var number_1 = require("../utils/number");
-function Pagination(props) {
+function Pagination() {
     var _a;
     // [Selector Group 1] Pagination State - 페이지네이션 상태
     var _b = (0, store_1.useAppStore)((0, shallow_1.useShallow)(function (s) { return ({