@osdk/react-components 0.2.0-beta.21 → 0.2.0-beta.23

package/build/browser/pdf-viewer/hooks/usePdfViewerState.js

@@ -0,0 +1,135 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { useCallback, useEffect, useState } from "react";
+import { MAX_SCALE, MIN_SCALE, SCALE_STEP } from "../constants.js";
+import { usePdfOutline } from "./usePdfOutline.js";
+import { usePdfViewerCore } from "./usePdfViewerCore.js";
+import { usePdfViewerSearch } from "./usePdfViewerSearch.js";
+export function usePdfViewerState({
+  src,
+  initialPage,
+  initialScale,
+  initialSidebarOpen = false,
+  sidebarMode: sidebarModeProp = "thumbnails",
+  onDownload
+}) {
+  const core = usePdfViewerCore({
+    src,
+    initialPage,
+    initialScale
+  });
+  const [rotation, setRotation] = useState(0);
+  const [sidebarOpen, setSidebarOpen] = useState(initialSidebarOpen);
+  const [sidebarMode, setSidebarMode] = useState(sidebarModeProp);
+  const search = usePdfViewerSearch(core.eventBusRef, core.findControllerRef, core.document);
+  const outlineItems = usePdfOutline(core.document);
+
+  // Sync sidebarMode prop changes to state
+  useEffect(function () {
+    setSidebarMode(sidebarModeProp);
+  }, [sidebarModeProp]);
+
+  // Sync rotation → PDFViewer
+  useEffect(function () {
+    const pdfViewer = core.pdfViewerRef.current;
+    if (pdfViewer != null) {
+      pdfViewer.pagesRotation = rotation;
+    }
+  }, [core.pdfViewerRef, rotation]);
+
+  // Ctrl+F keyboard shortcut
+  useEffect(function () {
+    const handleKeyDown = e => {
+      if ((e.ctrlKey || e.metaKey) && e.key === "f") {
+        e.preventDefault();
+        search.openSearch();
+      }
+    };
+    window.addEventListener("keydown", handleKeyDown);
+    return () => {
+      window.removeEventListener("keydown", handleKeyDown);
+    };
+  }, [search.openSearch]);
+  const zoomIn = useCallback(() => {
+    core.setScale(Math.min(core.scale + SCALE_STEP, MAX_SCALE));
+  }, [core.scale, core.setScale]);
+  const zoomOut = useCallback(() => {
+    core.setScale(Math.max(core.scale - SCALE_STEP, MIN_SCALE));
+  }, [core.scale, core.setScale]);
+  const rotateLeft = useCallback(() => {
+    setRotation(prev => (prev - 90 + 360) % 360);
+  }, []);
+  const rotateRight = useCallback(() => {
+    setRotation(prev => (prev + 90) % 360);
+  }, []);
+  const toggleSidebar = useCallback(() => {
+    setSidebarOpen(prev => !prev);
+  }, []);
+  const download = useCallback(filename => {
+    if (core.document == null) {
+      return;
+    }
+    void core.document.getData().then(data => {
+      const blob = new Blob([data.buffer], {
+        type: "application/pdf"
+      });
+      const url = URL.createObjectURL(blob);
+      const resolvedFilename = resolveDownloadFilename(src, filename);
+      const a = globalThis.document.createElement("a");
+      a.href = url;
+      a.download = resolvedFilename;
+      a.click();
+      URL.revokeObjectURL(url);
+      onDownload?.({
+        success: true,
+        filename: resolvedFilename
+      });
+    }).catch(err => {
+      onDownload?.({
+        success: false,
+        error: err instanceof Error ? err : new Error("Failed to download PDF")
+      });
+    });
+  }, [core.document, src, onDownload]);
+  return {
+    ...core,
+    zoomIn,
+    zoomOut,
+    rotation,
+    rotateLeft,
+    rotateRight,
+    sidebarOpen,
+    sidebarMode,
+    setSidebarMode,
+    toggleSidebar,
+    search,
+    outlineItems,
+    download
+  };
+}
+
+/** Derive a download filename from an explicit name, the src URL, or a fallback. */
+function resolveDownloadFilename(src, filename) {
+  if (filename != null) {
+    return filename;
+  }
+  if (typeof src === "string") {
+    return src.split("/").pop()?.split("?")[0] || "document.pdf";
+  }
+  return "document.pdf";
+}
+//# sourceMappingURL=usePdfViewerState.js.map

