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

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

@@ -1 +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"}
+{"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;IAE9B;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACrD;;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/variables.d.ts

@@ -13,7 +13,7 @@ export type ReportDateString = string;
  *
  * @alpha
  */
-export type ReportBuiltInVariable = "reportTitle" | "periodStart" | "periodEnd" | "workspaceName" | "generatedAt" | "pageNumber" | "totalPages" | "logo";
+export type ReportBuiltInVariable = "reportTitle" | "periodStart" | "periodEnd" | "workspaceName" | "generatedAt" | "pageNumber" | "totalPages" | "logo" | "logoInverse";
 /**
  * All built-in report variable names.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"variables.d.ts","sourceRoot":"","sources":["../../src/reports/variables.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEtC;;;;;;;;GAQG;AACH,MAAM,MAAM,qBAAqB,GAC3B,aAAa,GACb,aAAa,GACb,WAAW,GACX,eAAe,GACf,aAAa,GACb,YAAY,GACZ,YAAY,GACZ,MAAM,CAAC;AAEb;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,qBAAqB,EASzD,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,WAAW,yBAAyB;IACtC;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAID;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAShE;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAIlG"}
+{"version":3,"file":"variables.d.ts","sourceRoot":"","sources":["../../src/reports/variables.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEtC;;;;;;;;GAQG;AACH,MAAM,MAAM,qBAAqB,GAC3B,aAAa,GACb,aAAa,GACb,WAAW,GACX,eAAe,GACf,aAAa,GACb,YAAY,GACZ,YAAY,GACZ,MAAM,GACN,aAAa,CAAC;AAEpB;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,qBAAqB,EAUzD,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,WAAW,yBAAyB;IACtC;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAID;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAShE;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAIlG"}

package/esm/reports/variables.js

@@ -13,6 +13,7 @@ export const ReportBuiltInVariables = [
     "pageNumber",
     "totalPages",
     "logo",
+    "logoInverse",
 ];
 const placeholderRegex = /\{\{([a-zA-Z][a-zA-Z0-9_]*)\}\}/g;
 /**

package/esm/sdk-model.d.ts

@@ -471,6 +471,24 @@ export declare function attributeElementsCount(attributeElements: IAttributeElem
  */
 export declare function attributeElementsIsEmpty(attributeElements: IAttributeElements): boolean;
 
+/**
+ * Converts {@link IAttributeFilter} to {@link DashboardAttributeFilterItem}.
+ *
+ * @remarks
+ * For arbitrary and match filters, returns the corresponding dedicated dashboard filter type
+ * with full lossless conversion. For element-based filters, returns {@link IDashboardAttributeFilter}.
+ *
+ * @alpha
+ * @param filter - filter to convert
+ * @param localIdentifier - localIdentifier of the filter
+ * @param title - custom title of the filter
+ * @param attributeElements - currently selected elements. Only used for element-based filters.
+ * @param isInverted - whether filter has negative selection (NOT_IN operator). Default is taken from the filter param.
+ * @param selectionMode - selection mode of the filter (single / multi). Default is undefined.
+ * @returns converted filter
+ */
+export declare function attributeFilterToDashboardAttributeFilter(filter: IAttributeFilter, localIdentifier: string | undefined, title: string | undefined, attributeElements?: IAttributeElement[], isInverted?: boolean, selectionMode?: DashboardAttributeFilterSelectionMode): DashboardAttributeFilterItem;
+
 /**
  * Gets identifier of attribute's display form to use and get attribute element values from.
  *
@@ -1053,6 +1071,44 @@ export declare type CalendarContext = {
  */
 export declare type CalendarType = "STANDARD" | "FISCAL";
 
+/**
+ * Effective EDIT capability for a single metric.
+ *
+ * @remarks
+ * A workspace admin can always edit, matching how dashboards behave — `getDashboardPermissions`
+ * short-circuits to EDIT when the workspace grants MANAGE, and MANAGE is what canManageProject
+ * is built from. Behind enableMetricPermissions the metric's own EDIT grants it to everyone else.
+ *
+ * Only admins could edit metrics before the flag, so this can only ever grant edit, never take
+ * it away. Drop the flag term when the flag is removed.
+ *
+ * @param metricPermissions - the metric's own permissions, absent when they were not requested
+ * @param workspacePermissions - the user's workspace permissions
+ * @param areMetricPermissionsEnabled - the enableMetricPermissions feature flag
+ *
+ * @alpha
+ */
+export declare function canEditMetric(metricPermissions: AccessGranularPermission[] | undefined, workspacePermissions: IWorkspacePermissions, areMetricPermissionsEnabled: boolean): boolean;
+
+/**
+ * Effective SHARE capability for a single metric.
+ *
+ * @remarks
+ * Same shape as {@link canEditMetric}: a workspace admin can always share, otherwise the metric's
+ * own SHARE decides. Deliberately not derived from EDIT — the permissions are read independently
+ * rather than as an EDIT ⊃ SHARE ⊃ VIEW hierarchy.
+ *
+ * Unlike editing, sharing a metric did not exist before enableMetricPermissions, so it stays off
+ * entirely without the flag.
+ *
+ * @param metricPermissions - the metric's own permissions, absent when they were not requested
+ * @param workspacePermissions - the user's workspace permissions
+ * @param areMetricPermissionsEnabled - the enableMetricPermissions feature flag
+ *
+ * @alpha
+ */
+export declare function canShareMetric(metricPermissions: AccessGranularPermission[] | undefined, workspacePermissions: IWorkspacePermissions, areMetricPermissionsEnabled: boolean): boolean;
+
 /**
  * Type representing catalog item - attribute, measure, fact, dateDataset or computedAttribute
  *
@@ -1385,6 +1441,18 @@ export declare function dashboardAttributeFilterItemLocalIdentifier(filter: Dash
  */
 export declare function dashboardAttributeFilterItemTitle(filter: DashboardAttributeFilterItem): string | undefined;
 
+/**
+ * Converts any {@link DashboardAttributeFilterItem} to {@link IAttributeFilter} instance.
+ *
+ * @remarks
+ * Handles all attribute filter types: element-based (positive/negative selection),
+ * arbitrary value filters, and match (text) filters.
+ *
+ * @param filter - dashboard attribute filter item to convert
+ * @alpha
+ */
+export declare function dashboardAttributeFilterItemToAttributeFilter(filter: DashboardAttributeFilterItem): IAttributeFilter;
+
 /**
  * Returns the validateElementsBy of any attribute-based dashboard filter.
  *
@@ -1415,6 +1483,16 @@ export declare type DashboardAttributeFilterSelectionType = "list" | "text" | "l
  */
 export declare const DashboardAttributeFilterSelectionTypeValues: Record<Uppercase<Exclude<DashboardAttributeFilterSelectionType, "listOrText">> | "LIST_OR_TEXT", DashboardAttributeFilterSelectionType>;
 
+/**
+ * Converts {@link IDashboardAttributeFilter} to {@link IAttributeFilter} instance.
+ *
+ * @param filter - filter context attribute filter to convert
+ * @deprecated Use {@link dashboardAttributeFilterItemToAttributeFilter} instead,
+ * which supports all attribute filter types including text filters.
+ * @public
+ */
+export declare function dashboardAttributeFilterToAttributeFilter(filter: IDashboardAttributeFilter): IAttributeFilter;
+
 /**
  * Date filter configuration mode
  * @alpha
@@ -1428,6 +1506,24 @@ export declare type DashboardDateFilterConfigMode = "readonly" | "hidden" | "act
  */
 export declare const DashboardDateFilterConfigModeValues: Record<Uppercase<DashboardDateFilterConfigMode>, DashboardDateFilterConfigMode>;
 
+/**
+ * Converts {@link IDashboardDateFilter} to {@link IDateFilter} instance.
+ *
+ * @param filter - filter context attribute filter to convert
+ * @param dateDataSet - date data set to define {@link IDateFilter}
+ * @public
+ */
+export declare function dashboardDateFilterToDateFilterByDateDataSet(filter: IDashboardDateFilter, dateDataSet: ObjRef): IDateFilter;
+
+/**
+ * Converts {@link IDashboardDateFilter} to {@link IDateFilter} instance.
+ *
+ * @param filter - filter context attribute filter to convert
+ * @param widget - widget to use to get dateDataSet for date filters
+ * @public
+ */
+export declare function dashboardDateFilterToDateFilterByWidget(filter: IDashboardDateFilter, widget?: Partial<IFilterableWidget>): IDateFilter;
+
 /**
  * Returns local identifier of the dashboard filter.
  *
@@ -1475,6 +1571,20 @@ export declare type DashboardFiltersApplyMode = {
  */
 export declare function dashboardMeasureValueFilterLocalIdentifier(filter: IDashboardMeasureValueFilter): string;
 
+/**
+ * Converts {@link IDashboardMeasureValueFilter} to {@link IMeasureValueFilter} instance.
+ *
+ * @remarks
+ * Dashboard measure value filters always reference a catalog metric via `ObjRef`, which is a valid
+ * `ObjRefInScope`. When dashboard-level dimensionality is configured, it is passed through to the
+ * execution filter; otherwise the backend derives granularity from the widget automatically.
+ * Conditions are passed through unchanged.
+ *
+ * @param filter - dashboard measure value filter to convert
+ * @alpha
+ */
+export declare function dashboardMeasureValueFilterToMeasureValueFilter(filter: IDashboardMeasureValueFilter): IMeasureValueFilter;
+
 /**
  * Dashboard parameter mode — mirrors filter mode triple.
  *
@@ -2212,6 +2322,52 @@ export declare function filterAttributeElements(filter: IFilter): IAttributeElem
  */
 export declare type FilterContextItem = DashboardAttributeFilterItem | IDashboardDateFilter | IDashboardMeasureValueFilter;
 
+/**
+ * Gets {@link IDashboardFilter} items for filters specified as {@link FilterContextItem} instances.
+ *
+ * @param filterContextItems - filter context items to get filters for
+ * @param dateDataSet - date data set to define {@link IDateFilter}
+ * @alpha
+ */
+export declare function filterContextItemsToDashboardFiltersByDateDataSet(filterContextItems: FilterContextItem[], dateDataSet: ObjRef): IDashboardFilter[];
+
+/**
+ * Gets {@link IDashboardFilter} items for filters specified as {@link FilterContextItem} instances.
+ *
+ * @param filterContextItems - filter context items to get filters for
+ * @param widget - widget to use to get dateDataSet for date filters
+ * @alpha
+ */
+export declare function filterContextItemsToDashboardFiltersByRichTextWidget(filterContextItems: FilterContextItem[], widget?: Partial<IFilterableWidget>): IDashboardFilter[];
+
+/**
+ * Gets {@link IDashboardFilter} items for filters specified as {@link FilterContextItem} instances.
+ *
+ * @param filterContextItems - filter context items to get filters for
+ * @param widget - widget to use to get dateDataSet for date filters
+ * @alpha
+ */
+export declare function filterContextItemsToDashboardFiltersByWidget(filterContextItems: FilterContextItem[], widget?: Partial<IFilterableWidget>): IDashboardFilter[];
+
+/**
+ * Gets {@link IDashboardFilter} items for filters specified in given filterContext in relation to the
+ * given dateDataSet.
+ *
+ * @param filterContext - filter context to get filters for
+ * @param dateDataSet - widget to use to get dateDataSet for date filters
+ * @alpha
+ */
+export declare function filterContextToDashboardFiltersByDateDataSet(filterContext: IFilterContextDefinition | IFilterContext | ITempFilterContext | undefined, dateDataSet: ObjRef): IDashboardFilter[];
+
+/**
+ * Gets {@link IDashboardFilter} items for filters specified in given filterContext in relation to the given widget.
+ *
+ * @param filterContext - filter context to get filters for
+ * @param widget - widget to use to get dateDataSet for date filters
+ * @alpha
+ */
+export declare function filterContextToDashboardFiltersByWidget(filterContext: IFilterContextDefinition | IFilterContext | ITempFilterContext | undefined, widget: IWidgetDefinition): IDashboardFilter[];
+
 /**
  * Tests whether the provided attribute element does not specify any attribute elements.
  *
@@ -4789,12 +4945,13 @@ export declare interface IConditionalFormatting {
     enabled: boolean;
     rules: readonly IConditionalFormattingRule[];
     /**
-     * Targets for which these insight-level rules take over entirely from any semantic-layer
-     * conditional formatting carried on the execution result (see {@link ISemanticConditionalFormatting}).
-     * A target listed here is Custom: its semantic rules are ignored, never merged. A target not
-     * listed here (or when this is absent) is Inherited: semantic rules apply as-is.
+     * Targets whose formatting is explicitly suppressed — turned off rather than inherited from any
+     * semantic-layer conditional formatting carried on the execution result (see
+     * {@link ISemanticConditionalFormatting}). A target listed here shows no formatting even if the
+     * semantic layer has rules for it. A target not listed here (or when this is absent) is
+     * Inherited: semantic rules apply as-is.
      */
-    customTargets?: readonly ConditionalFormattingTarget[];
+    suppressedTargets?: readonly ConditionalFormattingTarget[];
 }
 
 /**
@@ -5480,6 +5637,14 @@ export declare interface IDashboardExportParameter {
     parameterType?: ParameterType;
 }
 
+/**
+ * Execution-filter form of a dashboard filter: what a {@link FilterContextItem} becomes once it is
+ * resolved against the object it filters.
+ *
+ * @public
+ */
+export declare type IDashboardFilter = IAbsoluteDateFilter | IRelativeDateFilter | IPositiveAttributeFilter | INegativeAttributeFilter | IArbitraryAttributeFilter | IMatchAttributeFilter | IMeasureValueFilter;
+
 /**
  * Single dashboard filter group configuration.
  * Title is displayed in the filter bar.
@@ -7658,6 +7823,13 @@ export declare interface IFeatureFlags {
      * Enable conditional formatting for the pivot table
      */
     enableConditionalFormatting?: boolean;
