@lark-apaas/miaoda-presets 1.0.0 → 1.0.2

package/lib/overlay/components.js

@@ -0,0 +1,169 @@
+"use strict";
+/**
+ * 错误容器组件
+ * @param {*} document
+ * @param {*} root
+ * @param {object} props
+ * @param {string} props.errorMessage - 错误信息
+ * @param {function} props.onRepairClick - 修复按钮点击事件
+ * @param {function} props.onCopyClick - 复制按钮点击事件
+ */
+function ErrorContainer(document, root, props) {
+    // 创建容器元素
+    const container = document.createElement('div');
+    container.className = 'container';
+    // 创建内容元素
+    const content = document.createElement('div');
+    content.className = 'content';
+    container.appendChild(content);
+    // 创建图片元素
+    const img = document.createElement('img');
+    img.src =
+        'https://lf3-static.bytednsdoc.com/obj/eden-cn/ylcylz_fsph_ryhs/ljhwZthlaukjlkulzlp/feisuda/template/render_error.svg';
+    img.alt = 'render error';
+    // 图片占位
+    img.width = 120;
+    img.height = 120;
+    img.className = 'error-image';
+    content.appendChild(img);
+    // 创建标题元素
+    const title = document.createElement('p');
+    title.className = 'title';
+    title.textContent = '哎呀，写错代码了';
+    content.appendChild(title);
+    // 创建描述元素
+    const description = document.createElement('p');
+    description.className = 'description';
+    description.textContent = '可复制错误信息，或告诉妙搭进行修复。';
+    content.appendChild(description);
+    // 创建按钮组元素
+    const buttonGroup = document.createElement('div');
+    buttonGroup.className = 'button-group';
+    content.appendChild(buttonGroup);
+    // 创建复制按钮
+    const copyBtn = document.createElement('button');
+    copyBtn.className = 'button button-copy';
+    copyBtn.id = 'copyBtn';
+    copyBtn.textContent = '复制错误信息';
+    copyBtn.addEventListener('click', props.onCopyClick);
+    buttonGroup.appendChild(copyBtn);
+    // 创建修复按钮
+    const repairBtn = document.createElement('button');
+    repairBtn.className = 'button button-repair';
+    repairBtn.id = 'repairBtn';
+    repairBtn.textContent = '告诉妙搭修复';
+    repairBtn.addEventListener('click', props.onRepairClick);
+    buttonGroup.appendChild(repairBtn);
+    // 添加到根元素
+    root.appendChild(container);
+}
+function RootStyle(document, root) {
+    const style = document.createElement('style');
+    style.id = 'react-refresh-overlay-style';
+    style.textContent = `
+    * {
+      margin: 0;
+      padding: 0;
+      box-sizing: border-box;
+    }
+
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', 'Oxygen',
+        'Ubuntu', 'Cantarell', 'Fira Sans', 'Droid Sans', 'Helvetica Neue',
+        sans-serif;
+      -webkit-font-smoothing: antialiased;
+      -moz-osx-font-smoothing: grayscale;
+    }
+
+    .container {
+      min-height: 100vh;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      background-color: #F3F4F6; /* bg-gray-100 */
+    }
+
+    .content {
+      display: flex;
+      flex-direction: column;
+      justify-content: center;
+      align-items: center;
+      text-align: center;
+    }
+
+    .error-image {
+      margin-bottom: 16px; /* mb-4 */
+      width: 120px; /* w-[120px] */
+      height: auto;
+    }
+
+    .title {
+      font-size: 18px; /* text-l (推测为 text-lg) */
+      line-height: 22px;
+      color: #1F2329;
+      font-weight: 500; /* font-medium */
+      margin-bottom: 8px; /* mb-2 */
+    }
+
+    .description {
+      font-size: 14px; /* text-sm */
+      line-height: 22px;
+      color: #646A73;
+      font-weight: 400; /* font-normal */
+      margin-bottom: 8px; /* mb-2 */
+    }
+
+    .button-group {
+      display: flex;
+      gap: 16px; /* space-x-4 */
+    }
+
+    .button {
+      height: 32px; /* h-[32px] */
+      padding: 0 16px;
+      border-radius: 6px; /* rounded-[6px] */
+      font-size: 14px; /* text-sm */
+      font-weight: 400; /* font-[400] */
+      cursor: pointer;
+      transition: all 0.2s;
+      outline: none; /* focus:outline-hidden */
+      border: 1px solid;
+    }
+
+    .button-copy {
+      background-color: white; /* bg-white */
+      color: #4B5563; /* text-gray-600 */
+      border-color: #D0D3D6; /* border-[#D0D3D6] */
+      box-shadow: 0 1px 3px 0 rgba(0, 0, 0, 0.1), 0 1px 2px 0 rgba(0, 0, 0, 0.06); /* shadow-xs */
+    }
+
+    .button-copy:hover {
+      background-color: #F3F4F6; /* hover:bg-gray-100 */
+    }
+
+    .button-copy:active {
+      background-color: #E5E7EB; /* active:bg-gray-200 */
+    }
+
+    .button-repair {
+      background-color: #2563EB; /* bg-blue-600 */
+      color: white; /* text-white */
+      border-color: transparent; /* border-transparent */
+      font-weight: 500; /* font-medium */
+      box-shadow: 0 1px 3px 0 rgba(0, 0, 0, 0.1), 0 1px 2px 0 rgba(0, 0, 0, 0.06); /* shadow-xs */
+    }
+
+    .button-repair:hover {
+      background-color: #2563EB; /* hover:bg-blue-600 (保持不变) */
+    }
+
+    .button-repair:active {
+      background-color: #1E40AF; /* active:bg-blue-700 */
+    }
+  `;
+    root.appendChild(style);
+}
+module.exports = {
+    ErrorContainer,
+    RootStyle,
+};

