semaphor 0.0.119 → 0.0.121

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';
 
@@ -7,6 +8,7 @@ declare type AggregateFunction = 'COUNT' | 'SUM' | 'AVG' | 'MIN' | 'MAX' | 'MEDI
 
 declare type AIContext = {
     selectedEntities: SelectedEntities;
+    fileAttachments?: FileAttachment[];
 };
 
 export declare type AIScopeTable = {
@@ -191,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';
@@ -209,6 +214,8 @@ declare interface ColumnSettings {
         useCustomFormat: boolean;
         customFormat: string;
         useRelativeTime: boolean;
+        timezone?: string;
+        sourceTimezone?: string;
     };
     colorRanges: ColorRange_2[];
 }
@@ -236,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;
     /**
@@ -245,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;
@@ -269,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 {
@@ -419,6 +455,17 @@ declare interface Field {
     role?: 'groupby' | 'metric' | 'sortby' | 'pivotby';
 }
 
+declare type FileAttachment = {
+    id: string;
+    name: string;
+    size: number;
+    type: string;
+    data?: string;
+    url?: string;
+    preview?: string;
+    uploadProgress?: number;
+};
+
 declare interface FileEntityReference extends DatabaseEntityReference {
     id: string;
     type: 'file' | 'url' | 'upload';
@@ -492,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;
@@ -641,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;
@@ -775,6 +822,7 @@ declare type TablePreferences = {
     columnSettingsMap?: ColumnSettingsMap;
     selectColumnVisible?: boolean;
     columnVisibility?: Record<string, boolean>;
+    columnSizing?: ColumnSizingState;
     pageSize?: number;
     enableDevModePagination?: boolean;
 };
@@ -813,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 = {
@@ -863,6 +916,7 @@ export declare type TCardPreferences = {
     kpiVisualOptions?: {
         lowerIsBetter?: boolean;
         countryLogoId?: string;
+        valueAlignment?: 'left' | 'center';
         formatOptions?: TFormatOptions;
         metricComparison?: {
             enabled?: boolean;
@@ -1110,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' | 'paginated';
+
+/**
+ * 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';
@@ -6,6 +7,7 @@ declare type AggregateFunction = 'COUNT' | 'SUM' | 'AVG' | 'MIN' | 'MAX' | 'MEDI
 
 declare type AIContext = {
     selectedEntities: SelectedEntities;
+    fileAttachments?: FileAttachment[];
 };
 
 export declare type AIScopeTable = {
@@ -190,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';
@@ -208,6 +213,8 @@ declare interface ColumnSettings {
         useCustomFormat: boolean;
         customFormat: string;
         useRelativeTime: boolean;
+        timezone?: string;
+        sourceTimezone?: string;
     };
     colorRanges: ColorRange_2[];
 }
@@ -230,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;
     /**
@@ -239,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;
@@ -263,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 {
@@ -413,6 +449,17 @@ declare interface Field {
     role?: 'groupby' | 'metric' | 'sortby' | 'pivotby';
 }
 
+declare type FileAttachment = {
+    id: string;
+    name: string;
+    size: number;
+    type: string;
+    data?: string;
+    url?: string;
+    preview?: string;
+    uploadProgress?: number;
+};
+
 declare interface FileEntityReference extends DatabaseEntityReference {
     id: string;
     type: 'file' | 'url' | 'upload';
@@ -486,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;
@@ -635,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;
@@ -767,6 +814,7 @@ declare type TablePreferences = {
     columnSettingsMap?: ColumnSettingsMap;
     selectColumnVisible?: boolean;
     columnVisibility?: Record<string, boolean>;
+    columnSizing?: ColumnSizingState;
     pageSize?: number;
     enableDevModePagination?: boolean;
 };
@@ -805,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 = {
@@ -855,6 +908,7 @@ export declare type TCardPreferences = {
     kpiVisualOptions?: {
         lowerIsBetter?: boolean;
         countryLogoId?: string;
+        valueAlignment?: 'left' | 'center';
         formatOptions?: TFormatOptions;
         metricComparison?: {
             enabled?: boolean;
@@ -1102,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' | 'paginated';
+
+/**
+ * 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.119",
+  "version": "0.0.121",
   "description": "Fully interactive and customizable dashboards for your apps.",
   "keywords": [
     "react",
@@ -46,7 +46,7 @@
     "preview": "vite preview"
   },
   "dependencies": {
-    "@ai-sdk/react": "^1.1.18",
+    "@ai-sdk/react": "^2.0.7",
     "@dnd-kit/core": "^6.3.1",
     "@dnd-kit/sortable": "^10.0.0",
     "@dnd-kit/utilities": "^3.2.2",
@@ -71,7 +71,7 @@
     "@radix-ui/react-select": "^2.1.4",
     "@radix-ui/react-separator": "^1.1.1",
     "@radix-ui/react-slider": "^1.3.5",
-    "@radix-ui/react-slot": "^1.2.2",
+    "@radix-ui/react-slot": "^1.2.3",
     "@radix-ui/react-switch": "^1.1.2",
     "@radix-ui/react-tabs": "^1.1.2",
     "@radix-ui/react-toggle": "^1.1.1",
@@ -79,7 +79,7 @@
     "@tailwindcss/container-queries": "^0.1.1",
     "@tanstack/react-query": "^5.62.15",
     "@tanstack/react-table": "^8.11.7",
-    "ai": "^4.1.46",
+    "ai": "^5.0.7",
     "chart.js": "^4.4.1",
     "chartjs-chart-funnel": "^4.2.4",
     "chartjs-chart-geo": "^4.3.4",
@@ -87,7 +87,8 @@
     "class-variance-authority": "^0.7.0",
     "clsx": "^2.0.0",
     "cmdk": "^1.1.1",
-    "date-fns": "^3.3.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",
@@ -95,7 +96,7 @@
     "ms": "^2.1.3",
     "next-themes": "^0.4.4",
     "prism-react-renderer": "^2.4.1",
-    "react-day-picker": "^8.10.0",
+    "react-day-picker": "^9.9.0",
     "react-error-boundary": "^4.1.2",
     "react-grid-layout": "^1.5.0",
     "react-icons": "^5.0.1",