Version 5.17.3

Author: martynasma

package.json

@@ -1,7 +1,7 @@
 {
   "private": true,
   "name": "@amcharts/amcharts5",
-  "version": "5.17.2",
+  "version": "5.17.3",
   "author": "amCharts <contact@amcharts.com> (https://www.amcharts.com/)",
   "description": "amCharts 5",
   "homepage": "https://www.amcharts.com/",

packages/shared/CHANGELOG.md

@@ -5,6 +5,21 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/).
 Please note, that this project, while following numbering syntax, it DOES NOT
 adhere to [Semantic Versioning](http://semver.org/spec/v2.0.0.html) rules.
 
+## [5.17.3] - 2026-05-29
+
+### Added
+- `Label` setting `fontFamily` now accepts special value of `"inherit"`. If set it will automatically use computer `fontFamily` value on chart's DOM container.
+- `onDebounced(key, callback, delay)` and `offDebounced(key, callback?)` methods added to all entities. Like `on()`/`off()` for settings, but the callback fires only once after rapid changes settle, waiting `delay` milliseconds since the last change.
+- `onPrivateDebounced(key, callback, delay)` and `offDebouncedPrivate(key, callback?)` — same as above for private settings.
+
+### Fixed
+- The underline text for a `Label` could render thicker in some cases.
+- `GanttSeries` was not syncing the `end` field back to data context when tasks were moved or resized, causing stale values when serializing data or calculating linked group positions.
+- `Gantt.addNewTask()` was setting a hardcoded stale `end` value in new task data.
+- If `Root` was placed in a ShadowDOM, TAB would select non-visible focusable elements.
+- Accessibility: The text for readable tooltip element had in-line formatting text in them.
+
+
 ## [5.17.2] - 2026-04-16
 
 ### Changed

src/.internal/charts/gantt/Gantt.ts

@@ -786,7 +786,6 @@ export class Gantt extends Container {
 
 		const seriesDataObject: any = {
 			start: start,
-			end: start + 1,
 			duration: duration,
 			progress: progress,
 			id: uid,

src/.internal/charts/gantt/GanttSeries.ts

@@ -761,10 +761,12 @@ export class GanttSeries extends ColumnSeries {
 
 
 						delete (dataContext[this.get("openValueXField")]);
+						delete (dataContext[this.get("valueXField")]);
 						delete (dataContext[this.get("durationField")]);
 					}
 					else {
 						dataContext[this.get("openValueXField")] = dataItem.get("openValueX");
+						dataContext[this.get("valueXField")] = dataItem.get("valueX");
 						dataContext[this.get("durationField")] = dataItem.get("duration");
 						dataContext[this.get("progressField")] = dataItem.get("progress");
 					}

src/.internal/charts/stock/drawing/LabelSeries.ts

@@ -25,6 +25,9 @@ export interface ILabelSeriesSettings extends IPolylineSeriesSettings {
 
 	/**
 	 * Label font family.
+	 *
+	 * Use reserved value `"inherit"` to use computed style on chart
+	 * container. (since `5.17.3`)
 	 */
 	labelFontFamily?: string;
 
@@ -332,7 +335,7 @@ export class LabelSeries extends PolylineSeries {
 	}
 
 	protected _handleBulletDragStart(event: ISpritePointerEvent) {
-		// don't call super		
+		// don't call super
 		const stockChart = this._getStockChart();
 		if (stockChart) {
 			stockChart._dragStartDrawing(event);
@@ -355,4 +358,4 @@ export class LabelSeries extends PolylineSeries {
 			grip.set("forceInactive", !enabled);
 		})
 	}
-}
+}

src/.internal/charts/stock/toolbar/DrawingControl.ts

@@ -150,6 +150,9 @@ export interface IDrawingControlSettings extends IStockControlSettings {
 
 	/**
 	 * Default label font.
+	 *
+	 * Use reserved value `"inherit"` to use computed style on chart
+	 * container. (since `5.17.3`)
 	 */
 	labelFontFamily?: string;
 

src/.internal/core/Registry.ts

@@ -5,7 +5,7 @@ export class Registry {
 	/**
 	 * Currently running version of amCharts.
 	 */
-	readonly version: string = "5.17.2";
+	readonly version: string = "5.17.3";
 
 	/**
 	 * List of applied licenses.

src/.internal/core/Root.ts

@@ -1048,7 +1048,7 @@ export class Root implements IDisposer {
 					allParents[parent.uid] = parent;
 					parent._prepareChildren();
 				}
-			});			
+			});
 		}
 
 		$object.entries(allParents).forEach(([_key, parent]) => {
@@ -1067,7 +1067,7 @@ export class Root implements IDisposer {
 				entity._beforeChanged();
 			}
 		});
-		
+
 		//		console.log("_changed")
 		objects.forEach((entity) => {
 			entity._changed();
@@ -1825,7 +1825,19 @@ export class Root implements IDisposer {
 			return;
 		}
 
-		const focusableElements = Array.from(document.querySelectorAll([
+		const rootNode = this.dom.getRootNode ? this.dom.getRootNode() : null;
+		let queryRoot: Document | ShadowRoot = this.dom.ownerDocument || document;
+
+		if (rootNode) {
+			if (typeof ShadowRoot !== "undefined" && rootNode instanceof ShadowRoot) {
+				queryRoot = rootNode;
+			}
+			else if (rootNode instanceof Document) {
+				queryRoot = rootNode;
+			}
+		}
+
+		const focusableElements = Array.from(queryRoot.querySelectorAll([
 			'a[href]',
 			'area[href]',
 			'button:not([disabled])',
@@ -1860,7 +1872,9 @@ export class Root implements IDisposer {
 			}
 		}
 
-		targetElement.focus();
+		if (targetElement) {
+			targetElement.focus();
+		}
 	}
 
 	protected _handleBlur(ev: FocusEvent): void {
@@ -1888,7 +1902,7 @@ export class Root implements IDisposer {
 			return;
 		}
 
-		const text = $utils.stripTags(target._getText());
+		const text = $utils.stripFormatTags($utils.stripTags(target._getText()));
 		let tooltipElement = target.getPrivate("tooltipElement");
 		if (target.get("role") == "tooltip" && text != "") {
 			if (!tooltipElement) {

src/.internal/core/render/Label.ts

@@ -16,7 +16,7 @@ export interface ILabelSettings extends IContainerSettings {
 	/**
 	 * Labels' text.
 	 * @see {@link https://www.amcharts.com/docs/v5/concepts/formatters/text-styling/} for text styling info
-	 * 
+	 *
 	 */
 	text?: string;
 
@@ -50,6 +50,9 @@ export interface ILabelSettings extends IContainerSettings {
 	 * Font family to use for the label.
 	 *
 	 * Multiple fonts can be separated by commas.
+	 *
+	 * Use reserved value `"inherit"` to use computed style on chart
+	 * container. (since `5.17.3`)
 	 */
 	fontFamily?: string;
 
@@ -223,7 +226,7 @@ export interface ILabelSettings extends IContainerSettings {
 	 *
 	 * If the `text` is longer than `maxChars`, the text will be truncated
 	 * using the `breakWords` and `ellipsis` settings.
-	 * 
+	 *
 	 * @since 5.7.2
 	 */
 	maxChars?: number;

src/.internal/core/render/backend/CanvasRenderer.ts

@@ -1090,7 +1090,7 @@ class Shadow extends Op {
 		context.shadowOffsetY = this.offsetY;
 	}
 
-	public colorizeGhost(_context: CanvasRenderingContext2D, _forceColor: string | undefined): void {}
+	public colorizeGhost(_context: CanvasRenderingContext2D, _forceColor: string | undefined): void { }
 }
 
 /**
@@ -1764,7 +1764,10 @@ export class CanvasText extends CanvasDisplayObject implements IText {
 			fontStyle.push(style.fontSize);
 		}
 
-		if (style2 && style2.fontFamily) {
+		if (style.fontFamily == "inherit") {
+			fontStyle.push(getComputedStyle(this._renderer.view).getPropertyValue("font-family"));
+		}
+		else if (style2 && style2.fontFamily) {
 			fontStyle.push(style2.fontFamily);
 		}
 		else if (style.fontFamily) {
@@ -1882,6 +1885,8 @@ export class CanvasText extends CanvasDisplayObject implements IText {
 							y = thickness + offset * 1.5 + line.offsetY + chunk.offsetY;
 						}
 
+						y = Math.round(y);
+
 						if (!ghostOnly) {
 							context.save();
 							context.beginPath();
@@ -2124,6 +2129,26 @@ export class CanvasText extends CanvasDisplayObject implements IText {
 									this.textVisible = true;
 									return false;
 								}
+
+								// _truncateText() may return text that still overflows (a single
+								// word wider than the remaining space when word-breaking is not
+								// allowed). If the line already has content, move the WHOLE chunk
+								// to the next line instead of letting it overflow.
+								if (!firstTextChunk) {
+									const tmpMetrics = this._measureText($utils.trim(tmpText), context);
+									const tmpWidth = tmpMetrics.actualBoundingBoxLeft + tmpMetrics.actualBoundingBoxRight;
+									if (tmpWidth > excessWidth) {
+										leftoverChunks = chunks.slice(index);
+										if (currentFormat) {
+											leftoverChunks.unshift({
+												type: "format",
+												text: currentFormat
+											});
+										}
+										chunks = [];
+										return false;
+									}
+								}
 								//skipFurtherText = true;
 
 								//Add remaining chunks for the next line
@@ -2357,7 +2382,9 @@ export class CanvasText extends CanvasDisplayObject implements IText {
 				text = text.slice(0, -1);
 			}
 			else {
-				let tmp = text.replace(/[^,;:!?\\\/\s​]+[,;:!?\\\/\s​]*$/g, "");
+				// A comma directly followed by a digit is a numeric separator (e.g.
+				// "1,200,300"), not a word boundary - keep such numbers unbroken.
+				let tmp = text.replace(/(?:[^,;:!?\\\/\s​]|,(?=\d))+[,;:!?\\\/\s​]*$/g, "");
 				if ((tmp == "" || tmp === text) && fallbackBreakWords) {
 					breakWords = true;
 				}
@@ -3137,7 +3164,7 @@ interface IEvents<Key extends keyof IRendererEvents> {
  */
 export class CanvasRenderer extends ArrayDisposer implements IRenderer, IDisposer {
 	public view: HTMLElement = document.createElement("div");
-	protected _layerDom: HTMLElement = document.createElement("div");
+	public _layerDom: HTMLElement = document.createElement("div");
 
 	public layers: Array<CanvasLayer> = [];
 	public _dirtyLayers: Array<CanvasLayer> = [];