@osdk/react-components 0.2.0-beta.1 → 0.2.0-beta.3

package/build/esm/filter-list/__tests__/testUtils.js

@@ -0,0 +1,192 @@
+/*
+ * 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 const MockObjectType = {
+  apiName: "TestObject",
+  type: "object",
+  __DefinitionMetadata: {
+    primaryKeyApiName: "id",
+    primaryKeyType: "string",
+    properties: {
+      id: {
+        type: "string",
+        multiplicity: false
+      },
+      name: {
+        type: "string",
+        multiplicity: false
+      },
+      age: {
+        type: "integer",
+        multiplicity: false
+      },
+      active: {
+        type: "boolean",
+        multiplicity: false
+      },
+      createdAt: {
+        type: "timestamp",
+        multiplicity: false
+      },
+      score: {
+        type: "double",
+        multiplicity: false
+      }
+    }
+  }
+};
+
+/**
+ * Create a property filter definition for testing
+ */
+export function createPropertyFilterDef(key, filterComponent, filterState) {
+  return {
+    type: "PROPERTY",
+    key,
+    filterComponent,
+    filterState
+  };
+}
+
+/**
+ * Create a hasLink filter definition for testing
+ */
+export function createHasLinkFilterDef(linkName) {
+  return {
+    type: "HAS_LINK",
+    linkName,
+    filterState: {
+      type: "hasLink",
+      hasLink: false
+    }
+  };
+}
+
+/**
+ * Create a linkedProperty filter definition for testing.
+ * Cast required because LinkedPropertyFilterDefinition has complex generic constraints
+ * that can't be satisfied with literal link names.
+ */
+export function createLinkedPropertyFilterDef(linkName, linkedPropertyKey) {
+  return {
+    type: "LINKED_PROPERTY",
+    linkName,
+    linkedPropertyKey,
+    linkedFilterComponent: "CHECKBOX_LIST",
+    linkedFilterState: {
+      type: "SELECT",
+      selectedValues: []
+    },
+    filterState: {
+      type: "linkedProperty",
+      linkedFilterState: {
+        type: "SELECT",
+        selectedValues: []
+      }
+    }
+  };
+}
+
+/**
+ * Create a keywordSearch filter definition for testing
+ */
+export function createKeywordSearchFilterDef(properties) {
+  return {
+    type: "KEYWORD_SEARCH",
+    properties,
+    filterState: {
+      type: "keywordSearch",
+      searchTerm: "",
+      operator: "AND"
+    }
+  };
+}
+
+/**
+ * Create a custom filter definition for testing.
+ * Cast required because CustomFilterDefinition expects specific callback signatures.
+ */
+export function createCustomFilterDef(key) {
+  return {
+    type: "CUSTOM",
+    key,
+    filterComponent: "CUSTOM",
+    filterState: {
+      type: "custom",
+      customState: {}
+    },
+    renderInput: () => null,
+    toWhereClause: () => ({})
+  };
+}
+
+/**
+ * Helper to create a SelectFilterState
+ */
+export function createSelectState(selectedValues, options) {
+  return {
+    type: "SELECT",
+    selectedValues,
+    isExcluding: options?.isExcluding,
+    includeNull: options?.includeNull
+  };
+}
+
+/**
+ * Helper to create a ContainsTextFilterState
+ */
+export function createContainsTextState(value, options) {
+  return {
+    type: "CONTAINS_TEXT",
+    value,
+    isExcluding: options?.isExcluding
+  };
+}
+
+/**
+ * Helper to create a ToggleFilterState
+ */
+export function createToggleState(enabled) {
+  return {
+    type: "TOGGLE",
+    enabled
+  };
+}
+
+/**
+ * Helper to create a NumberRangeFilterState
+ */
+export function createNumberRangeState(minValue, maxValue, options) {
+  return {
+    type: "NUMBER_RANGE",
+    minValue,
+    maxValue,
+    includeNull: options?.includeNull
+  };
+}
+
+/**
+ * Helper to create a DateRangeFilterState
+ */
+export function createDateRangeState(minValue, maxValue, options) {
+  return {
+    type: "DATE_RANGE",
+    minValue,
+    maxValue,
+    includeNull: options?.includeNull
+  };
+}
+//# sourceMappingURL=testUtils.js.map

