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

package/build/types/filter-list/base/inputs/RangeInput.d.ts

@@ -0,0 +1,37 @@
+import type { ObjectSet, ObjectTypeDefinition, PropertyKeys } from "@osdk/api";
+import React from "react";
+export interface RangeInputConfig<T> {
+	inputType: "number" | "date";
+	formatValue: (value: T | undefined) => string;
+	parseValue: (value: string) => T | undefined;
+	toNumber: (value: T) => number;
+	fromNumber: (value: number) => T;
+	minLabel: string;
+	maxLabel: string;
+	formatTooltip: (min: T, max: T, count: number) => string;
+	formatPlaceholder?: (value: T) => string;
+	inputProps?: React.InputHTMLAttributes<HTMLInputElement>;
+}
+export interface RangeInputProps<
+	Q extends ObjectTypeDefinition,
+	K extends PropertyKeys<Q>,
+	T
+> {
+	objectType: Q;
+	propertyKey: K;
+	minValue: T | undefined;
+	maxValue: T | undefined;
+	onChange: (min: T | undefined, max: T | undefined) => void;
+	objectSet?: ObjectSet<Q>;
+	showHistogram?: boolean;
+	className?: string;
+	style?: React.CSSProperties;
+	config: RangeInputConfig<T>;
+}
+declare function RangeInputInner<
+	Q extends ObjectTypeDefinition,
+	K extends PropertyKeys<Q>,
+	T
+>({ objectType, propertyKey, minValue, maxValue, onChange, objectSet, showHistogram, className, style, config }: RangeInputProps<Q, K, T>): React.ReactElement;
+export declare const RangeInput: typeof RangeInputInner;
+export {};

package/build/types/filter-list/base/inputs/RangeInput.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAiBA,cAAc,WAAW,sBAAsB,oBAAoB,WAAY;AAI/E,OAAO,WAQA,OAAQ;AAef,iBAAiB,iBAAiB,GAAG;CACnC,WAAW,WAAW;CACtB,cAAcA,OAAO;CACrB,aAAaC,kBAAkB;CAC/B,WAAWC,OAAO;CAClB,aAAaC,kBAAkB;CAC/B;CACA;CACA,gBAAgBC,KAAK,GAAGC,KAAK,GAAGC;CAChC,qBAAqBJ,OAAO;CAC5B,aAAa,MAAM,oBAAoB;AACxC;AAED,iBAAiB;CACf,UAAU;CACV,UAAU,aAAa;CACvB;EACA;CACA,YAAY;CACZ,aAAa;CACb,UAAU;CACV,UAAU;CACV,WAAWK,KAAK,eAAeC,KAAK;CACpC,YAAY,UAAU;CACtB;CACA;CACA,QAAQ,MAAM;CACd,QAAQ,iBAAiB;AAC1B;AAED,iBAAS;CACP,UAAU;CACV,UAAU,aAAa;CACvB;EACA,EACA,YACA,aACA,UACA,UACA,UACA,WACA,eACA,WACA,OACA,QACyB,EAAxB,gBAAgB,GAAG,GAAG,KAAK,MAAM;AA+NpC,OAAO,cAAM,mBAA6C","names":["value: T | undefined","value: string","value: T","value: number","min: T","max: T","count: number","min: T | undefined","max: T | undefined"],"sources":["../../../../../src/filter-list/base/inputs/RangeInput.tsx"],"version":3,"file":"RangeInput.d.ts"}

package/build/types/filter-list/base/inputs/SingleDateInput.d.ts

@@ -0,0 +1,13 @@
+import React from "react";
+interface SingleDateInputProps {
+	selectedDate: Date | undefined;
+	onChange: (date: Date | undefined) => void;
+	className?: string;
+	style?: React.CSSProperties;
+	minDate?: Date;
+	maxDate?: Date;
+	placeholder?: string;
+	showClearButton?: boolean;
+}
+export declare const SingleDateInput: React.NamedExoticComponent<SingleDateInputProps>;
+export {};

package/build/types/filter-list/base/inputs/SingleDateInput.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAmBA,OAAO,WAAkC,OAAQ;UAIvC,qBAAqB;CAC7B,cAAc;CACd,WAAWA,MAAM;CACjB;CACA,QAAQ,MAAM;CACd,UAAU;CACV,UAAU;CACV;CACA;AACD;AAmDD,OAAO,cAAMC,iBAAiB,MAAM,qBAAqB","names":["date: Date | undefined","SingleDateInput: React.NamedExoticComponent<SingleDateInputProps>"],"sources":["../../../../../src/filter-list/base/inputs/SingleDateInput.tsx"],"version":3,"file":"SingleDateInput.d.ts"}