package/build/browser/pdf-viewer/hooks/usePdfViewerState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePdfViewerState.js","names":["useCallback","useEffect","useState","MAX_SCALE","MIN_SCALE","SCALE_STEP","usePdfOutline","usePdfViewerCore","usePdfViewerSearch","usePdfViewerState","src","initialPage","initialScale","initialSidebarOpen","sidebarMode","sidebarModeProp","onDownload","core","rotation","setRotation","sidebarOpen","setSidebarOpen","setSidebarMode","search","eventBusRef","findControllerRef","document","outlineItems","pdfViewer","pdfViewerRef","current","pagesRotation","handleKeyDown","e","ctrlKey","metaKey","key","preventDefault","openSearch","window","addEventListener","removeEventListener","zoomIn","setScale","Math","min","scale","zoomOut","max","rotateLeft","prev","rotateRight","toggleSidebar","download","filename","getData","then","data","blob","Blob","buffer","type","url","URL","createObjectURL","resolvedFilename","resolveDownloadFilename","a","globalThis","createElement","href","click","revokeObjectURL","success","catch","err","error","Error","split","pop"],"sources":["usePdfViewerState.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 { useCallback, useEffect, useState } from \"react\";\nimport { MAX_SCALE, MIN_SCALE, SCALE_STEP } from \"../constants.js\";\nimport type { PdfDownloadResult, SidebarMode } from \"../types.js\";\nimport { usePdfOutline } from \"./usePdfOutline.js\";\nimport type {\n  UsePdfViewerCoreOptions,\n  UsePdfViewerCoreResult,\n} from \"./usePdfViewerCore.js\";\nimport { usePdfViewerCore } from \"./usePdfViewerCore.js\";\nimport type { UsePdfViewerSearchResult } from \"./usePdfViewerSearch.js\";\nimport { usePdfViewerSearch } from \"./usePdfViewerSearch.js\";\n\nexport interface UsePdfViewerStateOptions extends UsePdfViewerCoreOptions {\n  /** Whether the sidebar is initially open (default false) */\n  initialSidebarOpen?: boolean;\n  /** Which sidebar panel to show (default \"thumbnails\") */\n  sidebarMode?: SidebarMode;\n  /** Callback fired when a download completes or fails */\n  onDownload?: (result: PdfDownloadResult) => void;\n}\n\nexport interface UsePdfViewerStateResult extends UsePdfViewerCoreResult {\n  /** Zoom in by one step */\n  zoomIn: () => void;\n  /** Zoom out by one step */\n  zoomOut: () => void;\n\n  /** Current rotation in degrees (0, 90, 180, 270) */\n  rotation: number;\n  /** Rotate 90 degrees counter-clockwise */\n  rotateLeft: () => void;\n  /** Rotate 90 degrees clockwise */\n  rotateRight: () => void;\n\n  /** Whether the sidebar panel is open */\n  sidebarOpen: boolean;\n  /** Which sidebar panel is active */\n  sidebarMode: SidebarMode;\n  /** Change the active sidebar panel */\n  setSidebarMode: (mode: SidebarMode) => void;\n  /** Toggle sidebar open/closed */\n  toggleSidebar: () => void;\n\n  /** Search state and actions */\n  search: UsePdfViewerSearchResult;\n\n  /** Document outline items (from bookmarks or text extraction) */\n  outlineItems: ReturnType<typeof usePdfOutline>;\n\n  /** Download the PDF as a file */\n  download: (filename?: string) => void;\n}\n\nexport function usePdfViewerState({\n  src,\n  initialPage,\n  initialScale,\n  initialSidebarOpen = false,\n  sidebarMode: sidebarModeProp = \"thumbnails\",\n  onDownload,\n}: UsePdfViewerStateOptions): UsePdfViewerStateResult {\n  const core = usePdfViewerCore({ src, initialPage, initialScale });\n\n  const [rotation, setRotation] = useState(0);\n  const [sidebarOpen, setSidebarOpen] = useState(initialSidebarOpen);\n  const [sidebarMode, setSidebarMode] = useState<SidebarMode>(sidebarModeProp);\n\n  const search = usePdfViewerSearch(\n    core.eventBusRef,\n    core.findControllerRef,\n    core.document,\n  );\n\n  const outlineItems = usePdfOutline(core.document);\n\n  // Sync sidebarMode prop changes to state\n  useEffect(function syncSidebarMode() {\n    setSidebarMode(sidebarModeProp);\n  }, [sidebarModeProp]);\n\n  // Sync rotation → PDFViewer\n  useEffect(function syncRotationToViewer() {\n    const pdfViewer = core.pdfViewerRef.current;\n    if (pdfViewer != null) {\n      pdfViewer.pagesRotation = rotation;\n    }\n  }, [core.pdfViewerRef, rotation]);\n\n  // Ctrl+F keyboard shortcut\n  useEffect(function registerSearchShortcut() {\n    const handleKeyDown = (e: KeyboardEvent) => {\n      if ((e.ctrlKey || e.metaKey) && e.key === \"f\") {\n        e.preventDefault();\n        search.openSearch();\n      }\n    };\n    window.addEventListener(\"keydown\", handleKeyDown);\n    return () => {\n      window.removeEventListener(\"keydown\", handleKeyDown);\n    };\n  }, [search.openSearch]);\n\n  const zoomIn = useCallback(() => {\n    core.setScale(Math.min(core.scale + SCALE_STEP, MAX_SCALE));\n  }, [core.scale, core.setScale]);\n\n  const zoomOut = useCallback(() => {\n    core.setScale(Math.max(core.scale - SCALE_STEP, MIN_SCALE));\n  }, [core.scale, core.setScale]);\n\n  const rotateLeft = useCallback(() => {\n    setRotation((prev) => (prev - 90 + 360) % 360);\n  }, []);\n\n  const rotateRight = useCallback(() => {\n    setRotation((prev) => (prev + 90) % 360);\n  }, []);\n\n  const toggleSidebar = useCallback(() => {\n    setSidebarOpen((prev) => !prev);\n  }, []);\n\n  const download = useCallback((filename?: string) => {\n    if (core.document == null) {\n      return;\n    }\n    void core.document.getData().then((data) => {\n      const blob = new Blob([data.buffer as ArrayBuffer], {\n        type: \"application/pdf\",\n      });\n      const url = URL.createObjectURL(blob);\n      const resolvedFilename = resolveDownloadFilename(src, filename);\n      const a = globalThis.document.createElement(\"a\");\n      a.href = url;\n      a.download = resolvedFilename;\n      a.click();\n      URL.revokeObjectURL(url);\n      onDownload?.({ success: true, filename: resolvedFilename });\n    }).catch((err: unknown) => {\n      onDownload?.({\n        success: false,\n        error: err instanceof Error\n          ? err\n          : new Error(\"Failed to download PDF\"),\n      });\n    });\n  }, [core.document, src, onDownload]);\n\n  return {\n    ...core,\n    zoomIn,\n    zoomOut,\n    rotation,\n    rotateLeft,\n    rotateRight,\n    sidebarOpen,\n    sidebarMode,\n    setSidebarMode,\n    toggleSidebar,\n    search,\n    outlineItems,\n    download,\n  };\n}\n\n/** Derive a download filename from an explicit name, the src URL, or a fallback. */\nfunction resolveDownloadFilename(\n  src: string | ArrayBuffer,\n  filename: string | undefined,\n): string {\n  if (filename != null) {\n    return filename;\n  }\n  if (typeof src === \"string\") {\n    return src.split(\"/\").pop()?.split(\"?\")[0] || \"document.pdf\";\n  }\n  return \"document.pdf\";\n}\n"],"mappings":"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","ignoreList":[]}

