@taylorwong/ichartjs 2.0.1

package/CHANGELOG.md

@@ -0,0 +1,69 @@
+# Changelog
+
+## 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`.
+- Released the new Agent-first iChart.js 2.0 product line with one ESM/TypeScript runtime surface, 16 public chart types, project intelligence, controlled diagram editing, capability discovery, planning, validation, explanation, and stable lineage.
+- Accepted 51 core tests, the executable Agent workflow, official Skill validation, strict TypeScript consumption, package installation, and Node.js 18/20/22 GitHub Actions.
+- Accepted Chromium, Firefox 144, WebKit 26, and native Safari 26.6.2 across maintained Playground pages, plus 390 x 844 responsive/touch viewport checks.
+- Accepted local 5,000-row Line and Heatmap, 1,000-task Gantt, 300-node Diagram, Canvas/SVG, and lifecycle samples.
+- Deferred npm publication while retaining GitHub Tag installation. Physical iOS/Android verification remains a documented host/device follow-up and does not block the source release.
+
+## 2.0.0-rc.1 Iteration 8 - 2026-09-16
+
+- Reorganized the root README around the Agent discovery, inspection, planning, validation, rendering, and self-check workflow.
+- Added one publishable ESM entry plus manifest, recipe, TypeScript, example, and official Skill package surfaces.
+- Added English and Chinese Agent quickstarts plus an executable end-to-end Agent workflow.
+- Completed common presentation and geometry behavior across the existing 16 public chart types without adding a new type.
+- Added per-chart capability profiles, deterministic Agent planning, richer data inspection, validation diagnostics, explanations, and stable lineage output.
+- Added a unified Playground home, full Gallery, Agent Workbench, Interaction Lab, Accessibility Lab, Performance Lab, and a no-cache preview server.
+- Expanded TypeScript declarations, manifests, bilingual Agent contracts, regression tests, and local browser acceptance evidence.
+- Added Node.js 18/20/22 CI, contribution guidance, private vulnerability-reporting guidance, and an Apache 2.0 license file.
+- Completed Chromium, Firefox 144, and WebKit 26 desktop/mobile-viewport regression plus local 5,000-row performance and lifecycle samples.
+- Kept native Safari automation, physical iOS/Android, and representative release-host performance checks as explicit RC release gates.
+
+## 2.0.0-alpha.1 - 2026-09-14
+
+- Added the initial 2.0 module tree under `src/`.
+- Added JSON-friendly Chart Spec normalization and validation.
+- Added data normalization and inspection.
+- Added renderer-independent Scene Graph.
+- Added Canvas and SVG renderers.
+- Added line, area, bar, column, and pie charts.
+- Added basic hover, click, tooltip, resize, and export APIs.
+- Added Node-based core tests.
+
+The legacy 1.x implementation remains unchanged.
+
+## 2.0.0-beta.1 - 2026-09-14
+
+- Added chainable data transforms: filter, sortBy, groupBy, sum, average, topN, and percentage.
+- Added selection state, selected data, element lookup, JSON patches, and zoom reset APIs.
+- Added standalone Scale primitives for category, linear, and time mapping.
+- Added multi-series line/column rendering with left and right y-axis mappings.
+- Added temporal x-axis tick generation and adaptive date labels.
+- Added touch pan, pinch zoom, pointer brush, wheel zoom, and keyboard focus navigation.
+- Added Annotation, DataZoom, DataLabels, and Accessibility plugin exports.
+
+## Iteration 3 plan - 2026-09-14
+
+- Planned project-management views: Gantt, timeline, milestone, and burndown.
+- Planned process visualizations: flow chart and swimlane chart.
+- Planned shared interval, dependency, graph layout, lane, interaction, accessibility, export, and Agent Recipe capabilities.
+- Deferred geographic charts, 3D rendering, fishbone diagrams, organization charts, dependency networks, resource-load views, and Kanban boards.
+
+## Iteration 3 product hardening - 2026-09-14
+
+- Added Gantt critical-path analysis with automatic critical tasks, dependency arrowheads, and critical-edge emphasis.
+- Added Flow node dragging with persisted `node.position`, edge rerouting, `drag`, and `dragend` events.
+- Added Burndown scope-change markers, total-scope series, completion velocity, and estimated finish date.
+- Added project-specific tooltips for tasks, milestones, burndown points, nodes, and swimlanes.
+- Added shared project viewport scaling, mobile single-finger drag, and two-finger pinch behavior.
+- Added renderer-independent scene-structure checks for SVG and Canvas outputs.
+
+## Iteration 4 plan - 2026-09-14
+
+- Planned a versioned Business Data Schema for Agent-readable fields, permissions, relationships, and business rules.
+- Planned typed Edit Commands for task scheduling, progress, dependencies, milestones, Flow nodes, and Swimlane ownership.
+- Planned deterministic preview diffs, confirmation policies, audit records, rollback, undo, redo, and stale-version protection.
+- Planned TypeScript declarations, Recipe validation, headless preview/export, and an editing acceptance demo.

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,194 @@
+# iChart.js 2.0
+
+iChart.js is an Agent-first, renderer-independent visualization runtime. An Agent can inspect data, choose an appropriate chart, generate and validate a JSON-friendly Spec, render it with SVG or Canvas, and explain the result through public APIs.
+
+## For AI Agents
+
+Do not guess chart types or configuration fields from source code. Use the public planning contract:
+
+```text
+getCapabilities
+  → inspectData
+  → planChart
+  → build Spec
+  → validateSpec
+  → createChart
+  → chart.explain + chart.getState
+```
+
+### Agent entry points
+
+| Need | Entry point |
+| --- | --- |
+| Runtime and Agent planning APIs | `ichartjs` |
+| Machine-readable capability manifest | `ichartjs/capabilities.json` |
+| Intent and chart recipes | `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) |
+| Frontend integration | [`docs/agent/frontend-integration.md`](docs/agent/frontend-integration.md) |
+| Visual style and themes | [`docs/agent/theme-guide.md`](docs/agent/theme-guide.md) |
+| Official Agent Skill for Codex and WorkBuddy | [`skills/ichartjs/SKILL.md`](skills/ichartjs/SKILL.md) |
+
+### Install
+
+```bash
+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`.
+
+### Optional Agent Skill
+
+The runtime API remains the source of truth; the Skill only teaches and orchestrates the workflow. Codex, WorkBuddy, and other Agent Skills-compatible hosts can import the same versioned Skill from:
+
+```text
+https://github.com/wanghetommy/ichartjs/tree/master/skills/ichartjs
+```
+
+From a repository checkout, install it into Codex with:
+
+```bash
+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.
+
+### Agent workflow
+
+```js
+import {
+  createChart,
+  getCapabilities,
+  inspectData,
+  planChart,
+  validateSpec
+} from '@taylorwong/ichartjs';
+
+const rows = [
+  { id: 'jan', month: 'Jan', revenue: 120 },
+  { id: 'feb', month: 'Feb', revenue: 148 },
+  { id: 'mar', month: 'Mar', revenue: 136 }
+];
+
+const capabilities = getCapabilities();
+const inspection = inspectData(rows);
+const plan = planChart(rows, { intent: 'trend', renderer: 'svg' });
+
+const candidate = {
+  type: plan.primary,
+  renderer: 'svg',
+  data: { values: rows },
+  encoding: {
+    x: { field: plan.suggestedEncodings.dimension },
+    y: { field: plan.suggestedEncodings.measure }
+  },
+  accessibility: { enabled: true },
+  theme: {
+    mode: 'auto',
+    preset: plan.styleRecommendation.preset,
+    palette: plan.styleRecommendation.palette
+  }
+};
+
+const validation = validateSpec(candidate);
+if (!validation.valid) throw new Error(JSON.stringify(validation.errors));
+
+const chart = createChart(validation.spec);
+const agentResult = {
+  contractVersion: capabilities.contractVersion,
+  inspection,
+  plan,
+  explanation: chart.explain(),
+  state: chart.getState()
+};
+
+chart.destroy();
+```
+
+Run the complete executable workflow with:
+
+```bash
+npm run example:agent
+```
+
+Source: [`examples/agent-workflow.mjs`](examples/agent-workflow.mjs).
+
+### Agent rules
+
+- Call `getCapabilities()` instead of inventing chart types or options.
+- Treat `inspectData()` field roles and units as inferences, not business truth.
+- Stop and report `plan.requiredFields` when required data is missing.
+- Call `validateSpec()` before every render or edit.
+- Preserve stable source record IDs for selection, linking, and explanation.
+- Return assumptions, warnings, unsupported requests, and validation diagnostics to the user.
+- Use `chart.explain()` and `chart.getState()` for self-checking.
+- Never generate geographic or 3D Specs unless the capability contract adds them.
+
+### Integration boundary
+
+iChart.js is a JavaScript UI component library. Coding Agents use the same ESM API as developers and may optionally load the Skill for workflow guidance. A daily-use assistant can use iChart.js only inside a host web application that runs JavaScript; integrating a non-coding assistant is the host application's responsibility. The core package does not add a CLI, MCP server, HTTP service, or Python runtime.
+
+## Preview and Acceptance
+
+Start the cache-safe local server:
+
+```bash
+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`
+- Theme Gallery: `http://localhost:3000/playground/theme-gallery.html`
+- Project Intelligence: `http://localhost:3000/playground/project-intelligence.html`
+- Diagram Editor: `http://localhost:3000/playground/diagram-editor.html`
+
+## For Developers
+
+Use the main package entry when the chart type and Spec are already known:
+
+```js
+import { createChart } from '@taylorwong/ichartjs';
+
+const chart = createChart({
+  container: '#chart',
+  type: 'line',
+  renderer: 'svg',
+  data: {
+    values: [
+      { id: 'jan', month: 'Jan', sales: 120 },
+      { id: 'feb', month: 'Feb', sales: 180 }
+    ]
+  },
+  encoding: {
+    x: { field: 'month', type: 'category' },
+    y: { field: 'sales', type: 'quantitative' }
+  },
+  title: { text: 'Monthly Sales' }
+});
+```
+
+The public package includes ESM exports, TypeScript declarations, Agent documentation, manifests, recipes, examples, and the official Skill. The runtime has no external production dependency.
+
+## Supported Surface
+
+- Foundational charts: Line, Area, Bar, Column, Pie/Donut, Scatter, Funnel, Gauge, Heatmap, and Radar.
+- Project views: Gantt, Timeline, Milestone, and Burndown.
+- Diagrams: Flow and Swimlane with groups, ports, routing, and controlled editing.
+- Renderers: SVG and Canvas.
+- Agent contracts: capability discovery, data inspection, planning, validation, explanation, lineage, diagnostics, and safe editing.
+- Branding signature: low-contrast `Powered by iChart.js` bottom-right watermark, consistent across live view and all export formats; controlled via `branding` on Spec/Theme.
+- Exports: JSON (spec + runtime state, all environments), SVG (vector, zero-dependency headless), PNG/JPEG (raster, dual-engine, browser native + headless with optional `canvas` dependency), plus browser `downloadPNG/SVG/JSON` helpers.
+- Deferred: geographic charts and 3D rendering.
+
+## Development
+
+```bash
+npm run agent:check
+npm run playground
+```
+
+Start with [`docs/agent/quickstart.md`](docs/agent/quickstart.md). Detailed runtime, charting, project, diagram, and editing contracts live in [`docs/agent/`](docs/agent/).
+
+Contribution requirements are in [`CONTRIBUTING.md`](CONTRIBUTING.md). Report vulnerabilities privately according to [`SECURITY.md`](SECURITY.md).

