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

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

@@ -29,7 +29,7 @@ interface CustomFilterItemRendererProps<Q extends ObjectTypeDefinition, State ex
  * Filter definition for custom filters
  * Provides full control over rendering and filter logic
  */
-interface CustomFilterDefinition<Q extends ObjectTypeDefinition, State extends BaseFilterState = CustomFilterState> {
+interface CustomFilterDefinition<Q extends ObjectTypeDefinition, State extends BaseFilterState = CustomFilterState> extends FilterDefinitionControls {
     type: "CUSTOM";
     /**
      * Optional unique identifier for stable keying across filter reorders.
@@ -87,7 +87,7 @@ interface KeywordSearchFilterState extends BaseFilterState {
 /**
  * Filter definition for keyword search across string properties
  */
-interface KeywordSearchFilterDefinition<Q extends ObjectTypeDefinition, K extends StringPropertyKeys<Q> = StringPropertyKeys<Q>> {
+interface KeywordSearchFilterDefinition<Q extends ObjectTypeDefinition, K extends StringPropertyKeys<Q> = StringPropertyKeys<Q>> extends FilterDefinitionControls {
     type: "KEYWORD_SEARCH";
     /**
      * Optional unique identifier for stable keying across filter reorders.
@@ -119,6 +119,18 @@ interface KeywordSearchFilterDefinition<Q extends ObjectTypeDefinition, K extend
     isVisible?: boolean;
 }
 
+/**
+ * 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.
+ */
+type LinkedFilter<Q extends ObjectTypeDefinition> = {
+    [L in LinkNames<Q>]: {
+        linkName: L;
+        reverseLinkName: LinkNames<LinkedType<Q, L>>;
+        innerWhere: WhereClause<LinkedType<Q, L>>;
+    };
+}[LinkNames<Q>];
 /**
  * State for "has link" filter
  */
@@ -138,7 +150,7 @@ interface LinkedPropertyFilterState<S extends FilterState = FilterState> extends
  * Filter definition for "Has Link" filter
  * Filters objects based on whether they have any linked objects of the specified type
  */
-interface HasLinkFilterDefinition<Q extends ObjectTypeDefinition, L extends LinkNames<Q> = LinkNames<Q>> {
+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.
@@ -158,13 +170,22 @@ interface HasLinkFilterDefinition<Q extends ObjectTypeDefinition, L extends Link
 /**
  * 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>>> {
+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";
     /**
      * 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];
@@ -177,6 +198,14 @@ interface LinkedPropertyFilterDefinition<Q extends ObjectTypeDefinition, L exten
      * @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;
     /**
      * Controls whether this filter is rendered.
      * When false, the filter is hidden but its state is preserved.
@@ -189,6 +218,20 @@ interface LinkedPropertyFilterDefinition<Q extends ObjectTypeDefinition, L exten
  * 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"];
+/**
+ * Common mix-in for filter definitions: opt-out flag for the header search
+ * monocle.
+ */
+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;
+}
 /**
  * All available filter component types
  */
@@ -316,7 +359,7 @@ interface DateFormattingProps {
 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>>> {
+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
      */
@@ -427,7 +470,7 @@ type RenderFilterInput<D> = (props: {
     searchQuery?: string;
     excludeRowOpen?: boolean;
 }) => React__default.ReactNode;
-interface BaseFilterListProps<D> {
+interface BaseFilterListProps<D extends FilterDefinitionControls> {
     filterDefinitions?: Array<D>;
     filterStates: Map<string, FilterState>;
     onFilterStateChanged: (filterKey: string, state: FilterState) => void;
@@ -451,7 +494,7 @@ interface BaseFilterListProps<D> {
     renderAddFilterButton?: () => React__default.ReactNode;
 }
 
-declare function BaseFilterList<D>(props: BaseFilterListProps<D>): React__default.ReactElement;
+declare function BaseFilterList<D extends FilterDefinitionControls>(props: BaseFilterListProps<D>): React__default.ReactElement;
 
 /**
  * Component types that support static values.
@@ -463,7 +506,7 @@ type StaticValuesComponentType = "LISTOGRAM" | "SINGLE_SELECT" | "MULTI_SELECT"
  * 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> {
+interface StaticValuesFilterDefinition<Q extends ObjectTypeDefinition, C extends StaticValuesComponentType = StaticValuesComponentType> extends FilterDefinitionControls {
     type: "STATIC_VALUES";
     /**
      * Optional unique identifier for stable keying across filter reorders.
@@ -563,11 +606,23 @@ interface FilterListProps<Q extends ObjectTypeDefinition> {
      */
     objectType: Q;
     /**
-     * Optional object set to scope aggregation queries.
-     * When provided, filter aggregations (e.g. listogram counts) are scoped to this set.
-     * When omitted, aggregations run against the full object type.
+     * Optional object set to scope aggregation queries. When omitted,
+     * aggregations run against the full object type.
      */
     objectSet?: ObjectSet<Q>;
+    /**
+     * The current where clause to filter the objectSet.
+     * If provided, the filter clause is controlled.
+     * LINKED_PROPERTY filters are not included; use `onEffectiveObjectSet`.
+     */
+    filterClause?: WhereClause<Q>;
+    /**
+     * Called when the filter clause changes.
+     * Required in controlled mode.
+     *
+     * @param newClause The updated filter clause
+     */
+    onFilterClauseChanged?: (newClause: WhereClause<Q>) => void;
     /**
      * Optional title to display in the filter list header
      */
@@ -581,18 +636,6 @@ interface FilterListProps<Q extends ObjectTypeDefinition> {
      * If not supplied, all filterable properties will be available
      */
     filterDefinitions?: Array<FilterDefinitionUnion<Q>>;
-    /**
-     * The current where clause to filter the objectSet.
-     * If provided, the filter clause is controlled.
-     */
-    filterClause?: WhereClause<Q>;
-    /**
-     * Called when the filter clause changes.
-     * Required in controlled mode.
-     *
-     * @param newClause The updated filter clause
-     */
-    onFilterClauseChanged?: (newClause: WhereClause<Q>) => void;
     /**
      * Called when filter state changes
      *
@@ -600,6 +643,21 @@ interface FilterListProps<Q extends ObjectTypeDefinition> {
      * @param newState The updated filter state
      */
     onFilterStateChanged?: (definition: FilterDefinitionUnion<Q>, newState: FilterState) => void;
+    /**
+     * Called with the narrowed `ObjectSet` whenever filters change. Requires
+     * `objectSet` to be set.
+     *
+     * A linked filter only narrows the set when its definition has
+     * `reverseLinkName`. Linked filters without it are skipped here; read their
+     * state from `onFilterStateChanged` instead.
+     */
+    onEffectiveObjectSet?: (objectSet: ObjectSet<Q>) => void;
+    /**
+     * 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;
     /**
      * Controls how filter visibility (add/remove) is managed.
      *
@@ -731,7 +789,11 @@ interface FilterInputProps<Q extends ObjectTypeDefinition> {
     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;
     /**
@@ -743,15 +805,21 @@ interface FilterInputProps<Q extends ObjectTypeDefinition> {
      */
     layout?: MultiSelectInputLayout;
 }
-declare function FilterInputInner<Q extends ObjectTypeDefinition>({ objectType, objectSet, definition, filterState, onFilterStateChanged, whereClause, searchQuery, excludeRowOpen, layout, }: FilterInputProps<Q>): React__default.ReactElement;
+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 linked-property records; apply via `narrowObjectSet`. */
+    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;
     reset: () => void;
 }
@@ -767,6 +835,8 @@ declare function getFilterLabel<Q extends ObjectTypeDefinition>(definition: Filt
 /** 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>;
+
 declare const FilterList: typeof FilterList$1;
 
-export { BaseFilterList, type BaseFilterListProps, type FilterComponentType, type FilterDefinitionUnion, FilterInput, type FilterInputProps, FilterList, type FilterListItemProps, type FilterListProps, FilterPopover, type FilterPopoverProps, type FilterState, type PropertyFilterDefinition, type RenderFilterInput, type UseFilterListStateResult, deserializeFilterStates, filterHasActiveState, getFilterKey, getFilterLabel, serializeFilterStates, summarizeFilterValue, useFilterListState };
+export { BaseFilterList, type BaseFilterListProps, type FilterComponentType, type FilterDefinitionControls, type FilterDefinitionUnion, FilterInput, type FilterInputProps, FilterList, type FilterListItemProps, type FilterListProps, FilterPopover, type FilterPopoverProps, type FilterState, type LinkedFilter, type PropertyFilterDefinition, type RenderFilterInput, type UseFilterListStateResult, deserializeFilterStates, filterHasActiveState, getFilterKey, getFilterLabel, narrowObjectSet, serializeFilterStates, summarizeFilterValue, useFilterListState };

package/build/cjs/public/experimental/image-viewer.cjs

@@ -1,16 +1,16 @@
 'use strict';
 
-var chunk62DGPKOC_cjs = require('../../chunk-62DGPKOC.cjs');
+var chunkACIIYYEL_cjs = require('../../chunk-ACIIYYEL.cjs');
 var chunkVOROB7KJ_cjs = require('../../chunk-VOROB7KJ.cjs');
 require('../../chunk-MVQKV5BJ.cjs');
-require('../../chunk-BXCHISUQ.cjs');
+require('../../chunk-NOONKE5X.cjs');
 require('../../chunk-Q2W6GYRK.cjs');
 
 
 
 Object.defineProperty(exports, "ImageViewer", {
   enumerable: true,
-  get: function () { return chunk62DGPKOC_cjs.ImageViewer; }
+  get: function () { return chunkACIIYYEL_cjs.ImageViewer; }
 });
 Object.defineProperty(exports, "BaseImageViewer", {
   enumerable: true,

package/build/cjs/public/experimental/markdown-renderer.cjs

@@ -1,16 +1,16 @@
 'use strict';
 
-var chunkP7R4RWMU_cjs = require('../../chunk-P7R4RWMU.cjs');
+var chunk3RKGMRPD_cjs = require('../../chunk-3RKGMRPD.cjs');
 var chunkIYJOHKJE_cjs = require('../../chunk-IYJOHKJE.cjs');
 require('../../chunk-MVQKV5BJ.cjs');
-require('../../chunk-BXCHISUQ.cjs');
+require('../../chunk-NOONKE5X.cjs');
 require('../../chunk-Q2W6GYRK.cjs');
 
 
 
 Object.defineProperty(exports, "MarkdownViewerMedia", {
   enumerable: true,
-  get: function () { return chunkP7R4RWMU_cjs.MarkdownViewerMedia; }
+  get: function () { return chunk3RKGMRPD_cjs.MarkdownViewerMedia; }
 });
 Object.defineProperty(exports, "MarkdownRenderer", {
   enumerable: true,

package/build/cjs/public/experimental/object-table.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkL6QDNMMG_cjs = require('../../chunk-L6QDNMMG.cjs');
+var chunkK3IJA7WZ_cjs = require('../../chunk-K3IJA7WZ.cjs');
 require('../../chunk-POHAXPLQ.cjs');
 require('../../chunk-C6IPNPMZ.cjs');
 require('../../chunk-DWNKXV5E.cjs');
@@ -11,34 +11,34 @@ require('../../chunk-JBRNNWYC.cjs');
 require('../../chunk-HNBSGCSZ.cjs');
 require('../../chunk-7LXS66DW.cjs');
 require('../../chunk-MD4KDE44.cjs');
-require('../../chunk-BXCHISUQ.cjs');
+require('../../chunk-NOONKE5X.cjs');
 require('../../chunk-Q2W6GYRK.cjs');
 
 
 
 Object.defineProperty(exports, "BaseTable", {
   enumerable: true,
-  get: function () { return chunkL6QDNMMG_cjs.BaseTable; }
+  get: function () { return chunkK3IJA7WZ_cjs.BaseTable; }
 });
 Object.defineProperty(exports, "ColumnConfigDialog", {
   enumerable: true,
-  get: function () { return chunkL6QDNMMG_cjs.ColumnConfigDialog; }
+  get: function () { return chunkK3IJA7WZ_cjs.ColumnConfigDialog; }
 });
 Object.defineProperty(exports, "LoadingCell", {
   enumerable: true,
-  get: function () { return chunkL6QDNMMG_cjs.LoadingCell; }
+  get: function () { return chunkK3IJA7WZ_cjs.LoadingCell; }
 });
 Object.defineProperty(exports, "LoadingCellContent", {
   enumerable: true,
-  get: function () { return chunkL6QDNMMG_cjs.LoadingCellContent; }
+  get: function () { return chunkK3IJA7WZ_cjs.LoadingCellContent; }
 });
 Object.defineProperty(exports, "MultiColumnSortDialog", {
   enumerable: true,
-  get: function () { return chunkL6QDNMMG_cjs.MultiColumnSortDialog; }
+  get: function () { return chunkK3IJA7WZ_cjs.MultiColumnSortDialog; }
 });
 Object.defineProperty(exports, "ObjectTable", {
   enumerable: true,
-  get: function () { return chunkL6QDNMMG_cjs.ObjectTable; }
+  get: function () { return chunkK3IJA7WZ_cjs.ObjectTable; }
 });
 //# sourceMappingURL=object-table.cjs.map
 //# sourceMappingURL=object-table.cjs.map

package/build/cjs/public/experimental/pdf-viewer.cjs

@@ -1,31 +1,31 @@
 'use strict';
 
-var chunk6XRF4IAL_cjs = require('../../chunk-6XRF4IAL.cjs');
+var chunk2AK24MNP_cjs = require('../../chunk-2AK24MNP.cjs');
 var chunkETOC4FJE_cjs = require('../../chunk-ETOC4FJE.cjs');
-require('../../chunk-BXCHISUQ.cjs');
+require('../../chunk-NOONKE5X.cjs');
 require('../../chunk-Q2W6GYRK.cjs');
 
 
 
 Object.defineProperty(exports, "PdfViewer", {
   enumerable: true,
-  get: function () { return chunk6XRF4IAL_cjs.PdfViewer; }
+  get: function () { return chunk2AK24MNP_cjs.PdfViewer; }
 });
 Object.defineProperty(exports, "PdfViewerContent", {
   enumerable: true,
-  get: function () { return chunk6XRF4IAL_cjs.PdfViewerContent; }
+  get: function () { return chunk2AK24MNP_cjs.PdfViewerContent; }
 });
 Object.defineProperty(exports, "PdfViewerProvider", {
   enumerable: true,
-  get: function () { return chunk6XRF4IAL_cjs.PdfViewerProvider; }
+  get: function () { return chunk2AK24MNP_cjs.PdfViewerProvider; }
 });
 Object.defineProperty(exports, "usePdfViewerContext", {
   enumerable: true,
-  get: function () { return chunk6XRF4IAL_cjs.usePdfViewerContext; }
+  get: function () { return chunk2AK24MNP_cjs.usePdfViewerContext; }
 });
 Object.defineProperty(exports, "usePdfViewerInstance", {
   enumerable: true,
-  get: function () { return chunk6XRF4IAL_cjs.usePdfViewerInstance; }
+  get: function () { return chunk2AK24MNP_cjs.usePdfViewerInstance; }
 });
 Object.defineProperty(exports, "BasePdfViewer", {
   enumerable: true,

package/build/cjs/public/experimental/tiff-renderer.cjs

@@ -1,16 +1,16 @@
 'use strict';
 
-var chunk3OUALM3K_cjs = require('../../chunk-3OUALM3K.cjs');
+var chunkCOLGW56W_cjs = require('../../chunk-COLGW56W.cjs');
 var chunkIISDOJPR_cjs = require('../../chunk-IISDOJPR.cjs');
 require('../../chunk-MVQKV5BJ.cjs');
-require('../../chunk-BXCHISUQ.cjs');
+require('../../chunk-NOONKE5X.cjs');
 require('../../chunk-Q2W6GYRK.cjs');
 
 
 
 Object.defineProperty(exports, "TiffViewerMedia", {
   enumerable: true,
-  get: function () { return chunk3OUALM3K_cjs.TiffViewerMedia; }
+  get: function () { return chunkCOLGW56W_cjs.TiffViewerMedia; }
 });
 Object.defineProperty(exports, "TiffRenderer", {
   enumerable: true,

package/build/cjs/public/experimental/video-viewer.cjs

@@ -1,16 +1,16 @@
 'use strict';
 
-var chunkSLHKSOQC_cjs = require('../../chunk-SLHKSOQC.cjs');
+var chunkMHMRIDIM_cjs = require('../../chunk-MHMRIDIM.cjs');
 var chunkKHMOMROL_cjs = require('../../chunk-KHMOMROL.cjs');
 require('../../chunk-MVQKV5BJ.cjs');
-require('../../chunk-BXCHISUQ.cjs');
+require('../../chunk-NOONKE5X.cjs');
 require('../../chunk-Q2W6GYRK.cjs');
 
 
 
 Object.defineProperty(exports, "VideoViewer", {
   enumerable: true,
-  get: function () { return chunkSLHKSOQC_cjs.VideoViewer; }
+  get: function () { return chunkMHMRIDIM_cjs.VideoViewer; }
 });
 Object.defineProperty(exports, "BaseVideoViewer", {
   enumerable: true,

package/build/cjs/public/experimental/xml-viewer.cjs

@@ -1,16 +1,16 @@
 'use strict';
 
-var chunk3Y4W37E3_cjs = require('../../chunk-3Y4W37E3.cjs');
+var chunkOEESYGT4_cjs = require('../../chunk-OEESYGT4.cjs');
 var chunkOUJQJQ7N_cjs = require('../../chunk-OUJQJQ7N.cjs');
 require('../../chunk-MVQKV5BJ.cjs');
-require('../../chunk-BXCHISUQ.cjs');
+require('../../chunk-NOONKE5X.cjs');
 require('../../chunk-Q2W6GYRK.cjs');
 
 
 
 Object.defineProperty(exports, "XmlViewer", {
   enumerable: true,
-  get: function () { return chunk3Y4W37E3_cjs.XmlViewer; }
+  get: function () { return chunkOEESYGT4_cjs.XmlViewer; }
 });
 Object.defineProperty(exports, "BaseXmlViewer", {
   enumerable: true,