@ram_28/kf-ai-sdk 2.0.16 → 2.0.18

package/docs/useBDOForm.md

@@ -1,376 +0,0 @@
-# useBDOForm
-
-React hook for BDO forms with validation, API integration, and typed field handling.
-
-## Imports
-
-```typescript
-import { useBDOForm } from "@ram_28/kf-ai-sdk/form";
-import { ValidationMode, FormOperation } from "@ram_28/kf-ai-sdk/form";
-import type { UseBDOFormOptionsType, UseBDOFormReturnType, FormItemType, FormRegisterType, HandleSubmitType } from "@ram_28/kf-ai-sdk/form/types";
-import type { CreateUpdateResponseType } from "@ram_28/kf-ai-sdk/api/types";
-
-// Pre-built components for special field types
-import { ReferenceSelect } from "@/components/ui/reference-select";
-import { ImageUpload } from "@/components/ui/image-upload";
-import { FileUpload } from "@/components/ui/file-upload";
-```
-
----
-
-## Common Mistakes (READ FIRST)
-
-### 1. Missing `operation` in useBDOForm options (TS2345)
-
-ALWAYS include `operation`. Without it, TypeScript cannot resolve the union type.
-
-```typescript
-// ❌ WRONG — missing operation (TS2345)
-useBDOForm({ bdo: product, mode: ValidationMode.OnBlur });
-
-// ✅ CORRECT — always include operation
-useBDOForm({ bdo: product, operation: FormOperation.Create, mode: ValidationMode.OnBlur });
-useBDOForm({ bdo: product, operation: FormOperation.Update, recordId: id, mode: ValidationMode.OnBlur });
-```
-
-### 2. Annotating ternary with UseBDOFormOptionsType (TS2322)
-
-`UseBDOFormOptionsType` is a discriminated union. Type-annotating a variable prevents TS narrowing. NEVER annotate — call useBDOForm inline in each branch.
-
-```typescript
-// ❌ WRONG — type annotation prevents union narrowing (TS2322)
-const options: UseBDOFormOptionsType<typeof bdo> = id
-  ? { bdo, operation: FormOperation.Update, recordId: id, mode: ValidationMode.OnBlur }
-  : { bdo, operation: FormOperation.Create, mode: ValidationMode.OnBlur };
-const formResult = useBDOForm(options);
-
-// ✅ CORRECT — call useBDOForm inline, no type annotation
-const formResult = id
-  ? useBDOForm({ bdo, operation: FormOperation.Update, recordId: id, mode: ValidationMode.OnBlur })
-  : useBDOForm({ bdo, operation: FormOperation.Create, mode: ValidationMode.OnBlur });
-const { register, handleSubmit, watch, setValue, item, formState: { errors, isSubmitting }, isLoading } = formResult;
-```
-
-### 3. Using `.options` on StringField (TS2339)
-
-ONLY `SelectField` has `.options` getter. `StringField` with `Constraint.Enum` does NOT — use hardcoded `<option>` values from the BDO file.
-
-```tsx
-// Check the BDO class to determine field type:
-// new SelectField({...}) → has .options     → use bdo.field.options.map()
-// new StringField({..."Constraint": {"Enum": [...]}}) → NO .options → hardcode from Enum array
-
-// ❌ WRONG — StringField has no .options (TS2339)
-// Given: readonly status = new StringField({... "Constraint": { "Enum": ["Active", "Discontinued"] }})
-<select {...register(bdo.status.id)}>
-  {bdo.status.options.map((opt) => (          // TS2339: Property 'options' does not exist on StringField
-    <option key={opt.value} value={opt.value}>{opt.label}</option>
-  ))}
-</select>
-
-// ✅ CORRECT for StringField with Enum — hardcode options from BDO Constraint.Enum array
-<select {...register(bdo.status.id)}>
-  <option value="">Select {bdo.status.label}</option>
-  <option value="Active">Active</option>
-  <option value="Discontinued">Discontinued</option>
-</select>
-
-// ✅ CORRECT for SelectField — use .options getter
-// Given: readonly status = new SelectField({...})
-<select {...register(bdo.status.id)}>
-  <option value="">Select {bdo.status.label}</option>
-  {bdo.status.options.map((opt) => (
-    <option key={opt.value} value={opt.value}>{opt.label}</option>
-  ))}
-</select>
-```
-
-### 4. Using register() for BooleanField
-
-HTML checkboxes don't work with register(). Use watch/setValue.
-
-```tsx
-// ❌ WRONG
-<input type="checkbox" {...register(bdo.is_active.id)} />
-
-// ✅ CORRECT
-<Checkbox
-  checked={Boolean(watch(bdo.is_active.id))}
-  onCheckedChange={(v) => setValue(bdo.is_active.id, v as boolean, { shouldDirty: true })}
-/>
-```
-
-### 5. Using `<input>` for ReferenceField (should use `<ReferenceSelect>`)
-
-ReferenceField stores an object `{ _id, _name, ... }`, not a string. Use the pre-built component.
-
-```tsx
-// ❌ WRONG — text input for reference field
-<input {...register(bdo.category.id)} />
-
-// ✅ CORRECT
-<ReferenceSelect
-  bdoField={bdo.category}
-  instanceId={id || String(watch("_id") ?? "")}
-  value={watch(bdo.category.id)}
-  onChange={(val) => setValue(bdo.category.id, val, { shouldDirty: true })}
-/>
-```
-
-### 6. Using custom Image/File upload (should use template components)
-
-Use `<ImageUpload>` and `<FileUpload>`. CRITICAL: `instanceId` must work for BOTH edit and create mode.
-
-```tsx
-// ❌ WRONG — instanceId={id} is undefined in create mode
-<ImageUpload field={item.icon} value={watch(bdo.icon.id)} boId={bdo.meta._id} instanceId={id} fieldId={bdo.icon.id} />
-
-// ✅ CORRECT — ImageUpload (single image)
-<ImageUpload
-  field={item.product_image}
-  value={watch(bdo.product_image.id)}
-  boId={bdo.meta._id}
-  instanceId={id || String(watch("_id") ?? "")}
-  fieldId={bdo.product_image.id}
-/>
-
-// ✅ CORRECT — FileUpload (multi-file)
-<FileUpload
-  field={item.specification_document}
-  value={watch(bdo.specification_document.id)}
-  boId={bdo.meta._id}
-  instanceId={id || String(watch("_id") ?? "")}
-  fieldId={bdo.specification_document.id}
-/>
-```
-
-Props: `field` = item accessor (`item.fieldName`), `value` = `watch(bdo.field.id)`, `boId` = `bdo.meta._id`, `instanceId` = `id || String(watch("_id") ?? "")`, `fieldId` = `bdo.field.id`. Parent component MUST have `"use no memo"` directive.
-
-### 7. Wrong handleSubmit onSuccess type
-
-```typescript
-// ❌ WRONG
-const onSuccess = (data: unknown) => { ... };
-
-// ✅ CORRECT — CreateUpdateResponseType = { _id: string }
-import type { CreateUpdateResponseType } from "@ram_28/kf-ai-sdk/api/types";
-const onSuccess = (data: CreateUpdateResponseType) => { toast.success("Saved"); navigate("/list"); };
-```
-
-### 8. Passing FieldType instead of BDO instance
-
-```typescript
-// ❌ WRONG
-useBDOForm<ProductFieldType>({ ... });
-
-// ✅ CORRECT — pass BDO class instance
-const product = useMemo(() => new SellerProduct(), []);
-useBDOForm({ bdo: product, operation: FormOperation.Create, mode: ValidationMode.OnBlur });
-```
-
-### 9. Wrong default values for date fields
-
-```typescript
-// ❌ WRONG — empty string causes type errors
-defaultValues: { start_date: "" }
-
-// ✅ CORRECT
-defaultValues: { start_date: undefined }
-```
-
----
-
-## Complete Form Example (Create + Edit)
-
-```tsx
-"use no memo";
-
-import { useMemo } from "react";
-import { useNavigate, useParams } from "react-router-dom";
-import { useBDOForm, ValidationMode, FormOperation } from "@ram_28/kf-ai-sdk/form";
-import type { CreateUpdateResponseType } from "@ram_28/kf-ai-sdk/api/types";
-import { AdminProduct } from "@/bdo/admin/Product";
-import { ReferenceSelect } from "@/components/ui/reference-select";
-import { ImageUpload } from "@/components/ui/image-upload";
-import { FileUpload } from "@/components/ui/file-upload";
-import { Checkbox } from "@/components/ui/checkbox";
-import { toast } from "sonner";
-
-export default function ProductForm() {
-  const { id } = useParams<{ id: string }>();
-  const navigate = useNavigate();
-  const bdo = useMemo(() => new AdminProduct(), []);
-
-  // Create/Edit ternary — NO type annotation on result
-  const formResult = id
-    ? useBDOForm({ bdo, operation: FormOperation.Update, recordId: id, mode: ValidationMode.OnBlur })
-    : useBDOForm({ bdo, operation: FormOperation.Create, mode: ValidationMode.OnBlur });
-
-  const { register, handleSubmit, watch, setValue, item, formState: { errors, isSubmitting }, isLoading } = formResult;
-
-  // Loading guard AFTER all hooks
-  if (isLoading) return <div className="flex items-center justify-center h-full"><div className="animate-spin w-8 h-8 border-4 border-primary border-t-transparent rounded-full" /></div>;
-
-  const onSuccess = (data: CreateUpdateResponseType) => {
-    toast.success(id ? "Updated" : "Created");
-    navigate("/products");
-  };
-
-  const onError = (error: any) => {
-    toast.error(error instanceof Error ? error.message : "Please fix errors above");
-  };
-
-  return (
-    <form onSubmit={handleSubmit(onSuccess, onError)} className="space-y-6">
-      {/* StringField — register */}
-      <div>
-        <label>{bdo.product_name.label}{bdo.product_name.required && <span className="text-red-500"> *</span>}</label>
-        <input {...register(bdo.product_name.id)} className="w-full border rounded px-3 py-2" />
-        {errors.product_name && <p className="text-red-600 text-sm">{errors.product_name.message}</p>}
-      </div>
-
-      {/* NumberField — register */}
-      <div>
-        <label>{bdo.unit_price.label}</label>
-        <input type="number" step="0.01" {...register(bdo.unit_price.id)} className="w-full border rounded px-3 py-2" />
-        {errors.unit_price && <p className="text-red-600 text-sm">{errors.unit_price.message}</p>}
-      </div>
-
-      {/* StringField with Constraint.Enum — hardcoded options (NO .options getter) */}
-      <div>
-        <label>{bdo.status.label}</label>
-        <select {...register(bdo.status.id)} className="w-full border rounded px-3 py-2">
-          <option value="">Select {bdo.status.label}</option>
-          <option value="Active">Active</option>
-          <option value="Discontinued">Discontinued</option>
-        </select>
-        {errors.status && <p className="text-red-600 text-sm">{errors.status.message}</p>}
-      </div>
-
-      {/* ReferenceField — ReferenceSelect component */}
-      <div>
-        <label>{bdo.category.label}</label>
-        <ReferenceSelect
-          bdoField={bdo.category}
-          instanceId={id || String(watch("_id") ?? "")}
-          value={watch(bdo.category.id)}
-          onChange={(val) => setValue(bdo.category.id, val, { shouldDirty: true })}
-        />
-        {errors.category && <p className="text-red-600 text-sm">{String(errors.category.message ?? "")}</p>}
-      </div>
-
-      {/* BooleanField — watch + setValue */}
-      <div className="flex items-center gap-2">
-        <Checkbox
-          checked={Boolean(watch(bdo.is_active.id))}
-          onCheckedChange={(v) => setValue(bdo.is_active.id, v as boolean, { shouldDirty: true })}
-        />
-        <label>{bdo.is_active.label}</label>
-      </div>
-
-      {/* ImageField — ImageUpload component */}
-      <div>
-        <label>{bdo.product_image.label}</label>
-        <ImageUpload
-          field={item.product_image}
-          value={watch(bdo.product_image.id)}
-          boId={bdo.meta._id}
-          instanceId={id || String(watch("_id") ?? "")}
-          fieldId={bdo.product_image.id}
-        />
-      </div>
-
-      {/* FileField — FileUpload component */}
-      <div>
-        <label>{bdo.specification_document.label}</label>
-        <FileUpload
-          field={item.specification_document}
-          value={watch(bdo.specification_document.id)}
-          boId={bdo.meta._id}
-          instanceId={id || String(watch("_id") ?? "")}
-          fieldId={bdo.specification_document.id}
-        />
-      </div>
-
-      {/* TextField — textarea with register */}
-      <div>
-        <label>{bdo.description.label}</label>
-        <textarea {...register(bdo.description.id)} rows={4} className="w-full border rounded px-3 py-2" />
-      </div>
-
-      <button type="submit" disabled={isSubmitting} className="px-4 py-2 bg-primary text-white rounded">
-        {isSubmitting ? "Saving..." : id ? "Update" : "Create"}
-      </button>
-    </form>
-  );
-}
-```
-
----
-
-## Type Definitions
-
-### UseBDOFormOptionsType (Discriminated Union)
-
-```typescript
-type UseBDOFormOptionsType<B extends BaseBdo<any, any, any>> =
-  | { bdo: B; operation: "create"; defaultValues?: Partial<EditableFieldType>; mode?: ValidationModeType; }
-  | { bdo: B; operation: "update"; recordId: string; mode?: ValidationModeType; }
-  | { bdo: B; recordId?: string; defaultValues?: Partial<EditableFieldType>; mode?: ValidationModeType; };
-```
-
-### UseBDOFormReturnType
-
-```typescript
-interface UseBDOFormReturnType<B> {
-  item: FormItemType<EditableFieldType, ReadonlyFieldType>;  // Field accessors (.get(), .set(), .upload())
-  register: FormRegisterType;       // Auto-disables readonly fields
-  handleSubmit: HandleSubmitType;   // Auto-calls bdo.create() or bdo.update()
-  watch: UseFormWatch;              // Watch field values by bdo.field.id
-  setValue: UseFormSetValue;        // Set field values by bdo.field.id
-  getValues: UseFormGetValues;
-  control: Control;
-  formState: FormState;
-  errors: FieldErrors;
-  isLoading: boolean;               // Fetching record data (edit mode)
-  isSubmitting: boolean;
-  isDirty: boolean;
-  loadError: Error | null;
-}
-```
-
-### File & Image Types
-
-```typescript
-interface FileType { _id: string; _name: string; FileName: string; FileExtension: string; Size: number; ContentType: string; }
-type ImageFieldType = FileType | null;   // Single image, nullable
-type FileFieldType = FileType[];          // Array of files
-```
-
-Image accessor: `item.field.get()` returns `FileType | null`. Has `upload(file: File)`, `deleteAttachment()`, `getDownloadUrl()`.
-File accessor: `item.field.get()` returns `FileType[]`. Has `upload(files: File[])`, `deleteAttachment(id)`, `getDownloadUrl(id)`.
-
-### Constants
-
-```typescript
-FormOperation.Create  // "create"
-FormOperation.Update  // "update"
-ValidationMode.OnBlur / .OnChange / .OnSubmit / .OnTouched / .All
-```
-
-### Field-Type to UI Component Mapping
-
-| BDO Field Class | UI Pattern |
-|---|---|
-| `StringField` | `<input {...register(bdo.field.id)} />` |
-| `StringField` with `Constraint.Enum` | `<select {...register(bdo.field.id)}>` with hardcoded `<option>` from Enum array |
-| `SelectField` | `<select {...register(bdo.field.id)}>` with `bdo.field.options.map()` |
-| `TextField` | `<textarea {...register(bdo.field.id)} />` |
-| `NumberField` | `<input type="number" {...register(bdo.field.id)} />` |
-| `BooleanField` | `<Checkbox checked={watch()} onCheckedChange={v => setValue()} />` |
-| `DateField` | `<input type="date" {...register(bdo.field.id)} />` |
-| `DateTimeField` | `<input type="datetime-local" {...register(bdo.field.id)} />` |
-| `ReferenceField` | `<ReferenceSelect bdoField={bdo.field} instanceId={id \|\| String(watch("_id") ?? "")} value={watch()} onChange={...} />` |
-| `UserField` | `<ReferenceSelect bdoField={bdo.field} instanceId={id \|\| String(watch("_id") ?? "")} value={watch()} onChange={...} />` |
-| `ImageField` | `<ImageUpload field={item.field} value={watch()} boId={} instanceId={} fieldId={} />` |
-| `FileField` | `<FileUpload field={item.field} value={watch()} boId={} instanceId={} fieldId={} />` |

