@osdk/react-components 0.19.0 → 0.19.1-beta.0

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

@@ -1,5 +1,18 @@
-import type { LinkedType, LinkNames, ObjectTypeDefinition, PropertyKeys } from "@osdk/api";
-import type { BaseFilterState, FilterState, FilterStateByComponentType, PropertyTypeFromKey, ValidComponentsForPropertyType } from "../FilterListItemApi.js";
+import type { LinkedType, LinkNames, ObjectTypeDefinition, PropertyKeys, WhereClause } from "@osdk/api";
+import type { ReactNode } from "react";
+import type { BaseFilterState, FilterDefinitionControls, FilterState, FilterStateByComponentType, PropertyTypeFromKey, ValidComponentsForPropertyType } from "../FilterListItemApi.js";
+/**
+* Runtime representation of an active linked-property filter. Each entry
+* binds a `linkName` to its `reverseLinkName` and an `innerWhere` typed
+* against the linked object type, so `narrowObjectSet` can pivot type-safely.
+*/
+export type LinkedFilter<Q extends ObjectTypeDefinition> = { [L in LinkNames<Q>] : {
+	linkName: L
+	reverseLinkName: LinkNames<LinkedType<Q, L>>
+	innerWhere: WhereClause<LinkedType<Q, L>>
+} }[LinkNames<Q>];
+/** Shared empty default for `LinkedFilter` arrays — avoids new-array-per-render. */
+export declare const EMPTY_LINKED_FILTERS: readonly never[];
 /**
 * State for "has link" filter
 */
@@ -22,7 +35,7 @@ export interface LinkedPropertyFilterState<S extends FilterState = FilterState>
 export interface HasLinkFilterDefinition<
 	Q extends ObjectTypeDefinition,
 	L extends LinkNames<Q> = LinkNames<Q>
