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

package/esm/permissions/metric.d.ts

@@ -0,0 +1,39 @@
+import { type AccessGranularPermission } from "../accessControl/index.js";
+import { type IWorkspacePermissions } from "./index.js";
+/**
+ * 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;
+//# sourceMappingURL=metric.d.ts.map

package/esm/permissions/metric.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metric.d.ts","sourceRoot":"","sources":["../../src/permissions/metric.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAE1E,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CACzB,iBAAiB,EAAE,wBAAwB,EAAE,GAAG,SAAS,EACzD,oBAAoB,EAAE,qBAAqB,EAC3C,2BAA2B,EAAE,OAAO,GACrC,OAAO,CAKT;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAC1B,iBAAiB,EAAE,wBAAwB,EAAE,GAAG,SAAS,EACzD,oBAAoB,EAAE,qBAAqB,EAC3C,2BAA2B,EAAE,OAAO,GACrC,OAAO,CAKT"}

package/esm/permissions/metric.js

@@ -0,0 +1,45 @@
+// (C) 2026 GoodData Corporation
+/**
+ * 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 function canEditMetric(metricPermissions, workspacePermissions, areMetricPermissionsEnabled) {
+    return (workspacePermissions.canManageProject ||
+        (areMetricPermissionsEnabled && (metricPermissions?.includes("EDIT") ?? false)));
+}
+/**
+ * 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 function canShareMetric(metricPermissions, workspacePermissions, areMetricPermissionsEnabled) {
+    if (!areMetricPermissionsEnabled) {
+        return false;
+    }
+    return workspacePermissions.canManageProject || (metricPermissions?.includes("SHARE") ?? false);
+}

package/esm/reports/brandKit.d.ts

@@ -0,0 +1,187 @@
+import { type IRgbColorValue } from "../colors/index.js";
+/**
+ * Named brand image offered to report authors.
+ *
+ * @alpha
+ */
+export 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 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 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 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";
+}
+/**
+ * Brand typography.
+ *
+ * @alpha
+ */
+export 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[];
+}
+/**
+ * Brand assets, all hosted outside the platform.
+ *
+ * @alpha
+ */
+export 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[];
+}
+/**
+ * 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 interface IReportsBrandKit {
+    /**
+     * Content model version, for stored-content evolution.
+     */
+    version: "1";
+    colors?: IReportsBrandKitColors;
+    typography?: IReportsBrandKitTypography;
+    assets?: IReportsBrandKitAssets;
+}
+/**
+ * Prefix of the report variables brand kit images resolve; custom report variables must not
+ * use it.
+ *
+ * @alpha
+ */
+export declare const ReportsBrandKitImageVariablePrefix = "image_";
+/**
+ * Name of the report variable resolving the brand kit image with the given id.
+ *
+ * @alpha
+ */
+export declare function reportsBrandKitImageVariable(imageId: string): string;
+/**
+ * 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;
+/**
+ * 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;
+//# sourceMappingURL=brandKit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"brandKit.d.ts","sourceRoot":"","sources":["../../src/reports/brandKit.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IAClC;;;OAGG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,sBAAsB;IACnC;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAEjB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACrC;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,KAAK,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACvC;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,KAAK,CAAC,EAAE,wBAAwB,EAAE,CAAC;CACtC;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACnC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,MAAM,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACpC;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,gBAAgB;IAC7B;;OAEG;IACH,OAAO,EAAE,GAAG,CAAC;IAEb,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAEhC,UAAU,CAAC,EAAE,0BAA0B,CAAC;IAExC,MAAM,CAAC,EAAE,sBAAsB,CAAC;CACnC;AAED;;;;;GAKG;AACH,eAAO,MAAM,kCAAkC,WAAW,CAAC;AAE3D;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpE;AAgCD;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAsBrF;AA6HD;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS,CAWpF"}

package/esm/reports/brandKit.js

@@ -0,0 +1,208 @@
+// (C) 2026 GoodData Corporation
+/**
+ * Prefix of the report variables brand kit images resolve; custom report variables must not
+ * use it.
+ *
+ * @alpha
+ */
+export const ReportsBrandKitImageVariablePrefix = "image_";
+/**
+ * Name of the report variable resolving the brand kit image with the given id.
+ *
+ * @alpha
+ */
+export function reportsBrandKitImageVariable(imageId) {
+    return `${ReportsBrandKitImageVariablePrefix}${imageId}`;
+}
+const imageIdPattern = /^[a-zA-Z0-9_]+$/;
+const HEX_COLOR = /^#(?<digits>[0-9a-f]{3,8})$/i;
+// Either the comma form or the space form, not a mixture of the two, and an alpha that is an
+// actual number: `rgb(1, 2 3)` and `rgba(1,2,3,.)` are no more colors than a word would be.
+const RGB_NUMBER = String.raw `\d{1,3}`;
+const RGB_ALPHA = String.raw `(?:\d+(?:\.\d+)?|\.\d+)%?`;
+const RGB_COLOR = new RegExp(String.raw `^rgba?\(\s*(?:` +
+    String.raw `(?<r>${RGB_NUMBER})\s*,\s*(?<g>${RGB_NUMBER})\s*,\s*(?<b>${RGB_NUMBER})(?:\s*,\s*${RGB_ALPHA})?` +
+    String.raw `|` +
+    String.raw `(?<rs>${RGB_NUMBER})\s+(?<gs>${RGB_NUMBER})\s+(?<bs>${RGB_NUMBER})(?:\s*/\s*${RGB_ALPHA})?` +
+    String.raw `)\s*\)$`, "i");
+// Alpha is dropped from a 4- or 8-digit hex and from rgba(): a palette fill is opaque rgb.
+function fromHexDigits(digits) {
+    const short = digits.length === 3 || digits.length === 4;
+    if (!short && digits.length !== 6 && digits.length !== 8) {
+        return undefined;
+    }
+    const width = short ? 1 : 2;
+    const channel = (index) => {
+        const part = digits.slice(index * width, index * width + width);
+        return Number.parseInt(short ? part + part : part, 16);
+    };
+    return { r: channel(0), g: channel(1), b: channel(2) };
+}
+/**
+ * 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 function parseReportsBrandChartColor(color) {
+    const trimmed = color.trim();
+    const hex = HEX_COLOR.exec(trimmed);
+    if (hex?.groups) {
+        return fromHexDigits(hex.groups["digits"]);
+    }
+    const rgb = RGB_COLOR.exec(trimmed);
+    if (rgb?.groups) {
+        // One of the two forms matched, so each channel sits in exactly one of the two group sets.
+        const channels = [
+            ["r", "rs"],
+            ["g", "gs"],
+            ["b", "bs"],
+        ].map(([comma, space]) => Number(rgb.groups[comma] ?? rgb.groups[space]));
+        return channels.every((value) => value <= 255)
+            ? { r: channels[0], g: channels[1], b: channels[2] }
+            : undefined;
+    }
+    return undefined;
+}
+// Brand assets are fetched over the network and drawn into reports; a url of any other scheme
+// (javascript:, data:, a relative path) does not describe an externally hosted asset and is dropped
+// rather than reaching an element's src or a @font-face rule.
+function sanitizedAssetUrl(value) {
+    const url = sanitizedString(value);
+    if (url === undefined) {
+        return undefined;
+    }
+    try {
+        const { protocol } = new URL(url);
+        return protocol === "https:" || protocol === "http:" ? url : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function sanitizedString(value) {
+    return typeof value === "string" && value.trim() !== "" ? value : undefined;
+}
+function withDefined(parts) {
+    const defined = Object.fromEntries(Object.entries(parts).filter(([, value]) => value !== undefined));
+    return Object.keys(defined).length > 0 ? defined : undefined;
+}
+function sanitizedColors(value) {
+    if (typeof value !== "object" || value === null) {
+        return undefined;
+    }
+    const colors = value;
+    const chart = Array.isArray(colors.chart)
+        ? colors.chart
+            .map(sanitizedString)
+            .filter((color) => color !== undefined && parseReportsBrandChartColor(color) !== undefined)
+        : undefined;
+    return withDefined({
+        brand: sanitizedString(colors.brand),
+        chart: chart !== undefined && chart.length > 0 ? chart : undefined,
+        ink: sanitizedString(colors.ink),
+        inkMuted: sanitizedString(colors.inkMuted),
+        paper: sanitizedString(colors.paper),
+        paperAlt: sanitizedString(colors.paperAlt),
+    });
+}
+function sanitizedFontFace(value) {
+    if (typeof value !== "object" || value === null) {
+        return undefined;
+    }
+    const { family, url, weight, style } = value;
+    const sanitizedFamily = sanitizedString(family);
+    const sanitizedUrl = sanitizedAssetUrl(url);
+    if (sanitizedFamily === undefined || sanitizedUrl === undefined) {
+        return undefined;
+    }
+    return withDefined({
+        family: sanitizedFamily,
+        url: sanitizedUrl,
+        weight: typeof weight === "number" && weight >= 1 && weight <= 1000 ? weight : undefined,
+        style: style === "normal" || style === "italic" ? style : undefined,
+    });
+}
+function sanitizedFonts(value) {
+    if (!Array.isArray(value)) {
+        return undefined;
+    }
+    const fonts = value
+        .map(sanitizedFontFace)
+        .filter((font) => font !== undefined);
+    return fonts.length > 0 ? fonts : undefined;
+}
+function sanitizedTypography(value) {
+    if (typeof value !== "object" || value === null) {
+        return undefined;
+    }
+    const typography = value;
+    return withDefined({
+        fontFamily: sanitizedString(typography.fontFamily),
+        fonts: sanitizedFonts(typography.fonts),
+    });
+}
+function sanitizedImages(value) {
+    if (!Array.isArray(value)) {
+        return undefined;
+    }
+    const seen = new Set();
+    const images = [];
+    for (const entry of value) {
+        if (typeof entry !== "object" || entry === null) {
+            continue;
+        }
+        const { id, url, description } = entry;
+        if (typeof id !== "string" || !imageIdPattern.test(id) || seen.has(id)) {
+            continue;
+        }
+        const sanitizedUrl = sanitizedAssetUrl(url);
+        if (sanitizedUrl === undefined) {
+            continue;
+        }
+        seen.add(id);
+        images.push(withDefined({ id, url: sanitizedUrl, description: sanitizedString(description) }));
+    }
+    return images.length > 0 ? images : undefined;
+}
+function sanitizedAssets(value) {
+    if (typeof value !== "object" || value === null) {
+        return undefined;
+    }
+    const assets = value;
+    return withDefined({
+        logo: sanitizedAssetUrl(assets.logo),
+        logoInverse: sanitizedAssetUrl(assets.logoInverse),
+        images: sanitizedImages(assets.images),
+    });
+}
+/**
+ * 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 function sanitizeReportsBrandKit(value) {
+    if (typeof value !== "object" || value?.version !== "1") {
+        return undefined;
+    }
+    const kit = value;
+    const parts = withDefined({
+        colors: sanitizedColors(kit.colors),
+        typography: sanitizedTypography(kit.typography),
+        assets: sanitizedAssets(kit.assets),
+    });
+    return { version: "1", ...parts };
+}

package/esm/reports/pageLayout.d.ts

@@ -122,7 +122,7 @@ export interface IReportPageBodyValidationIssue {
 /**
  * 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, corner radii are finite and not negative, every slot is placed (by the
+ * 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.

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,gBAAgB,EAAsB,MAAM,iBAAiB,CAAC;AAC5E,OAAO,EAAE,KAAK,UAAU,EAAuC,MAAM,WAAW,CAAC;AACjF,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;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,eAAe,GAAG,8BAA8B,EAAE,CA8F9F"}
+{"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,EAAuC,MAAM,WAAW,CAAC;AACjF,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;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,eAAe,GAAG,8BAA8B,EAAE,CA+F9F"}

package/esm/reports/pageLayout.js

@@ -35,7 +35,7 @@ export function isReportPageLayoutContentV1(obj) {
 /**
  * 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, corner radii are finite and not negative, every slot is placed (by the
+ * 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.
@@ -47,11 +47,11 @@ export function validateReportPageBody(body) {
     if (body.format !== undefined && !isReportPageFormat(body.format)) {
         issues.push({ severity: "error", message: `Unknown page format "${body.format}".` });
     }
-    const checkBorderRadius = (borderRadius) => {
-        if (borderRadius !== undefined && !(Number.isFinite(borderRadius) && borderRadius >= 0)) {
+    const checkLength = (name, value) => {
+        if (value !== undefined && !(Number.isFinite(value) && value >= 0)) {
             issues.push({
                 severity: "error",
-                message: `Border radius must be a finite non-negative number, got ${borderRadius}.`,
+                message: `${name} must be a finite non-negative number, got ${value}.`,
             });
         }
     };
@@ -68,7 +68,8 @@ export function validateReportPageBody(body) {
     const slotsById = new Map(body.slots.map((slot) => [slot.localIdentifier, slot]));
     const backgroundIds = new Set();
     const checkBoxStyle = (style, isDrawn) => {
-        checkBorderRadius(style?.borderRadius);
+        checkLength("Border radius", style?.borderRadius);
+        checkLength("Padding", style?.padding);
         if (!style?.background || !isReportImageBackground(style.background)) {
             return;
         }

package/esm/reports/styling.d.ts

@@ -51,6 +51,13 @@ export interface IReportBoxStyle {
      * 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;
 }
 /**
  * Styling of a text slot: the paint of its box, plus the ink and placement of the text it owns.

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;IAE9B;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;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"}
+{"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;
 /**