@procore/saved-views 6.0.2 → 6.1.0

package/README.md

@@ -134,7 +134,15 @@ const MyDataTableView = () => {
   const savedViewsWrapperRef = useRef<IDataTableSavedViewsRef>(null);
 
   // Panel visibility control
-  const { SavedViewsButton, isOpen: isPanelOpen } = useSavedViewsPanel('your_domain', 'your_table');
+  // `SavedViewsProvider` is required if you want the `SavedViewsButton` label
+  // to display the currently active view name (e.g. "Views: My View"). Wrap
+  // the subtree that contains both the button and the `<DataTableSavedViews>`
+  // / `<SavedViews>` component below.
+  const {
+    SavedViewsButton,
+    SavedViewsProvider,
+    isOpen: isPanelOpen,
+  } = useSavedViewsPanel('your_domain', 'your_table');
 ```
 
 **Key Points**:
@@ -181,6 +189,7 @@ const defaultViewConfig = useMemo(
 
 ```tsx
   return (
+    <SavedViewsProvider>
     <div className="table-with-saved-views">
       <ServerSideDataTable
         columnDefinitions={columnDefinitions}
@@ -227,7 +236,7 @@ const defaultViewConfig = useMemo(
             {/* Top Controls */}
             <div style={{ display: 'flex', justifyContent: 'space-between', marginBottom: '12px' }}>
               <div style={{ display: 'flex', gap: '8px' }}>
-                <SavedViewsButton /> {/* Toggle saved views panel */}
+                <SavedViewsButton /> {/* Toggle saved views panel; shows active view name when wrapped in <SavedViewsProvider> */}
                 <ServerSideDataTable.Search />
                 <ServerSideDataTable.FiltersPanelButton />
               </div>
@@ -253,6 +262,7 @@ const defaultViewConfig = useMemo(
         </div>
       </ServerSideDataTable>
     </div>
+    </SavedViewsProvider>
   );
 };
 ```
@@ -263,6 +273,7 @@ const defaultViewConfig = useMemo(
 2. **API Sharing**: `tableApi={tableApi}` gives saved views control over table state
 3. **Config Sync**: `onTableConfigChange={handleTableConfigChange}` keeps everything in sync
 4. **Layout**: Saved views typically go in a left sidebar with fixed width
+5. **Active view label**: Wrapping the subtree in `<SavedViewsProvider>` lets the toggle button display the currently active view name (e.g. "Views: All RFIs"). The provider is a no-op when omitted, so existing integrations continue to render the plain "Views" label.
 
 ---
 

package/dist/legacy/index.d.mts

@@ -1,6 +1,6 @@
 import { Locale } from '@procore/globalization-toolkit';
 import * as React$1 from 'react';
-import React__default from 'react';
+import React__default, { PropsWithChildren } from 'react';
 import { DataTableConfig, TableApi, ColumnDefinition } from '@procore/data-table';
 import { ColumnState, FilterModel, GridApi } from 'ag-grid-community';
 import * as _procore_core_react_dist_Panel_Panel_types from '@procore/core-react/dist/Panel/Panel.types';
@@ -12,6 +12,7 @@ declare function getTranslations(envLocale: Locale): Record<string, object>;
 declare const useSavedViewsPanel: (domain: string, tableName: string) => {
     isOpen: boolean;
     SavedViewsButton: () => React__default.JSX.Element;
+    SavedViewsProvider: ({ children, }: React__default.PropsWithChildren) => React__default.JSX.Element;
 };
 
 interface IQueryInputProps {
@@ -116,6 +117,13 @@ interface IPanelContentProps {
     onClearTemporary?: () => void;
 }
 
+interface SavedViewsSelectionContextValue {
+    selectedView: ISavedView | null;
+    setSelectedView: (view: ISavedView | null) => void;
+}
+declare const SavedViewsSelectionProvider: ({ children, }: PropsWithChildren) => React__default.JSX.Element;
+declare const useSavedViewsSelection: () => SavedViewsSelectionContextValue | null;
+
 type SavedViewCollectionMenuItemProps = {
     item: ISavedView;
     key?: string;
@@ -189,4 +197,4 @@ interface IDataTableSavedViewsRef {
 }
 declare const DataTableSavedViews: React__default.ForwardRefExoticComponent<IDataTableSavedViewsExternalConsumerProps & React__default.RefAttributes<IDataTableSavedViewsRef>>;
 
-export { DataTableSavedViews, ExpandedPanel, FormModal, type IDataTableDefaultViewConfig, type IDataTableSavedViewsRef, type ISmartGridDefaultViewConfig, PanelContent, SavedViewCollectionMenuItem, SavedViews, SavedViewsDeleteConfirmationModalShared, SmartGridSavedViews, getTranslations, useSavedViewsPanel };
+export { DataTableSavedViews, ExpandedPanel, FormModal, type IDataTableDefaultViewConfig, type IDataTableSavedViewsRef, type ISmartGridDefaultViewConfig, PanelContent, SavedViewCollectionMenuItem, SavedViews, SavedViewsDeleteConfirmationModalShared, type SavedViewsSelectionContextValue, SavedViewsSelectionProvider, SmartGridSavedViews, getTranslations, useSavedViewsPanel, useSavedViewsSelection };

package/dist/legacy/index.d.ts

@@ -1,6 +1,6 @@
 import { Locale } from '@procore/globalization-toolkit';
 import * as React$1 from 'react';
-import React__default from 'react';
+import React__default, { PropsWithChildren } from 'react';
 import { DataTableConfig, TableApi, ColumnDefinition } from '@procore/data-table';
 import { ColumnState, FilterModel, GridApi } from 'ag-grid-community';
 import * as _procore_core_react_dist_Panel_Panel_types from '@procore/core-react/dist/Panel/Panel.types';
@@ -12,6 +12,7 @@ declare function getTranslations(envLocale: Locale): Record<string, object>;
 declare const useSavedViewsPanel: (domain: string, tableName: string) => {
     isOpen: boolean;
     SavedViewsButton: () => React__default.JSX.Element;
+    SavedViewsProvider: ({ children, }: React__default.PropsWithChildren) => React__default.JSX.Element;
 };
 
 interface IQueryInputProps {
@@ -116,6 +117,13 @@ interface IPanelContentProps {
     onClearTemporary?: () => void;
 }
 
+interface SavedViewsSelectionContextValue {
+    selectedView: ISavedView | null;
+    setSelectedView: (view: ISavedView | null) => void;
+}
+declare const SavedViewsSelectionProvider: ({ children, }: PropsWithChildren) => React__default.JSX.Element;
+declare const useSavedViewsSelection: () => SavedViewsSelectionContextValue | null;
+
 type SavedViewCollectionMenuItemProps = {
     item: ISavedView;
     key?: string;
@@ -189,4 +197,4 @@ interface IDataTableSavedViewsRef {
 }
 declare const DataTableSavedViews: React__default.ForwardRefExoticComponent<IDataTableSavedViewsExternalConsumerProps & React__default.RefAttributes<IDataTableSavedViewsRef>>;
 
-export { DataTableSavedViews, ExpandedPanel, FormModal, type IDataTableDefaultViewConfig, type IDataTableSavedViewsRef, type ISmartGridDefaultViewConfig, PanelContent, SavedViewCollectionMenuItem, SavedViews, SavedViewsDeleteConfirmationModalShared, SmartGridSavedViews, getTranslations, useSavedViewsPanel };
+export { DataTableSavedViews, ExpandedPanel, FormModal, type IDataTableDefaultViewConfig, type IDataTableSavedViewsRef, type ISmartGridDefaultViewConfig, PanelContent, SavedViewCollectionMenuItem, SavedViews, SavedViewsDeleteConfirmationModalShared, type SavedViewsSelectionContextValue, SavedViewsSelectionProvider, SmartGridSavedViews, getTranslations, useSavedViewsPanel, useSavedViewsSelection };