@ram_28/kf-ai-sdk 2.0.21 → 2.0.23

package/dist/components/hooks/useFilter/types.d.ts

@@ -21,8 +21,13 @@ export interface ConditionGroupBuilder {
 }
 /**
  * Hook options (minimal configuration)
- * Used for initializing useFilter, and also for initialState in useTable/useKanban
+ * Used for initializing useFilter, and also for initialState in useTable/useBDOTable
  * @template T - Data type for type-safe field names (defaults to any)
+ *
+ * NAMING: Hook options use camelCase (`conditions`, `operator`).
+ * Condition OBJECTS inside the array use PascalCase (`Operator`, `LHSField`, `RHSValue`).
+ * `operator` combines all conditions ("And"/"Or"/"Not").
+ * `ConditionType.Operator` compares a single field ("EQ"/"GT"/etc.).
  */
 export interface UseFilterOptionsType<T = any> {
     /** Filter conditions */

package/dist/components/hooks/useFilter/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../sdk/components/hooks/useFilter/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAClB,0BAA0B,EAC1B,UAAU,EACV,aAAa,EACd,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,0BAA0B,EAC1B,UAAU,EACV,aAAa,GACd,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAC3B,MAAM,aAAa,GAAG,kBAAkB,KACvC,IAAI,IAAI,kBAEV,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,GACtB,MAAM,aAAa,GAAG,kBAAkB,KACvC,IAAI,IAAI,aAEV,CAAC;AAMF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,kCAAkC;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,oCAAoC;IACpC,YAAY,CAAC,SAAS,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,GAAG,qBAAqB,CAAC;IAE1E,mCAAmC;IACnC,iBAAiB,CAAC,QAAQ,EAAE,0BAA0B,GAAG,qBAAqB,CAAC;CAChF;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC,GAAG,GAAG;IAC3C,wBAAwB;IACxB,UAAU,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7D,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,0BAA0B,CAAC;CACvC;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,GAAG,GAAG;IAK1C,kFAAkF;IAClF,QAAQ,EAAE,0BAA0B,CAAC;IAErC,+CAA+C;IAC/C,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;IAEvD,yEAAyE;IACzE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAEnC,mCAAmC;IACnC,aAAa,EAAE,OAAO,CAAC;IAMvB;;;;;OAKG;IACH,YAAY,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAErF;;;;;OAKG;IACH,iBAAiB,EAAE,CAAC,QAAQ,EAAE,0BAA0B,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAMvF;;;;OAIG;IACH,eAAe,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC;IAEtF;;;;OAIG;IACH,mBAAmB,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,0BAA0B,KAAK,IAAI,CAAC;IAMhF;;;OAGG;IACH,eAAe,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAEtC;;;;OAIG;IACH,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,aAAa,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAMnF,2BAA2B;IAC3B,kBAAkB,EAAE,MAAM,IAAI,CAAC;IAE/B,qDAAqD;IACrD,eAAe,EAAE,CAAC,EAAE,EAAE,0BAA0B,KAAK,IAAI,CAAC;CAC3D"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../sdk/components/hooks/useFilter/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAClB,0BAA0B,EAC1B,UAAU,EACV,aAAa,EACd,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,0BAA0B,EAC1B,UAAU,EACV,aAAa,GACd,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAC3B,MAAM,aAAa,GAAG,kBAAkB,KACvC,IAAI,IAAI,kBAEV,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,GACtB,MAAM,aAAa,GAAG,kBAAkB,KACvC,IAAI,IAAI,aAEV,CAAC;AAMF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,kCAAkC;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,oCAAoC;IACpC,YAAY,CAAC,SAAS,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,GAAG,qBAAqB,CAAC;IAE1E,mCAAmC;IACnC,iBAAiB,CAAC,QAAQ,EAAE,0BAA0B,GAAG,qBAAqB,CAAC;CAChF;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC,GAAG,GAAG;IAC3C,wBAAwB;IACxB,UAAU,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7D,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,0BAA0B,CAAC;CACvC;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,GAAG,GAAG;IAK1C,kFAAkF;IAClF,QAAQ,EAAE,0BAA0B,CAAC;IAErC,+CAA+C;IAC/C,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;IAEvD,yEAAyE;IACzE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAEnC,mCAAmC;IACnC,aAAa,EAAE,OAAO,CAAC;IAMvB;;;;;OAKG;IACH,YAAY,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAErF;;;;;OAKG;IACH,iBAAiB,EAAE,CAAC,QAAQ,EAAE,0BAA0B,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAMvF;;;;OAIG;IACH,eAAe,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC;IAEtF;;;;OAIG;IACH,mBAAmB,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,0BAA0B,KAAK,IAAI,CAAC;IAMhF;;;OAGG;IACH,eAAe,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAEtC;;;;OAIG;IACH,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,aAAa,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAMnF,2BAA2B;IAC3B,kBAAkB,EAAE,MAAM,IAAI,CAAC;IAE/B,qDAAqD;IACrD,eAAe,EAAE,CAAC,EAAE,EAAE,0BAA0B,KAAK,IAAI,CAAC;CAC3D"}

