@osdk/react-components 0.2.0-beta.1 → 0.2.0-beta.3

package/build/types/filter-list/FilterListItemApi.d.ts

@@ -1,67 +1,26 @@
 import type { CompileTimeMetadata, ObjectSet, ObjectTypeDefinition, PropertyKeys, WirePropertyTypes } from "@osdk/api";
-/**
-* Props for a single filter list item component
-*/
-export interface FilterListItemProps<
-	Q extends ObjectTypeDefinition,
-	K extends PropertyKeys<Q> = PropertyKeys<Q>,
-	C extends ValidComponentsForPropertyType<PropertyTypeFromKey<Q, K>> = ValidComponentsForPropertyType<PropertyTypeFromKey<Q, K>>
-> extends FilterDefinition<Q, K, C> {
-	objectSet: ObjectSet<Q>;
-	/**
-	* Called when the state of the filter changes.
-	* Required in controlled mode.
-	*/
-	onFilterStateChanged: (state: FilterStateByComponentType[C]) => void;
-	onFilterRemoved?: (key: PropertyKeys<Q>) => void;
-}
-/**
-* A filter definition specifies configuration for a single filter
-*
-* The component type C must be compatible with the property type derived from the key.
-* For example, boolean properties can only use LISTOGRAM,
-* while string properties can use LISTOGRAM, TEXT_TAGS, or CONTAINS_TEXT.
-*/
-export interface FilterDefinition<
-	Q extends ObjectTypeDefinition,
-	K extends PropertyKeys<Q> = PropertyKeys<Q>,
-	C extends ValidComponentsForPropertyType<PropertyTypeFromKey<Q, K>> = ValidComponentsForPropertyType<PropertyTypeFromKey<Q, K>>
-> {
-	/**
-	* The property key to filter on
-	*/
-	key: K;
-	/**
-	* Display label for the filter
-	*/
-	label?: string;
-	/**
-	* The filter component type to render
-	* Must be compatible with the property type derived from the key, see ValidComponentsForPropertyType
-	*/
-	filterComponent: C;
-	/**
-	* The current state of the filter.
-	* If provided, the filter is controlled.
-	*/
-	filterState: FilterStateByComponentType[C];
-}
+import type { CustomFilterState } from "./types/CustomRendererTypes.js";
+import type { KeywordSearchFilterState } from "./types/KeywordSearchTypes.js";
+import type { HasLinkFilterState, LinkedPropertyFilterState } from "./types/LinkedFilterTypes.js";
 /**
 * Helper type to extract the property type from an ObjectTypeDefinition given a property key
 */
-type PropertyTypeFromKey<
+export type PropertyTypeFromKey<
 	Q extends ObjectTypeDefinition,
 	K extends PropertyKeys<Q>
 > = CompileTimeMetadata<Q>["properties"][K]["type"];
-export type FilterComponentType = "LISTOGRAM" | "DATE_RANGE" | "NUMBER_RANGE" | "TEXT_TAGS" | "CONTAINS_TEXT";
+/**
+* All available filter component types
+*/
+export type FilterComponentType = "LISTOGRAM" | "DATE_RANGE" | "NUMBER_RANGE" | "TEXT_TAGS" | "CONTAINS_TEXT" | "SINGLE_SELECT" | "MULTI_SELECT" | "SINGLE_DATE" | "MULTI_DATE" | "TIMELINE" | "CHECKBOX_LIST" | "TOGGLE";
 /**
 * Gets valid component types for a given property type
 */
-export type ValidComponentsForPropertyType<P extends WirePropertyTypes> = P extends "boolean" ? "LISTOGRAM" : P extends "string" ? "LISTOGRAM" | "TEXT_TAGS" | "CONTAINS_TEXT" : P extends "datetime" | "timestamp" ? "DATE_RANGE" : P extends "double" | "integer" | "long" | "float" | "short" | "byte" | "decimal" ? "NUMBER_RANGE" : never;
+export type ValidComponentsForPropertyType<P extends WirePropertyTypes> = P extends "boolean" ? "LISTOGRAM" | "CHECKBOX_LIST" | "SINGLE_SELECT" | "TOGGLE" : P extends "string" ? "LISTOGRAM" | "TEXT_TAGS" | "CONTAINS_TEXT" | "SINGLE_SELECT" | "MULTI_SELECT" | "CHECKBOX_LIST" : P extends "datetime" | "timestamp" ? "DATE_RANGE" | "SINGLE_DATE" | "MULTI_DATE" | "TIMELINE" : P extends "double" | "integer" | "long" | "float" | "short" | "byte" | "decimal" ? "NUMBER_RANGE" | "SINGLE_SELECT" | "MULTI_SELECT" : never;
 /**
 * Union of all possible filter states
 */
-export type FilterState = ExactMatchFilterState<string | boolean> | DateRangeFilterState | ContainsTextFilterState | NumberRangeFilterState;
+export type FilterState = ExactMatchFilterState<string | boolean> | DateRangeFilterState | ContainsTextFilterState | NumberRangeFilterState | SelectFilterState<string | boolean | number> | SelectFilterState<Date> | TimelineFilterState | ToggleFilterState | HasLinkFilterState | LinkedPropertyFilterState | KeywordSearchFilterState | CustomFilterState;
 /**
 * Maps component types to their corresponding state types
 */