-> {
+> extends FilterDefinitionControls {
 	type: "HAS_LINK";
 	/**
 	* Optional unique identifier for stable keying across filter reorders.
@@ -48,13 +61,22 @@ export interface LinkedPropertyFilterDefinition<
 	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";
 	/**
 	* Optional unique identifier for stable keying across filter reorders.
 	*/
 	id?: string;
 	linkName: L;
+	/**
+	* Set this to make the filter narrow `objectSet`; the result is emitted
+	* via `onEffectiveObjectSet`. The value names the link on the linked
+	* object type that points back to `Q` (the inverse of `linkName`).
+	*
+	* Leave unset to keep the filter UI-only. It still renders and fires
+	* `onFilterStateChanged`, but FilterList won't narrow on it.
+	*/
+	reverseLinkName?: LinkNames<LinkedQ>;
 	linkedPropertyKey: LinkedK;
 	linkedFilterComponent: LinkedC;
 	linkedFilterState: FilterStateByComponentType[LinkedC];
@@ -68,6 +90,14 @@ export interface LinkedPropertyFilterDefinition<
 	*/
 	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;
+	/**
 	* Controls whether this filter is rendered.
 	* When false, the filter is hidden but its state is preserved.
 	* @default true

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

@@ -1 +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;;;;;;CAOA;;;;;;CAOA;AACD","names":[],"sources":["../../../../src/filter-list/types/LinkedFilterTypes.ts"],"version":3,"file":"LinkedFilterTypes.d.ts"}
+{"mappings":"AAgBA,cACE,YACA,WACA,sBACA,cACA,mBACK,WAAY;AACnB,cAAc,iBAAiB,OAAQ;AACvC,cACE,iBACA,0BACA,aACA,4BACA,qBACA,sCACK,yBAA0B;;;;;;AAOjC,YAAY,aAAa,UAAU,2BAChC,KAAK,UAAU,MAAK;CACnB,UAAU;CACV,iBAAiB,UAAU,WAAW,GAAG;CACzC,YAAY,YAAY,WAAW,GAAG;AACvC,IACD,UAAU;;AAGZ,OAAO,cAAMA;;;;AAKb,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;UAC3B,yBAAyB;CACjC,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;UACxD,yBAAyB;CACjC,MAAM;;;;CAIN;CACA,UAAU;;;;;;;;;CASV,kBAAkB,UAAU;CAC5B,mBAAmB;CACnB,uBAAuB;CACvB,mBAAmB,2BAA2B;CAC9C,2BAA2B,2BAA2B;CACtD,aAAa,0BAA0B,2BAA2B;CAClE;;;;;;CAOA;;;;;;;;CASA,eAAeC,kBAAkB;;;;;;CAOjC;AACD","names":["EMPTY_LINKED_FILTERS: readonly never[]","value: string"],"sources":["../../../../src/filter-list/types/LinkedFilterTypes.ts"],"version":3,"file":"LinkedFilterTypes.d.ts"}

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

@@ -1,6 +1,6 @@
 import type { ObjectTypeDefinition, WhereClause } from "@osdk/api";
 import type { ReactNode } from "react";
-import type { FilterState, FilterStateByComponentType } from "../FilterListItemApi.js";
+import type { FilterDefinitionControls, FilterState, FilterStateByComponentType } from "../FilterListItemApi.js";
 /**
 * Component types that support static values.
 * These components can display a fixed list of string values without OSDK aggregation.
@@ -14,7 +14,7 @@ export type StaticValuesComponentType = "LISTOGRAM" | "SINGLE_SELECT" | "MULTI_S
 export interface StaticValuesFilterDefinition<
 	Q extends ObjectTypeDefinition,
 	C extends StaticValuesComponentType = StaticValuesComponentType
-> {
+> extends FilterDefinitionControls {
 	type: "STATIC_VALUES";
 	/**
 	* Optional unique identifier for stable keying across filter reorders.

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

@@ -1 +1 @@
-{"mappings":"AAgBA,cAAc,sBAAsB,mBAAmB,WAAY;AACnE,cAAc,iBAAiB,OAAQ;AACvC,cACE,aACA,kCACK,yBAA0B;;;;;AAMjC,YAAY,4BACR,cACA,kBACA,iBACA;;;;;;AAOJ,iBAAiB;CACf,UAAU;CACV,UAAU,4BAA4B;EACtC;CACA,MAAM;;;;;CAMN;;;;;;CAOA;;;;CAKA;;;;CAKA,iBAAiB;;;;CAKjB,aAAa,2BAA2B;;;;;CAMxC;;;;;;;;CASA,eAAeA,kBAAkB;;;;;;CAOjC;;;;;CAMA,WAAW;;;;;CAMX,kBAAkB;EAChB,cAAc,SAAS,UAAU;;;;;EAKjC;CACD;;;;;;CAOD,iBAAiBC,OAAO,gBAAgB,YAAY;;;;;;CAOpD;AACD","names":["value: string","state: FilterState"],"sources":["../../../../src/filter-list/types/StaticValuesTypes.ts"],"version":3,"file":"StaticValuesTypes.d.ts"}
+{"mappings":"AAgBA,cAAc,sBAAsB,mBAAmB,WAAY;AACnE,cAAc,iBAAiB,OAAQ;AACvC,cACE,0BACA,aACA,kCACK,yBAA0B;;;;;AAMjC,YAAY,4BACR,cACA,kBACA,iBACA;;;;;;AAOJ,iBAAiB;CACf,UAAU;CACV,UAAU,4BAA4B;UAC9B,yBAAyB;CACjC,MAAM;;;;;CAMN;;;;;;CAOA;;;;CAKA;;;;CAKA,iBAAiB;;;;CAKjB,aAAa,2BAA2B;;;;;CAMxC;;;;;;;;CASA,eAAeA,kBAAkB;;;;;;CAOjC;;;;;CAMA,WAAW;;;;;CAMX,kBAAkB;EAChB,cAAc,SAAS,UAAU;;;;;EAKjC;CACD;;;;;;CAOD,iBAAiBC,OAAO,gBAAgB,YAAY;;;;;;CAOpD;AACD","names":["value: string","state: FilterState"],"sources":["../../../../src/filter-list/types/StaticValuesTypes.ts"],"version":3,"file":"StaticValuesTypes.d.ts"}

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

@@ -1,8 +1,31 @@
-import type { ObjectTypeDefinition, WhereClause } from "@osdk/api";
+import type { LinkedType, LinkNames, ObjectTypeDefinition, WhereClause } from "@osdk/api";
 import type { FilterDefinitionUnion } from "../FilterListApi.js";
 import type { FilterState } from "../FilterListItemApi.js";
+import type { LinkedFilter, LinkedPropertyFilterDefinition, LinkedPropertyFilterState } from "../types/LinkedFilterTypes.js";
+/**
+* Builds a WHERE clause fragment for a single property key from filter state.
+*/
+export declare function buildPropertyKeyClause(key: string | number | symbol, state: FilterState, propertyType?: string): Record<string, unknown> | undefined;
 export interface PropertyTypeInfo {
 	type: string;
 	multiplicity: boolean;
 }
+/**
+* Builds a `WhereClause<Q>` from direct (non-link-traversing) filter
+* definitions and current states. LINKED_PROPERTY filters are excluded —
+* use `getActiveLinkedFilters` for those and apply via `narrowObjectSet`.
+*/
 export declare function buildWhereClause<Q extends ObjectTypeDefinition>(definitions: Array<FilterDefinitionUnion<Q>> | undefined, filterStates: Map<string, FilterState>, propertyTypes?: Map<string, PropertyTypeInfo>, excludeFilterKey?: string): WhereClause<Q>;
+/**
+* Builds the inner `WhereClause` for a linked-property filter, typed against
+* the linked object type. Returns `undefined` when the state doesn't yield a
+* predicate (e.g. empty selection).
+*/
+export declare function buildLinkedInnerWhere<
+	Q extends ObjectTypeDefinition,
+	L extends LinkNames<Q>
+>(definition: LinkedPropertyFilterDefinition<Q, L>, state: LinkedPropertyFilterState): WhereClause<LinkedType<Q, L>> | undefined;
+/**
+* Returns the active LINKED_PROPERTY filters as `LinkedFilter<Q>` records.
+*/
+export declare function getActiveLinkedFilters<Q extends ObjectTypeDefinition>(definitions: Array<FilterDefinitionUnion<Q>> | undefined, filterStates: Map<string, FilterState>, excludeFilterKey?: string): Array<LinkedFilter<Q>>;

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

@@ -1 +1 @@
-{"mappings":"AAgBA,cAAc,sBAAsB,mBAAmB,WAAY;AAGnE,cAAc,6BAA6B,qBAAsB;AACjE,cAAc,mBAAmB,yBAA0B;AAsO3D,iBAAiB,iBAAiB;CAChC;CACA;AACD;AAED,OAAO,iBAAS,iBAAiB,UAAU,sBACzCA,aAAa,MAAM,sBAAsB,iBACzCC,cAAc,YAAY,cAC1BC,gBAAgB,YAAY,mBAC5BC,4BACC,YAAY","names":["definitions: Array<FilterDefinitionUnion<Q>> | undefined","filterStates: Map<string, FilterState>","propertyTypes?: Map<string, PropertyTypeInfo>","excludeFilterKey?: string"],"sources":["../../../../src/filter-list/utils/filterStateToWhereClause.ts"],"version":3,"file":"filterStateToWhereClause.d.ts"}
+{"mappings":"AAgBA,cACE,YACA,WACA,sBACA,mBACK,WAAY;AAGnB,cAAc,6BAA6B,qBAAsB;AACjE,cAAc,mBAAmB,yBAA0B;AAC3D,cACE,cACA,gCACA,iCACK,+BAAgC;;;;AA4LvC,OAAO,iBAAS,uBACdA,+BACAC,OAAO,aACPC,wBACC;AAyBH,iBAAiB,iBAAiB;CAChC;CACA;AACD;;;;;;AAOD,OAAO,iBAAS,iBAAiB,UAAU,sBACzCC,aAAa,MAAM,sBAAsB,iBACzCC,cAAc,YAAY,cAC1BC,gBAAgB,YAAY,mBAC5BC,4BACC,YAAY;;;;;;AAgLf,OAAO,iBAAS;CACd,UAAU;CACV,UAAU,UAAU;EAEpBC,YAAY,+BAA+B,GAAG,IAC9CC,OAAO,4BACN,YAAY,WAAW,GAAG;;;;AAc7B,OAAO,iBAAS,uBAAuB,UAAU,sBAC/CL,aAAa,MAAM,sBAAsB,iBACzCC,cAAc,YAAY,cAC1BE,4BACC,MAAM,aAAa","names":["key: string | number | symbol","state: FilterState","propertyType?: string","definitions: Array<FilterDefinitionUnion<Q>> | undefined","filterStates: Map<string, FilterState>","propertyTypes?: Map<string, PropertyTypeInfo>","excludeFilterKey?: string","definition: LinkedPropertyFilterDefinition<Q, L>","state: LinkedPropertyFilterState"],"sources":["../../../../src/filter-list/utils/filterStateToWhereClause.ts"],"version":3,"file":"filterStateToWhereClause.d.ts"}

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

@@ -1,5 +1,11 @@
 import type { FilterState } from "../FilterListItemApi.js";
 import type { PropertyAggregationValue } from "../types/AggregationTypes.js";
+/**
+* Unwraps a `linkedProperty` wrapper one level so callers can reason about the
+* underlying filter state directly (e.g. for header controls that should
+* follow the inner filter's capabilities).
+*/
+export declare function getEffectiveFilterState(state: FilterState | undefined): FilterState | undefined;
 /** Returns true for filter state types that support in-filter search. */
 export declare function supportsSearch(state: FilterState | undefined): boolean;
 /** Returns true for filter state types that support isExcluding. */
@@ -22,5 +28,25 @@ export declare function isEmptyValue(value: string | null | undefined): boolean;
 export declare function dedupeEmptyAggregationRows(values: PropertyAggregationValue[]): PropertyAggregationValue[];
 /** Case-insensitive substring filter for search functionality. */
 export declare function filterValuesBySearch<T>(values: T[], searchValue: string, getValue: (item: T) => string): T[];
+/**
+* Returns a "cleared" version of the given filter state, preserving the
+* discriminator and `isExcluding` flag so the UI doesn't snap between filter
+* modes when a user clicks "Clear all selections". Returns `undefined` if no
+* cleared form is meaningful for the state shape.
+*/
+export declare function clearFilterState(state: FilterState | undefined): FilterState | undefined;
+/**
+* Returns the state with `isExcluding` flipped, preserving the discriminator
+* and unwrapping/re-wrapping any `linkedProperty` wrapper. Returns `undefined`
+* if the wrapped state is one that does not support excluding.
+*/
+export declare function toggleIsExcluding(state: FilterState): FilterState | undefined;
+/**
+* Returns the number of values the user has actively selected for filters
+* whose UI surfaces a selected-of-total count (LISTOGRAM, SINGLE_SELECT,
+* MULTI_SELECT, TEXT_TAGS). Returns 0 for state shapes that don't have a
+* discrete list of selected values.
+*/
+export declare function getSelectedCount(state: FilterState | undefined): number;
 /** Check if a filter state has an active (non-empty) value. */
 export declare function filterHasActiveState(state: FilterState | undefined): boolean;

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

@@ -1 +1 @@
-{"mappings":"AAgBA,cAAc,mBAAmB,yBAA0B;AAC3D,cAAc,gCAAgC,8BAA+B;;AAG7E,OAAO,iBAAS,eAAeA,OAAO;;AA0BtC,OAAO,iBAAS,kBAAkBA,OAAO;;;;;;;;AAgCzC,OAAO,iBAAS,aAAaC;;;;;;;;AAW7B,OAAO,iBAAS,2BACdC,QAAQ,6BACP;;AAyBH,OAAO,iBAAS,qBAAqB,GACnCC,QAAQ,KACRC,qBACAC,WAAWC,MAAM,eAChB;;AAQH,OAAO,iBAAS,qBAAqBN,OAAO","names":["state: FilterState | undefined","value: string | null | undefined","values: PropertyAggregationValue[]","values: T[]","searchValue: string","getValue: (item: T) => string","item: T"],"sources":["../../../../src/filter-list/utils/filterValues.ts"],"version":3,"file":"filterValues.d.ts"}
+{"mappings":"AAgBA,cAAc,mBAAmB,yBAA0B;AAC3D,cAAc,gCAAgC,8BAA+B;;;;;;AAO7E,OAAO,iBAAS,wBACdA,OAAO,0BACN;;AAQH,OAAO,iBAAS,eAAeA,OAAO;;AA0BtC,OAAO,iBAAS,kBAAkBA,OAAO;;;;;;;;AAgCzC,OAAO,iBAAS,aAAaC;;;;;;;;AAW7B,OAAO,iBAAS,2BACdC,QAAQ,6BACP;;AAyBH,OAAO,iBAAS,qBAAqB,GACnCC,QAAQ,KACRC,qBACAC,WAAWC,MAAM,eAChB;;;;;;;AAeH,OAAO,iBAAS,iBACdN,OAAO,0BACN;;;;;;AA2EH,OAAO,iBAAS,kBACdO,OAAO,cACN;;;;;;;AAoBH,OAAO,iBAAS,iBAAiBP,OAAO;;AAcxC,OAAO,iBAAS,qBAAqBA,OAAO","names":["state: FilterState | undefined","value: string | null | undefined","values: PropertyAggregationValue[]","values: T[]","searchValue: string","getValue: (item: T) => string","item: T","state: FilterState"],"sources":["../../../../src/filter-list/utils/filterValues.ts"],"version":3,"file":"filterValues.d.ts"}

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

@@ -0,0 +1,7 @@
+import type { ObjectSet, ObjectTypeDefinition, WhereClause } from "@osdk/api";
+import type { LinkedFilter } from "../types/LinkedFilterTypes.js";
+export declare function narrowObjectSet<Q extends ObjectTypeDefinition>(objectSet: ObjectSet<Q>, whereClause: WhereClause<Q>, linkedFilters: ReadonlyArray<LinkedFilter<Q>>): ObjectSet<Q>;
+export declare function computeDualScopes<Q extends ObjectTypeDefinition>(objectSet: ObjectSet<Q> | undefined, whereClause: WhereClause<Q>, linkedFilters: ReadonlyArray<LinkedFilter<Q>>, showFilteredOutValues: boolean | undefined): {
+	scoped: ObjectSet<Q> | undefined
+	emptySource: ObjectSet<Q> | undefined
+};

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

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cAAc,WAAW,sBAAsB,mBAAmB,WAAY;AAC9E,cAAc,oBAAoB,+BAAgC;AAElE,OAAO,iBAAS,gBAAgB,UAAU,sBACxCA,WAAW,UAAU,IACrBC,aAAa,YAAY,IACzBC,eAAe,cAAc,aAAa,MACzC,UAAU;AAsBb,OAAO,iBAAS,kBAAkB,UAAU,sBAC1CC,WAAW,UAAU,gBACrBF,aAAa,YAAY,IACzBC,eAAe,cAAc,aAAa,KAC1CE,6CACC;CACD,QAAQ,UAAU;CAClB,aAAa,UAAU;AACxB","names":["objectSet: ObjectSet<Q>","whereClause: WhereClause<Q>","linkedFilters: ReadonlyArray<LinkedFilter<Q>>","objectSet: ObjectSet<Q> | undefined","showFilteredOutValues: boolean | undefined"],"sources":["../../../../src/filter-list/utils/narrowObjectSet.ts"],"version":3,"file":"narrowObjectSet.d.ts"}

package/build/types/public/experimental/filter-list.d.ts

@@ -3,7 +3,7 @@ export type { BaseFilterListProps, RenderFilterInput } from "../../filter-list/b
 import { FilterList as _FilterList } from "../../filter-list/FilterList.js";
 export declare const FilterList: typeof _FilterList;
 export type { FilterDefinitionUnion, FilterListProps } from "../../filter-list/FilterListApi.js";
-export type { FilterComponentType, FilterListItemProps, FilterState, PropertyFilterDefinition } from "../../filter-list/FilterListItemApi.js";
+export type { FilterComponentType, FilterDefinitionControls, FilterListItemProps, FilterState, PropertyFilterDefinition } from "../../filter-list/FilterListItemApi.js";
 export { deserializeFilterStates, serializeFilterStates } from "../../filter-list/utils/filterStateSerialization.js";
 export { FilterPopover } from "../../filter-list/base/FilterPopover.js";
 export type { FilterPopoverProps } from "../../filter-list/base/FilterPopover.js";
@@ -15,3 +15,5 @@ export { filterHasActiveState } from "../../filter-list/utils/filterValues.js";
 export { getFilterKey } from "../../filter-list/utils/getFilterKey.js";
 export { getFilterLabel } from "../../filter-list/utils/getFilterLabel.js";
 export { summarizeFilterValue } from "../../filter-list/utils/summarizeFilterValue.js";
+export type { LinkedFilter } from "../../filter-list/types/LinkedFilterTypes.js";
+export { narrowObjectSet } from "../../filter-list/utils/narrowObjectSet.js";

package/build/types/public/experimental/filter-list.d.ts.map

@@ -1 +1 @@
-{"mappings":"AAgBA,SAAS,sBAAsB;AAC/B,cACE,qBACA,yBACK;AACP,SAAS,cAAc,mBAAmB,iCAAkC;AAE5E,OAAO,cAAMA,mBAAmB;AAKhC,cACE,uBACA,uBACK;AACP,cACE,qBACA,qBACA,aACA,gCACK;AACP,SACE,yBACA,6BACK;AAEP,SAAS,qBAAqB;AAC9B,cAAc,0BAA0B;AAExC,SAAS,mBAAmB;AAC5B,cAAc,wBAAwB;AAEtC,SAAS,0BAA0B;AACnC,cAAc,gCAAgC;AAE9C,SAAS,4BAA4B;AACrC,SAAS,oBAAoB;AAC7B,SAAS,sBAAsB;AAC/B,SAAS,4BAA4B","names":["FilterList: typeof _FilterList"],"sources":["../../../../src/public/experimental/filter-list.ts"],"version":3,"file":"filter-list.d.ts"}
+{"mappings":"AAgBA,SAAS,sBAAsB;AAC/B,cACE,qBACA,yBACK;AACP,SAAS,cAAc,mBAAmB,iCAAkC;AAE5E,OAAO,cAAMA,mBAAmB;AAKhC,cACE,uBACA,uBACK;AACP,cACE,qBACA,0BACA,qBACA,aACA,gCACK;AACP,SACE,yBACA,6BACK;AAEP,SAAS,qBAAqB;AAC9B,cAAc,0BAA0B;AAExC,SAAS,mBAAmB;AAC5B,cAAc,wBAAwB;AAEtC,SAAS,0BAA0B;AACnC,cAAc,gCAAgC;AAE9C,SAAS,4BAA4B;AACrC,SAAS,oBAAoB;AAC7B,SAAS,sBAAsB;AAC/B,SAAS,4BAA4B;AAErC,cAAc,oBAAoB;AAClC,SAAS,uBAAuB","names":["FilterList: typeof _FilterList"],"sources":["../../../../src/public/experimental/filter-list.ts"],"version":3,"file":"filter-list.d.ts"}

package/docs/CSSVariables.md

@@ -875,23 +875,31 @@ Styling for filter list components including search, checkboxes, listogram, and
 
 #### Range Input Tokens
 
-| Variable                                         | Default Value                                                                | Description                 |
-| ------------------------------------------------ | ---------------------------------------------------------------------------- | --------------------------- |
-| `--osdk-filter-range-gap`                        | `calc(var(--osdk-surface-spacing) * 2.5)`                                    | Range gap                   |
-| `--osdk-filter-range-histogram-padding-bottom`   | `calc(var(--osdk-surface-spacing) * 1)`                                      | Histogram bottom padding    |
-| `--osdk-filter-range-histogram-padding-inline`   | `calc(var(--osdk-surface-spacing) * 2)`                                      | Histogram inline padding    |
-| `--osdk-filter-range-histogram-height`           | `calc(var(--osdk-surface-spacing) * 15)`                                     | Histogram height            |
-| `--osdk-filter-range-histogram-bar-gap`          | `calc(var(--osdk-surface-spacing) * 0.5)`                                    | Histogram bar gap           |
-| `--osdk-filter-range-histogram-bar-min-width`    | `var(--osdk-surface-spacing)`                                                | Histogram bar minimum width |
-| `--osdk-filter-range-histogram-bar-color`        | `var(--osdk-palette-gray-200)`                                               | Histogram bar color         |
-| `--osdk-filter-range-histogram-bar-active-color` | `var(--osdk-intent-primary-rest)`                                            | Histogram active bar color  |
-| `--osdk-filter-range-histogram-bar-transition`   | `var(--osdk-emphasis-transition-duration) var(--osdk-emphasis-ease-default)` | Histogram bar transition    |
-| `--osdk-filter-range-inputs-gap`                 | `calc(var(--osdk-surface-spacing) * 0.5)`                                    | Range inputs gap            |
-| `--osdk-filter-range-input-wrapper-gap`          | `var(--osdk-surface-spacing)`                                                | Input wrapper gap           |
-| `--osdk-filter-range-label-font-family`          | `var(--osdk-typography-family-default)`                                      | Range label font family     |
-| `--osdk-filter-range-label-font-size`            | `var(--osdk-typography-size-body-small)`                                     | Range label font size       |
-| `--osdk-filter-range-label-color`                | `var(--osdk-typography-color-muted)`                                         | Range label color           |
-| `--osdk-filter-range-separator-color`            | `var(--osdk-typography-color-muted)`                                         | Range separator color       |
+| Variable                                           | Default Value                                                                | Description                  |
+| -------------------------------------------------- | ---------------------------------------------------------------------------- | ---------------------------- |
+| `--osdk-filter-range-gap`                          | `calc(var(--osdk-surface-spacing) * 2.5)`                                    | Range gap                    |
+| `--osdk-filter-range-histogram-padding-bottom`     | `calc(var(--osdk-surface-spacing) * 1)`                                      | Histogram bottom padding     |
+| `--osdk-filter-range-histogram-padding-inline`     | `calc(var(--osdk-surface-spacing) * 2)`                                      | Histogram inline padding     |
+| `--osdk-filter-range-histogram-height`             | `calc(var(--osdk-surface-spacing) * 15)`                                     | Histogram height             |
+| `--osdk-filter-range-histogram-bar-gap`            | `calc(var(--osdk-surface-spacing) * 0.5)`                                    | Histogram bar gap            |
+| `--osdk-filter-range-histogram-bar-min-width`      | `var(--osdk-surface-spacing)`                                                | Histogram bar minimum width  |
+| `--osdk-filter-range-histogram-bar-color`          | `var(--osdk-palette-gray-200)`                                               | Histogram bar color          |
+| `--osdk-filter-range-histogram-bar-active-color`   | `var(--osdk-intent-primary-rest)`                                            | Histogram active bar color   |
+| `--osdk-filter-range-histogram-bar-transition`     | `var(--osdk-emphasis-transition-duration) var(--osdk-emphasis-ease-default)` | Histogram bar transition     |
+| `--osdk-filter-range-inputs-gap`                   | `calc(var(--osdk-surface-spacing) * 0.5)`                                    | Range inputs gap             |
+| `--osdk-filter-range-input-wrapper-gap`            | `var(--osdk-surface-spacing)`                                                | Input wrapper gap            |
+| `--osdk-filter-range-label-font-family`            | `var(--osdk-typography-family-default)`                                      | Range label font family      |
+| `--osdk-filter-range-label-font-size`              | `var(--osdk-typography-size-body-small)`                                     | Range label font size        |
+| `--osdk-filter-range-label-color`                  | `var(--osdk-typography-color-muted)`                                         | Range label color            |
+| `--osdk-filter-range-separator-color`              | `var(--osdk-typography-color-muted)`                                         | Range separator color        |
+| `--osdk-filter-range-clear-button-bg-hover`        | `var(--osdk-custom-color-gray-1)`                                            | Range clear button hover bg  |
+| `--osdk-filter-range-histogram-axis-color`         | `var(--osdk-typography-color-muted)`                                         | Histogram axis text color    |
+| `--osdk-filter-range-histogram-axis-font-size`     | `var(--osdk-typography-size-body-large)`                                     | Histogram axis font size     |
+| `--osdk-filter-range-histogram-axis-line-color`    | `var(--osdk-palette-gray-1)`                                                 | Histogram axis line color    |
+| `--osdk-filter-range-histogram-label-color`        | `var(--osdk-typography-color-muted)`                                         | Histogram label color        |
+| `--osdk-filter-range-histogram-label-font-size`    | `var(--osdk-typography-size-body-large)`                                     | Histogram label font size    |
+| `--osdk-filter-range-histogram-subtitle-color`     | `var(--osdk-typography-color-default-rest)`                                  | Histogram subtitle color     |
+| `--osdk-filter-range-histogram-subtitle-font-size` | `var(--osdk-typography-size-body-large)`                                     | Histogram subtitle font size |
 
 #### Timeline Input Tokens
 
@@ -980,6 +988,59 @@ Canonical "No value" styling used by the shared `NoValueLabel` component across
 | `--osdk-filter-skeleton-count-width`  | `calc(var(--osdk-surface-spacing) * 2.5)`  | Skeleton count width             |
 | `--osdk-filter-content-fade-duration` | `var(--osdk-emphasis-transition-duration)` | Content fade transition duration |
 
+#### Filtered-Out Item Tokens
+
+Styling for count=0 muted rows surfaced by `showFilteredOutValues`. Applied to listogram rows via `[data-filtered-out]` and to multi-select items via the `filteredOutItem` class.
+
+| Variable                                  | Default Value                        | Description                         |
+| ----------------------------------------- | ------------------------------------ | ----------------------------------- |
+| `--osdk-filter-filtered-out-item-opacity` | `0.5`                                | Opacity for filtered-out facet rows |
+| `--osdk-filter-filtered-out-item-color`   | `var(--osdk-typography-color-muted)` | Text color for filtered-out rows    |
+
+#### Filter Popover Tokens
+
+Used by the composable label + popover-trigger primitive that wraps single-select / multi-select dropdown filters.
+
+| Variable                                             | Default Value                                                                     | Description                                 |
+| ---------------------------------------------------- | --------------------------------------------------------------------------------- | ------------------------------------------- |
+| `--osdk-filter-popover-gap`                          | `calc(var(--osdk-surface-spacing) * 1)`                                           | Gap between label and trigger               |
+| `--osdk-filter-popover-stack-gap`                    | `calc(var(--osdk-surface-spacing) * 0.5)`                                         | Stack gap inside the trigger                |
+| `--osdk-filter-popover-label-font-family`            | `var(--osdk-typography-family-default)`                                           | Trigger label font family                   |
+| `--osdk-filter-popover-label-font-size`              | `var(--osdk-typography-size-body-small)`                                          | Trigger label font size                     |
+| `--osdk-filter-popover-label-color`                  | `var(--osdk-typography-color-muted)`                                              | Trigger label color                         |
+| `--osdk-filter-popover-trigger-width`                | `calc(var(--osdk-surface-spacing) * 40)`                                          | Trigger element width                       |
+| `--osdk-filter-popover-trigger-min-height`           | `calc(var(--osdk-surface-spacing) * 7)`                                           | Trigger element minimum height              |
+| `--osdk-filter-popover-trigger-padding`              | `0 calc(var(--osdk-surface-spacing) * 6) 0 calc(var(--osdk-surface-spacing) * 2)` | Trigger padding (right reserves remove btn) |
+| `--osdk-filter-popover-trigger-border-radius`        | `var(--osdk-surface-border-radius)`                                               | Trigger border radius                       |
+| `--osdk-filter-popover-trigger-border-width`         | `var(--osdk-surface-border-width)`                                                | Trigger border width                        |
+| `--osdk-filter-popover-trigger-border-color`         | `var(--osdk-surface-border-color-default)`                                        | Trigger border color (rest)                 |
+| `--osdk-filter-popover-trigger-border-color-hover`   | `var(--osdk-typography-color-muted)`                                              | Trigger border color on hover               |
+| `--osdk-filter-popover-trigger-border-color-active`  | `var(--osdk-intent-primary-rest)`                                                 | Trigger border color when open/active       |
+| `--osdk-filter-popover-trigger-bg`                   | `transparent`                                                                     | Trigger background                          |
+| `--osdk-filter-popover-trigger-color`                | `var(--osdk-typography-color-default-rest)`                                       | Trigger text color                          |
+| `--osdk-filter-popover-trigger-font-family`          | `var(--osdk-typography-family-default)`                                           | Trigger font family                         |
+| `--osdk-filter-popover-trigger-font-size`            | `var(--osdk-typography-size-body-medium)`                                         | Trigger font size                           |
+| `--osdk-filter-popover-trigger-transition`           | `var(--osdk-emphasis-transition-duration) var(--osdk-emphasis-ease-default)`      | Trigger transition                          |
+| `--osdk-filter-popover-trigger-focus-outline-width`  | `var(--osdk-emphasis-focus-width)`                                                | Trigger focus outline width                 |
+| `--osdk-filter-popover-trigger-focus-outline-color`  | `var(--osdk-emphasis-focus-color)`                                                | Trigger focus outline color                 |
+| `--osdk-filter-popover-trigger-focus-outline-offset` | `var(--osdk-emphasis-focus-offset)`                                               | Trigger focus outline offset                |
+| `--osdk-filter-popover-placeholder-color`            | `var(--osdk-typography-color-muted)`                                              | Trigger placeholder text color              |
+| `--osdk-filter-popover-remove-right`                 | `calc(var(--osdk-surface-spacing) * 0.75)`                                        | Remove-button right offset within trigger   |
+| `--osdk-filter-popover-remove-size`                  | `calc(var(--osdk-surface-spacing) * 4)`                                           | Remove button hit size                      |
+| `--osdk-filter-popover-remove-color`                 | `var(--osdk-typography-color-muted)`                                              | Remove button color (rest)                  |
+| `--osdk-filter-popover-remove-border-radius`         | `var(--osdk-surface-border-radius)`                                               | Remove button border radius                 |
+| `--osdk-filter-popover-remove-transition`            | `var(--osdk-emphasis-transition-duration) var(--osdk-emphasis-ease-default)`      | Remove button transition                    |
+| `--osdk-filter-popover-remove-color-hover`           | `var(--osdk-typography-color-default-rest)`                                       | Remove button hover color                   |
+| `--osdk-filter-popover-remove-bg-hover`              | `var(--osdk-custom-color-gray-1)`                                                 | Remove button hover background              |
+| `--osdk-filter-popover-popup-bg`                     | `var(--osdk-background-primary)`                                                  | Popup background                            |
+| `--osdk-filter-popover-popup-border`                 | `var(--osdk-surface-border)`                                                      | Popup border                                |
+| `--osdk-filter-popover-popup-border-radius`          | `var(--osdk-surface-border-radius)`                                               | Popup border radius                         |
+| `--osdk-filter-popover-popup-shadow`                 | `var(--osdk-surface-shadow-2)`                                                    | Popup shadow                                |
+| `--osdk-filter-popover-popup-padding`                | `calc(var(--osdk-surface-spacing) * 2)`                                           | Popup padding                               |
+| `--osdk-filter-popover-popup-min-width`              | `calc(var(--osdk-surface-spacing) * 70)`                                          | Popup minimum width                         |
+| `--osdk-filter-popover-popup-max-width`              | `calc(var(--osdk-surface-spacing) * 120)`                                         | Popup maximum width                         |
+| `--osdk-filter-popover-popup-z-index`                | `var(--osdk-surface-z-index-3)`                                                   | Popup stacking context                      |
+
 ### Form
 
 Styling for form components.

package/docs/FilterList.md

@@ -71,12 +71,13 @@ function EmployeeFilters() {
 
 ### Filter Management
 
-| Prop                    | Type                             | Default | Description                                                    |
-| ----------------------- | -------------------------------- | ------- | -------------------------------------------------------------- |
-| `filterClause`          | `WhereClause<Q>`                 | -       | Current where clause (controlled mode)                         |
-| `onFilterClauseChanged` | `(newClause) => void`            | -       | Called when filter clause changes. Required in controlled mode |
-| `onFilterStateChanged`  | `(definition, newState) => void` | -       | Called when any filter's state changes                         |
-| `initialFilterStates`   | `Map<string, FilterState>`       | -       | Initial states for hydrating from external storage             |
+| Prop                    | Type                             | Default | Description                                                                                                                                                               |
+| ----------------------- | -------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `filterClause`          | `WhereClause<Q>`                 | -       | Current where clause covering direct filters (controlled mode). LINKED_PROPERTY narrowing surfaces only through `onEffectiveObjectSet`.                                   |
+| `onFilterClauseChanged` | `(newClause) => void`            | -       | Called when the direct-filter where clause changes. Required in controlled mode.                                                                                          |
+| `onEffectiveObjectSet`  | `(objectSet) => void`            | -       | Observer invoked with the fully-narrowed `ObjectSet` (direct + linked filters applied) on every filter change. Requires `objectSet`. Use when LINKED filters are present. |
+| `onFilterStateChanged`  | `(definition, newState) => void` | -       | Called when any filter's state changes                                                                                                                                    |
+| `initialFilterStates`   | `Map<string, FilterState>`       | -       | Initial states for hydrating from external storage                                                                                                                        |
 
 ### UI Features
 
@@ -135,6 +136,51 @@ When using `type: "PROPERTY"`, the definition supports:
 | `displayMode`     | `"full" \| "count" \| "minimal"` | `"full"` | `full`: bar + count, `count`: count only, `minimal`: label only |
 | `maxVisibleItems` | `number`                         | `5`      | Number of items shown before "View all" link appears            |
 
+### Linked Property Filter Definition
+
+When using `type: "LINKED_PROPERTY"`, the definition supports:
+
+| Field                   | Type                            | Description                                                                                                                                                                                                                             |
+| ----------------------- | ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `linkName`              | `LinkNames<Q>`                  | Link on `Q` that traverses to the related object type                                                                                                                                                                                   |
+| `linkedPropertyKey`     | `PropertyKeys<LinkedQ>`         | Property on the linked type to filter by                                                                                                                                                                                                |
+| `linkedFilterComponent` | `FilterComponentType`           | Which UI component to render (see Filter Components table)                                                                                                                                                                              |
+| `linkedFilterState`     | `FilterState`                   | Initial state for the linked filter                                                                                                                                                                                                     |
+| `filterState`           | `LinkedPropertyFilterState`     | Wrapped filter state                                                                                                                                                                                                                    |
+| `reverseLinkName`       | `LinkNames<LinkedQ>` (optional) | **Opt-in for FilterList-managed narrowing.** When set, the linked filter narrows `objectSet` and emits via `onEffectiveObjectSet`. Names the link on the linked type that points back to `Q`. Omit to keep the filter as UI state only. |
+| `label`                 | `string`                        | Display label for the filter                                                                                                                                                                                                            |
+| `isVisible`             | `boolean`                       | Whether the filter is initially visible (default: `true`)                                                                                                                                                                               |
+
+#### Two modes for LINKED_PROPERTY
+
+**Auto-narrowing** — set `reverseLinkName`. FilterList composes `pivotTo(linkName).where(...).pivotTo(reverseLinkName)` and emits the narrowed set via `onEffectiveObjectSet`:
+
+```typescript
+{
+  type: "LINKED_PROPERTY",
+  linkName: "manager",          // Employee → Manager
+  reverseLinkName: "directReports", // Manager → Employee (back-link)
+  linkedPropertyKey: "fullName",
+  linkedFilterComponent: "MULTI_SELECT",
+  linkedFilterState: { type: "SELECT", selectedValues: [] },
+  filterState: { type: "linkedProperty", linkedFilterState: { type: "SELECT", selectedValues: [] } },
+}
+```
+
+**UI-only** — omit `reverseLinkName`. The filter still renders and fires `onFilterStateChanged`; downstream narrowing is up to the consumer:
+
+```typescript
+{
+  type: "LINKED_PROPERTY",
+  linkName: "manager",
+  // no reverseLinkName — FilterList won't narrow objectSet on this filter
+  linkedPropertyKey: "fullName",
+  linkedFilterComponent: "MULTI_SELECT",
+  linkedFilterState: { type: "SELECT", selectedValues: [] },
+  filterState: { type: "linkedProperty", linkedFilterState: { type: "SELECT", selectedValues: [] } },
+}
+```
+
 ### Filter Components
 
 When using `type: "PROPERTY"` or `type: "LINKED_PROPERTY"`, specify a `filterComponent`:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@osdk/react-components",
-  "version": "0.19.0",
+  "version": "0.19.1-beta.0",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -193,14 +193,14 @@
     "xlsx": "^0.18.5"
   },
   "peerDependencies": {
-    "@osdk/api": "^2.8.0",
-    "@osdk/client": "^2.8.0",
-    "@osdk/react": "^2.8.0",
+    "@osdk/api": ">=2.23.1-beta.0",
+    "@osdk/client": ">=2.23.1-beta.0",
+    "@osdk/react": ">=2.23.1-beta.0",
     "@types/react": "^17 || ^18 || ^19",
     "classnames": "^2.0.0",
     "react": "^17 || ^18 || ^19",
     "react-dom": "^17 || ^18 || ^19",
-    "@osdk/aip-core": "^0.4.0"
+    "@osdk/aip-core": "^0.4.1-beta.0"
   },
   "peerDependenciesMeta": {
     "@osdk/aip-core": {
@@ -219,12 +219,12 @@
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "typescript": "~5.5.4",
-    "@osdk/aip-core": "0.4.0",
-    "@osdk/api": "2.23.0",
-    "@osdk/client": "2.23.0",
+    "@osdk/aip-core": "0.4.1-beta.0",
+    "@osdk/api": "2.23.1-beta.2",
+    "@osdk/client": "2.23.1-beta.2",
     "@osdk/monorepo.api-extractor": "~0.7.0",
     "@osdk/monorepo.tsconfig": "~0.7.0",
-    "@osdk/react": "2.23.0"
+    "@osdk/react": "2.23.1-beta.2"
   },
   "publishConfig": {
     "access": "public"

package/build/cjs/chunk-3Y4W37E3.cjs

@@ -1,11 +0,0 @@
-'use strict';
-
-var chunkOUJQJQ7N_cjs = require('./chunk-OUJQJQ7N.cjs');
-var chunkBXCHISUQ_cjs = require('./chunk-BXCHISUQ.cjs');
-
-// src/public/experimental/xml-viewer.ts
-var XmlViewer2 = chunkBXCHISUQ_cjs.withOsdkMetrics(chunkOUJQJQ7N_cjs.XmlViewer, "XmlViewer");
-
-exports.XmlViewer = XmlViewer2;
-//# sourceMappingURL=chunk-3Y4W37E3.cjs.map
-//# sourceMappingURL=chunk-3Y4W37E3.cjs.map

package/build/cjs/chunk-62DGPKOC.cjs

@@ -1,11 +0,0 @@
-'use strict';
-
-var chunkVOROB7KJ_cjs = require('./chunk-VOROB7KJ.cjs');
-var chunkBXCHISUQ_cjs = require('./chunk-BXCHISUQ.cjs');
-
-// src/public/experimental/image-viewer.ts
-var ImageViewer2 = chunkBXCHISUQ_cjs.withOsdkMetrics(chunkVOROB7KJ_cjs.ImageViewer, "ImageViewer");
-
-exports.ImageViewer = ImageViewer2;
-//# sourceMappingURL=chunk-62DGPKOC.cjs.map
-//# sourceMappingURL=chunk-62DGPKOC.cjs.map

package/build/cjs/chunk-774FGQHO.cjs

@@ -1,11 +0,0 @@
-'use strict';
-
-var chunk4VJIPB7R_cjs = require('./chunk-4VJIPB7R.cjs');
-var chunkBXCHISUQ_cjs = require('./chunk-BXCHISUQ.cjs');
-
-// src/public/experimental/excel-viewer.ts
-var ExcelViewer2 = chunkBXCHISUQ_cjs.withOsdkMetrics(chunk4VJIPB7R_cjs.ExcelViewer, "ExcelViewer");
-
-exports.ExcelViewer = ExcelViewer2;
-//# sourceMappingURL=chunk-774FGQHO.cjs.map
-//# sourceMappingURL=chunk-774FGQHO.cjs.map