react-semaphor 0.1.446 → 0.1.448

package/dist/surfboard/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../chunks/dashboard-DGX9b3T-.cjs"),r=require("../chunks/common-types-CQ6SHfLk.cjs"),o=require("../chunks/report-preferences-dialog-CBMox_qt.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-zREDXi6s.cjs"),r=require("../chunks/common-types-CQ6SHfLk.cjs"),o=require("../chunks/report-preferences-dialog-BRGOibDO.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 { a, b as o } from "../chunks/dashboard-ECv6p6DC.js";
-import { C as f, E } from "../chunks/common-types-DFsDdpH7.js";
-import { R as t } from "../chunks/report-preferences-dialog-CkZ2KHWX.js";
+import { b as a, a as o } from "../chunks/index-CxnEYRCF.js";
+import { C as f, E } from "../chunks/common-types-B7Jk3Rtj.js";
+import { R as t } from "../chunks/report-preferences-dialog-lyC6PCs9.js";
 export {
   f as CONTROL_CARD_DEFAULT_VALUE,
   a as DisplayFormatPreferencesFields,

package/dist/types/brand-studio.d.ts

@@ -1,4 +1,4 @@
-import { default as default_2 } from 'react';
+import { JSX } from 'react/jsx-runtime';
 
 declare const APPEARANCE_SPEC_VERSION: 1;
 
@@ -101,7 +101,7 @@ export declare type BrandStudioDraft = {
     };
 };
 