package/build/browser/pdf-viewer/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","names":[],"sources":["types.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/** The visual style of an annotation rendered on the PDF. */\nexport type AnnotationType = \"highlight\" | \"underline\" | \"comment\" | \"pin\";\n\n/** A single annotation positioned on a specific page of the PDF. */\nexport interface PdfAnnotation {\n  /** Unique identifier for this annotation */\n  id: string;\n  /** The type of annotation to render */\n  type: AnnotationType;\n  /** Page number (1-indexed) */\n  page: number;\n  /** Coordinates in PDF points (origin: bottom-left of page) */\n  rect: { x: number; y: number; width: number; height: number };\n  /** Optional label or tooltip text */\n  label?: string;\n  /** Optional color override (CSS color string) */\n  color?: string;\n}\n\n/** Props for the {@link PdfViewer} component. */\nexport interface PdfViewerProps {\n  /** PDF source — URL string or ArrayBuffer */\n  src: string | ArrayBuffer;\n  /** Annotations to overlay on the PDF, keyed by page number (1-indexed) */\n  annotations?: Record<number, PdfAnnotation[]>;\n  /**\n   * Callback fired when an annotation is clicked.\n   *\n   * @param annotation - The annotation that was clicked\n   * @returns void\n   */\n  onAnnotationClick?: (annotation: PdfAnnotation) => void;\n  /** Initial page number (1-indexed, default 1) */\n  initialPage?: number;\n  /** Initial zoom scale (default 1.0) */\n  initialScale?: number;\n  /** Whether the sidebar is initially open (default false) */\n  initialSidebarOpen?: boolean;\n  /** Additional CSS class name for the root element */\n  className?: string;\n}\n"],"mappings":"","ignoreList":[]}
+{"version":3,"file":"types.js","names":[],"sources":["types.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 React from \"react\";\n\n/** Which sidebar panel to display when the sidebar is open. */\nexport type SidebarMode = \"thumbnails\" | \"outline\";\n\n/** A single item in the PDF document outline (table of contents). */\nexport interface OutlineItem {\n  title: string;\n  depth: number;\n  pageNumber: number;\n  bold: boolean;\n  italic: boolean;\n}\n\n/** The visual style of an annotation rendered on the PDF. */\nexport type AnnotationType = \"highlight\" | \"underline\" | \"comment\" | \"pin\";\n\n/** A single annotation positioned on a specific page of the PDF. */\nexport interface PdfAnnotation {\n  /** Unique identifier for this annotation */\n  id: string;\n  /** The type of annotation to render */\n  type: AnnotationType;\n  /** Page number (1-indexed) */\n  page: number;\n  /** Coordinates in PDF points (origin: bottom-left of page) */\n  rect: { x: number; y: number; width: number; height: number };\n  /** Optional label or tooltip text */\n  label?: string;\n  /** Optional color override (CSS color string) */\n  color?: string;\n}\n\n/** Result passed to the {@link PdfViewerProps.onDownload} callback. */\nexport type PdfDownloadResult =\n  | { success: true; filename: string }\n  | { success: false; error: Error };\n\n/** Props for the {@link PdfViewer} component. */\nexport interface PdfViewerProps {\n  /** PDF source — URL string or ArrayBuffer */\n  src: string | ArrayBuffer;\n  /** Annotations to overlay on the PDF, keyed by page number (1-indexed) */\n  annotations?: Record<number, PdfAnnotation[]>;\n  /**\n   * Callback fired when an annotation is clicked.\n   *\n   * @param annotation - The annotation that was clicked\n   * @returns void\n   */\n  onAnnotationClick?: (annotation: PdfAnnotation) => void;\n  /**\n   * Callback fired when a download completes or fails.\n   *\n   * @param result - The download result indicating success with the filename, or failure with an error\n   * @returns void\n   */\n  onDownload?: (result: PdfDownloadResult) => void;\n  /** Initial page number (1-indexed, default 1) */\n  initialPage?: number;\n  /** Initial zoom scale (default 1.0) */\n  initialScale?: number;\n  /** Whether the sidebar is initially open (default false) */\n  initialSidebarOpen?: boolean;\n  /**\n   * Whether the download button is shown in the toolbar.\n   * @default false\n   */\n  enableDownload?: boolean;\n  /**\n   * Which sidebar panel to show: thumbnails or document outline.\n   * @default \"thumbnails\"\n   */\n  sidebarMode?: SidebarMode;\n  /**\n   * Custom icon components for each outline depth level (0-indexed).\n   * Key 0 = top-level items, 1 = first nesting level, etc.\n   * If omitted, no icons are rendered.\n   */\n  outlineIcons?: Partial<Record<number, React.ComponentType>>;\n  /** Additional CSS class name for the root element */\n  className?: string;\n}\n"],"mappings":"","ignoreList":[]}