package/build/types/filter-list/base/inputs/SingleSelectInput.d.ts

@@ -0,0 +1,24 @@
+import type { ObjectSet, ObjectTypeDefinition, PropertyKeys, WhereClause } from "@osdk/api";
+import React from "react";
+interface SingleSelectInputProps<
+	Q extends ObjectTypeDefinition,
+	K extends PropertyKeys<Q>
+> {
+	objectType: Q;
+	propertyKey: K;
+	selectedValue: string | undefined;
+	onChange: (value: string | undefined) => void;
+	objectSet?: ObjectSet<Q>;
+	whereClause?: WhereClause<Q>;
+	className?: string;
+	style?: React.CSSProperties;
+	placeholder?: string;
+	showClearButton?: boolean;
+	showCounts?: boolean;
+}
+declare function SingleSelectInputInner<
+	Q extends ObjectTypeDefinition,
+	K extends PropertyKeys<Q>
+>({ objectType, propertyKey, selectedValue, onChange, whereClause, className, style, placeholder, showClearButton, showCounts }: SingleSelectInputProps<Q, K>): React.ReactElement;
+export declare const SingleSelectInput: typeof SingleSelectInputInner;
+export {};

package/build/types/filter-list/base/inputs/SingleSelectInput.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAkBA,cACE,WACA,sBACA,cACA,mBACK,WAAY;AAEnB,OAAO,WAA2C,OAAQ;UAMhD;CACR,UAAU;CACV,UAAU,aAAa;EACvB;CACA,YAAY;CACZ,aAAa;CACb;CACA,WAAWA;CACX,YAAY,UAAU;CACtB,cAAc,YAAY;CAC1B;CACA,QAAQ,MAAM;CACd;CACA;CACA;AACD;AAED,iBAAS;CACP,UAAU;CACV,UAAU,aAAa;EACvB,EACA,YACA,aACA,eACA,UACA,aACA,WACA,OACA,aACA,iBACA,YAC6B,EAA5B,uBAAuB,GAAG,KAAK,MAAM;AA6FxC,OAAO,cAAM,0BAED","names":["value: string | undefined"],"sources":["../../../../../src/filter-list/base/inputs/SingleSelectInput.tsx"],"version":3,"file":"SingleSelectInput.d.ts"}

package/build/types/filter-list/base/inputs/TextTagsInput.d.ts

@@ -0,0 +1,24 @@
+import type { ObjectSet, ObjectTypeDefinition, PropertyKeys, WhereClause } from "@osdk/api";
+import React from "react";
+interface TextTagsInputProps<
+	Q extends ObjectTypeDefinition,
+	K extends PropertyKeys<Q>
+> {
+	objectType: Q;
+	propertyKey: K;
+	tags: string[];
+	onChange: (tags: string[]) => void;
+	objectSet?: ObjectSet<Q>;
+	whereClause?: WhereClause<Q>;
+	className?: string;
+	style?: React.CSSProperties;
+	placeholder?: string;
+	allowCustomTags?: boolean;
+	suggestionLimit?: number;
+}
+declare function TextTagsInputInner<
+	Q extends ObjectTypeDefinition,
+	K extends PropertyKeys<Q>
+>({ objectType, propertyKey, tags, onChange, whereClause, className, style, placeholder, allowCustomTags, suggestionLimit }: TextTagsInputProps<Q, K>): React.ReactElement;
+export declare const TextTagsInput: typeof TextTagsInputInner;
+export {};

package/build/types/filter-list/base/inputs/TextTagsInput.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAiBA,cACE,WACA,sBACA,cACA,mBACK,WAAY;AAEnB,OAAO,WAAqD,OAAQ;UAiC1D;CACR,UAAU;CACV,UAAU,aAAa;EACvB;CACA,YAAY;CACZ,aAAa;CACb;CACA,WAAWA;CACX,YAAY,UAAU;CACtB,cAAc,YAAY;CAC1B;CACA,QAAQ,MAAM;CACd;CACA;CACA;AACD;AAED,iBAAS;CACP,UAAU;CACV,UAAU,aAAa;EACvB,EACA,YACA,aACA,MACA,UACA,aACA,WACA,OACA,aACA,iBACA,iBACyB,EAAxB,mBAAmB,GAAG,KAAK,MAAM;AAiKpC,OAAO,cAAM,sBAED","names":["tags: string[]"],"sources":["../../../../../src/filter-list/base/inputs/TextTagsInput.tsx"],"version":3,"file":"TextTagsInput.d.ts"}

