react-semaphor 0.1.509 → 0.1.511

package/dist/surfboard/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../chunks/index-DkEAikW8.cjs"),r=require("../chunks/common-types-nBuCd3u2.cjs"),o=require("../chunks/report-preferences-dialog-Wg9g9fIj.cjs");exports.DisplayFormatPreferencesFields=e.DisplayFormatPreferencesFields;exports.Surfboard=e.DashboardPlus;exports.CONTROL_CARD_DEFAULT_VALUE=r.CONTROL_CARD_DEFAULT_VALUE;exports.EMPTY_SELECTION=r.EMPTY_SELECTION;exports.ReportPreferencesDialog=o.ReportPreferencesDialog;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../chunks/index-Bym8NiEh.cjs"),r=require("../chunks/common-types-nBuCd3u2.cjs"),o=require("../chunks/report-preferences-dialog-BrrpSEMl.cjs");exports.DisplayFormatPreferencesFields=e.DisplayFormatPreferencesFields;exports.Surfboard=e.DashboardPlus;exports.CONTROL_CARD_DEFAULT_VALUE=r.CONTROL_CARD_DEFAULT_VALUE;exports.EMPTY_SELECTION=r.EMPTY_SELECTION;exports.ReportPreferencesDialog=o.ReportPreferencesDialog;

package/dist/surfboard/index.js

@@ -1,6 +1,6 @@
-import { b as a, a as o } from "../chunks/index-CL2lvhwk.js";
+import { b as a, a as o } from "../chunks/index-bH_soNi5.js";
 import { C as f, E } from "../chunks/common-types-C6cAQgyh.js";
