@amcharts/amcharts5-mcp 1.3.2 → 1.4.0

package/content/SKILL.md

@@ -105,7 +105,16 @@ root.dateFormatter.setAll({ dateFormat: "yyyy-MM-dd" });
 root.numberFormatter.setAll({ numberFormat: "#,###.##" });
 ```
 
-**Available themes:** `Animated`, `Dark`, `Frozen`, `Dataviz`, `Material`, `Moonrise`, `Spirited`, `Kelly`, `Micro`, `Responsive`.
+**Available themes** (as of 5.20.0):
+
+| Kind | Themes |
+|------|--------|
+| Behavioral | `Animated` (animations), `Micro` (stripped-down micro charts), `Responsive` (size-based rules) |
+| Light palettes | `Dataviz`, `Frozen`, `Kelly`, `Material`, `Moonrise`, `Spirited`, `Ember`, `Nord`, `Pastel`, `Petroleum`, `Savanna`, `Colorblind` (Okabe-Ito, color-blindness safe), `Patterns` (pattern fills instead of flat colors) |
+| Dark | `Dark`, `Midnight`, plus a dark variant of most palettes: `DatavizDark`, `FrozenDark`, `KellyDark`, `MaterialDark`, `MoonriseDark`, `SpiritedDark`, `NordDark`, `PastelDark`, `ColorblindDark`, `PatternsDark` |
+| Parameterized (5.20.0) | `Monochrome`, `Adaptive` — see below |
+
+Palette themes are additive: combine with `Animated`, e.g. `root.setThemes([am5themes_Animated.new(root), am5themes_Nord.new(root)])`. The `*Dark` variants already carry dark interface colors, so do NOT also add `Dark`.
 
 ## Colors
 
@@ -458,6 +467,39 @@ series.columns.template.states.create("active", {
 // State animation: stateAnimationDuration, stateAnimationEasing
 ```
 
