@osdk/react-components 0.2.0-beta.2 → 0.2.0-beta.21

package/build/esm/filter-list/inputs/ToggleFilterInput.js

@@ -0,0 +1,36 @@
+/*
+ * 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 React, { memo, useCallback } from "react";
+import { ToggleInput } from "../base/inputs/ToggleInput.js";
+function ToggleFilterInputInner({
+  filterState,
+  onFilterStateChanged
+}) {
+  const enabled = filterState?.type === "TOGGLE" ? filterState.enabled : false;
+  const handleChange = useCallback(enabled => {
+    onFilterStateChanged({
+      type: "TOGGLE",
+      enabled
+    });
+  }, [onFilterStateChanged]);
+  return /*#__PURE__*/React.createElement(ToggleInput, {
+    enabled: enabled,
+    onChange: handleChange
+  });
+}
+export const ToggleFilterInput = /*#__PURE__*/memo(ToggleFilterInputInner);
+//# sourceMappingURL=ToggleFilterInput.js.map

package/build/esm/filter-list/inputs/ToggleFilterInput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToggleFilterInput.js","names":["React","memo","useCallback","ToggleInput","ToggleFilterInputInner","filterState","onFilterStateChanged","enabled","type","handleChange","createElement","onChange","ToggleFilterInput"],"sources":["ToggleFilterInput.tsx"],"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 React, { memo, useCallback } from \"react\";\nimport { ToggleInput } from \"../base/inputs/ToggleInput.js\";\nimport type { FilterState } from \"../FilterListItemApi.js\";\n\ninterface ToggleFilterInputProps {\n  filterState: FilterState | undefined;\n  onFilterStateChanged: (state: FilterState) => void;\n}\n\nfunction ToggleFilterInputInner({\n  filterState,\n  onFilterStateChanged,\n}: ToggleFilterInputProps): React.ReactElement {\n  const enabled = filterState?.type === \"TOGGLE\" ? filterState.enabled : false;\n\n  const handleChange = useCallback(\n    (enabled: boolean) => {\n      onFilterStateChanged({ type: \"TOGGLE\", enabled });\n    },\n    [onFilterStateChanged],\n  );\n\n  return <ToggleInput enabled={enabled} onChange={handleChange} />;\n}\n\nexport const ToggleFilterInput: React.MemoExoticComponent<\n  typeof ToggleFilterInputInner\n> = memo(ToggleFilterInputInner);\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAOA,KAAK,IAAIC,IAAI,EAAEC,WAAW,QAAQ,OAAO;AAChD,SAASC,WAAW,QAAQ,+BAA+B;AAQ3D,SAASC,sBAAsBA,CAAC;EAC9BC,WAAW;EACXC;AACsB,CAAC,EAAsB;EAC7C,MAAMC,OAAO,GAAGF,WAAW,EAAEG,IAAI,KAAK,QAAQ,GAAGH,WAAW,CAACE,OAAO,GAAG,KAAK;EAE5E,MAAME,YAAY,GAAGP,WAAW,CAC7BK,OAAgB,IAAK;IACpBD,oBAAoB,CAAC;MAAEE,IAAI,EAAE,QAAQ;MAAED;IAAQ,CAAC,CAAC;EACnD,CAAC,EACD,CAACD,oBAAoB,CACvB,CAAC;EAED,oBAAON,KAAA,CAAAU,aAAA,CAACP,WAAW;IAACI,OAAO,EAAEA,OAAQ;IAACI,QAAQ,EAAEF;EAAa,CAAE,CAAC;AAClE;AAEA,OAAO,MAAMG,iBAEZ,gBAAGX,IAAI,CAACG,sBAAsB,CAAC","ignoreList":[]}

package/build/esm/filter-list/types/AggregationTypes.js

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

package/build/esm/filter-list/types/AggregationTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AggregationTypes.js","names":[],"sources":["AggregationTypes.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 interface PropertyAggregationValue {\n  value: string;\n  count: number;\n  isNull?: boolean;\n}\n"],"mappings":"","ignoreList":[]}

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

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