package/build/esm/filter-list/__tests__/testUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testUtils.js","names":["MockObjectType","apiName","type","__DefinitionMetadata","primaryKeyApiName","primaryKeyType","properties","id","multiplicity","name","age","active","createdAt","score","createPropertyFilterDef","key","filterComponent","filterState","createHasLinkFilterDef","linkName","hasLink","createLinkedPropertyFilterDef","linkedPropertyKey","linkedFilterComponent","linkedFilterState","selectedValues","createKeywordSearchFilterDef","searchTerm","operator","createCustomFilterDef","customState","renderInput","toWhereClause","createSelectState","options","isExcluding","includeNull","createContainsTextState","value","createToggleState","enabled","createNumberRangeState","minValue","maxValue","createDateRangeState"],"sources":["testUtils.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 } from \"@osdk/api\";\nimport type { FilterDefinitionUnion } from \"../FilterListApi.js\";\nimport type {\n  ContainsTextFilterState,\n  DateRangeFilterState,\n  FilterComponentType,\n  FilterState,\n  NumberRangeFilterState,\n  SelectFilterState,\n  ToggleFilterState,\n} from \"../FilterListItemApi.js\";\n\nexport const MockObjectType = {\n  apiName: \"TestObject\",\n  type: \"object\",\n  __DefinitionMetadata: {\n    primaryKeyApiName: \"id\",\n    primaryKeyType: \"string\",\n    properties: {\n      id: { type: \"string\", multiplicity: false },\n      name: { type: \"string\", multiplicity: false },\n      age: { type: \"integer\", multiplicity: false },\n      active: { type: \"boolean\", multiplicity: false },\n      createdAt: { type: \"timestamp\", multiplicity: false },\n      score: { type: \"double\", multiplicity: false },\n    },\n  },\n} as unknown as ObjectTypeDefinition;\n\n/**\n * Create a property filter definition for testing\n */\nexport function createPropertyFilterDef<\n  K extends string = string,\n  C extends FilterComponentType = FilterComponentType,\n>(\n  key: K,\n  filterComponent: C,\n  filterState: FilterState,\n): FilterDefinitionUnion<typeof MockObjectType> {\n  return {\n    type: \"PROPERTY\",\n    key,\n    filterComponent,\n    filterState,\n  } as FilterDefinitionUnion<typeof MockObjectType>;\n}\n\n/**\n * Create a hasLink filter definition for testing\n */\nexport function createHasLinkFilterDef(\n  linkName: string,\n): FilterDefinitionUnion<typeof MockObjectType> {\n  return {\n    type: \"HAS_LINK\",\n    linkName,\n    filterState: { type: \"hasLink\", hasLink: false },\n  } as FilterDefinitionUnion<typeof MockObjectType>;\n}\n\n/**\n * Create a linkedProperty filter definition for testing.\n * Cast required because LinkedPropertyFilterDefinition has complex generic constraints\n * that can't be satisfied with literal link names.\n */\nexport function createLinkedPropertyFilterDef(\n  linkName: string,\n  linkedPropertyKey: string,\n): FilterDefinitionUnion<typeof MockObjectType> {\n  return {\n    type: \"LINKED_PROPERTY\",\n    linkName,\n    linkedPropertyKey,\n    linkedFilterComponent: \"CHECKBOX_LIST\",\n    linkedFilterState: { type: \"SELECT\", selectedValues: [] },\n    filterState: {\n      type: \"linkedProperty\",\n      linkedFilterState: { type: \"SELECT\", selectedValues: [] },\n    },\n  } as FilterDefinitionUnion<typeof MockObjectType>;\n}\n\n/**\n * Create a keywordSearch filter definition for testing\n */\nexport function createKeywordSearchFilterDef(\n  properties: string[] | \"all\",\n): FilterDefinitionUnion<typeof MockObjectType> {\n  return {\n    type: \"KEYWORD_SEARCH\",\n    properties,\n    filterState: { type: \"keywordSearch\", searchTerm: \"\", operator: \"AND\" },\n  } as FilterDefinitionUnion<typeof MockObjectType>;\n}\n\n/**\n * Create a custom filter definition for testing.\n * Cast required because CustomFilterDefinition expects specific callback signatures.\n */\nexport function createCustomFilterDef(\n  key: string,\n): FilterDefinitionUnion<typeof MockObjectType> {\n  return {\n    type: \"CUSTOM\",\n    key,\n    filterComponent: \"CUSTOM\",\n    filterState: { type: \"custom\", customState: {} },\n    renderInput: () => null,\n    toWhereClause: () => ({}),\n  } as FilterDefinitionUnion<typeof MockObjectType>;\n}\n\n/**\n * Helper to create a SelectFilterState\n */\nexport function createSelectState<T = string>(\n  selectedValues: T[],\n  options?: {\n    isExcluding?: boolean;\n    includeNull?: boolean;\n  },\n): SelectFilterState<T> {\n  return {\n    type: \"SELECT\",\n    selectedValues,\n    isExcluding: options?.isExcluding,\n    includeNull: options?.includeNull,\n  };\n}\n\n/**\n * Helper to create a ContainsTextFilterState\n */\nexport function createContainsTextState(\n  value?: string,\n  options?: { isExcluding?: boolean },\n): ContainsTextFilterState {\n  return {\n    type: \"CONTAINS_TEXT\",\n    value,\n    isExcluding: options?.isExcluding,\n  };\n}\n\n/**\n * Helper to create a ToggleFilterState\n */\nexport function createToggleState(enabled: boolean): ToggleFilterState {\n  return {\n    type: \"TOGGLE\",\n    enabled,\n  };\n}\n\n/**\n * Helper to create a NumberRangeFilterState\n */\nexport function createNumberRangeState(\n  minValue?: number,\n  maxValue?: number,\n  options?: { includeNull?: boolean },\n): NumberRangeFilterState {\n  return {\n    type: \"NUMBER_RANGE\",\n    minValue,\n    maxValue,\n    includeNull: options?.includeNull,\n  };\n}\n\n/**\n * Helper to create a DateRangeFilterState\n */\nexport function createDateRangeState(\n  minValue?: Date,\n  maxValue?: Date,\n  options?: { includeNull?: boolean },\n): DateRangeFilterState {\n  return {\n    type: \"DATE_RANGE\",\n    minValue,\n    maxValue,\n    includeNull: options?.includeNull,\n  };\n}\n"],"mappings":"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","ignoreList":[]}

