@snack-kit/scripts 0.1.0 → 0.2.0

package/README.md

@@ -142,6 +142,12 @@ module.exports = (config) => {
 
 ## Changelog
 
+### 0.2.0
+
+- 新增：`MIGRATION.md` 迁移指南，说明从 `@para-snack/*` / `@paraview/*` 迁移到 `@snack-kit/*` 的完整步骤
+- 新增：`config/webpack.shared.js` 共享 webpack 配置模块
+- 重构：`template/dev/index.tsx`、`template/entry/index.tsx`、`template/snack/index.tsx` 模板文件更新，适配新包名
+
 ### 0.1.0
 
 - 新增：`snack-scripts init [dir]` 命令，交互式初始化新 snack 工程

package/config/webpack.shared.js

@@ -25,7 +25,10 @@ function createResolve(extraAlias = {}) {
             assets: path.join(process.env.PROJECT_PATH, 'src/assets'),
             // @snack-kit/core 的 package.json module 字段路径有误，直接指向 cjs
             '@snack-kit/core': path.resolve(__dirname, '../node_modules/@snack-kit/core/dist/cjs/index.js'),
-            ...extraAlias
+            // 强制 dev 模板使用 snack-scripts 自身的 react，避免项目中旧版 react 被命中
+            'react': path.resolve(__dirname, '../node_modules/react'),
+            'react-dom': path.resolve(__dirname, '../node_modules/react-dom'),
+...extraAlias
         }
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@snack-kit/scripts",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "snack-cli package scripts Powered by Para FED",
   "bin": {
     "snack-scripts": "./bin/main.js"
@@ -33,6 +33,8 @@
     "@babel/preset-react": "^7.24.7",
     "@babel/preset-typescript": "^7.24.7",
     "@pmmmwh/react-refresh-webpack-plugin": "^0.5.3",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
     "@snack-kit/core": "file:../core",
     "@snack-kit/lib": "^0.6.0",
     "@swc/core": "^1.2.100",

package/template/dev/index.tsx

@@ -2,13 +2,12 @@
 
 import React from 'react';
 import ReactDOM from 'react-dom';
-import {createRoot} from 'react-dom/client';
 import {Context, Debugger} from '@snack-kit/lib';
 import App from './App';
 
 /** import snack modules **/
 
-import {SnackSDK} from '@snack-kit/core';
+import {SnackSDK, createReactRoot} from '@snack-kit/core';
 
 import 'template/normalize.scss';
 import './index.scss';
@@ -24,7 +23,7 @@ const packages = JSON.parse(`/** vers packages **/`);
 
 
 async function init() {
-	await Debugger.init(projectPkg.dev.debug || []);
+	await Debugger.init({gateways: projectPkg.dev.debug || []});
 	const sdk = new SnackSDK({
 		service: Context.get('snackbar'),
 		importMaps: {
@@ -58,7 +57,7 @@ async function init() {
 			/>
 		);
 	};
-	const root = createRoot(document.getElementById('app')!);
+	const root = createReactRoot(document.getElementById('app')!);
 	root.render(<Main/>);
 
 }

package/template/entry/index.tsx

@@ -1,11 +1,10 @@
 // @ts-nocheck
 import React from 'react';
 import ReactDOM from 'react-dom';
-import {createRoot} from 'react-dom/client';
 import {Context, GetURLParams} from '@snack-kit/lib';
 import * as SnackLib from '@snack-kit/lib';
 
-import {SnackSDK} from '@snack-kit/core';
+import {SnackSDK, createReactRoot} from '@snack-kit/core';
 import '../normalize.scss';
 
 /** import plugin js **/
@@ -44,7 +43,7 @@ import '../normalize.scss';
 		});
 		window.snackSDK = sdk;
 		const Page = await sdk.createPageComponent({id, type});
-		const root = createRoot(document.getElementById('app'));
+		const root = createReactRoot(document.getElementById('app'));
 		root.render((
 			<Page/>
 		));

package/template/snack/index.tsx

@@ -1,10 +1,9 @@
 // @ts-nocheck
 import React from 'react';
 import ReactDOM from 'react-dom';
-import {createRoot} from 'react-dom/client';
 import {Context, Origin, axios} from '@snack-kit/lib';
 
-import {SnackSDK} from '@snack-kit/core';
+import {SnackSDK, createReactRoot} from '@snack-kit/core';
 import '../normalize.scss';
 
 /** import plugin js **/
@@ -28,7 +27,7 @@ async function init() {
 	let StttingMain;
 	if (Setting)
 		StttingMain = await sdk.createModuleComponent({main, name: SnackName, type: SnackType, setting: true});
-	const root = createRoot(document.getElementById('app')!);
+	const root = createReactRoot(document.getElementById('app')!);
 	root.render((
 			<>
 				{StttingMain ? (