-export declare function BrandStudioEditor({ appearance, previewTitle, isLoading, isSaving, error, className, onDraftChange, onSave, onClearConfig, onCancel, }: BrandStudioEditorProps): default_2.JSX.Element;
+export declare function BrandStudioEditor({ appearance, previewTitle, isLoading, isSaving, error, className, onDraftChange, onSave, onClearConfig, onCancel, }: BrandStudioEditorProps): JSX.Element;
 
 export declare type BrandStudioEditorProps = {
     appearance?: AppearanceSpec | null;

package/dist/types/briefings.d.ts

@@ -1783,6 +1783,11 @@ declare type PersistedInteraction = Interaction & {
 
 declare interface PivotByField extends Field {
     role: 'pivotby';
+    /**
+     * Ordering rule for this field's discovered members. Omitted means `auto`,
+     * so existing cards need no migration.
+     */
+    memberOrder?: PivotMemberOrder;
     /**
      * Query transport policy for grouped temporal pivot members. This is
      * projected into executable config and is never persisted authoring state.
@@ -1790,6 +1795,15 @@ declare interface PivotByField extends Field {
     dateValueMode?: 'canonical' | 'formatted';
 }
 
+/**
+ * Persisted authoring intent for the order of generated pivot-member columns.
+ *
+ * `auto` is a distinct persisted value rather than a synonym for `asc` so a
+ * future governed semantic member order can become the default for `auto`
+ * without changing cards that explicitly chose `asc` or `desc`.
+ */
+declare type PivotMemberOrder = 'auto' | 'asc' | 'desc';
+
 declare type PresentationScope = {
     dashboardId: string;
     cardId?: string;

package/dist/types/dashboard-assistant.d.ts

@@ -924,6 +924,11 @@ declare type Operator = '=' | '!=' | '>' | '>=' | '<' | '<=' | 'contains' | 'sta
 
 declare interface PivotByField extends Field {
     role: 'pivotby';
+    /**
+     * Ordering rule for this field's discovered members. Omitted means `auto`,
+     * so existing cards need no migration.
+     */
+    memberOrder?: PivotMemberOrder;
     /**
      * Query transport policy for grouped temporal pivot members. This is
      * projected into executable config and is never persisted authoring state.
@@ -931,6 +936,15 @@ declare interface PivotByField extends Field {
     dateValueMode?: 'canonical' | 'formatted';
 }
 
+/**
+ * Persisted authoring intent for the order of generated pivot-member columns.
+ *
+ * `auto` is a distinct persisted value rather than a synonym for `asc` so a
+ * future governed semantic member order can become the default for `auto`
+ * without changing cards that explicitly chose `asc` or `desc`.
+ */
+declare type PivotMemberOrder = 'auto' | 'asc' | 'desc';
+
 declare type PivotResultColumnClassification = {
     isSubtotal?: boolean;
     subtotalScope?: 'base' | 'pivot-value' | 'grand-total';

package/dist/types/dashboard-authoring.d.ts

@@ -1942,6 +1942,11 @@ declare type PersistedInteraction = Interaction & {
 
 declare interface PivotByField extends Field {
     role: 'pivotby';
+    /**
+     * Ordering rule for this field's discovered members. Omitted means `auto`,
+     * so existing cards need no migration.
+     */
+    memberOrder?: PivotMemberOrder;
     /**
      * Query transport policy for grouped temporal pivot members. This is
      * projected into executable config and is never persisted authoring state.
@@ -1949,6 +1954,15 @@ declare interface PivotByField extends Field {
     dateValueMode?: 'canonical' | 'formatted';
 }
 
+/**
+ * Persisted authoring intent for the order of generated pivot-member columns.
+ *
+ * `auto` is a distinct persisted value rather than a synonym for `asc` so a
+ * future governed semantic member order can become the default for `auto`
+ * without changing cards that explicitly chose `asc` or `desc`.
+ */
+declare type PivotMemberOrder = 'auto' | 'asc' | 'desc';
+
 export declare function preferDashboardAuthoringSourceMetadata(current: SemaphorSourceRef, next: SemaphorSourceRef): SemaphorSourceRef;
 
 export declare function preferredDashboardAuthoringSource(sources: readonly SemaphorSourceRef[]): SemaphorSourceRef | undefined;

package/dist/types/dashboard.d.ts

@@ -1,6 +1,7 @@
 import { ColumnSizingState } from '@tanstack/react-table';
 import { FontSpec } from 'chart.js';
-import { JSX } from 'react';
+import { JSX } from 'react/jsx-runtime';
+import { JSX as JSX_2 } from 'react';
 
 export declare type AggregateCalc = 'AVG' | 'MIN' | 'MAX' | 'SUM' | 'COUNT' | 'COUNT_DISTINCT';
 
@@ -1944,7 +1945,7 @@ declare interface JoinPlan {
 export declare type KPICardProps = {
     card: TCard;
     isLoading?: boolean;
-    renderFilterInfo?: () => JSX.Element | null;
+    renderFilterInfo?: () => JSX_2.Element | null;
 };
 
 export declare type LensInputValuesSnapshot = {
@@ -2130,6 +2131,11 @@ declare type PersistedInteraction = Interaction & {
 
 declare interface PivotByField extends Field {
     role: 'pivotby';
+    /**
+     * Ordering rule for this field's discovered members. Omitted means `auto`,
+     * so existing cards need no migration.
+     */
+    memberOrder?: PivotMemberOrder;
     /**
      * Query transport policy for grouped temporal pivot members. This is
      * projected into executable config and is never persisted authoring state.
@@ -2137,6 +2143,15 @@ declare interface PivotByField extends Field {
     dateValueMode?: 'canonical' | 'formatted';
 }
 
+/**
+ * Persisted authoring intent for the order of generated pivot-member columns.
+ *
+ * `auto` is a distinct persisted value rather than a synonym for `asc` so a
+ * future governed semantic member order can become the default for `auto`
+ * without changing cards that explicitly chose `asc` or `desc`.
+ */
+declare type PivotMemberOrder = 'auto' | 'asc' | 'desc';
+
 export declare type Placeholders = {
     /**
      * Placeholder for the card when there are no records to display.

package/dist/types/data-app-builder.d.ts

@@ -1,4 +1,4 @@
-import * as ReactRuntime from 'react';
+import { JSX } from 'react/jsx-runtime';
 
 export declare type ApiStatus = {
     ok: boolean;
@@ -169,7 +169,7 @@ export declare type BuilderTurnResult = {
     error?: string;
 };
 
-export declare function DataAppBuilder({ projectId, projectName, dataAppId, apiServiceUrl, adapters, }: DataAppBuilderProps): ReactRuntime.JSX.Element;
+export declare function DataAppBuilder({ projectId, projectName, dataAppId, apiServiceUrl, adapters, }: DataAppBuilderProps): JSX.Element;
 
 export declare type DataAppBuilderAdapters = {
     readStatus?: (options: {

package/dist/types/data-app-sdk.d.ts

@@ -1,5 +1,5 @@
 import { CSSProperties } from 'react';
-import { JSX } from 'react';
+import { JSX } from 'react/jsx-runtime';
 import { ReactElement } from 'react';
 import { ReactNode } from 'react';
 

package/dist/types/format-utils.d.ts

@@ -294,6 +294,8 @@ export declare type FlatTableExportTotalsRequest = {
         fieldId: string;
         role: 'detail' | 'groupby' | 'metric';
         behavior: FlatTableExportTotalsBehavior;
+        /** Stable identity for one authored metric instance. */
+        metricAlias?: string;
         label?: string;
     }>;
 };

package/dist/types/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../chunks/common-types-CQ6SHfLk.cjs"),l=require("../chunks/token-types-BdQ8kHBm.cjs"),E=require("../chunks/report-runtime-context-C8LZFsqV.cjs"),t=require("../chunks/pivot-result-identity-CDLRT-YG.cjs");exports.CALCULATED_FIELD_ENTITY_MARKER=e.CALCULATED_FIELD_ENTITY_MARKER;exports.CONTROL_CARD_DEFAULT_VALUE=e.CONTROL_CARD_DEFAULT_VALUE;exports.DATE_FORMAT_VALUES=e.DATE_FORMAT_VALUES;exports.EMPTY_SELECTION=e.EMPTY_SELECTION;exports.PivotMarkerEnum=e.PivotMarkerEnum;exports.getFieldRuntimeColumnName=e.getFieldRuntimeColumnName;exports.hasCalculatedFieldMarker=e.hasCalculatedFieldMarker;exports.hasCalculatedFormulaInputs=e.hasCalculatedFormulaInputs;exports.isCalculatedDimension=e.isCalculatedDimension;exports.isCalculatedField=e.isCalculatedField;exports.isCalculatedMetric=e.isCalculatedMetric;exports.DEFAULT_SEMANTIC_DOMAIN_ACCESS=l.DEFAULT_SEMANTIC_DOMAIN_ACCESS;exports.DEFAULT_CALENDAR_CONTEXT=E.DEFAULT_CALENDAR_CONTEXT;exports.resolveQueryColumnKeyMapEntry=t.resolveQueryColumnKeyMapEntry;exports.resolveUniqueQueryColumnKeyMapEntry=t.resolveUniqueQueryColumnKeyMapEntry;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../chunks/common-types-CQ6SHfLk.cjs"),l=require("../chunks/token-types-BdQ8kHBm.cjs"),t=require("../chunks/pivot-result-identity-CDLRT-YG.cjs"),E=require("../chunks/report-runtime-context-C8LZFsqV.cjs");exports.CALCULATED_FIELD_ENTITY_MARKER=e.CALCULATED_FIELD_ENTITY_MARKER;exports.CONTROL_CARD_DEFAULT_VALUE=e.CONTROL_CARD_DEFAULT_VALUE;exports.DATE_FORMAT_VALUES=e.DATE_FORMAT_VALUES;exports.EMPTY_SELECTION=e.EMPTY_SELECTION;exports.PivotMarkerEnum=e.PivotMarkerEnum;exports.getFieldRuntimeColumnName=e.getFieldRuntimeColumnName;exports.hasCalculatedFieldMarker=e.hasCalculatedFieldMarker;exports.hasCalculatedFormulaInputs=e.hasCalculatedFormulaInputs;exports.isCalculatedDimension=e.isCalculatedDimension;exports.isCalculatedField=e.isCalculatedField;exports.isCalculatedMetric=e.isCalculatedMetric;exports.DEFAULT_SEMANTIC_DOMAIN_ACCESS=l.DEFAULT_SEMANTIC_DOMAIN_ACCESS;exports.resolveQueryColumnKeyMapEntry=t.resolveQueryColumnKeyMapEntry;exports.resolveUniqueQueryColumnKeyMapEntry=t.resolveUniqueQueryColumnKeyMapEntry;exports.DEFAULT_CALENDAR_CONTEXT=E.DEFAULT_CALENDAR_CONTEXT;

package/dist/types/index.js

@@ -1,12 +1,12 @@
-import { a as s, C as r, D as E, E as l, P as C, g as o, h as t, b as A, i as u, c as T, d as _ } from "../chunks/common-types-DFsDdpH7.js";
-import { D } from "../chunks/token-types-DLo91nOf.js";
-import { D as n } from "../chunks/report-runtime-context-Qzn11HQe.js";
-import { r as M, a as d } from "../chunks/pivot-result-identity-B6QCWOSi.js";
+import { a as s, C as r, D as E, E as l, P as C, g as o, d as t, h as A, b as u, c as T, i as _ } from "../chunks/common-types-B7Jk3Rtj.js";
+import { D } from "../chunks/token-types-BHR58aTy.js";
+import { r as n, a as L } from "../chunks/pivot-result-identity-CwJWpKI7.js";
+import { D as d } from "../chunks/report-runtime-context-bCy3CVzK.js";
 export {
   s as CALCULATED_FIELD_ENTITY_MARKER,
   r as CONTROL_CARD_DEFAULT_VALUE,
   E as DATE_FORMAT_VALUES,
-  n as DEFAULT_CALENDAR_CONTEXT,
+  d as DEFAULT_CALENDAR_CONTEXT,
   D as DEFAULT_SEMANTIC_DOMAIN_ACCESS,
   l as EMPTY_SELECTION,
   C as PivotMarkerEnum,
@@ -16,6 +16,6 @@ export {
   u as isCalculatedDimension,
   T as isCalculatedField,
   _ as isCalculatedMetric,
-  M as resolveQueryColumnKeyMapEntry,
-  d as resolveUniqueQueryColumnKeyMapEntry
+  n as resolveQueryColumnKeyMapEntry,
+  L as resolveUniqueQueryColumnKeyMapEntry
 };

package/dist/types/main.d.ts

@@ -1,11 +1,11 @@
 import { Chart as Chart_2 } from 'chart.js';
 import { ColumnSizingState } from '@tanstack/react-table';
 import { DateRange } from 'react-day-picker';
-import { default as default_2 } from 'react';
-import { default as default_3 } from 'react-grid-layout';
+import { default as default_2 } from 'react-grid-layout';
 import { FetchStatus } from '@tanstack/query-core';
 import { FontSpec } from 'chart.js';
-import { JSX } from 'react';
+import { JSX } from 'react/jsx-runtime';
+import { JSX as JSX_2 } from 'react';
 import { JSXElementConstructor } from 'react';
 import { QueryObserverResult } from '@tanstack/query-core';
 import * as React_2 from 'react';
@@ -109,8 +109,8 @@ declare type Actions_2 = {
     setDocumentInputControlValue: (sheetId: string, inputId: string, value: unknown) => void;
     clearDocumentInputRuntime: (sheetId?: string) => void;
     setSelectedSheetId: (sheetId: string | null) => void;
-    setSheetLayout: (sheetId: string, layout: default_3.Layout[]) => void;
-    setSheetLayouts: (sheetId: string, layouts: default_3.Layouts) => void;
+    setSheetLayout: (sheetId: string, layout: default_2.Layout[]) => void;
+    setSheetLayouts: (sheetId: string, layouts: default_2.Layouts) => void;
     setSelectedCardId: (sheetId: string, cardId: string | null) => void;
     setSelectedFrameId: (frameId: string) => void;
     clearSelectedFrameId: () => void;
@@ -185,8 +185,8 @@ declare type Actions_2 = {
     getSelectedFrame: () => TFrame | undefined;
     getCardFrame: (cardId: string) => TFrame | undefined;
     getCardSheet: (cardId: string) => TSheet | undefined;
-    getSelectedSheetLayout: () => default_3.Layout[] | undefined;
-    getSelectedSheetLayouts: () => default_3.Layouts | undefined;
+    getSelectedSheetLayout: () => default_2.Layout[] | undefined;
+    getSelectedSheetLayouts: () => default_2.Layouts | undefined;
     handleDataPointClickAction: (card: TCard, dataPoint: any) => void;
     addBaseQuery: (baseQuery: TBaseQuery) => void;
     removeBaseQuery: (baseQueryId: string) => void;
@@ -1597,7 +1597,7 @@ export declare function Combobox({ name, items, value, onChange, isLoading, isEr
     refetch: () => void;
     className?: string;
     showNone?: boolean;
-}): React_2.JSX.Element;
+}): JSX.Element;
 
 declare type ComboBoxOption = {
     id: number | string;
@@ -3426,7 +3426,7 @@ export declare interface ExportJobStatus {
  * - Completed: Download button with file size
  * - Failed: Error message with dismiss option
  */
-export declare function ExportNotificationItem({ export: exp, onRemove, }: ExportNotificationItemProps): default_2.JSX.Element;
+export declare function ExportNotificationItem({ export: exp, onRemove, }: ExportNotificationItemProps): JSX.Element;
 
 declare interface ExportNotificationItemProps {
     /** The export data to display */
@@ -3441,7 +3441,7 @@ declare interface ExportNotificationItemProps {
  * Displays all active and recent exports with their status,
  * progress, and download options.
  */
-export declare function ExportNotificationList(): default_2.JSX.Element;
+export declare function ExportNotificationList(): JSX.Element;
 
 export declare type ExportStatus = 'pending' | 'processing' | 'chunking' | 'compacting' | 'completed' | 'failed' | 'cancelled';
 
@@ -3702,6 +3702,8 @@ declare type FlatTableExportTotalsRequest = {
         fieldId: string;
         role: 'detail' | 'groupby' | 'metric';
         behavior: FlatTableExportTotalsBehavior;
+        /** Stable identity for one authored metric instance. */
+        metricAlias?: string;
         label?: string;
     }>;
 };
@@ -4124,7 +4126,7 @@ export declare interface JoinPlan {
 export declare type KPICardProps = {
     card: TCard;
     isLoading?: boolean;
-    renderFilterInfo?: () => JSX.Element | null;
+    renderFilterInfo?: () => JSX_2.Element | null;
 };
 
 export declare type LensInputValuesSnapshot = {
@@ -4734,7 +4736,7 @@ export declare function normalizeDashboardForDirtyCheck(dashboard: TDashboard |
  */
 export declare function NotificationBell({ variant, }: {
     variant?: 'outline' | 'ghost';
-}): default_2.JSX.Element;
+}): JSX.Element;
 
 export declare type NumberAxisFormat = {
     decimalPlaces?: number;
@@ -4839,6 +4841,11 @@ export declare type PersistedInteraction = Interaction & {
 
 export declare interface PivotByField extends Field {
     role: 'pivotby';
+    /**
+     * Ordering rule for this field's discovered members. Omitted means `auto`,
+     * so existing cards need no migration.
+     */
+    memberOrder?: PivotMemberOrder;
     /**
      * Query transport policy for grouped temporal pivot members. This is
      * projected into executable config and is never persisted authoring state.
@@ -4887,6 +4894,15 @@ export declare enum PivotMarkerEnum {
     ALL = "__ALL__"
 }
 
+/**
+ * Persisted authoring intent for the order of generated pivot-member columns.
+ *
+ * `auto` is a distinct persisted value rather than a synonym for `asc` so a
+ * future governed semantic member order can become the default for `auto`
+ * without changing cards that explicitly chose `asc` or `desc`.
+ */
+export declare type PivotMemberOrder = 'auto' | 'asc' | 'desc';
+
 declare type PivotResultColumnClassification = {
     isSubtotal?: boolean;
     subtotalScope?: 'base' | 'pivot-value' | 'grand-total';
@@ -7466,6 +7482,7 @@ export declare function useCard(cardId: string): {
     visualKey: number;
     handleDatapointClick: (chart: Chart_2, datasetIndex: number, clickIndex: number, value: number) => void;
     cfg: any;
+    isRetainingSourceResult: boolean;
     queryKey: string[];
     queryRequestPayload: Record<string, unknown> | undefined;
     pagination: PaginationMetadata | undefined;
@@ -7476,7 +7493,7 @@ export declare function useCard(cardId: string): {
 };
 
 export declare function useCardSummary(card: TCard, options?: UseCardSummaryOptions): {
-    data: NoInfer<SummaryResponse> | undefined;
+    data: SummaryResponse | undefined;
     isLoading: boolean;
     isFetching: boolean;
     isError: boolean;
@@ -7508,7 +7525,7 @@ export declare function useDashboardById(dashboardId: string, options?: {
 }): UseQueryResult<any, Error>;
 
 export declare function useDashboardQuery(): {
-    data: NoInfer<{
+    data: {
         initialReportContext: ReportRuntimeContext;
         dashboard: TDashboard;
         lenses: TLens[];
@@ -7518,11 +7535,11 @@ export declare function useDashboardQuery(): {
         assistantProfileId?: string;
         semanticExecutionPayload: SemanticExecutionPayload;
         organizationAppearance?: AppearanceSpec | null;
-    } | null> | undefined;
+    } | null | undefined;
     isLoading: boolean;
     isFetching: boolean;
     isError: boolean;
-    refetch: (options?: RefetchOptions) => Promise<QueryObserverResult<NoInfer<{
+    refetch: (options?: RefetchOptions) => Promise<QueryObserverResult<    {
     initialReportContext: ReportRuntimeContext;
     dashboard: TDashboard;
     lenses: TLens[];
@@ -7532,7 +7549,7 @@ export declare function useDashboardQuery(): {
     assistantProfileId?: string;
     semanticExecutionPayload: SemanticExecutionPayload;
     organizationAppearance?: AppearanceSpec | null;
-    } | null>, Error>>;
+    } | null, Error>>;
     dashboardIdToFetch: string | null;
 };
 
@@ -7542,12 +7559,12 @@ setState(nextStateOrUpdater: DashboardStore | ((state: WritableDraft<DashboardSt
 }>;
 
 export declare function useDashboardSummary(): {
-    data: NoInfer<SummaryResponse> | undefined;
+    data: SummaryResponse | undefined;
     isLoading: boolean;
     isFetching: boolean;
     isError: boolean;
     error: Error | null;
-    refetch: (options?: RefetchOptions) => Promise<QueryObserverResult<NoInfer<SummaryResponse>, Error>>;
+    refetch: (options?: RefetchOptions) => Promise<QueryObserverResult<SummaryResponse, Error>>;
     refresh: UseMutateAsyncFunction<SummaryResponse, Error, void, unknown>;
     isRefreshing: boolean;
     applyAction: (action: SummaryAction) => Promise<void>;

package/dist/types/shared.d.ts

@@ -1667,6 +1667,11 @@ declare type PersistedInteraction = Interaction & {
 
 declare interface PivotByField extends Field {
     role: 'pivotby';
+    /**
+     * Ordering rule for this field's discovered members. Omitted means `auto`,
+     * so existing cards need no migration.
+     */
+    memberOrder?: PivotMemberOrder;
     /**
      * Query transport policy for grouped temporal pivot members. This is
      * projected into executable config and is never persisted authoring state.
@@ -1674,6 +1679,15 @@ declare interface PivotByField extends Field {
     dateValueMode?: 'canonical' | 'formatted';
 }
 
+/**
+ * Persisted authoring intent for the order of generated pivot-member columns.
+ *
+ * `auto` is a distinct persisted value rather than a synonym for `asc` so a
+ * future governed semantic member order can become the default for `auto`
+ * without changing cards that explicitly chose `asc` or `desc`.
+ */
+declare type PivotMemberOrder = 'auto' | 'asc' | 'desc';
+
 declare interface QueryConfig {
     groupByColumns?: GroupByColumn[];
     pivotColumns?: GroupByColumn[];

package/dist/types/surfboard.d.ts

@@ -1,6 +1,7 @@
 import { ColumnSizingState } from '@tanstack/react-table';
 import { FontSpec } from 'chart.js';
-import { JSX } from 'react';
+import { JSX } from 'react/jsx-runtime';
+import { JSX as JSX_2 } from 'react';
 
 export declare type AggregateCalc = 'AVG' | 'MIN' | 'MAX' | 'SUM' | 'COUNT' | 'COUNT_DISTINCT';
 
@@ -1957,7 +1958,7 @@ declare interface JoinPlan {
 export declare type KPICardProps = {
     card: TCard;
     isLoading?: boolean;
-    renderFilterInfo?: () => JSX.Element | null;
+    renderFilterInfo?: () => JSX_2.Element | null;
 };
 
 export declare type LensInputValuesSnapshot = {
@@ -2143,6 +2144,11 @@ declare type PersistedInteraction = Interaction & {
 
 declare interface PivotByField extends Field {
     role: 'pivotby';
+    /**
+     * Ordering rule for this field's discovered members. Omitted means `auto`,
+     * so existing cards need no migration.
+     */
+    memberOrder?: PivotMemberOrder;
     /**
      * Query transport policy for grouped temporal pivot members. This is
      * projected into executable config and is never persisted authoring state.
@@ -2150,6 +2156,15 @@ declare interface PivotByField extends Field {
     dateValueMode?: 'canonical' | 'formatted';
 }
 
+/**
+ * Persisted authoring intent for the order of generated pivot-member columns.
+ *
+ * `auto` is a distinct persisted value rather than a synonym for `asc` so a
+ * future governed semantic member order can become the default for `auto`
+ * without changing cards that explicitly chose `asc` or `desc`.
+ */
+declare type PivotMemberOrder = 'auto' | 'asc' | 'desc';
+
 export declare type Placeholders = {
     /**
      * Placeholder for the card when there are no records to display.

package/dist/types/types.d.ts

@@ -2285,6 +2285,8 @@ declare type FlatTableExportTotalsRequest = {
         fieldId: string;
         role: 'detail' | 'groupby' | 'metric';
         behavior: FlatTableExportTotalsBehavior;
+        /** Stable identity for one authored metric instance. */
+        metricAlias?: string;
         label?: string;
     }>;
 };
@@ -3057,6 +3059,11 @@ declare type PersistedInteraction = Interaction & {
 
 export declare interface PivotByField extends Field {
     role: 'pivotby';
+    /**
+     * Ordering rule for this field's discovered members. Omitted means `auto`,
+     * so existing cards need no migration.
+     */
+    memberOrder?: PivotMemberOrder;
     /**
      * Query transport policy for grouped temporal pivot members. This is
      * projected into executable config and is never persisted authoring state.
@@ -3105,6 +3112,15 @@ export declare enum PivotMarkerEnum {
     ALL = "__ALL__"
 }
 
+/**
+ * Persisted authoring intent for the order of generated pivot-member columns.
+ *
+ * `auto` is a distinct persisted value rather than a synonym for `asc` so a
+ * future governed semantic member order can become the default for `auto`
+ * without changing cards that explicitly chose `asc` or `desc`.
+ */
+export declare type PivotMemberOrder = 'auto' | 'asc' | 'desc';
+
 declare type PivotResultColumnClassification = {
     isSubtotal?: boolean;
     subtotalScope?: 'base' | 'pivot-value' | 'grand-total';

package/package.json

@@ -5,7 +5,7 @@
     "email": "support@semaphor.cloud"
   },
   "license": "MIT",
-  "version": "0.1.446",
+  "version": "0.1.448",
   "description": "Fully interactive and customizable dashboards for your apps.",
   "keywords": [
     "react",
@@ -224,7 +224,6 @@
     "lucide-react": "^0.453.0",
     "ms": "^2.1.3",
     "next-themes": "^0.4.4",
-    "prism-react-renderer": "^2.4.1",
     "prismjs": "^1.30.0",
     "react-day-picker": "^9.9.0",
     "react-error-boundary": "^4.1.2",
@@ -243,8 +242,8 @@
     "zustand": "^5.0.9"
   },
   "peerDependencies": {
-    "react": "^18.0.0 || ^19.0.0",
-    "react-dom": "^18.0.0 || ^19.0.0"
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0"
   },
   "peerDependenciesMeta": {
     "react": {