@carefully-built/crud 0.1.2

package/README.md

@@ -0,0 +1,70 @@
+# Carefully Built CRUD
+
+Config-driven CRUD table helpers for Carefully Built SaaS apps.
+
+## Install
+
+```bash
+bun add @carefully-built/crud @carefully-built/ui
+```
+
+## What It Includes
+
+- `useCrudTableState`: search, select filters, sorting, pagination, and empty-state derivation for table CRUD screens.
+- `CrudTableView`: shared toolbar plus `SmartTable` rendering with consistent empty-state and pagination wiring.
+- `CrudListTable`: direct CRUD table wrapper for pages that already own their toolbar/filter layout.
+- `CrudResourceSheet`: responsive create/edit sheet for resource forms, with confirm/cancel footer wiring.
+- CRUD types for resource configs, filters, and empty-state values.
+
+## Basic Usage
+
+```tsx
+const table = useCrudTableState({
+  data: items,
+  columns,
+  searchFields: ["name", "description"],
+  filters: [
+    { key: "status", config: STATUS_FILTER },
+    { key: "priority", config: PRIORITY_FILTER },
+  ],
+});
+
+<CrudTableView
+  state={table}
+  columns={columns}
+  isLoading={isLoading}
+  searchPlaceholder="Search..."
+  actions={["edit", "delete"]}
+  actionHandlers={actionHandlers}
+/>;
+```
+
+Keep domain actions, mutations, and labels inside the consuming app. This package owns the repeated table mechanics.
+
+## Sheet Usage
+
+Use `CrudResourceSheet` for create/edit forms instead of wiring `ResponsiveSheet` repeatedly in each app.
+
+```tsx
+<CrudResourceSheet
+  open={isOpen}
+  onOpenChange={setIsOpen}
+  title="Edit contact"
+  description="Update the contact details."
+  formId="contact-form"
+  confirmLabel="Save"
+  confirmLoading={isSaving}
+  classes={{
+    body: 'gap-4',
+    footer: 'border-t',
+  }}
+>
+  <ContactForm id="contact-form" />
+</CrudResourceSheet>
+```
+
+`className`, `contentClassName`, `footerClassName`, and `classes` are optional. Omit them to keep the default kit style.
+
+## Component Docs
+
+- [CRUD Table](./docs/crud-table.md)

package/dist/index.d.mts

