@osdk/react-components 0.1.0 → 0.2.0-beta.10

package/build/browser/filter-list/hooks/usePropertyAggregation.js

@@ -0,0 +1,92 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { useOsdkAggregation } from "@osdk/react/experimental";
+import { useMemo } from "react";
+export function usePropertyAggregation(objectType, propertyKey, options) {
+  // AggregateOpts requires specific property keys from Q, but we're dynamically
+  // using propertyKey. The cast is unavoidable for this dynamic filter pattern.
+  const aggregateOptions = useMemo(() => ({
+    $select: {
+      $count: "unordered"
+    },
+    $groupBy: {
+      [propertyKey]: {
+        $exact: {
+          $includeNullValue: true
+        }
+      }
+    }
+  }), [propertyKey]);
+  const {
+    data: countData,
+    isLoading,
+    error
+  } = useOsdkAggregation(objectType, {
+    aggregate: aggregateOptions,
+    where: options?.where
+  });
+  const result = useMemo(() => {
+    if (!countData) {
+      return {
+        data: [],
+        maxCount: 0
+      };
+    }
+    const values = [];
+    let maxCount = 0;
+
+    // The aggregation result type varies by query structure. Since we're building
+    // the query dynamically based on propertyKey, we cast to a known shape that
+    // matches the $groupBy + $count aggregation pattern.
+
+    for (const item of countData) {
+      const rawValue = item.$group[propertyKey];
+      const count = item.$count ?? 0;
+      if (rawValue == null) {
+        values.push({
+          value: "",
+          count,
+          isNull: true
+        });
+      } else {
+        values.push({
+          value: String(rawValue),
+          count
+        });
+      }
+      maxCount = Math.max(maxCount, count);
+    }
+    values.sort((a, b) => b.count - a.count);
+    if (options?.limit && values.length > options.limit) {
+      return {
+        data: values.slice(0, options.limit),
+        maxCount
+      };
+    }
+    return {
+      data: values,
+      maxCount
+    };
+  }, [countData, propertyKey, options?.limit]);
+  return {
+    data: result.data,
+    maxCount: result.maxCount,
+    isLoading,
+    error: error ?? null
+  };
+}
+//# sourceMappingURL=usePropertyAggregation.js.map

