technology-stack

# AG Charts Technology Stack This document outlines the preferred technologies and architectural constraints for the AG Charts monorepo. ## Critical Requirement: Zero Runtime Dependencies **The main AG Charts libraries (`ag-charts-core`, `ag-charts-community`, `ag-charts-enterprise`) MUST have ZERO third-party runtime dependencies.** Only internal AG Charts packages and dev dependencies for build/test tooling are allowed. ## Core Libraries | Package | Runtime Dependencies | Purpose | | ---------------------- | ------------------------------------------------------- | ---------------------------------------- | | `ag-charts-types` | **NONE** (zero dependencies) | TypeScript type definitions | | `ag-charts-core` | `ag-charts-types` only | Core rendering engine and utilities | | `ag-charts-locale` | **NONE** (zero dependencies) | Internationalization (40+ languages) | | `ag-charts-community` | `ag-charts-core`, `ag-charts-types`, `ag-charts-locale` | MIT licensed charts library | | `ag-charts-enterprise` | `ag-charts-community`, `ag-charts-core` | Commercial charts with advanced features | **Core Technologies:** - **TypeScript**: Primary language with strict mode enabled - **Canvas API**: Custom high-performance rendering with scene graph - **Pure JavaScript**: No external runtime dependencies ## Framework Wrappers | Package | Runtime Dependencies | Peer Dependencies | | ------------------- | ------------------------------ | ------------------------------------------------------ | | `ag-charts-react` | `ag-charts-community` | `react ^18.0.0 \|\| ^19.0.0` | | `ag-charts-angular` | `ag-charts-community`, `tslib` | `@angular/common >= 21.0.0`, `@angular/core >= 21.0.0` | | `ag-charts-vue3` | `ag-charts-community` | `vue ^3.5.0` | ## Documentation Website (`ag-charts-website`) | Technology | Purpose | | ------------------ | ----------------------------------- | | **Astro** | Static site generator | | **Markdoc** | Content authoring for documentation | | **React** | Interactive components within Astro | | **Vite** | Development server and build tool | | **Shiki** | Syntax highlighting | | **Algolia** | Documentation search | | **Nanostores** | Lightweight state management | | **Cheerio** | Server-side HTML parsing | ## Development & Build Tools | Tool | Purpose | Used By | | ----------------------- | ---------------------------------- | ------------------ | | **Nx** | Monorepo orchestration and caching | All packages | | **TypeScript** | Type checking and compilation | All packages | | **SWC** | Fast transpilation | Build system | | **ESBuild** | High-performance bundling | Production builds | | **Vitest** | Unit and visual snapshot testing | All packages | | **Playwright** | E2E testing | Website | | **ESLint** | Code linting with custom rules | All packages | | **Prettier** | Code formatting | All packages | | **Size Limit** | Bundle size monitoring | Core libraries | ## Version Requirements Tool and runtime versions live in the root `package.json` (`engines`, `devDependencies`) and `.nvmrc` — read them there rather than from this page. - **Build Target**: the `target` of the `build:package` and `build:umd` target defaults in `nx.json` (ES2022; excludes IE) - **TypeScript**: Strict mode enabled across all packages