package/build/esm/filter-list/hooks/__tests__/useFilterListState.test.js

@@ -0,0 +1,128 @@
+/*
+ * 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 { act, renderHook } from "@testing-library/react";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { createPropertyFilterDef, createSelectState, createToggleState, MockObjectType } from "../../__tests__/testUtils.js";
+import { getFilterKey } from "../../utils/getFilterKey.js";
+import { useFilterListState } from "../useFilterListState.js";
+function createMockObjectSet() {
+  return {
+    $objectSetInternals: {
+      def: MockObjectType
+    }
+  };
+}
+function createProps(overrides = {}) {
+  return {
+    objectSet: createMockObjectSet(),
+    ...overrides
+  };
+}
+describe("useFilterListState", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+  afterEach(() => {
+    vi.clearAllMocks();
+  });
+  it("initializes with empty filter states when no definitions", () => {
+    const props = createProps({
+      filterDefinitions: undefined
+    });
+    const {
+      result
+    } = renderHook(() => useFilterListState(props));
+    expect(result.current.filterStates.size).toBe(0);
+  });
+  it("initializes filter states from filterState for property filters", () => {
+    const initialState = createSelectState([]);
+    const nameDef = createPropertyFilterDef("name", "CHECKBOX_LIST", initialState);
+    const props = createProps({
+      filterDefinitions: [nameDef]
+    });
+    const {
+      result
+    } = renderHook(() => useFilterListState(props));
+    expect(result.current.filterStates.get(getFilterKey(nameDef))).toEqual(initialState);
+  });
+  it("updates filter state via setFilterState", () => {
+    const nameDef = createPropertyFilterDef("name", "CHECKBOX_LIST", createSelectState([]));
+    const props = createProps({
+      filterDefinitions: [nameDef]
+    });
+    const {
+      result
+    } = renderHook(() => useFilterListState(props));
+    act(() => {
+      result.current.setFilterState(getFilterKey(nameDef), createSelectState(["selected"]));
+    });
+    expect(result.current.filterStates.get(getFilterKey(nameDef))).toEqual(createSelectState(["selected"]));
+  });
+  it("calls onFilterStateChanged callback", () => {
+    const onFilterStateChanged = vi.fn();
+    const nameDef = createPropertyFilterDef("name", "CHECKBOX_LIST", createSelectState([]));
+    const props = createProps({
+      filterDefinitions: [nameDef],
+      onFilterStateChanged
+    });
+    const {
+      result
+    } = renderHook(() => useFilterListState(props));
+    const newState = createSelectState(["selected"]);
+    act(() => {
+      result.current.setFilterState(getFilterKey(nameDef), newState);
+    });
+    expect(onFilterStateChanged).toHaveBeenCalledWith(nameDef, newState);
+  });
+  it("builds whereClause from filter states", () => {
+    const nameDef = createPropertyFilterDef("name", "CHECKBOX_LIST", createSelectState([]));
+    const props = createProps({
+      filterDefinitions: [nameDef]
+    });
+    const {
+      result
+    } = renderHook(() => useFilterListState(props));
+    act(() => {
+      result.current.setFilterState(getFilterKey(nameDef), createSelectState(["John"]));
+    });
+    expect(result.current.whereClause).toEqual({
+      name: "John"
+    });
+  });
+  it("handles multiple filter definitions", () => {
+    const nameDef = createPropertyFilterDef("name", "CHECKBOX_LIST", createSelectState([]));
+    const activeDef = createPropertyFilterDef("active", "TOGGLE", createToggleState(false));
+    const props = createProps({
+      filterDefinitions: [nameDef, activeDef]
+    });
+    const {
+      result
+    } = renderHook(() => useFilterListState(props));
+    act(() => {
+      result.current.setFilterState(getFilterKey(nameDef), createSelectState(["John"]));
+      result.current.setFilterState(getFilterKey(activeDef), createToggleState(true));
+    });
+    expect(result.current.whereClause).toEqual({
+      $and: [{
+        name: "John"
+      }, {
+        active: true
+      }]
+    });
+  });
+});
+//# sourceMappingURL=useFilterListState.test.js.map

package/build/esm/filter-list/hooks/__tests__/useFilterListState.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFilterListState.test.js","names":["act","renderHook","afterEach","beforeEach","describe","expect","it","vi","createPropertyFilterDef","createSelectState","createToggleState","MockObjectType","getFilterKey","useFilterListState","createMockObjectSet","$objectSetInternals","def","createProps","overrides","objectSet","clearAllMocks","props","filterDefinitions","undefined","result","current","filterStates","size","toBe","initialState","nameDef","get","toEqual","setFilterState","onFilterStateChanged","fn","newState","toHaveBeenCalledWith","whereClause","name","activeDef","$and","active"],"sources":["useFilterListState.test.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 type { ObjectSet } from \"@osdk/api\";\nimport { act, renderHook } from \"@testing-library/react\";\nimport { afterEach, beforeEach, describe, expect, it, vi } from \"vitest\";\nimport {\n  createPropertyFilterDef,\n  createSelectState,\n  createToggleState,\n  MockObjectType,\n} from \"../../__tests__/testUtils.js\";\nimport type { FilterListProps } from \"../../FilterListApi.js\";\nimport { getFilterKey } from \"../../utils/getFilterKey.js\";\nimport { useFilterListState } from \"../useFilterListState.js\";\n\nfunction createMockObjectSet(): ObjectSet<typeof MockObjectType> {\n  return {\n    $objectSetInternals: {\n      def: MockObjectType,\n    },\n  } as ObjectSet<typeof MockObjectType>;\n}\n\nfunction createProps(\n  overrides: Partial<FilterListProps<typeof MockObjectType>> = {},\n): FilterListProps<typeof MockObjectType> {\n  return {\n    objectSet: createMockObjectSet(),\n    ...overrides,\n  };\n}\n\ndescribe(\"useFilterListState\", () => {\n  beforeEach(() => {\n    vi.clearAllMocks();\n  });\n\n  afterEach(() => {\n    vi.clearAllMocks();\n  });\n\n  it(\"initializes with empty filter states when no definitions\", () => {\n    const props = createProps({ filterDefinitions: undefined });\n    const { result } = renderHook(() => useFilterListState(props));\n    expect(result.current.filterStates.size).toBe(0);\n  });\n\n  it(\"initializes filter states from filterState for property filters\", () => {\n    const initialState = createSelectState([]);\n    const nameDef = createPropertyFilterDef(\n      \"name\",\n      \"CHECKBOX_LIST\",\n      initialState,\n    );\n    const props = createProps({\n      filterDefinitions: [nameDef],\n    });\n    const { result } = renderHook(() => useFilterListState(props));\n    expect(result.current.filterStates.get(getFilterKey(nameDef))).toEqual(\n      initialState,\n    );\n  });\n\n  it(\"updates filter state via setFilterState\", () => {\n    const nameDef = createPropertyFilterDef(\n      \"name\",\n      \"CHECKBOX_LIST\",\n      createSelectState([]),\n    );\n    const props = createProps({\n      filterDefinitions: [nameDef],\n    });\n    const { result } = renderHook(() => useFilterListState(props));\n    act(() => {\n      result.current.setFilterState(\n        getFilterKey(nameDef),\n        createSelectState([\"selected\"]),\n      );\n    });\n    expect(result.current.filterStates.get(getFilterKey(nameDef))).toEqual(\n      createSelectState([\"selected\"]),\n    );\n  });\n\n  it(\"calls onFilterStateChanged callback\", () => {\n    const onFilterStateChanged = vi.fn();\n    const nameDef = createPropertyFilterDef(\n      \"name\",\n      \"CHECKBOX_LIST\",\n      createSelectState([]),\n    );\n    const props = createProps({\n      filterDefinitions: [nameDef],\n      onFilterStateChanged,\n    });\n    const { result } = renderHook(() => useFilterListState(props));\n    const newState = createSelectState([\"selected\"]);\n    act(() => {\n      result.current.setFilterState(getFilterKey(nameDef), newState);\n    });\n    expect(onFilterStateChanged).toHaveBeenCalledWith(nameDef, newState);\n  });\n\n  it(\"builds whereClause from filter states\", () => {\n    const nameDef = createPropertyFilterDef(\n      \"name\",\n      \"CHECKBOX_LIST\",\n      createSelectState([]),\n    );\n    const props = createProps({\n      filterDefinitions: [nameDef],\n    });\n    const { result } = renderHook(() => useFilterListState(props));\n    act(() => {\n      result.current.setFilterState(\n        getFilterKey(nameDef),\n        createSelectState([\"John\"]),\n      );\n    });\n    expect(result.current.whereClause).toEqual({ name: \"John\" });\n  });\n\n  it(\"handles multiple filter definitions\", () => {\n    const nameDef = createPropertyFilterDef(\n      \"name\",\n      \"CHECKBOX_LIST\",\n      createSelectState([]),\n    );\n    const activeDef = createPropertyFilterDef(\n      \"active\",\n      \"TOGGLE\",\n      createToggleState(false),\n    );\n    const props = createProps({\n      filterDefinitions: [nameDef, activeDef],\n    });\n    const { result } = renderHook(() => useFilterListState(props));\n    act(() => {\n      result.current.setFilterState(\n        getFilterKey(nameDef),\n        createSelectState([\"John\"]),\n      );\n      result.current.setFilterState(\n        getFilterKey(activeDef),\n        createToggleState(true),\n      );\n    });\n    expect(result.current.whereClause).toEqual({\n      $and: [{ name: \"John\" }, { active: true }],\n    });\n  });\n});\n"],"mappings":"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","ignoreList":[]}

package/build/esm/filter-list/hooks/useDebouncedValue.js

@@ -0,0 +1,52 @@
+/*
+ * 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 { debounce } from "lodash-es";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+
+/**
+ * A hook that manages a local value with debounced updates to the parent.
+ * Useful for inputs where we want immediate visual feedback but delayed
+ * propagation of changes (e.g., search inputs, numeric inputs).
+ *
+ * @param externalValue The controlled value from the parent
+ * @param onChange Callback to propagate changes to the parent
+ * @param debounceMs Debounce delay in milliseconds
+ * @returns Tuple of [localValue, setLocalValue] where setLocalValue triggers debounced onChange
+ */
+export function useDebouncedValue(externalValue, onChange, debounceMs = 300) {
+  const [localValue, setLocalValue] = useState(externalValue);
+  const onChangeRef = useRef(onChange);
+  useEffect(() => {
+    onChangeRef.current = onChange;
+  }, [onChange]);
+  const debouncedOnChange = useMemo(() => debounce(value => onChangeRef.current(value), debounceMs), [debounceMs]);
+  useEffect(() => {
+    setLocalValue(externalValue);
+    debouncedOnChange.cancel();
+  }, [externalValue, debouncedOnChange]);
+  useEffect(() => {
+    return () => {
+      debouncedOnChange.cancel();
+    };
+  }, [debouncedOnChange]);
+  const setDebouncedValue = useCallback(newValue => {
+    setLocalValue(newValue);
+    debouncedOnChange(newValue);
+  }, [debouncedOnChange]);
+  return [localValue, setDebouncedValue];
+}
+//# sourceMappingURL=useDebouncedValue.js.map