package/build/types/filter-list/base/inputs/TimelineInput.d.ts

@@ -0,0 +1,11 @@
+import React from "react";
+interface TimelineInputProps {
+	startDate: Date | undefined;
+	endDate: Date | undefined;
+	onChange: (startDate: Date | undefined, endDate: Date | undefined) => void;
+	className?: string;
+	minDate?: Date;
+	maxDate?: Date;
+}
+export declare const TimelineInput: React.NamedExoticComponent<TimelineInputProps>;
+export {};

package/build/types/filter-list/base/inputs/TimelineInput.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAmBA,OAAO,WAA2C,OAAQ;UAQhD,mBAAmB;CAC3B,WAAW;CACX,SAAS;CACT,WAAWA,WAAW,kBAAkBC,SAAS;CACjD;CACA,UAAU;CACV,UAAU;AACX;AAkFD,OAAO,cAAMC,eAAe,MAAM,qBAAqB","names":["startDate: Date | undefined","endDate: Date | undefined","TimelineInput: React.NamedExoticComponent<TimelineInputProps>"],"sources":["../../../../../src/filter-list/base/inputs/TimelineInput.tsx"],"version":3,"file":"TimelineInput.d.ts"}

package/build/types/filter-list/base/inputs/ToggleInput.d.ts

@@ -0,0 +1,10 @@
+import React from "react";
+interface ToggleInputProps {
+	enabled: boolean;
+	onChange: (enabled: boolean) => void;
+	label?: string;
+	className?: string;
+	style?: React.CSSProperties;
+}
+export declare const ToggleInput: React.NamedExoticComponent<ToggleInputProps>;
+export {};

package/build/types/filter-list/base/inputs/ToggleInput.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAiBA,OAAO,WAAqB,OAAQ;UAI1B,iBAAiB;CACzB;CACA,WAAWA;CACX;CACA;CACA,QAAQ,MAAM;AACf;AAqBD,OAAO,cAAMC,aAAa,MAAM,qBAAqB","names":["enabled: boolean","ToggleInput: React.NamedExoticComponent<ToggleInputProps>"],"sources":["../../../../../src/filter-list/base/inputs/ToggleInput.tsx"],"version":3,"file":"ToggleInput.d.ts"}

package/build/types/filter-list/base/inputs/createHistogramBuckets.d.ts

@@ -0,0 +1,16 @@
+export declare const HISTOGRAM_BUCKETS = 20;
+export interface HistogramBucket<T> {
+	min: T;
+	max: T;
+	count: number;
+}
+interface ValueCountPair<T> {
+	value: T;
+	count: number;
+}
+export declare function createHistogramBuckets<T>(pairs: Array<ValueCountPair<T>>, range: {
+	min: T
+	max: T
+}, toNumber: (value: T) => number, fromNumber: (value: number) => T): Array<HistogramBucket<T>>;
+export declare function getMaxBucketCount<T>(buckets: Array<HistogramBucket<T>>): number;
+export {};

package/build/types/filter-list/base/inputs/createHistogramBuckets.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,OAAO,cAAM,oBAAoB;AAEjC,iBAAiB,gBAAgB,GAAG;CAClC,KAAK;CACL,KAAK;CACL;AACD;UAES,eAAe,GAAG;CAC1B,OAAO;CACP;AACD;AAED,OAAO,iBAAS,uBAAuB,GACrCA,OAAO,MAAM,eAAe,KAC5BC,OAAO;CAAE,KAAK;CAAG,KAAK;AAAG,GACzBC,WAAWC,OAAO,cAClBC,aAAaC,kBAAkB,IAC9B,MAAM,gBAAgB;AAgCzB,OAAO,iBAAS,kBAAkB,GAChCC,SAAS,MAAM,gBAAgB","names":["pairs: Array<ValueCountPair<T>>","range: { min: T; max: T }","toNumber: (value: T) => number","value: T","fromNumber: (value: number) => T","value: number","buckets: Array<HistogramBucket<T>>"],"sources":["../../../../../src/filter-list/base/inputs/createHistogramBuckets.ts"],"version":3,"file":"createHistogramBuckets.d.ts"}