-import { R as t } from "../chunks/report-preferences-dialog-Bv2VIOKc.js";
+import { R as t } from "../chunks/report-preferences-dialog-BMkvjfq4.js";
 export {
   f as CONTROL_CARD_DEFAULT_VALUE,
   a as DisplayFormatPreferencesFields,

package/dist/types/components/dashboard/dashboard-visual-error-state.d.ts

@@ -9,6 +9,12 @@ export declare function DashboardVisualErrorState({ onRetry, actionLabel, densit
 export declare function DashboardDeclaredSqlCustomDateFormatRepairState({ onRepair, }: {
     onRepair?: () => void;
 }): import("react/jsx-runtime").JSX.Element;
-export declare function DashboardVisualErrorBoundaryFallback({ error, resetErrorBoundary, onRepair, }: FallbackProps & {
+/**
+ * Render-failure state for a dashboard card. `onRepair` is present only when
+ * the user can edit the dashboard; whatever threw, an editor's way out is the
+ * visual editor and a viewer's is a retry.
+ */
+export declare function DashboardVisualErrorBoundaryFallback({ error, resetErrorBoundary, onRepair, density, }: FallbackProps & {
     onRepair?: () => void;
+    density?: 'default' | 'compact';
 }): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/error-fallbacks/fallback.d.ts

@@ -1,19 +1,31 @@
+import { FallbackProps } from 'react-error-boundary';
 import { TFrame } from '../../lib/types/index.js';
 export declare function FallbackChatVisual({ error, }: {
     error: Error;
     resetErrorBoundary: () => void;
 }): import("react/jsx-runtime").JSX.Element;
-export declare function FallbackVisual({ customerFacingMessage, error, resetErrorBoundary, }: {
-    customerFacingMessage?: string;
-    error: Error;
-    resetErrorBoundary: () => void;
+/**
+ * Render-failure state for one visual outside the dashboard grid: the editor
+ * preview, expanded view, interaction popovers and standalone visuals. Raw
+ * error text stays out of the UI (React already logs it).
+ *
+ * `onResetColumnSettings` is the editor's way out when the table's own column
+ * settings sheet failed along with the table: it runs the same reset as the
+ * sheet's "Reset all" on the unsaved draft, then retries the render.
+ */
+export declare function FallbackVisual({ error, resetErrorBoundary, onResetColumnSettings, }: FallbackProps & {
+    onResetColumnSettings?: () => void;
 }): import("react/jsx-runtime").JSX.Element;
-export declare function Fallback({ error, }: {
-    error: Error;
-    resetErrorBoundary: () => void;
-}): import("react/jsx-runtime").JSX.Element;
-export declare function FallbackCard({ error, frame, }: {
-    error: Error;
-    resetErrorBoundary: () => void;
+/**
+ * Whole-surface net (dashboard, editor, standalone visual), reached only when
+ * every narrower boundary was bypassed. Offers a retry instead of a dead end.
+ */
+export declare function Fallback({ error, resetErrorBoundary }: FallbackProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Sheet-grid net for a frame that failed outside its own boundaries. Keeps
+ * the card shell and hover toolbar so the card can still be edited, moved or
+ * deleted.
+ */
+export declare function FallbackCard({ error, resetErrorBoundary, frame, }: FallbackProps & {
     frame: TFrame;
 }): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/visual/data-table/hooks/use-data-table-logic.d.ts

@@ -84,6 +84,11 @@ export declare function useDataTableLogic(props: DataTableLogicProps): {
     totalRows: number;
     isTablePrintDisplayMode: boolean;
     onSortChange: ((sorting: SortingState) => void) | undefined;
+    pagination: {
+        pageIndex: number;
+        pageSize: number;
+    };
+    handlePaginationChange: (updater: import('@tanstack/table-core').PaginationState | ((old: import('@tanstack/table-core').PaginationState) => import('@tanstack/table-core').PaginationState)) => void;
     paginationMode: import('../utils/pagination-utils.js').PaginationMode;
     paginationMetadata: any;
     contextTimezone: string | undefined;

package/dist/types/lib/dashboard/open-card-in-visual-editor.d.ts

@@ -0,0 +1,15 @@
+import { useManagementStore } from '../stores/management-store.js';
+import { TCard, TFrame } from '../types/common-types.js';
+type ManagementState = ReturnType<typeof useManagementStore.getState>;
+/** Saved-dashboard edit permission, as the dashboard runtime reads it. */
+export declare function selectCanEditDashboard(state: ManagementState): boolean;
+/**
+ * Opens the visual editor on one dashboard card from any dashboard state,
+ * including view mode. Store values are read at call time, so callers such as
+ * error fallbacks don't subscribe to dashboard or editor state to offer it.
+ */
+export declare function openCardInVisualEditor({ frame, card, }: {
+    frame: TFrame;
+    card: TCard;
+}): void;
+export {};

package/dist/types/lib/dashboard-pagination/dashboard-card-pagination.d.ts

@@ -0,0 +1,24 @@
+import { PaginationConfig, PaginationMetadata } from '../types/explorer-types.js';
+export type DashboardCardPaginationState = PaginationConfig & {
+    queryInputIdentity: string;
+};
+type ResolveDashboardCardPaginationParams = {
+    current?: DashboardCardPaginationState;
+    defaultPageSize: number;
+    queryInputIdentity: string;
+};
+/**
+ * Attaches a runtime page to the data-shaping query it belongs to. A changed
+ * query always starts on page one, while the viewer's chosen page size carries
+ * forward across filters, controls, selections, and sorts.
+ */
+export declare function resolveDashboardCardPagination({ current, defaultPageSize, queryInputIdentity, }: ResolveDashboardCardPaginationParams): PaginationConfig;
+export declare function dashboardCardPaginationMatches(current: DashboardCardPaginationState | undefined, pagination: PaginationConfig, queryInputIdentity: string): boolean;
+/**
+ * Keeps pagination chrome aligned with the request being rendered while React
+ * Query retains the previous response. Counts and navigation capability remain
+ * useful placeholders, but the displayed page must belong to the current query
+ * input identity.
+ */
+export declare function resolveDashboardPaginationMetadata(metadata: PaginationMetadata | undefined, effectivePagination: PaginationConfig | undefined): PaginationMetadata | undefined;
+export {};

package/dist/types/lib/hooks/use-dashboard-card.d.ts

@@ -12,6 +12,8 @@ export declare function useCard(cardId: string): {
     handleDatapointClick: (chart: Chart, datasetIndex: number, clickIndex: number, value: number) => void;
     cfg: any;
     queryKey: string[];
+    queryInputIdentity: string | undefined;
+    effectivePaginationConfig: import('../types/index.js').PaginationConfig | undefined;
     queryRequestPayload: Record<string, unknown> | undefined;
     pagination: import('../types/index.js').PaginationMetadata | undefined;
     comparisonMetadata: import('../../shared/analytics-protocol/index.js').MetricComparisonMetadataMap | undefined;
@@ -30,6 +32,8 @@ export declare function useDashboardCard(card: TCard): {
     handleDatapointClick: (chart: Chart, datasetIndex: number, clickIndex: number, value: number) => void;
     cfg: any;
     queryKey: string[];
+    queryInputIdentity: string | undefined;
+    effectivePaginationConfig: import('../types/index.js').PaginationConfig | undefined;
     queryRequestPayload: Record<string, unknown> | undefined;
     pagination: import('../types/index.js').PaginationMetadata | undefined;
     comparisonMetadata: import('../../shared/analytics-protocol/index.js').MetricComparisonMetadataMap | undefined;

package/dist/types/lib/hooks/use-dashboard-frame-query.d.ts

@@ -1,6 +1,6 @@
 import { UseQueryResult } from '@tanstack/react-query';
 import { ControlDefinition, DashboardInputValues, TCard } from '../types/common-types.js';
-import { CardConfig, PaginationMetadata, TableTotalsRequest } from '../types/explorer-types.js';
+import { CardConfig, PaginationConfig, PaginationMetadata, TableTotalsRequest } from '../types/explorer-types.js';
 import { AutoJoinMetadata, ComparisonMetadataMap } from '../types/query-types.js';
 import { SemanticExecutionPayloadAuthority } from '../query-context/use-semantic-execution-payload-for-cards.js';
 import { TFilterValue } from '../../components/surfboard/filter/types.js';
@@ -15,6 +15,8 @@ type AdditionalState = {
     isFilteringCard: boolean;
     isSingleCardFrame: boolean;
     queryKey: string[];
+    queryInputIdentity?: string;
+    effectivePaginationConfig?: PaginationConfig;
     errorMessage: string;
     errorSql: string;
     pagination?: PaginationMetadata;

package/dist/types/lib/query-context/build-dashboard-card-query-contract.d.ts

@@ -1,7 +1,7 @@
 import { TFilterValue } from '../../components/surfboard/filter/types.js';
 import { getCacheConfig } from '../stores/utils.js';
 import { ControlBinding, ControlDefinition, TCard } from '../types/common-types.js';
-import { CardConfig } from '../types/explorer-types.js';
+import { CardConfig, PaginationConfig } from '../types/explorer-types.js';
 import { ResolvedPrimaryDateField } from '../types/semantic-runtime-types.js';
 import { TableConfig } from '../types/query-types.js';
 import { CardQueryContext, CompiledCardQueryContext } from './build-card-query-context.js';
@@ -33,6 +33,8 @@ export type DashboardCardQueryRequestPayloadBase = {
 export type DashboardCardQueryContract = {
     status: 'ready';
     queryKey: string[];
+    queryInputIdentity: string;
+    paginationConfig?: PaginationConfig;
     requestPayloadBase: DashboardCardQueryRequestPayloadBase;
     tableConfig: TableConfig;
     compiledFilters: CompiledDashboardCardFilters;
@@ -51,6 +53,7 @@ export type DashboardCardQueryExecutionOptions = {
     calendarContext: CalendarContext;
     allowGlobalDateMinutePrecision?: boolean;
     globalDateComparisonReferenceTime?: string;
+    resolvePaginationConfig?: (queryInputIdentity: string) => PaginationConfig | undefined;
 };
 /** One final compilation for interactive requests and immutable input captures. */
 export declare function compileDashboardCardQueryContext(card: TCard, context: CardQueryContext, execution: Omit<CompileDashboardCardFiltersParams, 'card' | 'cardConfig' | 'input'>): {

package/dist/types/lib/query-context/dashboard-card-query-key.d.ts

@@ -1,6 +1,6 @@
 import { ControlBinding, ControlDefinition, TCard } from '../types/common-types.js';
 import { ResolvedPrimaryDateField } from '../types/semantic-runtime-types.js';
-import { CardConfig } from '../types/explorer-types.js';
+import { CardConfig, PaginationConfig } from '../types/explorer-types.js';
 import { GlobalDateComparisonContext } from '../../shared/analytics-protocol/index.js';
 import { CalendarContext } from '../../shared/report-runtime-context/index.js';
 export declare const isPaginatedCardType: (card: TCard) => boolean;
@@ -25,4 +25,16 @@ export declare function dashboardCardQueryKeysMatch(currentQueryKey: readonly un
  * lifecycle effects must depend on this value rather than array identity.
  */
 export declare function serializeDashboardCardQueryKey(queryKey: readonly unknown[]): string;
-export declare function createDashboardCardQueryKey(card: TCard, { finalFiltersKey, selectedLensId, cardFilterValues, controlValues, controlDefinitions, cardControlDefinitions, controlBindings, queryRelevantConfig, resolvedPrimaryDateField, globalDateComparison, calendarContext, }: CreateDashboardCardQueryKeyOptions): string[];
+/**
+ * Builds the cache identity and the data-shaping identity from one projection.
+ * Pagination belongs in the cache key, but is deliberately excluded from the
+ * input identity so consumers can distinguish paging from a changed result set.
+ */
+export declare function createDashboardCardQueryIdentities(card: TCard, options: CreateDashboardCardQueryKeyOptions, identityOptions?: {
+    resolvePaginationConfig?: (queryInputIdentity: string) => PaginationConfig | undefined;
+}): {
+    queryKey: string[];
+    queryInputIdentity: string;
+    paginationConfig: PaginationConfig | undefined;
+};
+export declare function createDashboardCardQueryKey(card: TCard, options: CreateDashboardCardQueryKeyOptions): string[];

package/dist/types/lib/stores/dashboard-store.d.ts

@@ -16,6 +16,7 @@ import { CalendarPreferencesResponse, ReportRuntimeContext, ResolvedCalendarPref
 import { ResolvedValueFormatPreferenceSources, ResolvedValueFormatPreferences } from '../../shared/value-format-preferences/index.js';
 import { DashboardNavigationEntry, DashboardNavigationState, DashboardTransientContextScope, InsightRenderRequest, NavigationRejection } from '../dashboard-navigation/index.js';
 import { CardViewStateMap, DrillStep } from '../dashboard-view-state/index.js';
+import { DashboardCardPaginationState } from '../dashboard-pagination/dashboard-card-pagination.js';
 type AddFrameOptions = {
     position?: 'start' | 'end';
     insertAfterFrameId?: string;
@@ -97,6 +98,8 @@ export type DashboardStore = {
     dashboardInputValues: DashboardInputValues;
     /** Session-only per-card view state (the drill path), keyed by cardId. Never persisted. */
     cardViewState: CardViewStateMap;
+    /** Session-only server pagination, attached to the query identity that owns each page. */
+    dashboardCardPagination: Record<string, DashboardCardPaginationState>;
     /** Fixed execution clock from a strict dashboard input replay snapshot. */
     dashboardInputReferenceTime?: string;
     semanticExecutionPayload: SemanticExecutionPayload;
@@ -177,6 +180,7 @@ type Actions = {
     popDrillStep: (cardId: string) => void;
     resetCardViewState: (cardId: string) => void;
     resetAllCardViewState: () => void;
+    setDashboardCardPagination: (cardId: string, pagination: DashboardCardPaginationState) => void;
     setDashboardControlsModel: (controls: ControlDefinition[], defaultValues?: Record<string, unknown>, options?: DashboardControlsModelOptions) => void;
     updateDashboardControl: (controlId: string, updates: Partial<ControlDefinition>) => void;
     reorderDashboardControls: (orderedControlIds: string[]) => void;

package/dist/types/lib/utils/card-loading-state.d.ts

@@ -8,6 +8,7 @@ type CardLoadingPresentationInput = {
     hasRecords?: boolean;
 };
 export declare function shouldUseCardSkeletonDuringRefetch(card: Pick<TCard, 'type'> | undefined): boolean;
+export declare function showsOwnRefetchCue(card: Pick<TCard, 'type'> | undefined): boolean;
 export declare function getCardLoadingPresentation({ card, fetchStatus, isLoading, isFetching, isPending, hasRecords, }: CardLoadingPresentationInput): {
     isBusy: boolean;
     showCardSkeleton: boolean;

package/package.json

@@ -5,7 +5,7 @@
     "email": "support@semaphor.cloud"
   },
   "license": "MIT",
-  "version": "0.1.509",
+  "version": "0.1.511",
   "description": "Fully interactive and customizable dashboards for your apps.",
   "keywords": [
     "react",