@osdk/react-components 0.45.0 → 0.46.0

package/build/cjs/public/experimental.d.cts

@@ -2,20 +2,20 @@ export { ActionForm, ActionFormProps, ActionParameters, BaseForm, BaseFormFieldP
 export { BaseCbacBanner, BaseCbacPicker, BaseCbacPickerDialog, CategoryMarkingGroup, CbacBanner, CbacBannerData, CbacBannerPopover, CbacPicker, CbacPickerDialog, MarkingSelectionState, MaxClassificationConstraint, MaxClassificationField, MaxClassificationFieldProps, PickerMarking, PickerMarkingCategory, RequiredMarkingGroup, computeMarkingStates, groupMarkingsByCategory, toggleMarking } from './experimental/cbac-picker.cjs';
 export { DocumentViewer, DocumentViewerProps, ViewerType } from './experimental/document-viewer.cjs';
 export { BaseEmailViewer, EmailViewer } from './experimental/email-viewer.cjs';
-export { BaseExcelViewer, ExcelViewer } from './experimental/excel-viewer.cjs';
 export { BaseFilterList, BaseFilterListProps, FilterComponentType, FilterDefinitionControls, FilterDefinitionUnion, FilterInput, FilterInputProps, FilterList, FilterListItemProps, FilterListProps, FilterPopover, FilterPopoverProps, FilterState, LinkedFilter, NO_VALUE, PropertyFilterDefinition, RenderFilterInput, UseFilterListStateResult, deserializeFilterStates, filterHasActiveState, getFilterKey, getFilterLabel, narrowObjectSet, serializeFilterStates, summarizeFilterValue, useFilterListState } from './experimental/filter-list.cjs';
 export { BaseImageViewer, ImageViewer } from './experimental/image-viewer.cjs';
 export { MarkdownViewerMedia, MarkdownViewerMediaProps } from './experimental/markdown-renderer.cjs';
 export { AsyncCellData, BaseTable, BaseTableProps, CellEditInfo, ColumnConfigDialog, ColumnConfigDialogProps, ColumnConfigOptions, ColumnDefinition, ColumnDefinitionLocator, CustomColumnLocator, EditFieldConfig, EditModeState, EditableConfig, FunctionColumnData, FunctionColumnLocator, LoadingCell, LoadingCellContent, MultiColumnSortDialog, MultiColumnSortDialogProps, ObjectSetOptions, ObjectTable, ObjectTableDataColumn, ObjectTableDataRow, ObjectTableHandle, ObjectTableLabels, ObjectTableProps, ObjectTableSnapshot, ObjectTableSnapshotOptions, OrderBy, PopoverPosition, PropertyColumnLocator, RdpColumnLocator, RowSelectionChange, SortColumnItem, UseCellContextMenuProps, UseCellContextMenuResult, UseColumnDefsResult, UseColumnPinningProps, UseColumnPinningResult, UseColumnResizeProps, UseColumnResizeResult, UseColumnVisibilityProps, UseColumnVisibilityResult, UseEditableTableProps, UseFocusedRowProps, UseFocusedRowResult, UseFunctionColumnsDataProps, UseObjectTableDataProps, UseObjectTableDataResult, UseObjectTableSnapshotProps, UseRowSelectionChange, UseRowSelectionProps, UseRowSelectionResult, UseSelectionColumnProps, UseTableSortingProps, UseTableSortingResult, useCellContextMenu, useColumnDefs, useColumnPinning, useColumnResize, useColumnVisibility, useEditableTable, useFocusedRow, useFunctionColumnsData, useObjectTableData, useObjectTableSnapshot, useRowSelection, useSelectionColumn, useTableSorting } from './experimental/object-table.cjs';
 export { AnnotationPortalTarget, BasePdfViewer, PdfViewer, PdfViewerAnnotationLayer, PdfViewerAnnotationLayerProps, PdfViewerContent, PdfViewerContentProps, PdfViewerContextValue, PdfViewerMediaProps, PdfViewerOutlineSidebar, PdfViewerOutlineSidebarProps, PdfViewerProvider, PdfViewerSearchBar, PdfViewerSearchBarProps, PdfViewerSidebar, PdfViewerSidebarProps, PdfViewerToolbar, PdfViewerToolbarProps, UsePdfFormFieldsOptions, UsePdfFormFieldsResult, UsePdfHighlightModeOptions, UsePdfHighlightModeResult, UsePdfViewerCoreOptions, UsePdfViewerCoreResult, UsePdfViewerResult, UsePdfViewerSearchResult, UsePdfViewerStateOptions, UsePdfViewerStateResult, usePdfAnnotationPortals, usePdfAnnotationsByPage, usePdfDocument, usePdfFormFields, usePdfHighlightMode, usePdfOutline, usePdfViewer, usePdfViewerContext, usePdfViewerCore, usePdfViewerInstance, usePdfViewerSearch, usePdfViewerState, usePdfViewerSync } from './experimental/pdf-viewer.cjs';
+export { BaseSpreadsheetViewer, SpreadsheetViewer } from './experimental/spreadsheet-viewer.cjs';
 export { OsdkThemeContextValue, OsdkThemeMode, OsdkThemeProvider, OsdkThemeProviderProps, ResolvedOsdkTheme, useOsdkTheme } from './experimental/theme.cjs';
 export { TiffRenderer, TiffViewerMedia, TiffViewerMediaProps } from './experimental/tiff-renderer.cjs';
 export { BaseVideoViewer, VideoViewer } from './experimental/video-viewer.cjs';
 export { BaseXmlViewer, XmlViewer } from './experimental/xml-viewer.cjs';
 export { A as AnnotationType, O as OutlineItem, P as PdfAnnotation, a as PdfAnnotationRenderProps, b as PdfCustomAnnotation, c as PdfDownloadResult, d as PdfFormFieldValue, e as PdfRect, f as PdfSource, g as PdfTextHighlightEvent, h as PdfViewerHandle, i as PdfViewerInstanceOptions, j as PdfViewerProps, S as SidebarMode } from '../types-DDeX79uW.cjs';
 export { B as BaseEmailViewerProps, E as EmailAddress, a as EmailViewerMediaProps, P as ParsedEmail } from '../EmailViewerApi-vpg29jQa.cjs';
-export { B as BaseExcelViewerProps, E as ExcelViewerMediaProps, P as ParsedSpreadsheet, S as SheetData } from '../ExcelViewerApi-D8tqiUvS.cjs';
 export { B as BaseImageViewerProps, I as ImageViewerMediaProps } from '../ImageViewerApi-UjutcBVK.cjs';
+export { B as BaseSpreadsheetViewerProps, P as ParsedSpreadsheet, S as SheetData, a as SpreadsheetViewerMediaProps } from '../SpreadsheetViewerApi-C4-gqkkY.cjs';
 export { B as BaseVideoViewerProps, V as VideoViewerMediaProps } from '../VideoViewerApi-B9o8iEng.cjs';
 export { B as BaseXmlViewerProps, X as XmlViewerMediaProps } from '../XmlViewerApi-Bg1E6qVD.cjs';
 export { M as MarkdownRenderer, a as MarkdownRendererProps } from '../MarkdownRenderer-CIQLqUvA.cjs';

package/build/esm/document-viewer/DocumentViewer.js

@@ -21,12 +21,12 @@ import { Document as DocumentIcon } from "@blueprintjs/icons";
 import classnames from "classnames";
 import React, { useMemo } from "react";
 import { EmailViewer } from "../email-viewer/EmailViewer.js";
-import { ExcelViewer } from "../excel-viewer/ExcelViewer.js";
 import { ImageViewer } from "../images/image-viewer/ImageViewer.js";
 import { TiffViewerMedia } from "../images/tiff-renderer/TiffViewerMedia.js";
 import { MarkdownViewerMedia } from "../markdown-renderer/MarkdownViewerMedia.js";
 import { PdfViewer } from "../pdf-viewer/PdfRenderer.js";
 import { assertUnreachable } from "../shared/assertUnreachable.js";
+import { SpreadsheetViewer } from "../spreadsheet-viewer/SpreadsheetViewer.js";
 import { VideoViewer } from "../video-viewer/VideoViewer.js";
 import { XmlViewer } from "../xml-viewer/XmlViewer.js";
 import { ViewerType } from "./DocumentViewerApi.js";
@@ -59,7 +59,7 @@ function getViewerType(mimeType, fileName) {
     return ViewerType.Markdown;
   }
   if (mimeType === "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet") {
-    return ViewerType.Excel;
+    return ViewerType.Spreadsheet;
   }
   if (mimeType === "message/rfc822") {
     return ViewerType.Email;
@@ -78,7 +78,7 @@ export function DocumentViewer({
   videoViewerProps,
   tiffRendererProps,
   markdownRendererProps,
-  excelViewerProps,
+  spreadsheetViewerProps,
   emailViewerProps,
   xmlViewerProps,
   fileName,
@@ -122,11 +122,11 @@ export function DocumentViewer({
         media: media,
         className: rootClassName
       }, markdownRendererProps));
-    case ViewerType.Excel:
-      return /*#__PURE__*/React.createElement(ExcelViewer, _extends({
+    case ViewerType.Spreadsheet:
+      return /*#__PURE__*/React.createElement(SpreadsheetViewer, _extends({
         media: media,
         className: rootClassName
-      }, excelViewerProps));
+      }, spreadsheetViewerProps));
     case ViewerType.Email:
       return /*#__PURE__*/React.createElement(EmailViewer, _extends({
         media: media,

package/build/esm/document-viewer/DocumentViewer.js.map

@@ -1 +1 @@
-{"version":3,"file":"DocumentViewer.js","names":["Document","DocumentIcon","classnames","React","useMemo","EmailViewer","ExcelViewer","ImageViewer","TiffViewerMedia","MarkdownViewerMedia","PdfViewer","assertUnreachable","VideoViewer","XmlViewer","ViewerType","TiffDocumentViewer","styles","IMAGE_MIME_TYPES","Set","MARKDOWN_MIME_TYPES","XML_MIME_TYPES","isTiffFile","mimeType","fileName","lowered","toLowerCase","endsWith","getViewerType","Pdf","Tiff","has","Image","startsWith","Video","Markdown","Excel","Email","Xml","Unsupported","DocumentViewer","media","className","mimeTypeOverride","pdfViewerProps","imageViewerProps","videoViewerProps","tiffRendererProps","markdownRendererProps","excelViewerProps","emailViewerProps","xmlViewerProps","enableTiffToPdf","getMediaReference","viewerType","rootClassName","container","createElement","_extends","unsupportedContainer","unsupportedIcon"],"sources":["DocumentViewer.tsx"],"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\n/* cspell:words openxmlformats officedocument wordprocessingml spreadsheetml */\n\nimport { Document as DocumentIcon } from \"@blueprintjs/icons\";\nimport classnames from \"classnames\";\nimport React, { useMemo } from \"react\";\n\nimport { EmailViewer } from \"../email-viewer/EmailViewer.js\";\nimport { ExcelViewer } from \"../excel-viewer/ExcelViewer.js\";\nimport { ImageViewer } from \"../images/image-viewer/ImageViewer.js\";\nimport { TiffViewerMedia } from \"../images/tiff-renderer/TiffViewerMedia.js\";\nimport { MarkdownViewerMedia } from \"../markdown-renderer/MarkdownViewerMedia.js\";\nimport { PdfViewer } from \"../pdf-viewer/PdfRenderer.js\";\nimport { assertUnreachable } from \"../shared/assertUnreachable.js\";\nimport { VideoViewer } from \"../video-viewer/VideoViewer.js\";\nimport { XmlViewer } from \"../xml-viewer/XmlViewer.js\";\nimport type { DocumentViewerProps } from \"./DocumentViewerApi.js\";\nimport { ViewerType } from \"./DocumentViewerApi.js\";\nimport { TiffDocumentViewer } from \"./TiffDocumentViewer.js\";\n\nimport styles from \"./DocumentViewer.module.css\";\n\nconst IMAGE_MIME_TYPES = new Set([\n  \"image/png\",\n  \"image/jpeg\",\n  \"image/gif\",\n  \"image/svg+xml\",\n  \"image/webp\",\n  \"image/bmp\",\n]);\n\nconst MARKDOWN_MIME_TYPES = new Set([\"text/markdown\", \"text/x-markdown\"]);\n\nconst XML_MIME_TYPES = new Set([\"application/xml\", \"text/xml\"]);\n\nfunction isTiffFile(mimeType: string, fileName: string | undefined): boolean {\n  if (mimeType === \"image/tiff\") {\n    return true;\n  }\n  const lowered = fileName?.toLowerCase();\n  return (\n    lowered?.endsWith(\".tif\") === true || lowered?.endsWith(\".tiff\") === true\n  );\n}\n\nfunction getViewerType(\n  mimeType: string,\n  fileName: string | undefined,\n): ViewerType {\n  if (mimeType === \"application/pdf\") {\n    return ViewerType.Pdf;\n  }\n  if (isTiffFile(mimeType, fileName)) {\n    return ViewerType.Tiff;\n  }\n  if (IMAGE_MIME_TYPES.has(mimeType)) {\n    return ViewerType.Image;\n  }\n  if (mimeType.startsWith(\"video/\")) {\n    return ViewerType.Video;\n  }\n  if (MARKDOWN_MIME_TYPES.has(mimeType)) {\n    return ViewerType.Markdown;\n  }\n  if (\n    mimeType ===\n    \"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\"\n  ) {\n    return ViewerType.Excel;\n  }\n  if (mimeType === \"message/rfc822\") {\n    return ViewerType.Email;\n  }\n  if (XML_MIME_TYPES.has(mimeType)) {\n    return ViewerType.Xml;\n  }\n  return ViewerType.Unsupported;\n}\n\nexport function DocumentViewer({\n  media,\n  className,\n  mimeTypeOverride,\n  pdfViewerProps,\n  imageViewerProps,\n  videoViewerProps,\n  tiffRendererProps,\n  markdownRendererProps,\n  excelViewerProps,\n  emailViewerProps,\n  xmlViewerProps,\n  fileName,\n  enableTiffToPdf = false,\n}: DocumentViewerProps): React.ReactElement {\n  const mimeType = mimeTypeOverride ?? media.getMediaReference().mimeType;\n  const viewerType = useMemo(\n    () => getViewerType(mimeType, fileName),\n    [mimeType, fileName],\n  );\n  const rootClassName = classnames(styles.container, className);\n\n  switch (viewerType) {\n    case ViewerType.Pdf:\n      return (\n        <PdfViewer\n          media={media}\n          className={rootClassName}\n          {...pdfViewerProps}\n        />\n      );\n    case ViewerType.Tiff:\n      if (enableTiffToPdf) {\n        return (\n          <TiffDocumentViewer\n            media={media}\n            className={rootClassName}\n            enableTiffToPdf={enableTiffToPdf}\n            tiffRendererProps={tiffRendererProps}\n            pdfViewerProps={pdfViewerProps}\n          />\n        );\n      }\n      return (\n        <TiffViewerMedia\n          media={media}\n          className={rootClassName}\n          {...tiffRendererProps}\n        />\n      );\n    case ViewerType.Image:\n      return (\n        <ImageViewer\n          media={media}\n          className={rootClassName}\n          {...imageViewerProps}\n        />\n      );\n    case ViewerType.Video:\n      return (\n        <VideoViewer\n          media={media}\n          className={rootClassName}\n          {...videoViewerProps}\n        />\n      );\n    case ViewerType.Markdown:\n      return (\n        <MarkdownViewerMedia\n          media={media}\n          className={rootClassName}\n          {...markdownRendererProps}\n        />\n      );\n    case ViewerType.Excel:\n      return (\n        <ExcelViewer\n          media={media}\n          className={rootClassName}\n          {...excelViewerProps}\n        />\n      );\n    case ViewerType.Email:\n      return (\n        <EmailViewer\n          media={media}\n          className={rootClassName}\n          {...emailViewerProps}\n        />\n      );\n    case ViewerType.Xml:\n      return (\n        <XmlViewer\n          media={media}\n          className={rootClassName}\n          {...xmlViewerProps}\n        />\n      );\n    case ViewerType.Unsupported:\n      return (\n        <div className={rootClassName}>\n          <div className={styles.unsupportedContainer}>\n            <DocumentIcon className={styles.unsupportedIcon} />\n            Unsupported file type: {mimeType}\n          </div>\n        </div>\n      );\n    default:\n      assertUnreachable(viewerType);\n  }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"DocumentViewer.js","names":["Document","DocumentIcon","classnames","React","useMemo","EmailViewer","ImageViewer","TiffViewerMedia","MarkdownViewerMedia","PdfViewer","assertUnreachable","SpreadsheetViewer","VideoViewer","XmlViewer","ViewerType","TiffDocumentViewer","styles","IMAGE_MIME_TYPES","Set","MARKDOWN_MIME_TYPES","XML_MIME_TYPES","isTiffFile","mimeType","fileName","lowered","toLowerCase","endsWith","getViewerType","Pdf","Tiff","has","Image","startsWith","Video","Markdown","Spreadsheet","Email","Xml","Unsupported","DocumentViewer","media","className","mimeTypeOverride","pdfViewerProps","imageViewerProps","videoViewerProps","tiffRendererProps","markdownRendererProps","spreadsheetViewerProps","emailViewerProps","xmlViewerProps","enableTiffToPdf","getMediaReference","viewerType","rootClassName","container","createElement","_extends","unsupportedContainer","unsupportedIcon"],"sources":["DocumentViewer.tsx"],"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\n/* cspell:words openxmlformats officedocument wordprocessingml spreadsheetml */\n\nimport { Document as DocumentIcon } from \"@blueprintjs/icons\";\nimport classnames from \"classnames\";\nimport React, { useMemo } from \"react\";\n\nimport { EmailViewer } from \"../email-viewer/EmailViewer.js\";\nimport { ImageViewer } from \"../images/image-viewer/ImageViewer.js\";\nimport { TiffViewerMedia } from \"../images/tiff-renderer/TiffViewerMedia.js\";\nimport { MarkdownViewerMedia } from \"../markdown-renderer/MarkdownViewerMedia.js\";\nimport { PdfViewer } from \"../pdf-viewer/PdfRenderer.js\";\nimport { assertUnreachable } from \"../shared/assertUnreachable.js\";\nimport { SpreadsheetViewer } from \"../spreadsheet-viewer/SpreadsheetViewer.js\";\nimport { VideoViewer } from \"../video-viewer/VideoViewer.js\";\nimport { XmlViewer } from \"../xml-viewer/XmlViewer.js\";\nimport type { DocumentViewerProps } from \"./DocumentViewerApi.js\";\nimport { ViewerType } from \"./DocumentViewerApi.js\";\nimport { TiffDocumentViewer } from \"./TiffDocumentViewer.js\";\n\nimport styles from \"./DocumentViewer.module.css\";\n\nconst IMAGE_MIME_TYPES = new Set([\n  \"image/png\",\n  \"image/jpeg\",\n  \"image/gif\",\n  \"image/svg+xml\",\n  \"image/webp\",\n  \"image/bmp\",\n]);\n\nconst MARKDOWN_MIME_TYPES = new Set([\"text/markdown\", \"text/x-markdown\"]);\n\nconst XML_MIME_TYPES = new Set([\"application/xml\", \"text/xml\"]);\n\nfunction isTiffFile(mimeType: string, fileName: string | undefined): boolean {\n  if (mimeType === \"image/tiff\") {\n    return true;\n  }\n  const lowered = fileName?.toLowerCase();\n  return (\n    lowered?.endsWith(\".tif\") === true || lowered?.endsWith(\".tiff\") === true\n  );\n}\n\nfunction getViewerType(\n  mimeType: string,\n  fileName: string | undefined,\n): ViewerType {\n  if (mimeType === \"application/pdf\") {\n    return ViewerType.Pdf;\n  }\n  if (isTiffFile(mimeType, fileName)) {\n    return ViewerType.Tiff;\n  }\n  if (IMAGE_MIME_TYPES.has(mimeType)) {\n    return ViewerType.Image;\n  }\n  if (mimeType.startsWith(\"video/\")) {\n    return ViewerType.Video;\n  }\n  if (MARKDOWN_MIME_TYPES.has(mimeType)) {\n    return ViewerType.Markdown;\n  }\n  if (\n    mimeType ===\n    \"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\"\n  ) {\n    return ViewerType.Spreadsheet;\n  }\n  if (mimeType === \"message/rfc822\") {\n    return ViewerType.Email;\n  }\n  if (XML_MIME_TYPES.has(mimeType)) {\n    return ViewerType.Xml;\n  }\n  return ViewerType.Unsupported;\n}\n\nexport function DocumentViewer({\n  media,\n  className,\n  mimeTypeOverride,\n  pdfViewerProps,\n  imageViewerProps,\n  videoViewerProps,\n  tiffRendererProps,\n  markdownRendererProps,\n  spreadsheetViewerProps,\n  emailViewerProps,\n  xmlViewerProps,\n  fileName,\n  enableTiffToPdf = false,\n}: DocumentViewerProps): React.ReactElement {\n  const mimeType = mimeTypeOverride ?? media.getMediaReference().mimeType;\n  const viewerType = useMemo(\n    () => getViewerType(mimeType, fileName),\n    [mimeType, fileName],\n  );\n  const rootClassName = classnames(styles.container, className);\n\n  switch (viewerType) {\n    case ViewerType.Pdf:\n      return (\n        <PdfViewer\n          media={media}\n          className={rootClassName}\n          {...pdfViewerProps}\n        />\n      );\n    case ViewerType.Tiff:\n      if (enableTiffToPdf) {\n        return (\n          <TiffDocumentViewer\n            media={media}\n            className={rootClassName}\n            enableTiffToPdf={enableTiffToPdf}\n            tiffRendererProps={tiffRendererProps}\n            pdfViewerProps={pdfViewerProps}\n          />\n        );\n      }\n      return (\n        <TiffViewerMedia\n          media={media}\n          className={rootClassName}\n          {...tiffRendererProps}\n        />\n      );\n    case ViewerType.Image:\n      return (\n        <ImageViewer\n          media={media}\n          className={rootClassName}\n          {...imageViewerProps}\n        />\n      );\n    case ViewerType.Video:\n      return (\n        <VideoViewer\n          media={media}\n          className={rootClassName}\n          {...videoViewerProps}\n        />\n      );\n    case ViewerType.Markdown:\n      return (\n        <MarkdownViewerMedia\n          media={media}\n          className={rootClassName}\n          {...markdownRendererProps}\n        />\n      );\n    case ViewerType.Spreadsheet:\n      return (\n        <SpreadsheetViewer\n          media={media}\n          className={rootClassName}\n          {...spreadsheetViewerProps}\n        />\n      );\n    case ViewerType.Email:\n      return (\n        <EmailViewer\n          media={media}\n          className={rootClassName}\n          {...emailViewerProps}\n        />\n      );\n    case ViewerType.Xml:\n      return (\n        <XmlViewer\n          media={media}\n          className={rootClassName}\n          {...xmlViewerProps}\n        />\n      );\n    case ViewerType.Unsupported:\n      return (\n        <div className={rootClassName}>\n          <div className={styles.unsupportedContainer}>\n            <DocumentIcon className={styles.unsupportedIcon} />\n            Unsupported file type: {mimeType}\n          </div>\n        </div>\n      );\n    default:\n      assertUnreachable(viewerType);\n  }\n}\n"],"mappings":";AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;;AAEA,SAASA,QAAQ,IAAIC,YAAY,QAAQ,oBAAoB;AAC7D,OAAOC,UAAU,MAAM,YAAY;AACnC,OAAOC,KAAK,IAAIC,OAAO,QAAQ,OAAO;AAEtC,SAASC,WAAW,QAAQ,gCAAgC;AAC5D,SAASC,WAAW,QAAQ,uCAAuC;AACnE,SAASC,eAAe,QAAQ,4CAA4C;AAC5E,SAASC,mBAAmB,QAAQ,6CAA6C;AACjF,SAASC,SAAS,QAAQ,8BAA8B;AACxD,SAASC,iBAAiB,QAAQ,gCAAgC;AAClE,SAASC,iBAAiB,QAAQ,4CAA4C;AAC9E,SAASC,WAAW,QAAQ,gCAAgC;AAC5D,SAASC,SAAS,QAAQ,4BAA4B;AAEtD,SAASC,UAAU,QAAQ,wBAAwB;AACnD,SAASC,kBAAkB,QAAQ,yBAAyB;AAE5D,OAAOC,MAAM,MAAM,6BAA6B;AAEhD,MAAMC,gBAAgB,GAAG,IAAIC,GAAG,CAAC,CAC/B,WAAW,EACX,YAAY,EACZ,WAAW,EACX,eAAe,EACf,YAAY,EACZ,WAAW,CACZ,CAAC;AAEF,MAAMC,mBAAmB,GAAG,IAAID,GAAG,CAAC,CAAC,eAAe,EAAE,iBAAiB,CAAC,CAAC;AAEzE,MAAME,cAAc,GAAG,IAAIF,GAAG,CAAC,CAAC,iBAAiB,EAAE,UAAU,CAAC,CAAC;AAE/D,SAASG,UAAUA,CAACC,QAAgB,EAAEC,QAA4B,EAAW;EAC3E,IAAID,QAAQ,KAAK,YAAY,EAAE;IAC7B,OAAO,IAAI;EACb;EACA,MAAME,OAAO,GAAGD,QAAQ,EAAEE,WAAW,CAAC,CAAC;EACvC,OACED,OAAO,EAAEE,QAAQ,CAAC,MAAM,CAAC,KAAK,IAAI,IAAIF,OAAO,EAAEE,QAAQ,CAAC,OAAO,CAAC,KAAK,IAAI;AAE7E;AAEA,SAASC,aAAaA,CACpBL,QAAgB,EAChBC,QAA4B,EAChB;EACZ,IAAID,QAAQ,KAAK,iBAAiB,EAAE;IAClC,OAAOR,UAAU,CAACc,GAAG;EACvB;EACA,IAAIP,UAAU,CAACC,QAAQ,EAAEC,QAAQ,CAAC,EAAE;IAClC,OAAOT,UAAU,CAACe,IAAI;EACxB;EACA,IAAIZ,gBAAgB,CAACa,GAAG,CAACR,QAAQ,CAAC,EAAE;IAClC,OAAOR,UAAU,CAACiB,KAAK;EACzB;EACA,IAAIT,QAAQ,CAACU,UAAU,CAAC,QAAQ,CAAC,EAAE;IACjC,OAAOlB,UAAU,CAACmB,KAAK;EACzB;EACA,IAAId,mBAAmB,CAACW,GAAG,CAACR,QAAQ,CAAC,EAAE;IACrC,OAAOR,UAAU,CAACoB,QAAQ;EAC5B;EACA,IACEZ,QAAQ,KACR,mEAAmE,EACnE;IACA,OAAOR,UAAU,CAACqB,WAAW;EAC/B;EACA,IAAIb,QAAQ,KAAK,gBAAgB,EAAE;IACjC,OAAOR,UAAU,CAACsB,KAAK;EACzB;EACA,IAAIhB,cAAc,CAACU,GAAG,CAACR,QAAQ,CAAC,EAAE;IAChC,OAAOR,UAAU,CAACuB,GAAG;EACvB;EACA,OAAOvB,UAAU,CAACwB,WAAW;AAC/B;AAEA,OAAO,SAASC,cAAcA,CAAC;EAC7BC,KAAK;EACLC,SAAS;EACTC,gBAAgB;EAChBC,cAAc;EACdC,gBAAgB;EAChBC,gBAAgB;EAChBC,iBAAiB;EACjBC,qBAAqB;EACrBC,sBAAsB;EACtBC,gBAAgB;EAChBC,cAAc;EACd3B,QAAQ;EACR4B,eAAe,GAAG;AACC,CAAC,EAAsB;EAC1C,MAAM7B,QAAQ,GAAGoB,gBAAgB,IAAIF,KAAK,CAACY,iBAAiB,CAAC,CAAC,CAAC9B,QAAQ;EACvE,MAAM+B,UAAU,GAAGjD,OAAO,CACxB,MAAMuB,aAAa,CAACL,QAAQ,EAAEC,QAAQ,CAAC,EACvC,CAACD,QAAQ,EAAEC,QAAQ,CACrB,CAAC;EACD,MAAM+B,aAAa,GAAGpD,UAAU,CAACc,MAAM,CAACuC,SAAS,EAAEd,SAAS,CAAC;EAE7D,QAAQY,UAAU;IAChB,KAAKvC,UAAU,CAACc,GAAG;MACjB,oBACEzB,KAAA,CAAAqD,aAAA,CAAC/C,SAAS,EAAAgD,QAAA;QACRjB,KAAK,EAAEA,KAAM;QACbC,SAAS,EAAEa;MAAc,GACrBX,cAAc,CACnB,CAAC;IAEN,KAAK7B,UAAU,CAACe,IAAI;MAClB,IAAIsB,eAAe,EAAE;QACnB,oBACEhD,KAAA,CAAAqD,aAAA,CAACzC,kBAAkB;UACjByB,KAAK,EAAEA,KAAM;UACbC,SAAS,EAAEa,aAAc;UACzBH,eAAe,EAAEA,eAAgB;UACjCL,iBAAiB,EAAEA,iBAAkB;UACrCH,cAAc,EAAEA;QAAe,CAChC,CAAC;MAEN;MACA,oBACExC,KAAA,CAAAqD,aAAA,CAACjD,eAAe,EAAAkD,QAAA;QACdjB,KAAK,EAAEA,KAAM;QACbC,SAAS,EAAEa;MAAc,GACrBR,iBAAiB,CACtB,CAAC;IAEN,KAAKhC,UAAU,CAACiB,KAAK;MACnB,oBACE5B,KAAA,CAAAqD,aAAA,CAAClD,WAAW,EAAAmD,QAAA;QACVjB,KAAK,EAAEA,KAAM;QACbC,SAAS,EAAEa;MAAc,GACrBV,gBAAgB,CACrB,CAAC;IAEN,KAAK9B,UAAU,CAACmB,KAAK;MACnB,oBACE9B,KAAA,CAAAqD,aAAA,CAAC5C,WAAW,EAAA6C,QAAA;QACVjB,KAAK,EAAEA,KAAM;QACbC,SAAS,EAAEa;MAAc,GACrBT,gBAAgB,CACrB,CAAC;IAEN,KAAK/B,UAAU,CAACoB,QAAQ;MACtB,oBACE/B,KAAA,CAAAqD,aAAA,CAAChD,mBAAmB,EAAAiD,QAAA;QAClBjB,KAAK,EAAEA,KAAM;QACbC,SAAS,EAAEa;MAAc,GACrBP,qBAAqB,CAC1B,CAAC;IAEN,KAAKjC,UAAU,CAACqB,WAAW;MACzB,oBACEhC,KAAA,CAAAqD,aAAA,CAAC7C,iBAAiB,EAAA8C,QAAA;QAChBjB,KAAK,EAAEA,KAAM;QACbC,SAAS,EAAEa;MAAc,GACrBN,sBAAsB,CAC3B,CAAC;IAEN,KAAKlC,UAAU,CAACsB,KAAK;MACnB,oBACEjC,KAAA,CAAAqD,aAAA,CAACnD,WAAW,EAAAoD,QAAA;QACVjB,KAAK,EAAEA,KAAM;QACbC,SAAS,EAAEa;MAAc,GACrBL,gBAAgB,CACrB,CAAC;IAEN,KAAKnC,UAAU,CAACuB,GAAG;MACjB,oBACElC,KAAA,CAAAqD,aAAA,CAAC3C,SAAS,EAAA4C,QAAA;QACRjB,KAAK,EAAEA,KAAM;QACbC,SAAS,EAAEa;MAAc,GACrBJ,cAAc,CACnB,CAAC;IAEN,KAAKpC,UAAU,CAACwB,WAAW;MACzB,oBACEnC,KAAA,CAAAqD,aAAA;QAAKf,SAAS,EAAEa;MAAc,gBAC5BnD,KAAA,CAAAqD,aAAA;QAAKf,SAAS,EAAEzB,MAAM,CAAC0C;MAAqB,gBAC1CvD,KAAA,CAAAqD,aAAA,CAACvD,YAAY;QAACwC,SAAS,EAAEzB,MAAM,CAAC2C;MAAgB,CAAE,CAAC,2BAC5B,EAACrC,QACrB,CACF,CAAC;IAEV;MACEZ,iBAAiB,CAAC2C,UAAU,CAAC;EACjC;AACF","ignoreList":[]}

package/build/esm/document-viewer/DocumentViewerApi.js

@@ -20,7 +20,7 @@ export let ViewerType = /*#__PURE__*/function (ViewerType) {
   ViewerType["Image"] = "image";
   ViewerType["Video"] = "video";
   ViewerType["Markdown"] = "markdown";
-  ViewerType["Excel"] = "excel";
+  ViewerType["Spreadsheet"] = "spreadsheet";
   ViewerType["Email"] = "email";
   ViewerType["Xml"] = "xml";
   ViewerType["Unsupported"] = "unsupported";

package/build/esm/document-viewer/DocumentViewerApi.js.map

@@ -1 +1 @@
-{"version":3,"file":"DocumentViewerApi.js","names":["ViewerType"],"sources":["DocumentViewerApi.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 type { Media } from \"@osdk/api\";\n\nimport type { BaseEmailViewerProps } from \"../email-viewer/EmailViewerApi.js\";\nimport type { BaseExcelViewerProps } from \"../excel-viewer/ExcelViewerApi.js\";\nimport type { BaseImageViewerProps } from \"../images/image-viewer/ImageViewerApi.js\";\nimport type { TiffRendererProps } from \"../images/tiff-renderer/types.js\";\nimport type { MarkdownRendererProps } from \"../markdown-renderer/MarkdownRenderer.js\";\nimport type { PdfViewerProps } from \"../pdf-viewer/types.js\";\nimport type { BaseVideoViewerProps } from \"../video-viewer/VideoViewerApi.js\";\nimport type { BaseXmlViewerProps } from \"../xml-viewer/XmlViewerApi.js\";\n\nexport enum ViewerType {\n  Pdf = \"pdf\",\n  Tiff = \"tiff\",\n  Image = \"image\",\n  Video = \"video\",\n  Markdown = \"markdown\",\n  Excel = \"excel\",\n  Email = \"email\",\n  Xml = \"xml\",\n  Unsupported = \"unsupported\",\n}\n\nexport interface DocumentViewerProps {\n  /** The Media object to render */\n  media: Media;\n  /** Additional CSS class name for the root element\n   * @default undefined */\n  className?: string;\n  /** Override the auto-detected MIME type\n   * @default undefined */\n  mimeTypeOverride?: string;\n  /** Props forwarded to BasePdfViewer when rendering PDF\n   * @default undefined */\n  pdfViewerProps?: Partial<Omit<PdfViewerProps, \"src\" | \"className\">>;\n  /** Props forwarded to BaseImageViewer when rendering images\n   * @default undefined */\n  imageViewerProps?: Partial<Omit<BaseImageViewerProps, \"src\" | \"className\">>;\n  /** Props forwarded to BaseVideoViewer when rendering video\n   * @default undefined */\n  videoViewerProps?: Partial<Omit<BaseVideoViewerProps, \"src\" | \"className\">>;\n  /** Props forwarded to TiffRenderer when rendering TIFF\n   * @default undefined */\n  tiffRendererProps?: Partial<Omit<TiffRendererProps, \"content\" | \"className\">>;\n  /** Props forwarded to MarkdownRenderer when rendering markdown\n   * @default undefined */\n  markdownRendererProps?: Partial<\n    Omit<MarkdownRendererProps, \"content\" | \"className\">\n  >;\n  /** Props forwarded to BaseExcelViewer when rendering Excel\n   * @default undefined */\n  excelViewerProps?: Partial<\n    Omit<BaseExcelViewerProps, \"spreadsheet\" | \"className\">\n  >;\n  /** Props forwarded to BaseEmailViewer when rendering EML\n   * @default undefined */\n  emailViewerProps?: Partial<Omit<BaseEmailViewerProps, \"email\" | \"className\">>;\n  /** Props forwarded to BaseXmlViewer when rendering XML\n   * @default undefined */\n  xmlViewerProps?: Partial<Omit<BaseXmlViewerProps, \"content\" | \"className\">>;\n  /** File name hint for MIME type detection (e.g. \"scan.tif\"). Used to detect\n   *  TIFF files when the MIME type is ambiguous (e.g. application/octet-stream).\n   * @default undefined */\n  fileName?: string;\n  /** When true, multi-page TIFF files are converted to PDF via MIO transform API\n   * @default false */\n  enableTiffToPdf?: boolean;\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAaA,WAAYA,UAAU,0BAAVA,UAAU;EAAVA,UAAU;EAAVA,UAAU;EAAVA,UAAU;EAAVA,UAAU;EAAVA,UAAU;EAAVA,UAAU;EAAVA,UAAU;EAAVA,UAAU;EAAVA,UAAU;EAAA,OAAVA,UAAU;AAAA","ignoreList":[]}
+{"version":3,"file":"DocumentViewerApi.js","names":["ViewerType"],"sources":["DocumentViewerApi.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 type { Media } from \"@osdk/api\";\n\nimport type { BaseEmailViewerProps } from \"../email-viewer/EmailViewerApi.js\";\nimport type { BaseImageViewerProps } from \"../images/image-viewer/ImageViewerApi.js\";\nimport type { TiffRendererProps } from \"../images/tiff-renderer/types.js\";\nimport type { MarkdownRendererProps } from \"../markdown-renderer/MarkdownRenderer.js\";\nimport type { PdfViewerProps } from \"../pdf-viewer/types.js\";\nimport type { BaseSpreadsheetViewerProps } from \"../spreadsheet-viewer/SpreadsheetViewerApi.js\";\nimport type { BaseVideoViewerProps } from \"../video-viewer/VideoViewerApi.js\";\nimport type { BaseXmlViewerProps } from \"../xml-viewer/XmlViewerApi.js\";\n\nexport enum ViewerType {\n  Pdf = \"pdf\",\n  Tiff = \"tiff\",\n  Image = \"image\",\n  Video = \"video\",\n  Markdown = \"markdown\",\n  Spreadsheet = \"spreadsheet\",\n  Email = \"email\",\n  Xml = \"xml\",\n  Unsupported = \"unsupported\",\n}\n\nexport interface DocumentViewerProps {\n  /** The Media object to render */\n  media: Media;\n  /** Additional CSS class name for the root element\n   * @default undefined */\n  className?: string;\n  /** Override the auto-detected MIME type\n   * @default undefined */\n  mimeTypeOverride?: string;\n  /** Props forwarded to BasePdfViewer when rendering PDF\n   * @default undefined */\n  pdfViewerProps?: Partial<Omit<PdfViewerProps, \"src\" | \"className\">>;\n  /** Props forwarded to BaseImageViewer when rendering images\n   * @default undefined */\n  imageViewerProps?: Partial<Omit<BaseImageViewerProps, \"src\" | \"className\">>;\n  /** Props forwarded to BaseVideoViewer when rendering video\n   * @default undefined */\n  videoViewerProps?: Partial<Omit<BaseVideoViewerProps, \"src\" | \"className\">>;\n  /** Props forwarded to TiffRenderer when rendering TIFF\n   * @default undefined */\n  tiffRendererProps?: Partial<Omit<TiffRendererProps, \"content\" | \"className\">>;\n  /** Props forwarded to MarkdownRenderer when rendering markdown\n   * @default undefined */\n  markdownRendererProps?: Partial<\n    Omit<MarkdownRendererProps, \"content\" | \"className\">\n  >;\n  /** Props forwarded to BaseSpreadsheetViewer when rendering a spreadsheet\n   * @default undefined */\n  spreadsheetViewerProps?: Partial<\n    Omit<BaseSpreadsheetViewerProps, \"spreadsheet\" | \"className\">\n  >;\n  /** Props forwarded to BaseEmailViewer when rendering EML\n   * @default undefined */\n  emailViewerProps?: Partial<Omit<BaseEmailViewerProps, \"email\" | \"className\">>;\n  /** Props forwarded to BaseXmlViewer when rendering XML\n   * @default undefined */\n  xmlViewerProps?: Partial<Omit<BaseXmlViewerProps, \"content\" | \"className\">>;\n  /** File name hint for MIME type detection (e.g. \"scan.tif\"). Used to detect\n   *  TIFF files when the MIME type is ambiguous (e.g. application/octet-stream).\n   * @default undefined */\n  fileName?: string;\n  /** When true, multi-page TIFF files are converted to PDF via MIO transform API\n   * @default false */\n  enableTiffToPdf?: boolean;\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAaA,WAAYA,UAAU,0BAAVA,UAAU;EAAVA,UAAU;EAAVA,UAAU;EAAVA,UAAU;EAAVA,UAAU;EAAVA,UAAU;EAAVA,UAAU;EAAVA,UAAU;EAAVA,UAAU;EAAVA,UAAU;EAAA,OAAVA,UAAU;AAAA","ignoreList":[]}

package/build/esm/object-table/ObjectTableApi.js.map

@@ -1 +1 @@
-{"version":3,"file":"ObjectTableApi.js","names":[],"sources":["ObjectTableApi.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  CompileTimeMetadata,\n  DerivedProperty,\n  ObjectOrInterfaceDefinition,\n  ObjectSet,\n  Osdk,\n  PrimaryKeyType,\n  PropertyKeys,\n  QueryDefinition,\n  SimplePropertyDef,\n  WhereClause,\n} from \"@osdk/api\";\nimport type { QueryParameterType } from \"@osdk/client/observable\";\nimport type * as React from \"react\";\n\nimport type { ObjectTableLabels } from \"./ObjectTableLabels.js\";\nimport type { CellEditInfo, EditFieldConfig } from \"./utils/types.js\";\n\nexport type { EditFieldConfig } from \"./utils/types.js\";\n\nexport type ColumnDefinition<\n  Q extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = Record<string, never>,\n  FunctionColumns extends Record<string, QueryDefinition<{}>> = Record<\n    string,\n    never\n  >,\n> =\n  | EditableColumnDefinition<Q, RDPs, FunctionColumns>\n  | ReadonlyColumnDefinition<Q, RDPs, FunctionColumns>;\n\ninterface SharedColumnDefinition<\n  Q extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = Record<string, never>,\n  FunctionColumns extends Record<string, QueryDefinition<{}>> = Record<\n    string,\n    never\n  >,\n> {\n  /**\n   * Defines what the column shows:\n   * an object/interface property, a linked object property (derived property), a function\n   * column, or a custom column — and carries that locator's configuration.\n   */\n  locator: ColumnDefinitionLocator<Q, RDPs, FunctionColumns>;\n\n  /**\n   * @default true\n   */\n  isVisible?: boolean;\n\n  /**\n   * @default none\n   */\n  pinned?: \"left\" | \"right\" | \"none\";\n  width?: number;\n  minWidth?: number;\n  maxWidth?: number;\n  resizable?: boolean;\n  orderable?: boolean;\n\n  /**\n   * Custom renderer for the cell value.\n   *\n   * Interaction with `editable` columns:\n   * - When `editMode: \"manual\"` (default), `renderCell` is used while the\n   *   table is read-only (Edit Table button visible) and the editable cell\n   *   takes over once the user enters edit mode.\n   * - When `editMode: \"always\"`, the editable cell always wins on editable\n   *   columns and `renderCell` is ignored — `editMode: \"always\"` opts the\n   *   column into a permanently-editable surface, leaving no read-only\n   *   state for `renderCell` to render. Use `editMode: \"manual\"` if you\n   *   need a custom display alongside editing.\n   */\n  renderCell?: (\n    object: Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs>,\n    locator: ColumnDefinitionLocator<Q, RDPs, FunctionColumns>,\n  ) => React.ReactNode;\n\n  /**\n   * If provided, this will be used in the column header.\n   * If both columnName and renderHeader are provided, renderHeader will take precedence in the table header.\n   * columnName will still be used in other parts where the column name is displayed.\n   *\n   * If not provided,\n   * for a property column, the property displayName will be used\n   * for other columns, the id will be used.\n   */\n  columnName?: string;\n\n  /**\n   * If provided, this will be used to render the header component.\n   * When both columnName and renderHeader are provided, renderHeader will take precedence in the table header.\n   */\n  renderHeader?: () => React.ReactNode;\n}\n\ninterface EditableColumnDefinition<\n  Q extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = Record<string, never>,\n  FunctionColumns extends Record<string, QueryDefinition<{}>> = Record<\n    string,\n    never\n  >,\n> extends SharedColumnDefinition<Q, RDPs, FunctionColumns> {\n  /**\n   * `editable` can be a boolean or a predicate that receives the row's object\n   * and returns whether the cell is editable\n   */\n  editable:\n    | true\n    | ((\n        object: Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs>,\n      ) => boolean);\n\n  /**\n   * Configuration for the cell editor component.\n   *\n   * When provided, the column uses the specified field component\n   * (e.g. dropdown) instead of the default auto-detected text/number input.\n   *\n   * `getFieldComponentProps` receives the row's object and a map of any\n   * pending edits for that row (keyed by column id), and returns the props to\n   * pass to the field component. Editor configuration can depend on the\n   * current row or on other in-progress edits within the row.\n   */\n  editFieldConfig?: EditFieldConfig<\n    Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs>\n  >;\n\n  /**\n   * Additional function to validate the cell value during edit.\n   *\n   * @param value the current cell value\n   * @returns a promise that resolves to an error message string if validation fails, or undefined if validation succeeds\n   */\n  validateEdit?: (value: unknown) => Promise<string | undefined>;\n}\n\n/**\n * Column definition for a read-only column (default).\n * `editFieldConfig` and `validateEdit` are not available.\n */\ninterface ReadonlyColumnDefinition<\n  Q extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = Record<string, never>,\n  FunctionColumns extends Record<string, QueryDefinition<{}>> = Record<\n    string,\n    never\n  >,\n> extends SharedColumnDefinition<Q, RDPs, FunctionColumns> {\n  editable?: false;\n}\n\nexport type ExtractQueryParameters<Q extends QueryDefinition> =\n  CompileTimeMetadata<Q>[\"parameters\"] extends Record<string, never>\n    ? undefined\n    : QueryParameterType<CompileTimeMetadata<Q>[\"parameters\"]>;\n\nexport interface PropertyColumnLocator<Q extends ObjectOrInterfaceDefinition> {\n  type: \"property\";\n  id: PropertyKeys<Q>;\n}\n\n/**\n * Concrete function column locator for a single key K.\n * Correlates the id, queryDefinition, and getFunctionParams types.\n */\ninterface FunctionColumnLocatorForKey<\n  Q extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef>,\n  FunctionColumns extends Record<string, QueryDefinition<{}>>,\n  K extends keyof FunctionColumns,\n> {\n  /**\n   * This is equivalent to workshop's function-backed columns.\n   * The function needs to meet the specifications stated in https://www.palantir.com/docs/foundry/workshop/widgets-object-table/#function-backed-columns\n   */\n  type: \"function\";\n  id: K;\n  queryDefinition: FunctionColumns[K];\n\n  /**\n   * The function will be called with the current object set to get the input parameters for the function query.\n   * @param objectSet - The current object set.\n   * @returns - The function's input parameters including the object set.\n   */\n  getFunctionParams: (\n    objectSet: ObjectSet<Q, RDPs>,\n  ) => ExtractQueryParameters<FunctionColumns[K]>;\n\n  /**\n   * Function to generate keys for looking up results in the FunctionsMap.\n   * @param object - The object instance\n   * @returns - The key to use for looking up this object's result in the FunctionsMap\n   */\n  getKey: (\n    object: Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs>,\n  ) => string;\n\n  /**\n   * Function to extract the cell value from the raw cell data returned by the function.\n   * This is useful when functions return custom types with multiple properties.\n   * @param cellData - The raw data returned by the function for this object\n   * @returns - The value to display in the cell\n   */\n  getValue?: (cellData?: unknown) => unknown;\n\n  /**\n   * Minimum time between re-fetches of the same function with the same parameters, in milliseconds.\n   * Defaults to 5 minutes as it is expensive to fetch function columns for a large object set\n   * and they are expected to be relatively static in the context of an object table\n   *\n   * @default 300_000 (5 minutes)\n   */\n  dedupeIntervalMs?: number;\n\n  /**\n   * Object type apiNames the function reads but doesn't take as a parameter (e.g.\n   * linked object types the function traverses internally). The column auto-revalidates\n   * when an action edits an object of any of these types. Param-derived types are\n   * tracked automatically and don't need to be listed here.\n   */\n  dependsOn?: string[];\n}\n\n/**\n * Distributes over each key in FunctionColumns so that id, queryDefinition,\n * and getFunctionParams are correlated per key.\n */\nexport type FunctionColumnLocator<\n  Q extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = Record<string, never>,\n  FunctionColumns extends Record<string, QueryDefinition<{}>> = Record<\n    string,\n    never\n  >,\n> = keyof FunctionColumns extends infer K\n  ? K extends keyof FunctionColumns\n    ? FunctionColumnLocatorForKey<Q, RDPs, FunctionColumns, K>\n    : never\n  : never;\n\nexport interface RdpColumnLocator<\n  Q extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = Record<string, never>,\n> {\n  type: \"rdp\";\n  id: keyof RDPs;\n  creator: DerivedProperty.Creator<Q, RDPs[keyof RDPs]>;\n}\n\nexport interface CustomColumnLocator {\n  type: \"custom\";\n  id: string;\n}\n\nexport type ColumnDefinitionLocator<\n  Q extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = Record<string, never>,\n  FunctionColumns extends Record<string, QueryDefinition<{}>> = Record<\n    string,\n    never\n  >,\n> =\n  | PropertyColumnLocator<Q>\n  | FunctionColumnLocator<Q, RDPs, FunctionColumns>\n  | RdpColumnLocator<Q, RDPs>\n  | CustomColumnLocator;\n\nexport interface ObjectTableProps<\n  Q extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = Record<string, never>,\n  FunctionColumns extends Record<string, QueryDefinition<{}>> = Record<\n    string,\n    never\n  >,\n> {\n  /**\n   * The object or interface type of the object\n   * If objectSet is not provided, objects will be fetched based on this type.\n   */\n  objectType: Q;\n\n  /**\n   * The set of objects to show in the table.\n   * If provided, the table fetches through this object set instead of fetching based on\n   * objectType. Supported for both object and interface types.\n   *\n   * For an interface object set, rows expose the interface's declared properties;\n   * the underlying concrete object's non-interface properties are not loaded.\n   * Use objectType-based fetching if you need those.\n   */\n  objectSet?: ObjectSet<Q>;\n\n  /**\n   * Ordered list of column definitions to show in the table\n   *\n   * If not provided, all of the properties of the object type will be shown in default order.\n   */\n  columnDefinitions?: Array<ColumnDefinition<Q, RDPs, FunctionColumns>>;\n\n  objectSetOptions?: ObjectSetOptions<Q>;\n\n  /**\n   * Minimum time between fetch requests in milliseconds.\n   * Increasing this value reduces redundant network calls when the same data\n   * is requested multiple times in quick succession.\n   *\n   * @default 60_000 1 minute\n   */\n  dedupeIntervalMs?: number;\n\n  /**\n   * Enable streaming updates via websocket subscription.\n   * When true, the table will automatically update when matching\n   * objects are added, updated, or removed in Foundry.\n   *\n   * Limitations: `streamUpdates` cannot be used together with `pivotTo` or\n   * `withProperties`. The server does not support websocket subscriptions\n   * for link-traversal or derived-property queries. Those queries still\n   * fetch data normally but won't receive real-time updates.\n   *\n   * @default false\n   */\n  streamUpdates?: boolean;\n\n  /**\n   * Number of objects to fetch per page.\n   *\n   * @default 50\n   */\n  pageSize?: number;\n\n  /**\n   * The current where clause to filter the objects in the table.\n   * If provided, the filter is controlled.\n   */\n  filter?: WhereClause<Q, RDPs>;\n\n  /**\n   * Whether the column configuration dialog for column visibility and ordering is available to the user.\n   *\n   * @default true\n   */\n  enableColumnConfig?: boolean;\n\n  /**\n   * Whether columns can be pinned by the user.\n   *\n   * @default true\n   */\n  enableColumnPinning?: boolean;\n\n  /**\n   * Whether columns can be resized by the user.\n   *\n   * @default true\n   */\n  enableColumnResizing?: boolean;\n\n  /**\n   * Called when the column visibility or ordering changed.\n   *\n   * If provided, the table will allow the user to show/hide columns.\n   *\n   * @param newStates The columns sorted in their display order in the table and their visibility state.\n   */\n  onColumnVisibilityChanged?: (\n    newStates: Array<{\n      columnId: PropertyKeys<Q> | keyof RDPs | keyof FunctionColumns;\n      isVisible: boolean;\n    }>,\n  ) => void;\n\n  /**\n   * Called when the pinned columns change.\n   *\n   * If provided, the table will allow the user to pin/unpin columns.\n   *\n   * @param newStates The new list of column pin states\n   */\n  onColumnsPinnedChanged?: (\n    newStates: Array<{\n      columnId: PropertyKeys<Q> | keyof RDPs | keyof FunctionColumns;\n      pinned: \"left\" | \"right\" | \"none\";\n    }>,\n  ) => void;\n\n  /**\n   * Called when a column is resized.\n   *\n   * @param columnId The ID of the resized column\n   * @param newWidth The new width of the column. When newWidth = null, the column size is reset.\n   */\n  onColumnResize?: (\n    columnId: PropertyKeys<Q> | keyof RDPs | keyof FunctionColumns,\n    newWidth: number | null,\n  ) => void;\n\n  /**\n   * Called when a column header is clicked.\n   *\n   * The columnId matches the `locator.id` configured on the column definition.\n   * The dropdown menu trigger is excluded — clicking the chevron opens the\n   * header menu instead of firing this callback.\n   *\n   * @param columnId The id of the clicked column\n   */\n  onColumnHeaderClick?: (\n    columnId: PropertyKeys<Q> | keyof RDPs | keyof FunctionColumns,\n  ) => void;\n\n  /**\n   * Whether the table is sortable by the user.\n   *\n   * @default true\n   */\n  enableOrdering?: boolean;\n\n  /**\n   * The default order by clause to sort the objects in the table.\n   * If provided without orderBy prop, the sorting is uncontrolled.\n   * If both orderBy and defaultOrderBy are provided, orderBy takes precedence.\n   */\n  defaultOrderBy?: Array<{\n    property: PropertyKeys<Q> | keyof RDPs;\n    direction: \"asc\" | \"desc\";\n  }>;\n\n  /**\n   * The current order by clause to sort the objects in the table.\n   * If provided, the sorting is controlled.\n   * If both orderBy and defaultOrderBy are provided, orderBy takes precedence.\n   */\n  orderBy?: Array<{\n    property: PropertyKeys<Q> | keyof RDPs;\n    direction: \"asc\" | \"desc\";\n  }>;\n\n  /**\n   * Called when the order by clause is changed.\n   * Required when sorting is controlled.\n   *\n   * @param newOrderBy The new order by clause\n   */\n  onOrderByChanged?: (\n    newOrderBy: Array<{\n      property: PropertyKeys<Q> | keyof RDPs;\n      direction: \"asc\" | \"desc\";\n    }>,\n  ) => void;\n\n  /**\n   * Selection mode for the table rows.\n   *\n   * If multiple, a checkbox will be shown for each row to allow selecting multiple rows\n   * as well as a top-level checkbox in the header to select all rows.\n   *\n   * @default \"none\"\n   */\n  selectionMode?: \"single\" | \"multiple\" | \"none\";\n\n  /**\n   * The currently selected rows in the table.\n   * If provided, the row selection is controlled.\n   */\n  selectedRows?: PrimaryKeyType<Q>[];\n\n  /**\n   * Indicates whether all rows are selected in controlled mode.\n   * When true, the table will show all rows as selected regardless of the selectedRows array.\n   */\n  isAllSelected?: boolean;\n\n  /**\n   * Called when the row selection changes, with a {@link RowSelectionChange}\n   * payload describing the new state.\n   *\n   * @param change The new selection state. See {@link RowSelectionChange}.\n   */\n  onRowSelectionChanged?: (change: RowSelectionChange<Q, RDPs>) => void;\n\n  /**\n   * The primary key of the row to render as visually focused (the\n   * \"last interacted\" row). When provided, focus state is controlled by\n   * the caller.\n   *\n   * Stored as a primary key rather than a full object so the focus does\n   * not go stale when the underlying row data changes.\n   *\n   * Pass `null` to render no row as focused.\n   */\n  focusedRow?: PrimaryKeyType<Q> | null;\n\n  /**\n   * Called when the focused row changes — fires in both controlled and\n   * uncontrolled modes so callers can observe focus without taking it\n   * over.\n   *\n   * @param row The newly-focused row object, or `null` if focus was\n   * cleared\n   */\n  onFocusedRowChanged?: (\n    row: Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs> | null,\n  ) => void;\n\n  /**\n   * Controls the edit mode behavior of the table.\n   * - \"always\": Editable cells are immediately in edit mode on row clicked.\n   * - \"manual\": User can toggle edit mode on/off via the Edit Table button.\n   *\n   * @default \"manual\"\n   */\n  editMode?: \"always\" | \"manual\";\n\n  /**\n   * Whether to render the bottom edit footer that hosts the\n   * \"Edit Table\" / \"Cancel\" / \"Submit Edits\" buttons and the edit-state\n   * indicators (modification count, validation errors).\n   *\n   * @default true whenever the table has at least one column declared\n   * editable (i.e. any column with `editable: true` or `editable: (object) => boolean`).\n   * When `false`, the \"Edit Table\" and \"Submit Edits\" buttons will not be shown.\n   */\n  showEditFooter?: boolean;\n\n  /**\n   * Called after the value of a cell is edited and committed by the user.\n   *\n   * @param info An object containing details about the cell that was edited,\n   * including the rowId, columnId, new and old values, and the row data before the edit\n   */\n  onCellValueChanged?: (\n    info: CellEditInfo<\n      Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs>,\n      unknown\n    >,\n  ) => void;\n\n  /**\n   * If provided, the \"Submit Edits\" button will be shown in the edit footer.\n   *\n   * @param edits an array of edit info containing details about the edited cells\n   * including the rowId, columnId, new and old values, and the row data before the edit\n   * @return a promise that resolves to true if the edits were successfully submitted\n   */\n  onSubmitEdits?: (\n    edits: CellEditInfo<\n      Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs>,\n      unknown\n    >[],\n  ) => Promise<boolean>;\n\n  /**\n   * Called when a row is clicked.\n   *\n   * @param object The object representing the clicked row\n   */\n  onRowClick?: (\n    object: Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs>,\n  ) => void;\n\n  /**\n   * If provided, will render this context menu when right clicking on a cell\n   */\n  renderCellContextMenu?: (\n    row: Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs>,\n    cellValue: unknown,\n  ) => React.ReactNode;\n\n  /**\n   * The height of each row in pixels.\n   *\n   * @default 40\n   */\n  rowHeight?: number;\n\n  /**\n   * Render override for the empty state. Called when the table has no\n   * rows and no error. When omitted, a default \"No Data\" indicator is\n   * rendered.\n   */\n  renderEmptyState?: () => React.ReactNode;\n\n  /**\n   * Returns extra HTML attributes (typically `data-*`) to apply to each\n   * row element. Use this to drive conditional row styling\n   */\n  getRowAttributes?: (\n    object: Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs>,\n  ) => Record<string, string | undefined>;\n\n  /**\n   * Imperative handle for programmatic table actions. Pass a ref\n   * (`useRef<ObjectTableHandle<Q, RDPs>>(null)`) to call\n   * {@link ObjectTableHandle} methods such as\n   * {@link ObjectTableHandle.getSnapshot}.\n   */\n  tableRef?: React.Ref<ObjectTableHandle<Q, RDPs>>;\n\n  className?: string;\n\n  /**\n   * Overrides for the table's user-facing strings. Provide any subset; unset keys fall\n   * back to the built-in English defaults. Use this to localize the table or\n   * adjust wording. See {@link ObjectTableLabels}.\n   *\n   * @default undefined (built-in English strings)\n   */\n  labels?: Partial<ObjectTableLabels>;\n}\n\n/**\n * Imperative handle exposing programmatic actions on an {@link ObjectTable}.\n * Obtain it by passing {@link ObjectTableProps.tableRef}.\n */\nexport interface ObjectTableHandle<\n  Q extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = Record<string, never>,\n> {\n  /**\n   * Loads every row matching the object set and returns a format-agnostic\n   * snapshot of the table's columns, row values, and total count. The caller\n   * is responsible for turning the snapshot into a downloadable artifact\n   * (CSV, Excel, JSON, clipboard, …).\n   *\n   * Property, derived-property, and function-backed columns are included.\n   * Function-backed cells are fetched per page during snapshot collection;\n   * when a page's fetch fails, `row.getValue(columnId)` returns the thrown\n   * `Error` instance for the affected cells while the rest of the snapshot\n   * resolves normally.\n   * Columns defined with `locator.type === \"custom\"` are omitted because\n   * they have no underlying value to export.\n   *\n   * The returned promise rejects up front when the object set's `totalCount`\n   * exceeds `rowLimit`. When `totalCount` is unavailable, it instead rejects\n   * mid-load once more than `rowLimit` rows have been pulled, so an unknown\n   * count can't drain an unbounded set into the client. Otherwise every\n   * matching row is loaded.\n   *\n   * @param options See {@link ObjectTableSnapshotOptions}.\n   */\n  getSnapshot: (\n    options?: ObjectTableSnapshotOptions,\n  ) => Promise<ObjectTableSnapshot<Q, RDPs>>;\n}\n\n/**\n * Options for {@link ObjectTableHandle[\"getSnapshot\"]}.\n */\nexport interface ObjectTableSnapshotOptions {\n  /**\n   * Upper bound on how many rows the snapshot may contain. When the object\n   * set's total row count exceeds this value, `getSnapshot` rejects;\n   * otherwise every matching row is loaded.\n   *\n   * @default 10_000\n   */\n  rowLimit?: number;\n}\n\n/**\n * A point-in-time capture of an {@link ObjectTable}'s columns and row values,\n * returned by {@link ObjectTableHandle.getSnapshot}.\n */\nexport interface ObjectTableSnapshot<\n  Q extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = Record<string, never>,\n> {\n  columns: ObjectTableDataColumn[];\n  rows: ObjectTableDataRow<Q, RDPs>[];\n  /**\n   * Total number of objects matching the underlying object set, as reported\n   * by the API. `undefined` when the API did not provide a count. Encoded as\n   * a string to match the underlying list-payload representation.\n   */\n  totalCount: string | undefined;\n}\n\n/**\n * A single column in an {@link ObjectTableSnapshot}.\n */\nexport interface ObjectTableDataColumn {\n  /** Column id, matching the `locator.id` of the column definition. */\n  id: string;\n  /** Display name shown in the table header. */\n  name: string;\n}\n\n/**\n * A single row in an {@link ObjectTableSnapshot}.\n */\nexport interface ObjectTableDataRow<\n  Q extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = Record<string, never>,\n> {\n  /** Row id (the underlying object's `$primaryKey` rendered as a string). */\n  id: string;\n  /** The underlying loaded object. */\n  object: Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs>;\n  /**\n   * Returns the cell value for a given column id, or `undefined` when the\n   * column is not part of the snapshot. Function-backed cells whose query\n   * failed surface the thrown `Error` instance as their value.\n   */\n  getValue: (columnId: string) => unknown;\n}\n\n/**\n * Payload for {@link ObjectTableProps.onRowSelectionChanged}. Consolidates\n * the loaded row instances, the `isSelectAll` semantic intent, and an\n * `ObjectSet` covering the selection.\n */\nexport interface RowSelectionChange<\n  Q extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = Record<string, never>,\n> {\n  /**\n   * Loaded row instances currently selected. When `isSelectAll` is true,\n   * this reflects only the rows currently in the table — pages not yet\n   * fetched are absent. Use `objectSet` for the cross-page view, and\n   * `selectedRows.map(r => r.$primaryKey)` if you need the primary keys.\n   */\n  selectedRows: Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs>[];\n\n  /**\n   * True when the user invoked \"select all\" (header checkbox) or when\n   * controlled mode supplies `isAllSelected={true}`. Distinct from \"every\n   * loaded row happens to be selected\" — that condition is reflected by\n   * `selectedRows.length` matching the visible row count but does not set\n   * this flag.\n   */\n  isSelectAll: boolean;\n\n  /**\n   * An `ObjectSet` representing the selection.\n   *\n   * - \"Select all\" → the underlying `ObjectSet` (`objectSet` prop if\n   *   provided, otherwise derived from `objectType` via `client(...)`).\n   *   This includes rows not yet loaded into the table.\n   * - Partial selection → the underlying `ObjectSet` narrowed to\n   *   `{ $primaryKey: { $in: selectedRows.map(r => r.$primaryKey) } }`.\n   * - \"Deselect all\" → an empty `ObjectSet` (`$in: []`).\n   *\n   * Works for both object and interface types, since the `$primaryKey`\n   * special property does not require resolving the underlying primary key\n   * property name. `undefined` only when there is no underlying `ObjectSet`\n   * to derive from.\n   */\n  objectSet: ObjectSet<Q, RDPs> | undefined;\n}\n\nexport interface ObjectSetOptions<Q extends ObjectOrInterfaceDefinition> {\n  /**\n   * Object sets to union with\n   */\n  union?: ObjectSet<Q>[];\n\n  /**\n   * Object sets to intersect with\n   */\n  intersect?: ObjectSet<Q>[];\n\n  /**\n   * Object sets to subtract from\n   */\n  subtract?: ObjectSet<Q>[];\n}\n"],"mappings":"","ignoreList":[]}
+{"version":3,"file":"ObjectTableApi.js","names":[],"sources":["ObjectTableApi.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  CompileTimeMetadata,\n  DerivedProperty,\n  ObjectOrInterfaceDefinition,\n  ObjectSet,\n  Osdk,\n  PrimaryKeyType,\n  PropertyKeys,\n  QueryDefinition,\n  SimplePropertyDef,\n  WhereClause,\n} from \"@osdk/api\";\nimport type { QueryParameterType } from \"@osdk/client/observable\";\nimport type * as React from \"react\";\n\nimport type { ObjectTableLabels } from \"./ObjectTableLabels.js\";\nimport type { CellEditInfo, EditFieldConfig } from \"./utils/types.js\";\n\nexport type { EditFieldConfig } from \"./utils/types.js\";\n\nexport type ColumnDefinition<\n  Q extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = Record<string, never>,\n  FunctionColumns extends Record<string, QueryDefinition<{}>> = Record<\n    string,\n    never\n  >,\n> =\n  | EditableColumnDefinition<Q, RDPs, FunctionColumns>\n  | ReadonlyColumnDefinition<Q, RDPs, FunctionColumns>;\n\ninterface SharedColumnDefinition<\n  Q extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = Record<string, never>,\n  FunctionColumns extends Record<string, QueryDefinition<{}>> = Record<\n    string,\n    never\n  >,\n> {\n  /**\n   * Defines what the column shows:\n   * an object/interface property, a linked object property (derived property), a function\n   * column, or a custom column — and carries that locator's configuration.\n   */\n  locator: ColumnDefinitionLocator<Q, RDPs, FunctionColumns>;\n\n  /**\n   * @default true\n   */\n  isVisible?: boolean;\n\n  /**\n   * @default none\n   */\n  pinned?: \"left\" | \"right\" | \"none\";\n  width?: number;\n  minWidth?: number;\n  maxWidth?: number;\n  resizable?: boolean;\n  orderable?: boolean;\n\n  /**\n   * Custom renderer for the cell value.\n   *\n   * Interaction with `editable` columns:\n   * - When `editMode: \"manual\"` (default), `renderCell` is used while the\n   *   table is read-only (Edit Table button visible) and the editable cell\n   *   takes over once the user enters edit mode.\n   * - When `editMode: \"always\"`, the editable cell always wins on editable\n   *   columns and `renderCell` is ignored — `editMode: \"always\"` opts the\n   *   column into a permanently-editable surface, leaving no read-only\n   *   state for `renderCell` to render. Use `editMode: \"manual\"` if you\n   *   need a custom display alongside editing.\n   */\n  renderCell?: (\n    object: Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs>,\n    locator: ColumnDefinitionLocator<Q, RDPs, FunctionColumns>,\n  ) => React.ReactNode;\n\n  /**\n   * If provided, this will be used in the column header.\n   * If both columnName and renderHeader are provided, renderHeader will take precedence in the table header.\n   * columnName will still be used in other parts where the column name is displayed.\n   *\n   * If not provided,\n   * for a property column, the property displayName will be used\n   * for other columns, the id will be used.\n   */\n  columnName?: string;\n\n  /**\n   * If provided, this will be used to render the header component.\n   * When both columnName and renderHeader are provided, renderHeader will take precedence in the table header.\n   */\n  renderHeader?: () => React.ReactNode;\n}\n\ninterface EditableColumnDefinition<\n  Q extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = Record<string, never>,\n  FunctionColumns extends Record<string, QueryDefinition<{}>> = Record<\n    string,\n    never\n  >,\n> extends SharedColumnDefinition<Q, RDPs, FunctionColumns> {\n  /**\n   * `editable` can be a boolean or a predicate that receives the row's object\n   * and returns whether the cell is editable\n   */\n  editable:\n    | true\n    | ((\n        object: Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs>,\n      ) => boolean);\n\n  /**\n   * Configuration for the cell editor component.\n   *\n   * When provided, the column uses the specified field component\n   * (e.g. dropdown) instead of the default auto-detected text/number input.\n   *\n   * `getFieldComponentProps` receives the row's object and a map of any\n   * pending edits for that row (keyed by column id), and returns the props to\n   * pass to the field component. Editor configuration can depend on the\n   * current row or on other in-progress edits within the row.\n   */\n  editFieldConfig?: EditFieldConfig<\n    Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs>\n  >;\n\n  /**\n   * Additional function to validate the cell value during edit.\n   *\n   * @param value the current cell value\n   * @returns a promise that resolves to an error message string if validation fails, or undefined if validation succeeds\n   */\n  validateEdit?: (value: unknown) => Promise<string | undefined>;\n}\n\n/**\n * Column definition for a read-only column (default).\n * `editFieldConfig` and `validateEdit` are not available.\n */\ninterface ReadonlyColumnDefinition<\n  Q extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = Record<string, never>,\n  FunctionColumns extends Record<string, QueryDefinition<{}>> = Record<\n    string,\n    never\n  >,\n> extends SharedColumnDefinition<Q, RDPs, FunctionColumns> {\n  editable?: false;\n}\n\nexport type ExtractQueryParameters<Q extends QueryDefinition> =\n  CompileTimeMetadata<Q>[\"parameters\"] extends Record<string, never>\n    ? undefined\n    : QueryParameterType<CompileTimeMetadata<Q>[\"parameters\"]>;\n\nexport interface PropertyColumnLocator<Q extends ObjectOrInterfaceDefinition> {\n  type: \"property\";\n  id: PropertyKeys<Q>;\n}\n\n/**\n * Concrete function column locator for a single key K.\n * Correlates the id, queryDefinition, and getFunctionParams types.\n */\ninterface FunctionColumnLocatorForKey<\n  Q extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef>,\n  FunctionColumns extends Record<string, QueryDefinition<{}>>,\n  K extends keyof FunctionColumns,\n> {\n  /**\n   * This is equivalent to workshop's function-backed columns.\n   * The function needs to meet the specifications stated in https://www.palantir.com/docs/foundry/workshop/widgets-object-table/#function-backed-columns\n   */\n  type: \"function\";\n  id: K;\n  queryDefinition: FunctionColumns[K];\n\n  /**\n   * The function will be called with the current object set to get the input parameters for the function query.\n   * @param objectSet - The current object set.\n   * @returns - The function's input parameters including the object set.\n   */\n  getFunctionParams: (\n    objectSet: ObjectSet<Q, RDPs>,\n  ) => ExtractQueryParameters<FunctionColumns[K]>;\n\n  /**\n   * Function to generate keys for looking up results in the FunctionsMap.\n   * @param object - The object instance\n   * @returns - The key to use for looking up this object's result in the FunctionsMap\n   */\n  getKey: (\n    object: Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs>,\n  ) => string;\n\n  /**\n   * Function to extract the cell value from the raw cell data returned by the function.\n   * This is useful when functions return custom types with multiple properties.\n   * @param cellData - The raw data returned by the function for this object\n   * @returns - The value to display in the cell\n   */\n  getValue?: (cellData?: unknown) => unknown;\n\n  /**\n   * Minimum time between re-fetches of the same function with the same parameters, in milliseconds.\n   * Defaults to 5 minutes as it is expensive to fetch function columns for a large object set\n   * and they are expected to be relatively static in the context of an object table\n   *\n   * @default 300_000 (5 minutes)\n   */\n  dedupeIntervalMs?: number;\n\n  /**\n   * Object type apiNames the function reads but doesn't take as a parameter (e.g.\n   * linked object types the function traverses internally). The column auto-revalidates\n   * when an action edits an object of any of these types. Param-derived types are\n   * tracked automatically and don't need to be listed here.\n   */\n  dependsOn?: string[];\n}\n\n/**\n * Distributes over each key in FunctionColumns so that id, queryDefinition,\n * and getFunctionParams are correlated per key.\n */\nexport type FunctionColumnLocator<\n  Q extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = Record<string, never>,\n  FunctionColumns extends Record<string, QueryDefinition<{}>> = Record<\n    string,\n    never\n  >,\n> = keyof FunctionColumns extends infer K\n  ? K extends keyof FunctionColumns\n    ? FunctionColumnLocatorForKey<Q, RDPs, FunctionColumns, K>\n    : never\n  : never;\n\nexport interface RdpColumnLocator<\n  Q extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = Record<string, never>,\n> {\n  type: \"rdp\";\n  id: keyof RDPs;\n  creator: DerivedProperty.Creator<Q, RDPs[keyof RDPs]>;\n}\n\nexport interface CustomColumnLocator {\n  type: \"custom\";\n  id: string;\n}\n\nexport type ColumnDefinitionLocator<\n  Q extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = Record<string, never>,\n  FunctionColumns extends Record<string, QueryDefinition<{}>> = Record<\n    string,\n    never\n  >,\n> =\n  | PropertyColumnLocator<Q>\n  | FunctionColumnLocator<Q, RDPs, FunctionColumns>\n  | RdpColumnLocator<Q, RDPs>\n  | CustomColumnLocator;\n\nexport interface ObjectTableProps<\n  Q extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = Record<string, never>,\n  FunctionColumns extends Record<string, QueryDefinition<{}>> = Record<\n    string,\n    never\n  >,\n> {\n  /**\n   * The object or interface type of the object\n   * If objectSet is not provided, objects will be fetched based on this type.\n   */\n  objectType: Q;\n\n  /**\n   * The set of objects to show in the table.\n   * If provided, the table fetches through this object set instead of fetching based on\n   * objectType. Supported for both object and interface types.\n   *\n   * For an interface object set, rows expose the interface's declared properties;\n   * the underlying concrete object's non-interface properties are not loaded.\n   * Use objectType-based fetching if you need those.\n   */\n  objectSet?: ObjectSet<Q>;\n\n  /**\n   * Ordered list of column definitions to show in the table\n   *\n   * If not provided, all of the properties of the object type will be shown in default order.\n   */\n  columnDefinitions?: Array<ColumnDefinition<Q, RDPs, FunctionColumns>>;\n\n  objectSetOptions?: ObjectSetOptions<Q>;\n\n  /**\n   * Minimum time between fetch requests in milliseconds.\n   * Increasing this value reduces redundant network calls when the same data\n   * is requested multiple times in quick succession.\n   *\n   * @default 60_000 1 minute\n   */\n  dedupeIntervalMs?: number;\n\n  /**\n   * Enable streaming updates via websocket subscription.\n   * When true, the table will automatically update when matching\n   * objects are added, updated, or removed in Foundry.\n   *\n   * Limitations: `streamUpdates` cannot be used together with `pivotTo` or\n   * `withProperties`. The server does not support websocket subscriptions\n   * for link-traversal or derived-property queries. Those queries still\n   * fetch data normally but won't receive real-time updates.\n   *\n   * @default false\n   */\n  streamUpdates?: boolean;\n\n  /**\n   * Number of objects to fetch per page.\n   *\n   * @default 50\n   */\n  pageSize?: number;\n\n  /**\n   * The current where clause to filter the objects in the table.\n   * If provided, the filter is controlled.\n   */\n  filter?: WhereClause<Q, RDPs>;\n\n  /**\n   * Whether the column configuration dialog for column visibility and ordering is available to the user.\n   *\n   * @default true\n   */\n  enableColumnConfig?: boolean;\n\n  /**\n   * Whether columns can be pinned by the user.\n   *\n   * @default true\n   */\n  enableColumnPinning?: boolean;\n\n  /**\n   * Whether columns can be resized by the user.\n   *\n   * @default true\n   */\n  enableColumnResizing?: boolean;\n\n  /**\n   * Called when the column visibility or ordering changed.\n   *\n   * If provided, the table will allow the user to show/hide columns.\n   *\n   * @param newStates The columns sorted in their display order in the table and their visibility state.\n   */\n  onColumnVisibilityChanged?: (\n    newStates: Array<{\n      columnId: PropertyKeys<Q> | keyof RDPs | keyof FunctionColumns;\n      isVisible: boolean;\n    }>,\n  ) => void;\n\n  /**\n   * Called when the pinned columns change.\n   *\n   * If provided, the table will allow the user to pin/unpin columns.\n   *\n   * @param newStates The new list of column pin states\n   */\n  onColumnsPinnedChanged?: (\n    newStates: Array<{\n      columnId: PropertyKeys<Q> | keyof RDPs | keyof FunctionColumns;\n      pinned: \"left\" | \"right\" | \"none\";\n    }>,\n  ) => void;\n\n  /**\n   * Called when a column is resized.\n   *\n   * @param columnId The ID of the resized column\n   * @param newWidth The new width of the column. When newWidth = null, the column size is reset.\n   */\n  onColumnResize?: (\n    columnId: PropertyKeys<Q> | keyof RDPs | keyof FunctionColumns,\n    newWidth: number | null,\n  ) => void;\n\n  /**\n   * Called when a column header is clicked.\n   *\n   * The columnId matches the `locator.id` configured on the column definition.\n   * The dropdown menu trigger is excluded — clicking the chevron opens the\n   * header menu instead of firing this callback.\n   *\n   * @param columnId The id of the clicked column\n   */\n  onColumnHeaderClick?: (\n    columnId: PropertyKeys<Q> | keyof RDPs | keyof FunctionColumns,\n  ) => void;\n\n  /**\n   * Whether the table is sortable by the user.\n   *\n   * @default true\n   */\n  enableOrdering?: boolean;\n\n  /**\n   * The default order by clause to sort the objects in the table.\n   * If provided without orderBy prop, the sorting is uncontrolled.\n   * If both orderBy and defaultOrderBy are provided, orderBy takes precedence.\n   */\n  defaultOrderBy?: Array<{\n    property: PropertyKeys<Q> | keyof RDPs;\n    direction: \"asc\" | \"desc\";\n  }>;\n\n  /**\n   * The current order by clause to sort the objects in the table.\n   * If provided, the sorting is controlled.\n   * If both orderBy and defaultOrderBy are provided, orderBy takes precedence.\n   */\n  orderBy?: Array<{\n    property: PropertyKeys<Q> | keyof RDPs;\n    direction: \"asc\" | \"desc\";\n  }>;\n\n  /**\n   * Called when the order by clause is changed.\n   * Required when sorting is controlled.\n   *\n   * @param newOrderBy The new order by clause\n   */\n  onOrderByChanged?: (\n    newOrderBy: Array<{\n      property: PropertyKeys<Q> | keyof RDPs;\n      direction: \"asc\" | \"desc\";\n    }>,\n  ) => void;\n\n  /**\n   * Selection mode for the table rows.\n   *\n   * If multiple, a checkbox will be shown for each row to allow selecting multiple rows\n   * as well as a top-level checkbox in the header to select all rows.\n   *\n   * @default \"none\"\n   */\n  selectionMode?: \"single\" | \"multiple\" | \"none\";\n\n  /**\n   * The currently selected rows in the table.\n   * If provided, the row selection is controlled.\n   */\n  selectedRows?: PrimaryKeyType<Q>[];\n\n  /**\n   * Indicates whether all rows are selected in controlled mode.\n   * When true, the table will show all rows as selected regardless of the selectedRows array.\n   */\n  isAllSelected?: boolean;\n\n  /**\n   * Called when the row selection changes, with a {@link RowSelectionChange}\n   * payload describing the new state.\n   *\n   * @param change The new selection state. See {@link RowSelectionChange}.\n   */\n  onRowSelectionChanged?: (change: RowSelectionChange<Q, RDPs>) => void;\n\n  /**\n   * The primary key of the row to render as visually focused (the\n   * \"last interacted\" row). When provided, focus state is controlled by\n   * the caller.\n   *\n   * Stored as a primary key rather than a full object so the focus does\n   * not go stale when the underlying row data changes.\n   *\n   * Pass `null` to render no row as focused.\n   */\n  focusedRow?: PrimaryKeyType<Q> | null;\n\n  /**\n   * Called when the focused row changes — fires in both controlled and\n   * uncontrolled modes so callers can observe focus without taking it\n   * over.\n   *\n   * @param row The newly-focused row object, or `null` if focus was\n   * cleared\n   */\n  onFocusedRowChanged?: (\n    row: Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs> | null,\n  ) => void;\n\n  /**\n   * Controls the edit mode behavior of the table.\n   * - \"always\": Editable cells are immediately in edit mode on row clicked.\n   * - \"manual\": User can toggle edit mode on/off via the Edit Table button.\n   *\n   * @default \"manual\"\n   */\n  editMode?: \"always\" | \"manual\";\n\n  /**\n   * Whether to render the bottom edit footer that hosts the\n   * \"Edit Table\" / \"Cancel\" / \"Submit Edits\" buttons and the edit-state\n   * indicators (modification count, validation errors).\n   *\n   * @default true whenever the table has at least one column declared\n   * editable (i.e. any column with `editable: true` or `editable: (object) => boolean`).\n   * When `false`, the \"Edit Table\" and \"Submit Edits\" buttons will not be shown.\n   */\n  showEditFooter?: boolean;\n\n  /**\n   * Called after the value of a cell is edited and committed by the user.\n   *\n   * @param info An object containing details about the cell that was edited,\n   * including the rowId, columnId, new and old values, and the row data before the edit\n   */\n  onCellValueChanged?: (\n    info: CellEditInfo<\n      Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs>,\n      unknown\n    >,\n  ) => void;\n\n  /**\n   * If provided, the \"Submit Edits\" button will be shown in the edit footer.\n   *\n   * @param edits an array of edit info containing details about the edited cells\n   * including the rowId, columnId, new and old values, and the row data before the edit\n   * @return a promise that resolves to true if the edits were successfully submitted\n   */\n  onSubmitEdits?: (\n    edits: CellEditInfo<\n      Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs>,\n      unknown\n    >[],\n  ) => Promise<boolean>;\n\n  /**\n   * Called when a row is clicked.\n   *\n   * @param object The object representing the clicked row\n   */\n  onRowClick?: (\n    object: Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs>,\n  ) => void;\n\n  /**\n   * If provided, will render this context menu when right clicking on a cell\n   */\n  renderCellContextMenu?: (\n    row: Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs>,\n    cellValue: unknown,\n  ) => React.ReactNode;\n\n  /**\n   * The height of each row in pixels.\n   *\n   * @default 40\n   */\n  rowHeight?: number;\n\n  /**\n   * Render override for the empty state. Called when the table has no\n   * rows and no error. When omitted, a default \"No Data\" indicator is\n   * rendered.\n   */\n  renderEmptyState?: () => React.ReactNode;\n\n  /**\n   * Returns extra HTML attributes (typically `data-*`) to apply to each\n   * row element. Use this to drive conditional row styling\n   */\n  getRowAttributes?: (\n    object: Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs>,\n  ) => Record<string, string | undefined>;\n\n  /**\n   * Imperative handle for programmatic table actions. Pass a ref\n   * (`useRef<ObjectTableHandle<Q, RDPs>>(null)`) to call\n   * {@link ObjectTableHandle} methods such as\n   * {@link ObjectTableHandle.getSnapshot}.\n   */\n  tableRef?: React.Ref<ObjectTableHandle<Q, RDPs>>;\n\n  className?: string;\n\n  /**\n   * Overrides for the table's user-facing strings. Provide any subset; unset keys fall\n   * back to the built-in English defaults. Use this to localize the table or\n   * adjust wording. See {@link ObjectTableLabels}.\n   *\n   * @default undefined (built-in English strings)\n   */\n  labels?: Partial<ObjectTableLabels>;\n}\n\n/**\n * Imperative handle exposing programmatic actions on an {@link ObjectTable}.\n * Obtain it by passing {@link ObjectTableProps.tableRef}.\n */\nexport interface ObjectTableHandle<\n  Q extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = Record<string, never>,\n> {\n  /**\n   * Loads every row matching the object set and returns a format-agnostic\n   * snapshot of the table's columns, row values, and total count. The caller\n   * is responsible for turning the snapshot into a downloadable artifact\n   * (CSV, Spreadsheet, JSON, clipboard, …).\n   *\n   * Property, derived-property, and function-backed columns are included.\n   * Function-backed cells are fetched per page during snapshot collection;\n   * when a page's fetch fails, `row.getValue(columnId)` returns the thrown\n   * `Error` instance for the affected cells while the rest of the snapshot\n   * resolves normally.\n   * Columns defined with `locator.type === \"custom\"` are omitted because\n   * they have no underlying value to export.\n   *\n   * The returned promise rejects up front when the object set's `totalCount`\n   * exceeds `rowLimit`. When `totalCount` is unavailable, it instead rejects\n   * mid-load once more than `rowLimit` rows have been pulled, so an unknown\n   * count can't drain an unbounded set into the client. Otherwise every\n   * matching row is loaded.\n   *\n   * @param options See {@link ObjectTableSnapshotOptions}.\n   */\n  getSnapshot: (\n    options?: ObjectTableSnapshotOptions,\n  ) => Promise<ObjectTableSnapshot<Q, RDPs>>;\n}\n\n/**\n * Options for {@link ObjectTableHandle[\"getSnapshot\"]}.\n */\nexport interface ObjectTableSnapshotOptions {\n  /**\n   * Upper bound on how many rows the snapshot may contain. When the object\n   * set's total row count exceeds this value, `getSnapshot` rejects;\n   * otherwise every matching row is loaded.\n   *\n   * @default 10_000\n   */\n  rowLimit?: number;\n}\n\n/**\n * A point-in-time capture of an {@link ObjectTable}'s columns and row values,\n * returned by {@link ObjectTableHandle.getSnapshot}.\n */\nexport interface ObjectTableSnapshot<\n  Q extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = Record<string, never>,\n> {\n  columns: ObjectTableDataColumn[];\n  rows: ObjectTableDataRow<Q, RDPs>[];\n  /**\n   * Total number of objects matching the underlying object set, as reported\n   * by the API. `undefined` when the API did not provide a count. Encoded as\n   * a string to match the underlying list-payload representation.\n   */\n  totalCount: string | undefined;\n}\n\n/**\n * A single column in an {@link ObjectTableSnapshot}.\n */\nexport interface ObjectTableDataColumn {\n  /** Column id, matching the `locator.id` of the column definition. */\n  id: string;\n  /** Display name shown in the table header. */\n  name: string;\n}\n\n/**\n * A single row in an {@link ObjectTableSnapshot}.\n */\nexport interface ObjectTableDataRow<\n  Q extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = Record<string, never>,\n> {\n  /** Row id (the underlying object's `$primaryKey` rendered as a string). */\n  id: string;\n  /** The underlying loaded object. */\n  object: Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs>;\n  /**\n   * Returns the cell value for a given column id, or `undefined` when the\n   * column is not part of the snapshot. Function-backed cells whose query\n   * failed surface the thrown `Error` instance as their value.\n   */\n  getValue: (columnId: string) => unknown;\n}\n\n/**\n * Payload for {@link ObjectTableProps.onRowSelectionChanged}. Consolidates\n * the loaded row instances, the `isSelectAll` semantic intent, and an\n * `ObjectSet` covering the selection.\n */\nexport interface RowSelectionChange<\n  Q extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = Record<string, never>,\n> {\n  /**\n   * Loaded row instances currently selected. When `isSelectAll` is true,\n   * this reflects only the rows currently in the table — pages not yet\n   * fetched are absent. Use `objectSet` for the cross-page view, and\n   * `selectedRows.map(r => r.$primaryKey)` if you need the primary keys.\n   */\n  selectedRows: Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs>[];\n\n  /**\n   * True when the user invoked \"select all\" (header checkbox) or when\n   * controlled mode supplies `isAllSelected={true}`. Distinct from \"every\n   * loaded row happens to be selected\" — that condition is reflected by\n   * `selectedRows.length` matching the visible row count but does not set\n   * this flag.\n   */\n  isSelectAll: boolean;\n\n  /**\n   * An `ObjectSet` representing the selection.\n   *\n   * - \"Select all\" → the underlying `ObjectSet` (`objectSet` prop if\n   *   provided, otherwise derived from `objectType` via `client(...)`).\n   *   This includes rows not yet loaded into the table.\n   * - Partial selection → the underlying `ObjectSet` narrowed to\n   *   `{ $primaryKey: { $in: selectedRows.map(r => r.$primaryKey) } }`.\n   * - \"Deselect all\" → an empty `ObjectSet` (`$in: []`).\n   *\n   * Works for both object and interface types, since the `$primaryKey`\n   * special property does not require resolving the underlying primary key\n   * property name. `undefined` only when there is no underlying `ObjectSet`\n   * to derive from.\n   */\n  objectSet: ObjectSet<Q, RDPs> | undefined;\n}\n\nexport interface ObjectSetOptions<Q extends ObjectOrInterfaceDefinition> {\n  /**\n   * Object sets to union with\n   */\n  union?: ObjectSet<Q>[];\n\n  /**\n   * Object sets to intersect with\n   */\n  intersect?: ObjectSet<Q>[];\n\n  /**\n   * Object sets to subtract from\n   */\n  subtract?: ObjectSet<Q>[];\n}\n"],"mappings":"","ignoreList":[]}

package/build/esm/public/experimental/{excel-viewer.js → spreadsheet-viewer.js}

@@ -14,10 +14,10 @@
  * limitations under the License.
  */
 
-// BaseExcelViewer
-export { BaseExcelViewer } from "../../excel-viewer/BaseExcelViewer.js";
-// ExcelViewer (Media wrapper)
-import { ExcelViewer as _ExcelViewer } from "../../excel-viewer/ExcelViewer.js";
+// BaseSpreadsheetViewer
+export { BaseSpreadsheetViewer } from "../../spreadsheet-viewer/BaseSpreadsheetViewer.js";
+// SpreadsheetViewer (Media wrapper)
+import { SpreadsheetViewer as _SpreadsheetViewer } from "../../spreadsheet-viewer/SpreadsheetViewer.js";
 import { withOsdkMetrics } from "../../util/withOsdkMetrics.js";
-export const ExcelViewer = withOsdkMetrics(_ExcelViewer, "ExcelViewer");
-//# sourceMappingURL=excel-viewer.js.map
+export const SpreadsheetViewer = withOsdkMetrics(_SpreadsheetViewer, "SpreadsheetViewer");
+//# sourceMappingURL=spreadsheet-viewer.js.map

package/build/esm/public/experimental/spreadsheet-viewer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spreadsheet-viewer.js","names":["BaseSpreadsheetViewer","SpreadsheetViewer","_SpreadsheetViewer","withOsdkMetrics"],"sources":["spreadsheet-viewer.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\n// BaseSpreadsheetViewer\nexport { BaseSpreadsheetViewer } from \"../../spreadsheet-viewer/BaseSpreadsheetViewer.js\";\nexport type {\n  BaseSpreadsheetViewerProps,\n  ParsedSpreadsheet,\n  SheetData,\n  SpreadsheetViewerMediaProps,\n} from \"../../spreadsheet-viewer/SpreadsheetViewerApi.js\";\n\n// SpreadsheetViewer (Media wrapper)\nimport { SpreadsheetViewer as _SpreadsheetViewer } from \"../../spreadsheet-viewer/SpreadsheetViewer.js\";\nimport { withOsdkMetrics } from \"../../util/withOsdkMetrics.js\";\nexport const SpreadsheetViewer: typeof _SpreadsheetViewer = withOsdkMetrics(\n  _SpreadsheetViewer,\n  \"SpreadsheetViewer\",\n);\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA,SAASA,qBAAqB,QAAQ,mDAAmD;AAQzF;AACA,SAASC,iBAAiB,IAAIC,kBAAkB,QAAQ,+CAA+C;AACvG,SAASC,eAAe,QAAQ,+BAA+B;AAC/D,OAAO,MAAMF,iBAA4C,GAAGE,eAAe,CACzED,kBAAkB,EAClB,mBACF,CAAC","ignoreList":[]}

package/build/esm/public/experimental.js

@@ -18,12 +18,12 @@ export * from "./experimental/action-form.js";
 export * from "./experimental/cbac-picker.js";
 export * from "./experimental/document-viewer.js";
 export * from "./experimental/email-viewer.js";
-export * from "./experimental/excel-viewer.js";
 export * from "./experimental/filter-list.js";
 export * from "./experimental/image-viewer.js";
 export * from "./experimental/markdown-renderer.js";
 export * from "./experimental/object-table.js";
 export * from "./experimental/pdf-viewer.js";
+export * from "./experimental/spreadsheet-viewer.js";
 export * from "./experimental/theme.js";
 export * from "./experimental/tiff-renderer.js";
 export * from "./experimental/video-viewer.js";

package/build/esm/public/experimental.js.map

@@ -1 +1 @@
-{"version":3,"file":"experimental.js","names":[],"sources":["experimental.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport * from \"./experimental/action-form.js\";\nexport * from \"./experimental/cbac-picker.js\";\nexport * from \"./experimental/document-viewer.js\";\nexport * from \"./experimental/email-viewer.js\";\nexport * from \"./experimental/excel-viewer.js\";\nexport * from \"./experimental/filter-list.js\";\nexport * from \"./experimental/image-viewer.js\";\nexport * from \"./experimental/markdown-renderer.js\";\nexport * from \"./experimental/object-table.js\";\nexport * from \"./experimental/pdf-viewer.js\";\nexport * from \"./experimental/theme.js\";\nexport * from \"./experimental/tiff-renderer.js\";\nexport * from \"./experimental/video-viewer.js\";\nexport * from \"./experimental/xml-viewer.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,cAAc,+BAA+B;AAC7C,cAAc,+BAA+B;AAC7C,cAAc,mCAAmC;AACjD,cAAc,gCAAgC;AAC9C,cAAc,gCAAgC;AAC9C,cAAc,+BAA+B;AAC7C,cAAc,gCAAgC;AAC9C,cAAc,qCAAqC;AACnD,cAAc,gCAAgC;AAC9C,cAAc,8BAA8B;AAC5C,cAAc,yBAAyB;AACvC,cAAc,iCAAiC;AAC/C,cAAc,gCAAgC;AAC9C,cAAc,8BAA8B","ignoreList":[]}
+{"version":3,"file":"experimental.js","names":[],"sources":["experimental.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport * from \"./experimental/action-form.js\";\nexport * from \"./experimental/cbac-picker.js\";\nexport * from \"./experimental/document-viewer.js\";\nexport * from \"./experimental/email-viewer.js\";\nexport * from \"./experimental/filter-list.js\";\nexport * from \"./experimental/image-viewer.js\";\nexport * from \"./experimental/markdown-renderer.js\";\nexport * from \"./experimental/object-table.js\";\nexport * from \"./experimental/pdf-viewer.js\";\nexport * from \"./experimental/spreadsheet-viewer.js\";\nexport * from \"./experimental/theme.js\";\nexport * from \"./experimental/tiff-renderer.js\";\nexport * from \"./experimental/video-viewer.js\";\nexport * from \"./experimental/xml-viewer.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,cAAc,+BAA+B;AAC7C,cAAc,+BAA+B;AAC7C,cAAc,mCAAmC;AACjD,cAAc,gCAAgC;AAC9C,cAAc,+BAA+B;AAC7C,cAAc,gCAAgC;AAC9C,cAAc,qCAAqC;AACnD,cAAc,gCAAgC;AAC9C,cAAc,8BAA8B;AAC5C,cAAc,sCAAsC;AACpD,cAAc,yBAAyB;AACvC,cAAc,iCAAiC;AAC/C,cAAc,gCAAgC;AAC9C,cAAc,8BAA8B","ignoreList":[]}

package/build/{browser/excel-viewer/BaseExcelViewer.js → esm/spreadsheet-viewer/BaseSpreadsheetViewer.js}

@@ -16,7 +16,7 @@
 
 import classnames from "classnames";
 import React, { useCallback, useMemo, useState } from "react";
-import styles from "./BaseExcelViewer.module.css.js";
+import styles from "./BaseSpreadsheetViewer.module.css";
 
 /**
  * Converts a 0-based column index to a spreadsheet column letter (0=A, 1=B, ..., 25=Z, 26=AA).
@@ -63,7 +63,7 @@ const SheetTable = /*#__PURE__*/React.memo(({
   }, row[cellIndex] ?? "")))))));
 });
 SheetTable.displayName = "SheetTable";
-export function BaseExcelViewer({
+export function BaseSpreadsheetViewer({
   spreadsheet,
   className
 }) {
@@ -91,4 +91,4 @@ export function BaseExcelViewer({
     type: "button"
   }, sheet.name))));
 }
-//# sourceMappingURL=BaseExcelViewer.js.map
+//# sourceMappingURL=BaseSpreadsheetViewer.js.map

package/build/esm/spreadsheet-viewer/BaseSpreadsheetViewer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseSpreadsheetViewer.js","names":["classnames","React","useCallback","useMemo","useState","styles","columnIndexToLetter","index","letter","num","remainder","String","fromCharCode","Math","floor","SheetTable","memo","sheet","maxCols","rows","reduce","max","row","length","createElement","className","emptySheet","tableContainer","table","cornerCell","Array","from","_","i","key","columnHeader","map","rowIndex","rowHeader","cellIndex","cell","displayName","BaseSpreadsheetViewer","spreadsheet","activeSheetIndex","setActiveSheetIndex","rootClassName","container","safeIndex","min","sheets","activeSheet","handleTabClick","tabBar","name","tab","tabActive","onClick","type"],"sources":["BaseSpreadsheetViewer.tsx"],"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 classnames from \"classnames\";\nimport React, { useCallback, useMemo, useState } from \"react\";\n\nimport type {\n  BaseSpreadsheetViewerProps,\n  SheetData,\n} from \"./SpreadsheetViewerApi.js\";\n\nimport styles from \"./BaseSpreadsheetViewer.module.css\";\n\n/**\n * Converts a 0-based column index to a spreadsheet column letter (0=A, 1=B, ..., 25=Z, 26=AA).\n */\nfunction columnIndexToLetter(index: number): string {\n  let letter = \"\";\n  let num = index;\n  do {\n    const remainder = num % 26;\n    letter = String.fromCharCode(65 + remainder) + letter;\n    num = Math.floor(num / 26) - 1;\n  } while (num >= 0);\n  return letter;\n}\n\nconst SheetTable: React.FunctionComponent<{ sheet: SheetData }> = React.memo(\n  ({ sheet }) => {\n    const maxCols = useMemo(\n      () => sheet.rows.reduce((max, row) => Math.max(max, row.length), 0),\n      [sheet.rows],\n    );\n\n    if (sheet.rows.length === 0) {\n      return <div className={styles.emptySheet}>Empty sheet</div>;\n    }\n\n    return (\n      <div className={styles.tableContainer}>\n        <table className={styles.table}>\n          <thead>\n            <tr>\n              <th className={styles.cornerCell} />\n              {Array.from({ length: maxCols }, (_, i) => (\n                <th key={i} className={styles.columnHeader}>\n                  {columnIndexToLetter(i)}\n                </th>\n              ))}\n            </tr>\n          </thead>\n          <tbody>\n            {sheet.rows.map((row, rowIndex) => (\n              <tr key={rowIndex}>\n                <td className={styles.rowHeader}>{rowIndex + 1}</td>\n                {Array.from({ length: maxCols }, (_, cellIndex) => (\n                  <td key={cellIndex} className={styles.cell}>\n                    {row[cellIndex] ?? \"\"}\n                  </td>\n                ))}\n              </tr>\n            ))}\n          </tbody>\n        </table>\n      </div>\n    );\n  },\n);\nSheetTable.displayName = \"SheetTable\";\n\nexport function BaseSpreadsheetViewer({\n  spreadsheet,\n  className,\n}: BaseSpreadsheetViewerProps): React.ReactElement {\n  const [activeSheetIndex, setActiveSheetIndex] = useState(0);\n  const rootClassName = classnames(styles.container, className);\n\n  const safeIndex = Math.min(\n    activeSheetIndex,\n    Math.max(0, spreadsheet.sheets.length - 1),\n  );\n  const activeSheet = useMemo(\n    () => spreadsheet.sheets[safeIndex],\n    [spreadsheet.sheets, safeIndex],\n  );\n\n  const handleTabClick = useCallback((index: number) => {\n    setActiveSheetIndex(index);\n  }, []);\n\n  return (\n    <div className={rootClassName}>\n      {activeSheet != null ? (\n        <SheetTable sheet={activeSheet} />\n      ) : (\n        <div className={styles.emptySheet}>No sheets</div>\n      )}\n      {spreadsheet.sheets.length > 1 && (\n        <div className={styles.tabBar}>\n          {spreadsheet.sheets.map((sheet, index) => (\n            <button\n              key={sheet.name}\n              className={classnames(styles.tab, {\n                [styles.tabActive]: index === safeIndex,\n              })}\n              onClick={() => handleTabClick(index)}\n              type=\"button\"\n            >\n              {sheet.name}\n            </button>\n          ))}\n        </div>\n      )}\n    </div>\n  );\n}\n"],"mappings":"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","ignoreList":[]}

