@yuku123/z-frontend-common 1.1.0 → 1.1.2

package/src/components/ui/echarts.js

@@ -0,0 +1,8 @@
+/**
+ * 图表子路径 `@yuku123/z-frontend-common/ui/echarts`。
+ *
+ * EChartsChart 是 ui 目录里唯一依赖 echarts 的组件, 故不进扁平桶:
+ * 绝大多数域组件 (z-gw/z-ctc/z-oss/z-msg …) 从不画图, 让它们 resolve echarts/core
+ * 会直接构建失败。需要图表的域显式引本子路径并自行声明 echarts 依赖。
+ */
+export {default as EChartsChart} from './EChartsChart.jsx'

package/src/components/ui/index.js

@@ -13,7 +13,6 @@
  *   - ErrorState          错误状态 (原因 + 重试)
  *   - LoadingState        骨架屏 (cards/table/list/detail)
  *   - SearchInput         Debounced 搜索 (300ms, Enter 立即, Esc 清空)
- *   - EChartsChart        安全 echarts 包装 (自动 dispose/resize)
  *   - PageHeader          页面标题 (面包屑 + 返回 + 操作区)
  */
 
@@ -27,10 +26,12 @@ export {default as EmptyState} from './EmptyState'
 export {default as ErrorState} from './ErrorState'
 export {default as LoadingState} from './LoadingState'
 export {default as SearchInput} from './SearchInput'
-export {default as EChartsChart} from './EChartsChart'
+// EChartsChart 走 ./echarts 子路径: 它是本目录唯一引 echarts 的组件,
 export {default as PageHeader} from './PageHeader'
 export {default as TableToolbar, RefreshButton} from './TableToolbar'
 export {default as StatusBadge} from './StatusBadge'
 export {default as PagedTable} from './PagedTable'
+// ComponentDoc - 组件文档页（§7）：左侧 240px TOC + 右侧正文，各仓只提供 DOC.md
+export {default as ComponentDoc} from './ComponentDoc'
 
 export {brand, palette, neutral, radius, shadow, lift, space, fontSize, antdTheme} from './tokens'

package/src/index.js

@@ -1,7 +1,7 @@
 /**
  * z-frontend-common 桶导出 —— lead 008 前端开发规范唯一承载仓。
  *
- * 40+ 仓 suit 的 AppLayout / LoginPage 唯一来源；21 个 <repo>-component 的
+ * 40 个 suit 的 AppLayout / LoginPage 唯一来源；31 个 <repo>-component 的
  * services 层消费 createRequest / request / authRequest。
  *
  * API 契约与 0.1.1 完全兼容（ErrorBoundary / LoginPage / StatusTag /
@@ -26,7 +26,18 @@ import { createRequest, setupInterceptors, unwrapResponse, request, authRequest
 export { createRequest, setupInterceptors, unwrapResponse, request, authRequest }
 
 // 0.1.1 default 桶契约原样保留（Ge 对象），老调用方 `import zfc from '@yuku123/z-frontend-common'` 不断
-export default {
+//
+// ⚠ 桶额外**转发 axios 的 HTTP 动词方法**（get/post/put/patch/delete/head/options）。
+//   起因：仓里有 6 个包的 services/api.js 写的是「默认导入当 axios 实例用」——
+//   `import request from '@yuku123/z-frontend-common'` 然后 `request.get('/xxx')`，
+//   而默认导出是桶对象 ⇒ request.get 不存在 ⇒ 一调就抛
+//   "TypeError: Xt.get is not a function"（线上 /msg/inbox 白屏就是它，2026-10-20 实测）。
+//   那 6 个包的 dist 已发到 npm（z-oss / z-mq / z-gw / z-cache / z-graph / z-msg），
+//   改它们要逐个重新发版；这里在桶上补一层转发，让「默认导入当 axios 用」的老写法继续能跑。
+//   逐个转发（而不是 Object.assign(bucket, request)）：axios 实例自己也有个 .request 方法，
+//   整包 assign 会把桶里 request=「axios 实例」这个契约覆盖成 axios 的 request 方法。
+const httpVerbs = ['get', 'post', 'put', 'patch', 'delete', 'head', 'options']
+const bucket = {
     AppLayout,
     StatusTag,
     defaultStatusMap,
@@ -36,3 +47,9 @@ export default {
     authRequest,
     createRequest,
 }
+for (const verb of httpVerbs) {
+    if (typeof request[verb] === 'function' && !(verb in bucket)) {
+        bucket[verb] = (...args) => request[verb](...args)
+    }
+}
+export default bucket

package/src/services/request.js

@@ -17,7 +17,7 @@ export function unwrapResponse(body) {
 
 /**
  * axios 拦截器装配（request / authRequest 预建实例与 createRequest 工厂共用）。
- * 与 0.1.1 的 API 契约逐字段一致，21 个 component 仓的 services 层在消费，不能改签名。
+ * 与 0.1.1 的 API 契约逐字段一致，31 个 component 仓的 services 层在消费，不能改签名。
  */
 export function setupInterceptors(instance, options = {}) {
     const {
@@ -37,9 +37,23 @@ export function setupInterceptors(instance, options = {}) {
         (error) => {
             const status = error.response?.status
             if (status === 401) {
-                localStorage.removeItem(tokenKey)
-                localStorage.removeItem(userInfoKey)
-                window.location.href = unauthorizedRedirect
+                // ⚠ 401 有两种含义，HTTP 码一样但语义相反，必须分开：
+                //   会话 401（平台 SSO 层）: {"success":false,"code":401,"message":"未登录或Token无效","data":null}
+                //   业务 401（子域自己的凭据/口径）: {"success":false,"errorCode":"MISSING_API_KEY","message":"..."}
+                // 业务 401 **不是**平台会话过期 —— 清 token 跳登录会把人直接踢出系统。
+                // 实测（2026-10-20）：z-script 的 /api/script/** 被它自己的 ApiKeyAuthInterceptor
+                // 拦成 401 MISSING_API_KEY，一进 /script/manage 就被踢回 /login
+                // （运维面当年为此把该页从菜单里摘掉了）。
+                // 判据用「响应体带 errorCode」：平台会话 401 不带 errorCode，业务 401 带 —— 互斥，不会误伤真会话失效。
+                const body = error.response?.data
+                const isBusiness401 = !!(body && typeof body === 'object' && body.errorCode)
+                if (isBusiness401) {
+                    console.warn(`[401] 业务鉴权失败（不是会话过期，不跳登录）: ${error.config?.url} → ${body.errorCode}`)
+                } else {
+                    localStorage.removeItem(tokenKey)
+                    localStorage.removeItem(userInfoKey)
+                    window.location.href = unauthorizedRedirect
+                }
             } else if (status === 403) {
                 console.error('没有权限访问该资源')
             } else if (status === 500) {
@@ -52,7 +66,7 @@ export function setupInterceptors(instance, options = {}) {
 }
 
 /**
- * axios 实例工厂 —— 21 个 <repo>-component 的 services/api.js 用它建各自的请求实例。
+ * axios 实例工厂 —— 31 个 <repo>-component 的 services/api.js 用它建各自的请求实例。
  * @param {Object} options
  * @param {string}  [options.baseURL='/api']
  * @param {number}  [options.timeout=10000]