package/build/esm/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/esm/filter-list/types/KeywordSearchTypes.js

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

package/build/esm/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/esm/filter-list/types/LinkedFilterTypes.js

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

package/build/esm/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"],"mappings":"","ignoreList":[]}

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

@@ -0,0 +1,20 @@
+/*
+ * 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 "./CustomRendererTypes.js";
+export * from "./KeywordSearchTypes.js";
+export * from "./LinkedFilterTypes.js";
+//# sourceMappingURL=index.js.map

package/build/esm/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 \"./CustomRendererTypes.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,0BAA0B;AACxC,cAAc,yBAAyB;AACvC,cAAc,wBAAwB","ignoreList":[]}

package/build/esm/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/esm/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/esm/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/esm/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/esm/filter-list/utils/filterStateSerialization.js

@@ -0,0 +1,42 @@
+/*
+ * 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.
+ */
+
+const DATE_PREFIX = "__date__:";
+function replacer(_key, value) {
+  if (value instanceof Date) {
+    return DATE_PREFIX + value.toISOString();
+  }
+  return value;
+}
+function reviver(_key, value) {
+  if (typeof value === "string" && value.startsWith(DATE_PREFIX)) {
+    return new Date(value.slice(DATE_PREFIX.length));
+  }
+  return value;
+}
+export function serializeFilterStates(states) {
+  const entries = Array.from(states.entries());
+  return JSON.stringify(entries, replacer);
+}
+export function deserializeFilterStates(json) {
+  try {
+    const entries = JSON.parse(json, reviver);
+    return new Map(entries);
+  } catch {
+    return new Map();
+  }
+}
+//# sourceMappingURL=filterStateSerialization.js.map

package/build/esm/filter-list/utils/filterStateSerialization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterStateSerialization.js","names":["DATE_PREFIX","replacer","_key","value","Date","toISOString","reviver","startsWith","slice","length","serializeFilterStates","states","entries","Array","from","JSON","stringify","deserializeFilterStates","json","parse","Map"],"sources":["filterStateSerialization.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 { FilterState } from \"../FilterListItemApi.js\";\n\nconst DATE_PREFIX = \"__date__:\";\n\nfunction replacer(_key: string, value: unknown): unknown {\n  if (value instanceof Date) {\n    return DATE_PREFIX + value.toISOString();\n  }\n  return value;\n}\n\nfunction reviver(_key: string, value: unknown): unknown {\n  if (typeof value === \"string\" && value.startsWith(DATE_PREFIX)) {\n    return new Date(value.slice(DATE_PREFIX.length));\n  }\n  return value;\n}\n\nexport function serializeFilterStates(\n  states: Map<string, FilterState>,\n): string {\n  const entries = Array.from(states.entries());\n  return JSON.stringify(entries, replacer);\n}\n\nexport function deserializeFilterStates(\n  json: string,\n): Map<string, FilterState> {\n  try {\n    const entries: Array<[string, FilterState]> = JSON.parse(json, reviver);\n    return new Map(entries);\n  } catch {\n    return new Map();\n  }\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA,MAAMA,WAAW,GAAG,WAAW;AAE/B,SAASC,QAAQA,CAACC,IAAY,EAAEC,KAAc,EAAW;EACvD,IAAIA,KAAK,YAAYC,IAAI,EAAE;IACzB,OAAOJ,WAAW,GAAGG,KAAK,CAACE,WAAW,CAAC,CAAC;EAC1C;EACA,OAAOF,KAAK;AACd;AAEA,SAASG,OAAOA,CAACJ,IAAY,EAAEC,KAAc,EAAW;EACtD,IAAI,OAAOA,KAAK,KAAK,QAAQ,IAAIA,KAAK,CAACI,UAAU,CAACP,WAAW,CAAC,EAAE;IAC9D,OAAO,IAAII,IAAI,CAACD,KAAK,CAACK,KAAK,CAACR,WAAW,CAACS,MAAM,CAAC,CAAC;EAClD;EACA,OAAON,KAAK;AACd;AAEA,OAAO,SAASO,qBAAqBA,CACnCC,MAAgC,EACxB;EACR,MAAMC,OAAO,GAAGC,KAAK,CAACC,IAAI,CAACH,MAAM,CAACC,OAAO,CAAC,CAAC,CAAC;EAC5C,OAAOG,IAAI,CAACC,SAAS,CAACJ,OAAO,EAAEX,QAAQ,CAAC;AAC1C;AAEA,OAAO,SAASgB,uBAAuBA,CACrCC,IAAY,EACc;EAC1B,IAAI;IACF,MAAMN,OAAqC,GAAGG,IAAI,CAACI,KAAK,CAACD,IAAI,EAAEZ,OAAO,CAAC;IACvE,OAAO,IAAIc,GAAG,CAACR,OAAO,CAAC;EACzB,CAAC,CAAC,MAAM;IACN,OAAO,IAAIQ,GAAG,CAAC,CAAC;EAClB;AACF","ignoreList":[]}

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