package/lib/overlay/index.js

@@ -0,0 +1,330 @@
+"use strict";
+/* eslint-disable no-undef */
+const { ErrorContainer, RootStyle } = require('./components');
+/* ===== Cached elements for DOM manipulations ===== */
+/**
+ * The iframe that contains the overlay.
+ * @type {HTMLIFrameElement}
+ */
+let iframeRoot = null;
+/**
+ * The document object from the iframe root, used to create and render elements.
+ * @type {Document}
+ */
+let rootDocument = null;
+/**
+ * The root div elements will attach to.
+ * @type {HTMLDivElement}
+ */
+let root = null;
+/**
+ * A Cached function to allow deferred render.
+ * @type {RenderFn | null}
+ */
+let scheduledRenderFn = null;
+/* ===== Overlay State ===== */
+/**
+ * The latest error message from Webpack compilation.
+ * @type {string}
+ */
+let currentCompileErrorMessage = '';
+/**
+ * The latest runtime error objects.
+ * @type {Error[]}
+ */
+let currentRuntimeErrors = [];
+/**
+ * The render mode the overlay is currently in.
+ * @type {'compileError' | 'runtimeError' | null}
+ */
+let currentMode = null;
+/**
+ * @typedef {Object} IframeProps
+ * @property {function(): void} onIframeLoad
+ */
+/**
+ * Creates the main `iframe` the overlay will attach to.
+ * Accepts a callback to be ran after iframe is initialized.
+ * @param {Document} document
+ * @param {HTMLElement} root
+ * @param {IframeProps} props
+ * @returns {HTMLIFrameElement}
+ */
+function IframeRoot(document, root, props) {
+    const iframe = document.createElement('iframe');
+    iframe.id = 'react-refresh-overlay';
+    iframe.src = 'about:blank';
+    iframe.style.border = 'none';
+    iframe.style.height = '100%';
+    iframe.style.left = '0';
+    iframe.style.minHeight = '100vh';
+    iframe.style.minHeight = '-webkit-fill-available';
+    iframe.style.position = 'fixed';
+    iframe.style.top = '0';
+    iframe.style.width = '100vw';
+    iframe.style.zIndex = '2147483647';
+    iframe.addEventListener('load', function onLoad() {
+        // Reset margin of iframe body
+        iframe.contentDocument.body.style.margin = '0';
+        props.onIframeLoad();
+    });
+    // We skip mounting and returns as we need to ensure
+    // the load event is fired after we setup the global variable
+    return iframe;
+}
+/**
+ * Creates the main `div` element for the overlay to render.
+ * @param {Document} document
+ * @param {HTMLElement} root
+ * @returns {HTMLDivElement}
+ */
+function OverlayRoot(document, root) {
+    const div = document.createElement('div');
+    div.id = 'container';
+    root.appendChild(div);
+    return div;
+}
+/**
+ * Ensures the iframe root and the overlay root are both initialized before render.
+ * If check fails, render will be deferred until both roots are initialized.
+ * @param {RenderFn} renderFn A function that triggers a DOM render.
+ * @returns {void}
+ */
+function ensureRootExists(renderFn) {
+    if (root) {
+        // Overlay root is ready, we can render right away.
+        renderFn();
+        return;
+    }
+    // Creating an iframe may be asynchronous so we'll defer render.
+    // In case of multiple calls, function from the last call will be used.
+    scheduledRenderFn = renderFn;
+    if (iframeRoot) {
+        // Iframe is already ready, it will fire the load event.
+        return;
+    }
+    // Create the iframe root, and, the overlay root inside it when it is ready.
+    iframeRoot = IframeRoot(document, document.body, {
+        onIframeLoad: function onIframeLoad() {
+            rootDocument = iframeRoot.contentDocument;
+            RootStyle(rootDocument, rootDocument.head);
+            root = OverlayRoot(rootDocument, rootDocument.body);
+            scheduledRenderFn();
+        },
+    });
+    // We have to mount here to ensure `iframeRoot` is set when `onIframeLoad` fires.
+    // This is because onIframeLoad() will be called synchronously
+    // or asynchronously depending on the browser.
+    document.body.appendChild(iframeRoot);
+}
+function removeAllChildren(element, skip) {
+    /** @type {Node[]} */
+    const childList = Array.prototype.slice.call(element.childNodes, typeof skip !== 'undefined' ? skip : 0);
+    for (let i = 0; i < childList.length; i += 1) {
+        element.removeChild(childList[i]);
+    }
+}
+async function copyToClipboard(text) {
+    try {
+        // 优先使用现代的 Clipboard API
+        if (navigator.clipboard && window.isSecureContext) {
+            await navigator.clipboard.writeText(text);
+            return true;
+        }
+        // 降级方案：使用传统的 execCommand 方法
+        return fallbackCopyToClipboard(text);
+    }
+    catch (error) {
+        console.error('复制到剪切板失败:', error);
+        return false;
+    }
+}
+// 获取父窗口 origin
+function getPreviewParentOrigin() {
+    const { origin } = window.location;
+    // 线上环境
+    if (origin.includes('feishuapp.cn') ||
+        origin.includes('miaoda.feishuapp.net')) {
+        return 'https://miaoda.feishu.cn';
+    }
+    // PRE 环境
+    if (origin.includes('fsapp.kundou.cn') ||
+        origin.includes('miaoda-pre.feishuapp.net')) {
+        return 'https://miaoda.feishu-pre.cn';
+    }
+    // BOE 环境
+    return 'https://miaoda.feishu-boe.cn';
+}
+/**
+ * Creates the main `div` element for the overlay to render.
+ * @returns {void}
+ */
+function render() {
+    ensureRootExists(function () {
+        removeAllChildren(root);
+        // 发送 postMessage
+        const sendPostMessage = (message, targetOrigin) => {
+            const origin = targetOrigin || getPreviewParentOrigin();
+            window.parent.postMessage(message, origin);
+        };
+        if (currentCompileErrorMessage) {
+            currentMode = 'compileError';
+            ErrorContainer(rootDocument, root, {
+                errorMessage: currentCompileErrorMessage,
+                onRepairClick: function onRepairClick() {
+                    sendPostMessage({
+                        type: 'RenderErrorRepair',
+                        data: currentCompileErrorMessage,
+                    });
+                },
+                onCopyClick: function onCopyClick() {
+                    copyToClipboard(currentCompileErrorMessage);
+                },
+            });
+        }
+        else if (currentRuntimeErrors.length) {
+            currentMode = 'runtimeError';
+            let errors = '';
+            currentRuntimeErrors.forEach(error => {
+                errors += `${error.message}\n${error.stack}\n`;
+            });
+            // 叠加全部报错，将报错信息发送到妙搭
+            ErrorContainer(rootDocument, root, {
+                errorMessage: errors,
+                onRepairClick: function onRepairClick() {
+                    sendPostMessage({
+                        type: 'RenderErrorRepair',
+                        data: errors,
+                    });
+                },
+                onCopyClick: function onCopyClick() {
+                    copyToClipboard(errors);
+                },
+            });
+        }
+    });
+}
+/**
+ * Destroys the state of the overlay.
+ * @returns {void}
+ */
+function cleanup() {
+    // Clean up and reset all internal state.
+    try {
+        document.body.removeChild(iframeRoot);
+    }
+    catch (e) {
+        // In case user render react app directly to body， will trigger `NotFoundError` when recovery from an Error
+        // https://developer.mozilla.org/en-US/docs/Web/API/Node/removeChild#exceptions
+    }
+    scheduledRenderFn = null;
+    root = null;
+    iframeRoot = null;
+}
+/**
+ * Clears Webpack compilation errors and dismisses the compile error overlay.
+ * @returns {void}
+ */
+function clearCompileError() {
+    if (!root || currentMode !== 'compileError') {
+        return;
+    }
+    currentCompileErrorMessage = '';
+    currentMode = null;
+    cleanup();
+}
+/**
+ * Clears runtime error records and dismisses the runtime error overlay.
+ * @param {boolean} [dismissOverlay] Whether to dismiss the overlay or not.
+ * @returns {void}
+ */
+function clearRuntimeErrors(dismissOverlay) {
+    if (!root || currentMode !== 'runtimeError') {
+        return;
+    }
+    currentRuntimeErrors = [];
+    if (typeof dismissOverlay === 'undefined' || dismissOverlay) {
+        currentMode = null;
+        cleanup();
+    }
+}
+/**
+ * Shows the compile error overlay with the specific Webpack error message.
+ * @param {string} message
+ * @returns {void}
+ */
+function showCompileError(message) {
+    if (!message) {
+        return;
+    }
+    currentCompileErrorMessage = message;
+    render();
+}
+/**
+ * Shows the runtime error overlay with the specific error records.
+ * @param {Error[]} errors
+ * @returns {void}
+ */
+function showRuntimeErrors(errors) {
+    if (!errors || !errors.length) {
+        return;
+    }
+    currentRuntimeErrors = errors;
+    render();
+}
+function debounce(fn, wait) {
+    /**
+     * A cached setTimeout handler.
+     * @type {number | undefined}
+     */
+    let timer;
+    /**
+     * @returns {void}
+     */
+    function debounced() {
+        const context = this;
+        const args = arguments;
+        clearTimeout(timer);
+        timer = setTimeout(function () {
+            return fn.apply(context, args);
+        }, wait);
+    }
+    return debounced;
+}
+/**
+ * The debounced version of `showRuntimeErrors` to prevent frequent renders
+ * due to rapid firing listeners.
+ * @param {Error[]} errors
+ * @returns {void}
+ */
+const debouncedShowRuntimeErrors = debounce(showRuntimeErrors, 30);
+/**
+ * Detects if an error is a Webpack compilation error.
+ * @param {Error} error The error of interest.
+ * @returns {boolean} If the error is a Webpack compilation error.
+ */
+function isWebpackCompileError(error) {
+    return (/Module [A-z ]+\(from/.test(error.message) ||
+        /Cannot find module/.test(error.message));
+}
+/**
+ * Handles runtime error contexts captured with EventListeners.
+ * Integrates with a runtime error overlay.
+ * @param {Error} error A valid error object.
+ * @returns {void}
+ */
+function handleRuntimeError(error) {
+    if (error &&
+        !isWebpackCompileError(error) &&
+        currentRuntimeErrors.indexOf(error) === -1) {
+        currentRuntimeErrors = currentRuntimeErrors.concat(error);
+    }
+    debouncedShowRuntimeErrors(currentRuntimeErrors);
+}
+module.exports = Object.freeze({
+    clearCompileError: clearCompileError,
+    clearRuntimeErrors: clearRuntimeErrors,
+    handleRuntimeError: handleRuntimeError,
+    showCompileError: showCompileError,
+    showRuntimeErrors: showRuntimeErrors,
+});

package/lib/react-refresh-plugin.js

@@ -0,0 +1,11 @@
+"use strict";
+const ReactRefreshPlugin = require('@rspack/plugin-react-refresh');
+const path = require('path');
+function createReactRefreshPlugin() {
+    return new ReactRefreshPlugin({
+        overlay: {
+            module: path.resolve(__dirname, 'overlay/index.js'),
+        },
+    });
+}
+module.exports = createReactRefreshPlugin;

package/lib/recommend/eslint.js

@@ -27,17 +27,30 @@ exports.default = {
         'import/named': 'error', // 检查命名导入是否存在
         // 效果相关：模型不会
         'no-constant-binary-expression': 'off', // 不强制使用常量二进制表达式
-        // 效果相关：希望模型使用内置 logger
         'no-restricted-syntax': [
             'error',
+            // 效果相关：希望模型使用内置 logger 而不是 console
             {
                 selector: "CallExpression[callee.object.name='console'][callee.property.name=/^(log|warn|info|debug|trace)$/]",
                 message: 'Avoid using console.log, console.warn, etc. Use `@byted/spark-framework/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']",
+            },
         ],
     },
 };