package/build/browser/public/experimental.js

@@ -27,6 +27,27 @@ export { BaseTable } from "../object-table/Table.js";
 export { ColumnConfigDialog } from "../object-table/ColumnConfigDialog.js";
 // PdfViewer
 export { BasePdfViewer } from "../pdf-viewer/PdfViewer.js";
-// PdfRenderer
-export { PdfRenderer } from "../pdf-viewer/PdfRenderer.js";
+// PdfViewer building blocks
+export { PdfViewerAnnotationLayer } from "../pdf-viewer/components/PdfViewerAnnotationLayer.js";
+export { PdfViewerContent } from "../pdf-viewer/components/PdfViewerContent.js";
+export { PdfViewerOutlineSidebar } from "../pdf-viewer/components/PdfViewerOutlineSidebar.js";
+export { PdfViewerSearchBar } from "../pdf-viewer/components/PdfViewerSearchBar.js";
+export { PdfViewerSidebar } from "../pdf-viewer/components/PdfViewerSidebar.js";
+export { PdfViewerToolbar } from "../pdf-viewer/components/PdfViewerToolbar.js";
+
+// PdfViewer hooks — primitive
+export { usePdfAnnotationPortals } from "../pdf-viewer/hooks/usePdfAnnotationPortals.js";
+export { usePdfDocument } from "../pdf-viewer/hooks/usePdfDocument.js";
+export { usePdfOutline } from "../pdf-viewer/hooks/usePdfOutline.js";
+export { usePdfViewer } from "../pdf-viewer/hooks/usePdfViewer.js";
+export { usePdfViewerSearch } from "../pdf-viewer/hooks/usePdfViewerSearch.js";
+export { usePdfViewerSync } from "../pdf-viewer/hooks/usePdfViewerSync.js";
+// PdfViewer hooks — composition
+export { usePdfViewerCore } from "../pdf-viewer/hooks/usePdfViewerCore.js";
+export { usePdfViewerState } from "../pdf-viewer/hooks/usePdfViewerState.js";
+
+// PdfViewer (Media wrapper)
+export { PdfViewer } from "../pdf-viewer/PdfRenderer.js";
+export { ActionForm } from "../action-form/ActionForm.js";
+export { BaseForm } from "../action-form/BaseForm.js";
 //# sourceMappingURL=experimental.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"experimental.js","names":["BaseFilterList","FilterList","deserializeFilterStates","serializeFilterStates","ObjectTable","BaseTable","ColumnConfigDialog","BasePdfViewer","PdfRenderer"],"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 { BaseFilterList } from \"../filter-list/base/BaseFilterList.js\";\nexport type {\n  BaseFilterListProps,\n  RenderFilterInput,\n} from \"../filter-list/base/BaseFilterListApi.js\";\nexport { FilterList } from \"../filter-list/FilterList.js\";\n\nexport type {\n  FilterDefinitionUnion,\n  FilterListProps,\n} from \"../filter-list/FilterListApi.js\";\nexport type {\n  FilterComponentType,\n  FilterListItemProps,\n  FilterState,\n  PropertyFilterDefinition,\n} from \"../filter-list/FilterListItemApi.js\";\nexport {\n  deserializeFilterStates,\n  serializeFilterStates,\n} from \"../filter-list/utils/filterStateSerialization.js\";\n\n// ObjectTable that loads and displays data for a given objectSet\nexport { ObjectTable } from \"../object-table/ObjectTable.js\";\nexport type {\n  ColumnDefinition,\n  ColumnDefinitionLocator,\n  CustomColumnLocator,\n  FunctionColumnLocator,\n  ObjectTableProps,\n  PropertyColumnLocator,\n  RdpColumnLocator,\n} from \"../object-table/ObjectTableApi.js\";\nexport type { CellEditInfo } from \"../object-table/utils/types.js\";\n\n// BaseTable that does not handle data fetching\nexport type { BaseTableProps } from \"../object-table/Table.js\";\nexport { BaseTable } from \"../object-table/Table.js\";\n\nexport { ColumnConfigDialog } from \"../object-table/ColumnConfigDialog.js\";\nexport type {\n  ColumnConfigDialogProps,\n  ColumnConfigOptions,\n} from \"../object-table/ColumnConfigDialog.js\";\n\n// PdfViewer\nexport { BasePdfViewer } from \"../pdf-viewer/PdfViewer.js\";\nexport type {\n  AnnotationType,\n  PdfAnnotation,\n  PdfViewerProps,\n} from \"../pdf-viewer/types.js\";\n\n// PdfRenderer\nexport {\n  PdfRenderer,\n  type PdfRendererProps,\n} from \"../pdf-viewer/PdfRenderer.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,cAAc,QAAQ,uCAAuC;AAKtE,SAASC,UAAU,QAAQ,8BAA8B;AAYzD,SACEC,uBAAuB,EACvBC,qBAAqB,QAChB,kDAAkD;;AAEzD;AACA,SAASC,WAAW,QAAQ,gCAAgC;;AAY5D;;AAEA,SAASC,SAAS,QAAQ,0BAA0B;AAEpD,SAASC,kBAAkB,QAAQ,uCAAuC;AAM1E;AACA,SAASC,aAAa,QAAQ,4BAA4B;AAO1D;AACA,SACEC,WAAW,QAEN,8BAA8B","ignoreList":[]}
