@rainbow-robotics/muscat-plugin-kit 1.10.3-dev.0 → 1.10.3-dev.3

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 (32) hide show
  1. package/README.ko.md +1059 -0
  2. package/README.md +927 -150
  3. package/cli/README.md +1 -1
  4. package/cli/bin/muscat-pk.mjs +1 -1
  5. package/cli/src/build.mjs +9 -13
  6. package/cli/src/dev.mjs +4 -2
  7. package/cli/src/manifest.mjs +1 -0
  8. package/cli/src/mcp.mjs +17 -3
  9. package/cli/src/muscatLocal.mjs +2 -2
  10. package/cli/src/pluginDevServer.mjs +1 -1
  11. package/cli/storybook-dist/assets/{Color-YHDXOIA2-B1KKcB6K.js → Color-YHDXOIA2-Cp8LHsF-.js} +1 -1
  12. package/cli/storybook-dist/assets/{Docs-Ccehtd2V.js → Docs-B2ox3o_G.js} +1 -1
  13. package/cli/storybook-dist/assets/{Docs-CHv6SVVZ.js → Docs-By11aG_M.js} +1 -1
  14. package/cli/storybook-dist/assets/{Docs-2Fjmybwk.js → Docs-Kg1Im4XT.js} +1 -1
  15. package/cli/storybook-dist/assets/{Docs-DLOo5tzV.js → Docs-LeW_BIsw.js} +1 -1
  16. package/cli/storybook-dist/assets/{Docs-exoI2PyN.js → Docs-UJwiVwO2.js} +1 -1
  17. package/cli/storybook-dist/assets/{Docs-DtdcK7tN.js → Docs-ik2AhpV0.js} +1 -1
  18. package/cli/storybook-dist/assets/{DocsRenderer-CFRXHY34-DHVj1Lpb.js → DocsRenderer-CFRXHY34-DPFneFUi.js} +1 -1
  19. package/cli/storybook-dist/assets/{entry-preview-fUNTcv77.js → entry-preview-BTw3Jh8E.js} +1 -1
  20. package/cli/storybook-dist/assets/{iframe-Ck1s_iK9.js → iframe-BqPQIkPQ.js} +2 -2
  21. package/cli/storybook-dist/assets/{index-BkRHCy11.js → index-k_VkBflK.js} +3 -3
  22. package/cli/storybook-dist/assets/{preview-Cf2hNwTD.js → preview-C3ctYQQj.js} +2 -2
  23. package/cli/storybook-dist/assets/preview-Cog7BnbD.js +3 -0
  24. package/cli/storybook-dist/iframe.html +1 -1
  25. package/cli/storybook-dist/project.json +1 -1
  26. package/cli/templates/common/README.md +3 -4
  27. package/cli/templates/common/requirements.txt +3 -3
  28. package/cli/templates/cpp/cpp/CMakeLists.txt +1 -1
  29. package/cli/templates/readme-cpp/README.md +3 -4
  30. package/cli/templates/ros2-cpp/ros2_ws/src/__PLUGIN_SLUG__/CMakeLists.txt +1 -1
  31. package/package.json +5 -4
  32. package/cli/storybook-dist/assets/preview-CDcrEKt5.js +0 -3
@@ -509,7 +509,7 @@
509
509
  }
510
510
  </script>
511
511
 
512
- <script type="module" crossorigin src="./assets/iframe-Ck1s_iK9.js"></script>
512
+ <script type="module" crossorigin src="./assets/iframe-BqPQIkPQ.js"></script>
513
513
  </head>
514
514
 
515
515
  <body>
