@adapttable/unstyled 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,37 @@
+# @adapttable/unstyled
+
+## 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,91 @@
+# @adapttable/unstyled
+
+The **headless, unstyled** adapter for [AdaptTable](https://github.com/orwa-mahmoud/adapttable).
+Renders semantic HTML with `data-adapttable-part` + `data-*` state hooks
+and per-part `className` overrides — style it with **Tailwind**, **shadcn/ui**,
+or your own CSS. Ships zero styles.
+
+```bash
+pnpm add @adapttable/unstyled @adapttable/core react react-dom
+```
+
+## Quickstart
+
+```tsx
+import {
+  DataTable,
+  useFrontendData,
+  type ColumnDef,
+} from "@adapttable/unstyled";
+
+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}
+      classNames={{
+        table: "w-full text-sm",
+        headerCell: "text-left font-medium text-zinc-500 px-3 py-2",
+        row: "border-b hover:bg-zinc-50 data-[selected]:bg-blue-50",
+        cell: "px-3 py-2",
+      }}
+    />
+  );
+}
+```
+
+## Styling hooks
+
+Every node carries:
+
+- `data-adapttable-part="…"` — `root`, `toolbar`, `search-field`,
+  `search-icon`, `search`, `filters-button`, `filters-icon`, `column-menu`,
+  `table`, `row`, `cell`, `header-cell`, `sort-button`, `chips`, `chip`,
+  `bulk-bar`, `footer`, `empty`, `loading`, `error`, `card`, …
+- `data-*` state — `data-selected` on selected rows/cards, `data-sorted`
+  (`asc`/`desc`) on the active header, `data-mobile` on the root, and
+  `data-density` (`comfortable`/`compact`) on the root. The adapter ships no
+  density styles — drive spacing yourself, e.g.
+  `[data-density="compact"] [data-adapttable-part="cell"] { padding: 4px 8px; }`.
+- A per-part `className` from the `classNames` prop.
+
+Target them with attribute selectors (`[data-adapttable-part="row"]`),
+Tailwind data variants (`data-[selected]:bg-blue-50`), or class overrides.
+
+The leading search/funnel glyphs render as inline `currentColor` SVGs in the
+`search-icon` / `filters-icon` slots, so you can restyle or hide them via the
+`searchIcon` / `filtersIcon` class names (or the matching `data-adapttable-part`
+selectors). `SearchIcon` and `FiltersIcon` are also exported for reuse.
+
+## Empty / loading overrides
+
+Replace the empty-state or first-load skeleton with the top-level
+`emptyState` / `loadingState` props, or with the cross-adapter `slots` alias —
+whichever your other adapters already use:
+
+```tsx
+<DataTable
+  source={source}
+  columns={columns}
+  rowKey={(r) => r.id}
+  slots={{ empty: <MyEmpty />, skeleton: <MySkeleton /> }}
+/>
+```
+
+`slots.empty` / `slots.skeleton` take precedence when both forms are supplied
+(`slots.empty ?? emptyState`, `slots.skeleton ?? loadingState`).
+
+Everything else — client/server data, URL state, sorting, filtering,
+selection + bulk actions, RTL (`dir`), auto desktop/mobile — works the same
+as the other adapters, on the headless `@adapttable/core` engine.
+
+## License
+
+[MIT](../../LICENSE) © Orwa Mahmoud