@@ -71,8 +30,18 @@ export interface FilterStateByComponentType {
 	TEXT_TAGS: ExactMatchFilterState<string>;
 	CONTAINS_TEXT: ContainsTextFilterState;
 	NUMBER_RANGE: NumberRangeFilterState;
+	SINGLE_SELECT: SelectFilterState<string | boolean | number>;
+	MULTI_SELECT: SelectFilterState<string | boolean | number>;
+	SINGLE_DATE: SelectFilterState<Date>;
+	MULTI_DATE: SelectFilterState<Date>;
+	TIMELINE: TimelineFilterState;
+	CHECKBOX_LIST: SelectFilterState<string>;
+	TOGGLE: ToggleFilterState;
 }
-type FilterStateType = "EXACT_MATCH" | "DATE_RANGE" | "NUMBER_RANGE" | "CONTAINS_TEXT";
+/**
+* All filter state discriminator types
+*/
+export type FilterStateType = "EXACT_MATCH" | "DATE_RANGE" | "NUMBER_RANGE" | "CONTAINS_TEXT" | "SELECT" | "TIMELINE" | "TOGGLE" | "hasLink" | "linkedProperty" | "keywordSearch" | "custom";
 /**
 * Base interface for all filter states
 * Contains common properties shared across all filter types
@@ -123,4 +92,83 @@ export interface NumberRangeFilterState extends BaseFilterState {
 	*/
 	maxValue?: number;
 }
-export {};
+/**
+* Consolidated state type for select-based filters.
+* Used by SINGLE_SELECT, MULTI_SELECT, SINGLE_DATE, MULTI_DATE, and CHECKBOX_LIST.
+*/
+export interface SelectFilterState<T = string | boolean | number | Date> extends BaseFilterState {
+	type: "SELECT";
+	selectedValues: T[];
+}
+export interface TimelineFilterState extends BaseFilterState {
+	type: "TIMELINE";
+	startDate?: Date;
+	endDate?: Date;
+	granularity?: "day" | "week" | "month" | "quarter" | "year";
+}
+export interface ToggleFilterState extends BaseFilterState {
+	type: "TOGGLE";
+	enabled: boolean;
+}
+/**
+* A property filter definition specifies configuration for filtering on a single property
+*
+* The component type C must be compatible with the property type derived from the key.
+* For example, boolean properties can only use LISTOGRAM, CHECKBOX_LIST, or SINGLE_SELECT,
+* while string properties can use LISTOGRAM, TEXT_TAGS, CONTAINS_TEXT, SINGLE_SELECT, MULTI_SELECT, or CHECKBOX_LIST.
+*/
+export interface PropertyFilterDefinition<
+	Q extends ObjectTypeDefinition,
+	K extends PropertyKeys<Q> = PropertyKeys<Q>,
+	C extends ValidComponentsForPropertyType<PropertyTypeFromKey<Q, K>> = ValidComponentsForPropertyType<PropertyTypeFromKey<Q, K>>
+> {
+	/**
+	* Discriminator for filter definition type
+	*/
+	type: "PROPERTY";
+	/**
+	* Optional unique identifier for stable keying across filter reorders.
+	*/
+	id?: string;
+	/**
+	* The property key to filter on
+	*/
+	key: K;
+	/**
+	* Display label for the filter
+	*/
+	label?: string;
+	/**
+	* The filter component type to render
+	* Must be compatible with the property type derived from the key, see ValidComponentsForPropertyType
+	*/
+	filterComponent: C;
+	/**
+	* The current state of the filter.
+	* If provided, the filter is controlled.
+	*/
+	filterState: FilterStateByComponentType[C];
+	/**
+	* Controls whether this filter is rendered.
+	* When false, the filter is hidden but its state is preserved.
+	* @default true
+	*/
+	isVisible?: boolean;
+}
+/**
+* Props for a single filter list item component.
+* Extends PropertyFilterDefinition with runtime props for rendering.
+*/
+export interface FilterListItemProps<
+	Q extends ObjectTypeDefinition,
+	K extends PropertyKeys<Q> = PropertyKeys<Q>,
+	C extends ValidComponentsForPropertyType<PropertyTypeFromKey<Q, K>> = ValidComponentsForPropertyType<PropertyTypeFromKey<Q, K>>
+> extends PropertyFilterDefinition<Q, K, C> {
+	objectSet: ObjectSet<Q>;
+	/**
+	* Called when the state of the filter changes.
+	* Required in controlled mode.
+	*/
+	onFilterStateChanged: (state: FilterStateByComponentType[C]) => void;
+	onFilterRemoved?: (key: PropertyKeys<Q>) => void;
+}

package/build/types/filter-list/FilterListItemApi.d.ts.map