package/agent-recipes/diagrams/agent-orchestration.json

@@ -0,0 +1,18 @@
+{
+  "name": "agent-orchestration-diagram",
+  "version": "2.0",
+  "intent": "agent-orchestration",
+  "spec": {
+    "type": "flow",
+    "renderer": "svg",
+    "diagram": { "layout": "layered", "routing": "orthogonal", "grid": 8 },
+    "groups": [{ "id": "workers", "label": "Worker Agents", "padding": 20 }],
+    "nodes": [
+      { "id": "router", "label": "Router" },
+      { "id": "research", "label": "Research", "groupId": "workers" },
+      { "id": "writer", "label": "Writer", "groupId": "workers" },
+      { "id": "review", "label": "Review" }
+    ],
+    "edges": [{ "from": "router", "to": "research" }, { "from": "research", "to": "writer" }, { "from": "writer", "to": "review" }]
+  }
+}

package/agent-recipes/diagrams/approval-process.json

@@ -0,0 +1,16 @@
+{
+  "name": "approval-process-diagram",
+  "version": "2.0",
+  "intent": "approval-process",
+  "spec": {
+    "type": "flow",
+    "renderer": "svg",
+    "diagram": { "layout": "layered", "routing": "orthogonal", "grid": 8 },
+    "nodes": [
+      { "id": "request", "label": "Request", "ports": [{ "id": "out", "side": "right" }] },
+      { "id": "review", "label": "Review", "ports": [{ "id": "in", "side": "left" }, { "id": "out", "side": "right" }] },
+      { "id": "approved", "label": "Approved", "ports": [{ "id": "in", "side": "left" }] }
+    ],
+    "edges": [{ "id": "request-review", "from": "request", "to": "review", "fromPort": "out", "toPort": "in" }]
+  }
+}

