react-semaphor 0.1.474 → 0.1.476

package/dist/types/dashboard-authoring.d.ts

@@ -70,6 +70,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. */
@@ -1512,6 +1514,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;
@@ -1601,6 +1605,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;
 };
@@ -2118,8 +2124,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>;
@@ -3604,6 +3612,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;
@@ -3741,6 +3751,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/dashboard.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. */
@@ -1538,6 +1540,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;
@@ -1627,6 +1631,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;
 };
@@ -2215,8 +2221,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>;
@@ -3469,6 +3477,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;
@@ -3692,6 +3706,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;
@@ -3837,6 +3853,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/format-utils.d.ts

@@ -297,6 +297,20 @@ export declare interface ExportFormattingConfig {
     visibleColumns: string[];
 }
 
+/**
+ * Shared structured Fast PDF routing and safety policy.
+ *
+ * These values are product policy, not deployment configuration. Keep this
+ * module React-free so browser, app, and renderer adapters can enforce the
+ * same limits at their trust boundaries.
+ */
+export declare const FAST_PDF_POLICY: Readonly<{
+    maxRows: 5000;
+    maxRequestBytes: 2621440;
+    maxPages: 100;
+    maxOutputBytes: 52428800;
+}>;
+
 export declare function findResolvedNumericFormat(input: {
     snapshot: PresentationExecutionSnapshot;
     scope: PresentationScope;
@@ -533,6 +547,9 @@ export declare function getTimezoneAbbreviation(timezone: string, date?: Date):
  */
 export declare function getTimezoneName(timezone: string): string;
 
+/** Exact UTF-8 bytes used by the structured POST body. */
+export declare function getUtf8ByteLength(value: string): number;
+
 export declare interface GroupByField {
     name: string;
     alias: string;
@@ -547,6 +564,14 @@ declare type IdentifiedMetricField = IdentifiedField & MetricResultAliasInput;
 
 export declare function isAggregateTotalMemberMarker(value: unknown): value is typeof AGGREGATE_TOTAL_MEMBER_MARKER;
 
+export declare function isFastPdfOutputSizeEligible(byteLength: number): boolean;
+
+export declare function isFastPdfPageCountEligible(pageCount: number): boolean;
+
+export declare function isFastPdfRequestSizeEligible(byteLength: number): boolean;
+
+export declare function isFastPdfRowCountEligible(rowCount: number): boolean;
+
 export declare function isNumericCanonicalFormat(format: unknown): format is NumericCanonicalFormat;
 
 export declare function isPivotEmptyTupleAllowed(input: {
@@ -723,6 +748,8 @@ export declare function parseTemporalBucketValue(value: TemporalBucketValue, met
  */
 export declare function parseWithSourceTimezone(dateString: string, sourceTimezone?: string): Date;
 
+export declare const PDF_SAFETY_LIMIT_EXCEEDED: "PDF_SAFETY_LIMIT_EXCEEDED";
+
 export declare interface PivotByColumn {
     name: string;
     alias: string;
@@ -1304,6 +1331,18 @@ declare type SemaphorSourceRef = {
 
 declare type SemaphorTimeGrain = (typeof SEMAPHOR_TIME_GRAINS)[number];
 
+/**
+ * Returns whether an aggregate group value starts a new visible group at its
+ * hierarchy level. A nested value repeats only when its complete parent prefix
+ * also repeats. Subtotals and grand totals are presentation boundaries.
+ */
+export declare function shouldPresentAggregateGroupValue(input: {
+    row: Record<string, unknown>;
+    previousRow?: Record<string, unknown>;
+    context: AggregateTablePresentationContext;
+    columnKey: string;
+}): boolean;
+
 export declare type SqlTemporalColumnClassification = {
     status: 'empty';
 } | {
@@ -1434,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. */
@@ -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;
 };
@@ -5034,8 +5040,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 +6965,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 +7196,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 +7343,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/pdf-export-policy.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Shared structured Fast PDF routing and safety policy.
+ *
+ * These values are product policy, not deployment configuration. Keep this
+ * module React-free so browser, app, and renderer adapters can enforce the
+ * same limits at their trust boundaries.
+ */
+export declare const FAST_PDF_POLICY: Readonly<{
+    maxRows: 5000;
+    maxRequestBytes: 2621440;
+    maxPages: 100;
+    maxOutputBytes: 52428800;
+}>;
+
+/** Exact UTF-8 bytes used by the structured POST body. */
+export declare function getUtf8ByteLength(value: string): number;
+
+export declare function isFastPdfOutputSizeEligible(byteLength: number): boolean;
+
+export declare function isFastPdfPageCountEligible(pageCount: number): boolean;
+
+export declare function isFastPdfRequestSizeEligible(byteLength: number): boolean;
+
+export declare function isFastPdfRowCountEligible(rowCount: number): boolean;
+
+export declare const PDF_SAFETY_LIMIT_EXCEEDED: "PDF_SAFETY_LIMIT_EXCEEDED";
+
+export { }

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;
 };
@@ -1712,8 +1718,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 +2869,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 +3008,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;
 };
@@ -2228,8 +2234,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 +3499,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 +3728,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 +3875,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;
 };
@@ -3129,8 +3135,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 +4689,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 +4920,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 +5067,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.474",
+  "version": "0.1.476",
   "description": "Fully interactive and customizable dashboards for your apps.",
   "keywords": [
     "react",
@@ -127,6 +127,11 @@
       "import": "./dist/format-utils/index.js",
       "require": "./dist/format-utils/index.cjs"
     },
+    "./format-utils/pdf-export-policy": {
+      "types": "./dist/types/pdf-export-policy.d.ts",
+      "import": "./dist/pdf-export-policy/index.js",
+      "require": "./dist/pdf-export-policy/index.cjs"
+    },
     "./value-format-preferences": {
       "types": "./dist/types/value-format-preferences.d.ts",
       "import": "./dist/value-format-preferences/index.js",