@@ -1 +1 @@
-{"mappings":"AAgBA,cACE,qBACA,WACA,sBACA,cACA,yBACK,WAAY;;;;AAKnB,iBAAiB;CACf,UAAU;CACV,UAAU,aAAa,KAAK,aAAa;CACzC,UAAU,+BACR,oBAAoB,GAAG,MACrB,+BAA+B,oBAAoB,GAAG;UAClD,iBAAiB,GAAG,GAAG,GAAG;CAClC,WAAW,UAAU;;;;;CAMrB,uBAAuBA,OAAO,2BAA2B;CAEzD,mBAAmBC,KAAK,aAAa;AACtC;;;;;;;;AASD,iBAAiB;CACf,UAAU;CACV,UAAU,aAAa,KAAK,aAAa;CACzC,UAAU,+BACR,oBAAoB,GAAG,MACrB,+BAA+B,oBAAoB,GAAG;EAC1D;;;;CAIA,KAAK;;;;CAKL;;;;;CAMA,iBAAiB;;;;;CAMjB,aAAa,2BAA2B;AACzC;;;;KAKI;CACH,UAAU;CACV,UAAU,aAAa;IACrB,oBAAoB,GAAG,cAAc,GAAG;AAE5C,YAAY,sBACR,cACA,eACA,iBACA,cACA;;;;AAKJ,YAAY,+BAA+B,UAAU,qBACnD,UAAU,YAAY,cAClB,UAAU,WAAW,cAAc,cAAc,kBACjD,UAAU,aAAa,cAAc,eACrC,UACE,WACA,YACA,SACA,UACA,UACA,SACA,YAAY;;;;AAMpB,YAAY,cACR,0CACA,uBACA,0BACA;;;;AAKJ,iBAAiB,2BAA2B;CAC1C,WAAW;CACX,YAAY;CACZ,WAAW;CACX,eAAe;CACf,cAAc;AACf;KAEI,kBACD,gBACA,eACA,iBACA;;;;;AAMJ,iBAAiB,gBAAgB;;;;CAI/B,MAAM;;;;;CAMN;;;;;CAMA;AACD;AAED,iBAAiB,sBAAsB,8BAC7B,gBACV;CACE,MAAM;CACN,QAAQ;AACT;AAED,iBAAiB,6BAA6B,gBAAgB;CAC5D,MAAM;;;;CAIN,WAAW;;;;CAIX,WAAW;AACZ;AAED,iBAAiB,gCAAgC,gBAAgB;CAC/D,MAAM;CACN;AACD;AAED,iBAAiB,+BAA+B,gBAAgB;CAC9D,MAAM;;;;CAIN;;;;CAIA;AACD","names":["state: FilterStateByComponentType[C]","key: PropertyKeys<Q>"],"sources":["../../../src/filter-list/FilterListItemApi.ts"],"version":3,"file":"FilterListItemApi.d.ts"}
+{"mappings":"AAgBA,cACE,qBACA,WACA,sBACA,cACA,yBACK,WAAY;AACnB,cAAc,yBAAyB,gCAAiC;AACxE,cAAc,gCAAgC,+BAAgC;AAC9E,cACE,oBACA,iCACK,8BAA+B;;;;AAKtC,YAAY;CACV,UAAU;CACV,UAAU,aAAa;IACrB,oBAAoB,GAAG,cAAc,GAAG;;;;AAK5C,YAAY,sBACR,cACA,eACA,iBACA,cACA,kBACA,kBACA,iBACA,gBACA,eACA,aACA,kBACA;;;;AAKJ,YAAY,+BAA+B,UAAU,qBACnD,UAAU,YACN,cAAc,kBAAkB,kBAAkB,WAClD,UAAU,WACN,cACA,cACA,kBACA,kBACA,iBACA,kBACJ,UAAU,aAAa,cACrB,eAAe,gBAAgB,eAAe,aAChD,UACE,WACA,YACA,SACA,UACA,UACA,SACA,YAAY,iBAAiB,kBAAkB;;;;AAMvD,YAAY,cACR,0CACA,uBACA,0BACA,yBACA,+CACA,kBAAkB,QAClB,sBACA,oBACA,qBACA,4BACA,2BACA;;;;AAKJ,iBAAiB,2BAA2B;CAC1C,WAAW;CACX,YAAY;CACZ,WAAW;CACX,eAAe;CACf,cAAc;CACd,eAAe;CACf,cAAc;CACd,aAAa,kBAAkB;CAC/B,YAAY,kBAAkB;CAC9B,UAAU;CACV,eAAe;CACf,QAAQ;AACT;;;;AAKD,YAAY,kBACR,gBACA,eACA,iBACA,kBACA,WACA,aACA,WACA,YACA,mBACA,kBACA;;;;;AAMJ,iBAAiB,gBAAgB;;;;CAI/B,MAAM;;;;;CAMN;;;;;CAMA;AACD;AAED,iBAAiB,sBAAsB,8BAC7B,gBACV;CACE,MAAM;CACN,QAAQ;AACT;AAED,iBAAiB,6BAA6B,gBAAgB;CAC5D,MAAM;;;;CAIN,WAAW;;;;CAIX,WAAW;AACZ;AAED,iBAAiB,gCAAgC,gBAAgB;CAC/D,MAAM;CACN;AACD;AAED,iBAAiB,+BAA+B,gBAAgB;CAC9D,MAAM;;;;CAIN;;;;CAIA;AACD;;;;;AAMD,iBAAiB,kBAAkB,gCAAgC,cACzD,gBACV;CACE,MAAM;CACN,gBAAgB;AACjB;AAED,iBAAiB,4BAA4B,gBAAgB;CAC3D,MAAM;CACN,YAAY;CACZ,UAAU;CACV,cAAc,QAAQ,SAAS,UAAU,YAAY;AACtD;AAED,iBAAiB,0BAA0B,gBAAgB;CACzD,MAAM;CACN;AACD;;;;;;;;AASD,iBAAiB;CACf,UAAU;CACV,UAAU,aAAa,KAAK,aAAa;CACzC,UAAU,+BACR,oBAAoB,GAAG,MACrB,+BAA+B,oBAAoB,GAAG;EAC1D;;;;CAIA,MAAM;;;;CAKN;;;;CAKA,KAAK;;;;CAKL;;;;;CAMA,iBAAiB;;;;;CAMjB,aAAa,2BAA2B;;;;;;CAOxC;AACD;;;;;AAMD,iBAAiB;CACf,UAAU;CACV,UAAU,aAAa,KAAK,aAAa;CACzC,UAAU,+BACR,oBAAoB,GAAG,MACrB,+BAA+B,oBAAoB,GAAG;UAClD,yBAAyB,GAAG,GAAG,GAAG;CAC1C,WAAW,UAAU;;;;;CAMrB,uBAAuBA,OAAO,2BAA2B;CAEzD,mBAAmBC,KAAK,aAAa;AACtC","names":["state: FilterStateByComponentType[C]","key: PropertyKeys<Q>"],"sources":["../../../src/filter-list/FilterListItemApi.ts"],"version":3,"file":"FilterListItemApi.d.ts"}

