@amcharts/amcharts5-mcp 1.1.9 → 1.3.2

package/extended/reference/movingaveragedeviation.md

@@ -24,7 +24,8 @@ Extends: ChartIndicator
 
 - **decreasingColor** (`Color`) — Decreasing color.
 - **increasingColor** (`Color`) — Increasing color.
-- **type** (`"simple" | "weighted" | "exponential" | "dema" | "tema"`) — Default "simple" Type of the moving average.
+- **maType** (`"simple" | "weighted" | "exponential" | "dema" | "tema"`) — Default "simple" Type of the moving average. (Renamed from `type` in 5.18.0.)
+- **type** (`"simple" | "weighted" | "exponential" | "dema" | "tema"`) — *Deprecated since 5.18.0 — use `maType` (still works).* Default "simple" Type of the moving average.
 - **unit** (`"points" | "percent"`) — Default "points" How units are calculated.
 
 ## Properties

package/extended/reference/tree.md

@@ -22,5 +22,8 @@ Extends: LinkedHierarchy
 
 ## Settings
 
+- **clustered** (`undefined | false | true`) — Default false If set to true, uses a cluster (dendrogram) layout where all leaf nodes are placed at the same depth. @since 5.16.2
+- **fitNodes** (`undefined | false | true`) — Default false If set to true, hidden nodes are excluded from the layout, giving more space to visible ones. @since 5.18.0
 - **inversed** (`undefined | false | true`) — Default false If set to true, will flip the tree direction. @since 5.2.4
+- **nodeSeparation** (`undefined | (a: DataItem, b: DataItem) => number`) — Custom node-separation function; receives two data items and returns a numeric spacing value. @since 5.16.2
 - **orientation** (`"horizontal" | "vertical"`) — Default "vertical" Orientation of the diagram.

package/extended/reference/valueaxis.md

@@ -38,5 +38,6 @@ Extended by: DateAxis, DurationAxis
 - **strictMinMax** (`undefined | false | true`) — Force axis scale to be precisely at values as set in min and/or max. In case min and/or max is not set, the axis will fix its scale to precise lowest and highest values available through all of the series attached to it. This effectively locks the axis from auto-zooming itself when chart is zoomed in. If you need to zoom to actual low/high values within currently visible scope, use strictMinMaxSelection instead. Use extraMin and extraMax to add extra "padding". Click here for more info
 - **strictMinMaxSelection** (`undefined | false | true`) — Force axis to auto-zoom to exact lowest and highest values from attached series' data items within currently visible range. This is a good feature when your series is plotted from derivative values, like valueYChangeSelection as it helps to avoid frequent jumping of series to adjusted min and max of the axis. This will not work if strictMinMax is set to true (the axis will not zoom at all in this case). Use extraMin and extraMax to add extra "padding". @since 5.1.11
 - **syncWithAxis** (`ValueAxis`) — This setting can be set to an instance of another ValueAxis. If set the grid of this axis will be synced with grid of the target axis. NOTE: this is not 100% guaranteed to work. In some rare cases perfect sync might not be possible. Click here for more info
+- **syncZeros** (`undefined | false | true`) — Aligns the zero baseline across synced axes. Works only if `syncWithAxis` is set and zero is within the min/max of the axis. @since 5.16.2
 - **tooltipNumberFormat** (`string | NumberFormatOptions`) — A numeric format used for numbers displayed in axis tooltip. Click here for more info
 - **treatZeroAs** (`undefined | number`) — Treat zero values as some other value. Useful in situations where zero would result in error, i.e. logarithmic scale. Click here for more info

package/extended/reference/voronoitreemap.md

@@ -27,7 +27,8 @@ Extends: Hierarchy
 - **cornerCount** (`undefined | number`) — Default 120 Number of corners when type is "polygon". 120 means the polygoon will look like a circle. NOTE: this setting is ignored if type="rectangle".
 - **maxIterationCount** (`undefined | number`) — Default 100 Maximum allowed number of iterations when computing the layout. Computation is stopped when it number of iterations is reached, even if the convergenceRatio is not yet reached. Bigger number means finer results, but slower performance.
 - **minWeightRatio** (`undefined | number`) — Default 0.005 Minimum weight ratio which allows computing the minimum allowed weight (= [maximum weight] * minWeightRatio). Setting very small minWeigtRatio might result flickering. NOTE: the nodes that have smaller weight will be scaled up and will not represent their true value correctly.