package/docs/useBDOTable.md

@@ -1,284 +0,0 @@
-# useBDOTable
-
-Hook for BDO (Business Data Object) tables with search, sort, filter, and pagination. Pass a BDO instance and the hook handles the rest.
-
-## Imports
-
-```typescript
-import { useBDOTable } from "@ram_28/kf-ai-sdk/table";
-import { ConditionOperator, RHSType } from "@ram_28/kf-ai-sdk/table";
-import type { UseBDOTableOptionsType, UseBDOTableReturnType } from "@ram_28/kf-ai-sdk/table/types";
-```
-
----
-
-## Common Mistakes (READ FIRST)
-
-### 1. Passing `source` instead of `bdo`
-
-`useBDOTable` takes a `bdo` instance, NOT a `source` string.
-
-```typescript
-// ❌ WRONG — source is not a valid property on useBDOTable
-useBDOTable({ source: product.meta._id });
-
-// ✅ CORRECT — pass the BDO instance
-useBDOTable({ bdo: product });
-```
-
-### 2. Passing a raw object instead of a BDO instance
-
-The `bdo` property expects an object with a `meta` property containing `_id` and `name`. A plain object or entity type will not work.
-
-```typescript
-// ❌ WRONG — plain object without meta
-useBDOTable({ bdo: { _id: 'BO_Product', name: 'Product' } });
-
-// ✅ CORRECT — a BDO class instance
-const product = useMemo(() => new BuyerProduct(), []);
-useBDOTable({ bdo: product });
-```
-
-### 3. Recreating the BDO on every render
-
-Constructing the BDO inside the component body without `useMemo` creates a new instance on every render, which destabilizes the query key and causes infinite refetching.
-
-```typescript
-// ❌ WRONG — new instance every render
-function ProductsTable() {
-  const product = new BuyerProduct();
-  const table = useBDOTable({ bdo: product }); // infinite refetch loop
-}
-
-// ✅ CORRECT — memoize the instance
-function ProductsTable() {
-  const product = useMemo(() => new BuyerProduct(), []);
-  const table = useBDOTable({ bdo: product });
-}
-```
-
-### 4. Using `columns` with useBDOTable
-
-`useBDOTable` does not accept a `columns` property. Column definitions are a UI concern handled in your rendering logic, not in the hook options.
-
-```typescript
-// ❌ WRONG — columns is not a hook option
-useBDOTable({
-  bdo: product,
-  columns: [{ fieldId: 'Title', label: 'Title' }],
-});
-
-// ✅ CORRECT — define columns separately for rendering
-const columns = [
-  { fieldId: product.Title.id, label: product.Title.label },
-  { fieldId: product.Price.id, label: product.Price.label },
-];
-const table = useBDOTable({ bdo: product });
-```
-
-### 5. Calling `.get()` on table rows
-
-Table `rows` are plain objects, NOT `ItemType`. The `.get()` accessor is only available on items returned by `bdo.get()`, `bdo.create()`, or the `useBDOForm` item proxy.
-
-```typescript
-// ❌ WRONG — rows are plain objects, not ItemType
-table.rows.map((row) => row.Title.get());
-
-// ✅ CORRECT — access properties directly
-table.rows.map((row) => row.Title);
-```
-
-### 6. Wrong initialState property names
-
-This is not react-table. Do not use react-table naming conventions.
-
-```typescript
-// ❌ WRONG — sorting and pageIndex are react-table names
-useBDOTable({
-  bdo: product,
-  initialState: { sorting: [...], pagination: { pageIndex: 0, pageSize: 10 } },
-});
-
-// ✅ CORRECT — use sort and pageNo (1-indexed)
-useBDOTable({
-  bdo: product,
-  initialState: {
-    sort: [{ [product.Title.id]: 'ASC' }],
-    pagination: { pageNo: 1, pageSize: 10 },
-  },
-});
-```
-
----
-
-## Complete Example
-
-A product listing page with search, filter, sort, and pagination.
-
-```tsx
-import { useMemo, useState } from "react";
-import { useBDOTable } from "@ram_28/kf-ai-sdk/table";
-import { ConditionOperator, RHSType } from "@ram_28/kf-ai-sdk/table";
-import type { UseBDOTableReturnType } from "@ram_28/kf-ai-sdk/table/types";
-import { BuyerProduct } from "../bdo/buyer/Product";
-import type { BuyerProductFieldType } from "../bdo/buyer/Product";
-
-function ProductListPage() {
-  const productBdo = useMemo(() => new BuyerProduct(), []);
-  const [selectedCategory, setSelectedCategory] = useState("all");
-
-  const table: UseBDOTableReturnType<BuyerProductFieldType> =
-    useBDOTable<BuyerProductFieldType>({
-      bdo: productBdo,
-      initialState: {
-        sort: [{ [productBdo.Title.id]: "ASC" }],
-        pagination: { pageNo: 1, pageSize: 10 },
-      },
-      onError: (error) => {
-        console.error("Table fetch failed:", error.message);
-      },
-      onSuccess: (data) => {
-        console.log("Loaded", data.length, "rows");
-      },
-    });
-
-  const handleCategoryChange = (category: string) => {
-    setSelectedCategory(category);
-    table.filter.clearAllConditions();
-    if (category !== "all") {
-      table.filter.addCondition({
-        LHSField: productBdo.Category.id,
-        Operator: ConditionOperator.EQ,
-        RHSValue: category,
-        RHSType: RHSType.Constant,
-      });
-    }
-  };
-
-  if (table.isLoading) return <div>Loading...</div>;
-  if (table.error) {
-    return (
-      <div>
-        <p>Error: {table.error.message}</p>
-        <button onClick={() => table.refetch()}>Retry</button>
-      </div>
-    );
-  }
-
-  return (
-    <div>
-      {/* Search */}
-      <input
-        type="text"
-        placeholder="Search products..."
-        value={table.search.query}
-        onChange={(e) => table.search.set(productBdo.Title.id, e.target.value)}
-      />
-      {table.search.query && (
-        <button onClick={table.search.clear}>Clear Search</button>
-      )}
-
-      {/* Category Filter */}
-      <select
-        value={selectedCategory}
-        onChange={(e) => handleCategoryChange(e.target.value)}
-      >
-        <option value="all">All Categories</option>
-        <option value="Electronics">Electronics</option>
-        <option value="Books">Books</option>
-      </select>
-
-      {/* Sort */}
-      <select
-        onChange={(e) => {
-          const [field, dir] = e.target.value.split(":");
-          table.sort.set(field, dir as "ASC" | "DESC");
-        }}
-      >
-        <option value={`${productBdo.Title.id}:ASC`}>Name A-Z</option>
-        <option value={`${productBdo.Price.id}:ASC`}>Price: Low to High</option>
-        <option value={`${productBdo.Price.id}:DESC`}>Price: High to Low</option>
-      </select>
-
-      {/* Results */}
-      <p>{table.totalItems} results</p>
-      <div>
-        {table.rows.map((row) => (
-          <div key={row._id}>
-            <h3>{row.Title}</h3>
-            <p>${row.Price}</p>
-            <p>{row.Category}</p>
-          </div>
-        ))}
-      </div>
-
-      {/* Pagination */}
-      <div>
-        <button
-          onClick={table.pagination.goToPrevious}
-          disabled={!table.pagination.canGoPrevious}
-        >
-          Previous
-        </button>
-        <span>
-          Page {table.pagination.pageNo} of {table.pagination.totalPages}
-        </span>
-        <button
-          onClick={table.pagination.goToNext}
-          disabled={!table.pagination.canGoNext}
-        >
-          Next
-        </button>
-      </div>
-    </div>
-  );
-}
-```
-
----
-
-## Type Definitions
-
-### UseBDOTableOptionsType
-
-```typescript
-export interface UseBDOTableOptionsType<T> {
-  /** BDO instance — only meta._id is used (for API routing) */
-  bdo: {
-    meta: { readonly _id: string; readonly name: string };
-  };
-
-  /** Initial state */
-  initialState?: {
-    sort?: SortType;
-    pagination?: PaginationStateType;
-    filter?: UseFilterOptionsType<T>;
-  };
-
-  /** Error callback */
-  onError?: (error: Error) => void;
-
-  /** Success callback — receives rows from current page */
-  onSuccess?: (data: T[]) => void;
-}
-```
-
-### UseBDOTableReturnType
-
-```typescript
-export type UseBDOTableReturnType<T> = UseTableReturnType<T>;
-```
-
-The return type is identical to `UseTableReturnType<T>`. All properties — `rows`, `totalItems`, `isLoading`, `isFetching`, `error`, `search`, `sort`, `filter`, `pagination`, and `refetch` — behave the same.
-
----
-
-## Search, Sort, Filter, and Pagination
-
-`useBDOTable` supports `initialState`, `onError`, and `onSuccess` options.
-
-- **Search** — `table.search.set(field, query)`, `table.search.clear()`, 300ms debounce
-- **Sort** — `table.sort.toggle(field)`, `table.sort.set(field, direction)`, `table.sort.clear()`
-- **Filter** — `table.filter.addCondition(...)`, `table.filter.removeCondition(...)`, `table.filter.clearAllConditions()`
-- **Pagination** — `table.pagination.goToNext()`, `table.pagination.goToPrevious()`, `table.pagination.goToPage(n)`, `table.pagination.setPageSize(n)`
-