package/build/browser/filter-list/hooks/usePropertyAggregation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePropertyAggregation.js","names":["useOsdkAggregation","useMemo","usePropertyAggregation","objectType","propertyKey","options","aggregateOptions","$select","$count","$groupBy","$exact","$includeNullValue","data","countData","isLoading","error","aggregate","where","result","maxCount","values","item","rawValue","$group","count","push","value","isNull","String","Math","max","sort","a","b","limit","length","slice"],"sources":["usePropertyAggregation.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type {\n  AggregateOpts,\n  ObjectTypeDefinition,\n  PropertyKeys,\n  WhereClause,\n} from \"@osdk/api\";\nimport { useOsdkAggregation } from \"@osdk/react/experimental\";\nimport { useMemo } from \"react\";\nimport type { AggregationGroupResult } from \"../utils/aggregationHelpers.js\";\n\nexport interface PropertyAggregationValue {\n  value: string;\n  count: number;\n  isNull?: boolean;\n}\n\nexport interface UsePropertyAggregationResult {\n  data: PropertyAggregationValue[];\n  maxCount: number;\n  isLoading: boolean;\n  error: Error | null;\n}\n\nexport interface UsePropertyAggregationOptions<\n  Q extends ObjectTypeDefinition = ObjectTypeDefinition,\n> {\n  limit?: number;\n  where?: WhereClause<Q>;\n}\n\nexport function usePropertyAggregation<\n  Q extends ObjectTypeDefinition,\n  K extends PropertyKeys<Q>,\n>(\n  objectType: Q,\n  propertyKey: K,\n  options?: UsePropertyAggregationOptions<Q>,\n): UsePropertyAggregationResult {\n  // AggregateOpts requires specific property keys from Q, but we're dynamically\n  // using propertyKey. The cast is unavoidable for this dynamic filter pattern.\n  const aggregateOptions = useMemo(\n    () =>\n      ({\n        $select: { $count: \"unordered\" as const },\n        $groupBy: {\n          [propertyKey as string]: {\n            $exact: { $includeNullValue: true },\n          },\n        },\n      }) as AggregateOpts<Q>,\n    [propertyKey],\n  );\n\n  const { data: countData, isLoading, error } = useOsdkAggregation(objectType, {\n    aggregate: aggregateOptions,\n    where: options?.where,\n  });\n\n  const result = useMemo(\n    (): { data: PropertyAggregationValue[]; maxCount: number } => {\n      if (!countData) {\n        return { data: [], maxCount: 0 };\n      }\n\n      const values: PropertyAggregationValue[] = [];\n      let maxCount = 0;\n\n      // The aggregation result type varies by query structure. Since we're building\n      // the query dynamically based on propertyKey, we cast to a known shape that\n      // matches the $groupBy + $count aggregation pattern.\n      const dataArray = countData as AggregationGroupResult;\n\n      for (const item of dataArray) {\n        const rawValue = item.$group[propertyKey as string];\n        const count = item.$count ?? 0;\n\n        if (rawValue == null) {\n          values.push({ value: \"\", count, isNull: true });\n        } else {\n          values.push({ value: String(rawValue), count });\n        }\n        maxCount = Math.max(maxCount, count);\n      }\n\n      values.sort((a, b) => b.count - a.count);\n\n      if (options?.limit && values.length > options.limit) {\n        return { data: values.slice(0, options.limit), maxCount };\n      }\n\n      return { data: values, maxCount };\n    },\n    [countData, propertyKey, options?.limit],\n  );\n\n  return {\n    data: result.data,\n    maxCount: result.maxCount,\n    isLoading,\n    error: error ?? null,\n  };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAQA,SAASA,kBAAkB,QAAQ,0BAA0B;AAC7D,SAASC,OAAO,QAAQ,OAAO;AAuB/B,OAAO,SAASC,sBAAsBA,CAIpCC,UAAa,EACbC,WAAc,EACdC,OAA0C,EACZ;EAC9B;EACA;EACA,MAAMC,gBAAgB,GAAGL,OAAO,CAC9B,OACG;IACCM,OAAO,EAAE;MAAEC,MAAM,EAAE;IAAqB,CAAC;IACzCC,QAAQ,EAAE;MACR,CAACL,WAAW,GAAa;QACvBM,MAAM,EAAE;UAAEC,iBAAiB,EAAE;QAAK;MACpC;IACF;EACF,CAAC,CAAqB,EACxB,CAACP,WAAW,CACd,CAAC;EAED,MAAM;IAAEQ,IAAI,EAAEC,SAAS;IAAEC,SAAS;IAAEC;EAAM,CAAC,GAAGf,kBAAkB,CAACG,UAAU,EAAE;IAC3Ea,SAAS,EAAEV,gBAAgB;IAC3BW,KAAK,EAAEZ,OAAO,EAAEY;EAClB,CAAC,CAAC;EAEF,MAAMC,MAAM,GAAGjB,OAAO,CACpB,MAA8D;IAC5D,IAAI,CAACY,SAAS,EAAE;MACd,OAAO;QAAED,IAAI,EAAE,EAAE;QAAEO,QAAQ,EAAE;MAAE,CAAC;IAClC;IAEA,MAAMC,MAAkC,GAAG,EAAE;IAC7C,IAAID,QAAQ,GAAG,CAAC;;IAEhB;IACA;IACA;;IAGA,KAAK,MAAME,IAAI,IAFGR,SAAS,EAEG;MAC5B,MAAMS,QAAQ,GAAGD,IAAI,CAACE,MAAM,CAACnB,WAAW,CAAW;MACnD,MAAMoB,KAAK,GAAGH,IAAI,CAACb,MAAM,IAAI,CAAC;MAE9B,IAAIc,QAAQ,IAAI,IAAI,EAAE;QACpBF,MAAM,CAACK,IAAI,CAAC;UAAEC,KAAK,EAAE,EAAE;UAAEF,KAAK;UAAEG,MAAM,EAAE;QAAK,CAAC,CAAC;MACjD,CAAC,MAAM;QACLP,MAAM,CAACK,IAAI,CAAC;UAAEC,KAAK,EAAEE,MAAM,CAACN,QAAQ,CAAC;UAAEE;QAAM,CAAC,CAAC;MACjD;MACAL,QAAQ,GAAGU,IAAI,CAACC,GAAG,CAACX,QAAQ,EAAEK,KAAK,CAAC;IACtC;IAEAJ,MAAM,CAACW,IAAI,CAAC,CAACC,CAAC,EAAEC,CAAC,KAAKA,CAAC,CAACT,KAAK,GAAGQ,CAAC,CAACR,KAAK,CAAC;IAExC,IAAInB,OAAO,EAAE6B,KAAK,IAAId,MAAM,CAACe,MAAM,GAAG9B,OAAO,CAAC6B,KAAK,EAAE;MACnD,OAAO;QAAEtB,IAAI,EAAEQ,MAAM,CAACgB,KAAK,CAAC,CAAC,EAAE/B,OAAO,CAAC6B,KAAK,CAAC;QAAEf;MAAS,CAAC;IAC3D;IAEA,OAAO;MAAEP,IAAI,EAAEQ,MAAM;MAAED;IAAS,CAAC;EACnC,CAAC,EACD,CAACN,SAAS,EAAET,WAAW,EAAEC,OAAO,EAAE6B,KAAK,CACzC,CAAC;EAED,OAAO;IACLtB,IAAI,EAAEM,MAAM,CAACN,IAAI;IACjBO,QAAQ,EAAED,MAAM,CAACC,QAAQ;IACzBL,SAAS;IACTC,KAAK,EAAEA,KAAK,IAAI;EAClB,CAAC;AACH","ignoreList":[]}

