@amcharts/amcharts5-mcp 1.3.2 → 1.5.0

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/irootsettings.md

@@ -43,3 +43,7 @@ If set to some string, it will be used as inner <div> ARIA-LABEL.
 - **role** (`undefined | string`) — Allows setting a "role" for the inner <div>. @since 5.3.17 Click here for more info
 - **tooltipContainerBounds** (`undefined | { bottom: number,  left: number,  right: number,  top: number }`) — Allows defining margins around chart area for tooltips to go outside the chart itself. @since 5.2.24
 
+- **fontFamily** (`undefined | string`) — Default font family for all text elements, unless overridden on an element. @since 5.20.2
+- **fontSize** (`undefined | number | string`) — Default font size for all text elements, unless overridden on an element. @since 5.20.2
+- **fontWeight** (`"normal" | "bold" | "bolder" | "lighter" | "100" | "200" | "300" | "400" | "500" | "600" | "700" | "800" | "900"`) — Default font weight for all text elements, unless overridden on an element. @since 5.20.2
+- **sanitizeHTML** (`undefined | false | true`) — Default true If set to true, dynamically-set HTML (html/labelHTML, HTML tooltips, modal content) is sanitized. Set to false to opt out. @since 5.19.0

package/extended/reference/iscrollbarsettings.md

@@ -52,3 +52,4 @@ Extended by: ISliderSettings, IXYChartScrollbarSettings
 - **end** (`undefined | number`) — Relative end of the selected range, with 0 meaning beginning, and 1 the end.
 - **orientation** (`"horizontal" | "vertical"`) — Orientation of the scrollbar.
 - **start** (`undefined | number`) — Relative start of the selected range, with 0 meaning beginning, and 1 the end.
+- **opposite** (`undefined | false | true`) — Default false If set to true, a chart's scrollbarX is placed below the plot area and its scrollbarY to the left, instead of above and to the right. Only has effect on scrollbars set via a chart's scrollbarX/scrollbarY settings; a scrollbar the user added to a container themselves is left where it is. Unrelated to the `opposite` setting of AxisRendererX/AxisRendererY. @since 5.20.2

package/extended/reference/iserialchartcontainersettings.md

@@ -0,0 +1,16 @@
+---
+title: "ISerialChartContainerSettings"
+type: "interface"
+source: "https://www.amcharts.com/docs/v5/reference/iserialchartcontainersettings/"
+scraped: "2026-09-14"
+---
+
+## Inheritance
+
+Extends: ISerialChartSettings
+
+> **Note:** This class also inherits all settings, properties, methods, and events from ISerialChartSettings (and its ancestors). Use `get_doc` or `get_core_reference` with the parent class name to see inherited members.
+
+## Properties
+
+- **zoomTools** (`ZoomTools`) — A ZoomTools instance to add to the chart. When set, its `target` is automatically pointed at the chart's `seriesContainer`. @since 5.20.2

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/mapchart.md

@@ -66,3 +66,7 @@ Extends: SerialChart
 - **wheelY** (`"none" | "zoom" | "rotateX" | "rotateY"`) — Default "zoom" Defines what happens when mouse wheel is turned. Click here for more info
 - **zoomControl** (`ZoomControl`) — A ZoomControl instance. Click here for more info
 - **zoomLevel** (`undefined | number`) — Current zoom level.
+
+## Properties
+
+- **boxZoomSelection** (`Rectangle`) — A Rectangle element that shows the area being drawn when boxZoom is enabled. Read-only; style its fill/stroke. @since 5.20.2

package/extended/reference/serialchart.md

@@ -17,7 +17,7 @@ import * as am5 from "@amcharts/amcharts5"
 ## Inheritance
 
 Extends: Chart
-Extended by: PercentChart, XYChart, MapChart
+Extended by: PercentChart, XYChart, MapChart, SerialChartContainer
 
 > **Note:** This class also inherits all settings, properties, methods, and events from Chart (and its ancestors). Use `get_doc` or `get_core_reference` with the parent class name to see inherited members.
 

package/extended/reference/serialchartcontainer.md

@@ -0,0 +1,34 @@
+---
+title: "SerialChartContainer"
+type: "class"
+source: "https://www.amcharts.com/docs/v5/reference/serialchartcontainer/"
+scraped: "2026-09-14"
+---
+
+A `SerialChart` whose `seriesContainer` is a `ZoomableContainer`, so that the chart contents can be zoomed and panned.
+
+Unlike the abstract `SerialChart`, this chart attaches its `seriesContainer` to the display tree on its own, so it can be instantiated and used directly — e.g. to make a `ForceDirected`, `Tree` or `Pack` series zoomable/pannable. Bullets sit alongside the series inside the zoomable container, so they zoom and pan with it.
+
+@since 5.20.2
+
+## Import
+
+```javascript
+// Import SerialChartContainer — exported from the root module, not a chart package
+import * as am5 from "@amcharts/amcharts5"
+const chart = root.container.children.push(am5.SerialChartContainer.new(root, {}));
+```
+
+## Inheritance
+
+Extends: SerialChart
+
+> **Note:** This class also inherits all settings, properties, methods, and events from SerialChart (and its ancestors). Use `get_doc` or `get_core_reference` with the parent class name to see inherited members.
+
+## Settings
+
+- **zoomTools** (`ZoomTools`) — A ZoomTools instance to add to the chart. When set, its `target` is automatically pointed at the chart's `seriesContainer`.
+
+## Properties
+
+- **zoomableContainer** (`ZoomableContainer`) — Default ZoomableContainer.new() A ZoomableContainer which holds chart's `seriesContainer` so it can be zoomed and panned. Theme tag `serialchartcontainer` (default theme: `wheelable: false`, `pinchZoom: false`, `maskContent: true`).

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.5.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

