@taylorwong/ichartjs 2.0.3 → 2.0.4

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 2.0.4 - 2026-09-18
+
+- Synchronized current Agent documentation, scoped package paths, GitHub fallback instructions, Skill links, Playground links, and release status.
+- Corrected Runtime and Playground version displays to `2.0.4`.
+- Marked the original `2.0.0` release-readiness document as historical and added stronger documentation consistency checks.
+
+## 2.0.3 - 2026-09-17
+
+- Completed Iteration 8 acceptance documentation and added the author-only release SOP.
+- Added README and official Skill release guardrails for the scoped npm package and controlled publishing workflow.
+
+## 2.0.2 - 2026-09-17
+
+- Fixed Line and Area rendering so `fill: 'none'` does not create an unintended filled area.
+
+## 2.0.1 - 2026-09-17
+
+- Added dual-engine raster export, branding signature support, and synchronized documentation and TypeScript declarations.
+
 ## 2.0.0 - 2026-09-16
 
 - Added Iteration 9's lightweight visual style system with adaptive modes, semantic presets and palettes, live switching, contrast diagnostics, Agent recommendations, bilingual guidance, and Theme Gallery while retaining version `2.0.0`.

package/README.md

@@ -20,9 +20,9 @@ getCapabilities
 
 | Need | Entry point |
 | --- | --- |
-| Runtime and Agent planning APIs | `ichartjs` |
-| Machine-readable capability manifest | `ichartjs/capabilities.json` |
-| Intent and chart recipes | `ichartjs/recipes/*` |
+| Runtime and Agent planning APIs | `@taylorwong/ichartjs` |
+| Machine-readable capability manifest | `@taylorwong/ichartjs/capabilities.json` |
+| Intent and chart recipes | `@taylorwong/ichartjs/recipes/*` |
 | Agent quickstart | [`docs/agent/quickstart.md`](docs/agent/quickstart.md) |
 | Chinese quickstart | [`docs/agent/zh-CN/quickstart.md`](docs/agent/zh-CN/quickstart.md) |
 | Coding Agent integration | [`docs/agent/coding-agent-integration.md`](docs/agent/coding-agent-integration.md) |
@@ -36,7 +36,7 @@ getCapabilities
 npm install @taylorwong/ichartjs@^2
 ```
 
-As a fallback for environments without npm access, install directly from GitHub: `npm install github:wanghetommy/ichartjs#v2.0.1`.
+As a fallback for environments without npm access, install directly from GitHub: `npm install github:wanghetommy/ichartjs#v2.0.4`.
 
 ### Optional Agent Skill
 
@@ -52,7 +52,7 @@ From a repository checkout, install it into Codex with:
 cp -R skills/ichartjs "${CODEX_HOME:-$HOME/.codex}/skills/"
 ```
 
-WorkBuddy users can import or register the same `skills/ichartjs` folder through the host's Skill interface. Package consumers can copy it from `node_modules/ichartjs/skills/ichartjs` into their Agent host's Skill directory. After installation, invoke it as `$ichartjs` when the host supports named Skill invocation, or select the `ichartjs` Skill in the host UI.
+WorkBuddy users can import or register the same `skills/ichartjs` folder through the host's Skill interface. Package consumers can copy it from `node_modules/@taylorwong/ichartjs/skills/ichartjs` into their Agent host's Skill directory. After installation, invoke it as `$ichartjs` when the host supports named Skill invocation, or select the `ichartjs` Skill in the host UI.
 
 ### Agent workflow
 
@@ -140,9 +140,14 @@ npm run playground
 - Playground Home: `http://localhost:3000/playground/index.html`
 - Agent Workbench: `http://localhost:3000/playground/agent-workbench.html`
 - Complete Gallery: `http://localhost:3000/playground/project-gallery.html`
+- Foundational Gallery: `http://localhost:3000/playground/foundational-gallery.html`
 - Theme Gallery: `http://localhost:3000/playground/theme-gallery.html`
+- Business Editing: `http://localhost:3000/playground/editing.html`
 - Project Intelligence: `http://localhost:3000/playground/project-intelligence.html`
 - Diagram Editor: `http://localhost:3000/playground/diagram-editor.html`