@@ -0,0 +1,375 @@
+/*
+ * 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 "../../shared/assertUnreachable.js";
+import { formatDateForInput } from "../base/inputs/dateUtils.js";
+import { getFilterKey } from "./getFilterKey.js";
+function isCompoundFilter(f) {
+  return typeof f === "object" && f != null && "__compound" in f;
+}
+const NUMERIC_BOUNDS = {
+  byte: {
+    min: -128,
+    max: 127
+  },
+  short: {
+    min: -32_768,
+    max: 32_767
+  },
+  integer: {
+    min: -2_147_483_648,
+    max: 2_147_483_647
+  },
+  long: {
+    min: Number.MIN_SAFE_INTEGER,
+    max: Number.MAX_SAFE_INTEGER
+  }
+};
+function clampToPropertyBounds(value, propertyType) {
+  if (propertyType === undefined) {
+    return value;
+  }
+  const bounds = NUMERIC_BOUNDS[propertyType];
+  if (bounds === undefined) {
+    return value;
+  }
+  return Math.max(bounds.min, Math.min(bounds.max, value));
+}
+function formatDateValue(date, propertyType) {
+  if (propertyType === "datetime") {
+    return formatDateForInput(date);
+  }
+  return date.toISOString();
+}
+function filterStateToPropertyFilter(state, propertyType) {
+  switch (state.type) {
+    case "CONTAINS_TEXT":
+      {
+        if (!state.value) {
+          return undefined;
+        }
+        return {
+          $containsAnyTerm: state.value
+        };
+      }
+    case "TOGGLE":
+      {
+        return state.enabled;
+      }
+    case "DATE_RANGE":
+      {
+        const conditions = [];
+        if (state.minValue !== undefined) {
+          conditions.push({
+            $gte: formatDateValue(state.minValue, propertyType)
+          });
+        }
+        if (state.maxValue !== undefined) {
+          conditions.push({
+            $lte: formatDateValue(state.maxValue, propertyType)
+          });
+        }
+        if (conditions.length === 0 && !state.includeNull) {
+          return undefined;
+        }
+        if (conditions.length === 0 && state.includeNull) {
+          return {
+            $isNull: true
+          };
+        }
+        if (conditions.length === 1 && !state.includeNull) {
+          return conditions[0];
+        }
+        return {
+          __compound: true,
+          conditions,
+          includeNull: state.includeNull ?? false
+        };
+      }
+    case "NUMBER_RANGE":
+      {
+        const conditions = [];
+        if (state.minValue !== undefined) {
+          conditions.push({
+            $gte: clampToPropertyBounds(state.minValue, propertyType)
+          });
+        }
+        if (state.maxValue !== undefined) {
+          conditions.push({
+            $lte: clampToPropertyBounds(state.maxValue, propertyType)
+          });
+        }
+        if (conditions.length === 0 && !state.includeNull) {
+          return undefined;
+        }
+        if (conditions.length === 0 && state.includeNull) {
+          return {
+            $isNull: true
+          };
+        }
+        if (conditions.length === 1 && !state.includeNull) {
+          return conditions[0];
+        }
+        return {
+          __compound: true,
+          conditions,
+          includeNull: state.includeNull ?? false
+        };
+      }
+    case "EXACT_MATCH":
+      {
+        if (state.values.length === 0) {
+          return undefined;
+        }
+        return state.values.length === 1 ? state.values[0] : {
+          $in: state.values
+        };
+      }
+    case "SELECT":
+      {
+        if (state.selectedValues.length === 0) {
+          return undefined;
+        }
+        const values = state.selectedValues.map(v => v instanceof Date ? formatDateValue(v, propertyType) : v);
+        return values.length === 1 ? values[0] : {
+          $in: values
+        };
+      }
+    case "TIMELINE":
+      {
+        const conditions = [];
+        if (state.startDate !== undefined) {
+          conditions.push({
+            $gte: formatDateValue(state.startDate, propertyType)
+          });
+        }
+        if (state.endDate !== undefined) {
+          conditions.push({
+            $lte: formatDateValue(state.endDate, propertyType)
+          });
+        }
+        if (conditions.length === 0) {
+          return undefined;
+        }
+        if (conditions.length === 1) {
+          return conditions[0];
+        }
+        return {
+          __compound: true,
+          conditions,
+          includeNull: false
+        };
+      }
+
+    // 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, propertyTypes, excludeFilterKey) {
+  if (!definitions || definitions.length === 0) {
+    return {};
+  }
+  const clauses = [];
+  for (const definition of definitions) {
+    const key = getFilterKey(definition);
+    if (key === excludeFilterKey) {
+      continue;
+    }
+    const state = filterStates.get(key);
+    if (!state) {
+      continue;
+    }
+    switch (definition.type) {
+      case "PROPERTY":
+        {
+          const propertyType = propertyTypes?.get(definition.key)?.type;
+          const filter = filterStateToPropertyFilter(state, propertyType);
+          if (filter !== undefined) {
+            const isExcluding = "isExcluding" in state && state.isExcluding;
+            if (isCompoundFilter(filter)) {
+              const fieldClauses = filter.conditions.map(c => ({
+                [definition.key]: c
+              }));
+              let rangeClause = fieldClauses.length === 1 ? fieldClauses[0] : {
+                $and: fieldClauses
+              };
+              if (filter.includeNull) {
+                rangeClause = {
+                  $or: [rangeClause, {
+                    [definition.key]: {
+                      $isNull: true
+                    }
+                  }]
+                };
+              }
+              clauses.push(isExcluding ? {
+                $not: rangeClause
+              } : rangeClause);
+            } else {
+              const clause = {
+                [definition.key]: filter
+              };
+              clauses.push(isExcluding ? {
+                $not: clause
+              } : clause);
+            }
+          }
+          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 (propertyTypes && propertyTypes.size > 0) {
+              propertiesToSearch = [];
+              for (const [key, info] of propertyTypes) {
+                if (info.type === "string" && !info.multiplicity) {
+                  propertiesToSearch.push(key);
+                }
+              }
+            } else {
+              if (process.env.NODE_ENV !== "production") {
+                // eslint-disable-next-line no-console
+                console.warn("[FilterList] Keyword search with properties: 'all' requires propertyTypes 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]: {
+              [containsOp]: searchTerm
+            }
+          }));
+          let searchClause;
+          if (propertySearches.length === 1) {
+            searchClause = propertySearches[0];
+          } else {
+            searchClause = {
+              $or: propertySearches
+            };
+          }
+          clauses.push(state.isExcluding ? {
+            $not: searchClause
+          } : searchClause);
+          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