react-semaphor 0.1.133 → 0.1.135

package/dist/surfboard/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../chunks/index-BCmbfOd2.js"),r=require("../types/index.cjs");exports.Surfboard=e.DashboardPlus;exports.EMPTY_SELECTION=r.EMPTY_SELECTION;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../chunks/index-DACjdh6Y.js"),r=require("../types/index.cjs");exports.Surfboard=e.DashboardPlus;exports.EMPTY_SELECTION=r.EMPTY_SELECTION;

package/dist/surfboard/index.js

@@ -1,4 +1,4 @@
-import { a } from "../chunks/index-DilTtW4W.js";
+import { a } from "../chunks/index-DwAURM9i.js";
 import { EMPTY_SELECTION as E } from "../types/index.js";
 export {
   E as EMPTY_SELECTION,

package/dist/types/dashboard.d.ts

@@ -1213,6 +1213,11 @@ export declare type TCard = {
      * If not specified, the card will use the dashboard's display preferences.
      */
     displayPreferences?: VisualDisplayPreferences;
+    /**
+     * Inline filter definitions for this card.
+     * Configured by editors via the visual editor settings.
+     */
+    inlineFilters?: TInlineFilter[];
 };
 
 export declare type TCardContext = {
@@ -1371,6 +1376,14 @@ export declare type TCustomCardPreferences = {
     }[];
 };
 
+declare type TCustomFilterPreferences = {
+    url: string;
+    componentName: string;
+    pluginFilterType?: string;
+    icon?: string;
+    settings?: Record<string, string | number | boolean>;
+};
+
 export declare type TDashboard = {
     id: string;
     title?: string;
@@ -1463,6 +1476,9 @@ declare type TFilter = {
     excludeSheetIds?: string[];
     applyToCardIds?: string[];
     excludeCardIds?: string[];
+    customFilterPreferences?: TCustomFilterPreferences;
+    /** Whether to show the label above the filter (default: true) */
+    showLabel?: boolean;
 };
 
 declare type TFilterValue = FilterForString | FilterForEqual | FilterForCompare | FilterForBetween | FilterForIn | FilterForDate;
@@ -1529,6 +1545,41 @@ declare interface TimeDrillStep {
 
 declare type TimeGranularity = 'day' | 'week' | 'month' | 'quarter' | 'year';
 
+/**
+ * Inline filter definition stored on a card.
+ * Inline filters appear on the right-hand side of the card header,
+ * allowing ad-hoc data exploration without affecting other cards.
+ */
+export declare type TInlineFilter = {
+    id: string;
+    column: string;
+    title: string;
+    dataType: string;
+    table: string;
+    database: string;
+    connectionId: string;
+    operation: Operation;
+    sql: string;
+    /** Selection type: 'single' allows one value, 'multiple' allows many */
+    type?: 'single' | 'multiple';
+    /** UI component for single-select filters */
+    uiType?: 'radio' | 'dropdown' | 'tabs';
+    /** Date picker type: 'range' for full calendar, 'months' for month picker */
+    dateSelectionMode?: DateSelectionMode;
+    /** Default values applied when the dashboard first loads */
+    defaultValues?: (string | number)[];
+    /** Default relative date filter (e.g., "Last 7 days") applied on dashboard load */
+    defaultDateFilter?: RelativeDateFilter;
+    /** Search mode for numeric filters: 'text' treats as text, 'numeric' enables operators (>, <, =) */
+    searchMode?: 'text' | 'numeric' | 'auto';
+    /** Custom filter UI from a plugin */
+    customFilterPreferences?: TCustomFilterPreferences;
+    /** Width of the inline filter in pixels (default: 250) */
+    width?: number;
+    /** Whether to show the label above the filter (default: true) */
+    showLabel?: boolean;
+};
+
 export declare type TLegendOptions = {
     display?: boolean;
     position?: 'top' | 'left' | 'bottom' | 'right';

package/dist/types/main.d.ts

@@ -68,6 +68,13 @@ declare type Actions = {
     setCardKpiOptions: (sheetId: string, cardId: string, kpiOptions: Record<string, any>) => void;
     updateCardFilters: (cardId: string, filters: FilterGroup | undefined) => void;
     clearCardFilters: (cardId: string) => void;
+    setCardInlineFilterValue: (cardId: string, filterValue: TFilterValue) => void;
+    removeCardInlineFilterValue: (cardId: string, filterId: string) => void;
+    getCardInlineFilterValues: (cardId: string) => TFilterValue[];
+    clearAllInlineFilterValues: () => void;
+    setInlineFilterValuesMap: (map: Record<string, TFilterValue[]>) => void;
+    setCardInlineFilterMode: (sheetId: string, cardId: string, filterId: string, filterMode: 'include' | 'exclude') => void;
+    setCardInlineFilterDefaultValues: (sheetId: string, cardId: string, filterId: string, defaultValues: (string | number)[] | undefined) => void;
     addFrame: (sheetId: string, frame: TFrame, position?: 'start' | 'end') => void;
     updateFrame: (sheetId: string, frame: TFrame) => void;
     updateCard: (sheetId: string, card: TCard) => void;
@@ -765,6 +772,8 @@ export declare type DashboardStore = {
     showDashboardJSON: boolean;
     showFilters: boolean;
     filterValues?: TFilterValue[];
+    /** Runtime-only inline filter values, keyed by cardId. Not persisted with dashboard. */
+    inlineFilterValuesMap: Record<string, TFilterValue[]>;
     isDashboardPanelOpen: boolean;
     drillHistory: Array<{
         sourceDashboardId: string;
@@ -2149,6 +2158,11 @@ export declare type TCard = {
      * If not specified, the card will use the dashboard's display preferences.
      */
     displayPreferences?: VisualDisplayPreferences;
+    /**
+     * Inline filter definitions for this card.
+     * Configured by editors via the visual editor settings.
+     */
+    inlineFilters?: TInlineFilter[];
 };
 
 export declare type TCardContext = {
@@ -2309,6 +2323,14 @@ export declare type TCustomCardPreferences = {
     }[];
 };
 
+declare type TCustomFilterPreferences = {
+    url: string;
+    componentName: string;
+    pluginFilterType?: string;
+    icon?: string;
+    settings?: Record<string, string | number | boolean>;
+};
+
 export declare type TDashboard = {
     id: string;
     title?: string;
@@ -2401,6 +2423,9 @@ declare type TFilter = {
     excludeSheetIds?: string[];
     applyToCardIds?: string[];
     excludeCardIds?: string[];
+    customFilterPreferences?: TCustomFilterPreferences;
+    /** Whether to show the label above the filter (default: true) */
+    showLabel?: boolean;
 };
 
 export declare type TFilterValue = FilterForString | FilterForEqual | FilterForCompare | FilterForBetween | FilterForIn | FilterForDate;
@@ -2473,6 +2498,41 @@ export declare interface TimeDrillStep {
 
 export declare type TimeGranularity = 'day' | 'week' | 'month' | 'quarter' | 'year';
 
+/**
+ * Inline filter definition stored on a card.
+ * Inline filters appear on the right-hand side of the card header,
+ * allowing ad-hoc data exploration without affecting other cards.
+ */
+export declare type TInlineFilter = {
+    id: string;
+    column: string;
+    title: string;
+    dataType: string;
+    table: string;
+    database: string;
+    connectionId: string;
+    operation: Operation;
+    sql: string;
+    /** Selection type: 'single' allows one value, 'multiple' allows many */
+    type?: 'single' | 'multiple';
+    /** UI component for single-select filters */
+    uiType?: 'radio' | 'dropdown' | 'tabs';
+    /** Date picker type: 'range' for full calendar, 'months' for month picker */
+    dateSelectionMode?: DateSelectionMode;
+    /** Default values applied when the dashboard first loads */
+    defaultValues?: (string | number)[];
+    /** Default relative date filter (e.g., "Last 7 days") applied on dashboard load */
+    defaultDateFilter?: RelativeDateFilter;
+    /** Search mode for numeric filters: 'text' treats as text, 'numeric' enables operators (>, <, =) */
+    searchMode?: 'text' | 'numeric' | 'auto';
+    /** Custom filter UI from a plugin */
+    customFilterPreferences?: TCustomFilterPreferences;
+    /** Width of the inline filter in pixels (default: 250) */
+    width?: number;
+    /** Whether to show the label above the filter (default: true) */
+    showLabel?: boolean;
+};
+
 export declare type TLegendOptions = {
     display?: boolean;
     position?: 'top' | 'left' | 'bottom' | 'right';

package/dist/types/surfboard.d.ts

@@ -1218,6 +1218,11 @@ export declare type TCard = {
      * If not specified, the card will use the dashboard's display preferences.
      */
     displayPreferences?: VisualDisplayPreferences;
+    /**
+     * Inline filter definitions for this card.
+     * Configured by editors via the visual editor settings.
+     */
+    inlineFilters?: TInlineFilter[];
 };
 
 export declare type TCardContext = {
@@ -1376,6 +1381,14 @@ export declare type TCustomCardPreferences = {
     }[];
 };
 
+declare type TCustomFilterPreferences = {
+    url: string;
+    componentName: string;
+    pluginFilterType?: string;
+    icon?: string;
+    settings?: Record<string, string | number | boolean>;
+};
+
 export declare type TDashboard = {
     id: string;
     title?: string;
@@ -1468,6 +1481,9 @@ declare type TFilter = {
     excludeSheetIds?: string[];
     applyToCardIds?: string[];
     excludeCardIds?: string[];
+    customFilterPreferences?: TCustomFilterPreferences;
+    /** Whether to show the label above the filter (default: true) */
+    showLabel?: boolean;
 };
 
 declare type TFilterValue = FilterForString | FilterForEqual | FilterForCompare | FilterForBetween | FilterForIn | FilterForDate;
@@ -1534,6 +1550,41 @@ declare interface TimeDrillStep {
 
 declare type TimeGranularity = 'day' | 'week' | 'month' | 'quarter' | 'year';
 
+/**
+ * Inline filter definition stored on a card.
+ * Inline filters appear on the right-hand side of the card header,
+ * allowing ad-hoc data exploration without affecting other cards.
+ */
+export declare type TInlineFilter = {
+    id: string;
+    column: string;
+    title: string;
+    dataType: string;
+    table: string;
+    database: string;
+    connectionId: string;
+    operation: Operation;
+    sql: string;
+    /** Selection type: 'single' allows one value, 'multiple' allows many */
+    type?: 'single' | 'multiple';
+    /** UI component for single-select filters */
+    uiType?: 'radio' | 'dropdown' | 'tabs';
+    /** Date picker type: 'range' for full calendar, 'months' for month picker */
+    dateSelectionMode?: DateSelectionMode;
+    /** Default values applied when the dashboard first loads */
+    defaultValues?: (string | number)[];
+    /** Default relative date filter (e.g., "Last 7 days") applied on dashboard load */
+    defaultDateFilter?: RelativeDateFilter;
+    /** Search mode for numeric filters: 'text' treats as text, 'numeric' enables operators (>, <, =) */
+    searchMode?: 'text' | 'numeric' | 'auto';
+    /** Custom filter UI from a plugin */
+    customFilterPreferences?: TCustomFilterPreferences;
+    /** Width of the inline filter in pixels (default: 250) */
+    width?: number;
+    /** Whether to show the label above the filter (default: true) */
+    showLabel?: boolean;
+};
+
 export declare type TLegendOptions = {
     display?: boolean;
     position?: 'top' | 'left' | 'bottom' | 'right';

package/dist/types/types.d.ts

@@ -1210,6 +1210,11 @@ export declare type TCard = {
      * If not specified, the card will use the dashboard's display preferences.
      */
     displayPreferences?: VisualDisplayPreferences;
+    /**
+     * Inline filter definitions for this card.
+     * Configured by editors via the visual editor settings.
+     */
+    inlineFilters?: TInlineFilter[];
 };
 
 export declare type TCardContext = {
@@ -1368,6 +1373,14 @@ export declare type TCustomCardPreferences = {
     }[];
 };
 
+declare type TCustomFilterPreferences = {
+    url: string;
+    componentName: string;
+    pluginFilterType?: string;
+    icon?: string;
+    settings?: Record<string, string | number | boolean>;
+};
+
 export declare type TDashboard = {
     id: string;
     title?: string;
@@ -1460,6 +1473,9 @@ declare type TFilter = {
     excludeSheetIds?: string[];
     applyToCardIds?: string[];
     excludeCardIds?: string[];
+    customFilterPreferences?: TCustomFilterPreferences;
+    /** Whether to show the label above the filter (default: true) */
+    showLabel?: boolean;
 };
 
 declare type TFilterValue = FilterForString | FilterForEqual | FilterForCompare | FilterForBetween | FilterForIn | FilterForDate;
@@ -1526,6 +1542,41 @@ declare interface TimeDrillStep {
 
 declare type TimeGranularity = 'day' | 'week' | 'month' | 'quarter' | 'year';
 
+/**
+ * Inline filter definition stored on a card.
+ * Inline filters appear on the right-hand side of the card header,
+ * allowing ad-hoc data exploration without affecting other cards.
+ */
+export declare type TInlineFilter = {
+    id: string;
+    column: string;
+    title: string;
+    dataType: string;
+    table: string;
+    database: string;
+    connectionId: string;
+    operation: Operation;
+    sql: string;
+    /** Selection type: 'single' allows one value, 'multiple' allows many */
+    type?: 'single' | 'multiple';
+    /** UI component for single-select filters */
+    uiType?: 'radio' | 'dropdown' | 'tabs';
+    /** Date picker type: 'range' for full calendar, 'months' for month picker */
+    dateSelectionMode?: DateSelectionMode;
+    /** Default values applied when the dashboard first loads */
+    defaultValues?: (string | number)[];
+    /** Default relative date filter (e.g., "Last 7 days") applied on dashboard load */
+    defaultDateFilter?: RelativeDateFilter;
+    /** Search mode for numeric filters: 'text' treats as text, 'numeric' enables operators (>, <, =) */
+    searchMode?: 'text' | 'numeric' | 'auto';
+    /** Custom filter UI from a plugin */
+    customFilterPreferences?: TCustomFilterPreferences;
+    /** Width of the inline filter in pixels (default: 250) */
+    width?: number;
+    /** Whether to show the label above the filter (default: true) */
+    showLabel?: boolean;
+};
+
 export declare type TLegendOptions = {
     display?: boolean;
     position?: 'top' | 'left' | 'bottom' | 'right';

package/package.json

@@ -5,7 +5,7 @@
     "email": "support@semaphor.cloud"
   },
   "license": "MIT",
-  "version": "0.1.133",
+  "version": "0.1.135",
   "description": "Fully interactive and customizable dashboards for your apps.",
   "keywords": [
     "react",