w-web-perm 1.1.11 → 1.1.12

package/docs/global.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#createAuthorizeExec">createAuthorizeExec</a></li><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#eachOwn">eachOwn</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#getOwn">getOwn</a></li><li><a href="global.html#getRuleEnable">getRuleEnable</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#resolveShellWorker">resolveShellWorker</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#validateRowsBeforeWrite">validateRowsBeforeWrite</a></li><li><a href="global.html#wrapInjected">wrapInjected</a></li><li><a href="global.html#wrapOperOrm">wrapOperOrm</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#createAuthorizeExec">createAuthorizeExec</a></li><li><a href="global.html#createLegendMeasurer">createLegendMeasurer</a></li><li><a href="global.html#createLockSave">createLockSave</a></li><li><a href="global.html#cvKpToArr">cvKpToArr</a></li><li><a href="global.html#cvKpToObj">cvKpToObj</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#eachOwn">eachOwn</a></li><li><a href="global.html#fetchJson">fetchJson</a></li><li><a href="global.html#fmtLossyMsg">fmtLossyMsg</a></li><li><a href="global.html#genLegend">genLegend</a></li><li><a href="global.html#getKeyOrderLost">getKeyOrderLost</a></li><li><a href="global.html#getKpLossy">getKpLossy</a></li><li><a href="global.html#getKpWriteLost">getKpWriteLost</a></li><li><a href="global.html#getOwn">getOwn</a></li><li><a href="global.html#getRuleEnable">getRuleEnable</a></li><li><a href="global.html#isAuthMode">isAuthMode</a></li><li><a href="global.html#joinNames">joinNames</a></li><li><a href="global.html#keepKeyOrder">keepKeyOrder</a></li><li><a href="global.html#keyOrderOf">keyOrderOf</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#resolveShellWorker">resolveShellWorker</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#validateRowsBeforeWrite">validateRowsBeforeWrite</a></li><li><a href="global.html#wrapInjected">wrapInjected</a></li><li><a href="global.html#wrapOperOrm">wrapOperOrm</a></li></ul>
     
 </nav>
 
