@powerportalspro/react-fluent 6.0.0 → 7.0.0

package/dist/index.d.cts

@@ -2010,6 +2010,15 @@ interface ThemeContextValue {
      * option list.
      */
     readonly availableAccents: readonly AccentColor[];
+    /**
+     * Whether the site fixes its accent color via
+     * `<PowerPortalsProThemeProvider lockAccentColor>`. When `true`,
+     * {@link setAccentColor} is a no-op, any persisted preference is
+     * ignored in favour of the configured accent, and
+     * `<ThemeColorSelector>` renders nothing. Read it before offering
+     * any accent-changing UI of your own.
+     */
+    readonly accentColorLocked: boolean;
     /**
      * Each accent's representative brand-fill color (hex). Drives the
      * color swatch rendered next to each option in
@@ -2061,6 +2070,21 @@ interface PowerPortalsProThemeProviderProps {
      * is set. Defaults to `'ltr'`.
      */
     defaultTextDirection?: TextDirection;
+    /**
+     * Fixes the site's accent color to `defaultAccentColor`. Without
+     * it, that prop is only a *default*: a visitor who once picked an
+     * accent keeps it forever, because the persisted preference wins.
+     * With it, the configured accent always wins, the persisted value
+     * is rewritten to match, `setAccentColor` becomes a no-op, and
+     * `<ThemeColorSelector>` (and therefore the accent section of
+     * `<SiteSettingsPanel>`) renders nothing. Light/dark mode stays
+     * under the visitor's control either way.
+     *
+     * Pair it with a `customAccents` entry at the `'default'` key to
+     * lock the site to your own brand rather than one of the built-in
+     * Office accents.
+     */
+    lockAccentColor?: boolean;
     /**
      * Consumer-supplied custom accents, layered ON TOP of the built-in
      * Office-brand palette (`'default'`, `'teams'`, `'excel'`, `'word'`,
@@ -2132,7 +2156,7 @@ interface PowerPortalsProThemeProviderProps {
  * </PowerPortalsProThemeProvider>
  * ```
  */
-declare function PowerPortalsProThemeProvider({ children, defaultMode, defaultAccentColor, defaultTextDirection, customAccents, storageKey, style, fluentProviderProps, }: PowerPortalsProThemeProviderProps): react_jsx_runtime.JSX.Element;
+declare function PowerPortalsProThemeProvider({ children, defaultMode, defaultAccentColor, defaultTextDirection, lockAccentColor, customAccents, storageKey, style, fluentProviderProps, }: PowerPortalsProThemeProviderProps): react_jsx_runtime.JSX.Element;
 
 interface ThemeSelectorProps {
     /** Disable the control. Useful when displaying the user's read-only preference. */
@@ -2196,8 +2220,12 @@ interface ThemeColorSelectorProps {
  * `app.components.theme-color-selector.accent.<key>`. Missing keys
  * fall back to the accent's raw string (so an unlocalized custom
  * accent like `'forest'` shows as `"forest"` rather than blank).
+ *
+ * Renders nothing when the site fixes its accent via
+ * `<PowerPortalsProThemeProvider lockAccentColor>` — a picker whose
+ * choice is discarded is worse than no picker.
  */
-declare function ThemeColorSelector({ readOnly, label, width, accentLabels, }: ThemeColorSelectorProps): react_jsx_runtime.JSX.Element;
+declare function ThemeColorSelector({ readOnly, label, width, accentLabels, }: ThemeColorSelectorProps): react_jsx_runtime.JSX.Element | null;
 
 /**
  * Canonical accent definition. One entry per visually-distinct brand
@@ -2440,6 +2468,69 @@ interface ProfileMainMenuProps {
  */
 declare function ProfileMainMenu({ accountUrl, accountLabel, headerSlot, footerSlot, anonymousContent, signInUrl, }: ProfileMainMenuProps): react_jsx_runtime.JSX.Element;
 
+/** Props for {@link ImpersonationBanner}. */
+interface ImpersonationBannerProps {
+    /**
+     * Where to send the browser after impersonation ends. Defaults to `'/'`.
+     *
+     * A full navigation rather than a client-side route change, because ending impersonation
+     * swaps the auth cookie — every mounted component is now rendering for a different user, and
+     * anything that captured the old principal at mount time would keep showing it.
+     */
+    returnUrl?: string;
+    /** Extra class applied to the banner element. */
+    className?: string;
+}
+/**
+ * Persistent banner shown while an internal user is operating the portal as one of its contacts.
+ * Renders nothing for an ordinary session, so it is safe — and intended — to mount
+ * unconditionally; {@link PageLayout} already does.
+ *
+ * That unconditional mounting is the point. A banner a host can forget to render defeats its own
+ * purpose: the reason it exists is that an administrator must not be able to forget the portal is
+ * answering as somebody else.
+ *
+ * Built on Fluent's own `MessageBar` with `intent="error"` rather than a hand-painted bar, so the
+ * library owns the surface, the intent colour and the icon — and the Stop button is a stock
+ * `Button` on a surface Fluent itself themed. An earlier version painted its own red background
+ * and then had to override the button's colours to stay readable on it, which is what put this
+ * component in the business of fighting the design-token system. Letting the library own the
+ * surface removes that whole class of problem: there is no colour styling left here at all.
+ * Mirrors the Blazor banner, which is built on `FluentMessageBar` for the same reason.
+ *
+ * Reads `auth.user.isImpersonating` from `useAuth()`, so the app must be wrapped in
+ * `<PowerPortalsProProvider>`.
+ */
+declare function ImpersonationBanner({ returnUrl, className, }: ImpersonationBannerProps): react_jsx_runtime.JSX.Element | null;
+
+/** Props for {@link ImpersonationPickerDialog}. */
+interface ImpersonationPickerDialogProps {
+    /** Whether the dialog is open. */
+    open: boolean;
+    /** Called when the dialog should close — Cancel, dismiss, or Escape. */
+    onClose: () => void;
+    /**
+     * Where to send the browser once impersonation starts. Defaults to `'/'`.
+     *
+     * A full navigation, because the auth cookie has changed: every mounted component is now
+     * rendering for a different user, and anything that captured the old principal at mount time
+     * would keep showing it.
+     */
+    returnUrl?: string;
+    /** Extra class applied to the dialog surface. */
+    className?: string;
+}
+/**
+ * Modal picker for choosing the contact an internal administrator wants to view the portal as.
+ * Typing searches by name, email address, or exact user id; confirming starts impersonation and
+ * reloads the app as that user.
+ *
+ * Presentation only. Every decision about who may impersonate and who may be impersonated is made
+ * server-side — this component cannot widen either, and the endpoint re-checks both regardless of
+ * what the UI offered.
+ */
+declare function ImpersonationPickerDialog({ open, onClose, returnUrl, className, }: ImpersonationPickerDialogProps): react_jsx_runtime.JSX.Element;
+
 interface SiteSettingsButtonProps {
     /**
      * When `true` (default), the panel renders the language dropdown.
@@ -4635,7 +4726,11 @@ interface MainGridProps {
      * Set to `'virtualize'` for infinite-scroll — the pager footer is
      * hidden, rows accumulate across page boundaries, and the next page
      * fetches automatically when the user scrolls past the rendered
-     * bottom.
+     * bottom. Pages are requested sequentially with the previous page's
+     * Dataverse paging cookie (cursor paging), and loading stops when the
+     * server reports no more records — not when the accumulated rows reach
+     * the total count, which can never happen if per-row permission
+     * handlers drop rows after Dataverse has counted them.
      */
     pagingMode?: PagingMode;
     /**
@@ -6337,4 +6432,4 @@ declare function useFluentChartPalette(scopeRef: RefObject<HTMLElement | null>):
 
 declare const VERSION = "0.1.0";
 
-export { type AccentColor, type AccentThemePair, type BaseCellRendererProps, type BaseColumnEditProps, Body, type BodyProps, BoolEdit, type BoolEditProps, BoolEditorType, CacheAdmin, type CacheAdminProps, type CellRendererType, ChoiceEdit, type ChoiceEditProps, ChoiceEditorType, ChoiceInvalidValueBehavior, type ChoiceMetadataView, type ChoiceOption, ChoiceOrientation, ChoiceValueSort, ColumnDisplayValue, type ColumnDisplayValueProps, ColumnEdit, type CropAspect, type CropResult, type CustomViewDefinition, DataverseChart, type DataverseChartHandle, type DataverseChartProps, DateTimeEdit, type DateTimeEditProps, DateTimeEditorType, DeleteContextButton, type DeleteContextButtonProps, DeleteRecordGridButton, type DeleteRecordGridButtonProps, DescriptionLocation, type DialogLocation, type FileColumnValue, FileEdit, type FileEditProps, FileGrid, type FileGridProps, type FileSource, FileViewer, type FileViewerProps, type FluentChartPalette, FluentDialogProvider, FluentOverlayProvider, FluentOverlayTarget, FluentUIChart, type FluentUIChartProps, Footer, type FooterProps, GridButton, GridButtonBehavior, type GridButtonProps, GridButtonRole, type GridButtonRoleProps, GridButtons, type GridButtonsProps, GridColumn, type GridColumnAlign, type GridColumnCellRenderer, type GridColumnCellRendererProps, type GridColumnProps, GridColumns, type GridColumnsProps, type GridContextValue, type GridDeclaredColumn, GridTemplateColumn, type GridTemplateColumnCellRenderer, type GridTemplateColumnCellRendererProps, type GridTemplateColumnEditRenderer, type GridTemplateColumnEditRendererProps, type GridTemplateColumnProps, Header, type HeaderProps, Highlighter, type HighlighterProps, ImageEdit, type ImageEditProps, type ImageSource, ImageViewer, type ImageViewerHandle, type ImageViewerProps, LabelPosition, LanguageDropdown, type LanguageDropdownProps, type LinkExistingBulkMode, type LinkExistingRecordBehavior, LinkExistingRecordGridButton, type LinkExistingRecordGridButtonProps, LocalizationAdmin, type LocalizationAdminProps, LocalizationBoundary, type LocalizationBoundaryProps, LocalizationTranslator, type LocalizationTranslatorProps, LogoutButton, type LogoutButtonProps, type LookupColumnValue, LookupDialog, type LookupDialogProps, LookupEdit, type LookupEditProps, LookupEditorType, LookupForm, type LookupFormProps, type LookupMetadataView, MainGrid, type MainGridProps, ManyToManyLookupEdit, type ManyToManyLookupEditProps, ManyToManyLookupEditorType, MaskedTextField, type MaskedTextFieldHandle, type MaskedTextFieldProps, MemoEdit, type MemoEditProps, MenuBar, type MenuBarProps, MoneyEdit, type MoneyEditProps, MultiSelectChoiceEdit, type MultiSelectChoiceEditProps, NavGroup, type NavGroupProps, NavItem, type NavItemProps, type NavMatchMode, NavMenu, type NavMenuProps, NavigateNewRecordGridButton, type NavigateNewRecordGridButtonProps, NavigateOpenRecordGridButton, type NavigateOpenRecordGridButtonProps, NavigateRecordGridButton, type NavigateRecordGridButtonContext, type NavigateRecordGridButtonProps, type NewRecordDialogLocation, NewRecordGridButton, type NewRecordGridButtonBehavior, type NewRecordGridButtonProps, NumberEdit, type NumberEditProps, type NumberLimits, type NumberValueType, OFFICE_ACCENT_DEFINITIONS, OFFICE_ACCENT_HEX_TO_NAME, OFFICE_ACCENT_THEMES, OFFICE_COLOR_NAME_TO_ACCENT, type OfficeAccentDefinition, OpenRecordGridButton, type OpenRecordGridButtonBehavior, type OpenRecordGridButtonProps, PageLayout, type PageLayoutProps, PagingMode, type PendingRowCreate, type PendingRowUpdate, type PersistedGridState, type PersistedSort, PowerPortalsProThemeProvider, type PowerPortalsProThemeProviderProps, ProfileMainMenu, type ProfileMainMenuProps, RefreshContextButton, type RefreshContextButtonProps, RefreshGridButton, type RefreshGridButtonProps, RouterUnsavedChangesGuard, SaveContextButton, type SaveContextButtonProps, Section, SectionColumn, SectionColumnOrientation, type SectionColumnProps, type SectionProps, SiteSettingsButton, type SiteSettingsButtonProps, SiteSettingsPanel, type SiteSettingsPanelProps, type StepperVisibility, SubGrid, type SubGridProps, TextDirection, TextEdit, type TextEditProps, ThemeColorSelector, type ThemeColorSelectorProps, type ThemeContextValue, ThemeMode, ThemeSelector, type ThemeSelectorProps, ThemeTextDirection, type ThemeTextDirectionProps, type UnlinkExistingBulkMode, type UnlinkExistingRecordBehavior, UnlinkExistingRecordGridButton, type UnlinkExistingRecordGridButtonProps, VERSION, ValidationSummary, type ValidationSummaryProps, ViewSort, WizardRecordForm, type WizardRecordFormProps, WizardRecordPage, type WizardRecordPageProps, evaluateGridButtonBehavior, findFirstButtonOfRole, getCellRenderer, getChartPalette, getChoiceMetadata, getDisplayDescription, getDisplayLabel, getEditComponentForMetadata, getEditComponentForType, getGridButtonRoleFromElement, getLookupMetadata, getNumberLimits, getRendererTypeForMetadata, getStringMaxLength, isColumnSortable, isMetadataReadOnly, isMetadataRequired, isNewRecord, officeColorValueToAccentName, resolveColumnDisplayValue, setGridButtonRole, splitHighlightSegments, toTranslucent, useBoolColumn, useChoiceColumn, useDateColumn, useFileColumn, useFluentChartPalette, useGridContext, useLookupColumn, useMoneyColumn, useMultiSelectChoiceColumn, useNumberColumn, useStringColumn, useTheme };
+export { type AccentColor, type AccentThemePair, type BaseCellRendererProps, type BaseColumnEditProps, Body, type BodyProps, BoolEdit, type BoolEditProps, BoolEditorType, CacheAdmin, type CacheAdminProps, type CellRendererType, ChoiceEdit, type ChoiceEditProps, ChoiceEditorType, ChoiceInvalidValueBehavior, type ChoiceMetadataView, type ChoiceOption, ChoiceOrientation, ChoiceValueSort, ColumnDisplayValue, type ColumnDisplayValueProps, ColumnEdit, type CropAspect, type CropResult, type CustomViewDefinition, DataverseChart, type DataverseChartHandle, type DataverseChartProps, DateTimeEdit, type DateTimeEditProps, DateTimeEditorType, DeleteContextButton, type DeleteContextButtonProps, DeleteRecordGridButton, type DeleteRecordGridButtonProps, DescriptionLocation, type DialogLocation, type FileColumnValue, FileEdit, type FileEditProps, FileGrid, type FileGridProps, type FileSource, FileViewer, type FileViewerProps, type FluentChartPalette, FluentDialogProvider, FluentOverlayProvider, FluentOverlayTarget, FluentUIChart, type FluentUIChartProps, Footer, type FooterProps, GridButton, GridButtonBehavior, type GridButtonProps, GridButtonRole, type GridButtonRoleProps, GridButtons, type GridButtonsProps, GridColumn, type GridColumnAlign, type GridColumnCellRenderer, type GridColumnCellRendererProps, type GridColumnProps, GridColumns, type GridColumnsProps, type GridContextValue, type GridDeclaredColumn, GridTemplateColumn, type GridTemplateColumnCellRenderer, type GridTemplateColumnCellRendererProps, type GridTemplateColumnEditRenderer, type GridTemplateColumnEditRendererProps, type GridTemplateColumnProps, Header, type HeaderProps, Highlighter, type HighlighterProps, ImageEdit, type ImageEditProps, type ImageSource, ImageViewer, type ImageViewerHandle, type ImageViewerProps, ImpersonationBanner, type ImpersonationBannerProps, ImpersonationPickerDialog, type ImpersonationPickerDialogProps, LabelPosition, LanguageDropdown, type LanguageDropdownProps, type LinkExistingBulkMode, type LinkExistingRecordBehavior, LinkExistingRecordGridButton, type LinkExistingRecordGridButtonProps, LocalizationAdmin, type LocalizationAdminProps, LocalizationBoundary, type LocalizationBoundaryProps, LocalizationTranslator, type LocalizationTranslatorProps, LogoutButton, type LogoutButtonProps, type LookupColumnValue, LookupDialog, type LookupDialogProps, LookupEdit, type LookupEditProps, LookupEditorType, LookupForm, type LookupFormProps, type LookupMetadataView, MainGrid, type MainGridProps, ManyToManyLookupEdit, type ManyToManyLookupEditProps, ManyToManyLookupEditorType, MaskedTextField, type MaskedTextFieldHandle, type MaskedTextFieldProps, MemoEdit, type MemoEditProps, MenuBar, type MenuBarProps, MoneyEdit, type MoneyEditProps, MultiSelectChoiceEdit, type MultiSelectChoiceEditProps, NavGroup, type NavGroupProps, NavItem, type NavItemProps, type NavMatchMode, NavMenu, type NavMenuProps, NavigateNewRecordGridButton, type NavigateNewRecordGridButtonProps, NavigateOpenRecordGridButton, type NavigateOpenRecordGridButtonProps, NavigateRecordGridButton, type NavigateRecordGridButtonContext, type NavigateRecordGridButtonProps, type NewRecordDialogLocation, NewRecordGridButton, type NewRecordGridButtonBehavior, type NewRecordGridButtonProps, NumberEdit, type NumberEditProps, type NumberLimits, type NumberValueType, OFFICE_ACCENT_DEFINITIONS, OFFICE_ACCENT_HEX_TO_NAME, OFFICE_ACCENT_THEMES, OFFICE_COLOR_NAME_TO_ACCENT, type OfficeAccentDefinition, OpenRecordGridButton, type OpenRecordGridButtonBehavior, type OpenRecordGridButtonProps, PageLayout, type PageLayoutProps, PagingMode, type PendingRowCreate, type PendingRowUpdate, type PersistedGridState, type PersistedSort, PowerPortalsProThemeProvider, type PowerPortalsProThemeProviderProps, ProfileMainMenu, type ProfileMainMenuProps, RefreshContextButton, type RefreshContextButtonProps, RefreshGridButton, type RefreshGridButtonProps, RouterUnsavedChangesGuard, SaveContextButton, type SaveContextButtonProps, Section, SectionColumn, SectionColumnOrientation, type SectionColumnProps, type SectionProps, SiteSettingsButton, type SiteSettingsButtonProps, SiteSettingsPanel, type SiteSettingsPanelProps, type StepperVisibility, SubGrid, type SubGridProps, TextDirection, TextEdit, type TextEditProps, ThemeColorSelector, type ThemeColorSelectorProps, type ThemeContextValue, ThemeMode, ThemeSelector, type ThemeSelectorProps, ThemeTextDirection, type ThemeTextDirectionProps, type UnlinkExistingBulkMode, type UnlinkExistingRecordBehavior, UnlinkExistingRecordGridButton, type UnlinkExistingRecordGridButtonProps, VERSION, ValidationSummary, type ValidationSummaryProps, ViewSort, WizardRecordForm, type WizardRecordFormProps, WizardRecordPage, type WizardRecordPageProps, evaluateGridButtonBehavior, findFirstButtonOfRole, getCellRenderer, getChartPalette, getChoiceMetadata, getDisplayDescription, getDisplayLabel, getEditComponentForMetadata, getEditComponentForType, getGridButtonRoleFromElement, getLookupMetadata, getNumberLimits, getRendererTypeForMetadata, getStringMaxLength, isColumnSortable, isMetadataReadOnly, isMetadataRequired, isNewRecord, officeColorValueToAccentName, resolveColumnDisplayValue, setGridButtonRole, splitHighlightSegments, toTranslucent, useBoolColumn, useChoiceColumn, useDateColumn, useFileColumn, useFluentChartPalette, useGridContext, useLookupColumn, useMoneyColumn, useMultiSelectChoiceColumn, useNumberColumn, useStringColumn, useTheme };

package/dist/index.d.ts

@@ -2010,6 +2010,15 @@ interface ThemeContextValue {
      * option list.
      */
     readonly availableAccents: readonly AccentColor[];
+    /**
+     * Whether the site fixes its accent color via
+     * `<PowerPortalsProThemeProvider lockAccentColor>`. When `true`,
+     * {@link setAccentColor} is a no-op, any persisted preference is
+     * ignored in favour of the configured accent, and
+     * `<ThemeColorSelector>` renders nothing. Read it before offering
+     * any accent-changing UI of your own.
+     */
+    readonly accentColorLocked: boolean;
     /**
      * Each accent's representative brand-fill color (hex). Drives the
      * color swatch rendered next to each option in
@@ -2061,6 +2070,21 @@ interface PowerPortalsProThemeProviderProps {
      * is set. Defaults to `'ltr'`.
      */
     defaultTextDirection?: TextDirection;
+    /**
+     * Fixes the site's accent color to `defaultAccentColor`. Without
+     * it, that prop is only a *default*: a visitor who once picked an
+     * accent keeps it forever, because the persisted preference wins.
+     * With it, the configured accent always wins, the persisted value
+     * is rewritten to match, `setAccentColor` becomes a no-op, and
+     * `<ThemeColorSelector>` (and therefore the accent section of
+     * `<SiteSettingsPanel>`) renders nothing. Light/dark mode stays
+     * under the visitor's control either way.
+     *
+     * Pair it with a `customAccents` entry at the `'default'` key to
+     * lock the site to your own brand rather than one of the built-in
+     * Office accents.
+     */
+    lockAccentColor?: boolean;
     /**
      * Consumer-supplied custom accents, layered ON TOP of the built-in
      * Office-brand palette (`'default'`, `'teams'`, `'excel'`, `'word'`,
@@ -2132,7 +2156,7 @@ interface PowerPortalsProThemeProviderProps {
  * </PowerPortalsProThemeProvider>
  * ```
  */
-declare function PowerPortalsProThemeProvider({ children, defaultMode, defaultAccentColor, defaultTextDirection, customAccents, storageKey, style, fluentProviderProps, }: PowerPortalsProThemeProviderProps): react_jsx_runtime.JSX.Element;
+declare function PowerPortalsProThemeProvider({ children, defaultMode, defaultAccentColor, defaultTextDirection, lockAccentColor, customAccents, storageKey, style, fluentProviderProps, }: PowerPortalsProThemeProviderProps): react_jsx_runtime.JSX.Element;
 
 interface ThemeSelectorProps {
     /** Disable the control. Useful when displaying the user's read-only preference. */
@@ -2196,8 +2220,12 @@ interface ThemeColorSelectorProps {
  * `app.components.theme-color-selector.accent.<key>`. Missing keys
  * fall back to the accent's raw string (so an unlocalized custom
  * accent like `'forest'` shows as `"forest"` rather than blank).
+ *
+ * Renders nothing when the site fixes its accent via
+ * `<PowerPortalsProThemeProvider lockAccentColor>` — a picker whose
+ * choice is discarded is worse than no picker.
  */
-declare function ThemeColorSelector({ readOnly, label, width, accentLabels, }: ThemeColorSelectorProps): react_jsx_runtime.JSX.Element;
+declare function ThemeColorSelector({ readOnly, label, width, accentLabels, }: ThemeColorSelectorProps): react_jsx_runtime.JSX.Element | null;
 
 /**
  * Canonical accent definition. One entry per visually-distinct brand
@@ -2440,6 +2468,69 @@ interface ProfileMainMenuProps {
  */
 declare function ProfileMainMenu({ accountUrl, accountLabel, headerSlot, footerSlot, anonymousContent, signInUrl, }: ProfileMainMenuProps): react_jsx_runtime.JSX.Element;
 
+/** Props for {@link ImpersonationBanner}. */
+interface ImpersonationBannerProps {
+    /**
+     * Where to send the browser after impersonation ends. Defaults to `'/'`.
+     *
+     * A full navigation rather than a client-side route change, because ending impersonation
+     * swaps the auth cookie — every mounted component is now rendering for a different user, and
+     * anything that captured the old principal at mount time would keep showing it.
+     */
+    returnUrl?: string;
+    /** Extra class applied to the banner element. */
+    className?: string;
+}
+/**
+ * Persistent banner shown while an internal user is operating the portal as one of its contacts.
+ * Renders nothing for an ordinary session, so it is safe — and intended — to mount
+ * unconditionally; {@link PageLayout} already does.
+ *
+ * That unconditional mounting is the point. A banner a host can forget to render defeats its own
+ * purpose: the reason it exists is that an administrator must not be able to forget the portal is
+ * answering as somebody else.
+ *
+ * Built on Fluent's own `MessageBar` with `intent="error"` rather than a hand-painted bar, so the
+ * library owns the surface, the intent colour and the icon — and the Stop button is a stock
+ * `Button` on a surface Fluent itself themed. An earlier version painted its own red background
+ * and then had to override the button's colours to stay readable on it, which is what put this
+ * component in the business of fighting the design-token system. Letting the library own the
+ * surface removes that whole class of problem: there is no colour styling left here at all.
+ * Mirrors the Blazor banner, which is built on `FluentMessageBar` for the same reason.
+ *
+ * Reads `auth.user.isImpersonating` from `useAuth()`, so the app must be wrapped in
+ * `<PowerPortalsProProvider>`.
+ */
+declare function ImpersonationBanner({ returnUrl, className, }: ImpersonationBannerProps): react_jsx_runtime.JSX.Element | null;
+
+/** Props for {@link ImpersonationPickerDialog}. */
+interface ImpersonationPickerDialogProps {
+    /** Whether the dialog is open. */
+    open: boolean;
+    /** Called when the dialog should close — Cancel, dismiss, or Escape. */
+    onClose: () => void;
+    /**
+     * Where to send the browser once impersonation starts. Defaults to `'/'`.
+     *
+     * A full navigation, because the auth cookie has changed: every mounted component is now
+     * rendering for a different user, and anything that captured the old principal at mount time
+     * would keep showing it.
+     */
+    returnUrl?: string;
+    /** Extra class applied to the dialog surface. */
+    className?: string;
+}
+/**
+ * Modal picker for choosing the contact an internal administrator wants to view the portal as.
+ * Typing searches by name, email address, or exact user id; confirming starts impersonation and
+ * reloads the app as that user.
+ *
+ * Presentation only. Every decision about who may impersonate and who may be impersonated is made
+ * server-side — this component cannot widen either, and the endpoint re-checks both regardless of
+ * what the UI offered.
+ */
+declare function ImpersonationPickerDialog({ open, onClose, returnUrl, className, }: ImpersonationPickerDialogProps): react_jsx_runtime.JSX.Element;
+
 interface SiteSettingsButtonProps {
     /**
      * When `true` (default), the panel renders the language dropdown.
@@ -4635,7 +4726,11 @@ interface MainGridProps {
      * Set to `'virtualize'` for infinite-scroll — the pager footer is
      * hidden, rows accumulate across page boundaries, and the next page
      * fetches automatically when the user scrolls past the rendered
-     * bottom.
+     * bottom. Pages are requested sequentially with the previous page's
+     * Dataverse paging cookie (cursor paging), and loading stops when the
+     * server reports no more records — not when the accumulated rows reach
+     * the total count, which can never happen if per-row permission
+     * handlers drop rows after Dataverse has counted them.
      */
     pagingMode?: PagingMode;
     /**
@@ -6337,4 +6432,4 @@ declare function useFluentChartPalette(scopeRef: RefObject<HTMLElement | null>):
 
 declare const VERSION = "0.1.0";
 
-export { type AccentColor, type AccentThemePair, type BaseCellRendererProps, type BaseColumnEditProps, Body, type BodyProps, BoolEdit, type BoolEditProps, BoolEditorType, CacheAdmin, type CacheAdminProps, type CellRendererType, ChoiceEdit, type ChoiceEditProps, ChoiceEditorType, ChoiceInvalidValueBehavior, type ChoiceMetadataView, type ChoiceOption, ChoiceOrientation, ChoiceValueSort, ColumnDisplayValue, type ColumnDisplayValueProps, ColumnEdit, type CropAspect, type CropResult, type CustomViewDefinition, DataverseChart, type DataverseChartHandle, type DataverseChartProps, DateTimeEdit, type DateTimeEditProps, DateTimeEditorType, DeleteContextButton, type DeleteContextButtonProps, DeleteRecordGridButton, type DeleteRecordGridButtonProps, DescriptionLocation, type DialogLocation, type FileColumnValue, FileEdit, type FileEditProps, FileGrid, type FileGridProps, type FileSource, FileViewer, type FileViewerProps, type FluentChartPalette, FluentDialogProvider, FluentOverlayProvider, FluentOverlayTarget, FluentUIChart, type FluentUIChartProps, Footer, type FooterProps, GridButton, GridButtonBehavior, type GridButtonProps, GridButtonRole, type GridButtonRoleProps, GridButtons, type GridButtonsProps, GridColumn, type GridColumnAlign, type GridColumnCellRenderer, type GridColumnCellRendererProps, type GridColumnProps, GridColumns, type GridColumnsProps, type GridContextValue, type GridDeclaredColumn, GridTemplateColumn, type GridTemplateColumnCellRenderer, type GridTemplateColumnCellRendererProps, type GridTemplateColumnEditRenderer, type GridTemplateColumnEditRendererProps, type GridTemplateColumnProps, Header, type HeaderProps, Highlighter, type HighlighterProps, ImageEdit, type ImageEditProps, type ImageSource, ImageViewer, type ImageViewerHandle, type ImageViewerProps, LabelPosition, LanguageDropdown, type LanguageDropdownProps, type LinkExistingBulkMode, type LinkExistingRecordBehavior, LinkExistingRecordGridButton, type LinkExistingRecordGridButtonProps, LocalizationAdmin, type LocalizationAdminProps, LocalizationBoundary, type LocalizationBoundaryProps, LocalizationTranslator, type LocalizationTranslatorProps, LogoutButton, type LogoutButtonProps, type LookupColumnValue, LookupDialog, type LookupDialogProps, LookupEdit, type LookupEditProps, LookupEditorType, LookupForm, type LookupFormProps, type LookupMetadataView, MainGrid, type MainGridProps, ManyToManyLookupEdit, type ManyToManyLookupEditProps, ManyToManyLookupEditorType, MaskedTextField, type MaskedTextFieldHandle, type MaskedTextFieldProps, MemoEdit, type MemoEditProps, MenuBar, type MenuBarProps, MoneyEdit, type MoneyEditProps, MultiSelectChoiceEdit, type MultiSelectChoiceEditProps, NavGroup, type NavGroupProps, NavItem, type NavItemProps, type NavMatchMode, NavMenu, type NavMenuProps, NavigateNewRecordGridButton, type NavigateNewRecordGridButtonProps, NavigateOpenRecordGridButton, type NavigateOpenRecordGridButtonProps, NavigateRecordGridButton, type NavigateRecordGridButtonContext, type NavigateRecordGridButtonProps, type NewRecordDialogLocation, NewRecordGridButton, type NewRecordGridButtonBehavior, type NewRecordGridButtonProps, NumberEdit, type NumberEditProps, type NumberLimits, type NumberValueType, OFFICE_ACCENT_DEFINITIONS, OFFICE_ACCENT_HEX_TO_NAME, OFFICE_ACCENT_THEMES, OFFICE_COLOR_NAME_TO_ACCENT, type OfficeAccentDefinition, OpenRecordGridButton, type OpenRecordGridButtonBehavior, type OpenRecordGridButtonProps, PageLayout, type PageLayoutProps, PagingMode, type PendingRowCreate, type PendingRowUpdate, type PersistedGridState, type PersistedSort, PowerPortalsProThemeProvider, type PowerPortalsProThemeProviderProps, ProfileMainMenu, type ProfileMainMenuProps, RefreshContextButton, type RefreshContextButtonProps, RefreshGridButton, type RefreshGridButtonProps, RouterUnsavedChangesGuard, SaveContextButton, type SaveContextButtonProps, Section, SectionColumn, SectionColumnOrientation, type SectionColumnProps, type SectionProps, SiteSettingsButton, type SiteSettingsButtonProps, SiteSettingsPanel, type SiteSettingsPanelProps, type StepperVisibility, SubGrid, type SubGridProps, TextDirection, TextEdit, type TextEditProps, ThemeColorSelector, type ThemeColorSelectorProps, type ThemeContextValue, ThemeMode, ThemeSelector, type ThemeSelectorProps, ThemeTextDirection, type ThemeTextDirectionProps, type UnlinkExistingBulkMode, type UnlinkExistingRecordBehavior, UnlinkExistingRecordGridButton, type UnlinkExistingRecordGridButtonProps, VERSION, ValidationSummary, type ValidationSummaryProps, ViewSort, WizardRecordForm, type WizardRecordFormProps, WizardRecordPage, type WizardRecordPageProps, evaluateGridButtonBehavior, findFirstButtonOfRole, getCellRenderer, getChartPalette, getChoiceMetadata, getDisplayDescription, getDisplayLabel, getEditComponentForMetadata, getEditComponentForType, getGridButtonRoleFromElement, getLookupMetadata, getNumberLimits, getRendererTypeForMetadata, getStringMaxLength, isColumnSortable, isMetadataReadOnly, isMetadataRequired, isNewRecord, officeColorValueToAccentName, resolveColumnDisplayValue, setGridButtonRole, splitHighlightSegments, toTranslucent, useBoolColumn, useChoiceColumn, useDateColumn, useFileColumn, useFluentChartPalette, useGridContext, useLookupColumn, useMoneyColumn, useMultiSelectChoiceColumn, useNumberColumn, useStringColumn, useTheme };
+export { type AccentColor, type AccentThemePair, type BaseCellRendererProps, type BaseColumnEditProps, Body, type BodyProps, BoolEdit, type BoolEditProps, BoolEditorType, CacheAdmin, type CacheAdminProps, type CellRendererType, ChoiceEdit, type ChoiceEditProps, ChoiceEditorType, ChoiceInvalidValueBehavior, type ChoiceMetadataView, type ChoiceOption, ChoiceOrientation, ChoiceValueSort, ColumnDisplayValue, type ColumnDisplayValueProps, ColumnEdit, type CropAspect, type CropResult, type CustomViewDefinition, DataverseChart, type DataverseChartHandle, type DataverseChartProps, DateTimeEdit, type DateTimeEditProps, DateTimeEditorType, DeleteContextButton, type DeleteContextButtonProps, DeleteRecordGridButton, type DeleteRecordGridButtonProps, DescriptionLocation, type DialogLocation, type FileColumnValue, FileEdit, type FileEditProps, FileGrid, type FileGridProps, type FileSource, FileViewer, type FileViewerProps, type FluentChartPalette, FluentDialogProvider, FluentOverlayProvider, FluentOverlayTarget, FluentUIChart, type FluentUIChartProps, Footer, type FooterProps, GridButton, GridButtonBehavior, type GridButtonProps, GridButtonRole, type GridButtonRoleProps, GridButtons, type GridButtonsProps, GridColumn, type GridColumnAlign, type GridColumnCellRenderer, type GridColumnCellRendererProps, type GridColumnProps, GridColumns, type GridColumnsProps, type GridContextValue, type GridDeclaredColumn, GridTemplateColumn, type GridTemplateColumnCellRenderer, type GridTemplateColumnCellRendererProps, type GridTemplateColumnEditRenderer, type GridTemplateColumnEditRendererProps, type GridTemplateColumnProps, Header, type HeaderProps, Highlighter, type HighlighterProps, ImageEdit, type ImageEditProps, type ImageSource, ImageViewer, type ImageViewerHandle, type ImageViewerProps, ImpersonationBanner, type ImpersonationBannerProps, ImpersonationPickerDialog, type ImpersonationPickerDialogProps, LabelPosition, LanguageDropdown, type LanguageDropdownProps, type LinkExistingBulkMode, type LinkExistingRecordBehavior, LinkExistingRecordGridButton, type LinkExistingRecordGridButtonProps, LocalizationAdmin, type LocalizationAdminProps, LocalizationBoundary, type LocalizationBoundaryProps, LocalizationTranslator, type LocalizationTranslatorProps, LogoutButton, type LogoutButtonProps, type LookupColumnValue, LookupDialog, type LookupDialogProps, LookupEdit, type LookupEditProps, LookupEditorType, LookupForm, type LookupFormProps, type LookupMetadataView, MainGrid, type MainGridProps, ManyToManyLookupEdit, type ManyToManyLookupEditProps, ManyToManyLookupEditorType, MaskedTextField, type MaskedTextFieldHandle, type MaskedTextFieldProps, MemoEdit, type MemoEditProps, MenuBar, type MenuBarProps, MoneyEdit, type MoneyEditProps, MultiSelectChoiceEdit, type MultiSelectChoiceEditProps, NavGroup, type NavGroupProps, NavItem, type NavItemProps, type NavMatchMode, NavMenu, type NavMenuProps, NavigateNewRecordGridButton, type NavigateNewRecordGridButtonProps, NavigateOpenRecordGridButton, type NavigateOpenRecordGridButtonProps, NavigateRecordGridButton, type NavigateRecordGridButtonContext, type NavigateRecordGridButtonProps, type NewRecordDialogLocation, NewRecordGridButton, type NewRecordGridButtonBehavior, type NewRecordGridButtonProps, NumberEdit, type NumberEditProps, type NumberLimits, type NumberValueType, OFFICE_ACCENT_DEFINITIONS, OFFICE_ACCENT_HEX_TO_NAME, OFFICE_ACCENT_THEMES, OFFICE_COLOR_NAME_TO_ACCENT, type OfficeAccentDefinition, OpenRecordGridButton, type OpenRecordGridButtonBehavior, type OpenRecordGridButtonProps, PageLayout, type PageLayoutProps, PagingMode, type PendingRowCreate, type PendingRowUpdate, type PersistedGridState, type PersistedSort, PowerPortalsProThemeProvider, type PowerPortalsProThemeProviderProps, ProfileMainMenu, type ProfileMainMenuProps, RefreshContextButton, type RefreshContextButtonProps, RefreshGridButton, type RefreshGridButtonProps, RouterUnsavedChangesGuard, SaveContextButton, type SaveContextButtonProps, Section, SectionColumn, SectionColumnOrientation, type SectionColumnProps, type SectionProps, SiteSettingsButton, type SiteSettingsButtonProps, SiteSettingsPanel, type SiteSettingsPanelProps, type StepperVisibility, SubGrid, type SubGridProps, TextDirection, TextEdit, type TextEditProps, ThemeColorSelector, type ThemeColorSelectorProps, type ThemeContextValue, ThemeMode, ThemeSelector, type ThemeSelectorProps, ThemeTextDirection, type ThemeTextDirectionProps, type UnlinkExistingBulkMode, type UnlinkExistingRecordBehavior, UnlinkExistingRecordGridButton, type UnlinkExistingRecordGridButtonProps, VERSION, ValidationSummary, type ValidationSummaryProps, ViewSort, WizardRecordForm, type WizardRecordFormProps, WizardRecordPage, type WizardRecordPageProps, evaluateGridButtonBehavior, findFirstButtonOfRole, getCellRenderer, getChartPalette, getChoiceMetadata, getDisplayDescription, getDisplayLabel, getEditComponentForMetadata, getEditComponentForType, getGridButtonRoleFromElement, getLookupMetadata, getNumberLimits, getRendererTypeForMetadata, getStringMaxLength, isColumnSortable, isMetadataReadOnly, isMetadataRequired, isNewRecord, officeColorValueToAccentName, resolveColumnDisplayValue, setGridButtonRole, splitHighlightSegments, toTranslucent, useBoolColumn, useChoiceColumn, useDateColumn, useFileColumn, useFluentChartPalette, useGridContext, useLookupColumn, useMoneyColumn, useMultiSelectChoiceColumn, useNumberColumn, useStringColumn, useTheme };