react-semaphor 0.1.305 → 0.1.307

package/dist/surfboard/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("../chunks/index-BOGpMmRo.js"),e=require("../chunks/common-types-nBuCd3u2.js"),r=require("../chunks/dashboard-summary-settings-dialog-DioOegLQ.js");exports.Surfboard=a.DashboardPlus;exports.CONTROL_CARD_DEFAULT_VALUE=e.CONTROL_CARD_DEFAULT_VALUE;exports.EMPTY_SELECTION=e.EMPTY_SELECTION;exports.CalendarPreferencesDialog=r.CalendarPreferencesDialog;exports.DashboardSummarySettingsDialog=r.DashboardSummarySettingsDialog;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("../chunks/index-DQCMUspd.js"),e=require("../chunks/common-types-nBuCd3u2.js"),r=require("../chunks/dashboard-summary-settings-dialog-DD9Aj2XH.js");exports.Surfboard=a.DashboardPlus;exports.CONTROL_CARD_DEFAULT_VALUE=e.CONTROL_CARD_DEFAULT_VALUE;exports.EMPTY_SELECTION=e.EMPTY_SELECTION;exports.CalendarPreferencesDialog=r.CalendarPreferencesDialog;exports.DashboardSummarySettingsDialog=r.DashboardSummarySettingsDialog;

package/dist/surfboard/index.js

@@ -1,6 +1,6 @@
-import { a as o } from "../chunks/index-DJFckbGE.js";
+import { a as o } from "../chunks/index-DMFCfjgD.js";
 import { C as s, E as C } from "../chunks/common-types-C6cAQgyh.js";
