@lark-apaas/fullstack-presets 1.0.13 → 1.1.0

package/README.md

@@ -0,0 +1,2 @@
+# 全栈技术栈 Presets
+独立拆分 simple 目录，属于全栈精简版，目前妙搭场景专用。

package/lib/index.d.ts

@@ -1,3 +1,9 @@
 export { createTailwindPreset } from './recommend/tailwind/createTailwindPreset';
 export { eslintPresets } from './recommend/eslint';
 export { stylelintPresets } from './recommend/stylelint';
+/**
+ * NestJs 精简版本配置（妙搭专用）
+ */
+export { createTailwindPreset as createTailwindPresetOfSimple } from './simple/recommend/tailwind/createTailwindPreset';
+export { eslintPresets as eslintPresetsOfSimple } from './simple/recommend/eslint';
+export { stylelintPresets as stylelintPresetsOfSimple } from './simple/recommend/stylelint';

package/lib/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.stylelintPresets = exports.eslintPresets = exports.createTailwindPreset = void 0;
+exports.stylelintPresetsOfSimple = exports.eslintPresetsOfSimple = exports.createTailwindPresetOfSimple = exports.stylelintPresets = exports.eslintPresets = exports.createTailwindPreset = void 0;
 // Tailwind 配置
 var createTailwindPreset_1 = require("./recommend/tailwind/createTailwindPreset");
 Object.defineProperty(exports, "createTailwindPreset", { enumerable: true, get: function () { return createTailwindPreset_1.createTailwindPreset; } });