package/build/types/filter-list/__tests__/filterStateToWhereClause.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/types/filter-list/__tests__/filterStateToWhereClause.test.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"","names":[],"sources":["../../../../src/filter-list/__tests__/filterStateToWhereClause.test.ts"],"version":3,"file":"filterStateToWhereClause.test.d.ts"}

package/build/types/filter-list/__tests__/getFilterKey.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/types/filter-list/__tests__/getFilterKey.test.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"","names":[],"sources":["../../../../src/filter-list/__tests__/getFilterKey.test.ts"],"version":3,"file":"getFilterKey.test.d.ts"}

package/build/types/filter-list/__tests__/testUtils.d.ts

@@ -0,0 +1,59 @@
+import type { ObjectTypeDefinition } from "@osdk/api";
+import type { FilterDefinitionUnion } from "../FilterListApi.js";
+import type { ContainsTextFilterState, DateRangeFilterState, FilterComponentType, FilterState, NumberRangeFilterState, SelectFilterState, ToggleFilterState } from "../FilterListItemApi.js";
+export declare const MockObjectType: ObjectTypeDefinition;
+/**
+* Create a property filter definition for testing
+*/
+export declare function createPropertyFilterDef<
+	K extends string = string,
+	C extends FilterComponentType = FilterComponentType
+>(key: K, filterComponent: C, filterState: FilterState): FilterDefinitionUnion<typeof MockObjectType>;
+/**
+* Create a hasLink filter definition for testing
+*/
+export declare function createHasLinkFilterDef(linkName: string): FilterDefinitionUnion<typeof MockObjectType>;
+/**
+* Create a linkedProperty filter definition for testing.
+* Cast required because LinkedPropertyFilterDefinition has complex generic constraints
+* that can't be satisfied with literal link names.
+*/
+export declare function createLinkedPropertyFilterDef(linkName: string, linkedPropertyKey: string): FilterDefinitionUnion<typeof MockObjectType>;
+/**
+* Create a keywordSearch filter definition for testing
+*/
+export declare function createKeywordSearchFilterDef(properties: string[] | "all"): FilterDefinitionUnion<typeof MockObjectType>;
+/**
+* Create a custom filter definition for testing.
+* Cast required because CustomFilterDefinition expects specific callback signatures.
+*/
+export declare function createCustomFilterDef(key: string): FilterDefinitionUnion<typeof MockObjectType>;
+/**
+* Helper to create a SelectFilterState
+*/
+export declare function createSelectState<T = string>(selectedValues: T[], options?: {
+	isExcluding?: boolean
+	includeNull?: boolean
+}): SelectFilterState<T>;
+/**
+* Helper to create a ContainsTextFilterState
+*/
+export declare function createContainsTextState(value?: string, options?: {
+	isExcluding?: boolean
+}): ContainsTextFilterState;
+/**
+* Helper to create a ToggleFilterState
+*/
+export declare function createToggleState(enabled: boolean): ToggleFilterState;
+/**
+* Helper to create a NumberRangeFilterState
+*/
+export declare function createNumberRangeState(minValue?: number, maxValue?: number, options?: {
+	includeNull?: boolean
+}): NumberRangeFilterState;
+/**
+* Helper to create a DateRangeFilterState
+*/
+export declare function createDateRangeState(minValue?: Date, maxValue?: Date, options?: {
+	includeNull?: boolean
+}): DateRangeFilterState;

package/build/types/filter-list/__tests__/testUtils.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cAAc,4BAA4B,WAAY;AACtD,cAAc,6BAA6B,qBAAsB;AACjE,cACE,yBACA,sBACA,qBACA,aACA,wBACA,mBACA,yBACK,yBAA0B;AAEjC,OAAO,cAAM,gBAeG;;;;AAKhB,OAAO,iBAAS;CACd;CACA,UAAU,sBAAsB;EAEhCA,KAAK,GACLC,iBAAiB,GACjBC,aAAa,cACZ,6BAA6B;;;;AAYhC,OAAO,iBAAS,uBACdC,mBACC,6BAA6B;;;;;;AAahC,OAAO,iBAAS,8BACdA,kBACAC,4BACC,6BAA6B;;;;AAiBhC,OAAO,iBAAS,6BACdC,uBAAuB,QACtB,6BAA6B;;;;;AAYhC,OAAO,iBAAS,sBACdC,cACC,6BAA6B;;;;AAchC,OAAO,iBAAS,kBAAkB,YAChCC,gBAAgB,KAChBC,UAAU;CACR;CACA;AACD,IACA,kBAAkB;;;;AAYrB,OAAO,iBAAS,wBACdC,gBACAC,UAAU;CAAE;AAAuB,IAClC;;;;AAWH,OAAO,iBAAS,kBAAkBC,mBAAmB;;;;AAUrD,OAAO,iBAAS,uBACdC,mBACAC,mBACAC,UAAU;CAAE;AAAuB,IAClC;;;;AAYH,OAAO,iBAAS,qBACdC,WAAW,MACXC,WAAW,MACXF,UAAU;CAAE;AAAuB,IAClC","names":["key: K","filterComponent: C","filterState: FilterState","linkName: string","linkedPropertyKey: string","properties: string[] | \"all\"","key: string","selectedValues: T[]","options?: {\n    isExcluding?: boolean;\n    includeNull?: boolean;\n  }","value?: string","options?: { isExcluding?: boolean }","enabled: boolean","minValue?: number","maxValue?: number","options?: { includeNull?: boolean }","minValue?: Date","maxValue?: Date"],"sources":["../../../../src/filter-list/__tests__/testUtils.ts"],"version":3,"file":"testUtils.d.ts"}