@@ -661,7 +661,7 @@ operatorId 可為操作者 id 或「操作者 id + 列識別」(只擋同一列
 
     
 
-    <h4 class="name" id="decideLegendType"><span class="type-signature"></span>decideLegendType<span class="signature">(m)</span><span class="type-signature"> &rarr; {String}</span></h4>
+    <h4 class="name" id="cvKpToArr"><span class="type-signature"></span>cvKpToArr<span class="signature">(kp)</span><span class="type-signature"> &rarr; {Array}</span></h4>
 
     
 
@@ -671,13 +671,18 @@ operatorId 可為操作者 id 或「操作者 id + 列識別」(只擋同一列
 <dl class="details">
     
     <dt class="tag-description">Description:</dt>
-    <dd class="tag-description"><ul class="dummy"><li><p>依量測結果決定圖例類型</p></li></ul></dd>
+    <dd class="tag-description"><ul class="dummy"><li><p>解碼授權資料(JSON5.parse(cgrups／cpemis／crules) 之結果)為 [{ name, … }] 陣列, 伺服端權限評估(src/plugins/mShare.mjs 之 getUserRules)與編輯對話框(經 cvKpToObj)共用之唯一解碼</p>
+<p>授權資料為使用者(含外部應用)寫入, 鍵為群組／權限／規則名, 一律以 eachOwn 依自有鍵走訪(規則帳本 R-OBJ-ITER-01):
+lodash each 對含非負整數 length 鍵之物件改走索引 0..length-1, 真實鍵被略過(權限靜默評估為 n), length 極大時空轉或耗盡記憶體(每次 getPerm／getPermUserInfor 皆走此路徑).
+eachOwn 對陣列依索引、對物件依自有鍵, 對字串與其他原始值不迭代.
+名稱: 物件形式(以名稱為鍵)以外層鍵為名, 值內 name 不得改名(編輯器依外層鍵顯示與存檔, 授權若依值內 name 則顯示與授權不一致; 規則帳本 R-AUTH-PATH-01);
+陣列形式([{ name, … }])元素之 name 即名稱(元素無 name 或非物件時名稱為索引數字, 不會對應任何群組／權限／規則名)</p></li></ul></dd>
     
 
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_js_legendFit.mjs.html">src/js/legendFit.mjs</a>, <a href="src_js_legendFit.mjs.html#line43">line 43</a>
+        <a href="src_js_cvKpToArr.mjs.html">src/js/cvKpToArr.mjs</a>, <a href="src_js_cvKpToArr.mjs.html#line24">line 24</a>
     </li></ul></dd>
     
 
@@ -722,6 +727,14 @@ operatorId 可為操作者 id 或「操作者 id + 列識別」(只擋同一列
 
 
 
+    <h5 class="h5-examples">Example</h5>
+    
+    <pre class="prettyprint"><code>console.log(cvKpToArr({ A: 'y', B: { mode: 'OR', isActive: 'y' } }))
+// => [{ name: 'A', isActive: 'y' }, { name: 'B', mode: 'OR', isActive: 'y' }]
+console.log(cvKpToArr([{ name: 'A', isActive: 'y' }]))
+// => [{ name: 'A', isActive: 'y' }]</code></pre>
+
+
 
 
     <h5 class="h5-parameters">Parameters:</h5>
@@ -749,7 +762,7 @@ operatorId 可為操作者 id 或「操作者 id + 列識別」(只擋同一列
 
         <tr>
             
-                <td class="name"><code>m</code></td>
+                <td class="name"><code>kp</code></td>
             
 
             <td class="type">
@@ -758,7 +771,7 @@ operatorId 可為操作者 id 或「操作者 id + 列識別」(只擋同一列
 <span class="param-type">Object</span>
 |
 
-<span class="param-type">null</span>
+<span class="param-type">Array</span>
 
 
 
@@ -769,7 +782,7 @@ operatorId 可為操作者 id 或「操作者 id + 列識別」(只擋同一列
 
             
 
-            <td class="description last"><p>輸入量測結果物件{rows,bottom}, 量測失敗為null</p></td>
+            <td class="description last"><p>輸入 JSON5.parse(cgrups／cpemis／crules) 之結果, 物件形式 { 名稱: 值 } 或陣列形式 [{ name, … }]</p></td>
         </tr>
 
     
@@ -795,7 +808,7 @@ operatorId 可為操作者 id 或「操作者 id + 列識別」(只擋同一列
 
         
 <div class="param-desc">
-    <p>回傳'plain'或'scroll', 量測失敗回'scroll'(單列, 不會重疊)</p>
+    <p>回傳 [{ name, … }] 陣列; 值為物件(iseobj)時展開其欄位(如 mode、isActive), 否則以值為 isActive</p>
 </div>
 
 
@@ -806,7 +819,7 @@ operatorId 可為操作者 id 或「操作者 id + 列識別」(只擋同一列
     </dt>
     <dd>
         
-<span class="param-type">String</span>
+<span class="param-type">Array</span>
 
 
 
@@ -822,7 +835,7 @@ operatorId 可為操作者 id 或「操作者 id + 列識別」(只擋同一列
 
     
 
-    <h4 class="name" id="describeUpstream"><span class="type-signature"></span>describeUpstream<span class="signature">(err)</span><span class="type-signature"> &rarr; {Object}</span></h4>
+    <h4 class="name" id="cvKpToObj"><span class="type-signature"></span>cvKpToObj<span class="signature">(kp, opt<span class="signature-attributes">opt</span>)</span><span class="type-signature"> &rarr; {Object}</span></h4>
 
     
 
@@ -832,17 +845,30 @@ operatorId 可為操作者 id 或「操作者 id + 列識別」(只擋同一列
 <dl class="details">
     
     <dt class="tag-description">Description:</dt>
-    <dd class="tag-description"><ul class="dummy"><li><p>描述上游失敗, 供寫入 log: 絕不含上游原文</p>
+    <dd class="tag-description"><ul class="dummy"><li><p>授權資料(JSON5.parse(cgrups／cpemis／crules) 之結果)統一為以名稱為鍵之物件形式, 供編輯對話框依名稱查值(getOwn／getRuleEnable)</p>
+<p>外部應用可直接寫入陣列形式 [{ &quot;name&quot;: &quot;A&quot;, &quot;isActive&quot;: &quot;y&quot; }], 伺服端 getUserRules 相容並授權(規則帳本 R-AUTH-DECODE-01);
+編輯對話框若依名稱為鍵查值會查不到陣列元素 → 顯示停用 → 管理者存檔即撤銷有效授權. 本函數與伺服端共用 cvKpToArr 之解碼(單一擁有者),
+並使「編輯器顯示啟用 ⇔ 該元素被伺服端採納(納入合併; 元素層級, 非最終權限樹)」.</p>
+<p>存檔後授權不變(複審 R3／R4, 規則帳本 R-AUTH-ORDER-01／R-AUTH-LOSSY-01): 解碼後之鍵序即伺服端序, 編輯器以 keepKeyOrder 保留原鍵序後寫出;
+物件形式無法無損表示之格(同名有效 OR／AND 並存; 有效 AND 名稱 ≥ 2 且第一個 AND 名稱因整數式鍵先排而易位)由 getKpLossy 判定,
+編輯器對之拒存並顯示固定訊息(authLossyBlocked), 不寫出. 其餘格(含兩個以上 AND 群組)在保序下存檔前後授權相等(unit-cvKpToObj PR-001／PR-001b／PR-003／PR-004 窮舉).</p>
 <ul>
-<li>reject 值(字串)或其 message 屬白名單 key → { upstream: key }</li>
-<li>其餘 → { upstreamType, upstreamName }: 型別(null / array / typeof)與名稱形狀之 Error.name(無則 '')</li>
-</ul></li></ul></dd>
+<li>opt.hasMode 為 false(預設, crules): 伺服端 mergeRules 以 kpRule[vv.name] = vv.isActive 收斂, 鍵經 JS 屬性鍵轉型(true → 'true'、['T1'] → 'T1'、非物件元素之索引 → '0'),
+同名後者覆蓋前者; 本函數以同一個指派式 o[r.name] = … 取得相同鍵與相同覆蓋順序(crules 之合併與順序無關, 無有損格).</li>
+<li>opt.hasMode 為 true(cgrups／cpemis): 伺服端 arrFinder 以 === 比對名稱(非字串名稱不授權), 且 isActive 為 'y' 而 mode 非 OR／AND 者不納入合併(不授權).
+故僅名稱為非空字串者保留; isActive 為 'y' 而 mode 不合法者改為 'n'(顯示停用——否則存檔會補預設 OR 而把「不授權」變成「授權」); 同名重複者, 各「有效啟用元素」(isActive 'y' 且 mode 合法)
+模式一致時合為一個啟用項(與伺服端逐項合併等價: 同模式同規則之重複不改變結果); 無有效啟用元素時為 'n'; 同名 AND 與 OR 並存者(物件形式無法無損表示, 由 getKpLossy 判定並拒存)
+此處僅取 AND 支作為顯示值. 鍵序: 有效啟用元素首次出現之序在前(伺服端 AND 合併之第一個 AND 項依此序), 其後為無有效元素之名稱(首次出現之序);
+整數式名稱(如 '1')受 JS 屬性序影響恆排前面, 該格由 getKpLossy 判定.</li>
+</ul>
+<p>物件形式: 值為物件者去掉值內 name(外層鍵為名, 規則帳本 R-AUTH-PATH-01: 否則關聯對話框存檔會把授權改指到值內 name 所指之項目); hasMode 時另把 isActive 'y' 而 mode 不合法者改為 'n'.
+無需修改時原樣回傳(同一參考, 既有行為不變). 陣列形式一律回傳無原型物件(原型鍵名〔<strong>proto</strong>、constructor、toString〕可為一般鍵).</p></li></ul></dd>
     
 
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="server_wrapInjected.mjs.html">server/wrapInjected.mjs</a>, <a href="server_wrapInjected.mjs.html#line45">line 45</a>
+        <a href="src_js_cvKpToObj.mjs.html">src/js/cvKpToObj.mjs</a>, <a href="src_js_cvKpToObj.mjs.html#line43">line 43</a>
     </li></ul></dd>
     
 
@@ -887,6 +913,15 @@ operatorId 可為操作者 id 或「操作者 id + 列識別」(只擋同一列
 
 
 
+    <h5 class="h5-examples">Example</h5>
+    
+    <pre class="prettyprint"><code>let kp = cvKpToObj([{ name: 'A', mode: 'OR', isActive: 'y' }], { hasMode: true })
+console.log(kp.A)
+// => { mode: 'OR', isActive: 'y' }
+console.log(cvKpToObj([{ name: 'A', isActive: 'y' }], { hasMode: true }).A)
+// => { isActive: 'n' }  (缺 mode: 伺服端不授權)</code></pre>
+
+
 
 
     <h5 class="h5-parameters">Parameters:</h5>
@@ -902,8 +937,12 @@ operatorId 可為操作者 id 或「操作者 id + 列識別」(只擋同一列
         <th>Type</th>
 
         
+        <th>Attributes</th>
+        
 
         
+        <th>Default</th>
+        
 
         <th class="last">Description</th>
     </tr>
@@ -914,13 +953,16 @@ operatorId 可為操作者 id 或「操作者 id + 列識別」(只擋同一列
 
         <tr>
             
-                <td class="name"><code>err</code></td>
+                <td class="name"><code>kp</code></td>
             
 
             <td class="type">
             
                 
-<span class="param-type">*</span>
+<span class="param-type">Object</span>
+|
+
+<span class="param-type">Array</span>
 
 
 
@@ -928,10 +970,132 @@ operatorId 可為操作者 id 或「操作者 id + 列識別」(只擋同一列
             </td>
 
             
+                <td class="attributes">
+                
+
+                
 
+                
+                </td>
             
 
-            <td class="description last"><p>輸入注入函數拋出或 reject 之值</p></td>
+            
+                <td class="default">
+                
+                </td>
+            
+
+            <td class="description last"><p>輸入 JSON5.parse(cgrups／cpemis／crules) 之結果</p></td>
+        </tr>
+
+    
+
+        <tr>
+            
+                <td class="name"><code>opt</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">Object</span>
+
+
+
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
+
+                
+
+                
+                </td>
+            
+
+            
+                <td class="default">
+                
+                    <code>{}</code>
+                
+                </td>
+            
+
+            <td class="description last"><p>輸入設定物件</p>
+                <h6>Properties</h6>
+                
+
+<table class="params">
+    <thead>
+    <tr>
+        
+        <th>Name</th>
+        
+
+        <th>Type</th>
+
+        
+        <th>Attributes</th>
+        
+
+        
+        <th>Default</th>
+        
+
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+
+    <tbody>
+    
+
+        <tr>
+            
+                <td class="name"><code>hasMode</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">Boolean</span>
+
+
+
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
+
+                
+
+                
+                </td>
+            
+
+            
+                <td class="default">
+                
+                    <code>false</code>
+                
+                </td>
+            
+
+            <td class="description last"><p>輸入是否為帶 mode 之資料(cgrups／cpemis 為 true, crules 為 false), 預設false</p></td>
+        </tr>
+
+    
+    </tbody>
+</table>
+
+            </td>
         </tr>
 
     
@@ -957,7 +1121,7 @@ operatorId 可為操作者 id 或「操作者 id + 列識別」(只擋同一列
 
         
 <div class="param-desc">
-    <p>回傳描述物件</p>
+    <p>回傳以名稱為鍵之物件; 輸入非物件且非陣列時原樣回傳</p>
 </div>
 
 
@@ -984,7 +1148,7 @@ operatorId 可為操作者 id 或「操作者 id + 列識別」(只擋同一列
 
     
 
-    <h4 class="name" id="eachOwn"><span class="type-signature"></span>eachOwn<span class="signature">(o, fn)</span><span class="type-signature"> &rarr; {Array|Object}</span></h4>
+    <h4 class="name" id="decideLegendType"><span class="type-signature"></span>decideLegendType<span class="signature">(m)</span><span class="type-signature"> &rarr; {String}</span></h4>
 
     
 
@@ -994,16 +1158,13 @@ operatorId 可為操作者 id 或「操作者 id + 列識別」(只擋同一列
 <dl class="details">
     
     <dt class="tag-description">Description:</dt>
-    <dd class="tag-description"><ul class="dummy"><li><p>迭代陣列或物件, 物件只依自有可列舉字串鍵(lodash each 對具非負整數 length 鍵之物件會改走索引 0..length-1, 真實鍵被略過且迭代次數即 length 之值)</p>
-<p>真陣列(Array.isArray, 不用依 Object.prototype.toString 之 isarr: 可被 Symbol.toStringTag 偽稱)依索引由小到大迭代, 空洞以 undefined 迭代, 長度於開始時取一次, 同 lodash each;
-一般物件依 Object.keys 之順序迭代, length 與其他鍵同為一般鍵, 成本只依實際鍵數, 與 length 之值無關;
-其餘(null、undefined、字串、數字、布林、函數、Symbol)不迭代, 原樣回傳(lodash each 對字串會逐字元迭代, 本函數不做)</p></li></ul></dd>
+    <dd class="tag-description"><ul class="dummy"><li><p>依量測結果決定圖例類型</p></li></ul></dd>
     
 
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_js_eachOwn.mjs.html">src/js/eachOwn.mjs</a>, <a href="src_js_eachOwn.mjs.html#line26">line 26</a>
+        <a href="src_js_legendFit.mjs.html">src/js/legendFit.mjs</a>, <a href="src_js_legendFit.mjs.html#line43">line 43</a>
     </li></ul></dd>
     
 
@@ -1048,14 +1209,1943 @@ operatorId 可為操作者 id 或「操作者 id + 列識別」(只擋同一列
 
 
 
-    <h5 class="h5-examples">Example</h5>
-    
-    <pre class="prettyprint"><code>let ks = []
-eachOwn({ id: 'a', length: 1, name: 'x' }, (v, k) => {
-    ks.push(k)
-})
-console.log(ks)
-// => ['id', 'length', 'name']</code></pre>
+
+
+    <h5 class="h5-parameters">Parameters:</h5>
+    
+
+<table class="params">
+    <thead>
+    <tr>
+        
+        <th>Name</th>
+        
+
+        <th>Type</th>
+
+        
+
+        
+
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+
+    <tbody>
+    
+
+        <tr>
+            
+                <td class="name"><code>m</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">Object</span>
+|
+
+<span class="param-type">null</span>
+
+
+
+            
+            </td>
+
+            
+
+            
+
+            <td class="description last"><p>輸入量測結果物件{rows,bottom}, 量測失敗為null</p></td>
+        </tr>
+
+    
+    </tbody>
+</table>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+<h5 class="h5-returns">Returns:</h5>
+
+        
+<div class="param-desc">
+    <p>回傳'plain'或'scroll', 量測失敗回'scroll'(單列, 不會重疊)</p>
+</div>
+
+
+
+<dl class="param-type">
+    <dt>
+        Type
+    </dt>
+    <dd>
+        
+<span class="param-type">String</span>
+
+
+
+    </dd>
+</dl>
+
+    
+
+
+
+        
+            
+
+    
+
+    <h4 class="name" id="describeUpstream"><span class="type-signature"></span>describeUpstream<span class="signature">(err)</span><span class="type-signature"> &rarr; {Object}</span></h4>
+
+    
+
+
+
+
+<dl class="details">
+    
+    <dt class="tag-description">Description:</dt>
+    <dd class="tag-description"><ul class="dummy"><li><p>描述上游失敗, 供寫入 log: 絕不含上游原文</p>
+<ul>
+<li>reject 值(字串)或其 message 屬白名單 key → { upstream: key }</li>
+<li>其餘 → { upstreamType, upstreamName }: 型別(null / array / typeof)與名稱形狀之 Error.name(無則 '')</li>
+</ul></li></ul></dd>
+    
+
+    
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="server_wrapInjected.mjs.html">server/wrapInjected.mjs</a>, <a href="server_wrapInjected.mjs.html#line45">line 45</a>
+    </li></ul></dd>
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+</dl>
+
+
+
+
+
+
+
+
+
+
+
+
+
+    <h5 class="h5-parameters">Parameters:</h5>
+    
+
+<table class="params">
+    <thead>
+    <tr>
+        
+        <th>Name</th>
+        
+
+        <th>Type</th>
+
+        
+
+        
+
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+
+    <tbody>
+    
+
+        <tr>
+            
+                <td class="name"><code>err</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">*</span>
+
+
+
+            
+            </td>
+
+            
+
+            
+
+            <td class="description last"><p>輸入注入函數拋出或 reject 之值</p></td>
+        </tr>
+
+    
+    </tbody>
+</table>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+<h5 class="h5-returns">Returns:</h5>
+
+        
+<div class="param-desc">
+    <p>回傳描述物件</p>
+</div>
+
+
+
+<dl class="param-type">
+    <dt>
+        Type
+    </dt>
+    <dd>
+        
+<span class="param-type">Object</span>
+
+
+
+    </dd>
+</dl>
+
+    
+
+
+
+        
+            
+
+    
+
+    <h4 class="name" id="eachOwn"><span class="type-signature"></span>eachOwn<span class="signature">(o, fn)</span><span class="type-signature"> &rarr; {Array|Object}</span></h4>
+
+    
+
+
+
+
+<dl class="details">
+    
+    <dt class="tag-description">Description:</dt>
+    <dd class="tag-description"><ul class="dummy"><li><p>迭代陣列或物件, 物件只依自有可列舉字串鍵(lodash each 對具非負整數 length 鍵之物件會改走索引 0..length-1, 真實鍵被略過且迭代次數即 length 之值)</p>
+<p>真陣列(Array.isArray, 不用依 Object.prototype.toString 之 isarr: 可被 Symbol.toStringTag 偽稱)依索引由小到大迭代, 空洞以 undefined 迭代, 長度於開始時取一次, 同 lodash each;
+一般物件依 Object.keys 之順序迭代, length 與其他鍵同為一般鍵, 成本只依實際鍵數, 與 length 之值無關;
+其餘(null、undefined、字串、數字、布林、函數、Symbol)不迭代, 原樣回傳(lodash each 對字串會逐字元迭代, 本函數不做)</p></li></ul></dd>
+    
+
+    
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="src_js_eachOwn.mjs.html">src/js/eachOwn.mjs</a>, <a href="src_js_eachOwn.mjs.html#line26">line 26</a>
+    </li></ul></dd>
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+</dl>
+
+
+
+
+
+
+
+
+
+
+
+    <h5 class="h5-examples">Example</h5>
+    
+    <pre class="prettyprint"><code>let ks = []
+eachOwn({ id: 'a', length: 1, name: 'x' }, (v, k) => {
+    ks.push(k)
+})
+console.log(ks)
+// => ['id', 'length', 'name']</code></pre>
+
+
+
+
+    <h5 class="h5-parameters">Parameters:</h5>
+    
+
+<table class="params">
+    <thead>
+    <tr>
+        
+        <th>Name</th>
+        
+
+        <th>Type</th>
+
+        
+
+        
+
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+
+    <tbody>
+    
+
+        <tr>
+            
+                <td class="name"><code>o</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">Array</span>
+|
+
+<span class="param-type">Object</span>
+
+
+
+            
+            </td>
+
+            
+
+            
+
+            <td class="description last"><p>輸入陣列或物件</p></td>
+        </tr>
+
+    
+
+        <tr>
+            
+                <td class="name"><code>fn</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">function</span>
+
+
+
+            
+            </td>
+
+            
+
+            
+
+            <td class="description last"><p>輸入回呼函數(值, 鍵或索引, 原輸入), 回傳false時跳出, 其他回傳值(含undefined、true)皆繼續</p></td>
+        </tr>
+
+    
+    </tbody>
+</table>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+<h5 class="h5-returns">Returns:</h5>
+
+        
+<div class="param-desc">
+    <p>回傳原輸入</p>
+</div>
+
+
+
+<dl class="param-type">
+    <dt>
+        Type
+    </dt>
+    <dd>
+        
+<span class="param-type">Array</span>
+|
+
+<span class="param-type">Object</span>
+
+
+
+    </dd>
+</dl>
+
+    
+
+
+
+        
+            
+
+    
+
+    <h4 class="name" id="fetchJson"><span class="type-signature type-signature-async">(async) </span>fetchJson<span class="signature">(url, opt<span class="signature-attributes">opt</span>)</span><span class="type-signature"> &rarr; {Promise}</span></h4>
+
+    
+
+
+
+
+<dl class="details">
+    
+    <dt class="tag-description">Description:</dt>
+    <dd class="tag-description"><ul class="dummy"><li><p>以瀏覽器與 node(18+) 內建之 fetch 取得 JSON 回應, 取代 axios(2026-09-07 起本套件不再依賴 axios)</p>
+<p>與 axios 之語意對齊:</p>
+<ul>
+<li>網路錯誤或非 2xx: axios 會 reject, fetch 只在網路錯誤 reject, 故此處對 !res.ok 亦 reject, 統一為 { kind: 'request', status, message }</li>
+<li>回應非 JSON: axios 回原字串(呼叫端判 state 失敗), 此處 res.json() 失敗 reject { kind: 'parse', status, message }</li>
+<li>成功: resolve 解析後之 JSON(對應 axios 之 res.data)
+reject 之 message 只含例外名稱與代碼(如 'TypeError ECONNREFUSED'、'SyntaxError')或 'HTTP <status>', 不含網址與回應本體(網址常帶權杖)
+注意: node 端 fetch(undici) 不讀 HTTP_PROXY / HTTPS_PROXY 環境變數(axios 會), 需走 proxy 之部署須自行以 opt.dispatcher 注入 undici Agent</li>
+</ul></li></ul></dd>
+    
+
+    
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="src_fetchJson.mjs.html">src/fetchJson.mjs</a>, <a href="src_fetchJson.mjs.html#line40">line 40</a>
+    </li></ul></dd>
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+</dl>
+
+
+
+
+
+
+
+
+
+
+
+
+
+    <h5 class="h5-parameters">Parameters:</h5>
+    
+
+<table class="params">
+    <thead>
+    <tr>
+        
+        <th>Name</th>
+        
+
+        <th>Type</th>
+
+        
+        <th>Attributes</th>
+        
+
+        
+        <th>Default</th>
+        
+
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+
+    <tbody>
+    
+
+        <tr>
+            
+                <td class="name"><code>url</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">String</span>
+
+
+
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+
+                
+
+                
+                </td>
+            
+
+            
+                <td class="default">
+                
+                </td>
+            
+
+            <td class="description last"><p>輸入請求網址字串</p></td>
+        </tr>
+
+    
+
+        <tr>
+            
+                <td class="name"><code>opt</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">Object</span>
+
+
+
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
+
+                
+
+                
+                </td>
+            
+
+            
+                <td class="default">
+                
+                    <code>{}</code>
+                
+                </td>
+            
+
+            <td class="description last"><p>輸入 fetch 選項物件(method / headers / body / signal / dispatcher 等原樣傳給 fetch), 預設 {}</p></td>
+        </tr>
+
+    
+    </tbody>
+</table>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+<h5 class="h5-returns">Returns:</h5>
+
+        
+<div class="param-desc">
+    <p>回傳 Promise, resolve 為 JSON 物件, reject 為 { kind: 'request'|'parse', status, message }</p>
+</div>
+
+
+
+<dl class="param-type">
+    <dt>
+        Type
+    </dt>
+    <dd>
+        
+<span class="param-type">Promise</span>
+
+
+
+    </dd>
+</dl>
+
+    
+
+
+
+        
+            
+
+    
+
+    <h4 class="name" id="fmtLossyMsg"><span class="type-signature"></span>fmtLossyMsg<span class="signature">(tpl, names)</span><span class="type-signature"> &rarr; {String}</span></h4>
+
+    
+
+
+
+
+<dl class="details">
+    
+    <dt class="tag-description">Description:</dt>
+    <dd class="tag-description"><ul class="dummy"><li><p>把拒存訊息範本(authLossyBlocked)之 {names} 代入受影響之名稱</p>
+<p>名稱為使用者／外部應用寫入之資料, 可含 $&amp;、$$、$' 等字樣; 以 split／join 代入(不用 String.replace, 其替換字串中的 $ 樣式會被展開), 名稱原樣顯示.</p></li></ul></dd>
+    
+
+    
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="src_js_fmtLossyMsg.mjs.html">src/js/fmtLossyMsg.mjs</a>, <a href="src_js_fmtLossyMsg.mjs.html#line18">line 18</a>
+    </li></ul></dd>
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+</dl>
+
+
+
+
+
+
+
+
+
+
+
+    <h5 class="h5-examples">Example</h5>
+    
+    <pre class="prettyprint"><code>console.log(fmtLossyMsg('Not saved: {names}', ['a', '$&amp;']))
+// => 'Not saved: a, $&amp;'</code></pre>
+
+
+
+
+    <h5 class="h5-parameters">Parameters:</h5>
+    
+
+<table class="params">
+    <thead>
+    <tr>
+        
+        <th>Name</th>
+        
+
+        <th>Type</th>
+
+        
+
+        
+
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+
+    <tbody>
+    
+
+        <tr>
+            
+                <td class="name"><code>tpl</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">String</span>
+
+
+
+            
+            </td>
+
+            
+
+            
+
+            <td class="description last"><p>輸入訊息範本, 含 {names}</p></td>
+        </tr>
+
+    
+
+        <tr>
+            
+                <td class="name"><code>names</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">Array</span>
+
+
+
+            
+            </td>
+
+            
+
+            
+
+            <td class="description last"><p>輸入受影響之名稱陣列(至多列出 5 個, 超過加省略號, 見 joinNames)</p></td>
+        </tr>
+
+    
+    </tbody>
+</table>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+<h5 class="h5-returns">Returns:</h5>
+
+        
+<div class="param-desc">
+    <p>回傳代入後之訊息</p>
+</div>
+
+
+
+<dl class="param-type">
+    <dt>
+        Type
+    </dt>
+    <dd>
+        
+<span class="param-type">String</span>
+
+
+
+    </dd>
+</dl>
+
+    
+
+
+
+        
+            
+
+    
+
+    <h4 class="name" id="genLegend"><span class="type-signature"></span>genLegend<span class="signature">(type<span class="signature-attributes">opt</span>)</span><span class="type-signature"> &rarr; {Object}</span></h4>
+
+    
+
+
+
+
+<dl class="details">
+    
+    <dt class="tag-description">Description:</dt>
+    <dd class="tag-description"><ul class="dummy"><li><p>產生圖例設定(單一來源), genOpt 與執行期切換類型共用</p>
+<p>切換類型(plain↔scroll)時 echarts 以新傳入之選項重建圖例模型(Global.js:322-344), 未帶之設定一律回到預設, 故每次都須帶齊</p></li></ul></dd>
+    
+
+    
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="src_js_legendFit.mjs.html">src/js/legendFit.mjs</a>, <a href="src_js_legendFit.mjs.html#line24">line 24</a>
+    </li></ul></dd>
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+</dl>
+
+
+
+
+
+
+
+
+
+
+
+
+
+    <h5 class="h5-parameters">Parameters:</h5>
+    
+
+<table class="params">
+    <thead>
+    <tr>
+        
+        <th>Name</th>
+        
+
+        <th>Type</th>
+
+        
+        <th>Attributes</th>
+        
+
+        
+        <th>Default</th>
+        
+
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+
+    <tbody>
+    
+
+        <tr>
+            
+                <td class="name"><code>type</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">String</span>
+
+
+
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
+
+                
+
+                
+                </td>
+            
+
+            
+                <td class="default">
+                
+                    <code>'plain'</code>
+                
+                </td>
+            
+
+            <td class="description last"><p>輸入圖例類型字串, 'plain'或'scroll', 預設'plain'</p></td>
+        </tr>
+
+    
+    </tbody>
+</table>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+<h5 class="h5-returns">Returns:</h5>
+
+        
+<div class="param-desc">
+    <p>回傳echarts之legend設定物件</p>
+</div>
+
+
+
+<dl class="param-type">
+    <dt>
+        Type
+    </dt>
+    <dd>
+        
+<span class="param-type">Object</span>
+
+
+
+    </dd>
+</dl>
+
+    
+
+
+
+        
+            
+
+    
+
+    <h4 class="name" id="getKeyOrderLost"><span class="type-signature"></span>getKeyOrderLost<span class="signature">(kpOut, seq)</span><span class="type-signature"> &rarr; {Array}</span></h4>
+
+    
+
+
+
+
+<dl class="details">
+    
+    <dt class="tag-description">Description:</dt>
+    <dd class="tag-description"><ul class="dummy"><li><p>判定欲寫出之物件 kpOut 的鍵序(JS 屬性序: 整數式鍵先排、遞增)是否與預期序 seq 不同, 使有效 AND 名稱之相對順序易位, 回傳受影響之 AND 名稱</p>
+<p>編輯器以 keepKeyOrder 讓「原字串已有之名稱維持原序、新增者附加於後」, 但 JS 物件的整數式鍵(如群組名 '1')恆排在前面,
+新增(或新啟用)的整數式 AND 名稱會排到既有 AND 名稱之前, 使伺服端 mergeRules 在沒有有效 OR 項時的「第一個 AND 項」易位而改變授權(規則帳本 R-AUTH-LOSSY-01);
+此為編輯器無法在不改變授權下寫出的格, 須拒存並顯示固定訊息(authLossyBlocked).
+只看有效 AND 項(isActive 'y' 且 mode 'AND')之「第一個」是否易位: 欲寫出之物件只含現存之群組／權限(編輯器列出之列, 無查無實體之名稱被丟棄的問題),
+mergeRules 的結果對 AND 項順序的依賴只經第一個 AND 項(其餘 AND 項彼此可交換), 故第一個不變則其後之相對順序改變不影響授權, 不需拒存(輸入側 getKpLossy 因幻影名稱須比整個相對順序, 見其說明).</p></li></ul></dd>
+    
+
+    
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="src_js_getKeyOrderLost.mjs.html">src/js/getKeyOrderLost.mjs</a>, <a href="src_js_getKeyOrderLost.mjs.html#line24">line 24</a>
+    </li></ul></dd>
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+</dl>
+
+
+
+
+
+
+
+
+
+
+
+    <h5 class="h5-examples">Example</h5>
+    
+    <pre class="prettyprint"><code>let seq = ['A', '1']
+let kpOut = { '1': { mode: 'AND', isActive: 'y' }, A: { mode: 'AND', isActive: 'y' } } //JS 把 '1' 排到 A 前面
+console.log(getKeyOrderLost(kpOut, seq))
+// => ['A', '1']</code></pre>
+
+
+
+
+    <h5 class="h5-parameters">Parameters:</h5>
+    
+
+<table class="params">
+    <thead>
+    <tr>
+        
+        <th>Name</th>
+        
+
+        <th>Type</th>
+
+        
+
+        
+
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+
+    <tbody>
+    
+
+        <tr>
+            
+                <td class="name"><code>kpOut</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">Object</span>
+
+
+
+            
+            </td>
+
+            
+
+            
+
+            <td class="description last"><p>輸入欲寫出之物件 { 名稱: { mode, isActive } }</p></td>
+        </tr>
+
+    
+
+        <tr>
+            
+                <td class="name"><code>seq</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">Array</span>
+
+
+
+            
+            </td>
+
+            
+
+            
+
+            <td class="description last"><p>輸入預期的名稱順序(keepKeyOrder 之 keyOrderOf 結果)</p></td>
+        </tr>
+
+    
+    </tbody>
+</table>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+<h5 class="h5-returns">Returns:</h5>
+
+        
+<div class="param-desc">
+    <p>回傳受影響之 AND 名稱(依預期序), 無易位回傳空陣列; 不改動輸入</p>
+</div>
+
+
+
+<dl class="param-type">
+    <dt>
+        Type
+    </dt>
+    <dd>
+        
+<span class="param-type">Array</span>
+
+
+
+    </dd>
+</dl>
+
+    
+
+
+
+        
+            
+
+    
+
+    <h4 class="name" id="getKpLossy"><span class="type-signature"></span>getKpLossy<span class="signature">(kp)</span><span class="type-signature"> &rarr; {Array}</span></h4>
+
+    
+
+
+
+
+<dl class="details">
+    
+    <dt class="tag-description">Description:</dt>
+    <dd class="tag-description"><ul class="dummy"><li><p>判定帶 mode 之授權資料(JSON5.parse(cgrups／cpemis) 之結果)是否含「編輯器無法以物件形式無損表示」之格, 回傳受影響之名稱</p>
+<p>編輯器存檔一律寫物件形式 { 名稱: { mode, isActive } }(每個名稱只有一個 mode、鍵序為 JS 屬性序); 外部應用可直接寫入陣列形式, 其下列兩格物件形式無法無損表示,
+硬寫即靜默改變授權(規則帳本 R-AUTH-LOSSY-01; 複審 R4), 編輯器須拒存並顯示固定訊息(authLossyBlocked), 庫內字串不動:</p>
+<ol>
+<li>同名有效啟用元素同時為 OR 與 AND: 物件形式只能留一個 mode. 保留 AND 支者, 另有其他 AND 名稱時 AND 合併之起始值由 OR 聯集改為第一個 AND 項而增權(外審 sol 第三輪#2);
+保留 OR 支或停用者亦會減權或增權, 一律視為有損(此格若整組只有該名稱則碰巧相等, 仍從嚴判定).</li>
+<li>有效 AND 名稱 ≥ 2 且其相對順序於伺服端序(陣列元素首次有效出現之序)與物件鍵序(整數式鍵先、遞增)不同:
+mergeRules 在沒有有效 OR 項時以第一個 AND 項為 AND 合併之起始, 結果因之而異; 整數式名稱(如群組名 '1')在物件形式中恆排在前面, 陣列形式之順序無法保留.
+須比整個相對順序而非只比第一個: 查無實體(群組／權限表內沒有)之名稱會被伺服端 arrFinder 丟棄、編輯器存檔時亦不寫出, 丟棄後實際的第一個 AND 項可能是其後任一名稱(外審 sol#1／minimax#1).
+有效啟用元素: 名稱為非空字串、isActive 為 'y'、mode 為 OR／AND(同伺服端 arrFinder 以 === 比對名稱、mergeRules 跳過非 OR／AND 者).
+物件形式(編輯器自己寫出之形式、鍵唯一、鍵序即伺服端序)與其他輸入恆可無損表示, 回傳空陣列. 以原函式 getUserRules 為真理之窮舉驗證見 unit-cvKpToObj PR-001／PR-001b／PR-003
+(凡存檔前後授權不相等者皆被本函數判定, 漏判 0; 本函數為保守側, 某些整體授權碰巧相等之格仍判有損).</li>
+</ol></li></ul></dd>
+    
+
+    
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="src_js_getKpLossy.mjs.html">src/js/getKpLossy.mjs</a>, <a href="src_js_getKpLossy.mjs.html#line31">line 31</a>
+    </li></ul></dd>
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+</dl>
+
+
+
+
+
+
+
+
+
+
+
+    <h5 class="h5-examples">Example</h5>
+    
+    <pre class="prettyprint"><code>console.log(getKpLossy([{ name: 'G1', mode: 'OR', isActive: 'y' }, { name: 'G1', mode: 'AND', isActive: 'y' }]))
+// => ['G1']
+console.log(getKpLossy({ G1: { mode: 'OR', isActive: 'y' } }))
+// => []</code></pre>
+
+
+
+
+    <h5 class="h5-parameters">Parameters:</h5>
+    
+
+<table class="params">
+    <thead>
+    <tr>
+        
+        <th>Name</th>
+        
+
+        <th>Type</th>
+
+        
+
+        
+
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+
+    <tbody>
+    
+
+        <tr>
+            
+                <td class="name"><code>kp</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">Object</span>
+|
+
+<span class="param-type">Array</span>
+
+
+
+            
+            </td>
+
+            
+
+            
+
+            <td class="description last"><p>輸入 JSON5.parse(cgrups／cpemis) 之結果</p></td>
+        </tr>
+
+    
+    </tbody>
+</table>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+<h5 class="h5-returns">Returns:</h5>
+
+        
+<div class="param-desc">
+    <p>回傳受影響之名稱陣列(不重複), 無損回傳空陣列; 不改動輸入</p>
+</div>
+
+
+
+<dl class="param-type">
+    <dt>
+        Type
+    </dt>
+    <dd>
+        
+<span class="param-type">Array</span>
+
+
+
+    </dd>
+</dl>
+
+    
+
+
+
+        
+            
+
+    
+
+    <h4 class="name" id="getKpWriteLost"><span class="type-signature"></span>getKpWriteLost<span class="signature">(kpRef, kpNew)</span><span class="type-signature"> &rarr; {Array}</span></h4>
+
+    
+
+
+
+
+<dl class="details">
+    
+    <dt class="tag-description">Description:</dt>
+    <dd class="tag-description"><ul class="dummy"><li><p>判定欲寫出之授權物件 kpNew 以 keepKeyOrder(kpRef, kpNew) 寫出時, 鍵序是否被 JS 屬性序(整數式鍵恆先排)改變而使第一個有效 AND 項易位, 回傳受影響之 AND 名稱</p>
+<p>四個帶 mode 的編輯器(VeCgrups／VeCpemis／VeGrupBlngUsers／VePemiBlngGrups)寫出前共用此函數(規則帳本 R-AUTH-LOSSY-01 ③): 預期序一律由「參考(解碼後之原資料)」與「欲寫出之物件」
+在此函數內導出, 呼叫端不得自行傳入預期序——外審 minimax 第二輪指出關聯對話框曾以「已套用 JS 屬性序之物件序」當預期序, 守門恆等而形同虛設.
+kpRef 須為解碼後之原授權資料(cvKpToObj 之結果, 鍵序即伺服端序); kpNew 為欲寫出之物件(名稱 → { mode, isActive }).</p></li></ul></dd>
+    
+
+    
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="src_js_getKpWriteLost.mjs.html">src/js/getKpWriteLost.mjs</a>, <a href="src_js_getKpWriteLost.mjs.html#line23">line 23</a>
+    </li></ul></dd>
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+</dl>
+
+
+
+
+
+
+
+
+
+
+
+    <h5 class="h5-examples">Example</h5>
+    
+    <pre class="prettyprint"><code>let kpRef = { A: { mode: 'AND', isActive: 'y' } }
+let kpNew = { A: { mode: 'AND', isActive: 'y' }, 1: { mode: 'AND', isActive: 'y' } } //新啟用整數式名稱 1 為 AND
+console.log(getKpWriteLost(kpRef, kpNew))
+// => ['A', '1']</code></pre>
+
+
+
+
+    <h5 class="h5-parameters">Parameters:</h5>
+    
+
+<table class="params">
+    <thead>
+    <tr>
+        
+        <th>Name</th>
+        
+
+        <th>Type</th>
+
+        
+
+        
+
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+
+    <tbody>
+    
+
+        <tr>
+            
+                <td class="name"><code>kpRef</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">Object</span>
+
+
+
+            
+            </td>
+
+            
+
+            
+
+            <td class="description last"><p>輸入解碼後之原授權資料</p></td>
+        </tr>
+
+    
+
+        <tr>
+            
+                <td class="name"><code>kpNew</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">Object</span>
+
+
+
+            
+            </td>
+
+            
+
+            
+
+            <td class="description last"><p>輸入欲寫出之物件</p></td>
+        </tr>
+
+    
+    </tbody>
+</table>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+<h5 class="h5-returns">Returns:</h5>
+
+        
+<div class="param-desc">
+    <p>回傳受影響之 AND 名稱(依預期序), 無易位回傳空陣列; 不改動輸入</p>
+</div>
+
+
+
+<dl class="param-type">
+    <dt>
+        Type
+    </dt>
+    <dd>
+        
+<span class="param-type">Array</span>
+
+
+
+    </dd>
+</dl>
+
+    
+
+
+
+        
+            
+
+    
+
+    <h4 class="name" id="getOwn"><span class="type-signature"></span>getOwn<span class="signature">(o, k, def<span class="signature-attributes">opt</span>)</span><span class="type-signature"> &rarr; {*}</span></h4>
+
+    
+
+
+
+
+<dl class="details">
+    
+    <dt class="tag-description">Description:</dt>
+    <dd class="tag-description"><ul class="dummy"><li><p>取物件之自有屬性值, 不解析路徑、不取繼承屬性(lodash get 會把含 . 或 [ 之字串鍵解析為路徑, 並可取到繼承屬性)</p>
+<p>鍵為使用端資料(標的 id、群組／權限／規則名稱、列 id)時一律用本函數: 只授權 A 時, lodash get(kp, 'A.0') 經字串索引得 'y'、'A.length' 得 1、
+'toString' 得繼承函數; 本函數對這些鍵回預設值. 自有屬性存在時回其值(含 0、''、null、false、undefined), 精確鍵(整串即鍵名, 如 'A.0')照常.
+輸入非物件(null、undefined、字串、數字、布林)一律回預設值.</p></li></ul></dd>
+    
+
+    
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="src_js_getOwn.mjs.html">src/js/getOwn.mjs</a>, <a href="src_js_getOwn.mjs.html#line30">line 30</a>
+    </li></ul></dd>
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+</dl>
+
+
+
+
+
+
+
+
+
+
+
+    <h5 class="h5-examples">Example</h5>
+    
+    <pre class="prettyprint"><code>let kp = { A: 'y', 'B.0': 'y' }
+console.log(getOwn(kp, 'A', 'n'))
+// => 'y'
+console.log(getOwn(kp, 'A.0', 'n'))
+// => 'n'
+console.log(getOwn(kp, 'B.0', 'n'))
+// => 'y'
+console.log(getOwn(kp, 'toString', 'n'))
+// => 'n'</code></pre>
+
+
+
+
+    <h5 class="h5-parameters">Parameters:</h5>
+    
+
+<table class="params">
+    <thead>
+    <tr>
+        
+        <th>Name</th>
+        
+
+        <th>Type</th>
+
+        
+        <th>Attributes</th>
+        
+
+        
+
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+
+    <tbody>
+    
+
+        <tr>
+            
+                <td class="name"><code>o</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">Object</span>
+
+
+
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+
+                
+
+                
+                </td>
+            
+
+            
+
+            <td class="description last"><p>輸入物件(可為一般物件或無原型物件)</p></td>
+        </tr>
+
+    
+
+        <tr>
+            
+                <td class="name"><code>k</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">String</span>
+|
+
+<span class="param-type">Number</span>
+
+
+
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+
+                
+
+                
+                </td>
+            
+
+            
+
+            <td class="description last"><p>輸入鍵(整串視為鍵名)</p></td>
+        </tr>
+
+    
+
+        <tr>
+            
+                <td class="name"><code>def</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">*</span>
+
+
+
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
+
+                
+
+                
+                </td>
+            
+
+            
+
+            <td class="description last"><p>輸入無自有屬性時回傳之預設值, 預設undefined</p></td>
+        </tr>
+
+    
+    </tbody>
+</table>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+<h5 class="h5-returns">Returns:</h5>
+
+        
+<div class="param-desc">
+    <p>回傳自有屬性值或預設值</p>
+</div>
+
+
+
+<dl class="param-type">
+    <dt>
+        Type
+    </dt>
+    <dd>
+        
+<span class="param-type">*</span>
+
+
+
+    </dd>
+</dl>
+
+    
+
+
+
+        
+            
+
+    
+
+    <h4 class="name" id="getRuleEnable"><span class="type-signature"></span>getRuleEnable<span class="signature">(kp, name)</span><span class="type-signature"> &rarr; {String}</span></h4>
+
+    
+
+
+
+
+<dl class="details">
+    
+    <dt class="tag-description">Description:</dt>
+    <dd class="tag-description"><ul class="dummy"><li><p>取得規則(標的)於 JSON5 解析結果(crules)中之啟用狀態</p>
+<p>與 getUserRules 之解碼一致: 名稱為資料不是路徑(僅以自有屬性精確查值, 規則帳本 R-AUTH-PATH-01),
+值為物件(如 { isActive: 'y' })時取其 isActive, 其餘取值本身; 僅 'y' 為啟用, 其餘(含缺漏、非字串、物件值無 isActive)皆為 'n'.
+使編輯對話框顯示之狀態與實際授權結果一致, 存檔時不致把有效授權靜默改成 n</p></li></ul></dd>
+    
+
+    
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="src_js_getRuleEnable.mjs.html">src/js/getRuleEnable.mjs</a>, <a href="src_js_getRuleEnable.mjs.html#line15">line 15</a>
+    </li></ul></dd>
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+</dl>
+
+
+
+
+
+
+
+
+
 
 
 
@@ -1085,15 +3175,12 @@ console.log(ks)
 
         <tr>
             
-                <td class="name"><code>o</code></td>
+                <td class="name"><code>kp</code></td>
             
 
             <td class="type">
             
                 
-<span class="param-type">Array</span>
-|
-
 <span class="param-type">Object</span>
 
 
@@ -1105,20 +3192,20 @@ console.log(ks)
 
             
 
-            <td class="description last"><p>輸入陣列或物件</p></td>
+            <td class="description last"><p>輸入 JSON5.parse(crules) 之結果, 鍵為規則(標的)名稱</p></td>
         </tr>
 
     
 
         <tr>
             
-                <td class="name"><code>fn</code></td>
+                <td class="name"><code>name</code></td>
             
 
             <td class="type">
             
                 
-<span class="param-type">function</span>
+<span class="param-type">String</span>
 
 
 
@@ -1129,7 +3216,7 @@ console.log(ks)
 
             
 
-            <td class="description last"><p>輸入回呼函數(值, 鍵或索引, 原輸入), 回傳false時跳出, 其他回傳值(含undefined、true)皆繼續</p></td>
+            <td class="description last"><p>輸入規則(標的)名稱</p></td>
         </tr>
 
     
@@ -1155,7 +3242,7 @@ console.log(ks)
 
         
 <div class="param-desc">
-    <p>回傳原輸入</p>
+    <p>回傳 'y' 或 'n'</p>
 </div>
 
 
@@ -1166,10 +3253,7 @@ console.log(ks)
     </dt>
     <dd>
         
-<span class="param-type">Array</span>
-|
-
-<span class="param-type">Object</span>
+<span class="param-type">String</span>
 
 
 
@@ -1185,7 +3269,7 @@ console.log(ks)
 
     
 
-    <h4 class="name" id="fetchJson"><span class="type-signature type-signature-async">(async) </span>fetchJson<span class="signature">(url, opt<span class="signature-attributes">opt</span>)</span><span class="type-signature"> &rarr; {Promise}</span></h4>
+    <h4 class="name" id="isAuthMode"><span class="type-signature"></span>isAuthMode<span class="signature">(m)</span><span class="type-signature"> &rarr; {Boolean}</span></h4>
 
     
 
@@ -1195,21 +3279,15 @@ console.log(ks)
 <dl class="details">
     
     <dt class="tag-description">Description:</dt>
-    <dd class="tag-description"><ul class="dummy"><li><p>以瀏覽器與 node(18+) 內建之 fetch 取得 JSON 回應, 取代 axios(2026-09-07 起本套件不再依賴 axios)</p>
-<p>與 axios 之語意對齊:</p>
-<ul>
-<li>網路錯誤或非 2xx: axios 會 reject, fetch 只在網路錯誤 reject, 故此處對 !res.ok 亦 reject, 統一為 { kind: 'request', status, message }</li>
-<li>回應非 JSON: axios 回原字串(呼叫端判 state 失敗), 此處 res.json() 失敗 reject { kind: 'parse', status, message }</li>
-<li>成功: resolve 解析後之 JSON(對應 axios 之 res.data)
-reject 之 message 只含例外名稱與代碼(如 'TypeError ECONNREFUSED'、'SyntaxError')或 'HTTP <status>', 不含網址與回應本體(網址常帶權杖)
-注意: node 端 fetch(undici) 不讀 HTTP_PROXY / HTTPS_PROXY 環境變數(axios 會), 需走 proxy 之部署須自行以 opt.dispatcher 注入 undici Agent</li>
-</ul></li></ul></dd>
+    <dd class="tag-description"><ul class="dummy"><li><p>判斷是否為合法合併模式 'OR' 或 'AND'</p>
+<p>與伺服端 src/plugins/mShare.mjs 之 mergeRules 一致: mode 非 OR／AND 之群組／權限不納入合併(不授權).
+編輯器解碼(cvKpToObj)與無損表示判定(getKpLossy)共用, 單一擁有者.</p></li></ul></dd>
     
 
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_fetchJson.mjs.html">src/fetchJson.mjs</a>, <a href="src_fetchJson.mjs.html#line40">line 40</a>
+        <a href="src_js_isAuthMode.mjs.html">src/js/isAuthMode.mjs</a>, <a href="src_js_isAuthMode.mjs.html#line15">line 15</a>
     </li></ul></dd>
     
 
@@ -1254,6 +3332,12 @@ reject 之 message 只含例外名稱與代碼(如 'TypeError ECONNREFUSED'、'S
 
 
 
+    <h5 class="h5-examples">Example</h5>
+    
+    <pre class="prettyprint"><code>console.log(isAuthMode('OR'), isAuthMode('or'), isAuthMode(undefined))
+// => true false false</code></pre>
+
+
 
 
     <h5 class="h5-parameters">Parameters:</h5>
@@ -1269,12 +3353,8 @@ reject 之 message 只含例外名稱與代碼(如 'TypeError ECONNREFUSED'、'S
         <th>Type</th>
 
         
-        <th>Attributes</th>
-        
 
         
-        <th>Default</th>
-        
 
         <th class="last">Description</th>
     </tr>
@@ -1285,49 +3365,13 @@ reject 之 message 只含例外名稱與代碼(如 'TypeError ECONNREFUSED'、'S
 
         <tr>
             
-                <td class="name"><code>url</code></td>
-            
-
-            <td class="type">
-            
-                
-<span class="param-type">String</span>
-
-
-
-            
-            </td>
-
-            
-                <td class="attributes">
-                
-
-                
-
-                
-                </td>
-            
-
-            
-                <td class="default">
-                
-                </td>
-            
-
-            <td class="description last"><p>輸入請求網址字串</p></td>
-        </tr>
-
-    
-
-        <tr>
-            
-                <td class="name"><code>opt</code></td>
+                <td class="name"><code>m</code></td>
             
 
             <td class="type">
             
                 
-<span class="param-type">Object</span>
+<span class="param-type">*</span>
 
 
 
@@ -1335,26 +3379,10 @@ reject 之 message 只含例外名稱與代碼(如 'TypeError ECONNREFUSED'、'S
             </td>
 
             
-                <td class="attributes">
-                
-                    &lt;optional><br>
-                
-
-                
-
-                
-                </td>
-            
 
             
-                <td class="default">
-                
-                    <code>{}</code>
-                
-                </td>
-            
 
-            <td class="description last"><p>輸入 fetch 選項物件(method / headers / body / signal / dispatcher 等原樣傳給 fetch), 預設 {}</p></td>
+            <td class="description last"><p>輸入 mode</p></td>
         </tr>
 
     
@@ -1380,7 +3408,7 @@ reject 之 message 只含例外名稱與代碼(如 'TypeError ECONNREFUSED'、'S
 
         
 <div class="param-desc">
-    <p>回傳 Promise, resolve 為 JSON 物件, reject 為 { kind: 'request'|'parse', status, message }</p>
+    <p>回傳是否為 'OR' 或 'AND'</p>
 </div>
 
 
@@ -1391,7 +3419,7 @@ reject 之 message 只含例外名稱與代碼(如 'TypeError ECONNREFUSED'、'S
     </dt>
     <dd>
         
-<span class="param-type">Promise</span>
+<span class="param-type">Boolean</span>
 
 
 
@@ -1407,7 +3435,7 @@ reject 之 message 只含例外名稱與代碼(如 'TypeError ECONNREFUSED'、'S
 
     
 
-    <h4 class="name" id="genLegend"><span class="type-signature"></span>genLegend<span class="signature">(type<span class="signature-attributes">opt</span>)</span><span class="type-signature"> &rarr; {Object}</span></h4>
+    <h4 class="name" id="joinNames"><span class="type-signature"></span>joinNames<span class="signature">(names, max<span class="signature-attributes">opt</span>)</span><span class="type-signature"> &rarr; {String}</span></h4>
 
     
 
@@ -1417,14 +3445,13 @@ reject 之 message 只含例外名稱與代碼(如 'TypeError ECONNREFUSED'、'S
 <dl class="details">
     
     <dt class="tag-description">Description:</dt>
-    <dd class="tag-description"><ul class="dummy"><li><p>產生圖例設定(單一來源), genOpt 與執行期切換類型共用</p>
-<p>切換類型(plain↔scroll)時 echarts 以新傳入之選項重建圖例模型(Global.js:322-344), 未帶之設定一律回到預設, 故每次都須帶齊</p></li></ul></dd>
+    <dd class="tag-description"><ul class="dummy"><li><p>把名稱陣列以「, 」串接供訊息顯示, 超過上限者截斷並加省略號</p></li></ul></dd>
     
 
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_js_legendFit.mjs.html">src/js/legendFit.mjs</a>, <a href="src_js_legendFit.mjs.html#line24">line 24</a>
+        <a href="src_js_joinNames.mjs.html">src/js/joinNames.mjs</a>, <a href="src_js_joinNames.mjs.html#line15">line 15</a>
     </li></ul></dd>
     
 
@@ -1469,6 +3496,14 @@ reject 之 message 只含例外名稱與代碼(如 'TypeError ECONNREFUSED'、'S
 
 
 
+    <h5 class="h5-examples">Example</h5>
+    
+    <pre class="prettyprint"><code>console.log(joinNames(['a', 'b']))
+// => 'a, b'
+console.log(joinNames(['a', 'b', 'c'], 2))
+// => 'a, b …'</code></pre>
+
+
 
 
     <h5 class="h5-parameters">Parameters:</h5>
@@ -1500,13 +3535,49 @@ reject 之 message 只含例外名稱與代碼(如 'TypeError ECONNREFUSED'、'S
 
         <tr>
             
-                <td class="name"><code>type</code></td>
+                <td class="name"><code>names</code></td>
             
 
             <td class="type">
             
                 
-<span class="param-type">String</span>
+<span class="param-type">Array</span>
+
+
+
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+
+                
+
+                
+                </td>
+            
+
+            
+                <td class="default">
+                
+                </td>
+            
+
+            <td class="description last"><p>輸入名稱陣列, 非陣列回傳空字串, 元素非字串者轉字串</p></td>
+        </tr>
+
+    
+
+        <tr>
+            
+                <td class="name"><code>max</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">Number</span>
 
 
 
@@ -1528,12 +3599,12 @@ reject 之 message 只含例外名稱與代碼(如 'TypeError ECONNREFUSED'、'S
             
                 <td class="default">
                 
-                    <code>'plain'</code>
+                    <code>5</code>
                 
                 </td>
             
 
-            <td class="description last"><p>輸入圖例類型字串, 'plain'或'scroll', 預設'plain'</p></td>
+            <td class="description last"><p>輸入最多列出幾個名稱, 預設5</p></td>
         </tr>
 
     
@@ -1559,7 +3630,7 @@ reject 之 message 只含例外名稱與代碼(如 'TypeError ECONNREFUSED'、'S
 
         
 <div class="param-desc">
-    <p>回傳echarts之legend設定物件</p>
+    <p>回傳字串, 如 'a, b, c' 或 'a, b, c, d, e …'</p>
 </div>
 
 
@@ -1570,7 +3641,7 @@ reject 之 message 只含例外名稱與代碼(如 'TypeError ECONNREFUSED'、'S
     </dt>
     <dd>
         
-<span class="param-type">Object</span>
+<span class="param-type">String</span>
 
 
 
@@ -1586,7 +3657,7 @@ reject 之 message 只含例外名稱與代碼(如 'TypeError ECONNREFUSED'、'S
 
     
 
-    <h4 class="name" id="getOwn"><span class="type-signature"></span>getOwn<span class="signature">(o, k, def<span class="signature-attributes">opt</span>)</span><span class="type-signature"> &rarr; {*}</span></h4>
+    <h4 class="name" id="keepKeyOrder"><span class="type-signature"></span>keepKeyOrder<span class="signature">(kpRef, kpNew)</span><span class="type-signature"> &rarr; {Object}</span></h4>
 
     
 
@@ -1596,16 +3667,17 @@ reject 之 message 只含例外名稱與代碼(如 'TypeError ECONNREFUSED'、'S
 <dl class="details">
     
     <dt class="tag-description">Description:</dt>
-    <dd class="tag-description"><ul class="dummy"><li><p>取物件之自有屬性值, 不解析路徑、不取繼承屬性(lodash get 會把含 . 或 [ 之字串鍵解析為路徑, 並可取到繼承屬性)</p>
-<p>鍵為使用端資料(標的 id、群組／權限／規則名稱、列 id)時一律用本函數: 只授權 A 時, lodash get(kp, 'A.0') 經字串索引得 'y'、'A.length' 得 1、
-'toString' 得繼承函數; 本函數對這些鍵回預設值. 自有屬性存在時回其值(含 0、''、null、false、undefined), 精確鍵(整串即鍵名, 如 'A.0')照常.
-輸入非物件(null、undefined、字串、數字、布林)一律回預設值.</p></li></ul></dd>
+    <dd class="tag-description"><ul class="dummy"><li><p>以 kpRef 之鍵序重排 kpNew: 參考中已有之名稱維持參考序, 新增名稱附加於後(依 kpNew 序), kpNew 沒有之名稱(已刪除)不出現</p>
+<p>編輯器寫出授權字串(cgrups／cpemis／crules)時使用(規則帳本 R-AUTH-ORDER-01): 伺服端 mergeRules 在沒有任何有效 OR 項時以「第一個 AND 項」為 AND 合併之起始,
+結果因鍵序而異, 編輯器若依對話框(群組表)順序重寫, 未改動之授權也會被改變(可增權可減權); 保留原鍵序使「存檔後授權不變」.
+值一律取 kpNew; 鍵為使用者資料(含 <strong>proto</strong>、constructor 等原型鍵名), 回傳無原型物件, 不改動輸入.
+JS 物件屬性序使整數式鍵(如 '1'、'2')恆排在前面且遞增, 本函數無法改變(此類資料由 getKpLossy 判定, 見規則帳本 R-AUTH-LOSSY-01).</p></li></ul></dd>
     
 
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_js_getOwn.mjs.html">src/js/getOwn.mjs</a>, <a href="src_js_getOwn.mjs.html#line30">line 30</a>
+        <a href="src_js_keepKeyOrder.mjs.html">src/js/keepKeyOrder.mjs</a>, <a href="src_js_keepKeyOrder.mjs.html#line21">line 21</a>
     </li></ul></dd>
     
 
@@ -1652,15 +3724,8 @@ reject 之 message 只含例外名稱與代碼(如 'TypeError ECONNREFUSED'、'S
 
     <h5 class="h5-examples">Example</h5>
     
-    <pre class="prettyprint"><code>let kp = { A: 'y', 'B.0': 'y' }
-console.log(getOwn(kp, 'A', 'n'))
-// => 'y'
-console.log(getOwn(kp, 'A.0', 'n'))
-// => 'n'
-console.log(getOwn(kp, 'B.0', 'n'))
-// => 'y'
-console.log(getOwn(kp, 'toString', 'n'))
-// => 'n'</code></pre>
+    <pre class="prettyprint"><code>console.log(Object.keys(keepKeyOrder({ B: 1, A: 2 }, { A: 'a', C: 'c', B: 'b' })))
+// => ['B', 'A', 'C']</code></pre>
 
 
 
@@ -1678,8 +3743,6 @@ console.log(getOwn(kp, 'toString', 'n'))
         <th>Type</th>
 
         
-        <th>Attributes</th>
-        
 
         
 
@@ -1692,7 +3755,7 @@ console.log(getOwn(kp, 'toString', 'n'))
 
         <tr>
             
-                <td class="name"><code>o</code></td>
+                <td class="name"><code>kpRef</code></td>
             
 
             <td class="type">
@@ -1706,66 +3769,23 @@ console.log(getOwn(kp, 'toString', 'n'))
             </td>
 
             
-                <td class="attributes">
-                
-
-                
-
-                
-                </td>
-            
-
-            
-
-            <td class="description last"><p>輸入物件(可為一般物件或無原型物件)</p></td>
-        </tr>
-
-    
-
-        <tr>
-            
-                <td class="name"><code>k</code></td>
-            
-
-            <td class="type">
-            
-                
-<span class="param-type">String</span>
-|
-
-<span class="param-type">Number</span>
-
-
-
-            
-            </td>
-
-            
-                <td class="attributes">
-                
-
-                
-
-                
-                </td>
-            
 
             
 
-            <td class="description last"><p>輸入鍵(整串視為鍵名)</p></td>
+            <td class="description last"><p>輸入參考物件(通常為 cvKpToObj 解碼後之原授權資料), 非物件(null、undefined、陣列、字串、數字)視為無參考</p></td>
         </tr>
 
     
 
         <tr>
             
-                <td class="name"><code>def</code></td>
+                <td class="name"><code>kpNew</code></td>
             
 
             <td class="type">
             
                 
-<span class="param-type">*</span>
+<span class="param-type">Object</span>
 
 
 
@@ -1773,20 +3793,10 @@ console.log(getOwn(kp, 'toString', 'n'))
             </td>
 
             
-                <td class="attributes">
-                
-                    &lt;optional><br>
-                
-
-                
-
-                
-                </td>
-            
 
             
 
-            <td class="description last"><p>輸入無自有屬性時回傳之預設值, 預設undefined</p></td>
+            <td class="description last"><p>輸入欲寫出之物件, 鍵為名稱</p></td>
         </tr>
 
     
@@ -1812,7 +3822,7 @@ console.log(getOwn(kp, 'toString', 'n'))
 
         
 <div class="param-desc">
-    <p>回傳自有屬性值或預設值</p>
+    <p>回傳無原型物件, 鍵序為參考序在前、新增在後</p>
 </div>
 
 
@@ -1823,7 +3833,7 @@ console.log(getOwn(kp, 'toString', 'n'))
     </dt>
     <dd>
         
-<span class="param-type">*</span>
+<span class="param-type">Object</span>
 
 
 
@@ -1839,7 +3849,7 @@ console.log(getOwn(kp, 'toString', 'n'))
 
     
 
-    <h4 class="name" id="getRuleEnable"><span class="type-signature"></span>getRuleEnable<span class="signature">(kp, name)</span><span class="type-signature"> &rarr; {String}</span></h4>
+    <h4 class="name" id="keyOrderOf"><span class="type-signature"></span>keyOrderOf<span class="signature">(kpRef, kpNew)</span><span class="type-signature"> &rarr; {Array}</span></h4>
 
     
 
@@ -1849,16 +3859,14 @@ console.log(getOwn(kp, 'toString', 'n'))
 <dl class="details">
     
     <dt class="tag-description">Description:</dt>
-    <dd class="tag-description"><ul class="dummy"><li><p>取得規則(標的)於 JSON5 解析結果(crules)中之啟用狀態</p>
-<p>與 getUserRules 之解碼一致: 名稱為資料不是路徑(僅以自有屬性精確查值, 規則帳本 R-AUTH-PATH-01),
-值為物件(如 { isActive: 'y' })時取其 isActive, 其餘取值本身; 僅 'y' 為啟用, 其餘(含缺漏、非字串、物件值無 isActive)皆為 'n'.
-使編輯對話框顯示之狀態與實際授權結果一致, 存檔時不致把有效授權靜默改成 n</p></li></ul></dd>
+    <dd class="tag-description"><ul class="dummy"><li><p>keepKeyOrder 的預期名稱順序: 參考中已有之名稱依參考序在前, kpNew 新增之名稱依 kpNew 序附加於後; 以陣列回傳(不受 JS 屬性序影響)</p>
+<p>輸出物件(keepKeyOrder)之鍵序受 JS 屬性序影響(整數式鍵恆先排), 與本函數的預期序可能不同, 差異影響有效 AND 項之相對順序者由 getKeyOrderLost 判定(編輯器拒存).</p></li></ul></dd>
     
 
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_js_getRuleEnable.mjs.html">src/js/getRuleEnable.mjs</a>, <a href="src_js_getRuleEnable.mjs.html#line15">line 15</a>
+        <a href="src_js_keepKeyOrder.mjs.html">src/js/keepKeyOrder.mjs</a>, <a href="src_js_keepKeyOrder.mjs.html#line44">line 44</a>
     </li></ul></dd>
     
 
@@ -1903,6 +3911,12 @@ console.log(getOwn(kp, 'toString', 'n'))
 
 
 
+    <h5 class="h5-examples">Example</h5>
+    
+    <pre class="prettyprint"><code>console.log(keyOrderOf({ B: 1, A: 2 }, { A: 'a', C: 'c', B: 'b' }))
+// => ['B', 'A', 'C']</code></pre>
+
+
 
 
     <h5 class="h5-parameters">Parameters:</h5>
@@ -1930,7 +3944,7 @@ console.log(getOwn(kp, 'toString', 'n'))
 
         <tr>
             
-                <td class="name"><code>kp</code></td>
+                <td class="name"><code>kpRef</code></td>
             
 
             <td class="type">
@@ -1947,20 +3961,20 @@ console.log(getOwn(kp, 'toString', 'n'))
 
             
 
-            <td class="description last"><p>輸入 JSON5.parse(crules) 之結果, 鍵為規則(標的)名稱</p></td>
+            <td class="description last"><p>輸入參考物件, 非物件視為無參考</p></td>
         </tr>
 
     
 
         <tr>
             
-                <td class="name"><code>name</code></td>
+                <td class="name"><code>kpNew</code></td>
             
 
             <td class="type">
             
                 
-<span class="param-type">String</span>
+<span class="param-type">Object</span>
 
 
 
@@ -1971,7 +3985,7 @@ console.log(getOwn(kp, 'toString', 'n'))
 
             
 
-            <td class="description last"><p>輸入規則(標的)名稱</p></td>
+            <td class="description last"><p>輸入欲寫出之物件, 非物件回傳空陣列</p></td>
         </tr>
 
     
@@ -1997,7 +4011,7 @@ console.log(getOwn(kp, 'toString', 'n'))
 
         
 <div class="param-desc">
-    <p>回傳 'y' 或 'n'</p>
+    <p>回傳名稱陣列</p>
 </div>
 
 
@@ -2008,7 +4022,7 @@ console.log(getOwn(kp, 'toString', 'n'))
     </dt>
     <dd>
         
-<span class="param-type">String</span>
+<span class="param-type">Array</span>
 
 
 
@@ -3543,7 +5557,10 @@ opt.hold 為函數, 輸入流程結果, 回傳 true 時保持占位與按鈕鎖(
 <li>主鍵 id 有給時須為非空字串或有限數字(NaN、±Infinity 視為未給, 同 w-serv-orm 1.1.11 之補值), 字串之 UTF-8 位元組數不得超過 1978(LMDB 鍵長上限),
 且批內不得重複(以 String(id) 比對: w-serv-orm 1.1.11 起數字主鍵存為其字串形式, 數字與其字串形式為同一主鍵).</li>
 <li>任一字串欄位之值會被 wsemi 之 clearXSS 改寫者(含 HTML 標記, 如「&lt;」後接英文字母)即拒絕——與 w-serv-orm 寫入前之 adjustData 同一函數,
-主鍵被改寫時 ORM 拒絕整批, 其他欄位則會被靜默改寫(存值與送入值不同), 兩者皆於此擋下, 使送入值即儲存值.
+主鍵被改寫時 ORM 拒絕整批, 其他欄位則會被靜默改寫(存值與送入值不同), 兩者皆於此擋下, 使送入值即儲存值.</li>
+<li>任一欄位之值須為純量(字串、數字、布林、null、undefined)——物件、陣列、函數、symbol、bigint 一律拒絕(規則帳本 R-FIELD-SCALAR-01):
+四表 schema 欄位型別只有 STRING／INTEGER／TEXT(cgrups／cpemis／crules 為 TEXT 存 JSON 字串), 無合法物件型欄位; 修正前預檢只看 isestr(vv),
+巢狀字串(如 { description: { value: '&lt;標記&gt;' } })避過預檢而於寫入時被 w-serv-orm 靜默改寫(非拒絕), 「送入值即儲存值」不成立.
 本函數為純函數: 不修改輸入、不呼叫 ORM; 主鍵是否必填由呼叫端以 opt.idRequired 指定(未給主鍵之列由 ORM 自動補主鍵者可不要求).
 列物件之欄位一律依自有可列舉字串鍵逐一檢查(規則帳本 R-OBJ-ITER-01): 名為 length 之欄位與其他欄位同為一般欄位, 即使其值為非負整數(0、1、2**32-1)亦然——
 lodash each 對這類物件會改走索引 0..length-1 而略過全部字串欄位, 且迭代次數即 length 之值; rows 與 rowsIdOnly 須為真陣列(Array.isArray),
@@ -3554,7 +5571,7 @@ lodash each 對這類物件會改走索引 0..length-1 而略過全部字串欄
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="server_validateRows.mjs.html">server/validateRows.mjs</a>, <a href="server_validateRows.mjs.html#line31">line 31</a>
+        <a href="server_validateRows.mjs.html">server/validateRows.mjs</a>, <a href="server_validateRows.mjs.html#line38">line 38</a>
     </li></ul></dd>
     
 
@@ -3835,7 +5852,7 @@ lodash each 對這類物件會改走索引 0..length-1 而略過全部字串欄
 
         
 <div class="param-desc">
-    <p>回傳第一個違規 { reason, k, field }, reason 為 'rowsInvalid'、'idInvalid'、'idTooLong'、'idDuplicate'、'htmlMarkup' 之一, k 為該列於 rows 之位置(rowsIdOnly 之列為 -1), field 為欄位名; 皆通過回傳 null</p>
+    <p>回傳第一個違規 { reason, k, field }, reason 為 'rowsInvalid'、'idInvalid'、'idTooLong'、'idDuplicate'、'fieldNotScalar'、'htmlMarkup' 之一, k 為該列於 rows 之位置(rowsIdOnly 之列為 -1), field 為欄位名; 皆通過回傳 null</p>
 </div>
 
 
@@ -4437,7 +6454,7 @@ lodash each 對這類物件會改走索引 0..length-1 而略過全部字串欄
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Tue Oct 20 2026 14:44:45 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 Wed Oct 21 2026 01:27:46 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>