package/build/browser/filter-list/types/AddFilterMenuTypes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=AddFilterMenuTypes.js.map

package/build/browser/filter-list/types/AddFilterMenuTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AddFilterMenuTypes.js","names":[],"sources":["AddFilterMenuTypes.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { ReactNode } from \"react\";\nimport type { FilterComponentType } from \"../FilterListItemApi.js\";\n\n/**\n * Visual data indicator configuration for filter items\n */\nexport type FilterDataIndicator = \"histogram\" | \"count\" | \"none\";\n\n/**\n * Category for organizing filters in the add filter menu\n */\nexport type FilterCategory =\n  | \"ALL_PROPERTIES\"\n  | \"SINGLE_PROPERTY\"\n  | \"LINKED_OBJECT\";\n\n/**\n * Template for a filter that can be added via the add filter menu\n */\nexport interface FilterTemplate {\n  /**\n   * Unique identifier for the template\n   */\n  id: string;\n\n  /**\n   * Display label for the filter\n   */\n  label: string;\n\n  /**\n   * Property key this filter applies to\n   */\n  key: string;\n\n  /**\n   * The type of filter component to use\n   */\n  filterComponent: FilterComponentType;\n\n  /**\n   * Icon to display next to the filter label.\n   * Can be a string (icon name) or a ReactNode for custom icons.\n   */\n  icon: string | ReactNode;\n\n  /**\n   * Type of data indicator to show (histogram, count, none)\n   */\n  dataIndicator?: FilterDataIndicator;\n\n  /**\n   * Whether to show a \"Select All\" option for checkbox lists\n   */\n  showSelectAll?: boolean;\n\n  /**\n   * Maximum number of visible items before scrolling\n   */\n  maxVisibleItems?: number;\n\n  /**\n   * Whether multiple instances of this filter can be added\n   */\n  allowMultiple: boolean;\n\n  /**\n   * Category for grouping in the add filter menu\n   */\n  category: FilterCategory;\n}\n"],"mappings":"","ignoreList":[]}

package/build/browser/filter-list/types/CustomRendererTypes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=CustomRendererTypes.js.map

package/build/browser/filter-list/types/CustomRendererTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CustomRendererTypes.js","names":[],"sources":["CustomRendererTypes.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { ObjectSet, ObjectTypeDefinition, WhereClause } from \"@osdk/api\";\nimport type { ReactNode } from \"react\";\nimport type { BaseFilterState } from \"../FilterListItemApi.js\";\n\n/**\n * State for custom filter\n */\nexport interface CustomFilterState<T = Record<string, unknown>>\n  extends BaseFilterState\n{\n  type: \"custom\";\n  customState: T;\n}\n\n/**\n * Props passed to custom filter input renderer\n */\nexport interface CustomFilterInputRendererProps<\n  Q extends ObjectTypeDefinition,\n  State extends BaseFilterState,\n> {\n  objectSet: ObjectSet<Q>;\n  filterState: State;\n  onFilterStateChanged: (newState: State) => void;\n}\n\n/**\n * Props passed to custom filter item renderer\n * Includes full item context in addition to input renderer props\n */\nexport interface CustomFilterItemRendererProps<\n  Q extends ObjectTypeDefinition,\n  State extends BaseFilterState,\n> extends CustomFilterInputRendererProps<Q, State> {\n  label: string;\n  onRemove?: () => void;\n}\n\n/**\n * Filter definition for custom filters\n * Provides full control over rendering and filter logic\n */\nexport interface CustomFilterDefinition<\n  Q extends ObjectTypeDefinition,\n  State extends BaseFilterState = CustomFilterState,\n> {\n  type: \"CUSTOM\";\n  /**\n   * Optional unique identifier for stable keying across filter reorders.\n   * If provided, takes precedence over `key` for state keying.\n   */\n  id?: string;\n  /**\n   * Unique key for this custom filter\n   */\n  key: string;\n  label?: string;\n  filterComponent: \"CUSTOM\";\n  filterState: State;\n  defaultFilterState?: State;\n  /**\n   * Render the input portion of the filter\n   * Used when rendering within a filter item wrapper\n   */\n  renderInput?: (\n    props: CustomFilterInputRendererProps<Q, State>,\n  ) => ReactNode;\n  /**\n   * Render the complete filter item\n   * Used when you need full control over the item appearance\n   */\n  renderItem?: (\n    props: CustomFilterItemRendererProps<Q, State>,\n  ) => ReactNode;\n  /**\n   * Convert filter state to a WhereClause for filtering\n   * Required for the filter to affect the object set\n   */\n  toWhereClause: (state: State) => WhereClause<Q> | undefined;\n  /**\n   * Controls whether this filter is rendered.\n   * When false, the filter is hidden but its state is preserved.\n   * @default true\n   */\n  isVisible?: boolean;\n}\n"],"mappings":"","ignoreList":[]}

