react-semaphor 0.1.509 → 0.1.510

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-BriWG9wG.cjs"),r=require("../chunks/common-types-nBuCd3u2.cjs"),o=require("../chunks/report-preferences-dialog-C1LOgCAH.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-CTFwTeBb.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-CEja_Mat.js";
 export {
   f as CONTROL_CARD_DEFAULT_VALUE,
   a as DisplayFormatPreferencesFields,

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

@@ -0,0 +1,17 @@
+import { PaginationConfig } 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;
+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.510",
   "description": "Fully interactive and customizable dashboards for your apps.",
   "keywords": [
     "react",