+{"version":3,"file":"experimental.js","names":["BaseFilterList","FilterList","deserializeFilterStates","serializeFilterStates","ObjectTable","BaseTable","ColumnConfigDialog","BasePdfViewer","PdfViewerAnnotationLayer","PdfViewerContent","PdfViewerOutlineSidebar","PdfViewerSearchBar","PdfViewerSidebar","PdfViewerToolbar","usePdfAnnotationPortals","usePdfDocument","usePdfOutline","usePdfViewer","usePdfViewerSearch","usePdfViewerSync","usePdfViewerCore","usePdfViewerState","PdfViewer","ActionForm","BaseForm"],"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 { BaseFilterList } from \"../filter-list/base/BaseFilterList.js\";\nexport type {\n  BaseFilterListProps,\n  RenderFilterInput,\n} from \"../filter-list/base/BaseFilterListApi.js\";\nexport { FilterList } from \"../filter-list/FilterList.js\";\n\nexport type {\n  FilterDefinitionUnion,\n  FilterListProps,\n} from \"../filter-list/FilterListApi.js\";\nexport type {\n  FilterComponentType,\n  FilterListItemProps,\n  FilterState,\n  PropertyFilterDefinition,\n} from \"../filter-list/FilterListItemApi.js\";\nexport {\n  deserializeFilterStates,\n  serializeFilterStates,\n} from \"../filter-list/utils/filterStateSerialization.js\";\n\n// ObjectTable that loads and displays data for a given objectSet\nexport { ObjectTable } from \"../object-table/ObjectTable.js\";\nexport type {\n  ColumnDefinition,\n  ColumnDefinitionLocator,\n  CustomColumnLocator,\n  FunctionColumnLocator,\n  ObjectTableProps,\n  PropertyColumnLocator,\n  RdpColumnLocator,\n} from \"../object-table/ObjectTableApi.js\";\nexport type { CellEditInfo } from \"../object-table/utils/types.js\";\n\n// BaseTable that does not handle data fetching\nexport type { BaseTableProps } from \"../object-table/Table.js\";\nexport { BaseTable } from \"../object-table/Table.js\";\n\nexport { ColumnConfigDialog } from \"../object-table/ColumnConfigDialog.js\";\nexport type {\n  ColumnConfigDialogProps,\n  ColumnConfigOptions,\n} from \"../object-table/ColumnConfigDialog.js\";\n\n// PdfViewer\nexport { BasePdfViewer } from \"../pdf-viewer/PdfViewer.js\";\nexport type {\n  AnnotationType,\n  PdfAnnotation,\n  PdfDownloadResult,\n  PdfViewerProps,\n  SidebarMode,\n} from \"../pdf-viewer/types.js\";\n\n// PdfViewer building blocks\nexport {\n  PdfViewerAnnotationLayer,\n  type PdfViewerAnnotationLayerProps,\n} from \"../pdf-viewer/components/PdfViewerAnnotationLayer.js\";\nexport {\n  PdfViewerContent,\n  type PdfViewerContentProps,\n} from \"../pdf-viewer/components/PdfViewerContent.js\";\nexport {\n  PdfViewerOutlineSidebar,\n  type PdfViewerOutlineSidebarProps,\n} from \"../pdf-viewer/components/PdfViewerOutlineSidebar.js\";\nexport {\n  PdfViewerSearchBar,\n  type PdfViewerSearchBarProps,\n} from \"../pdf-viewer/components/PdfViewerSearchBar.js\";\nexport {\n  PdfViewerSidebar,\n  type PdfViewerSidebarProps,\n} from \"../pdf-viewer/components/PdfViewerSidebar.js\";\nexport {\n  PdfViewerToolbar,\n  type PdfViewerToolbarProps,\n} from \"../pdf-viewer/components/PdfViewerToolbar.js\";\n\n// PdfViewer hooks — primitive\nexport {\n  type AnnotationPortalTarget,\n  usePdfAnnotationPortals,\n} from \"../pdf-viewer/hooks/usePdfAnnotationPortals.js\";\nexport { usePdfDocument } from \"../pdf-viewer/hooks/usePdfDocument.js\";\nexport { usePdfOutline } from \"../pdf-viewer/hooks/usePdfOutline.js\";\nexport {\n  usePdfViewer,\n  type UsePdfViewerResult,\n} from \"../pdf-viewer/hooks/usePdfViewer.js\";\nexport {\n  usePdfViewerSearch,\n  type UsePdfViewerSearchResult,\n} from \"../pdf-viewer/hooks/usePdfViewerSearch.js\";\nexport { usePdfViewerSync } from \"../pdf-viewer/hooks/usePdfViewerSync.js\";\nexport { type OutlineItem } from \"../pdf-viewer/types.js\";\n\n// PdfViewer hooks — composition\nexport {\n  usePdfViewerCore,\n  type UsePdfViewerCoreOptions,\n  type UsePdfViewerCoreResult,\n} from \"../pdf-viewer/hooks/usePdfViewerCore.js\";\nexport {\n  usePdfViewerState,\n  type UsePdfViewerStateOptions,\n  type UsePdfViewerStateResult,\n} from \"../pdf-viewer/hooks/usePdfViewerState.js\";\n\n// PdfViewer (Media wrapper)\nexport {\n  PdfViewer,\n  type PdfViewerMediaProps,\n} from \"../pdf-viewer/PdfRenderer.js\";\n\nexport { ActionForm } from \"../action-form/ActionForm.js\";\nexport type {\n  ActionFormProps,\n  BaseFormProps,\n  FormError,\n  FormState,\n} from \"../action-form/ActionFormApi.js\";\nexport { BaseForm } from \"../action-form/BaseForm.js\";\nexport type {\n  ActionParameters,\n  BaseFormFieldProps,\n  CustomFieldProps,\n  DatetimePickerFieldProps,\n  DropdownFieldProps,\n  FieldComponent,\n  FieldValueType,\n  FilePickerProps,\n  FormFieldDefinition,\n  FormFieldPropsByType,\n  NumberInputFieldProps,\n  ObjectSetFieldProps,\n  Option,\n  RadioButtonsFieldProps,\n  RendererFieldDefinition,\n  TextAreaFieldProps,\n  TextInputFieldProps,\n} from \"../action-form/FormFieldApi.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,cAAc,QAAQ,uCAAuC;AAKtE,SAASC,UAAU,QAAQ,8BAA8B;AAYzD,SACEC,uBAAuB,EACvBC,qBAAqB,QAChB,kDAAkD;;AAEzD;AACA,SAASC,WAAW,QAAQ,gCAAgC;;AAY5D;;AAEA,SAASC,SAAS,QAAQ,0BAA0B;AAEpD,SAASC,kBAAkB,QAAQ,uCAAuC;AAM1E;AACA,SAASC,aAAa,QAAQ,4BAA4B;AAS1D;AACA,SACEC,wBAAwB,QAEnB,sDAAsD;AAC7D,SACEC,gBAAgB,QAEX,8CAA8C;AACrD,SACEC,uBAAuB,QAElB,qDAAqD;AAC5D,SACEC,kBAAkB,QAEb,gDAAgD;AACvD,SACEC,gBAAgB,QAEX,8CAA8C;AACrD,SACEC,gBAAgB,QAEX,8CAA8C;;AAErD;AACA,SAEEC,uBAAuB,QAClB,gDAAgD;AACvD,SAASC,cAAc,QAAQ,uCAAuC;AACtE,SAASC,aAAa,QAAQ,sCAAsC;AACpE,SACEC,YAAY,QAEP,qCAAqC;AAC5C,SACEC,kBAAkB,QAEb,2CAA2C;AAClD,SAASC,gBAAgB,QAAQ,yCAAyC;AAG1E;AACA,SACEC,gBAAgB,QAGX,yCAAyC;AAChD,SACEC,iBAAiB,QAGZ,0CAA0C;;AAEjD;AACA,SACEC,SAAS,QAEJ,8BAA8B;AAErC,SAASC,UAAU,QAAQ,8BAA8B;AAOzD,SAASC,QAAQ,QAAQ,4BAA4B","ignoreList":[]}

