@gooddata/sdk-ui-pivot 11.53.0-alpha.0 → 11.53.0-alpha.1

package/esm/next/context/ColumnDefsContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ColumnDefsContext.d.ts","sourceRoot":"","sources":["../../../src/next/context/ColumnDefsContext.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAsC,MAAM,OAAO,CAAC;AAM3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAM1E,KAAK,kBAAkB,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAI/D;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,2CAuCvE;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,kBAAkB,CAQlD"}
+{"version":3,"file":"ColumnDefsContext.d.ts","sourceRoot":"","sources":["../../../src/next/context/ColumnDefsContext.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAsC,MAAM,OAAO,CAAC;AAM3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAM1E,KAAK,kBAAkB,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAI/D;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,2CA0CvE;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,kBAAkB,CAQlD"}

package/esm/next/context/ColumnDefsContext.js

@@ -16,7 +16,7 @@ export function ColumnDefsProvider({ children }) {
     const initialExecutionData = useInitialExecution();
     const props = usePivotTableProps();
     const { config } = props;
-    const { columnHeadersPosition, columnSizing: { columnWidths: initialColumnWidths }, textWrapping, separators, conditionalFormatting, } = config;
+    const { columnHeadersPosition, columnSizing: { columnWidths: initialColumnWidths }, textWrapping, separators, conditionalFormatting, enableSemanticConditionalFormatting, } = config;
     const { initialDataView } = initialExecutionData;
     const columnWidths = useInitialProp(initialColumnWidths);
     const drillableItemsRef = useDrillableItemsRef();
@@ -30,6 +30,7 @@ export function ColumnDefsProvider({ children }) {
             intl,
             separators,
             conditionalFormatting,
+            enableSemanticConditionalFormatting,
         });
     }, [
         initialDataView,
@@ -40,6 +41,7 @@ export function ColumnDefsProvider({ children }) {
         drillableItemsRef,
         separators,
         conditionalFormatting,
+        enableSemanticConditionalFormatting,
     ]);
     return _jsx(ColumnDefsContext.Provider, { value: columnDefs, children: children });
 }

package/esm/next/features/data/dataViewToColDefs.d.ts

@@ -13,7 +13,7 @@ import { type ColumnHeadersPosition } from "../../types/transposition.js";
  *
  * @internal
  */
