semaphor 0.0.128 → 0.0.129

package/dist/surfboard/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../chunks/dashboard-plus-DuenxiNV.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/dashboard-plus-BZ8k_sGe.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 { D as f } from "../chunks/dashboard-plus-vO1PNFhv.js";
+import { D as f } from "../chunks/dashboard-plus-qMRXHdYf.js";
 import { EMPTY_SELECTION as a } from "../types/index.js";
 export {
   a as EMPTY_SELECTION,

package/dist/types/dashboard.d.ts

@@ -104,7 +104,7 @@ declare interface CardConfig {
      * Configuration for on-click dashboard filters triggered by this card.
      */
     clickFilterInteractions?: ClickFilterInteraction[];
-    comparisonType?: 'none' | 'previous_period' | 'same_period_last_year' | 'target';
+    comparisonType?: 'none' | 'previous_period' | 'same_period_last_year' | 'target' | 'start_vs_end';
     targetValue?: number;
     showTrendline?: boolean;
     trendlineWindow?: number;
@@ -347,6 +347,8 @@ export declare type DateOptions = {
     options: Intl.DateTimeFormatOptions;
 };
 
+declare type DateUnit = 'day' | 'week' | 'month' | 'quarter' | 'year';
+
 declare type Dialect = 'mysql' | 'postgres' | 'bigquery' | 'redshift' | 'snowflake' | 'clickhouse' | 'duckdb';
 
 export declare type DisplayDataType = 'string' | 'date' | 'number' | 'html' | 'none';
@@ -505,6 +507,7 @@ declare type FilterForCompare = BaseFilter & {
 declare type FilterForDate = BaseFilter & {
     operation: 'between' | 'not between';
     values: [Date, Date];
+    relativeMeta?: RelativeDateFilter;
 };
 
 declare type FilterForEqual = BaseFilter & {
@@ -686,7 +689,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' | 'isNull' | 'isNotNull';
+declare type Operator = '=' | '!=' | '>' | '>=' | '<' | '<=' | 'contains' | 'startsWith' | 'endsWith' | 'in' | 'not in' | 'between' | 'not between' | 'isNull' | 'isNotNull';
 
 declare type OptionsMap = {
     number: NumberOptions;
@@ -752,6 +755,25 @@ declare type RangeValue = {
     gt?: string | number;
 };
 
+declare type RelativeDateFilter = {
+    mode: 'last';
+    n: number;
+    unit: DateUnit;
+    complete?: boolean;
+} | {
+    mode: 'this';
+    unit: DateUnit;
+    toDate?: boolean;
+} | {
+    mode: 'previous';
+    unit: DateUnit;
+} | {
+    mode: 'between';
+    unit: DateUnit;
+    from: number;
+    to: number;
+};
+
 declare type SelectedEntities = DatabaseEntityReference[] | DataModelEntityReference[] | FileEntityReference[];
 
 export declare type SelectionState = Record<Level, string | null>;

package/dist/types/main.d.ts

@@ -18,6 +18,7 @@ import { MetricField as MetricField_2 } from '../types/explorer-types';
 import { PaginationMetadata as PaginationMetadata_2 } from '../types/explorer-types';
 import { PivotByField as PivotByField_2 } from '../types/explorer-types';
 import { QueryObserverResult } from '@tanstack/query-core';
+import * as React_2 from 'react';
 import { RefetchOptions } from '@tanstack/query-core';
 import { StoreApi } from 'zustand';
 import { TBaseQuery as TBaseQuery_2 } from '..';
@@ -70,6 +71,8 @@ declare type Actions = {
     setCardPython: (cardId: string, pythonCode: string) => void;
     setCardDescription: (sheetId: string, cardId: string, description: string) => void;
     setCardKpiOptions: (sheetId: string, cardId: string, kpiOptions: Record<string, any>) => void;
+    updateCardFilters: (cardId: string, filters: FilterGroup | undefined) => void;
+    clearCardFilters: (cardId: string) => void;
     addFrame: (sheetId: string, frame: TFrame, position?: 'start' | 'end') => void;
     updateFrame: (sheetId: string, frame: TFrame) => void;
     updateCard: (sheetId: string, card: TCard) => void;
@@ -250,6 +253,21 @@ export declare type AuthToken = {
     refreshToken?: string;
 };
 
+/**
+ * Metadata for auto-resolved joins returned by the backend
+ *
+ * When the backend auto-resolves joins using semantic relationships,
+ * it returns this metadata alongside the query results.
+ */
+export declare interface AutoJoinMetadata {
+    /** The complete join plan that was auto-resolved */
+    resolvedJoinPlan: JoinPlan;
+    /** Flag indicating the joins were auto-resolved (vs manually configured) */
+    autoResolved: boolean;
+    /** Names of the semantic relationships that were used */
+    relationshipsUsed: string[];
+}
+
 export declare type AxisConfig = {
     enabled?: boolean;
     name?: {
@@ -326,7 +344,7 @@ export declare interface CardConfig {
      * Configuration for on-click dashboard filters triggered by this card.
      */
     clickFilterInteractions?: ClickFilterInteraction[];
-    comparisonType?: 'none' | 'previous_period' | 'same_period_last_year' | 'target';
+    comparisonType?: 'none' | 'previous_period' | 'same_period_last_year' | 'target' | 'start_vs_end';
     targetValue?: number;
     showTrendline?: boolean;
     trendlineWindow?: number;
@@ -452,6 +470,22 @@ declare type ColumnSettingsMap = Record<string, ColumnSettings>;
 
 export declare type ColumnType = 'string' | 'number' | 'date';
 
+export declare function Combobox({ name, items, value, onChange, isLoading, isError, refetch, className, icon, showNone, }: {
+    icon?: React_2.ReactNode;
+    name?: string;
+    items: {
+        id: string;
+        name: string;
+    }[];
+    value: string;
+    onChange: (value: string) => void;
+    isLoading: boolean;
+    isError: boolean;
+    refetch: () => void;
+    className?: string;
+    showNone?: boolean;
+}): JSX_2.Element;
+
 declare type ComboBoxOption = {
     id: number | string;
     value: string;
@@ -472,6 +506,13 @@ export declare type ConnectionType = 'GoogleSheets' | 'MySQL' | 'MSSQL' | 'Postg
 
 export declare type ContainerId = 'groupBy' | 'metrics' | 'pivotBy' | 'sortBy' | 'source';
 
+/**
+ * Factory function to create empty KPI card configuration
+ * Returns a fresh config with new array instances to prevent shared references
+ * Used when switching to KPI chart type
+ */
+export declare const createEmptyKpiConfig: () => CardConfig;
+
 export declare function createSqlGenConfig(column: TDataColumn, preSqlGen: SqlGen, calc?: AggregateCalc): SqlGen;
 
 export declare type CustomCard = CardWithContent | CardWithFooter;
@@ -650,6 +691,8 @@ export declare type DateOptions = {
 
 export { DateRange }
 
+declare type DateUnit = 'day' | 'week' | 'month' | 'quarter' | 'year';
+
 export declare type Dialect = 'mysql' | 'postgres' | 'bigquery' | 'redshift' | 'snowflake' | 'clickhouse' | 'duckdb';
 
 export declare type DisplayDataType = 'string' | 'date' | 'number' | 'html' | 'none';
@@ -930,6 +973,7 @@ declare type FilterForCompare = BaseFilter & {
 declare type FilterForDate = BaseFilter & {
     operation: 'between' | 'not between';
     values: [Date, Date];
+    relativeMeta?: RelativeDateFilter;
 };
 
 declare type FilterForEqual = BaseFilter & {
@@ -1184,7 +1228,7 @@ export declare type OldFilterValue = string | number | null | (string | number)[
 
 declare type Operation = '=' | '>' | '<' | '>=' | '<=' | '!=' | 'in' | 'not in' | 'like' | 'not like' | 'between' | 'not between' | 'is null' | 'is not null';
 
-export declare type Operator = '=' | '!=' | '>' | '>=' | '<' | '<=' | 'contains' | 'startsWith' | 'endsWith' | 'in' | 'not in' | 'between' | 'isNull' | 'isNotNull';
+export declare type Operator = '=' | '!=' | '>' | '>=' | '<' | '<=' | 'contains' | 'startsWith' | 'endsWith' | 'in' | 'not in' | 'between' | 'not between' | 'isNull' | 'isNotNull';
 
 declare type OptionsMap = {
     number: NumberOptions;
@@ -1289,6 +1333,25 @@ export declare type RangeValue = {
     gt?: string | number;
 };
 
+declare type RelativeDateFilter = {
+    mode: 'last';
+    n: number;
+    unit: DateUnit;
+    complete?: boolean;
+} | {
+    mode: 'this';
+    unit: DateUnit;
+    toDate?: boolean;
+} | {
+    mode: 'previous';
+    unit: DateUnit;
+} | {
+    mode: 'between';
+    unit: DateUnit;
+    from: number;
+    to: number;
+};
+
 export declare function resolveDatamodelName(datamodelName: string): string;
 
 export declare const resolveDataType: (value: any) => string;
@@ -1314,31 +1377,10 @@ export declare function ScheduleDashboard({ triggerButtonClassName, }: {
 
 export declare type SchemaItem = DropdownItem;
 
-export declare function SelectComponent({ title, items, value, isLoading, isError, refetch, onChange, showNone, className, disabled, type, }: SelectProps): JSX_2.Element;
-
 export declare type SelectedEntities = DatabaseEntityReference[] | DataModelEntityReference[] | FileEntityReference[];
 
 export declare type SelectionState = Record<Level, string | null>;
 
-declare type SelectProps = {
-    title: string;
-    items: {
-        id: string;
-        name: string;
-    }[];
-    value: string;
-    isLoading: boolean;
-    isError: boolean;
-    refetch: () => void;
-    onChange?: (value: string) => void;
-    showNone?: boolean;
-    className?: string;
-    showIcon?: boolean;
-    connectionTooltip?: string;
-    disabled?: boolean;
-    type?: 'select' | 'combobox';
-};
-
 export declare const SemaphorContextProvider: ({ children, dashboardProps, }: {
     children: React.ReactNode;
     dashboardProps: DashboardProps;
@@ -2096,6 +2138,7 @@ export declare function useDateFilterHook(filterId: string): {
     dateRange: DateRange | undefined;
     handleClear: () => void;
     handleChange: (date: DateRange | undefined) => void;
+    handleRelativeChange: (date: DateRange | undefined, relativeMeta: RelativeDateFilter) => void;
     handleReset: () => void;
 };
 

package/dist/types/surfboard.d.ts

@@ -104,7 +104,7 @@ declare interface CardConfig {
      * Configuration for on-click dashboard filters triggered by this card.
      */
     clickFilterInteractions?: ClickFilterInteraction[];
-    comparisonType?: 'none' | 'previous_period' | 'same_period_last_year' | 'target';
+    comparisonType?: 'none' | 'previous_period' | 'same_period_last_year' | 'target' | 'start_vs_end';
     targetValue?: number;
     showTrendline?: boolean;
     trendlineWindow?: number;
@@ -350,6 +350,8 @@ export declare type DateOptions = {
     options: Intl.DateTimeFormatOptions;
 };
 
+declare type DateUnit = 'day' | 'week' | 'month' | 'quarter' | 'year';
+
 declare type Dialect = 'mysql' | 'postgres' | 'bigquery' | 'redshift' | 'snowflake' | 'clickhouse' | 'duckdb';
 
 export declare type DisplayDataType = 'string' | 'date' | 'number' | 'html' | 'none';
@@ -508,6 +510,7 @@ declare type FilterForCompare = BaseFilter & {
 declare type FilterForDate = BaseFilter & {
     operation: 'between' | 'not between';
     values: [Date, Date];
+    relativeMeta?: RelativeDateFilter;
 };
 
 declare type FilterForEqual = BaseFilter & {
@@ -689,7 +692,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' | 'isNull' | 'isNotNull';
+declare type Operator = '=' | '!=' | '>' | '>=' | '<' | '<=' | 'contains' | 'startsWith' | 'endsWith' | 'in' | 'not in' | 'between' | 'not between' | 'isNull' | 'isNotNull';
 
 declare type OptionsMap = {
     number: NumberOptions;
@@ -755,6 +758,25 @@ declare type RangeValue = {
     gt?: string | number;
 };
 
+declare type RelativeDateFilter = {
+    mode: 'last';
+    n: number;
+    unit: DateUnit;
+    complete?: boolean;
+} | {
+    mode: 'this';
+    unit: DateUnit;
+    toDate?: boolean;
+} | {
+    mode: 'previous';
+    unit: DateUnit;
+} | {
+    mode: 'between';
+    unit: DateUnit;
+    from: number;
+    to: number;
+};
+
 declare type SelectedEntities = DatabaseEntityReference[] | DataModelEntityReference[] | FileEntityReference[];
 
 export declare type SelectionState = Record<Level, string | null>;

package/dist/types/types.d.ts

@@ -103,7 +103,7 @@ declare interface CardConfig {
      * Configuration for on-click dashboard filters triggered by this card.
      */
     clickFilterInteractions?: ClickFilterInteraction[];
-    comparisonType?: 'none' | 'previous_period' | 'same_period_last_year' | 'target';
+    comparisonType?: 'none' | 'previous_period' | 'same_period_last_year' | 'target' | 'start_vs_end';
     targetValue?: number;
     showTrendline?: boolean;
     trendlineWindow?: number;
@@ -344,6 +344,8 @@ export declare type DateOptions = {
     options: Intl.DateTimeFormatOptions;
 };
 
+declare type DateUnit = 'day' | 'week' | 'month' | 'quarter' | 'year';
+
 declare type Dialect = 'mysql' | 'postgres' | 'bigquery' | 'redshift' | 'snowflake' | 'clickhouse' | 'duckdb';
 
 export declare type DisplayDataType = 'string' | 'date' | 'number' | 'html' | 'none';
@@ -502,6 +504,7 @@ declare type FilterForCompare = BaseFilter & {
 declare type FilterForDate = BaseFilter & {
     operation: 'between' | 'not between';
     values: [Date, Date];
+    relativeMeta?: RelativeDateFilter;
 };
 
 declare type FilterForEqual = BaseFilter & {
@@ -683,7 +686,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' | 'isNull' | 'isNotNull';
+declare type Operator = '=' | '!=' | '>' | '>=' | '<' | '<=' | 'contains' | 'startsWith' | 'endsWith' | 'in' | 'not in' | 'between' | 'not between' | 'isNull' | 'isNotNull';
 
 declare type OptionsMap = {
     number: NumberOptions;
@@ -749,6 +752,25 @@ declare type RangeValue = {
     gt?: string | number;
 };
 
+declare type RelativeDateFilter = {
+    mode: 'last';
+    n: number;
+    unit: DateUnit;
+    complete?: boolean;
+} | {
+    mode: 'this';
+    unit: DateUnit;
+    toDate?: boolean;
+} | {
+    mode: 'previous';
+    unit: DateUnit;
+} | {
+    mode: 'between';
+    unit: DateUnit;
+    from: number;
+    to: number;
+};
+
 declare type SelectedEntities = DatabaseEntityReference[] | DataModelEntityReference[] | FileEntityReference[];
 
 export declare type SelectionState = Record<Level, string | null>;

package/package.json

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