@osdk/react-components 0.4.0 → 0.4.1-main-6b2c638658dbe4aad3cb1b827607371baec6fb32

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @osdk/react-components
 
+## 0.4.1-main-6b2c638658dbe4aad3cb1b827607371baec6fb32
+
+### Patch Changes
+
+- e456da5: Add Fetch-User-Agent tracing headers for React layer network calls
+- Updated dependencies [58248f8]
+- Updated dependencies [e456da5]
+  - @osdk/react@0.12.1-main-6b2c638658dbe4aad3cb1b827607371baec6fb32
+  - @osdk/client@2.10.1-main-6b2c638658dbe4aad3cb1b827607371baec6fb32
+  - @osdk/api@2.10.1-main-6b2c638658dbe4aad3cb1b827607371baec6fb32
+
 ## 0.4.0
 
 ### Minor Changes

package/README.md

@@ -177,6 +177,7 @@ When building new components:
 3. Keep the Base component API simple using primitive types
 4. For complex components, consider a building blocks tier with sub-components and hooks
 5. Document all layers for users who want to customize
+6. **Register a user agent for metrics** — wrap every OSDK component with `withOsdkMetrics` at the export barrel (see [Metrics](#metrics) below)
 
 ## Folder Structure
 
@@ -214,6 +215,31 @@ This package focuses on complex, Ontology-aware components with built-in data fe
 - Reduces maintenance burden
 - Encourages consistent use of existing design systems
 
+## Metrics
+
+Every OSDK component (the outermost data-fetching layer, **not** the Base component) must register a user agent string so that network requests include a `Fetch-User-Agent` header identifying which component initiated them. This enables usage tracking and debugging.
+
+This is handled automatically by the `withOsdkMetrics` HOC. Wrap your component at the **export barrel** (`public/experimental/*.ts`), not inside the component body:
+
+```ts
+// public/experimental/my-component.ts
+import { MyComponent as _MyComponent } from "../../my-component/MyComponent.js";
+import { withOsdkMetrics } from "../../util/withOsdkMetrics.js";
+export const MyComponent: typeof _MyComponent = withOsdkMetrics(
+  _MyComponent,
+  "MyComponent",
+);
+```
+
+`withOsdkMetrics` calls `useRegisterUserAgent` internally, producing a user agent string like `osdk-react-components/<version>/MyComponent`.
+
+**Checklist for new components:**
+
+- [ ] Wrap the OSDK component with `withOsdkMetrics` in the export barrel
+- [ ] Add `typeof _Component` annotation to satisfy `--isolatedDeclarations`
+- [ ] Do **not** wrap Base components — only the OSDK wrapper needs it
+- [ ] Do **not** call `useRegisterUserAgent` directly inside the component body
+
 ## Custom Styling
 
 See the [CSS Variables Reference](./docs/CSSVariables.md) on how to apply custom themes and styling to the components.

package/build/browser/public/experimental/action-form.js

@@ -14,6 +14,8 @@
  * limitations under the License.
  */
 
-export { ActionForm } from "../../action-form/ActionForm.js";
+import { ActionForm as _ActionForm } from "../../action-form/ActionForm.js";
+import { withOsdkMetrics } from "../../util/withOsdkMetrics.js";
+export const ActionForm = withOsdkMetrics(_ActionForm, "ActionForm");
 export { BaseForm } from "../../action-form/BaseForm.js";
 //# sourceMappingURL=action-form.js.map

package/build/browser/public/experimental/action-form.js.map

@@ -1 +1 @@
-{"version":3,"file":"action-form.js","names":["ActionForm","BaseForm"],"sources":["action-form.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 { ActionForm } from \"../../action-form/ActionForm.js\";\nexport type {\n  ActionFormProps,\n  BaseFormProps,\n  FormError,\n  FormState,\n} from \"../../action-form/ActionFormApi.js\";\nexport { BaseForm } from \"../../action-form/BaseForm.js\";\nexport type {\n  ActionParameters,\n  BaseFormFieldProps,\n  CustomFieldProps,\n  DateRange,\n  DateRangeInputFieldProps,\n  DatetimePickerFieldProps,\n  DropdownFieldProps,\n  FieldComponent,\n  FieldValueType,\n  FilePickerProps,\n  FormFieldDefinition,\n  FormFieldPropsByType,\n  NumberInputFieldProps,\n  ObjectSetFieldProps,\n  Option,\n  RadioButtonsFieldProps,\n  RendererFieldDefinition,\n  TextAreaFieldProps,\n  TextInputFieldProps,\n  ValidationError,\n} from \"../../action-form/FormFieldApi.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,UAAU,QAAQ,iCAAiC;AAO5D,SAASC,QAAQ,QAAQ,+BAA+B","ignoreList":[]}
+{"version":3,"file":"action-form.js","names":["ActionForm","_ActionForm","withOsdkMetrics","BaseForm"],"sources":["action-form.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 { ActionForm as _ActionForm } from \"../../action-form/ActionForm.js\";\nimport { withOsdkMetrics } from \"../../util/withOsdkMetrics.js\";\nexport const ActionForm: typeof _ActionForm = withOsdkMetrics(\n  _ActionForm,\n  \"ActionForm\",\n);\nexport type {\n  ActionFormProps,\n  BaseFormProps,\n  FormError,\n  FormState,\n} from \"../../action-form/ActionFormApi.js\";\nexport { BaseForm } from \"../../action-form/BaseForm.js\";\nexport type {\n  ActionParameters,\n  BaseFormFieldProps,\n  CustomFieldProps,\n  DateRange,\n  DateRangeInputFieldProps,\n  DatetimePickerFieldProps,\n  DropdownFieldProps,\n  FieldComponent,\n  FieldValueType,\n  FilePickerProps,\n  FormFieldDefinition,\n  FormFieldPropsByType,\n  NumberInputFieldProps,\n  ObjectSetFieldProps,\n  Option,\n  RadioButtonsFieldProps,\n  RendererFieldDefinition,\n  TextAreaFieldProps,\n  TextInputFieldProps,\n  ValidationError,\n} from \"../../action-form/FormFieldApi.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,UAAU,IAAIC,WAAW,QAAQ,iCAAiC;AAC3E,SAASC,eAAe,QAAQ,+BAA+B;AAC/D,OAAO,MAAMF,UAA8B,GAAGE,eAAe,CAC3DD,WAAW,EACX,YACF,CAAC;AAOD,SAASE,QAAQ,QAAQ,+BAA+B","ignoreList":[]}

package/build/browser/public/experimental/filter-list.js

@@ -15,6 +15,8 @@
  */
 
 export { BaseFilterList } from "../../filter-list/base/BaseFilterList.js";
-export { FilterList } from "../../filter-list/FilterList.js";
+import { FilterList as _FilterList } from "../../filter-list/FilterList.js";
+import { withOsdkMetrics } from "../../util/withOsdkMetrics.js";
+export const FilterList = withOsdkMetrics(_FilterList, "FilterList");
 export { deserializeFilterStates, serializeFilterStates } from "../../filter-list/utils/filterStateSerialization.js";
 //# sourceMappingURL=filter-list.js.map

package/build/browser/public/experimental/filter-list.js.map

@@ -1 +1 @@
-{"version":3,"file":"filter-list.js","names":["BaseFilterList","FilterList","deserializeFilterStates","serializeFilterStates"],"sources":["filter-list.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 { BaseFilterList } from \"../../filter-list/base/BaseFilterList.js\";\nexport type {\n  BaseFilterListProps,\n  RenderFilterInput,\n} from \"../../filter-list/base/BaseFilterListApi.js\";\nexport { FilterList } from \"../../filter-list/FilterList.js\";\n\nexport type {\n  FilterDefinitionUnion,\n  FilterListProps,\n} from \"../../filter-list/FilterListApi.js\";\nexport type {\n  FilterComponentType,\n  FilterListItemProps,\n  FilterState,\n  PropertyFilterDefinition,\n} from \"../../filter-list/FilterListItemApi.js\";\nexport {\n  deserializeFilterStates,\n  serializeFilterStates,\n} from \"../../filter-list/utils/filterStateSerialization.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,cAAc,QAAQ,0CAA0C;AAKzE,SAASC,UAAU,QAAQ,iCAAiC;AAY5D,SACEC,uBAAuB,EACvBC,qBAAqB,QAChB,qDAAqD","ignoreList":[]}
+{"version":3,"file":"filter-list.js","names":["BaseFilterList","FilterList","_FilterList","withOsdkMetrics","deserializeFilterStates","serializeFilterStates"],"sources":["filter-list.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 { BaseFilterList } from \"../../filter-list/base/BaseFilterList.js\";\nexport type {\n  BaseFilterListProps,\n  RenderFilterInput,\n} from \"../../filter-list/base/BaseFilterListApi.js\";\nimport { FilterList as _FilterList } from \"../../filter-list/FilterList.js\";\nimport { withOsdkMetrics } from \"../../util/withOsdkMetrics.js\";\nexport const FilterList: typeof _FilterList = withOsdkMetrics(\n  _FilterList,\n  \"FilterList\",\n);\n\nexport type {\n  FilterDefinitionUnion,\n  FilterListProps,\n} from \"../../filter-list/FilterListApi.js\";\nexport type {\n  FilterComponentType,\n  FilterListItemProps,\n  FilterState,\n  PropertyFilterDefinition,\n} from \"../../filter-list/FilterListItemApi.js\";\nexport {\n  deserializeFilterStates,\n  serializeFilterStates,\n} from \"../../filter-list/utils/filterStateSerialization.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,cAAc,QAAQ,0CAA0C;AAKzE,SAASC,UAAU,IAAIC,WAAW,QAAQ,iCAAiC;AAC3E,SAASC,eAAe,QAAQ,+BAA+B;AAC/D,OAAO,MAAMF,UAA8B,GAAGE,eAAe,CAC3DD,WAAW,EACX,YACF,CAAC;AAYD,SACEE,uBAAuB,EACvBC,qBAAqB,QAChB,qDAAqD","ignoreList":[]}

package/build/browser/public/experimental/object-table.js

@@ -15,7 +15,9 @@
  */
 
 // ObjectTable that loads and displays data for a given objectSet
-export { ObjectTable } from "../../object-table/ObjectTable.js";
+import { ObjectTable as _ObjectTable } from "../../object-table/ObjectTable.js";
+import { withOsdkMetrics } from "../../util/withOsdkMetrics.js";
+export const ObjectTable = withOsdkMetrics(_ObjectTable, "ObjectTable");
 
 // BaseTable that does not handle data fetching
 

package/build/browser/public/experimental/object-table.js.map

@@ -1 +1 @@
-{"version":3,"file":"object-table.js","names":["ObjectTable","BaseTable","ColumnConfigDialog","MultiColumnSortDialog"],"sources":["object-table.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// ObjectTable that loads and displays data for a given objectSet\nexport { ObjectTable } from \"../../object-table/ObjectTable.js\";\nexport type {\n  ColumnDefinition,\n  ColumnDefinitionLocator,\n  CustomColumnLocator,\n  DatePickerEditConfig,\n  DropdownEditConfig,\n  EditFieldConfig,\n  FunctionColumnLocator,\n  ObjectTableProps,\n  PropertyColumnLocator,\n  RdpColumnLocator,\n} from \"../../object-table/ObjectTableApi.js\";\nexport type { CellEditInfo } from \"../../object-table/utils/types.js\";\n\n// BaseTable that does not handle data fetching\nexport type { BaseTableProps } from \"../../object-table/Table.js\";\nexport { BaseTable } from \"../../object-table/Table.js\";\n\nexport { ColumnConfigDialog } from \"../../object-table/ColumnConfigDialog.js\";\nexport type {\n  ColumnConfigDialogProps,\n  ColumnConfigOptions,\n} from \"../../object-table/ColumnConfigDialog.js\";\n\nexport { MultiColumnSortDialog } from \"../../object-table/MultiColumnSortDialog.js\";\nexport type {\n  MultiColumnSortDialogProps,\n  SortColumnItem,\n} from \"../../object-table/MultiColumnSortDialog.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA,SAASA,WAAW,QAAQ,mCAAmC;;AAe/D;;AAEA,SAASC,SAAS,QAAQ,6BAA6B;AAEvD,SAASC,kBAAkB,QAAQ,0CAA0C;AAM7E,SAASC,qBAAqB,QAAQ,6CAA6C","ignoreList":[]}
+{"version":3,"file":"object-table.js","names":["ObjectTable","_ObjectTable","withOsdkMetrics","BaseTable","ColumnConfigDialog","MultiColumnSortDialog"],"sources":["object-table.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// ObjectTable that loads and displays data for a given objectSet\nimport { ObjectTable as _ObjectTable } from \"../../object-table/ObjectTable.js\";\nimport { withOsdkMetrics } from \"../../util/withOsdkMetrics.js\";\nexport const ObjectTable: typeof _ObjectTable = withOsdkMetrics(\n  _ObjectTable,\n  \"ObjectTable\",\n);\nexport type {\n  ColumnDefinition,\n  ColumnDefinitionLocator,\n  CustomColumnLocator,\n  DatePickerEditConfig,\n  DropdownEditConfig,\n  EditFieldConfig,\n  FunctionColumnLocator,\n  ObjectTableProps,\n  PropertyColumnLocator,\n  RdpColumnLocator,\n} from \"../../object-table/ObjectTableApi.js\";\nexport type { CellEditInfo } from \"../../object-table/utils/types.js\";\n\n// BaseTable that does not handle data fetching\nexport type { BaseTableProps } from \"../../object-table/Table.js\";\nexport { BaseTable } from \"../../object-table/Table.js\";\n\nexport { ColumnConfigDialog } from \"../../object-table/ColumnConfigDialog.js\";\nexport type {\n  ColumnConfigDialogProps,\n  ColumnConfigOptions,\n} from \"../../object-table/ColumnConfigDialog.js\";\n\nexport { MultiColumnSortDialog } from \"../../object-table/MultiColumnSortDialog.js\";\nexport type {\n  MultiColumnSortDialogProps,\n  SortColumnItem,\n} from \"../../object-table/MultiColumnSortDialog.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA,SAASA,WAAW,IAAIC,YAAY,QAAQ,mCAAmC;AAC/E,SAASC,eAAe,QAAQ,+BAA+B;AAC/D,OAAO,MAAMF,WAAgC,GAAGE,eAAe,CAC7DD,YAAY,EACZ,aACF,CAAC;;AAeD;;AAEA,SAASE,SAAS,QAAQ,6BAA6B;AAEvD,SAASC,kBAAkB,QAAQ,0CAA0C;AAM7E,SAASC,qBAAqB,QAAQ,6CAA6C","ignoreList":[]}

package/build/browser/public/experimental/pdf-viewer.js

@@ -41,5 +41,7 @@ export { usePdfViewerCore } from "../../pdf-viewer/hooks/usePdfViewerCore.js";
 export { usePdfViewerState } from "../../pdf-viewer/hooks/usePdfViewerState.js";
 
 // PdfViewer (Media wrapper)
-export { PdfViewer } from "../../pdf-viewer/PdfRenderer.js";
+import { PdfViewer as _PdfViewer } from "../../pdf-viewer/PdfRenderer.js";
+import { withOsdkMetrics } from "../../util/withOsdkMetrics.js";
+export const PdfViewer = withOsdkMetrics(_PdfViewer, "PdfViewer");
 //# sourceMappingURL=pdf-viewer.js.map

package/build/browser/public/experimental/pdf-viewer.js.map

@@ -1 +1 @@
-{"version":3,"file":"pdf-viewer.js","names":["BasePdfViewer","PdfViewerAnnotationLayer","PdfViewerContent","PdfViewerOutlineSidebar","PdfViewerSearchBar","PdfViewerSidebar","PdfViewerToolbar","usePdfAnnotationPortals","usePdfAnnotationsByPage","usePdfDocument","usePdfFormFields","usePdfHighlightMode","usePdfOutline","usePdfViewer","usePdfViewerSearch","usePdfViewerSync","PdfViewerProvider","usePdfViewerContext","usePdfViewerInstance","usePdfViewerCore","usePdfViewerState","PdfViewer"],"sources":["pdf-viewer.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// PdfViewer\nexport { BasePdfViewer } from \"../../pdf-viewer/PdfViewer.js\";\nexport type {\n  AnnotationType,\n  PdfAnnotation,\n  PdfAnnotationRenderProps,\n  PdfCustomAnnotation,\n  PdfDownloadResult,\n  PdfFormFieldValue,\n  PdfRect,\n  PdfTextHighlightEvent,\n  PdfViewerProps,\n  SidebarMode,\n} from \"../../pdf-viewer/types.js\";\n\n// PdfViewer building blocks\nexport {\n  PdfViewerAnnotationLayer,\n  type PdfViewerAnnotationLayerProps,\n} from \"../../pdf-viewer/components/PdfViewerAnnotationLayer.js\";\nexport {\n  PdfViewerContent,\n  type PdfViewerContentProps,\n} from \"../../pdf-viewer/components/PdfViewerContent.js\";\nexport {\n  PdfViewerOutlineSidebar,\n  type PdfViewerOutlineSidebarProps,\n} from \"../../pdf-viewer/components/PdfViewerOutlineSidebar.js\";\nexport {\n  PdfViewerSearchBar,\n  type PdfViewerSearchBarProps,\n} from \"../../pdf-viewer/components/PdfViewerSearchBar.js\";\nexport {\n  PdfViewerSidebar,\n  type PdfViewerSidebarProps,\n} from \"../../pdf-viewer/components/PdfViewerSidebar.js\";\nexport {\n  PdfViewerToolbar,\n  type PdfViewerToolbarProps,\n} from \"../../pdf-viewer/components/PdfViewerToolbar.js\";\n\n// PdfViewer hooks — primitive\nexport {\n  type AnnotationPortalTarget,\n  usePdfAnnotationPortals,\n} from \"../../pdf-viewer/hooks/usePdfAnnotationPortals.js\";\nexport { usePdfAnnotationsByPage } from \"../../pdf-viewer/hooks/usePdfAnnotationsByPage.js\";\nexport { usePdfDocument } from \"../../pdf-viewer/hooks/usePdfDocument.js\";\nexport {\n  usePdfFormFields,\n  type UsePdfFormFieldsOptions,\n  type UsePdfFormFieldsResult,\n} from \"../../pdf-viewer/hooks/usePdfFormFields.js\";\nexport {\n  usePdfHighlightMode,\n  type UsePdfHighlightModeOptions,\n  type UsePdfHighlightModeResult,\n} from \"../../pdf-viewer/hooks/usePdfHighlightMode.js\";\nexport { usePdfOutline } from \"../../pdf-viewer/hooks/usePdfOutline.js\";\nexport {\n  usePdfViewer,\n  type UsePdfViewerResult,\n} from \"../../pdf-viewer/hooks/usePdfViewer.js\";\nexport {\n  usePdfViewerSearch,\n  type UsePdfViewerSearchResult,\n} from \"../../pdf-viewer/hooks/usePdfViewerSearch.js\";\nexport { usePdfViewerSync } from \"../../pdf-viewer/hooks/usePdfViewerSync.js\";\nexport { type OutlineItem } from \"../../pdf-viewer/types.js\";\n\n// PdfViewer context\nexport {\n  type PdfViewerContextValue,\n  PdfViewerProvider,\n  usePdfViewerContext,\n  usePdfViewerInstance,\n} from \"../../pdf-viewer/PdfViewerContext.js\";\nexport type {\n  PdfViewerHandle,\n  PdfViewerInstanceOptions,\n} from \"../../pdf-viewer/types.js\";\n\n// PdfViewer hooks — composition\nexport {\n  usePdfViewerCore,\n  type UsePdfViewerCoreOptions,\n  type UsePdfViewerCoreResult,\n} from \"../../pdf-viewer/hooks/usePdfViewerCore.js\";\nexport {\n  usePdfViewerState,\n  type UsePdfViewerStateOptions,\n  type UsePdfViewerStateResult,\n} from \"../../pdf-viewer/hooks/usePdfViewerState.js\";\n\n// PdfViewer (Media wrapper)\nexport {\n  PdfViewer,\n  type PdfViewerMediaProps,\n} from \"../../pdf-viewer/PdfRenderer.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA,SAASA,aAAa,QAAQ,+BAA+B;AAc7D;AACA,SACEC,wBAAwB,QAEnB,yDAAyD;AAChE,SACEC,gBAAgB,QAEX,iDAAiD;AACxD,SACEC,uBAAuB,QAElB,wDAAwD;AAC/D,SACEC,kBAAkB,QAEb,mDAAmD;AAC1D,SACEC,gBAAgB,QAEX,iDAAiD;AACxD,SACEC,gBAAgB,QAEX,iDAAiD;;AAExD;AACA,SAEEC,uBAAuB,QAClB,mDAAmD;AAC1D,SAASC,uBAAuB,QAAQ,mDAAmD;AAC3F,SAASC,cAAc,QAAQ,0CAA0C;AACzE,SACEC,gBAAgB,QAGX,4CAA4C;AACnD,SACEC,mBAAmB,QAGd,+CAA+C;AACtD,SAASC,aAAa,QAAQ,yCAAyC;AACvE,SACEC,YAAY,QAEP,wCAAwC;AAC/C,SACEC,kBAAkB,QAEb,8CAA8C;AACrD,SAASC,gBAAgB,QAAQ,4CAA4C;AAG7E;AACA,SAEEC,iBAAiB,EACjBC,mBAAmB,EACnBC,oBAAoB,QACf,sCAAsC;AAM7C;AACA,SACEC,gBAAgB,QAGX,4CAA4C;AACnD,SACEC,iBAAiB,QAGZ,6CAA6C;;AAEpD;AACA,SACEC,SAAS,QAEJ,iCAAiC","ignoreList":[]}
+{"version":3,"file":"pdf-viewer.js","names":["BasePdfViewer","PdfViewerAnnotationLayer","PdfViewerContent","PdfViewerOutlineSidebar","PdfViewerSearchBar","PdfViewerSidebar","PdfViewerToolbar","usePdfAnnotationPortals","usePdfAnnotationsByPage","usePdfDocument","usePdfFormFields","usePdfHighlightMode","usePdfOutline","usePdfViewer","usePdfViewerSearch","usePdfViewerSync","PdfViewerProvider","usePdfViewerContext","usePdfViewerInstance","usePdfViewerCore","usePdfViewerState","PdfViewer","_PdfViewer","withOsdkMetrics"],"sources":["pdf-viewer.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// PdfViewer\nexport { BasePdfViewer } from \"../../pdf-viewer/PdfViewer.js\";\nexport type {\n  AnnotationType,\n  PdfAnnotation,\n  PdfAnnotationRenderProps,\n  PdfCustomAnnotation,\n  PdfDownloadResult,\n  PdfFormFieldValue,\n  PdfRect,\n  PdfTextHighlightEvent,\n  PdfViewerProps,\n  SidebarMode,\n} from \"../../pdf-viewer/types.js\";\n\n// PdfViewer building blocks\nexport {\n  PdfViewerAnnotationLayer,\n  type PdfViewerAnnotationLayerProps,\n} from \"../../pdf-viewer/components/PdfViewerAnnotationLayer.js\";\nexport {\n  PdfViewerContent,\n  type PdfViewerContentProps,\n} from \"../../pdf-viewer/components/PdfViewerContent.js\";\nexport {\n  PdfViewerOutlineSidebar,\n  type PdfViewerOutlineSidebarProps,\n} from \"../../pdf-viewer/components/PdfViewerOutlineSidebar.js\";\nexport {\n  PdfViewerSearchBar,\n  type PdfViewerSearchBarProps,\n} from \"../../pdf-viewer/components/PdfViewerSearchBar.js\";\nexport {\n  PdfViewerSidebar,\n  type PdfViewerSidebarProps,\n} from \"../../pdf-viewer/components/PdfViewerSidebar.js\";\nexport {\n  PdfViewerToolbar,\n  type PdfViewerToolbarProps,\n} from \"../../pdf-viewer/components/PdfViewerToolbar.js\";\n\n// PdfViewer hooks — primitive\nexport {\n  type AnnotationPortalTarget,\n  usePdfAnnotationPortals,\n} from \"../../pdf-viewer/hooks/usePdfAnnotationPortals.js\";\nexport { usePdfAnnotationsByPage } from \"../../pdf-viewer/hooks/usePdfAnnotationsByPage.js\";\nexport { usePdfDocument } from \"../../pdf-viewer/hooks/usePdfDocument.js\";\nexport {\n  usePdfFormFields,\n  type UsePdfFormFieldsOptions,\n  type UsePdfFormFieldsResult,\n} from \"../../pdf-viewer/hooks/usePdfFormFields.js\";\nexport {\n  usePdfHighlightMode,\n  type UsePdfHighlightModeOptions,\n  type UsePdfHighlightModeResult,\n} from \"../../pdf-viewer/hooks/usePdfHighlightMode.js\";\nexport { usePdfOutline } from \"../../pdf-viewer/hooks/usePdfOutline.js\";\nexport {\n  usePdfViewer,\n  type UsePdfViewerResult,\n} from \"../../pdf-viewer/hooks/usePdfViewer.js\";\nexport {\n  usePdfViewerSearch,\n  type UsePdfViewerSearchResult,\n} from \"../../pdf-viewer/hooks/usePdfViewerSearch.js\";\nexport { usePdfViewerSync } from \"../../pdf-viewer/hooks/usePdfViewerSync.js\";\nexport { type OutlineItem } from \"../../pdf-viewer/types.js\";\n\n// PdfViewer context\nexport {\n  type PdfViewerContextValue,\n  PdfViewerProvider,\n  usePdfViewerContext,\n  usePdfViewerInstance,\n} from \"../../pdf-viewer/PdfViewerContext.js\";\nexport type {\n  PdfViewerHandle,\n  PdfViewerInstanceOptions,\n} from \"../../pdf-viewer/types.js\";\n\n// PdfViewer hooks — composition\nexport {\n  usePdfViewerCore,\n  type UsePdfViewerCoreOptions,\n  type UsePdfViewerCoreResult,\n} from \"../../pdf-viewer/hooks/usePdfViewerCore.js\";\nexport {\n  usePdfViewerState,\n  type UsePdfViewerStateOptions,\n  type UsePdfViewerStateResult,\n} from \"../../pdf-viewer/hooks/usePdfViewerState.js\";\n\n// PdfViewer (Media wrapper)\nimport { PdfViewer as _PdfViewer } from \"../../pdf-viewer/PdfRenderer.js\";\nimport { withOsdkMetrics } from \"../../util/withOsdkMetrics.js\";\nexport const PdfViewer: typeof _PdfViewer = withOsdkMetrics(\n  _PdfViewer,\n  \"PdfViewer\",\n);\nexport type { PdfViewerMediaProps } from \"../../pdf-viewer/PdfRenderer.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA,SAASA,aAAa,QAAQ,+BAA+B;AAc7D;AACA,SACEC,wBAAwB,QAEnB,yDAAyD;AAChE,SACEC,gBAAgB,QAEX,iDAAiD;AACxD,SACEC,uBAAuB,QAElB,wDAAwD;AAC/D,SACEC,kBAAkB,QAEb,mDAAmD;AAC1D,SACEC,gBAAgB,QAEX,iDAAiD;AACxD,SACEC,gBAAgB,QAEX,iDAAiD;;AAExD;AACA,SAEEC,uBAAuB,QAClB,mDAAmD;AAC1D,SAASC,uBAAuB,QAAQ,mDAAmD;AAC3F,SAASC,cAAc,QAAQ,0CAA0C;AACzE,SACEC,gBAAgB,QAGX,4CAA4C;AACnD,SACEC,mBAAmB,QAGd,+CAA+C;AACtD,SAASC,aAAa,QAAQ,yCAAyC;AACvE,SACEC,YAAY,QAEP,wCAAwC;AAC/C,SACEC,kBAAkB,QAEb,8CAA8C;AACrD,SAASC,gBAAgB,QAAQ,4CAA4C;AAG7E;AACA,SAEEC,iBAAiB,EACjBC,mBAAmB,EACnBC,oBAAoB,QACf,sCAAsC;AAM7C;AACA,SACEC,gBAAgB,QAGX,4CAA4C;AACnD,SACEC,iBAAiB,QAGZ,6CAA6C;;AAEpD;AACA,SAASC,SAAS,IAAIC,UAAU,QAAQ,iCAAiC;AACzE,SAASC,eAAe,QAAQ,+BAA+B;AAC/D,OAAO,MAAMF,SAA4B,GAAGE,eAAe,CACzDD,UAAU,EACV,WACF,CAAC","ignoreList":[]}

package/build/browser/util/UserAgent.js

@@ -0,0 +1,21 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+const PACKAGE_USER_AGENT = `osdk-react-components/${"0.4.1-main-6b2c638658dbe4aad3cb1b827607371baec6fb32"}`;
+export function componentUserAgent(componentName) {
+  return `${PACKAGE_USER_AGENT}/${componentName}`;
+}
+//# sourceMappingURL=UserAgent.js.map

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

@@ -0,0 +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 =\n  `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,GACtB,gFAAsD;AAExD,OAAO,SAASC,kBAAkBA,CAACC,aAAqB,EAAU;EAChE,OAAO,GAAGF,kBAAkB,IAAIE,aAAa,EAAE;AACjD","ignoreList":[]}

package/build/browser/util/withOsdkMetrics.js

@@ -0,0 +1,33 @@
+/*
+ * Copyright 2026 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 { useRegisterUserAgent } from "@osdk/react/experimental";
+import React from "react";
+import { componentUserAgent } from "./UserAgent.js";
+
+// `any` is required: FunctionComponent defaults to FunctionComponent<{}> which
+// rejects components with required props. A generic P parameter doesn't help
+// because TS can't infer both P and C simultaneously from a single argument.
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function withOsdkMetrics(Component, name) {
+  const Wrapped = props => {
+    useRegisterUserAgent(componentUserAgent(name));
+    return /*#__PURE__*/React.createElement(Component, props);
+  };
+  Wrapped.displayName = `withOsdkMetrics(${name})`;
+  return Wrapped;
+}
+//# sourceMappingURL=withOsdkMetrics.js.map

package/build/browser/util/withOsdkMetrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"withOsdkMetrics.js","names":["useRegisterUserAgent","React","componentUserAgent","withOsdkMetrics","Component","name","Wrapped","props","createElement","displayName"],"sources":["withOsdkMetrics.ts"],"sourcesContent":["/*\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/experimental\";\nimport type { FunctionComponent } from \"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<C extends FunctionComponent<any>>(\n  Component: C,\n  name: string,\n): C {\n  const Wrapped = (props: React.ComponentProps<C>) => {\n    useRegisterUserAgent(componentUserAgent(name));\n    return React.createElement(Component, props);\n  };\n  Wrapped.displayName = `withOsdkMetrics(${name})`;\n  return Wrapped as unknown as C;\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,oBAAoB,QAAQ,0BAA0B;AAE/D,OAAOC,KAAK,MAAM,OAAO;AACzB,SAASC,kBAAkB,QAAQ,gBAAgB;;AAEnD;AACA;AACA;AACA;AACA,OAAO,SAASC,eAAeA,CAC7BC,SAAY,EACZC,IAAY,EACT;EACH,MAAMC,OAAO,GAAIC,KAA8B,IAAK;IAClDP,oBAAoB,CAACE,kBAAkB,CAACG,IAAI,CAAC,CAAC;IAC9C,oBAAOJ,KAAK,CAACO,aAAa,CAACJ,SAAS,EAAEG,KAAK,CAAC;EAC9C,CAAC;EACDD,OAAO,CAACG,WAAW,GAAG,mBAAmBJ,IAAI,GAAG;EAChD,OAAOC,OAAO;AAChB","ignoreList":[]}

package/build/cjs/{chunk-2424DUP3.cjs → chunk-3CYEDIJI.cjs}

@@ -1,5 +1,6 @@
 'use strict';
 
+var chunk3P65RY77_cjs = require('./chunk-3P65RY77.cjs');
 var chunkQ2W6GYRK_cjs = require('./chunk-Q2W6GYRK.cjs');
 var icons = require('@blueprintjs/icons');
 var classnames = require('classnames');
@@ -2157,8 +2158,11 @@ function PdfViewer({
   }, pdfViewerProps));
 }
 
+// src/public/experimental/pdf-viewer.ts
+var PdfViewer2 = chunk3P65RY77_cjs.withOsdkMetrics(PdfViewer, "PdfViewer");
+
 exports.BasePdfViewer = BasePdfViewer;
-exports.PdfViewer = PdfViewer;
+exports.PdfViewer = PdfViewer2;
 exports.PdfViewerAnnotationLayer = PdfViewerAnnotationLayer;
 exports.PdfViewerContent = PdfViewerContent;
 exports.PdfViewerOutlineSidebar = PdfViewerOutlineSidebar;
@@ -2179,5 +2183,5 @@ exports.usePdfViewerInstance = usePdfViewerInstance;
 exports.usePdfViewerSearch = usePdfViewerSearch;
 exports.usePdfViewerState = usePdfViewerState;
 exports.usePdfViewerSync = usePdfViewerSync;
-//# sourceMappingURL=chunk-2424DUP3.cjs.map
-//# sourceMappingURL=chunk-2424DUP3.cjs.map
+//# sourceMappingURL=chunk-3CYEDIJI.cjs.map
+//# sourceMappingURL=chunk-3CYEDIJI.cjs.map