comins-table 0.1.10 → 0.2.0

package/CHANGELOG.md

@@ -1,6 +1,59 @@
 # Comins Table
 
-## 0.1.10 (Unreleased)
+## 0.2.0 - 2026-10-02
+
+### Changed
+
+- **Migration:** `comins-table/core` now exports neutral state, Column/Group and payload contracts. Labels are strings, cell data guards live directly on `cell`, and React renderer/theme/DOM contracts are excluded. Move React state helpers and React-only types previously imported from `/core` to `comins-table`.
+- The root, `/clipboard`, and `/selection` preserve their existing React-state APIs, JSX labels, props guards, callbacks and theme behavior. Use `/core` helpers with neutral state. Package exports and React peer dependencies are unchanged; this is not an SSR or Vue support declaration.
+- Local verification now checks a freshly built and packed Core artifact with no React installation and ES2022-only declarations, plus source and runtime dependency graphs.
+- Release verification checks the exact publication artifact with the neutral Core consumer and React 18/19 consumers, including strict types, helper execution, client mounting, and browser JS/CSS builds.
+
+### Fixed
+
+- Pending Row Detail focus retries are cancelled when their owning Table unmounts, while disclosure-collapse focus restoration is preserved.
+- Fill gestures explicitly release pointer capture on cancellation and cleanup, and stopped pointer animation loops cannot schedule another frame during cleanup.
+- Repeated cleanup of an old cross-table transfer registration no longer removes a replacement registered under the same scope and Table ID.
+- Playground TSV inputs display multiline samples with full-width styling. Pinned-column boundary and cross-table duplicate-ID policy explanations now describe the existing behavior explicitly.
+
+## 0.1.11 - 2026-09-22
+
+### Added
+
+- Opt-in external plain-text TSV paste through `clipboardPaste`, typed `cell.parseClipboard`, `onClipboardError`, and `parseCominsClipboardText` / `pasteCominsText` Core helpers. Parsing is bounded and batch errors are atomic; native editors keep their clipboard behavior.
+- Opt-in `fillHandle` with typed value/pattern repetition, preview, edge scrolling, cancellation, and click/Ref `fillSelection` alternatives. Both editing options require Cell selection and a controlled data callback.
+- Optional `cell.validateFill` validates typed destination values before a Fill commits. Returning `false` or throwing rejects the entire operation without changing data; React reports the error through `onClipboardError`.
+- A 1,000-Row Playground editing example with automatic height, pinned Columns, numeric conversion and protected Rows/Cells, plus matching English/Korean guides.
+- A Clipboard/Fill README animation and refreshed 0.1.11 overview and feature GIFs captured from live demos.
+
+### Changed
+
+- **Migration:** Row Drag is now disabled by default. Set `rowProps={{ draggable: true }}` to retain handle-based movement. `onChangeData` remains optional for local Row reordering; a new `data` array replaces internal Rows, while option-only rerenders preserve local order. Tree and cross-Group/transfer ownership contracts remain unchanged.
+- Header Sort uses the same Chevron family and 24px icon-button primitive as Row Group disclosure, retaining sorting, keyboard activation, multi-sort and resize/drag isolation.
+- Header and Row Group drag feedback uses accent/danger tokens, neutral source placeholders and a readable light/dark drag preview. Filled ranges, focus, disabled controls and reduced motion follow `DESIGN.md`.
+
+### Fixed
+
+- Completed Playground option toggle styling, including automatic-height content length, width, renderer expansion, Tree policies, Group visibility, and Viewport request options. Pressed states are visible and support native Enter/Space activation.
+- Excluded ignored local diagnostic files from Vitest discovery so the normal verification command does not execute Playwright-only diagnostics.
+- Removed duplicated perimeter borders at the final Body/Header/Summary Cell and unified Row, Tree and Group drop feedback with the Header target tokens.
+- Enabled local Row/Group edge auto-scroll with refreshed virtual drop targets and viewport-clipped bounds. Tree pointer drops preserve the scrolled viewport instead of following a moved anchor Row.
+- Connected CRUD reordering to controlled data and replaced position-based IDs and labels in both Virtualization examples with stable Row identities. Clarified the Viewport Datasource Row Drag exclusion.
+- Kept the top border stationary when Headers are hidden, and removed Row drag placeholder layout shifts. Local virtual Row drops preserve the viewport position; fixed-height virtual rendering uses the same logical/physical offset convention as variable-height rendering.
+- Made Component example labels follow stable Row data, aligned example text/numeric/control values, clarified empty filtered Groups and disabled Rows, and connected Context Create/Delete to actual example data changes.
+- Added a two-value TSV sample and explained trailing empty fields without changing intentional empty-cell paste behavior.
+- Separated the CRUD Playground's internal Row identity from editable `column4`, so all six displayed fields can be updated while selection and deletion keep targeting the same Row.
+- Clamped logical scroll anchors to the final viewport after sorting variable-height Rows, preventing blank space below the last Row.
+- Preserved keyboard focus when clearing Header sort and opening the first or closing the last virtual Row Detail.
+- Kept incomplete filter drafts independent from applied conditions and repositioned filter popovers after layout changes, above sibling Headers while inheriting Table theme tokens.
+- Connected controlled expansion in the 10,000-node Tree Playground and rejected non-numeric Fill values in its numeric editing example.
+
+### Compatibility notes
+
+- `clipboard`, `clipboardPaste` and `fillHandle` remain independent opt-in features. Existing internal paste remains the default. OS paste imports strings unless a Column parser converts them, and intentional empty TSV Cells overwrite editable destinations.
+- Fill repeats existing values; automatic series and source clearing on shrink are not included. Viewport edits require contiguous loaded data and do not fetch or persist it.
+
+## 0.1.10 - 2026-09-11
 
 ### Added
 

