Release 2.0.0

.github/workflows/ci.yaml

@@ -0,0 +1,36 @@
+name: CI
+
+on:
+    pull_request:
+    push:
+        branches:
+            - main
+
+permissions:
+    contents: read
+
+jobs:
+    verify:
+        runs-on: ubuntu-latest
+        steps:
+            - uses: actions/checkout@v7
+
+            - uses: actions/setup-node@v7
+              with:
+                  node-version: 22
+
+            - name: Install
+              run: npm ci
+
+            - name: Typecheck
+              run: npm run typecheck
+
+            # build ends with verifyLib: artifact layout assertions, then publint and attw
+            - name: Build
+              run: npm run build
+
+            # compares against bundle-check/baseline/sizes.json and fails on regressions,
+            # so a change that widens sideEffects or drags the Builder into the init path
+            # is caught here rather than at publish time
+            - name: Tree-shaking and bundle-size gate
+              run: npm run bundleCheck

.gitignore

@@ -4,9 +4,18 @@ node_modules
 /storybook-static
 /demos/react18/*/build
 /demos/react18/basic/node_modules
-/demos/react18/cra/node_modules
-/demos/react18/cra-pwa/node_modules
 /demos/react16/node_modules
+/demos/features/*/node_modules
+/demos/features/*/build
+/demos/features/*/types
 packageNPM.json
+# wasm copied next to an entry point by a demo's build step - the v5 pair and its .data
+# files, plus the v6 core and the side modules it loads beside it
+scichart*.wasm
 scichart2d.data
-scichart2d.wasm
+scichart3d.data
+# bundle-check harness artifacts
+/bundle-check/node_modules
+/bundle-check/build
+/bundle-check/dist
+/bundle-check/reports

.storybook/main.ts

@@ -1,12 +1,17 @@
 import type { StorybookConfig } from "@storybook/react-webpack5";
 import merge from "webpack-merge";
-const CopyPlugin = require("copy-webpack-plugin");
 const path = require("path");
 
 const config: StorybookConfig = {
-    stories: ["./stories/SciChartReact.stories.tsx", "./stories/**/*.mdx", "./stories/**/*.stories.@(js|jsx|mjs|ts|tsx)"],
+    stories: [
+        "./stories/SciChartReact.stories.tsx",
+        "./stories/**/*.mdx",
+        "./stories/**/*.stories.@(js|jsx|mjs|ts|tsx)"
+    ],
     addons: ["@storybook/addon-links", "@storybook/addon-essentials", "@storybook/addon-interactions"],
-    staticDirs: ["./public"],
+    // the whole _wasm directory, not a single file: the core picks a variant per browser and
+    // fetches side modules (charting3d) relative to it, matching what the README tells consumers
+    staticDirs: ["./public", { from: "../node_modules/scichart/_wasm", to: "/" }],
     framework: {
         name: "@storybook/react-webpack5",
         options: {}
@@ -32,18 +37,6 @@ const config: StorybookConfig = {
             webpackConfig
         );
 
-        // config.plugins?.push(
-        //     new CopyPlugin({
-        //         patterns: [
-        //             { from: "src/index.html", to: "" },
-        //             { from: "node_modules/scichart/_wasm/scichart2d.data", to: "" },
-        //             { from: "node_modules/scichart/_wasm/scichart2d.wasm", to: "" },
-        //             { from: "node_modules/scichart/_wasm/scichart3d.data", to: "" },
-        //             { from: "node_modules/scichart/_wasm/scichart3d.wasm", to: "" }
-        //         ]
-        //     })
-        // );
-
         return customizedWebpackConfig;
     }
 };

.storybook/stories/ChartGroupLoader.stories.tsx

@@ -3,13 +3,10 @@ import ChartGroupLoaderBasicSrc from "!!raw-loader!./DocExamples/ChartGroupLoade
 import ChartGroupLoaderCustomSrc from "!!raw-loader!./DocExamples/ChartGroupLoaderCustom";
 import { ChartGroupLoaderBasic as ChartGroupLoaderBasicRenderer } from "./DocExamples/ChartGroupLoaderBasic";
 import { ChartGroupLoaderCustom as ChartGroupLoaderCustomRenderer } from "./DocExamples/ChartGroupLoaderCustom";
-import { EAxisType, EChart2DModifierType, ESeriesType, SciChart3DSurface, SciChartSurface } from "scichart";
+import { EAxisType, EChart2DModifierType, ESeriesType } from "scichart";
 import { Title, Subtitle, Description, Primary, Controls, Stories, ArgTypes } from "@storybook/blocks";
 import { ChartGroupLoader } from "../../src/ChartGroupLoader";
 