package/src/tools.js

@@ -12,6 +12,26 @@ import { CHART_TYPE_MAP, extractImportBlock, searchDocs } from "./content.js";
 export function registerTools(server, content) {
   const { docs, extendedDocs, examples } = content;
 
+  // Resolve any identifier a search result prints — "skill/SKILL.md",
+  // "skill/xy", "SKILL", "xy.md", "extended/charts/xy-chart/cursor",
+  // "charts/xy-chart/cursor", "reference/xycursor" — to a doc. Search results
+  // label their source exactly this way, so an agent can paste the label
+  // straight into get_section / get_doc.
+  function resolveDoc(id) {
+    let key = String(id || "").trim().replace(/^\/+|\/+$/g, "").replace(/\.md$/i, "");
+    if (!key) return null;
+    let skillKey = key.startsWith("skill/") ? key.slice("skill/".length) : key;
+    if (docs.has(skillKey)) return { doc: docs.get(skillKey), label: `skill/${skillKey}` };
+    const extKey = key.startsWith("extended/") ? key.slice("extended/".length) : key;
+    if (extendedDocs.has(extKey)) return { doc: extendedDocs.get(extKey), label: `extended/${extKey}` };
+    // Case-insensitive skill fallback ("skill" → "SKILL", "Xy" → "xy").
+    const lower = skillKey.toLowerCase();
+    for (const [name, doc] of docs) {
+      if (name.toLowerCase() === lower) return { doc, label: `skill/${name}` };
+    }
+    return null;
+  }
+
   // --- Tool: list_chart_types ---
   server.tool(
     "list_chart_types",
@@ -86,12 +106,39 @@ export function registerTools(server, content) {
         return { content: [{ type: "text", text: `No results found for "${query}".${hint}` }] };
       }
 
+      // Per-result excerpt budget. When only one or two sections match, the
+      // whole point is to read them — grow the budget instead of cutting the
+      // answer off.
+      const budget = results.length <= 2 ? 6000 : 2000;
+      const terms = query.toLowerCase().split(/\s+/).filter(Boolean);
+
       let text = `# Search results for "${query}" (scope: ${scope})\n\n`;
       for (const r of results) {
+        const id = `${r.source}/${r.file}`;
         text += `## ${r.docTitle} → ${r.heading}\n`;
-        text += `*(source: ${r.source}/${r.file}.md, relevance: ${r.score})*\n\n`;
-        // Truncate very long sections
-        const body = r.body.length > 2000 ? r.body.slice(0, 2000) + "\n\n...(truncated)" : r.body;
+        text += `*(source: ${id}.md, relevance: ${r.score})*\n\n`;
+        let body = r.body;
+        if (body.length > budget) {
+          // The excerpt is a fixed-size head, so the line that matched the
+          // query may lie past the cut. Quote the matching lines beyond the
+          // head so the answer is never lost, and print the exact call that
+          // returns the full section.
+          const head = body.slice(0, budget);
+          const beyond = [];
+          let offset = 0;
+          for (const line of body.split("\n")) {
+            const start = offset;
+            offset += line.length + 1;
+            if (start < budget) continue;
+            const l = line.toLowerCase();
+            if (terms.some(t => l.includes(t))) beyond.push(line.trim().slice(0, 400));
+            if (beyond.length >= 8) break;
+          }
+          body = head + `\n\n...(truncated — full section: get_section(file: "${id}", heading: "${r.heading}"))`;
+          if (beyond.length) {
+            body += `\n\nMatching lines beyond the excerpt:\n` + beyond.map(l => `> ${l}`).join("\n");
+          }
+        }
         text += body + "\n\n---\n\n";
       }
       return { content: [{ type: "text", text }] };
@@ -101,28 +148,29 @@ export function registerTools(server, content) {
   // --- Tool: get_section ---
   server.tool(
     "get_section",
-    "Get a specific section from an amCharts 5 reference file by heading name. Use search_docs first to find the right section.",
+    "Get the FULL text of one section of a doc by heading — use it to expand a truncated search_docs / search_all result. `file` accepts the source label exactly as search results print it ('skill/SKILL.md', 'skill/xy', 'extended/charts/xy-chart/cursor', 'reference/xycursor') as well as a bare skill file name ('SKILL', 'xy', 'map').",
     {
-      file: z.string().describe("Reference file name without .md, e.g. 'xy', 'pie', 'SKILL', 'map'"),
-      heading: z.string().describe("Section heading to retrieve, e.g. 'Core setup pattern', 'Axis types', 'Common pitfalls'"),
+      file: z.string().describe("Doc identifier: a skill file ('SKILL', 'xy', 'pie', 'map') or a source label from search results ('skill/SKILL.md', 'extended/concepts/events', 'reference/xycursor'). '.md' and 'skill/' / 'extended/' prefixes are optional."),
+      heading: z.string().describe("Section heading to retrieve (case-insensitive substring), e.g. 'Core setup pattern', 'Axis types', 'Common pitfalls', 'Recent API changes'"),
     },
     async ({ file, heading }) => {
-      const doc = docs.get(file);
-      if (!doc) {
-        return { content: [{ type: "text", text: `File "${file}" not found.` }] };
+      const resolved = resolveDoc(file);
+      if (!resolved) {
+        const skillFiles = [...docs.keys()].map(k => `skill/${k}`).join(", ");
+        return { content: [{ type: "text", text: `File "${file}" not found.\n\nSkill files: ${skillFiles}\n\nExtended docs use their path, e.g. 'charts/xy-chart/cursor', 'concepts/events', 'reference/xycursor' (with or without an 'extended/' prefix). Use search_docs / search_all to find one.` }] };
       }
+      const { doc, label } = resolved;
 
-      const section = doc.sections.find(
-        s => s.heading.toLowerCase().includes(heading.toLowerCase())
-      );
+      const needle = heading.toLowerCase();
+      const section = doc.sections.find(s => s.heading.toLowerCase().includes(needle));
       if (!section) {
         const available = doc.sections.map(s => s.heading).filter(Boolean).join("\n- ");
         return {
-          content: [{ type: "text", text: `Section "${heading}" not found in ${file}.md.\n\nAvailable sections:\n- ${available}` }],
+          content: [{ type: "text", text: `Section "${heading}" not found in ${label}.md.\n\nAvailable sections:\n- ${available}` }],
         };
       }
       return {
-        content: [{ type: "text", text: `# ${section.heading}\n\n${section.body}` }],
+        content: [{ type: "text", text: `# ${section.heading}\n*(source: ${label}.md)*\n\n${section.body}` }],
       };
     }
   );
@@ -244,22 +292,26 @@ export function registerTools(server, content) {
   // --- Tool: get_doc ---
   server.tool(
     "get_doc",
-    "Get a full documentation page from the extended amCharts 5 docs. Use search_all first to find the right path.",
+    "Get a full documentation page — an extended doc by path, or a skill file by 'skill/<name>'. Accepts the source label exactly as search_docs / search_all print it. Use search_all first to find the right path.",
     {
-      path: z.string().describe("Doc path, e.g. 'charts/xy-chart/cursor', 'concepts/events', 'getting-started/integrations/react', 'reference/xycursor' (per-class API). For a class's full settings + defaults prefer get_api_reference."),
+      path: z.string().describe("Doc path, e.g. 'charts/xy-chart/cursor', 'concepts/events', 'getting-started/integrations/react', 'reference/xycursor' (per-class API), or a skill file such as 'skill/SKILL.md' / 'skill/xy'. For a class's full settings + defaults prefer get_api_reference."),
     },
     async ({ path: docPath }) => {
-      const key = docPath.replace(/^\/|\/$/g, "").replace(/\.md$/, "");
-      const doc = extendedDocs.get(key);
-      if (!doc) {
+      const key = String(docPath || "").replace(/^\/|\/$/g, "").replace(/\.md$/, "");
+      // Extended docs take precedence for bare paths; 'skill/…' always means the skill layer.
+      const resolved = key.startsWith("skill/")
+        ? resolveDoc(key)
+        : (extendedDocs.has(key) ? { doc: extendedDocs.get(key), label: `extended/${key}` } : resolveDoc(key));
+      if (!resolved) {
         // List available top-level paths
         const paths = [...extendedDocs.keys()];
         const topLevel = [...new Set(paths.map(p => p.split("/")[0]))].sort();
         return {
-          content: [{ type: "text", text: `Doc "${key}" not found.\n\nAvailable top-level sections: ${topLevel.join(", ")}\n\nUse search_all to find the right path.` }],
+          content: [{ type: "text", text: `Doc "${key}" not found.\n\nAvailable top-level sections: skill, ${topLevel.join(", ")}\n\nSkill files: ${[...docs.keys()].map(k => `skill/${k}`).join(", ")}\n\nUse search_all to find the right path.` }],
         };
       }
-      return { content: [{ type: "text", text: `# ${doc.title}\n\n${doc.content}` }] };
+      const { doc, label } = resolved;
+      return { content: [{ type: "text", text: `# ${doc.title}\n*(source: ${label}.md)*\n\n${doc.content}` }] };
     }
   );