package/build/types/filter-list/base/inputs/dateUtils.d.ts

@@ -0,0 +1,17 @@
+/**
+* Date utilities for HTML date inputs.
+*
+* These functions operate on local time by design. HTML <input type="date">
+* returns and expects values in "YYYY-MM-DD" format without timezone info.
+*
+* `parseDateFromInput` appends "T00:00:00" (no "Z") so the date is parsed as
+* local midnight rather than UTC midnight. Without this, negative-offset
+* timezones (e.g. US timezones) would shift "2024-01-15" to Jan 14 locally.
+*
+* Consumers providing dates from an API (typically UTC) should handle
+* UTC-to-local conversion before passing values to these functions.
+*/
+export declare function formatDateForInput(date: Date | undefined): string;
+export declare function parseDateFromInput(value: string): Date | undefined;
+export declare function formatDateForDisplay(date: Date | undefined, fallback?: string): string;
+export declare function parseDateFromISO(value: string | Date | undefined | null): Date | undefined;

package/build/types/filter-list/base/inputs/dateUtils.d.ts.map

@@ -0,0 +1 @@
+{"mappings":";;;;;;;;;;;;;AA8BA,OAAO,iBAAS,mBAAmBA,MAAM;AAQzC,OAAO,iBAAS,mBAAmBC,gBAAgB;AAMnD,OAAO,iBAAS,qBACdD,MAAM,kBACNE;AAUF,OAAO,iBAAS,iBACdC,gBAAgB,0BACf","names":["date: Date | undefined","value: string","fallback: string","value: string | Date | undefined | null"],"sources":["../../../../../src/filter-list/base/inputs/dateUtils.ts"],"version":3,"file":"dateUtils.d.ts"}

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

@@ -0,0 +1,8 @@
+export { CheckboxListInput } from "./CheckboxListInput.js";
+export { ContainsTextInput } from "./ContainsTextInput.js";
+export { DateRangeInput } from "./DateRangeInput.js";
+export { formatDateForDisplay, formatDateForInput, parseDateFromInput } from "./dateUtils.js";
+export { NullValueWrapper } from "./NullValueWrapper.js";
+export { NumberRangeInput } from "./NumberRangeInput.js";
+export { RangeInput } from "./RangeInput.js";
+export { ToggleInput } from "./ToggleInput.js";

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

@@ -0,0 +1 @@
+{"mappings":"AAgBA,SAAS,yBAAyB;AAClC,SAAS,yBAAyB;AAClC,SAAS,sBAAsB;AAC/B,SACE,sBACA,oBACA,0BACK;AACP,SAAS,wBAAwB;AACjC,SAAS,wBAAwB;AACjC,SAAS,kBAAkB;AAC3B,SAAS,mBAAmB","names":[],"sources":["../../../../../src/filter-list/base/inputs/index.ts"],"version":3,"file":"index.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/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;AAKnB,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,56 @@
+import type { ReactNode } from "react";
+import type { FilterComponentType } from "../FilterListItemApi.js";
+/**
+* Visual data indicator configuration for filter items
+*/
+export type FilterDataIndicator = "histogram" | "count" | "none";
+/**
+* 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;
+	/**
+	* Type of data indicator to show (histogram, count, none)
+	*/
+	dataIndicator?: FilterDataIndicator;
+	/**
+	* Whether to show a "Select All" option for checkbox lists
+	*/
+	showSelectAll?: boolean;
+	/**
+	* Maximum number of visible items before scrolling
+	*/
+	maxVisibleItems?: number;
+	/**
+	* Whether multiple instances of this filter can be added
+	*/
+	allowMultiple: boolean;
+	/**
+	* Category for grouping in the add filter menu
+	*/
+	category: FilterCategory;
+}

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

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cAAc,iBAAiB,OAAQ;AACvC,cAAc,2BAA2B,yBAA0B;;;;AAKnE,YAAY,sBAAsB,cAAc,UAAU;;;;AAK1D,YAAY,iBACR,mBACA,oBACA;;;;AAKJ,iBAAiB,eAAe;;;;CAI9B;;;;CAKA;;;;CAKA;;;;CAKA,iBAAiB;;;;;CAMjB,eAAe;;;;CAKf,gBAAgB;;;;CAKhB;;;;CAKA;;;;CAKA;;;;CAKA,UAAU;AACX","names":[],"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/FilterPanelTypes.d.ts