package/build/types/filter-list/hooks/__tests__/useFilterListState.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/types/filter-list/hooks/__tests__/useFilterListState.test.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"","names":[],"sources":["../../../../../src/filter-list/hooks/__tests__/useFilterListState.test.tsx"],"version":3,"file":"useFilterListState.test.d.ts"}

package/build/types/filter-list/hooks/useDebouncedValue.d.ts

@@ -0,0 +1,11 @@
+/**
+* A hook that manages a local value with debounced updates to the parent.
+* Useful for inputs where we want immediate visual feedback but delayed
+* propagation of changes (e.g., search inputs, numeric inputs).
+*
+* @param externalValue The controlled value from the parent
+* @param onChange Callback to propagate changes to the parent
+* @param debounceMs Debounce delay in milliseconds
+* @returns Tuple of [localValue, setLocalValue] where setLocalValue triggers debounced onChange
+*/
+export declare function useDebouncedValue<T>(externalValue: T, onChange: (value: T) => void, debounceMs?: number): [T, (value: T) => void];

package/build/types/filter-list/hooks/useDebouncedValue.d.ts.map

@@ -0,0 +1 @@
+{"mappings":";;;;;;;;;;AA6BA,OAAO,iBAAS,kBAAkB,GAChCA,eAAe,GACfC,WAAWC,OAAO,YAClBC,uBACE,IAAID,OAAO","names":["externalValue: T","onChange: (value: T) => void","value: T","debounceMs: number"],"sources":["../../../../src/filter-list/hooks/useDebouncedValue.ts"],"version":3,"file":"useDebouncedValue.d.ts"}

package/build/types/filter-list/hooks/useFilterListState.d.ts

@@ -0,0 +1,11 @@
+import type { ObjectTypeDefinition, WhereClause } from "@osdk/api";
+import type { FilterListProps } from "../FilterListApi.js";
+import type { FilterState } from "../FilterListItemApi.js";
+export interface UseFilterListStateResult<Q extends ObjectTypeDefinition> {
+	filterStates: Map<string, FilterState>;
+	setFilterState: (filterKey: string, state: FilterState) => void;
+	whereClause: WhereClause<Q>;
+	activeFilterCount: number;
+	reset: () => void;
+}
+export declare function useFilterListState<Q extends ObjectTypeDefinition>(props: FilterListProps<Q>): UseFilterListStateResult<Q>;

package/build/types/filter-list/hooks/useFilterListState.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cAAc,sBAAsB,mBAAmB,WAAY;AAEnE,cAAc,uBAAuB,qBAAsB;AAC3D,cAAc,mBAAmB,yBAA0B;AAO3D,iBAAiB,yBAAyB,UAAU,sBAAsB;CACxE,cAAc,YAAY;CAC1B,iBACEA,mBACAC,OAAO;CAET,aAAa,YAAY;CACzB;CACA;AACD;AAqDD,OAAO,iBAAS,mBAAmB,UAAU,sBAC3CC,OAAO,gBAAgB,KACtB,yBAAyB","names":["filterKey: string","state: FilterState","props: FilterListProps<Q>"],"sources":["../../../../src/filter-list/hooks/useFilterListState.ts"],"version":3,"file":"useFilterListState.d.ts"}

package/build/types/filter-list/hooks/usePropertyAggregation.d.ts

@@ -0,0 +1,20 @@
+import type { ObjectTypeDefinition, PropertyKeys, WhereClause } from "@osdk/api";
+export interface PropertyAggregationValue {
+	value: string;
+	count: number;
+	isNull?: boolean;
+}
+export interface UsePropertyAggregationResult {
+	data: PropertyAggregationValue[];
+	maxCount: number;
+	isLoading: boolean;
+	error: Error | null;
+}
+export interface UsePropertyAggregationOptions<Q extends ObjectTypeDefinition = ObjectTypeDefinition> {
+	limit?: number;
+	where?: WhereClause<Q>;
+}
+export declare function usePropertyAggregation<
+	Q extends ObjectTypeDefinition,
+	K extends PropertyKeys<Q>
+>(objectType: Q, propertyKey: K, options?: UsePropertyAggregationOptions<Q>): UsePropertyAggregationResult;