@@ -0,0 +1,211 @@
+import { ActionHandlers, ActionType, Column, FilterConfig, ResponsiveSheetClassNames, SortState } from "@carefully-built/ui";
+import { ReactNode } from "react";
+
+//#region src/pagination.d.ts
+interface CrudPaginationState {
+  readonly currentPage: number;
+  readonly totalPages: number;
+  readonly totalItems: number;
+  readonly pageSize: number;
+  readonly startIndex: number;
+  readonly endIndex: number;
+  readonly onPageChange: (page: number) => void;
+}
+//#endregion
+//#region src/types.d.ts
+type CrudEmptyState = "initial" | "no-results";
+interface CrudFilterDefinition<TItem> {
+  readonly key: Extract<keyof TItem, string>;
+  readonly config: FilterConfig;
+  readonly allowAll?: boolean;
+  readonly clearable?: boolean;
+}
+interface UseCrudTableStateOptions<TItem> {
+  readonly data: readonly TItem[];
+  readonly columns: readonly Column<TItem>[];
+  readonly searchFields?: readonly Extract<keyof TItem, string>[];
+  readonly filters?: readonly CrudFilterDefinition<TItem>[];
+  readonly pageSize?: number;
+  readonly initialSortState?: SortState;
+}
+interface CrudTableState<TItem> {
+  readonly filteredData: TItem[];
+  readonly sortedData: TItem[];
+  readonly paginatedData: TItem[];
+  readonly search: string;
+  readonly setSearch: (value: string) => void;
+  readonly filters: Record<string, string>;
+  readonly setFilter: (key: string, value: string) => void;
+  readonly clearAll: () => void;
+  readonly getDraftFilterResultCount: (draftValues: Record<string, string>) => number;
+  readonly hasSearch: boolean;
+  readonly hasFilters: boolean;
+  readonly emptyState: CrudEmptyState;
+  readonly sortState: SortState;
+  readonly setSortState: (state: SortState) => void;
+  readonly pagination: CrudPaginationState;
+}
+interface CrudTableViewProps<TItem> {
+  readonly state: CrudTableState<TItem>;
+  readonly columns: readonly Column<TItem>[];
+  readonly isLoading: boolean;
+  readonly searchPlaceholder?: string;
+  readonly filters?: readonly CrudFilterDefinition<TItem>[];
+  readonly actions?: readonly ActionType[];
+  readonly actionHandlers?: ActionHandlers<TItem>;
+  readonly renderActions?: (item: TItem) => ReactNode;
+  readonly noDataMessage?: string;
+  readonly initialEmptyContent?: ReactNode;
+  readonly noResultsContent?: ReactNode;
+  readonly getRowKey?: (item: TItem) => string | number;
+  readonly onRowClick?: (item: TItem) => void;
+  readonly renderMobileCard?: (item: TItem) => ReactNode;
+  readonly stickyHeader?: boolean;
+  readonly fullHeight?: boolean;
+  readonly maxHeight?: string;
+}
+interface CrudDataTableProps<TItem> {
+  readonly data: readonly TItem[];
+  readonly columns: readonly Column<TItem>[];
+  readonly isLoading: boolean;
+  readonly actions?: readonly ActionType[];
+  readonly actionHandlers?: ActionHandlers<TItem>;
+  readonly renderActions?: (item: TItem) => ReactNode;
+  readonly noDataMessage?: string;
+  readonly noDataContent?: ReactNode;
+  readonly getRowKey?: (item: TItem) => string | number;
+  readonly onRowClick?: (item: TItem) => void;
+  readonly renderMobileCard?: (item: TItem) => ReactNode;
+  readonly stickyHeader?: boolean;
+  readonly fullHeight?: boolean;
+  readonly maxHeight?: string;
+  readonly sortState?: SortState;
+  readonly onSortChange?: (state: SortState) => void;
+  readonly pagination?: CrudPaginationState;
+}
+//#endregion
+//#region src/crud-data-table.d.ts
+declare function CrudDataTable<TItem extends object>({
+  actions,
+  actionHandlers,
+  columns,
+  data,
+  fullHeight,
+  getRowKey,
+  isLoading,
+  maxHeight,
+  noDataContent,
+  noDataMessage,
+  onRowClick,
+  pagination,
+  renderActions,
+  renderMobileCard,
+  sortState,
+  stickyHeader,
+  onSortChange
+}: CrudDataTableProps<TItem>): React.ReactElement;
+//#endregion
+//#region src/crud-list-table.d.ts
+type CrudListTableProps<TItem extends object> = CrudDataTableProps<TItem>;
+declare function CrudListTable<TItem extends object>(props: CrudListTableProps<TItem>): React.ReactElement;
+//#endregion
+//#region src/crud-resource-sheet.d.ts
+interface CrudResourceSheetProps {
+  readonly open: boolean;
+  readonly onOpenChange: (open: boolean) => void;
+  readonly title: ReactNode;
+  readonly children: ReactNode;
+  readonly formId?: string;
+  readonly description?: ReactNode;
+  readonly onCancel?: () => void;
+  readonly cancelLabel?: ReactNode;
+  readonly onConfirm?: () => void;
+  readonly confirmLabel?: ReactNode;
+  readonly confirmDisabled?: boolean;
+  readonly confirmLoading?: boolean;
+  readonly confirmCloseWhenDirty?: boolean;
+  readonly width?: number;
+  readonly className?: string;
+  readonly contentClassName?: string;
+  readonly footerClassName?: string;
+  readonly classes?: ResponsiveSheetClassNames;
+}
+declare function CrudResourceSheet({
+  children,
+  formId,
+  onConfirm,
+  confirmCloseWhenDirty: _confirmCloseWhenDirty,
+  ...sheetProps
+}: CrudResourceSheetProps): React.ReactElement;
+//#endregion
+//#region src/crud-table-view.d.ts
+declare function CrudTableView<TItem extends object>({
+  state,
+  columns,
+  isLoading,
+  searchPlaceholder,
+  filters,
+  actions,
+  actionHandlers,
+  renderActions,
+  noDataMessage,
+  initialEmptyContent,
+  noResultsContent,
+  getRowKey,
+  onRowClick,
+  renderMobileCard,
+  stickyHeader,
+  fullHeight,
+  maxHeight
+}: CrudTableViewProps<TItem>): React.ReactElement;
+//#endregion
+//#region src/use-crud-table-state.d.ts
+declare function useCrudTableState<TItem extends object>({
+  data,
+  columns,
+  searchFields,
+  filters: filterDefinitions,
+  pageSize,
+  initialSortState
+}: UseCrudTableStateOptions<TItem>): CrudTableState<TItem>;
+//#endregion
+//#region src/use-url-string-filters.d.ts
+interface UrlStringFilterDefinition<TKey extends string = string> {
+  readonly key: TKey;
+  readonly param?: string;
+  readonly defaultValue?: string;
+  readonly clearValue?: string;
+}
+type UrlStringFilterValues<TDefinitions extends readonly UrlStringFilterDefinition[]> = { readonly [TDefinition in TDefinitions[number] as TDefinition["key"]]: string };
+interface UrlStringFiltersState<TDefinitions extends readonly UrlStringFilterDefinition[]> {
+  readonly values: UrlStringFilterValues<TDefinitions>;
+  readonly setValue: (key: TDefinitions[number]["key"], value: string) => void;
+  readonly clear: () => void;
+  readonly getDraftValues: (draftValues: Record<string, string>) => UrlStringFilterValues<TDefinitions>;
+}
+declare function useUrlStringFilters<const TDefinitions extends readonly UrlStringFilterDefinition[]>(definitions: TDefinitions): UrlStringFiltersState<TDefinitions>;
+//#endregion
+//#region src/use-url-pagination.d.ts
+interface UseUrlPaginationOptions {
+  readonly totalItems: number;
+  readonly pageSize?: number;
+  readonly pageParam?: string;
+}
+interface UrlPaginationState extends CrudPaginationState {
+  readonly hasPrevPage: boolean;
+  readonly hasNextPage: boolean;
+  readonly goToPage: (page: number) => void;
+  readonly nextPage: () => void;
+  readonly prevPage: () => void;
+  readonly firstPage: () => void;
+  readonly lastPage: () => void;
+  readonly paginate: <T>(data: readonly T[]) => T[];
+}
+declare function useUrlPagination({
+  totalItems,
+  pageSize,
+  pageParam
+}: UseUrlPaginationOptions): UrlPaginationState;
+//#endregion
+export { CrudDataTable, type CrudDataTableProps, type CrudEmptyState, type CrudFilterDefinition, CrudListTable, type CrudListTableProps, type CrudPaginationState, CrudResourceSheet, type CrudResourceSheetProps, type CrudTableState, CrudTableView, type CrudTableViewProps, type UrlPaginationState, type UrlStringFilterDefinition, type UrlStringFiltersState, type UseCrudTableStateOptions, type UseUrlPaginationOptions, useCrudTableState, useUrlPagination, useUrlStringFilters };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/pagination.ts","../src/types.ts","../src/crud-data-table.tsx","../src/crud-list-table.tsx","../src/crud-resource-sheet.tsx","../src/crud-table-view.tsx","../src/use-crud-table-state.ts","../src/use-url-string-filters.ts","../src/use-url-pagination.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/index.mjs

