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

package/build/browser/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/browser/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":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA,SAASA,GAAG,EAAEC,UAAU,QAAQ,wBAAwB;AACxD,SAASC,SAAS,EAAEC,UAAU,EAAEC,QAAQ,EAAEC,MAAM,EAAEC,EAAE,EAAEC,EAAE,QAAQ,QAAQ;AACxE,SACEC,uBAAuB,EACvBC,iBAAiB,EACjBC,iBAAiB,EACjBC,cAAc,QACT,8BAA8B;AAErC,SAASC,YAAY,QAAQ,6BAA6B;AAC1D,SAASC,kBAAkB,QAAQ,0BAA0B;AAE7D,SAASC,mBAAmBA,CAAA,EAAqC;EAC/D,OAAO;IACLC,mBAAmB,EAAE;MACnBC,GAAG,EAAEL;IACP;EACF,CAAC;AACH;AAEA,SAASM,WAAWA,CAClBC,SAA0D,GAAG,CAAC,CAAC,EACvB;EACxC,OAAO;IACLC,SAAS,EAAEL,mBAAmB,CAAC,CAAC;IAChC,GAAGI;EACL,CAAC;AACH;AAEAd,QAAQ,CAAC,oBAAoB,EAAE,MAAM;EACnCD,UAAU,CAAC,MAAM;IACfI,EAAE,CAACa,aAAa,CAAC,CAAC;EACpB,CAAC,CAAC;EAEFlB,SAAS,CAAC,MAAM;IACdK,EAAE,CAACa,aAAa,CAAC,CAAC;EACpB,CAAC,CAAC;EAEFd,EAAE,CAAC,0DAA0D,EAAE,MAAM;IACnE,MAAMe,KAAK,GAAGJ,WAAW,CAAC;MAAEK,iBAAiB,EAAEC;IAAU,CAAC,CAAC;IAC3D,MAAM;MAAEC;IAAO,CAAC,GAAGvB,UAAU,CAAC,MAAMY,kBAAkB,CAACQ,KAAK,CAAC,CAAC;IAC9DhB,MAAM,CAACmB,MAAM,CAACC,OAAO,CAACC,YAAY,CAACC,IAAI,CAAC,CAACC,IAAI,CAAC,CAAC,CAAC;EAClD,CAAC,CAAC;EAEFtB,EAAE,CAAC,iEAAiE,EAAE,MAAM;IAC1E,MAAMuB,YAAY,GAAGpB,iBAAiB,CAAC,EAAE,CAAC;IAC1C,MAAMqB,OAAO,GAAGtB,uBAAuB,CACrC,MAAM,EACN,eAAe,EACfqB,YACF,CAAC;IACD,MAAMR,KAAK,GAAGJ,WAAW,CAAC;MACxBK,iBAAiB,EAAE,CAACQ,OAAO;IAC7B,CAAC,CAAC;IACF,MAAM;MAAEN;IAAO,CAAC,GAAGvB,UAAU,CAAC,MAAMY,kBAAkB,CAACQ,KAAK,CAAC,CAAC;IAC9DhB,MAAM,CAACmB,MAAM,CAACC,OAAO,CAACC,YAAY,CAACK,GAAG,CAACnB,YAAY,CAACkB,OAAO,CAAC,CAAC,CAAC,CAACE,OAAO,CACpEH,YACF,CAAC;EACH,CAAC,CAAC;EAEFvB,EAAE,CAAC,yCAAyC,EAAE,MAAM;IAClD,MAAMwB,OAAO,GAAGtB,uBAAuB,CACrC,MAAM,EACN,eAAe,EACfC,iBAAiB,CAAC,EAAE,CACtB,CAAC;IACD,MAAMY,KAAK,GAAGJ,WAAW,CAAC;MACxBK,iBAAiB,EAAE,CAACQ,OAAO;IAC7B,CAAC,CAAC;IACF,MAAM;MAAEN;IAAO,CAAC,GAAGvB,UAAU,CAAC,MAAMY,kBAAkB,CAACQ,KAAK,CAAC,CAAC;IAC9DrB,GAAG,CAAC,MAAM;MACRwB,MAAM,CAACC,OAAO,CAACQ,cAAc,CAC3BrB,YAAY,CAACkB,OAAO,CAAC,EACrBrB,iBAAiB,CAAC,CAAC,UAAU,CAAC,CAChC,CAAC;IACH,CAAC,CAAC;IACFJ,MAAM,CAACmB,MAAM,CAACC,OAAO,CAACC,YAAY,CAACK,GAAG,CAACnB,YAAY,CAACkB,OAAO,CAAC,CAAC,CAAC,CAACE,OAAO,CACpEvB,iBAAiB,CAAC,CAAC,UAAU,CAAC,CAChC,CAAC;EACH,CAAC,CAAC;EAEFH,EAAE,CAAC,qCAAqC,EAAE,MAAM;IAC9C,MAAM4B,oBAAoB,GAAG3B,EAAE,CAAC4B,EAAE,CAAC,CAAC;IACpC,MAAML,OAAO,GAAGtB,uBAAuB,CACrC,MAAM,EACN,eAAe,EACfC,iBAAiB,CAAC,EAAE,CACtB,CAAC;IACD,MAAMY,KAAK,GAAGJ,WAAW,CAAC;MACxBK,iBAAiB,EAAE,CAACQ,OAAO,CAAC;MAC5BI;IACF,CAAC,CAAC;IACF,MAAM;MAAEV;IAAO,CAAC,GAAGvB,UAAU,CAAC,MAAMY,kBAAkB,CAACQ,KAAK,CAAC,CAAC;IAC9D,MAAMe,QAAQ,GAAG3B,iBAAiB,CAAC,CAAC,UAAU,CAAC,CAAC;IAChDT,GAAG,CAAC,MAAM;MACRwB,MAAM,CAACC,OAAO,CAACQ,cAAc,CAACrB,YAAY,CAACkB,OAAO,CAAC,EAAEM,QAAQ,CAAC;IAChE,CAAC,CAAC;IACF/B,MAAM,CAAC6B,oBAAoB,CAAC,CAACG,oBAAoB,CAACP,OAAO,EAAEM,QAAQ,CAAC;EACtE,CAAC,CAAC;EAEF9B,EAAE,CAAC,uCAAuC,EAAE,MAAM;IAChD,MAAMwB,OAAO,GAAGtB,uBAAuB,CACrC,MAAM,EACN,eAAe,EACfC,iBAAiB,CAAC,EAAE,CACtB,CAAC;IACD,MAAMY,KAAK,GAAGJ,WAAW,CAAC;MACxBK,iBAAiB,EAAE,CAACQ,OAAO;IAC7B,CAAC,CAAC;IACF,MAAM;MAAEN;IAAO,CAAC,GAAGvB,UAAU,CAAC,MAAMY,kBAAkB,CAACQ,KAAK,CAAC,CAAC;IAC9DrB,GAAG,CAAC,MAAM;MACRwB,MAAM,CAACC,OAAO,CAACQ,cAAc,CAC3BrB,YAAY,CAACkB,OAAO,CAAC,EACrBrB,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAC5B,CAAC;IACH,CAAC,CAAC;IACFJ,MAAM,CAACmB,MAAM,CAACC,OAAO,CAACa,WAAW,CAAC,CAACN,OAAO,CAAC;MAAEO,IAAI,EAAE;IAAO,CAAC,CAAC;EAC9D,CAAC,CAAC;EAEFjC,EAAE,CAAC,qCAAqC,EAAE,MAAM;IAC9C,MAAMwB,OAAO,GAAGtB,uBAAuB,CACrC,MAAM,EACN,eAAe,EACfC,iBAAiB,CAAC,EAAE,CACtB,CAAC;IACD,MAAM+B,SAAS,GAAGhC,uBAAuB,CACvC,QAAQ,EACR,QAAQ,EACRE,iBAAiB,CAAC,KAAK,CACzB,CAAC;IACD,MAAMW,KAAK,GAAGJ,WAAW,CAAC;MACxBK,iBAAiB,EAAE,CAACQ,OAAO,EAAEU,SAAS;IACxC,CAAC,CAAC;IACF,MAAM;MAAEhB;IAAO,CAAC,GAAGvB,UAAU,CAAC,MAAMY,kBAAkB,CAACQ,KAAK,CAAC,CAAC;IAC9DrB,GAAG,CAAC,MAAM;MACRwB,MAAM,CAACC,OAAO,CAACQ,cAAc,CAC3BrB,YAAY,CAACkB,OAAO,CAAC,EACrBrB,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAC5B,CAAC;MACDe,MAAM,CAACC,OAAO,CAACQ,cAAc,CAC3BrB,YAAY,CAAC4B,SAAS,CAAC,EACvB9B,iBAAiB,CAAC,IAAI,CACxB,CAAC;IACH,CAAC,CAAC;IACFL,MAAM,CAACmB,MAAM,CAACC,OAAO,CAACa,WAAW,CAAC,CAACN,OAAO,CAAC;MACzCS,IAAI,EAAE,CAAC;QAAEF,IAAI,EAAE;MAAO,CAAC,EAAE;QAAEG,MAAM,EAAE;MAAK,CAAC;IAC3C,CAAC,CAAC;EACJ,CAAC,CAAC;AACJ,CAAC,CAAC","ignoreList":[]}

