@gooddata/sdk-model 11.55.0-alpha.0 → 11.55.0-alpha.2

package/esm/reports/factory.js

@@ -1,5 +1,6 @@
 // (C) 2026 GoodData Corporation
 import { isReportLayoutSection } from "./layout.js";
+import { isReportImageBackground } from "./styling.js";
 function generateReportLocalId(prefix) {
     const unique = typeof crypto !== "undefined" && typeof crypto.randomUUID === "function"
         ? crypto.randomUUID().replace(/-/g, "").slice(0, 12)
@@ -9,10 +10,20 @@ function generateReportLocalId(prefix) {
 function deepClone(value) {
     return JSON.parse(JSON.stringify(value));
 }
+function prefixBackgroundSlotId(style, prefix) {
+    if (!style?.background || !isReportImageBackground(style.background)) {
+        return style;
+    }
+    return {
+        ...style,
+        background: { ...style.background, slotId: `${prefix}_${style.background.slotId}` },
+    };
+}
 function prefixLayoutSlotIds(node, prefix) {
     if (isReportLayoutSection(node)) {
         return {
             ...node,
+            ...(node.style === undefined ? {} : { style: prefixBackgroundSlotId(node.style, prefix) }),
             children: node.children.map((child) => prefixLayoutSlotIds(child, prefix)),
         };
     }
@@ -50,6 +61,7 @@ export function newReportContentPageFromLayout(page, localIdentifier = generateR
     return {
         ...body,
         localIdentifier,
+        ...(body.style === undefined ? {} : { style: prefixBackgroundSlotId(body.style, localIdentifier) }),
         layout: prefixLayoutSlotIds(body.layout, localIdentifier),
         slots: body.slots.map((slot) => ({
             ...slot,

package/esm/reports/layout.d.ts

@@ -1,7 +1,8 @@
+import { type IReportBoxStyle } from "./styling.js";
 /**
  * Node of a report page layout: a recursive row/column split tree (flexbox semantics)
- * over a fixed page. Leaves assign their area to slots; the tree carries only geometry,
- * slot content lives in {@link IReportPageBody.slots}.
+ * over a fixed page. Leaves assign their area to slots; the tree carries geometry and
+ * box paint, slot content lives in {@link IReportPageBody.slots}.
  *
  * @alpha
  */
@@ -30,6 +31,10 @@ export interface IReportLayoutSection extends IReportLayoutNodeBase {
      */
     direction: "row" | "column";
     children: ReportPageLayoutNode[];
+    /**
+     * Paint of this section's box. Never affects how children are laid out.
+     */
+    style?: IReportBoxStyle;
 }
 /**
  * A leaf assigning its area to a slot. The slot fills the area completely.

package/esm/reports/layout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/reports/layout.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,GAAG,oBAAoB,CAAC;AAE/E;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IAClC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAqB,SAAQ,qBAAqB;IAC/D,IAAI,EAAE,SAAS,CAAC;IAEhB;;OAEG;IACH,SAAS,EAAE,KAAK,GAAG,QAAQ,CAAC;IAE5B,QAAQ,EAAE,oBAAoB,EAAE,CAAC;CACpC;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAqB,SAAQ,qBAAqB;IAC/D,IAAI,EAAE,SAAS,CAAC;IAEhB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,oBAAoB,CAE/E;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,oBAAoB,CAE/E"}
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/reports/layout.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,GAAG,oBAAoB,CAAC;AAE/E;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IAClC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAqB,SAAQ,qBAAqB;IAC/D,IAAI,EAAE,SAAS,CAAC;IAEhB;;OAEG;IACH,SAAS,EAAE,KAAK,GAAG,QAAQ,CAAC;IAE5B,QAAQ,EAAE,oBAAoB,EAAE,CAAC;IAEjC;;OAEG;IACH,KAAK,CAAC,EAAE,eAAe,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAqB,SAAQ,qBAAqB;IAC/D,IAAI,EAAE,SAAS,CAAC;IAEhB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,oBAAoB,CAE/E;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,oBAAoB,CAE/E"}

package/esm/reports/pageFormat.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Page shape a report page layout is designed for.
+ *
+ * @remarks
+ * A layout's geometry only reads correctly at the proportions it was authored for: a row of three
+ * visualizations that works on a widescreen slide is unusably narrow on an upright page. The format
+ * is therefore a property of the page, not a choice made when rendering it.
+ *
+ * @alpha
+ */
+export type ReportPageFormat = "widescreen" | "a4Portrait" | "letterPortrait";
+/**
+ * Format assumed by a page that declares none, which keeps pages authored before formats existed
+ * on the shape they were designed for.
+ *
+ * @alpha
+ */
+export declare const DefaultReportPageFormat: ReportPageFormat;
+/**
+ * List of built-in report page format names.
+ *
+ * @alpha
+ */
+export declare const ReportPageFormats: ReportPageFormat[];
+/**
+ * Width divided by height for each page format: 16:9 for a slide, ISO A4 (210 x 297 mm) and
+ * US Letter (8.5 x 11 in) upright.
+ *
+ * @alpha
+ */
+export declare const ReportPageFormatAspectRatios: Record<ReportPageFormat, number>;
+/**
+ * Type-guard testing whether the provided value is a {@link ReportPageFormat}.
+ *
+ * @alpha
+ */
+export declare function isReportPageFormat(value: unknown): value is ReportPageFormat;
+//# sourceMappingURL=pageFormat.d.ts.map

package/esm/reports/pageFormat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pageFormat.d.ts","sourceRoot":"","sources":["../../src/reports/pageFormat.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,YAAY,GAAG,gBAAgB,CAAC;AAE9E;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,EAAE,gBAA+B,CAAC;AAEtE;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,gBAAgB,EAAmD,CAAC;AAEpG;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAIzE,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAE5E"}

package/esm/reports/pageFormat.js

@@ -0,0 +1,33 @@
+// (C) 2026 GoodData Corporation
+/**
+ * Format assumed by a page that declares none, which keeps pages authored before formats existed
+ * on the shape they were designed for.
+ *
+ * @alpha
+ */
+export const DefaultReportPageFormat = "widescreen";
+/**
+ * List of built-in report page format names.
+ *
+ * @alpha
+ */
+export const ReportPageFormats = ["widescreen", "a4Portrait", "letterPortrait"];
+/**
+ * Width divided by height for each page format: 16:9 for a slide, ISO A4 (210 x 297 mm) and
+ * US Letter (8.5 x 11 in) upright.
+ *
+ * @alpha
+ */
+export const ReportPageFormatAspectRatios = {
+    widescreen: 16 / 9,
+    a4Portrait: 210 / 297,
+    letterPortrait: 8.5 / 11,
+};
+/**
+ * Type-guard testing whether the provided value is a {@link ReportPageFormat}.
+ *
+ * @alpha
+ */
+export function isReportPageFormat(value) {
+    return typeof value === "string" && ReportPageFormats.includes(value);
+}

package/esm/reports/pageLayout.d.ts

@@ -2,7 +2,9 @@ import { type IAuditableDates, type IAuditableUsers } from "../base/metadata.js"
 import { type FilterContextItem } from "../dashboard/filterContext.js";
 import { type ObjRef } from "../objRef/index.js";
 import { type ReportPageLayoutNode } from "./layout.js";
+import { type ReportPageFormat } from "./pageFormat.js";
 import { type ReportSlot } from "./slot.js";
+import { type IReportBoxStyle } from "./styling.js";
 /**
  * Body of a report page: geometry (flex split tree) plus the slots it places.
  *
@@ -22,6 +24,15 @@ export interface IReportPageBody {
      * Renderers must not branch layout logic on it — geometry always comes from `layout`.
      */
     kind?: "cover" | "section" | "content";
+    /**
+     * Page proportions the layout was authored for. Defaults to
+     * {@link DefaultReportPageFormat}.
+     */
+    format?: ReportPageFormat;
+    /**
+     * Paint of the page itself, behind everything the layout places.
+     */
+    style?: IReportBoxStyle;
     /**
      * Root of the page layout tree.
      */
@@ -109,10 +120,11 @@ export interface IReportPageBodyValidationIssue {
     message: string;
 }
 /**
- * Validates the structural invariants of a page body the type system cannot express:
- * slot localIdentifiers are unique, layout weights are positive, every slot is placed
- * by the layout, and every layout slotId resolves (unresolved ones are warnings —
- * they render as empty areas).
+ * Validates the structural invariants of a page body beyond what its types guarantee for content
+ * arriving from the wire: the page format is known, slot localIdentifiers are unique, layout
+ * weights are positive, every slot is placed (by the layout or as a background), every layout
+ * slotId resolves (unresolved ones are warnings — they render as empty areas), and background
+ * references resolve to image slots.
  *
  * @alpha
  */

package/esm/reports/pageLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pageLayout.d.ts","sourceRoot":"","sources":["../../src/reports/pageLayout.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,KAAK,MAAM,EAAY,MAAM,oBAAoB,CAAC;AAE3D,OAAO,EAAE,KAAK,oBAAoB,EAAgD,MAAM,aAAa,CAAC;AACtG,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,eAAe;IAC5B;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IAEvC;;OAEG;IACH,MAAM,EAAE,oBAAoB,CAAC;IAE7B;;OAEG;IACH,KAAK,EAAE,UAAU,EAAE,CAAC;IAEpB;;;OAGG;IACH,OAAO,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACjC;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAyB,SAAQ,eAAe;IAC7D;;OAEG;IACH,OAAO,EAAE,GAAG,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IACxC,IAAI,EAAE,kBAAkB,CAAC;IAEzB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,KAAK,EAAE,MAAM,CAAC;IAEd,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB,OAAO,EAAE,wBAAwB,CAAC;CACrC;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAkB,SAAQ,2BAA2B,EAAE,eAAe,EAAE,eAAe;IACpG,GAAG,EAAE,MAAM,CAAC;IAEZ;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,2BAA2B,CAE7F;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,iBAAiB,CAEzE;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,wBAAwB,CAOzF;AAED;;;;GAIG;AACH,MAAM,WAAW,8BAA8B;IAC3C,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,eAAe,GAAG,8BAA8B,EAAE,CA8C9F"}
+{"version":3,"file":"pageLayout.d.ts","sourceRoot":"","sources":["../../src/reports/pageLayout.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,KAAK,MAAM,EAAY,MAAM,oBAAoB,CAAC;AAE3D,OAAO,EAAE,KAAK,oBAAoB,EAAgD,MAAM,aAAa,CAAC;AACtG,OAAO,EAAE,KAAK,gBAAgB,EAAsB,MAAM,iBAAiB,CAAC;AAC5E,OAAO,EAAE,KAAK,UAAU,EAAqB,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,KAAK,eAAe,EAA2B,MAAM,cAAc,CAAC;AAE7E;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,eAAe;IAC5B;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IAEvC;;;OAGG;IACH,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAE1B;;OAEG;IACH,KAAK,CAAC,EAAE,eAAe,CAAC;IAExB;;OAEG;IACH,MAAM,EAAE,oBAAoB,CAAC;IAE7B;;OAEG;IACH,KAAK,EAAE,UAAU,EAAE,CAAC;IAEpB;;;OAGG;IACH,OAAO,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACjC;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAyB,SAAQ,eAAe;IAC7D;;OAEG;IACH,OAAO,EAAE,GAAG,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IACxC,IAAI,EAAE,kBAAkB,CAAC;IAEzB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,KAAK,EAAE,MAAM,CAAC;IAEd,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB,OAAO,EAAE,wBAAwB,CAAC;CACrC;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAkB,SAAQ,2BAA2B,EAAE,eAAe,EAAE,eAAe;IACpG,GAAG,EAAE,MAAM,CAAC;IAEZ;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,2BAA2B,CAE7F;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,iBAAiB,CAEzE;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,wBAAwB,CAOzF;AAED;;;;GAIG;AACH,MAAM,WAAW,8BAA8B;IAC3C,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,eAAe,GAAG,8BAA8B,EAAE,CA8E9F"}

package/esm/reports/pageLayout.js

@@ -2,6 +2,9 @@
 import { isEmpty } from "lodash-es";
 import { isObjRef } from "../objRef/index.js";
 import { isReportLayoutSection, isReportLayoutSlotRef } from "./layout.js";
+import { isReportPageFormat } from "./pageFormat.js";
+import { isReportImageSlot } from "./slot.js";
+import { isReportImageBackground } from "./styling.js";
 /**
  * Type-guard testing whether the provided object is an instance of {@link IReportPageLayoutDefinition}.
  *
@@ -30,15 +33,19 @@ export function isReportPageLayoutContentV1(obj) {
         Array.isArray(obj.slots));
 }
 /**
- * Validates the structural invariants of a page body the type system cannot express:
- * slot localIdentifiers are unique, layout weights are positive, every slot is placed
- * by the layout, and every layout slotId resolves (unresolved ones are warnings —
- * they render as empty areas).
+ * Validates the structural invariants of a page body beyond what its types guarantee for content
+ * arriving from the wire: the page format is known, slot localIdentifiers are unique, layout
+ * weights are positive, every slot is placed (by the layout or as a background), every layout
+ * slotId resolves (unresolved ones are warnings — they render as empty areas), and background
+ * references resolve to image slots.
  *
  * @alpha
  */
 export function validateReportPageBody(body) {
     const issues = [];
+    if (body.format !== undefined && !isReportPageFormat(body.format)) {
+        issues.push({ severity: "error", message: `Unknown page format "${body.format}".` });
+    }
     const slotIds = new Set();
     for (const slot of body.slots) {
         if (slotIds.has(slot.localIdentifier)) {
@@ -49,6 +56,32 @@ export function validateReportPageBody(body) {
         }
         slotIds.add(slot.localIdentifier);
     }
+    const slotsById = new Map(body.slots.map((slot) => [slot.localIdentifier, slot]));
+    const backgroundIds = new Set();
+    const checkBackground = (style) => {
+        if (!style?.background || !isReportImageBackground(style.background)) {
+            return;
+        }
+        const { slotId } = style.background;
+        const slot = slotsById.get(slotId);
+        if (slot === undefined) {
+            issues.push({
+                severity: "warning",
+                message: `Background references slot "${slotId}" which has no definition; no background renders.`,
+            });
+            return;
+        }
+        if (!isReportImageSlot(slot)) {
+            issues.push({
+                severity: "error",
+                message: `Background references slot "${slotId}" which is not an image slot.`,
+            });
+            return;
+        }
+        // Only a reference that actually renders counts as placing its slot.
+        backgroundIds.add(slotId);
+    };
+    checkBackground(body.style);
     const referencedIds = new Set();
     const visit = (node) => {
         if (node.weight !== undefined && !(node.weight > 0)) {
@@ -67,12 +100,13 @@ export function validateReportPageBody(body) {
             }
         }
         else if (isReportLayoutSection(node)) {
+            checkBackground(node.style);
             node.children.forEach(visit);
         }
     };
     visit(body.layout);
     for (const slotId of slotIds) {
-        if (!referencedIds.has(slotId)) {
+        if (!referencedIds.has(slotId) && !backgroundIds.has(slotId)) {
             issues.push({
                 severity: "warning",
                 message: `Slot "${slotId}" is not placed by the layout and never renders.`,

package/esm/reports/slot.d.ts

@@ -1,6 +1,7 @@
 import { type FilterContextItem, type IDashboardFilterReference } from "../dashboard/filterContext.js";
 import { type VisualizationProperties } from "../insight/index.js";
 import { type ObjRef } from "../objRef/index.js";
+import { type IReportImageStyle, type IReportTextStyle } from "./styling.js";
 /**
  * Metadata of a slot that is intentionally left unfilled in a report page or template.
  *
@@ -134,6 +135,10 @@ export type ReportTextSource = IReportStaticTextSource | IReportAiTextSource;
 export interface IReportTextSlot extends IReportSlotBase {
     type: "text";
     kind: ReportTextSlotKind;
+    /**
+     * Ink and placement overrides on top of the kind's defaults.
+     */
+    style?: IReportTextStyle;
     /**
      * Undefined = declared-but-empty slot.
      */
@@ -173,6 +178,10 @@ export interface IReportImageSlot extends IReportSlotBase {
      * How the image fills the slot area. Defaults to "contain".
      */
     fit?: "contain" | "cover" | "fill";
+    /**
+     * Placement overrides for the drawn image; centered on both axes by default.
+     */
+    style?: IReportImageStyle;
 }
 /**
  * All slot types of report content version 1.

package/esm/reports/slot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"slot.d.ts","sourceRoot":"","sources":["../../src/reports/slot.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"slot.d.ts","sourceRoot":"","sources":["../../src/reports/slot.ts"],"names":[],"mappings":"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"}

package/esm/reports/styling.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Where content sits inside the box that carries it, along one axis.
+ *
+ * @alpha
+ */
+export type ReportContentAlignment = "start" | "center" | "end";
+/**
+ * Solid color painted behind a section's or page's content.
+ *
+ * @alpha
+ */
+export interface IReportColorBackground {
+    type: "color";
+    /**
+     * CSS color value. Absolute: report styling states brand colors directly and does not
+     * follow the workspace theme.
+     */
+    color: string;
+}
+/**
+ * Image painted behind a section's or page's content.
+ *
+ * @alpha
+ */
+export interface IReportImageBackground {
+    type: "image";
+    /**
+     * Local identifier of an image slot in {@link IReportPageBody.slots}. Routing the image
+     * through a slot keeps it template-fillable and gives it the slot's placeholder metadata.
+     * A reference that is missing or resolves to a non-image slot paints no background.
+     */
+    slotId: string;
+}
+/**
+ * What a section or page paints behind its content.
+ *
+ * @alpha
+ */
+export type ReportBackground = IReportColorBackground | IReportImageBackground;
+/**
+ * Paint of the box itself. Never affects the geometry of the box or its children —
+ * geometry always comes from layout weights.
+ *
+ * @alpha
+ */
+export interface IReportBoxStyle {
+    background?: ReportBackground;
+}
+/**
+ * Styling of the text a text slot owns.
+ *
+ * @remarks
+ * Overrides the ink and placement of the slot's {@link ReportTextSlotKind} defaults; the kind
+ * keeps owning semantic typography (size and weight).
+ *
+ * @alpha
+ */
+export interface IReportTextStyle {
+    /**
+     * CSS color value. Absolute, like {@link IReportColorBackground.color}.
+     */
+    color?: string;
+    horizontalAlign?: ReportContentAlignment;
+    verticalAlign?: ReportContentAlignment;
+}
+/**
+ * Where the drawn image sits when it does not fill its box, and which part of it is kept when it
+ * is cropped to fill one.
+ *
+ * @alpha
+ */
+export interface IReportImageStyle {
+    horizontalAlign?: ReportContentAlignment;
+    verticalAlign?: ReportContentAlignment;
+}
+/**
+ * Type-guard testing whether the provided object is an instance of {@link IReportColorBackground}.
+ *
+ * @alpha
+ */
+export declare function isReportColorBackground(obj: unknown): obj is IReportColorBackground;
+/**
+ * Type-guard testing whether the provided object is an instance of {@link IReportImageBackground}.
+ *
+ * @alpha
+ */
+export declare function isReportImageBackground(obj: unknown): obj is IReportImageBackground;
+//# sourceMappingURL=styling.d.ts.map

package/esm/reports/styling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styling.d.ts","sourceRoot":"","sources":["../../src/reports/styling.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEhE;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACnC,IAAI,EAAE,OAAO,CAAC;IAEd;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACnC,IAAI,EAAE,OAAO,CAAC;IAEd;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,sBAAsB,GAAG,sBAAsB,CAAC;AAE/E;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC5B,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACjC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB;IAC7B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,eAAe,CAAC,EAAE,sBAAsB,CAAC;IAEzC,aAAa,CAAC,EAAE,sBAAsB,CAAC;CAC1C;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAC9B,eAAe,CAAC,EAAE,sBAAsB,CAAC;IAEzC,aAAa,CAAC,EAAE,sBAAsB,CAAC;CAC1C;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,sBAAsB,CAEnF;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,sBAAsB,CAEnF"}

package/esm/reports/styling.js

@@ -0,0 +1,18 @@
+// (C) 2026 GoodData Corporation
+import { isEmpty } from "lodash-es";
+/**
+ * Type-guard testing whether the provided object is an instance of {@link IReportColorBackground}.
+ *
+ * @alpha
+ */
+export function isReportColorBackground(obj) {
+    return !isEmpty(obj) && obj.type === "color";
+}
+/**
+ * Type-guard testing whether the provided object is an instance of {@link IReportImageBackground}.
+ *
+ * @alpha
+ */
+export function isReportImageBackground(obj) {
+    return !isEmpty(obj) && obj.type === "image";
+}