@gooddata/sdk-ui-vis-commons 11.33.0-alpha.4 → 11.33.0-alpha.7

package/esm/customTooltip/markdownToHtml.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @internal
+ */
+export declare function markdownToHtml(markdown: string): string;
+//# sourceMappingURL=markdownToHtml.d.ts.map

package/esm/customTooltip/markdownToHtml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdownToHtml.d.ts","sourceRoot":"","sources":["../../src/customTooltip/markdownToHtml.ts"],"names":[],"mappings":"AAsHA;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAuBvD"}

package/esm/customTooltip/markdownToHtml.js

@@ -0,0 +1,191 @@
+// (C) 2026 GoodData Corporation
+/**
+ * Lightweight Markdown-to-HTML converter for tooltip rendering.
+ *
+ * Supports the subset of Markdown needed for tooltips:
+ * - Headings (# through ####)
+ * - Bold (**text** or __text__)
+ * - Italic (*text* or _text_)
+ * - Unordered lists (- item or * item)
+ * - Ordered lists (1. item)
+ * - Images (![alt](url))
+ * - Links ([text](url)) — rendered as plain styled text (not clickable in tooltips)
+ * - Horizontal rules (--- or ***)
+ * - Line breaks
+ * - Backslash escapes (\*, \_, \[, \!, etc.) — render the metachar as literal text.
+ *   Used by reference resolution to keep data values that contain markdown
+ *   syntax from being reinterpreted as formatting.
+ *
+ * Does NOT support: tables, code blocks, blockquotes, nested lists, HTML passthrough.
+ * For full Markdown fidelity, a library like `marked` should be used instead.
+ *
+ * IMPORTANT: When changing the supported syntax here, also update the @alpha TSDoc
+ * on `ICustomTooltipConfig.content` in ./types.ts so the SDK documentation matches reality.
+ */
+function escapeHtml(text) {
+    return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+function isSafeUrl(url) {
+    return /^https?:\/\//i.test(url) || /^data:image\//i.test(url);
+}
+// URL pattern allowing one level of balanced parens, e.g.
+// https://en.wikipedia.org/wiki/Page_(name)
+const URL_PATTERN = "(?:[^()\\s]|\\([^)]*\\))+";
+const IMAGE_REGEX = new RegExp(`!\\[([^\\]]*)\\]\\((${URL_PATTERN})\\)`, "g");
+const LINK_REGEX = new RegExp(`\\[([^\\]]+)\\]\\((${URL_PATTERN})\\)`, "g");
+// Italic content must have non-whitespace at both inner boundaries. This keeps
+// arithmetic-style text (e.g. `5 * 3 * 2`) from being misread as italics.
+const ITALIC_ASTERISK_REGEX = /\*([^\s*][^*]*[^\s*]|[^\s*])\*/g;
+const ITALIC_UNDERSCORE_REGEX = /(?<!\w)_([^\s_][^_]*[^\s_]|[^\s_])_(?!\w)/g;
+function processInlineMarkdown(text) {
+    let result = escapeHtml(text);
+    // Inline style as fallback since the tooltip renders outside the normal DOM tree.
+    result = result.replace(IMAGE_REGEX, (_match, alt, url) => {
+        if (!isSafeUrl(url)) {
+            return `${alt}`;
+        }
+        return `<img src="${url}" alt="${alt}" style="max-width: 100%; display: block; margin: 4px 0;" />`;
+    });
+    // Render as styled text — links are intentionally not clickable inside tooltips.
+    result = result.replace(LINK_REGEX, (_match, linkText) => {
+        return `<span class="gd-viz-tooltip-custom-link">${linkText}</span>`;
+    });
+    // Bold-italic: ***text*** — must run before bold and italic so the triple
+    // asterisks are consumed as a unit instead of being split across patterns.
+    result = result.replace(/\*\*\*(.+?)\*\*\*/g, "<strong><em>$1</em></strong>");
+    result = result.replace(/\*\*(.+?)\*\*/g, "<strong>$1</strong>");
+    result = result.replace(/__(.+?)__/g, "<strong>$1</strong>");
+    result = result.replace(ITALIC_ASTERISK_REGEX, "<em>$1</em>");
+    result = result.replace(ITALIC_UNDERSCORE_REGEX, "<em>$1</em>");
+    return result;
+}
+// Backslash-escape protection: replace `\X` with a per-parse sentinel that
+// survives all block- and inline-level matching, then restore it to the literal
+// char at the end. The generated prefix is chosen so it does not already appear
+// in the input, which prevents user-supplied sentinel-shaped text from being
+// restored into raw HTML after escaping.
+const ESCAPABLE_METACHARS = /\\([\\*_`\[\]()!#~+\-])/g;
+const SENTINEL_PREFIX = "\u0001E";
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function createSentinelPrefix(markdown) {
+    let index = 0;
+    let prefix;
+    do {
+        prefix = `${SENTINEL_PREFIX}${index}:`;
+        index += 1;
+    } while (markdown.includes(prefix));
+    return prefix;
+}
+function protectEscapes(markdown) {
+    const sentinelPrefix = createSentinelPrefix(markdown);
+    const escapeSentinelRe = new RegExp(`${escapeRegExp(sentinelPrefix)}([0-9a-f]+);`, "g");
+    return {
+        markdown: markdown.replace(ESCAPABLE_METACHARS, (_, char) => `${sentinelPrefix}${char.charCodeAt(0).toString(16)};`),
+        restore: (html) => 
+        // None of the escapable chars are HTML-special (`<`, `>`, `&`, `"`),
+        // so a raw substitution is safe — no re-escaping needed.
+        html.replace(escapeSentinelRe, (_, code) => String.fromCharCode(parseInt(code, 16))),
+    };
+}
+// LRU cache: tooltip formatter is invoked on every Highcharts mousemove,
+// so the same resolved content is parsed many times per second. Caching
+// turns repeated calls into O(1) lookups.
+const CACHE_LIMIT = 200;
+const cache = new Map();
+/**
+ * @internal
+ */
+export function markdownToHtml(markdown) {
+    if (!markdown) {
+        return "";
+    }
+    const cached = cache.get(markdown);
+    if (cached !== undefined) {
+        // Touch: re-insert so it becomes most-recently-used.
+        cache.delete(markdown);
+        cache.set(markdown, cached);
+        return cached;
+    }
+    const protectedEscapes = protectEscapes(markdown);
+    const html = protectedEscapes.restore(parseMarkdown(protectedEscapes.markdown));
+    cache.set(markdown, html);
+    if (cache.size > CACHE_LIMIT) {
+        const oldest = cache.keys().next().value;
+        if (oldest !== undefined) {
+            cache.delete(oldest);
+        }
+    }
+    return html;
+}
+function parseMarkdown(markdown) {
+    const lines = markdown.split("\n");
+    const htmlParts = [];
+    let inUnorderedList = false;
+    let inOrderedList = false;
+    const closeList = () => {
+        if (inUnorderedList) {
+            htmlParts.push("</ul>");
+            inUnorderedList = false;
+        }
+        if (inOrderedList) {
+            htmlParts.push("</ol>");
+            inOrderedList = false;
+        }
+    };
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed) {
+            closeList();
+            continue;
+        }
+        // Horizontal rule: --- or *** or ___
+        if (/^(-{3,}|\*{3,}|_{3,})$/.test(trimmed)) {
+            closeList();
+            htmlParts.push("<hr/>");
+            continue;
+        }
+        // Headings: # through ####
+        const headingMatch = trimmed.match(/^(#{1,4})\s+(.+)$/);
+        if (headingMatch) {
+            closeList();
+            const level = headingMatch[1].length;
+            const content = processInlineMarkdown(headingMatch[2]);
+            htmlParts.push(`<h${level}>${content}</h${level}>`);
+            continue;
+        }
+        // Unordered list: - item or * item
+        const ulMatch = trimmed.match(/^[-*]\s+(.+)$/);
+        if (ulMatch) {
+            if (inOrderedList) {
+                closeList();
+            }
+            if (!inUnorderedList) {
+                htmlParts.push("<ul>");
+                inUnorderedList = true;
+            }
+            htmlParts.push(`<li>${processInlineMarkdown(ulMatch[1])}</li>`);
+            continue;
+        }
+        // Ordered list: 1. item
+        const olMatch = trimmed.match(/^\d+\.\s+(.+)$/);
+        if (olMatch) {
+            if (inUnorderedList) {
+                closeList();
+            }
+            if (!inOrderedList) {
+                htmlParts.push("<ol>");
+                inOrderedList = true;
+            }
+            htmlParts.push(`<li>${processInlineMarkdown(olMatch[1])}</li>`);
+            continue;
+        }
+        // Regular paragraph
+        closeList();
+        htmlParts.push(`<p>${processInlineMarkdown(trimmed)}</p>`);
+    }
+    closeList();
+    return htmlParts.join("");
+}
+//# sourceMappingURL=markdownToHtml.js.map

package/esm/customTooltip/markdownToHtml.js.map

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

package/esm/customTooltip/measureLdmIdentifier.d.ts

@@ -0,0 +1,12 @@
+import { type IMeasure } from "@gooddata/sdk-model";
+/**
+ * Returns the LDM identifier the measure ultimately resolves to.
+ *
+ * - Simple measures: the identifier of the underlying catalog metric
+ * - Derived measures (PoP, previous period): follows the chain to the master
+ * - Arithmetic measures (and anything without an identifier ref): undefined
+ *
+ * @internal
+ */
+export declare function resolveMeasureLdmIdentifier(measure: IMeasure, allMeasures: IMeasure[]): string | undefined;
+//# sourceMappingURL=measureLdmIdentifier.d.ts.map

package/esm/customTooltip/measureLdmIdentifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"measureLdmIdentifier.d.ts","sourceRoot":"","sources":["../../src/customTooltip/measureLdmIdentifier.ts"],"names":[],"mappings":"AAEA,OAAO,EACH,KAAK,QAAQ,EAMhB,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,MAAM,GAAG,SAAS,CAa1G"}