+## Parameterized themes — Monochrome & Adaptive (5.20.0)
+
+Two themes generate their palette from colors you pass in (OKLCH-based, so the result stays perceptually balanced). Because a theme cannot take constructor parameters, these ship as **factory functions** — call them with `(root, settings)`; `.new(root, settings)` also works.
+
+```js
+import am5themes_Monochrome from "@amcharts/amcharts5/themes/Monochrome";
+import am5themes_Adaptive from "@amcharts/amcharts5/themes/Adaptive";
+
+// Monochrome — single-hue lightness ramp
+root.setThemes([
+  am5themes_Animated.new(root),
+  am5themes_Monochrome(root, {
+    color: 0x2c6e91,   // base hue (default: blue #2e7c9e)
+    accent: 0xff7f0e,  // optional — applied to the FIRST series only, so it pops
+    count: 7,          // steps in the ramp (default 7)
+    dark: false        // true = dark background + light-to-mid ramp
+  })
+]);
+
+// Adaptive — full palette generated from one or two base colors
+root.setThemes([
+  am5themes_Animated.new(root),
+  am5themes_Adaptive(root, {
+    baseColor: 0x2c6e91,   // first generated color IS this color (good for brand colors)
+    baseColor2: 0xffdd00,  // optional — palette spans the two colors
+    count: 10,             // number of series colors (default 10)
+    dark: false
+  })
+]);
+```
+
+Both are additive (they do not modify built-in themes) and both handle dark mode themselves via `dark: true` — do not also add the `Dark` theme.
+
 ## Custom themes
 
 ```js
@@ -660,7 +702,7 @@ onUnmounted(() => { root.dispose(); });
 12. **CDN script load order** — `index.js` must load first, then `xy.js`, then any package that depends on it (`radar.js`, `timeline.js`, `gantt.js`). Wrong order causes runtime errors. Correct order: `index.js` → `xy.js` → `radar.js` / `timeline.js` / `gantt.js` → `themes/*.js`.
 13. **No `minorGrid` / `minorTicks` / `minorLabels` objects** — These do not exist on axes. Minor grid is enabled via boolean flags on the **renderer**: `minorGridEnabled: true` and optionally `minorLabelsEnabled: true`. Styling is done through theme rules targeting the `"minor"` tag, not through separate object properties.
 14. **Flow chart animated bullets go on `series.bullets`, NOT `series.links.template.bullets`** — To animate labels/circles flowing along Sankey or Chord links, use `series.bullets.push(function(...) { ... })`. Animate `bullet.locationX` (Sankey) or `bullet.locationY` (Chord) from 0→1 with `loops: Infinity`. Use an adapter on opacity for fade effect. See `references/flow.md` → "Animated bullets along links".
-15. **`MapPointSeries` needs `latitudeField`/`longitudeField` when using `data.setAll()`** — If point data has `latitude`/`longitude` fields, the series must declare them: `am5map.MapPointSeries.new(root, { latitudeField: "latitude", longitudeField: "longitude" })`. Without these, points silently won't appear. This is NOT needed when using `pushDataItem({ latitude: ..., longitude: ... })` which passes coordinates directly.
+15. **`MapPointSeries` needs `latitudeField`/`longitudeField` when your data fields are named anything other than `latitude`/`longitude`** — Since 5.16.1 the series defaults to `latitudeField: "latitude"`, `longitudeField: "longitude"`, so data using exactly those names works with no declaration. Any other naming (`lat`/`lng`, `y`/`x`, …) must be declared or the points silently won't appear: `am5map.MapPointSeries.new(root, { latitudeField: "lat", longitudeField: "lng" })`. Neither is needed with `pushDataItem({ latitude: ..., longitude: ... })`, which passes coordinates directly. On amCharts **older than 5.16.1** there were no defaults, so declare the fields explicitly if you must support those versions.
 16. **`data.setAll()` does NOT animate — use `data.setIndex()` for animated updates** — When the user asks to update/refresh data with animation, do NOT use `series.data.setAll(newData)` — it replaces everything instantly with no transition. Instead, update each item with `series.data.setIndex(i, newItem)` which triggers smooth value animation. For full replacement with animation, loop: `newData.forEach(function(item, i) { series.data.setIndex(i, item); })`.
 17. **`color.lighten()` / `color.darken()` are NOT instance methods** — `am5.color(0xff0000).lighten(0.3)` does NOT work. Use static methods: `am5.Color.lighten(color, 0.3)` to lighten, `am5.Color.lighten(color, -0.3)` to darken. There is NO `darken()` method — use negative lighten. Also available: `am5.Color.brighten()`, `am5.Color.saturate()`.
 18. **Venn diagram has no `VennDiagram` class** — `am5venn.Venn` is pushed directly into a `Container`, NOT into a chart's `series`. See `references/venn.md`.
@@ -716,7 +758,7 @@ Skip this step entirely if you cannot execute code (e.g., chat-only context with
 
 ## Recent API changes (newer than the bundled class reference)
 
-The bundled per-class API reference was snapshotted on **2026-03-15**, so it predates the changes below. Prefer these names/settings; for anything newer, verify against the live docs (see next section).
+The bundled per-class API reference was snapshotted on **2026-03-15**, so it predates the changes below. Latest release covered here: **5.20.1** (2026-08-03). Prefer these names/settings; for anything newer, verify against the live docs (see next section).
 
 **Renamed settings (old name still works but is deprecated — use the new one):**
 
@@ -731,14 +773,50 @@ am5stock.MovingAverage.new(root, { maType: "exponential", period: 20 });
 am5hierarchy.VoronoiTreemap.new(root, { shapeType: "rectangle" }); // was: type
 ```
 
+**Breaking change — WordCloud internals (5.20.1):** the layout is now computed synchronously in one pass (much faster). The per-data-item `ghostLabel` is gone and labels live in an internal container, so `dataItem.get("ghostLabel")` and any code walking `series.children` to find labels must be updated — use `series.labels` / `dataItem.get("label")` instead.
+
 **New settings / methods worth knowing:**
+
+*Themes & styling*
+- 20+ new themes (5.20.0): `Midnight`, `Ember`, `Nord`, `Pastel`, `Colorblind`, `Patterns`, `Petroleum`, `Savanna`, plus `*Dark` variants of most palettes. Two parameterized factory themes, `Monochrome` and `Adaptive` — see "Parameterized themes" above.
+- New fill patterns (5.20.0): `am5.StarPattern` (`radius`, `innerRadius`, `spikes`, `gap`, `checkered`) and `am5.TrianglePattern` (`maxWidth`, `maxHeight`, `gap`, `checkered`).
+- `rotateShapes` (5.20.0) on `RectanglePattern`/`StarPattern`/`TrianglePattern`: `rotation` then spins each shape around its own center instead of the whole grid — tiles seamlessly and is much faster. Prefer it over a whole-pattern `rotation` on large tiles.
+- `Series`: `fillGradient` / `strokeGradient` settings. A bullet `Graphics` with no paint of its own (`fill`, `fillGradient`, `fillPattern`, `stroke`, `strokeGradient`) now inherits all of them from its series — and on pie, funnel, flow and hierarchy charts, from its own slice/node (5.20.0–5.20.1).
+
+*XY charts*
+- `XYChart`: `strokeWidths` (array of pixel widths) and `strokeDasharrays` (array of dash arrays) — cycled across line series as they are added, exactly like `colors`. Lets series be told apart without relying on color, e.g. with the `Patterns` theme.
+- `XYCursor`: `clickTolerance` (default `0`) — how many pixels outside the plot area a press may start and still begin a zoom/selection. The selection itself still starts at the plot edge.
+- `XYSeries`: a value field (`valueYField`, `openValueYField`, …) can now be changed after creation — re-set the series data afterwards for it to take effect. A series can also be reassigned to a different `xAxis`/`yAxis` after creation.
+
+*WordCloud (5.20.1)*
+- `svgPath` arranges words into a shape (experimental), with `maskByShape` to clip them to the outline and `shapeTolerance` to control spill (negative = padding inside). See `references/wordcloud.md`.
+- `randomizeAngles: false` cycles `angles` in order for a reproducible layout; `allowNesting: false` packs words as non-overlapping bounding boxes (use it when labels have opaque backgrounds).
+- `angles` now accepts **any** angle (e.g. `[0, -30, -45]`). Before 5.20.1 only `0`/`±90` were handled, and the old docs said so explicitly — that restriction is gone.
+
+*Core / events*
+- New `globalpointerdown` event on all elements — fires on a press anywhere on the chart surface, mirroring `globalpointermove`/`globalpointerup`.
+- `Root`: `sanitizeHTML` (5.19.0, default `true`) — dynamically-set HTML (`html`/`labelHTML`, HTML tooltips, modal content) is sanitized; set `false` to opt out. Exports gained `escapeFormulas` (default `true`) to guard CSV/XLSX against formula injection.
+- `Root`: `ariaLabel` is now applied to the `<div>` holding the chart's focusable elements (5.20.0).
+- `Label`: `oversizedBehavior: "truncate"` now ignores `maxHeight` (there is no way to truncate text vertically).
+- A `Container`'s `Rectangle`/`RoundedRectangle` background now defaults `crisp` to `true` unless set explicitly (5.20.0).
+
+*Maps*
+- `MapChart`: `projectionName` (5.19.0) — string alternative to `projection`, e.g. `"geoOrthographic"`, mainly for JSON config. Register extra ones with `am5map.registerProjection()`. Bundled projections are no longer eagerly imported, so unused ones tree-shake away.
+- `MapSankeySeries` (5.17.0) — Sankey overlaid on a map; auto-resolves `sourceId`/`targetId` once `polygonSeries` geoJSON loads (5.17.1), so no `datavalidated` wrapper needed. See `references/map.md`.
+- `MapPointSeries` defaults changed to `longitudeField: "longitude"`, `latitudeField: "latitude"` (5.16.1).
+
+*Hierarchy & axes*
 - `Tree`: `fitNodes` (5.18.0, exclude hidden nodes from layout), `nodeSeparation` (5.16.2, custom node-spacing fn), `clustered` (5.16.2, dendrogram layout — leaves at same depth).
 - `ValueAxis`: `syncZeros` (5.16.2, align zero across synced axes — needs `syncWithAxis`).
 - `Hierarchy`: `parentIdField` setting + `setFlatData(data)` method (5.16.2) — feed flat `{id, parentId}` data instead of nested `children`.
-- All entities: `onDebounced(key, cb, delay)` / `offDebounced(key, cb?)` and `onPrivateDebounced` / `offDebouncedPrivate` (5.17.3) — fire once after rapid changes settle.
+
+*Stock*
+- Indicator numeric settings now enforce min/max limits, so extreme values can no longer freeze the page. `IIndicatorEditableSetting` gained `scale`, `maxValue` and `step` (5.20.0).
+- Volume Profile now spreads each bar's volume across its full high/low range instead of placing it all at the close. Several indicator math fixes (Williams %R, Momentum, RSI, Moving Average Cross defaults, Commodity Channel Index) landed in 5.19.0–5.20.0 — see `references/stock.md`.
+
+*All entities*
+- `onDebounced(key, cb, delay)` / `offDebounced(key, cb?)` and `onPrivateDebounced` / `offDebouncedPrivate` (5.17.3) — fire once after rapid changes settle.
 - `Label`: `fontFamily: "inherit"` (5.17.3) uses the chart container's computed font.
-- `MapSankeySeries` (5.17.0) — Sankey overlaid on a map; auto-resolves `sourceId`/`targetId` once `polygonSeries` geoJSON loads (5.17.1), so no `datavalidated` wrapper needed. See `references/map.md`.
-- `MapPointSeries` defaults changed to `longitudeField: "longitude"`, `latitudeField: "latitude"` (5.16.1).
 
 ## Verify unfamiliar API before using it
 

package/content/map.md

@@ -166,7 +166,9 @@ pointSeries.bullets.push(function() {
   });
 });
 
-// Add points via data — requires latitudeField/longitudeField on the series
+// Add points via data. Fields named "latitude"/"longitude" are the series
+// defaults since 5.16.1; any other naming must be declared via
+// latitudeField/longitudeField or the points silently won't render.
 pointSeries.data.setAll([
   { latitude: 48.8566, longitude: 2.3522, name: "Paris" },
   { latitude: 40.7128, longitude: -74.0060, name: "New York" },

package/content/stock.md

@@ -185,7 +185,10 @@ stockChart.indicators.push(am5stock.MovingAverage.new(root, {
   stockSeries: valueSeries,
   legend: legend,
   period: 20,
-  type: "simple"  // "simple", "weighted", "exponential", "dema", "tema"
+  maType: "simple"  // "simple", "weighted", "exponential", "dema", "tema"
+                    // NOTE: `type` was renamed to `maType` in 5.18.0 — `type` still
+                    // works but is deprecated. Same for MovingAverageDeviation,
+                    // MovingAverageEnvelope and BollingerBands.
 }));
 
 // RSI (creates its own panel)
@@ -244,6 +247,43 @@ stockChart.indicators.push(am5stock.Volume.new(root, {
 
 All classes are under `am5stock.*` (e.g., `am5stock.BollingerBands`).
 
+### Indicator changes in 5.19.0–5.20.0
+
+Several indicators changed behavior. If you have hardcoded expectations or saved settings, re-check them:
+
+| Indicator | Change | Version |
+|-----------|--------|---------|
+| `VolumeProfile` | Each bar's volume is now distributed across the full high/low range it traded, instead of being placed entirely at the closing price. Also no longer errors in `ticks` count mode when the visible price range is flat. | 5.20.0 |
+| `MACross` | Default fast/slow periods were inverted; defaults are now `fastPeriod: 9`, `period: 21`. | 5.20.0 |
+| `WilliamsR` | Used a `period + 1` lookback and treated a missing high/low as `0`; now uses exactly `period` bars. | 5.20.0 |
+| `Momentum` | Skipped its first computable value; now plots from `period` bars onward. | 5.20.0 |
+| `RelativeStrengthIndex` | Returned `0` (max "oversold") for a perfectly flat market; now returns a neutral `50`. | 5.20.0 |
+| `AccelerationBands` | `factor` now displays as the conventional `1` instead of `0.001` in both the settings modal and the legend; upper/lower bands were swapped so `upperColor`/`lowerColor` apply correctly. | 5.20.0–5.20.1 |
+| `CommodityChannelIndex` | Typical price was computed as `(high + low + close) / 2` instead of `/ 3`, inflating values. | 5.19.0 |
+
+All indicators now enforce min/max limits on their numeric settings, so extreme values entered in the settings modal can no longer freeze the page (e.g. a Volume Profile row count of 24,000).
+
+### Custom indicator editable settings (5.20.0)
+
+`IIndicatorEditableSetting` gained three properties for the settings modal:
+
+```js
+_editableSettings: [{
+  key: "period",
+  name: "Period",
+  type: "number",
+  minValue: 1,
+  maxValue: 200,   // 5.20.0 — upper bound enforced by the input
+  step: 1          // 5.20.0 — step; a step of 1 also marks the value as an integer
+}, {
+  key: "factor",
+  name: "Factor",
+  type: "number",
+  scale: 1000      // 5.20.0 — display multiplier for the modal ONLY:
+                   // shown value = stored × scale, divided back on save
+}]
+```
+
 ## Data format
 
 ```js

package/content/wordcloud.md

@@ -57,15 +57,27 @@ series.appear(1000);
 |---------|------|---------|-------------|
 | `categoryField` | string | — | Data field for word text (required) |
 | `valueField` | string | — | Data field for word weight/size (required) |
-| `maxFontSize` | number \| Percent | `100` | Maximum font size (a `Percent` is relative to the smaller chart dimension) |
-| `minFontSize` | number \| Percent | `10` | Minimum font size (a `Percent` is relative to the smaller chart dimension) |
-| `angles` | number[] | `[0]` | Allowed rotation angles for words |
+| `maxFontSize` | number \| Percent | `am5.percent(15)` | Maximum font size (a `Percent` is relative to the smaller chart dimension) |
+| `minFontSize` | number \| Percent | `am5.percent(2)` | Minimum font size (a `Percent` is relative to the smaller chart dimension) |
+| `angles` | number[] | `[0, -90]` | Allowed rotation angles for words. **Any angle works** as of 5.20.1 (e.g. `[0, -30, -45]`), not just `0`/`±90` as in earlier versions |
+| `randomizeAngles` | boolean | `true` | `true` = each word picks a random angle from `angles`. `false` = words cycle through `angles` in order (word 0 → `angles[0]`, …) which, with `randomness: 0`, makes the layout reproducible. *(5.20.1)* |
 | `randomness` | number (0–1) | `0` | Layout randomness (0 = ordered by value, 1 = fully random) |
+| `allowNesting` | boolean | `true` | `true` = small words tuck into the concavities of bigger ones (tight packing, bounding boxes may overlap). `false` = whole bounding boxes are packed so they never overlap — use this when labels have an opaque `background`. *(5.20.1)* |
 | `minWordLength` | number | `1` | Skip words shorter than this |
+| `minValue` | number | — | Skip words occurring fewer times than this |
 | `maxCount` | number | — | Maximum number of words to display |
 | `excludeWords` | string[] | `[]` | Words to exclude |
 | `text` | string | — | Raw text to parse — words are extracted and weighted by frequency automatically |
 | `colors` | ColorSet | — | Color set for words |
+| `fillField` | string | — | Data field holding a per-word label fill color |
+| `autoFit` | boolean | `true` | Scale font sizes down so all words fit the available area |
+| `step` | number | `15` | Step size used when searching for the next word placement |
+| `svgPath` | string | — | Arrange words to fill this SVG path shape (experimental) *(5.20.1)* |
+| `maskByShape` | boolean | `false` | Clip words to the `svgPath` outline for a crisp silhouette. Requires `svgPath`. *(5.20.1)* |
+| `shapeTolerance` | number | `0` | Extra pixels a word may spill past the `svgPath` outline; negative pulls words inside, creating padding. Requires `svgPath`. *(5.20.1)* |
+| `animationDuration` | number | — | Duration of word animation on chart resize |
+| `sequencedInterpolation` | boolean | `true` | Stagger the word reveal instead of showing all at once |
+| `sequencedDelay` | number | `15` | Milliseconds between words when `sequencedInterpolation` is on |
 
 ### excludeWords example
 
@@ -77,7 +89,81 @@ am5wc.WordCloud.new(root, {
 });
 ```
 
-**Note:** amCharts WordCloud does not support mask/shape rendering (words constrained to a custom shape). Words are arranged in a rectangular area.
+## Shaped word clouds — `svgPath` (5.20.1)
+
+Words can be arranged to fill an arbitrary shape. The path is scaled proportionally to fit the plot area.
+
+```js
+var series = root.container.children.push(
+  am5wc.WordCloud.new(root, {
+    categoryField: "tag",
+    valueField: "weight",
+    svgPath: "M10,30 A20,20 0,0,1 50,30 A20,20 0,0,1 90,30 Q90,60 50,90 Q10,60 10,30 z", // heart
+    maskByShape: true,     // clip letters that overhang the outline
+    shapeTolerance: -4,    // negative = padding inside the shape
+    angles: [0],           // simple shapes fill better with fewer angles
+    minFontSize: am5.percent(2),
+    maxFontSize: am5.percent(12)
+  })
+);
+```
+
+The shape outline itself is drawn behind the words as `series.shape` (a `Graphics`), by default a faint 10%-opacity silhouette. Style or hide it:
+
+```js
+series.shape.setAll({ fill: am5.color(0xff3366), fillOpacity: 0.08 });
+series.shape.set("fillOpacity", 0);      // no visible silhouette, words only
+```
+
+Style `fill`/`stroke` only — the series manages the shape's geometry (`svgPath`, `scale`, `x`, `y`) and its `forceHidden` flag, so setting those is pointless. To hide the silhouette use `fillOpacity: 0`.
+
+**Caveats:** this is an experimental feature and the fit is approximate. Favor simple, bold shapes over thin or highly concave ones, and tune `shapeTolerance`, `maskByShape`, `angles`, `minFontSize`/`maxFontSize` per shape. `shapeTolerance` affects placement only — the drawn outline never moves.
+
+## Diagonal angles (5.20.1)
+
+Before 5.20.1 only `0`, `90` and `-90` were handled. The layout rewrite rasterizes each word and its collision mask at the word's actual angle, so arbitrary angles now work — and neighbors pack into the corners of a rotated word's footprint instead of reserving its full axis-aligned bounding box.
+
+```js
+am5wc.WordCloud.new(root, {
+  categoryField: "tag",
+  valueField: "weight",
+  angles: [0, -30, -45, -60, -90]
+});
+```
+
+One caveat: if a word comes out very wide relative to the available area, the layout flips it to `0` or `±90` for a better fit — but only when that value is present in your `angles` array. Leave them out and your angles are used as given.
+
+## Reproducible layouts
+
+By default word placement is randomized, so the cloud looks different on every render. For a stable layout:
+
+```js
+am5wc.WordCloud.new(root, {
+  categoryField: "tag",
+  valueField: "weight",
+  randomness: 0,           // order strictly by value
+  randomizeAngles: false   // cycle `angles` in order instead of picking randomly
+});
+```
+
+## Labels with opaque backgrounds
+
+Nesting lets small words sit inside the gaps of larger ones, which looks wrong once labels have a solid background — the background rectangles slide over neighbors. Turn nesting off so whole bounding boxes are packed:
+
+```js
+series.set("allowNesting", false);
+series.labels.template.setAll({
+  background: am5.RoundedRectangle.new(root, { fill: am5.color(0x1f2933), fillOpacity: 1 })
+});
+```
+
+## Breaking change in 5.20.1
+
+The layout is now computed synchronously in a single pass instead of one word per animation frame — much faster for large clouds. Consequences for existing code:
+
+- The per-data-item `ghostLabel` no longer exists — `dataItem.get("ghostLabel")` returns `undefined`.
+- Labels are held in an internal container, so code walking `series.children` to find labels breaks. Use `series.labels` (the `ListTemplate`) or `dataItem.get("label")`.
+- The reveal is staggered via `sequencedInterpolation`/`sequencedDelay` (defaults `true` / `15`ms) rather than by the layout itself.
 
 ## Customizing labels
 

package/content/xy.md

@@ -382,6 +382,17 @@ chart.set("cursor", am5xy.XYCursor.new(root, { snapToSeries: [series] }));
 
 **Do NOT** pass `lineX`/`lineY` as constructor options to `XYCursor.new()`. Always access `cursor.lineX` / `cursor.lineY` after creation.
 
+**Easier edge selections (`clickTolerance`, 5.20.0)** — by default a zoom/select drag can only begin inside the plot area, which makes selecting right up to an edge fiddly. `clickTolerance` widens the area where a press may *start*:
+
+```js
+chart.set("cursor", am5xy.XYCursor.new(root, {
+  behavior: "selectX",
+  clickTolerance: 20    // px outside the plot area where a drag may start (default 0)
+}));
+```
+
+The selection itself still starts at the plot edge — the press point is clamped into the plot area.
+
 For timeline charts, use `am5timeline.CurveCursor` instead — see `references/timeline.md`.
 
 ## Scrollbar
@@ -675,6 +686,45 @@ am5xy.XYChart.new(root, {
 })
 ```
 
+## Distinguishing line series without color (5.20.0)
+
+`XYChart` can cycle stroke widths and dash patterns across line series as they are added, exactly the way `colors` cycles series colors. Useful for print, for color-blind-safe output, or with the `Patterns` theme.
+
+```js
+const chart = root.container.children.push(am5xy.XYChart.new(root, {
+  strokeWidths: [3, 2, 2],                    // px, cycled per line series
+  strokeDasharrays: [0, [6, 3], [2, 2]]       // 0 or [] = solid line
+}));
+```
+
+Each added line series takes the next entry by position, wrapping around when the array runs out.
+
+## Series gradients (5.20.0)
+
+`Series` accepts `fillGradient` and `strokeGradient`:
+
+```js
+series.set("fillGradient", am5.LinearGradient.new(root, {
+  stops: [{ opacity: 0.6 }, { opacity: 0 }],
+  rotation: 90
+}));
+```
+
+A bullet `Graphics` that sets none of `fill`, `fillGradient`, `fillPattern`, `stroke`, `strokeGradient` now inherits all of them from its series, so bullets pick up series gradients and patterns automatically.
+
+## Changing fields and axes after creation (5.20.0)
+
+```js
+// Swap which data field a series plots — then re-set the data
+series.set("valueYField", "profit");
+series.data.setAll(data);
+
+// Move a series to a different axis
+series.set("yAxis", secondaryYAxis);
+```
+
+Both were previously fixed at creation time. Re-setting the series data is required for a value-field change to take effect.
+
 ---
 
 # amCharts 5 XY Charts — Working Examples

package/extended/charts/word-cloud.md

@@ -2,6 +2,8 @@
 title: "Word cloud"
 source: "https://www.amcharts.com/docs/v5/charts/word-cloud/"
 scraped: "2026-03-15"
+updated: "2026-08-05"
+updatedFor: "@amcharts/amcharts5@5.20.1"
 ---
 
 [Word clouds](https://en.wikipedia.org/wiki/Tag_cloud) (or tag clouds) help visualize weight or importance of individual words from a keyword list or a free-form text.
@@ -247,13 +249,27 @@ Series setting responsible for identifying possible angles is named `angles`.
 
 It's an array of numbers, and the default is `[0, -90]` meaning that words can come at zero (horizontal) or 90 (vertical) angle.
 
-The only supported values are `0`, `90`, and `-90`.
-
 To make all words horizontal, set it to `[0]`. To make all vertical, use `[90]`.
 
+**Any angle is supported as of 5.20.1.** Earlier versions only handled `0`, `90` and `-90`; the layout rewrite in 5.20.1 rasterizes each word and its collision mask at the word's actual angle, so diagonal values work and neighboring words pack into the corners of a rotated word's footprint rather than reserving its full axis-aligned bounding box.
+
+```javascript
+am5wc.WordCloud.new(root, {
+  categoryField: "tag",
+  valueField: "weight",
+  angles: [0, -30, -45, -60, -90]   // arbitrary angles, not just 0/±90
+});
+```
+
+NOTE There is one place where `0` and `±90` still get special treatment: if a word comes out very wide relative to the available area, the layout will flip it to `0` or `±90` for a better fit — but only if that value is present in your `angles` array. Omit them and your angles are used as given.
+
+#### Choosing angles
+
+`randomizeAngles` (default `true`) picks a random entry from `angles` for each word. Set it to `false` to cycle through `angles` in order — combined with `randomness: 0` this produces a reproducible layout.
+
 #### Rotating whole series
 
-Even though non-horizontal/vertical angles are not supported, the whole series can easily be rotated to achieve intermediate angle effect by `rotation` and relative centering settings to the series itself.
+Instead of (or in addition to) rotating individual words, the whole series can be rotated using `rotation` and relative centering settings on the series itself.
 
 let series = root.container.children.push(
   am5wc.WordCloud.new(root, {

package/extended/concepts/colors-gradients-and-patterns/patterns.md

@@ -2,6 +2,8 @@
 title: "Patterns"
 source: "https://www.amcharts.com/docs/v5/concepts/colors-gradients-and-patterns/patterns/"
 scraped: "2026-03-15"
+updated: "2026-08-05"
+updatedFor: "@amcharts/amcharts5@5.20.1"
 ---
 
 This tutorial looks at how we can create patterns to use for element fills ant outlines.
@@ -43,8 +45,57 @@ Example
 
 `[PathPattern](https://www.amcharts.com/docs/v5/reference/pathpattern/)`
 
+`[StarPattern](https://www.amcharts.com/docs/v5/reference/starpattern/)` (5.20.0)
+
+`[TrianglePattern](https://www.amcharts.com/docs/v5/reference/trianglepattern/)` (5.20.0)
+
 Patterns can be customized by applying rotation, gap, stroke, and other settings, which we'll explore in a bit.
 
+### Star and triangle patterns (5.20.0)
+
+`StarPattern` and `TrianglePattern` work like `RectanglePattern`/`CirclePattern` — a grid of shapes with a `gap` between them, and an optional `checkered` mode that places only every second shape.
+
+```javascript
+columnSeries.columns.template.set("fillPattern", am5.StarPattern.new(root, {
+  color: am5.color(0xffffff),
+  radius: 5,               // outer radius of the star, in pixels. Default: 5
+  innerRadius: am5.percent(50), // inner radius: pixels or a percent of `radius`. Default: 50%
+  spikes: 5,               // number of spikes. Default: 5
+  gap: 6,                  // gap between stars, in pixels. Default: 6
+  checkered: false,        // place every second star. Default: false
+  centered: true           // center stars in their grid cell. Default: true
+}));
+
+columnSeries.columns.template.set("fillPattern", am5.TrianglePattern.new(root, {
+  color: am5.color(0xffffff),
+  maxWidth: 8,             // width of the triangle, in pixels. Default: 8
+  maxHeight: 8,            // height of the triangle, in pixels. Default: 8
+  gap: 6,                  // gap between triangles, in pixels. Default: 6
+  checkered: false,
+  centered: true
+}));
+```
+
+### `rotateShapes` (5.20.0)
+
+`RectanglePattern`, `StarPattern` and `TrianglePattern` accept a `rotateShapes` setting (default `false`).
+
+When `false`, `rotation` rotates the whole pattern grid. That does not tile periodically on an axis-aligned tile, so you usually have to enlarge `width`/`height` and tweak `gap` to avoid seams — expensive on large tiles.
+
+When `true`, `rotation` instead rotates **each shape around its own center** while the grid stays axis-aligned. This tiles seamlessly (a small `width`/`height` is enough) and is significantly faster.
+
+```javascript
+columnSeries.columns.template.set("fillPattern", am5.RectanglePattern.new(root, {
+  color: am5.color(0xffffff),
+  rotation: 45,
+  rotateShapes: true    // rotate each rectangle, not the whole grid
+}));
+```
+
+NOTE Star, triangle, rectangle and circle patterns normalize an oversized `width`/`height` down to a single repeat cell (2×2 cells when `checkered`), since the grid repeats every cell anyway. This optimization is skipped when a whole-pattern `rotation` is set — another reason to prefer `rotateShapes`.
+
+NOTE As of 5.20.0, `PathPattern` repeats its `svgPath` as a grid itself instead of drawing once and letting the rendering engine repeat it.
+
 ## Setting pattern
 
 To set a pattern fill on an element, we need to assign it to element's `fillPattern` setting.
@@ -243,6 +294,8 @@ For more configuration options, visit following class references:
 -   [`RectanglePattern` settings](https://www.amcharts.com/docs/v5/reference/linepattern/#Settings)
 -   [`CirclePattern` settings](https://www.amcharts.com/docs/v5/reference/linepattern/#Settings)
 -   [`PathPattern` settings](https://www.amcharts.com/docs/v5/reference/pathpattern/#Settings)
+-   [`StarPattern` settings](https://www.amcharts.com/docs/v5/reference/starpattern/#Settings)
+-   [`TrianglePattern` settings](https://www.amcharts.com/docs/v5/reference/trianglepattern/#Settings)
 
 ## Examples
 

package/extended/concepts/events.md

@@ -2,6 +2,8 @@
 title: "Events"
 source: "https://www.amcharts.com/docs/v5/concepts/events/"
 scraped: "2026-03-15"
+updated: "2026-08-05"
+updatedFor: "@amcharts/amcharts5@5.20.1"
 ---
 
 ## User interactions
@@ -82,6 +84,22 @@ For example, a Scrollbar might invoke a `rangechanged` event when its selection
 
 For a complete list of element's events, see "Events" section in its class reference. Here's a [link](https://www.amcharts.com/docs/v5/reference/scrollbar/#Events) to `Scrollbar` events as an example.
 
+## Global pointer events
+
+Regular pointer events like `pointerdown` fire only when the pointer is over the element itself. The "global" variants fire on **every** element for a pointer action anywhere on the chart surface, which is what you need for drag-style interactions that must keep tracking once the pointer leaves the element.
+
+Available on all elements:
+
+-   `globalpointermove`
+-   `globalpointerup`
+-   `globalpointerdown` — added in 5.20.0
+
+```javascript
+series.columns.template.events.on("globalpointerdown", function(ev) {
+  // fires on a press anywhere on the chart surface
+});
+```
+
 ## Debounced events
 
 Starting with version `5.14`, we can create debounced events, i.e. ensuring that event handler will be invoked only once during specific timeframe.

package/extended/concepts/themes.md

@@ -2,6 +2,8 @@
 title: "Themes"
 source: "https://www.amcharts.com/docs/v5/concepts/themes/"
 scraped: "2026-03-15"
+updated: "2026-08-05"
+updatedFor: "@amcharts/amcharts5@5.20.1"
 ---
 
 Themes can be used to apply a collection of settings to chart's elements easily, with a a single line of code.
@@ -62,6 +64,95 @@ A theme that can be used to enable responsive features of the chart - adapting s
 
 A theme that adds alternative default colors.
 
+## Themes added in 5.20.0
+
+The list above is the pre-5.20 set. Version 5.20.0 added a large batch of palette themes, dark variants, and two parameterized themes. All live in `/themes` and load exactly like the others.
+
+### New palette themes
+
+Theme name
+
+Comment
+
+`Colorblind`
+
+A color-blindness-safe palette based on the Okabe-Ito color set.
+
+`Ember`
+
+A warm, fire-oriented palette.
+
+`Midnight`
+
+A dark theme.
+
+`Nord`
+
+A palette based on the Nord color scheme.
+
+`Pastel`
+
+A soft, low-saturation palette.
+
+`Patterns`
+
+Uses pattern fills instead of flat colors — useful for print, monochrome output, and accessibility.
+
+`Petroleum`
+
+A deep blue-green palette.
+
+`Savanna`
+
+A warm, earthy palette.
+
+### New dark variants
+
+Dark counterparts were added for most palette themes: `ColorblindDark`, `DatavizDark`, `FrozenDark`, `KellyDark`, `MaterialDark`, `MoonriseDark`, `NordDark`, `PastelDark`, `PatternsDark`, `SpiritedDark`.
+
+Each already carries dark background and interface colors, so you should NOT additionally apply the `Dark` theme when using one.
+
+### Parameterized themes: `Monochrome` and `Adaptive`
+
+These two themes generate their palette from colors you supply, using OKLCH so the result stays perceptually balanced (even lightness/chroma, evenly spread hues). Because a theme cannot take constructor parameters, they ship as **factory functions** — call them with `(root, settings)`. A `.new(root, settings)` alias also works.
+
+Both are additive: they do not modify any built-in theme.
+
+`Monochrome` — a single-hue lightness ramp:
+
+```javascript
+import am5themes_Monochrome from "@amcharts/amcharts5/themes/Monochrome";
+
+root.setThemes([
+  am5themes_Animated.new(root),
+  am5themes_Monochrome(root, {
+    color: 0x2c6e91,    // base color of the ramp; hex number, CSS string, or Color. Default: #2e7c9e (blue)
+    accent: 0xff7f0e,   // optional: applied to the FIRST series only, so one series stands out
+    count: 7,           // number of steps in the ramp. Default: 7
+    dark: false         // true = dark background + interface colors, ramp runs light-to-mid. Default: false
+  })
+]);
+```
+
+`Adaptive` — a full palette generated from one or two base colors:
+
+```javascript
+import am5themes_Adaptive from "@amcharts/amcharts5/themes/Adaptive";
+
+root.setThemes([
+  am5themes_Animated.new(root),
+  am5themes_Adaptive(root, {
+    baseColor: 0x2c6e91,   // primary base color. The FIRST generated color is this color,
+                           // so a brand color always appears in the chart.
+                           // Default: green-to-yellow (#4b8e39 first, #ffdd00 last)
+    baseColor2: 0xffdd00,  // optional: palette spans the two colors, interpolated in OKLCH,
+                           // instead of fanning out from a single hue
+    count: 10,             // number of series colors to generate. Default: 10
+    dark: false            // true = faintly base-tinted dark background + matching interface colors
+  })
+]);
+```
+
 ## Applying
 
 Each chart can have multiple themes applied to it.

package/extended/reference/irectanglepatternsettings.md

@@ -55,3 +55,4 @@ Extends: IPatternSettings
 - **gap** (`undefined | number`) — Default 6 Gap between rectangles, in pixels.
 - **maxHeight** (`undefined | number`) — Default 5 Maximum height of the rectangle, in pixels.
 - **maxWidth** (`undefined | number`) — Default 5 Maximum width of the rectangle, in pixels.
+- **rotateShapes** (`undefined | false | true`) — Default false *(since 5.20.0)* If set to true, rotation rotates each rectangle around its own center while the grid/tile stays axis-aligned, instead of rotating the whole pattern. This tiles seamlessly (a small width/height is enough) and is much faster than rotating the whole pattern on large tiles.

package/extended/reference/iseriessettings.md

@@ -76,7 +76,9 @@ Extended by: IFlowSettings, IFlowNodesSettings, IPercentSeriesSettings, ILegendS
 - **customValueField** (`undefined | string`) — A key to look up in data for a numeric customValue of the data item. Usually used for storing additional numeric information and heat rules.
 - **excludeFromAggregate** (`Array`) — A list of field names to exclude from automatic aggregation when calculateAggregates is enabled. Use it to optimize performance by disabling automatic aggregation for data fields where aggregate values are not needed. @since 5.14.4
 - **fill** (`Color`) — Series fill color. Click here for more info
+- **fillGradient** (`Gradient`) — *(since 5.20.0)* Series fill gradient.
 - **fillPattern** (`Pattern`) — Series fill pattern. Click here for more info @since 5.10.0
+- **strokeGradient** (`Gradient`) — *(since 5.20.0)* Series stroke gradient.
 - **heatRules** (`IHeatRule[]`) — A list of heat rules to apply on series elements. Click here for more info
 - **idField** (`undefined | string`) — A key to look up in data for an id of the data item.
 - **legendDataItem** (`DataItem`) — A data item representing series in a Legend. @readonly

package/extended/reference/istarpatternsettings.md

@@ -0,0 +1,38 @@
+---
+title: "IStarPatternSettings"
+type: "interface"
+source: "https://www.amcharts.com/docs/v5/reference/istarpatternsettings/"
+generatedFrom: "@amcharts/amcharts5@5.20.1"
+---
+
+Settings for `StarPattern` (added in 5.20.0).
+
+## Inheritance
+
+Extends: IPatternSettings
+
+> **Note:** This interface also inherits all settings from IPatternSettings (and its ancestors). Use `get_doc` or `get_core_reference` with the parent interface name to see inherited members.
+
+## Properties
+
+- **centered** (`undefined | false | true`) — Default true Center stars in their grid cell.
+- **checkered** (`undefined | false | true`) — Default false If set to true, will place every second star, creating a checkered pattern.
+- **gap** (`undefined | number`) — Default 6 Gap between stars, in pixels.
+- **innerRadius** (`undefined | number | Percent`) — Default 50% Inner radius of the star. Either an absolute pixel value or a percent of radius.
+- **radius** (`undefined | number`) — Default 5 Outer radius of the star, in pixels.
+- **rotateShapes** (`undefined | false | true`) — Default false If set to true, rotation rotates each star around its own center while the grid/tile stays axis-aligned, instead of rotating the whole pattern. This tiles seamlessly (a small width/height is enough) and is much faster than rotating the whole pattern on large tiles.
+- **spikes** (`undefined | number`) — Default 5 Number of spikes.
+
+### Inherited from IPatternSettings
+
+- **color** (`Color`) — Color of the pattern shape.
+- **colorOpacity** (`undefined | number`) — Opacity of the pattern shape.
+- **fill** (`Color`) — Color to fill gaps between pattern shapes.
+- **fillOpacity** (`undefined | number`) — Opacity of the fill for gaps between pattern shapes.
+- **height** (`undefined | number`) — Height of the pattern tile, in pixels.
+- **repetition** (`"repeat" | "repeat-x" | "repeat-y" | "no-repeat"`) — How pattern tiles are repeated when filling the area.
+- **rotation** (`undefined | number`) — Default 0 Rotation of pattern in degrees. Supported values: -90 to 90. See also `rotateShapes`.
+- **strokeDasharray** (`number[] | number`) — Stroke (border or line) dash settings.
+- **strokeDashoffset** (`undefined | number`) — Stroke (border or line) dash offset.
+- **strokeWidth** (`undefined | number`) — Default 1 Width of the pattern's line elements.
+- **width** (`undefined | number`) — Width of the pattern tile, in pixels.

package/extended/reference/itrianglepatternsettings.md

@@ -0,0 +1,37 @@
+---
+title: "ITrianglePatternSettings"
+type: "interface"
+source: "https://www.amcharts.com/docs/v5/reference/itrianglepatternsettings/"
+generatedFrom: "@amcharts/amcharts5@5.20.1"
+---
+
+Settings for `TrianglePattern` (added in 5.20.0).
+
+## Inheritance
+
+Extends: IPatternSettings
+
+> **Note:** This interface also inherits all settings from IPatternSettings (and its ancestors). Use `get_doc` or `get_core_reference` with the parent interface name to see inherited members.
+
+## Properties
+
+- **centered** (`undefined | false | true`) — Default true Center triangles in their grid cell.
+- **checkered** (`undefined | false | true`) — Default false If set to true, will place every second triangle, creating a checkered pattern.
+- **gap** (`undefined | number`) — Default 6 Gap between triangles, in pixels.
+- **maxHeight** (`undefined | number`) — Default 8 Height of the triangle, in pixels.
+- **maxWidth** (`undefined | number`) — Default 8 Width of the triangle, in pixels.
+- **rotateShapes** (`undefined | false | true`) — Default false If set to true, rotation rotates each triangle around its own center while the grid/tile stays axis-aligned, instead of rotating the whole pattern. This tiles seamlessly (a small width/height is enough) and is much faster than rotating the whole pattern on large tiles.
+
+### Inherited from IPatternSettings
+
+- **color** (`Color`) — Color of the pattern shape.
+- **colorOpacity** (`undefined | number`) — Opacity of the pattern shape.
+- **fill** (`Color`) — Color to fill gaps between pattern shapes.
+- **fillOpacity** (`undefined | number`) — Opacity of the fill for gaps between pattern shapes.
+- **height** (`undefined | number`) — Height of the pattern tile, in pixels.
+- **repetition** (`"repeat" | "repeat-x" | "repeat-y" | "no-repeat"`) — How pattern tiles are repeated when filling the area.
+- **rotation** (`undefined | number`) — Default 0 Rotation of pattern in degrees. Supported values: -90 to 90. See also `rotateShapes`.
+- **strokeDasharray** (`number[] | number`) — Stroke (border or line) dash settings.
+- **strokeDashoffset** (`undefined | number`) — Stroke (border or line) dash offset.
+- **strokeWidth** (`undefined | number`) — Default 1 Width of the pattern's line elements.
+- **width** (`undefined | number`) — Width of the pattern tile, in pixels.

package/extended/reference/iwordcloudsettings.md

@@ -57,20 +57,36 @@ Extends: ISeriesSettings
 
 ## Properties
 
-- **angles** (`number[]`) — An array of possible rotation angles for words.
+- **allowNesting** (`undefined | false | true`) — Default true *(since 5.20.1)* Whether words may nest into each other's empty space. When true a word is packed against its neighbors' letters, so small words tuck into the concavities of bigger ones and the cloud packs tightly — but bounding boxes may overlap. Set to false to pack whole bounding boxes instead, so they never overlap (useful when labels have an opaque background, whose rectangles would otherwise slide into a neighbor's gaps).
+- **angles** (`number[]`) — Default [0, -90] An array of possible rotation angles for words. As of 5.20.1 any angle is supported (e.g. [0, -30, -45]); earlier versions only handled 0, 90 and -90. Note that an overly wide word may still be flipped to 0 or ±90 for a better fit, but only if that value is present in the array.
 - **animationDuration** (`undefined | number`) — Duration of word animation when chart resizes.
 - **animationEasing** (`undefined | ( t: Time) => Time`) — Default am5.ease.out($ease.cubic) An easing function to use for word animations. Click here for more info
-- **autoFit** (`undefined | false | true`) — Default false
+- **autoFit** (`undefined | false | true`) — Default true (set by WordCloudDefaultTheme; the typings' @default false is stale) Indicates whether font sizes are scaled down so all words fit the available area.
 - **categoryField** (`undefined | string`) — A field in data that holds category names.
 - **colors** (`ColorSet`) — A ColorSet to use when asigning colors for slices.
-- **excludeWords** (`Array`) — Array of words exclude from cloud.
+- **excludeWords** (`Array`) — Default [] Array of words exclude from cloud.
 - **fillField** (`undefined | string`) — A field that holds color for label fill.
+- **maskByShape** (`undefined | false | true`) — Default false *(since 5.20.1)* If set to true, words are clipped to the svgPath shape, so the parts of letters that overhang the outline (see shapeTolerance) are cut off at the edge for a crisp silhouette. Requires svgPath.
 - **maxCount** (`undefined | number`) — Maximum number of words to show.
-- **maxFontSize** (`number | Percent`) — Absolute or relative font size for the biggest words.
-- **minFontSize** (`number | Percent`) — Absolute or relative font size for the smallest words.
+- **maxFontSize** (`number | Percent`) — Default 15% Absolute or relative font size for the biggest words.
+- **minFontSize** (`number | Percent`) — Default 2% Absolute or relative font size for the smallest words.
 - **minValue** (`undefined | number`) — Minimum occurances for a word to be included into cloud.
-- **minWordLength** (`undefined | number`) — Minimum number of characters for a word to be included in the cloud.
+- **minWordLength** (`undefined | number`) — Default 1 Minimum number of characters for a word to be included in the cloud.
 - **progress** (`undefined | number`) — Progress of current word layout animation. (0-1) @readonly
-- **randomness** (`undefined | number`) — Randomness of word placement (0-1).
-- **step** (`undefined | number`) — Step for next word placement.
+- **randomizeAngles** (`undefined | false | true`) — Default true *(since 5.20.1)* How a word's rotation is chosen from angles. When true each word picks a random angle from angles, so the cloud looks different on every layout. When false words cycle through angles in order (word 0 gets angles[0], word 1 angles[1], and so on), which — together with randomness: 0 — makes the layout reproducible.
+- **randomness** (`undefined | number`) — Default 0 Randomness of word placement (0-1).
+- **shapeTolerance** (`undefined | number`) — Default 0 *(since 5.20.1)* Extra distance (in pixels) a word may extend past the svgPath outline, on top of the automatic per-word overhang (a fraction of each word's own size). Can also be negative to pull words further inside the outline, creating visual padding between the words and the shape edge. Only affects placement — the drawn shape outline is unchanged. Requires svgPath.
+- **step** (`undefined | number`) — Default 15 Step for next word placement.
+- **svgPath** (`undefined | string`) — *(since 5.20.1)* Experimental: if set, words are arranged to fill this shape. The path is scaled proportionally to fit the plot area. The fit is approximate — favor simple, bold shapes over complex, thin, or highly concave ones, and tune shapeTolerance, maskByShape, angles (and minFontSize/maxFontSize) to get a better fill for a particular shape.
 - **text** (`undefined | string`) — Source text from which words are extracted.
+
+### Inherited from ISeriesSettings (notable for WordCloud)
+
+- **sequencedInterpolation** (`undefined | false | true`) — Default true (set by WordCloudDefaultTheme) Staggers the word reveal instead of showing all words at once.
+- **sequencedDelay** (`undefined | number`) — Default 15 Milliseconds between words when sequencedInterpolation is enabled.
+
+## Breaking change in 5.20.1
+
+The WordCloud layout is now computed synchronously in a single pass instead of one word per animation frame — much faster for large clouds. The per-data-item `ghostLabel` is removed and labels are held in an internal container, so code reading `dataItem.get("ghostLabel")` or walking `series.children` for labels needs updating. Use `series.labels` (a `ListTemplate<Label>`) or `dataItem.get("label")` instead.
+
+A `series.shape` (`Graphics`) element was added; it draws the `svgPath` outline behind the words. Its geometry and `forceHidden` are managed by the series — only `fill`/`stroke` styling is yours to set.

package/extended/reference/ixychartsettings.md

@@ -82,6 +82,8 @@ Extended by: IRadarChartSettings, IStockPanelSettings, ICurveChartSettings
 - **pinchZoomY** (`undefined | false | true`) — Default false If set to true, using pinch gesture on the chart's plot area will zoom chart vertically. NOTE: this setting is not supported in a RadarChart. Click here for more info @since 5.1.8
 - **scrollbarX** (`Scrollbar`) — horizontal scrollbar. Click here for more info
 - **scrollbarY** (`Scrollbar`) — Vertical scrollbar.
+- **strokeDasharrays** (`Array<number | Array<number>>`) — *(since 5.20.0)* A list of stroke dash arrays to cycle through for line series as they are added, the same way colors cycles series colors. Each entry is a strokeDasharray value (an array of dash/gap lengths, or a single number); 0 or an empty array is a solid line.
+- **strokeWidths** (`Array<number>`) — *(since 5.20.0)* A list of stroke widths (in pixels) to cycle through for line series as they are added, the same way colors cycles series colors. Each added line series is given the next width based on its position. Useful for telling line series apart without relying on color (e.g. the "Patterns" theme).
 - **wheelStep** (`undefined | number`) — Default 0.25 Indicates the relative "speed" of the mouse wheel.
 - **wheelX** (`"zoomX" | "zoomY" | "zoomXY" | "panX" | "panY" | "panXY" | "none"`) — Indicates what happens when mouse wheel is spinned horizontally while over plot area. Click here for more info
 - **wheelY** (`"zoomX" | "zoomY" | "zoomXY" | "panX" | "panY" | "panXY" | "none"`) — Indicates what happens when mouse wheel is spinned vertically while over plot area. Click here for more info

package/extended/reference/ixycursorsettings.md

@@ -85,6 +85,7 @@ Extended by: IRadarCursorSettings, ICurveCursorSettings
 
 - **alwaysShow** (`undefined | false | true`) — Default false If set to true, cursor will not be hidden when mouse cursor moves out of the plot area.
 - **behavior** (`"zoomX" | "zoomY" | "zoomXY" | "selectX" | "selectY" | "selectXY" | "none"`) — Default "none" What should cursor do when dragged across plot area. Click here for more info
+- **clickTolerance** (`undefined | number`) — Default 0 *(since 5.20.0)* How far (in pixels) outside the plot area a press can start and still begin a zoom/selection, when behavior is set to a zoom or select mode. Makes it easier to start selecting near the edges of the plot area. The selection still starts on the edge of the plot area (the press point is clamped into it). A value of 0 (default) disables this and keeps the original behavior: a selection can only start within the plot area.
 - **moveThreshold** (`undefined | number`) — Default 1 Minimum distance in pixels between down and up points. If a distance is less than the value of moveThreshold, the zoom or selection won't happen. @since 5.2.20
 - **positionX** (`undefined | number`) — Cursor's horizontal position relative to plot area. If this setting is set, cursor will not react to mouse/touch and will just sit at specified position until positionX is reset to undefined. 0 - left, 1 - right.
 - **positionY** (`undefined | number`) — Cursor's vertical position relative to plot area. If this setting is set, cursor will not react to mouse/touch and will just sit at specified position until positionY is reset to undefined. 0 - left, 1 - right.

package/extended/reference/starpattern.md

@@ -0,0 +1,51 @@
+---
+title: "StarPattern"
+type: "class"
+source: "https://www.amcharts.com/docs/v5/reference/starpattern/"
+generatedFrom: "@amcharts/amcharts5@5.20.1"
+---
+
+Star pattern. Draws a grid of stars, used as a `fillPattern` or `strokePattern` on any element.
+
+Added in 5.20.0.
+
+## Import
+
+```javascript
+// Import StarPattern
+import * as am5 from "@amcharts/amcharts5"
+```
+
+## Usage
+
+```javascript
+columnSeries.columns.template.set("fillPattern", am5.StarPattern.new(root, {
+  color: am5.color(0xffffff),
+  radius: 5,
+  innerRadius: am5.percent(50),
+  spikes: 5,
+  gap: 6
+}));
+```
+
+## Inheritance
+
+Extends: Pattern
+
+> **Note:** This class also inherits all settings, properties, methods, and events from Pattern (and its ancestors). Use `get_doc` or `get_core_reference` with the parent class name to see inherited members.
+
+## Settings
+
+- **centered** (`undefined | false | true`) — Default true Center stars in their grid cell.
+- **checkered** (`undefined | false | true`) — Default false If set to true, will place every second star, creating a checkered pattern.
+- **gap** (`undefined | number`) — Default 6 Gap between stars, in pixels.
+- **innerRadius** (`undefined | number | Percent`) — Default 50% Inner radius of the star. Either an absolute pixel value or a percent of radius.
+- **radius** (`undefined | number`) — Default 5 Outer radius of the star, in pixels.
+- **rotateShapes** (`undefined | false | true`) — Default false If set to true, rotation rotates each star around its own center while the grid/tile stays axis-aligned, instead of rotating the whole pattern. This tiles seamlessly (a small width/height is enough) and is much faster than rotating the whole pattern on large tiles.
+- **spikes** (`undefined | number`) — Default 5 Number of spikes.
+
+See `IStarPatternSettings` (`reference/istarpatternsettings`) for the full settings list including everything inherited from `IPatternSettings`.
+
+## Notes
+
+A star pattern's tile is only a repeat unit — the grid repeats every cell — so an oversized `width`/`height` just wastes memory and draw time for an identical result. The class normalizes the tile to a single cell (2x2 cells when `checkered`). This optimization is skipped for a whole-pattern `rotation` (which isn't periodic on an axis-aligned tile — use `rotateShapes` for that) and for non-`repeat` repetitions.

package/extended/reference/trianglepattern.md

@@ -0,0 +1,49 @@
+---
+title: "TrianglePattern"
+type: "class"
+source: "https://www.amcharts.com/docs/v5/reference/trianglepattern/"
+generatedFrom: "@amcharts/amcharts5@5.20.1"
+---
+
+Triangle pattern. Draws a grid of triangles, used as a `fillPattern` or `strokePattern` on any element.
+
+Added in 5.20.0.
+
+## Import
+
+```javascript
+// Import TrianglePattern
+import * as am5 from "@amcharts/amcharts5"
+```
+
+## Usage
+
+```javascript
+columnSeries.columns.template.set("fillPattern", am5.TrianglePattern.new(root, {
+  color: am5.color(0xffffff),
+  maxWidth: 8,
+  maxHeight: 8,
+  gap: 6
+}));
+```
+
+## Inheritance
+
+Extends: Pattern
+
+> **Note:** This class also inherits all settings, properties, methods, and events from Pattern (and its ancestors). Use `get_doc` or `get_core_reference` with the parent class name to see inherited members.
+
+## Settings
+
+- **centered** (`undefined | false | true`) — Default true Center triangles in their grid cell.
+- **checkered** (`undefined | false | true`) — Default false If set to true, will place every second triangle, creating a checkered pattern.
+- **gap** (`undefined | number`) — Default 6 Gap between triangles, in pixels.
+- **maxHeight** (`undefined | number`) — Default 8 Height of the triangle, in pixels.
+- **maxWidth** (`undefined | number`) — Default 8 Width of the triangle, in pixels.
+- **rotateShapes** (`undefined | false | true`) — Default false If set to true, rotation rotates each triangle around its own center while the grid/tile stays axis-aligned, instead of rotating the whole pattern. This tiles seamlessly (a small width/height is enough) and is much faster than rotating the whole pattern on large tiles.
+
+See `ITrianglePatternSettings` (`reference/itrianglepatternsettings`) for the full settings list including everything inherited from `IPatternSettings`.
+
+## Notes
+
+A triangle pattern's tile is only a repeat unit — the grid repeats every cell — so an oversized `width`/`height` just wastes memory and draw time for an identical result. The class normalizes the tile to a single cell (2x2 cells when `checkered`). This optimization is skipped for a whole-pattern `rotation` (which isn't periodic on an axis-aligned tile — use `rotateShapes` for that) and for non-`repeat` repetitions.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amcharts/amcharts5-mcp",
-  "version": "1.3.2",
+  "version": "1.4.0",
   "mcpName": "io.github.amcharts/amcharts5",
   "description": "On-demand access to amCharts 5 docs, code examples, and API reference",
   "type": "module",
@@ -12,6 +12,7 @@
     "src/",
     "content/",
     "extended/",
+    "!extended/reference-generated/",
     "README.md",
     "LICENSE"
   ],

package/src/content-fs.js

@@ -25,6 +25,14 @@ const REFERENCES_DIR = existsSync(join(SKILL_DIR, "references"))
   : SKILL_DIR;
 const EXTENDED_DIR = join(ROOT, "extended");
 
+// Directories under extended/ that must never be served. `reference-generated/`
+// is work-in-progress output from scripts/generate-reference.cjs: it duplicates
+// every page in reference/ under a second key, which makes search return each
+// class twice and advertises an unfinished section via get_doc. It is untracked,
+// but untracked does NOT mean unpublished — `files: ["extended/"]` packs from the
+// filesystem, so without this it also ships in the npm tarball.
+const EXTENDED_SKIP_DIRS = new Set(["reference-generated"]);
+
 /**
  * Read all skill + extended markdown into the raw { skillFiles, extendedFiles }
  * shape that buildContent() expects.
@@ -58,6 +66,8 @@ function walkExtended(dir, prefix, out) {
   for (const entry of readdirSync(dir, { withFileTypes: true })) {
     const fullPath = join(dir, entry.name);
     if (entry.isDirectory()) {
+      // Only skip at the top level — a nested dir of the same name is fine.
+      if (!prefix && EXTENDED_SKIP_DIRS.has(entry.name)) continue;
       walkExtended(fullPath, prefix ? `${prefix}/${entry.name}` : entry.name, out);
     } else if (entry.name.endsWith(".md")) {
       const key = prefix