package/build/esm/filter-list/hooks/useDebouncedValue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebouncedValue.js","names":["debounce","useCallback","useEffect","useMemo","useRef","useState","useDebouncedValue","externalValue","onChange","debounceMs","localValue","setLocalValue","onChangeRef","current","debouncedOnChange","value","cancel","setDebouncedValue","newValue"],"sources":["useDebouncedValue.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 { debounce } from \"lodash-es\";\nimport { useCallback, useEffect, useMemo, useRef, useState } from \"react\";\n\n/**\n * A hook that manages a local value with debounced updates to the parent.\n * Useful for inputs where we want immediate visual feedback but delayed\n * propagation of changes (e.g., search inputs, numeric inputs).\n *\n * @param externalValue The controlled value from the parent\n * @param onChange Callback to propagate changes to the parent\n * @param debounceMs Debounce delay in milliseconds\n * @returns Tuple of [localValue, setLocalValue] where setLocalValue triggers debounced onChange\n */\nexport function useDebouncedValue<T>(\n  externalValue: T,\n  onChange: (value: T) => void,\n  debounceMs: number = 300,\n): [T, (value: T) => void] {\n  const [localValue, setLocalValue] = useState<T>(externalValue);\n  const onChangeRef = useRef(onChange);\n\n  useEffect(() => {\n    onChangeRef.current = onChange;\n  }, [onChange]);\n\n  const debouncedOnChange = useMemo(\n    () => debounce((value: T) => onChangeRef.current(value), debounceMs),\n    [debounceMs],\n  );\n\n  useEffect(() => {\n    setLocalValue(externalValue);\n    debouncedOnChange.cancel();\n  }, [externalValue, debouncedOnChange]);\n\n  useEffect(() => {\n    return () => {\n      debouncedOnChange.cancel();\n    };\n  }, [debouncedOnChange]);\n\n  const setDebouncedValue = useCallback(\n    (newValue: T) => {\n      setLocalValue(newValue);\n      debouncedOnChange(newValue);\n    },\n    [debouncedOnChange],\n  );\n\n  return [localValue, setDebouncedValue];\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,QAAQ,QAAQ,WAAW;AACpC,SAASC,WAAW,EAAEC,SAAS,EAAEC,OAAO,EAAEC,MAAM,EAAEC,QAAQ,QAAQ,OAAO;;AAEzE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,iBAAiBA,CAC/BC,aAAgB,EAChBC,QAA4B,EAC5BC,UAAkB,GAAG,GAAG,EACC;EACzB,MAAM,CAACC,UAAU,EAAEC,aAAa,CAAC,GAAGN,QAAQ,CAAIE,aAAa,CAAC;EAC9D,MAAMK,WAAW,GAAGR,MAAM,CAACI,QAAQ,CAAC;EAEpCN,SAAS,CAAC,MAAM;IACdU,WAAW,CAACC,OAAO,GAAGL,QAAQ;EAChC,CAAC,EAAE,CAACA,QAAQ,CAAC,CAAC;EAEd,MAAMM,iBAAiB,GAAGX,OAAO,CAC/B,MAAMH,QAAQ,CAAEe,KAAQ,IAAKH,WAAW,CAACC,OAAO,CAACE,KAAK,CAAC,EAAEN,UAAU,CAAC,EACpE,CAACA,UAAU,CACb,CAAC;EAEDP,SAAS,CAAC,MAAM;IACdS,aAAa,CAACJ,aAAa,CAAC;IAC5BO,iBAAiB,CAACE,MAAM,CAAC,CAAC;EAC5B,CAAC,EAAE,CAACT,aAAa,EAAEO,iBAAiB,CAAC,CAAC;EAEtCZ,SAAS,CAAC,MAAM;IACd,OAAO,MAAM;MACXY,iBAAiB,CAACE,MAAM,CAAC,CAAC;IAC5B,CAAC;EACH,CAAC,EAAE,CAACF,iBAAiB,CAAC,CAAC;EAEvB,MAAMG,iBAAiB,GAAGhB,WAAW,CAClCiB,QAAW,IAAK;IACfP,aAAa,CAACO,QAAQ,CAAC;IACvBJ,iBAAiB,CAACI,QAAQ,CAAC;EAC7B,CAAC,EACD,CAACJ,iBAAiB,CACpB,CAAC;EAED,OAAO,CAACJ,UAAU,EAAEO,iBAAiB,CAAC;AACxC","ignoreList":[]}