+- Interaction Lab: `http://localhost:3000/playground/interaction-lab.html`
+- Accessibility Lab: `http://localhost:3000/playground/accessibility-lab.html`
+- Performance Lab: `http://localhost:3000/playground/performance-lab.html`
 
 ## For Developers
 
@@ -199,7 +204,7 @@ Contributors should:
 1. Open PRs / commit only to `develop`
 2. Ensure `npm run agent:check` and `npm test` are green
 
-Full author-only release SOP (exact 13-step sequence + must-not rules + rollback procedure):
+Full author-only release SOP (preconditions, release sequence, must-not rules, and rollback procedure):
 👉 [`docs/agent/development/release-sop.md`](docs/agent/development/release-sop.md)
 
 Start with [`docs/agent/quickstart.md`](docs/agent/quickstart.md). Detailed runtime, charting, project, diagram, and editing contracts live in [`docs/agent/`](docs/agent/).

package/docs/agent/README.md

@@ -21,7 +21,7 @@ This is the user-facing Agent entry point for iChart.js 2.0. Read this file firs
 - [Editing Contract](editing-contract.md): schemas, commands, preview, commit, and undo/redo.
 - Machine-readable capability manifests are in `docs/manifests/` and should be loaded on demand.
 
-The 2.0 API is Spec-first. Import from `ichartjs`, inspect data, plan a chart, create a JSON-friendly Spec, validate it, render it, and self-check the explanation and runtime state.
+The 2.0 API is Spec-first. Import from `@taylorwong/ichartjs`, inspect data, plan a chart, create a JSON-friendly Spec, validate it, render it, and self-check the explanation and runtime state.
 
 ## Recommended flow
 

package/docs/agent/coding-agent-integration.md

@@ -4,7 +4,7 @@ Use this guide with Codex, WorkBuddy, and similar Agents that can read a reposit
 
 ## Responsibility Boundary
 
-iChart.js is a JavaScript UI component library. The coding Agent writes or updates the host application and calls the public `ichartjs` ESM API. The optional Skill provides workflow guidance only; it does not introduce a second runtime or service.
+iChart.js is a JavaScript UI component library. The coding Agent writes or updates the host application and calls the public `@taylorwong/ichartjs` ESM API. The optional Skill provides workflow guidance only; it does not introduce a second runtime or service.
 
 Do not add a CLI, MCP server, HTTP API, or Python adapter to complete an ordinary charting task.
 
@@ -16,7 +16,7 @@ Inside a consumer project:
 npm install @taylorwong/ichartjs@^2
 ```
 
-Do not install the unscoped npm registry package named `ichartjs`; it is currently an npm security holding package. Use the GitHub source until the project publishes under a confirmed npm scope.
+Do not install the unscoped npm registry package named `ichartjs`; it is an npm security holding package and is not this project. The published package is `@taylorwong/ichartjs`.
 
 Inside this repository:
 
@@ -46,7 +46,7 @@ If the host supports named Skill invocation, the request may start with `Use $ic
 ## Required Workflow
 
 1. Inspect existing application structure and local instructions.
-2. Import public APIs from `ichartjs`.
+2. Import public APIs from `@taylorwong/ichartjs`.
 3. Call `getCapabilities()`, `inspectData()`, and `planChart()`.
 4. Stop or ask for input when required fields are missing.
 5. Build a JSON-friendly Spec and call `validateSpec()`.
@@ -80,7 +80,7 @@ Use `examples/agent-workflow.mjs` for the full executable lifecycle.
 
 ## Acceptance
 
-- The application imports only `ichartjs`, not source internals.
+- The application imports only `@taylorwong/ichartjs`, not source internals.
 - The chosen chart exists in capabilities.
 - Validation passes before rendering.
 - Warnings and assumptions remain visible.

package/docs/agent/development/2.0-release-readiness.md

@@ -1,5 +1,7 @@
 # iChart.js 2.0 Final Release Readiness
 
+> Historical record. This document describes the original `2.0.0` source-release decision and is superseded by the published `2.0.x` release line. Use `release-sop.md` for current releases.
+
 Date: 2026-09-16
 
 ## Decision

package/docs/agent/development/release-sop.md