package/build/browser/public/primitives.js

@@ -0,0 +1,20 @@
+/*
+ * Copyright 2026 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+export { ActionButton } from "../base-components/action-button/ActionButton.js";
+export { Dialog } from "../base-components/dialog/Dialog.js";
+export { Tooltip, TooltipArrow } from "../base-components/tooltip/index.js";
+//# sourceMappingURL=primitives.js.map

package/build/browser/public/primitives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.js","names":["ActionButton","Dialog","Tooltip","TooltipArrow"],"sources":["primitives.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\nexport {\n  ActionButton,\n  type ButtonProps,\n} from \"../base-components/action-button/ActionButton.js\";\nexport { Dialog, type DialogProps } from \"../base-components/dialog/Dialog.js\";\nexport {\n  Tooltip,\n  TooltipArrow,\n  type TooltipProps,\n} from \"../base-components/tooltip/index.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SACEA,YAAY,QAEP,kDAAkD;AACzD,SAASC,MAAM,QAA0B,qCAAqC;AAC9E,SACEC,OAAO,EACPC,YAAY,QAEP,qCAAqC","ignoreList":[]}

package/build/browser/{filter-list/base/inputs → shared}/dateUtils.js

@@ -29,25 +29,61 @@
  */
 
 export function formatDateForInput(date) {
-  if (!date) return "";
+  if (date == null) return "";
   const year = date.getFullYear();
   const month = String(date.getMonth() + 1).padStart(2, "0");
   const day = String(date.getDate()).padStart(2, "0");
   return `${year}-${month}-${day}`;
 }