@@ -10,3 +10,15 @@ Object.defineProperty(exports, "eslintPresets", { enumerable: true, get: functio
 // Stylelint 配置
 var stylelint_1 = require("./recommend/stylelint");
 Object.defineProperty(exports, "stylelintPresets", { enumerable: true, get: function () { return stylelint_1.stylelintPresets; } });
+/**
+ * NestJs 精简版本配置（妙搭专用）
+ */
+// Tailwind 配置
+var createTailwindPreset_2 = require("./simple/recommend/tailwind/createTailwindPreset");
+Object.defineProperty(exports, "createTailwindPresetOfSimple", { enumerable: true, get: function () { return createTailwindPreset_2.createTailwindPreset; } });
+// Eslint 配置
+var eslint_2 = require("./simple/recommend/eslint");
+Object.defineProperty(exports, "eslintPresetsOfSimple", { enumerable: true, get: function () { return eslint_2.eslintPresets; } });
+// Stylelint 配置
+var stylelint_2 = require("./simple/recommend/stylelint");
+Object.defineProperty(exports, "stylelintPresetsOfSimple", { enumerable: true, get: function () { return stylelint_2.stylelintPresets; } });

package/lib/recommend/eslint/eslint-client.js

@@ -132,7 +132,7 @@ exports.default = {
             },
             // 禁止使用 text-accent
             {
-                selector: 'JSXAttribute[name.name="className"][value.value=/text-accent/]',
+                selector: 'JSXAttribute[name.name="className"][value.value=/(^|\\s)text-accent(\\s|$)/]',
                 message: 'Classname "text-accent" would cause visibility issues. Consider using proper semantic color tokens from `client/src/tailwind-theme.css`',
             },
         ],

package/lib/recommend/rspack/index.d.ts

@@ -0,0 +1,9 @@
+import { type Configuration } from '@rspack/core';
+export declare function createRecommendRspackConfig(options: {
+    enableReactRefresh?: boolean;
+    isDev?: boolean;
+    /** 是否需要插件解析路由 */
+    needRoutes?: boolean;
+    /** 运行态模式，默认为全栈模式 */
+    runtimeMode?: string;
+}): Configuration;

package/lib/recommend/rspack/index.js

@@ -0,0 +1,210 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRecommendRspackConfig = createRecommendRspackConfig;
+const path_1 = __importDefault(require("path"));
+const core_1 = __importDefault(require("@rspack/core"));
+const dev_server_listener_1 = require("../utils/dev-server-listener");
+const RouteParserPlugin = require('../rspack-plugins/route-parser-plugin');
+const SlardarPerformanceMonitorPlugin = require('../rspack-plugins/slardar-performance-monitor-plugin');
+function createRecommendRspackConfig(options) {
+    const { enableReactRefresh = false, isDev = true, needRoutes = true, runtimeMode = 'fullstack', } = options;
+    return {
+        experiments: {
+            css: true,
+        },
+        module: {
+            rules: [
+                {
+                    test: /\.svg$/,
+                    type: 'asset',
+                    parser: {
+                        dataUrlCondition: {
+                            maxSize: 10 * 1024, // 对应vite的assetsInlineLimit
+                        },
+                    },
+                },
+                {
+                    test: /\.(png|jpe?g|gif|webp|ico)$/,
+                    type: 'asset',
+                    parser: {
+                        dataUrlCondition: {
+                            maxSize: 10 * 1024, // 对应vite的assetsInlineLimit
+                        },
+                    },
+                },
+                {
+                    test: /\.css$/,
+                    use: [
+                        {
+                            loader: 'postcss-loader',
+                            options: {
+                                postcssOptions: {
+                                    plugins: [
+                                        [
+                                            'postcss-import',
+                                            {
+                                                resolve: (id, _basedir) => {
+                                                    // 只有dev环境需要打包选中精调所需的一些预置样式, prod环境则不打包
+                                                    if (id === '@/inspector.dev.css') {
+                                                        return isDev
+                                                            ? path_1.default.join(_basedir, '/inspector.dev.css')
+                                                            : [];
+                                                    }
+                                                    return id;
+                                                },
+                                            },
+                                        ],
+                                    ],
+                                },
+                            },
+                        },
+                    ],
+                    type: 'css',
+                },
+                {
+                    test: /\.tsx?$/,
+                    use: [
+                        {
+                            loader: 'builtin:swc-loader',
+                            options: {
+                                /**
+                                 * @type {import('@swc/core').JscConfig}
+                                 */
+                                jsc: {
+                                    parser: {
+                                        syntax: 'typescript',
+                                        jsx: true,
+                                    },
+                                    transform: {
+                                        react: {
+                                            runtime: 'automatic',
+                                            ...(isDev
+                                                ? {
+                                                    importSource: path_1.default.dirname(require.resolve('@lark-apaas/miaoda-inspector-jsx-runtime')),
+                                                }
+                                                : {}),
+                                            development: isDev,
+                                            refresh: enableReactRefresh,
+                                        },
+                                    },
+                                },
+                            },
+                        },
+                        ...(isDev
+                            ? [require.resolve('@lark-apaas/miaoda-inspector-babel-plugin')]
+                            : []),
+                    ],
+                },
+            ],
+        },
+        plugins: [
+            // 针对 clsx/echarts 等包，让其默认好用
+            new core_1.default.NormalModuleReplacementPlugin(/^(clsx|echarts)$/, function (resource) {
+                if (!resource.context.endsWith('module-alias')) {
+                    if (resource.request.endsWith('echarts')) {
+                        resource.request = require.resolve('../module-alias/echarts.js');
+                    }
+                    else {
+                        resource.request = require.resolve('../module-alias/clsx.js');
+                    }
+                }
+            }),
+            new core_1.default.DefinePlugin({
+                'process.env.NODE_ENV': JSON.stringify(isDev ? 'development' : 'production'),
+                'process.env.CWD': JSON.stringify(process.cwd()),
+                'process.env.runtimeMode': JSON.stringify(runtimeMode),
+            }),
+            new core_1.default.optimize.LimitChunkCountPlugin({
+                maxChunks: 1,
+            }),
+            // 全栈模式下，增加性能监控上报脚本注入
+            runtimeMode === 'fullstack'
+                ? new SlardarPerformanceMonitorPlugin()
+                : undefined,
+            // 开发环境下，解析路由
+            isDev &&
+                needRoutes &&
+                new RouteParserPlugin({
+                    appPath: './client/src/app.tsx',
+                    outputPath: path_1.default.resolve(__dirname, 'dist/client/routes.json'),
+                }),
+        ],
+        optimization: isDev
+            ? {}
+            : {
+                moduleIds: 'deterministic',
+                concatenateModules: true,
+                minimize: true, // 对应vite的minify配置
+                minimizer: [
+                    new core_1.default.SwcJsMinimizerRspackPlugin({
+                        minimizerOptions: {
+                            // 保持不压缩
+                            minify: !isDev,
+                            mangle: !isDev,
+                            format: {
+                                beautify: isDev,
+                                comments: false,
+                            },
+                            compress: {
+                                keep_classnames: true,
+                                keep_fnames: true,
+                                keep_fargs: !isDev,
+                                unused: true,
+                                dead_code: true,
+                                drop_debugger: true,
+                                // FIXME: 先临时开始 console.log
+                                // drop_console: !isDev,
+                                const_to_let: !isDev,
+                                booleans_as_integers: !isDev,
+                                booleans: !isDev,
+                                // maybe unsafe
+                                reduce_funcs: !isDev,
+                                reduce_vars: !isDev,
+                            },
+                        },
+                    }),
+                    new core_1.default.LightningCssMinimizerRspackPlugin(),
+                ],
+                sideEffects: true,
+                usedExports: true,
+                innerGraph: true,
+                providedExports: true,
+                mergeDuplicateChunks: true,
+                splitChunks: false, // 禁用代码分割，保持单文件输出
+            },
+        devtool: isDev ? 'source-map' : false, // 对应vite的sourcemap配置
+        devServer: {
+            headers: req => {
+                // 获取请求的Origin头
+                const requestOrigin = req.headers.origin ?? '';
+                // 定义允许的域名白名单
+                const allowedOrigins = [
+                    'https://miaoda.feishu.cn',
+                    'https://miaoda.feishu-boe.cn',
+                    'https://miaoda.feishu-pre.cn',
+                ];
+                // 检查请求的Origin是否在允许的列表中
+                const allowedOrigin = allowedOrigins.includes(requestOrigin)
+                    ? requestOrigin
+                    : allowedOrigins[0]; // 默认返回第一个允许的域名
+                return {
+                    'Access-Control-Allow-Origin': allowedOrigin,
+                };
+            },
+            onListening(server) {
+                if (runtimeMode === 'fullstack') {
+                    (0, dev_server_listener_1.listenHmrTiming)(server);
+                }
+            },
+            client: {
+                overlay: {
+                    errors: false,
+                    warnings: false,
+                },
+            },
+        },
+    };
+}

package/lib/simple/recommend/eslint/eslint-client.d.ts

@@ -0,0 +1,29 @@
+declare const _default: {
+    name: string;
+    languageOptions: {
+        ecmaVersion: number;
+        parser: any;
+        parserOptions: {
+            ecmaFeatures: {
+                jsx: boolean;
+            };
+        };
+        globals: any;
+    };
+    plugins: {
+        'react-hooks': any;
+        import: any;
+    };
+    settings: {
+        'import/resolver': {
+            node: {
+                extensions: string[];
+            };
+        };
+        'import/parsers': {
+            '@typescript-eslint/parser': string[];
+        };
+    };
+    rules: any;
+};
+export default _default;

package/lib/simple/recommend/eslint/eslint-client.js

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const globals = require('globals');
+const reactHooks = require('eslint-plugin-react-hooks');
+const tseslint = require('typescript-eslint');
+const importPlugin = require('eslint-plugin-import');
+exports.default = {
+    name: 'fullstack-presets/client-recommend',
+    languageOptions: {
+        ecmaVersion: 2020,
+        parser: tseslint.parser,
+        parserOptions: {
+            ecmaFeatures: {
+                jsx: true,
+            },
+        },
+        globals: {
+            ...globals.browser,
+            ...globals.node,
+        },
+    },
+    plugins: {
+        'react-hooks': reactHooks,
+        import: importPlugin,
+    },
+    settings: {
+        'import/resolver': {
+            node: {
+                extensions: ['.js', '.jsx', '.ts', '.tsx'],
+            },
+        },
+        'import/parsers': {
+            '@typescript-eslint/parser': ['.ts', '.tsx'],
+        },
+    },
+    rules: {
+        // React Hooks 推荐规则
+        ...reactHooks.configs.recommended.rules,
+        // TypeScript 规则
+        '@typescript-eslint/no-unused-vars': 'off', // 未使用变量检查关闭
+        '@typescript-eslint/no-explicit-any': 'off', // 允许使用 any 类型
+        '@typescript-eslint/no-empty-interface': 'off', // 允许空接口
+        '@typescript-eslint/no-empty-object-type': 'off', // 允许空对象类型
+        '@typescript-eslint/no-redeclare': 'error', // 禁止重复声明
+        // React 规则
+        'react/jsx-no-undef-props': 'off', // 不检查未定义的 props
+        'react/no-unknown-property': 'off', // 允许未知属性
+        'react-hooks/exhaustive-deps': 'off', // 不强制检查依赖数组
+        // JavaScript 基础规则
+        'no-undef': 'off', // 禁止使用未声明的变量
+        'no-console': 'off', // 允许使用 console
+        'prefer-const': 'off', // 不强制使用 const
+        // Import 规则
+        'import/no-unresolved': 'error', // 检查导入路径是否存在
+        // 其他规则
+        'no-constant-binary-expression': 'off', // 不强制使用常量二进制表达式
+        // React Refresh 相关 - 开发时不影响渲染的检测
+        'react-refresh/only-export-components': 'off',
+        'no-restricted-imports': [
+            'error',
+            {
+                paths: [
+                    {
+                        name: 'next/link',
+                        message: "Importing from 'next/link' is prohibited. Please use the `Link` component from 'react-router-dom' for navigation.",
+                    },
+                ],
+            },
+        ],
+        'no-restricted-syntax': [
+            'error',
+            // 限制使用 fetch（推荐使用生成的 API Client）
+            {
+                message: "Please don't use fetch, use Generated API Client instead",
+                selector: "CallExpression[callee.name='fetch'][arguments.0.type='Literal'][arguments.0.value=/^\\u002F/]",
+            },
+            // 避免使用 console.log，推荐使用 logger 库
+            {
+                selector: "CallExpression[callee.object.name='console'][callee.property.name=/^(log|warn|info|debug|trace)$/]",
+                message: 'Avoid using console.log, console.warn, etc. Use `@lark-apaas/client-toolkit/logger` instead.',
+            },
+            // 禁用BOM方法alert和confirm，及不推荐使用同名方法
+            {
+                message: "Please don't use window.alert, use `Dialog` component instead for better user experience and consistency",
+                selector: "MemberExpression[object.name='window'][property.name='alert']",
+            },
+            {
+                message: "Please don't use window.confirm, use `Dialog` component instead for better user experience and consistency",
+                selector: "MemberExpression[object.name='window'][property.name='confirm']",
+            },
+            {
+                message: "Please don't use alert. It may conflict with window.alert BOM method, use `Dialog` component instead for better user experience and consistency",
+                selector: "CallExpression[callee.name='alert']",
+            },
+            {
+                message: "Please don't use confirm. It may conflict with window.confirm BOM method, use `Dialog` component instead for better user experience and consistency",
+                selector: "CallExpression[callee.name='confirm']",
+            },
+            // 禁用`window.location.href`赋值使用，可以读取
+            {
+                selector: 'AssignmentExpression[left.object.object.name="window"][left.object.property.name="location"][left.property.name="href"]',
+                message: "Please don't use `window.location.href` to navigate. Use `useNavigate` hook from 'react-router-dom' instead.",
+            },
+            // 禁止`location.href`赋值使用，可以读取
+            {
+                selector: 'AssignmentExpression[left.object.name="location"][left.property.name="href"]',
+                message: "Please don't use `location.href` to navigate. Use `useNavigate` hook from 'react-router-dom' instead.",
+            },
+            // SelectItem组件的value属性值不能为空字符串
+            {
+                message: 'The `value` attribute of the `SelectItem` component cannot be an empty string.',
+                selector: 'JSXOpeningElement[name.name="SelectItem"]:has(JSXAttribute[name.name="value"][value.value=""]), JSXOpeningElement[name.name="SelectItem"]:has(JSXAttribute[name.name="value"][value.expression.value=""])',
+            },
+            // 禁止a标签href使用相对路径
+            {
+                selector: "JSXOpeningElement[name.name='a']:has(JSXAttribute[name.name='href'][value.value=/^(?!https?:|\\u002F\\u002F|mailto:|tel:|#).+/])",
+                message: "Please don't use relative paths in <a> tags. Use NavLink from 'react-router-dom' instead.",
+            },
+            // 禁止 variant 为 outline|link|ghost 的 Button 使用 text-white
+            {
+                selector: 'JSXElement[openingElement.name.name="Button"]' +
+                    ':has(JSXAttribute[name.name="variant"][value.value=/^(outline|link|ghost)$/])' +
+                    ':has(JSXAttribute[name.name="className"][value.value=/text-white/])',
+                message: 'Button with variant="outline|link|ghost" should not use "text-white" className. This causes visibility issues. Consider using proper semantic color tokens from `client/src/tailwind-theme.css`',
+            },
+            // 禁止在 Button 上组合 text-primary-foreground 与 bg-background 并用的情况
+            {
+                selector: 'JSXElement[openingElement.name.name="Button"]' +
+                    ':has(JSXAttribute[name.name="className"][value.value=/text-primary-foreground/])' +
+                    ':has(JSXAttribute[name.name="className"][value.value=/bg-background/])',
+                message: 'Button should not use "text-primary-foreground" and "bg-background" className. This causes visibility issues. Consider using proper semantic color tokens from `client/src/tailwind-theme.css`',
+            },
+            // 禁止使用 text-accent
+            {
+                selector: 'JSXAttribute[name.name="className"][value.value=/(^|\\s)text-accent(\\s|$)/]',
+                message: 'Classname "text-accent" would cause visibility issues. Consider using proper semantic color tokens from `client/src/tailwind-theme.css`',
+            },
+        ],
+    },
+};

package/lib/simple/recommend/eslint/eslint-server.d.ts

@@ -0,0 +1,53 @@
+declare const _default: {
+    name: string;
+    languageOptions: {
+        ecmaVersion: number;
+        sourceType: string;
+        parser: any;
+        globals: any;
+    };
+    plugins: {
+        import: any;
+    };
+    settings: {
+        'import/resolver': {
+            node: {
+                extensions: string[];
+            };
+        };
+        'import/parsers': {
+            '@typescript-eslint/parser': string[];
+        };
+    };
+    rules: {
+        '@typescript-eslint/no-unused-vars': string;
+        '@typescript-eslint/no-explicit-any': string;
+        '@typescript-eslint/no-empty-interface': string;
+        '@typescript-eslint/no-empty-object-type': string;
+        '@typescript-eslint/no-redeclare': string;
+        '@typescript-eslint/no-extraneous-class': string;
+        'no-undef': string;
+        'no-console': string;
+        'prefer-const': string;
+        'import/no-unresolved': string;
+        'import/no-extraneous-dependencies': string;
+        'no-restricted-imports': (string | {
+            patterns: {
+                group: string[];
+                message: string;
+            }[];
+        })[];
+        '@darraghor/nestjs-typed/injectable-should-be-provided': (string | {
+            src: string[];
+        })[];
+        '@darraghor/nestjs-typed/api-property-returning-array-should-set-array': string;
+        '@darraghor/nestjs-typed/api-property-matches-property-optionality': string;
+        '@darraghor/nestjs-typed/all-properties-have-explicit-defined': string;
+        '@darraghor/nestjs-typed/controllers-should-supply-api-tags': string;
+        '@darraghor/nestjs-typed/api-method-should-specify-api-response': string;
+        '@darraghor/nestjs-typed/api-method-should-specify-api-operation': string;
+        '@darraghor/nestjs-typed/api-enum-property-best-practices': string;
+        '@darraghor/nestjs-typed/all-properties-are-whitelisted': string;
+    };
+};
+export default _default;

package/lib/simple/recommend/eslint/eslint-server.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const globals = require('globals');
+const tseslint = require('typescript-eslint');
+const importPlugin = require('eslint-plugin-import');
+exports.default = {
+    name: 'fullstack-presets/server-recommend',
+    languageOptions: {
+        ecmaVersion: 2022,
+        sourceType: 'module',
+        parser: tseslint.parser,
+        globals: {
+            ...globals.node,
+            NodeJS: true,
+        },
+    },
+    plugins: {
+        import: importPlugin,
+    },
+    settings: {
+        'import/resolver': {
+            node: {
+                extensions: ['.js', '.jsx', '.ts', '.tsx'],
+            },
+        },
+        'import/parsers': {
+            '@typescript-eslint/parser': ['.ts', '.tsx'],
+        },
+    },
+    rules: {
+        // TypeScript 规则
+        '@typescript-eslint/no-unused-vars': 'off',
+        '@typescript-eslint/no-explicit-any': 'off',
+        '@typescript-eslint/no-empty-interface': 'off',
+        '@typescript-eslint/no-empty-object-type': 'off',
+        '@typescript-eslint/no-redeclare': 'error',
+        '@typescript-eslint/no-extraneous-class': 'off',
+        // JavaScript 基础规则
+        'no-undef': 'off',
+        'no-console': 'error',
+        'prefer-const': 'off',
+        // Import 规则
+        'import/no-unresolved': 'error',
+        'import/no-extraneous-dependencies': 'error',
+        // 禁止服务端导入客户端专用包
+        'no-restricted-imports': [
+            'error',
+            {
+                patterns: [
+                    {
+                        group: ['@lark-apaas/client-toolkit', '@lark-apaas/client-toolkit/*'],
+                        message: 'This toolkit is for client-side use only and must not be imported or used in server-side code.',
+                    },
+                ],
+            },
+        ],
+        '@darraghor/nestjs-typed/injectable-should-be-provided': [
+            'error',
+            {
+                src: ['./server/**/*.ts'],
+            },
+        ],
+        '@darraghor/nestjs-typed/api-property-returning-array-should-set-array': 'off',
+        '@darraghor/nestjs-typed/api-property-matches-property-optionality': 'off',
+        '@darraghor/nestjs-typed/all-properties-have-explicit-defined': 'off',
+        // 关闭 Swagger 相关规则
+        '@darraghor/nestjs-typed/controllers-should-supply-api-tags': 'off',
+        '@darraghor/nestjs-typed/api-method-should-specify-api-response': 'off',
+        '@darraghor/nestjs-typed/api-method-should-specify-api-operation': 'off',
+        '@darraghor/nestjs-typed/api-enum-property-best-practices': 'off',
+        '@darraghor/nestjs-typed/all-properties-are-whitelisted': 'off',
+    },
+};

package/lib/simple/recommend/eslint/index.d.ts

@@ -0,0 +1,37 @@
+export declare const eslintPresets: {
+    client: ({
+        readonly rules: Readonly<import("eslint").Linter.RulesRecord>;
+    } | import("typescript-eslint/dist/compatibility-types").CompatibleConfig | {
+        name: string;
+        languageOptions: {
+            ecmaVersion: number;
+            parser: any;
+            parserOptions: {
+                ecmaFeatures: {
+                    jsx: boolean;
+                };
+            };
+            globals: any;
+        };
+        plugins: {
+            'react-hooks': any;
+            import: any;
+        };
+        settings: {
+            'import/resolver': {
+                node: {
+                    extensions: string[];
+                };
+            };
+            'import/parsers': {
+                '@typescript-eslint/parser': string[];
+            };
+        };
+        rules: any;
+    } | {
+        ignores: string[];
+    })[];
+    server: ({
+        readonly rules: Readonly<import("eslint").Linter.RulesRecord>;
+    } | import("typescript-eslint/dist/compatibility-types").CompatibleConfig)[];
+};

package/lib/simple/recommend/eslint/index.js

@@ -0,0 +1,30 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.eslintPresets = void 0;
+const eslint_client_1 = __importDefault(require("./eslint-client"));
+const eslint_server_1 = __importDefault(require("./eslint-server"));
+const js_1 = __importDefault(require("@eslint/js"));
+const typescript_eslint_1 = __importDefault(require("typescript-eslint"));
+const eslint_plugin_nestjs_typed_1 = __importDefault(require("@darraghor/eslint-plugin-nestjs-typed"));
+const globalIgnoreServerPatterns = ['server/database/.introspect/**']; // 全局 eslint server ignore
+const globalIgnoreClientPatterns = ['dist', 'node_modules', 'client/src/api/gen']; // 全局 eslint client Ignore
+// 只导出纯净的规则配置，不包含基础配置
+// 用户需要在项目配置中自己添加基础配置（eslintJs, tseslint, nestjs 等）
+exports.eslintPresets = {
+    client: [
+        { ignores: globalIgnoreClientPatterns },
+        js_1.default.configs.recommended,
+        ...typescript_eslint_1.default.configs.recommended,
+        eslint_client_1.default
+    ],
+    server: [
+        { ignores: globalIgnoreServerPatterns },
+        js_1.default.configs.recommended,
+        ...typescript_eslint_1.default.configs.recommended,
+        ...eslint_plugin_nestjs_typed_1.default.configs.flatRecommended,
+        eslint_server_1.default
+    ],
+};

package/lib/simple/recommend/stylelint/index.d.ts

@@ -0,0 +1,5 @@
+export declare const stylelintPresets: {
+    rules: {
+        'declaration-block-no-duplicate-custom-properties': boolean;
+    };
+};

package/lib/simple/recommend/stylelint/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stylelintPresets = void 0;
+exports.stylelintPresets = {
+    rules: {
+        'declaration-block-no-duplicate-custom-properties': true,
+    },
+};

package/lib/simple/recommend/tailwind/createTailwindPreset.d.ts

@@ -0,0 +1,8 @@
+export declare function createTailwindPreset(options?: {
+    packageName?: string;
+}): {
+    darkMode: string;
+    content: string[];
+    prefix: string;
+    plugins: any[];
+};

package/lib/simple/recommend/tailwind/createTailwindPreset.js

@@ -0,0 +1,63 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTailwindPreset = createTailwindPreset;
+const path = __importStar(require("path"));
+const defaultPackageName = '@lark-apaas/client-toolkit';
+function createTailwindPreset(options = {}) {
+    // 默认补充扫描外网包依赖
+    const { packageName = defaultPackageName } = options;
+    const pkgPath = getToolKitPath(packageName);
+    return {
+        darkMode: 'class',
+        content: [pkgPath].filter(Boolean),
+        prefix: '',
+        plugins: [
+            require('tailwindcss-animate'),
+        ],
+    };
+}
+function getToolKitPath(packageName) {
+    let pkgPath = '';
+    if (packageName) {
+        try {
+            pkgPath = path.join(path.dirname(require.resolve(packageName)), '/**/*.js');
+        }
+        catch (e) {
+            console.warn(`Failed to resolve package ${packageName}, use default path`);
+        }
+    }
+    return pkgPath;
+}

package/lib/simple/tsconfig/tsconfig.app.json

@@ -0,0 +1,30 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "useDefineForClassFields": true,
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "skipLibCheck": true,
+
+    /* Bundler mode */
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "isolatedModules": true,
+    "moduleDetection": "force",
+    "noEmit": true,
+    "jsx": "react-jsx",
+
+    /* Linting */
+    "strict": false,
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noImplicitAny": false,
+    "noFallthroughCasesInSwitch": false,
+
+    "sourceMap": true,
+    "allowJs": true,
+    "strictNullChecks": false,
+
+    "incremental": false,
+  },
+}

