@peasant-labs/fairtrade 0.0.28 → 0.0.29

package/dist/lib/types/DataTable.d.ts

@@ -2,8 +2,8 @@
  * a sortable + selectable data table. square, hairline, mono headers; both themes
  * via tokens. sort + selection state/logic are powered by TanStack Table
  * (@tanstack/react-table, headless) while this component still renders its own markup
- * + token classes. Search, column filters and pagination can each be host-controlled
- * or seeded by defaults. Sorting cycles none -> asc -> desc -> none on a
+ * + token classes. Search and filter controls are opt-in toolbar content. Pagination
+ * is enabled only by explicit pagination/defaultPagination props. Sorting cycles none -> asc -> desc -> none on a
  * sortable header (a real <button>, so it is keyboard-operable), exposes aria-sort on the
  * <th>, and shows a lucide chevron indicator. selection reuses the existing .check-box control:
  * a header checkbox selects/clears all (with an indeterminate middle state) and
@@ -47,11 +47,14 @@
  * @param {DataTableColumnFilters} [props.defaultColumnFilters=[]] initial column filters.
  * @param {(next: DataTableColumnFilters) => void} [props.onColumnFiltersChange] next filters.
  * @param {DataTablePagination} [props.pagination] controlled pagination (zero-based pageIndex).
- * @param {DataTablePagination} [props.defaultPagination] defaults to pageIndex 0, pageSize 10.
+ * @param {DataTablePagination} [props.defaultPagination] enables local pagination with this initial state.
  * @param {(next: DataTablePagination) => void} [props.onPaginationChange] next pagination.
  * @param {number} [props.rowCount] host total for host-sliced data: pagination stays manual (the page count comes from rowCount) and sorting stays local, while search and column filters still apply to the rows given; with a partial window and an active filter the footer reports the loaded rows, never the host total.
+ * @param {(controls: Parameters<typeof import('./DataTableControls.jsx').DataTableToolbar>[0]) => React.ReactNode} [props.toolbar] optional controls; render DataTableToolbar or importer-owned content.
+ * @param {(controls: Parameters<typeof DataTablePaginationControls>[0]) => React.ReactNode} [props.footer] optional footer; replaces the default pager when pagination is enabled.
+ * @param {React.CSSProperties['maxHeight']} [props.maxHeight] explicit inner scroll bound; natural height when omitted.
  */
