@ram_28/kf-ai-sdk 1.0.14 → 1.0.15

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

@@ -8,6 +8,17 @@ export declare const isConditionGroup: (item: ConditionType | ConditionGroupType
  * Type guard to check if an item is a leaf Condition (has LHSField)
  */
 export declare const isCondition: (item: ConditionType | ConditionGroupType) => item is ConditionType;
+/**
+ * Builder interface for fluent condition group construction
+ */
+export interface ConditionGroupBuilder {
+    /** The id of the created group */
+    readonly id: string;
+    /** Add a condition to this group */
+    addCondition(condition: Omit<ConditionType, "id">): ConditionGroupBuilder;
+    /** Add a nested condition group */
+    addConditionGroup(operator: ConditionGroupOperatorType): ConditionGroupBuilder;
+}
 /**
  * Hook options (minimal configuration)
  */
@@ -30,53 +41,45 @@ export interface UseFilterReturnType {
     /** Whether any conditions exist */
     hasConditions: boolean;
     /**
-     * Add a leaf condition at root level
-     * @returns The id of the created condition
-     */
-    add: (condition: Omit<ConditionType, "id">) => string;
-    /**
-     * Add a condition group at root level
-     * @returns The id of the created group
-     */
-    addGroup: (operator: ConditionGroupOperatorType) => string;
-    /**
-     * Add a leaf condition to a specific parent group
-     * @param parentId - The id of the parent ConditionGroup
+     * Add a leaf condition at root level or to a specific parent group
+     * @param condition - The condition to add (without id)
+     * @param parentId - Optional id of the parent ConditionGroup. If omitted, adds at root level
      * @returns The id of the created condition
      */
-    addTo: (parentId: string, condition: Omit<ConditionType, "id">) => string;
+    addCondition: (condition: Omit<ConditionType, "id">, parentId?: string) => string;
     /**
-     * Add a condition group to a specific parent group
-     * @param parentId - The id of the parent ConditionGroup
+     * Add a condition group at root level or to a specific parent group
+     * @param operator - The operator for the new group ("And" | "Or" | "Not")
+     * @param parentId - Optional id of the parent ConditionGroup. If omitted, adds at root level
      * @returns The id of the created group
      */
-    addGroupTo: (parentId: string, operator: ConditionGroupOperatorType) => string;
+    addConditionGroup: (operator: ConditionGroupOperatorType, parentId?: string) => string;
     /**
      * Update a leaf condition by id
      * @param id - The id of the condition to update
      * @param updates - Partial updates to apply
      */
-    update: (id: string, updates: Partial<Omit<ConditionType, "id">>) => void;
+    updateCondition: (id: string, updates: Partial<Omit<ConditionType, "id">>) => void;
     /**
      * Update a condition group's operator by id
      * @param id - The id of the group to update
      * @param operator - The new operator
      */
-    updateOperator: (id: string, operator: ConditionGroupOperatorType) => void;
+    updateGroupOperator: (id: string, operator: ConditionGroupOperatorType) => void;
     /**
      * Remove a condition or group by id
      * @param id - The id of the item to remove
      */
-    remove: (id: string) => void;
+    removeCondition: (id: string) => void;
     /**
      * Get a condition or group by id
      * @param id - The id to look up
      * @returns The item or undefined if not found
      */
-    get: (id: string) => ConditionType | ConditionGroupType | undefined;
+    getCondition: (id: string) => ConditionType | ConditionGroupType | undefined;
     /** Clear all conditions */
-    clear: () => void;
+    clearAllConditions: () => void;
     /** Set the root operator for combining conditions */
-    setOperator: (op: ConditionGroupOperatorType) => void;
+    setRootOperator: (op: ConditionGroupOperatorType) => void;
 }
 //# sourceMappingURL=types.d.ts.map

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,iBAAiB,EAClB,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,0BAA0B,EAC1B,UAAU,EACV,iBAAiB,GAClB,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,oBAAoB;IACnC,gCAAgC;IAChC,iBAAiB,CAAC,EAAE,KAAK,CAAC,aAAa,GAAG,kBAAkB,CAAC,CAAC;IAC9D,oEAAoE;IACpE,eAAe,CAAC,EAAE,0BAA0B,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAKlC,kFAAkF;IAClF,QAAQ,EAAE,0BAA0B,CAAC;IAErC,+CAA+C;IAC/C,KAAK,EAAE,KAAK,CAAC,aAAa,GAAG,kBAAkB,CAAC,CAAC;IAEjD,yEAAyE;IACzE,OAAO,EAAE,UAAU,GAAG,SAAS,CAAC;IAEhC,mCAAmC;IACnC,aAAa,EAAE,OAAO,CAAC;IAMvB;;;OAGG;IACH,GAAG,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,KAAK,MAAM,CAAC;IAEtD;;;OAGG;IACH,QAAQ,EAAE,CAAC,QAAQ,EAAE,0BAA0B,KAAK,MAAM,CAAC;IAE3D;;;;OAIG;IACH,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,KAAK,MAAM,CAAC;IAE1E;;;;OAIG;IACH,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,0BAA0B,KAAK,MAAM,CAAC;IAM/E;;;;OAIG;IACH,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC;IAE1E;;;;OAIG;IACH,cAAc,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,0BAA0B,KAAK,IAAI,CAAC;IAM3E;;;OAGG;IACH,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAE7B;;;;OAIG;IACH,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,aAAa,GAAG,kBAAkB,GAAG,SAAS,CAAC;IAMpE,2BAA2B;IAC3B,KAAK,EAAE,MAAM,IAAI,CAAC;IAElB,qDAAqD;IACrD,WAAW,EAAE,CAAC,EAAE,EAAE,0BAA0B,KAAK,IAAI,CAAC;CACvD"}
+{"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,iBAAiB,EAClB,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,0BAA0B,EAC1B,UAAU,EACV,iBAAiB,GAClB,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;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,gCAAgC;IAChC,iBAAiB,CAAC,EAAE,KAAK,CAAC,aAAa,GAAG,kBAAkB,CAAC,CAAC;IAC9D,oEAAoE;IACpE,eAAe,CAAC,EAAE,0BAA0B,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAKlC,kFAAkF;IAClF,QAAQ,EAAE,0BAA0B,CAAC;IAErC,+CAA+C;IAC/C,KAAK,EAAE,KAAK,CAAC,aAAa,GAAG,kBAAkB,CAAC,CAAC;IAEjD,yEAAyE;IACzE,OAAO,EAAE,UAAU,GAAG,SAAS,CAAC;IAEhC,mCAAmC;IACnC,aAAa,EAAE,OAAO,CAAC;IAMvB;;;;;OAKG;IACH,YAAY,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAElF;;;;;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,EAAE,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC;IAEnF;;;;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,GAAG,kBAAkB,GAAG,SAAS,CAAC;IAM7E,2BAA2B;IAC3B,kBAAkB,EAAE,MAAM,IAAI,CAAC;IAE/B,qDAAqD;IACrD,eAAe,EAAE,CAAC,EAAE,EAAE,0BAA0B,KAAK,IAAI,CAAC;CAC3D"}

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

@@ -1 +1 @@
-{"version":3,"file":"useFilter.d.ts","sourceRoot":"","sources":["../../../../sdk/components/hooks/useFilter/useFilter.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AA6KzE,wBAAgB,SAAS,CAAC,OAAO,GAAE,oBAAyB,GAAG,mBAAmB,CA2JjF"}
+{"version":3,"file":"useFilter.d.ts","sourceRoot":"","sources":["../../../../sdk/components/hooks/useFilter/useFilter.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AA6KzE,wBAAgB,SAAS,CAAC,OAAO,GAAE,oBAAyB,GAAG,mBAAmB,CA+IjF"}

package/dist/filter.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("./useFilter-D-bCDo6Z.cjs");exports.isCondition=i.isCondition;exports.isConditionGroup=i.isConditionGroup;exports.useFilter=i.useFilter;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("./useFilter-Dofowpr_.cjs");exports.isCondition=i.isCondition;exports.isConditionGroup=i.isConditionGroup;exports.useFilter=i.useFilter;

package/dist/filter.mjs

@@ -1,4 +1,4 @@
-import { i as s, a, u as n } from "./useFilter-CXFqEHyI.js";
+import { i as s, a, u as n } from "./useFilter-Dv-mr9QW.js";
 export {
   s as isCondition,
   a as isConditionGroup,

package/dist/kanban.cjs

@@ -1,4 +1,4 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const u=require("react"),A=require("@tanstack/react-query"),F=require("./client-C15j4O5B.cjs"),St=require("./useFilter-D-bCDo6Z.cjs"),nt=50,st=5,it=5;function ot({onCardMove:s,onError:c,columns:l,announceMove:a}){const[i,S]=u.useState({isDragging:!1,draggedCard:null,dragOverColumn:null,dragOverPosition:null,dragSourceColumn:null}),O=u.useRef(null),w=u.useRef(null),K=u.useRef(null),_=u.useCallback(()=>{S({isDragging:!1,draggedCard:null,dragOverColumn:null,dragOverPosition:null,dragSourceColumn:null}),w.current&&(clearTimeout(w.current),w.current=null)},[]),D=u.useCallback(d=>l.find(o=>o._id===d)||null,[l]),X=u.useCallback(d=>{for(const o of l){const y=o.cards.find(m=>m._id===d);if(y)return{card:y,column:o}}return null},[l]),P=u.useCallback((d,o)=>{var y,m;try{const g=d.target,f=D(o.columnId);if(!f)throw new Error("Source column not found");(y=d.dataTransfer)==null||y.setData("text/plain",o._id),(m=d.dataTransfer)==null||m.setData("application/json",JSON.stringify(o));const k=g.cloneNode(!0);k.style.cssText=`
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const u=require("react"),A=require("@tanstack/react-query"),F=require("./client-C15j4O5B.cjs"),St=require("./useFilter-Dofowpr_.cjs"),nt=50,st=5,it=5;function ot({onCardMove:s,onError:c,columns:l,announceMove:a}){const[i,S]=u.useState({isDragging:!1,draggedCard:null,dragOverColumn:null,dragOverPosition:null,dragSourceColumn:null}),O=u.useRef(null),w=u.useRef(null),K=u.useRef(null),_=u.useCallback(()=>{S({isDragging:!1,draggedCard:null,dragOverColumn:null,dragOverPosition:null,dragSourceColumn:null}),w.current&&(clearTimeout(w.current),w.current=null)},[]),D=u.useCallback(d=>l.find(o=>o._id===d)||null,[l]),X=u.useCallback(d=>{for(const o of l){const y=o.cards.find(m=>m._id===d);if(y)return{card:y,column:o}}return null},[l]),P=u.useCallback((d,o)=>{var y,m;try{const g=d.target,f=D(o.columnId);if(!f)throw new Error("Source column not found");(y=d.dataTransfer)==null||y.setData("text/plain",o._id),(m=d.dataTransfer)==null||m.setData("application/json",JSON.stringify(o));const k=g.cloneNode(!0);k.style.cssText=`
         position: fixed;
         top: -1000px;
         left: -1000px;

package/dist/kanban.mjs

@@ -1,7 +1,7 @@
 import { useState as G, useRef as k, useCallback as h, useEffect as rt, useMemo as ot, createContext as qt, useContext as Qt } from "react";
 import { useQueryClient as At, useQueries as Tt, keepPreviousData as kt, useQuery as Pt, useMutation as j } from "@tanstack/react-query";
 import { a as F } from "./client-CfvLiGfP.js";
-import { u as Et } from "./useFilter-CXFqEHyI.js";
+import { u as Et } from "./useFilter-Dv-mr9QW.js";
 const ct = 50, dt = 5, ut = 5;
 function Ft({
   onCardMove: i,

package/dist/table.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("react"),O=require("@tanstack/react-query"),Q=require("./client-C15j4O5B.cjs"),_=require("./useFilter-D-bCDo6Z.cjs");function $(t){var N,m,P,k,z,T,F,M,w,E;const[o,p]=a.useState({query:""}),[n,y]=a.useState({field:((m=(N=t.initialState)==null?void 0:N.sorting)==null?void 0:m.field)||null,direction:((k=(P=t.initialState)==null?void 0:P.sorting)==null?void 0:k.direction)||null}),[i,c]=a.useState({pageNo:((T=(z=t.initialState)==null?void 0:z.pagination)==null?void 0:T.pageNo)||1,pageSize:((M=(F=t.initialState)==null?void 0:F.pagination)==null?void 0:M.pageSize)||10}),s=_.useFilter({initialConditions:(w=t.initialState)==null?void 0:w.filters,initialOperator:((E=t.initialState)==null?void 0:E.filterOperator)||"And"}),l=a.useMemo(()=>{const e={};return o.query&&(e.Search=o.query),s.payload&&(e.Filter=s.payload),e},[o.query,s.payload]),b=a.useMemo(()=>{const e={...l};return n.field&&n.direction&&(e.Sort=[{[String(n.field)]:n.direction==="asc"?"ASC":"DESC"}]),t.enablePagination&&(e.Page=i.pageNo,e.PageSize=i.pageSize),e},[l,n,i,t.enablePagination]),{data:u,isLoading:L,isFetching:R,error:x,refetch:q}=O.useQuery({queryKey:["table",t.source,b],queryFn:async()=>{try{const e=await Q.api(t.source).list(b);return t.onSuccess&&t.onSuccess(e.Data),e}catch(e){throw t.onError&&t.onError(e),e}},staleTime:0,gcTime:0}),{data:g,isLoading:A,isFetching:D,error:G,refetch:C}=O.useQuery({queryKey:["table-count",t.source,l],queryFn:async()=>{try{return await Q.api(t.source).count(l)}catch(e){throw t.onError&&t.onError(e),e}},staleTime:0,gcTime:0}),K=a.useMemo(()=>(u==null?void 0:u.Data)||[],[u]),S=a.useMemo(()=>(g==null?void 0:g.Count)||0,[g]),d=a.useMemo(()=>Math.ceil(S/i.pageSize),[S,i.pageSize]),j=a.useCallback(e=>{y(r=>{if(r.field===e){if(r.direction==="asc")return{field:e,direction:"desc"};if(r.direction==="desc")return{field:null,direction:null}}return{field:e,direction:"asc"}})},[]),I=a.useCallback(()=>{y({field:null,direction:null})},[]),B=a.useCallback((e,r)=>{y({field:e,direction:r})},[]),H=a.useCallback(e=>{p({query:e}),c(r=>({...r,pageNo:1}))},[]),J=a.useCallback(()=>{p({query:""})},[]),f=i.pageNo<d,h=i.pageNo>1,U=a.useCallback(()=>{f&&c(e=>({...e,pageNo:e.pageNo+1}))},[f]),V=a.useCallback(()=>{h&&c(e=>({...e,pageNo:e.pageNo-1}))},[h]),W=a.useCallback(e=>{const r=Math.max(1,Math.min(e,d));c(Z=>({...Z,pageNo:r}))},[d]),X=a.useCallback(e=>{c(r=>({...r,pageSize:e,pageNo:1}))},[]),Y=a.useCallback(async()=>{const[e]=await Promise.all([q(),C()]);return e.data||{Data:[]}},[q,C]);return{rows:K,totalItems:S,isLoading:L||A,isFetching:R||D,error:x||G,search:{query:o.query,setQuery:H,clear:J},sort:{field:n.field,direction:n.direction,toggle:j,clear:I,set:B},filter:s,pagination:{currentPage:i.pageNo,pageSize:i.pageSize,totalPages:d,totalItems:S,canGoNext:f,canGoPrevious:h,goToNext:U,goToPrevious:V,goToPage:W,setPageSize:X},refetch:Y}}exports.useTable=$;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("react"),O=require("@tanstack/react-query"),Q=require("./client-C15j4O5B.cjs"),_=require("./useFilter-Dofowpr_.cjs");function $(t){var N,m,P,k,z,T,F,M,w,E;const[o,p]=a.useState({query:""}),[n,y]=a.useState({field:((m=(N=t.initialState)==null?void 0:N.sorting)==null?void 0:m.field)||null,direction:((k=(P=t.initialState)==null?void 0:P.sorting)==null?void 0:k.direction)||null}),[i,c]=a.useState({pageNo:((T=(z=t.initialState)==null?void 0:z.pagination)==null?void 0:T.pageNo)||1,pageSize:((M=(F=t.initialState)==null?void 0:F.pagination)==null?void 0:M.pageSize)||10}),s=_.useFilter({initialConditions:(w=t.initialState)==null?void 0:w.filters,initialOperator:((E=t.initialState)==null?void 0:E.filterOperator)||"And"}),l=a.useMemo(()=>{const e={};return o.query&&(e.Search=o.query),s.payload&&(e.Filter=s.payload),e},[o.query,s.payload]),b=a.useMemo(()=>{const e={...l};return n.field&&n.direction&&(e.Sort=[{[String(n.field)]:n.direction==="asc"?"ASC":"DESC"}]),t.enablePagination&&(e.Page=i.pageNo,e.PageSize=i.pageSize),e},[l,n,i,t.enablePagination]),{data:u,isLoading:L,isFetching:R,error:x,refetch:q}=O.useQuery({queryKey:["table",t.source,b],queryFn:async()=>{try{const e=await Q.api(t.source).list(b);return t.onSuccess&&t.onSuccess(e.Data),e}catch(e){throw t.onError&&t.onError(e),e}},staleTime:0,gcTime:0}),{data:g,isLoading:A,isFetching:D,error:G,refetch:C}=O.useQuery({queryKey:["table-count",t.source,l],queryFn:async()=>{try{return await Q.api(t.source).count(l)}catch(e){throw t.onError&&t.onError(e),e}},staleTime:0,gcTime:0}),K=a.useMemo(()=>(u==null?void 0:u.Data)||[],[u]),S=a.useMemo(()=>(g==null?void 0:g.Count)||0,[g]),d=a.useMemo(()=>Math.ceil(S/i.pageSize),[S,i.pageSize]),j=a.useCallback(e=>{y(r=>{if(r.field===e){if(r.direction==="asc")return{field:e,direction:"desc"};if(r.direction==="desc")return{field:null,direction:null}}return{field:e,direction:"asc"}})},[]),I=a.useCallback(()=>{y({field:null,direction:null})},[]),B=a.useCallback((e,r)=>{y({field:e,direction:r})},[]),H=a.useCallback(e=>{p({query:e}),c(r=>({...r,pageNo:1}))},[]),J=a.useCallback(()=>{p({query:""})},[]),f=i.pageNo<d,h=i.pageNo>1,U=a.useCallback(()=>{f&&c(e=>({...e,pageNo:e.pageNo+1}))},[f]),V=a.useCallback(()=>{h&&c(e=>({...e,pageNo:e.pageNo-1}))},[h]),W=a.useCallback(e=>{const r=Math.max(1,Math.min(e,d));c(Z=>({...Z,pageNo:r}))},[d]),X=a.useCallback(e=>{c(r=>({...r,pageSize:e,pageNo:1}))},[]),Y=a.useCallback(async()=>{const[e]=await Promise.all([q(),C()]);return e.data||{Data:[]}},[q,C]);return{rows:K,totalItems:S,isLoading:L||A,isFetching:R||D,error:x||G,search:{query:o.query,setQuery:H,clear:J},sort:{field:n.field,direction:n.direction,toggle:j,clear:I,set:B},filter:s,pagination:{currentPage:i.pageNo,pageSize:i.pageSize,totalPages:d,totalItems:S,canGoNext:f,canGoPrevious:h,goToNext:U,goToPrevious:V,goToPage:W,setPageSize:X},refetch:Y}}exports.useTable=$;

package/dist/table.mjs

@@ -1,7 +1,7 @@
 import { useState as m, useMemo as c, useCallback as i } from "react";
 import { useQuery as A } from "@tanstack/react-query";
 import { a as D } from "./client-CfvLiGfP.js";
-import { u as v } from "./useFilter-CXFqEHyI.js";
+import { u as v } from "./useFilter-Dv-mr9QW.js";
 function ae(t) {
   var F, T, C, b, w, E, x, L, M, O;
   const [s, N] = m({

package/dist/useFilter-Dofowpr_.cjs

@@ -0,0 +1 @@
+"use strict";const u=require("react"),d=r=>"Condition"in r,R=r=>"LHSField"in r;let _=0;const l=()=>`filter_${Date.now()}_${++_}`,$=r=>r.id?r:{...r,id:l()},k=r=>r.map(o=>{const n=$(o);return d(n)?{...n,Condition:k(n.Condition)}:n}),O=r=>r.map(o=>{if(d(o)){const{id:b,...C}=o;return{...C,Condition:O(o.Condition)}}const{id:n,...t}=o;return t}),h=(r,o)=>{for(const n of r){if(n.id===o)return n;if(d(n)){const t=h(n.Condition,o);if(t)return t}}},f=(r,o,n)=>r.map(t=>t.id===o?n(t):d(t)?{...t,Condition:f(t.Condition,o,n)}:t),G=(r,o)=>r.filter(n=>n.id!==o).map(n=>d(n)?{...n,Condition:G(n.Condition,o)}:n),p=(r,o,n)=>r.map(t=>t.id===o&&d(t)?{...t,Condition:[...t.Condition,n]}:d(t)?{...t,Condition:p(t.Condition,o,n)}:t);function q(r={}){const[o,n]=u.useState(()=>k(r.initialConditions||[])),[t,b]=u.useState(r.initialOperator||"And"),C=u.useMemo(()=>{if(o.length!==0)return{Operator:t,Condition:O(o)}},[o,t]),g=o.length>0,v=u.useCallback((i,s)=>{const c=l(),e={...i,id:c};return n(s?a=>p(a,s,e):a=>[...a,e]),c},[]),F=u.useCallback((i,s)=>{const c=l(),e={id:c,Operator:i,Condition:[]};return n(s?a=>p(a,s,e):a=>[...a,e]),c},[]),I=u.useCallback((i,s)=>{n(c=>f(c,i,e=>d(e)?e:{...e,...s}))},[]),S=u.useCallback((i,s)=>{n(c=>f(c,i,e=>d(e)?{...e,Operator:s}:e))},[]),w=u.useCallback(i=>{n(s=>G(s,i))},[]),T=u.useCallback(i=>h(o,i),[o]),y=u.useCallback(()=>{n([])},[]),A=u.useCallback(i=>{b(i)},[]);return{operator:t,items:o,payload:C,hasConditions:g,addCondition:v,addConditionGroup:F,updateCondition:I,updateGroupOperator:S,removeCondition:w,getCondition:T,clearAllConditions:y,setRootOperator:A}}exports.isCondition=R;exports.isConditionGroup=d;exports.useFilter=q;

package/dist/useFilter-Dv-mr9QW.js

@@ -0,0 +1,117 @@
+import { useState as h, useMemo as k, useCallback as c } from "react";
+const u = (t) => "Condition" in t, H = (t) => "LHSField" in t;
+let x = 0;
+const f = () => `filter_${Date.now()}_${++x}`, B = (t) => t.id ? t : { ...t, id: f() }, g = (t) => t.map((o) => {
+  const n = B(o);
+  return u(n) ? {
+    ...n,
+    Condition: g(n.Condition)
+  } : n;
+}), v = (t) => t.map((o) => {
+  if (u(o)) {
+    const { id: O, ...C } = o;
+    return {
+      ...C,
+      Condition: v(o.Condition)
+    };
+  }
+  const { id: n, ...r } = o;
+  return r;
+}), G = (t, o) => {
+  for (const n of t) {
+    if (n.id === o)
+      return n;
+    if (u(n)) {
+      const r = G(n.Condition, o);
+      if (r) return r;
+    }
+  }
+}, p = (t, o, n) => t.map((r) => r.id === o ? n(r) : u(r) ? {
+  ...r,
+  Condition: p(r.Condition, o, n)
+} : r), I = (t, o) => t.filter((n) => n.id !== o).map((n) => u(n) ? {
+  ...n,
+  Condition: I(n.Condition, o)
+} : n), l = (t, o, n) => t.map((r) => r.id === o && u(r) ? {
+  ...r,
+  Condition: [...r.Condition, n]
+} : u(r) ? {
+  ...r,
+  Condition: l(r.Condition, o, n)
+} : r);
+function L(t = {}) {
+  const [o, n] = h(
+    () => g(t.initialConditions || [])
+  ), [r, O] = h(
+    t.initialOperator || "And"
+  ), C = k(() => {
+    if (o.length !== 0)
+      return {
+        Operator: r,
+        Condition: v(o)
+      };
+  }, [o, r]), w = o.length > 0, F = c(
+    (i, s) => {
+      const d = f(), e = { ...i, id: d };
+      return n(s ? (a) => l(a, s, e) : (a) => [...a, e]), d;
+    },
+    []
+  ), S = c(
+    (i, s) => {
+      const d = f(), e = {
+        id: d,
+        Operator: i,
+        Condition: []
+      };
+      return n(s ? (a) => l(a, s, e) : (a) => [...a, e]), d;
+    },
+    []
+  ), T = c(
+    (i, s) => {
+      n(
+        (d) => p(d, i, (e) => u(e) ? e : { ...e, ...s })
+      );
+    },
+    []
+  ), y = c(
+    (i, s) => {
+      n(
+        (d) => p(d, i, (e) => u(e) ? { ...e, Operator: s } : e)
+      );
+    },
+    []
+  ), A = c((i) => {
+    n((s) => I(s, i));
+  }, []), _ = c(
+    (i) => G(o, i),
+    [o]
+  ), $ = c(() => {
+    n([]);
+  }, []), b = c((i) => {
+    O(i);
+  }, []);
+  return {
+    // State
+    operator: r,
+    items: o,
+    payload: C,
+    hasConditions: w,
+    // Add operations
+    addCondition: F,
+    addConditionGroup: S,
+    // Update operations
+    updateCondition: T,
+    updateGroupOperator: y,
+    // Remove & access
+    removeCondition: A,
+    getCondition: _,
+    // Utility
+    clearAllConditions: $,
+    setRootOperator: b
+  };
+}
+export {
+  u as a,
+  H as i,
+  L as u
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ram_28/kf-ai-sdk",
-  "version": "1.0.14",
+  "version": "1.0.15",
   "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

@@ -41,6 +41,20 @@ export const isCondition = (
 // HOOK-SPECIFIC TYPE DEFINITIONS
 // ============================================================
 
+/**
+ * Builder interface for fluent condition group construction
+ */
+export interface ConditionGroupBuilder {
+  /** The id of the created group */
+  readonly id: string;
+
+  /** Add a condition to this group */
+  addCondition(condition: Omit<ConditionType, "id">): ConditionGroupBuilder;
+
+  /** Add a nested condition group */
+  addConditionGroup(operator: ConditionGroupOperatorType): ConditionGroupBuilder;
+}
+
 /**
  * Hook options (minimal configuration)
  */
@@ -76,30 +90,20 @@ export interface UseFilterReturnType {
   // ============================================================
 
   /**
-   * Add a leaf condition at root level
-   * @returns The id of the created condition
-   */
-  add: (condition: Omit<ConditionType, "id">) => string;
-
-  /**
-   * Add a condition group at root level
-   * @returns The id of the created group
-   */
-  addGroup: (operator: ConditionGroupOperatorType) => string;
-
-  /**
-   * Add a leaf condition to a specific parent group
-   * @param parentId - The id of the parent ConditionGroup
+   * Add a leaf condition at root level or to a specific parent group
+   * @param condition - The condition to add (without id)
+   * @param parentId - Optional id of the parent ConditionGroup. If omitted, adds at root level
    * @returns The id of the created condition
    */
-  addTo: (parentId: string, condition: Omit<ConditionType, "id">) => string;
+  addCondition: (condition: Omit<ConditionType, "id">, parentId?: string) => string;
 
   /**
-   * Add a condition group to a specific parent group
-   * @param parentId - The id of the parent ConditionGroup
+   * Add a condition group at root level or to a specific parent group
+   * @param operator - The operator for the new group ("And" | "Or" | "Not")
+   * @param parentId - Optional id of the parent ConditionGroup. If omitted, adds at root level
    * @returns The id of the created group
    */
-  addGroupTo: (parentId: string, operator: ConditionGroupOperatorType) => string;
+  addConditionGroup: (operator: ConditionGroupOperatorType, parentId?: string) => string;
 
   // ============================================================
   // UPDATE OPERATIONS
@@ -110,14 +114,14 @@ export interface UseFilterReturnType {
    * @param id - The id of the condition to update
    * @param updates - Partial updates to apply
    */
-  update: (id: string, updates: Partial<Omit<ConditionType, "id">>) => void;
+  updateCondition: (id: string, updates: Partial<Omit<ConditionType, "id">>) => void;
 
   /**
    * Update a condition group's operator by id
    * @param id - The id of the group to update
    * @param operator - The new operator
    */
-  updateOperator: (id: string, operator: ConditionGroupOperatorType) => void;
+  updateGroupOperator: (id: string, operator: ConditionGroupOperatorType) => void;
 
   // ============================================================
   // REMOVE & ACCESS
@@ -127,22 +131,22 @@ export interface UseFilterReturnType {
    * Remove a condition or group by id
    * @param id - The id of the item to remove
    */
-  remove: (id: string) => void;
+  removeCondition: (id: string) => void;
 
   /**
    * Get a condition or group by id
    * @param id - The id to look up
    * @returns The item or undefined if not found
    */
-  get: (id: string) => ConditionType | ConditionGroupType | undefined;
+  getCondition: (id: string) => ConditionType | ConditionGroupType | undefined;
 
   // ============================================================
   // UTILITY
   // ============================================================
 
   /** Clear all conditions */
-  clear: () => void;
+  clearAllConditions: () => void;
 
   /** Set the root operator for combining conditions */
-  setOperator: (op: ConditionGroupOperatorType) => void;
+  setRootOperator: (op: ConditionGroupOperatorType) => void;
 }