package/build/esm/filter-list/hooks/useFilterListState.js

@@ -0,0 +1,119 @@
+/*
+ * 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 { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { assertUnreachable } from "../utils/assertUnreachable.js";
+import { buildWhereClause } from "../utils/filterStateToWhereClause.js";
+import { filterHasActiveState } from "../utils/filterValues.js";
+import { getFilterKey } from "../utils/getFilterKey.js";
+/**
+ * Build initial states from filter definitions.
+ * Uses string keys derived from getFilterKey() for stable lookups.
+ */
+function buildInitialStates(definitions) {
+  const states = new Map();
+  if (!definitions) {
+    return states;
+  }
+  for (const definition of definitions) {
+    const key = getFilterKey(definition);
+    switch (definition.type) {
+      case "PROPERTY":
+        {
+          const state = definition.filterState;
+          if (state) {
+            states.set(key, state);
+          }
+          break;
+        }
+      case "HAS_LINK":
+      case "KEYWORD_SEARCH":
+      case "CUSTOM":
+        {
+          const state = definition.defaultFilterState;
+          if (state) {
+            states.set(key, state);
+          }
+          break;
+        }
+      case "LINKED_PROPERTY":
+        {
+          const innerState = definition.defaultLinkedFilterState;
+          if (innerState) {
+            states.set(key, {
+              type: "linkedProperty",
+              linkedFilterState: innerState
+            });
+          }
+          break;
+        }
+      default:
+        assertUnreachable(definition);
+    }
+  }
+  return states;
+}
+export function useFilterListState(props) {
+  const {
+    objectSet,
+    filterDefinitions,
+    filterOperator = "and",
+    onFilterStateChanged,
+    onFilterClauseChanged
+  } = props;
+  const objectType = objectSet.$objectSetInternals.def;
+  const [filterStates, setFilterStates] = useState(() => buildInitialStates(filterDefinitions));
+  const setFilterState = useCallback((filterKey, state) => {
+    setFilterStates(prev => {
+      const next = new Map(prev);
+      next.set(filterKey, state);
+      return next;
+    });
+    const definition = filterDefinitions?.find(d => getFilterKey(d) === filterKey);
+    if (definition) {
+      onFilterStateChanged?.(definition, state);
+    }
+  }, [filterDefinitions, onFilterStateChanged]);
+  const whereClause = useMemo(() => buildWhereClause(filterDefinitions, filterStates, filterOperator, objectType), [filterDefinitions, filterStates, filterOperator, objectType]);
+  const isFirstRender = useRef(true);
+  useEffect(() => {
+    if (isFirstRender.current) {
+      isFirstRender.current = false;
+      return;
+    }
+    onFilterClauseChanged?.(whereClause);
+  }, [whereClause, onFilterClauseChanged]);
+  const activeFilterCount = useMemo(() => {
+    let count = 0;
+    for (const state of filterStates.values()) {
+      if (filterHasActiveState(state)) {
+        count++;
+      }
+    }
+    return count;
+  }, [filterStates]);
+  const reset = useCallback(() => {
+    setFilterStates(buildInitialStates(filterDefinitions));
+  }, [filterDefinitions]);
+  return useMemo(() => ({
+    filterStates,
+    setFilterState,
+    whereClause,
+    activeFilterCount,
+    reset
+  }), [filterStates, setFilterState, whereClause, activeFilterCount, reset]);
+}
+//# sourceMappingURL=useFilterListState.js.map