@@ -0,0 +1,322 @@
+import { ResponsiveSheet, SmartTable, TableToolbar, useTableSorting } from "@carefully-built/ui";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { useCallback, useMemo, useState } from "react";
+import { parseAsInteger, parseAsString, useQueryState, useQueryStates } from "nuqs";
+
+//#region src/crud-data-table.tsx
+function CrudDataTable({ actions, actionHandlers, columns, data, fullHeight = true, getRowKey, isLoading, maxHeight, noDataContent, noDataMessage, onRowClick, pagination, renderActions, renderMobileCard, sortState, stickyHeader = true, onSortChange }) {
+	return /* @__PURE__ */ jsx(SmartTable, {
+		data: [...data],
+		columns: [...columns],
+		isLoading,
+		actions: actions ? [...actions] : void 0,
+		actionHandlers,
+		renderActions,
+		noDataMessage,
+		noDataContent,
+		getRowKey,
+		onRowClick,
+		renderMobileCard,
+		stickyHeader,
+		fullHeight,
+		maxHeight,
+		sortState,
+		onSortChange,
+		pagination
+	});
+}
+
+//#endregion
+//#region src/crud-list-table.tsx
+function CrudListTable(props) {
+	return /* @__PURE__ */ jsx(CrudDataTable, { ...props });
+}
+
+//#endregion
+//#region src/crud-resource-sheet.tsx
+function CrudResourceSheet({ children, formId, onConfirm, confirmCloseWhenDirty: _confirmCloseWhenDirty, ...sheetProps }) {
+	const submitForm = () => {
+		const form = formId ? document.getElementById(formId) : null;
+		if (form instanceof HTMLFormElement) {
+			form.requestSubmit();
+			return;
+		}
+		onConfirm?.();
+	};
+	return /* @__PURE__ */ jsx(ResponsiveSheet, {
+		...sheetProps,
+		onConfirm: formId || onConfirm ? submitForm : void 0,
+		children
+	});
+}
+
+//#endregion
+//#region src/crud-table-view.tsx
+function CrudTableView({ state, columns, isLoading, searchPlaceholder = "Search...", filters = [], actions, actionHandlers, renderActions, noDataMessage, initialEmptyContent, noResultsContent, getRowKey, onRowClick, renderMobileCard, stickyHeader = true, fullHeight = true, maxHeight }) {
+	const emptyContent = state.emptyState === "no-results" ? noResultsContent : initialEmptyContent;
+	return /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx("div", {
+		className: "shrink-0",
+		children: /* @__PURE__ */ jsx(TableToolbar, {
+			search: {
+				value: state.search,
+				onChange: state.setSearch,
+				placeholder: searchPlaceholder
+			},
+			filters: filters.map((filter) => ({
+				config: filter.config,
+				value: state.filters[filter.key] ?? "all",
+				onChange: (value) => {
+					state.setFilter(filter.key, value);
+				},
+				allowAll: filter.allowAll,
+				clearable: filter.clearable
+			})),
+			onClearAll: state.clearAll,
+			getDraftResultCount: state.getDraftFilterResultCount
+		})
+	}), /* @__PURE__ */ jsx(SmartTable, {
+		data: state.paginatedData,
+		columns: [...columns],
+		isLoading,
+		actions: actions ? [...actions] : void 0,
+		actionHandlers,
+		renderActions,
+		noDataMessage,
+		noDataContent: emptyContent,
+		getRowKey,
+		onRowClick,
+		renderMobileCard,
+		stickyHeader,
+		fullHeight,
+		maxHeight,
+		sortState: state.sortState,
+		onSortChange: state.setSortState,
+		pagination: state.pagination
+	})] });
+}
+
+//#endregion
+//#region src/search.ts
+function normalizeSearchText(value) {
+	return value.toLocaleLowerCase().normalize("NFD").replace(/\p{Diacritic}/gu, "").trim();
+}
+function buildCrudSearchText(values) {
+	return normalizeSearchText(values.filter((value) => typeof value === "string" || typeof value === "number").map(String).join(" "));
+}
+function matchesCrudSearch(searchText, query) {
+	const normalizedQuery = normalizeSearchText(query);
+	if (!normalizedQuery) return true;
+	return normalizedQuery.split(/\s+/).every((token) => searchText.includes(token));
+}
+
+//#endregion
+//#region src/pagination.ts
+function getValidPage(page, totalPages) {
+	return Math.min(Math.max(1, page), totalPages);
+}
+function paginateCrudData(data, currentPage, pageSize) {
+	const startIndex = (currentPage - 1) * pageSize;
+	return data.slice(startIndex, startIndex + pageSize);
+}
+
+//#endregion
+//#region src/use-crud-table-state.ts
+function buildInitialFilters(filters) {
+	return Object.fromEntries(filters.map((filter) => [filter.key, "all"]));
+}
+function itemMatchesFilters(item, filters) {
+	const record = item;
+	return Object.entries(filters).every(([key, filterValue]) => {
+		if (!filterValue || filterValue === "all") return true;
+		return record[key] === filterValue;
+	});
+}
+function filterCrudData(data, search, filters, searchFields) {
+	return data.filter((item) => {
+		if (!itemMatchesFilters(item, filters)) return false;
+		const record = item;
+		return matchesCrudSearch(buildCrudSearchText(searchFields.map((field) => record[field])), search);
+	});
+}
+function useCrudTableState({ data, columns, searchFields = [], filters: filterDefinitions = [], pageSize = 20, initialSortState = null }) {
+	const [search, setSearch] = useState("");
+	const [filters, setFilters] = useState(() => buildInitialFilters(filterDefinitions));
+	const [currentPage, setCurrentPage] = useState(1);
+	const filteredData = useMemo(() => filterCrudData(data, search, filters, searchFields), [
+		data,
+		filters,
+		search,
+		searchFields
+	]);
+	const { sortedData, sortState, setSortState } = useTableSorting({
+		data: filteredData,
+		columns,
+		initialSortState
+	});
+	const totalPages = Math.max(1, Math.ceil(filteredData.length / pageSize));
+	const validCurrentPage = getValidPage(currentPage, totalPages);
+	const startIndex = (validCurrentPage - 1) * pageSize;
+	const endIndex = Math.min(startIndex + pageSize, filteredData.length);
+	const paginatedData = useMemo(() => paginateCrudData(sortedData, validCurrentPage, pageSize), [
+		pageSize,
+		sortedData,
+		validCurrentPage
+	]);
+	const setFilter = useCallback((key, value) => {
+		setFilters((currentFilters) => ({
+			...currentFilters,
+			[key]: value
+		}));
+		setCurrentPage(1);
+	}, []);
+	const updateSearch = useCallback((value) => {
+		setSearch(value);
+		setCurrentPage(1);
+	}, []);
+	const clearAll = useCallback(() => {
+		setSearch("");
+		setFilters(buildInitialFilters(filterDefinitions));
+		setCurrentPage(1);
+	}, [filterDefinitions]);
+	const getDraftFilterResultCount = useCallback((draftValues) => filterCrudData(data, search, {
+		...filters,
+		...draftValues
+	}, searchFields).length, [
+		data,
+		filters,
+		search,
+		searchFields
+	]);
+	const hasSearch = search.trim().length > 0;
+	const hasFilters = Object.values(filters).some((value) => value && value !== "all");
+	return {
+		filteredData,
+		sortedData,
+		paginatedData,
+		search,
+		setSearch: updateSearch,
+		filters,
+		setFilter,
+		clearAll,
+		getDraftFilterResultCount,
+		hasSearch,
+		hasFilters,
+		emptyState: hasSearch || hasFilters ? "no-results" : "initial",
+		sortState,
+		setSortState,
+		pagination: {
+			currentPage: validCurrentPage,
+			totalPages,
+			totalItems: filteredData.length,
+			pageSize,
+			startIndex,
+			endIndex,
+			onPageChange: setCurrentPage
+		}
+	};
+}
+
+//#endregion
+//#region src/use-url-string-filters.ts
+function buildParserMap(definitions) {
+	return Object.fromEntries(definitions.map((definition) => [definition.param ?? definition.key, parseAsString.withDefault(definition.defaultValue ?? "all")]));
+}
+function normalizeFilterValue(value, definition) {
+	if (value === (definition.clearValue ?? definition.defaultValue ?? "all")) return null;
+	return value.length > 0 ? value : null;
+}
+function useUrlStringFilters(definitions) {
+	const [params, setParams] = useQueryStates(useMemo(() => buildParserMap(definitions), [definitions]));
+	const values = useMemo(() => Object.fromEntries(definitions.map((definition) => {
+		const param = definition.param ?? definition.key;
+		return [definition.key, params[param] ?? definition.defaultValue ?? "all"];
+	})), [definitions, params]);
+	return {
+		values,
+		setValue: useCallback((key, value) => {
+			const definition = definitions.find((item) => item.key === key);
+			if (!definition) return;
+			setParams({ [definition.param ?? definition.key]: normalizeFilterValue(value, definition) });
+		}, [definitions, setParams]),
+		clear: useCallback(() => {
+			setParams(Object.fromEntries(definitions.map((definition) => [definition.param ?? definition.key, null])));
+		}, [definitions, setParams]),
+		getDraftValues: useCallback((draftValues) => ({
+			...values,
+			...draftValues
+		}), [values])
+	};
+}
+
+//#endregion
+//#region src/use-url-pagination.ts
+function useUrlPagination({ totalItems, pageSize = 20, pageParam = "page" }) {
+	const [page, setPage] = useQueryState(pageParam, parseAsInteger.withDefault(1));
+	const totalPages = Math.max(1, Math.ceil(totalItems / pageSize));
+	const currentPage = Math.min(Math.max(1, page), totalPages);
+	const startIndex = (currentPage - 1) * pageSize;
+	const endIndex = Math.min(startIndex + pageSize, totalItems);
+	const hasPrevPage = currentPage > 1;
+	const hasNextPage = currentPage < totalPages;
+	const goToPage = useCallback((newPage) => {
+		const validPage = Math.min(Math.max(1, newPage), totalPages);
+		setPage(validPage === 1 ? null : validPage);
+	}, [setPage, totalPages]);
+	const nextPage = useCallback(() => {
+		if (hasNextPage) goToPage(currentPage + 1);
+	}, [
+		currentPage,
+		goToPage,
+		hasNextPage
+	]);
+	const prevPage = useCallback(() => {
+		if (hasPrevPage) goToPage(currentPage - 1);
+	}, [
+		currentPage,
+		goToPage,
+		hasPrevPage
+	]);
+	const firstPage = useCallback(() => {
+		goToPage(1);
+	}, [goToPage]);
+	const lastPage = useCallback(() => {
+		goToPage(totalPages);
+	}, [goToPage, totalPages]);
+	const paginate = useCallback((data) => data.slice(startIndex, endIndex), [endIndex, startIndex]);
+	return useMemo(() => ({
+		currentPage,
+		pageSize,
+		totalPages,
+		totalItems,
+		startIndex,
+		endIndex,
+		hasPrevPage,
+		hasNextPage,
+		goToPage,
+		nextPage,
+		prevPage,
+		firstPage,
+		lastPage,
+		paginate,
+		onPageChange: goToPage
+	}), [
+		currentPage,
+		endIndex,
+		firstPage,
+		goToPage,
+		hasNextPage,
+		hasPrevPage,
+		lastPage,
+		nextPage,
+		pageSize,
+		paginate,
+		prevPage,
+		startIndex,
+		totalItems,
+		totalPages
+	]);
+}
+
+//#endregion
+export { CrudDataTable, CrudListTable, CrudResourceSheet, CrudTableView, useCrudTableState, useUrlPagination, useUrlStringFilters };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/crud-data-table.tsx","../src/crud-list-table.tsx","../src/crud-resource-sheet.tsx","../src/crud-table-view.tsx","../src/search.ts","../src/pagination.ts","../src/use-crud-table-state.ts","../src/use-url-string-filters.ts","../src/use-url-pagination.ts"],"sourcesContent":["\"use client\";\n\nimport { SmartTable } from \"@carefully-built/ui\";\n\nimport type {\n  CrudDataTableProps,\n} from \"./types\";\n\nexport function CrudDataTable<TItem extends object>({\n  actions,\n  actionHandlers,\n  columns,\n  data,\n  fullHeight = true,\n  getRowKey,\n  isLoading,\n  maxHeight,\n  noDataContent,\n  noDataMessage,\n  onRowClick,\n  pagination,\n  renderActions,\n  renderMobileCard,\n  sortState,\n  stickyHeader = true,\n  onSortChange,\n}: CrudDataTableProps<TItem>): React.ReactElement {\n  return (\n    <SmartTable\n      data={[...data]}\n      columns={[...columns]}\n      isLoading={isLoading}\n      actions={actions ? [...actions] : undefined}\n      actionHandlers={actionHandlers}\n      renderActions={renderActions}\n      noDataMessage={noDataMessage}\n      noDataContent={noDataContent}\n      getRowKey={getRowKey}\n      onRowClick={onRowClick}\n      renderMobileCard={renderMobileCard}\n      stickyHeader={stickyHeader}\n      fullHeight={fullHeight}\n      maxHeight={maxHeight}\n      sortState={sortState}\n      onSortChange={onSortChange}\n      pagination={pagination}\n    />\n  );\n}\n","\"use client\";\n\nimport { CrudDataTable } from \"./crud-data-table\";\nimport type { CrudDataTableProps } from \"./types\";\n\nexport type CrudListTableProps<TItem extends object> = CrudDataTableProps<TItem>;\n\nexport function CrudListTable<TItem extends object>(\n  props: CrudListTableProps<TItem>,\n): React.ReactElement {\n  return <CrudDataTable {...props} />;\n}\n","\"use client\";\n\nimport type { ReactNode } from \"react\";\n\nimport { ResponsiveSheet } from \"@carefully-built/ui\";\nimport type { ResponsiveSheetClassNames } from \"@carefully-built/ui\";\n\nexport interface CrudResourceSheetProps {\n  readonly open: boolean;\n  readonly onOpenChange: (open: boolean) => void;\n  readonly title: ReactNode;\n  readonly children: ReactNode;\n  readonly formId?: string;\n  readonly description?: ReactNode;\n  readonly onCancel?: () => void;\n  readonly cancelLabel?: ReactNode;\n  readonly onConfirm?: () => void;\n  readonly confirmLabel?: ReactNode;\n  readonly confirmDisabled?: boolean;\n  readonly confirmLoading?: boolean;\n  readonly confirmCloseWhenDirty?: boolean;\n  readonly width?: number;\n  readonly className?: string;\n  readonly contentClassName?: string;\n  readonly footerClassName?: string;\n  readonly classes?: ResponsiveSheetClassNames;\n}\n\nexport function CrudResourceSheet({\n  children,\n  formId,\n  onConfirm,\n  confirmCloseWhenDirty: _confirmCloseWhenDirty,\n  ...sheetProps\n}: CrudResourceSheetProps): React.ReactElement {\n  const submitForm = (): void => {\n    const form = formId ? document.getElementById(formId) : null;\n\n    if (form instanceof HTMLFormElement) {\n      form.requestSubmit();\n      return;\n    }\n\n    onConfirm?.();\n  };\n\n  return (\n    <ResponsiveSheet\n      {...sheetProps}\n      onConfirm={formId || onConfirm ? submitForm : undefined}\n    >\n      {children}\n    </ResponsiveSheet>\n  );\n}\n","\"use client\";\n\nimport type { CrudTableViewProps } from \"./types\";\n\nimport { SmartTable, TableToolbar } from \"@carefully-built/ui\";\n\nexport function CrudTableView<TItem extends object>({\n  state,\n  columns,\n  isLoading,\n  searchPlaceholder = \"Search...\",\n  filters = [],\n  actions,\n  actionHandlers,\n  renderActions,\n  noDataMessage,\n  initialEmptyContent,\n  noResultsContent,\n  getRowKey,\n  onRowClick,\n  renderMobileCard,\n  stickyHeader = true,\n  fullHeight = true,\n  maxHeight,\n}: CrudTableViewProps<TItem>): React.ReactElement {\n  const emptyContent =\n    state.emptyState === \"no-results\" ? noResultsContent : initialEmptyContent;\n\n  return (\n    <>\n      <div className=\"shrink-0\">\n        <TableToolbar\n          search={{\n            value: state.search,\n            onChange: state.setSearch,\n            placeholder: searchPlaceholder,\n          }}\n          filters={filters.map((filter) => ({\n            config: filter.config,\n            value: state.filters[filter.key] ?? \"all\",\n            onChange: (value) => {\n              state.setFilter(filter.key, value);\n            },\n            allowAll: filter.allowAll,\n            clearable: filter.clearable,\n          }))}\n          onClearAll={state.clearAll}\n          getDraftResultCount={state.getDraftFilterResultCount}\n        />\n      </div>\n\n      <SmartTable\n        data={state.paginatedData}\n        columns={[...columns]}\n        isLoading={isLoading}\n        actions={actions ? [...actions] : undefined}\n        actionHandlers={actionHandlers}\n        renderActions={renderActions}\n        noDataMessage={noDataMessage}\n        noDataContent={emptyContent}\n        getRowKey={getRowKey}\n        onRowClick={onRowClick}\n        renderMobileCard={renderMobileCard}\n        stickyHeader={stickyHeader}\n        fullHeight={fullHeight}\n        maxHeight={maxHeight}\n        sortState={state.sortState}\n        onSortChange={state.setSortState}\n        pagination={state.pagination}\n      />\n    </>\n  );\n}\n","function normalizeSearchText(value: string): string {\n  return value\n    .toLocaleLowerCase()\n    .normalize(\"NFD\")\n    .replace(/\\p{Diacritic}/gu, \"\")\n    .trim();\n}\n\nexport function buildCrudSearchText(values: readonly unknown[]): string {\n  return normalizeSearchText(\n    values\n      .filter(\n        (value): value is string | number =>\n          typeof value === \"string\" || typeof value === \"number\",\n      )\n      .map(String)\n      .join(\" \"),\n  );\n}\n\nexport function matchesCrudSearch(searchText: string, query: string): boolean {\n  const normalizedQuery = normalizeSearchText(query);\n\n  if (!normalizedQuery) {\n    return true;\n  }\n\n  return normalizedQuery\n    .split(/\\s+/)\n    .every((token) => searchText.includes(token));\n}\n","export interface CrudPaginationState {\n  readonly currentPage: number;\n  readonly totalPages: number;\n  readonly totalItems: number;\n  readonly pageSize: number;\n  readonly startIndex: number;\n  readonly endIndex: number;\n  readonly onPageChange: (page: number) => void;\n}\n\nexport function getValidPage(page: number, totalPages: number): number {\n  return Math.min(Math.max(1, page), totalPages);\n}\n\nexport function paginateCrudData<T>(\n  data: readonly T[],\n  currentPage: number,\n  pageSize: number,\n): T[] {\n  const startIndex = (currentPage - 1) * pageSize;\n  return data.slice(startIndex, startIndex + pageSize);\n}\n","\"use client\";\n\nimport { useCallback, useMemo, useState } from \"react\";\n\nimport type { UseCrudTableStateOptions, CrudTableState } from \"./types\";\n\nimport { useTableSorting } from \"@carefully-built/ui\";\n\nimport { buildCrudSearchText, matchesCrudSearch } from \"./search\";\nimport { getValidPage, paginateCrudData } from \"./pagination\";\n\nfunction buildInitialFilters<TItem>(\n  filters: readonly { readonly key: Extract<keyof TItem, string> }[],\n): Record<string, string> {\n  return Object.fromEntries(filters.map((filter) => [filter.key, \"all\"]));\n}\n\nfunction itemMatchesFilters<TItem extends object>(\n  item: TItem,\n  filters: Record<string, string>,\n): boolean {\n  const record = item as Record<string, unknown>;\n\n  return Object.entries(filters).every(([key, filterValue]) => {\n    if (!filterValue || filterValue === \"all\") {\n      return true;\n    }\n\n    return record[key] === filterValue;\n  });\n}\n\nfunction filterCrudData<TItem extends object>(\n  data: readonly TItem[],\n  search: string,\n  filters: Record<string, string>,\n  searchFields: readonly Extract<keyof TItem, string>[],\n): TItem[] {\n  return data.filter((item) => {\n    if (!itemMatchesFilters(item, filters)) {\n      return false;\n    }\n\n    const record = item as Record<string, unknown>;\n    const searchText = buildCrudSearchText(\n      searchFields.map((field) => record[field]),\n    );\n    return matchesCrudSearch(searchText, search);\n  });\n}\n\nexport function useCrudTableState<TItem extends object>({\n  data,\n  columns,\n  searchFields = [],\n  filters: filterDefinitions = [],\n  pageSize = 20,\n  initialSortState = null,\n}: UseCrudTableStateOptions<TItem>): CrudTableState<TItem> {\n  const [search, setSearch] = useState(\"\");\n  const [filters, setFilters] = useState<Record<string, string>>(() =>\n    buildInitialFilters(filterDefinitions),\n  );\n  const [currentPage, setCurrentPage] = useState(1);\n\n  const filteredData = useMemo(\n    () => filterCrudData(data, search, filters, searchFields),\n    [data, filters, search, searchFields],\n  );\n  const { sortedData, sortState, setSortState } = useTableSorting({\n    data: filteredData,\n    columns,\n    initialSortState,\n  });\n\n  const totalPages = Math.max(1, Math.ceil(filteredData.length / pageSize));\n  const validCurrentPage = getValidPage(currentPage, totalPages);\n  const startIndex = (validCurrentPage - 1) * pageSize;\n  const endIndex = Math.min(startIndex + pageSize, filteredData.length);\n  const paginatedData = useMemo(\n    () => paginateCrudData(sortedData, validCurrentPage, pageSize),\n    [pageSize, sortedData, validCurrentPage],\n  );\n\n  const setFilter = useCallback((key: string, value: string) => {\n    setFilters((currentFilters) => ({\n      ...currentFilters,\n      [key]: value,\n    }));\n    setCurrentPage(1);\n  }, []);\n\n  const updateSearch = useCallback((value: string) => {\n    setSearch(value);\n    setCurrentPage(1);\n  }, []);\n\n  const clearAll = useCallback(() => {\n    setSearch(\"\");\n    setFilters(buildInitialFilters(filterDefinitions));\n    setCurrentPage(1);\n  }, [filterDefinitions]);\n\n  const getDraftFilterResultCount = useCallback(\n    (draftValues: Record<string, string>) =>\n      filterCrudData(\n        data,\n        search,\n        {\n          ...filters,\n          ...draftValues,\n        },\n        searchFields,\n      ).length,\n    [data, filters, search, searchFields],\n  );\n\n  const hasSearch = search.trim().length > 0;\n  const hasFilters = Object.values(filters).some(\n    (value) => value && value !== \"all\",\n  );\n\n  return {\n    filteredData,\n    sortedData,\n    paginatedData,\n    search,\n    setSearch: updateSearch,\n    filters,\n    setFilter,\n    clearAll,\n    getDraftFilterResultCount,\n    hasSearch,\n    hasFilters,\n    emptyState: hasSearch || hasFilters ? \"no-results\" : \"initial\",\n    sortState,\n    setSortState,\n    pagination: {\n      currentPage: validCurrentPage,\n      totalPages,\n      totalItems: filteredData.length,\n      pageSize,\n      startIndex,\n      endIndex,\n      onPageChange: setCurrentPage,\n    },\n  };\n}\n","\"use client\";\n\nimport { parseAsString, useQueryStates } from \"nuqs\";\nimport { useCallback, useMemo } from \"react\";\n\nexport interface UrlStringFilterDefinition<TKey extends string = string> {\n  readonly key: TKey;\n  readonly param?: string;\n  readonly defaultValue?: string;\n  readonly clearValue?: string;\n}\n\ntype UrlStringFilterValues<TDefinitions extends readonly UrlStringFilterDefinition[]> = {\n  readonly [TDefinition in TDefinitions[number] as TDefinition[\"key\"]]: string;\n};\n\nexport interface UrlStringFiltersState<\n  TDefinitions extends readonly UrlStringFilterDefinition[],\n> {\n  readonly values: UrlStringFilterValues<TDefinitions>;\n  readonly setValue: (key: TDefinitions[number][\"key\"], value: string) => void;\n  readonly clear: () => void;\n  readonly getDraftValues: (\n    draftValues: Record<string, string>,\n  ) => UrlStringFilterValues<TDefinitions>;\n}\n\nfunction buildParserMap(definitions: readonly UrlStringFilterDefinition[]) {\n  return Object.fromEntries(\n    definitions.map((definition) => [\n      definition.param ?? definition.key,\n      parseAsString.withDefault(definition.defaultValue ?? \"all\"),\n    ]),\n  );\n}\n\nfunction normalizeFilterValue(\n  value: string,\n  definition: UrlStringFilterDefinition,\n): string | null {\n  const clearValue = definition.clearValue ?? definition.defaultValue ?? \"all\";\n\n  if (value === clearValue) {\n    return null;\n  }\n\n  return value.length > 0 ? value : null;\n}\n\nexport function useUrlStringFilters<\n  const TDefinitions extends readonly UrlStringFilterDefinition[],\n>(definitions: TDefinitions): UrlStringFiltersState<TDefinitions> {\n  const parserMap = useMemo(() => buildParserMap(definitions), [definitions]);\n  const [params, setParams] = useQueryStates(parserMap);\n\n  const values = useMemo(\n    () =>\n      Object.fromEntries(\n        definitions.map((definition) => {\n          const param = definition.param ?? definition.key;\n          return [definition.key, params[param] ?? definition.defaultValue ?? \"all\"];\n        }),\n      ) as UrlStringFilterValues<TDefinitions>,\n    [definitions, params],\n  );\n\n  const setValue = useCallback(\n    (key: TDefinitions[number][\"key\"], value: string) => {\n      const definition = definitions.find((item) => item.key === key);\n\n      if (!definition) {\n        return;\n      }\n\n      void setParams({\n        [definition.param ?? definition.key]: normalizeFilterValue(value, definition),\n      });\n    },\n    [definitions, setParams],\n  );\n\n  const clear = useCallback(() => {\n    void setParams(\n      Object.fromEntries(\n        definitions.map((definition) => [definition.param ?? definition.key, null]),\n      ),\n    );\n  }, [definitions, setParams]);\n\n  const getDraftValues = useCallback(\n    (draftValues: Record<string, string>) =>\n      ({\n        ...values,\n        ...draftValues,\n      }) as UrlStringFilterValues<TDefinitions>,\n    [values],\n  );\n\n  return {\n    values,\n    setValue,\n    clear,\n    getDraftValues,\n  };\n}\n","\"use client\";\n\nimport { parseAsInteger, useQueryState } from \"nuqs\";\nimport { useCallback, useMemo } from \"react\";\n\nimport type { CrudPaginationState } from \"./pagination\";\n\nexport interface UseUrlPaginationOptions {\n  readonly totalItems: number;\n  readonly pageSize?: number;\n  readonly pageParam?: string;\n}\n\nexport interface UrlPaginationState extends CrudPaginationState {\n  readonly hasPrevPage: boolean;\n  readonly hasNextPage: boolean;\n  readonly goToPage: (page: number) => void;\n  readonly nextPage: () => void;\n  readonly prevPage: () => void;\n  readonly firstPage: () => void;\n  readonly lastPage: () => void;\n  readonly paginate: <T>(data: readonly T[]) => T[];\n}\n\nexport function useUrlPagination({\n  totalItems,\n  pageSize = 20,\n  pageParam = \"page\",\n}: UseUrlPaginationOptions): UrlPaginationState {\n  const [page, setPage] = useQueryState(\n    pageParam,\n    parseAsInteger.withDefault(1),\n  );\n\n  const totalPages = Math.max(1, Math.ceil(totalItems / pageSize));\n  const currentPage = Math.min(Math.max(1, page), totalPages);\n  const startIndex = (currentPage - 1) * pageSize;\n  const endIndex = Math.min(startIndex + pageSize, totalItems);\n  const hasPrevPage = currentPage > 1;\n  const hasNextPage = currentPage < totalPages;\n\n  const goToPage = useCallback(\n    (newPage: number) => {\n      const validPage = Math.min(Math.max(1, newPage), totalPages);\n      void setPage(validPage === 1 ? null : validPage);\n    },\n    [setPage, totalPages],\n  );\n\n  const nextPage = useCallback(() => {\n    if (hasNextPage) {\n      goToPage(currentPage + 1);\n    }\n  }, [currentPage, goToPage, hasNextPage]);\n\n  const prevPage = useCallback(() => {\n    if (hasPrevPage) {\n      goToPage(currentPage - 1);\n    }\n  }, [currentPage, goToPage, hasPrevPage]);\n\n  const firstPage = useCallback(() => {\n    goToPage(1);\n  }, [goToPage]);\n\n  const lastPage = useCallback(() => {\n    goToPage(totalPages);\n  }, [goToPage, totalPages]);\n\n  const paginate = useCallback(\n    <T,>(data: readonly T[]): T[] => data.slice(startIndex, endIndex),\n    [endIndex, startIndex],\n  );\n\n  return useMemo(\n    () => ({\n      currentPage,\n      pageSize,\n      totalPages,\n      totalItems,\n      startIndex,\n      endIndex,\n      hasPrevPage,\n      hasNextPage,\n      goToPage,\n      nextPage,\n      prevPage,\n      firstPage,\n      lastPage,\n      paginate,\n      onPageChange: goToPage,\n    }),\n    [\n      currentPage,\n      endIndex,\n      firstPage,\n      goToPage,\n      hasNextPage,\n      hasPrevPage,\n      lastPage,\n      nextPage,\n      pageSize,\n      paginate,\n      prevPage,\n      startIndex,\n      totalItems,\n      totalPages,\n    ],\n  );\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@carefully-built/crud",
+  "version": "0.1.2",
+  "description": "Config-driven CRUD table and form helpers for Carefully Built SaaS apps.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Alessandro Dodi",
+  "homepage": "https://github.com/AlessandroDodi/carefully-built-saas-kit#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AlessandroDodi/carefully-built-saas-kit.git",
+    "directory": "packages/crud"
+  },
+  "bugs": {
+    "url": "https://github.com/AlessandroDodi/carefully-built-saas-kit/issues"
+  },
+  "keywords": [
+    "react",
+    "crud",
+    "table",
+    "saas",
+    "convex"
+  ],
+  "sideEffects": false,
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsdown src/index.ts --format esm --dts",
+    "prepublishOnly": "bun run typecheck && bun run build",
+    "typecheck": "tsc --noEmit"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@carefully-built/ui": ">=0.1.4",
+    "nuqs": ">=2.0.0",
+    "react": ">=18.2.0 || >=19.0.0",
+    "react-dom": ">=18.2.0 || >=19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@carefully-built/ui": {
+      "optional": true
+    },
+    "nuqs": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@carefully-built/ui": "workspace:*",
+    "nuqs": "^2.8.8",
+    "react": "^19.2.3",
+    "react-dom": "^19.2.3"
+  }
+}