package/esm/customTooltip/measureLdmIdentifier.js

@@ -0,0 +1,24 @@
+// (C) 2026 GoodData Corporation
+import { isIdentifierRef, isSimpleMeasure, measureItem, measureLocalId, measureMasterIdentifier, } from "@gooddata/sdk-model";
+/**
+ * Returns the LDM identifier the measure ultimately resolves to.
+ *
+ * - Simple measures: the identifier of the underlying catalog metric
+ * - Derived measures (PoP, previous period): follows the chain to the master
+ * - Arithmetic measures (and anything without an identifier ref): undefined
+ *
+ * @internal
+ */
+export function resolveMeasureLdmIdentifier(measure, allMeasures) {
+    if (isSimpleMeasure(measure)) {
+        const ref = measureItem(measure);
+        return ref && isIdentifierRef(ref) ? ref.identifier : undefined;
+    }
+    const masterLocalId = measureMasterIdentifier(measure);
+    if (!masterLocalId) {
+        return undefined;
+    }
+    const masterMeasure = allMeasures.find((m) => measureLocalId(m) === masterLocalId);
+    return masterMeasure ? resolveMeasureLdmIdentifier(masterMeasure, allMeasures) : undefined;
+}
+//# sourceMappingURL=measureLdmIdentifier.js.map