package/lib/recommend/rspack.js

@@ -8,6 +8,8 @@ const path_1 = __importDefault(require("path"));
 const core_1 = __importDefault(require("@rspack/core"));
 // eslint-disable-next-line @typescript-eslint/no-var-requires
 const RouteParserPlugin = require('../rspack-plugins/route-parser-plugin');
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const SlardarPerformanceMonitorPlugin = require('../rspack-plugins/slardar-performance-monitor-plugin');
 // eslint-disable-next-line max-lines-per-function
 function createRecommendRspackConfig(options) {
     const { enableReactRefresh = false, isDev = true, needRoutes = true, runtimeMode = 'fullstack', } = options;
@@ -120,6 +122,8 @@ function createRecommendRspackConfig(options) {
             new core_1.default.optimize.LimitChunkCountPlugin({
                 maxChunks: 1,
             }),
+            // 全栈模式下，增加性能监控上报脚本注入
+            runtimeMode === 'fullstack' ? new SlardarPerformanceMonitorPlugin() : undefined,
             // 开发环境下，解析路由
             isDev &&
                 needRoutes &&

package/lib/rspack-plugins/slardar-performance-monitor-plugin.js

@@ -0,0 +1,96 @@
+"use strict";
+/**
+ * 加载性能监控脚本
+ * @param {object} option
+ * @param {string} [option.bid='apaas_ai']
+ * @param {string} [option.globalName='KSlardarWeb']
+ * @returns
+ */
+function getSlardarScript(option = {}) {
+    const bid = option.bid || 'apaas_ai';
+    const globalName = option.globalName || 'KSlardarWeb';
+    return `
+  <script>
+  // 创建 Slardar 脚本元素
+    const slardarScript = document.createElement('script');
+    slardarScript.src = 'https://lf3-short.ibytedapm.com/slardar/fe/sdk-web/browser.cn.js?bid=${bid}&globalName=${globalName}';
+    slardarScript.crossOrigin = 'anonymous';
+
+    // 添加 onload 事件处理
+    slardarScript.onload = function() {
+      // 脚本加载完成后执行初始化
+      if (window.KSlardarWeb) {
+        window.KSlardarWeb('init', {
+          bid: 'apaas_ai',
+          // 四种类型：dev/boe/pre/online
+          env: 'online',
+        });
+        window.KSlardarWeb('start');
+      }
+    };
+
+    // 添加错误处理
+    slardarScript.onerror = function() {
+      console.warn('Failed to load Slardar script');
+    };
+
+    // 将脚本添加到页面
+    document.head.appendChild(slardarScript);
+
+    // 添加 TTI 监控脚本
+    const performanceScript = document.createElement('script');
+    performanceScript.src = 'https://sf3-scmcdn-cn.feishucdn.com/obj/unpkg/byted/performance/0.1.0/dist/performance.iife.js';
+    document.head.appendChild(performanceScript);
+</script>
+
+  `;
+}
+class SlardarPerformanceMonitorPlugin {
+    constructor(options) {
+        this.options = options || {};
+    }
+    apply(compiler) {
+        compiler.hooks.compilation.tap('SlardarPerformanceMonitorPlugin', compilation => {
+            try {
+                // 尝试获取HtmlRspackPlugin的hooks
+                let HtmlPlugin;
+                try {
+                    HtmlPlugin = require('@rspack/core').rspack.HtmlRspackPlugin;
+                }
+                catch (e) {
+                    // 如果html-rspack-plugin不可用，尝试使用html-webpack-plugin
+                    try {
+                        HtmlPlugin = require('html-webpack-plugin');
+                    }
+                    catch (e2) {
+                        console.warn('SlardarPerformanceMonitorPlugin: html-rspack-plugin or html-webpack-plugin not found');
+                        return;
+                    }
+                }
+                const hooks = HtmlPlugin.getHooks(compilation);
+                // 在生成 HTML 前修改内容
+                hooks.beforeEmit.tapAsync('SlardarPerformanceMonitorPlugin', (data, cb) => {
+                    const position = this.options.position ?? 'head-end';
+                    const snippet = this.options.snippet ?? getSlardarScript();
+                    if (!snippet)
+                        return;
+                    if (position === 'body-end') {
+                        data.html = data.html.replace('</body>', `${snippet}\n</body>`);
+                    }
+                    else if (position === 'body-start') {
+                        data.html = data.html.replace('<body>', `<body>\n${snippet}`);
+                    }
+                    else if (position === 'head-end') {
+                        data.html = data.html.replace('</head>', `${snippet}\n</head>`);
+                    }
+                    cb(null, data);
+                });
+            }
+            catch (error) {
+                console.error('Error in SlardarPerformanceMonitorPlugin:', error);
+            }
+        });
+    }
+}
+// 导出插件
+module.exports = SlardarPerformanceMonitorPlugin;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/miaoda-presets",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "files": [
     "lib"
   ],