@@ -8,7 +8,7 @@
 >
 > **Agent Policy:** An Agent MUST NOT initiate any step in this SOP on its own.
 > It MAY execute the sequence **only when explicitly instructed** by the author
-> (e.g. "publish v2.0.3", "commit and release patch", or equivalent intent).
+> (e.g. "publish v2.0.4", "commit and release patch", or equivalent intent).
 
 ## 0. Preconditions (MUST ALL be green)
 

package/docs/agent/development/roadmap.md

@@ -1,6 +1,6 @@
 # iChart.js 2.0 Roadmap
 
-> Roadmap baseline: 2026-09-14. Geographic charts and 3D rendering remain out of scope until explicitly reintroduced.
+> Roadmap baseline: 2026-09-14. Current release status: `v2.0.3` is published and `v2.0.4` is the documentation/version-consistency patch release. Geographic charts and 3D rendering remain out of scope until explicitly reintroduced.
 
 ## Current Status
 
@@ -11,8 +11,8 @@
 - Iteration 6 project intelligence local runtime and browser acceptance are complete.
 - Iteration 7 local runtime and browser acceptance are complete for foundational composition, Heatmap, and Radar; physical-device checks remain host integration evidence.
 - Iteration 8A–8D is complete and accepted in automated tests, Chromium, Firefox 144, WebKit 26, native Safari 26.6.2, and a 390 px touch viewport. Physical iOS/Android and representative release-host measurements remain post-release host/device follow-up. No new public chart type was introduced.
-- Iteration 9A–9D implements the lightweight visual style system, adaptive theme planning, runtime switching, renderer integration, and bilingual Agent guidance without adding a chart type or changing version `2.0.0`.
-- Final `2.0.0` readiness is tracked in `docs/agent/development/2.0-release-readiness.md`; strict TypeScript, Node.js 18/20/22, GitHub Actions, package-consumer, browser, performance, and lifecycle checks pass. Only the final commit, `master` cutover, tag, and GitHub Release remain. npm publication is tracked separately.
+- Iteration 9A–9D implemented the lightweight visual style system, adaptive theme planning, runtime switching, renderer integration, and bilingual Agent guidance without adding a chart type; these capabilities remain in the `2.0.x` line.
+- The original `2.0.0` readiness record is historical and superseded by the published `2.0.x` releases. Current release checks are defined by `docs/agent/development/release-sop.md`.
 
 ## Iteration 4 — Agent Data Contract and Business Editing
 

package/docs/agent/frontend-integration.md

@@ -8,7 +8,7 @@ Use iChart.js as an ordinary JavaScript UI component inside a browser applicatio
 npm install @taylorwong/ichartjs@^2
 ```
 
-For environments without npm registry access, install from GitHub as a fallback: `npm install github:wanghetommy/ichartjs#v2.0.1`.
+For environments without npm registry access, install from GitHub as a fallback: `npm install github:wanghetommy/ichartjs#v2.0.4`.
 
 Use the package through a bundler or another environment that resolves npm ESM imports:
 

package/docs/agent/quickstart.md

@@ -15,14 +15,14 @@ import {
 } from '@taylorwong/ichartjs';
 ```
 
-Agents and developers use the same `ichartjs` ESM entry. Agent behavior comes from the public planning APIs and optional Skill, not from a second runtime.
+Agents and developers use the same `@taylorwong/ichartjs` ESM entry. Agent behavior comes from the public planning APIs and optional Skill, not from a second runtime.
 
 Additional package resources:
 
-- `ichartjs/capabilities.json`: machine-readable catalog, including per-chart exports, branding, and interaction declarations.
-- `ichartjs/recipes/foundational-analysis`: foundational chart recipes.
-- `ichartjs/recipes/project-management`: project intelligence recipes.
-- `ichartjs/recipes/diagrams/workflow`: diagram editing recipe.
+- `@taylorwong/ichartjs/capabilities.json`: machine-readable catalog, including per-chart exports, branding, and interaction declarations.
+- `@taylorwong/ichartjs/recipes/foundational-analysis`: foundational chart recipes.
+- `@taylorwong/ichartjs/recipes/project-management`: project intelligence recipes.
+- `@taylorwong/ichartjs/recipes/diagrams/workflow`: diagram editing recipe.
 - `skills/ichartjs/SKILL.md`: optional workflow adapter for Codex, WorkBuddy, and other Agent Skills-compatible hosts.
 
 The Skill is not the runtime. Install or register it only when the Agent host supports Skills; it must still call the package's public APIs and capability contract.

package/docs/agent/zh-CN/coding-agent-integration.md

@@ -14,7 +14,7 @@ iChart.js 是 JavaScript UI 图表组件库。编码 Agent 负责修改宿主前
 npm install @taylorwong/ichartjs@^2
 ```
 