package/DESIGN.md

@@ -22,7 +22,7 @@ Motion is limited to short color, opacity, position, and resize feedback. Motion
 
 | Surface | Contract |
 | --- | --- |
-| Frame | Owns the outer border, radius, background, and the final horizontal scrollbar. |
+| Frame | Owns a single 1px outer border, radius, background, and the final horizontal scrollbar. Header and final Cells must not duplicate the perimeter border; pinned-zone separators remain distinct. |
 | Header | Uses an accent surface by default and retains visible focus, resize, sort, move, and pinned boundaries. |
 | Body Cell | Keeps grid borders and application Row backgrounds visible beneath selection indicators. |
 | Group Row | Uses one semantic full-width Cell. Its content remains visible at the Body viewport start during horizontal scrolling. |
@@ -38,6 +38,20 @@ Rest, hover, active, `focus-visible`, selected, disabled, loading, invalid, drag
 
 For variable business Row heights, `getRowHeight` owns the layout policy. Returning `"auto"` measures normal-flow Cell content; `estimatedRowHeight` supplies the initial estimate without imposing a limit on the Renderer. Group headings retain their fixed `rowHeight`, and Row Details keep their independent height policy. CSS height overrides alone do not update virtual geometry. Viewport loading estimates unloaded heights and may adjust the scrollbar as content is measured.
 
+## Icons, sorting, and drag feedback
+
+Built-in icons use the existing Radix 15px SVG primitives and inherit their foreground. Icon buttons have a 24px square interaction area. Disclosure uses right/down Chevrons; ascending/descending sorting uses up/down Chevrons from the same family. Sorting remains a Header action, with `aria-sort` on the owning Header, an accessible button label, decorative SVGs, and native Enter/Space activation. Sort direction must not be confused with Group expansion state.
+
+| Interaction state | Treatment |
+| --- | --- |
+| Source placeholder | Neutral `surface-muted` / `muted` pair and a one-pixel inset dashed `drop-marker` outline. Preserve original geometry. |
+| Valid target | `drop-valid-background` with readable `foreground`; 2px solid `drop-valid` outline or insertion line for Row, Tree, Group and Header targets. |
+| Invalid target | `drop-invalid-background` with readable foreground and 2px solid `drop-invalid` outline; retain rejected-drop semantics. |
+| Floating drag preview | `surface` / `foreground`, `drop-marker` border, 2px radius, compact spacing, subdued shadow; never intercept pointer events. |
+| Fill Handle | 24px hit area, 8px accent marker, visible keyboard focus, preview without data mutation. Click actions provide a non-drag alternative. |
+
+Header and Row Group targets share these states while retaining their own insertion geometry. Never substitute a hard-coded light foreground on a dark-theme accent marker. Component disabled text uses `component-muted`; menu and virtual-list items distinguish keyboard focus from hover. Reduced-motion mode disables Sort and Group disclosure transitions as well as movement animation.
+
 ## CSS token stability
 
 The canonical machine-readable inventory is `docs/feature-manifest.json`. Stability means:

package/README.md

@@ -1,5 +1,7 @@
 # Comins Table
 
