@parqui/react 1.2.0 → 1.2.2

package/LICENSE

@@ -0,0 +1,18 @@
+Business Source License 1.1
+
+SPDX short identifier: BUSL-1.1
+
+Copyright (c) 2026 Parqui
+
+Use of this package is governed by the Business Source License 1.1.
+The licensor for this package is Parqui.
+
+Additional Use Grant:
+- Personal, educational, and open-source usage is permitted at no cost.
+- Commercial usage requires a paid Parqui commercial license.
+
+Change Date: 2030-01-01
+Change License: Apache-2.0
+
+For the full legal text of Business Source License 1.1, see:
+https://mariadb.com/bsl11/

package/README.md

@@ -0,0 +1,78 @@
+# @parqui/react
+
+[![npm version](https://img.shields.io/npm/v/%40parqui%2Freact)](https://www.npmjs.com/package/@parqui/react)
+[![npm downloads](https://img.shields.io/npm/dm/%40parqui%2Freact)](https://www.npmjs.com/package/@parqui/react)
+
+High-performance React Parquet file viewer component for Apache Parquet datasets. Includes virtual scrolling data grid, filtering, sorting, grouping, search, and column controls.
+
+## Why `@parqui/react`
+
+- Plug-and-play Parquet viewer for React 18/19
+- Virtualized table for large parquet files
+- Built-in filtering, multi-sort, grouping, and quick search
+- Keyboard navigation and interactive column management
+- Fully client-side: inspect parquet data without server uploads
+
+## Installation
+
+```bash
+npm install @parqui/react
+```
+
+Peer dependencies:
+
+- `react` `^18 || ^19`
+- `react-dom` `^18 || ^19`
+
+## Quick Start
+
+```tsx
+import { Parkui } from "@parqui/react";
+
+export function App() {
+  return (
+    <div style={{ height: "80vh" }}>
+      <Parkui />
+    </div>
+  );
+}
+```
+
+Open behavior:
+
+- If no `source` is passed, users can open a local `.parquet` file via the built-in UI.
+- You can pass a predefined source from `@parqui/core` for controlled integrations.
+
+```tsx
+import { Parkui } from "@parqui/react";
+import { sourceFromUrl } from "@parqui/core";
+
+const source = sourceFromUrl("https://example.com/data/events.parquet");
+
+export function App() {
+  return <Parkui source={source} />;
+}
+```
+
+## Key Props
+
+- `source`: predefined parquet source (`File`, URL source, or custom `ParquetSource`)
+- `columns`: limit visible columns
+- `allowOpen`: enable/disable built-in file open flow
+- `showToolbar`: show/hide toolbar with search and pipeline chips
+- `onMetadataLoad`: callback when parquet metadata is available
+- `onRequestOpen`: custom open handler for desktop/in-app file pickers
+
+## Package Ecosystem
+
+- Core engine: [`@parqui/core`](https://www.npmjs.com/package/@parqui/core)
+- Vue wrapper: [`@parqui/vue`](https://www.npmjs.com/package/@parqui/vue)
+- Angular wrapper: [`@parqui/angular`](https://www.npmjs.com/package/@parqui/angular)
+
+## Links
+
+- Website: [parqui.dev](https://parqui.dev)
+
+## License
+
+Business Source License 1.1 (`BUSL-1.1`). See `LICENSE`.

package/dist/index.cjs

@@ -514,18 +514,18 @@ function useParquetData(inputSource, columns, searchText) {
     }
     compute();
   }, [sourceState.source, sourceState.metadata, sourceState.totalRows, pipeline, searchText]);
-  const toggleSort = (0, import_react4.useCallback)((column) => {
+  const toggleSort = (0, import_react4.useCallback)((column, multi = false) => {
     setPipeline((prev) => {
       const existing = prev.sorts.find((s2) => s2.column === column);
       let newSorts;
       if (!existing) {
-        newSorts = [...prev.sorts, { column, direction: "asc" }];
+        newSorts = multi ? [...prev.sorts, { column, direction: "asc" }] : [{ column, direction: "asc" }];
       } else if (existing.direction === "asc") {
-        newSorts = prev.sorts.map(
+        newSorts = multi ? prev.sorts.map(
           (s2) => s2.column === column ? { ...s2, direction: "desc" } : s2
-        );
+        ) : [{ column, direction: "desc" }];
       } else {
-        newSorts = prev.sorts.filter((s2) => s2.column !== column);
+        newSorts = multi ? prev.sorts.filter((s2) => s2.column !== column) : [];
       }
       return { ...prev, sorts: newSorts };
     });
@@ -1806,7 +1806,7 @@ function ColumnHeader({
   const handleClick = (0, import_react11.useCallback)(
     (e) => {
       if (e.target.dataset.resize) return;
-      onSortClick(column.key);
+      onSortClick(column.key, e.ctrlKey || e.metaKey);
     },
     [column.key, onSortClick]
   );
@@ -3139,7 +3139,7 @@ function Parkui({
     [keyboard, scrollRowCount, colManager.visibleColumns.length]
   );
   const handleSortClick = (0, import_react16.useCallback)(
-    (column) => pq.toggleSort(column),
+    (column, multi) => pq.toggleSort(column, multi),
     [pq.toggleSort]
   );
   const handleContextMenu = (0, import_react16.useCallback)(