@osdk/react-components 0.56.0 → 0.57.0-main-9c5a7b17bd0a71c88bf2d3ed29847e6f87975bbf

package/build/cjs/public/experimental/filter-list.d.cts

@@ -1,976 +1,62 @@
-import React__default, { ReactNode } from 'react';
-import { ObjectTypeDefinition, ObjectSet, WhereClause, PropertyKeys, LinkNames, LinkedType, WirePropertyTypes, CompileTimeMetadata } from '@osdk/api';
-
-/**
- * State for custom filter
- */
-interface CustomFilterState<T = Record<string, unknown>> extends BaseFilterState {
-    type: "custom";
-    customState: T;
-}
-/**
- * Props passed to custom filter input renderer
- */
-interface CustomFilterInputRendererProps<Q extends ObjectTypeDefinition, State extends BaseFilterState> {
-    objectType: Q;
-    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
- */
-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
- */
-interface CustomFilterDefinition<Q extends ObjectTypeDefinition, State extends BaseFilterState = CustomFilterState> extends FilterDefinitionControls {
-    type: "CUSTOM";
-    /**
-     * Unique key for this custom filter
-     */
-    key: string;
-    label?: string;
-    filterComponent: "CUSTOM";
-    /**
-     * Seeds the filter's state on mount, FilterList owns the state from then on
-     *
-     * @default undefined (filter starts empty)
-     */
-    defaultFilterState?: State;
-    /**
-     * @deprecated Rename to `defaultFilterState`.
-     */
-    filterState?: 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;
-}
-
-/**
- * Keys of string properties on an object type
- */
-type StringPropertyKeys<Q extends ObjectTypeDefinition> = PropertyKeys.Filtered<Q, "string">;
-/**
- * State for keyword search filter
- */
-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
- */
-interface KeywordSearchFilterDefinition<Q extends ObjectTypeDefinition, K extends StringPropertyKeys<Q> = StringPropertyKeys<Q>> extends FilterDefinitionControls {
-    type: "KEYWORD_SEARCH";
-    /**
-     * Properties to search within
-     * - "all": Search all string properties
-     * - K[]: Search specific string properties
-     */
-    properties: "all" | K[];
-    label?: string;
-    /**
-     * Seeds the filter's state on mount, FilterList owns the state from then on
-     *
-     * @default undefined (filter starts empty)
-     */
-    defaultFilterState?: KeywordSearchFilterState;
-    /**
-     * @deprecated Has no effect, remove it.
-     */
-    filterState?: KeywordSearchFilterState;
-}
-
-/**
- * Runtime representation of an active link-traversing filter
- */
-type LinkedFilter<Q extends ObjectTypeDefinition> = {
-    [L in LinkNames<Q>]: {
-        /** The filter definition's `getFilterKey` value. */
-        id: string;
-        linkName: L;
-        /**
-         * Predicate the linked objects must match to be counted.
-         */
-        innerWhere?: WhereClause<LinkedType<Q, L>>;
-        /**
-         * When true, keep source rows whose match-count is zero.
-         */
-        isExcluding?: boolean;
-    };
-}[LinkNames<Q>];
-/**
- * State for "has link" filter
- */
-interface HasLinkFilterState extends BaseFilterState {
-    type: "hasLink";
-    hasLink: boolean;
-}
-/**
- * State for linked property filter
- * Wraps the filter state of the linked property
- */
-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. Filters `objectSet` and is emitted via `onEffectiveObjectSet`; link
- * presence has no filter-clause form, so it never appears in
- * `onFilterClauseChanged`.
- */
-interface HasLinkFilterDefinition<Q extends ObjectTypeDefinition, L extends LinkNames<Q> = LinkNames<Q>> extends FilterDefinitionControls {
-    type: "HAS_LINK";
-    linkName: L;
-    label?: string;
-    /**
-     * Seeds the filter's state on mount, FilterList owns the state from then on
-     *
-     * @default undefined (filter starts empty)
-     */
-    defaultFilterState?: HasLinkFilterState;
-    /**
-     * @deprecated Has no effect, remove it.
-     */
-    filterState?: HasLinkFilterState;
-}
-/**
- * Filter definition for filtering on a property of linked objects
- */
-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>>> extends FilterDefinitionControls {
-    type: "LINKED_PROPERTY";
-    linkName: L;
-    /**
-     * @deprecated Has no effect, remove it.
-     */
-    reverseLinkName?: LinkNames<LinkedQ>;
-    linkedPropertyKey: LinkedK;
-    /**
-     * The filter component to render for the linked property. Must be
-     * compatible with the linked property's type, see
-     * ValidComponentsForPropertyType.
-     *
-     * Required in practice — a definition that sets neither this nor
-     * `linkedFilterComponent` renders as unsupported.
-     */
-    filterComponent?: LinkedC;
-    /**
-     * @deprecated Rename to `filterComponent`.
-     */
-    linkedFilterComponent?: LinkedC;
-    /**
-     * Seeds the state of the filter on the *linked* property. FilterList owns the
-     * state from then on. `onFilterStateChanged` fires with the wrapper.
-     *
-     * @default undefined (filter starts empty)
-     */
-    defaultFilterState?: FilterStateByComponentType[LinkedC];
-    /**
-     * @deprecated Rename to `defaultFilterState`.
-     */
-    defaultLinkedFilterState?: FilterStateByComponentType[LinkedC];
-    /**
-     * @deprecated Has no effect, remove it.
-     */
-    linkedFilterState?: FilterStateByComponentType[LinkedC];
-    /**
-     * @deprecated Has no effect, remove it.
-     */
-    filterState?: LinkedPropertyFilterState<FilterStateByComponentType[LinkedC]>;
-    label?: string;
-    /**
-     * Show aggregation counts next to filter option values.
-     * Applies to LISTOGRAM, SINGLE_SELECT, and MULTI_SELECT linked components.
-     * @default true for LISTOGRAM and MULTI_SELECT, false for SINGLE_SELECT
-     */
-    showCount?: boolean;
-    /**
-     * Custom display function for filter values.
-     * Replaces the default string display in dropdown items, chips, and listogram rows.
-     * When the function returns a string, that string is also used for search matching
-     * within filter dropdowns. When it returns a non-string `ReactNode`, search falls
-     * back to the raw value.
-     */
-    renderValue?: (value: string) => ReactNode;
-}
-
-/**
- * Helper type to extract the property type from an ObjectTypeDefinition given a property key
- */
-type PropertyTypeFromKey<Q extends ObjectTypeDefinition, K extends PropertyKeys<Q>> = CompileTimeMetadata<Q>["properties"][K]["type"];
-/**
- * Fields shared by every filter definition, regardless of kind.
- */
-interface FilterDefinitionControls {
-    /**
-     * When `false`, the header monocle (search-values icon) is hidden even for
-     * filter components that ordinarily support in-filter search. Useful for
-     * `MULTI_SELECT`, which already has its own inline search field.
-     *
-     * @default true
-     */
-    searchField?: boolean;
-    /**
-     * Optional unique identifier for stable keying across filter reorders.
-     * Set it explicitly when that derived value would collide, e.g. two filters on the
-     * same property.
-     *
-     * This is the key used in `defaultFilterStates`; `getFilterKey(definition)`
-     * returns it.
-     *
-     * @default a value derived from the definition (its `key`, or its link and property names)
-     */
-    id?: string;
-    /**
-     * Controls whether this filter is rendered.
-     * When false, the filter is hidden but its state is preserved.
-     * @default true
-     */
-    isVisible?: boolean;
-}
-/**
- * All available filter component types
- */
-type FilterComponentType = "LISTOGRAM" | "DATE_RANGE" | "NUMBER_RANGE" | "TEXT_TAGS" | "CONTAINS_TEXT" | "SINGLE_SELECT" | "MULTI_SELECT" | "SINGLE_DATE" | "MULTI_DATE" | "TIMELINE" | "TOGGLE";
-/**
- * Gets valid component types for a given property type
- */
-type ValidComponentsForPropertyType<P extends WirePropertyTypes> = P extends "boolean" ? "LISTOGRAM" | "SINGLE_SELECT" | "TOGGLE" : P extends "string" ? "LISTOGRAM" | "TEXT_TAGS" | "CONTAINS_TEXT" | "SINGLE_SELECT" | "MULTI_SELECT" : 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
- */
-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
- */
-interface FilterStateByComponentType {
-    LISTOGRAM: ExactMatchFilterState<string | boolean>;
-    DATE_RANGE: DateRangeFilterState;
-    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;
-    TOGGLE: ToggleFilterState;
-}
-/**
- * All filter state discriminator types
- */
-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
- */
-interface BaseFilterState {
-    /**
-     * The type of filter component
-     */
-    type: FilterStateType;
-    /**
-     * If true, the objects satisfying the filter are excluded
-     * @default false
-     */
-    isExcluding?: boolean;
-    /**
-     * If true, include objects that have no value
-     * @default false
-     */
-    includeNull?: boolean;
-}
-interface ExactMatchFilterState<T = string | boolean> extends BaseFilterState {
-    type: "EXACT_MATCH";
-    values: T[];
-}
-interface DateRangeFilterState extends BaseFilterState {
-    type: "DATE_RANGE";
-    /**
-     * The earliest date the user can select
-     */
-    minValue?: Date;
-    /**
-     * The latest date the user can select
-     */
-    maxValue?: Date;
-}
-interface ContainsTextFilterState extends BaseFilterState {
-    type: "CONTAINS_TEXT";
-    value?: string;
-}
-interface NumberRangeFilterState extends BaseFilterState {
-    type: "NUMBER_RANGE";
-    /**
-     * Minimum numeric value (inclusive)
-     */
-    minValue?: number;
-    /**
-     * Maximum numeric value (inclusive)
-     */
-    maxValue?: number;
-}
-/**
- * Consolidated state type for select-based filters.
- * Used by SINGLE_SELECT, MULTI_SELECT, SINGLE_DATE, and MULTI_DATE.
- */
-interface SelectFilterState<T = string | boolean | number | Date> extends BaseFilterState {
-    type: "SELECT";
-    selectedValues: T[];
-}
-interface TimelineFilterState extends BaseFilterState {
-    type: "TIMELINE";
-    startDate?: Date;
-    endDate?: Date;
-    granularity?: "day" | "week" | "month" | "quarter" | "year";
-}
-interface ToggleFilterState extends BaseFilterState {
-    type: "TOGGLE";
-    enabled: boolean;
-}
-/**
- * Optional date display formatter. Mixed into `PropertyFilterDefinition`
- * only when the property is `datetime` or `timestamp` — see
- * {@link PropertyFilterDateExtras}.
- *
- * `formatDate` overrides the displayed string everywhere the filter
- * surfaces a date: the shared `DateRangePicker` / `DatePicker` idle text,
- * the date-range histogram tooltip and period subtitle, the multi-date
- * chip text, and timeline labels. The picker's internal value remains
- * ISO `YYYY-MM-DD` so cross-locale viewers see a consistent input format
- * regardless of `formatDate`.
- *
- * Receives a `Date` in local time. If the property is a UTC ISO string and
- * you want a different timezone, do that conversion inside your callback.
- */
-interface DateFormattingProps {
-    formatDate?: (date: Date) => string;
-}
-/**
- * Conditionally adds `formatDate` to a property filter definition only for
- * `datetime` / `timestamp` properties. For other property types this field
- * is typed as `never` so attempting to set it is a TypeScript error.
- */
-type PropertyFilterDateExtras<P extends WirePropertyTypes> = P extends "datetime" | "timestamp" ? DateFormattingProps : {
-    formatDate?: never;
-};
-interface PropertyFilterDefinitionBase<Q extends ObjectTypeDefinition, K extends PropertyKeys<Q> = PropertyKeys<Q>, C extends ValidComponentsForPropertyType<PropertyTypeFromKey<Q, K>> = ValidComponentsForPropertyType<PropertyTypeFromKey<Q, K>>> extends FilterDefinitionControls {
-    /**
-     * Discriminator for filter definition type
-     */
-    type: "PROPERTY";
-    /**
-     * 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;
-    /**
-     * Seeds the filter's state on mount, FilterList owns the state from then on
-     *
-     * @default undefined (filter starts empty)
-     */
-    defaultFilterState?: FilterStateByComponentType[C];
-    /**
-     * @deprecated Rename to `defaultFilterState`.
-     */
-    filterState?: FilterStateByComponentType[C];
-    /**
-     * Maps filter values to colors for visual differentiation.
-     * Used by LISTOGRAM (per-row bar colors).
-     */
-    colorMap?: Record<string, string>;
-    /**
-     * Configuration for LISTOGRAM display mode.
-     * Only applies when filterComponent is "LISTOGRAM".
-     */
-    listogramConfig?: {
-        displayMode?: "full" | "count" | "minimal";
-        /**
-         * Number of items shown before "View all" link appears
-         * @default 5
-         */
-        maxVisibleItems?: number;
-    };
-    /**
-     * Custom display function for filter values.
-     * Replaces the default string display in dropdown items, chips, and listogram rows.
-     * When the function returns a string, that string is also used for search matching
-     * within filter dropdowns. When it returns a non-string `ReactNode`, search falls
-     * back to the raw value.
-     */
-    renderValue?: (value: string) => ReactNode;
-    /**
-     * Show aggregation counts next to filter option values.
-     * Applies to LISTOGRAM, SINGLE_SELECT, and MULTI_SELECT components.
-     * @default true for LISTOGRAM and MULTI_SELECT, false for SINGLE_SELECT
-     */
-    showCount?: boolean;
-    /**
-     * When true, clicking a bar in the histogram replaces the filter range
-     * with that bucket's `[min, max]`. Only applies to histogram-rendering
-     * filter components (`NUMBER_RANGE` and `DATE_RANGE`); ignored on other
-     * component types.
-     *
-     * Click replaces the current range — clicking a second bar discards the
-     * previous selection. Multi-bucket selection / shift+click union is NOT
-     * supported in v1.
-     *
-     * @default false
-     */
-    clickToFilter?: 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 or SINGLE_SELECT,
- * while string properties can use LISTOGRAM, TEXT_TAGS, CONTAINS_TEXT, SINGLE_SELECT, or MULTI_SELECT.
- *
- * Date and datetime properties may additionally specify `formatDate` — see
- * {@link PropertyFilterDateExtras}.
- */
-type PropertyFilterDefinition<Q extends ObjectTypeDefinition, K extends PropertyKeys<Q> = PropertyKeys<Q>, C extends ValidComponentsForPropertyType<PropertyTypeFromKey<Q, K>> = ValidComponentsForPropertyType<PropertyTypeFromKey<Q, K>>> = PropertyFilterDefinitionBase<Q, K, C> & PropertyFilterDateExtras<PropertyTypeFromKey<Q, K>>;
-
-type RenderFilterInput<D> = (props: {
-    definition: D;
-    filterKey: string;
-    filterState: FilterState | undefined;
-    onFilterStateChanged: (state: FilterState) => void;
-    searchQuery?: string;
-    excludeRowOpen?: boolean;
-}) => React__default.ReactNode;
-interface BaseFilterListProps<D extends FilterDefinitionControls> {
-    filterDefinitions?: Array<D>;
-    filterStates: Map<string, FilterState>;
-    onFilterStateChanged: (filterKey: string, state: FilterState) => void;
-    renderInput: RenderFilterInput<D>;
-    getFilterKey: (definition: D) => string;
-    getFilterLabel: (definition: D) => string;
-    /**
-     * Display-only fallback state for a filter that has no stored state, used so
-     * capability-driven header controls (overflow … menu, search) render for
-     * empty/just-added filters. Never written into the filter-state map.
-     */
-    getEmptyDisplayState?: (definition: D) => FilterState | undefined;
-    activeFilterCount: number;
-    onReset?: () => void;
-    onFilterAdded?: () => void;
-    onFilterRemoved?: (filterKey: string) => void;
-    onOrderChange?: (orderedKeys: string[]) => void;
-    /**
-     * Whether the collapse/expand control is available. When `false` the panel is
-     * always expanded, no collapse control is rendered, and `collapsed` /
-     * `defaultCollapsed` are ignored.
-     * @default true
-     */
-    enableCollapse?: boolean;
-    /**
-     * Controlled mode. When supplied, this prop is the source of truth for
-     * whether the panel is collapsed and the component keeps no internal state;
-     * re-render with a new value in response to `onCollapsedChange`.
-     *
-     * If both `collapsed` and `defaultCollapsed` are provided, `collapsed` takes
-     * precedence. Ignored when `enableCollapse` is `false`.
-     */
-    collapsed?: boolean;
-    /**
-     * Uncontrolled mode. Seeds the panel's internal collapsed state; the
-     * component continues to own the state after mount, so later changes to this
-     * prop are ignored.
-     *
-     * If both `collapsed` and `defaultCollapsed` are provided, `collapsed` takes
-     * precedence. Ignored when `enableCollapse` is `false`.
-     * @default false
-     */
-    defaultCollapsed?: boolean;
-    /**
-     * Called whenever the collapsed state changes.
-     *
-     * @param collapsed The new collapsed state
-     */
-    onCollapsedChange?: (collapsed: boolean) => void;
-    title?: React__default.ReactNode;
-    titleIcon?: React__default.ReactNode;
-    showResetButton?: boolean;
-    showActiveFilterCount?: boolean;
-    /**
-     * Whether the reset button is enabled. Hosts compute this from whether the
-     * filter and/or visibility state has diverged from its initial snapshot.
-     */
-    canReset?: boolean;
-    enableSorting?: boolean;
-    className?: string;
-    renderAddFilterButton?: () => React__default.ReactNode;
-}
-
-declare function BaseFilterList<D extends FilterDefinitionControls>(props: BaseFilterListProps<D>): React__default.ReactElement;
-
-/**
- * Component types that support static values.
- * These components can display a fixed list of string values without OSDK aggregation.
- */
-type StaticValuesComponentType = "LISTOGRAM" | "SINGLE_SELECT" | "MULTI_SELECT" | "TEXT_TAGS";
-/**
- * Filter definition for static (non-OSDK) value lists.
- * Renders built-in filter components with user-provided values instead of
- * fetching values via OSDK aggregation queries.
- */
-interface StaticValuesFilterDefinition<Q extends ObjectTypeDefinition, C extends StaticValuesComponentType = StaticValuesComponentType> extends FilterDefinitionControls {
-    type: "STATIC_VALUES";
-    /**
-     * Key used for state management and auto WHERE clause generation.
-     * When `toWhereClause` is not provided, this is used as the property key
-     * in the generated WHERE clause.
-     */
-    key: string;
-    /**
-     * Display label for the filter
-     */
-    label?: string;
-    /**
-     * The filter component type to render
-     */
-    filterComponent: C;
-    /**
-     * Seeds the filter's state on mount, FilterList owns the state from then on
-     *
-     * @default undefined (filter starts empty)
-     */
-    defaultFilterState?: FilterStateByComponentType[C];
-    /**
-     * @deprecated Rename to `defaultFilterState`.
-     */
-    filterState?: FilterStateByComponentType[C];
-    /**
-     * The static list of values to display in the filter component.
-     * These are rendered directly without OSDK aggregation.
-     */
-    values: string[];
-    /**
-     * Custom display function for filter values.
-     * Replaces the default string display in dropdown items, chips, and listogram rows.
-     * When the function returns a string, that string is also used for search matching
-     * within filter dropdowns. When it returns a non-string `ReactNode`, search falls
-     * back to the raw value.
-     */
-    renderValue?: (value: string) => ReactNode;
-    /**
-     * Show aggregation counts next to filter option values.
-     * Applies to LISTOGRAM, SINGLE_SELECT, and MULTI_SELECT components.
-     * @default true for LISTOGRAM and MULTI_SELECT, false for SINGLE_SELECT
-     */
-    showCount?: boolean;
-    /**
-     * Maps filter values to colors for visual differentiation.
-     * Used by LISTOGRAM (per-row bar colors).
-     */
-    colorMap?: Record<string, string>;
-    /**
-     * Configuration for LISTOGRAM display mode.
-     * Only applies when filterComponent is "LISTOGRAM".
-     */
-    listogramConfig?: {
-        displayMode?: "full" | "count" | "minimal";
-        /**
-         * Number of items shown before "View all" link appears
-         * @default 5
-         */
-        maxVisibleItems?: number;
-    };
-    /**
-     * Optional custom WHERE clause generator.
-     * When provided, this is used instead of auto-generating a WHERE clause
-     * from the `key` and filter state.
-     */
-    toWhereClause?: (state: FilterState) => WhereClause<Q> | undefined;
-}
-
-/**
- * Distributes LinkedPropertyFilterDefinition over each link name individually,
- * so that LinkedQ/LinkedK/LinkedC defaults resolve correctly per link.
- */
-type DistributeLinkedProperty<Q extends ObjectTypeDefinition, L extends LinkNames<Q>> = L extends LinkNames<Q> ? LinkedPropertyFilterDefinition<Q, L> : never;
-/**
- * Union type of all filter definition types
- */
-type FilterDefinitionUnion<Q extends ObjectTypeDefinition> = PropertyFilterDefinition<Q> | HasLinkFilterDefinition<Q> | DistributeLinkedProperty<Q, LinkNames<Q>> | KeywordSearchFilterDefinition<Q> | CustomFilterDefinition<Q> | StaticValuesFilterDefinition<Q>;
-/**
- * The filter state after a change, in one payload.
- */
-interface FilterChangeSnapshot<Q extends ObjectTypeDefinition> {
-    /**
-     * The combined clause for all active filters.
-     *
-     * `HAS_LINK` and `LINKED_PROPERTY` filters are not represented in the clause —
-     * read `filteredObjectSet` for those.
-     */
-    filterClause: WhereClause<Q>;
-    /**
-     * The `objectSet` prop filtered by all active filters, including `HAS_LINK`
-     * and `LINKED_PROPERTY`, or `undefined` when no `objectSet` was supplied.
-     */
-    filteredObjectSet: ObjectSet<Q> | undefined;
-}
-/**
- * What the user did to the filter state.
- */
-type FilterChangeReason = 
-/** A filter's state was set — selected values changed, include/exclude mode toggled, or filter cleared. */
-{
-    type: "FILTER_STATE_CHANGED";
-    filterKey: string;
-    newState: FilterState;
-}
-/** A filter was removed from the list. */
- | {
-    type: "FILTER_REMOVED";
-    filterKey: string;
-}
-/** Every filter was restored to the state it mounted with. */
- | {
-    type: "FILTER_LIST_RESET";
-}
-/** The list mounted, reporting the state it started with. */
- | {
-    type: "FILTER_LIST_INITIALIZED";
-};
-/**
- * The payload delivered to `onFilterListChanged`.
- */
-interface FilterChangeEvent<Q extends ObjectTypeDefinition> {
-    /** The filter state the change produced. */
-    snapshot: FilterChangeSnapshot<Q>;
-    /** What changed. */
-    reason: FilterChangeReason;
-}
-interface FilterListProps<Q extends ObjectTypeDefinition> {
-    /**
-     * The object type definition for the objects being filtered.
-     * Used for metadata resolution (property types, display names).
-     */
-    objectType: Q;
-    /**
-     * Optional object set to scope aggregation queries. When omitted,
-     * aggregations run against the full object type.
-     *
-     * Required for `HAS_LINK` and `LINKED_PROPERTY` filters to work.
-     */
-    objectSet?: ObjectSet<Q>;
-    /**
-     * The definition for all supported filter items in the list
-     * If not supplied, all filterable properties will be available
-     */
-    filterDefinitions?: Array<FilterDefinitionUnion<Q>>;
-    /**
-     * Seeds filter states from external storage, keyed by `getFilterKey`.
-     * Applied over the per-definition `defaultFilterState` seeds on mount, and
-     * FilterList owns the states from then on. Also the state the reset button
-     * restores to.
-     * Use `onFilterStateChanged` to persist changes back out.
-     *
-     * @default undefined (filters seed from their definitions alone)
-     */
-    defaultFilterStates?: Map<string, FilterState>;
-    /**
-     * @deprecated Rename to `defaultFilterStates`.
-     */
-    initialFilterStates?: Map<string, FilterState>;
-    /**
-     * Called on filter init and when filter state changes.
-     *
-     * @param event `snapshot` carries the filter state the change produced;
-     * `reason` carries what changed.
-     */
-    onFilterListChanged?: (event: FilterChangeEvent<Q>) => void;
-    /**
-     * Called whenever the filter clause changes. FilterList owns filter state;
-     * this is how you read it out, e.g. to feed an `ObjectTable`'s `filter`.
-     *
-     * `HAS_LINK` and `LINKED_PROPERTY` filters are not represented in the clause
-     * — use `onEffectiveObjectSet` for those.
-     *
-     * @param newClause The updated filter clause
-     * @deprecated Use `onFilterListChanged`, whose `snapshot` reports the clause
-     * alongside the filtered `ObjectSet`.
-     */
-    onFilterClauseChanged?: (newClause: WhereClause<Q>) => void;
-    /**
-     * Called when filter state changes
-     *
-     * @param definition The filter definition whose state changed
-     * @param newState The updated filter state
-     * @deprecated Use `onFilterListChanged`, which reports every set / clear / reset
-     * with an `event` describing what changed.
-     */
-    onFilterStateChanged?: (definition: FilterDefinitionUnion<Q>, newState: FilterState) => void;
-    /**
-     * Called with the filtered `ObjectSet` whenever filters change. Requires
-     * `objectSet` to be set. `HAS_LINK` and `LINKED_PROPERTY` filters apply only
-     * here, never through the filter clause.
-     *
-     * @deprecated Use `onFilterListChanged`, whose `snapshot.filteredObjectSet`
-     * reports the same filtered set alongside the clause.
-     */
-    onEffectiveObjectSet?: (objectSet: ObjectSet<Q>) => void;
-    /**
-     * Controls how filter visibility (add/remove) is managed.
-     *
-     * - `"uncontrolled"` (default): FilterList manages visibility internally.
-     *   An "Add filter" popover is rendered for filters with `isVisible: false`,
-     *   and each visible filter shows a remove button.
-     * - `"controlled"`: The consumer manages which filters are visible via
-     *   `filterDefinitions`. Filters with `isVisible: false` are excluded from
-     *   the rendered list.
-     *
-     * @default "uncontrolled"
-     * @deprecated Going away; visibility will always be managed internally.
-     * Seed it with `isVisible` on each `filterDefinitions` entry and observe
-     * changes with `onFilterVisibilityChange`.
-     */
-    addFilterMode?: "controlled" | "uncontrolled";
-    /**
-     * Custom render function for the "Add filter" button. Customizes the trigger
-     * element for the built-in add-filter popover; the popover behavior is
-     * handled automatically.
-     */
-    renderAddFilterButton?: () => React__default.ReactNode;
-    /**
-     * Called after a filter is shown from the built-in "Add filter" popover.
-     *
-     * @param filterKey The key of the added filter
-     * @param newDefinitions Deprecated. The `filterDefinitions` you passed in,
-     * unchanged — not the post-add state. Use `onFilterVisibilityChange`.
-     */
-    onFilterAdded?: (filterKey: string, 
-    /** @deprecated Use `onFilterVisibilityChange`. */
-    newDefinitions: Array<FilterDefinitionUnion<Q>>) => void;
-    /**
-     * Called after a filter's remove button is clicked, once the filter is
-     * hidden and its state cleared.
-     *
-     * @param filterKey The key of the removed filter
-     */
-    onFilterRemoved?: (filterKey: string) => void;
-    /**
-     * Enable drag-and-drop reordering of filters. When `true`, drag handles are
-     * rendered and filters can be reordered.
-     *
-     * Reorder state is managed internally; persist `onFilterVisibilityChange` to
-     * track order across remounts.
-     *
-     * @default false
-     */
-    enableSorting?: boolean;
-    /**
-     * Called when filter visibility or ordering changes, i.e. when filters are
-     * reordered, added or removed via the built-in show/remove controls, or
-     * reset.
-     *
-     * Visible filters come first, in display order, followed by the hidden ones.
-     * Persist this array and feed it back as the order and `isVisible` of
-     * `filterDefinitions` to make reordering survive a remount.
-     *
-     * @param newStates The filters in current display order with their visibility state
-     */
-    onFilterVisibilityChange?: (newStates: Array<{
-        filterKey: string;
-        isVisible: boolean;
-    }>) => void;
-    /**
-     * Whether the collapse/expand control is available. When `false` the panel is
-     * always expanded, no collapse control is rendered, and `collapsed` /
-     * `defaultCollapsed` are ignored.
-     * @default true
-     */
-    enableCollapse?: boolean;
-    /**
-     * Controlled mode. When supplied, this prop is the source of truth for
-     * whether the panel is collapsed and the component keeps no internal state;
-     * re-render with a new value in response to `onCollapsedChange`.
-     *
-     * If both `collapsed` and `defaultCollapsed` are provided, `collapsed` takes
-     * precedence. Ignored when `enableCollapse` is `false`.
-     */
-    collapsed?: boolean;
-    /**
-     * Uncontrolled mode. Seeds the panel's internal collapsed state; the
-     * component continues to own the state after mount, so later changes to this
-     * prop are ignored.
-     *
-     * If both `collapsed` and `defaultCollapsed` are provided, `collapsed` takes
-     * precedence. Ignored when `enableCollapse` is `false`.
-     * @default false
-     */
-    defaultCollapsed?: boolean;
-    /**
-     * Called whenever the collapsed state changes.
-     *
-     * @param collapsed The new collapsed state
-     */
-    onCollapsedChange?: (collapsed: boolean) => void;
-    /**
-     * Show reset filters button in header
-     */
-    showResetButton?: boolean;
-    /**
-     * Called when reset button is clicked
-     */
-    onReset?: () => void;
-    /**
-     * Optional title to display in the filter list header
-     */
-    title?: ReactNode;
-    /**
-     * Optional icon to display next to the title
-     */
-    titleIcon?: React__default.ReactNode;
-    /**
-     * Show count of active filters in header
-     */
-    showActiveFilterCount?: boolean;
-    /**
-     * When `true`, facets render greyed-out count=0 rows for values present in
-     * the unfiltered data but excluded by other active filters.
-     * @default false
-     */
-    showFilteredOutValues?: boolean;
-    /**
-     * Additional CSS class name
-     */
-    className?: string;
-}
-
-declare function FilterList$1<Q extends ObjectTypeDefinition>(props: FilterListProps<Q>): React__default.ReactElement;
-
-declare function serializeFilterStates(states: Map<string, FilterState>): string;
-declare function deserializeFilterStates(json: string): Map<string, FilterState>;
-
-interface FilterPopoverProps {
-    label: string;
-    /** Short summary of the current value; falls back to `placeholder` when empty. */
-    summary: string;
-    isActive: boolean;
-    onRemove?: () => void;
-    /** Popup contents — only mounted while the popover is open. */
-    children: React__default.ReactNode;
-    className?: string;
-    placeholder?: string;
-    /**
-     * Where the label sits relative to the trigger.
-     * - `"inline"` (default): label and trigger sit on one row.
-     * - `"top"`: label stacks above the trigger.
-     */
-    labelPlacement?: "inline" | "top";
-}
-declare const FilterPopover: React__default.NamedExoticComponent<FilterPopoverProps>;
-
-/**
- * Layout for the value list:
- * - `"dropdown"` (default): chips inline + portaled Combobox popup. Use when
- *   the input drives its own surface (e.g. standalone in a row).
- * - `"inline"`: search input + always-visible value list rendered in flow.
- *   Use when wrapping the input in your own popover so the values are
- *   immediately visible without an extra inner trigger.
- */
-type MultiSelectInputLayout = "dropdown" | "inline";
-
-interface FilterInputProps<Q extends ObjectTypeDefinition> {
-    objectType: Q;
-    objectSet?: ObjectSet<Q>;
-    definition: FilterDefinitionUnion<Q>;
-    filterState: FilterState | undefined;
-    onFilterStateChanged: (state: FilterState) => void;
-    /** Per-filter excluding-self where clause (direct filters only). */
-    whereClause: WhereClause<Q>;
-    /** Per-filter excluding-self linked-filter records. */
-    linkedFilters?: ReadonlyArray<LinkedFilter<Q>>;
-    showFilteredOutValues?: boolean;
-    searchQuery?: string;
-    excludeRowOpen?: boolean;
-    /**
-     * Layout for `MULTI_SELECT` filter components. Pass `"inline"` when this
-     * input renders inside a popover (or any container where chips would feel
-     * redundant) so the value list is always visible. Defaults to `"dropdown"`,
-     * which renders chips + a portaled Combobox popup. Ignored by other
-     * filter components.
-     */
-    layout?: MultiSelectInputLayout;
-}
-declare function FilterInputInner<Q extends ObjectTypeDefinition>({ objectType, objectSet, definition, filterState, onFilterStateChanged, whereClause, linkedFilters, showFilteredOutValues, searchQuery, excludeRowOpen, layout, }: FilterInputProps<Q>): React__default.ReactElement;
-declare const FilterInput: typeof FilterInputInner;
-
-interface UseFilterListStateResult<Q extends ObjectTypeDefinition> {
-    filterStates: Map<string, FilterState>;
-    setFilterState: (filterKey: string, state: FilterState) => void;
-    clearFilterState: (filterKey: string) => void;
-    /** Direct (non-link-traversing) filters combined into a `WhereClause<Q>`. */
-    whereClause: WhereClause<Q>;
-    /** Active HAS_LINK and LINKED_PROPERTY records */
-    linkedFilters: ReadonlyArray<LinkedFilter<Q>>;
-    /** Per-filter excluding-self where clauses keyed by `getFilterKey`. */
-    perFilterWhereClauses: Map<string, WhereClause<Q>>;
-    /** Per-filter excluding-self linked filters keyed by `getFilterKey`. */
-    perFilterLinkedFilters: Map<string, ReadonlyArray<LinkedFilter<Q>>>;
-    activeFilterCount: number;
-    hasChangesFromInitial: boolean;
-    reset: () => void;
-}
-declare function useFilterListState<Q extends ObjectTypeDefinition>(props: FilterListProps<Q>): UseFilterListStateResult<Q>;
-
-/**
- * Sentinel identity for the "No value" bucket (null/undefined property values).
- *
- * `selectedValues` is a `string[]`, so the null/undefined state needs a string
- * stand-in that cannot collide with a real value. Put `NO_VALUE` in `selectedValues`
- * to filter for objects whose property `$isNull`.
- */
-declare const NO_VALUE = "__NO_VALUE__";
-/** Check if a filter state has an active (non-empty) value. */
-declare function filterHasActiveState(state: FilterState | undefined): boolean;
-
-declare function getFilterKey<Q extends ObjectTypeDefinition>(definition: FilterDefinitionUnion<Q>): string;
-
-declare function getFilterLabel<Q extends ObjectTypeDefinition>(definition: FilterDefinitionUnion<Q>): string;
-
-/** Short summary of a filter's current value for rendering inside a `FilterPopover` trigger. */
-declare function summarizeFilterValue<Q extends ObjectTypeDefinition>(definition: FilterDefinitionUnion<Q>, state: FilterState | undefined): string;
-
-declare function narrowObjectSet<Q extends ObjectTypeDefinition>(objectSet: ObjectSet<Q>, whereClause: WhereClause<Q>, linkedFilters: ReadonlyArray<LinkedFilter<Q>>): ObjectSet<Q>;
-
+import * as Api from '@osdk/api';
+import { B as BaseFilterList$1, F as FilterDefinitionControls$1, a as BaseFilterListProps$1, b as FilterChangeEvent$1, c as FilterChangeReason$1, d as FilterChangeSnapshot$1, e as FilterComponentType$1, f as FilterDefinitionUnion$1, g as FilterInput$1, h as FilterInputProps$1, i as FilterList$1, j as FilterListProps$1, k as FilterPopover$1, l as FilterPopoverProps$1, m as FilterState$1, L as LinkedFilter$1, N as NO_VALUE$1, V as ValidComponentsForPropertyType, P as PropertyTypeFromKey, n as PropertyFilterDefinition$1, R as RenderFilterInput$1, U as UseFilterListStateResult$1, o as deserializeFilterStates$1, p as filterHasActiveState$1, q as getFilterKey$1, r as getFilterLabel$1, s as narrowObjectSet$1, t as serializeFilterStates$1, u as summarizeFilterValue$1, v as useFilterListState$1 } from '../../filter-list-CraygbR8.cjs';
+import 'react';
+
+/** @deprecated Import from `@osdk/react-components/filter-list` instead. */
+declare const BaseFilterList: typeof BaseFilterList$1;
+/** @deprecated Import from `@osdk/react-components/filter-list` instead. */
+type BaseFilterListProps<D extends FilterDefinitionControls$1> = BaseFilterListProps$1<D>;
+/** @deprecated Import from `@osdk/react-components/filter-list` instead. */
+type RenderFilterInput<D> = RenderFilterInput$1<D>;
+/** @deprecated Import from `@osdk/react-components/filter-list` instead. */
 declare const FilterList: typeof FilterList$1;
+/** @deprecated Import from `@osdk/react-components/filter-list` instead. */
+type FilterChangeEvent<Q extends Api.ObjectTypeDefinition> = FilterChangeEvent$1<Q>;
+/** @deprecated Import from `@osdk/react-components/filter-list` instead. */
+type FilterChangeReason = FilterChangeReason$1;
+/** @deprecated Import from `@osdk/react-components/filter-list` instead. */
+type FilterChangeSnapshot<Q extends Api.ObjectTypeDefinition> = FilterChangeSnapshot$1<Q>;
+/** @deprecated Import from `@osdk/react-components/filter-list` instead. */
+type FilterDefinitionUnion<Q extends Api.ObjectTypeDefinition> = FilterDefinitionUnion$1<Q>;
+/** @deprecated Import from `@osdk/react-components/filter-list` instead. */
+type FilterListProps<Q extends Api.ObjectTypeDefinition> = FilterListProps$1<Q>;
+/** @deprecated Import from `@osdk/react-components/filter-list` instead. */
+type FilterComponentType = FilterComponentType$1;
+/** @deprecated Import from `@osdk/react-components/filter-list` instead. */
+type FilterDefinitionControls = FilterDefinitionControls$1;
+/** @deprecated Import from `@osdk/react-components/filter-list` instead. */
+type FilterState = FilterState$1;
+/** @deprecated Import from `@osdk/react-components/filter-list` instead. */
+type PropertyFilterDefinition<Q extends Api.ObjectTypeDefinition, K extends Api.PropertyKeys<Q> = Api.PropertyKeys<Q>, C extends ValidComponentsForPropertyType<PropertyTypeFromKey<Q, K>> = ValidComponentsForPropertyType<PropertyTypeFromKey<Q, K>>> = PropertyFilterDefinition$1<Q, K, C>;
+/** @deprecated Import from `@osdk/react-components/filter-list` instead. */
+declare const deserializeFilterStates: typeof deserializeFilterStates$1;
+/** @deprecated Import from `@osdk/react-components/filter-list` instead. */
+declare const serializeFilterStates: typeof serializeFilterStates$1;
+/** @deprecated Import from `@osdk/react-components/filter-list` instead. */
+declare const FilterPopover: typeof FilterPopover$1;
+/** @deprecated Import from `@osdk/react-components/filter-list` instead. */
+type FilterPopoverProps = FilterPopoverProps$1;
+/** @deprecated Import from `@osdk/react-components/filter-list` instead. */
+declare const FilterInput: typeof FilterInput$1;
+/** @deprecated Import from `@osdk/react-components/filter-list` instead. */
+type FilterInputProps<Q extends Api.ObjectTypeDefinition> = FilterInputProps$1<Q>;
+/** @deprecated Import from `@osdk/react-components/filter-list` instead. */
+declare const useFilterListState: typeof useFilterListState$1;
+/** @deprecated Import from `@osdk/react-components/filter-list` instead. */
+type UseFilterListStateResult<Q extends Api.ObjectTypeDefinition> = UseFilterListStateResult$1<Q>;
+/** @deprecated Import from `@osdk/react-components/filter-list` instead. */
+declare const filterHasActiveState: typeof filterHasActiveState$1;
+/** @deprecated Import from `@osdk/react-components/filter-list` instead. */
+declare const NO_VALUE: typeof NO_VALUE$1;
+/** @deprecated Import from `@osdk/react-components/filter-list` instead. */
+declare const getFilterKey: typeof getFilterKey$1;
+/** @deprecated Import from `@osdk/react-components/filter-list` instead. */
+declare const getFilterLabel: typeof getFilterLabel$1;
+/** @deprecated Import from `@osdk/react-components/filter-list` instead. */
+declare const summarizeFilterValue: typeof summarizeFilterValue$1;
+/** @deprecated Import from `@osdk/react-components/filter-list` instead. */
+type LinkedFilter<Q extends Api.ObjectTypeDefinition> = LinkedFilter$1<Q>;
+/** @deprecated Import from `@osdk/react-components/filter-list` instead. */
+declare const narrowObjectSet: typeof narrowObjectSet$1;
 
 export { BaseFilterList, type BaseFilterListProps, type FilterChangeEvent, type FilterChangeReason, type FilterChangeSnapshot, type FilterComponentType, type FilterDefinitionControls, type FilterDefinitionUnion, FilterInput, type FilterInputProps, FilterList, type FilterListProps, FilterPopover, type FilterPopoverProps, type FilterState, type LinkedFilter, NO_VALUE, type PropertyFilterDefinition, type RenderFilterInput, type UseFilterListStateResult, deserializeFilterStates, filterHasActiveState, getFilterKey, getFilterLabel, narrowObjectSet, serializeFilterStates, summarizeFilterValue, useFilterListState };