@wandelbots/wandelbots-js-react-components 3.1.1 → 3.2.0-pr.docs-migration-guide.416.5e423df

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +41 -3
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -12,11 +12,49 @@ Built with TypeScript, Material-UI, and React Three Fiber. Provides robot contro
12
12
  npm install @wandelbots/wandelbots-js-react-components
13
13
  ```
14
14
 
15
- ## Getting Started
15
+ ## Modular Imports + Peer Dependencies
16
16
 
17
- For setup instructions, integration examples, and basic usage patterns, visit the **[Getting Started Guide](https://wandelbotsgmbh.github.io/wandelbots-js-react-components/?path=/docs/gettingstarted--docs)** in our Storybook documentation.
17
+ Please note that some modules require extra dependencies, like three.js. If you don't need 3D rendering in your application, make sure you always import from `@wandelbots/wandelbots-js-react-components/core`.
18
18
 
19
- ## Documentation
19
+ ```typescript
20
+ import {
21
+ SafetyBar,
22
+ JoggingPanel,
23
+ DataGrid,
24
+ Timer,
25
+ } from "@wandelbots/wandelbots-js-react-components/core"
26
+ ```
27
+
28
+ For 3D-enabled components, use `@wandelbots/wandelbots-js-react-components/3d`:
29
+
30
+ ```typescript
31
+ import { Robot, RobotCard } from "@wandelbots/wandelbots-js-react-components/3d"
32
+ ```
33
+
34
+ You can also import from top-level `@wandelbots/wandelbots-js-react-components`, but then you'll need to provide all optional dependencies:
35
+
36
+ ```bash
37
+ npm install @wandelbots/wandelbots-js-react-components \
38
+ react react-dom \
39
+ @mui/material @mui/icons-material @emotion/react @emotion/styled \
40
+ three @react-three/fiber @react-three/drei three-stdlib \
41
+ @monaco-editor/react shiki @shikijs/monaco
42
+ ```
43
+
44
+ **Available Entry Points:**
45
+
46
+ | Entry Point | Components | Required Peer Dependencies |
47
+ | ------------------- | ------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
48
+ | **Main** (`.`) | All components | React 18+, MUI v6/v7, @emotion/react, @emotion/styled, @mui/icons-material + all below |
49
+ | **`/core`** | Base components (AppHeader, ProgramControl, SafetyBar, VelocitySlider, JoggingPanel, DataGrid, Timer, themes, i18n, etc.) | React 18+, MUI v6/v7, @emotion/react, @emotion/styled, @mui/icons-material |
50
+ | **`/3d`** | 3D visualization (Robot, RobotCard, CollisionSceneRenderer, SafetyZonesRenderer, TrajectoryRenderer) | All from `/core` + three, @react-three/fiber, @react-three/drei, three-stdlib |
51
+ | **`/wandelscript`** | Code editor (WandelscriptEditor) | All from `/core` + @monaco-editor/react |
52
+
53
+ ## 2.x to 3.x Migration Guide
54
+
55
+ See [Migration Guide](https://wandelbotsgmbh.github.io/wandelbots-js-react-components/?path=/docs/migration-guide--docs) for assistance.
56
+
57
+ ## Interactive Documentation
20
58
 
21
59
  See the [Storybook](https://wandelbotsgmbh.github.io/wandelbots-js-react-components) for interactive examples and API documentation.
22
60
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@wandelbots/wandelbots-js-react-components",
3
- "version": "3.1.1",
3
+ "version": "3.2.0-pr.docs-migration-guide.416.5e423df",
4
4
  "description": "React UI toolkit for building applications on top of the Wandelbots platform",
5
5
  "type": "module",
6
6
  "sideEffects": false,