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

package/build/esm/filter-list/base/inputs/createHistogramBuckets.js

@@ -0,0 +1,53 @@
+/*
+ * 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 HISTOGRAM_BUCKETS = 20;
+export function createHistogramBuckets(pairs, range, toNumber, fromNumber) {
+  if (pairs.length === 0) return [];
+  const minNum = toNumber(range.min);
+  const maxNum = toNumber(range.max);
+  const rangeSize = maxNum - minNum;
+
+  // Handle single-value case
+  if (rangeSize === 0) {
+    const totalCount = pairs.reduce((sum, p) => sum + p.count, 0);
+    return [{
+      min: range.min,
+      max: range.max,
+      count: totalCount
+    }];
+  }
+
+  // Create buckets
+  const bucketSize = rangeSize / HISTOGRAM_BUCKETS;
+  const bucketCounts = new Array(HISTOGRAM_BUCKETS).fill(0);
+  for (const {
+    value,
+    count
+  } of pairs) {
+    const bucketIndex = Math.min(Math.floor((toNumber(value) - minNum) / bucketSize), HISTOGRAM_BUCKETS - 1);
+    bucketCounts[bucketIndex] += count;
+  }
+  return bucketCounts.map((count, i) => ({
+    min: fromNumber(minNum + i * bucketSize),
+    max: fromNumber(minNum + (i + 1) * bucketSize),
+    count
+  }));
+}
+export function getMaxBucketCount(buckets) {
+  return Math.max(...buckets.map(b => b.count), 1);
+}
+//# sourceMappingURL=createHistogramBuckets.js.map

package/build/esm/filter-list/base/inputs/createHistogramBuckets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createHistogramBuckets.js","names":["HISTOGRAM_BUCKETS","createHistogramBuckets","pairs","range","toNumber","fromNumber","length","minNum","min","maxNum","max","rangeSize","totalCount","reduce","sum","p","count","bucketSize","bucketCounts","Array","fill","value","bucketIndex","Math","floor","map","i","getMaxBucketCount","buckets","b"],"sources":["createHistogramBuckets.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 const HISTOGRAM_BUCKETS = 20;\n\nexport interface HistogramBucket<T> {\n  min: T;\n  max: T;\n  count: number;\n}\n\ninterface ValueCountPair<T> {\n  value: T;\n  count: number;\n}\n\nexport function createHistogramBuckets<T>(\n  pairs: Array<ValueCountPair<T>>,\n  range: { min: T; max: T },\n  toNumber: (value: T) => number,\n  fromNumber: (value: number) => T,\n): Array<HistogramBucket<T>> {\n  if (pairs.length === 0) return [];\n\n  const minNum = toNumber(range.min);\n  const maxNum = toNumber(range.max);\n  const rangeSize = maxNum - minNum;\n\n  // Handle single-value case\n  if (rangeSize === 0) {\n    const totalCount = pairs.reduce((sum, p) => sum + p.count, 0);\n    return [{ min: range.min, max: range.max, count: totalCount }];\n  }\n\n  // Create buckets\n  const bucketSize = rangeSize / HISTOGRAM_BUCKETS;\n  const bucketCounts = new Array<number>(HISTOGRAM_BUCKETS).fill(0);\n\n  for (const { value, count } of pairs) {\n    const bucketIndex = Math.min(\n      Math.floor((toNumber(value) - minNum) / bucketSize),\n      HISTOGRAM_BUCKETS - 1,\n    );\n    bucketCounts[bucketIndex] += count;\n  }\n\n  return bucketCounts.map((count, i) => ({\n    min: fromNumber(minNum + i * bucketSize),\n    max: fromNumber(minNum + (i + 1) * bucketSize),\n    count,\n  }));\n}\n\nexport function getMaxBucketCount<T>(\n  buckets: Array<HistogramBucket<T>>,\n): number {\n  return Math.max(...buckets.map((b) => b.count), 1);\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAO,MAAMA,iBAAiB,GAAG,EAAE;AAanC,OAAO,SAASC,sBAAsBA,CACpCC,KAA+B,EAC/BC,KAAyB,EACzBC,QAA8B,EAC9BC,UAAgC,EACL;EAC3B,IAAIH,KAAK,CAACI,MAAM,KAAK,CAAC,EAAE,OAAO,EAAE;EAEjC,MAAMC,MAAM,GAAGH,QAAQ,CAACD,KAAK,CAACK,GAAG,CAAC;EAClC,MAAMC,MAAM,GAAGL,QAAQ,CAACD,KAAK,CAACO,GAAG,CAAC;EAClC,MAAMC,SAAS,GAAGF,MAAM,GAAGF,MAAM;;EAEjC;EACA,IAAII,SAAS,KAAK,CAAC,EAAE;IACnB,MAAMC,UAAU,GAAGV,KAAK,CAACW,MAAM,CAAC,CAACC,GAAG,EAAEC,CAAC,KAAKD,GAAG,GAAGC,CAAC,CAACC,KAAK,EAAE,CAAC,CAAC;IAC7D,OAAO,CAAC;MAAER,GAAG,EAAEL,KAAK,CAACK,GAAG;MAAEE,GAAG,EAAEP,KAAK,CAACO,GAAG;MAAEM,KAAK,EAAEJ;IAAW,CAAC,CAAC;EAChE;;EAEA;EACA,MAAMK,UAAU,GAAGN,SAAS,GAAGX,iBAAiB;EAChD,MAAMkB,YAAY,GAAG,IAAIC,KAAK,CAASnB,iBAAiB,CAAC,CAACoB,IAAI,CAAC,CAAC,CAAC;EAEjE,KAAK,MAAM;IAAEC,KAAK;IAAEL;EAAM,CAAC,IAAId,KAAK,EAAE;IACpC,MAAMoB,WAAW,GAAGC,IAAI,CAACf,GAAG,CAC1Be,IAAI,CAACC,KAAK,CAAC,CAACpB,QAAQ,CAACiB,KAAK,CAAC,GAAGd,MAAM,IAAIU,UAAU,CAAC,EACnDjB,iBAAiB,GAAG,CACtB,CAAC;IACDkB,YAAY,CAACI,WAAW,CAAC,IAAIN,KAAK;EACpC;EAEA,OAAOE,YAAY,CAACO,GAAG,CAAC,CAACT,KAAK,EAAEU,CAAC,MAAM;IACrClB,GAAG,EAAEH,UAAU,CAACE,MAAM,GAAGmB,CAAC,GAAGT,UAAU,CAAC;IACxCP,GAAG,EAAEL,UAAU,CAACE,MAAM,GAAG,CAACmB,CAAC,GAAG,CAAC,IAAIT,UAAU,CAAC;IAC9CD;EACF,CAAC,CAAC,CAAC;AACL;AAEA,OAAO,SAASW,iBAAiBA,CAC/BC,OAAkC,EAC1B;EACR,OAAOL,IAAI,CAACb,GAAG,CAAC,GAAGkB,OAAO,CAACH,GAAG,CAAEI,CAAC,IAAKA,CAAC,CAACb,KAAK,CAAC,EAAE,CAAC,CAAC;AACpD","ignoreList":[]}

package/build/esm/filter-list/base/inputs/dateUtils.js

@@ -0,0 +1,57 @@
+/*
+ * 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.
+ */
+
+/**
+ * Date utilities for HTML date inputs.
+ *
+ * These functions operate on local time by design. HTML <input type="date">
+ * returns and expects values in "YYYY-MM-DD" format without timezone info.
+ *
+ * `parseDateFromInput` appends "T00:00:00" (no "Z") so the date is parsed as
+ * local midnight rather than UTC midnight. Without this, negative-offset
+ * timezones (e.g. US timezones) would shift "2024-01-15" to Jan 14 locally.
+ *
+ * Consumers providing dates from an API (typically UTC) should handle
+ * UTC-to-local conversion before passing values to these functions.
+ */
+
+export function formatDateForInput(date) {
+  if (!date) return "";
+  const year = date.getFullYear();
+  const month = String(date.getMonth() + 1).padStart(2, "0");
+  const day = String(date.getDate()).padStart(2, "0");
+  return `${year}-${month}-${day}`;
+}
+export function parseDateFromInput(value) {
+  if (!value) return undefined;
+  const date = new Date(value + "T00:00:00");
+  return isNaN(date.getTime()) ? undefined : date;
+}
+export function formatDateForDisplay(date, fallback = "") {
+  if (!date) return fallback;
+  return date.toLocaleDateString(undefined, {
+    year: "numeric",
+    month: "short",
+    day: "numeric"
+  });
+}
+export function parseDateFromISO(value) {
+  if (value == null) return undefined;
+  if (value instanceof Date) return value;
+  const date = new Date(value);
+  return isNaN(date.getTime()) ? undefined : date;
+}
+//# sourceMappingURL=dateUtils.js.map

