@novastera-oss/material-react-table 4.0.0-beta.11

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Kevin Vandy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+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.

package/README.md

@@ -0,0 +1,203 @@
+# Material React Table V4
+
+This is a fork of [Material React Table](https://www.material-react-table.com/). It was created to provide maintenance and update dependencies to the latest standards, including support for:
+- Material UI v9
+- React 19 (Optimized: No `forwardRef`, internal performance stability)
+- Vite 8 & Rollup 4
+- ESLint 10
+- TypeScript 6 (Zero runtime helpers)
+
+The original repository has not seen updates for over a year and the v9 beta lacked progress. This version ensures the library remains usable in modern development stacks.
+
+# Material React Table V3
+
+View [Documentation](https://www.material-react-table.com/)
+
+## About
+
+### _Quickly Create React Data Tables with Material Design_
+
+### **Built with [Material UI <sup>V9</sup>](https://mui.com) and [TanStack Table <sup>V8</sup>](https://tanstack.com/table/v8)**
+
+<img src="https://material-react-table.com/banner.png" alt="MRT" height="50" />
+
+> Want to use Mantine instead of Material UI? Check out [Mantine React Table](https://www.mantine-react-table.com)
+
+## Learn More
+
+- Join the [Discord](https://discord.gg/5wqyRx6fnm) server to join in on the development discussion or ask questions
+- View the [Docs Website](https://www.material-react-table.com/)
+- See all [Props, Options, APIs, Components, and Hooks](https://www.material-react-table.com/docs/api)
+
+### Quick Examples
+
+- [Basic Table](https://www.material-react-table.com/docs/examples/basic/) (See Default Features)
+- [Minimal Table](https://www.material-react-table.com/docs/examples/minimal/) (Turn off Features like Pagination, Sorting, Filtering, and Toolbars)
+- [Advanced Table](https://www.material-react-table.com/docs/examples/advanced/) (See some of the Advanced Features)
+- [Custom Headless Table](https://www.material-react-table.com/docs/examples/custom-headless/) (Build your own table markup)
+- [Dragging / Ordering Examples](https://www.material-react-table.com/docs/examples/column-ordering/) (Drag and Drop)
+- [Editing (CRUD) Examples](https://www.material-react-table.com/docs/examples/editing-crud/) (Create, Edit, and Delete Rows)
+- [Expanding / Grouping Examples](https://www.material-react-table.com/docs/examples/aggregation-and-grouping/) (Sum, Average, Count, etc.)
+- [Filtering Examples](https://www.material-react-table.com/docs/examples/filter-variants/) (Faceted Values, Switching Filters, etc.)
+- [Sticky Pinning Examples](https://www.material-react-table.com/docs/examples/sticky-header/) (Sticky Headers, Sticky Columns, Sticky Rows, etc.)
+- [Remote Data Fetching Examples](https://www.material-react-table.com/docs/examples/react-query/) (Server-side Pagination, Sorting, and Filtering)
+- [Virtualized Examples](https://www.material-react-table.com/docs/examples/virtualized/) (10,000 rows at once!)
+- [Infinite Scrolling](https://www.material-react-table.com/docs/examples/infinite-scrolling/) (Fetch data as you scroll)
+- [Localization (i18n)](https://www.material-react-table.com/docs/guides/localization#built-in-locale-examples) (Over a dozen languages built-in)
+
+View additional [storybook examples](https://www.material-react-table.dev/)
+
+## Features
+
+_All features can easily be enabled/disabled_
+
+_**Fully Fleshed out [Docs](https://www.material-react-table.com/docs/guides#guides) are available for all features**_
+
+- [x] 30-56kb gzipped - [Bundlephobia](https://bundlephobia.com/package/material-react-table)
+- [x] Advanced TypeScript Generics Support (TypeScript Optional)
+- [x] Aggregation and Grouping (Sum, Average, Count, etc.)
+- [x] Cell Actions (Right-click Context Menu)
+- [x] Click To Copy Cell Values
+- [x] Column Action Dropdown Menu
+- [x] Column Hiding
+- [x] Column Ordering via Drag'n'Drop
+- [x] Column Pinning (Freeze Columns)
+- [x] Column Resizing
+- [x] Customize Icons
+- [x] Customize Styling of internal Mui Components
+- [x] Data Editing and Creating (5 different editing modes)
+- [x] Density Toggle
+- [x] Detail Panels (Expansion)
+- [x] Faceted Value Generation for Filter Options
+- [x] Filtering (supports client-side and server-side)
+- [x] Filter Match Highlighting
+- [x] Full Screen Mode
+- [x] Global Filtering (Search across all columns, rank by best match)
+- [x] Header Groups & Footers
+- [x] Localization (i18n) support
+- [x] Manage your own state or let the table manage it internally for you
+- [x] Pagination (supports client-side and server-side)
+- [x] Row Actions (Your Custom Action Buttons)
+- [x] Row Numbers
+- [x] Row Ordering via Drag'n'Drop
+- [x] Row Pinning
+- [x] Row Selection (Checkboxes)
+- [x] SSR compatible
+- [x] Sorting (supports client-side and server-side)
+- [x] Theming (Respects your Material UI Theme)
+- [x] Toolbars (Add your own action buttons)
+- [x] Tree Data / Expanding Sub-rows
+- [x] Virtualization (@tanstack/react-virtual)
+
+## Getting Started
+
+### Installation
+
+View the full [Installation Docs](https://www.material-react-table.com/docs/getting-started/install)
+
+1. Ensure that you have React 19 or later installed
+
+2. Install Peer Dependencies (Material UI V9)
+
+```bash
+npm install @mui/material @mui/x-date-pickers @mui/icons-material @emotion/react @emotion/styled
+```
+
+3. Install material-react-table
+
+```bash
+npm install material-react-table
+```
+
+> _`@tanstack/react-table`, `@tanstack/react-virtual`, and `@tanstack/match-sorter-utils`_ are internal dependencies, so you do NOT need to install them yourself.
+
+### Usage
+
+> Read the full usage docs [here](https://www.material-react-table.com/docs/getting-started/usage/)
+
+```jsx
+import { useMemo, useState, useEffect } from 'react';
+import {
+  MaterialReactTable,
+  useMaterialReactTable,
+} from 'material-react-table';
+
+//data must be stable reference (useState, useMemo, useQuery, defined outside of component, etc.)
+const data = [
+  {
+    name: 'John',
+    age: 30,
+  },
+  {
+    name: 'Sara',
+    age: 25,
+  },
+];
+
+export default function App() {
+  const columns = useMemo(
+    () => [
+      {
+        accessorKey: 'name', //simple recommended way to define a column
+        header: 'Name',
+        muiTableHeadCellProps: { sx: { color: 'green' } }, //optional custom props
+        Cell: ({ cell }) => <span>{cell.getValue()}</span>, //optional custom cell render
+      },
+      {
+        accessorFn: (row) => row.age, //alternate way
+        id: 'age', //id required if you use accessorFn instead of accessorKey
+        header: 'Age',
+        Header: () => <i>Age</i>, //optional custom header render
+      },
+    ],
+    [],
+  );
+
+  //optionally, you can manage any/all of the table state yourself
+  const [rowSelection, setRowSelection] = useState({});
+
+  useEffect(() => {
+    //do something when the row selection changes
+  }, [rowSelection]);
+
+  const table = useMaterialReactTable({
+    columns,
+    data,
+    enableColumnOrdering: true, //enable some features
+    enableRowSelection: true,
+    enablePagination: false, //disable a default feature
+    onRowSelectionChange: setRowSelection, //hoist internal state to your own state (optional)
+    state: { rowSelection }, //manage your own state, pass it back to the table (optional)
+  });
+
+  const someEventHandler = () => {
+    //read the table state during an event from the table instance
+    console.log(table.getState().sorting);
+  };
+
+  return (
+    <MaterialReactTable table={table} /> //other more lightweight MRT sub components also available
+  );
+}
+```
+
+_Open in [Code Sandbox](https://codesandbox.io/s/simple-material-react-table-example-t5c3ji)_
+
+## Contributors
+
+<a href="https://github.com/kevinvandy/material-react-table/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=kevinvandy/material-react-table" />
+</a>
+
+PRs are Welcome, but please discuss in [GitHub Discussions](https://github.com/KevinVandy/material-react-table/discussions) or the [Discord Server](https://discord.gg/5wqyRx6fnm) first if it is a large change!
+
+Read the [Contributing Guide](https://github.com/KevinVandy/material-react-table/blob/v3/CONTRIBUTING.md) to learn how to run this project locally.
+
+<!-- Use the FORCE, Luke! -->
+## About Novastera
+
+**Material React Table V4** is maintained by **Novastera** as part of our commitment to the open-source community. This fork was established to ensure that one of the React table libraries remains compatible with the latest versions of Material UI and receives the active maintenance it deserves.
+
+We step in where others stall—providing stability, modern dependency support, and a reliable path forward for production applications.
+
+Learn more: [https://novastera.com/resources](https://novastera.com/resources)