+    /**
+     * Enable inheriting conditional formatting rules authored on a semantic-layer catalog object
+     * (label, metric, fact, or date dataset) — independent of
+     * {@link IFeatureFlags.enableConditionalFormatting}, which only gates an insight's own authored
+     * rules.
+     */
+    enableSemanticConditionalFormatting?: boolean;
     /**
      * Enable new geo pushpin chart
      */
@@ -11326,6 +11498,11 @@ export declare interface IPermanentSettings {
      * @beta
      */
     defaultExportTemplate?: IDefaultExportTemplate;
+    /**
+     * Brand kit offered to report authors: brand colors, typography and shared assets.
+     * @alpha
+     */
+    reportsBrandKit?: IReportsBrandKit;
     /**
      * Indicates current platform edition.
      */
@@ -12062,6 +12239,19 @@ export declare interface IReportBase {
  */
 export declare interface IReportBoxStyle {
     background?: ReportBackground;
+    /**
+     * Corner radius in percent of the page width — the same relative unit the rest of a report page
+     * is sized in, so the corners keep their proportion however large the page is rendered.
+     * Content reaching into a rounded corner is clipped.
+     */
+    borderRadius?: number;
+    /**
+     * Inset of the box's own content, in percent of the page width like
+     * {@link IReportBoxStyle.borderRadius}. Insets only inward — siblings and the layout
+     * gaps around the box are untouched. A box that paints a background usually wants one;
+     * a full-bleed box (an image-backed cover) wants none, which is why no default exists.
+     */
+    padding?: number;
 }
 
 /**
@@ -12167,7 +12357,7 @@ export declare interface IReportImageSlot extends IReportSlotBase {
     /**
      * How the image fills the slot area. Defaults to "contain".
      */
-    fit?: "contain" | "cover" | "fill";
+    fit?: ReportImageFit;
     /**
      * Placement overrides for the drawn image; centered on both axes by default.
      */
@@ -12331,6 +12521,158 @@ export declare interface IReportPageLayoutDefinition {
     content: IReportPageLayoutContent;
 }
 
+/**
+ * Workspace brand kit: the customer's colors, assets, and typography reports are branded with.
+ *
+ * @remarks
+ * Stored as the free-form content of the `reportsBrandKit` workspace setting. Everything is
+ * optional; each part degrades independently to the product defaults. Assets resolve report
+ * variables, chart colors derive the visualization palette, typography applies to rendered
+ * reports.
+ *
+ * @alpha
+ */
+export declare interface IReportsBrandKit {
+    /**
+     * Content model version, for stored-content evolution.
+     */
+    version: "1";
+    colors?: IReportsBrandKitColors;
+    typography?: IReportsBrandKitTypography;
+    assets?: IReportsBrandKitAssets;
+}
+
+/**
+ * Brand assets, all hosted outside the platform.
+ *
+ * @alpha
+ */
+export declare interface IReportsBrandKitAssets {
+    /**
+     * Primary logo URL; resolves the `{{logo}}` report variable, taking precedence over
+     * the workspace white-labeling logo.
+     */
+    logo?: string;
+    /**
+     * Logo variant for dark backgrounds; resolves the `{{logoInverse}}` report variable.
+     */
+    logoInverse?: string;
+    /**
+     * Additional brand images, each resolving its `{{image_<id>}}` report variable.
+     */
+    images?: IReportsBrandKitImage[];
+}
+
+/**
+ * Brand colors.
+ *
+ * @remarks
+ * Every color but {@link IReportsBrandKitColors.chart} is written into CSS, so it may be stated in
+ * any notation CSS reads. Chart colors become palette entries instead of declarations, so they are
+ * held to {@link parseReportsBrandChartColor} and a value it cannot read is dropped.
+ *
+ * @alpha
+ */
+export declare interface IReportsBrandKitColors {
+    /**
+     * Primary brand color, offered to authors as a swatch.
+     *
+     * @remarks
+     * Also seeds the derived chart palette when {@link IReportsBrandKitColors.chart} is not
+     * provided — but only when stated in a notation {@link parseReportsBrandChartColor} reads,
+     * since seeding means computing tints of it rather than declaring it. Stated in any other
+     * notation it remains a swatch, and charts keep the workspace palette.
+     */
+    brand?: string;
+    /**
+     * Ordered chart series colors the visualization palette is derived from. Each must be a color
+     * {@link parseReportsBrandChartColor} reads; the sanitizer drops the rest.
+     */
+    chart?: string[];
+    /**
+     * Ink of headings and titles.
+     */
+    ink?: string;
+    /**
+     * Ink of body and secondary text.
+     */
+    inkMuted?: string;
+    /**
+     * Default page background.
+     */
+    paper?: string;
+    /**
+     * Alternate background for covers and highlighted sections.
+     */
+    paperAlt?: string;
+}
+
+/**
+ * One hosted font file, loaded as a font face for rendered reports.
+ *
+ * @alpha
+ */
+export declare interface IReportsBrandKitFontFace {
+    /**
+     * Font family name the face registers; reference it from
+     * {@link IReportsBrandKitTypography.fontFamily}.
+     */
+    family: string;
+    /**
+     * Absolute URL of the externally hosted font file (TTF/OTF/WOFF/WOFF2). The organization
+     * CSP must allow the host as a font source, and for exports the host must also serve
+     * CORS headers.
+     */
+    url: string;
+    /**
+     * CSS font-weight the face carries (1-1000). Defaults to 400.
+     */
+    weight?: number;
+    /**
+     * Defaults to "normal".
+     */
+    style?: "normal" | "italic";
+}
+
+/**
+ * Named brand image offered to report authors.
+ *
+ * @alpha
+ */
+export declare interface IReportsBrandKitImage {
+    /**
+     * Identifier the image is referenced by from report content, as the
+     * `{{image_<id>}}` variable. Must match /^[a-zA-Z0-9_]+$/.
+     */
+    id: string;
+    /**
+     * Absolute URL of the externally hosted image. The organization CSP must allow the
+     * host, and for exports the host must also serve CORS headers.
+     */
+    url: string;
+    /**
+     * Human readable description shown when the image is offered in the editor.
+     */
+    description?: string;
+}
+
+/**
+ * Brand typography.
+ *
+ * @alpha
+ */
+export declare interface IReportsBrandKitTypography {
+    /**
+     * CSS font-family stack applied to rendered reports.
+     */
+    fontFamily?: string;
+    /**
+     * Hosted font files backing the families named in
+     * {@link IReportsBrandKitTypography.fontFamily}.
+     */
+    fonts?: IReportsBrandKitFontFace[];
+}
+
 /**
  * Structural base of every report slot.
  *
@@ -12434,7 +12776,7 @@ export declare interface IReportTextSlot extends IReportSlotBase {
 }
 
 /**
- * Styling of the text a text slot owns.
+ * Styling of a text slot: the paint of its box, plus the ink and placement of the text it owns.
  *
  * @remarks
  * Overrides the ink and placement of the slot's {@link ReportTextSlotKind} defaults; the kind
@@ -12442,7 +12784,7 @@ export declare interface IReportTextSlot extends IReportSlotBase {
  *
  * @alpha
  */
-export declare interface IReportTextStyle {
+export declare interface IReportTextStyle extends IReportBoxStyle {
     /**
      * CSS color value. Absolute, like {@link IReportColorBackground.color}.
      */
@@ -13373,6 +13715,13 @@ export declare function isDashboardDateFilterWithDimension(obj: unknown): obj is
  */
 export declare function isDashboardDefinition(obj: unknown): obj is IDashboardDefinition;
 
+/**
+ * Type-guard testing whether the provided object is an instance of {@link IDashboardFilter}.
+ *
+ * @public
+ */
+export declare function isDashboardFilter(obj: unknown): obj is IDashboardFilter;
+
 /**
  * Type-guard testing whether the provided object is an instance of {@link IDashboardLayout}.
  * @alpha
@@ -18551,6 +18900,20 @@ export declare type ParameterValue = IParameterDefinition["defaultValue"];
  */
 export declare function parameterValueMatchesType(definition: IParameterDefinition, value: ParameterValue): boolean;
 
+/**
+ * Reads one of {@link IReportsBrandKitColors.chart} as rgb channels, or undefined where the value is
+ * not one of the notations those colors are stated in.
+ *
+ * @remarks
+ * Chart colors become palette entries rather than CSS declarations, so unlike the rest of the kit
+ * they are held to what this reads: hex (3, 4, 6 or 8 digits) and `rgb()`/`rgba()`. The sanitizer
+ * drops what this cannot read, so a stored kit never carries a chart color the palette would
+ * silently ignore.
+ *
+ * @alpha
+ */
+export declare function parseReportsBrandChartColor(color: string): IRgbColorValue | undefined;
+
 /**
  * Provenance of a granted permission — granted directly to the grantee,
  * or inherited from a group or rule.
@@ -18796,7 +19159,7 @@ export declare type ReportBackground = IReportColorBackground | IReportImageBack
  *
  * @alpha
  */
-export declare type ReportBuiltInVariable = "reportTitle" | "periodStart" | "periodEnd" | "workspaceName" | "generatedAt" | "pageNumber" | "totalPages" | "logo";
+export declare type ReportBuiltInVariable = "reportTitle" | "periodStart" | "periodEnd" | "workspaceName" | "generatedAt" | "pageNumber" | "totalPages" | "logo" | "logoInverse";
 
 /**
  * All built-in report variable names.
@@ -18826,6 +19189,14 @@ export declare function reportContentPage(reportOrTemplate: IReport | IReportDef
  */
 export declare type ReportDateString = string;
 
+/**
+ * How an image is fitted to the area it is drawn in: kept whole inside it, filling it and cropped to
+ * do so, or stretched to its shape.
+ *
+ * @alpha
+ */
+export declare type ReportImageFit = "contain" | "cover" | "fill";
+
 /**
  * What an image slot displays.
  *
@@ -18881,6 +19252,21 @@ export declare const ReportPageFormats: ReportPageFormat[];
  */
 export declare type ReportPageLayoutNode = IReportLayoutSection | IReportLayoutSlotRef;
 
+/**
+ * Name of the report variable resolving the brand kit image with the given id.
+ *
+ * @alpha
+ */
+export declare function reportsBrandKitImageVariable(imageId: string): string;
+
+/**
+ * Prefix of the report variables brand kit images resolve; custom report variables must not
+ * use it.
+ *
+ * @alpha
+ */
+export declare const ReportsBrandKitImageVariablePrefix = "image_";
+
 /**
  * All slot types of report content version 1.
  *
@@ -19005,6 +19391,20 @@ export declare function sanitizeBucketTotals(bucket: IBucket, sortItems: ISortIt
  */
 export declare function sanitizeParameterValue(definition: IParameterDefinition, value: ParameterValue): ParameterValue;
 
+/**
+ * Reads a stored brand kit from free-form JSON, keeping the parts that are valid and dropping
+ * everything else.
+ *
+ * @remarks
+ * The setting content is not schema-validated by the backend, so every consumer must go
+ * through this. Returns undefined only when the value is not a version "1" brand kit at all;
+ * a kit whose sections are absent or entirely invalid comes back empty, which the type permits
+ * and a workspace that has not filled its kit in yet carries.
+ *
+ * @alpha
+ */
+export declare function sanitizeReportsBrandKit(value: unknown): IReportsBrandKit | undefined;
+
 /**
  * Supported email attachments
  * @alpha
@@ -19309,9 +19709,10 @@ export declare function userFullName(user: IUser): string | undefined;
 /**
  * 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.
+ * weights are positive, corner radii and paddings are finite and not negative, every slot is placed (by the
+ * layout, or as the image background of a box that renders), every layout slotId resolves
+ * (unresolved ones are warnings — they render as empty areas), and background references
+ * resolve to image slots.
  *
  * @alpha
  */

package/esm/settings/settings.d.ts

@@ -1,4 +1,5 @@
 import type { IDateFilterConfig } from "../dateFilterConfig/index.js";
+import type { IReportsBrandKit } from "../reports/brandKit.js";
 /**
  * Describes metric format override configuration.
  *
@@ -312,6 +313,11 @@ export interface IPermanentSettings {
      * @beta
      */
     defaultExportTemplate?: IDefaultExportTemplate;
+    /**
+     * Brand kit offered to report authors: brand colors, typography and shared assets.
+     * @alpha
+     */
+    reportsBrandKit?: IReportsBrandKit;
     /**
      * Indicates current platform edition.
      */
@@ -684,6 +690,13 @@ export interface IFeatureFlags {
      * Enable conditional formatting for the pivot table
      */
     enableConditionalFormatting?: boolean;
+    /**
+     * Enable inheriting conditional formatting rules authored on a semantic-layer catalog object
+     * (label, metric, fact, or date dataset) — independent of
+     * {@link IFeatureFlags.enableConditionalFormatting}, which only gates an insight's own authored
+     * rules.
+     */
+    enableSemanticConditionalFormatting?: boolean;
     /**
      * Enable new geo pushpin chart
      */