package/build/esm/filter-list/hooks/useFilterListState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFilterListState.js","names":["useCallback","useEffect","useMemo","useRef","useState","assertUnreachable","buildWhereClause","filterHasActiveState","getFilterKey","buildInitialStates","definitions","states","Map","definition","key","type","state","filterState","set","defaultFilterState","innerState","defaultLinkedFilterState","linkedFilterState","useFilterListState","props","objectSet","filterDefinitions","filterOperator","onFilterStateChanged","onFilterClauseChanged","objectType","$objectSetInternals","def","filterStates","setFilterStates","setFilterState","filterKey","prev","next","find","d","whereClause","isFirstRender","current","activeFilterCount","count","values","reset"],"sources":["useFilterListState.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 { useCallback, useEffect, useMemo, useRef, useState } from \"react\";\nimport type { FilterListProps } from \"../FilterListApi.js\";\nimport type { FilterState } from \"../FilterListItemApi.js\";\nimport type { LinkedPropertyFilterState } from \"../types/LinkedFilterTypes.js\";\nimport { assertUnreachable } from \"../utils/assertUnreachable.js\";\nimport { buildWhereClause } from \"../utils/filterStateToWhereClause.js\";\nimport { filterHasActiveState } from \"../utils/filterValues.js\";\nimport { getFilterKey } from \"../utils/getFilterKey.js\";\n\nexport interface UseFilterListStateResult<Q extends ObjectTypeDefinition> {\n  filterStates: Map<string, FilterState>;\n  setFilterState: (\n    filterKey: string,\n    state: FilterState,\n  ) => void;\n  whereClause: WhereClause<Q>;\n  activeFilterCount: number;\n  reset: () => void;\n}\n\n/**\n * Build initial states from filter definitions.\n * Uses string keys derived from getFilterKey() for stable lookups.\n */\nfunction buildInitialStates<Q extends ObjectTypeDefinition>(\n  definitions: FilterListProps<Q>[\"filterDefinitions\"],\n): Map<string, FilterState> {\n  const states = new Map<string, FilterState>();\n\n  if (!definitions) {\n    return states;\n  }\n\n  for (const definition of definitions) {\n    const key = getFilterKey(definition);\n    switch (definition.type) {\n      case \"PROPERTY\": {\n        const state = definition.filterState;\n        if (state) {\n          states.set(key, state);\n        }\n        break;\n      }\n      case \"HAS_LINK\":\n      case \"KEYWORD_SEARCH\":\n      case \"CUSTOM\": {\n        const state = definition.defaultFilterState;\n        if (state) {\n          states.set(key, state);\n        }\n        break;\n      }\n      case \"LINKED_PROPERTY\": {\n        const innerState = definition.defaultLinkedFilterState;\n        if (innerState) {\n          const state: LinkedPropertyFilterState = {\n            type: \"linkedProperty\",\n            linkedFilterState: innerState,\n          };\n          states.set(key, state);\n        }\n        break;\n      }\n      default:\n        assertUnreachable(definition);\n    }\n  }\n\n  return states;\n}\n\nexport function useFilterListState<Q extends ObjectTypeDefinition>(\n  props: FilterListProps<Q>,\n): UseFilterListStateResult<Q> {\n  const {\n    objectSet,\n    filterDefinitions,\n    filterOperator = \"and\",\n    onFilterStateChanged,\n    onFilterClauseChanged,\n  } = props;\n\n  const objectType = objectSet.$objectSetInternals.def;\n\n  const [filterStates, setFilterStates] = useState<\n    Map<string, FilterState>\n  >(() => buildInitialStates(filterDefinitions));\n\n  const setFilterState = useCallback(\n    (filterKey: string, state: FilterState) => {\n      setFilterStates((prev) => {\n        const next = new Map(prev);\n        next.set(filterKey, state);\n        return next;\n      });\n      const definition = filterDefinitions?.find(\n        (d) => getFilterKey(d) === filterKey,\n      );\n      if (definition) {\n        onFilterStateChanged?.(definition, state);\n      }\n    },\n    [filterDefinitions, onFilterStateChanged],\n  );\n\n  const whereClause = useMemo(\n    () =>\n      buildWhereClause(\n        filterDefinitions,\n        filterStates,\n        filterOperator,\n        objectType,\n      ),\n    [filterDefinitions, filterStates, filterOperator, objectType],\n  );\n\n  const isFirstRender = useRef(true);\n  useEffect(() => {\n    if (isFirstRender.current) {\n      isFirstRender.current = false;\n      return;\n    }\n    onFilterClauseChanged?.(whereClause);\n  }, [whereClause, onFilterClauseChanged]);\n\n  const activeFilterCount = useMemo(() => {\n    let count = 0;\n    for (const state of filterStates.values()) {\n      if (filterHasActiveState(state)) {\n        count++;\n      }\n    }\n    return count;\n  }, [filterStates]);\n\n  const reset = useCallback(() => {\n    setFilterStates(buildInitialStates(filterDefinitions));\n  }, [filterDefinitions]);\n\n  return useMemo(() => ({\n    filterStates,\n    setFilterState,\n    whereClause,\n    activeFilterCount,\n    reset,\n  }), [filterStates, setFilterState, whereClause, activeFilterCount, reset]);\n}\n"],"mappings":"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","ignoreList":[]}

package/build/esm/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) => a.value.localeCompare(b.value));
+    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