@lark-apaas/client-toolkit-lite 1.1.7-alpha.24 → 1.1.7-alpha.26

package/README.md

@@ -19,13 +19,14 @@ npm install react react-dom react-router-dom @tanstack/react-query
 ### 1. 使用 AppContainer
 
 `AppContainer` 是应用根容器，内部集成：
-- **全局样式** — 自动导入主题样式（theme-layer / tailwind-theme / override / font-family），无需手动 import CSS
 - **Safety** — 生产环境「妙搭构建」安全标识
 - **QueryProvider** — React Query 数据管理
 - **useAppInfo** — 自动同步 document title / favicon / OG meta
 - **Tea 埋点** — 生产环境自动上报页面访问事件
 - **Runtime** — React DevTools Hook + Axios CSRF 全局注入（防重复）
 
+> 主题样式**不自动注入**，需在应用入口手动 import，详见下一节。
+
 ```tsx
 // App.tsx
 import { AppContainer } from '@lark-apaas/client-toolkit-lite';
@@ -53,6 +54,53 @@ import { QueryProvider } from '@lark-apaas/client-toolkit-lite';
 <QueryProvider>{children}</QueryProvider>
 ```
 
+### 2. 导入样式
+
+主题样式包含 4 个片段：`theme-layer`（layer 顺序声明）/ `tailwind-theme`（色板变量 + `.dark` 模式）/ `override`（base 兜底）/ `font-family`（Lark 字体）。聚合入口需手动 import：
+
+```ts
+// main.ts / main.tsx
+import '@lark-apaas/client-toolkit-lite/styles.css';
+```
+
+#### Tailwind v4 source 扫描
+
+lite 的 `Drawer` / `Popover` / `ErrorRender` 等组件使用了 Tailwind class，由于 v4 默认不扫描 `node_modules`，需要在你自己的主 css 里显式声明 source（否则这些组件会没有视觉）：
+
+```css
+/* 你的 main.css */
+@import 'tailwindcss';
+@import '@lark-apaas/client-toolkit-lite/styles.css';
+
+/* 路径相对于这个 css 文件所在位置 */
+@source "../node_modules/@lark-apaas/client-toolkit-lite/dist";
+```
+
+#### shadcn 语义变量（按需补）
+
+`override.css` 和 `Drawer` / `Popover` 用了 `--background` / `--foreground` / `--border` / `--ring` / `--popover` / `--popover-foreground` / `--muted-foreground` 等 shadcn 风格语义变量。lite 内置色板（`tailwind-theme.css`）**只提供 `--color-*` 全色板**，不包含这些语义变量 —— 需要你在自己的 css 里按业务主题补上：
+
+```css
+:root {
+  --background: var(--color-neutral-00);
+  --foreground: var(--color-neutral-950);
+  --border: var(--color-neutral-300);
+  --ring: var(--color-blue-500);
+  --popover: var(--color-neutral-00);
+  --popover-foreground: var(--color-neutral-950);
+  --muted-foreground: var(--color-neutral-700);
+}
+```
+
+#### 按需导入子片段
+
+只要色板或字体时可单独 import：
+
+```ts
+import '@lark-apaas/client-toolkit-lite/styles/tailwind-theme.css';
+import '@lark-apaas/client-toolkit-lite/styles/font-family.css';
+```
+
 ### 3. Hooks
 
 #### useAppInfo

package/dist/index.cjs

