react-semaphor 0.1.508 → 0.1.510

package/dist/surfboard/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../chunks/index-BaIrLSBb.cjs"),r=require("../chunks/common-types-nBuCd3u2.cjs"),o=require("../chunks/report-preferences-dialog-C9rpWgQZ.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-ByiS9sB4.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-BbkXcnnn.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/components/visual/matrix-table/matrix-interaction-actions.d.ts

@@ -7,7 +7,12 @@ export type MatrixInteractionHost = Pick<MatrixInteractionInput, 'resolveField'
      * A direct click on a member or a cell. The host decides whether that part
      * of the grid starts a selection and which gesture the pointer asked for.
      */
-    select?: (context: NonNullable<MatrixInteraction['context']>, source: MatrixSelectionSource, event: Pick<React.MouseEvent, 'shiftKey' | 'metaKey' | 'ctrlKey' | 'nativeEvent'>) => void;
+    select?: (context: NonNullable<MatrixInteraction['context']>, source: MatrixSelectionSource, event: {
+        shiftKey: boolean;
+        metaKey: boolean;
+        ctrlKey: boolean;
+        nativeEvent?: Event;
+    }) => void;
     /**
      * Whether this part of the grid is in the card's filter selection, so the
      * viewer can mark it. Absent when the card has nothing selected, which lets
@@ -17,8 +22,12 @@ export type MatrixInteractionHost = Pick<MatrixInteractionInput, 'resolveField'
     drill: (context: NonNullable<MatrixInteraction['context']>, measure: NonNullable<MatrixInteraction['measure']>) => void;
 };
 /** The host adapts Matrix gestures to selection and drill callbacks; it owns no query or permission policy. */
-export declare function MatrixInteractionActions({ input, host, menu, }: {
+export declare function MatrixInteractionActions({ input, host, }: {
+    input: Omit<MatrixInteractionInput, 'resolveField' | 'capabilities'>;
+    host?: MatrixInteractionHost;
+}): import("react/jsx-runtime").JSX.Element | null;
+/** Cell-level drill access after the redundant floating selection toolbar was removed. */
+export declare function MatrixCellDrillAction({ input, host, }: {
     input: Omit<MatrixInteractionInput, 'resolveField' | 'capabilities'>;
     host?: MatrixInteractionHost;
-    menu?: boolean;
 }): import("react/jsx-runtime").JSX.Element | null;

package/dist/types/components/visual/matrix-table/matrix-window-viewer.d.ts

@@ -15,7 +15,7 @@ type Props = Parameters<typeof useMatrix>[0] & {
         }) => void;
     };
     interactions?: MatrixInteractionHost;
-    onSelectionChange?: (coordinate: MatrixCoordinate | undefined) => void;
+    onCellFocusChange?: (coordinate: MatrixCoordinate | undefined) => void;
     /** Explicit persist of the live view; hosts write it to the card. */
     onPersistView?: (view: MatrixViewState) => void;
     /** Show technical failure diagnostics (owners and editors only). */

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/matrix-table/matrix-runtime-types.d.ts

@@ -111,7 +111,4 @@ export declare const MATRIX_RUNTIME_LIMITS: Readonly<{
     checkpoints: 64;
     overrides: 2000;
     mountedCells: 5000;
-    clipboardCells: 10000;
-    clipboardBytes: number;
-    clipboardTimeoutMs: 30000;
 }>;

package/dist/types/lib/matrix-table/matrix-runtime.d.ts

@@ -28,8 +28,6 @@ export declare class MatrixRuntimeController {
     private view;
     private spec;
     private snapshot;
-    private copyDemand?;
-    private rejectCopy?;
     constructor(input: MatrixRuntimeInput, query: QueryClient, execute: MatrixWindowExecutor, session?: MatrixViewState);
     subscribe: (listener: () => void) => () => boolean;
     getSnapshot: () => MatrixRuntimeSnapshot;
@@ -53,8 +51,6 @@ export declare class MatrixRuntimeController {
     /** Used by explicit refresh/retry integrations; latest-issued response wins. */
     refetchCell: (coordinate: MatrixCoordinate) => void;
     refetchPage: (key: string) => void;
-    /** Clipboard demand shares page-owner tiles, the queue and retention policy. */
-    acquireCells: (coordinates: readonly MatrixCoordinate[], signal?: AbortSignal) => Promise<MatrixCellState[]>;
     private visible;
     private plan;
     private loadPage;

package/dist/types/lib/matrix-table/{use-matrix-selection.d.ts → use-matrix-cell-focus.d.ts}

@@ -1,18 +1,21 @@
 import { KeyboardEvent } from 'react';
-import { MatrixCoordinate, MatrixPresentation, MatrixSpec } from '../../shared/analytics-protocol/index.js';
+import { MatrixCoordinate, MatrixSpec } from '../../shared/analytics-protocol/index.js';
 import { MatrixRuntime } from './use-matrix.js';
-/** Selection is view-local; only explicit copy asks the runtime for missing cells. */
-export declare function useMatrixSelection(input: {
+/**
+ * One view-local active cell for grid navigation and editor field scoping.
+ * Dashboard selection remains owned by the selection input runtime.
+ */
+export declare function useMatrixCellFocus(input: {
     runtime: MatrixRuntime;
     spec: MatrixSpec;
-    absence: MatrixPresentation['absence'];
     reveal: (row: number, valueColumn: number) => void;
-    onSelectionChange?: (coordinate: MatrixCoordinate | undefined) => void;
+    onFocusChange?: (coordinate: MatrixCoordinate | undefined) => void;
+    onActivate?: (coordinate: MatrixCoordinate, event: KeyboardEvent<HTMLDivElement>) => void;
 }): {
     hasFocus: boolean;
     focusedRow: number;
     focusedColumn: number;
-    selectedCoordinate: {
+    coordinate: {
         rowPath: readonly {
             member: {
                 value: string | number | boolean | {
@@ -43,17 +46,10 @@ export declare function useMatrixSelection(input: {
         }[];
         measureId: string;
     } | undefined;
-    /** Inclusive row and value-column bounds of the current selection. */
-    range: {
-        rows: readonly [number, number];
-        columns: readonly [number, number];
-    } | null;
-    copyState: string;
-    copyPending: boolean;
-    copy: () => Promise<void>;
     keyboard: (event: KeyboardEvent<HTMLDivElement>) => void;
-    select: (rowIndex: number, valueColumn: number, extend: boolean) => void;
-    /** Drop the selection; the pill's clear button and Escape share it. */
+    setFocus: (rowIndex: number, valueColumn: number, options?: {
+        toggle?: boolean;
+    }) => void;
     clear: () => void;
-    selected: (r: number, c: number) => boolean;
+    isFocused: (rowIndex: number, valueColumn: number) => boolean;
 };

package/dist/types/lib/matrix-table/use-matrix.d.ts

@@ -25,7 +25,6 @@ export declare function useMatrix(input: MatrixInput): {
         }>;
     };
     readCell: (coordinate: import('./matrix-runtime-types.js').MatrixCellAddress) => import('./matrix-runtime-types.js').MatrixCellState;
-    acquireCells: (coordinates: readonly import('../../shared/analytics-protocol/index.js').MatrixCoordinate[], signal?: AbortSignal) => Promise<import('./matrix-runtime-types.js').MatrixCellState[]>;
     setViewport: (viewport: import('./matrix-runtime-types.js').MatrixViewport) => void;
     retry: (retryKey: string) => void;
     refresh: () => void;

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.508",
+  "version": "0.1.510",
   "description": "Fully interactive and customizable dashboards for your apps.",
   "keywords": [
     "react",