-import { C as E, D as f } from "../chunks/dashboard-summary-settings-dialog-CMxi2arh.js";
+import { C as E, D as f } from "../chunks/dashboard-summary-settings-dialog-Bj4_wBW9.js";
 export {
   s as CONTROL_CARD_DEFAULT_VALUE,
   E as CalendarPreferencesDialog,

package/dist/types/dashboard.d.ts

@@ -352,10 +352,7 @@ declare interface ColumnSettings {
     maxWidth?: number;
     textOverflow?: 'ellipsis' | 'wrap' | 'clip';
     textWrap: 'wrap' | 'nowrap';
-    /**
-     * Totals-row behavior for this column. Undefined = 'none'. The footer
-     * renders only when at least one visible column has a non-'none' behavior.
-     */
+    /** Deprecated/inert. Totals are controlled by tablePrefs.tableStyle.totals. */
     totalsBehavior?: TotalsBehavior;
     totalsLabel?: string;
     numberFormat: {
@@ -395,6 +392,90 @@ declare type ColumnSettingsMap = Record<string, ColumnSettings>;
 
 declare type ColumnType = 'string' | 'number' | 'date';
 
+declare type ComparisonOperator = 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte';
+
+declare type ConditionalFormatCondition = {
+    kind: 'comparison';
+    columnId: string;
+    operator: ComparisonOperator;
+    value: unknown;
+} | {
+    kind: 'between';
+    columnId: string;
+    min: unknown;
+    max: unknown;
+    inclusive?: boolean;
+} | {
+    kind: 'blank';
+    columnId: string;
+    isBlank: boolean;
+} | {
+    kind: 'contains';
+    columnId: string;
+    value: string;
+    caseSensitive?: boolean;
+    exact?: boolean;
+} | {
+    kind: 'topBottom';
+    columnId: string;
+    direction: 'top' | 'bottom';
+    count: number;
+} | {
+    kind: 'colorScale';
+    columnId: string;
+    range: 'auto' | 'manual';
+    min?: number;
+    mid?: number;
+    max?: number;
+    colors: {
+        min: string;
+        mid?: string;
+        max: string;
+    };
+} | {
+    kind: 'dataBar';
+    columnId: string;
+    range: 'auto' | 'manual';
+    min?: number;
+    max?: number;
+    color: string;
+    showValue?: boolean;
+};
+
+declare type ConditionalFormatRule = {
+    id: string;
+    name?: string;
+    enabled?: boolean;
+    target: ConditionalFormatTarget;
+    condition: ConditionalFormatCondition;
+    style?: ConditionalFormatStyle;
+};
+
+declare type ConditionalFormatStyle = {
+    backgroundColor?: string;
+    textColor?: string;
+    fontWeight?: 'normal' | 'medium' | 'semibold' | 'bold';
+    italic?: boolean;
+    textDecoration?: 'none' | 'underline' | 'line-through';
+    icon?: 'arrowUp' | 'arrowDown' | 'warning' | 'check' | 'x';
+    dataBar?: {
+        color: string;
+        showValue: boolean;
+    };
+};
+
+declare type ConditionalFormatTarget = {
+    level: 'cell' | 'row';
+    columnIds?: string[];
+    conditionColumnId?: string;
+    applyToColumnIds?: string[];
+    tableParts?: TablePart[];
+    rowRoles?: string[];
+    depth?: number;
+    includeTotals?: boolean;
+    includeSubtotals?: boolean;
+};
+
 export declare type ConnectionPolicy = {
     connectionId?: string;
     name: string;
@@ -933,12 +1014,6 @@ export declare type DocumentSpacerSection = {
     heightPx: number;
 };
 
-export declare type DocumentTableDensity = 'comfortable' | 'standard' | 'compact' | 'dense';
-
-export declare type DocumentTableGridLines = 'none' | 'outer' | 'inner' | 'horizontal' | 'vertical' | 'top' | 'right' | 'bottom' | 'left' | 'full';
-
-export declare type DocumentTableHeaderStyle = 'plain' | 'filled' | 'accent';
-
 export declare type DocumentTableSection = {
     id: string;
     type: 'table';
@@ -949,30 +1024,9 @@ export declare type DocumentTableSection = {
         columnFormatting?: Record<string, unknown>;
         repeatHeaderOnPageBreak?: boolean;
         rowHeightPx?: number;
-        style?: DocumentTableStyle;
-        totalsStyle?: DocumentTableTotalsStyle;
     };
 };
 
-export declare type DocumentTableStyle = {
-    density?: DocumentTableDensity;
-    headerStyle?: DocumentTableHeaderStyle;
-    headerBackgroundColor?: string;
-    headerTextColor?: string;
-    stripedRows?: boolean;
-    gridLines?: DocumentTableGridLines;
-    wrapText?: boolean;
-};
-
-export declare type DocumentTableTotalsFontWeight = 'normal' | 'medium' | 'semibold' | 'bold';
-
-export declare type DocumentTableTotalsStyle = {
-    backgroundColor?: string;
-    textColor?: string;
-    fontWeight?: DocumentTableTotalsFontWeight;
-    borderTop?: boolean;
-};
-
 export declare type DocumentTextContent = DocumentTextNode[];
 
 export declare type DocumentTextInlineFormat = {
@@ -1937,6 +1991,29 @@ declare type TableAppearance = {
     };
 };
 
+declare type TableBaseFormatting = {
+    version: TableFormattingVersion;
+    tableParts?: Partial<Record<TablePart, TableBaseStyle>>;
+    columns?: Record<string, {
+        body?: TableBaseStyle;
+        header?: TableBaseStyle;
+        footer?: TableBaseStyle;
+    }>;
+};
+
+declare type TableBaseStyle = {
+    fontWeight?: 'normal' | 'medium' | 'semibold' | 'bold';
+    italic?: boolean;
+    textColor?: string;
+    backgroundColor?: string;
+    textDecoration?: 'none' | 'underline' | 'line-through';
+};
+
+declare type TableConditionalFormatting = {
+    version: TableFormattingVersion;
+    rules: ConditionalFormatRule[];
+};
+
 /**
  * Row rhythm for the whole table. Authors pick one per card; undefined
  * falls back to 'compact' (the canonical default — dense scanning, matches
@@ -1945,8 +2022,18 @@ declare type TableAppearance = {
  */
 declare type TableDensity = 'dense' | 'compact' | 'standard' | 'comfortable' | 'spacious';
 
+declare type TableFormattingVersion = 1;
+
+declare type TableGridLines = 'none' | 'outer' | 'inner' | 'horizontal' | 'vertical' | 'top' | 'right' | 'bottom' | 'left' | 'full';
+
+declare type TableHeaderStyle = 'plain' | 'filled' | 'accent';
+
+declare type TablePart = 'body' | 'header' | 'footer' | 'subtotal' | 'grandTotal';
+
 declare type TablePreferences = {
     columnSettingsMap?: ColumnSettingsMap;
+    baseFormatting?: TableBaseFormatting;
+    conditionalFormatting?: TableConditionalFormatting;
     selectColumnVisible?: boolean;
     columnVisibility?: Record<string, boolean>;
     columnSizing?: ColumnSizingState;
@@ -1954,7 +2041,29 @@ declare type TablePreferences = {
     enableDevModePagination?: boolean;
     forceClientPagination?: boolean;
     density?: TableDensity;
-    documentWrapText?: boolean;
+    tableStyle?: TableStylePreferences;
+};
+
+declare type TableStylePreferences = {
+    headerStyle?: TableHeaderStyle;
+    headerBackgroundColor?: string;
+    headerTextColor?: string;
+    stripedRows?: boolean;
+    gridLines?: TableGridLines;
+    wrapText?: boolean;
+    totals?: TableTotalsStylePreferences;
+};
+
+declare type TableTotalsFontWeight = 'normal' | 'medium' | 'semibold' | 'bold';
+
+declare type TableTotalsStylePreferences = {
+    enabled?: boolean;
+    backgroundColor?: string;
+    textColor?: string;
+    fontWeight?: TableTotalsFontWeight;
+    borderTop?: boolean;
+    borderTopStyle?: 'solid' | 'dashed' | 'dotted' | 'double';
+    borderTopColor?: string;
 };
 
 /**
@@ -2686,18 +2795,7 @@ export declare type TLens = {
 /** Line dash style options */
 export declare type TLineStyle = 'solid' | 'dashed' | 'dotted' | 'dash-dot';
 
-/**
- * Per-column contribution to the table-level totals row (`<tfoot>`).
- * Additive and optional — omitting it keeps the cell empty in the footer,
- * matching existing behavior when a totals row is not needed.
- *
- *   - 'sum'    → aggregate the column across the full dataset
- *   - 'avg'    → arithmetic mean across the full dataset
- *   - 'count'  → non-null count across the full dataset
- *   - 'label'  → render `totalsLabel` (or 'Total') as static text — typically
- *                on the first column so the footer reads as a labeled row
- *   - 'none'   → blank cell in the footer
- */
+/** Historical per-column totals shape. Runtime totals are table-level now. */
 declare type TotalsBehavior = 'sum' | 'avg' | 'count' | 'label' | 'none';
 
 /** Point style options supported by Chart.js */

package/dist/types/main.d.ts

@@ -1177,10 +1177,7 @@ declare interface ColumnSettings {
     maxWidth?: number;
     textOverflow?: 'ellipsis' | 'wrap' | 'clip';
     textWrap: 'wrap' | 'nowrap';
-    /**
-     * Totals-row behavior for this column. Undefined = 'none'. The footer
-     * renders only when at least one visible column has a non-'none' behavior.
-     */
+    /** Deprecated/inert. Totals are controlled by tablePrefs.tableStyle.totals. */
     totalsBehavior?: TotalsBehavior;
     totalsLabel?: string;
     numberFormat: {
@@ -1267,6 +1264,90 @@ export declare interface ComparisonMetadataEntry {
 
 export declare type ComparisonMetadataMap = Record<string, ComparisonMetadataEntry>;
 
+declare type ComparisonOperator = 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte';
+
+declare type ConditionalFormatCondition = {
+    kind: 'comparison';
+    columnId: string;
+    operator: ComparisonOperator;
+    value: unknown;
+} | {
+    kind: 'between';
+    columnId: string;
+    min: unknown;
+    max: unknown;
+    inclusive?: boolean;
+} | {
+    kind: 'blank';
+    columnId: string;
+    isBlank: boolean;
+} | {
+    kind: 'contains';
+    columnId: string;
+    value: string;
+    caseSensitive?: boolean;
+    exact?: boolean;
+} | {
+    kind: 'topBottom';
+    columnId: string;
+    direction: 'top' | 'bottom';
+    count: number;
+} | {
+    kind: 'colorScale';
+    columnId: string;
+    range: 'auto' | 'manual';
+    min?: number;
+    mid?: number;
+    max?: number;
+    colors: {
+        min: string;
+        mid?: string;
+        max: string;
+    };
+} | {
+    kind: 'dataBar';
+    columnId: string;
+    range: 'auto' | 'manual';
+    min?: number;
+    max?: number;
+    color: string;
+    showValue?: boolean;
+};
+
+declare type ConditionalFormatRule = {
+    id: string;
+    name?: string;
+    enabled?: boolean;
+    target: ConditionalFormatTarget;
+    condition: ConditionalFormatCondition;
+    style?: ConditionalFormatStyle;
+};
+
+declare type ConditionalFormatStyle = {
+    backgroundColor?: string;
+    textColor?: string;
+    fontWeight?: 'normal' | 'medium' | 'semibold' | 'bold';
+    italic?: boolean;
+    textDecoration?: 'none' | 'underline' | 'line-through';
+    icon?: 'arrowUp' | 'arrowDown' | 'warning' | 'check' | 'x';
+    dataBar?: {
+        color: string;
+        showValue: boolean;
+    };
+};
+
+declare type ConditionalFormatTarget = {
+    level: 'cell' | 'row';
+    columnIds?: string[];
+    conditionColumnId?: string;
+    applyToColumnIds?: string[];
+    tableParts?: TablePart[];
+    rowRoles?: string[];
+    depth?: number;
+    includeTotals?: boolean;
+    includeSubtotals?: boolean;
+};
+
 export declare type ConnectionItem = DropdownItem & {
     type: string;
 };
@@ -2097,12 +2178,6 @@ export declare type DocumentSpacerSection = {
     heightPx: number;
 };
 
-export declare type DocumentTableDensity = 'comfortable' | 'standard' | 'compact' | 'dense';
-
-export declare type DocumentTableGridLines = 'none' | 'outer' | 'inner' | 'horizontal' | 'vertical' | 'top' | 'right' | 'bottom' | 'left' | 'full';
-
-export declare type DocumentTableHeaderStyle = 'plain' | 'filled' | 'accent';
-
 export declare type DocumentTableSection = {
     id: string;
     type: 'table';
@@ -2113,30 +2188,9 @@ export declare type DocumentTableSection = {
         columnFormatting?: Record<string, unknown>;
         repeatHeaderOnPageBreak?: boolean;
         rowHeightPx?: number;
-        style?: DocumentTableStyle;
-        totalsStyle?: DocumentTableTotalsStyle;
     };
 };
 
-export declare type DocumentTableStyle = {
-    density?: DocumentTableDensity;
-    headerStyle?: DocumentTableHeaderStyle;
-    headerBackgroundColor?: string;
-    headerTextColor?: string;
-    stripedRows?: boolean;
-    gridLines?: DocumentTableGridLines;
-    wrapText?: boolean;
-};
-
-export declare type DocumentTableTotalsFontWeight = 'normal' | 'medium' | 'semibold' | 'bold';
-
-export declare type DocumentTableTotalsStyle = {
-    backgroundColor?: string;
-    textColor?: string;
-    fontWeight?: DocumentTableTotalsFontWeight;
-    borderTop?: boolean;
-};
-
 export declare type DocumentTextContent = DocumentTextNode[];
 
 export declare type DocumentTextInlineFormat = {
@@ -4105,6 +4159,8 @@ export declare function Surfboard({ showControls, showFooter, ...rest }: Dashboa
 
 declare interface TableActions {
     updateColumnSettingsMap: (columnSettings: ColumnSettingsMap) => void;
+    updateTableBaseFormatting: (baseFormatting: TableBaseFormatting) => void;
+    updateTableConditionalFormatting: (conditionalFormatting: TableConditionalFormatting) => void;
     updateColumnVisibility: (columnId: string, isVisible: boolean) => void;
     updateColumnSizing: (sizing: ColumnSizingState) => void;
     updatePageSize: (pageSize: number) => void;
@@ -4163,6 +4219,29 @@ declare type TableAppearance = {
     };
 };
 
+declare type TableBaseFormatting = {
+    version: TableFormattingVersion;
+    tableParts?: Partial<Record<TablePart, TableBaseStyle>>;
+    columns?: Record<string, {
+        body?: TableBaseStyle;
+        header?: TableBaseStyle;
+        footer?: TableBaseStyle;
+    }>;
+};
+
+declare type TableBaseStyle = {
+    fontWeight?: 'normal' | 'medium' | 'semibold' | 'bold';
+    italic?: boolean;
+    textColor?: string;
+    backgroundColor?: string;
+    textDecoration?: 'none' | 'underline' | 'line-through';
+};
+
+declare type TableConditionalFormatting = {
+    version: TableFormattingVersion;
+    rules: ConditionalFormatRule[];
+};
+
 export declare type TableConfig = {
     databaseName: string;
     schemaName: string;
@@ -4178,10 +4257,20 @@ export declare type TableConfig = {
  */
 declare type TableDensity = 'dense' | 'compact' | 'standard' | 'comfortable' | 'spacious';
 
+declare type TableFormattingVersion = 1;
+
+declare type TableGridLines = 'none' | 'outer' | 'inner' | 'horizontal' | 'vertical' | 'top' | 'right' | 'bottom' | 'left' | 'full';
+
+declare type TableHeaderStyle = 'plain' | 'filled' | 'accent';
+
 export declare type TableItem = DropdownItem;
 
+declare type TablePart = 'body' | 'header' | 'footer' | 'subtotal' | 'grandTotal';
+
 declare type TablePreferences = {
     columnSettingsMap?: ColumnSettingsMap;
+    baseFormatting?: TableBaseFormatting;
+    conditionalFormatting?: TableConditionalFormatting;
     selectColumnVisible?: boolean;
     columnVisibility?: Record<string, boolean>;
     columnSizing?: ColumnSizingState;
@@ -4189,9 +4278,21 @@ declare type TablePreferences = {
     enableDevModePagination?: boolean;
     forceClientPagination?: boolean;
     density?: TableDensity;
-    documentWrapText?: boolean;
+    tableStyle?: TableStylePreferences;
+};
+
+declare type TableStylePreferences = {
+    headerStyle?: TableHeaderStyle;
+    headerBackgroundColor?: string;
+    headerTextColor?: string;
+    stripedRows?: boolean;
+    gridLines?: TableGridLines;
+    wrapText?: boolean;
+    totals?: TableTotalsStylePreferences;
 };
 
+declare type TableTotalsFontWeight = 'normal' | 'medium' | 'semibold' | 'bold';
+
 export declare type TableTotalsRequest = {
     source: 'documentFlatTable';
     columns: Array<{
@@ -4202,6 +4303,16 @@ export declare type TableTotalsRequest = {
     }>;
 };
 
+declare type TableTotalsStylePreferences = {
+    enabled?: boolean;
+    backgroundColor?: string;
+    textColor?: string;
+    fontWeight?: TableTotalsFontWeight;
+    borderTop?: boolean;
+    borderTopStyle?: 'solid' | 'dashed' | 'dotted' | 'double';
+    borderTopColor?: string;
+};
+
 /**
  * Target column configuration for multi-field filters.
  * Allows a single filter to target multiple columns from the SAME table,
@@ -5170,18 +5281,7 @@ export declare type TokenSecurityPolicy = {
     };
 };
 
-/**
- * Per-column contribution to the table-level totals row (`<tfoot>`).
- * Additive and optional — omitting it keeps the cell empty in the footer,
- * matching existing behavior when a totals row is not needed.
- *
- *   - 'sum'    → aggregate the column across the full dataset
- *   - 'avg'    → arithmetic mean across the full dataset
- *   - 'count'  → non-null count across the full dataset
- *   - 'label'  → render `totalsLabel` (or 'Total') as static text — typically
- *                on the first column so the footer reads as a labeled row
- *   - 'none'   → blank cell in the footer
- */
+/** Historical per-column totals shape. Runtime totals are table-level now. */
 declare type TotalsBehavior = 'sum' | 'avg' | 'count' | 'label' | 'none';
 
 /** Point style options supported by Chart.js */
@@ -6133,9 +6233,7 @@ declare interface VisualAttachment {
         currentSheetId?: string;
         currentSheetName?: string;
         tablePreferences?: TablePreferences;
-        /** Inline filter values for card-specific filtering in scheduled exports */
         inlineFilterValues?: TFilterValue[];
-        /** Dashboard-level sheet filter values, merged at schedule creation time */
         sheetFilterValues?: TFilterValue[];
     };
 }