@amcharts/amcharts5-mcp 1.7.1 → 1.9.0

package/extended/reference/triangle.md

@@ -2,7 +2,7 @@
 title: "Triangle"
 type: "class"
 source: "https://www.amcharts.com/docs/v5/reference/triangle/"
-generatedFrom: "@amcharts/amcharts5@5.21.0"
+generatedFrom: "@amcharts/amcharts5@5.21.3"
 ---
 
 Draws a triangle pointing up, centered on its `x` and `y`, with its `width` and `height`.

package/extended/reference/trianglepattern.md

@@ -2,7 +2,7 @@
 title: "TrianglePattern"
 type: "class"
 source: "https://www.amcharts.com/docs/v5/reference/trianglepattern/"
-generatedFrom: "@amcharts/amcharts5@5.21.0"
+generatedFrom: "@amcharts/amcharts5@5.21.3"
 ---
 
 Triangle pattern.

package/extended/reference/trix.md

@@ -2,7 +2,7 @@
 title: "Trix"
 type: "class"
 source: "https://www.amcharts.com/docs/v5/reference/trix/"
-generatedFrom: "@amcharts/amcharts5@5.21.0"
+generatedFrom: "@amcharts/amcharts5@5.21.3"
 ---
 
 Trix indicator: the percentage change of a triple exponential moving average of `field` over `period`, with a signal line. Drawn in a panel of its own.

package/extended/reference/type.md

@@ -2,7 +2,7 @@
 title: "Type"
 type: "type"
 source: "https://www.amcharts.com/docs/v5/reference/type/"
-generatedFrom: "@amcharts/amcharts5@5.21.0"
+generatedFrom: "@amcharts/amcharts5@5.21.3"
 ---
 
 Represents a type for all available JavaScript variable types.

package/extended/reference/typicalprice.md

@@ -2,7 +2,7 @@
 title: "TypicalPrice"
 type: "class"
 source: "https://www.amcharts.com/docs/v5/reference/typicalprice/"
-generatedFrom: "@amcharts/amcharts5@5.21.0"
+generatedFrom: "@amcharts/amcharts5@5.21.3"
 ---
 
 Typical Price indicator: `field`, by default the typical price (`"hlc/3"`, the average of high, low and close), averaged over `period`. Drawn in a panel of its own.

package/extended/reference/utils.md

@@ -1,7 +1,7 @@
 ---
 title: "utils"
 type: "namespace"
-generatedFrom: "@amcharts/amcharts5@5.21.0"
+generatedFrom: "@amcharts/amcharts5@5.21.3"
 ---
 
 Helpers exported as `am5.utils`.
@@ -43,8 +43,8 @@ am5.utils.…
 - `getStyle(dom: HTMLElement, property: string): string | undefined` — Gets style property value on a DOM element.
 - `getTimeZone(date: Date, long?: boolean, savings?: boolean, utc?: boolean, timezone?: string): string` — Returns a string name of the time zone.
 - `getTimezoneOffset(timezone: string, targetDate?: Date): number` — Returns the UTC offset in minutes for a given timezone, positive west of UTC, as with `Date.getTimezoneOffset()`.
-- `getWeek(date: Date, _utc?: boolean): number` — Returns the ISO 8601 week number of a date: weeks start on Monday, and week 1 is the one with the year's first Thursday.
-- `getWeekYear(date: Date, _utc?: boolean): number` — Returns the year that the ISO 8601 week of the date belongs to. Around January 1 it can differ from the calendar year. _Since 5.3.0._
+- `getWeek(date: Date, utc?: boolean): number` — Returns the ISO 8601 week number of a date: weeks start on Monday, and week 1 is the one with the year's first Thursday.
+- `getWeekYear(date: Date, utc?: boolean): number` — Returns the year that the ISO 8601 week of the date belongs to. Around January 1 it can differ from the calendar year. _Since 5.3.0._
 - `getYearDay(date: Date, utc?: boolean): number` — Returns the day of the year, `1` being January 1.
 - `hslToHsv(hsl: iHSL): iHSV` — Converts HSL to HSV.
 - `hslToRgb(color: iHSL): iRGB` — Converts an HSL color to RGB: `h`, `s` and `l` from `0` to `1` in, `r`, `g` and `b` from `0` to `255` out. Alpha is not carried over.

package/extended/reference/value.md

@@ -2,7 +2,7 @@
 title: "Value"
 type: "class"
 source: "https://www.amcharts.com/docs/v5/reference/value/"