package/agent-recipes/diagrams/responsibility-mapping.json

@@ -0,0 +1,13 @@
+{
+  "name": "responsibility-mapping-diagram",
+  "version": "2.0",
+  "intent": "responsibility",
+  "spec": {
+    "type": "swimlane",
+    "renderer": "svg",
+    "diagram": { "layout": "layered", "routing": "orthogonal", "grid": 8 },
+    "lanes": [{ "id": "product", "label": "Product" }, { "id": "engineering", "label": "Engineering" }],
+    "nodes": [{ "id": "scope", "label": "Define Scope", "laneId": "product" }, { "id": "build", "label": "Build", "laneId": "engineering" }, { "id": "accept", "label": "Accept", "laneId": "product" }],
+    "edges": [{ "from": "scope", "to": "build" }, { "from": "build", "to": "accept" }]
+  }
+}

package/agent-recipes/diagrams/workflow.json

@@ -0,0 +1,19 @@
+{
+  "name": "workflow-diagram",
+  "version": "2.0",
+  "intent": "workflow",
+  "spec": {
+    "type": "flow",
+    "renderer": "svg",
+    "diagram": { "layout": "layered", "routing": "orthogonal", "grid": 8 },
+    "nodes": [],
+    "edges": []
+  },
+  "commands": [
+    { "type": "layout-edit", "operations": [{ "op": "moveNode", "nodeId": "review", "position": { "x": 320, "y": 120 } }] },
+    { "type": "layout-edit", "operations": [{ "op": "resizeNode", "nodeId": "review", "size": { "width": 180, "height": 56 } }] },
+    { "type": "layout-edit", "reason": "Align selected workflow nodes", "operations": [{ "op": "alignNodes", "nodeIds": ["review", "qa"], "alignment": "left" }] },
+    { "type": "layout-edit", "reason": "Snap selected workflow nodes to grid", "operations": [{ "op": "snapNodes", "nodeIds": ["review", "qa"] }] }
+    ,{ "type": "layout-edit", "reason": "Resize the delivery group member bounds", "operations": [{ "op": "resizeGroup", "groupId": "delivery", "size": { "width": 320, "height": 180 } }] }
+  ]
+}