package/build/esm/filter-list/base/inputs/dateUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dateUtils.js","names":["formatDateForInput","date","year","getFullYear","month","String","getMonth","padStart","day","getDate","parseDateFromInput","value","undefined","Date","isNaN","getTime","formatDateForDisplay","fallback","toLocaleDateString","parseDateFromISO"],"sources":["dateUtils.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 * Date utilities for HTML date inputs.\n *\n * These functions operate on local time by design. HTML <input type=\"date\">\n * returns and expects values in \"YYYY-MM-DD\" format without timezone info.\n *\n * `parseDateFromInput` appends \"T00:00:00\" (no \"Z\") so the date is parsed as\n * local midnight rather than UTC midnight. Without this, negative-offset\n * timezones (e.g. US timezones) would shift \"2024-01-15\" to Jan 14 locally.\n *\n * Consumers providing dates from an API (typically UTC) should handle\n * UTC-to-local conversion before passing values to these functions.\n */\n\nexport function formatDateForInput(date: Date | undefined): string {\n  if (!date) return \"\";\n  const year = date.getFullYear();\n  const month = String(date.getMonth() + 1).padStart(2, \"0\");\n  const day = String(date.getDate()).padStart(2, \"0\");\n  return `${year}-${month}-${day}`;\n}\n\nexport function parseDateFromInput(value: string): Date | undefined {\n  if (!value) return undefined;\n  const date = new Date(value + \"T00:00:00\");\n  return isNaN(date.getTime()) ? undefined : date;\n}\n\nexport function formatDateForDisplay(\n  date: Date | undefined,\n  fallback: string = \"\",\n): string {\n  if (!date) return fallback;\n  return date.toLocaleDateString(undefined, {\n    year: \"numeric\",\n    month: \"short\",\n    day: \"numeric\",\n  });\n}\n\nexport function parseDateFromISO(\n  value: string | Date | undefined | null,\n): Date | undefined {\n  if (value == null) return undefined;\n  if (value instanceof Date) return value;\n  const date = new Date(value);\n  return isNaN(date.getTime()) ? undefined : date;\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAO,SAASA,kBAAkBA,CAACC,IAAsB,EAAU;EACjE,IAAI,CAACA,IAAI,EAAE,OAAO,EAAE;EACpB,MAAMC,IAAI,GAAGD,IAAI,CAACE,WAAW,CAAC,CAAC;EAC/B,MAAMC,KAAK,GAAGC,MAAM,CAACJ,IAAI,CAACK,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAACC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;EAC1D,MAAMC,GAAG,GAAGH,MAAM,CAACJ,IAAI,CAACQ,OAAO,CAAC,CAAC,CAAC,CAACF,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;EACnD,OAAO,GAAGL,IAAI,IAAIE,KAAK,IAAII,GAAG,EAAE;AAClC;AAEA,OAAO,SAASE,kBAAkBA,CAACC,KAAa,EAAoB;EAClE,IAAI,CAACA,KAAK,EAAE,OAAOC,SAAS;EAC5B,MAAMX,IAAI,GAAG,IAAIY,IAAI,CAACF,KAAK,GAAG,WAAW,CAAC;EAC1C,OAAOG,KAAK,CAACb,IAAI,CAACc,OAAO,CAAC,CAAC,CAAC,GAAGH,SAAS,GAAGX,IAAI;AACjD;AAEA,OAAO,SAASe,oBAAoBA,CAClCf,IAAsB,EACtBgB,QAAgB,GAAG,EAAE,EACb;EACR,IAAI,CAAChB,IAAI,EAAE,OAAOgB,QAAQ;EAC1B,OAAOhB,IAAI,CAACiB,kBAAkB,CAACN,SAAS,EAAE;IACxCV,IAAI,EAAE,SAAS;IACfE,KAAK,EAAE,OAAO;IACdI,GAAG,EAAE;EACP,CAAC,CAAC;AACJ;AAEA,OAAO,SAASW,gBAAgBA,CAC9BR,KAAuC,EACrB;EAClB,IAAIA,KAAK,IAAI,IAAI,EAAE,OAAOC,SAAS;EACnC,IAAID,KAAK,YAAYE,IAAI,EAAE,OAAOF,KAAK;EACvC,MAAMV,IAAI,GAAG,IAAIY,IAAI,CAACF,KAAK,CAAC;EAC5B,OAAOG,KAAK,CAACb,IAAI,CAACc,OAAO,CAAC,CAAC,CAAC,GAAGH,SAAS,GAAGX,IAAI;AACjD","ignoreList":[]}