-- **type** (`"rectangle" | "polygon"`) — Default "polygon" Type of the diagram's shape. Click here for more info
+- **shapeType** (`"rectangle" | "polygon"`) — Default "polygon" Type of the diagram's shape. (Renamed from `type` in 5.18.0.) Click here for more info
+- **type** (`"rectangle" | "polygon"`) — *Deprecated since 5.18.0 — use `shapeType` (still works).* Default "polygon" Type of the diagram's shape.
 
 ## Properties
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amcharts/amcharts5-mcp",
-  "version": "1.1.9",
+  "version": "1.3.2",
   "mcpName": "io.github.amcharts/amcharts5",
   "description": "On-demand access to amCharts 5 docs, code examples, and API reference",
   "type": "module",
@@ -18,6 +18,10 @@
   "scripts": {
     "start": "node src/index.js",
     "dev": "node --watch src/index.js",
+    "test": "node test.js",
+    "build:worker": "node scripts/build-worker-content.js",
+    "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)\"",
     "postpublish": "node -e \"require('fs').rmSync('content',{recursive:true,force:true})\""
   },
@@ -48,5 +52,9 @@
     "@modelcontextprotocol/sdk": "^1.12.1",
     "jsdom": "^29.0.0",
     "turndown": "^7.2.2"
+  },
+  "devDependencies": {
+    "agents": "^0.16.2",
+    "wrangler": "^4.102.0"
   }
 }

package/src/content-fs.js

@@ -0,0 +1,74 @@
+// ---------------------------------------------------------------------------
+// Node-only disk loader.
+//
+// Reads raw markdown off the filesystem into the { skillFiles, extendedFiles }
+// shape consumed by buildContent(). Used by the stdio server (src/index.js) and
+// by the Worker content build script (scripts/build-worker-content.js).
+//
+// NOTE: imports `fs` — must NOT be imported by the Worker bundle.
+// ---------------------------------------------------------------------------
+
+import { readFileSync, readdirSync, existsSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import { buildContent } from "./content.js";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ROOT = join(__dirname, "..");
+
+// Submodule path (local dev) or content/ fallback (npm install)
+const SUBMODULE_DIR = join(ROOT, "amcharts5-skill", "amcharts5-skill");
+const CONTENT_DIR = join(ROOT, "content");
+const SKILL_DIR = existsSync(SUBMODULE_DIR) ? SUBMODULE_DIR : CONTENT_DIR;
+const REFERENCES_DIR = existsSync(join(SKILL_DIR, "references"))
+  ? join(SKILL_DIR, "references")
+  : SKILL_DIR;
+const EXTENDED_DIR = join(ROOT, "extended");
+
+/**
+ * Read all skill + extended markdown into the raw { skillFiles, extendedFiles }
+ * shape that buildContent() expects.
+ */
+export function readRawFiles() {
+  const skillFiles = {};
+  const extendedFiles = {};
+
+  // Core SKILL.md
+  const skillPath = join(SKILL_DIR, "SKILL.md");
+  if (existsSync(skillPath)) {
+    skillFiles["SKILL"] = readFileSync(skillPath, "utf-8");
+  }
+
+  // Reference files (skip SKILL.md if it lives in the same dir as references)
+  if (existsSync(REFERENCES_DIR)) {
+    for (const file of readdirSync(REFERENCES_DIR)) {
+      if (!file.endsWith(".md") || file === "SKILL.md") continue;
+      skillFiles[file.replace(".md", "")] = readFileSync(join(REFERENCES_DIR, file), "utf-8");
+    }
+  }
+
+  // Extended docs + examples (recursive)
+  walkExtended(EXTENDED_DIR, "", extendedFiles);
+
+  return { skillFiles, extendedFiles };
+}
+
+function walkExtended(dir, prefix, out) {
+  if (!existsSync(dir)) return;
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    const fullPath = join(dir, entry.name);
+    if (entry.isDirectory()) {
+      walkExtended(fullPath, prefix ? `${prefix}/${entry.name}` : entry.name, out);
+    } else if (entry.name.endsWith(".md")) {
+      const key = prefix
+        ? `${prefix}/${entry.name.replace(".md", "")}`
+        : entry.name.replace(".md", "");
+      out[key] = readFileSync(fullPath, "utf-8");
+    }
+  }
+}
+
+/** Read from disk and build the in-memory content structures. */
+export function loadContentFromDisk() {
+  return buildContent(readRawFiles());
+}

package/src/content.js