package/build/{browser/excel-viewer/BaseExcelViewer.module.css → esm/spreadsheet-viewer/BaseSpreadsheetViewer.module.css}

@@ -3,8 +3,8 @@
   flex-direction: column;
   width: 100%;
   height: 100%;
-  background-color: var(--osdk-excel-viewer-bg);
-  border: var(--osdk-excel-viewer-border);
+  background-color: var(--osdk-spreadsheet-viewer-bg);
+  border: var(--osdk-spreadsheet-viewer-border);
   border-radius: var(--osdk-surface-border-radius);
   overflow: hidden;
 }
@@ -25,75 +25,75 @@
 
 /* Column letter headers (A, B, C...) */
 .columnHeader {
-  background-color: var(--osdk-excel-viewer-header-bg);
-  border: 1px solid var(--osdk-excel-viewer-cell-border);
-  padding: var(--osdk-excel-viewer-cell-padding);
+  background-color: var(--osdk-spreadsheet-viewer-header-bg);
+  border: 1px solid var(--osdk-spreadsheet-viewer-cell-border);
+  padding: var(--osdk-spreadsheet-viewer-cell-padding);
   text-align: center;
   font-weight: var(--osdk-typography-weight-default);
-  color: var(--osdk-excel-viewer-header-color);
+  color: var(--osdk-spreadsheet-viewer-header-color);
   position: sticky;
   top: 0;
   z-index: 2;
-  min-width: var(--osdk-excel-viewer-col-min-width);
+  min-width: var(--osdk-spreadsheet-viewer-col-min-width);
   user-select: none;
 }
 
 /* Top-left corner cell */
 .cornerCell {
-  background-color: var(--osdk-excel-viewer-header-bg);
-  border: 1px solid var(--osdk-excel-viewer-cell-border);
+  background-color: var(--osdk-spreadsheet-viewer-header-bg);
+  border: 1px solid var(--osdk-spreadsheet-viewer-cell-border);
   position: sticky;
   top: 0;
   left: 0;
   z-index: 3;
-  min-width: var(--osdk-excel-viewer-row-header-width);
-  width: var(--osdk-excel-viewer-row-header-width);
+  min-width: var(--osdk-spreadsheet-viewer-row-header-width);
+  width: var(--osdk-spreadsheet-viewer-row-header-width);
 }
 
 /* Row number headers (1, 2, 3...) */
 .rowHeader {
-  background-color: var(--osdk-excel-viewer-header-bg);
-  border: 1px solid var(--osdk-excel-viewer-cell-border);
-  padding: var(--osdk-excel-viewer-cell-padding);
+  background-color: var(--osdk-spreadsheet-viewer-header-bg);
+  border: 1px solid var(--osdk-spreadsheet-viewer-cell-border);
+  padding: var(--osdk-spreadsheet-viewer-cell-padding);
   text-align: center;
   font-weight: var(--osdk-typography-weight-default);
-  color: var(--osdk-excel-viewer-header-color);
+  color: var(--osdk-spreadsheet-viewer-header-color);
   position: sticky;
   left: 0;
   z-index: 1;
-  min-width: var(--osdk-excel-viewer-row-header-width);
-  width: var(--osdk-excel-viewer-row-header-width);
+  min-width: var(--osdk-spreadsheet-viewer-row-header-width);
+  width: var(--osdk-spreadsheet-viewer-row-header-width);
   user-select: none;
 }
 
 /* Data cells */
 .cell {
-  border: 1px solid var(--osdk-excel-viewer-cell-border);
-  padding: var(--osdk-excel-viewer-cell-padding);
+  border: 1px solid var(--osdk-spreadsheet-viewer-cell-border);
+  padding: var(--osdk-spreadsheet-viewer-cell-padding);
   white-space: nowrap;
-  min-width: var(--osdk-excel-viewer-col-min-width);
+  min-width: var(--osdk-spreadsheet-viewer-col-min-width);
 }
 
 /* Sheet tabs bar */
 .tabBar {
   display: flex;
   align-items: flex-end;
-  gap: var(--osdk-excel-viewer-tab-gap);
-  border-top: var(--osdk-excel-viewer-tab-border);
-  background-color: var(--osdk-excel-viewer-tab-bg);
+  gap: var(--osdk-spreadsheet-viewer-tab-gap);
+  border-top: var(--osdk-spreadsheet-viewer-tab-border);
+  background-color: var(--osdk-spreadsheet-viewer-tab-bg);
   flex-shrink: 0;
   overflow-x: auto;
-  padding: var(--osdk-excel-viewer-tab-bar-padding)
-    var(--osdk-excel-viewer-tab-bar-padding) 0;
+  padding: var(--osdk-spreadsheet-viewer-tab-bar-padding)
+    var(--osdk-spreadsheet-viewer-tab-bar-padding) 0;
 }
 
 .tab {
-  padding: var(--osdk-excel-viewer-tab-padding);
-  border: var(--osdk-excel-viewer-tab-border);
+  padding: var(--osdk-spreadsheet-viewer-tab-padding);
+  border: var(--osdk-spreadsheet-viewer-tab-border);
   border-bottom: none;
-  border-radius: var(--osdk-excel-viewer-tab-border-radius)
-    var(--osdk-excel-viewer-tab-border-radius) 0 0;
-  background-color: var(--osdk-excel-viewer-tab-bg);
+  border-radius: var(--osdk-spreadsheet-viewer-tab-border-radius)
+    var(--osdk-spreadsheet-viewer-tab-border-radius) 0 0;
+  background-color: var(--osdk-spreadsheet-viewer-tab-bg);
   font-family: var(--osdk-typography-family-default);
   font-size: var(--osdk-typography-size-body-x-small);
   color: var(--osdk-typography-color-muted);
@@ -104,15 +104,15 @@
 }
 
 .tab:hover {
-  background-color: var(--osdk-excel-viewer-tab-hover-bg);
+  background-color: var(--osdk-spreadsheet-viewer-tab-hover-bg);
   color: var(--osdk-typography-color-default-rest);
 }
 
 .tabActive {
-  background-color: var(--osdk-excel-viewer-tab-active-bg);
+  background-color: var(--osdk-spreadsheet-viewer-tab-active-bg);
   color: var(--osdk-typography-color-default-rest);
   font-weight: var(--osdk-typography-weight-bold);
-  border-bottom: 1px solid var(--osdk-excel-viewer-tab-active-bg);
+  border-bottom: 1px solid var(--osdk-spreadsheet-viewer-tab-active-bg);
 }
 
 .emptySheet {

package/build/esm/{excel-viewer/ExcelViewer.js → spreadsheet-viewer/SpreadsheetViewer.js}

@@ -19,13 +19,13 @@ import { Error as ErrorIcon, Spin } from "@blueprintjs/icons";
 import classnames from "classnames";
 import React, { useCallback } from "react";
 import { useMediaContents } from "../shared/hooks/useMediaContents.js";
-import { BaseExcelViewer } from "./BaseExcelViewer.js";
+import { BaseSpreadsheetViewer } from "./BaseSpreadsheetViewer.js";
 import { parseSpreadsheetFromResponse } from "./parseSpreadsheet.js";
-import styles from "./BaseExcelViewer.module.css";
-export function ExcelViewer({
+import styles from "./BaseSpreadsheetViewer.module.css";
+export function SpreadsheetViewer({
   media,
   className,
-  ...excelViewerProps
+  ...spreadsheetViewerProps
 }) {
   const {
     data: spreadsheet,
@@ -43,8 +43,8 @@ export function ExcelViewer({
     className: styles.errorContainer
   }, /*#__PURE__*/React.createElement(ErrorIcon, {
     className: styles.errorIcon
-  }), "Failed to load spreadsheet: ", error.message), spreadsheet != null && /*#__PURE__*/React.createElement(BaseExcelViewer, _extends({
+  }), "Failed to load spreadsheet: ", error.message), spreadsheet != null && /*#__PURE__*/React.createElement(BaseSpreadsheetViewer, _extends({
     spreadsheet: spreadsheet
-  }, excelViewerProps)));
+  }, spreadsheetViewerProps)));
 }