package/esm/customTooltip/measureLdmIdentifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"measureLdmIdentifier.js","sourceRoot":"","sources":["../../src/customTooltip/measureLdmIdentifier.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAEhC,OAAO,EAEH,eAAe,EACf,eAAe,EACf,WAAW,EACX,cAAc,EACd,uBAAuB,GAC1B,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;GAQG;AACH,MAAM,UAAU,2BAA2B,CAAC,OAAiB,EAAE,WAAuB,EAAsB;IACxG,IAAI,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;QACjC,OAAO,GAAG,IAAI,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;IACpE,CAAC;IAED,MAAM,aAAa,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACvD,IAAI,CAAC,aAAa,EAAE,CAAC;QACjB,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,MAAM,aAAa,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,KAAK,aAAa,CAAC,CAAC;IACnF,OAAO,aAAa,CAAC,CAAC,CAAC,2BAA2B,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAAA,CAC9F"}

package/esm/customTooltip/referenceResolver.d.ts

@@ -0,0 +1,20 @@
+import { type IResolvedReferenceValues } from "./types.js";
+/**
+ * Substitutes `{metric/id}` and `{label/id}` references in markdown content
+ * with resolved values from the lookup table.
+ *
+ * Substituted values come from data and may contain markdown metacharacters
+ * (e.g., `*`, `_`, `[`). They are backslash-escaped so the downstream
+ * markdown-to-HTML conversion renders them as literal text rather than as
+ * unintended formatting. `markdownToHtml` understands the backslash escapes.
+ *
+ * @param content - Markdown content with reference placeholders
+ * @param values - Lookup of `metric/id` and `label/id` keys to formatted values.
+ *   Keys must use a lowercase prefix; LDM identifiers are case-sensitive.
+ * @param fallbackText - Localized text shown when a reference is recognized
+ *   but no value is available (unknown identifier, point with no value, etc.).
+ *
+ * @internal
+ */
+export declare function resolveReferences(content: string, values: IResolvedReferenceValues, fallbackText: string): string;
+//# sourceMappingURL=referenceResolver.d.ts.map

package/esm/customTooltip/referenceResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"referenceResolver.d.ts","sourceRoot":"","sources":["../../src/customTooltip/referenceResolver.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAa3D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAC7B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,wBAAwB,EAChC,YAAY,EAAE,MAAM,GACrB,MAAM,CAYR"}