package/build/browser/filter-list/types/FilterPanelTypes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=FilterPanelTypes.js.map

package/build/browser/filter-list/types/FilterPanelTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FilterPanelTypes.js","names":[],"sources":["FilterPanelTypes.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { ObjectTypeDefinition, WhereClause } from \"@osdk/api\";\nimport type { FilterState } from \"../FilterListItemApi.js\";\n\n/**\n * Filter states indexed by key (serializable to JSON)\n */\nexport type SerializableFilterStates = Record<string, FilterState>;\n\n/**\n * Persisted state for the filter list\n * Can be serialized and stored for session persistence\n *\n * Note: Only includes serializable data. Filter definitions are not persisted\n * because they may contain callback functions which cannot be serialized.\n */\nexport interface FilterListPersistedState<\n  Q extends ObjectTypeDefinition = ObjectTypeDefinition,\n> {\n  collapsed: boolean;\n  filterStatesByKey: SerializableFilterStates;\n  filterClause?: WhereClause<Q>;\n}\n"],"mappings":"","ignoreList":[]}

package/build/browser/filter-list/types/KeywordSearchTypes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=KeywordSearchTypes.js.map

package/build/browser/filter-list/types/KeywordSearchTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KeywordSearchTypes.js","names":[],"sources":["KeywordSearchTypes.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { ObjectTypeDefinition, PropertyKeys } from \"@osdk/api\";\nimport type { BaseFilterState } from \"../FilterListItemApi.js\";\n\n/**\n * Keys of string properties on an object type\n */\nexport type StringPropertyKeys<Q extends ObjectTypeDefinition> =\n  PropertyKeys.Filtered<Q, \"string\">;\n\n/**\n * State for keyword search filter\n */\nexport interface KeywordSearchFilterState extends BaseFilterState {\n  type: \"keywordSearch\";\n  searchTerm: string;\n  /**\n   * How multiple terms are combined\n   * - \"AND\": All terms must match\n   * - \"OR\": Any term must match\n   */\n  operator: \"AND\" | \"OR\";\n}\n\n/**\n * Filter definition for keyword search across string properties\n */\nexport interface KeywordSearchFilterDefinition<\n  Q extends ObjectTypeDefinition,\n  K extends StringPropertyKeys<Q> = StringPropertyKeys<Q>,\n> {\n  type: \"KEYWORD_SEARCH\";\n  /**\n   * Optional unique identifier for stable keying across filter reorders.\n   */\n  id?: string;\n  /**\n   * Properties to search within\n   * - \"all\": Search all string properties\n   * - K[]: Search specific string properties\n   */\n  properties: \"all\" | K[];\n  label?: string;\n  /**\n   * Controlled state for the filter.\n   * When provided, the filter becomes controlled and changes should be\n   * handled via onFilterStateChanged callback.\n   */\n  filterState?: KeywordSearchFilterState;\n  /**\n   * Default state for uncontrolled mode.\n   * Used when filterState is not provided.\n   */\n  defaultFilterState?: KeywordSearchFilterState;\n  /**\n   * Controls whether this filter is rendered.\n   * When false, the filter is hidden but its state is preserved.\n   * @default true\n   */\n  isVisible?: boolean;\n}\n"],"mappings":"","ignoreList":[]}

package/build/browser/filter-list/types/LinkedFilterTypes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=LinkedFilterTypes.js.map