-generatedFrom: "@amcharts/amcharts5@5.21.0"
+generatedFrom: "@amcharts/amcharts5@5.21.3"
 ---
 
 ## Import

package/extended/reference/valueaxis.md

@@ -2,7 +2,7 @@
 title: "ValueAxis"
 type: "class"
 source: "https://www.amcharts.com/docs/v5/reference/valueaxis/"
-generatedFrom: "@amcharts/amcharts5@5.21.0"
+generatedFrom: "@amcharts/amcharts5@5.21.3"
 ---
 
 An axis with a numeric scale.

package/extended/reference/venn.md

@@ -2,7 +2,7 @@
 title: "Venn"
 type: "class"
 source: "https://www.amcharts.com/docs/v5/reference/venn/"
-generatedFrom: "@amcharts/amcharts5@5.21.0"
+generatedFrom: "@amcharts/amcharts5@5.21.3"
 ---
 
 A Venn diagram: circles sized by their values, overlapping as much as the values of their overlaps say.

package/extended/reference/venndefaulttheme.md

@@ -2,7 +2,7 @@
 title: "VennDefaultTheme"
 type: "class"
 source: "https://www.amcharts.com/docs/v5/reference/venndefaulttheme/"
-generatedFrom: "@amcharts/amcharts5@5.21.0"
+generatedFrom: "@amcharts/amcharts5@5.21.3"
 ---
 
 Built-in theme rules: `Venn` adds this theme to its default themes, so its rules apply to that element and everything inside it.

package/extended/reference/verticallayout.md

@@ -2,7 +2,7 @@
 title: "VerticalLayout"
 type: "class"
 source: "https://www.amcharts.com/docs/v5/reference/verticallayout/"
-generatedFrom: "@amcharts/amcharts5@5.21.0"
+generatedFrom: "@amcharts/amcharts5@5.21.3"
 ---
 
 Stacks a `Container`'s children from top to bottom. Children with a percent height share the height the others leave, in proportion to their percents.

package/extended/reference/verticallineseries.md

@@ -2,7 +2,7 @@
 title: "VerticalLineSeries"
 type: "class"
 source: "https://www.amcharts.com/docs/v5/reference/verticallineseries/"
-generatedFrom: "@amcharts/amcharts5@5.21.0"
+generatedFrom: "@amcharts/amcharts5@5.21.3"
 ---
 
 A `SimpleLineSeries` subclass.

package/extended/reference/volume.md

@@ -2,7 +2,7 @@
 title: "Volume"
 type: "class"
 source: "https://www.amcharts.com/docs/v5/reference/volume/"
-generatedFrom: "@amcharts/amcharts5@5.21.0"
+generatedFrom: "@amcharts/amcharts5@5.21.3"
 ---
 
 Volume indicator: columns of `volumeSeries`, colored by whether the price closed up or down. Drawn in a panel of its own.

package/extended/reference/volumeprofile.md

@@ -2,7 +2,7 @@
 title: "VolumeProfile"
 type: "class"
 source: "https://www.amcharts.com/docs/v5/reference/volumeprofile/"
-generatedFrom: "@amcharts/amcharts5@5.21.0"
+generatedFrom: "@amcharts/amcharts5@5.21.3"
 ---
 
 Volume Profile indicator: horizontal rows over the main series showing how much volume traded at each price in the visible range, split into up and down volume.

package/extended/reference/voronoitreemap.md

@@ -2,7 +2,7 @@
 title: "VoronoiTreemap"
 type: "class"
 source: "https://www.amcharts.com/docs/v5/reference/voronoitreemap/"
-generatedFrom: "@amcharts/amcharts5@5.21.0"
+generatedFrom: "@amcharts/amcharts5@5.21.3"
 ---
 
 A weighted Voronoi treemap: nodes as polygon cells sized by value, each inside its parent's cell. Many items with very different values lay out poorly; group the small ones into an "Other" item.

package/extended/reference/vwap.md

@@ -2,7 +2,7 @@
 title: "VWAP"
 type: "class"
 source: "https://www.amcharts.com/docs/v5/reference/vwap/"
-generatedFrom: "@amcharts/amcharts5@5.21.0"
+generatedFrom: "@amcharts/amcharts5@5.21.3"
 ---
 
 Volume-Weighted Average Price indicator: `field` averaged over the last `period` data items, weighted by volume. Drawn over the main series; needs a `volumeSeries`.

package/extended/reference/weekdays.md

@@ -2,7 +2,7 @@
 title: "Weekdays"
 type: "type"
 source: "https://www.amcharts.com/docs/v5/reference/weekdays/"