-export default function DataTable({ columns, rows, selectable, disabled, rowKey, defaultSort, sort: sortProp, onSortChange, defaultSelectedKeys, selectedKeys: selectedProp, onSelectionChange, caption, className, search: searchProp, defaultSearch, onSearchChange, columnFilters: filtersProp, defaultColumnFilters, onColumnFiltersChange, pagination: paginationProp, defaultPagination, onPaginationChange, rowCount, }: {
+export default function DataTable({ columns, rows, selectable, disabled, rowKey, defaultSort, sort: sortProp, onSortChange, defaultSelectedKeys, selectedKeys: selectedProp, onSelectionChange, caption, className, search: searchProp, defaultSearch, onSearchChange, columnFilters: filtersProp, defaultColumnFilters, onColumnFiltersChange, pagination: paginationProp, defaultPagination, onPaginationChange, rowCount, toolbar, footer, maxHeight, }: {
     columns: DataTableColumn[];
     rows: any[];
     selectable?: boolean;
@@ -75,13 +78,16 @@ export default function DataTable({ columns, rows, selectable, disabled, rowKey,
     defaultPagination?: DataTablePagination;
     onPaginationChange?: (next: DataTablePagination) => void;
     rowCount?: number;
+    toolbar?: (controls: Parameters<typeof import("./DataTableControls.jsx").DataTableToolbar>[0]) => React.ReactNode;
+    footer?: (controls: Parameters<typeof DataTablePaginationControls>[0]) => React.ReactNode;
+    maxHeight?: React.CSSProperties["maxHeight"];
 }): import("react").JSX.Element;
 /**
  * a sortable + selectable data table. square, hairline, mono headers; both themes
  * via tokens. sort + selection state/logic are powered by TanStack Table
  * (@tanstack/react-table, headless) while this component still renders its own markup
- * + token classes. Search, column filters and pagination can each be host-controlled
- * or seeded by defaults. Sorting cycles none -> asc -> desc -> none on a
+ * + token classes. Search and filter controls are opt-in toolbar content. Pagination
+ * is enabled only by explicit pagination/defaultPagination props. Sorting cycles none -> asc -> desc -> none on a
  * sortable header (a real <button>, so it is keyboard-operable), exposes aria-sort on the
  * <th>, and shows a lucide chevron indicator. selection reuses the existing .check-box control:
  * a header checkbox selects/clears all (with an indeterminate middle state) and
@@ -122,8 +128,8 @@ export type DataTableColumn = {
  * a sortable + selectable data table. square, hairline, mono headers; both themes
  * via tokens. sort + selection state/logic are powered by TanStack Table
  * (@tanstack/react-table, headless) while this component still renders its own markup
- * + token classes. Search, column filters and pagination can each be host-controlled
- * or seeded by defaults. Sorting cycles none -> asc -> desc -> none on a
+ * + token classes. Search and filter controls are opt-in toolbar content. Pagination
+ * is enabled only by explicit pagination/defaultPagination props. Sorting cycles none -> asc -> desc -> none on a
  * sortable header (a real <button>, so it is keyboard-operable), exposes aria-sort on the
  * <th>, and shows a lucide chevron indicator. selection reuses the existing .check-box control:
  * a header checkbox selects/clears all (with an indeterminate middle state) and
@@ -142,8 +148,8 @@ export type DataTableSort = {
  * a sortable + selectable data table. square, hairline, mono headers; both themes
  * via tokens. sort + selection state/logic are powered by TanStack Table
  * (@tanstack/react-table, headless) while this component still renders its own markup
- * + token classes. Search, column filters and pagination can each be host-controlled
- * or seeded by defaults. Sorting cycles none -> asc -> desc -> none on a
+ * + token classes. Search and filter controls are opt-in toolbar content. Pagination
+ * is enabled only by explicit pagination/defaultPagination props. Sorting cycles none -> asc -> desc -> none on a
  * sortable header (a real <button>, so it is keyboard-operable), exposes aria-sort on the
  * <th>, and shows a lucide chevron indicator. selection reuses the existing .check-box control:
  * a header checkbox selects/clears all (with an indeterminate middle state) and
@@ -162,8 +168,8 @@ export type DataTableColumnFilters = {
  * a sortable + selectable data table. square, hairline, mono headers; both themes
  * via tokens. sort + selection state/logic are powered by TanStack Table
  * (@tanstack/react-table, headless) while this component still renders its own markup
- * + token classes. Search, column filters and pagination can each be host-controlled
- * or seeded by defaults. Sorting cycles none -> asc -> desc -> none on a
+ * + token classes. Search and filter controls are opt-in toolbar content. Pagination
+ * is enabled only by explicit pagination/defaultPagination props. Sorting cycles none -> asc -> desc -> none on a
  * sortable header (a real <button>, so it is keyboard-operable), exposes aria-sort on the
  * <th>, and shows a lucide chevron indicator. selection reuses the existing .check-box control:
  * a header checkbox selects/clears all (with an indeterminate middle state) and
@@ -178,3 +184,4 @@ export type DataTablePagination = {
     pageIndex: number;
     pageSize: number;
 };
+import { DataTablePaginationControls } from './DataTableControls.jsx';

package/dist/lib/types/DataTableControls.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Optional table controls. Omit search or columnFilters to leave that control out;
+ * children extend the toolbar with importer-owned actions.
+ * @param {Object} props
+ * @param {{ value: string, onChange: (value: string) => void }} [props.search]
+ * @param {{ columns: import('./DataTable.jsx').DataTableColumn[], value: import('./DataTable.jsx').DataTableColumnFilters, onChange: (value: import('./DataTable.jsx').DataTableColumnFilters) => void }} [props.columnFilters]
+ * @param {boolean} [props.disabled=false]
+ * @param {React.ReactNode} [props.children]
+ */
+export function DataTableToolbar({ search, columnFilters, disabled, children }: {
+    search?: {
+        value: string;
+        onChange: (value: string) => void;
+    };
+    columnFilters?: {
+        columns: import("./DataTable.jsx").DataTableColumn[];
+        value: import("./DataTable.jsx").DataTableColumnFilters;
+        onChange: (value: import("./DataTable.jsx").DataTableColumnFilters) => void;
+    };
+    disabled?: boolean;
+    children?: React.ReactNode;
+}): import("react").JSX.Element;
+/**
+ * Optional pagination/footer presentation, independent of the table's row markup.
+ * @param {Object} props
+ * @param {string} props.countLabel
+ * @param {number} props.pageIndex
+ * @param {number} props.pageCount
+ * @param {boolean} props.canPreviousPage
+ * @param {boolean} props.canNextPage
+ * @param {() => void} props.onPreviousPage
+ * @param {() => void} props.onNextPage
+ * @param {boolean} [props.disabled=false]
+ */
+export function DataTablePaginationControls({ countLabel, pageIndex, pageCount, canPreviousPage, canNextPage, onPreviousPage, onNextPage, disabled }: {
+    countLabel: string;
+    pageIndex: number;
+    pageCount: number;
+    canPreviousPage: boolean;
+    canNextPage: boolean;
+    onPreviousPage: () => void;
+    onNextPage: () => void;
+    disabled?: boolean;
+}): import("react").JSX.Element;

package/dist/lib/types/index.d.ts

@@ -41,6 +41,7 @@ export { Avatar, AvatarGroup, Kbd, KbdChord, Tag } from "./Avatar.jsx";
 export { default as BrandMark, resolveBrand } from "./BrandMark.jsx";
 export { providerAccent, providerDisplayName } from "./provider-policy.js";
 export { Skeleton, Progress, Spinner, Toast, FeedbackPanel } from "./Feedback.jsx";
+export { DataTableToolbar, DataTablePaginationControls } from "./DataTableControls.jsx";
 export { default as HelperGroup, HelperGroupListItem, HelperThreadRow, useHelperSelection, helperOwnerState, helperSelectionIds, helperOwnerToggle, helperMemberToggle, HELPER_OWNER_STATE } from "./HelperGroup.jsx";
 export { default as Timeline, TimelineItem, ToolCall, ThinkingBlock } from "./Timeline.jsx";
 export { default as ToastProvider, useToast } from "./ToastHost.jsx";