@coldsmirk/ledger-mantine 0.1.0 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Venus
+
+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

@@ -1,15 +1,22 @@
 # @coldsmirk/ledger-mantine
 
-A Mantine-native `<DataTable>` built on [TanStack Table](https://tanstack.com/table) and [TanStack Virtual](https://tanstack.com/virtual): sorting, filtering, pagination, row selection, column pinning/resizing/visibility, master–detail expansion, inline cell editing, and adaptive row virtualization — rendered as a real `<table>` with Mantine's table styling.
+[![npm version](https://img.shields.io/npm/v/%40coldsmirk%2Fledger-mantine)](https://www.npmjs.com/package/@coldsmirk/ledger-mantine)
+[![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/coldsmirk/ledger/blob/main/LICENSE)
 
-> **Status: implemented and pre-release.** The component, documentation, tests, build, and package validation gates are in place. The package has not been published to npm yet.
+A Mantine-native `<DataTable>` built on [TanStack Table](https://tanstack.com/table) and [TanStack Virtual](https://tanstack.com/virtual): sorting, filtering, pagination, row selection, column pinning/resizing/visibility, master–detail expansion, tree data, grouping, inline editing, row reordering, and row/column virtualization — rendered as a real `<table>` with Mantine's table styling.
 
-## Install
+**Live demo:** [coldsmirk.github.io/ledger](https://coldsmirk.github.io/ledger/) — one page per feature area, each with a view-source drawer.
+
+> Pre-1.0: the public surface is complete and documented, but minor releases may still contain breaking changes while the API settles.
+
+## Installation
 
 ```bash
-pnpm add @coldsmirk/ledger-mantine @mantine/core @mantine/dates @mantine/hooks dayjs react react-dom
+pnpm add @coldsmirk/ledger-mantine
 ```
 
+Peer dependencies: `@mantine/core`, `@mantine/dates`, and `@mantine/hooks` `^9.0.0`; `react` and `react-dom` `^19.2.0`; and `dayjs` as required by `@mantine/dates`. `@tanstack/react-table` and `@tanstack/react-virtual` are direct dependencies — everything a table needs is re-exported from the main entry.
+
 Import Mantine's styles and ledger's layered stylesheet once at the application entry point:
 
 ```tsx
@@ -18,8 +25,6 @@ import "@mantine/dates/styles.css";
 import "@coldsmirk/ledger-mantine/styles.css";
 ```
 
-Peer dependencies: `@mantine/core`, `@mantine/dates`, and `@mantine/hooks` `^9`; `react` and `react-dom` `^19.2`; and `dayjs` as required by `@mantine/dates`.
-
 ## First table
 
 ```tsx
@@ -46,4 +51,13 @@ export function PeopleTable({ people }: { people: Person[] }) {
 
 The behavior layer speaks TanStack's language (raw `ColumnDef`, verbatim state shapes, `enable*` switches), while the presentation layer speaks Mantine's (forwarded `Table` style props, `BoxProps` sizing, Styles API).
 
-See the repository's [getting-started guide](https://github.com/coldsmirk/ledger/blob/main/docs/getting-started.md), [feature guides](https://github.com/coldsmirk/ledger/tree/main/docs), and [complete API reference](https://github.com/coldsmirk/ledger/blob/main/docs/api.md).
+## Documentation
+
+- [Getting started](https://github.com/coldsmirk/ledger/blob/main/docs/getting-started.md) — install, first table, sugar vs hook mode, app-wide defaults
+- [Feature guides](https://github.com/coldsmirk/ledger/tree/main/docs) — one authoritative guide per feature area
+- [API reference](https://github.com/coldsmirk/ledger/blob/main/docs/api.md) — the complete public surface with defaults
+- [Recipes](https://github.com/coldsmirk/ledger/blob/main/docs/recipes.md) — server tables, URL sync, CSV download, and more
+
+## License
+
+[MIT](https://github.com/coldsmirk/ledger/blob/main/LICENSE)

package/dist/index.cjs

@@ -147,9 +147,10 @@ const dateRange = (row, columnId, filterValue) => {
 };
 dateRange.autoRemove = (value) => !value || !value[0] && !value[1];
 /**
-* Strict set membership for the multi-select variant. TanStack's `arrIncludesSome` expects an
-* array row value and degrades to substring matching on scalars ("active" would match
-* "inactive") — the variant's semantics are exact membership for scalar and array cells.
+* Strict set membership for the multi-select variant. No TanStack built-in covers both cell
+* shapes exactly: `arrIncludesSome` rejects non-array row values outright, `arrHas` rejects
+* array cells, and `arrIncludes` substring-matches strings ("active" would match "inactive") —
+* the variant's semantics are exact membership for scalar and array cells.
 */
 const oneOf = (row, columnId, filterValue) => {
 	const raw = row.getValue(columnId);
@@ -517,10 +518,12 @@ function RowReorderOverlay({ session }) {
 function RowDragCell({ row, table }) {
 	const { labels, icons, rowReorderKeyboard } = useDataTableContext();
 	const orderable = table.options.meta?.ledger?.rowOrdering.orderable === true;
+	const pinned = table.options.enableRowPinning === true && row.getIsPinned() !== false;
 	const { ref, isDragSource } = (0, _dnd_kit_react.useDraggable)({
 		id: row.id,
-		disabled: !orderable
+		disabled: !orderable || pinned
 	});
+	if (pinned) return null;
 	const lifted = rowReorderKeyboard?.active(row.id) === true;
 	const handleKeyDown = (event) => {
 		const keyboard = rowReorderKeyboard;
@@ -2868,8 +2871,9 @@ function TableBody({ table, virtualization, columnWindow, viewportRef, loading,
 //#endregion
 //#region src/table-footer.tsx
 /**
-* Column footers (totals row). Rendered only when at least one leaf column declares a `footer`;
-* pinned columns keep their sticky offsets so the totals track their columns.
+* Column footers (totals row). Rendered only when at least one column — leaf or group —
+* declares a `footer`; pinned columns keep their sticky offsets so the totals track their
+* columns.
 */
 /**
 * The footer rows that actually render. `getFooterGroups()` mirrors *every* header level, so a
@@ -3724,10 +3728,14 @@ function useColumnWidths(table, columns, viewport, tableMinWidth) {
 * object so `typeof ledgerFeatures` (`LedgerFeatures`) can pre-bind the `TFeatures` generic of
 * every re-exported type — consumers keep writing v8-shaped `ColumnDef<TData>` code.
 *
-* - Every stock feature is registered EXCEPT `columnResizingFeature`: ledger owns the resize
-* interaction end to end (`use-column-resize.ts`), so TanStack's drag machinery — and with it
-* the `columnResizing` state slice, `getIsResizing()`, and `getResizeHandler()` — is not
-* registered at all. Feature-gated APIs cannot lie about a pipeline that never runs.
+* - Every stock feature is registered EXCEPT the two below.
+* - `columnResizingFeature`: ledger owns the resize interaction end to end
+* (`use-column-resize.ts`), so TanStack's drag machinery — and with it the `columnResizing`
+* state slice, `getIsResizing()`, and `getResizeHandler()` — is not registered at all.
+* Feature-gated APIs cannot lie about a pipeline that never runs.
+* - `cellSelectionFeature`: cell selection is deferred until its own design round
+* (docs/DESIGN.md), so the `cellSelection` state slice, `enableCellSelection`, and
+* `cell.getIsSelected()` are likewise absent by the same rule.
 * - Row model factories are registered statically; the `manualX` translations decide at runtime
 * whether a model actually processes rows (client mode) or passes through (server mode).
 * - Every built-in fn ships registered under its conventional name. v9 resolves string ids —
@@ -6053,6 +6061,18 @@ function useDataTable(options) {
 		enableRowSelection,
 		withExpander
 	]);
+	const setPublicColumnPinning = (0, react.useCallback)((updater) => {
+		setColumnPinning((old) => {
+			const next = (0, _tanstack_react_table.functionalUpdate)(updater, old);
+			const start = next.start.filter((id) => !isInternalColumn(id));
+			const end = next.end.filter((id) => !isInternalColumn(id));
+			if (start.length === next.start.length && end.length === next.end.length) return next;
+			return start.length === old.start.length && end.length === old.end.length && start.every((id, index) => id === old.start[index]) && end.every((id, index) => id === old.end[index]) ? old : {
+				end,
+				start
+			};
+		});
+	}, [setColumnPinning]);
 	if (isDev && (enableRowSelection || withExpander) && !getRowId) warnOnce("missing-get-row-id", "Row selection/expansion is enabled without getRowId — index-based row ids corrupt state across refetches.");
 	const churn = (0, react.useRef)({
 		renders: 0,
@@ -6150,7 +6170,7 @@ function useDataTable(options) {
 		onRowSelectionChange: setRowSelection,
 		onExpandedChange: setExpanded,
 		onColumnVisibilityChange: setColumnVisibility,
-		onColumnPinningChange: setColumnPinning,
+		onColumnPinningChange: setPublicColumnPinning,
 		onColumnOrderChange: setColumnOrder,
 		onColumnSizingChange: setColumnSizing,
 		onGroupingChange: setGrouping,
@@ -6385,11 +6405,12 @@ const defaultProps = {
 function leafCol(column) {
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("col", { style: { width: `var(${columnWidthVar(column.id)})` } }, column.id);
 }
-const varsResolver = (0, _mantine_core.createVarsResolver)((theme, { stripedColor, highlightOnHoverColor, borderColor }) => {
+const varsResolver = (0, _mantine_core.createVarsResolver)((theme, { stripedColor, highlightOnHoverColor, borderColor, radius }) => {
 	return { root: {
 		"--ledger-striped-color": stripedColor ? (0, _mantine_core.getThemeColor)(stripedColor, theme) : void 0,
 		"--ledger-hover-color": highlightOnHoverColor ? (0, _mantine_core.getThemeColor)(highlightOnHoverColor, theme) : void 0,
-		"--ledger-border-color": borderColor ? (0, _mantine_core.getThemeColor)(borderColor, theme) : void 0
+		"--ledger-border-color": borderColor ? (0, _mantine_core.getThemeColor)(borderColor, theme) : void 0,
+		"--ledger-radius": radius === void 0 ? void 0 : (0, _mantine_core.getRadius)(radius)
 	} };
 });
 const OPTION_KEY_SET = /* @__PURE__ */ new Set([
@@ -6510,7 +6531,7 @@ function DataTableFromOptions({ props }) {
 	});
 }
 function DataTableCore({ presentation, stylesProps, table }) {
-	const { striped, stripedColor: _stripedColor, highlightOnHover, highlightOnHoverColor: _highlightOnHoverColor, withTableBorder, withColumnBorders, withRowBorders, borderColor: _borderColor, verticalSpacing, horizontalSpacing, tabularNums, tableMinWidth, virtualizedRows, virtualizedColumns, onEndReached, endReachedOffset, loadingMore, loadMoreError, loading, emptyState, error, onRetry, withColumnHeaders, withPaginationBar, pageSizeOptions, onRowClick, onRowActivate, onRowDoubleClick, onRowContextMenu, rowProps, headerRowProps, footerRowProps, viewportProps, labels: labelsProp, icons: iconsProp, handleRef, ref: rootRef, classNames, styles, unstyled, vars, className, style, attributes, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, "aria-describedby": ariaDescribedBy, ...others } = presentation;
+	const { striped, stripedColor: _stripedColor, highlightOnHover, highlightOnHoverColor: _highlightOnHoverColor, withTableBorder, withColumnBorders, withRowBorders, borderColor: _borderColor, radius: _radius, verticalSpacing, horizontalSpacing, tabularNums, tableMinWidth, virtualizedRows, virtualizedColumns, onEndReached, endReachedOffset, loadingMore, loadMoreError, loading, emptyState, error, onRetry, withColumnHeaders, withPaginationBar, pageSizeOptions, onRowClick, onRowActivate, onRowDoubleClick, onRowContextMenu, rowProps, headerRowProps, footerRowProps, viewportProps, labels: labelsProp, icons: iconsProp, handleRef, ref: rootRef, classNames, styles, unstyled, vars, className, style, attributes, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, "aria-describedby": ariaDescribedBy, ...others } = presentation;
 	const getStyles = (0, _mantine_core.useStyles)({
 		name: "DataTable",
 		classes,