generator-mico-cli 0.2.25 → 0.2.27

package/README.md

@@ -216,7 +216,9 @@ pnpm test:watch
 | `tests/integration/micro-react.test.js` | micro-react 生成器集成测试 |
 | `tests/integration/subapp-react.test.js` | subapp-react 生成器集成测试 |
 | `tests/integration/subapp-umd.test.js` | subapp-umd 生成器集成测试 |
+| `tests/integration/mico-cli.test.js` | `mico` 入口子进程测试（help / version / list / create 透传） |
 | `tests/helpers/setup.js` | 测试共享工具（路径常量、monorepo fixture 工厂） |
+| `tests/helpers/mico-subprocess.js` | 子进程运行 `bin/mico.js`、假 `yo` 工具函数 |
 
 ### Scripts 说明
 

package/generators/micro-react/templates/apps/layout/config/config.dev.ts

@@ -64,7 +64,6 @@ const config: ReturnType<typeof defineConfig> = {
   define: {
     'process.env.NODE_ENV': 'development',
     'process.env.API_BASE_URL': '',
-    'process.env.PROXY_SUFFIX': '/proxy/<%= projectName %>_svr',
     'process.env.LOGIN_ENDPOINT':
       'https://dashboard-api-test.micoplatform.com/api/yufu_login/',
     'process.env.REFRESH_ENDPOINT':

package/generators/micro-react/templates/apps/layout/config/config.prod.development.ts

@@ -3,6 +3,11 @@
 import { defineConfig } from '@umijs/max';
 // 开发环境，不上传 sourcemap。调试时如有需要再解开
 // import { applySentryPlugin } from "../../../scripts/apply-sentry-plugin";
+const { CDN_PUBLIC_PATH } = process.env;
+
+const PUBLIC_PATH: string = CDN_PUBLIC_PATH
+  ? `${CDN_PUBLIC_PATH.replace(/\/?$/, '/')}layout/`
+  : '/layout/';
 
 const config: ReturnType<typeof defineConfig> = {
   // 开发环境，不上传 sourcemap。调试时如有需要再解开
@@ -19,10 +24,11 @@ const config: ReturnType<typeof defineConfig> = {
     'react-dom': 'ReactDOM',
     '@common-web/sentry': 'CommonWebSentry',
   },
+  publicPath: PUBLIC_PATH,
+  cssPublicPath: PUBLIC_PATH,
   define: {
     'process.env.NODE_ENV': 'development',
     'process.env.API_BASE_URL': 'https://dashboard-api-test.micoplatform.com',
-    'process.env.PROXY_SUFFIX': '/proxy/<%= projectName %>_svr',
     'process.env.LOGIN_ENDPOINT':
       'https://dashboard-api-test.micoplatform.com/api/yufu_login/',
     'process.env.REFRESH_ENDPOINT':

package/generators/micro-react/templates/apps/layout/config/config.prod.testing.ts

@@ -3,6 +3,11 @@
 import { defineConfig } from '@umijs/max';
 // 测试环境，不上传 sourcemap。调试时如有需要再解开
 // import { applySentryPlugin } from "../../../scripts/apply-sentry-plugin";
+const { CDN_PUBLIC_PATH } = process.env;
+
+const PUBLIC_PATH: string = CDN_PUBLIC_PATH
+  ? `${CDN_PUBLIC_PATH.replace(/\/?$/, '/')}layout/`
+  : '/layout/';
 
 const config: ReturnType<typeof defineConfig> = {
   // 测试环境，不上传 sourcemap。调试时如有需要再解开
@@ -19,10 +24,11 @@ const config: ReturnType<typeof defineConfig> = {
     'react-dom': 'ReactDOM',
     '@common-web/sentry': 'CommonWebSentry',
   },
+  publicPath: PUBLIC_PATH,
+  cssPublicPath: PUBLIC_PATH,
   define: {
     'process.env.NODE_ENV': 'testing',
     'process.env.API_BASE_URL': 'https://dashboard-api-test.micoplatform.com',
-    'process.env.PROXY_SUFFIX': '/proxy/<%= projectName %>_svr',
     'process.env.LOGIN_ENDPOINT':
       'https://dashboard-api-test.micoplatform.com/api/yufu_login/',
     'process.env.REFRESH_ENDPOINT':

package/generators/micro-react/templates/apps/layout/config/config.prod.ts

@@ -17,7 +17,6 @@ const config: ReturnType<typeof defineConfig> = {
   define: {
     'process.env.NODE_ENV': 'production',
     'process.env.API_BASE_URL': 'https://dashboard-api.micoplatform.com',
-    'process.env.PROXY_SUFFIX': '/proxy/<%= projectName %>_svr',
     'process.env.LOGIN_ENDPOINT':
       'https://dashboard-api.micoplatform.com/api/yufu_login/',
     'process.env.REFRESH_ENDPOINT':
@@ -43,6 +42,7 @@ const config: ReturnType<typeof defineConfig> = {
     return memo;
   },
   publicPath: PUBLIC_PATH,
+  cssPublicPath: PUBLIC_PATH,
 };
 
 export default defineConfig(config);

package/generators/micro-react/templates/apps/layout/docs/feature-/345/276/256/345/211/215/347/253/257/346/250/241/345/274/217.md

@@ -1,7 +1,7 @@
 # 微前端模式
 
 > 创建时间：2025-12-26
-> 更新时间：2025-01-25（加载健壮性增强）
+> 更新时间：2025-03-20（MicroAppLoader 增加 base 与 normalizeMicroAppBase）
 
 ## 功能概述
 
@@ -45,6 +45,8 @@
 
 ```typescript
 interface MicroAppLoaderProps {
+  /** 微应用在主应用中的挂载路径前缀（通常与当前页面 route.path 一致），经 normalizeMicroAppBase 后传给子应用 */
+  base: string;
   /** 微应用入口 URL */
   entry: string;
   /** 微应用名称 */
@@ -60,11 +62,47 @@ interface MicroAppLoaderProps {
 
 | 参数 | 类型 | 必填 | 说明 |
 |------|------|------|------|
+| base | string | 是 | 挂载路径前缀；经 `normalizeMicroAppBase` 后作为子应用 `props.base` |
 | entry | string | 是 | qiankun 入口 URL (htmlUrl 或 jsUrls[0]) |
 | name | string | 是 | 微应用唯一标识 |
 | displayName | string | 否 | 显示名称，用于加载提示 |
 | routePath | string | 否 | 当前路由路径，用于子应用内部路由切换 |
 
+### MicroAppLoader 路由与 base
+
+主应用为微应用补充 **挂载前缀 `base`**，便于子应用对齐 basename、publicPath、内部路由等与路径相关的逻辑；**是否与免鉴权配置做前缀匹配**以当前实现为准（见下「加载门控」）。
+
+#### `base` 与 `routePath` 的区别
+
+| 字段 | 含义 |
+| --- | --- |
+| **base** | 该微应用在主应用中的**根路径前缀**，一般等于菜单/动态路由里的 `path`。 |
+| **routePath** | 当前激活的**完整路由路径**，随浏览器 URL 变化，用于通知子应用做**内部路由同步**。 |
+
+二者在 `layouts/index.tsx` 中常同为 `currentRoute.path`；在 `app.tsx` 的 `patchClientRoutes` 里与动态路由项一致，传入 **`base: route.path`**、**`name: route.path`**（`name` 另在布局侧可能改为基于 `entry` 的 `getAppNameFromEntry`，与 `base` 来源不同，需注意）。
+
+#### `normalizeMicroAppBase`
+
+组件内导出工具函数（见 `MicroAppLoader/index.tsx`）：
+
+```typescript
+export const normalizeMicroAppBase = (path: string): string =>
+  path.replace(/\/+$/, '').replace(/\*+$/, '');
+```
+
+含义：先去掉末尾 `/`，再去掉末尾 `*`（兼容路由表中的 `/foo/*` 等写法）。**传给子应用的 `props.base` 为规范化后的字符串**。
+
+#### 调用处传参
+
+| 位置 | 说明 |
+| --- | --- |
+| `src/app.tsx` `patchClientRoutes` | 动态注册微应用路由时：`React.createElement(MicroAppLoader, { entry, name: route.path, base: route.path, ... })` |
+| `src/layouts/index.tsx` | 布局内渲染：`<MicroAppLoader base={currentRoute.path} routePath={currentRoute.path} ... />` |
+
+#### 加载门控（认证）
+
+微应用开始执行 `switchTo` / 挂载前，需 **`isAuthReady`**（`isAuthDisabled`、`isPageAuthFree`、`isNoAuthRoute(location.pathname)`、`isNoPermissionRoute(location.pathname)` 或已存在 `currentUser` 等，见组件内实现）。**当前以浏览器 `location.pathname` 与全局常量为准**，未单独使用 `base` 与 `window.__MICO_CONFIG__.noAuthRouteList` 做前缀匹配。
+
 ### MicroAppProps (传递给子应用)
 
 ```typescript
@@ -87,6 +125,8 @@ interface MicroAppProps {
   timezone: string;
   /** 在线状态 */
   presenceStatus: string;
+  /** 挂载路径前缀（为 `normalizeMicroAppBase(MicroAppLoader.base)`） */
+  base: string;
   /** 当前路由路径 */
   routePath?: string;
   /** 共享的 request 实例，子应用可直接使用 */
@@ -211,7 +251,11 @@ const menus: MenuItem[] = [
 const renderContent = () => {
   if (currentRoute?.loadType === 'microapp' && currentRoute.entry) {
     return (
-      <MicroAppLoader entry={currentRoute.entry} name={currentRoute.name} />
+      <MicroAppLoader
+        entry={currentRoute.entry}
+        name={currentRoute.name}
+        base={currentRoute.path}
+      />
     );
   }
   return <Outlet />;

package/generators/micro-react/templates/apps/layout/mock/menus.ts

@@ -80,7 +80,7 @@ const mockMenus: MockMenuItem[] = [
         nameEn: 'Subapp Page',
         nameKey: 'cs_web_menu_subapp_page',
         type: 'page',
-        path: '/subapp/*',
+        path: '/subapp',
         icon: 'Desktop',
         enabled: true,
         sortOrder: 1,

package/generators/micro-react/templates/apps/layout/mock/pages.ts

@@ -28,6 +28,7 @@ const mockPages: PublicPageItem[] = [
     nameEn: 'Login',
     nameKey: 'page.user.login',
     route: '/user/login',
+    base: '/user/login',
     htmlUrl:
       'https://cdn-portal.micoplatform.com/portal-center/common-web/0.0.4/login/index.html',
     jsUrls: [],
@@ -47,6 +48,7 @@ const mockPages: PublicPageItem[] = [
     nameEn: 'Permission Management',
     nameKey: 'page.permission',
     route: '/permission',
+    base: '/',
     htmlUrl:
       'https://cdn-portal.micoplatform.com/portal-center/common-web/0.0.4/permission/index.html',
     jsUrls: [],
@@ -66,6 +68,7 @@ const mockPages: PublicPageItem[] = [
     nameEn: 'Fallback',
     nameKey: 'page.fallback',
     route: '/*',
+    base: '/',
     htmlUrl: '',
     jsUrls: [],
     cssUrls: [],

package/generators/micro-react/templates/apps/layout/src/app.tsx

@@ -226,6 +226,7 @@ export function patchClientRoutes({ routes }: { routes: UmiRoute[] }) {
         ? React.createElement(MicroAppLoader, {
             entry: route.entry,
             name: route.path,
+            base: route.base,
             displayName: route.name,
           })
         : undefined;

package/generators/micro-react/templates/apps/layout/src/common/menu/parser.ts

@@ -22,6 +22,7 @@ export const extractRoutesFromPages = (
       return {
         path: page.route,
         name: page.name,
+        base: page.base || '/',
         icon: '',
         loadType: (hasEntry ? 'microapp' : 'internal') as
           | 'internal'
@@ -269,6 +270,7 @@ export const extractRoutes = (
       if (page && page.enabled) {
         routes.push({
           path: page.route,
+          base: page.base || '/',
           name: item.name,
           nameEn: item.nameEn,
           icon: item.icon,

package/generators/micro-react/templates/apps/layout/src/common/menu/types.ts

@@ -16,6 +16,8 @@ export interface PageConfig {
   nameKey?: string;
   /** 路由路径 */
   route: string;
+  /** 路由前缀路径 */
+  base: string;
   /** 是否启用 */
   enabled: boolean;
   /** 微应用 HTML 入口 URL (用于 qiankun 加载) */
@@ -90,6 +92,8 @@ export interface MenuItem {
  */
 export interface ParsedRoute {
   path: string;
+  /** 微应用在主应用中的挂载前缀（来自页面配置 base，可与 path 不同） */
+  base: string;
   /** 菜单显示名称（中文） */
   name: string;
   /** 菜单显示名称（英文） */

package/generators/micro-react/templates/apps/layout/src/common/request/config.ts

@@ -3,6 +3,7 @@
  * appId 优先从 window.__MICO_WORKSPACE__ 获取，其次从 window.__MICO_CONFIG__ 获取；
  * externalLoginPath 优先从 window.__MICO_WORKSPACE__.casServerLoginUrl 获取；
  * 其余 apiBaseUrl / proxySuffix / loginEndpoint / refreshEndpoint 优先从 window.__MICO_CONFIG__ 同名字段获取，兜底取 process.env 环境变量。
+ * proxySuffix：若 __MICO_CONFIG__.proxySuffix 与 process.env.PROXY_SUFFIX 均未配置，则按已解析的 appId 推导为 /proxy/${appId}_svr。
  */
 
 import { getStoredAuthToken } from '../auth/auth-manager';
@@ -18,6 +19,15 @@ function getMicoWorkspace(): Window['__MICO_WORKSPACE__'] {
   return window.__MICO_WORKSPACE__ ?? undefined;
 }
 
+/** 显式 proxySuffix 优先；否则在有 appId 时使用 /proxy/${appId}_svr */
+function resolveProxySuffixWithFallback(
+  explicit: string,
+  appId: string,
+): string {
+  if (explicit) return explicit;
+  return appId ? `/proxy/${appId}_svr` : '';
+}
+
 function buildDefaultClientOptions(): RequestClientOptions {
   const envDefaults: RequestClientOptions = {
     appId: '',
@@ -36,14 +46,27 @@ function buildDefaultClientOptions(): RequestClientOptions {
       ? String(workspace.appId)
       : undefined;
   const externalLoginFromWorkspace = workspace?.casServerLoginUrl;
-  if (!mico && !appIdFromWorkspace && !externalLoginFromWorkspace)
-    return envDefaults;
+  if (!mico && !appIdFromWorkspace && !externalLoginFromWorkspace) {
+    return {
+      ...envDefaults,
+      proxySuffix: resolveProxySuffixWithFallback(
+        envDefaults.proxySuffix,
+        envDefaults.appId,
+      ),
+    };
+  }
+  const resolvedAppId =
+    appIdFromWorkspace ?? mico?.appId ?? envDefaults.appId;
+  const explicitProxy = mico?.proxySuffix ?? envDefaults.proxySuffix;
   return {
     ...envDefaults,
     ...(mico?.defaultClientOptions ?? {}),
-    appId: appIdFromWorkspace ?? mico?.appId ?? envDefaults.appId,
+    appId: resolvedAppId,
     apiBaseUrl: mico?.apiBaseUrl ?? envDefaults.apiBaseUrl,
-    proxySuffix: mico?.proxySuffix ?? envDefaults.proxySuffix,
+    proxySuffix: resolveProxySuffixWithFallback(
+      explicitProxy,
+      resolvedAppId,
+    ),
     loginEndpoint: mico?.loginEndpoint ?? envDefaults.loginEndpoint,
     refreshEndpoint: mico?.refreshEndpoint ?? envDefaults.refreshEndpoint,
     externalLoginPath:

package/generators/micro-react/templates/apps/layout/src/components/MicroAppLoader/index.tsx

@@ -11,6 +11,8 @@ import './index.less';
 import { microAppManager, type MicroAppState } from './micro-app-manager';
 
 interface MicroAppLoaderProps {
+  /** 微应用在主应用中的挂载路径前缀（来自 ParsedRoute.base / 页面配置 base），经 normalizeMicroAppBase 后传给子应用 */
+  base: string;
   entry: string;
   name: string;
   displayName?: string;
@@ -18,6 +20,10 @@ interface MicroAppLoaderProps {
   routePath?: string;
 }
 
+/** 微应用 base：先去掉末尾 /，再去掉末尾 *（与路由 path 约定一致） */
+export const normalizeMicroAppBase = (path: string): string =>
+  path.replace(/\/+$/, '').replace(/\*+$/, '');
+
 const sanitizeId = (path: string): string => {
   return (
     path
@@ -35,6 +41,7 @@ const sanitizeId = (path: string): string => {
  * 用户意图追踪在 MicroAppManager 内部处理。
  */
 const MicroAppLoader: React.FC<MicroAppLoaderProps> = ({
+  base,
   entry,
   name,
   displayName,
@@ -77,6 +84,7 @@ const MicroAppLoader: React.FC<MicroAppLoaderProps> = ({
       uid: authInfo.uid,
       avatar: authInfo.avatar,
       nickname: authInfo.nickname,
+      base: normalizeMicroAppBase(base || '/'),
       // 传递当前路由路径，让子应用进行内部路由切换
       routePath,
       // 传递主应用的 request 实例，子应用可直接使用
@@ -84,7 +92,7 @@ const MicroAppLoader: React.FC<MicroAppLoaderProps> = ({
       // 传递当前多语言类型给子应用（zh-CN, en-US）
       locale: getCurrentLocale(),
     };
-  }, [env, routePath]);
+  }, [base, env, routePath]);
 
   // ref 持有最新的 buildProps，避免加载 effect 依赖它导致子应用被重载
   const buildPropsRef = useRef(buildProps);
@@ -129,7 +137,7 @@ const MicroAppLoader: React.FC<MicroAppLoaderProps> = ({
       microAppManager.cancel();
       microAppManager.setStateCallback(null);
     };
-  }, [entry, appName, isAuthReady]);
+  }, [entry, appName, isAuthReady, buildProps]);
 
   return (
     <div className="micro-app-container">

package/generators/micro-react/templates/apps/layout/src/layouts/index.tsx

@@ -184,6 +184,7 @@ const BasicLayout: React.FC = () => {
             // 同一个微应用的不同路由共用同一个实例
             key={appName}
             entry={currentRoute.entry}
+            base={currentRoute.base}
             // 使用 entry 生成的标识，而不是 path
             name={appName}
             // 显示名称用于 loading 提示

package/generators/subapp-react/index.js

@@ -323,6 +323,7 @@ module.exports = class extends Generator {
         `    nameEn: '${this.appNamePascal}',`,
         `    nameKey: 'page.${this.appName}',`,
         `    route: '/${this.appName}',`,
+        `    base: '/${this.appName}',`,
         `    htmlUrl: '//localhost:${this.devPort}',`,
         '    jsUrls: [],',
         '    cssUrls: [],',

package/generators/subapp-react/templates/homepage/config/config.prod.development.ts

@@ -3,6 +3,11 @@
 import { defineConfig } from '@umijs/max';
 // 开发环境，不上传 sourcemap。调试时如有需要再解开
 // import { applySentryPlugin } from "../../../scripts/apply-sentry-plugin";
+const { CDN_PUBLIC_PATH } = process.env;
+
+const PUBLIC_PATH: string = CDN_PUBLIC_PATH
+  ? `${CDN_PUBLIC_PATH.replace(/\/?$/, '/')}<%= appName %>/`
+  : '/<%= appName %>/';
 
 const config: ReturnType<typeof defineConfig> = {
   // 开发环境，不上传 sourcemap。调试时如有需要再解开
@@ -11,12 +16,16 @@ const config: ReturnType<typeof defineConfig> = {
   // 测试环境：将所有代码打包到一个文件
   extraBabelPlugins: ['babel-plugin-dynamic-import-node'],
 
+  publicPath: PUBLIC_PATH,
+  cssPublicPath: PUBLIC_PATH,
+
   // 禁用代码分割，只输出一个 JS 和一个 CSS
   chainWebpack(memo) {
     // 禁用 splitChunks
     memo.optimization.splitChunks(false);
     // 禁用 runtimeChunk
     memo.optimization.runtimeChunk(false);
+    memo.plugins.delete('runtimePublicPath');
     // 开发环境，不上传 sourcemap。调试时如有需要再解开
     // applySentryPlugin({ memo, appName: '<%= appName %>' });
     return memo;

package/generators/subapp-react/templates/homepage/config/config.prod.testing.ts

@@ -3,6 +3,11 @@
 import { defineConfig } from '@umijs/max';
 // 测试环境，不上传 sourcemap。调试时如有需要再解开
 // import { applySentryPlugin } from "../../../scripts/apply-sentry-plugin";
+const { CDN_PUBLIC_PATH } = process.env;
+
+const PUBLIC_PATH: string = CDN_PUBLIC_PATH
+  ? `${CDN_PUBLIC_PATH.replace(/\/?$/, '/')}<%= appName %>/`
+  : '/<%= appName %>/';
 
 const config: ReturnType<typeof defineConfig> = {
   // 测试环境，不上传 sourcemap。调试时如有需要再解开
@@ -11,12 +16,16 @@ const config: ReturnType<typeof defineConfig> = {
   // 测试环境：将所有代码打包到一个文件
   extraBabelPlugins: ['babel-plugin-dynamic-import-node'],
 
+  publicPath: PUBLIC_PATH,
+  cssPublicPath: PUBLIC_PATH,
+
   // 禁用代码分割，只输出一个 JS 和一个 CSS
   chainWebpack(memo) {
     // 禁用 splitChunks
     memo.optimization.splitChunks(false);
     // 禁用 runtimeChunk
     memo.optimization.runtimeChunk(false);
+    memo.plugins.delete('runtimePublicPath');
     // 测试环境，不上传 sourcemap。调试时如有需要再解开
     // applySentryPlugin({ memo, appName: '<%= appName %>' });
     return memo;

package/generators/subapp-react/templates/homepage/config/config.prod.ts

@@ -24,9 +24,11 @@ const config: ReturnType<typeof defineConfig> = {
     // 禁用 runtimeChunk
     memo.optimization.runtimeChunk(false);
     applySentryPlugin({ memo, appName: '<%= appName %>' });
+    memo.plugins.delete('runtimePublicPath');
     return memo;
   },
   publicPath: PUBLIC_PATH,
+  cssPublicPath: PUBLIC_PATH,
 
   /**
    * @name 外部依赖配置

package/generators/subapp-react/templates/homepage/config/routes.ts

@@ -3,5 +3,5 @@
  * @description <%= appName %> 子应用的路由配置
  */
 export default [
-  { path: '/<%= appName %>', component: '@/pages/index' },
+  { path: '/', component: '@/pages/index' },
 ];

package/generators/subapp-react/templates/homepage/src/app.tsx

@@ -13,6 +13,11 @@ import { SentryErrorBoundary } from '@common-web/sentry';
 import { appLogger } from './common/logger';
 import { type IMicroAppProps, setMainAppProps } from './common/mainApp';
 
+/** 与 layout parser.findRouteByPath 一致：根路径 "/" 保持不变 */
+function stripTrailingSlash(path: string): string {
+  return path.length > 1 && path.endsWith('/') ? path.slice(0, -1) : path;
+}
+
 /**
  * @name 路由同步工具
  * @description 处理主应用与子应用之间的路由同步，支持通配符路由模式
@@ -20,12 +25,12 @@ import { type IMicroAppProps, setMainAppProps } from './common/mainApp';
 function syncRoute(routePath: string, logPrefix = 'route sync') {
   if (!history) return;
 
-  const currentPath = history.location.pathname;
+  const currentPath = stripTrailingSlash(history.location.pathname);
   const isWildcard = routePath.endsWith('/*');
-  // 通配符模式取基础路径，否则使用原路径
-  const targetPath = isWildcard ? routePath.slice(0, -2) : routePath;
+  const targetPath = stripTrailingSlash(
+    isWildcard ? routePath.slice(0, -2) : routePath,
+  );
 
-  // 判断当前路径是否已匹配目标
   const isMatched = isWildcard
     ? currentPath === targetPath || currentPath.startsWith(`${targetPath}/`)
     : currentPath === targetPath;

package/lib/utils.js

@@ -2,7 +2,7 @@
 
 const fs = require('node:fs');
 const path = require('node:path');
-const { execSync, execFileSync, execFile } = require('node:child_process');
+const { exec, execSync, execFileSync, execFile } = require('node:child_process');
 const os = require('node:os');
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "generator-mico-cli",
-  "version": "0.2.25",
+  "version": "0.2.27",
   "description": "Yeoman generator for Mico CLI projects",
   "keywords": [
     "yeoman-generator",
@@ -18,6 +18,7 @@
     "generators"
   ],
   "scripts": {
+    "prepare": "husky",
     "format": "biome format --write .",
     "format:check": "biome format .",
     "test": "vitest run",
@@ -27,6 +28,7 @@
   },
   "devDependencies": {
     "@biomejs/biome": "^1.9.4",
+    "husky": "^9.1.7",
     "vitest": "^4.0.18",
     "yeoman-environment": "^3.19.3",
     "yeoman-test": "^6.3.0"