@adapttable/mui 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,37 @@
+# @adapttable/mui
+
+## 0.1.0
+
+### Minor Changes
+
+- 845ff41: Initial public release of AdaptTable — a headless, UI-agnostic React data
+  table: one API, rendered natively by your design system.
+  - `@adapttable/core`: the headless engine — declarative `columns` (bare
+    keys, dot-paths, auto headers) and `filters` (one definition drives the
+    widget, URL params, chips, and predicate, with `"auto"` and async option
+    sources), three data tiers (in-memory, server via one consolidated
+    `onQueryChange(query, { signal })`, or a full custom `TableSource`),
+    URL-synced state with an injectable adapter (`urlSync={false}` for
+    in-memory), multi-sort, summary rows, header groups, row expansion,
+    saved views, select-all-N-matching, keyboard row navigation, and opt-in
+    row/card virtualization that tracks the page or any `maxHeight` scroll
+    box — 50,000 rows stay a handful of DOM nodes.
+  - Batteries-included adapters for **Mantine**, **MUI**, **Chakra UI**,
+    **Ant Design**, and **Tailwind/shadcn** (`@adapttable/unstyled`): native
+    filter forms with operator-first number/date ranges, column management
+    (hide / reorder / pin / resize — the row-actions column included), a
+    built-in saved-views menu, mobile card layouts, and memoized rows.
+  - `@adapttable/i18n`: label presets for ten locales (en, ar, de, es, fr,
+    he, it, ja, pt, zh) with RTL helpers — headers, cells, sorting and
+    filtering can all follow per-locale data paths.
+  - `@adapttable/cli`: `npx @adapttable/cli init` detects your kit and
+    scaffolds a working table.
+
+  Highlights: shareable URL state, paging and true infinite scroll (auto by
+  device), first-class RTL, seamless dark mode, 100% test coverage, and a
+  full headless escape hatch at every layer.
+
+### Patch Changes
+
+- Updated dependencies [845ff41]
+  - @adapttable/core@0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Orwa Mahmoud
+
+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,50 @@
+# @adapttable/mui
+
+The **Material UI adapter** for [AdaptTable](https://github.com/orwa-mahmoud/adapttable) —
+a batteries-included MUI data table with sorting, filtering, URL-synced
+state, selection + bulk actions, RTL, and dark mode. A free, headless
+**alternative to MUI X DataGrid** built on `@adapttable/core`.
+
+```bash
+pnpm add @adapttable/mui @adapttable/core @mui/material @emotion/react @emotion/styled react react-dom
+```
+
+## Quickstart
+
+```tsx
+import { DataTable, useFrontendData, type ColumnDef } from "@adapttable/mui";
+
+interface Person {
+  id: string;
+  name: string;
+  city: string;
+}
+
+const columns: ColumnDef<Person>[] = [
+  { key: "name", header: "Name", accessor: (r) => r.name, sortable: true },
+  { key: "city", header: "City", accessor: (r) => r.city },
+];
+
+export function People({ data }: { data: Person[] }) {
+  const source = useFrontendData({ data, columns });
+  return <DataTable source={source} columns={columns} rowKey={(r) => r.id} />;
+}
+```
+
+Wrap your app in MUI's `ThemeProvider` to control light/dark mode and RTL,
+as usual. Swap `useFrontendData` for `useBackendData` to drive the table
+from a server-paginated query — the component doesn't change.
+
+## Features
+
+- Client or server data through one `TableSource`.
+- URL-synced search / sort / filters / page.
+- `TableSortLabel` headers, `Checkbox` selection + bulk actions with confirm.
+- Filter drawer + removable `Chip`s.
+- `Pagination` footer, `Skeleton` loading, `Alert` error with retry.
+- Auto desktop table ↔ mobile cards.
+- `slots` (skeleton, empty), `className`, `size`, injectable `confirm`.
+
+## License
+
+[MIT](../../LICENSE) © Orwa Mahmoud