@@ -1473,6 +1473,11 @@ __name(useLogout, "useLogout");
 
 // src/locales/messages.ts
 var messages = {
+  // ── Index / 通用 ──────────────────────────────────────────────
+  "index.rateLimitError": {
+    zh: "\u5E94\u7528\u989D\u5EA6\u5DF2\u8017\u5C3D\uFF0C\u8BF7\u8054\u7CFB\u5E94\u7528\u5F00\u53D1\u8005",
+    en: "Application quota exhausted, please contact the app developer"
+  },
   // ── Safety 组件 ──────────────────────────────────────────────
   "safety.badge.label": {
     zh: "\u5999\u642D",
@@ -2841,23 +2846,86 @@ var axiosForBackend = getAxiosForBackend();
 
 // src/integrations/capabilityClient.ts
 var import_client_capability = require("@lark-apaas/client-capability");
+
+// src/components/ui/toast.tsx
+function showToast2(message, duration = 3e3) {
+  return new Promise((resolve) => {
+    const toast = document.createElement("div");
+    const iconSvg = `<svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
+      <path fill-rule="evenodd" clip-rule="evenodd" d="M8 1.333a6.667 6.667 0 1 1 0 13.334A6.667 6.667 0 0 1 8 1.333ZM8 10a.667.667 0 1 0 0 1.333A.667.667 0 0 0 8 10Zm0-5.333a.667.667 0 0 0-.667.666v3.334a.667.667 0 0 0 1.334 0V5.333A.667.667 0 0 0 8 4.667Z" fill="#ff811a"/>
+    </svg>`;
+    const iconWrapper = document.createElement("span");
+    iconWrapper.innerHTML = iconSvg;
+    Object.assign(iconWrapper.style, {
+      display: "flex",
+      alignItems: "center",
+      marginRight: "8px",
+      flexShrink: "0"
+    });
+    const textWrapper = document.createElement("span");
+    textWrapper.textContent = message;
+    toast.appendChild(iconWrapper);
+    toast.appendChild(textWrapper);
+    Object.assign(toast.style, {
+      position: "fixed",
+      top: "32px",
+      left: "50%",
+      transform: "translate(-50%, -50%)",
+      display: "flex",
+      alignItems: "center",
+      padding: "12px 16px",
+      backgroundColor: "#fff",
+      color: "#1f2329",
+      border: "1px solid #dee0e3",
+      borderRadius: "6px",
+      fontSize: "14px",
+      lineHeight: "1.5",
+      zIndex: "99999",
+      maxWidth: "80vw",
+      wordBreak: "break-word",
+      boxShadow: "0 4px 8px rgba(0, 0, 0, 0.03), 0 3px 6px rgba(0, 0, 0, 0.05), 0 6px 18px rgba(0, 0, 0, 0.03)",
+      opacity: "0",
+      transition: "opacity 0.3s ease"
+    });
+    document.body.appendChild(toast);
+    requestAnimationFrame(() => {
+      toast.style.opacity = "1";
+    });
+    setTimeout(() => {
+      toast.style.opacity = "0";
+      setTimeout(() => {
+        document.body.removeChild(toast);
+        resolve();
+      }, 300);
+    }, duration);
+  });
+}
+__name(showToast2, "showToast");
+
+// src/integrations/capabilityClient.ts
 var _appId = getAppId();
-var _acquireUploadUrl = isNewPathEnabled() ? `/app/${_appId}/__runtime__/api/v1/studio/plugins/tmp_files/acquire_upload_url` : `/af/api/v1/studio/plugins/tmp_files/acquire_upload_url`;
-var _acquireDownloadUrl = isNewPathEnabled() ? `/app/${_appId}/__runtime__/api/v1/studio/plugins/tmp_files/acquire_download_url` : `/af/api/v1/studio/plugins/tmp_files/acquire_download_url`;
+var _archType = process.env.MIAODA_APP_ARCH_TYPE;
+var _isFrontendOnly = _archType === "2" || _archType === "3" || _archType === "4";
 var capabilityClient = (0, import_client_capability.createClient)({
   baseURL: normalizeBasePath(process.env.CLIENT_BASE_PATH ?? "/"),
-  acquireUploadUrl: _acquireUploadUrl,
-  acquireDownloadUrl: _acquireDownloadUrl,
+  acquireUploadUrl: `/app/${_appId}/__runtime__/api/v1/studio/plugins/tmp_files/acquire_upload_url`,
+  acquireDownloadUrl: `/app/${_appId}/__runtime__/api/v1/studio/plugins/tmp_files/acquire_download_url`,
   fetchOptions: {
     headers: {
       "X-Suda-Csrf-Token": window.csrfToken ?? ""
     }
   },
-  central: {
-    enabled: true,
-    // window.appId 由妙搭沙箱 / 线上环境注入；非妙搭场景下 capability 调用本身不可用
-    appId: _appId ?? ""
-  }
+  logger,
+  onRateLimitError: /* @__PURE__ */ __name(() => {
+    showToast2(t("index.rateLimitError"));
+  }, "onRateLimitError"),
+  ..._isFrontendOnly ? {
+    central: {
+      enabled: true,
+      // window.appId 由妙搭沙箱 / 线上环境注入；非妙搭场景下 capability 调用本身不可用
+      appId: _appId ?? ""
+    }
+  } : {}
 });
 
 // src/constants/img-resources/avatar.ts