package/build/esm/filter-list/base/inputs/index.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.
+ */
+
+export { CheckboxListInput } from "./CheckboxListInput.js";
+export { ContainsTextInput } from "./ContainsTextInput.js";
+export { DateRangeInput } from "./DateRangeInput.js";
+export { formatDateForDisplay, formatDateForInput, parseDateFromInput } from "./dateUtils.js";
+export { NullValueWrapper } from "./NullValueWrapper.js";
+export { NumberRangeInput } from "./NumberRangeInput.js";
+export { RangeInput } from "./RangeInput.js";
+export { ToggleInput } from "./ToggleInput.js";
+//# sourceMappingURL=index.js.map

package/build/esm/filter-list/base/inputs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["CheckboxListInput","ContainsTextInput","DateRangeInput","formatDateForDisplay","formatDateForInput","parseDateFromInput","NullValueWrapper","NumberRangeInput","RangeInput","ToggleInput"],"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 { CheckboxListInput } from \"./CheckboxListInput.js\";\nexport { ContainsTextInput } from \"./ContainsTextInput.js\";\nexport { DateRangeInput } from \"./DateRangeInput.js\";\nexport {\n  formatDateForDisplay,\n  formatDateForInput,\n  parseDateFromInput,\n} from \"./dateUtils.js\";\nexport { NullValueWrapper } from \"./NullValueWrapper.js\";\nexport { NumberRangeInput } from \"./NumberRangeInput.js\";\nexport { RangeInput } from \"./RangeInput.js\";\nexport { ToggleInput } from \"./ToggleInput.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,iBAAiB,QAAQ,wBAAwB;AAC1D,SAASC,iBAAiB,QAAQ,wBAAwB;AAC1D,SAASC,cAAc,QAAQ,qBAAqB;AACpD,SACEC,oBAAoB,EACpBC,kBAAkB,EAClBC,kBAAkB,QACb,gBAAgB;AACvB,SAASC,gBAAgB,QAAQ,uBAAuB;AACxD,SAASC,gBAAgB,QAAQ,uBAAuB;AACxD,SAASC,UAAU,QAAQ,iBAAiB;AAC5C,SAASC,WAAW,QAAQ,kBAAkB","ignoreList":[]}