package/build/browser/filter-list/types/LinkedFilterTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LinkedFilterTypes.js","names":[],"sources":["LinkedFilterTypes.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type {\n  LinkedType,\n  LinkNames,\n  ObjectTypeDefinition,\n  PropertyKeys,\n} from \"@osdk/api\";\nimport type {\n  BaseFilterState,\n  FilterState,\n  FilterStateByComponentType,\n  PropertyTypeFromKey,\n  ValidComponentsForPropertyType,\n} from \"../FilterListItemApi.js\";\n\n/**\n * State for \"has link\" filter\n */\nexport interface HasLinkFilterState extends BaseFilterState {\n  type: \"hasLink\";\n  hasLink: boolean;\n}\n\n/**\n * State for linked property filter\n * Wraps the filter state of the linked property\n */\nexport interface LinkedPropertyFilterState<S extends FilterState = FilterState>\n  extends BaseFilterState\n{\n  type: \"linkedProperty\";\n  linkedFilterState: S;\n}\n\n/**\n * Filter definition for \"Has Link\" filter\n * Filters objects based on whether they have any linked objects of the specified type\n */\nexport interface HasLinkFilterDefinition<\n  Q extends ObjectTypeDefinition,\n  L extends LinkNames<Q> = LinkNames<Q>,\n> {\n  type: \"HAS_LINK\";\n  /**\n   * Optional unique identifier for stable keying across filter reorders.\n   */\n  id?: string;\n  linkName: L;\n  label?: string;\n  filterState: HasLinkFilterState;\n  defaultFilterState?: HasLinkFilterState;\n  /**\n   * Controls whether this filter is rendered.\n   * When false, the filter is hidden but its state is preserved.\n   * @default true\n   */\n  isVisible?: boolean;\n}\n\n/**\n * Filter definition for filtering on a property of linked objects\n */\nexport interface LinkedPropertyFilterDefinition<\n  Q extends ObjectTypeDefinition,\n  L extends LinkNames<Q>,\n  LinkedQ extends ObjectTypeDefinition = LinkedType<Q, L>,\n  LinkedK extends PropertyKeys<LinkedQ> = PropertyKeys<LinkedQ>,\n  LinkedC extends ValidComponentsForPropertyType<\n    PropertyTypeFromKey<LinkedQ, LinkedK>\n  > = ValidComponentsForPropertyType<PropertyTypeFromKey<LinkedQ, LinkedK>>,\n> {\n  type: \"LINKED_PROPERTY\";\n  /**\n   * Optional unique identifier for stable keying across filter reorders.\n   */\n  id?: string;\n  linkName: L;\n  linkedPropertyKey: LinkedK;\n  linkedFilterComponent: LinkedC;\n  linkedFilterState: FilterStateByComponentType[LinkedC];\n  defaultLinkedFilterState?: FilterStateByComponentType[LinkedC];\n  filterState: LinkedPropertyFilterState<FilterStateByComponentType[LinkedC]>;\n  label?: string;\n  /**\n   * Controls whether this filter is rendered.\n   * When false, the filter is hidden but its state is preserved.\n   * @default true\n   */\n  isVisible?: boolean;\n}\n\n/**\n * Display mode for linked filters\n *\n * - \"inline\": Show alongside non-linked filters in the main list\n * - \"grouped\": Group by link type with collapsible sections\n */\nexport type LinkedFilterDisplayMode = \"inline\" | \"grouped\";\n\n/**\n * Configuration for a group of linked filters\n */\nexport interface LinkedFilterGroupConfig<\n  Q extends ObjectTypeDefinition,\n  L extends LinkNames<Q> = LinkNames<Q>,\n> {\n  linkName: L;\n  displayMode: LinkedFilterDisplayMode;\n  collapsedByDefault?: boolean;\n  groupLabel?: string;\n}\n"],"mappings":"","ignoreList":[]}

package/build/browser/filter-list/types/index.js

@@ -0,0 +1,22 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+export * from "./AddFilterMenuTypes.js";
+export * from "./CustomRendererTypes.js";
+export * from "./FilterPanelTypes.js";
+export * from "./KeywordSearchTypes.js";
+export * from "./LinkedFilterTypes.js";
+//# sourceMappingURL=index.js.map

package/build/browser/filter-list/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["index.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport * from \"./AddFilterMenuTypes.js\";\nexport * from \"./CustomRendererTypes.js\";\nexport * from \"./FilterPanelTypes.js\";\nexport * from \"./KeywordSearchTypes.js\";\nexport * from \"./LinkedFilterTypes.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,cAAc,yBAAyB;AACvC,cAAc,0BAA0B;AACxC,cAAc,uBAAuB;AACrC,cAAc,yBAAyB;AACvC,cAAc,wBAAwB","ignoreList":[]}

package/build/browser/filter-list/utils/aggregationHelpers.js

@@ -0,0 +1,44 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+export function createGroupByAggregateOptions(propertyKey) {
+  return {
+    $select: {
+      $count: "unordered"
+    },
+    $groupBy: {
+      [propertyKey]: "exact"
+    }
+  };
+}
+export function createNullCountAggregateOptions() {
+  return {
+    $select: {
+      $count: "unordered"
+    }
+  };
+}
+
+/** Shape returned by $groupBy + $count aggregations when iterated. */
+
+export function createNullWhereClause(propertyKey) {
+  return {
+    [propertyKey]: {
+      $isNull: true
+    }
+  };
+}
+//# sourceMappingURL=aggregationHelpers.js.map