@@ -1 +1 @@
1
- {"generatedAt":1792988817946,"userSince":1750932757926,"hasCustomBabel":false,"hasCustomWebpack":false,"hasStaticDirs":false,"hasStorybookEslint":true,"refCount":0,"testPackages":{"@vitest/browser":"3.2.4","@vitest/coverage-v8":"3.2.4","playwright":"1.59.1","vitest":"3.2.4"},"hasRouterPackage":false,"monorepo":"Turborepo","packageManager":{"type":"yarn","version":"berry","agent":"yarn@berry"},"preview":{"usesGlobals":false},"framework":{"name":"@storybook/react-vite","options":{}},"builder":"@storybook/builder-vite","renderer":"@storybook/react","portableStoriesFileCount":0,"applicationFileCount":0,"storybookVersion":"8.6.18","storybookVersionSpecifier":"^8.6.4","language":"typescript","storybookPackages":{"@chromatic-com/storybook":{"version":"3.2.7"},"@storybook/addon-essentials":{"version":"8.6.18"},"@storybook/addon-links":{"version":"8.6.18"},"@storybook/addon-onboarding":{"version":"8.6.18"},"@storybook/addon-themes":{"version":"8.6.18"},"@storybook/blocks":{"version":"8.6.18"},"@storybook/experimental-addon-test":{"version":"8.6.18"},"@storybook/react":{"version":"8.6.18"},"@storybook/react-vite":{"version":"8.6.18"},"@storybook/test":{"version":"8.6.18"},"@storybook/theming":{"version":"8.6.18"},"eslint-plugin-storybook":{"version":"0.11.6"},"storybook":{"version":"8.6.18"},"storybook-addon-react-docgen":{"version":"1.2.44"}},"addons":{"$SNIP/node_modules/@storybook/addon-links":{"version":null},"$SNIP/node_modules/@storybook/addon-essentials":{"version":null},"$SNIP/node_modules/@chromatic-com/storybook":{"version":null},"$SNIP/node_modules/@storybook/addon-themes":{"version":null},"$SNIP/node_modules/@storybook/experimental-addon-test":{"version":null}}}
1
+ {"generatedAt":1793063570625,"userSince":1750932757926,"hasCustomBabel":false,"hasCustomWebpack":false,"hasStaticDirs":false,"hasStorybookEslint":true,"refCount":0,"testPackages":{"@vitest/browser":"3.2.4","@vitest/coverage-v8":"3.2.4","playwright":"1.59.1","vitest":"3.2.4"},"hasRouterPackage":false,"monorepo":"Turborepo","packageManager":{"type":"yarn","version":"berry","agent":"yarn@berry"},"preview":{"usesGlobals":false},"framework":{"name":"@storybook/react-vite","options":{}},"builder":"@storybook/builder-vite","renderer":"@storybook/react","portableStoriesFileCount":0,"applicationFileCount":0,"storybookVersion":"8.6.18","storybookVersionSpecifier":"^8.6.4","language":"typescript","storybookPackages":{"@chromatic-com/storybook":{"version":"3.2.7"},"@storybook/addon-essentials":{"version":"8.6.18"},"@storybook/addon-links":{"version":"8.6.18"},"@storybook/addon-onboarding":{"version":"8.6.18"},"@storybook/addon-themes":{"version":"8.6.18"},"@storybook/blocks":{"version":"8.6.18"},"@storybook/experimental-addon-test":{"version":"8.6.18"},"@storybook/react":{"version":"8.6.18"},"@storybook/react-vite":{"version":"8.6.18"},"@storybook/test":{"version":"8.6.18"},"@storybook/theming":{"version":"8.6.18"},"eslint-plugin-storybook":{"version":"0.11.6"},"storybook":{"version":"8.6.18"},"storybook-addon-react-docgen":{"version":"1.2.44"}},"addons":{"$SNIP/node_modules/@storybook/addon-links":{"version":null},"$SNIP/node_modules/@storybook/addon-essentials":{"version":null},"$SNIP/node_modules/@chromatic-com/storybook":{"version":null},"$SNIP/node_modules/@storybook/addon-themes":{"version":null},"$SNIP/node_modules/@storybook/experimental-addon-test":{"version":null}}}
@@ -217,7 +217,7 @@ plugin logic only; it should not start its own copy of the plugin gateway.
217
217
  | Contribution point | What it is | Backend pattern |