+
+/** Formats the time portion of a Date as "HH:mm". */
+export function formatTime(date) {
+  const hours = String(date.getHours()).padStart(2, "0");
+  const minutes = String(date.getMinutes()).padStart(2, "0");
+  return `${hours}:${minutes}`;
+}
 export function parseDateFromInput(value) {
   if (!value) return undefined;
   const date = new Date(value + "T00:00:00");
   return isNaN(date.getTime()) ? undefined : date;
 }
+export function formatDatetimeForInput(date) {
+  if (date == null) return "";
+  return `${formatDateForInput(date)}T${formatTime(date)}`;
+}
+
+/**
+ * Parses a datetime-local input string (e.g. "2024-01-15T14:30") into a Date.
+ * Delegates to `parseDateFromISO` since the parsing logic is identical for
+ * string inputs — datetime-local strings already include the time component
+ * and have no "Z" suffix, so `new Date()` parses them as local time.
+ */
+export function parseDatetimeFromInput(value) {
+  if (!value) return undefined;
+  return parseDateFromISO(value);
+}
 export function formatDateForDisplay(date, fallback = "") {
-  if (!date) return fallback;
+  if (date == null) return fallback;
   return date.toLocaleDateString(undefined, {
     year: "numeric",
     month: "short",
     day: "numeric"
   });
 }