-SciChartSurface.loadWasmFromCDN();
-SciChartSurface.loadWasmFromCDN();
-
 // More on how to set up stories at: https://storybook.js.org/docs/react/writing-stories/introduction#default-export
 const meta = {
     title: "Example/ChartGroupLoader",

.storybook/stories/DocExamples/ChartGroupLoaderBasic.tsx

@@ -1,5 +1,5 @@
 import { NumericAxis, SciChartSurface } from "scichart";
-import { SciChartReact, ChartGroupLoader } from "scichart-react";
+import { SciChartReact, SciChartDeclarative, ChartGroupLoader } from "scichart-react";
 
 export const ChartGroupLoaderBasic = () => (
     <ChartGroupLoader style={{ minWidth: 600, display: "flex" }}>
@@ -21,7 +21,7 @@ export const ChartGroupLoaderBasic = () => (
             }}
             style={{ flex: "auto", minHeight: "200px" }}
         />
-        <SciChartReact config={{}} style={{ flex: "auto", minHeight: "200px" }} />
-        <SciChartReact config={{}} style={{ flex: "auto", minHeight: "200px" }} />
+        <SciChartDeclarative config={{}} style={{ flex: "auto", minHeight: "200px" }} />
+        <SciChartDeclarative config={{}} style={{ flex: "auto", minHeight: "200px" }} />
     </ChartGroupLoader>
 );

.storybook/stories/DocExamples/ChartGroupLoaderCustom.tsx

@@ -1,6 +1,6 @@
 import { useState } from "react";
 import { NumericAxis, SciChartSurface } from "scichart";
-import { SciChartReact, ChartGroupLoader, DefaultFallback } from "scichart-react";
+import { SciChartReact, SciChartDeclarative, ChartGroupLoader, DefaultFallback } from "scichart-react";
 
 // this will be displayed if error happens during initialization
 const customFallback = (
@@ -55,8 +55,8 @@ export const ChartGroupLoaderCustom = () => {
                 }}
                 style={{ flex: "auto", minHeight: "200px" }}
             />
-            <SciChartReact config={{}} style={{ flex: "auto", minHeight: "200px" }} />
-            <SciChartReact config={{}} style={{ flex: "auto", minHeight: "200px" }} />
+            <SciChartDeclarative config={{}} style={{ flex: "auto", minHeight: "200px" }} />
+            <SciChartDeclarative config={{}} style={{ flex: "auto", minHeight: "200px" }} />
         </ChartGroupLoader>
     );
 };

.storybook/stories/DocExamples/ChartWithConfig.tsx

@@ -1,8 +1,8 @@
 import { EAxisType, ESeriesType, EChart2DModifierType } from "scichart";