package/docs/examples/fields/complex-fields.md

@@ -23,11 +23,11 @@ import {
   SelectTrigger,
   SelectValue,
 } from "@/components/ui/select";
-import { ReferenceSelect } from "@/components/ui/reference-select";
-import { FileUpload } from "@/components/ui/file-upload";
-import { ImageUpload } from "@/components/ui/image-upload";
-import { FilePreview } from "@/components/ui/file-preview";
-import { ImageThumbnail } from "@/components/ui/image-thumbnail";
+import { ReferenceSelect } from "@/components/system/reference-select";
+import { FileUpload } from "@/components/system/file-upload";
+import { ImageUpload } from "@/components/system/image-upload";
+import { FilePreview } from "@/components/system/file-preview";
+import { ImageThumbnail } from "@/components/system/image-thumbnail";
 
 export default function ComplexFieldsForm({ recordId }: { recordId?: string }) {
   const fieldTest = useMemo(() => new AdminFieldTest(), []);
@@ -204,8 +204,8 @@ export default function ComplexFieldsForm({ recordId }: { recordId?: string }) {
 For tables and detail pages, use `<FilePreview>` and `<ImageThumbnail>`:
 
 ```tsx
-import { FilePreview } from "@/components/ui/file-preview";
-import { ImageThumbnail } from "@/components/ui/image-thumbnail";
+import { FilePreview } from "@/components/system/file-preview";
+import { ImageThumbnail } from "@/components/system/image-thumbnail";
 
 // In a table row or detail page
 function RecordRow({ record }: { record: ItemType<...> }) {

package/docs/fields/README.md

@@ -126,13 +126,13 @@ const { data: options = [] } = useQuery({
 
 ## UI Components
 
-| Component           | Field     | Mode      | Key Props                                         |
-| ------------------- | --------- | --------- | ------------------------------------------------- |
-| `<ReferenceSelect>` | Reference | Edit      | `bdoField`, `instanceId`, `value`, `onChange`     |
-| `<FileUpload>`      | File      | Edit      | `field`, `value`, `boId`, `instanceId`, `fieldId` |
-| `<ImageUpload>`     | Image     | Edit      | `field`, `value`, `boId`, `instanceId`, `fieldId` |
-| `<FilePreview>`     | File      | Read-only | `boId`, `instanceId`, `fieldId`, `value`          |
-| `<ImageThumbnail>`  | Image     | Read-only | `boId`, `instanceId`, `fieldId`, `value`          |
+| Component           | Field     | Mode      | Import Path                            | Key Props                                         |
+| ------------------- | --------- | --------- | -------------------------------------- | ------------------------------------------------- |
+| `<ReferenceSelect>` | Reference | Edit      | `@/components/system/reference-select` | `bdoField`, `instanceId`, `value`, `onChange`     |
+| `<FileUpload>`      | File      | Edit      | `@/components/system/file-upload`      | `field`, `value`, `boId`, `instanceId`, `fieldId` |
+| `<ImageUpload>`     | Image     | Edit      | `@/components/system/image-upload`     | `field`, `value`, `boId`, `instanceId`, `fieldId` |
+| `<FilePreview>`     | File      | Read-only | `@/components/system/file-preview`     | `boId`, `instanceId`, `fieldId`, `value`          |
+| `<ImageThumbnail>`  | Image     | Read-only | `@/components/system/image-thumbnail`  | `boId`, `instanceId`, `fieldId`, `value`          |
 
 ## Further Reading
 

package/docs/useFilter/README.md

@@ -229,7 +229,7 @@ filter.addCondition(
 The root operator combines all top-level conditions. It defaults to `"And"` and can be set via the `operator` option or changed later with `setRootOperator()`:
 
 ```tsx
-// Set at initialization
+// Set at initialization — camelCase hook option, NOT a condition property
 const filter = useFilter<AdminProductFieldType>({
   operator: "Or",
 });
@@ -265,16 +265,22 @@ const table = useBDOTable({
   bdo: product,
   initialState: {
     filter: {
+      // Inside condition objects → PascalCase: Operator, LHSField, RHSValue
       conditions: [
         { Operator: ConditionOperator.EQ, LHSField: "status", RHSValue: "Active" },
       ],
+      // Hook option → camelCase: operator (combines conditions, NOT a condition property)
       operator: "And",
     },
   },
 });
 
-// Same API as standalone useFilter
-table.filter.addCondition({ ... });
+// Same API as standalone useFilter — condition objects always PascalCase
+table.filter.addCondition({
+  Operator: ConditionOperator.EQ,   // PascalCase! NOT operator:
+  LHSField: product.Category.id,
+  RHSValue: "Electronics",
+});
 table.filter.clearAllConditions();
 ```
 
@@ -316,8 +322,9 @@ filter.items.map((item) => {
 
 ## Common Mistakes
 
+- **NEVER write `operator:` (lowercase) inside condition objects** -- this is the #1 error. Condition objects require PascalCase `Operator:`. The camelCase `operator` is ONLY for hook options like `useFilter({ operator: "And" })`. Inside `addCondition({...})` or `conditions: [{...}]`, ALWAYS write `{ Operator: ConditionOperator.EQ, ... }`.
 - **Don't read `filter.conditions`** -- the property is `filter.items`.
 - **Don't expect `payload` to be an empty object when empty** -- it's `undefined`. Use a simple falsy check: `if (filter.payload) { ... }`.
 - **Don't use string literals** -- use `ConditionOperator.EQ`, `GroupOperator.And`, `FilterValueSource.Constant` instead.
 - **Don't expect IDs in `payload`** -- they're stripped automatically before the payload is built.
-- **Don't mix PascalCase and camelCase** -- condition properties are PascalCase (`Operator`, `LHSField`, `RHSValue`, `RHSType`), while hook options are camelCase (`conditions`, `operator`).
+- **Don't mix PascalCase and camelCase** -- condition properties are PascalCase (`Operator`, `LHSField`, `RHSValue`, `RHSType`), while hook options are camelCase (`conditions`, `operator`). Writing `operator: "EQ"` (lowercase) in a condition causes TS2561.

package/docs/useFilter/api_reference.md

@@ -30,7 +30,7 @@ const filter: UseFilterReturnType<T> = useFilter<T>(options: UseFilterOptionsTyp
   - Initial filter conditions. Each item is cloned and assigned an auto-generated `id`.
 - `operator?: ConditionGroupOperatorType`
   - **Optional**, defaults to `"And"`
-  - Root operator for combining top-level conditions.
+  - Root operator for combining top-level conditions. NOT the same as `ConditionType.Operator`.
 
 ## Return Value
 
@@ -198,7 +198,8 @@ type FilterRHSType = (typeof FilterValueSource)[keyof typeof FilterValueSource];
 interface UseFilterOptionsType<T = any> {
   /** Initial filter conditions. Each item is cloned and assigned an auto-generated id. */
   conditions?: Array<ConditionType<T> | ConditionGroupType<T>>;
-  /** Root operator for combining conditions. Defaults to "And". */
+  /** Root operator for combining conditions. Defaults to "And".
+   *  NOT the same as ConditionType.Operator — this combines conditions, not compares fields. */
   operator?: ConditionGroupOperatorType;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ram_28/kf-ai-sdk",
-  "version": "2.0.21",
+  "version": "2.0.23",
   "description": "Type-safe, AI-driven SDK for building modern web applications with role-based access control",
   "author": "Ramprasad",
   "license": "MIT",

package/sdk/components/hooks/useFilter/types.ts

@@ -57,8 +57,13 @@ export interface ConditionGroupBuilder {
 
 /**
  * Hook options (minimal configuration)
- * Used for initializing useFilter, and also for initialState in useTable/useKanban
+ * Used for initializing useFilter, and also for initialState in useTable/useBDOTable
  * @template T - Data type for type-safe field names (defaults to any)
+ *
+ * NAMING: Hook options use camelCase (`conditions`, `operator`).
+ * Condition OBJECTS inside the array use PascalCase (`Operator`, `LHSField`, `RHSValue`).
+ * `operator` combines all conditions ("And"/"Or"/"Not").
+ * `ConditionType.Operator` compares a single field ("EQ"/"GT"/etc.).
  */
 export interface UseFilterOptionsType<T = any> {
   /** Filter conditions */