@lark-apaas/coding-template-nestjs-react-fullstack 0.1.63 → 0.1.65-alpha.20261110070953

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/coding-template-nestjs-react-fullstack",
-  "version": "0.1.63",
+  "version": "0.1.65-alpha.20261110070953",
   "description": "NestJS + React fullstack template for miaoda coding",
   "type": "module",
   "files": [

package/template/client/src/components/business-ui/user-profile/lark-sdk-styles.ts

@@ -0,0 +1,55 @@
+/**
+ * 飞书 h5-js-sdk 全局样式降层。
+ *
+ * 问题：SDK 加载时用 style-loader 往 <head> 插入约 200 段 CSS，其中混着几条
+ * 不带类名的全局重置，例如 `body{color;background-color;font-family}`、
+ * `input,button,select,optgroup,textarea{color:inherit}`。这些规则不在任何
+ * cascade layer 里，按层叠规则会压过应用放在 `@layer base` / `@layer utilities`
+ * 里的全部样式（与选择器权重无关）。表现为：打开过一次名片后，
+ * `bg-primary text-primary-foreground` 的按钮变成蓝底黑字，body 的字体、
+ * 颜色、背景也被改掉，直到刷新页面都不会恢复。
+ *
+ * 做法：只把「所有选择器都不含类名 / id」的规则挪进 `@layer base.lark-sdk`，
+ * 让应用自己的 base 层和工具类都能覆盖它们；带类名的名片内部样式原样保留，
+ * 名片外观不受影响。
+ *
+ * ⚠️ 依据 h5-js-sdk 1.2.21 的实现（加载时同步注入）。升级 SDK 后需要重新确认
+ * 新版是否还有其他全局规则、注入时机是否变化。
+ */
+
+const SDK_STYLE_LAYER = 'base.lark-sdk';
+
+/** 选择器列表里没有任何一项带类名或 id，即作用于整页的元素级规则 */
+function isElementLevelSelector(selectorText: string): boolean {
+  return selectorText.split(',').every((selector) => !/[.#]/.test(selector));
+}
+
+/** 把一个 <style> 里的元素级全局规则挪进低优先级的 cascade layer */
+export function demoteGlobalStyleRules(style: HTMLStyleElement): void {
+  // emotion 运行时样式都是哈希类名，Vite 开发态样式属于应用自身，都不处理
+  if (
+    style.hasAttribute('data-emotion') ||
+    style.hasAttribute('data-vite-dev-id')
+  ) {
+    return;
+  }
+
+  const sheet = style.sheet;
+  if (!sheet) return;
+
+  const moved: string[] = [];
+  for (let i = sheet.cssRules.length - 1; i >= 0; i -= 1) {
+    const rule = sheet.cssRules[i];
+    if (
+      rule instanceof CSSStyleRule &&
+      isElementLevelSelector(rule.selectorText)
+    ) {
+      moved.unshift(rule.cssText);
+      sheet.deleteRule(i);
+    }
+  }
+
+  if (moved.length > 0) {
+    sheet.insertRule(`@layer ${SDK_STYLE_LAYER} {\n${moved.join('\n')}\n}`, 0);
+  }
+}

package/template/client/src/components/business-ui/user-profile/user-external-script.ts

@@ -7,6 +7,30 @@ export interface UseExternalScriptOptions {
   attributes?: Record<string, string>;
   nonce?: string;
   onloadCallback?: () => void;
+  /**
+   * 脚本加载期间（插入 → onload / onerror）每个新插入 <head> 的 <style>
+   * 都会回调一次，用于处理脚本自带的全局样式。
+   */
+  onStyleInjected?: (style: HTMLStyleElement) => void;
+}
+
+/** 监听 <head> 新增的 <style>，返回的函数会先处理完积压的记录再停止监听 */
+function watchHeadStyles(
+  onStyle: (style: HTMLStyleElement) => void,
+): () => void {
+  const handle = (records: MutationRecord[]) => {
+    records.forEach((record) => {
+      record.addedNodes.forEach((node) => {
+        if (node instanceof HTMLStyleElement) onStyle(node);
+      });
+    });
+  };
+  const observer = new MutationObserver(handle);
+  observer.observe(document.head, { childList: true });
+  return () => {
+    handle(observer.takeRecords());
+    observer.disconnect();
+  };
 }
 
 /**
@@ -49,7 +73,13 @@ export function useExternalScript(
       script.setAttribute(k, v);
     });
 
+    // 组件提前卸载时脚本仍会继续加载并注入样式，所以只在 onload / onerror 停止监听
+    const stopWatchingStyles = options.onStyleInjected
+      ? watchHeadStyles(options.onStyleInjected)
+      : undefined;
+
     script.onload = () => {
+      stopWatchingStyles?.();
       if (!cancelled) setStatus('ready');
       if (options.onloadCallback) {
         options.onloadCallback();
@@ -57,6 +87,7 @@ export function useExternalScript(
     };
 
     script.onerror = () => {
+      stopWatchingStyles?.();
       if (!cancelled) setStatus('error');
     };
 

package/template/client/src/components/business-ui/user-profile/user-profile.tsx

@@ -26,6 +26,7 @@ import {
   takeSpare,
   waitForCardReady,
 } from '@client/src/components/business-ui/user-profile/lark-card-pool';
+import { demoteGlobalStyleRules } from '@client/src/components/business-ui/user-profile/lark-sdk-styles';
 import { getEnv } from '@lark-apaas/client-toolkit/utils/getEnv';
 import { useExternalScript } from '@client/src/components/business-ui/user-profile/user-external-script';
 import { Avatar, AvatarFallback, AvatarImage } from '@/components/ui/avatar';
@@ -369,7 +370,10 @@ function LarkProfileCard(props: { readonly larkCardParam: LarkCardParam }) {
   const startedRef = useRef(-1);
 
   const scriptOptions = useMemo(
-    () => ({ onloadCallback: registerLarkAuthHandler }),
+    () => ({
+      onloadCallback: registerLarkAuthHandler,
+      onStyleInjected: demoteGlobalStyleRules,
+    }),
     [],
   );
   const scriptStatus = useExternalScript(LARK_SDK_URL, scriptOptions);

package/template/package-lock.json

@@ -8,7 +8,7 @@
       "name": "fullstack-nestjs-template",
       "version": "2.3.0",
       "dependencies": {
-        "@lark-apaas/fullstack-nestjs-core": "^1.1.75",
+        "@lark-apaas/fullstack-nestjs-core": "^1.1.76",
         "@nestjs/axios": "^4.0.1",
         "@nestjs/cache-manager": "^3.1.3",
         "@nestjs/common": "^10.4.20",
@@ -1546,9 +1546,9 @@
       }
     },
     "node_modules/@lark-apaas/cache-service": {
-      "version": "0.1.6",
-      "resolved": "https://registry.npmmirror.com/@lark-apaas/cache-service/-/cache-service-0.1.6.tgz",
-      "integrity": "sha512-PO+OtJf6OsbeZJtM3SYKlSMV0Dlw2jvexKPPdDR5P/26kWvm52tFIt5iKdTDyhxkVvrHndtmjuOy4yvY3dFUUg==",
+      "version": "0.1.7",
+      "resolved": "https://registry.npmmirror.com/@lark-apaas/cache-service/-/cache-service-0.1.7.tgz",
+      "integrity": "sha512-ywuYrOck1/WVLXJDQsQRVmw3fQFq2wlRvuJJr0DcJ5j/ij3qT+Co6hsBLUZApK/Vu0LB8KmR4eiDMJfEM4jWgA==",
       "license": "MIT",
       "dependencies": {
         "@keyv/redis": "^5.1.6",
@@ -1561,9 +1561,9 @@
         "node": ">=18.0.0"
       },
       "peerDependencies": {
-        "@lark-apaas/nestjs-common": "^0.1.9",
-        "@lark-apaas/nestjs-logger": "^1.0.22",
-        "@lark-apaas/nestjs-observable": "^0.0.16",
+        "@lark-apaas/nestjs-common": "^0.1.10",
+        "@lark-apaas/nestjs-logger": "^1.0.23",
+        "@lark-apaas/nestjs-observable": "^0.0.17",
         "@nestjs/common": "^10.0.0",
         "@nestjs/core": "^10.0.0"
       }
@@ -1705,23 +1705,23 @@
       }
     },
     "node_modules/@lark-apaas/fullstack-nestjs-core": {
-      "version": "1.1.75",
-      "resolved": "https://registry.npmmirror.com/@lark-apaas/fullstack-nestjs-core/-/fullstack-nestjs-core-1.1.75.tgz",
-      "integrity": "sha512-8L3BxYUACH/TkZpC91tgtj1nyYXrMtabteALMQ2ocusMrLQ/TIveDwPpUtAkGuVm/z/qOlxiBoFBAFSwmgDfMw==",
+      "version": "1.1.76",
+      "resolved": "https://registry.npmmirror.com/@lark-apaas/fullstack-nestjs-core/-/fullstack-nestjs-core-1.1.76.tgz",
+      "integrity": "sha512-FyKahIqGRK498JvQQWSbCMk2L+XUwxr1ebY90elOkdB22kfIhW1NTDVgWypvAmWfhJG9YlIqDHMXyZAsQvkVtg==",
       "license": "MIT",
       "dependencies": {
-        "@lark-apaas/cache-service": "^0.1.6",
+        "@lark-apaas/cache-service": "^0.1.7",
         "@lark-apaas/file-service": "^0.1.2",
         "@lark-apaas/http-client": "^0.1.9",
-        "@lark-apaas/nestjs-authnpaas": "^1.0.9",
-        "@lark-apaas/nestjs-authzpaas": "^0.1.16",
-        "@lark-apaas/nestjs-capability": "^0.1.14",
-        "@lark-apaas/nestjs-common": "^0.1.9",
-        "@lark-apaas/nestjs-datapaas": "^1.0.27",
-        "@lark-apaas/nestjs-http-forwarder": "^0.1.4",
-        "@lark-apaas/nestjs-logger": "^1.0.22",
+        "@lark-apaas/nestjs-authnpaas": "^1.0.10",
+        "@lark-apaas/nestjs-authzpaas": "^0.1.17",
+        "@lark-apaas/nestjs-capability": "^0.1.15",
+        "@lark-apaas/nestjs-common": "^0.1.10",
+        "@lark-apaas/nestjs-datapaas": "^1.0.28",
+        "@lark-apaas/nestjs-http-forwarder": "^0.1.5",
+        "@lark-apaas/nestjs-logger": "^1.0.23",
         "@lark-apaas/nestjs-mcp": "^0.1.2",
-        "@lark-apaas/nestjs-observable": "^0.0.16",
+        "@lark-apaas/nestjs-observable": "^0.0.17",
         "@lark-apaas/nestjs-openapi-devtools": "^1.0.10",
         "@lark-apaas/nestjs-trigger": "^0.0.3",
         "@nestjs/axios": "^4.0.1",
@@ -1814,9 +1814,9 @@
       }
     },
     "node_modules/@lark-apaas/nestjs-authnpaas": {
-      "version": "1.0.9",
-      "resolved": "https://registry.npmmirror.com/@lark-apaas/nestjs-authnpaas/-/nestjs-authnpaas-1.0.9.tgz",
-      "integrity": "sha512-IZmTASPj/fXHjDfUahSNQeFlyWmZxpbpOeJO4cJNH8IGL3ueBWaMJ3A/DcR5TyR7kAy1Z3z371dd/MUlv8KP6g==",
+      "version": "1.0.10",
+      "resolved": "https://registry.npmmirror.com/@lark-apaas/nestjs-authnpaas/-/nestjs-authnpaas-1.0.10.tgz",
+      "integrity": "sha512-jqFOmINrYJbreVOohhsh6uHyPk2i+PbfcdYYOuuguKjhSNT8ckrHILM4nzv1pU735nIXfyZY/skYR+XYVan4Zg==",
       "license": "MIT",
       "dependencies": {
         "reflect-metadata": "^0.1.13"
@@ -1825,21 +1825,21 @@
         "node": ">=18.0.0"
       },
       "peerDependencies": {
-        "@lark-apaas/nestjs-common": "^0.1.9",
+        "@lark-apaas/nestjs-common": "^0.1.10",
         "@nestjs/common": "^10.0.0",
         "@nestjs/core": "^10.0.0",
         "@nestjs/swagger": "^7.4.2"
       }
     },
     "node_modules/@lark-apaas/nestjs-authzpaas": {
-      "version": "0.1.16",
-      "resolved": "https://registry.npmmirror.com/@lark-apaas/nestjs-authzpaas/-/nestjs-authzpaas-0.1.16.tgz",
-      "integrity": "sha512-w663qQ0ZZvooovH/bEJ/QqEWtu9uZJT2TaiAtjeqTUBtEqcxDuzZ2XiqK0zk3drdmrIWrbMXqjok8ubhnMrB5A==",
+      "version": "0.1.17",
+      "resolved": "https://registry.npmmirror.com/@lark-apaas/nestjs-authzpaas/-/nestjs-authzpaas-0.1.17.tgz",
+      "integrity": "sha512-BECBCQsJK0J2dyV7AV6Ob+pgG8go5lDImhyanTlNQGDBrzeQfQ+ys+Ki1mazlgAT3zVcVmzXRJz5vsP6rRSGbQ==",
       "license": "MIT",
       "dependencies": {
         "@casl/ability": "^6.7.3",
-        "@lark-apaas/nestjs-authnpaas": "^1.0.9",
-        "@lark-apaas/nestjs-common": "^0.1.9",
+        "@lark-apaas/nestjs-authnpaas": "^1.0.10",
+        "@lark-apaas/nestjs-common": "^0.1.10",
         "jsonwebtoken": "^9.0.3",
         "reflect-metadata": "^0.1.13",
         "uuid": "^13.0.0"
@@ -1867,12 +1867,12 @@
       }
     },
     "node_modules/@lark-apaas/nestjs-capability": {
-      "version": "0.1.14",
-      "resolved": "https://registry.npmmirror.com/@lark-apaas/nestjs-capability/-/nestjs-capability-0.1.14.tgz",
-      "integrity": "sha512-xdq27yE0vC0UzGLpgRB9eDLnp6qnH9avP/fLyL5U8dAwZ631wZb7n0fexNZCK5skY54hRUwYQ12ET4hFv3kTrg==",
+      "version": "0.1.15",
+      "resolved": "https://registry.npmmirror.com/@lark-apaas/nestjs-capability/-/nestjs-capability-0.1.15.tgz",
+      "integrity": "sha512-2FwfGGRdLPRNHNpFYGtk2CzprHdpaMQvjHGbIriBB3J3XobvaFZgTzBDL1d+D1oADHuFLtWKnqc5m82hUZqtdA==",
       "license": "MIT",
       "dependencies": {
-        "@lark-apaas/nestjs-common": "^0.1.9",
+        "@lark-apaas/nestjs-common": "^0.1.10",
         "chokidar": "^3.6.0"
       },
       "engines": {
@@ -1886,18 +1886,18 @@
       }
     },
     "node_modules/@lark-apaas/nestjs-common": {
-      "version": "0.1.9",
-      "resolved": "https://registry.npmmirror.com/@lark-apaas/nestjs-common/-/nestjs-common-0.1.9.tgz",
-      "integrity": "sha512-tEcLXjlQcScse+E3A2DAr6a09Jwb0W8i7z2yv4uVowxo1hfbmVyacHqKgod/FNHpkPXmhJ0N4omWJE00xGD3Sw==",
+      "version": "0.1.10",
+      "resolved": "https://registry.npmmirror.com/@lark-apaas/nestjs-common/-/nestjs-common-0.1.10.tgz",
+      "integrity": "sha512-Z9hInCfEOFmsI72p/dkumFw4hf1mfXnfY0EaD1lO89vnkcC6dlTJNYfAxSDpIg2BhCyiXQI0s83EyeOLey3HwQ==",
       "license": "MIT",
       "peerDependencies": {
         "@nestjs/common": "^10.4.20"
       }
     },
     "node_modules/@lark-apaas/nestjs-datapaas": {
-      "version": "1.0.27",
-      "resolved": "https://registry.npmmirror.com/@lark-apaas/nestjs-datapaas/-/nestjs-datapaas-1.0.27.tgz",
-      "integrity": "sha512-vjCg2QDSDFso3rIgazJe3CtPCxRiWuu0MCvsSMvB88oBS/tSqM/T3qZFXXK3rKcLjjNHfv7xFwdW4l7dwnnv3w==",
+      "version": "1.0.28",
+      "resolved": "https://registry.npmmirror.com/@lark-apaas/nestjs-datapaas/-/nestjs-datapaas-1.0.28.tgz",
+      "integrity": "sha512-cOOfT2NcD/gNgbvH8Sm7ywo9JNp4HxsPhpXTMFqr/5zp610XC2Zj8Fc3jyrRdb4mQVLxl6JSGvXTIvv0IyiZWQ==",
       "license": "MIT",
       "dependencies": {
         "@types/pg": "^8.10.9",
@@ -1908,20 +1908,20 @@
         "node": ">=18.0.0"
       },
       "peerDependencies": {
-        "@lark-apaas/nestjs-common": "^0.1.9",
-        "@lark-apaas/nestjs-observable": "^0.0.16",
+        "@lark-apaas/nestjs-common": "^0.1.10",
+        "@lark-apaas/nestjs-observable": "^0.0.17",
         "@nestjs/common": "^10.0.0",
         "@nestjs/core": "^10.0.0",
         "drizzle-orm": ">=0.44.6"
       }
     },
     "node_modules/@lark-apaas/nestjs-http-forwarder": {
-      "version": "0.1.4",
-      "resolved": "https://registry.npmmirror.com/@lark-apaas/nestjs-http-forwarder/-/nestjs-http-forwarder-0.1.4.tgz",
-      "integrity": "sha512-AOWaeHrZvXRsK/F+2KkEPDJYbNjeuFc2OqhWEWm7u+KSuDE2iQ0dgNm1fTCvf9tkqrLNWEczqDhsP+CNmKndEQ==",
+      "version": "0.1.5",
+      "resolved": "https://registry.npmmirror.com/@lark-apaas/nestjs-http-forwarder/-/nestjs-http-forwarder-0.1.5.tgz",
+      "integrity": "sha512-GKl17i+E90rgcUdzWi7b9CoYmVWJrgq8KoQlbQ08AwOyzIwc6sguU8GaCg5/uxKcmz+Zz/B2X/Jg/Qlw7XnE0Q==",
       "license": "MIT",
       "dependencies": {
-        "@lark-apaas/nestjs-common": "^0.1.9",
+        "@lark-apaas/nestjs-common": "^0.1.10",
         "reflect-metadata": "^0.1.13",
         "undici": "^7.0.0"
       },
@@ -1934,13 +1934,13 @@
       }
     },
     "node_modules/@lark-apaas/nestjs-logger": {
-      "version": "1.0.22",
-      "resolved": "https://registry.npmmirror.com/@lark-apaas/nestjs-logger/-/nestjs-logger-1.0.22.tgz",
-      "integrity": "sha512-IyD32YyoZPx+jCVQceJY9bidwOgiou7qMNZy79byK/uOPwTrgXZkZoWY/DSHVbm2AfDyg86/WeDgRT9+JCz4kQ==",
+      "version": "1.0.23",
+      "resolved": "https://registry.npmmirror.com/@lark-apaas/nestjs-logger/-/nestjs-logger-1.0.23.tgz",
+      "integrity": "sha512-trdHMSgpFYZVqjGfy0sGx752Z5g/G5OFZMi2XinpOKV0rsm9xfDrSH19sKMh84cZ4BKd5dL7KlGwIti2EUD5CA==",
       "license": "MIT",
       "dependencies": {
-        "@lark-apaas/nestjs-common": "^0.1.9",
-        "@lark-apaas/nestjs-observable": "^0.0.16",
+        "@lark-apaas/nestjs-common": "^0.1.10",
+        "@lark-apaas/nestjs-observable": "^0.0.17",
         "pino": "^10.0.0",
         "rotating-file-stream": "^3.2.9"
       },
@@ -1973,12 +1973,12 @@
       }
     },
     "node_modules/@lark-apaas/nestjs-observable": {
-      "version": "0.0.16",
-      "resolved": "https://registry.npmmirror.com/@lark-apaas/nestjs-observable/-/nestjs-observable-0.0.16.tgz",
-      "integrity": "sha512-t0RO/YZKpBH1cEYGun6sUPRiOkmqUqUJIMoOvGu4GxM3OyHiNtqSb2apIaDlhZ5Az1eaXP+04n5tN8iLO4FScg==",
+      "version": "0.0.17",
+      "resolved": "https://registry.npmmirror.com/@lark-apaas/nestjs-observable/-/nestjs-observable-0.0.17.tgz",
+      "integrity": "sha512-SCkLTXodXsemDkW01NkPehCyw1VM6rnaZFt8fOU7cEIxmpTfTubYKlcQpNv+ui7a9t3ROr2Nv02GNhdVBAKNUQ==",
       "license": "MIT",
       "dependencies": {
-        "@lark-apaas/nestjs-common": "^0.1.9",
+        "@lark-apaas/nestjs-common": "^0.1.10",
         "@lark-apaas/observable": "^1.0.10"
       },
       "peerDependencies": {
@@ -21746,9 +21746,9 @@
       }
     },
     "node_modules/undici": {
-      "version": "7.30.1",
-      "resolved": "https://registry.npmmirror.com/undici/-/undici-7.30.1.tgz",
-      "integrity": "sha512-03KrMbjIFDWQR5RNPrSw3bd1r12JpyFQl9/yxjUbJtqkjmllqC5lFjZh6ujeuJCKr8EOQvRW872Oy/az+nLYxg==",
+      "version": "7.30.2",
+      "resolved": "https://registry.npmmirror.com/undici/-/undici-7.30.2.tgz",
+      "integrity": "sha512-mLyPQnHwUxaM/rideoK/+KL8DaAJLRl4aBCfmX444aCSLnIaomqPLtNRe2jdCYcsk5wZzXrDIQC8ZeYNRAYyIA==",
       "license": "MIT",
       "engines": {
         "node": ">=20.18.1"

package/template/package.json

@@ -28,7 +28,7 @@
     "upgrade": "npx -y @lark-apaas/fullstack-cli sync --disable-gen-openapi"
   },
   "dependencies": {
-    "@lark-apaas/fullstack-nestjs-core": "^1.1.75",
+    "@lark-apaas/fullstack-nestjs-core": "^1.1.76",
     "@nestjs/axios": "^4.0.1",
     "@nestjs/cache-manager": "^3.1.3",
     "@nestjs/common": "^10.4.20",