-npm Registry 中无作用域的 `ichartjs` 当前是安全占位包，并非本项目。正式 npm scope 确认前请从 GitHub 安装。
+npm Registry 中无作用域的 `ichartjs` 是安全占位包，并非本项目。正式包名是 `@taylorwong/ichartjs`，优先从 npm 安装。
 
 Codex、WorkBuddy 和其他兼容 Agent Skills 的宿主可共同使用 `skills/ichartjs`。从仓库检出目录安装到 Codex：
 

package/docs/agent/zh-CN/diagram-scenario.md

@@ -9,13 +9,13 @@
 
 ## 当前能力
 
-已支持节点、边、泳道、Group、Port、四种布局、三种路由、节点拖动、多选、对齐、网格吸附、键盘移动和 Undo/Redo。
+已支持节点、边、泳道、Group、Port、四种布局、三种路由、节点拖动、多选、对齐、网格吸附、键盘移动、Copy/Paste、Group 折叠展开、Port 键盘连线和 Undo/Redo。
 
 当前限制：
 
 - Group 只支持平级 Group，不支持嵌套。
-- Port 可显示并参与路由，但 Port 拖拽连线尚未完成。
-- Copy/Paste 和 Group 折叠展开尚未完成。
+- Group bounds 由成员几何和 `group.padding` 推导；`resizeGroup` 会缩放成员位置和尺寸，不持久化第二个 Group 矩形。
+- Canvas 提供基础无障碍文本，SVG 提供更丰富的 Diagram 语义。
 
 ## Agent 流程
 

package/docs/agent/zh-CN/frontend-integration.md

@@ -6,7 +6,7 @@ iChart.js 应作为普通 JavaScript UI 组件运行在浏览器应用中。数
 npm install @taylorwong/ichartjs@^2
 ```
 
-无法访问 npm Registry 的环境请用 GitHub 源作为后备：`npm install github:wanghetommy/ichartjs#v2.0.1`。
+无法访问 npm Registry 的环境请用 GitHub 源作为后备：`npm install github:wanghetommy/ichartjs#v2.0.4`。
 
 ```js
 import { createChart } from '@taylorwong/ichartjs';

package/docs/agent/zh-CN/quickstart.md

@@ -15,9 +15,9 @@ import {
 } from '@taylorwong/ichartjs';
 ```
 
-- `ichartjs`：统一的 Agent 规划与 Runtime API。
-- `ichartjs/capabilities.json`：机器可读能力清单，包含逐图表导出、署名和交互声明。
-- `ichartjs/recipes/*`：基础分析、项目管理和 Diagram Recipes。
+- `@taylorwong/ichartjs`：统一的 Agent 规划与 Runtime API。
+- `@taylorwong/ichartjs/capabilities.json`：机器可读能力清单，包含逐图表导出、署名和交互声明。
+- `@taylorwong/ichartjs/recipes/*`：基础分析、项目管理和 Diagram Recipes。
 - `skills/ichartjs/SKILL.md`：适用于 Codex、WorkBuddy 等 Agent Skills 兼容宿主的可选编排层。
 
 Agent 与开发者使用同一个 ESM 入口。编码 Agent 的完整方式见 [编码 Agent 集成](coding-agent-integration.md)，普通应用集成见 [前端项目集成](frontend-integration.md)。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taylorwong/ichartjs",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "description": "Agent-first, renderer-independent charting and project visualization runtime",
   "type": "module",
   "main": "./src/index.mjs",

package/skills/ichartjs/SKILL.md