package/build/types/filter-list/hooks/usePropertyAggregation.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cAEE,sBACA,cACA,mBACK,WAAY;AAInB,iBAAiB,yBAAyB;CACxC;CACA;CACA;AACD;AAED,iBAAiB,6BAA6B;CAC5C,MAAM;CACN;CACA;CACA,OAAO;AACR;AAED,iBAAiB,8BACf,UAAU,uBAAuB,sBACjC;CACA;CACA,QAAQ,YAAY;AACrB;AAED,OAAO,iBAAS;CACd,UAAU;CACV,UAAU,aAAa;EAEvBA,YAAY,GACZC,aAAa,GACbC,UAAU,8BAA8B,KACvC","names":["objectType: Q","propertyKey: K","options?: UsePropertyAggregationOptions<Q>"],"sources":["../../../../src/filter-list/hooks/usePropertyAggregation.ts"],"version":3,"file":"usePropertyAggregation.d.ts"}

package/build/types/filter-list/types/AddFilterMenuTypes.d.ts

@@ -0,0 +1,61 @@
+import type { ReactNode } from "react";
+import type { FilterComponentType } from "../FilterListItemApi.js";
+/**
+* Category for organizing filters in the add filter menu
+*/
+export type FilterCategory = "ALL_PROPERTIES" | "SINGLE_PROPERTY" | "LINKED_OBJECT";
+/**
+* Template for a filter that can be added via the add filter menu
+*/
+export interface FilterTemplate {
+	/**
+	* Unique identifier for the template
+	*/
+	id: string;
+	/**
+	* Display label for the filter
+	*/
+	label: string;
+	/**
+	* Property key this filter applies to
+	*/
+	key: string;
+	/**
+	* The type of filter component to use
+	*/
+	filterComponent: FilterComponentType;
+	/**
+	* Icon to display next to the filter label.
+	* Can be a string (icon name) or a ReactNode for custom icons.
+	*/
+	icon: string | ReactNode;
+	/**
+	* Whether multiple instances of this filter can be added
+	*/
+	allowMultiple: boolean;
+	/**
+	* Category for grouping in the add filter menu
+	*/
+	category: FilterCategory;
+}
+/**
+* Props for the add filter menu component
+*/
+export interface AddFilterMenuProps {
+	/**
+	* Available filter templates to display
+	*/
+	templates: FilterTemplate[];
+	/**
+	* Current count of active filters by key
+	*/
+	activeCounts: Record<string, number>;
+	/**
+	* Called when a filter template is selected
+	*/
+	onSelectFilter: (template: FilterTemplate) => void;
+	/**
+	* Called when the menu should be closed
+	*/
+	onClose: () => void;
+}

package/build/types/filter-list/types/AddFilterMenuTypes.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cAAc,iBAAiB,OAAQ;AACvC,cAAc,2BAA2B,yBAA0B;;;;AAKnE,YAAY,iBACR,mBACA,oBACA;;;;AAKJ,iBAAiB,eAAe;;;;CAI9B;;;;CAKA;;;;CAKA;;;;CAKA,iBAAiB;;;;;CAMjB,eAAe;;;;CAKf;;;;CAKA,UAAU;AACX;;;;AAKD,iBAAiB,mBAAmB;;;;CAIlC,WAAW;;;;CAKX,cAAc;;;;CAKd,iBAAiBA,UAAU;;;;CAK3B;AACD","names":["template: FilterTemplate"],"sources":["../../../../src/filter-list/types/AddFilterMenuTypes.ts"],"version":3,"file":"AddFilterMenuTypes.d.ts"}

package/build/types/filter-list/types/CustomRendererTypes.d.ts

@@ -0,0 +1,76 @@
+import type { ObjectSet, ObjectTypeDefinition, WhereClause } from "@osdk/api";
+import type { ReactNode } from "react";
+import type { BaseFilterState } from "../FilterListItemApi.js";
+/**
+* State for custom filter
+*/
+export interface CustomFilterState<T = Record<string, unknown>> extends BaseFilterState {
+	type: "custom";
+	customState: T;
+}
+/**
+* Props passed to custom filter input renderer
+*/
+export interface CustomFilterInputRendererProps<
+	Q extends ObjectTypeDefinition,
+	State extends BaseFilterState
+> {
+	objectSet: ObjectSet<Q>;
+	filterState: State;
+	onFilterStateChanged: (newState: State) => void;
+}
+/**
+* Props passed to custom filter item renderer
+* Includes full item context in addition to input renderer props
+*/
+export interface CustomFilterItemRendererProps<
+	Q extends ObjectTypeDefinition,
+	State extends BaseFilterState
+> extends CustomFilterInputRendererProps<Q, State> {
+	label: string;
+	onRemove?: () => void;
+}
+/**
+* Filter definition for custom filters
+* Provides full control over rendering and filter logic
+*/
+export interface CustomFilterDefinition<
+	Q extends ObjectTypeDefinition,
+	State extends BaseFilterState = CustomFilterState
+> {
+	type: "CUSTOM";
+	/**
+	* Optional unique identifier for stable keying across filter reorders.
+	* If provided, takes precedence over `key` for state keying.
+	*/
+	id?: string;
+	/**
+	* Unique key for this custom filter
+	*/
+	key: string;
+	label?: string;
+	filterComponent: "CUSTOM";
+	filterState: State;
+	defaultFilterState?: State;
+	/**
+	* Render the input portion of the filter
+	* Used when rendering within a filter item wrapper
+	*/
+	renderInput?: (props: CustomFilterInputRendererProps<Q, State>) => ReactNode;
+	/**
+	* Render the complete filter item
+	* Used when you need full control over the item appearance
+	*/
+	renderItem?: (props: CustomFilterItemRendererProps<Q, State>) => ReactNode;
+	/**
+	* Convert filter state to a WhereClause for filtering
+	* Required for the filter to affect the object set
+	*/
+	toWhereClause: (state: State) => WhereClause<Q> | undefined;
+	/**
+	* Controls whether this filter is rendered.
+	* When false, the filter is hidden but its state is preserved.
+	* @default true
+	*/
+	isVisible?: boolean;
+}

