react-semaphor 0.1.19 → 0.1.21

package/dist/surfboard/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../chunks/dashboard-plus-_lhN-s45.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-CxeKQLr6.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-XEKMZ7Lk.js";
+import { D as f } from "../chunks/dashboard-plus-DNG6HyXE.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 & {
@@ -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

@@ -344,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;
@@ -506,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;
@@ -684,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';
@@ -964,6 +973,7 @@ declare type FilterForCompare = BaseFilter & {
 declare type FilterForDate = BaseFilter & {
     operation: 'between' | 'not between';
     values: [Date, Date];
+    relativeMeta?: RelativeDateFilter;
 };
 
 declare type FilterForEqual = BaseFilter & {
@@ -1323,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;
@@ -2109,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 & {
@@ -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 & {
@@ -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.1.19",
+  "version": "0.1.21",
   "description": "Fully interactive and customizable dashboards for your apps.",
   "keywords": [
     "react",