react-semaphor 0.1.475 → 0.1.477

package/dist/types/format-utils.d.ts

@@ -1473,6 +1473,13 @@ export declare function validateCardExportPresentationSnapshot(input: {
     useFormattedValues: boolean;
 }): void;
 
+/** Validates an authored pattern without formatting or inventing a fallback. */
+export declare function validateRawTemporalPattern(input: {
+    valueKind?: RawTemporalValueKind;
+    dialect: RawTemporalPatternDialect;
+    pattern: string;
+}): void;
+
 /**
  * Validates descriptor exclusivity and datatype compatibility without
  * inferring temporal meaning from a value or display label.

package/dist/types/main.d.ts

@@ -547,6 +547,8 @@ declare type BaseFilter = {
     valueType: 'string' | 'number' | 'date' | 'boolean';
     connectionType?: 'database' | 'api';
     dataType?: string;
+    /** Exact database type retained across dashboard-to-query transport. */
+    nativeDataType?: string;
     fieldMeta?: FilterFieldMeta;
     semanticContext?: FilterSemanticContext;
     /** Governed meaning for canonical grouped-temporal filter values. */
@@ -1608,9 +1610,9 @@ export declare function Combobox({ name, items, value, onChange, isLoading, isEr
 }): JSX.Element;
 
 declare type ComboBoxOption = {
-    id: number | string;
-    value: string;
-    [key: string]: number | string;
+    id: FilterOptionValue;
+    value: FilterOptionValue;
+    [key: string]: FilterOptionValue;
 };
 
 declare type ComparisonAvailability = {
@@ -3671,6 +3673,8 @@ export declare interface Field {
     sourceField?: string;
     qualifiedFieldName: string;
     dataType: string;
+    /** Exact database type when dataType is normalized for analytics/UI use. */
+    nativeDataType?: string;
     description?: string;
     qualifiedEntityName?: string;
     dateFormat?: DateFormatValue;
@@ -3760,6 +3764,8 @@ declare type FilterDisplayMode = 'canvas' | 'toolbar' | 'inherit';
 declare type FilterFieldMeta = Pick<Field, 'name' | 'qualifiedFieldName'> & Partial<Pick<Field, 'id' | 'qualifiedEntityName' | 'entityId' | 'dataType' | 'role' | 'fieldScope'>> & {
     entityName?: Field['entityName'];
     entityType?: string;
+    /** Exact database type used by server-side predicate formatting. */
+    nativeDataType?: string;
     expression?: string;
     calculatedFormula?: CalculatedFieldFormula;
 };
@@ -3783,12 +3789,12 @@ declare type FilterForDate = BaseFilter & {
 
 declare type FilterForEqual = BaseFilter & {
     operation: '=' | '!=';
-    values: [string | number];
+    values: [FilterOptionValue];
 };
 
 declare type FilterForIn = BaseFilter & {
     operation: 'in' | 'not in';
-    values: (string | number)[];
+    values: FilterOptionValue[];
 };
 
 declare type FilterForNull = BaseFilter & {
@@ -3846,6 +3852,8 @@ declare type FilterOnClick = {
     columnIndex: number;
 };
 
+declare type FilterOptionValue = string | number | boolean;
+
 declare type FilterSemanticContext = {
     semanticDomainId?: string;
     selectedEntities?: unknown[];
@@ -5034,8 +5042,10 @@ export declare function pauseBriefing(apiServiceUrl: string, token: string, brie
     briefing: BriefingDetail;
 }>;
 
-declare type PersistedColumnSettings = Omit<Partial<ColumnSettings>, 'numberFormat'> & {
+declare type PersistedColumnSettings = Omit<Partial<ColumnSettings>, 'numberFormat' | 'dateFormat'> & {
     numberFormat?: Partial<ColumnSettings['numberFormat']>;
+    /** Sparse persisted date settings; conditional requirements are enforced by the serializer. */
+    dateFormat?: Partial<ColumnSettings['dateFormat']>;
 };
 
 declare type PersistedColumnSettingsMap = Record<string, PersistedColumnSettings>;
@@ -6957,6 +6967,12 @@ export declare type TDashboard = {
 export declare type TDataColumn = {
     column_name: string;
     data_type: string;
+    /** Exact catalog type when the columns API can prove it independently. */
+    nativeDataType?: string;
+    /** @deprecated Use the API contract spelling `nativeDataType`. */
+    native_data_type?: string;
+    /** Whether `data_type` came from semantic metadata or physical introspection. */
+    dataTypeProvenance?: 'semantic' | 'physical';
     is_nullable?: string;
     label?: string;
     description?: string;
@@ -7182,6 +7198,8 @@ export declare type TFilter = {
     title: string;
     column: string;
     dataType: string;
+    /** Exact database type retained when dataType is a normalized UI category. */
+    nativeDataType?: string;
     table?: string;
     database?: string;
     qualifiedTableName?: string;
@@ -7327,6 +7345,8 @@ export declare type TInlineFilter = {
     column: string;
     title: string;
     dataType: string;
+    /** Exact database type retained when dataType is a normalized UI category. */
+    nativeDataType?: string;
     table: string;
     database: string;
     qualifiedTableName?: string;
@@ -7895,7 +7915,7 @@ export declare function useDataColumns(token?: AuthToken): {
 };
 
 export declare function useDateFilterHook(filterId: string): {
-    records: any;
+    records: Record<string, unknown>[] | undefined;
     isLoading: boolean;
     isFetching: boolean;
     isError: boolean;
@@ -8108,6 +8128,11 @@ export declare function useTextFilterHook(filterId: string): {
     isFetching: boolean;
     isPlaceholderData: boolean;
     isError: boolean;
+    hasNextPage: boolean;
+    hasLoadedMoreOptions: boolean;
+    isFetchingNextPage: boolean;
+    isNextPageError: boolean;
+    loadNextPage: () => void;
     records: ComboBoxOption[];
     selectedRecords: ComboBoxOption[];
     handleChange: (selectedRecords: TSelectedRecord[]) => void;

package/dist/types/shared.d.ts

@@ -62,6 +62,8 @@ declare type BaseFilter = {
     valueType: 'string' | 'number' | 'date' | 'boolean';
     connectionType?: 'database' | 'api';
     dataType?: string;
+    /** Exact database type retained across dashboard-to-query transport. */
+    nativeDataType?: string;
     fieldMeta?: FilterFieldMeta;
     semanticContext?: FilterSemanticContext;
     /** Governed meaning for canonical grouped-temporal filter values. */
@@ -1179,6 +1181,8 @@ declare interface Field {
     sourceField?: string;
     qualifiedFieldName: string;
     dataType: string;
+    /** Exact database type when dataType is normalized for analytics/UI use. */
+    nativeDataType?: string;
     description?: string;
     qualifiedEntityName?: string;
     dateFormat?: DateFormatValue;
@@ -1268,6 +1272,8 @@ declare type FilterDisplayMode = 'canvas' | 'toolbar' | 'inherit';
 declare type FilterFieldMeta = Pick<Field, 'name' | 'qualifiedFieldName'> & Partial<Pick<Field, 'id' | 'qualifiedEntityName' | 'entityId' | 'dataType' | 'role' | 'fieldScope'>> & {
     entityName?: Field['entityName'];
     entityType?: string;
+    /** Exact database type used by server-side predicate formatting. */
+    nativeDataType?: string;
     expression?: string;
     calculatedFormula?: CalculatedFieldFormula;
 };
@@ -1291,12 +1297,12 @@ declare type FilterForDate = BaseFilter & {
 
 declare type FilterForEqual = BaseFilter & {
     operation: '=' | '!=';
-    values: [string | number];
+    values: [FilterOptionValue];
 };
 
 declare type FilterForIn = BaseFilter & {
     operation: 'in' | 'not in';
-    values: (string | number)[];
+    values: FilterOptionValue[];
 };
 
 declare type FilterForNull = BaseFilter & {
@@ -1354,6 +1360,8 @@ declare type FilterOnClick = {
     columnIndex: number;
 };
 
+declare type FilterOptionValue = string | number | boolean;
+
 declare type FilterSemanticContext = {
     semanticDomainId?: string;
     selectedEntities?: unknown[];
@@ -1712,8 +1720,10 @@ declare interface PaginationConfig {
     pageSize: number;
 }
 
-declare type PersistedColumnSettings = Omit<Partial<ColumnSettings>, 'numberFormat'> & {
+declare type PersistedColumnSettings = Omit<Partial<ColumnSettings>, 'numberFormat' | 'dateFormat'> & {
     numberFormat?: Partial<ColumnSettings['numberFormat']>;
+    /** Sparse persisted date settings; conditional requirements are enforced by the serializer. */
+    dateFormat?: Partial<ColumnSettings['dateFormat']>;
 };
 
 declare type PersistedColumnSettingsMap = Record<string, PersistedColumnSettings>;
@@ -2861,6 +2871,8 @@ declare type TFilter = {
     title: string;
     column: string;
     dataType: string;
+    /** Exact database type retained when dataType is a normalized UI category. */
+    nativeDataType?: string;
     table?: string;
     database?: string;
     qualifiedTableName?: string;
@@ -2998,6 +3010,8 @@ declare type TInlineFilter = {
     column: string;
     title: string;
     dataType: string;
+    /** Exact database type retained when dataType is a normalized UI category. */
+    nativeDataType?: string;
     table: string;
     database: string;
     qualifiedTableName?: string;

package/dist/types/surfboard.d.ts

@@ -136,6 +136,8 @@ declare type BaseFilter = {
     valueType: 'string' | 'number' | 'date' | 'boolean';
     connectionType?: 'database' | 'api';
     dataType?: string;
+    /** Exact database type retained across dashboard-to-query transport. */
+    nativeDataType?: string;
     fieldMeta?: FilterFieldMeta;
     semanticContext?: FilterSemanticContext;
     /** Governed meaning for canonical grouped-temporal filter values. */
@@ -1551,6 +1553,8 @@ declare interface Field {
     sourceField?: string;
     qualifiedFieldName: string;
     dataType: string;
+    /** Exact database type when dataType is normalized for analytics/UI use. */
+    nativeDataType?: string;
     description?: string;
     qualifiedEntityName?: string;
     dateFormat?: DateFormatValue;
@@ -1640,6 +1644,8 @@ declare type FilterDisplayMode = 'canvas' | 'toolbar' | 'inherit';
 declare type FilterFieldMeta = Pick<Field, 'name' | 'qualifiedFieldName'> & Partial<Pick<Field, 'id' | 'qualifiedEntityName' | 'entityId' | 'dataType' | 'role' | 'fieldScope'>> & {
     entityName?: Field['entityName'];
     entityType?: string;
+    /** Exact database type used by server-side predicate formatting. */
+    nativeDataType?: string;
     expression?: string;
     calculatedFormula?: CalculatedFieldFormula;
 };
@@ -1663,12 +1669,12 @@ declare type FilterForDate = BaseFilter & {
 
 declare type FilterForEqual = BaseFilter & {
     operation: '=' | '!=';
-    values: [string | number];
+    values: [FilterOptionValue];
 };
 
 declare type FilterForIn = BaseFilter & {
     operation: 'in' | 'not in';
-    values: (string | number)[];
+    values: FilterOptionValue[];
 };
 
 declare type FilterForNull = BaseFilter & {
@@ -1726,6 +1732,8 @@ declare type FilterOnClick = {
     columnIndex: number;
 };
 
+declare type FilterOptionValue = string | number | boolean;
+
 declare type FilterSemanticContext = {
     semanticDomainId?: string;
     selectedEntities?: unknown[];
@@ -2228,8 +2236,10 @@ declare type Params = {
     [key: string]: string | number | string[] | number[];
 };
 
-declare type PersistedColumnSettings = Omit<Partial<ColumnSettings>, 'numberFormat'> & {
+declare type PersistedColumnSettings = Omit<Partial<ColumnSettings>, 'numberFormat' | 'dateFormat'> & {
     numberFormat?: Partial<ColumnSettings['numberFormat']>;
+    /** Sparse persisted date settings; conditional requirements are enforced by the serializer. */
+    dateFormat?: Partial<ColumnSettings['dateFormat']>;
 };
 
 declare type PersistedColumnSettingsMap = Record<string, PersistedColumnSettings>;
@@ -3491,6 +3501,12 @@ export declare type TDashboard = {
 export declare type TDataColumn = {
     column_name: string;
     data_type: string;
+    /** Exact catalog type when the columns API can prove it independently. */
+    nativeDataType?: string;
+    /** @deprecated Use the API contract spelling `nativeDataType`. */
+    native_data_type?: string;
+    /** Whether `data_type` came from semantic metadata or physical introspection. */
+    dataTypeProvenance?: 'semantic' | 'physical';
     is_nullable?: string;
     label?: string;
     description?: string;
@@ -3714,6 +3730,8 @@ declare type TFilter = {
     title: string;
     column: string;
     dataType: string;
+    /** Exact database type retained when dataType is a normalized UI category. */
+    nativeDataType?: string;
     table?: string;
     database?: string;
     qualifiedTableName?: string;
@@ -3859,6 +3877,8 @@ export declare type TInlineFilter = {
     column: string;
     title: string;
     dataType: string;
+    /** Exact database type retained when dataType is a normalized UI category. */
+    nativeDataType?: string;
     table: string;
     database: string;
     qualifiedTableName?: string;

package/dist/types/types.d.ts

@@ -145,6 +145,8 @@ declare type BaseFilter = {
     valueType: 'string' | 'number' | 'date' | 'boolean';
     connectionType?: 'database' | 'api';
     dataType?: string;
+    /** Exact database type retained across dashboard-to-query transport. */
+    nativeDataType?: string;
     fieldMeta?: FilterFieldMeta;
     semanticContext?: FilterSemanticContext;
     /** Governed meaning for canonical grouped-temporal filter values. */
@@ -2133,6 +2135,8 @@ export declare interface Field {
     sourceField?: string;
     qualifiedFieldName: string;
     dataType: string;
+    /** Exact database type when dataType is normalized for analytics/UI use. */
+    nativeDataType?: string;
     description?: string;
     qualifiedEntityName?: string;
     dateFormat?: DateFormatValue;
@@ -2222,6 +2226,8 @@ declare type FilterDisplayMode = 'canvas' | 'toolbar' | 'inherit';
 export declare type FilterFieldMeta = Pick<Field, 'name' | 'qualifiedFieldName'> & Partial<Pick<Field, 'id' | 'qualifiedEntityName' | 'entityId' | 'dataType' | 'role' | 'fieldScope'>> & {
     entityName?: Field['entityName'];
     entityType?: string;
+    /** Exact database type used by server-side predicate formatting. */
+    nativeDataType?: string;
     expression?: string;
     calculatedFormula?: CalculatedFieldFormula;
 };
@@ -2245,12 +2251,12 @@ declare type FilterForDate = BaseFilter & {
 
 declare type FilterForEqual = BaseFilter & {
     operation: '=' | '!=';
-    values: [string | number];
+    values: [FilterOptionValue];
 };
 
 declare type FilterForIn = BaseFilter & {
     operation: 'in' | 'not in';
-    values: (string | number)[];
+    values: FilterOptionValue[];
 };
 
 declare type FilterForNull = BaseFilter & {
@@ -2308,6 +2314,8 @@ declare type FilterOnClick = {
     columnIndex: number;
 };
 
+declare type FilterOptionValue = string | number | boolean;
+
 export declare type FilterSemanticContext = {
     semanticDomainId?: string;
     selectedEntities?: unknown[];
@@ -3129,8 +3137,10 @@ declare type Params = {
     [key: string]: string | number | string[] | number[];
 };
 
-declare type PersistedColumnSettings = Omit<Partial<ColumnSettings>, 'numberFormat'> & {
+declare type PersistedColumnSettings = Omit<Partial<ColumnSettings>, 'numberFormat' | 'dateFormat'> & {
     numberFormat?: Partial<ColumnSettings['numberFormat']>;
+    /** Sparse persisted date settings; conditional requirements are enforced by the serializer. */
+    dateFormat?: Partial<ColumnSettings['dateFormat']>;
 };
 
 declare type PersistedColumnSettingsMap = Record<string, PersistedColumnSettings>;
@@ -4681,6 +4691,12 @@ export declare type TDashboard = {
 export declare type TDataColumn = {
     column_name: string;
     data_type: string;
+    /** Exact catalog type when the columns API can prove it independently. */
+    nativeDataType?: string;
+    /** @deprecated Use the API contract spelling `nativeDataType`. */
+    native_data_type?: string;
+    /** Whether `data_type` came from semantic metadata or physical introspection. */
+    dataTypeProvenance?: 'semantic' | 'physical';
     is_nullable?: string;
     label?: string;
     description?: string;
@@ -4906,6 +4922,8 @@ export declare type TFilter = {
     title: string;
     column: string;
     dataType: string;
+    /** Exact database type retained when dataType is a normalized UI category. */
+    nativeDataType?: string;
     table?: string;
     database?: string;
     qualifiedTableName?: string;
@@ -5051,6 +5069,8 @@ export declare type TInlineFilter = {
     column: string;
     title: string;
     dataType: string;
+    /** Exact database type retained when dataType is a normalized UI category. */
+    nativeDataType?: string;
     table: string;
     database: string;
     qualifiedTableName?: string;

package/package.json

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