package/build/types/filter-list/types/CustomRendererTypes.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cAAc,WAAW,sBAAsB,mBAAmB,WAAY;AAC9E,cAAc,iBAAiB,OAAQ;AACvC,cAAc,uBAAuB,yBAA0B;;;;AAK/D,iBAAiB,kBAAkB,IAAI,iCAC7B,gBACV;CACE,MAAM;CACN,aAAa;AACd;;;;AAKD,iBAAiB;CACf,UAAU;CACV,cAAc;EACd;CACA,WAAW,UAAU;CACrB,aAAa;CACb,uBAAuBA,UAAU;AAClC;;;;;AAMD,iBAAiB;CACf,UAAU;CACV,cAAc;UACN,+BAA+B,GAAG,OAAO;CACjD;CACA;AACD;;;;;AAMD,iBAAiB;CACf,UAAU;CACV,cAAc,kBAAkB;EAChC;CACA,MAAM;;;;;CAKN;;;;CAIA;CACA;CACA,iBAAiB;CACjB,aAAa;CACb,qBAAqB;;;;;CAKrB,eACEC,OAAO,+BAA+B,GAAG,WACtC;;;;;CAKL,cACEC,OAAO,8BAA8B,GAAG,WACrC;;;;;CAKL,gBAAgBC,OAAO,UAAU,YAAY;;;;;;CAM7C;AACD","names":["newState: State","props: CustomFilterInputRendererProps<Q, State>","props: CustomFilterItemRendererProps<Q, State>","state: State"],"sources":["../../../../src/filter-list/types/CustomRendererTypes.ts"],"version":3,"file":"CustomRendererTypes.d.ts"}

package/build/types/filter-list/types/KeywordSearchTypes.d.ts

@@ -0,0 +1,56 @@
+import type { ObjectTypeDefinition, PropertyKeys } from "@osdk/api";
+import type { BaseFilterState } from "../FilterListItemApi.js";
+/**
+* Keys of string properties on an object type
+*/
+export type StringPropertyKeys<Q extends ObjectTypeDefinition> = PropertyKeys.Filtered<Q, "string">;
+/**
+* State for keyword search filter
+*/
+export interface KeywordSearchFilterState extends BaseFilterState {
+	type: "keywordSearch";
+	searchTerm: string;
+	/**
+	* How multiple terms are combined
+	* - "AND": All terms must match
+	* - "OR": Any term must match
+	*/
+	operator: "AND" | "OR";
+}
+/**
+* Filter definition for keyword search across string properties
+*/
+export interface KeywordSearchFilterDefinition<
+	Q extends ObjectTypeDefinition,
+	K extends StringPropertyKeys<Q> = StringPropertyKeys<Q>
+> {
+	type: "KEYWORD_SEARCH";
+	/**
+	* Optional unique identifier for stable keying across filter reorders.
+	*/
+	id?: string;
+	/**
+	* Properties to search within
+	* - "all": Search all string properties
+	* - K[]: Search specific string properties
+	*/
+	properties: "all" | K[];
+	label?: string;
+	/**
+	* Controlled state for the filter.
+	* When provided, the filter becomes controlled and changes should be
+	* handled via onFilterStateChanged callback.
+	*/
+	filterState?: KeywordSearchFilterState;
+	/**
+	* Default state for uncontrolled mode.
+	* Used when filterState is not provided.
+	*/
+	defaultFilterState?: KeywordSearchFilterState;
+	/**
+	* Controls whether this filter is rendered.
+	* When false, the filter is hidden but its state is preserved.
+	* @default true
+	*/
+	isVisible?: boolean;
+}

package/build/types/filter-list/types/KeywordSearchTypes.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cAAc,sBAAsB,oBAAoB,WAAY;AACpE,cAAc,uBAAuB,yBAA0B;;;;AAK/D,YAAY,mBAAmB,UAAU,wBACvC,aAAa,SAAS,GAAG;;;;AAK3B,iBAAiB,iCAAiC,gBAAgB;CAChE,MAAM;CACN;;;;;;CAMA,UAAU,QAAQ;AACnB;;;;AAKD,iBAAiB;CACf,UAAU;CACV,UAAU,mBAAmB,KAAK,mBAAmB;EACrD;CACA,MAAM;;;;CAIN;;;;;;CAMA,YAAY,QAAQ;CACpB;;;;;;CAMA,cAAc;;;;;CAKd,qBAAqB;;;;;;CAMrB;AACD","names":[],"sources":["../../../../src/filter-list/types/KeywordSearchTypes.ts"],"version":3,"file":"KeywordSearchTypes.d.ts"}

package/build/types/filter-list/types/LinkedFilterTypes.d.ts