package/esm/customTooltip/referenceResolver.js

@@ -0,0 +1,41 @@
+// (C) 2026 GoodData Corporation
+import { REFERENCE_REGEX_MATCH } from "@gooddata/sdk-ui-kit";
+// Markdown metacharacters that, if present in a substituted value, would be
+// reinterpreted as formatting by `markdownToHtml`. Backslash-escape them so the
+// parser treats them as literal text. The set covers every char that can start
+// or end a markdown construct supported by our parser: emphasis, link/image
+// brackets, parens, headings, lists, and horizontal rules.
+const MARKDOWN_METACHARS = /[\\*_`\[\]()!#~+\-]/g;
+function escapeMarkdownMetachars(value) {
+    return value.replace(MARKDOWN_METACHARS, "\\$&");
+}
+/**
+ * Substitutes `{metric/id}` and `{label/id}` references in markdown content
+ * with resolved values from the lookup table.
+ *
+ * Substituted values come from data and may contain markdown metacharacters
+ * (e.g., `*`, `_`, `[`). They are backslash-escaped so the downstream
+ * markdown-to-HTML conversion renders them as literal text rather than as
+ * unintended formatting. `markdownToHtml` understands the backslash escapes.
+ *
+ * @param content - Markdown content with reference placeholders
+ * @param values - Lookup of `metric/id` and `label/id` keys to formatted values.
+ *   Keys must use a lowercase prefix; LDM identifiers are case-sensitive.
+ * @param fallbackText - Localized text shown when a reference is recognized
+ *   but no value is available (unknown identifier, point with no value, etc.).
+ *
+ * @internal
+ */
+export function resolveReferences(content, values, fallbackText) {
+    if (!content) {
+        return "";
+    }
+    return content.replace(REFERENCE_REGEX_MATCH, (_fullMatch, _wrapped, _key, prefix, identifier) => {
+        // The regex matches the prefix case-insensitively; storage uses
+        // lowercase prefixes so users can write either `{metric/foo}` or
+        // `{Metric/foo}`. LDM identifiers stay as-is — they are case-sensitive.
+        const value = values[`${prefix.toLowerCase()}/${identifier}`];
+        return escapeMarkdownMetachars(value === undefined ? fallbackText : value);
+    });
+}
+//# sourceMappingURL=referenceResolver.js.map

package/esm/customTooltip/referenceResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"referenceResolver.js","sourceRoot":"","sources":["../../src/customTooltip/referenceResolver.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAEhC,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAI7D,4EAA4E;AAC5E,gFAAgF;AAChF,+EAA+E;AAC/E,4EAA4E;AAC5E,2DAA2D;AAC3D,MAAM,kBAAkB,GAAG,sBAAsB,CAAC;AAElD,SAAS,uBAAuB,CAAC,KAAa,EAAU;IACpD,OAAO,KAAK,CAAC,OAAO,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;AAAA,CACpD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,iBAAiB,CAC7B,OAAe,EACf,MAAgC,EAChC,YAAoB,EACd;IACN,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,OAAO,EAAE,CAAC;IACd,CAAC;IAED,OAAO,OAAO,CAAC,OAAO,CAAC,qBAAqB,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,CAAC;QAC9F,gEAAgE;QAChE,iEAAiE;QACjE,0EAAwE;QACxE,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,IAAI,UAAU,EAAE,CAAC,CAAC;QAC9D,OAAO,uBAAuB,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAAA,CAC9E,CAAC,CAAC;AAAA,CACN"}

package/esm/customTooltip/types.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Placement of the custom tooltip section relative to the default tooltip content.
+ *
+ * @alpha
+ */
+export type CustomTooltipPlacement = "above" | "below" | "replace";
+/**
+ * Custom tooltip configuration.
+ *
+ * @remarks
+ * Allows users to define a custom section in the visualization tooltip using Markdown
+ * with metric/attribute references that resolve dynamically per hovered data point.
+ *
+ * @alpha
+ */
+export interface ICustomTooltipConfig {
+    /**
+     * Whether the custom tooltip is enabled.
+     */
+    enabled?: boolean;
+    /**
+     * Markdown content for the custom tooltip section.
+     *
+     * @remarks
+     * Supports a subset of Markdown:
+     *
+     * - Headings: `#` through `####`
+     * - Bold (`**text**`), italic (`*text*`)
+     * - Unordered lists (`- item`) and ordered lists (`1. item`) — not nested
+     * - Images (`![alt](url)`) — `https:`, `http:`, and `data:image/...` URLs only
+     * - Links (`[text](url)`) — rendered as styled text, NOT clickable inside tooltips
+     * - Horizontal rules (`---`)
+     * - Backslash escapes (`\*`, `\_`, `\[`, `\!`, etc.) to render a metacharacter
+     *   as literal text instead of formatting
+     *
+     * Not supported: tables, code blocks, blockquotes, nested lists, raw HTML.
+     *
+     * Also accepts metric/attribute references (\{metric/id\}, \{label/id\})
+     * that resolve dynamically per hovered data point. Resolved values are
+     * automatically backslash-escaped, so data containing markdown metacharacters
+     * renders as literal text — no manual escaping is required.
+     *
+     * @see https://www.gooddata.com/docs/cloud/create-visualizations/custom-tooltips/
+     */
+    content?: string;
+    /**
+     * Where to place the custom section relative to the default tooltip content.
+     *
+     * @defaultValue "above"
+     */
+    placement?: CustomTooltipPlacement;
+}
+/**
+ * Lookup of resolved reference values keyed by `metric/id` or `label/id`.
+ *
+ * @internal
+ */
+export interface IResolvedReferenceValues {
+    [referenceKey: string]: string | undefined;
+}
+//# sourceMappingURL=types.d.ts.map

package/esm/customTooltip/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/customTooltip/types.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;AAEnE;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAoB;IACjC;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,SAAS,CAAC,EAAE,sBAAsB,CAAC;CACtC;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACrC,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CAC9C"}

package/esm/customTooltip/types.js

@@ -0,0 +1,3 @@
+// (C) 2026 GoodData Corporation
+export {};
+//# sourceMappingURL=types.js.map

package/esm/customTooltip/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/customTooltip/types.ts"],"names":[],"mappings":"AAAA,gCAAgC"}

package/esm/index.d.ts

@@ -28,4 +28,8 @@ export { getHeadlineResponsiveClassName } from "./utils/headlineResponsiveClassN
 export { getLegendDetails, type ILegendDetails, type ILegendDetailOptions, } from "./legend/PopUpLegend/helpers.js";
 export { PATTERN_FILLS, getPatternFillByIndex, getPatternFillByName, getPatternFill, type IPatternFill, type PatternFillName, type IChartFillConfig, } from "./coloring/patternFills.js";
 export { PatternFill, type IPatternFillProps } from "./coloring/PatternFill.js";
+export { type ICustomTooltipConfig, type CustomTooltipPlacement, type IResolvedReferenceValues, } from "./customTooltip/types.js";
+export { markdownToHtml } from "./customTooltip/markdownToHtml.js";
+export { resolveReferences } from "./customTooltip/referenceResolver.js";
+export { resolveMeasureLdmIdentifier } from "./customTooltip/measureLdmIdentifier.js";
 //# sourceMappingURL=index.d.ts.map

package/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EACH,aAAa,EACb,KAAK,cAAc,EACnB,KAAK,iCAAiC,EACtC,2BAA2B,EAC3B,kBAAkB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACH,cAAc,EACd,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EACzB,eAAe,EACf,sBAAsB,EACtB,YAAY,EACZ,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,UAAU,EACV,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,gBAAgB,GACnB,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACR,aAAa,EACb,aAAa,EACb,qBAAqB,EACrB,cAAc,GACjB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,MAAM,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE/D,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEjF,OAAO,EAAE,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAE1F,OAAO,EAAE,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE9E,OAAO,EAAE,aAAa,EAAE,KAAK,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEpF,OAAO,EAAE,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE9E,OAAO,EAAE,MAAM,EAAE,KAAK,YAAY,EAAE,KAAK,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAE5F,OAAO,EAAE,kBAAkB,EAAE,KAAK,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAExG,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAEjG,OAAO,EACH,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,0BAA0B,EAC/B,KAAK,MAAM,EACX,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAC9B,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,qBAAqB,EACrB,cAAc,EACd,wBAAwB,EACxB,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACrB,yBAAyB,EACzB,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,GACf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAE3E,OAAO,EAAE,sBAAsB,EAAE,+BAA+B,EAAE,MAAM,kCAAkC,CAAC;AAC3G,OAAO,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AAExF,OAAO,EACH,gBAAgB,EAChB,KAAK,cAAc,EACnB,KAAK,oBAAoB,GAC5B,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACH,aAAa,EACb,qBAAqB,EACrB,oBAAoB,EACpB,cAAc,EACd,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACxB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/esm/index.js

@@ -29,4 +29,7 @@ export { getHeadlineResponsiveClassName } from "./utils/headlineResponsiveClassN
 export { getLegendDetails, } from "./legend/PopUpLegend/helpers.js";
 export { PATTERN_FILLS, getPatternFillByIndex, getPatternFillByName, getPatternFill, } from "./coloring/patternFills.js";
 export { PatternFill } from "./coloring/PatternFill.js";
+export { markdownToHtml } from "./customTooltip/markdownToHtml.js";
+export { resolveReferences } from "./customTooltip/referenceResolver.js";
+export { resolveMeasureLdmIdentifier } from "./customTooltip/measureLdmIdentifier.js";
 //# sourceMappingURL=index.js.map

package/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,qCAAqC;AAErC,oDAAoD;AAEpD;;;;;;;;GAQG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EACH,aAAa,EAGb,2BAA2B,EAC3B,kBAAkB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACH,cAAc,EACd,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EACzB,eAAe,EACf,sBAAsB,EACtB,YAAY,EACZ,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,UAAU,EACV,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,gBAAgB,GACnB,MAAM,qBAAqB,CAAC;AAS7B,OAAO,EAAE,MAAM,EAAqB,MAAM,oBAAoB,CAAC;AAE/D,OAAO,EAAE,YAAY,EAA2B,MAAM,0BAA0B,CAAC;AAEjF,OAAO,EAAE,WAAW,EAA0B,MAAM,qCAAqC,CAAC;AAE1F,OAAO,EAAE,WAAW,EAA0B,MAAM,yBAAyB,CAAC;AAE9E,OAAO,EAAE,aAAa,EAA4B,MAAM,2BAA2B,CAAC;AAEpF,OAAO,EAAE,WAAW,EAA0B,MAAM,yBAAyB,CAAC;AAE9E,OAAO,EAAE,MAAM,EAAkD,MAAM,oBAAoB,CAAC;AAE5F,OAAO,EAAE,kBAAkB,EAAiC,MAAM,qCAAqC,CAAC;AAExG,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAEjG,OAAO,EAmBH,qBAAqB,EACrB,cAAc,EACd,wBAAwB,EACxB,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACrB,yBAAyB,EACzB,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,GACf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAE3E,OAAO,EAAE,sBAAsB,EAAE,+BAA+B,EAAE,MAAM,kCAAkC,CAAC;AAC3G,OAAO,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AAExF,OAAO,EACH,gBAAgB,GAGnB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACH,aAAa,EACb,qBAAqB,EACrB,oBAAoB,EACpB,cAAc,GAIjB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,WAAW,EAA0B,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,qCAAqC;AAErC,oDAAoD;AAEpD;;;;;;;;GAQG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EACH,aAAa,EAGb,2BAA2B,EAC3B,kBAAkB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACH,cAAc,EACd,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EACzB,eAAe,EACf,sBAAsB,EACtB,YAAY,EACZ,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,UAAU,EACV,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,gBAAgB,GACnB,MAAM,qBAAqB,CAAC;AAS7B,OAAO,EAAE,MAAM,EAAqB,MAAM,oBAAoB,CAAC;AAE/D,OAAO,EAAE,YAAY,EAA2B,MAAM,0BAA0B,CAAC;AAEjF,OAAO,EAAE,WAAW,EAA0B,MAAM,qCAAqC,CAAC;AAE1F,OAAO,EAAE,WAAW,EAA0B,MAAM,yBAAyB,CAAC;AAE9E,OAAO,EAAE,aAAa,EAA4B,MAAM,2BAA2B,CAAC;AAEpF,OAAO,EAAE,WAAW,EAA0B,MAAM,yBAAyB,CAAC;AAE9E,OAAO,EAAE,MAAM,EAAkD,MAAM,oBAAoB,CAAC;AAE5F,OAAO,EAAE,kBAAkB,EAAiC,MAAM,qCAAqC,CAAC;AAExG,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAEjG,OAAO,EAmBH,qBAAqB,EACrB,cAAc,EACd,wBAAwB,EACxB,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACrB,yBAAyB,EACzB,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,GACf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAE3E,OAAO,EAAE,sBAAsB,EAAE,+BAA+B,EAAE,MAAM,kCAAkC,CAAC;AAC3G,OAAO,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AAExF,OAAO,EACH,gBAAgB,GAGnB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACH,aAAa,EACb,qBAAqB,EACrB,oBAAoB,EACpB,cAAc,GAIjB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,WAAW,EAA0B,MAAM,2BAA2B,CAAC;AAOhF,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,EAAE,2BAA2B,EAAE,MAAM,yCAAyC,CAAC"}

package/esm/sdk-ui-vis-commons.d.ts

@@ -18,6 +18,7 @@ import { IColorPaletteItem } from '@gooddata/sdk-model';
 import { IDataView } from '@gooddata/sdk-backend-spi';
 import { IHeaderPredicate } from '@gooddata/sdk-ui';
 import { IMappingHeader } from '@gooddata/sdk-ui';
+import { IMeasure } from '@gooddata/sdk-model';
 import { IRgbColorValue } from '@gooddata/sdk-model';
 import { ITheme } from '@gooddata/sdk-model';
 import { JSX } from 'react/jsx-runtime';
@@ -83,6 +84,13 @@ export declare const ColorUtils: {
     getColorMappingPredicate: typeof getColorMappingPredicate;
 };
 
+/**
+ * Placement of the custom tooltip section relative to the default tooltip content.
+ *
+ * @alpha
+ */
+export declare type CustomTooltipPlacement = "above" | "below" | "replace";
+
 /**
  * @internal
  */
@@ -334,6 +342,53 @@ export declare interface ICreateColorAssignmentReturnValue {
     outputColorAssignment?: IColorAssignment[];
 }
 
+/**
+ * Custom tooltip configuration.
+ *
+ * @remarks
+ * Allows users to define a custom section in the visualization tooltip using Markdown
+ * with metric/attribute references that resolve dynamically per hovered data point.
+ *
+ * @alpha
+ */
+export declare interface ICustomTooltipConfig {
+    /**
+     * Whether the custom tooltip is enabled.
+     */
+    enabled?: boolean;
+    /**
+     * Markdown content for the custom tooltip section.
+     *
+     * @remarks
+     * Supports a subset of Markdown:
+     *
+     * - Headings: `#` through `####`
+     * - Bold (`**text**`), italic (`*text*`)
+     * - Unordered lists (`- item`) and ordered lists (`1. item`) — not nested
+     * - Images (`![alt](url)`) — `https:`, `http:`, and `data:image/...` URLs only
+     * - Links (`[text](url)`) — rendered as styled text, NOT clickable inside tooltips
+     * - Horizontal rules (`---`)
+     * - Backslash escapes (`\*`, `\_`, `\[`, `\!`, etc.) to render a metacharacter
+     *   as literal text instead of formatting
+     *
+     * Not supported: tables, code blocks, blockquotes, nested lists, raw HTML.
+     *
+     * Also accepts metric/attribute references (\{metric/id\}, \{label/id\})
+     * that resolve dynamically per hovered data point. Resolved values are
+     * automatically backslash-escaped, so data containing markdown metacharacters
+     * renders as literal text — no manual escaping is required.
+     *
+     * @see https://www.gooddata.com/docs/cloud/create-visualizations/custom-tooltips/
+     */
+    content?: string;
+    /**
+     * Where to place the custom section relative to the default tooltip content.
+     *
+     * @defaultValue "above"
+     */
+    placement?: CustomTooltipPlacement;
+}
+
 /**
  * @internal
  */
@@ -556,6 +611,15 @@ export declare interface IRange {
     to: number;
 }
 
+/**
+ * Lookup of resolved reference values keyed by `metric/id` or `label/id`.
+ *
+ * @internal
+ */
+export declare interface IResolvedReferenceValues {
+    [referenceKey: string]: string | undefined;
+}
+
 /**
  * @internal
  */
@@ -685,6 +749,11 @@ export declare const LegendPosition: {
     [name: string]: PositionType;
 };
 
+/**
+ * @internal
+ */
+export declare function markdownToHtml(markdown: string): string;
+
 /**
  * @internal
  */
@@ -747,6 +816,36 @@ export declare function PopUpLegend({ name, maxRows, enableBorderRadius, series,
  */
 export declare type PositionType = "left" | "right" | "top" | "bottom" | "auto";
 
+/**
+ * Returns the LDM identifier the measure ultimately resolves to.
+ *
+ * - Simple measures: the identifier of the underlying catalog metric
+ * - Derived measures (PoP, previous period): follows the chain to the master
+ * - Arithmetic measures (and anything without an identifier ref): undefined
+ *
+ * @internal
+ */
+export declare function resolveMeasureLdmIdentifier(measure: IMeasure, allMeasures: IMeasure[]): string | undefined;
+
+/**
+ * Substitutes `{metric/id}` and `{label/id}` references in markdown content
+ * with resolved values from the lookup table.
+ *
+ * Substituted values come from data and may contain markdown metacharacters
+ * (e.g., `*`, `_`, `[`). They are backslash-escaped so the downstream
+ * markdown-to-HTML conversion renders them as literal text rather than as
+ * unintended formatting. `markdownToHtml` understands the backslash escapes.
+ *
+ * @param content - Markdown content with reference placeholders
+ * @param values - Lookup of `metric/id` and `label/id` keys to formatted values.
+ *   Keys must use a lowercase prefix; LDM identifiers are case-sensitive.
+ * @param fallbackText - Localized text shown when a reference is recognized
+ *   but no value is available (unknown identifier, point with no value, etc.).
+ *
+ * @internal
+ */
+export declare function resolveReferences(content: string, values: IResolvedReferenceValues, fallbackText: string): string;
+
 /**
  * @internal
  * Check if Kpi's and Headlines should display pagination according to widget height.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gooddata/sdk-ui-vis-commons",
-  "version": "11.33.0-alpha.4",
+  "version": "11.33.0-alpha.7",
   "description": "GoodData.UI SDK - common functionality for different types of visualizations",
   "license": "MIT",
   "author": "GoodData Corporation",
@@ -36,11 +36,11 @@
     "react-intl": "7.1.11",
     "react-measure": "^2.5.2",
     "tslib": "2.8.1",
-    "@gooddata/sdk-backend-spi": "11.33.0-alpha.4",
-    "@gooddata/sdk-model": "11.33.0-alpha.4",
-    "@gooddata/sdk-ui": "11.33.0-alpha.4",
-    "@gooddata/sdk-ui-kit": "11.33.0-alpha.4",
-    "@gooddata/sdk-ui-theme-provider": "11.33.0-alpha.4"
+    "@gooddata/sdk-backend-spi": "11.33.0-alpha.7",
+    "@gooddata/sdk-model": "11.33.0-alpha.7",
+    "@gooddata/sdk-ui": "11.33.0-alpha.7",
+    "@gooddata/sdk-ui-kit": "11.33.0-alpha.7",
+    "@gooddata/sdk-ui-theme-provider": "11.33.0-alpha.7"
   },
   "devDependencies": {
     "@microsoft/api-documenter": "^7.17.0",
@@ -81,11 +81,11 @@
     "typescript": "5.9.3",
     "vitest": "4.1.0",
     "vitest-dom": "0.1.1",
-    "@gooddata/eslint-config": "11.33.0-alpha.4",
-    "@gooddata/oxlint-config": "11.33.0-alpha.4",
-    "@gooddata/reference-workspace": "11.33.0-alpha.4",
-    "@gooddata/sdk-backend-mockingbird": "11.33.0-alpha.4",
-    "@gooddata/stylelint-config": "11.33.0-alpha.4"
+    "@gooddata/eslint-config": "11.33.0-alpha.7",
+    "@gooddata/oxlint-config": "11.33.0-alpha.7",
+    "@gooddata/sdk-backend-mockingbird": "11.33.0-alpha.7",
+    "@gooddata/reference-workspace": "11.33.0-alpha.7",
+    "@gooddata/stylelint-config": "11.33.0-alpha.7"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",

package/styles/scss/customTooltip.scss

@@ -0,0 +1,65 @@
+// (C) 2026 GoodData Corporation
+
+// Styles for the custom tooltip section rendered inside .gd-viz-tooltip
+// containers across chart families (Highcharts, geo, etc.).
+
+.gd-viz-tooltip-custom-section {
+    font-size: 13px;
+    line-height: 1.4;
+    text-align: left;
+    white-space: normal;
+    word-wrap: break-word;
+    min-width: 200px;
+
+    h1,
+    h2,
+    h3,
+    h4 {
+        margin: 0 0 2px;
+        font-weight: 700;
+        color: var(--gd-chart-tooltip-valueColor);
+        font-size: 14px;
+        line-height: 1.3;
+    }
+
+    p {
+        margin: 0 0 1px;
+    }
+
+    strong {
+        font-weight: 700;
+        color: var(--gd-chart-tooltip-valueColor);
+    }
+
+    ul,
+    ol {
+        margin: 2px 0;
+        padding-left: 18px;
+    }
+
+    li {
+        margin-bottom: 1px;
+    }
+
+    hr {
+        border: 0;
+        border-top: 1px solid var(--gd-palette-complementary-3);
+        margin: 4px 0;
+    }
+
+    img {
+        max-width: 100%;
+        display: block;
+        margin: 4px 0;
+    }
+
+    .gd-viz-tooltip-custom-link {
+        text-decoration: underline;
+        color: var(--gd-chart-tooltip-labelColor-from-theme);
+    }
+}
+
+.gd-viz-tooltip-custom-separator {
+    border-top: 1px solid var(--gd-palette-complementary-3);
+    margin: 8px 0;
+}