-generatedFrom: "@amcharts/amcharts5@5.21.0"
+generatedFrom: "@amcharts/amcharts5@5.21.3"
 ---
 
 TypeScript: not exported by name from the package.

package/extended/reference/williamsr.md

@@ -2,7 +2,7 @@
 title: "WilliamsR"
 type: "class"
 source: "https://www.amcharts.com/docs/v5/reference/williamsr/"
-generatedFrom: "@amcharts/amcharts5@5.21.0"
+generatedFrom: "@amcharts/amcharts5@5.21.3"
 ---
 
 Williams %R indicator: where the close is within the high-low range of the last `period` data items, from `0` (at the high) to `-100` (at the low). Drawn in a panel of its own.

package/extended/reference/wordcloud.md

@@ -2,7 +2,7 @@
 title: "WordCloud"
 type: "class"
 source: "https://www.amcharts.com/docs/v5/reference/wordcloud/"
-generatedFrom: "@amcharts/amcharts5@5.21.0"
+generatedFrom: "@amcharts/amcharts5@5.21.3"
 ---
 
 A word cloud: words sized by their values, from `data` or counted in `text`.

package/extended/reference/wordclouddefaulttheme.md

@@ -2,7 +2,7 @@
 title: "WordCloudDefaultTheme"
 type: "class"
 source: "https://www.amcharts.com/docs/v5/reference/wordclouddefaulttheme/"
-generatedFrom: "@amcharts/amcharts5@5.21.0"
+generatedFrom: "@amcharts/amcharts5@5.21.3"
 ---
 
 Built-in theme rules: `WordCloud` adds this theme to its default themes, so its rules apply to that element and everything inside it.

package/extended/reference/xychart.md

@@ -2,7 +2,7 @@
 title: "XYChart"
 type: "class"
 source: "https://www.amcharts.com/docs/v5/reference/xychart/"
-generatedFrom: "@amcharts/amcharts5@5.21.0"
+generatedFrom: "@amcharts/amcharts5@5.21.3"
 ---
 
 A chart with X and Y axes, for line, column, scatter and other XY series.

package/extended/reference/xychartdefaulttheme.md

@@ -2,7 +2,7 @@
 title: "XYChartDefaultTheme"
 type: "class"
 source: "https://www.amcharts.com/docs/v5/reference/xychartdefaulttheme/"
-generatedFrom: "@amcharts/amcharts5@5.21.0"
+generatedFrom: "@amcharts/amcharts5@5.21.3"
 ---
 
 Built-in theme rules: `StockChart` and `XYChart` add this theme to their default themes, so its rules apply to those elements and everything inside them.

package/extended/reference/xychartscrollbar.md

@@ -2,7 +2,7 @@
 title: "XYChartScrollbar"
 type: "class"
 source: "https://www.amcharts.com/docs/v5/reference/xychartscrollbar/"
-generatedFrom: "@amcharts/amcharts5@5.21.0"
+generatedFrom: "@amcharts/amcharts5@5.21.3"
 ---
 
 A scrollbar with a small preview chart in it. Add axes and series to its `chart` to draw the preview.

package/extended/reference/xycursor.md

@@ -2,7 +2,7 @@
 title: "XYCursor"
 type: "class"
 source: "https://www.amcharts.com/docs/v5/reference/xycursor/"
-generatedFrom: "@amcharts/amcharts5@5.21.0"
+generatedFrom: "@amcharts/amcharts5@5.21.3"
 ---
 
 Crosshair lines over an `XYChart` that follow the pointer and show the axis and series tooltips. Dragging can zoom or select (`behavior`).

package/extended/reference/xyseries.md

@@ -2,7 +2,7 @@
 title: "XYSeries"
 type: "class"
 source: "https://www.amcharts.com/docs/v5/reference/xyseries/"
-generatedFrom: "@amcharts/amcharts5@5.21.0"
+generatedFrom: "@amcharts/amcharts5@5.21.3"
 ---
 
 Base class for all XY chart series.

package/extended/reference/zigzag.md

@@ -2,7 +2,7 @@
 title: "ZigZag"
 type: "class"
 source: "https://www.amcharts.com/docs/v5/reference/zigzag/"
-generatedFrom: "@amcharts/amcharts5@5.21.0"
+generatedFrom: "@amcharts/amcharts5@5.21.3"
 ---
 
 ZigZag indicator: straight lines between the price's turning points, ignoring moves smaller than `deviation`. Drawn over the main series.

package/extended/reference/zoomablecontainer.md

@@ -2,7 +2,7 @@
 title: "ZoomableContainer"
 type: "class"
 source: "https://www.amcharts.com/docs/v5/reference/zoomablecontainer/"