package/lib/simple/tsconfig/tsconfig.node.json

@@ -0,0 +1,25 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "commonjs",
+    "moduleResolution": "node",
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+
+    /* Bundler mode */
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
+    "importHelpers": true,
+    "incremental": true,
+    "noEmit": false,
+
+    /* Linting */
+    "strict": false,
+    "composite": true,
+    "declaration": true,
+    "removeComments": false,
+
+    "types": ["node"]
+  },
+  "ts-node": { "require": ["tsconfig-paths/register"] }
+}

package/lib/utils/dev-server-listener.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 监听 HMR 编译时间
+ * @param server
+ */
+export declare function listenHmrTiming(server: any): void;

package/lib/utils/dev-server-listener.js

@@ -0,0 +1,113 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listenHmrTiming = listenHmrTiming;
+/* eslint-disable @typescript-eslint/no-explicit-any */
+const fs = __importStar(require("fs"));
+/**
+ * 监听 HMR 编译时间
+ * @param server
+ */
+function listenHmrTiming(server) {
+    const compiler = server.compiler;
+    const ws = server.webSocketServer;
+    let start = 0;
+    let changedFiles = new Set();
+    // 监听文件变更
+    compiler.hooks.watchRun.tap('HmrTiming', (comp) => {
+        const modifiedFiles = comp.modifiedFiles;
+        if (modifiedFiles && modifiedFiles.size > 0) {
+            changedFiles = new Set(modifiedFiles);
+        }
+        else {
+            changedFiles.clear();
+        }
+        start = Date.now();
+    });
+    // 编译完成
+    compiler.hooks.done.tap('HmrTiming', () => {
+        const duration = Date.now() - start;
+        // 过滤有效文件 - 只保留实际的项目文件
+        const validFiles = [...changedFiles]
+            .map(f => f.replace(process.cwd(), '').replace(/\\/g, '/'))
+            .filter(filePath => {
+            // 过滤无效文件
+            if (!filePath || filePath.length === 0)
+                return false;
+            // 过滤 node_modules 中的文件
+            if (filePath.includes('/node_modules/'))
+                return false;
+            // 只保留支持的文件类型
+            const validExtensions = ['.js', '.jsx', '.ts', '.tsx', '.svelte', '.css', '.json', '.html'];
+            const hasValidExtension = validExtensions.some(ext => filePath.toLowerCase().endsWith(ext));
+            if (!hasValidExtension)
+                return false;
+            return true;
+        });
+        // 获取文件统计信息
+        const fileStats = validFiles.map(filePath => {
+            const fullPath = process.cwd() + filePath;
+            try {
+                const stats = fs.statSync(fullPath);
+                return {
+                    path: filePath,
+                    size: stats.size,
+                };
+            }
+            catch (error) {
+                return {
+                    path: filePath,
+                    size: 0,
+                };
+            }
+        });
+        // 计算总文件大小(B)
+        const totalSize = fileStats.reduce((sum, file) => sum + file.size, 0);
+        const payload = {
+            duration,
+            fileCount: validFiles.length,
+            fileTotalSize: totalSize,
+        };
+        // 推送到浏览器端
+        for (const client of ws.clients) {
+            if (client.readyState === 1) {
+                client.send(JSON.stringify({
+                    type: 'hmr-timing',
+                    data: payload,
+                }));
+            }
+        }
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/fullstack-presets",
-  "version": "1.0.13",
+  "version": "1.1.0",
   "files": [
     "lib"
   ],