package/build/browser/filter-list/utils/aggregationHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregationHelpers.js","names":["createGroupByAggregateOptions","propertyKey","$select","$count","$groupBy","createNullCountAggregateOptions","createNullWhereClause","$isNull"],"sources":["aggregationHelpers.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type {\n  AggregateOpts,\n  ObjectTypeDefinition,\n  WhereClause,\n} from \"@osdk/api\";\n\nexport function createGroupByAggregateOptions<\n  Q extends ObjectTypeDefinition,\n>(propertyKey: string): AggregateOpts<Q> {\n  return {\n    $select: { $count: \"unordered\" as const },\n    $groupBy: { [propertyKey]: \"exact\" as const },\n  } as AggregateOpts<Q>;\n}\n\nexport function createNullCountAggregateOptions<\n  Q extends ObjectTypeDefinition,\n>(): AggregateOpts<Q> {\n  return {\n    $select: { $count: \"unordered\" as const },\n  } as AggregateOpts<Q>;\n}\n\n/** Shape returned by $groupBy + $count aggregations when iterated. */\nexport type AggregationGroupResult = Iterable<{\n  $group: Record<string, unknown>;\n  $count?: number;\n}>;\n\nexport function createNullWhereClause<\n  Q extends ObjectTypeDefinition,\n>(propertyKey: string): WhereClause<Q> {\n  return { [propertyKey]: { $isNull: true } } as WhereClause<Q>;\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAQA,OAAO,SAASA,6BAA6BA,CAE3CC,WAAmB,EAAoB;EACvC,OAAO;IACLC,OAAO,EAAE;MAAEC,MAAM,EAAE;IAAqB,CAAC;IACzCC,QAAQ,EAAE;MAAE,CAACH,WAAW,GAAG;IAAiB;EAC9C,CAAC;AACH;AAEA,OAAO,SAASI,+BAA+BA,CAAA,EAEzB;EACpB,OAAO;IACLH,OAAO,EAAE;MAAEC,MAAM,EAAE;IAAqB;EAC1C,CAAC;AACH;;AAEA;;AAMA,OAAO,SAASG,qBAAqBA,CAEnCL,WAAmB,EAAkB;EACrC,OAAO;IAAE,CAACA,WAAW,GAAG;MAAEM,OAAO,EAAE;IAAK;EAAE,CAAC;AAC7C","ignoreList":[]}

package/build/browser/filter-list/utils/assertUnreachable.js

@@ -0,0 +1,25 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * Exhaustive type checking helper.
+ * Use in default cases of switch statements to ensure all cases are handled.
+ * TypeScript will error if a case is missing.
+ */
+export function assertUnreachable(value) {
+  throw new Error(`Unhandled value: ${String(value)}`);
+}
+//# sourceMappingURL=assertUnreachable.js.map