-//# sourceMappingURL=ExcelViewer.js.map
+//# sourceMappingURL=SpreadsheetViewer.js.map

package/build/esm/spreadsheet-viewer/SpreadsheetViewer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpreadsheetViewer.js","names":["Error","ErrorIcon","Spin","classnames","React","useCallback","useMediaContents","BaseSpreadsheetViewer","parseSpreadsheetFromResponse","styles","SpreadsheetViewer","media","className","spreadsheetViewerProps","data","spreadsheet","loading","error","rootClassName","container","createElement","loadingContainer","spinnerIcon","errorContainer","errorIcon","message","_extends"],"sources":["SpreadsheetViewer.tsx"],"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 { Error as ErrorIcon, Spin } from \"@blueprintjs/icons\";\nimport classnames from \"classnames\";\nimport React, { useCallback } from \"react\";\n\nimport { useMediaContents } from \"../shared/hooks/useMediaContents.js\";\nimport { BaseSpreadsheetViewer } from \"./BaseSpreadsheetViewer.js\";\nimport { parseSpreadsheetFromResponse } from \"./parseSpreadsheet.js\";\nimport type {\n  ParsedSpreadsheet,\n  SpreadsheetViewerMediaProps,\n} from \"./SpreadsheetViewerApi.js\";\n\nimport styles from \"./BaseSpreadsheetViewer.module.css\";\n\nexport function SpreadsheetViewer({\n  media,\n  className,\n  ...spreadsheetViewerProps\n}: SpreadsheetViewerMediaProps): React.ReactElement {\n  const {\n    data: spreadsheet,\n    loading,\n    error,\n  } = useMediaContents<ParsedSpreadsheet>(\n    media,\n    useCallback(parseSpreadsheetFromResponse, []),\n  );\n\n  const rootClassName = classnames(styles.container, className);\n\n  return (\n    <div className={rootClassName}>\n      {loading && (\n        <div className={styles.loadingContainer}>\n          <Spin className={styles.spinnerIcon} />\n          Loading…\n        </div>\n      )}\n      {error != null && (\n        <div className={styles.errorContainer}>\n          <ErrorIcon className={styles.errorIcon} />\n          Failed to load spreadsheet: {error.message}\n        </div>\n      )}\n      {spreadsheet != null && (\n        <BaseSpreadsheetViewer\n          spreadsheet={spreadsheet}\n          {...spreadsheetViewerProps}\n        />\n      )}\n    </div>\n  );\n}\n"],"mappings":";AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,KAAK,IAAIC,SAAS,EAAEC,IAAI,QAAQ,oBAAoB;AAC7D,OAAOC,UAAU,MAAM,YAAY;AACnC,OAAOC,KAAK,IAAIC,WAAW,QAAQ,OAAO;AAE1C,SAASC,gBAAgB,QAAQ,qCAAqC;AACtE,SAASC,qBAAqB,QAAQ,4BAA4B;AAClE,SAASC,4BAA4B,QAAQ,uBAAuB;AAMpE,OAAOC,MAAM,MAAM,oCAAoC;AAEvD,OAAO,SAASC,iBAAiBA,CAAC;EAChCC,KAAK;EACLC,SAAS;EACT,GAAGC;AACwB,CAAC,EAAsB;EAClD,MAAM;IACJC,IAAI,EAAEC,WAAW;IACjBC,OAAO;IACPC;EACF,CAAC,GAAGX,gBAAgB,CAClBK,KAAK,EACLN,WAAW,CAACG,4BAA4B,EAAE,EAAE,CAC9C,CAAC;EAED,MAAMU,aAAa,GAAGf,UAAU,CAACM,MAAM,CAACU,SAAS,EAAEP,SAAS,CAAC;EAE7D,oBACER,KAAA,CAAAgB,aAAA;IAAKR,SAAS,EAAEM;EAAc,GAC3BF,OAAO,iBACNZ,KAAA,CAAAgB,aAAA;IAAKR,SAAS,EAAEH,MAAM,CAACY;EAAiB,gBACtCjB,KAAA,CAAAgB,aAAA,CAAClB,IAAI;IAACU,SAAS,EAAEH,MAAM,CAACa;EAAY,CAAE,CAAC,iBAEpC,CACN,EACAL,KAAK,IAAI,IAAI,iBACZb,KAAA,CAAAgB,aAAA;IAAKR,SAAS,EAAEH,MAAM,CAACc;EAAe,gBACpCnB,KAAA,CAAAgB,aAAA,CAACnB,SAAS;IAACW,SAAS,EAAEH,MAAM,CAACe;EAAU,CAAE,CAAC,gCACd,EAACP,KAAK,CAACQ,OAChC,CACN,EACAV,WAAW,IAAI,IAAI,iBAClBX,KAAA,CAAAgB,aAAA,CAACb,qBAAqB,EAAAmB,QAAA;IACpBX,WAAW,EAAEA;EAAY,GACrBF,sBAAsB,CAC3B,CAEA,CAAC;AAEV","ignoreList":[]}

package/build/esm/spreadsheet-viewer/SpreadsheetViewerApi.js

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

package/build/esm/spreadsheet-viewer/SpreadsheetViewerApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpreadsheetViewerApi.js","names":[],"sources":["SpreadsheetViewerApi.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 type { Media } from \"@osdk/api\";\n\nexport interface SheetData {\n  /** Sheet name */\n  name: string;\n  /** Rows of cell values as strings */\n  rows: readonly (readonly string[])[];\n}\n\nexport interface ParsedSpreadsheet {\n  /** All sheets in the workbook */\n  sheets: readonly SheetData[];\n}\n\nexport interface BaseSpreadsheetViewerProps {\n  /** Parsed spreadsheet data */\n  spreadsheet: ParsedSpreadsheet;\n  /** Additional CSS class name for the root element\n   * @default undefined */\n  className?: string;\n}\n\nexport interface SpreadsheetViewerMediaProps extends Omit<\n  BaseSpreadsheetViewerProps,\n  \"spreadsheet\"\n> {\n  /** The Media object to fetch spreadsheet contents from */\n  media: Media;\n}\n"],"mappings":"","ignoreList":[]}