@lark-apaas/fullstack-presets 1.1.3 → 1.1.5-alpha.0

package/lib/custom-eslint-rules/index.d.ts

@@ -1,3 +1,4 @@
 export declare const customRules: {
     'no-nested-styled-jsx': import("eslint").Rule.RuleModule;
+    'require-app-container': import("eslint").Rule.RuleModule;
 };

package/lib/custom-eslint-rules/index.js

@@ -5,6 +5,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.customRules = void 0;
 const no_nested_styled_jsx_1 = __importDefault(require("./no-nested-styled-jsx"));
+const require_app_container_1 = __importDefault(require("./require-app-container"));
 exports.customRules = {
     'no-nested-styled-jsx': no_nested_styled_jsx_1.default,
+    'require-app-container': require_app_container_1.default,
 };

package/lib/custom-eslint-rules/require-app-container.d.ts

@@ -0,0 +1,9 @@
+/**
+ * ESLint rule to require AppContainer component in entry files.
+ *
+ * This rule ensures that client/src/index.tsx and client/src/app.tsx
+ * files contain the AppContainer component to ensure platform features work correctly.
+ */
+import type { Rule } from 'eslint';
+declare const rule: Rule.RuleModule;
+export default rule;

package/lib/custom-eslint-rules/require-app-container.js

@@ -0,0 +1,123 @@
+"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 });
+const path = __importStar(require("path"));
+const DEFAULT_MESSAGE = '缺少平台组件AppContainer，请确认App外层包裹了AppContainer组件以确保平台功能正常运行';
+// Files that must contain AppContainer
+const REQUIRED_FILES = ['index.tsx', 'app.tsx'];
+// Directory pattern to match
+const CLIENT_SRC_PATTERN = /[/\\]client[/\\]src[/\\]$/;
+const rule = {
+    meta: {
+        type: 'problem',
+        docs: {
+            description: 'Require AppContainer component in entry files',
+            category: 'Possible Errors',
+            recommended: true,
+        },
+        schema: [
+            {
+                type: 'object',
+                properties: {
+                    message: {
+                        type: 'string',
+                        description: 'Custom error message',
+                    },
+                },
+                additionalProperties: false,
+            },
+        ],
+        messages: {
+            missingAppContainer: DEFAULT_MESSAGE,
+        },
+    },
+    create(context) {
+        const options = context.options[0];
+        const customMessage = options?.message;
+        const filename = context.filename || context.getFilename();
+        // Check if this file should be validated
+        const basename = path.basename(filename);
+        const dirname = path.dirname(filename);
+        // Only check files in client/src/ directory that match our required files
+        const isRequiredFile = REQUIRED_FILES.includes(basename.toLowerCase()) &&
+            CLIENT_SRC_PATTERN.test(dirname + path.sep);
+        if (!isRequiredFile) {
+            return {};
+        }
+        let hasAppContainer = false;
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        let programNode = null;
+        return {
+            // Track if AppContainer is imported
+            ImportDeclaration(node) {
+                // Check for default or named import of AppContainer
+                for (const specifier of node.specifiers) {
+                    if (specifier.type === 'ImportSpecifier' ||
+                        specifier.type === 'ImportDefaultSpecifier') {
+                        if (specifier.local.name === 'AppContainer') {
+                            hasAppContainer = true;
+                            break;
+                        }
+                    }
+                }
+            },
+            // Check for JSX usage of <AppContainer>
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            JSXOpeningElement(node) {
+                const elementName = node.name;
+                if (elementName?.type === 'JSXIdentifier' &&
+                    elementName?.name === 'AppContainer') {
+                    hasAppContainer = true;
+                }
+            },
+            // Store the program node for reporting at the end
+            Program(node) {
+                programNode = node;
+            },
+            // Check at the end of file if AppContainer was found
+            'Program:exit'() {
+                if (!hasAppContainer && programNode) {
+                    context.report({
+                        node: programNode,
+                        ...(customMessage
+                            ? { message: customMessage }
+                            : { messageId: 'missingAppContainer' }),
+                    });
+                }
+            },
+        };
+    },
+};
+exports.default = rule;

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

@@ -13,6 +13,12 @@ declare const _default: {
     plugins: {
         'react-hooks': any;
         import: any;
+        'fullstack-presets': {
+            rules: {
+                'no-nested-styled-jsx': import("eslint").Rule.RuleModule;
+                'require-app-container': import("eslint").Rule.RuleModule;
+            };
+        };
     };
     settings: {
         'import/resolver': {

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

@@ -4,6 +4,7 @@ const globals = require('globals');
 const reactHooks = require('eslint-plugin-react-hooks');
 const tseslint = require('typescript-eslint');
 const importPlugin = require('eslint-plugin-import');
+const custom_eslint_rules_1 = require("../../custom-eslint-rules");
 exports.default = {
     name: 'fullstack-presets/client-recommend',
     languageOptions: {
@@ -22,6 +23,9 @@ exports.default = {
     plugins: {
         'react-hooks': reactHooks,
         import: importPlugin,
+        'fullstack-presets': {
+            rules: custom_eslint_rules_1.customRules,
+        },
     },
     settings: {
         'import/resolver': {
@@ -36,6 +40,8 @@ exports.default = {
     rules: {
         // React Hooks 推荐规则
         ...reactHooks.configs.recommended.rules,
+        // 平台规则：确保入口文件包含 AppContainer 组件
+        'fullstack-presets/require-app-container': 'error',
         // TypeScript 规则
         '@typescript-eslint/no-unused-vars': 'off', // 未使用变量检查关闭
         '@typescript-eslint/no-explicit-any': 'off', // 允许使用 any 类型

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

@@ -16,6 +16,12 @@ export declare const eslintPresets: {
         plugins: {
             'react-hooks': any;
             import: any;
+            'fullstack-presets': {
+                rules: {
+                    'no-nested-styled-jsx': import("eslint").Rule.RuleModule;
+                    'require-app-container': import("eslint").Rule.RuleModule;
+                };
+            };
         };
         settings: {
             'import/resolver': {

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

@@ -18,6 +18,7 @@ declare const _default: ({
         '@lark-apaas'?: {
             rules: {
                 'no-nested-styled-jsx': import("eslint").Rule.RuleModule;
+                'require-app-container': import("eslint").Rule.RuleModule;
             };
         } | undefined;
         'react-hooks': any;

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

@@ -17,6 +17,7 @@ export declare const eslintPresets: {
             '@lark-apaas'?: {
                 rules: {
                     'no-nested-styled-jsx': import("eslint").Rule.RuleModule;
+                    'require-app-container': import("eslint").Rule.RuleModule;
                 };
             } | undefined;
             'react-hooks': any;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/fullstack-presets",
-  "version": "1.1.3",
+  "version": "1.1.5-alpha.0",
   "files": [
     "lib"
   ],
@@ -45,6 +45,5 @@
   "peerDependencies": {
     "eslint": "^9.0.0",
     "typescript-eslint": "^8.44.0"
-  },
-  "gitHead": "bc9469110ed352267d992d7406578d00bc3ffe03"
+  }
 }