package/build/esm/filter-list/base/inputs/shared.module.css

@@ -0,0 +1,79 @@
+/*
+ * 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.
+ */
+
+/* Shared message styles for filter inputs */
+.loadingMessage,
+.errorMessage,
+.emptyMessage {
+  font-size: var(--osdk-typography-size-body-small);
+  padding: var(--osdk-surface-spacing);
+}
+
+.loadingMessage,
+.emptyMessage {
+  color: var(--osdk-typography-color-muted);
+}
+
+.errorMessage {
+  color: var(--osdk-intent-danger-rest);
+}
+
+/* Shared tag styles */
+.tagContainer {
+  display: flex;
+  flex-wrap: wrap;
+  gap: var(--osdk-filter-tag-container-gap);
+}
+
+.tag {
+  display: inline-flex;
+  align-items: center;
+  gap: var(--osdk-filter-tag-gap);
+  padding: var(--osdk-filter-tag-padding);
+  border-radius: var(--osdk-filter-tag-border-radius);
+  background-color: var(--osdk-filter-tag-bg);
+  font-family: var(--osdk-filter-tag-font-family);
+  font-size: var(--osdk-filter-tag-font-size);
+  line-height: var(--osdk-filter-tag-line-height);
+  color: var(--osdk-filter-tag-color);
+}
+
+.tagRemove {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: 0;
+  border: none;
+  background: transparent;
+  cursor: pointer;
+  color: var(--osdk-filter-tag-remove-color);
+  font-size: var(--osdk-filter-tag-remove-font-size);
+  line-height: 1;
+  transition: color var(--osdk-filter-tag-remove-transition);
+
+  &:hover {
+    color: var(--osdk-filter-tag-remove-color-hover);
+  }
+
+  &:focus-visible {
+    outline: var(--osdk-filter-input-focus-outline-width) solid var(--osdk-filter-input-focus-outline-color);
+    outline-offset: var(--osdk-filter-input-focus-outline-offset);
+  }
+
+  @media (prefers-reduced-motion: reduce) {
+    transition: none;
+  }
+}

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/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, useMemo, 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) => {
+    let newWhereClause;
+    setFilterStates(prev => {
+      const next = new Map(prev);
+      next.set(filterKey, state);
+      newWhereClause = buildWhereClause(filterDefinitions, next, filterOperator, objectType);
+      return next;
+    });
+    if (newWhereClause !== undefined) {
+      onFilterClauseChanged?.(newWhereClause);
+    }
+    const definition = filterDefinitions?.find(d => getFilterKey(d) === filterKey);
+    if (definition) {
+      onFilterStateChanged?.(definition, state);
+    }
+  }, [filterDefinitions, filterOperator, objectType, onFilterClauseChanged, onFilterStateChanged]);
+  const whereClause = useMemo(() => buildWhereClause(filterDefinitions, filterStates, filterOperator, objectType), [filterDefinitions, filterStates, filterOperator, objectType]);
+  const activeFilterCount = useMemo(() => {
+    let count = 0;
+    for (const state of filterStates.values()) {
+      if (filterHasActiveState(state)) {
+        count++;
+      }
+    }
+    return count;
+  }, [filterStates]);
+  const reset = useCallback(() => {
+    const initialStates = buildInitialStates(filterDefinitions);
+    setFilterStates(initialStates);
+    const newWhereClause = buildWhereClause(filterDefinitions, initialStates, filterOperator, objectType);
+    onFilterClauseChanged?.(newWhereClause);
+  }, [filterDefinitions, filterOperator, objectType, onFilterClauseChanged]);
+  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","useMemo","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","newWhereClause","prev","next","undefined","find","d","whereClause","activeFilterCount","count","values","reset","initialStates"],"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, useMemo, 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      let newWhereClause: WhereClause<Q> | undefined;\n\n      setFilterStates((prev) => {\n        const next = new Map(prev);\n        next.set(filterKey, state);\n\n        newWhereClause = buildWhereClause(\n          filterDefinitions,\n          next,\n          filterOperator,\n          objectType,\n        );\n\n        return next;\n      });\n\n      if (newWhereClause !== undefined) {\n        onFilterClauseChanged?.(newWhereClause);\n      }\n      const definition = filterDefinitions?.find(\n        (d) => getFilterKey(d) === filterKey,\n      );\n      if (definition) {\n        onFilterStateChanged?.(definition, state);\n      }\n    },\n    [\n      filterDefinitions,\n      filterOperator,\n      objectType,\n      onFilterClauseChanged,\n      onFilterStateChanged,\n    ],\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 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    const initialStates = buildInitialStates(filterDefinitions);\n    setFilterStates(initialStates);\n\n    const newWhereClause = buildWhereClause(\n      filterDefinitions,\n      initialStates,\n      filterOperator,\n      objectType,\n    );\n    onFilterClauseChanged?.(newWhereClause);\n  }, [filterDefinitions, filterOperator, objectType, onFilterClauseChanged]);\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) => b.count - a.count);
+    if (options?.limit && values.length > options.limit) {
+      return {
+        data: values.slice(0, options.limit),
+        maxCount
+      };
+    }
+    return {
+      data: values,
+      maxCount
+    };
+  }, [countData, propertyKey, options?.limit]);
+  return {
+    data: result.data,
+    maxCount: result.maxCount,
+    isLoading,
+    error: error ?? null
+  };
+}
+//# sourceMappingURL=usePropertyAggregation.js.map

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

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

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

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