@snack-kit/scripts 0.8.0 → 0.9.0

package/README.md

@@ -156,11 +156,17 @@ src/package/UserManager/
 
 ## config-overrides.js
 
-在项目根目录创建 `config-overrides.js` 可自定义 webpack 配置：
+在项目根目录创建 `config-overrides.js` 可自定义 webpack 配置。
+
+> **注意：** `snack-scripts` 会将已解析的 webpack 实例作为**第二参数**传入。若需使用 webpack 内置插件（如 `ProvidePlugin`），必须使用该参数而非 `require('webpack')`，否则会因 tapable 多实例冲突导致构建报错。
 
 ```js
-module.exports = (config) => {
-    // 修改 webpack 配置
+module.exports = (config, webpack) => {
+    // 使用传入的 webpack 实例，而非 require('webpack')
+    config.plugins = [
+        ...config.plugins,
+        new webpack.ProvidePlugin({ /* ... */ }),
+    ];
     return config;
 };
 ```
@@ -183,6 +189,11 @@ module.exports = (config) => {
 
 ## Changelog
 
+### 0.9.0
+
+- 修复：sass-loader 改回 legacy API，解决旧项目 `@import '~xxx'` 路径无法解析的问题（`api: 'modern'` 的 webpack importer 在 sass-loader 13.x 中未实现）
+- 优化：添加 `silenceDeprecations` 配置，屏蔽 Dart Sass 1.80+ 对 `@import`、legacy JS API 等语法的弃用警告，迁移期间无需修改 SCSS 源文件
+
 ### 0.8.0
 
 - 重构：`bin/main.js` 拆分为 `snack-cli`（init / create）和 `snack-scripts`（start / build / entry）两个独立命令

package/bin/snack-scripts.js

@@ -36,15 +36,16 @@ const entryConfigPath = path.resolve(__dirname, '../config/webpack.entry.config.
 
 const platform = process.platform;
 const webpackFile = platform === 'win32' ? 'webpack.cmd' : 'webpack';
-const isNpm = fs.existsSync(path.resolve(process.cwd(), './node_modules/.bin/', webpackFile));
+
+// 始终使用 snack-scripts 自身内置的 webpack CLI，保证 CLI 进程与配置文件加载同一 webpack 实例，
+// 避免与宿主项目 node_modules 中的 webpack 产生多实例 tapable 冲突。
+const webpackBin = path.resolve(__dirname, '../node_modules/.bin/', webpackFile);
 
 // ─── webpack 构建命令 ─────────────────────────────────────────────────────────
 
 function execWebpack(wpArgs) {
     return new Promise(resolve => {
-        const ps = isNpm
-            ? spawn('webpack', wpArgs, { stdio: 'inherit', shell: true })
-            : spawn(path.resolve(__dirname, '../node_modules/.bin/', webpackFile), wpArgs, { stdio: 'inherit' });
+        const ps = spawn(webpackBin, wpArgs, { stdio: 'inherit' });
         ps.on('error', e => { console.log(e); resolve(false); });
         ps.on('exit', () => resolve(true));
     });

package/config/webpack.dev.config.js

@@ -100,7 +100,7 @@ const configOverridesPath = path.resolve(process.env.PROJECT_PATH, 'config-overr
 if (fs.existsSync(configOverridesPath)) {
     try {
         const overrides = require(configOverridesPath);
-        conf = overrides(conf);
+        conf = overrides(conf, webpack);
         console.log('snack config overrides');
     } catch (err) {
         console.error('SnackCLI Error:', err);

package/config/webpack.shared.js

@@ -151,7 +151,22 @@ function createSwcRule(withRefresh = false) {
  */
 const styleRule = {
     test: /\.(css|sass|scss)$/,
-    use: ['style-loader', 'css-loader', { loader: 'sass-loader', options: { api: 'modern' } }]
+    use: [
+        'style-loader',
+        'css-loader',
+        {
+            loader: 'sass-loader',
+            options: {
+                // 使用 legacy API：getModernWebpackImporter 在 sass-loader 13.x 中未实现，
+                // 导致 @import '~xxx' 的 ~ 前缀无法解析；legacy API 有完整的 webpack resolver 支持
+                webpackImporter: true,
+                sassOptions: {
+                    // 屏蔽 Dart Sass 1.80+ 对 @import 语法的弃用警告，旧项目迁移期间无需修改 SCSS
+                    silenceDeprecations: ['import', 'global-builtin', 'color-functions', 'legacy-js-api']
+                }
+            }
+        }
+    ]
 };
 
 /**
@@ -219,17 +234,12 @@ const filesystemCache = {
 };
 
 /**
- * 解析 webpack 模块，优先使用宿主项目的 webpack 实例。
- * 保证 webpack config 文件与 webpack CLI 进程使用同一个 webpack 实例，
- * 避免多实例导致的 instanceof 检查失败（Critical dependency / Compilation 错误）。
+ * 获取 webpack 实例。
+ * 始终使用 snack-scripts 自身内置的 webpack，保证 CLI 进程与 config 文件加载同一个实例，
+ * 避免与宿主项目 node_modules 中的 webpack 产生多实例 tapable 冲突。
  */
 function resolveProjectWebpack() {
-    const searchPaths = [process.env.PROJECT_PATH, __dirname].filter(Boolean);
-    try {
-        return require(require.resolve('webpack', { paths: searchPaths }));
-    } catch (_) {
-        return require('webpack');
-    }
+    return require('webpack');
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@snack-kit/scripts",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "snack-cli package scripts Powered by Para FED",
   "bin": {
     "snack-cli": "./bin/snack-cli.js",
@@ -16,7 +16,7 @@
     "tsconfig.json"
   ],
   "scripts": {
-    "dev:start": "node bin/snack-scripts.js start --project=/Users/liujia/工作/snack/code-editor",
+    "dev:start": "node bin/snack-scripts.js start --project=/Users/liujia/工作/snack/pam-snack",
     "dev:build": "node bin/snack-scripts.js build --project=/Users/liujia/工作/snack3-test",
     "release": "npm publish --access public",
     "release:beta": "npm publish --tag=beta --access public",