comins-table 0.2.1 → 0.2.3

package/CHANGELOG.md

@@ -2,6 +2,91 @@
 
 ## Unreleased
 
+## 0.2.3 - 2026-11-04
+
+### Fixed
+
+- Release cancelled Viewport request callbacks without waiting for a consumer Promise that ignores AbortSignal, while continuing to ignore late results.
+
+- Keep production Playground XLSX compression inside its existing Worker to avoid nested Worker teardown retention, while preserving workbook contents and the main-thread export path.
+
+- Preserve default grouped column order without running requested-order lock and segment reconciliation when no order is supplied, while keeping explicit reorder behavior unchanged.
+
+- Reuse the normalized column ID projection within each column-order calculation, avoiding two temporary arrays while preserving pinned, locked, and grouped ordering.
+
+- Reapply the Viewport height-cache budget after ResizeObserver measurement batches, retaining the current required blocks without waiting for another scroll or data request.
+
+- Avoid rebuilding the Playground value-filter toolbar when only filter model or popup state changes, while preserving locale updates and controlled inputs.
+
+- Limit row-detail disclosure refs to their DOM registry and row ID so a retired native event Fiber does not retain row data and application callbacks.
+
+- Limit grouped-row disclosure refs to their DOM registry and group ID so a retired event Fiber does not retain grouping callbacks and table rows.
+
+- Keep native value-filter checkbox ref installers limited to the indeterminate flag so the last event Fiber cannot retain retired table rows through filter callbacks.
+
+- Preserve newer horizontal scroll requests and native keyboard scrolling by ignoring synchronization echoes, and align newly mounted headers and summaries with the current body position.
+
+- Release focused search inputs in the Playground-owned custom value-filter panels before sidebar navigation, while preserving the library custom-panel getter contract.
+
+- Limit value-filter search ref callbacks to their ref object so a retired input does not retain its table through filter render closures.
+
+- Release focused built-in filter inputs and their popups before Playground sidebar route unmounts, while preserving custom input blur contracts and cancelled or modified navigation.
+
+- Prevent stale Viewport row-height anchors from overriding a newer scroll before its scroll event is delivered.
+
+- Preserve a newer scroll request when an earlier automatic-height anchor correction commits before its scroll event, while retaining normal browser bottom clamping.
+
+- Pin development and Playground React tooling to 19.3.0 to use upstream Performance Tracks cleanup and avoid large-props diagnostic failures; keep the published React peer support range unchanged.
+
+- Release focused built-in Virtual List search subtrees before Playground sidebar route changes, while preserving cancelled, modified, same-route, and application-owned input blur behavior.
+- Reapply the Viewport cache budget when cancelled requests or superseded responses stop protecting old blocks, while preserving visible blocks, active requests, and newer retained edits.
+- Use the latest committed Header Menu callbacks and payload for outside/Escape dismissal, and keep native listeners and cleanup closures from retaining replaced menu configuration while open.
+- Blur focused filter inputs before outside-pointer dismissal removes their popup, releasing React selection tracking without stealing the clicked destination focus.
+- Preserve reconciled React table inputs when controlled columns and imperative layout restoration update in one commit, avoiding stale state overwrites that can leave restored columns missing.
+- Keep Playground column-selector Portal listeners on a popover-owned body child and remove that host on close or unmount, avoiding persistent body delegation after use.
+- Keep scroll-anchor fallback linear when every row key changes, avoiding synchronous renderer stalls during large data replacement while preserving predecessor and duplicate-key selection.
+- Avoid coercing hidden raw cell values to strings when a custom renderer or visible built-in component supplies the content, while preserving explicit formatter callbacks and input/select fallback text.
+- Keep default cell heights aligned with the row model without a global CSS reset, preventing intrinsic viewport/filler resize feedback.
+- Avoid React state projection for empty selected-cell ranges.
+
+- Stop viewport observations before DOM removal, ignore retired resize deliveries, and avoid state dispatches from column interaction unmount cleanup while resetting interrupted interactions on effect reconnection.
+
+- Avoid Chromium paged-media query cache accumulation for table header/footer groups on scrolling screens while preserving print fragmentation.
+
+- Release replaced initial React table data retained by mount-lifetime measurement and cleanup closures, including disabled cell fill.
+
+## 0.2.2 - 2026-10-13
+
+- Playground: display complete remote-loading responses and CSV/XLSX datasets, start file examples with 1000 rows, and reset article scrolling on page navigation.
+
+- Add framework-neutral Excel Export styles: a default Comins theme, plain mode and header/body/column overrides for fonts, colors, borders, alignment, widths and number formats.
+- Replace the XML parser and Export engine while preserving typed Import, literal text and byte-only package boundaries.
+
+- Add `comins-table/xlsx` byte APIs for typed ordinary-row import/export, cached formula results and formatted dates.
+- Validate actual inflated ZIP bytes/CRC, visible sheet selection and atomic mapping; add Worker-based Playground with cancellation and full virtualized datasets.
+
+### Value list filtering
+
+- Add framework-neutral value-list filtering, search-scoped selection, other-column facet counts and JSON-compatible controlled models.
+- Add React filter trigger/option/panel render and class/style customization with native/custom control bindings.
+- Preserve condition filtering, explicit empty selections and selected values missing from refreshed data; provide bilingual guides and Playground examples.
+
+### Rendering customization
+
+### Added
+
+- Standard `render` paths for cell/header content, row details, group labels/content, Tree slots, transfer rejection tooltips, loading and empty content. Legacy APIs retain their 0.x behavior; removal targets 1.0.0.
+- Summary `render` after aggregation and formatting, with original `value` and `formattedValue` payloads.
+- Informational custom cell tooltips via `cell.tooltip.render`, including hover/focus, Escape and virtualization cleanup. Existing native string tooltips remain compatible.
+
+### Changed
+
+- Playground examples use standard rendering paths. English and Korean 0.2.2 migration guides document precedence, return values and content boundaries.
+
+### Fixed
+
+- The Playground Context Menu opener keeps its menu inside the viewport when the button is near the bottom edge.
+
 ## 0.2.1 - 2026-10-04
 
 ### Fixed