-export declare function dataViewToColDefs({ dataView, columnHeadersPosition, columnWidths, drillableItemsRef, textWrapping, intl, separators, conditionalFormatting }: {
+export declare function dataViewToColDefs({ dataView, columnHeadersPosition, columnWidths, drillableItemsRef, textWrapping, intl, separators, conditionalFormatting, enableSemanticConditionalFormatting }: {
     dataView: DataViewFacade;
     columnHeadersPosition: ColumnHeadersPosition;
     columnWidths: ColumnWidthItem[];
@@ -22,6 +22,8 @@ export declare function dataViewToColDefs({ dataView, columnHeadersPosition, col
     intl: IntlShape;
     separators?: ISeparators;
     conditionalFormatting?: IConditionalFormatting;
+    /** Off by default: descriptors may carry semantic rules the host has no other way to suppress. */
+    enableSemanticConditionalFormatting?: boolean;
 }): {
     columnDefinitionByColId: ITableColumnDefinitionByColId;
     columnDefs: (AgGridColumnDef | AgGridColumnGroupDef)[];

package/esm/next/features/data/dataViewToColDefs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dataViewToColDefs.d.ts","sourceRoot":"","sources":["../../../../src/next/features/data/dataViewToColDefs.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAE3E,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AACxF,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,EAAE,KAAK,6BAA6B,EAAE,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAa1E;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAC9B,QAAQ,EACR,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,IAAI,EACJ,UAAU,EACV,qBAAqB,EACxB,EAAE;IACC,QAAQ,EAAE,cAAc,CAAC;IACzB,qBAAqB,EAAE,qBAAqB,CAAC;IAC7C,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,iBAAiB,EAAE,SAAS,CAAC,aAAa,EAAE,CAAC,CAAC;IAC9C,YAAY,EAAE,aAAa,CAAC;IAC5B,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,CAAC,EAAE,WAAW,CAAC;IACzB,qBAAqB,CAAC,EAAE,sBAAsB,CAAC;CAClD,GAAG;IACA,uBAAuB,EAAE,6BAA6B,CAAC;IACvD,UAAU,EAAE,CAAC,eAAe,GAAG,oBAAoB,CAAC,EAAE,CAAC;IACvD,cAAc,EAAE,eAAe,EAAE,CAAC;IAClC,SAAS,EAAE,OAAO,CAAC;CACtB,CAmEA"}
+{"version":3,"file":"dataViewToColDefs.d.ts","sourceRoot":"","sources":["../../../../src/next/features/data/dataViewToColDefs.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAE3E,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AACxF,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,EAAE,KAAK,6BAA6B,EAAE,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAc1E;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAC9B,QAAQ,EACR,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,IAAI,EACJ,UAAU,EACV,qBAAqB,EACrB,mCAAmC,EACtC,EAAE;IACC,QAAQ,EAAE,cAAc,CAAC;IACzB,qBAAqB,EAAE,qBAAqB,CAAC;IAC7C,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,iBAAiB,EAAE,SAAS,CAAC,aAAa,EAAE,CAAC,CAAC;IAC9C,YAAY,EAAE,aAAa,CAAC;IAC5B,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,CAAC,EAAE,WAAW,CAAC;IACzB,qBAAqB,CAAC,EAAE,sBAAsB,CAAC;IAC/C,kGAAkG;IAClG,mCAAmC,CAAC,EAAE,OAAO,CAAC;CACjD,GAAG;IACA,uBAAuB,EAAE,6BAA6B,CAAC;IACvD,UAAU,EAAE,CAAC,eAAe,GAAG,oBAAoB,CAAC,EAAE,CAAC;IACvD,cAAc,EAAE,eAAe,EAAE,CAAC;IAClC,SAAS,EAAE,OAAO,CAAC;CACtB,CA8EA"}

package/esm/next/features/data/dataViewToColDefs.js

@@ -4,6 +4,7 @@ import { columnDefinitionToColId } from "../columns/colId.js";
 import { createColDef } from "../columns/createColDef.js";
 import { columnDefsToPivotGroups } from "../pivoting/columnDefsToPivotGroups.js";
 import { resolveConditionalFormattingDateBounds, resolveConditionalFormattingTriggers, } from "../styling/conditionalFormatting.js";
+import { resolvePerTargetConditionalFormatting } from "../styling/semanticConditionalFormatting.js";
 import { applyTextWrappingToGroupDef } from "../textWrapping/applyTextWrappingToGroupDef.js";
 import { getTableData } from "./valueFormatter.js";
 /**
@@ -11,7 +12,7 @@ import { getTableData } from "./valueFormatter.js";
  *
  * @internal
  */
-export function dataViewToColDefs({ dataView, columnHeadersPosition, columnWidths, drillableItemsRef, textWrapping, intl, separators, conditionalFormatting, }) {
+export function dataViewToColDefs({ dataView, columnHeadersPosition, columnWidths, drillableItemsRef, textWrapping, intl, separators, conditionalFormatting, enableSemanticConditionalFormatting, }) {
     const sortBy = dataView.definition.sortBy;
     const tableData = getTableData(dataView, separators);
     const columnDefinitionByColId = {};
@@ -19,14 +20,20 @@ export function dataViewToColDefs({ dataView, columnHeadersPosition, columnWidth
         const colId = columnDefinitionToColId(columnDefinition, columnHeadersPosition);
         columnDefinitionByColId[colId] = columnDefinition;
     });
+    // Descriptors may carry semantic rules regardless of `conditionalFormatting` (even `undefined`
+    // still inherits, per resolvePerTargetConditionalFormatting) — the host can't suppress that by
+    // omitting `conditionalFormatting` alone, so inheritance needs its own explicit opt-in.
+    const effectiveConditionalFormatting = enableSemanticConditionalFormatting
+        ? resolvePerTargetConditionalFormatting(conditionalFormatting, dataView.meta().attributeDescriptors(), dataView.meta().measureDescriptors())
+        : conditionalFormatting;
     // Resolve each rule's trigger column to a colId ONCE for this render pass, so the per-cell
     // cellStyle path is O(rules) lookups instead of re-matching every column on every cell.
-    const conditionalFormattingTriggers = conditionalFormatting?.enabled
-        ? resolveConditionalFormattingTriggers(conditionalFormatting, tableData.columnDefinitions, columnHeadersPosition)
+    const conditionalFormattingTriggers = effectiveConditionalFormatting?.enabled
+        ? resolveConditionalFormattingTriggers(effectiveConditionalFormatting, tableData.columnDefinitions, columnHeadersPosition)
         : [];
     // Resolved once per render like the triggers; relative periods anchor to render time.
-    const conditionalFormattingDateBounds = conditionalFormatting?.enabled
-        ? resolveConditionalFormattingDateBounds(conditionalFormatting, tableData.columnDefinitions)
+    const conditionalFormattingDateBounds = effectiveConditionalFormatting?.enabled
+        ? resolveConditionalFormattingDateBounds(effectiveConditionalFormatting, tableData.columnDefinitions)
         : {};
     const colDefs = tableData.columnDefinitions.map((columnDefinition) => {
         const colDef = createColDef(columnDefinition, columnHeadersPosition, intl, dataView);
@@ -36,7 +43,7 @@ export function dataViewToColDefs({ dataView, columnHeadersPosition, columnWidth
             textWrapping,
             drillableItemsRef,
             dataViewFacade: dataView,
-            conditionalFormatting,
+            conditionalFormatting: effectiveConditionalFormatting,
             conditionalFormattingTriggers,
             conditionalFormattingDateBounds,
         })(colDef);

package/esm/next/features/styling/semanticConditionalFormatting.d.ts

@@ -0,0 +1,12 @@
+import { type IAttributeDescriptor, type IMeasureDescriptor } from "@gooddata/sdk-model";
+import { type IConditionalFormatting } from "../../types/conditionalFormatting.js";
+/**
+ * Blends the insight's own conditional-formatting config with rules inherited from the semantic
+ * layer (carried on the execution result's attribute/measure descriptors), resolving Inherited vs
+ * Custom per target. Returns an ordinary {@link IConditionalFormatting} that the rest of the
+ * engine (trigger resolution, date-bounds resolution, evaluation) consumes unmodified.
+ *
+ * @internal
+ */
+export declare function resolvePerTargetConditionalFormatting(insightConfig: IConditionalFormatting | undefined, attributeDescriptors: readonly IAttributeDescriptor[], measureDescriptors: readonly IMeasureDescriptor[]): IConditionalFormatting | undefined;
+//# sourceMappingURL=semanticConditionalFormatting.d.ts.map

package/esm/next/features/styling/semanticConditionalFormatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semanticConditionalFormatting.d.ts","sourceRoot":"","sources":["../../../../src/next/features/styling/semanticConditionalFormatting.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,oBAAoB,EAAE,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzF,OAAO,EAEH,KAAK,sBAAsB,EAE9B,MAAM,sCAAsC,CAAC;AA4C9C;;;;;;;GAOG;AACH,wBAAgB,qCAAqC,CACjD,aAAa,EAAE,sBAAsB,GAAG,SAAS,EACjD,oBAAoB,EAAE,SAAS,oBAAoB,EAAE,EACrD,kBAAkB,EAAE,SAAS,kBAAkB,EAAE,GAClD,sBAAsB,GAAG,SAAS,CA+BpC"}

package/esm/next/features/styling/semanticConditionalFormatting.js

@@ -0,0 +1,75 @@
+// (C) 2026 GoodData Corporation
+function targetKey(target) {
+    return target.kind === "attribute"
+        ? `attribute:${target.attributeIdentifier}`
+        : `measure:${target.measureIdentifier}`;
+}
+function materializeSemanticRules(attributeDescriptors, measureDescriptors) {
+    const attributeRules = attributeDescriptors.flatMap((descriptor) => {
+        const conditionalFormatting = descriptor.attributeHeader.conditionalFormatting;
+        if (!conditionalFormatting) {
+            return [];
+        }
+        return [
+            {
+                id: `semantic:attribute:${descriptor.attributeHeader.localIdentifier}`,
+                target: {
+                    kind: "attribute",
+                    attributeIdentifier: descriptor.attributeHeader.localIdentifier,
+                },
+                conditions: conditionalFormatting.conditions,
+            },
+        ];
+    });
+    const measureRules = measureDescriptors.flatMap((descriptor) => {
+        const conditionalFormatting = descriptor.measureHeaderItem.conditionalFormatting;
+        if (!conditionalFormatting) {
+            return [];
+        }
+        return [
+            {
+                id: `semantic:measure:${descriptor.measureHeaderItem.localIdentifier}`,
+                target: { kind: "measure", measureIdentifier: descriptor.measureHeaderItem.localIdentifier },
+                conditions: conditionalFormatting.conditions,
+            },
+        ];
+    });
+    return [...attributeRules, ...measureRules];
+}
+/**
+ * Blends the insight's own conditional-formatting config with rules inherited from the semantic
+ * layer (carried on the execution result's attribute/measure descriptors), resolving Inherited vs
+ * Custom per target. Returns an ordinary {@link IConditionalFormatting} that the rest of the
+ * engine (trigger resolution, date-bounds resolution, evaluation) consumes unmodified.
+ *
+ * @internal
+ */
+export function resolvePerTargetConditionalFormatting(insightConfig, attributeDescriptors, measureDescriptors) {
+    const semanticRules = materializeSemanticRules(attributeDescriptors, measureDescriptors);
+    if (semanticRules.length === 0) {
+        return insightConfig;
+    }
+    // `enabled` predates per-target Inherited/Custom and only ever meant "my authored rules are
+    // active" — it must not also suppress targets the creator never touched (that's what
+    // `customTargets` is for). A Custom target (has an authored rule) whose rules are inactive
+    // shows nothing rather than silently falling back to its inherited rule: `customModeTargets`
+    // is built from ALL authored rules regardless of `enabled`, so a disabled target stays
+    // excluded from inheritance even though its (inactive) rule is excluded from the merge below.
+    const allInsightRules = insightConfig?.rules ?? [];
+    const activeInsightRules = insightConfig?.enabled ? allInsightRules : [];
+    const customModeTargets = new Set([
+        ...allInsightRules.map((rule) => targetKey(rule.target)),
+        ...(insightConfig?.customTargets ?? []).map(targetKey),
+    ]);
+    const inheritedRules = semanticRules.filter((rule) => !customModeTargets.has(targetKey(rule.target)));
+    const mergedRules = [...activeInsightRules, ...inheritedRules];
+    if (mergedRules.length === 0) {
+        return undefined;
+    }
+    return {
+        version: insightConfig?.version,
+        enabled: true,
+        rules: mergedRules,
+        customTargets: insightConfig?.customTargets,
+    };
+}

package/esm/next/types/conditionalFormatting.d.ts

@@ -1,149 +1,6 @@
-import { type ComparisonConditionOperator, type DateFilterGranularity, type RangeConditionOperator } from "@gooddata/sdk-model";
+import type { ConditionalFormattingEmptinessOperator, ConditionalFormattingOperator, ConditionalFormattingTarget, ConditionalFormattingTextOperator, ConditionalFormattingValue, IConditionalFormatting, IConditionalFormattingCondition, IConditionalFormattingFormat, IConditionalFormattingRule } from "@gooddata/sdk-model";
 import { type PivotTableNextConfig } from "./public.js";
-/**
- * Identifies the measure or attribute a conditional-formatting rule targets. Layout-neutral on
- * purpose: the same target applies whether the item renders as a column or — when transposed — as a
- * row, so the rule survives a transpose without re-pointing.
- *
- * @alpha
- */
-export type ConditionalFormattingTarget = {
-    kind: "attribute";
-    attributeIdentifier: string;
-} | {
-    kind: "measure";
-    measureIdentifier: string;
-};
-/**
- * Substring operators specific to conditional formatting. No existing SDK enum covers text
- * matching (attribute filters are element-based IN/NOT_IN), so these are CF-specific.
- *
- * @alpha
- */
-export type ConditionalFormattingTextOperator = "CONTAINS" | "NOT_CONTAINS" | "STARTS_WITH" | "NOT_STARTS_WITH" | "ENDS_WITH" | "NOT_ENDS_WITH";
-/**
- * Emptiness operators — target-agnostic: an empty cell (null measure value, valueless attribute
- * element) is matched only by these, on any target kind.
- *
- * @alpha
- */
-export type ConditionalFormattingEmptinessOperator = "IS_EMPTY" | "IS_NOT_EMPTY";
-/**
- * Every operator a stored condition may carry. One shared, shape-grouped vocabulary: numeric and
- * range operators reuse the SDK measure-value-filter enums (`ComparisonConditionOperator`,
- * `RangeConditionOperator` from `@gooddata/sdk-model`); `"ALL"` always matches non-empty cells;
- * substring operators are {@link ConditionalFormattingTextOperator}; emptiness operators are
- * {@link ConditionalFormattingEmptinessOperator}. Which subset a target kind AUTHORS is editor
- * policy (see `operatorsForTarget` in sdk-ui-ext); the evaluation engine accepts any combination
- * and treats inapplicable ones as never matching.
- *
- * @alpha
- */
-export type ConditionalFormattingOperator = "ALL" | ComparisonConditionOperator | RangeConditionOperator | ConditionalFormattingTextOperator | ConditionalFormattingEmptinessOperator;
-/**
- * The operand a condition compares against. Discriminated so range / no-operand / date / (future
- * column-reference) shapes stay valid by construction.
- *
- * Date values target date attributes and express a period; a single date is a period whose bounds
- * coincide. "Is on" (EQUAL_TO) means the cell's period lies within the value period; "Is after"
- * (GREATER_THAN) means after the period ends; "Is before" (LESS_THAN) before it starts.
- *
- * @alpha
- */
-export type ConditionalFormattingValue = {
-    kind: "none";
-} | {
-    kind: "literal";
-    value: string | number;
-} | {
-    kind: "literalRange";
-    from: number;
-    to: number;
-} | {
-    kind: "absoluteDate";
-    /**
-     * Period start as a platform date string: "YYYY-MM-DD", or "YYYY-MM-DD HH:mm" for
-     * hour/minute-granularity targets. Snapped to the period start at save time.
-     */
-    from: string;
-    /**
-     * Inclusive period end — the last day (or minute) of the period, mirroring how absolute
-     * date filters store their `to` bound.
-     */
-    to: string;
-} | {
-    kind: "relativeDate";
-    /**
-     * Granularity the offsets count in (linear granularities only).
-     */
-    granularity: DateFilterGranularity;
-    /**
-     * Integer period offset of the range start; 0 = the period containing the anchor,
-     * negative = past, positive = future.
-     */
-    from: number;
-    /**
-     * Integer period offset of the range end (inclusive), \>= `from`.
-     */
-    to: number;
-};
-/**
- * The visual format applied to a matched cell or row.
- *
- * @alpha
- */
-export interface IConditionalFormattingFormat {
-    /**
-     * Text color (raw hex, e.g. "#FFFFFF").
-     */
-    color?: string;
-    /**
-     * Fill / background color (raw hex, e.g. "#E54D40").
-     */
-    backgroundColor?: string;
-    /**
-     * Whether the format applies to the matched cell only or the whole row.
-     */
-    scope: "cell" | "row";
-}
-/**
- * A single condition: an operator + operand, and the format applied when it matches.
- *
- * @alpha
- */
-export interface IConditionalFormattingCondition {
-    id: string;
-    operator: ConditionalFormattingOperator;
-    value: ConditionalFormattingValue;
-    format: IConditionalFormattingFormat;
-}
-/**
- * A rule targeting one measure or attribute with one or more stacked conditions. The first matching
- * condition (top-down) wins.
- *
- * @alpha
- */
-export interface IConditionalFormattingRule {
-    id: string;
-    target: ConditionalFormattingTarget;
-    conditions: readonly IConditionalFormattingCondition[];
-}
-/**
- * Conditional-formatting settings: an on/off toggle plus the ordered list of rules. Stored on the
- * table config and (when persisted) on the insight's `properties.controls.conditionalFormatting`.
- *
- * @alpha
- */
-export interface IConditionalFormatting {
-    /**
-     * Model version of the persisted shape (mirrors the dashboard model-version convention). Absent
-     * is treated as `"1"`. Lets the persisted contract evolve for cross-stack readers (e.g. server
-     * XLSX export) without breaking older saved insights.
-     */
-    version?: string;
-    enabled: boolean;
-    rules: readonly IConditionalFormattingRule[];
-}
+export type { ConditionalFormattingEmptinessOperator, ConditionalFormattingOperator, ConditionalFormattingTarget, ConditionalFormattingTextOperator, ConditionalFormattingValue, IConditionalFormatting, IConditionalFormattingCondition, IConditionalFormattingFormat, IConditionalFormattingRule, };
 /**
  * Resolved trigger columns, aligned by index to {@link IConditionalFormatting.rules}: each rule maps
  * to the colIds of every column that may hold its target's value. One colId for a non-pivoted target,
@@ -184,6 +41,14 @@ export type PivotTableNextConditionalFormattingConfig = {
      * Rules that color cells/rows based on their values. Absent = no conditional formatting.
      */
     conditionalFormatting?: IConditionalFormatting;
+    /**
+     * Whether the engine may inherit conditional formatting from semantic-layer catalog objects
+     * (carried on execution result headers). Defaults to `false` — `conditionalFormatting` being
+     * absent/disabled is not enough to keep inheritance off, since it's resolved independently
+     * from descriptors the host can't otherwise suppress. Off by default so every consumer ships
+     * dark until it explicitly opts in.
+     */
+    enableSemanticConditionalFormatting?: boolean;
 };
 /**
  * {@link PivotTableNextConfig} extended with the conditional formatting configuration.

package/esm/next/types/conditionalFormatting.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conditionalFormatting.d.ts","sourceRoot":"","sources":["../../../src/next/types/conditionalFormatting.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"conditionalFormatting.d.ts","sourceRoot":"","sources":["../../../src/next/types/conditionalFormatting.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACR,sCAAsC,EACtC,6BAA6B,EAC7B,2BAA2B,EAC3B,iCAAiC,EACjC,0BAA0B,EAC1B,sBAAsB,EACtB,+BAA+B,EAC/B,4BAA4B,EAC5B,0BAA0B,EAC7B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAExD,YAAY,EACR,sCAAsC,EACtC,6BAA6B,EAC7B,2BAA2B,EAC3B,iCAAiC,EACjC,0BAA0B,EAC1B,sBAAsB,EACtB,+BAA+B,EAC/B,4BAA4B,EAC5B,0BAA0B,GAC7B,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,kCAAkC,GAAG,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC;AAEhF;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,+BAA+B,GAAG,MAAM,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAAC,CAAC;AAE1F;;;;;GAKG;AACH,MAAM,MAAM,yCAAyC,GAAG;IACpD;;OAEG;IACH,qBAAqB,CAAC,EAAE,sBAAsB,CAAC;IAC/C;;;;;;OAMG;IACH,mCAAmC,CAAC,EAAE,OAAO,CAAC;CACjD,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,6CAA6C,GAAG,oBAAoB,GAC5E,yCAAyC,CAAC"}

package/esm/sdk-ui-pivot.d.ts

@@ -9,13 +9,20 @@
 
 import { AttributesMeasuresOrPlaceholders } from '@gooddata/sdk-ui';
 import { AttributesOrPlaceholders } from '@gooddata/sdk-ui';
-import { ComparisonConditionOperator } from '@gooddata/sdk-model';
-import { DateFilterGranularity } from '@gooddata/sdk-model';
+import type { ConditionalFormattingEmptinessOperator } from '@gooddata/sdk-model';
+import type { ConditionalFormattingOperator } from '@gooddata/sdk-model';
+import type { ConditionalFormattingTarget } from '@gooddata/sdk-model';
+import type { ConditionalFormattingTextOperator } from '@gooddata/sdk-model';
+import type { ConditionalFormattingValue } from '@gooddata/sdk-model';
 import { ExplicitDrill } from '@gooddata/sdk-ui';
 import { IAnalyticalBackend } from '@gooddata/sdk-backend-spi';
 import { IAttribute } from '@gooddata/sdk-model';
 import { IBackendCapabilities } from '@gooddata/sdk-backend-spi';
 import { IBucket } from '@gooddata/sdk-model';
+import type { IConditionalFormatting } from '@gooddata/sdk-model';
+import type { IConditionalFormattingCondition } from '@gooddata/sdk-model';
+import type { IConditionalFormattingFormat } from '@gooddata/sdk-model';
+import type { IConditionalFormattingRule } from '@gooddata/sdk-model';
 import { Identifier } from '@gooddata/sdk-model';
 import { IDimension } from '@gooddata/sdk-model';
 import { IExecutionConfig } from '@gooddata/sdk-model';
@@ -27,7 +34,6 @@ import { IVisualizationCallbacks } from '@gooddata/sdk-ui';
 import { IVisualizationProps } from '@gooddata/sdk-ui';
 import { JSX } from 'react/jsx-runtime';
 import { NullableFiltersOrPlaceholders } from '@gooddata/sdk-ui';
-import { RangeConditionOperator } from '@gooddata/sdk-model';
 import { SortsOrPlaceholders } from '@gooddata/sdk-ui';
 import { TotalsOrPlaceholders } from '@gooddata/sdk-ui';
 import { TotalType } from '@gooddata/sdk-model';
@@ -82,97 +88,15 @@ export declare type ColumnWidthItemNext = IAttributeColumnWidthItemNext | IMeasu
  */
 export declare type ColumnWidthNext = IAbsoluteColumnWidthNext | IAutoColumnWidthNext;
 
-/**
- * Emptiness operators — target-agnostic: an empty cell (null measure value, valueless attribute
- * element) is matched only by these, on any target kind.
- *
- * @alpha
- */
-export declare type ConditionalFormattingEmptinessOperator = "IS_EMPTY" | "IS_NOT_EMPTY";
+export { ConditionalFormattingEmptinessOperator }
 
-/**
- * Every operator a stored condition may carry. One shared, shape-grouped vocabulary: numeric and
- * range operators reuse the SDK measure-value-filter enums (`ComparisonConditionOperator`,
- * `RangeConditionOperator` from `@gooddata/sdk-model`); `"ALL"` always matches non-empty cells;
- * substring operators are {@link ConditionalFormattingTextOperator}; emptiness operators are
- * {@link ConditionalFormattingEmptinessOperator}. Which subset a target kind AUTHORS is editor
- * policy (see `operatorsForTarget` in sdk-ui-ext); the evaluation engine accepts any combination
- * and treats inapplicable ones as never matching.
- *
- * @alpha
- */
-export declare type ConditionalFormattingOperator = "ALL" | ComparisonConditionOperator | RangeConditionOperator | ConditionalFormattingTextOperator | ConditionalFormattingEmptinessOperator;
+export { ConditionalFormattingOperator }
 
-/**
- * Identifies the measure or attribute a conditional-formatting rule targets. Layout-neutral on
- * purpose: the same target applies whether the item renders as a column or — when transposed — as a
- * row, so the rule survives a transpose without re-pointing.
- *
- * @alpha
- */
-export declare type ConditionalFormattingTarget = {
-    kind: "attribute";
-    attributeIdentifier: string;
-} | {
-    kind: "measure";
-    measureIdentifier: string;
-};
+export { ConditionalFormattingTarget }
 
-/**
- * Substring operators specific to conditional formatting. No existing SDK enum covers text
- * matching (attribute filters are element-based IN/NOT_IN), so these are CF-specific.
- *
- * @alpha
- */
-export declare type ConditionalFormattingTextOperator = "CONTAINS" | "NOT_CONTAINS" | "STARTS_WITH" | "NOT_STARTS_WITH" | "ENDS_WITH" | "NOT_ENDS_WITH";
+export { ConditionalFormattingTextOperator }
 
-/**
- * The operand a condition compares against. Discriminated so range / no-operand / date / (future
- * column-reference) shapes stay valid by construction.
- *
- * Date values target date attributes and express a period; a single date is a period whose bounds
- * coincide. "Is on" (EQUAL_TO) means the cell's period lies within the value period; "Is after"
- * (GREATER_THAN) means after the period ends; "Is before" (LESS_THAN) before it starts.
- *
- * @alpha
- */
-export declare type ConditionalFormattingValue = {
-    kind: "none";
-} | {
-    kind: "literal";
-    value: string | number;
-} | {
-    kind: "literalRange";
-    from: number;
-    to: number;
-} | {
-    kind: "absoluteDate";
-    /**
-     * Period start as a platform date string: "YYYY-MM-DD", or "YYYY-MM-DD HH:mm" for
-     * hour/minute-granularity targets. Snapped to the period start at save time.
-     */
-    from: string;
-    /**
-     * Inclusive period end — the last day (or minute) of the period, mirroring how absolute
-     * date filters store their `to` bound.
-     */
-    to: string;
-} | {
-    kind: "relativeDate";
-    /**
-     * Granularity the offsets count in (linear granularities only).
-     */
-    granularity: DateFilterGranularity;
-    /**
-     * Integer period offset of the range start; 0 = the period containing the anchor,
-     * negative = past, positive = future.
-     */
-    from: number;
-    /**
-     * Integer period offset of the range end (inclusive), \>= `from`.
-     */
-    to: number;
-};
+export { ConditionalFormattingValue }
 
 /**
  * @internal
@@ -453,66 +377,13 @@ export declare interface IColumnTextWrappingItem {
     matchType?: "column" | "pivotGroup";
 }
 
-/**
- * Conditional-formatting settings: an on/off toggle plus the ordered list of rules. Stored on the
- * table config and (when persisted) on the insight's `properties.controls.conditionalFormatting`.
- *
- * @alpha
- */
-export declare interface IConditionalFormatting {
-    /**
-     * Model version of the persisted shape (mirrors the dashboard model-version convention). Absent
-     * is treated as `"1"`. Lets the persisted contract evolve for cross-stack readers (e.g. server
-     * XLSX export) without breaking older saved insights.
-     */
-    version?: string;
-    enabled: boolean;
-    rules: readonly IConditionalFormattingRule[];
-}
+export { IConditionalFormatting }
 
-/**
- * A single condition: an operator + operand, and the format applied when it matches.
- *
- * @alpha
- */
-export declare interface IConditionalFormattingCondition {
-    id: string;
-    operator: ConditionalFormattingOperator;
-    value: ConditionalFormattingValue;
-    format: IConditionalFormattingFormat;
-}
+export { IConditionalFormattingCondition }
 
-/**
- * The visual format applied to a matched cell or row.
- *
- * @alpha
- */
-export declare interface IConditionalFormattingFormat {
-    /**
-     * Text color (raw hex, e.g. "#FFFFFF").
-     */
-    color?: string;
-    /**
-     * Fill / background color (raw hex, e.g. "#E54D40").
-     */
-    backgroundColor?: string;
-    /**
-     * Whether the format applies to the matched cell only or the whole row.
-     */
-    scope: "cell" | "row";
-}
+export { IConditionalFormattingFormat }
 
-/**
- * A rule targeting one measure or attribute with one or more stacked conditions. The first matching
- * condition (top-down) wins.
- *
- * @alpha
- */
-export declare interface IConditionalFormattingRule {
-    id: string;
-    target: ConditionalFormattingTarget;
-    conditions: readonly IConditionalFormattingCondition[];
-}
+export { IConditionalFormattingRule }
 
 /**
  * @internal
@@ -1386,6 +1257,14 @@ export declare type PivotTableNextConditionalFormattingConfig = {
      * Rules that color cells/rows based on their values. Absent = no conditional formatting.
      */
     conditionalFormatting?: IConditionalFormatting;
+    /**
+     * Whether the engine may inherit conditional formatting from semantic-layer catalog objects
+     * (carried on execution result headers). Defaults to `false` — `conditionalFormatting` being
+     * absent/disabled is not enough to keep inheritance off, since it's resolved independently
+     * from descriptors the host can't otherwise suppress. Off by default so every consumer ships
+     * dark until it explicitly opts in.
+     */
+    enableSemanticConditionalFormatting?: boolean;
 };
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gooddata/sdk-ui-pivot",
-  "version": "11.53.0-alpha.0",
+  "version": "11.53.0-alpha.1",
   "description": "GoodData.UI SDK - Pivot Table",
   "license": "MIT",
   "author": "GoodData Corporation",
@@ -42,12 +42,12 @@
     "ts-invariant": "0.10.3",
     "tslib": "2.8.1",
     "uuid": "11.1.1",
-    "@gooddata/sdk-backend-spi": "11.53.0-alpha.0",
-    "@gooddata/sdk-model": "11.53.0-alpha.0",
-    "@gooddata/sdk-ui": "11.53.0-alpha.0",
-    "@gooddata/sdk-ui-kit": "11.53.0-alpha.0",
-    "@gooddata/sdk-ui-theme-provider": "11.53.0-alpha.0",
-    "@gooddata/sdk-ui-vis-commons": "11.53.0-alpha.0"
+    "@gooddata/sdk-backend-spi": "11.53.0-alpha.1",
+    "@gooddata/sdk-model": "11.53.0-alpha.1",
+    "@gooddata/sdk-ui-kit": "11.53.0-alpha.1",
+    "@gooddata/sdk-ui-theme-provider": "11.53.0-alpha.1",
+    "@gooddata/sdk-ui": "11.53.0-alpha.1",
+    "@gooddata/sdk-ui-vis-commons": "11.53.0-alpha.1"
   },
   "devDependencies": {
     "@microsoft/api-documenter": "^7.17.0",
@@ -89,12 +89,12 @@
     "typescript": "5.9.3",
     "vitest": "4.1.8",
     "vitest-dom": "0.1.1",
-    "@gooddata/eslint-config": "11.53.0-alpha.0",
-    "@gooddata/oxlint-config": "11.53.0-alpha.0",
-    "@gooddata/reference-workspace": "11.53.0-alpha.0",
-    "@gooddata/sdk-backend-mockingbird": "11.53.0-alpha.0",
-    "@gooddata/sdk-backend-base": "11.53.0-alpha.0",
-    "@gooddata/stylelint-config": "11.53.0-alpha.0"
+    "@gooddata/eslint-config": "11.53.0-alpha.1",
+    "@gooddata/oxlint-config": "11.53.0-alpha.1",
+    "@gooddata/reference-workspace": "11.53.0-alpha.1",
+    "@gooddata/sdk-backend-mockingbird": "11.53.0-alpha.1",
+    "@gooddata/sdk-backend-base": "11.53.0-alpha.1",
+    "@gooddata/stylelint-config": "11.53.0-alpha.1"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",