@@ -0,0 +1,214 @@
+// ---------------------------------------------------------------------------
+// Shared, transport-agnostic content layer.
+//
+// Pure logic only — NO filesystem, NO Node built-ins — so this module can be
+// bundled into the Cloudflare Worker as-is. The stdio server reads files from
+// disk (see content-fs.js) and the Worker imports a pre-generated bundle (see
+// scripts/build-worker-content.js); both feed the same buildContent() here so
+// the two deployments behave identically.
+// ---------------------------------------------------------------------------
+
+/** Chart type aliases → reference file mapping */
+export const CHART_TYPE_MAP = {
+  // XY family
+  "xy": "xy", "line": "xy", "area": "xy", "bar": "xy", "column": "xy",
+  "candlestick": "xy", "ohlc": "xy", "scatter": "xy", "bubble": "xy",
+  "stacked": "xy", "stacked-bar": "xy", "stacked-column": "xy",
+  "stacked-area": "xy", "range": "xy", "waterfall": "xy",
+  // Pie family
+  "pie": "pie", "donut": "pie", "funnel": "pie", "pyramid": "pie",
+  "semi-circle": "pie", "pictorial": "pie", "sliced": "pie",
+  // Map
+  "map": "map", "choropleth": "map", "geo": "map", "geographic": "map",
+  "world": "map", "country": "map", "bubble-map": "map", "point-map": "map",
+  // Hierarchy
+  "hierarchy": "hierarchy", "treemap": "hierarchy", "sunburst": "hierarchy",
+  "force-directed": "hierarchy", "pack": "hierarchy", "partition": "hierarchy",
+  "tree": "hierarchy", "org-chart": "hierarchy",
+  // Flow
+  "flow": "flow", "sankey": "flow", "chord": "flow", "arc": "flow",
+  "alluvial": "flow",
+  // Radar
+  "radar": "radar", "spider": "radar", "polar": "radar", "gauge": "radar",
+  "speedometer": "radar", "meter": "radar",
+  // Stock
+  "stock": "stock", "financial": "stock", "trading": "stock",
+  // Timeline
+  "timeline": "timeline", "serpentine": "timeline", "spiral": "timeline",
+  "curve": "timeline",
+  // Gantt
+  "gantt": "gantt", "project-timeline": "gantt",
+  // Word cloud
+  "wordcloud": "wordcloud", "word-cloud": "wordcloud", "tag-cloud": "wordcloud",
+  // Venn
+  "venn": "venn",
+  // UI
+  "ui": "ui-elements", "ui-elements": "ui-elements", "button": "ui-elements",
+  "slider": "ui-elements", "controls": "ui-elements",
+};
+
+export function parseSections(content) {
+  const sections = [];
+  const lines = content.split("\n");
+  let currentHeading = "";
+  let currentBody = [];
+
+  for (const line of lines) {
+    const headingMatch = line.match(/^(#{1,3})\s+(.+)/);
+    if (headingMatch) {
+      const level = headingMatch[1].length;
+      const title = headingMatch[2].trim();
+      if (level <= 2) {
+        // Major section boundary (# or ##)
+        if (currentHeading || currentBody.length > 0) {
+          sections.push({ heading: currentHeading, body: currentBody.join("\n") });
+        }
+        currentHeading = title;
+        currentBody = [];
+      } else {
+        // Sub-heading (###) — include in current section body
+        currentBody.push(line);
+      }
+    } else {
+      currentBody.push(line);
+    }
+  }
+  if (currentHeading || currentBody.length > 0) {
+    sections.push({ heading: currentHeading, body: currentBody.join("\n") });
+  }
+  return sections;
+}
+
+/**
+ * Import sections carry two ### sub-blocks: one for ES modules, one for CDN /
+ * script tags. Return only the requested one (esm | html), or "" if not found.
+ */
+export function extractImportBlock(body, format) {
+  const lines = body.split("\n");
+  const wantEsm = format === "esm";
+  let capturing = false;
+  let captured = [];
+  let sawSub = false;
+  for (const line of lines) {
+    const sub = line.match(/^###\s+(.+)/);
+    if (sub) {
+      sawSub = true;
+      const h = sub[1].toLowerCase();
+      const isEsm = /es module|esm|typescript|import/.test(h);
+      // Note: "typescript" contains "script", so match "script tag"/"cdn", not bare "script".
+      const isCdn = /cdn|script tag|<script/.test(h);
+      capturing = wantEsm ? isEsm : isCdn;
+      continue;
+    }
+    if (capturing) captured.push(line);
+  }
+  if (!sawSub) return ""; // no sub-blocks → caller falls back to full body
+  return captured.join("\n").trim();
+}
+
+/**
+ * Build the in-memory content structures from raw markdown files.
+ *
+ * @param {{ skillFiles: Record<string,string>, extendedFiles: Record<string,string> }} raw
+ *   skillFiles  — name (no .md) → raw markdown for SKILL.md + references/*.md
+ *   extendedFiles — path key (no .md) → raw markdown for everything under extended/
+ * @returns {{ docs: Map, extendedDocs: Map, examples: Map }}
+ */
+export function buildContent({ skillFiles = {}, extendedFiles = {} } = {}) {
+  /** @type {Map<string, {title: string, content: string, sections: {heading: string, body: string}[]}>} */
+  const docs = new Map();
+  /** @type {Map<string, {title: string, content: string, sections: {heading: string, body: string}[], path: string}>} */
+  const extendedDocs = new Map();
+  /** @type {Map<string, {title: string, category: string, content: string, source: string}>} */
+  const examples = new Map();
+
+  // Skill docs (SKILL.md + references/*.md)
+  for (const [name, content] of Object.entries(skillFiles)) {
+    const titleMatch = content.match(/^#\s+(.+)/m);
+    const title = titleMatch ? titleMatch[1] : name;
+    docs.set(name, { title, content, sections: parseSections(content) });
+  }
+
+  // Extended docs + examples (frontmatter-tagged markdown)
+  for (const [key, content] of Object.entries(extendedFiles)) {
+    const fmMatch = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+    const body = fmMatch ? fmMatch[2].trim() : content;
+    const fm = fmMatch ? fmMatch[1] : "";
+    const titleMatch = fm.match(/title:\s*"(.+?)"/);
+    const categoryMatch = fm.match(/category:\s*"(.+?)"/);
+    const sourceMatch = fm.match(/source:\s*"(.+?)"/);
+    const fallbackTitle = key.split("/").pop();
+    const title = titleMatch ? titleMatch[1] : fallbackTitle;
+
+    if (key.startsWith("examples/")) {
+      examples.set(key, {
+        title,
+        category: categoryMatch ? categoryMatch[1] : "",
+        content: body,
+        source: sourceMatch ? sourceMatch[1] : "",
+      });
+    } else {
+      extendedDocs.set(key, {
+        title,
+        content: body,
+        sections: parseSections(body),
+        path: key,
+      });
+    }
+  }
+
+  return { docs, extendedDocs, examples };
+}
+
+/**
+ * Keyword search over the skill docs and (optionally) the extended docs.
+ * @param {{docs: Map, extendedDocs: Map}} content
+ */
+export function searchDocs(content, query, maxResults = 10, scope = "skill") {
+  const terms = query.toLowerCase().split(/\s+/).filter(Boolean);
+  const results = [];
+
+  // Skill docs (SKILL.md + references/*.md)
+  for (const [name, doc] of content.docs) {
+    for (const section of doc.sections) {
+      const text = (section.heading + " " + section.body).toLowerCase();
+      const score = terms.reduce((s, t) => s + (text.includes(t) ? 1 : 0), 0);
+      if (score > 0) {
+        results.push({
+          file: name,
+          source: "skill",
+          docTitle: doc.title,
+          heading: section.heading,
+          body: section.body.trim(),
+          // Nudge skill results slightly ahead of extended on ties — the skill
+          // is the curated layer; extended is the exhaustive API reference.
+          score: score + 0.1,
+        });
+      }
+    }
+  }
+
+  // Extended docs (charts/, concepts/, getting-started/, reference/<class>) —
+  // this is where the per-class API + defaults live. Only scanned when scope=all.
+  if (scope === "all") {
+    for (const [key, doc] of content.extendedDocs) {
+      for (const section of doc.sections) {
+        const text = (section.heading + " " + section.body).toLowerCase();
+        const score = terms.reduce((s, t) => s + (text.includes(t) ? 1 : 0), 0);
+        if (score > 0) {
+          results.push({
+            file: key,
+            source: "extended",
+            docTitle: doc.title,
+            heading: section.heading,
+            body: section.body.trim(),
+            score,
+          });
+        }
+      }
+    }
+  }
+
+  results.sort((a, b) => b.score - a.score);
+  return results.slice(0, maxResults);
+}