@@ -0,0 +1,18 @@
+import type { ObjectTypeDefinition, WhereClause } from "@osdk/api";
+import type { FilterState } from "../FilterListItemApi.js";
+/**
+* Filter states indexed by key (serializable to JSON)
+*/
+export type SerializableFilterStates = Record<string, FilterState>;
+/**
+* Persisted state for the filter list
+* Can be serialized and stored for session persistence
+*
+* Note: Only includes serializable data. Filter definitions are not persisted
+* because they may contain callback functions which cannot be serialized.
+*/
+export interface FilterListPersistedState<Q extends ObjectTypeDefinition = ObjectTypeDefinition> {
+	collapsed: boolean;
+	filterStatesByKey: SerializableFilterStates;
+	filterClause?: WhereClause<Q>;
+}

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

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cAAc,sBAAsB,mBAAmB,WAAY;AACnE,cAAc,mBAAmB,yBAA0B;;;;AAK3D,YAAY,2BAA2B,eAAe;;;;;;;;AAStD,iBAAiB,yBACf,UAAU,uBAAuB,sBACjC;CACA;CACA,mBAAmB;CACnB,eAAe,YAAY;AAC5B","names":[],"sources":["../../../../src/filter-list/types/FilterPanelTypes.ts"],"version":3,"file":"FilterPanelTypes.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,89 @@
+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;
+}
+/**
+* Display mode for linked filters
+*
+* - "inline": Show alongside non-linked filters in the main list
+* - "grouped": Group by link type with collapsible sections
+*/
+export type LinkedFilterDisplayMode = "inline" | "grouped";
+/**
+* Configuration for a group of linked filters
+*/
+export interface LinkedFilterGroupConfig<
+	Q extends ObjectTypeDefinition,
+	L extends LinkNames<Q> = LinkNames<Q>
+> {
+	linkName: L;
+	displayMode: LinkedFilterDisplayMode;
+	collapsedByDefault?: boolean;
+	groupLabel?: string;
+}

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;;;;;;;AAQD,YAAY,0BAA0B,WAAW;;;;AAKjD,iBAAiB;CACf,UAAU;CACV,UAAU,UAAU,KAAK,UAAU;EACnC;CACA,UAAU;CACV,aAAa;CACb;CACA;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,5 @@
+export * from "./AddFilterMenuTypes.js";
+export * from "./CustomRendererTypes.js";
+export * from "./FilterPanelTypes.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;AACd,cAAc","names":[],"sources":["../../../../src/filter-list/types/index.ts"],"version":3,"file":"index.d.ts"}

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

@@ -0,0 +1,9 @@
+import type { AggregateOpts, ObjectTypeDefinition, WhereClause } from "@osdk/api";
+export declare function createGroupByAggregateOptions<Q extends ObjectTypeDefinition>(propertyKey: string): AggregateOpts<Q>;
+export declare function createNullCountAggregateOptions<Q extends ObjectTypeDefinition>(): AggregateOpts<Q>;
+/** Shape returned by $groupBy + $count aggregations when iterated. */
+export type AggregationGroupResult = Iterable<{
+	$group: Record<string, unknown>
+	$count?: number
+}>;
+export declare function createNullWhereClause<Q extends ObjectTypeDefinition>(propertyKey: string): WhereClause<Q>;

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

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cACE,eACA,sBACA,mBACK,WAAY;AAEnB,OAAO,iBAAS,8BACd,UAAU,sBACVA,sBAAsB,cAAc;AAOtC,OAAO,iBAAS,gCACd,UAAU,yBACP,cAAc;;AAOnB,YAAY,yBAAyB,SAAS;CAC5C,QAAQ;CACR;AACD;AAED,OAAO,iBAAS,sBACd,UAAU,sBACVA,sBAAsB,YAAY","names":["propertyKey: string"],"sources":["../../../../src/filter-list/utils/aggregationHelpers.ts"],"version":3,"file":"aggregationHelpers.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 | Date;
+/**
+* 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 {};

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

@@ -0,0 +1 @@
+{"mappings":"KAgBK,0CAA0C;;;;;AAM/C,OAAO,iBAAS,eACdA,OAAO;;;;AAST,OAAO,iBAAS,oBACdC,QAAQ","names":["value: FilterValue | undefined","values: FilterValue[] | undefined"],"sources":["../../../../src/filter-list/utils/coerceFilterValue.ts"],"version":3,"file":"coerceFilterValue.d.ts"}