package/build/browser/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/browser/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/browser/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/browser/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/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) => 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

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","localeCompare","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\";\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 Iterable<{\n        $group: Record<string, unknown>;\n        $count?: number;\n      }>;\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) => a.value.localeCompare(b.value));\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;AAsB/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;;IAMA,KAAK,MAAME,IAAI,IALGR,SAAS,EAKG;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,KAAKD,CAAC,CAACN,KAAK,CAACQ,aAAa,CAACD,CAAC,CAACP,KAAK,CAAC,CAAC;IAErD,IAAIrB,OAAO,EAAE8B,KAAK,IAAIf,MAAM,CAACgB,MAAM,GAAG/B,OAAO,CAAC8B,KAAK,EAAE;MACnD,OAAO;QAAEvB,IAAI,EAAEQ,MAAM,CAACiB,KAAK,CAAC,CAAC,EAAEhC,OAAO,CAAC8B,KAAK,CAAC;QAAEhB;MAAS,CAAC;IAC3D;IAEA,OAAO;MAAEP,IAAI,EAAEQ,MAAM;MAAED;IAAS,CAAC;EACnC,CAAC,EACD,CAACN,SAAS,EAAET,WAAW,EAAEC,OAAO,EAAE8B,KAAK,CACzC,CAAC;EAED,OAAO;IACLvB,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 * 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   * 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\n/**\n * Props for the add filter menu component\n */\nexport interface AddFilterMenuProps {\n  /**\n   * Available filter templates to display\n   */\n  templates: FilterTemplate[];\n\n  /**\n   * Current count of active filters by key\n   */\n  activeCounts: Record<string, number>;\n\n  /**\n   * Called when a filter template is selected\n   */\n  onSelectFilter: (template: FilterTemplate) => void;\n\n  /**\n   * Called when the menu should be closed\n   */\n  onClose: () => void;\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/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"],"mappings":"","ignoreList":[]}

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

@@ -0,0 +1,21 @@
+/*
+ * 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 "./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 \"./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,yBAAyB;AACvC,cAAc,wBAAwB","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;\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":[]}