218
218
  | --- | --- | --- |
219
219
  | `program.panel` (with `commandInfo`) | Defines a **custom command** the plugin adds to the Program page's rule-based sequence builder. The operator places it into the program tree like any built-in command (Move J, Point, Wait, …); it runs when the program reaches that step. | **`PluginProgramContext`** — integrated with the program's stop/pause and variables. See _Program command backend_ below. |
220
- | `toolbar` / `lnb` / `move.panel` | A live UI panel/popover the operator interacts with directly | Call the robot **SDK directly** (`RBManipulateSDK`, `RBAmrSDK`) from `py/main.py`, or `rb.action(...)` → your backend → SDK. **Not** a program step — there is no stop/pause/variable context. |
220
+ | `toolbar` / `lnb` / `move.panel` / `program.monitor` | A live UI panel/popover the operator interacts with directly (`program.monitor` is a tab in the Program page's monitor panel, next to General / Digital I/O / Monitor / Log; it is rendered per selected task, and `rb.data` is `{ point: "program.monitor", taskId, robotModel }` — pass it as the `scope` argument of `rb.program.*` so a multi-component robot's calls hit that component's task) | Call the robot **SDK directly** (`RBManipulateSDK`, `RBAmrSDK`) from `py/main.py`, or `rb.action(...)` → your backend → SDK. **Not** a program step — there is no stop/pause/variable context. |
221
221
 
222
222
  Rule of thumb: use `PluginProgramContext` **only** for a `program.panel` command
223
223
  that runs as part of a program. To move the robot live from a toolbar/move panel,
@@ -1073,8 +1073,7 @@ Any other MCP client works too — it's a standard stdio MCP server started with
1073
1073
  ## Shipping
1074
1074
 
1075
1075
  ```bash
1076
- muscat-pk build # build + ZIP
1077
- muscat-pk build --no-zip # build only, no ZIP
1076
+ muscat-pk build # build + ZIP
1078
1077
  ```
1079
1078
 
1080
1079
  > Building the other arch (e.g. arm64 on an amd64 PC) runs in an emulated container for
@@ -1110,7 +1109,7 @@ __PLUGIN_DIR__-1.0.0.zip
1110
1109
  muscat-pk dev # UI + backend
1111
1110
  muscat-pk dev:ui # UI preview only (preview-host)
1112
1111
  muscat-pk dev:back # backend only (Python: watchfiles / ROS2: Docker)
1113
- muscat-pk build # build → dist/ + distributable ZIP (--no-zip to skip)
1112
+ muscat-pk build # build → dist/ + distributable ZIP
1114
1113
  muscat-pk storybook # browse the rb-components UI library in a browser
1115
1114
  muscat-pk mcp # MCP server for AI assistants (components/tokens/SDK docs)
1116
1115
  ```
@@ -1,4 +1,4 @@
1
- rainbow-rb-sdk==0.10.2
2
- rainbow-rb-flat-buffers==0.10.2
3
- rainbow-rb-zenoh==0.10.2
1
+ rainbow-rb-sdk==0.10.3
2
+ rainbow-rb-flat-buffers==0.10.3
3
+ rainbow-rb-zenoh==0.10.3
4
4
  requests==2.34.2
@@ -7,7 +7,7 @@ set(CMAKE_CXX_STANDARD_REQUIRED ON)
7
7
  # Rainbow Robotics C++ SDK — provided by the apt package rainbow-rb-sdk-dev
8
8
  # (pre-installed in the muscat-pk dev container). The version here is the one the
9
9
  # dev container installs; change it with `muscat-pk sdk update <version>`.
10
- find_package(rb_sdk 0.10.2 EXACT REQUIRED)
10
+ find_package(rb_sdk 0.10.3 EXACT REQUIRED)
11
11
 
12
12
  # The executable name must match runtime.entry in manifest.json.
13
13
  add_executable(__PLUGIN_SLUG__ main.cpp)
@@ -244,7 +244,7 @@ don't install anything locally.
244
244
 
245
245
  ```cmake
246
246
  # cpp/CMakeLists.txt — the version is the SDK the dev container installs (muscat-pk sdk update <version>)
247
- find_package(rb_sdk 0.10.2 EXACT REQUIRED)
247
+ find_package(rb_sdk 0.10.3 EXACT REQUIRED)
248
248
  add_executable(__PLUGIN_SLUG__ main.cpp) # name must equal runtime.entry
249
249
  target_link_libraries(__PLUGIN_SLUG__ PRIVATE rb_sdk::rb_sdk)
250
250
  ```
@@ -839,8 +839,7 @@ Any other MCP client works too — it's a standard stdio MCP server started with
839
839
  ## Shipping
840
840
 
841
841
  ```bash
842
- muscat-pk build # build + ZIP
843
- muscat-pk build --no-zip # build only, no ZIP
842
+ muscat-pk build # build + ZIP
844
843
  ```
845
844
 
846
845
  > Building the other arch (e.g. arm64 on an amd64 PC) runs in an emulated container for
@@ -876,7 +875,7 @@ __PLUGIN_DIR__-1.0.0.zip
876
875
  muscat-pk dev # UI + backend
877
876
  muscat-pk dev:ui # UI preview only (preview-host)
878
877
  muscat-pk dev:back # backend only (C++ rebuild + restart in Docker)
879
- muscat-pk build # build → dist/ + distributable ZIP (--no-zip to skip)
878
+ muscat-pk build # build → dist/ + distributable ZIP
880
879
  muscat-pk storybook # browse the rb-components UI library in a browser
881
880
  muscat-pk mcp # MCP server for AI assistants (components/tokens/SDK docs)
882
881
  ```
@@ -10,7 +10,7 @@ find_package(rclcpp REQUIRED)
10
10
  # Rainbow Robotics C++ SDK (apt: rainbow-rb-sdk-dev, pre-installed in the dev
11
11
  # container). The version here is the one the dev container installs; change it
12
12
  # with `muscat-pk sdk update <version>`.
13
- find_package(rb_sdk 0.10.2 EXACT REQUIRED)
13
+ find_package(rb_sdk 0.10.3 EXACT REQUIRED)
14
14
 
15
15
  add_executable(__PLUGIN_SLUG___node src/node.cpp)
16
16
  ament_target_dependencies(__PLUGIN_SLUG___node rclcpp)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@rainbow-robotics/muscat-plugin-kit",
3
- "version": "1.10.3-dev.0",
3
+ "version": "1.10.3-dev.3",
4
4
  "type": "module",
5
5
  "engines": {
6
6
  "node": ">=20"
@@ -34,7 +34,8 @@
34
34
  },
35
35
  "files": [
36
36
  "cli",
37
- "package.json"
37
+ "package.json",
38
+ "README.ko.md"
38
39
  ],
39
40
  "scripts": {
40
41
  "lint": "node cli/src/check-package.mjs",
@@ -52,8 +53,8 @@
52
53
  },
53
54
  "dependencies": {
54
55
  "@modelcontextprotocol/sdk": "^1.29.0",
55
- "@rainbow-robotics/plugin-ui": "1.10.3-dev.0",
56
- "@rainbow-robotics/preview-host": "1.10.3-dev.0",
56
+ "@rainbow-robotics/plugin-ui": "1.10.3-dev.3",
57
+ "@rainbow-robotics/preview-host": "1.10.3-dev.3",
57
58
  "@types/react": "^19.0.10",
58
59
  "postcss": "^8.5.8",
59
60
  "typescript": "^5.8.0",