react-semaphor 0.0.5921 → 0.0.6371

package/dist/types/surfboard.d.ts

@@ -1,3 +1,4 @@
+import { ColumnSizingState } from '@tanstack/react-table';
 import { FontSpec } from 'chart.js';
 import { JSX as JSX_2 } from 'react/jsx-runtime';
 
@@ -192,7 +193,10 @@ declare interface ColorRange_2 {
 declare interface ColumnSettings {
     type: 'none' | 'text' | 'number' | 'date' | 'badge' | 'link' | 'progress';
     textAlign: 'left' | 'center' | 'right';
-    width: string;
+    width: number;
+    minWidth?: number;
+    maxWidth?: number;
+    textOverflow?: 'ellipsis' | 'wrap' | 'clip';
     textWrap: 'wrap' | 'nowrap';
     numberFormat: {
         style: 'decimal' | 'currency' | 'percent';
@@ -210,6 +214,8 @@ declare interface ColumnSettings {
         useCustomFormat: boolean;
         customFormat: string;
         useRelativeTime: boolean;
+        timezone?: string;
+        sourceTimezone?: string;
     };
     colorRanges: ColorRange_2[];
 }
@@ -237,6 +243,33 @@ declare type DashboardPlusProps = {
     showFooter?: boolean;
 } & DashboardProps;
 
+/**
+ * Unified dashboard preferences for both card display and UI modes
+ */
+export declare type DashboardPreferences = {
+    /**
+     * Visual display preferences for cards
+     * Controls how card content is rendered (headers, footers, etc.)
+     */
+    cardDisplay?: VisualDisplayPreferences;
+    /**
+     * UI modes for developer and debug features
+     * Controls what developer tools and debug panels are available
+     */
+    uiMode?: {
+        /**
+         * Enable developer mode
+         * Shows additional controls and debug information
+         */
+        developer?: boolean;
+        /**
+         * Enable console mode
+         * Shows console panel for debugging
+         */
+        console?: boolean;
+    };
+};
+
 export declare type DashboardProps = {
     id?: string;
     /**
@@ -246,10 +279,7 @@ export declare type DashboardProps = {
     /**
      * Default filter values for the dashboard. The dashboard will be filtered by these values when the user loads the dashboard.
      */
-    defaultFilterValues?: {
-        filterId: string;
-        values: string[] | number[];
-    }[] | TFilterValue[];
+    defaultFilterValues?: TFilterValue[];
     customStyle?: TStyle;
     currentTheme?: Theme;
     version?: string;
@@ -270,6 +300,11 @@ export declare type DashboardProps = {
      * The id of the sheet to be selected when the dashboard is loaded.
      */
     selectedSheetId?: string;
+    /**
+     * Unified preferences for dashboard configuration
+     * Includes both card display preferences and UI mode settings
+     */
+    preferences?: DashboardPreferences;
 };
 
 declare interface DatabaseEntityReference {
@@ -504,7 +539,7 @@ declare type FilterOnClick = {
     columnIndex: number;
 };
 
-declare type FilterValue = string | number | boolean | Date | [number, number] | [string, string] | string[] | number[];
+declare type FilterValue = string | number | boolean | Date | null | [number, number] | [string, string] | string[] | number[];
 
 export declare type GetDashboardResponse = {
     dashboard: TDashboard;
@@ -653,7 +688,7 @@ declare type OldFilterValue = string | number | null | (string | number)[] | Ran
 
 declare type Operation = '=' | '>' | '<' | '>=' | '<=' | '!=' | 'in' | 'not in' | 'like' | 'not like' | 'between' | 'not between' | 'is null' | 'is not null';
 
-declare type Operator = '=' | '!=' | '>' | '>=' | '<' | '<=' | 'contains' | 'startsWith' | 'endsWith' | 'in' | 'not in' | 'between';
+declare type Operator = '=' | '!=' | '>' | '>=' | '<' | '<=' | 'contains' | 'startsWith' | 'endsWith' | 'in' | 'not in' | 'between' | 'isNull' | 'isNotNull';
 
 declare type OptionsMap = {
     number: NumberOptions;
@@ -787,6 +822,7 @@ declare type TablePreferences = {
     columnSettingsMap?: ColumnSettingsMap;
     selectColumnVisible?: boolean;
     columnVisibility?: Record<string, boolean>;
+    columnSizing?: ColumnSizingState;
     pageSize?: number;
     enableDevModePagination?: boolean;
 };
@@ -825,6 +861,11 @@ export declare type TCard = {
     lastSelectedSchema?: string;
     lastSelectedTable?: string;
     refreshInterval?: string;
+    /**
+     * Card-specific display preferences that override dashboard-level preferences.
+     * If not specified, the card will use the dashboard's display preferences.
+     */
+    displayPreferences?: VisualDisplayPreferences;
 };
 
 export declare type TCardContext = {
@@ -875,6 +916,7 @@ export declare type TCardPreferences = {
     kpiVisualOptions?: {
         lowerIsBetter?: boolean;
         countryLogoId?: string;
+        valueAlignment?: 'left' | 'center';
         formatOptions?: TFormatOptions;
         metricComparison?: {
             enabled?: boolean;
@@ -1122,4 +1164,41 @@ export declare type TStyle = {
     dark?: StyleProps;
 };
 
+/**
+ * Display mode for visual components - controls which UI elements are shown
+ */
+export declare type VisualDisplayMode = 'full' | 'content-only' | 'print' | 'embed' | 'table-print';
+
+/**
+ * Display preferences for controlling visual component rendering
+ */
+export declare type VisualDisplayPreferences = {
+    /**
+     * Predefined display mode
+     * - 'full': All UI elements (default)
+     * - 'content-only': Just the visualization/table content
+     * - 'print': Optimized for printing (shows title and description, hides interactive elements)
+     * - 'embed': Minimal chrome for embedding in other contexts
+     */
+    mode?: VisualDisplayMode;
+    /**
+     * Override specific UI elements visibility
+     * These overrides take precedence over the mode presets
+     */
+    overrides?: {
+        showHeader?: boolean;
+        showTitle?: boolean;
+        showDescription?: boolean;
+        showTabs?: boolean;
+        showFooter?: boolean;
+        showFilters?: boolean;
+        showBreadcrumbs?: boolean;
+        showRefreshIndicator?: boolean;
+        showFilterInfo?: boolean;
+        showPagination?: boolean;
+        showTableToolbar?: boolean;
+        showColumnSettings?: boolean;
+    };
+};
+
 export { }

package/dist/types/types.d.ts

@@ -1,3 +1,4 @@
+import { ColumnSizingState } from '@tanstack/react-table';
 import { FontSpec } from 'chart.js';
 
 export declare type AggregateCalc = 'AVG' | 'MIN' | 'MAX' | 'SUM' | 'COUNT' | 'COUNT_DISTINCT';
@@ -191,7 +192,10 @@ declare interface ColorRange_2 {
 declare interface ColumnSettings {
     type: 'none' | 'text' | 'number' | 'date' | 'badge' | 'link' | 'progress';
     textAlign: 'left' | 'center' | 'right';
-    width: string;
+    width: number;
+    minWidth?: number;
+    maxWidth?: number;
+    textOverflow?: 'ellipsis' | 'wrap' | 'clip';
     textWrap: 'wrap' | 'nowrap';
     numberFormat: {
         style: 'decimal' | 'currency' | 'percent';
@@ -209,6 +213,8 @@ declare interface ColumnSettings {
         useCustomFormat: boolean;
         customFormat: string;
         useRelativeTime: boolean;
+        timezone?: string;
+        sourceTimezone?: string;
     };
     colorRanges: ColorRange_2[];
 }
@@ -231,6 +237,33 @@ export declare type DashboardEventHandlers = {
     onExportData?: (payload: ExportDataPayload) => void;
 };
 
+/**
+ * Unified dashboard preferences for both card display and UI modes
+ */
+export declare type DashboardPreferences = {
+    /**
+     * Visual display preferences for cards
+     * Controls how card content is rendered (headers, footers, etc.)
+     */
+    cardDisplay?: VisualDisplayPreferences;
+    /**
+     * UI modes for developer and debug features
+     * Controls what developer tools and debug panels are available
+     */
+    uiMode?: {
+        /**
+         * Enable developer mode
+         * Shows additional controls and debug information
+         */
+        developer?: boolean;
+        /**
+         * Enable console mode
+         * Shows console panel for debugging
+         */
+        console?: boolean;
+    };
+};
+
 export declare type DashboardProps = {
     id?: string;
     /**
@@ -240,10 +273,7 @@ export declare type DashboardProps = {
     /**
      * Default filter values for the dashboard. The dashboard will be filtered by these values when the user loads the dashboard.
      */
-    defaultFilterValues?: {
-        filterId: string;
-        values: string[] | number[];
-    }[] | TFilterValue[];
+    defaultFilterValues?: TFilterValue[];
     customStyle?: TStyle;
     currentTheme?: Theme;
     version?: string;
@@ -264,6 +294,11 @@ export declare type DashboardProps = {
      * The id of the sheet to be selected when the dashboard is loaded.
      */
     selectedSheetId?: string;
+    /**
+     * Unified preferences for dashboard configuration
+     * Includes both card display preferences and UI mode settings
+     */
+    preferences?: DashboardPreferences;
 };
 
 declare interface DatabaseEntityReference {
@@ -498,7 +533,7 @@ declare type FilterOnClick = {
     columnIndex: number;
 };
 
-declare type FilterValue = string | number | boolean | Date | [number, number] | [string, string] | string[] | number[];
+declare type FilterValue = string | number | boolean | Date | null | [number, number] | [string, string] | string[] | number[];
 
 export declare type GetDashboardResponse = {
     dashboard: TDashboard;
@@ -647,7 +682,7 @@ declare type OldFilterValue = string | number | null | (string | number)[] | Ran
 
 declare type Operation = '=' | '>' | '<' | '>=' | '<=' | '!=' | 'in' | 'not in' | 'like' | 'not like' | 'between' | 'not between' | 'is null' | 'is not null';
 
-declare type Operator = '=' | '!=' | '>' | '>=' | '<' | '<=' | 'contains' | 'startsWith' | 'endsWith' | 'in' | 'not in' | 'between';
+declare type Operator = '=' | '!=' | '>' | '>=' | '<' | '<=' | 'contains' | 'startsWith' | 'endsWith' | 'in' | 'not in' | 'between' | 'isNull' | 'isNotNull';
 
 declare type OptionsMap = {
     number: NumberOptions;
@@ -779,6 +814,7 @@ declare type TablePreferences = {
     columnSettingsMap?: ColumnSettingsMap;
     selectColumnVisible?: boolean;
     columnVisibility?: Record<string, boolean>;
+    columnSizing?: ColumnSizingState;
     pageSize?: number;
     enableDevModePagination?: boolean;
 };
@@ -817,6 +853,11 @@ export declare type TCard = {
     lastSelectedSchema?: string;
     lastSelectedTable?: string;
     refreshInterval?: string;
+    /**
+     * Card-specific display preferences that override dashboard-level preferences.
+     * If not specified, the card will use the dashboard's display preferences.
+     */
+    displayPreferences?: VisualDisplayPreferences;
 };
 
 export declare type TCardContext = {
@@ -867,6 +908,7 @@ export declare type TCardPreferences = {
     kpiVisualOptions?: {
         lowerIsBetter?: boolean;
         countryLogoId?: string;
+        valueAlignment?: 'left' | 'center';
         formatOptions?: TFormatOptions;
         metricComparison?: {
             enabled?: boolean;
@@ -1114,4 +1156,41 @@ export declare type TStyle = {
     dark?: StyleProps;
 };
 
+/**
+ * Display mode for visual components - controls which UI elements are shown
+ */
+export declare type VisualDisplayMode = 'full' | 'content-only' | 'print' | 'embed' | 'table-print';
+
+/**
+ * Display preferences for controlling visual component rendering
+ */
+export declare type VisualDisplayPreferences = {
+    /**
+     * Predefined display mode
+     * - 'full': All UI elements (default)
+     * - 'content-only': Just the visualization/table content
+     * - 'print': Optimized for printing (shows title and description, hides interactive elements)
+     * - 'embed': Minimal chrome for embedding in other contexts
+     */
+    mode?: VisualDisplayMode;
+    /**
+     * Override specific UI elements visibility
+     * These overrides take precedence over the mode presets
+     */
+    overrides?: {
+        showHeader?: boolean;
+        showTitle?: boolean;
+        showDescription?: boolean;
+        showTabs?: boolean;
+        showFooter?: boolean;
+        showFilters?: boolean;
+        showBreadcrumbs?: boolean;
+        showRefreshIndicator?: boolean;
+        showFilterInfo?: boolean;
+        showPagination?: boolean;
+        showTableToolbar?: boolean;
+        showColumnSettings?: boolean;
+    };
+};
+
 export { }

package/package.json

@@ -5,7 +5,7 @@
     "email": "support@semaphor.cloud"
   },
   "license": "MIT",
-  "version": "0.0.5921",
+  "version": "0.0.6371",
   "description": "Fully interactive and customizable dashboards for your apps.",
   "keywords": [
     "react",
@@ -88,6 +88,7 @@
     "clsx": "^2.0.0",
     "cmdk": "^1.1.1",
     "date-fns": "^3.6.0",
+    "date-fns-tz": "^3.2.0",
     "immer": "^10.0.3",
     "jwt-decode": "^4.0.0",
     "lodash.merge": "^4.6.2",