-import { SciChartReact } from "scichart-react";
+import { SciChartDeclarative } from "scichart-react";
 
 export const ChartWithConfig = () => (
-    <SciChartReact
+    <SciChartDeclarative
         config={{
             xAxes: [{ type: EAxisType.NumericAxis }],
             yAxes: [{ type: EAxisType.NumericAxis }],

.storybook/stories/DocExamples/NestedOverviewBasic.tsx

@@ -1,8 +1,8 @@
 import { EAxisType, ESeriesType, EChart2DModifierType } from "scichart";
-import { SciChartReact, SciChartNestedOverview } from "scichart-react";
+import { SciChartDeclarative, SciChartNestedOverview } from "scichart-react";
 
 export const NestedOverviewBasic = () => (
-    <SciChartReact
+    <SciChartDeclarative
         config={{
             xAxes: [{ type: EAxisType.NumericAxis }],
             yAxes: [{ type: EAxisType.NumericAxis }],
@@ -33,5 +33,5 @@ export const NestedOverviewBasic = () => (
         innerContainerProps={{ style: { height: "80%" } }}
     >
         <SciChartNestedOverview style={{ height: "20%" }} />
-    </SciChartReact>
+    </SciChartDeclarative>
 );

.storybook/stories/SciChartOverview.stories.tsx

@@ -1,16 +1,11 @@
 import type { Meta, StoryObj } from "@storybook/react";
 import NestedOverviewBasicSrc from "!!raw-loader!./DocExamples/NestedOverviewBasic";
 import { NestedOverviewBasic as NestedOverviewBasicRenderer } from "./DocExamples/NestedOverviewBasic";
-import { EAxisType, EChart2DModifierType, ESeriesType, SciChart3DSurface, SciChartSurface } from "scichart";
+import { EAxisType, EChart2DModifierType, ESeriesType } from "scichart";
 import { Title, Subtitle, Description, Primary, Controls, Stories, ArgTypes } from "@storybook/blocks";
 import { SciChartNestedOverview } from "../../src/SciChartOverview";
 import { SciChartReact } from "../../src/SciChart";
 
-// SciChartSurface.loadWasmFromCDN();
-// SciChartSurface.loadWasmFromCDN();
-SciChartSurface.useWasmFromCDN();
-SciChart3DSurface.useWasmFromCDN();
-
 // More on how to set up stories at: https://storybook.js.org/docs/react/writing-stories/introduction#default-export
 const meta = {
     title: "Example/SciChartOverview",

.storybook/stories/SciChartReact.stories.tsx

@@ -19,13 +19,9 @@ import { ChartUsageWithTypescript as ChartUsageWithTypescriptRenderer } from "./
 import { ChartWith3dSurface as ChartWith3dSurfaceRenderer } from "./DocExamples/ChartWith3dSurface";
 import { ChartWithPieSurface as ChartWithPieSurfaceRenderer } from "./DocExamples/ChartWithPieSurface";
 import { ChartWrapperStyling as ChartWrapperStylingRenderer } from "./DocExamples/ChartWrapperStyling";
-import { SciChart3DSurface, SciChartSurface } from "scichart";
 import { SciChartReact } from "../../src/SciChart";
 import { Title, Subtitle, Description, Primary, Controls, Stories, ArgTypes } from "@storybook/blocks";
 
-SciChartSurface.useWasmFromCDN();
-SciChart3DSurface.useWasmFromCDN();
-
 // More on how to set up stories at: https://storybook.js.org/docs/react/writing-stories/introduction#default-export
 const meta = {
     title: "Example/SciChartReact",

CHANGELOG.md

@@ -0,0 +1,68 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project
+adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+This file is not shipped in the npm package — the tarball root is `lib/`, which carries
+`README_NPM.md` as its readme.
+
+## [2.0.0]
+
+The 2.0 line targets SciChart.js v6 and is built and verified against `scichart` 6.0.1.
+
+### Breaking
+
+-   **`scichart` peer dependency is now v6+.** The engine ships one union `scichart.wasm` instead of
+    the `scichart2d.wasm` / `scichart3d.wasm` pair, and there are no more `.data` files. The WASM
+    payload to deploy is the whole `_wasm` **directory**, not a single file. Apps staying on
+    scichart 3.x–5.x should stay on scichart-react 1.x. When upgrading the core library, the
+    `scichart-migrate` codemod automates the renames.
+-   **The `config` prop moved to the new `SciChartDeclarative` component.** Replace
+    `<SciChartReact config={...} />` with `<SciChartDeclarative config={...} />` — one JSX rename,
+    all other props identical. `SciChartReact` now requires `initChart` and throws a pointer error
+    if it receives `config`.
+-   **`SciChartOverview` no longer mirrors** palette providers, animations or data labels onto the
+    overview's mini series. Set them on the overview series explicitly if you relied on that.
+-   **The Builder API registers nothing on import.** Since SciChart v6, types used by a JSON config
+    must be registered explicitly (`registerNumericAxis`, `registerXyDataSeries`, …), or via the
+    `registerAllTypes()` escape hatch. `SciChartDeclarative` calls `registerAllTypes()` internally,
+    so declarative users are unaffected.
+
+### Added
+
+-   `SciChartDeclarative` — the JSON-config component split out of `SciChartReact`.
+-   `configureSciChartDefaults` — the import-time global defaults, now also callable directly and
+    importable as `scichart-react/configureDefaults`.
+-   Exported types `IChartComponentPropsCore`, `TChartComponentPropsWithInit` and
+    `TChartComponentPropsWithConfig`.
+-   `SciChartMemoryDebugWrapper` gained a `defaultRenderChildren` prop, so the children can be
+    rendered on the first render instead of waiting for the checkbox. Its props are now typed
+    rather than `any`.
+
+### Changed
+
+-   **Dual ESM/CJS output** with an `exports` map, a `module` entry and subpath deep imports
+    (`scichart-react/SciChartGroup`), replacing the single flat CommonJS build.
+-   **`sideEffects` narrowed** to `configureDefaults.js` only, so bundlers can drop everything a
+    consumer does not import. An `initChart`-only bundle no longer drags in the Builder.
+-   `"use client"` directives added, so the components work in React Server Component setups.
+-   `react` peer dependency raised to `>=16.14.0`.
+-   Each surface returned from `initChart` is marked as externally lifecycle-managed, which
+    suppresses the core's "root detached before delete" and "surface already deleted"
+    memory-debug warnings. Both are expected here: the component removes the chart root before
+    the asynchronous delete, and a surface can be deleted twice (the nested overview). The flag
+    is only set when the core exposes it, so this is inert against scichart 6.0.1 and takes
+    effect with the core release that adds it.
+
+### Deprecated
+
+-   `TChartComponentProps` — use `TChartComponentPropsWithInit` or `TChartComponentPropsWithConfig`.
+
+## [1.0.0]
+
+First stable release of the 1.x line, targeting SciChart.js 3.x–5.x.
+
+[2.0.0]: https://github.com/ABTSoftware/scichart-react/releases/tag/v2.0.0
+[1.0.0]: https://github.com/ABTSoftware/scichart-react/releases/tag/v1.0.0