-generatedFrom: "@amcharts/amcharts5@5.21.0"
+generatedFrom: "@amcharts/amcharts5@5.21.3"
 ---
 
 A `Container` whose `contents` can be zoomed with the wheel, a pinch or `ZoomTools`, and panned by dragging.

package/extended/reference/zoomcontrol.md

@@ -2,7 +2,7 @@
 title: "ZoomControl"
 type: "class"
 source: "https://www.amcharts.com/docs/v5/reference/zoomcontrol/"
-generatedFrom: "@amcharts/amcharts5@5.21.0"
+generatedFrom: "@amcharts/amcharts5@5.21.3"
 ---
 
 Buttons that zoom a `MapChart` in and out, set as its `zoomControl`. A home button is there too, hidden by default.

package/extended/reference/zoomtools.md

@@ -2,7 +2,7 @@
 title: "ZoomTools"
 type: "class"
 source: "https://www.amcharts.com/docs/v5/reference/zoomtools/"
-generatedFrom: "@amcharts/amcharts5@5.21.0"
+generatedFrom: "@amcharts/amcharts5@5.21.3"
 ---
 
 Home, zoom-in and zoom-out buttons for a zoomable `target`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amcharts/amcharts5-mcp",
-  "version": "1.7.1",
+  "version": "1.9.0",
   "mcpName": "io.github.amcharts/amcharts5",
   "description": "On-demand access to amCharts 5 docs, code examples, and API reference",
   "type": "module",
@@ -12,7 +12,6 @@
     "src/",
     "content/",
     "extended/",
-    "!extended/reference-generated/",
     "README.md",
     "LICENSE"
   ],
@@ -25,6 +24,7 @@
     "clean:examples": "node scripts/clean-examples2.js && node scripts/clean-all.js extended/examples && node scripts/check-examples.js",
     "build:worker": "node scripts/build-worker-content.js",
     "build:reference": "node scripts/generate-reference.cjs",
+    "build:geodata": "node scripts/generate-geodata-index.cjs",
     "dev:worker": "npm run build:worker && wrangler dev",
     "deploy": "npm run build:worker && wrangler deploy",
     "prepublishOnly": "node -e \"const fs=require('fs');if(!fs.existsSync('content'))fs.mkdirSync('content');fs.cpSync('amcharts5-skill/amcharts5-skill/SKILL.md','content/SKILL.md');for(const f of fs.readdirSync('amcharts5-skill/amcharts5-skill/references').filter(x=>x.endsWith('.md')))fs.cpSync('amcharts5-skill/amcharts5-skill/references/'+f,'content/'+f)\"",
@@ -58,12 +58,12 @@
     "zod": "^3.25 || ^4.0"
   },
   "devDependencies": {
-    "@amcharts/amcharts5": "5.21.0",
-    "agents": "^0.16.2",
+    "@amcharts/amcharts5": "5.21.3",
+    "agents": "^0.28.1",
     "jsdom": "^29.0.0",
     "turndown": "^7.2.2",
     "typescript": "5.9.3",
-    "wrangler": "^4.102.0"
+    "wrangler": "^4.151.1"
   },
   "overrides": {
     "@modelcontextprotocol/sdk": "$@modelcontextprotocol/sdk"

package/src/content-fs.js

@@ -24,18 +24,12 @@ const REFERENCES_DIR = existsSync(join(SKILL_DIR, "references"))
   ? 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"]);
+// Geodata map list (scripts/generate-geodata-index.cjs), served by list_geodata.
+const GEODATA_INDEX = join(EXTENDED_DIR, "geodata", "index.json");
 
 /**
- * Read all skill + extended markdown into the raw { skillFiles, extendedFiles }
- * shape that buildContent() expects.
+ * Read all skill + extended markdown (and the geodata index) into the raw
+ * { skillFiles, extendedFiles, geodata } shape that buildContent() expects.
  */
 export function readRawFiles() {
   const skillFiles = {};
@@ -58,7 +52,9 @@ export function readRawFiles() {
   // Extended docs + examples (recursive)
   walkExtended(EXTENDED_DIR, "", extendedFiles);
 
-  return { skillFiles, extendedFiles };
+  const geodata = existsSync(GEODATA_INDEX) ? JSON.parse(readFileSync(GEODATA_INDEX, "utf-8")) : null;
+
+  return { skillFiles, extendedFiles, geodata };
 }
 
 function walkExtended(dir, prefix, out) {
@@ -66,8 +62,6 @@ 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