package/README.md

@@ -2,7 +2,7 @@
 
 <a href="https://comins-website.vercel.app/ko/"><img src="https://raw.githubusercontent.com/kim1124/comins-table/main/example/public/comins-symbol.svg" width="64" height="64" alt="Comins brand website" /></a>
 
-A React data table backed by a framework-neutral TypeScript core. Build data-heavy screens with application-owned data, virtualized rows, Tree Grid, grouping, and customizable cells.
+A React data table backed by the framework-neutral TypeScript `comins-table/core`. Build data-heavy screens with application-owned data, virtualized rows, Tree Grid, grouping, and customizable cells.
 
 [![npm version](https://img.shields.io/npm/v/comins-table)](https://www.npmjs.com/package/comins-table)
 [![TypeScript declarations](https://img.shields.io/npm/types/comins-table)](https://www.npmjs.com/package/comins-table)
@@ -14,6 +14,10 @@ A React data table backed by a framework-neutral TypeScript core. Build data-hea
 · [Comins Brand](https://comins-website.vercel.app/ko/)
 · [Changelog](https://github.com/kim1124/comins-table/blob/main/CHANGELOG.md)
 
+0.2.3 improves lifecycle cleanup, Viewport cancellation and cache release, scrolling, and Playground rendering costs while preserving the existing API.
+
+0.2.2: standard `render` customization with 0.x compatibility, value list filters, and styled Excel import/export. [한국어 전환 안내](https://github.com/kim1124/comins-table/blob/main/docs/ko/27-migration-0.2.2.md) · [English migration](https://github.com/kim1124/comins-table/blob/main/docs/user/27-migration-0.2.2.md).
+
 ![Comins Table: clipboard and Fill Handle, Tree drag, automatic row heights, and Viewport loading](https://raw.githubusercontent.com/kim1124/comins-table/main/docs/assets/comins-table-overview.gif)
 
 The preview was recorded with 0.1.11. Feature-specific recordings and examples are available in the guides.
@@ -91,7 +95,7 @@ Open [the Playground](http://127.0.0.1:4002/docs/getting-started). The [Playgrou
 
 ## Version and support
 
-**0.2.1** adds framework-neutral CSV import, Tree/Group export metadata, and React Tree node slots. The framework-neutral `comins-table/core` contract introduced in 0.2.0 remains compatible; React helpers and rendering types stay at `comins-table`, while `/clipboard` and `/selection` retain their React-state contracts. See the migration guides above and the [changelog](https://github.com/kim1124/comins-table/blob/main/CHANGELOG.md) for version history.
+**0.2.2** adds standard `render` customization, customizable value list filters, and framework-neutral Excel import/export with export styles. Existing 0.x rendering aliases remain compatible until 1.0.0. See the migration guides above and the [changelog](https://github.com/kim1124/comins-table/blob/main/CHANGELOG.md) for version history.
 
 The Table UI is client-only React; SSR and a Vue adapter are not currently supported. Chrome and Edge are the supported browser targets, with automated browser checks using Playwright Chromium. Firefox and Safari are outside the current support contract. Feature combinations and limits are documented in the corresponding guides.
 

package/THIRD_PARTY_NOTICES.md

@@ -119,3 +119,7 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
+
+## XLSX external runtime dependencies
+
+The independent `comins-table/xlsx` entry imports SheetJS CE `xlsx` 0.20.3 (Apache-2.0, official supplier artifact), `@zip.js/zip.js` 2.23.0 (BSD-3-Clause) `@federicocarboni/saxe` 0.8.0 (Apache-2.0) and `write-excel-file` 4.1.1 (MIT), with `fflate` 0.8.3 (MIT) transitively. Comins preserves these as external imports and does not copy their source into its library chunks. Their installed packages contain the applicable license texts. Downstream applications that bundle them must preserve the corresponding license/notice obligations. The ZIP native JS entry includes a JavaScript fallback and does not request a runtime WASM asset.

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

@@ -1 +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"}
+{"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,cAUT;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/viewport-requests.d.ts.map

@@ -1 +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"}
+{"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,CAsBhB"}

package/dist/cell-fill.d.ts

@@ -15,6 +15,13 @@ export declare function useCominsCellFill<TData>(options: {
     releaseGesture: (cleanup: () => void) => void;
     scrollHorizontal: (delta: number) => void;
 }): {
+    fillSelection: (direction: "down" | "right") => boolean;
+    preview: CominsCellRange | null;
+    isPreview: () => boolean;
+    handleAddress: null;
+    handle: null;
+    menu: null;
+} | {
     fillSelection: (direction: "down" | "right") => boolean;
     preview: CominsCellRange | null;
     isPreview: (address: CominsCellAddress) => boolean;

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

@@ -1 +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"}
+{"version":3,"file":"cell-fill.d.ts","sourceRoot":"","sources":["../src/cell-fill.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAqG,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAC1I,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAQ7G,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;+BA6BmC,MAAM,GAAG,OAAO;;;;;;;;;yBA6E3B,iBAAiB;;;;EAqBzC"}