@@ -35,7 +35,7 @@ Do not install the unscoped npm registry package named `ichartjs`; it is current
 10. Provide an exact preview URL or artifact path and report assumptions, warnings, and deferred checks.
 11. Prefer `theme: { mode: 'auto', preset, palette }`; preserve explicit user style choices and use `chart.setTheme()` for live switching.
 
-Use `ichartjs` for package imports. Use `examples/agent-workflow.mjs` as the executable baseline when working in the repository.
+Use `@taylorwong/ichartjs` for package imports. Use `examples/agent-workflow.mjs` as the executable baseline when working in the repository.
 
 ## Task Routing
 
@@ -44,7 +44,7 @@ Use `ichartjs` for package imports. Use `examples/agent-workflow.mjs` as the exe
 - For Flow or Swimlane, preserve node, edge, lane, group, and port IDs; use diagram recipes and validated edit commands.
 - For business edits, preview first, preserve the preview ID and revision, require confirmation when declared, then commit or reject atomically.
 - For browser deliverables, start `npm run playground` and return the exact maintained Playground URL.
-- Release workflow (npm publish + develop→master merge) is **AUTHOR ONLY**. Read the 13-step SOP in [`docs/agent/development/release-sop.md`](../../../docs/agent/development/release-sop.md). Never initiate any release step unless the author explicitly instructs.
+- Release workflow (npm publish + develop→master merge) is **AUTHOR ONLY**. Read the release SOP in [`docs/agent/development/release-sop.md`](../../docs/agent/development/release-sop.md). Never initiate any release step unless the author explicitly instructs.
 
 ## Guardrails
 

package/src/index.mjs

@@ -559,4 +559,4 @@ export { normalizeProjectCalendar, applyWorkingCalendar, normalizeDependencies,
 export { normalizeLinkedFilters, normalizeLinkedSelection, filterProjectRows, createLinkedProjectState, linkedRecordId };
 
 export { contrastRatio, planStyle, resolveTheme, styleCapabilities, themeModes, themePalettes, themePresets, validateThemeContrast, annotationPlugin, dataZoomPlugin, dataLabelsPlugin, accessibilityPlugin };
-export const iChart = { version: '2.0.0', createChart, inspectData, normalizeData, binData, applyTransforms, normalizeSpec, validateSpec, data, getCapabilities, getChartCapability, planChart, recommend, explainChart, contrastRatio, planStyle, resolveTheme, styleCapabilities, themeModes, themePalettes, themePresets, validateThemeContrast, annotationPlugin, dataZoomPlugin, dataLabelsPlugin, accessibilityPlugin, getBusinessSchema, inspectDataSchema, validateData, getEditCapabilities, validateEdit, previewEdit, commitPreview, validateRecipe, normalizeProjectCalendar, applyWorkingCalendar, normalizeDependencies, analyzeSchedule, analyzeBurndownSeries, analyzeCapacity, buildCapacityView, buildCumulativeFlowSeries, buildVelocitySeries, buildReleaseForecast, buildRiskMatrixSeries, buildIssueAgingSeries, normalizeLinkedFilters, normalizeLinkedSelection, filterProjectRows, createLinkedProjectState, linkedRecordId };
+export const iChart = { version: '2.0.4', createChart, inspectData, normalizeData, binData, applyTransforms, normalizeSpec, validateSpec, data, getCapabilities, getChartCapability, planChart, recommend, explainChart, contrastRatio, planStyle, resolveTheme, styleCapabilities, themeModes, themePalettes, themePresets, validateThemeContrast, annotationPlugin, dataZoomPlugin, dataLabelsPlugin, accessibilityPlugin, getBusinessSchema, inspectDataSchema, validateData, getEditCapabilities, validateEdit, previewEdit, commitPreview, validateRecipe, normalizeProjectCalendar, applyWorkingCalendar, normalizeDependencies, analyzeSchedule, analyzeBurndownSeries, analyzeCapacity, buildCapacityView, buildCumulativeFlowSeries, buildVelocitySeries, buildReleaseForecast, buildRiskMatrixSeries, buildIssueAgingSeries, normalizeLinkedFilters, normalizeLinkedSelection, filterProjectRows, createLinkedProjectState, linkedRecordId };