w-web-perm 1.1.4 → 1.1.6

package/docs/server_procCore.mjs.html

@@ -29,7 +29,7 @@
 <nav >
     
     
-    <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="WWebPerm.html">WWebPerm</a></li></ul><h3>Global</h3><ul><li><a href="global.html#fetchJson">fetchJson</a></li><li><a href="global.html#mergePickKeysOnly">mergePickKeysOnly</a></li></ul>
+    <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="WWebPerm.html">WWebPerm</a></li></ul><h3>Global</h3><ul><li><a href="global.html#createLegendMeasurer">createLegendMeasurer</a></li><li><a href="global.html#createLockSave">createLockSave</a></li><li><a href="global.html#decideLegendType">decideLegendType</a></li><li><a href="global.html#describeUpstream">describeUpstream</a></li><li><a href="global.html#fetchJson">fetchJson</a></li><li><a href="global.html#genLegend">genLegend</a></li><li><a href="global.html#maskQuery">maskQuery</a></li><li><a href="global.html#maskTok">maskTok</a></li><li><a href="global.html#maskUrl">maskUrl</a></li><li><a href="global.html#mergePickKeysOnly">mergePickKeysOnly</a></li><li><a href="global.html#reuseDeletedIds">reuseDeletedIds</a></li><li><a href="global.html#submitGuard">submitGuard</a></li><li><a href="global.html#wrapInjected">wrapInjected</a></li></ul>
     
 </nav>
 
@@ -96,7 +96,7 @@ function mergePickKeysOnly(ltdtDb, rowsIn, keyDetect, pickKeys) {
 }
 
 