@@ -0,0 +1,70 @@
+import type { LinkedType, LinkNames, ObjectTypeDefinition, PropertyKeys } from "@osdk/api";
+import type { BaseFilterState, FilterState, FilterStateByComponentType, PropertyTypeFromKey, ValidComponentsForPropertyType } from "../FilterListItemApi.js";
+/**
+* State for "has link" filter
+*/
+export interface HasLinkFilterState extends BaseFilterState {
+	type: "hasLink";
+	hasLink: boolean;
+}
+/**
+* State for linked property filter
+* Wraps the filter state of the linked property
+*/
+export interface LinkedPropertyFilterState<S extends FilterState = FilterState> extends BaseFilterState {
+	type: "linkedProperty";
+	linkedFilterState: S;
+}
+/**
+* Filter definition for "Has Link" filter
+* Filters objects based on whether they have any linked objects of the specified type
+*/
+export interface HasLinkFilterDefinition<
+	Q extends ObjectTypeDefinition,
+	L extends LinkNames<Q> = LinkNames<Q>
+> {
+	type: "HAS_LINK";
+	/**
+	* Optional unique identifier for stable keying across filter reorders.
+	*/
+	id?: string;
+	linkName: L;
+	label?: string;
+	filterState: HasLinkFilterState;
+	defaultFilterState?: HasLinkFilterState;
+	/**
+	* Controls whether this filter is rendered.
+	* When false, the filter is hidden but its state is preserved.
+	* @default true
+	*/
+	isVisible?: boolean;
+}
+/**
+* Filter definition for filtering on a property of linked objects
+*/
+export interface LinkedPropertyFilterDefinition<
+	Q extends ObjectTypeDefinition,
+	L extends LinkNames<Q>,
+	LinkedQ extends ObjectTypeDefinition = LinkedType<Q, L>,
+	LinkedK extends PropertyKeys<LinkedQ> = PropertyKeys<LinkedQ>,
+	LinkedC extends ValidComponentsForPropertyType<PropertyTypeFromKey<LinkedQ, LinkedK>> = ValidComponentsForPropertyType<PropertyTypeFromKey<LinkedQ, LinkedK>>
+> {
+	type: "LINKED_PROPERTY";
+	/**
+	* Optional unique identifier for stable keying across filter reorders.
+	*/
+	id?: string;
+	linkName: L;
+	linkedPropertyKey: LinkedK;
+	linkedFilterComponent: LinkedC;
+	linkedFilterState: FilterStateByComponentType[LinkedC];
+	defaultLinkedFilterState?: FilterStateByComponentType[LinkedC];
+	filterState: LinkedPropertyFilterState<FilterStateByComponentType[LinkedC]>;
+	label?: string;
+	/**
+	* Controls whether this filter is rendered.
+	* When false, the filter is hidden but its state is preserved.
+	* @default true
+	*/
+	isVisible?: boolean;
+}

package/build/types/filter-list/types/LinkedFilterTypes.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cACE,YACA,WACA,sBACA,oBACK,WAAY;AACnB,cACE,iBACA,aACA,4BACA,qBACA,sCACK,yBAA0B;;;;AAKjC,iBAAiB,2BAA2B,gBAAgB;CAC1D,MAAM;CACN;AACD;;;;;AAMD,iBAAiB,0BAA0B,UAAU,cAAc,qBACzD,gBACV;CACE,MAAM;CACN,mBAAmB;AACpB;;;;;AAMD,iBAAiB;CACf,UAAU;CACV,UAAU,UAAU,KAAK,UAAU;EACnC;CACA,MAAM;;;;CAIN;CACA,UAAU;CACV;CACA,aAAa;CACb,qBAAqB;;;;;;CAMrB;AACD;;;;AAKD,iBAAiB;CACf,UAAU;CACV,UAAU,UAAU;CACpB,gBAAgB,uBAAuB,WAAW,GAAG;CACrD,gBAAgB,aAAa,WAAW,aAAa;CACrD,gBAAgB,+BACd,oBAAoB,SAAS,YAC3B,+BAA+B,oBAAoB,SAAS;EAChE;CACA,MAAM;;;;CAIN;CACA,UAAU;CACV,mBAAmB;CACnB,uBAAuB;CACvB,mBAAmB,2BAA2B;CAC9C,2BAA2B,2BAA2B;CACtD,aAAa,0BAA0B,2BAA2B;CAClE;;;;;;CAMA;AACD","names":[],"sources":["../../../../src/filter-list/types/LinkedFilterTypes.ts"],"version":3,"file":"LinkedFilterTypes.d.ts"}

package/build/types/filter-list/types/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./AddFilterMenuTypes.js";
+export * from "./CustomRendererTypes.js";
+export * from "./KeywordSearchTypes.js";
+export * from "./LinkedFilterTypes.js";

package/build/types/filter-list/types/index.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc","names":[],"sources":["../../../../src/filter-list/types/index.ts"],"version":3,"file":"index.d.ts"}

package/build/types/filter-list/utils/assertUnreachable.d.ts

@@ -0,0 +1,6 @@
+/**
+* Exhaustive type checking helper.
+* Use in default cases of switch statements to ensure all cases are handled.
+* TypeScript will error if a case is missing.
+*/
+export declare function assertUnreachable(value: never): never;

package/build/types/filter-list/utils/assertUnreachable.d.ts.map

@@ -0,0 +1 @@
+{"mappings":";;;;;AAqBA,OAAO,iBAAS,kBAAkBA","names":["value: never"],"sources":["../../../../src/filter-list/utils/assertUnreachable.ts"],"version":3,"file":"assertUnreachable.d.ts"}

package/build/types/filter-list/utils/coerceFilterValue.d.ts

@@ -0,0 +1,11 @@
+type FilterValue = string | boolean | number;
+/**
+* Coerces a filter value to a string for display.
+* Returns undefined if the value is undefined.
+*/
+export declare function coerceToString(value: FilterValue | undefined): string | undefined;
+/**
+* Coerces an array of filter values to string[] for display.
+*/
+export declare function coerceToStringArray(values: FilterValue[] | undefined): string[];
+export {};