package/build/browser/filter-list/utils/assertUnreachable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertUnreachable.js","names":["assertUnreachable","value","Error","String"],"sources":["assertUnreachable.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * Exhaustive type checking helper.\n * Use in default cases of switch statements to ensure all cases are handled.\n * TypeScript will error if a case is missing.\n */\nexport function assertUnreachable(value: never): never {\n  throw new Error(`Unhandled value: ${String(value)}`);\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASA,iBAAiBA,CAACC,KAAY,EAAS;EACrD,MAAM,IAAIC,KAAK,CAAC,oBAAoBC,MAAM,CAACF,KAAK,CAAC,EAAE,CAAC;AACtD","ignoreList":[]}

package/build/browser/filter-list/utils/coerceFilterValue.js

@@ -0,0 +1,33 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * Coerces a filter value to a string for display.
+ * Returns undefined if the value is undefined.
+ */
+export function coerceToString(value) {
+  if (value === undefined) return undefined;
+  return String(value);
+}
+
+/**
+ * Coerces an array of filter values to string[] for display.
+ */
+export function coerceToStringArray(values) {
+  if (values === undefined) return [];
+  return values.map(v => String(v));
+}
+//# sourceMappingURL=coerceFilterValue.js.map

package/build/browser/filter-list/utils/coerceFilterValue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coerceFilterValue.js","names":["coerceToString","value","undefined","String","coerceToStringArray","values","map","v"],"sources":["coerceFilterValue.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\ntype FilterValue = string | boolean | number | Date;\n\n/**\n * Coerces a filter value to a string for display.\n * Returns undefined if the value is undefined.\n */\nexport function coerceToString(\n  value: FilterValue | undefined,\n): string | undefined {\n  if (value === undefined) return undefined;\n  return String(value);\n}\n\n/**\n * Coerces an array of filter values to string[] for display.\n */\nexport function coerceToStringArray(\n  values: FilterValue[] | undefined,\n): string[] {\n  if (values === undefined) return [];\n  return values.map((v) => String(v));\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA;AACA;AACA;AACA;AACA,OAAO,SAASA,cAAcA,CAC5BC,KAA8B,EACV;EACpB,IAAIA,KAAK,KAAKC,SAAS,EAAE,OAAOA,SAAS;EACzC,OAAOC,MAAM,CAACF,KAAK,CAAC;AACtB;;AAEA;AACA;AACA;AACA,OAAO,SAASG,mBAAmBA,CACjCC,MAAiC,EACvB;EACV,IAAIA,MAAM,KAAKH,SAAS,EAAE,OAAO,EAAE;EACnC,OAAOG,MAAM,CAACC,GAAG,CAAEC,CAAC,IAAKJ,MAAM,CAACI,CAAC,CAAC,CAAC;AACrC","ignoreList":[]}

package/build/browser/filter-list/utils/filterStateToWhereClause.js

@@ -0,0 +1,337 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { assertUnreachable } from "./assertUnreachable.js";
+import { getFilterKey } from "./getFilterKey.js";
+function isDate(value) {
+  return value instanceof Date;
+}
+function filterStateToPropertyFilter(state) {
+  switch (state.type) {
+    case "CONTAINS_TEXT":
+      {
+        if (!state.value) {
+          return undefined;
+        }
+        const filter = {
+          $containsAnyTerm: state.value
+        };
+        if (state.isExcluding) {
+          return {
+            $not: filter
+          };
+        }
+        return filter;
+      }
+    case "TOGGLE":
+      {
+        return state.enabled;
+      }
+    case "DATE_RANGE":
+      {
+        const conditions = [];
+        if (state.minValue !== undefined) {
+          conditions.push({
+            $gte: state.minValue.toISOString()
+          });
+        }
+        if (state.maxValue !== undefined) {
+          conditions.push({
+            $lte: state.maxValue.toISOString()
+          });
+        }
+        if (conditions.length === 0 && !state.includeNull) {
+          return undefined;
+        }
+        let rangeFilter;
+        if (conditions.length === 1) {
+          rangeFilter = conditions[0];
+        } else if (conditions.length > 1) {
+          rangeFilter = {
+            $and: conditions
+          };
+        }
+        if (state.includeNull) {
+          if (rangeFilter) {
+            return {
+              $or: [rangeFilter, {
+                $isNull: true
+              }]
+            };
+          }
+          return {
+            $isNull: true
+          };
+        }
+        return rangeFilter;
+      }
+    case "NUMBER_RANGE":
+      {
+        const conditions = [];
+        if (state.minValue !== undefined) {
+          conditions.push({
+            $gte: state.minValue
+          });
+        }
+        if (state.maxValue !== undefined) {
+          conditions.push({
+            $lte: state.maxValue
+          });
+        }
+        if (conditions.length === 0 && !state.includeNull) {
+          return undefined;
+        }
+        let rangeFilter;
+        if (conditions.length === 1) {
+          rangeFilter = conditions[0];
+        } else if (conditions.length > 1) {
+          rangeFilter = {
+            $and: conditions
+          };
+        }
+        if (state.includeNull) {
+          if (rangeFilter) {
+            return {
+              $or: [rangeFilter, {
+                $isNull: true
+              }]
+            };
+          }
+          return {
+            $isNull: true
+          };
+        }
+        return rangeFilter;
+      }
+    case "EXACT_MATCH":
+      {
+        if (state.values.length === 0) {
+          return undefined;
+        }
+        const filter = state.values.length === 1 ? state.values[0] : {
+          $in: state.values
+        };
+        if (state.isExcluding) {
+          return {
+            $not: filter
+          };
+        }
+        return filter;
+      }
+    case "SELECT":
+      {
+        if (state.selectedValues.length === 0) {
+          return undefined;
+        }
+        const isDateValue = state.selectedValues[0] instanceof Date;
+        const values = isDateValue ? state.selectedValues.map(v => v.toISOString()) : state.selectedValues;
+        const filter = values.length === 1 ? values[0] : {
+          $in: values
+        };
+        if (state.isExcluding) {
+          return {
+            $not: filter
+          };
+        }
+        return filter;
+      }
+    case "TIMELINE":
+      {
+        const conditions = [];
+        if (state.startDate !== undefined) {
+          conditions.push({
+            $gte: state.startDate.toISOString()
+          });
+        }
+        if (state.endDate !== undefined) {
+          conditions.push({
+            $lte: state.endDate.toISOString()
+          });
+        }
+        if (conditions.length === 0) {
+          return undefined;
+        }
+        if (conditions.length === 1) {
+          return conditions[0];
+        }
+        return {
+          $and: conditions
+        };
+      }
+
+    // These filter types are handled separately in buildWhereClause
+    // since they need access to the full definition, not just state
+    case "hasLink":
+    case "linkedProperty":
+    case "keywordSearch":
+    case "custom":
+      return undefined;
+    default:
+      return assertUnreachable(state);
+  }
+}
+
+/**
+ * Builds a WhereClause from filter definitions and their current states.
+ *
+ * The filterStates map uses string keys derived from filter definitions via
+ * getFilterKey(). This ensures stable state lookups even when filters are
+ * reordered or definition object references change.
+ *
+ * Note: The `as WhereClause<Q>` casts are necessary because we're building
+ * clauses dynamically from property keys determined at runtime. TypeScript
+ * cannot verify that the constructed clause structure matches the generic Q's
+ * expected shape, but the structure is guaranteed to be valid by construction.
+ */
+export function buildWhereClause(definitions, filterStates, operator, objectType) {
+  if (!definitions || definitions.length === 0) {
+    return {};
+  }
+  const clauses = [];
+  for (const definition of definitions) {
+    const state = filterStates.get(getFilterKey(definition));
+    if (!state) {
+      continue;
+    }
+    switch (definition.type) {
+      case "PROPERTY":
+        {
+          const filter = filterStateToPropertyFilter(state);
+          if (filter !== undefined) {
+            clauses.push({
+              [definition.key]: filter
+            });
+          }
+          break;
+        }
+      case "HAS_LINK":
+        {
+          if (state.type !== "hasLink") {
+            if (process.env.NODE_ENV !== "production") {
+              // eslint-disable-next-line no-console
+              console.warn(`[FilterList] State type mismatch for hasLink filter "${definition.linkName}": expected hasLink, got ${state.type}`);
+            }
+            break;
+          }
+          if (!state.hasLink) {
+            break;
+          }
+          clauses.push({
+            [definition.linkName]: {
+              $isNotNull: true
+            }
+          });
+          break;
+        }
+      case "LINKED_PROPERTY":
+        {
+          // OSDK WhereClause does not support filtering through links.
+          // Link-based filtering requires ObjectSet operations (pivotTo/intersect).
+          // LinkedProperty filters render UI for selection but cannot be included
+          // in the where clause. Consumers needing linked property filtering must
+          // implement it using ObjectSet.pivotTo() and intersect().
+          break;
+        }
+      case "KEYWORD_SEARCH":
+        {
+          if (state.type !== "keywordSearch") {
+            if (process.env.NODE_ENV !== "production") {
+              // eslint-disable-next-line no-console
+              console.warn(`[FilterList] State type mismatch for keywordSearch filter: expected keywordSearch, got ${state.type}`);
+            }
+            break;
+          }
+          if (!state.searchTerm) {
+            break;
+          }
+          // TypeScript narrows state to KeywordSearchFilterState
+          const searchTerm = state.searchTerm.trim();
+          if (!searchTerm) {
+            break;
+          }
+          const properties = definition.properties;
+          let propertiesToSearch;
+          if (properties === "all") {
+            if (objectType?.__DefinitionMetadata?.properties) {
+              propertiesToSearch = Object.entries(objectType.__DefinitionMetadata.properties).filter(([, prop]) => prop.type === "string" && !prop.multiplicity).map(([key]) => key);
+            } else {
+              if (process.env.NODE_ENV !== "production") {
+                // eslint-disable-next-line no-console
+                console.warn("[FilterList] Keyword search with properties: 'all' requires objectType to be provided. Filter will be skipped.");
+              }
+              break;
+            }
+          } else {
+            propertiesToSearch = properties;
+          }
+          if (propertiesToSearch.length === 0) {
+            break;
+          }
+          const containsOp = state.operator === "AND" ? "$containsAllTerms" : "$containsAnyTerm";
+          const propertySearches = propertiesToSearch.map(prop => ({
+            [prop]: state.isExcluding ? {
+              $not: {
+                [containsOp]: searchTerm
+              }
+            } : {
+              [containsOp]: searchTerm
+            }
+          }));
+          if (propertySearches.length === 1) {
+            clauses.push(propertySearches[0]);
+          } else {
+            clauses.push({
+              $or: propertySearches
+            });
+          }
+          break;
+        }
+      case "CUSTOM":
+        {
+          if (state.type !== "custom") {
+            if (process.env.NODE_ENV !== "production") {
+              // eslint-disable-next-line no-console
+              console.warn(`[FilterList] State type mismatch for custom filter "${definition.key}": expected custom, got ${state.type}`);
+            }
+            break;
+          }
+          // TypeScript narrows state to CustomFilterState
+          const customClause = definition.toWhereClause(state);
+          if (customClause && Object.keys(customClause).length > 0) {
+            clauses.push(customClause);
+          }
+          break;
+        }
+      default:
+        assertUnreachable(definition);
+    }
+  }
+  if (clauses.length === 0) {
+    return {};
+  }
+  if (clauses.length === 1) {
+    return clauses[0];
+  }
+  if (operator === "and") {
+    return {
+      $and: clauses
+    };
+  }
+  return {
+    $or: clauses
+  };
+}
+//# sourceMappingURL=filterStateToWhereClause.js.map