-function proc(woItems, procOrm, { srLog, kmx }) {
+function proc(woItems, procOrm, { srLog, kmx, lockSave }) {
 
 
     //updateTabItems
@@ -106,8 +106,21 @@ function proc(woItems, procOrm, { srLog, kmx }) {
         //pickKeysOnly, 僅採納既有列之指定欄位變更(見 mergePickKeysOnly), 未給則整表 diff 寫入
         let pickKeysOnly = get(opt, 'pickKeysOnly', null)
 
+        //idsNew: 前端標為新增(transient 欄位 _isNew === true, 清單頁 addItem / copyItem 標記)之列 id, 供下方比對既有列 (ADR-025);
+        //_isNew 不在 schema keys 內, 下方 ltdtmapping 取欄時即剝除不入庫. pickKeysOnly 模式不採納新增列(見 mergePickKeysOnly), 故不收集
+        let idsNew = []
+        if (!isearr(pickKeysOnly)) {
+            each(rows, (r) => {
+                if (get(r, '_isNew') === true) {
+                    idsNew.push(get(r, 'id', ''))
+                }
+            })
+        }
+
+        //雙擊防護(後端): 同一操作者之同表寫入處理中再送出即拒絕 'saveInProgress'(不排隊, 見 lockSave.mjs, ADR-025);
+        //占位包在 kmx 之外層, 不同操作者之並行寫入仍由 kmx 序列化、各自成功(ADR-012)
         //序列化同表之並行整表批次寫入: 防 lost update (同 keyTable 序列化, 不同表並行)
-        return await kmx('updateTabItems:' + keyTable, async () => {
+        return await lockSave(`updateTabItems:${keyTable}`, userId, () => kmx('updateTabItems:' + keyTable, async () => {
 
         //pickKeysOnly, 須於 mutex 內讀取資料庫為基底, 避免與並行寫入 race
         if (isearr(pickKeysOnly)) {
@@ -184,6 +197,19 @@ function proc(woItems, procOrm, { srLog, kmx }) {
 
         //ltdtDiffByKey
         let ltdtOld = await woItems[keyTable].select()
+
+        //新增列已存在即拒絕 (ADR-025): 同一包重送且第 2 次於第 1 次完成後才處理時(占位已釋放), 第 1 次已建立之列會被當「修改」(diff),
+        //以前端之佔位字覆寫伺服器於新增時填入之建立者 / 建立時間(procOrm save 只覆寫 userIdUpdate / timeUpdate); 故整包拒絕、不寫入
+        if (size(idsNew) > 0) {
+            let kpIdOld = {}
+            each(ltdtOld, (v) => {
+                kpIdOld[get(v, 'id', '')] = true
+            })
+            if (idsNew.some((id) => kpIdOld[id] === true)) {
+                return Promise.reject('saveNewRowExists')
+            }
+        }
+
         let ltdtNew = rows
         let r = ltdtDiffByKey(ltdtOld, ltdtNew, keyDetect)
         // console.log('ltdtDiffByKey r', r)
@@ -214,7 +240,7 @@ function proc(woItems, procOrm, { srLog, kmx }) {
 
         return ltdtNew
 
-        })
+        }))
     }
 
 
@@ -298,7 +324,7 @@ export default proc
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Thu Sep 24 2026 13:05:11 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Fri Oct 02 2026 20:53:56 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/server_wrapInjected.mjs.html

@@ -0,0 +1,163 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    
+    <meta charset="utf-8">
+    <title>server/wrapInjected.mjs - Documentation</title>
+    
+    
+    <script src="scripts/prettify/prettify.js"></script>
+    <script src="scripts/prettify/lang-css.js"></script>
+    <!--[if lt IE 9]>
+      <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
+    <![endif]-->
+    <link type="text/css" rel="stylesheet" href="styles/prettify.css">
+    <link type="text/css" rel="stylesheet" href="styles/jsdoc.css">
+    <script src="scripts/nav.js" defer></script>
+    
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+</head>
+<body>
+
+<input type="checkbox" id="nav-trigger" class="nav-trigger" />
+<label for="nav-trigger" class="navicon-button x">
+  <div class="navicon"></div>
+</label>
+
+<label for="nav-trigger" class="overlay"></label>
+
+<nav >
+    
+    
+    <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="WWebPerm.html">WWebPerm</a></li></ul><h3>Global</h3><ul><li><a href="global.html#createLegendMeasurer">createLegendMeasurer</a></li><li><a href="global.html#createLockSave">createLockSave</a></li><li><a href="global.html#decideLegendType">decideLegendType</a></li><li><a href="global.html#describeUpstream">describeUpstream</a></li><li><a href="global.html#fetchJson">fetchJson</a></li><li><a href="global.html#genLegend">genLegend</a></li><li><a href="global.html#maskQuery">maskQuery</a></li><li><a href="global.html#maskTok">maskTok</a></li><li><a href="global.html#maskUrl">maskUrl</a></li><li><a href="global.html#mergePickKeysOnly">mergePickKeysOnly</a></li><li><a href="global.html#reuseDeletedIds">reuseDeletedIds</a></li><li><a href="global.html#submitGuard">submitGuard</a></li><li><a href="global.html#wrapInjected">wrapInjected</a></li></ul>
+    
+</nav>
+
+<div id="main">
+    
+    <h1 class="page-title">server/wrapInjected.mjs</h1>
+    
+
+    
+
+
+
+    
+    <section>
+        <article>
+            <pre class="prettyprint source linenums"><code>import get from 'lodash-es/get.js'
+import isestr from 'wsemi/src/isestr.mjs'
+import isarr from 'wsemi/src/isarr.mjs'
+import isfun from 'wsemi/src/isfun.mjs'
+
+
+//wrapInjected: 部署方注入函數(getUserByToken / verifyClientUser / verifyAppUser)之包裝(W 契約, spec/設計要點與取捨.md ADR-023)
+//why: 注入函數拋錯或 reject 時原會被 await 原樣上拋, 其原文經 pm2resolve 回前端、經 verifyConn 之 msg 入 srLog、經 error 事件印出;
+//部署方常以 w-web-sso 對外 helper(≤1.1.4)包裝 getUserByToken, 其 reject 字串含已代入系統介接權杖與使用者權杖之完整網址(修正前探測實證)。
+//包裝後失敗視同否定結果(由呼叫端給 failValue), 走各呼叫點既有之查無 / 無權限分支回自家 key; 上游原文不回前端、不入 log。
+
+
+//keysUpstream: 上游失敗可照記之 key 白名單 = w-web-sso 對外 helper 之 K 契約 14 個 key(w-web-sso ADR-068)
+//與 sso 之同步點: sso 之 K 契約增減 key 時須同步本表(見 CLAUDE_rulebook.md「權杖不外洩」)
+let keysUpstream = [
+    'invalidUrl',
+    'invalidTokenSelf',
+    'invalidTokenTar',
+    'invalidUserIdTar',
+    'noTokenKeyValueInUrl',
+    'noTokenKeyUserIdInUrl',
+    'noTokenInUrl',
+    'cannotGetUserByUrl',
+    'cannotGetUsersByUrl',
+    'cannotGetUserDataByUrl',
+    'cannotGetUsersDataByUrl',
+    'noUserDataByUrl',
+    'noUsersDataByUrl',
+    'noUserDataAfterConvert',
+]
+
+
+//reName: Error.name 之名稱形狀(同 w-web-sso helper 診斷之 errName), 不符者不記(name 亦可被設為任意字串)
+let reName = /^[A-Za-z]{1,40}$/
+
+
+/**
+ * 描述上游失敗, 供寫入 log: 絕不含上游原文
+ * - reject 值(字串)或其 message 屬白名單 key → { upstream: key }
+ * - 其餘 → { upstreamType, upstreamName }: 型別(null / array / typeof)與名稱形狀之 Error.name(無則 '')
+ *
+ * @param {*} err 輸入注入函數拋出或 reject 之值
+ * @returns {Object} 回傳描述物件
+ */
+function describeUpstream(err) {
+    let key = isestr(err) ? err : get(err, 'message')
+    if (isestr(key) &amp;&amp; keysUpstream.includes(key)) {
+        return { upstream: key }
+    }
+    let upstreamType = (err === null) ? 'null' : (isarr(err) ? 'array' : typeof err)
+    let name = get(err, 'name')
+    let upstreamName = (isestr(name) &amp;&amp; reName.test(name)) ? name : ''
+    return { upstreamType, upstreamName }
+}
+
+
+/**
+ * 包裝注入函數: 回傳(同步或 Promise)原樣回傳; 同步拋錯或 reject 回 failValue, 並以 describeUpstream(err) 呼叫 onFail
+ * 包裝後一律回 Promise(呼叫端既有之 ispm 判斷照常)
+ *
+ * @param {Function} fn 輸入注入函數
+ * @param {Object} [opt={}] 輸入設定物件
+ * @param {*} [opt.failValue=null] 輸入失敗時之回傳值(getUserByToken 為 null 等同查無, verify* 為 false 等同無權限)
+ * @param {Function} [opt.onFail=null] 輸入失敗時之紀錄函數, 只收到 describeUpstream 之結果(收不到上游原文); 其自身拋錯不影響回傳
+ * @returns {Function} 回傳包裝後之函數
+ */
+function wrapInjected(fn, opt = {}) {
+    let failValue = get(opt, 'failValue', null)
+    let onFail = get(opt, 'onFail', null)
+    return async (...args) => {
+        try {
+            return await fn(...args) //await 於 try 內: 同步拋錯、reject 與 thenable 之 reject 皆攔截
+        }
+        catch (err) {
+            if (isfun(onFail)) {
+                try {
+                    onFail(describeUpstream(err))
+                }
+                catch (e) {} //紀錄失敗不改變「失敗＝否定結果」之語意
+            }
+            return failValue
+        }
+    }
+}
+
+
+export {
+    keysUpstream,
+    describeUpstream
+}
+export default wrapInjected
+</code></pre>
+        </article>
+    </section>
+
+
+
+
+    
+    
+</div>
+
+<br class="clear">
+
+<footer>
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Fri Oct 02 2026 20:53:56 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+</footer>
+
+<script>prettyPrint();</script>
+<script src="scripts/polyfill.js"></script>
+<script src="scripts/linenumber.js"></script>
+
+
+
+</body>
+</html>

package/docs/src_fetchJson.mjs.html

@@ -29,7 +29,7 @@
 <nav >
     
     
-    <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="WWebPerm.html">WWebPerm</a></li></ul><h3>Global</h3><ul><li><a href="global.html#fetchJson">fetchJson</a></li><li><a href="global.html#mergePickKeysOnly">mergePickKeysOnly</a></li></ul>
+    <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="WWebPerm.html">WWebPerm</a></li></ul><h3>Global</h3><ul><li><a href="global.html#createLegendMeasurer">createLegendMeasurer</a></li><li><a href="global.html#createLockSave">createLockSave</a></li><li><a href="global.html#decideLegendType">decideLegendType</a></li><li><a href="global.html#describeUpstream">describeUpstream</a></li><li><a href="global.html#fetchJson">fetchJson</a></li><li><a href="global.html#genLegend">genLegend</a></li><li><a href="global.html#maskQuery">maskQuery</a></li><li><a href="global.html#maskTok">maskTok</a></li><li><a href="global.html#maskUrl">maskUrl</a></li><li><a href="global.html#mergePickKeysOnly">mergePickKeysOnly</a></li><li><a href="global.html#reuseDeletedIds">reuseDeletedIds</a></li><li><a href="global.html#submitGuard">submitGuard</a></li><li><a href="global.html#wrapInjected">wrapInjected</a></li></ul>
     
 </nav>
 
@@ -45,13 +45,39 @@
     
     <section>
         <article>
-            <pre class="prettyprint source linenums"><code>/**
+            <pre class="prettyprint source linenums"><code>import get from 'lodash-es/get.js'
+import isestr from 'wsemi/src/isestr.mjs'
+
+
+let reName = /^[A-Za-z]{1,40}$/
+let reCode = /^[A-Z][A-Z0-9_]{1,40}$/
+
+
+//errDesc: 例外只取名稱(與代碼形狀之 cause.code / code), 不取 message(spec/設計要點與取捨.md ADR-023)
+//why: fetch 例外之 message 可能含完整網址('Failed to parse URL from &lt;url>'、'Request cannot be constructed from a URL that includes credentials: &lt;url>'),
+//而網址常帶權杖(?token=); JSON 解析錯誤之 message 夾帶回應本體片段. reject 物件會經 perm.conn / provideTabs 交給呼叫端與其 log
+function errDesc(err) {
+    let name = get(err, 'name')
+    let s = (isestr(name) &amp;&amp; reName.test(name)) ? name : 'Error'
+    let code = get(err, 'cause.code')
+    if (!(isestr(code) &amp;&amp; reCode.test(code))) {
+        code = get(err, 'code')
+    }
+    if (isestr(code) &amp;&amp; reCode.test(code)) {
+        s += ` ${code}`
+    }
+    return s
+}
+
+
+/**
  * 以瀏覽器與 node(18+) 內建之 fetch 取得 JSON 回應, 取代 axios(2026-09-07 起本套件不再依賴 axios)
  *
  * 與 axios 之語意對齊:
  *   - 網路錯誤或非 2xx: axios 會 reject, fetch 只在網路錯誤 reject, 故此處對 !res.ok 亦 reject, 統一為 { kind: 'request', status, message }
  *   - 回應非 JSON: axios 回原字串(呼叫端判 state 失敗), 此處 res.json() 失敗 reject { kind: 'parse', status, message }
  *   - 成功: resolve 解析後之 JSON(對應 axios 之 res.data)
+ * reject 之 message 只含例外名稱與代碼(如 'TypeError ECONNREFUSED'、'SyntaxError')或 'HTTP &lt;status>', 不含網址與回應本體(網址常帶權杖)
  * 注意: node 端 fetch(undici) 不讀 HTTP_PROXY / HTTPS_PROXY 環境變數(axios 會), 需走 proxy 之部署須自行以 opt.dispatcher 注入 undici Agent
  *
  * @param {String} url 輸入請求網址字串
@@ -66,7 +92,7 @@ async function fetchJson(url, opt = {}) {
         res = await fetch(url, opt)
     }
     catch (err) {
-        return Promise.reject({ kind: 'request', status: 0, message: String((err &amp;&amp; err.message) || err) })
+        return Promise.reject({ kind: 'request', status: 0, message: errDesc(err) })
     }
 
     //check status
@@ -79,7 +105,7 @@ async function fetchJson(url, opt = {}) {
         return await res.json()
     }
     catch (err) {
-        return Promise.reject({ kind: 'parse', status: res.status, message: String((err &amp;&amp; err.message) || err) })
+        return Promise.reject({ kind: 'parse', status: res.status, message: errDesc(err) })
     }
 
 }
@@ -100,7 +126,7 @@ export default fetchJson
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Thu Sep 24 2026 13:05:11 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Fri Oct 02 2026 20:53:56 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/src_js_legendFit.mjs.html

@@ -0,0 +1,225 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    
+    <meta charset="utf-8">
+    <title>src/js/legendFit.mjs - Documentation</title>
+    
+    
+    <script src="scripts/prettify/prettify.js"></script>
+    <script src="scripts/prettify/lang-css.js"></script>
+    <!--[if lt IE 9]>
+      <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
+    <![endif]-->
+    <link type="text/css" rel="stylesheet" href="styles/prettify.css">
+    <link type="text/css" rel="stylesheet" href="styles/jsdoc.css">
+    <script src="scripts/nav.js" defer></script>
+    
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+</head>
+<body>
+
+<input type="checkbox" id="nav-trigger" class="nav-trigger" />
+<label for="nav-trigger" class="navicon-button x">
+  <div class="navicon"></div>
+</label>
+
+<label for="nav-trigger" class="overlay"></label>
+
+<nav >
+    
+    
+    <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="WWebPerm.html">WWebPerm</a></li></ul><h3>Global</h3><ul><li><a href="global.html#createLegendMeasurer">createLegendMeasurer</a></li><li><a href="global.html#createLockSave">createLockSave</a></li><li><a href="global.html#decideLegendType">decideLegendType</a></li><li><a href="global.html#describeUpstream">describeUpstream</a></li><li><a href="global.html#fetchJson">fetchJson</a></li><li><a href="global.html#genLegend">genLegend</a></li><li><a href="global.html#maskQuery">maskQuery</a></li><li><a href="global.html#maskTok">maskTok</a></li><li><a href="global.html#maskUrl">maskUrl</a></li><li><a href="global.html#mergePickKeysOnly">mergePickKeysOnly</a></li><li><a href="global.html#reuseDeletedIds">reuseDeletedIds</a></li><li><a href="global.html#submitGuard">submitGuard</a></li><li><a href="global.html#wrapInjected">wrapInjected</a></li></ul>
+    
+</nav>
+
+<div id="main">
+    
+    <h1 class="page-title">src/js/legendFit.mjs</h1>
+    
+
+    
+
+
+
+    
+    <section>
+        <article>
+            <pre class="prettyprint source linenums"><code>//圖例排版: 供事件發生頻率圖(LayoutContentStaInfor)使用. 一般式(plain, 可換行)圖例放得下時維持現狀, 放不下(會壓到最上方刻度與繪圖區)時改捲動式(scroll, 單列+翻頁)
+//判定以「離屏量測實例」計算一般式圖例於指定寬度之實際排版, 為寬度與名稱集合之純函數:
+//  不讀可見圖之顯示列表(echarts resize 不 flush zrender, resize 後讀到的是上一個寬度之圖例, echarts.js:964-1012);
+//  不在可見圖上試排(類型改變即重建圖例模型, 捲動式頁次會歸零, 帶回頁次則每次滑動 800ms)
+//本檔無外部相依, 日後可原樣移入 w-echarts-vue(src/js/)
+
+
+//GRID_TOP: 繪圖區頂(px), 同 echarts 6.1.0 預設(GridModel.js:84 top:65), 於 option 明寫以防預設變動
+let GRID_TOP = 65
+
+//LEGEND_MAX_BOTTOM: 一般式圖例底緣上限(px). 最上方 y 軸刻度文字以繪圖區頂為中線(字高 12 → 半高 6), 再留白 2 → 65-6-2=57
+//  實測(echarts 6.1.0, 列距 21): 1 列底 18、2 列底 39(安全)、3 列底 60(擦到刻度)、4 列底 81(壓進繪圖區)
+let LEGEND_MAX_BOTTOM = GRID_TOP - 6 - 2
+
+
+/**
+ * 產生圖例設定(單一來源), genOpt 與執行期切換類型共用
+ *
+ * 切換類型(plain↔scroll)時 echarts 以新傳入之選項重建圖例模型(Global.js:322-344), 未帶之設定一律回到預設, 故每次都須帶齊
+ *
+ * @param {String} [type='plain'] 輸入圖例類型字串, 'plain'或'scroll', 預設'plain'
+ * @returns {Object} 回傳echarts之legend設定物件
+ */
+function genLegend(type = 'plain') {
+    let legend = {
+        show: true,
+        top: 0, //須明給: echarts 6 起 legend 預設由 top:0 改為 bottom, 不給會落到底部壓住 x 軸時間標籤; 切換類型時亦須帶(類型改變即重建圖例模型)
+        type,
+    }
+    if (type === 'scroll') {
+        legend.tooltip = { show: true } //捲動式僅出現於窄版, 單一項目可能寬於可視窗而被裁, 滑過顯示全名(靜止畫面不變)
+    }
+    return legend
+}
+
+
+/**
+ * 依量測結果決定圖例類型
+ *
+ * @param {Object|null} m 輸入量測結果物件{rows,bottom}, 量測失敗為null
+ * @returns {String} 回傳'plain'或'scroll', 量測失敗回'scroll'(單列, 不會重疊)
+ */
+function decideLegendType(m) {
+    if (!m || typeof m.bottom !== 'number') {
+        return 'scroll'
+    }
+    return m.bottom &lt;= LEGEND_MAX_BOTTOM ? 'plain' : 'scroll'
+}
+
+
+/**
+ * 建立離屏量測器: 以未掛入DOM之echarts實例, 計算一般式圖例於指定寬度之排版
+ *
+ * 量測實例僅含圖例、隱藏之座標軸與同名空系列, 故顯示列表中「文字等於系列名」之元素即圖例項目(不會與軸刻度文字撞名)
+ *
+ * @param {Object} echarts 輸入echarts命名空間物件, 須與圖表同一份(例如w-echarts-vue之iniEcharts()), 字型與版面規則方能一致
+ * @returns {Object} 回傳物件, 含measure(names,width,height)與dispose(); measure回傳{rows,bottom}(bottom為圖例底緣距圖表頂之px), 量不到回null
+ */
+function createLegendMeasurer(echarts) {
+    let el = null
+    let chart = null
+
+    let measure = (names, width, height = 300) => {
+
+        //check
+        if (!Array.isArray(names) || names.length === 0) {
+            return null
+        }
+        if (!(width > 0) || !(height > 0)) {
+            return null
+        }
+
+        //uniq
+        let uniq = []
+        for (let name of names) {
+            if (uniq.indexOf(name) &lt; 0) {
+                uniq.push(name)
+            }
+        }
+
+        try {
+
+            //chart, 首次建立後重用
+            if (!chart) {
+                el = document.createElement('div')
+                chart = echarts.init(el, null, { width, height })
+            }
+            else {
+                chart.resize({ width, height })
+            }
+
+            //setOption, 同步排版(notMerge整體置換)
+            chart.setOption({
+                animation: false,
+                legend: genLegend('plain'),
+                xAxis: { type: 'category', show: false, data: [] },
+                yAxis: { type: 'value', show: false },
+                series: uniq.map((name) => {
+                    return { name, type: 'line', data: [] }
+                }),
+            }, { notMerge: true })
+
+            //圖例項目: 顯示列表中文字等於系列名者, 以其頂緣去重計列數、取最大底緣
+            let tops = []
+            let bottom = 0
+            let n = 0
+            for (let e of chart.getZr().storage.getDisplayList(true)) {
+                let t = e.style &amp;&amp; e.style.text
+                if (!t || uniq.indexOf(t) &lt; 0 || typeof e.transformCoordToGlobal !== 'function') {
+                    continue
+                }
+                let r = e.getBoundingRect()
+                let top = e.transformCoordToGlobal(r.x, r.y)[1]
+                let btm = e.transformCoordToGlobal(r.x, r.y + r.height)[1]
+                let tr = Math.round(top)
+                if (tops.indexOf(tr) &lt; 0) {
+                    tops.push(tr)
+                }
+                bottom = Math.max(bottom, btm)
+                n++
+            }
+
+            //check, 找到之圖例文字數須等於系列名數, 否則視為量測失敗
+            if (n !== uniq.length) {
+                return null
+            }
+
+            return { rows: tops.length, bottom }
+        }
+        catch (err) {
+            return null
+        }
+    }
+
+    let dispose = () => {
+        if (chart) {
+            chart.dispose()
+        }
+        chart = null
+        el = null
+    }
+
+    return { measure, dispose }
+}
+
+
+export {
+    GRID_TOP,
+    LEGEND_MAX_BOTTOM,
+    genLegend,
+    decideLegendType,
+    createLegendMeasurer
+}
+</code></pre>
+        </article>
+    </section>
+
+
+
+
+    
+    
+</div>
+
+<br class="clear">
+
+<footer>
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Fri Oct 02 2026 20:53:56 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+</footer>
+
+<script>prettyPrint();</script>
+<script src="scripts/polyfill.js"></script>
+<script src="scripts/linenumber.js"></script>
+
+
+
+</body>
+</html>