+
+/** Formats a Date as "2024-06-15 14:30" — space-separated, more readable than T. */
+export function formatDatetimeForDisplay(date) {
+  if (date == null) return "";
+  return `${formatDateForInput(date)} ${formatTime(date)}`;
+}
+
+/** Parses space-separated ("2024-06-15 14:30") or T-separated datetime strings. */
+export function parseDatetimeFromDisplay(value) {
+  if (!value) return undefined;
+  const normalized = value.includes("T") ? value : value.replace(" ", "T");
+  const date = new Date(normalized);
+  return isNaN(date.getTime()) ? undefined : date;
+}
 export function parseDateFromISO(value) {
   if (value == null) return undefined;
   if (value instanceof Date) return value;

package/build/browser/shared/dateUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dateUtils.js","names":["formatDateForInput","date","year","getFullYear","month","String","getMonth","padStart","day","getDate","formatTime","hours","getHours","minutes","getMinutes","parseDateFromInput","value","undefined","Date","isNaN","getTime","formatDatetimeForInput","parseDatetimeFromInput","parseDateFromISO","formatDateForDisplay","fallback","toLocaleDateString","formatDatetimeForDisplay","parseDatetimeFromDisplay","normalized","includes","replace"],"sources":["dateUtils.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * Date utilities for HTML date inputs.\n *\n * These functions operate on local time by design. HTML <input type=\"date\">\n * returns and expects values in \"YYYY-MM-DD\" format without timezone info.\n *\n * `parseDateFromInput` appends \"T00:00:00\" (no \"Z\") so the date is parsed as\n * local midnight rather than UTC midnight. Without this, negative-offset\n * timezones (e.g. US timezones) would shift \"2024-01-15\" to Jan 14 locally.\n *\n * Consumers providing dates from an API (typically UTC) should handle\n * UTC-to-local conversion before passing values to these functions.\n */\n\nexport function formatDateForInput(date: Date | undefined | null): string {\n  if (date == null) return \"\";\n  const year = date.getFullYear();\n  const month = String(date.getMonth() + 1).padStart(2, \"0\");\n  const day = String(date.getDate()).padStart(2, \"0\");\n  return `${year}-${month}-${day}`;\n}\n\n/** Formats the time portion of a Date as \"HH:mm\". */\nexport function formatTime(date: Date): string {\n  const hours = String(date.getHours()).padStart(2, \"0\");\n  const minutes = String(date.getMinutes()).padStart(2, \"0\");\n  return `${hours}:${minutes}`;\n}\n\nexport function parseDateFromInput(\n  value: string | undefined | null,\n): Date | undefined {\n  if (!value) return undefined;\n  const date = new Date(value + \"T00:00:00\");\n  return isNaN(date.getTime()) ? undefined : date;\n}\n\nexport function formatDatetimeForInput(\n  date: Date | undefined | null,\n): string {\n  if (date == null) return \"\";\n  return `${formatDateForInput(date)}T${formatTime(date)}`;\n}\n\n/**\n * Parses a datetime-local input string (e.g. \"2024-01-15T14:30\") into a Date.\n * Delegates to `parseDateFromISO` since the parsing logic is identical for\n * string inputs — datetime-local strings already include the time component\n * and have no \"Z\" suffix, so `new Date()` parses them as local time.\n */\nexport function parseDatetimeFromInput(\n  value: string | undefined | null,\n): Date | undefined {\n  if (!value) return undefined;\n  return parseDateFromISO(value);\n}\n\nexport function formatDateForDisplay(\n  date: Date | undefined | null,\n  fallback: string = \"\",\n): string {\n  if (date == null) return fallback;\n  return date.toLocaleDateString(undefined, {\n    year: \"numeric\",\n    month: \"short\",\n    day: \"numeric\",\n  });\n}\n\n/** Formats a Date as \"2024-06-15 14:30\" — space-separated, more readable than T. */\nexport function formatDatetimeForDisplay(\n  date: Date | undefined | null,\n): string {\n  if (date == null) return \"\";\n  return `${formatDateForInput(date)} ${formatTime(date)}`;\n}\n\n/** Parses space-separated (\"2024-06-15 14:30\") or T-separated datetime strings. */\nexport function parseDatetimeFromDisplay(\n  value: string | undefined | null,\n): Date | undefined {\n  if (!value) return undefined;\n  const normalized = value.includes(\"T\") ? value : value.replace(\" \", \"T\");\n  const date = new Date(normalized);\n  return isNaN(date.getTime()) ? undefined : date;\n}\n\nexport function parseDateFromISO(\n  value: string | Date | undefined | null,\n): Date | undefined {\n  if (value == null) return undefined;\n  if (value instanceof Date) return value;\n  const date = new Date(value);\n  return isNaN(date.getTime()) ? undefined : date;\n}\n"],"mappings":"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","ignoreList":[]}