package/agent-recipes/foundational-analysis.json

@@ -0,0 +1,18 @@
+{
+  "name": "foundational-analysis-views",
+  "version": "2.0",
+  "intentMappings": {
+    "composition": "column",
+    "distribution": "column",
+    "matrix": "heatmap",
+    "multidimensional": "radar"
+  },
+  "examples": {
+    "stacked": { "type": "column", "stack": "stacked", "encoding": { "x": { "field": "period" }, "y": [{ "field": "product" }, { "field": "service" }] }, "data": [] },
+    "donut": { "type": "pie", "innerRadius": 0.55, "data": [{ "name": "Product", "value": 60 }, { "name": "Service", "value": 40 }] },
+    "combo": { "type": "column", "encoding": { "x": { "field": "period" }, "y": [{ "field": "sales", "mark": "column" }, { "field": "rate", "mark": "line", "axis": "right" }] }, "data": [] },
+    "histogram": { "type": "column", "transform": { "type": "bin", "field": "score", "thresholds": 8 }, "encoding": { "x": { "field": "name" }, "y": { "field": "value" } }, "data": [] },
+    "heatmap": { "type": "heatmap", "encoding": { "x": { "field": "day" }, "y": { "field": "period" }, "color": { "field": "value" } }, "data": [] },
+    "radar": { "type": "radar", "indicators": [{ "name": "Quality", "field": "quality", "min": 0, "max": 100 }, { "name": "Speed", "field": "speed", "min": 0, "max": 100 }, { "name": "Experience", "field": "experience", "min": 0, "max": 100 }], "data": [] }
+  }
+}