+<img src="example/public/comins-symbol.svg" width="64" height="64" alt="Comins" />
+
 Comins Table is a controlled React data table for data-heavy application screens. Applications keep ownership of their data and business models while the Table provides virtualized rendering, structured Rows, configurable Headers, precise selection, and customizable cells.
 
 [![npm version](https://img.shields.io/npm/v/comins-table)](https://www.npmjs.com/package/comins-table)
@@ -7,7 +9,7 @@ Comins Table is a controlled React data table for data-heavy application screens
 [![Verify](https://github.com/kim1124/comins-table/actions/workflows/verify.yml/badge.svg?branch=main)](https://github.com/kim1124/comins-table/actions/workflows/verify.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 
-![Comins Table controlled Rows, Column Pinning, Row Grouping, Filtering, Tree Grid, and Cross-Table Drag overview](https://raw.githubusercontent.com/kim1124/comins-table/main/docs/assets/comins-table-overview.gif)
+![Comins Table 0.1.11: TSV paste, Fill Handle, Tree drag, automatic heights, and Viewport loading](https://raw.githubusercontent.com/kim1124/comins-table/main/docs/assets/comins-table-overview.gif)
 
 ## Why Comins Table
 
@@ -21,9 +23,20 @@ Comins Table is a controlled React data table for data-heavy application screens
 
 Comins Table is standalone and does not wrap another table or grid implementation.
 
-### Version 0.1.10
+### Version 0.2.0
+
+The source targets 0.2.0. The animations were recorded with 0.1.11. See the [changelog](https://github.com/kim1124/comins-table/blob/main/CHANGELOG.md) for release status.
+
+**0.1.11 migration:** Row Drag is opt-in with `rowProps={{ draggable: true }}`. `onChangeData` is optional for local Row movement; connect it to synchronize application state. New `data` arrays remain authoritative.
+
+**0.2.0 migration:** `/core` now exposes framework-neutral contracts. Move React state helpers and React-only types from `/core` to `comins-table`; see the [migration guide](https://github.com/kim1124/comins-table/blob/main/docs/user/26-migration-0.2.0.md). Existing opt-in TSV paste, Fill Handle, Tree Row drag, automatic heights, and Viewport Datasource remain available.
 
-This source version adds Tree Row drag, automatic business Row heights with variable-height virtualization, and known-count Viewport Datasource loading. Row and Cell selection can be managed independently, with separate Ref getters and opt-in OS clipboard copying. See the [0.1.10 changelog](https://github.com/kim1124/comins-table/blob/main/CHANGELOG.md) for the complete change list.
+For migration, keep these data-ownership boundaries explicit:
+
+- Local Row reordering needs `rowProps.draggable: true`; connect `onChangeData` when the application must retain the new order. Use stable Row IDs and keep the input array reference stable when relying on internal order.
+- Tree movement still requires `treeRowDrag` and controlled `onChangeData`. Cross-Table transfers use the Coordinator; enabling a local Row handle does not enable transfers.
+- OS paste and Fill require `cellSelection` and `onChangeData`; both remain opt-in. A two-field TSV updates two destination Cells. A trailing tab deliberately supplies an additional empty field.
+- Viewport loading has no Row Drag handles. Reordering a partially loaded dataset belongs to the server, followed by a dataset reset.
 
 ### Feature catalog
 
@@ -156,12 +169,14 @@ Set `multiSort` to opt into ordered multi-column sorting. Normal Header click or
 
 ## Package Entry Points
 
+**0.2.0:** `/core` uses neutral state and string labels. Existing React state helpers and JSX/renderer/theme types belong to the root; `/clipboard` and `/selection` retain React-state contracts. Published 0.1.x behavior is not changed by this guide. See the [English migration guide](https://github.com/kim1124/comins-table/blob/main/docs/user/26-migration-0.2.0.md) or [한국어 마이그레이션](https://github.com/kim1124/comins-table/blob/main/docs/ko/26-migration-0.2.0.md). React peers and the client-only Table boundary remain unchanged; Vue support is not included.
+
 | Import | Purpose |
 | --- | --- |
 | `comins-table` | React component, public types, and root helper exports |
-| `comins-table/core` | State, row, column, pagination, sorting, layout, selection, clipboard, export, and virtualization helpers |
-| `comins-table/clipboard` | Clipboard helper subset |
-| `comins-table/selection` | Selection helper subset |
+| `comins-table/core` | Neutral state, row, column, pagination, sorting, layout, selection, clipboard, export, and virtualization helpers |
+| `comins-table/clipboard` | React-state clipboard helper subset |
+| `comins-table/selection` | React-state selection helper subset |
 | `comins-table/styles.css` | Optional table shell, theme, and built-in component skin |
 
 ## Header And Layout
@@ -170,7 +185,7 @@ Sortable headers support pointer and keyboard activation and expose `aria-sort`.
 
 A left-button mouse interaction activates column movement after a 6-pixel horizontal drag, provided horizontal movement remains greater than vertical movement. The source becomes a source placeholder while a ghost and target marker show the proposed move. Pointer Up commits only over a valid target; vertical intent, pointer cancellation, `Escape`, and window blur cancel the pending move. Non-mouse pointers retain one-second long-press compatibility. Parent header groups move their children as one block.
 
-Use `getColumnLayout()` and `setColumnLayout()` through the Ref API, or `serializeCominsColumnLayout()` and `applyCominsColumnLayout()` from `comins-table/core`, to persist and restore order, widths, and visibility.
+Use `getColumnLayout()` and `setColumnLayout()` through the Ref API, or `serializeCominsColumnLayout()` and `applyCominsColumnLayout()` to persist and restore order, widths, and visibility. Import helpers from the root for React state or from `comins-table/core` for neutral state.
 
 ### Column Pinning
 
@@ -239,6 +254,24 @@ Use `getRowHeight={() => "auto"}` for content-driven business Row heights, or re
 
 Viewport bounds cached data and measured heights; distant scrolling does not fetch every earlier page or require a full dataset array. Unloaded heights are estimated, so scrollbar size can change as content is measured. Selection getters and copy operate on loaded data without fetching missing Rows. The application owns network requests and edit persistence. Tree, Row Grouping, Row Detail, Row Drag, append loading, pagination, built-in sorting/filtering, and automatic Summary aggregation are unavailable in Viewport mode.
 
+### Tree subtree movement
+
+Move Gamma and its child Epsilon to another parent, then fold and expand the hierarchy.
+
+![Tree subtree drag with controlled parent changes](https://raw.githubusercontent.com/kim1124/comins-table/main/docs/assets/comins-table-tree-row-drag.gif)
+
+### Content-driven heights
+
+Expand a Cell Renderer and narrow the Table. Row heights adjust automatically across 100,000 virtualized Rows.
+
+![Automatic row heights respond to renderer content and table width](https://raw.githubusercontent.com/kim1124/comins-table/main/docs/assets/comins-table-auto-row-height.gif)
+
+### Load the visible region
+
+Drag the scrollbar to a distant region of 1,000,000 Rows, inspect the bounded cache, and change the query. This recording uses a simulated asynchronous source with a 250 ms delay.
+
+![Viewport datasource loads a distant range and resets the query](https://raw.githubusercontent.com/kim1124/comins-table/main/docs/assets/comins-table-viewport-datasource.gif)
+
 See [automatic height](https://github.com/kim1124/comins-table/blob/main/docs/user/24-auto-row-height.md), [Viewport Datasource](https://github.com/kim1124/comins-table/blob/main/docs/user/25-viewport-datasource.md), and [Tree drag](https://github.com/kim1124/comins-table/blob/main/docs/user/17-tree-grid.md) for examples, defaults, and combination limits.
 
 ## Column Filtering
@@ -283,9 +316,11 @@ Virtual List Item activation follows the normal Row selection modifiers. More se
 
 Set `clipboard` to enable OS keyboard copy. It defaults to `false`, preserving the existing internal copy buffer. With OS copy enabled, the default priority is multiple selected Cells → selected Rows → one selected Cell. Five selected Rows and three selected Cells copy the three Cells while retaining all five selected Rows. Discontiguous Cells produce a TSV rectangle with unselected positions empty; internal paste skips those positions.
 
-Call `copySelection("auto" | "cells" | "rows")` from a button or context menu to choose the target explicitly. This Ref method writes to the OS clipboard regardless of the `clipboard` prop, returns `Promise<string | null>`, and rejects if writing is unavailable or denied. Native text editing keeps its own copy behavior. Ctrl/Cmd+V uses the Table's internal buffer; importing arbitrary OS clipboard content is outside this version. See the [Clipboard guide](https://github.com/kim1124/comins-table/blob/main/docs/user/09-clipboard.md) for guards, TSV escaping, and loaded-data limits.
+Call `copySelection("auto" | "cells" | "rows")` from a button or context menu to choose the target explicitly. This Ref method writes to the OS clipboard regardless of the `clipboard` prop, returns `Promise<string | null>`, and rejects if writing is unavailable or denied. Native text editing keeps its own copy behavior. Ctrl/Cmd+V uses the Table's internal buffer by default; enable `clipboardPaste` to import external TSV instead. See the [Clipboard guide](https://github.com/kim1124/comins-table/blob/main/docs/user/09-clipboard.md) for guards, TSV escaping, and loaded-data limits.
+
+![Comins Table 0.1.11 pastes two TSV fields and repeats a Cell pattern with the Fill Handle](https://raw.githubusercontent.com/kim1124/comins-table/main/docs/assets/comins-table-clipboard-fill.gif)
 
-`copyCominsRow`, `copyCominsCell`, and `copyCominsCellRange` read Row or Cell selections. `pasteCominsRow`, `pasteCominsCell`, and `pasteCominsCellRange` apply clipboard data while respecting `props.copyable`, `props.pasteable`, and disabled guards. `fillCominsCellRange` remains a framework-independent core helper; no visual fill handle is presented as shipped UI.
+`copyCominsRow`, `copyCominsCell`, and `copyCominsCellRange` read Row or Cell selections. `pasteCominsRow`, `pasteCominsCell`, and `pasteCominsCellRange` apply clipboard data while respecting `props.copyable`, `props.pasteable`, and disabled guards. `fillCominsCellRange` accepts a single Cell or rectangular source pattern. Enable `clipboardPaste` for OS TSV paste and `fillHandle` for visual pattern repetition; both default to false and require `cellSelection` and `onChangeData`. Set `cell.parseClipboard` for typed external values, optional `cell.validateFill` for atomic Fill validation, and `onClipboardError` for rejected input. `parseCominsClipboardText` and `pasteCominsText` are available from the root, `/core`, and `/clipboard`. See the [Clipboard guide](https://github.com/kim1124/comins-table/blob/main/docs/user/09-clipboard.md) for limits, guards, native-editor behavior, and `fillSelection("down" | "right")` click alternatives.
 
 Use `exportCominsRowsToCsv` and `exportCominsRowsToJson` with the exact rows and export columns the application wants to serialize. Export remains independent of visible pagination, filtering, and selection unless the application passes those rows.
 
@@ -345,7 +380,7 @@ Use the [source repository](https://github.com/kim1124/comins-table) for develop
 
 Comins Table provides CSR arrays and known-count Viewport range loading. Server-side Row models and built-in server filtering, custom Filter editor renderers, Tree filtering, pivoting, charts, AI assistance, remote Tree loading, hierarchy pagination, Tree Row copy/paste, Tree Grid Row Details, nested managed Details, Firefox, Safari, and SSR are not shipped or supported.
 
-The visual fill handle is not shipped or supported. `fillCominsCellRange` remains available as a core helper without a drag-handle UI.
+The visual fill handle repeats values or selected patterns. Automatic numeric/date series and source clearing on range shrink are not supported. Viewport edits require contiguous loaded Rows and never request missing data.
 
 ## Development
 
@@ -360,7 +395,7 @@ npm run verify
 npm run docs:readme-gif
 ```
 
-`npm run docs:readme-gif` is a maintainer command that captures the real hidden Playground fixtures and regenerates the overview animation plus four detailed feature animations.
+`npm run docs:readme-gif` is a maintainer command that captures the real hidden Playground fixtures and regenerates the overview animation plus eight detailed feature animations, including TSV paste and Fill Handle, Tree subtree drag, automatic height, and Viewport loading.
 
 ## Trusted Publishing
 

package/THIRD_PARTY_NOTICES.md

@@ -22,8 +22,6 @@ distribution.
 - `DoubleArrowRightIcon`
 - `DragHandleDots2Icon`
 - `MagnifyingGlassIcon`
-- `ThickArrowDownIcon`
-- `ThickArrowUpIcon`
 <!-- radix-icons-used-exports:end -->
 
 MIT License

package/dist/browser/clipboard.d.ts

@@ -0,0 +1,4 @@
+export declare function writeCominsClipboardText(text: string): Promise<void>;
+export declare function readCominsClipboardEvent(data: Pick<DataTransfer, "types" | "getData">): string | null;
+export declare function writeCominsClipboardEvent(data: Pick<DataTransfer, "setData">, text: string): void;
+//# sourceMappingURL=clipboard.d.ts.map

package/dist/browser/clipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../../src/browser/clipboard.ts"],"names":[],"mappings":"AAAA,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,MAAM,iBAG1D;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,OAAO,GAAG,SAAS,CAAC,iBAErF;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,QAE1F"}

package/dist/browser/measurements.d.ts

@@ -0,0 +1,28 @@
+export type CominsElementMeasurement = {
+    element: Element;
+    height: number;
+    rectHeight: number;
+    width: number;
+};
+export declare function measureCominsElement(element: Element, entry?: ResizeObserverEntry): CominsElementMeasurement;
+/** Owns DOM targets only; adapters map measurements to rows and flush a batch once. */
+export declare function createMeasurementObserver(options: {
+    onMeasure: (measurement: CominsElementMeasurement) => void;
+    onBatchComplete?: () => void;
+}): {
+    observe(element: Element): void;
+    unobserve(element: Element): void;
+    dispose(): void;
+};
+export declare function hasCominsResizeObserver(): boolean;
+export declare function observeCominsViewport(element: HTMLElement, onMeasure: (value: {
+    height: number;
+    width: number;
+    scrollWidth: number;
+    outerWidth: number;
+    viewportWidth: number;
+}) => void): () => void;
+export declare function observeCominsFontChanges(onChange: () => void): () => void;
+export declare function getCominsElementRect(element: Element): DOMRect;
+export declare function getCominsElementRect(element: Element | null | undefined): DOMRect | undefined;
+//# sourceMappingURL=measurements.d.ts.map

package/dist/browser/measurements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"measurements.d.ts","sourceRoot":"","sources":["../../src/browser/measurements.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,mBAAmB,GAAG,wBAAwB,CAI5G;AAED,uFAAuF;AACvF,wBAAgB,yBAAyB,CAAC,OAAO,EAAE;IACjD,SAAS,EAAE,CAAC,WAAW,EAAE,wBAAwB,KAAK,IAAI,CAAC;IAC3D,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;CAC9B;IAUG,OAAO,UAAU,OAAO;IAoBxB,SAAS,UAAU,OAAO;IAK1B,OAAO;EAOV;AAED,wBAAgB,uBAAuB,YAAoD;AAE3F,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE;IAC7E,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;CAC/F,KAAK,IAAI,cAOT;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,IAAI,cAI5D;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC;AAChE,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC"}

package/dist/browser/pointer.d.ts

@@ -0,0 +1,25 @@
+export declare function captureCominsPointer(element: Pick<Element, "setPointerCapture" | "releasePointerCapture">, pointerId: number): () => void;
+export declare function registerCominsPointerListeners(input: {
+    move: (event: PointerEvent) => void;
+    up: (event: PointerEvent) => void;
+    cancel: (event: PointerEvent) => void;
+    blur: () => void;
+    key: (event: KeyboardEvent) => void;
+    keyCapture?: boolean;
+}): () => void;
+export declare function startCominsPointerFrames(onFrame: FrameRequestCallback, host?: Pick<Window, "requestAnimationFrame" | "cancelAnimationFrame">): () => void;
+export declare function focusCominsPointerTarget(element: HTMLElement | null): void;
+export declare function applyCominsDragScroll(viewport: HTMLElement, input: {
+    top: number;
+    bottom: number;
+    clientY: number;
+    deltaMs: number;
+    onlyIfChanged?: boolean;
+    enabled?: boolean;
+}): void;
+export declare function isCominsNativeEditor(target: EventTarget | null): boolean;
+export declare const createCrossTableAutoScroll: (resolveTarget: (clientX: number, clientY: number) => void) => {
+    stop: () => void;
+    update: (nextViewport: HTMLElement | null, nextClientX: number, nextClientY: number, valid: boolean) => void;
+};
+//# sourceMappingURL=pointer.d.ts.map

package/dist/browser/pointer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pointer.d.ts","sourceRoot":"","sources":["../../src/browser/pointer.ts"],"names":[],"mappings":"AAEA,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,uBAAuB,CAAC,EAAE,SAAS,EAAE,MAAM,cAQ5H;AACD,wBAAgB,8BAA8B,CAAC,KAAK,EAAE;IACpD,IAAI,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IAAC,EAAE,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IAAC,MAAM,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IAC9G,IAAI,EAAE,MAAM,IAAI,CAAC;IAAC,GAAG,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC7E,cAQA;AACD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,oBAAoB,EAAE,IAAI,GAAE,IAAI,CAAC,MAAM,EAAE,uBAAuB,GAAG,sBAAsB,CAAU,cASpJ;AACD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,QAEnE;AACD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,QAGhL;AACD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,WAE9D;AAED,eAAO,MAAM,0BAA0B,kBACpB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI;;2BAsDzC,WAAW,GAAG,IAAI,eACnB,MAAM,eACN,MAAM,SACZ,OAAO;CAqCjB,CAAC"}

package/dist/browser/scroll.d.ts

@@ -0,0 +1,9 @@
+export declare function setCominsScrollTop(element: HTMLElement, top: number): void;
+export declare function setCominsScrollLeft(element: HTMLElement, left: number): void;
+export declare function scrollCominsRowIntoView(viewport: HTMLElement, index: number): void;
+export declare function focusCominsElement(element: HTMLElement | null | undefined, options?: FocusOptions): void;
+export declare function createCominsDetailFocusRestorer(): {
+    restore(element: HTMLElement | null, getToggle: () => HTMLButtonElement | null): void;
+    dispose(): void;
+};
+//# sourceMappingURL=scroll.d.ts.map

package/dist/browser/scroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll.d.ts","sourceRoot":"","sources":["../../src/browser/scroll.ts"],"names":[],"mappings":"AAAA,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,QAEnE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,QAErE;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,QAE3E;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,EAAE,OAAO,CAAC,EAAE,YAAY,QAEjG;AAED,wBAAgB,+BAA+B;IAG3C,OAAO,UAAU,WAAW,GAAG,IAAI,aAAa,MAAM,iBAAiB,GAAG,IAAI;IAW9E,OAAO;EAKV"}

package/dist/browser/table-transfer.d.ts

@@ -0,0 +1,38 @@
+/** The registry only observes identity and DOM fields; adapter metadata stays opaque. */
+export type BrowserTransferSnapshot = {
+    config: {
+        coordinator: object;
+        scope: string;
+        tableId: string;
+    };
+    endpoint: {
+        tableId: string;
+    };
+    instanceId: string;
+    root: HTMLElement | null;
+    viewport: HTMLElement | null;
+};
+type Registration<TSnapshot> = {
+    getSnapshot: () => TSnapshot | null;
+};
+export declare function createTableTransferRegistry<TSnapshot extends BrowserTransferSnapshot>(): {
+    register(scope: string, tableId: string, registration: Registration<TSnapshot>): () => void;
+    get(scope: string, tableId: string): Registration<TSnapshot> | null;
+};
+export declare function getRegisteredTransferSnapshot<TSnapshot extends BrowserTransferSnapshot>(registry: ReturnType<typeof createTableTransferRegistry<TSnapshot>>, coordinator: object, scope: string, tableId: string): TSnapshot | null;
+export declare function getCrossTableTransferHit<TSnapshot extends BrowserTransferSnapshot>(input: {
+    sourceTableId: string;
+    scope: string;
+    instanceId: string;
+    root: HTMLElement | null;
+    clientX: number;
+    clientY: number;
+    document: Pick<Document, "elementFromPoint">;
+    getSnapshot: (tableId: string) => TSnapshot | null;
+}): {
+    element: HTMLElement;
+    root: HTMLElement;
+    snapshot: TSnapshot;
+} | null;
+export {};
+//# sourceMappingURL=table-transfer.d.ts.map

package/dist/browser/table-transfer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-transfer.d.ts","sourceRoot":"","sources":["../../src/browser/table-transfer.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE,QAAQ,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;CAC9B,CAAC;AACF,KAAK,YAAY,CAAC,SAAS,IAAI;IAAE,WAAW,EAAE,MAAM,SAAS,GAAG,IAAI,CAAA;CAAE,CAAC;AAEvE,wBAAgB,2BAA2B,CAAC,SAAS,SAAS,uBAAuB;IAGjF,QAAQ,QAAQ,MAAM,WAAW,MAAM,gBAAgB,YAAY,CAAC,SAAS,CAAC;IAe9E,GAAG,QAAQ,MAAM,WAAW,MAAM;EAKrC;AAED,wBAAgB,6BAA6B,CAAC,SAAS,SAAS,uBAAuB,EACrF,QAAQ,EAAE,UAAU,CAAC,OAAO,2BAA2B,CAAC,SAAS,CAAC,CAAC,EACnE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,oBAKpD;AAED,wBAAgB,wBAAwB,CAAC,SAAS,SAAS,uBAAuB,EAAE,KAAK,EAAE;IACzF,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC;IAC7C,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,SAAS,GAAG,IAAI,CAAC;CACpD;;;;SASA"}

package/dist/browser/viewport-requests.d.ts

@@ -0,0 +1,27 @@
+import type { CoreViewportRequest, CominsViewportDataEvent } from "../core/viewport/data";
+export type CominsViewportRequest = CoreViewportRequest & {
+    signal: AbortSignal;
+};
+type WithSignal<TEvent> = TEvent extends {
+    request: CoreViewportRequest;
+} ? Omit<TEvent, "request"> & {
+    request: CominsViewportRequest;
+} : TEvent;
+export type BrowserViewportDataEvent<T> = WithSignal<CominsViewportDataEvent<T>>;
+export declare function createViewportRequestExecutor(options: {
+    onRequest: (request: CominsViewportRequest) => void | Promise<void>;
+    onSettled: (requestId: string) => void;
+}): {
+    start(descriptor: CoreViewportRequest): void;
+    cancel: (requestId: string) => void;
+    release(requestId: string): void;
+    dispose(): void;
+};
+/** The consumer owns data; this boundary owns only execution and listener lifetime. */
+export declare function runViewportRequest<T>(input: {
+    request: CominsViewportRequest;
+    getRows: (request: CominsViewportRequest) => readonly T[] | Promise<readonly T[]>;
+    dispatch: (event: BrowserViewportDataEvent<T>) => void;
+}): Promise<void>;
+export {};
+//# sourceMappingURL=viewport-requests.d.ts.map

package/dist/browser/viewport-requests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewport-requests.d.ts","sourceRoot":"","sources":["../../src/browser/viewport-requests.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAE1F,MAAM,MAAM,qBAAqB,GAAG,mBAAmB,GAAG;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,CAAC;AAClF,KAAK,UAAU,CAAC,MAAM,IAAI,MAAM,SAAS;IAAE,OAAO,EAAE,mBAAmB,CAAA;CAAE,GAAG,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG;IAAE,OAAO,EAAE,qBAAqB,CAAA;CAAE,GAAG,MAAM,CAAC;AAClJ,MAAM,MAAM,wBAAwB,CAAC,CAAC,IAAI,UAAU,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,CAAC;AAEjF,wBAAgB,6BAA6B,CAAC,OAAO,EAAE;IACrD,SAAS,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;sBAUqB,mBAAmB;wBAPZ,MAAM;uBAuBZ,MAAM;;EAS5B;AAED,uFAAuF;AACvF,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,KAAK,EAAE;IACjD,OAAO,EAAE,qBAAqB,CAAC;IAC/B,OAAO,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,SAAS,CAAC,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAClF,QAAQ,EAAE,CAAC,KAAK,EAAE,wBAAwB,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;CACxD,GAAG,OAAO,CAAC,IAAI,CAAC,CAchB"}

package/dist/cell-fill.d.ts

@@ -0,0 +1,25 @@
+import { type RefObject } from "react";
+import type { CominsCellAddress, CominsCellRange, CominsRowId, CominsTableState } from "./react/core-compat";
+/** Private gesture controller. All writes go through the owning Table's batch callback. */
+export declare function useCominsCellFill<TData>(options: {
+    enabled: boolean;
+    state: CominsTableState<TData>;
+    rowIds: readonly CominsRowId[];
+    columnIds: readonly string[];
+    root: RefObject<HTMLDivElement | null>;
+    viewport: RefObject<HTMLDivElement | null>;
+    addressAtPoint: (x: number, y: number) => CominsCellAddress | null;
+    canUseRange: (range: CominsCellRange) => boolean;
+    onFill: (source: CominsCellRange, target: CominsCellRange) => boolean;
+    registerGesture: (cleanup: () => void) => void;
+    releaseGesture: (cleanup: () => void) => void;
+    scrollHorizontal: (delta: number) => void;
+}): {
+    fillSelection: (direction: "down" | "right") => boolean;
+    preview: CominsCellRange | null;
+    isPreview: (address: CominsCellAddress) => boolean;
+    handleAddress: CominsCellAddress | null;
+    handle: import("react").JSX.Element;
+    menu: import("react").JSX.Element | null;
+};
+//# sourceMappingURL=cell-fill.d.ts.map

package/dist/cell-fill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cell-fill.d.ts","sourceRoot":"","sources":["../src/cell-fill.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAgF,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACrH,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAI7G,2FAA2F;AAC3F,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC/B,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IAC/B,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,IAAI,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACvC,QAAQ,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC3C,cAAc,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,iBAAiB,GAAG,IAAI,CAAC;IACnE,WAAW,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC;IACjD,MAAM,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC;IACtE,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IAC/C,cAAc,EAAE,CAAC,OAAO,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IAC9C,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3C;+BAyBmC,MAAM,GAAG,OAAO;;yBA2E3B,iBAAiB;;;;EAqBzC"}