@osdk/react-components 0.48.0 → 0.49.0-main-ff0ef7e7cc3986538c90f5632028a422b404d2eb

package/build/esm/filter-list/FilterList.js.map

@@ -1 +1 @@
-{"version":3,"file":"FilterList.js","names":["React","useCallback","useMemo","AddFilterPopover","BaseFilterList","FilterInput","useFilterListState","useFilterVisibility","EMPTY_LINKED_FILTERS","getEmptyDisplayState","getFilterKey","getFilterLabel","EMPTY_WHERE","FilterList","props","objectType","objectSet","title","titleIcon","collapsed","onCollapsedChange","filterDefinitions","addFilterMode","showResetButton","onReset","showActiveFilterCount","showFilteredOutValues","className","enableSorting","onFilterAdded","onFilterRemoved","onFilterVisibilityChange","renderAddFilterButton","filterStates","setFilterState","clearFilterState","perFilterWhereClauses","perFilterLinkedFilters","activeFilterCount","hasChangesFromInitial","reset","uncontrolledAddFilterMode","handleVisibilityChange","visibleKeys","hiddenKeys","states","map","key","filterKey","isVisible","visibleDefinitions","managedVisibleDefinitions","hiddenDefinitions","managedHiddenDefinitions","showFilter","hideFilter","reorderVisible","hasVisibilityChanges","resetVisibility","undefined","handleReset","simpleVisibleDefinitions","filter","def","effectiveVisibleDefinitions","handleFilterRemoved","handleFilterShown","handleOrderChange","orderedKeys","hiddenFilterItems","label","effectiveRenderAddFilterButton","length","createElement","onShowFilter","renderTrigger","effectiveOnFilterRemoved","renderInput","definition","filterState","onFilterStateChanged","searchQuery","excludeRowOpen","whereClause","get","linkedFilters","canReset","onOrderChange"],"sources":["FilterList.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 { ObjectTypeDefinition } from \"@osdk/api\";\nimport React, { useCallback, useMemo } from \"react\";\n\nimport { AddFilterPopover } from \"./base/AddFilterPopover.js\";\nimport { BaseFilterList } from \"./base/BaseFilterList.js\";\nimport type { RenderFilterInput } from \"./base/BaseFilterListApi.js\";\nimport { FilterInput } from \"./FilterInput.js\";\nimport type {\n  FilterDefinitionUnion,\n  FilterKey,\n  FilterListProps,\n} from \"./FilterListApi.js\";\nimport { useFilterListState } from \"./hooks/useFilterListState.js\";\nimport { useFilterVisibility } from \"./hooks/useFilterVisibility.js\";\nimport { EMPTY_LINKED_FILTERS } from \"./types/LinkedFilterTypes.js\";\nimport { getEmptyDisplayState } from \"./utils/emptyFilterDisplayState.js\";\nimport { getFilterKey } from \"./utils/getFilterKey.js\";\nimport { getFilterLabel } from \"./utils/getFilterLabel.js\";\n\nconst EMPTY_WHERE = {};\n\nexport function FilterList<Q extends ObjectTypeDefinition>(\n  props: FilterListProps<Q>,\n): React.ReactElement {\n  const {\n    objectType,\n    objectSet,\n    title,\n    titleIcon,\n    collapsed,\n    onCollapsedChange,\n    filterDefinitions,\n    addFilterMode = \"uncontrolled\",\n    showResetButton = false,\n    onReset,\n    showActiveFilterCount = false,\n    showFilteredOutValues = false,\n    className,\n    enableSorting,\n    onFilterAdded,\n    onFilterRemoved,\n    onFilterVisibilityChange,\n    renderAddFilterButton,\n  } = props;\n\n  const {\n    filterStates,\n    setFilterState,\n    clearFilterState,\n    perFilterWhereClauses,\n    perFilterLinkedFilters,\n    activeFilterCount,\n    hasChangesFromInitial,\n    reset,\n  } = useFilterListState(props);\n\n  const uncontrolledAddFilterMode = addFilterMode === \"uncontrolled\";\n\n  const handleVisibilityChange = useCallback(\n    (visibleKeys: string[], hiddenKeys: string[]) => {\n      if (!onFilterVisibilityChange) {\n        return;\n      }\n      const states: Array<{ filterKey: FilterKey<Q>; isVisible: boolean }> = [\n        ...visibleKeys.map((key) => ({\n          filterKey: key as FilterKey<Q>,\n          isVisible: true,\n        })),\n        ...hiddenKeys.map((key) => ({\n          filterKey: key as FilterKey<Q>,\n          isVisible: false,\n        })),\n      ];\n      onFilterVisibilityChange(states);\n    },\n    [onFilterVisibilityChange],\n  );\n\n  const {\n    visibleDefinitions: managedVisibleDefinitions,\n    hiddenDefinitions: managedHiddenDefinitions,\n    showFilter,\n    hideFilter,\n    reorderVisible,\n    hasVisibilityChanges,\n    resetVisibility,\n  } = useFilterVisibility(\n    filterDefinitions,\n    uncontrolledAddFilterMode ? handleVisibilityChange : undefined,\n  );\n\n  const canReset = hasChangesFromInitial || hasVisibilityChanges;\n\n  const handleReset = useCallback(() => {\n    reset();\n    resetVisibility();\n    onReset?.();\n  }, [reset, resetVisibility, onReset]);\n\n  const simpleVisibleDefinitions = useMemo(() => {\n    if (filterDefinitions == null) {\n      return undefined;\n    }\n    return filterDefinitions.filter(\n      (def: FilterDefinitionUnion<Q>) => def.isVisible !== false,\n    );\n  }, [filterDefinitions]);\n\n  const effectiveVisibleDefinitions = uncontrolledAddFilterMode\n    ? managedVisibleDefinitions\n    : simpleVisibleDefinitions;\n\n  const handleFilterRemoved = useCallback(\n    (filterKey: string) => {\n      clearFilterState(filterKey);\n      if (uncontrolledAddFilterMode) {\n        hideFilter(filterKey);\n      }\n      onFilterRemoved?.(filterKey);\n    },\n    [clearFilterState, uncontrolledAddFilterMode, hideFilter, onFilterRemoved],\n  );\n\n  const handleFilterShown = useCallback(\n    (filterKey: string) => {\n      showFilter(filterKey);\n      onFilterAdded?.(filterKey, filterDefinitions ?? []);\n    },\n    [showFilter, onFilterAdded, filterDefinitions],\n  );\n\n  const handleOrderChange = useCallback(\n    (orderedKeys: string[]) => {\n      reorderVisible(orderedKeys);\n    },\n    [reorderVisible],\n  );\n\n  const hiddenFilterItems = useMemo(\n    () =>\n      managedHiddenDefinitions.map((def) => ({\n        key: getFilterKey(def),\n        label: getFilterLabel(def),\n      })),\n    [managedHiddenDefinitions],\n  );\n\n  const effectiveRenderAddFilterButton = useMemo(() => {\n    if (uncontrolledAddFilterMode) {\n      if (managedHiddenDefinitions.length === 0) {\n        return undefined;\n      }\n      return () => (\n        <AddFilterPopover\n          hiddenDefinitions={hiddenFilterItems}\n          onShowFilter={handleFilterShown}\n          renderTrigger={renderAddFilterButton}\n        />\n      );\n    }\n    return renderAddFilterButton;\n  }, [\n    uncontrolledAddFilterMode,\n    managedHiddenDefinitions.length,\n    hiddenFilterItems,\n    handleFilterShown,\n    renderAddFilterButton,\n  ]);\n\n  const effectiveOnFilterRemoved = uncontrolledAddFilterMode\n    ? handleFilterRemoved\n    : onFilterRemoved;\n\n  const renderInput = useCallback<RenderFilterInput<FilterDefinitionUnion<Q>>>(\n    ({\n      definition,\n      filterKey,\n      filterState,\n      onFilterStateChanged,\n      searchQuery,\n      excludeRowOpen,\n    }) => (\n      <FilterInput\n        objectType={objectType}\n        objectSet={objectSet}\n        definition={definition}\n        filterState={filterState}\n        onFilterStateChanged={onFilterStateChanged}\n        whereClause={perFilterWhereClauses.get(filterKey) ?? EMPTY_WHERE}\n        linkedFilters={\n          perFilterLinkedFilters.get(filterKey) ?? EMPTY_LINKED_FILTERS\n        }\n        showFilteredOutValues={showFilteredOutValues}\n        searchQuery={searchQuery}\n        excludeRowOpen={excludeRowOpen}\n      />\n    ),\n    [\n      objectType,\n      objectSet,\n      perFilterWhereClauses,\n      perFilterLinkedFilters,\n      showFilteredOutValues,\n    ],\n  );\n\n  return (\n    <BaseFilterList\n      title={title}\n      titleIcon={titleIcon}\n      collapsed={collapsed}\n      onCollapsedChange={onCollapsedChange}\n      filterDefinitions={effectiveVisibleDefinitions}\n      filterStates={filterStates}\n      onFilterStateChanged={setFilterState}\n      renderInput={renderInput}\n      getFilterKey={getFilterKey}\n      getFilterLabel={getFilterLabel}\n      getEmptyDisplayState={getEmptyDisplayState}\n      activeFilterCount={activeFilterCount}\n      onReset={handleReset}\n      showResetButton={showResetButton}\n      showActiveFilterCount={showActiveFilterCount}\n      canReset={canReset}\n      enableSorting={enableSorting}\n      onFilterRemoved={effectiveOnFilterRemoved}\n      onOrderChange={handleOrderChange}\n      className={className}\n      renderAddFilterButton={effectiveRenderAddFilterButton}\n    />\n  );\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA,OAAOA,KAAK,IAAIC,WAAW,EAAEC,OAAO,QAAQ,OAAO;AAEnD,SAASC,gBAAgB,QAAQ,4BAA4B;AAC7D,SAASC,cAAc,QAAQ,0BAA0B;AAEzD,SAASC,WAAW,QAAQ,kBAAkB;AAM9C,SAASC,kBAAkB,QAAQ,+BAA+B;AAClE,SAASC,mBAAmB,QAAQ,gCAAgC;AACpE,SAASC,oBAAoB,QAAQ,8BAA8B;AACnE,SAASC,oBAAoB,QAAQ,oCAAoC;AACzE,SAASC,YAAY,QAAQ,yBAAyB;AACtD,SAASC,cAAc,QAAQ,2BAA2B;AAE1D,MAAMC,WAAW,GAAG,CAAC,CAAC;AAEtB,OAAO,SAASC,UAAUA,CACxBC,KAAyB,EACL;EACpB,MAAM;IACJC,UAAU;IACVC,SAAS;IACTC,KAAK;IACLC,SAAS;IACTC,SAAS;IACTC,iBAAiB;IACjBC,iBAAiB;IACjBC,aAAa,GAAG,cAAc;IAC9BC,eAAe,GAAG,KAAK;IACvBC,OAAO;IACPC,qBAAqB,GAAG,KAAK;IAC7BC,qBAAqB,GAAG,KAAK;IAC7BC,SAAS;IACTC,aAAa;IACbC,aAAa;IACbC,eAAe;IACfC,wBAAwB;IACxBC;EACF,CAAC,GAAGlB,KAAK;EAET,MAAM;IACJmB,YAAY;IACZC,cAAc;IACdC,gBAAgB;IAChBC,qBAAqB;IACrBC,sBAAsB;IACtBC,iBAAiB;IACjBC,qBAAqB;IACrBC;EACF,CAAC,GAAGlC,kBAAkB,CAACQ,KAAK,CAAC;EAE7B,MAAM2B,yBAAyB,GAAGnB,aAAa,KAAK,cAAc;EAElE,MAAMoB,sBAAsB,GAAGzC,WAAW,CACxC,CAAC0C,WAAqB,EAAEC,UAAoB,KAAK;IAC/C,IAAI,CAACb,wBAAwB,EAAE;MAC7B;IACF;IACA,MAAMc,MAA8D,GAAG,CACrE,GAAGF,WAAW,CAACG,GAAG,CAAEC,GAAG,KAAM;MAC3BC,SAAS,EAAED,GAAmB;MAC9BE,SAAS,EAAE;IACb,CAAC,CAAC,CAAC,EACH,GAAGL,UAAU,CAACE,GAAG,CAAEC,GAAG,KAAM;MAC1BC,SAAS,EAAED,GAAmB;MAC9BE,SAAS,EAAE;IACb,CAAC,CAAC,CAAC,CACJ;IACDlB,wBAAwB,CAACc,MAAM,CAAC;EAClC,CAAC,EACD,CAACd,wBAAwB,CAC3B,CAAC;EAED,MAAM;IACJmB,kBAAkB,EAAEC,yBAAyB;IAC7CC,iBAAiB,EAAEC,wBAAwB;IAC3CC,UAAU;IACVC,UAAU;IACVC,cAAc;IACdC,oBAAoB;IACpBC;EACF,CAAC,GAAGnD,mBAAmB,CACrBc,iBAAiB,EACjBoB,yBAAyB,GAAGC,sBAAsB,GAAGiB,SACvD,CAAC;EAID,MAAMC,WAAW,GAAG3D,WAAW,CAAC,MAAM;IACpCuC,KAAK,CAAC,CAAC;IACPkB,eAAe,CAAC,CAAC;IACjBlC,OAAO,GAAG,CAAC;EACb,CAAC,EAAE,CAACgB,KAAK,EAAEkB,eAAe,EAAElC,OAAO,CAAC,CAAC;EAErC,MAAMqC,wBAAwB,GAAG3D,OAAO,CAAC,MAAM;IAC7C,IAAImB,iBAAiB,IAAI,IAAI,EAAE;MAC7B,OAAOsC,SAAS;IAClB;IACA,OAAOtC,iBAAiB,CAACyC,MAAM,CAC5BC,GAA6B,IAAKA,GAAG,CAACd,SAAS,KAAK,KACvD,CAAC;EACH,CAAC,EAAE,CAAC5B,iBAAiB,CAAC,CAAC;EAEvB,MAAM2C,2BAA2B,GAAGvB,yBAAyB,GACzDU,yBAAyB,GACzBU,wBAAwB;EAE5B,MAAMI,mBAAmB,GAAGhE,WAAW,CACpC+C,SAAiB,IAAK;IACrBb,gBAAgB,CAACa,SAAS,CAAC;IAC3B,IAAIP,yBAAyB,EAAE;MAC7Bc,UAAU,CAACP,SAAS,CAAC;IACvB;IACAlB,eAAe,GAAGkB,SAAS,CAAC;EAC9B,CAAC,EACD,CAACb,gBAAgB,EAAEM,yBAAyB,EAAEc,UAAU,EAAEzB,eAAe,CAC3E,CAAC;EAED,MAAMoC,iBAAiB,GAAGjE,WAAW,CAClC+C,SAAiB,IAAK;IACrBM,UAAU,CAACN,SAAS,CAAC;IACrBnB,aAAa,GAAGmB,SAAS,EAAE3B,iBAAiB,IAAI,EAAE,CAAC;EACrD,CAAC,EACD,CAACiC,UAAU,EAAEzB,aAAa,EAAER,iBAAiB,CAC/C,CAAC;EAED,MAAM8C,iBAAiB,GAAGlE,WAAW,CAClCmE,WAAqB,IAAK;IACzBZ,cAAc,CAACY,WAAW,CAAC;EAC7B,CAAC,EACD,CAACZ,cAAc,CACjB,CAAC;EAED,MAAMa,iBAAiB,GAAGnE,OAAO,CAC/B,MACEmD,wBAAwB,CAACP,GAAG,CAAEiB,GAAG,KAAM;IACrChB,GAAG,EAAErC,YAAY,CAACqD,GAAG,CAAC;IACtBO,KAAK,EAAE3D,cAAc,CAACoD,GAAG;EAC3B,CAAC,CAAC,CAAC,EACL,CAACV,wBAAwB,CAC3B,CAAC;EAED,MAAMkB,8BAA8B,GAAGrE,OAAO,CAAC,MAAM;IACnD,IAAIuC,yBAAyB,EAAE;MAC7B,IAAIY,wBAAwB,CAACmB,MAAM,KAAK,CAAC,EAAE;QACzC,OAAOb,SAAS;MAClB;MACA,OAAO,mBACL3D,KAAA,CAAAyE,aAAA,CAACtE,gBAAgB;QACfiD,iBAAiB,EAAEiB,iBAAkB;QACrCK,YAAY,EAAER,iBAAkB;QAChCS,aAAa,EAAE3C;MAAsB,CACtC,CACF;IACH;IACA,OAAOA,qBAAqB;EAC9B,CAAC,EAAE,CACDS,yBAAyB,EACzBY,wBAAwB,CAACmB,MAAM,EAC/BH,iBAAiB,EACjBH,iBAAiB,EACjBlC,qBAAqB,CACtB,CAAC;EAEF,MAAM4C,wBAAwB,GAAGnC,yBAAyB,GACtDwB,mBAAmB,GACnBnC,eAAe;EAEnB,MAAM+C,WAAW,GAAG5E,WAAW,CAC7B,CAAC;IACC6E,UAAU;IACV9B,SAAS;IACT+B,WAAW;IACXC,oBAAoB;IACpBC,WAAW;IACXC;EACF,CAAC,kBACClF,KAAA,CAAAyE,aAAA,CAACpE,WAAW;IACVU,UAAU,EAAEA,UAAW;IACvBC,SAAS,EAAEA,SAAU;IACrB8D,UAAU,EAAEA,UAAW;IACvBC,WAAW,EAAEA,WAAY;IACzBC,oBAAoB,EAAEA,oBAAqB;IAC3CG,WAAW,EAAE/C,qBAAqB,CAACgD,GAAG,CAACpC,SAAS,CAAC,IAAIpC,WAAY;IACjEyE,aAAa,EACXhD,sBAAsB,CAAC+C,GAAG,CAACpC,SAAS,CAAC,IAAIxC,oBAC1C;IACDkB,qBAAqB,EAAEA,qBAAsB;IAC7CuD,WAAW,EAAEA,WAAY;IACzBC,cAAc,EAAEA;EAAe,CAChC,CACF,EACD,CACEnE,UAAU,EACVC,SAAS,EACToB,qBAAqB,EACrBC,sBAAsB,EACtBX,qBAAqB,CAEzB,CAAC;EAED,oBACE1B,KAAA,CAAAyE,aAAA,CAACrE,cAAc;IACba,KAAK,EAAEA,KAAM;IACbC,SAAS,EAAEA,SAAU;IACrBC,SAAS,EAAEA,SAAU;IACrBC,iBAAiB,EAAEA,iBAAkB;IACrCC,iBAAiB,EAAE2C,2BAA4B;IAC/C/B,YAAY,EAAEA,YAAa;IAC3B+C,oBAAoB,EAAE9C,cAAe;IACrC2C,WAAW,EAAEA,WAAY;IACzBnE,YAAY,EAAEA,YAAa;IAC3BC,cAAc,EAAEA,cAAe;IAC/BF,oBAAoB,EAAEA,oBAAqB;IAC3C6B,iBAAiB,EAAEA,iBAAkB;IACrCd,OAAO,EAAEoC,WAAY;IACrBrC,eAAe,EAAEA,eAAgB;IACjCE,qBAAqB,EAAEA,qBAAsB;IAC7C6D,QAAQ,EApIK/C,qBAAqB,IAAIkB,oBAoInB;IACnB7B,aAAa,EAAEA,aAAc;IAC7BE,eAAe,EAAE8C,wBAAyB;IAC1CW,aAAa,EAAEpB,iBAAkB;IACjCxC,SAAS,EAAEA,SAAU;IACrBK,qBAAqB,EAAEuC;EAA+B,CACvD,CAAC;AAEN","ignoreList":[]}
+{"version":3,"file":"FilterList.js","names":["React","useCallback","useMemo","AddFilterPopover","BaseFilterList","FilterInput","useFilterListState","useFilterVisibility","EMPTY_LINKED_FILTERS","getEmptyDisplayState","getFilterKey","getFilterLabel","EMPTY_WHERE","EMPTY_DEFINITIONS","FilterList","props","objectType","objectSet","title","titleIcon","collapsed","onCollapsedChange","filterDefinitions","addFilterMode","showResetButton","onReset","showActiveFilterCount","showFilteredOutValues","className","enableSorting","onFilterAdded","onFilterRemoved","onFilterVisibilityChange","renderAddFilterButton","filterStates","setFilterState","clearFilterState","perFilterWhereClauses","perFilterLinkedFilters","activeFilterCount","hasChangesFromInitial","reset","uncontrolledAddFilterMode","handleVisibilityChange","visibleKeys","hiddenKeys","states","map","key","filterKey","isVisible","visibleDefinitions","managedVisibleDefinitions","hiddenDefinitions","managedHiddenDefinitions","showFilter","hideFilter","reorderVisible","hasVisibilityChanges","resetVisibility","handleReset","simpleVisibleDefinitions","undefined","filter","def","effectiveVisibleDefinitions","handleFilterRemoved","handleFilterShown","handleOrderChange","orderedKeys","hiddenFilterItems","label","effectiveRenderAddFilterButton","length","createElement","onShowFilter","renderTrigger","effectiveOnFilterRemoved","renderInput","definition","filterState","onFilterStateChanged","searchQuery","excludeRowOpen","whereClause","get","linkedFilters","canReset","onOrderChange"],"sources":["FilterList.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 { ObjectTypeDefinition } from \"@osdk/api\";\nimport React, { useCallback, useMemo } from \"react\";\n\nimport { AddFilterPopover } from \"./base/AddFilterPopover.js\";\nimport { BaseFilterList } from \"./base/BaseFilterList.js\";\nimport type { RenderFilterInput } from \"./base/BaseFilterListApi.js\";\nimport { FilterInput } from \"./FilterInput.js\";\nimport type {\n  FilterDefinitionUnion,\n  FilterKey,\n  FilterListProps,\n} from \"./FilterListApi.js\";\nimport { useFilterListState } from \"./hooks/useFilterListState.js\";\nimport { useFilterVisibility } from \"./hooks/useFilterVisibility.js\";\nimport { EMPTY_LINKED_FILTERS } from \"./types/LinkedFilterTypes.js\";\nimport { getEmptyDisplayState } from \"./utils/emptyFilterDisplayState.js\";\nimport { getFilterKey } from \"./utils/getFilterKey.js\";\nimport { getFilterLabel } from \"./utils/getFilterLabel.js\";\n\nconst EMPTY_WHERE = {};\nconst EMPTY_DEFINITIONS: Array<never> = [];\n\nexport function FilterList<Q extends ObjectTypeDefinition>(\n  props: FilterListProps<Q>,\n): React.ReactElement {\n  const {\n    objectType,\n    objectSet,\n    title,\n    titleIcon,\n    collapsed,\n    onCollapsedChange,\n    filterDefinitions,\n    addFilterMode = \"uncontrolled\",\n    showResetButton = false,\n    onReset,\n    showActiveFilterCount = false,\n    showFilteredOutValues = false,\n    className,\n    enableSorting,\n    onFilterAdded,\n    onFilterRemoved,\n    onFilterVisibilityChange,\n    renderAddFilterButton,\n  } = props;\n\n  const {\n    filterStates,\n    setFilterState,\n    clearFilterState,\n    perFilterWhereClauses,\n    perFilterLinkedFilters,\n    activeFilterCount,\n    hasChangesFromInitial,\n    reset,\n  } = useFilterListState(props);\n\n  const uncontrolledAddFilterMode = addFilterMode === \"uncontrolled\";\n\n  const handleVisibilityChange = useCallback(\n    (visibleKeys: string[], hiddenKeys: string[]) => {\n      if (!onFilterVisibilityChange) {\n        return;\n      }\n      const states: Array<{ filterKey: FilterKey<Q>; isVisible: boolean }> = [\n        ...visibleKeys.map((key) => ({\n          filterKey: key as FilterKey<Q>,\n          isVisible: true,\n        })),\n        ...hiddenKeys.map((key) => ({\n          filterKey: key as FilterKey<Q>,\n          isVisible: false,\n        })),\n      ];\n      onFilterVisibilityChange(states);\n    },\n    [onFilterVisibilityChange],\n  );\n\n  const {\n    visibleDefinitions: managedVisibleDefinitions,\n    hiddenDefinitions: managedHiddenDefinitions,\n    showFilter,\n    hideFilter,\n    reorderVisible,\n    hasVisibilityChanges,\n    resetVisibility,\n  } = useFilterVisibility(filterDefinitions, handleVisibilityChange);\n\n  const canReset = hasChangesFromInitial || hasVisibilityChanges;\n\n  const handleReset = useCallback(() => {\n    reset();\n    resetVisibility();\n    onReset?.();\n  }, [reset, resetVisibility, onReset]);\n\n  const simpleVisibleDefinitions = useMemo(() => {\n    if (filterDefinitions == null) {\n      return undefined;\n    }\n    return filterDefinitions.filter(\n      (def: FilterDefinitionUnion<Q>) => def.isVisible !== false,\n    );\n  }, [filterDefinitions]);\n\n  const effectiveVisibleDefinitions = uncontrolledAddFilterMode\n    ? managedVisibleDefinitions\n    : simpleVisibleDefinitions;\n\n  const handleFilterRemoved = useCallback(\n    (filterKey: string) => {\n      clearFilterState(filterKey);\n      if (uncontrolledAddFilterMode) {\n        hideFilter(filterKey);\n      }\n      onFilterRemoved?.(filterKey);\n    },\n    [clearFilterState, uncontrolledAddFilterMode, hideFilter, onFilterRemoved],\n  );\n\n  const handleFilterShown = useCallback(\n    (filterKey: string) => {\n      showFilter(filterKey);\n      onFilterAdded?.(filterKey, filterDefinitions ?? EMPTY_DEFINITIONS);\n    },\n    [showFilter, onFilterAdded, filterDefinitions],\n  );\n\n  const handleOrderChange = useCallback(\n    (orderedKeys: string[]) => {\n      reorderVisible(orderedKeys);\n    },\n    [reorderVisible],\n  );\n\n  const hiddenFilterItems = useMemo(\n    () =>\n      managedHiddenDefinitions.map((def) => ({\n        key: getFilterKey(def),\n        label: getFilterLabel(def),\n      })),\n    [managedHiddenDefinitions],\n  );\n\n  const effectiveRenderAddFilterButton = useMemo(() => {\n    if (uncontrolledAddFilterMode) {\n      if (managedHiddenDefinitions.length === 0) {\n        return undefined;\n      }\n      return () => (\n        <AddFilterPopover\n          hiddenDefinitions={hiddenFilterItems}\n          onShowFilter={handleFilterShown}\n          renderTrigger={renderAddFilterButton}\n        />\n      );\n    }\n    return renderAddFilterButton;\n  }, [\n    uncontrolledAddFilterMode,\n    managedHiddenDefinitions.length,\n    hiddenFilterItems,\n    handleFilterShown,\n    renderAddFilterButton,\n  ]);\n\n  const effectiveOnFilterRemoved = uncontrolledAddFilterMode\n    ? handleFilterRemoved\n    : onFilterRemoved;\n\n  const renderInput = useCallback<RenderFilterInput<FilterDefinitionUnion<Q>>>(\n    ({\n      definition,\n      filterKey,\n      filterState,\n      onFilterStateChanged,\n      searchQuery,\n      excludeRowOpen,\n    }) => (\n      <FilterInput\n        objectType={objectType}\n        objectSet={objectSet}\n        definition={definition}\n        filterState={filterState}\n        onFilterStateChanged={onFilterStateChanged}\n        whereClause={perFilterWhereClauses.get(filterKey) ?? EMPTY_WHERE}\n        linkedFilters={\n          perFilterLinkedFilters.get(filterKey) ?? EMPTY_LINKED_FILTERS\n        }\n        showFilteredOutValues={showFilteredOutValues}\n        searchQuery={searchQuery}\n        excludeRowOpen={excludeRowOpen}\n      />\n    ),\n    [\n      objectType,\n      objectSet,\n      perFilterWhereClauses,\n      perFilterLinkedFilters,\n      showFilteredOutValues,\n    ],\n  );\n\n  return (\n    <BaseFilterList\n      title={title}\n      titleIcon={titleIcon}\n      collapsed={collapsed}\n      onCollapsedChange={onCollapsedChange}\n      filterDefinitions={effectiveVisibleDefinitions}\n      filterStates={filterStates}\n      onFilterStateChanged={setFilterState}\n      renderInput={renderInput}\n      getFilterKey={getFilterKey}\n      getFilterLabel={getFilterLabel}\n      getEmptyDisplayState={getEmptyDisplayState}\n      activeFilterCount={activeFilterCount}\n      onReset={handleReset}\n      showResetButton={showResetButton}\n      showActiveFilterCount={showActiveFilterCount}\n      canReset={canReset}\n      enableSorting={enableSorting}\n      onFilterRemoved={effectiveOnFilterRemoved}\n      onOrderChange={handleOrderChange}\n      className={className}\n      renderAddFilterButton={effectiveRenderAddFilterButton}\n    />\n  );\n}\n"],"mappings":"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","ignoreList":[]}

package/build/esm/filter-list/FilterListApi.js.map

@@ -1 +1 @@
-{"version":3,"file":"FilterListApi.js","names":[],"sources":["FilterListApi.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  LinkNames,\n  ObjectSet,\n  ObjectTypeDefinition,\n  WhereClause,\n} from \"@osdk/api\";\nimport type React from \"react\";\nimport type { ReactNode } from \"react\";\n\nimport type {\n  FilterState,\n  PropertyFilterDefinition,\n} from \"./FilterListItemApi.js\";\nimport type { CustomFilterDefinition } from \"./types/CustomRendererTypes.js\";\nimport type { KeywordSearchFilterDefinition } from \"./types/KeywordSearchTypes.js\";\nimport type {\n  HasLinkFilterDefinition,\n  LinkedPropertyFilterDefinition,\n} from \"./types/LinkedFilterTypes.js\";\nimport type { StaticValuesFilterDefinition } from \"./types/StaticValuesTypes.js\";\n\n/**\n * Distributes LinkedPropertyFilterDefinition over each link name individually,\n * so that LinkedQ/LinkedK/LinkedC defaults resolve correctly per link.\n */\ntype DistributeLinkedProperty<\n  Q extends ObjectTypeDefinition,\n  L extends LinkNames<Q>,\n> = L extends LinkNames<Q> ? LinkedPropertyFilterDefinition<Q, L> : never;\n\n/**\n * Union type of all filter definition types\n */\nexport type FilterDefinitionUnion<Q extends ObjectTypeDefinition> =\n  | PropertyFilterDefinition<Q>\n  | HasLinkFilterDefinition<Q>\n  | DistributeLinkedProperty<Q, LinkNames<Q>>\n  | KeywordSearchFilterDefinition<Q>\n  | CustomFilterDefinition<Q>\n  | StaticValuesFilterDefinition<Q>;\n\n/**\n * Extract the key from a filter definition union\n */\ntype ExtractFilterKey<D> = D extends { key: infer K }\n  ? K\n  : D extends { linkName: infer L }\n    ? L\n    : never;\n\nexport type FilterKey<Q extends ObjectTypeDefinition> = ExtractFilterKey<\n  FilterDefinitionUnion<Q>\n>;\n\nexport interface FilterListProps<Q extends ObjectTypeDefinition> {\n  /**\n   * The object type definition for the objects being filtered.\n   * Used for metadata resolution (property types, display names).\n   */\n  objectType: Q;\n\n  /**\n   * Optional object set to scope aggregation queries. When omitted,\n   * aggregations run against the full object type.\n   */\n  objectSet?: ObjectSet<Q>;\n\n  /**\n   * Called whenever the filter clause changes. FilterList owns filter state;\n   * this is how you read it out, e.g. to feed an `ObjectTable`'s `filter`.\n   *\n   * `LINKED_PROPERTY` filters are not represented in the clause — use\n   * `onEffectiveObjectSet` for those.\n   *\n   * @param newClause The updated filter clause\n   */\n  onFilterClauseChanged?: (newClause: WhereClause<Q>) => void;\n\n  /**\n   * Optional title to display in the filter list header\n   */\n  title?: ReactNode;\n\n  /**\n   * Optional icon to display next to the title\n   */\n  titleIcon?: React.ReactNode;\n\n  /**\n   * The definition for all supported filter items in the list\n   * If not supplied, all filterable properties will be available\n   */\n  filterDefinitions?: Array<FilterDefinitionUnion<Q>>;\n\n  /**\n   * Called when filter state changes\n   *\n   * @param definition The filter definition whose state changed\n   * @param newState The updated filter state\n   */\n  onFilterStateChanged?: (\n    definition: FilterDefinitionUnion<Q>,\n    newState: FilterState,\n  ) => void;\n\n  /**\n   * Called with the narrowed `ObjectSet` whenever filters change. Requires\n   * `objectSet` to be set.\n   *\n   * A linked filter only narrows the set when its definition has\n   * `reverseLinkName`. Linked filters without it are skipped here; read their\n   * state from `onFilterStateChanged` instead.\n   */\n  onEffectiveObjectSet?: (objectSet: ObjectSet<Q>) => void;\n\n  /**\n   * When `true`, facets render greyed-out count=0 rows for values present in\n   * the unfiltered data but excluded by other active filters.\n   * @default false\n   */\n  showFilteredOutValues?: boolean;\n\n  /**\n   * Controls how filter visibility (add/remove) is managed.\n   *\n   * - `\"uncontrolled\"` (default): FilterList manages visibility internally.\n   *   An \"Add filter\" popover is rendered for filters with `isVisible: false`,\n   *   and each visible filter shows a remove button.\n   * - `\"controlled\"`: The consumer manages which filters are visible via\n   *   `filterDefinitions`. Filters with `isVisible: false` are excluded from\n   *   the rendered list.\n   *\n   * @default \"uncontrolled\"\n   */\n  addFilterMode?: \"controlled\" | \"uncontrolled\";\n\n  /**\n   * Called when a filter is added (shown).\n   *\n   * In uncontrolled mode, this fires when a user selects a hidden filter\n   * from the \"Add filter\" popover.\n   *\n   * @param filterKey The key of the added filter\n   * @param newDefinitions The current filter definitions array\n   */\n  onFilterAdded?: (\n    filterKey: FilterKey<Q>,\n    newDefinitions: Array<FilterDefinitionUnion<Q>>,\n  ) => void;\n\n  /**\n   * Called when a filter is removed (hidden).\n   *\n   * In uncontrolled mode, this fires as a notification after the filter\n   * is hidden internally.\n   *\n   * @param filterKey The key of the removed filter\n   */\n  onFilterRemoved?: (filterKey: FilterKey<Q>) => void;\n\n  /**\n   * Called when filter visibility or ordering changes, i.e. when filters\n   * are reordered, or (in uncontrolled mode) added or\n   * removed via the built-in show/remove controls.\n   *\n   * @param newStates The filters in current display order with their visibility state\n   */\n  onFilterVisibilityChange?: (\n    newStates: Array<{\n      filterKey: FilterKey<Q>;\n      isVisible: boolean;\n    }>,\n  ) => void;\n\n  /**\n   * Enable drag-and-drop reordering of filters.\n   * When true, drag handles are rendered and filters can be reordered.\n   * Reorder state is managed internally; consumers who need to track order\n   * should use controlled filterDefinitions.\n   */\n  enableSorting?: boolean;\n\n  /**\n   * Whether the filter list panel is collapsed\n   */\n  collapsed?: boolean;\n\n  /**\n   * Called when the collapsed state changes\n   */\n  onCollapsedChange?: (collapsed: boolean) => void;\n\n  /**\n   * Initial filter states for hydrating from external storage.\n   * These states are merged over definition defaults on mount.\n   * Use onFilterStateChanged to persist state changes externally.\n   */\n  initialFilterStates?: Map<string, FilterState>;\n\n  /**\n   * Show reset filters button in header\n   */\n  showResetButton?: boolean;\n\n  /**\n   * Called when reset button is clicked\n   */\n  onReset?: () => void;\n\n  /**\n   * Show count of active filters in header\n   */\n  showActiveFilterCount?: boolean;\n\n  /**\n   * Additional CSS class name\n   */\n  className?: string;\n\n  /**\n   * Custom render function for the \"Add filter\" button.\n   *\n   * - In uncontrolled mode: customizes the trigger element for the built-in\n   *   add-filter popover. The popover behavior is handled automatically.\n   * - In controlled mode: replaces the entire add-filter button area.\n   *   The consumer is responsible for all add-filter behavior.\n   */\n  renderAddFilterButton?: () => React.ReactNode;\n}\n"],"mappings":"","ignoreList":[]}
+{"version":3,"file":"FilterListApi.js","names":[],"sources":["FilterListApi.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  LinkNames,\n  ObjectSet,\n  ObjectTypeDefinition,\n  WhereClause,\n} from \"@osdk/api\";\nimport type React from \"react\";\nimport type { ReactNode } from \"react\";\n\nimport type {\n  FilterState,\n  PropertyFilterDefinition,\n} from \"./FilterListItemApi.js\";\nimport type { CustomFilterDefinition } from \"./types/CustomRendererTypes.js\";\nimport type { KeywordSearchFilterDefinition } from \"./types/KeywordSearchTypes.js\";\nimport type {\n  HasLinkFilterDefinition,\n  LinkedPropertyFilterDefinition,\n} from \"./types/LinkedFilterTypes.js\";\nimport type { StaticValuesFilterDefinition } from \"./types/StaticValuesTypes.js\";\n\n/**\n * Distributes LinkedPropertyFilterDefinition over each link name individually,\n * so that LinkedQ/LinkedK/LinkedC defaults resolve correctly per link.\n */\ntype DistributeLinkedProperty<\n  Q extends ObjectTypeDefinition,\n  L extends LinkNames<Q>,\n> = L extends LinkNames<Q> ? LinkedPropertyFilterDefinition<Q, L> : never;\n\n/**\n * Union type of all filter definition types\n */\nexport type FilterDefinitionUnion<Q extends ObjectTypeDefinition> =\n  | PropertyFilterDefinition<Q>\n  | HasLinkFilterDefinition<Q>\n  | DistributeLinkedProperty<Q, LinkNames<Q>>\n  | KeywordSearchFilterDefinition<Q>\n  | CustomFilterDefinition<Q>\n  | StaticValuesFilterDefinition<Q>;\n\n/**\n * Extract the key from a filter definition union\n */\ntype ExtractFilterKey<D> = D extends { key: infer K }\n  ? K\n  : D extends { linkName: infer L }\n    ? L\n    : never;\n\nexport type FilterKey<Q extends ObjectTypeDefinition> = ExtractFilterKey<\n  FilterDefinitionUnion<Q>\n>;\n\nexport interface FilterListProps<Q extends ObjectTypeDefinition> {\n  /**\n   * The object type definition for the objects being filtered.\n   * Used for metadata resolution (property types, display names).\n   */\n  objectType: Q;\n\n  /**\n   * Optional object set to scope aggregation queries. When omitted,\n   * aggregations run against the full object type.\n   */\n  objectSet?: ObjectSet<Q>;\n\n  /**\n   * Called whenever the filter clause changes. FilterList owns filter state;\n   * this is how you read it out, e.g. to feed an `ObjectTable`'s `filter`.\n   *\n   * `LINKED_PROPERTY` filters are not represented in the clause — use\n   * `onEffectiveObjectSet` for those.\n   *\n   * @param newClause The updated filter clause\n   */\n  onFilterClauseChanged?: (newClause: WhereClause<Q>) => void;\n\n  /**\n   * Optional title to display in the filter list header\n   */\n  title?: ReactNode;\n\n  /**\n   * Optional icon to display next to the title\n   */\n  titleIcon?: React.ReactNode;\n\n  /**\n   * The definition for all supported filter items in the list\n   * If not supplied, all filterable properties will be available\n   */\n  filterDefinitions?: Array<FilterDefinitionUnion<Q>>;\n\n  /**\n   * Called when filter state changes\n   *\n   * @param definition The filter definition whose state changed\n   * @param newState The updated filter state\n   */\n  onFilterStateChanged?: (\n    definition: FilterDefinitionUnion<Q>,\n    newState: FilterState,\n  ) => void;\n\n  /**\n   * Called with the narrowed `ObjectSet` whenever filters change. Requires\n   * `objectSet` to be set.\n   *\n   * A linked filter only narrows the set when its definition has\n   * `reverseLinkName`. Linked filters without it are skipped here; read their\n   * state from `onFilterStateChanged` instead.\n   */\n  onEffectiveObjectSet?: (objectSet: ObjectSet<Q>) => void;\n\n  /**\n   * When `true`, facets render greyed-out count=0 rows for values present in\n   * the unfiltered data but excluded by other active filters.\n   * @default false\n   */\n  showFilteredOutValues?: boolean;\n\n  /**\n   * Controls how filter visibility (add/remove) is managed.\n   *\n   * - `\"uncontrolled\"` (default): FilterList manages visibility internally.\n   *   An \"Add filter\" popover is rendered for filters with `isVisible: false`,\n   *   and each visible filter shows a remove button.\n   * - `\"controlled\"`: The consumer manages which filters are visible via\n   *   `filterDefinitions`. Filters with `isVisible: false` are excluded from\n   *   the rendered list.\n   *\n   * @default \"uncontrolled\"\n   * @deprecated Going away; visibility will always be managed internally.\n   * Seed it with `isVisible` on each `filterDefinitions` entry and observe\n   * changes with `onFilterVisibilityChange`.\n   */\n  addFilterMode?: \"controlled\" | \"uncontrolled\";\n\n  /**\n   * Called after a filter is shown from the built-in \"Add filter\" popover.\n   *\n   * @param filterKey The key of the added filter\n   * @param newDefinitions Deprecated. The `filterDefinitions` you passed in,\n   * unchanged — not the post-add state. Use `onFilterVisibilityChange`.\n   */\n  onFilterAdded?: (\n    filterKey: FilterKey<Q>,\n    /** @deprecated Use `onFilterVisibilityChange`. */\n    newDefinitions: Array<FilterDefinitionUnion<Q>>,\n  ) => void;\n\n  /**\n   * Called after a filter's remove button is clicked, once the filter is\n   * hidden and its state cleared.\n   *\n   * @param filterKey The key of the removed filter\n   */\n  onFilterRemoved?: (filterKey: FilterKey<Q>) => void;\n\n  /**\n   * Called when filter visibility or ordering changes, i.e. when filters are\n   * reordered, added or removed via the built-in show/remove controls, or\n   * reset.\n   *\n   * Visible filters come first, in display order, followed by the hidden ones.\n   * Persist this array and feed it back as the order and `isVisible` of\n   * `filterDefinitions` to make reordering survive a remount.\n   *\n   * @param newStates The filters in current display order with their visibility state\n   */\n  onFilterVisibilityChange?: (\n    newStates: Array<{\n      filterKey: FilterKey<Q>;\n      isVisible: boolean;\n    }>,\n  ) => void;\n\n  /**\n   * Enable drag-and-drop reordering of filters. When `true`, drag handles are\n   * rendered and filters can be reordered.\n   *\n   * Reorder state is managed internally; persist `onFilterVisibilityChange` to\n   * track order across remounts.\n   *\n   * @default false\n   */\n  enableSorting?: boolean;\n\n  /**\n   * Whether the filter list panel is collapsed\n   */\n  collapsed?: boolean;\n\n  /**\n   * Called when the collapsed state changes\n   */\n  onCollapsedChange?: (collapsed: boolean) => void;\n\n  /**\n   * Initial filter states for hydrating from external storage.\n   * These states are merged over definition defaults on mount.\n   * Use onFilterStateChanged to persist state changes externally.\n   */\n  initialFilterStates?: Map<string, FilterState>;\n\n  /**\n   * Show reset filters button in header\n   */\n  showResetButton?: boolean;\n\n  /**\n   * Called when reset button is clicked\n   */\n  onReset?: () => void;\n\n  /**\n   * Show count of active filters in header\n   */\n  showActiveFilterCount?: boolean;\n\n  /**\n   * Additional CSS class name\n   */\n  className?: string;\n\n  /**\n   * Custom render function for the \"Add filter\" button. Customizes the trigger\n   * element for the built-in add-filter popover; the popover behavior is\n   * handled automatically.\n   */\n  renderAddFilterButton?: () => React.ReactNode;\n}\n"],"mappings":"","ignoreList":[]}

package/build/esm/util/UserAgent.js

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-const PACKAGE_USER_AGENT = `osdk-react-components/${"0.48.0"}`;
+const PACKAGE_USER_AGENT = `osdk-react-components/${"0.49.0-main-ff0ef7e7cc3986538c90f5632028a422b404d2eb"}`;
 export function componentUserAgent(componentName) {
   return `${PACKAGE_USER_AGENT}/${componentName}`;
 }

package/build/esm/util/UserAgent.js.map

@@ -1 +1 @@
-{"version":3,"file":"UserAgent.js","names":["PACKAGE_USER_AGENT","componentUserAgent","componentName"],"sources":["UserAgent.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\nconst PACKAGE_USER_AGENT = `osdk-react-components/${process.env.PACKAGE_VERSION}`;\n\nexport function componentUserAgent(componentName: string): string {\n  return `${PACKAGE_USER_AGENT}/${componentName}`;\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,MAAMA,kBAAkB,GAAG,mCAAsD;AAEjF,OAAO,SAASC,kBAAkBA,CAACC,aAAqB,EAAU;EAChE,OAAO,GAAGF,kBAAkB,IAAIE,aAAa,EAAE;AACjD","ignoreList":[]}
+{"version":3,"file":"UserAgent.js","names":["PACKAGE_USER_AGENT","componentUserAgent","componentName"],"sources":["UserAgent.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\nconst PACKAGE_USER_AGENT = `osdk-react-components/${process.env.PACKAGE_VERSION}`;\n\nexport function componentUserAgent(componentName: string): string {\n  return `${PACKAGE_USER_AGENT}/${componentName}`;\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,MAAMA,kBAAkB,GAAG,iFAAsD;AAEjF,OAAO,SAASC,kBAAkBA,CAACC,aAAqB,EAAU;EAChE,OAAO,GAAGF,kBAAkB,IAAIE,aAAa,EAAE;AACjD","ignoreList":[]}

package/build/types/filter-list/FilterList.d.ts.map

@@ -1 +1 @@
-{"mappings":"AAgBA,cAAc,4BAA4B,WAAY;AACtD,OAAO,WAAqC,OAAQ;AAMpD,cAGE,uBACK,oBAAqB;AAU5B,OAAO,iBAAS,WAAW,UAAU,sBACnCA,OAAO,gBAAgB,KACtB,MAAM","names":["props: FilterListProps<Q>"],"sources":["../../../src/filter-list/FilterList.tsx"],"version":3,"file":"FilterList.d.ts"}
+{"mappings":"AAgBA,cAAc,4BAA4B,WAAY;AACtD,OAAO,WAAqC,OAAQ;AAMpD,cAGE,uBACK,oBAAqB;AAW5B,OAAO,iBAAS,WAAW,UAAU,sBACnCA,OAAO,gBAAgB,KACtB,MAAM","names":["props: FilterListProps<Q>"],"sources":["../../../src/filter-list/FilterList.tsx"],"version":3,"file":"FilterList.d.ts"}

package/build/types/filter-list/FilterListApi.d.ts

@@ -94,31 +94,34 @@ export interface FilterListProps<Q extends ObjectTypeDefinition> {
 	*   the rendered list.
 	*
 	* @default "uncontrolled"
+	* @deprecated Going away; visibility will always be managed internally.
+	* Seed it with `isVisible` on each `filterDefinitions` entry and observe
+	* changes with `onFilterVisibilityChange`.
 	*/
 	addFilterMode?: "controlled" | "uncontrolled";
 	/**
-	* Called when a filter is added (shown).
-	*
-	* In uncontrolled mode, this fires when a user selects a hidden filter
-	* from the "Add filter" popover.
+	* Called after a filter is shown from the built-in "Add filter" popover.
 	*
 	* @param filterKey The key of the added filter
-	* @param newDefinitions The current filter definitions array
+	* @param newDefinitions Deprecated. The `filterDefinitions` you passed in,
+	* unchanged — not the post-add state. Use `onFilterVisibilityChange`.
 	*/
 	onFilterAdded?: (filterKey: FilterKey<Q>, newDefinitions: Array<FilterDefinitionUnion<Q>>) => void;
 	/**
-	* Called when a filter is removed (hidden).
-	*
-	* In uncontrolled mode, this fires as a notification after the filter
-	* is hidden internally.
+	* Called after a filter's remove button is clicked, once the filter is
+	* hidden and its state cleared.
 	*
 	* @param filterKey The key of the removed filter
 	*/
 	onFilterRemoved?: (filterKey: FilterKey<Q>) => void;
 	/**
-	* Called when filter visibility or ordering changes, i.e. when filters
-	* are reordered, or (in uncontrolled mode) added or
-	* removed via the built-in show/remove controls.
+	* Called when filter visibility or ordering changes, i.e. when filters are
+	* reordered, added or removed via the built-in show/remove controls, or
+	* reset.
+	*
+	* Visible filters come first, in display order, followed by the hidden ones.
+	* Persist this array and feed it back as the order and `isVisible` of
+	* `filterDefinitions` to make reordering survive a remount.
 	*
 	* @param newStates The filters in current display order with their visibility state
 	*/
@@ -127,10 +130,13 @@ export interface FilterListProps<Q extends ObjectTypeDefinition> {
 		isVisible: boolean
 	}>) => void;
 	/**
-	* Enable drag-and-drop reordering of filters.
-	* When true, drag handles are rendered and filters can be reordered.
-	* Reorder state is managed internally; consumers who need to track order
-	* should use controlled filterDefinitions.
+	* Enable drag-and-drop reordering of filters. When `true`, drag handles are
+	* rendered and filters can be reordered.
+	*
+	* Reorder state is managed internally; persist `onFilterVisibilityChange` to
+	* track order across remounts.
+	*
+	* @default false
 	*/
 	enableSorting?: boolean;
 	/**
@@ -164,12 +170,9 @@ export interface FilterListProps<Q extends ObjectTypeDefinition> {
 	*/
 	className?: string;
 	/**
-	* Custom render function for the "Add filter" button.
-	*
-	* - In uncontrolled mode: customizes the trigger element for the built-in
-	*   add-filter popover. The popover behavior is handled automatically.
-	* - In controlled mode: replaces the entire add-filter button area.
-	*   The consumer is responsible for all add-filter behavior.
+	* Custom render function for the "Add filter" button. Customizes the trigger
+	* element for the built-in add-filter popover; the popover behavior is
+	* handled automatically.
 	*/
 	renderAddFilterButton?: () => React.ReactNode;
 }

package/build/types/filter-list/FilterListApi.d.ts.map

@@ -1 +1 @@
-{"mappings":"AAgBA,cACE,WACA,WACA,sBACA,mBACK,WAAY;AACnB,YAAY,WAAW,OAAQ;AAC/B,cAAc,iBAAiB,OAAQ;AAEvC,cACE,aACA,gCACK,wBAAyB;AAChC,cAAc,8BAA8B,gCAAiC;AAC7E,cAAc,qCAAqC,+BAAgC;AACnF,cACE,yBACA,sCACK,8BAA+B;AACtC,cAAc,oCAAoC,8BAA+B;;;;;KAM5E;CACH,UAAU;CACV,UAAU,UAAU;IAClB,UAAU,UAAU,KAAK,+BAA+B,GAAG;;;;AAK/D,YAAY,sBAAsB,UAAU,wBACxC,yBAAyB,KACzB,wBAAwB,KACxB,yBAAyB,GAAG,UAAU,MACtC,8BAA8B,KAC9B,uBAAuB,KACvB,6BAA6B;;;;KAK5B,iBAAiB,KAAK,UAAU;CAAE,WAAW;AAAG,IACjD,IACA,UAAU;CAAE,gBAAgB;AAAG,IAC7B;AAGN,YAAY,UAAU,UAAU,wBAAwB,iBACtD,sBAAsB;AAGxB,iBAAiB,gBAAgB,UAAU,sBAAsB;;;;;CAK/D,YAAY;;;;;CAMZ,YAAY,UAAU;;;;;;;;;;CAWtB,yBAAyBA,WAAW,YAAY;;;;CAKhD,QAAQ;;;;CAKR,YAAY,MAAM;;;;;CAMlB,oBAAoB,MAAM,sBAAsB;;;;;;;CAQhD,wBACEC,YAAY,sBAAsB,IAClCC,UAAU;;;;;;;;;CAWZ,wBAAwBC,WAAW,UAAU;;;;;;CAO7C;;;;;;;;;;;;;CAcA,gBAAgB,eAAe;;;;;;;;;;CAW/B,iBACEC,WAAW,UAAU,IACrBC,gBAAgB,MAAM,sBAAsB;;;;;;;;;CAW9C,mBAAmBD,WAAW,UAAU;;;;;;;;CASxC,4BACEE,WAAW,MAAM;EACf,WAAW,UAAU;EACrB;CACD;;;;;;;CASH;;;;CAKA;;;;CAKA,qBAAqBC;;;;;;CAOrB,sBAAsB,YAAY;;;;CAKlC;;;;CAKA;;;;CAKA;;;;CAKA;;;;;;;;;CAUA,8BAA8B,MAAM;AACrC","names":["newClause: WhereClause<Q>","definition: FilterDefinitionUnion<Q>","newState: FilterState","objectSet: ObjectSet<Q>","filterKey: FilterKey<Q>","newDefinitions: Array<FilterDefinitionUnion<Q>>","newStates: Array<{\n      filterKey: FilterKey<Q>;\n      isVisible: boolean;\n    }>","collapsed: boolean"],"sources":["../../../src/filter-list/FilterListApi.ts"],"version":3,"file":"FilterListApi.d.ts"}
+{"mappings":"AAgBA,cACE,WACA,WACA,sBACA,mBACK,WAAY;AACnB,YAAY,WAAW,OAAQ;AAC/B,cAAc,iBAAiB,OAAQ;AAEvC,cACE,aACA,gCACK,wBAAyB;AAChC,cAAc,8BAA8B,gCAAiC;AAC7E,cAAc,qCAAqC,+BAAgC;AACnF,cACE,yBACA,sCACK,8BAA+B;AACtC,cAAc,oCAAoC,8BAA+B;;;;;KAM5E;CACH,UAAU;CACV,UAAU,UAAU;IAClB,UAAU,UAAU,KAAK,+BAA+B,GAAG;;;;AAK/D,YAAY,sBAAsB,UAAU,wBACxC,yBAAyB,KACzB,wBAAwB,KACxB,yBAAyB,GAAG,UAAU,MACtC,8BAA8B,KAC9B,uBAAuB,KACvB,6BAA6B;;;;KAK5B,iBAAiB,KAAK,UAAU;CAAE,WAAW;AAAG,IACjD,IACA,UAAU;CAAE,gBAAgB;AAAG,IAC7B;AAGN,YAAY,UAAU,UAAU,wBAAwB,iBACtD,sBAAsB;AAGxB,iBAAiB,gBAAgB,UAAU,sBAAsB;;;;;CAK/D,YAAY;;;;;CAMZ,YAAY,UAAU;;;;;;;;;;CAWtB,yBAAyBA,WAAW,YAAY;;;;CAKhD,QAAQ;;;;CAKR,YAAY,MAAM;;;;;CAMlB,oBAAoB,MAAM,sBAAsB;;;;;;;CAQhD,wBACEC,YAAY,sBAAsB,IAClCC,UAAU;;;;;;;;;CAWZ,wBAAwBC,WAAW,UAAU;;;;;;CAO7C;;;;;;;;;;;;;;;;CAiBA,gBAAgB,eAAe;;;;;;;;CAS/B,iBACEC,WAAW,UAAU,IAErBC,gBAAgB,MAAM,sBAAsB;;;;;;;CAS9C,mBAAmBD,WAAW,UAAU;;;;;;;;;;;;CAaxC,4BACEE,WAAW,MAAM;EACf,WAAW,UAAU;EACrB;CACD;;;;;;;;;;CAYH;;;;CAKA;;;;CAKA,qBAAqBC;;;;;;CAOrB,sBAAsB,YAAY;;;;CAKlC;;;;CAKA;;;;CAKA;;;;CAKA;;;;;;CAOA,8BAA8B,MAAM;AACrC","names":["newClause: WhereClause<Q>","definition: FilterDefinitionUnion<Q>","newState: FilterState","objectSet: ObjectSet<Q>","filterKey: FilterKey<Q>","newDefinitions: Array<FilterDefinitionUnion<Q>>","newStates: Array<{\n      filterKey: FilterKey<Q>;\n      isVisible: boolean;\n    }>","collapsed: boolean"],"sources":["../../../src/filter-list/FilterListApi.ts"],"version":3,"file":"FilterListApi.d.ts"}

package/docs/FilterList.md

@@ -66,30 +66,30 @@ function EmployeeFilters() {
 
 Type parameters: `Q extends ObjectTypeDefinition`
 
-| Name                       | Type                                                                                 | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
-| -------------------------- | ------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `objectType`               | `Q`                                                                                  | **Required.** The object type definition for the objects being filtered. Used for metadata resolution (property types, display names).                                                                                                                                                                                                                                                                                                                          |
-| `objectSet`                | `ObjectSet<Q>`                                                                       | Optional object set to scope aggregation queries. When omitted, aggregations run against the full object type.                                                                                                                                                                                                                                                                                                                                                  |
-| `onFilterClauseChanged`    | `(newClause: WhereClause<Q>) => void`                                                | Called whenever the filter clause changes. FilterList owns filter state; this is how you read it out, e.g. to feed an `ObjectTable`'s `filter`.<br /><br />`LINKED_PROPERTY` filters are not represented in the clause — use `onEffectiveObjectSet` for those.                                                                                                                                                                                                  |
-| `title`                    | `ReactNode`                                                                          | Optional title to display in the filter list header                                                                                                                                                                                                                                                                                                                                                                                                             |
-| `titleIcon`                | `React.ReactNode`                                                                    | Optional icon to display next to the title                                                                                                                                                                                                                                                                                                                                                                                                                      |
-| `filterDefinitions`        | `Array<FilterDefinitionUnion<Q>>`                                                    | The definition for all supported filter items in the list If not supplied, all filterable properties will be available                                                                                                                                                                                                                                                                                                                                          |
-| `onFilterStateChanged`     | `(definition: FilterDefinitionUnion<Q>, newState: FilterState) => void`              | Called when filter state changes                                                                                                                                                                                                                                                                                                                                                                                                                                |
-| `onEffectiveObjectSet`     | `(objectSet: ObjectSet<Q>) => void`                                                  | Called with the narrowed `ObjectSet` whenever filters change. Requires `objectSet` to be set.<br /><br />A linked filter only narrows the set when its definition has `reverseLinkName`. Linked filters without it are skipped here; read their state from `onFilterStateChanged` instead.                                                                                                                                                                      |
-| `showFilteredOutValues`    | `boolean`                                                                            | When `true`, facets render greyed-out count=0 rows for values present in the unfiltered data but excluded by other active filters. Defaults to `false`.                                                                                                                                                                                                                                                                                                         |
-| `addFilterMode`            | `"controlled" \| "uncontrolled"`                                                     | Controls how filter visibility (add/remove) is managed.<br /><br />- `"uncontrolled"` (default): FilterList manages visibility internally. An "Add filter" popover is rendered for filters with `isVisible: false`, and each visible filter shows a remove button. - `"controlled"`: The consumer manages which filters are visible via `filterDefinitions`. Filters with `isVisible: false` are excluded from the rendered list. Defaults to `"uncontrolled"`. |
-| `onFilterAdded`            | `(filterKey: FilterKey<Q>, newDefinitions: Array<FilterDefinitionUnion<Q>>) => void` | Called when a filter is added (shown).<br /><br />In uncontrolled mode, this fires when a user selects a hidden filter from the "Add filter" popover.                                                                                                                                                                                                                                                                                                           |
-| `onFilterRemoved`          | `(filterKey: FilterKey<Q>) => void`                                                  | Called when a filter is removed (hidden).<br /><br />In uncontrolled mode, this fires as a notification after the filter is hidden internally.                                                                                                                                                                                                                                                                                                                  |
-| `onFilterVisibilityChange` | `(newStates: Array<{ filterKey: FilterKey<Q>; isVisible: boolean; }>) => void`       | Called when filter visibility or ordering changes, i.e. when filters are reordered, or (in uncontrolled mode) added or removed via the built-in show/remove controls.                                                                                                                                                                                                                                                                                           |
-| `enableSorting`            | `boolean`                                                                            | Enable drag-and-drop reordering of filters. When true, drag handles are rendered and filters can be reordered. Reorder state is managed internally; consumers who need to track order should use controlled filterDefinitions.                                                                                                                                                                                                                                  |
-| `collapsed`                | `boolean`                                                                            | Whether the filter list panel is collapsed                                                                                                                                                                                                                                                                                                                                                                                                                      |
-| `onCollapsedChange`        | `(collapsed: boolean) => void`                                                       | Called when the collapsed state changes                                                                                                                                                                                                                                                                                                                                                                                                                         |
-| `initialFilterStates`      | `Map<string, FilterState>`                                                           | Initial filter states for hydrating from external storage. These states are merged over definition defaults on mount. Use onFilterStateChanged to persist state changes externally.                                                                                                                                                                                                                                                                             |
-| `showResetButton`          | `boolean`                                                                            | Show reset filters button in header                                                                                                                                                                                                                                                                                                                                                                                                                             |
-| `onReset`                  | `() => void`                                                                         | Called when reset button is clicked                                                                                                                                                                                                                                                                                                                                                                                                                             |
-| `showActiveFilterCount`    | `boolean`                                                                            | Show count of active filters in header                                                                                                                                                                                                                                                                                                                                                                                                                          |
-| `className`                | `string`                                                                             | Additional CSS class name                                                                                                                                                                                                                                                                                                                                                                                                                                       |
-| `renderAddFilterButton`    | `() => React.ReactNode`                                                              | Custom render function for the "Add filter" button.<br /><br />- In uncontrolled mode: customizes the trigger element for the built-in add-filter popover. The popover behavior is handled automatically. - In controlled mode: replaces the entire add-filter button area. The consumer is responsible for all add-filter behavior.                                                                                                                            |
+| Name                       | Type                                                                                 | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| -------------------------- | ------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `objectType`               | `Q`                                                                                  | **Required.** The object type definition for the objects being filtered. Used for metadata resolution (property types, display names).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
+| `objectSet`                | `ObjectSet<Q>`                                                                       | Optional object set to scope aggregation queries. When omitted, aggregations run against the full object type.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| `onFilterClauseChanged`    | `(newClause: WhereClause<Q>) => void`                                                | Called whenever the filter clause changes. FilterList owns filter state; this is how you read it out, e.g. to feed an `ObjectTable`'s `filter`.<br /><br />`LINKED_PROPERTY` filters are not represented in the clause — use `onEffectiveObjectSet` for those.                                                                                                                                                                                                                                                                                                                                                                                             |
+| `title`                    | `ReactNode`                                                                          | Optional title to display in the filter list header                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
+| `titleIcon`                | `React.ReactNode`                                                                    | Optional icon to display next to the title                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| `filterDefinitions`        | `Array<FilterDefinitionUnion<Q>>`                                                    | The definition for all supported filter items in the list If not supplied, all filterable properties will be available                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
+| `onFilterStateChanged`     | `(definition: FilterDefinitionUnion<Q>, newState: FilterState) => void`              | Called when filter state changes                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
+| `onEffectiveObjectSet`     | `(objectSet: ObjectSet<Q>) => void`                                                  | Called with the narrowed `ObjectSet` whenever filters change. Requires `objectSet` to be set.<br /><br />A linked filter only narrows the set when its definition has `reverseLinkName`. Linked filters without it are skipped here; read their state from `onFilterStateChanged` instead.                                                                                                                                                                                                                                                                                                                                                                 |
+| `showFilteredOutValues`    | `boolean`                                                                            | When `true`, facets render greyed-out count=0 rows for values present in the unfiltered data but excluded by other active filters. Defaults to `false`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `addFilterMode`            | `"controlled" \| "uncontrolled"`                                                     | **Deprecated** — Going away; visibility will always be managed internally. Seed it with `isVisible` on each `filterDefinitions` entry and observe changes with `onFilterVisibilityChange`. Controls how filter visibility (add/remove) is managed.<br /><br />- `"uncontrolled"` (default): FilterList manages visibility internally. An "Add filter" popover is rendered for filters with `isVisible: false`, and each visible filter shows a remove button. - `"controlled"`: The consumer manages which filters are visible via `filterDefinitions`. Filters with `isVisible: false` are excluded from the rendered list. Defaults to `"uncontrolled"`. |
+| `onFilterAdded`            | `(filterKey: FilterKey<Q>, newDefinitions: Array<FilterDefinitionUnion<Q>>) => void` | Called after a filter is shown from the built-in "Add filter" popover.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
+| `onFilterRemoved`          | `(filterKey: FilterKey<Q>) => void`                                                  | Called after a filter's remove button is clicked, once the filter is hidden and its state cleared.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| `onFilterVisibilityChange` | `(newStates: Array<{ filterKey: FilterKey<Q>; isVisible: boolean; }>) => void`       | Called when filter visibility or ordering changes, i.e. when filters are reordered, added or removed via the built-in show/remove controls, or reset.<br /><br />Visible filters come first, in display order, followed by the hidden ones. Persist this array and feed it back as the order and `isVisible` of `filterDefinitions` to make reordering survive a remount.                                                                                                                                                                                                                                                                                  |
+| `enableSorting`            | `boolean`                                                                            | Enable drag-and-drop reordering of filters. When `true`, drag handles are rendered and filters can be reordered.<br /><br />Reorder state is managed internally; persist `onFilterVisibilityChange` to track order across remounts. Defaults to `false`.                                                                                                                                                                                                                                                                                                                                                                                                   |
+| `collapsed`                | `boolean`                                                                            | Whether the filter list panel is collapsed                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| `onCollapsedChange`        | `(collapsed: boolean) => void`                                                       | Called when the collapsed state changes                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `initialFilterStates`      | `Map<string, FilterState>`                                                           | Initial filter states for hydrating from external storage. These states are merged over definition defaults on mount. Use onFilterStateChanged to persist state changes externally.                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
+| `showResetButton`          | `boolean`                                                                            | Show reset filters button in header                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
+| `onReset`                  | `() => void`                                                                         | Called when reset button is clicked                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
+| `showActiveFilterCount`    | `boolean`                                                                            | Show count of active filters in header                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
+| `className`                | `string`                                                                             | Additional CSS class name                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| `renderAddFilterButton`    | `() => React.ReactNode`                                                              | Custom render function for the "Add filter" button. Customizes the trigger element for the built-in add-filter popover; the popover behavior is handled automatically.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
 
 <!-- AUTOGEN:props END -->
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@osdk/react-components",
-  "version": "0.48.0",
+  "version": "0.49.0-main-ff0ef7e7cc3986538c90f5632028a422b404d2eb",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -203,9 +203,9 @@
   },
   "peerDependencies": {
     "@osdk/aip-core": ">=0.5.0 <1.0.0",
-    "@osdk/api": "^2.8.0",
-    "@osdk/client": "^2.8.0",
-    "@osdk/react": "^2.8.0",
+    "@osdk/api": ">=2.56.1-beta.0",
+    "@osdk/client": ">=2.56.1-beta.0",
+    "@osdk/react": ">=2.56.1-beta.0",
     "@types/react": "^17 || ^18 || ^19",
     "classnames": "^2.0.0",
     "react": "^17 || ^18 || ^19",
@@ -228,11 +228,11 @@
     "react-dom": "^18.3.1",
     "typescript": "~5.5.4",
     "@osdk/aip-core": "0.9.0",
-    "@osdk/api": "2.56.0",
-    "@osdk/client": "2.56.0",
-    "@osdk/monorepo.tsconfig": "~0.7.0",
+    "@osdk/api": "2.56.1-main-ff0ef7e7cc3986538c90f5632028a422b404d2eb",
+    "@osdk/client": "2.56.1-main-ff0ef7e7cc3986538c90f5632028a422b404d2eb",
     "@osdk/monorepo.api-extractor": "~0.7.0",
-    "@osdk/react": "2.56.0"
+    "@osdk/monorepo.tsconfig": "~0.7.0",
+    "@osdk/react": "2.56.1-main-ff0ef7e7cc3986538c90f5632028a422b404d2eb"
   },
   "publishConfig": {
     "access": "public"

package/build/cjs/chunk-56TROTOG.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/util/UserAgent.ts","../../src/util/withOsdkMetrics.ts"],"names":["useRegisterUserAgent","React"],"mappings":";;;;;;;;;;;;AAgBA,IAAM,kBAAA,GAAqB,yBAAyB,QAA2B,CAAA,CAAA;AACxE,SAAS,mBAAmB,aAAA,EAAe;AAChD,EAAA,OAAO,CAAA,EAAG,kBAAkB,CAAA,CAAA,EAAI,aAAa,CAAA,CAAA;AAC/C;;;ACKO,SAAS,eAAA,CAAgB,WAAW,IAAA,EAAM;AAC/C,EAAA,MAAM,UAAU,CAAA,KAAA,KAAS;AACvB,IAAAA,0BAAA,CAAqB,kBAAA,CAAmB,IAAI,CAAC,CAAA;AAC7C,IAAA,uBAAoBC,sBAAA,CAAM,aAAA,CAAc,SAAA,EAAW,KAAK,CAAA;AAAA,EAC1D,CAAA;AACA,EAAA,OAAA,CAAQ,WAAA,GAAc,mBAAmB,IAAI,CAAA,CAAA,CAAA;AAC7C,EAAA,OAAO,OAAA;AACT","file":"chunk-56TROTOG.cjs","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\nconst PACKAGE_USER_AGENT = `osdk-react-components/${process.env.PACKAGE_VERSION}`;\nexport function componentUserAgent(componentName) {\n  return `${PACKAGE_USER_AGENT}/${componentName}`;\n}","/*\n * Copyright 2026 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 { useRegisterUserAgent } from \"@osdk/react\";\nimport React from \"react\";\nimport { componentUserAgent } from \"./UserAgent.js\";\n\n// `any` is required: FunctionComponent defaults to FunctionComponent<{}> which\n// rejects components with required props. A generic P parameter doesn't help\n// because TS can't infer both P and C simultaneously from a single argument.\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function withOsdkMetrics(Component, name) {\n  const Wrapped = props => {\n    useRegisterUserAgent(componentUserAgent(name));\n    return /*#__PURE__*/React.createElement(Component, props);\n  };\n  Wrapped.displayName = `withOsdkMetrics(${name})`;\n  return Wrapped;\n}"]}