package/agent-recipes/project-management.json

@@ -0,0 +1,47 @@
+{
+  "name": "project-management-views",
+  "version": "2.0",
+  "intentMappings": {
+    "schedule": "gantt",
+    "milestone": "milestone",
+    "progress": "burndown",
+    "variance": "gantt",
+    "capacity": "column",
+    "release": "burndown",
+    "risk": "scatter",
+    "aging": "bar",
+    "workflow": "flow",
+    "responsibility": "swimlane"
+  },
+  "examples": {
+    "gantt": {
+      "type": "gantt",
+      "renderer": "svg",
+      "project": {
+        "overlays": {
+          "criticalPath": true,
+          "slack": true,
+          "baseline": true,
+          "actual": true,
+          "variance": true
+        },
+        "calendar": {
+          "timezone": "UTC",
+          "workingWeekdays": [1, 2, 3, 4, 5],
+          "holidays": ["2026-09-10"]
+        }
+      },
+      "data": [
+        { "id": "design", "name": "Design", "start": "2026-09-01", "end": "2026-09-05", "baselineStart": "2026-09-01", "baselineEnd": "2026-09-04", "actualStart": "2026-09-01", "actualEnd": "2026-09-05", "owner": "Alex", "progress": 100, "status": "done" }
+      ]
+    },
+    "timeline": { "type": "timeline", "renderer": "svg", "data": [{ "date": "2026-09-01", "title": "Kickoff" }] },
+    "milestone": { "type": "milestone", "renderer": "svg", "data": [{ "date": "2026-09-19", "title": "Release", "baselineDate": "2026-09-17", "actualDate": "2026-09-19" }] },
+    "burndown": { "type": "burndown", "renderer": "svg", "data": [{ "date": "2026-09-01", "remaining": 40 }, { "date": "2026-09-19", "remaining": 0 }] },
+    "capacity": { "type": "column", "renderer": "svg", "data": [{ "name": "Alex", "value": 10, "capacity": 8, "overload": 2 }] },
+    "risk": { "type": "scatter", "renderer": "svg", "data": [{ "name": "Vendor delay", "x": 4, "y": 5, "value": 20, "recordId": "risk-1" }] },
+    "aging": { "type": "bar", "renderer": "svg", "data": [{ "name": "0-7", "value": 4 }, { "name": "8-14", "value": 2 }] },
+    "flow": { "type": "flow", "renderer": "svg", "nodes": [{ "id": "start", "label": "Start" }, { "id": "done", "label": "Done" }], "edges": [{ "from": "start", "to": "done" }] },
+    "swimlane": { "type": "swimlane", "renderer": "svg", "lanes": [{ "id": "agent", "label": "Agent" }], "nodes": [{ "id": "plan", "label": "Plan", "laneId": "agent" }], "edges": [] }
+  }
+}

package/agent-recipes/trend-line.json

@@ -0,0 +1,21 @@
+{
+  "name": "monthly-sales-trend",
+  "intent": "trend",
+  "inputData": [
+    { "month": "Jan", "sales": 120 },
+    { "month": "Feb", "sales": 180 },
+    { "month": "Mar", "sales": 145 }
+  ],
+  "spec": {
+    "version": "2.0",
+    "type": "line",
+    "renderer": "svg",
+    "data": { "values": [] },
+    "encoding": {
+      "x": { "field": "month", "type": "category" },
+      "y": { "field": "sales", "type": "quantitative" }
+    },
+    "interaction": { "tooltip": true, "hover": true, "click": true }
+  },
+  "expected": { "chartType": "line", "dimension": "month", "measure": "sales" }
+}