wsemi 1.9.21 → 1.9.23

package/docs/u16arr2u8arr.mjs.html

@@ -130,7 +130,7 @@ export default u16arr2u8arr
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Oct 19 2026 23:54:10 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 Tue Oct 20 2026 18:08:33 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/u8arr2ab.mjs.html

@@ -131,7 +131,7 @@ export default u8arr2ab
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Oct 19 2026 23:54:10 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 Tue Oct 20 2026 18:08:33 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/u8arr2b64.mjs.html

@@ -136,7 +136,7 @@ export default u8arr2b64
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Oct 19 2026 23:54:10 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 Tue Oct 20 2026 18:08:33 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/u8arr2blob.mjs.html

@@ -133,7 +133,7 @@ export default u8arr2blob
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Oct 19 2026 23:54:10 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 Tue Oct 20 2026 18:08:33 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/u8arr2bs.mjs.html

@@ -133,7 +133,7 @@ export default u8arr2bs
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Oct 19 2026 23:54:10 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 Tue Oct 20 2026 18:08:33 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/u8arr2obj.mjs.html

@@ -55,6 +55,16 @@ import u8arr2str from './u8arr2str.mjs'
 import stru8arr2obj from './stru8arr2obj.mjs'
 
 
+//checkLenHead, 檢查封包標頭記載之分塊資訊區長度, 回傳不符原因字串, 符合則回傳空字串
+//取自封包標頭(網路/檔案來源, 不可信), 須為非負整數且不逾封包資料區之位元組數: 小數與負數經slice被靜默截斷或自尾端算而得同一分割(非正規編碼), NaN與Infinity亦然
+function checkLenHead(lenHead, size) {
+    if (!Number.isInteger(lenHead) || lenHead < 0 || lenHead > size) {
+        return 'head length must be a non-negative integer not exceeding the packet'
+    }
+    return ''
+}
+
+
 //checkPks, 檢查分塊資訊, 回傳不符原因字串, 全符合則回傳空字串
 //分塊資訊取自封包標頭(網路/檔案來源, 不可信), 須在迭代與配置記憶體前驗證(R-OBJ-ITER-01規則6), 否則偽造{"length":N}會使迭代依N次並逐次配置Uint8Array
 //  1. 須為真陣列(Array.isArray), 帶length鍵之物件或字串等不得依其length迭代
@@ -110,7 +120,7 @@ function sliceU8arr(u8a, inds) {
  * @param {Uint8Array} u8a 輸入Uint8Array
  * @param {Object} [opt={}] 輸入設定物件，預設{}
  * @param {Boolean} [opt.returnWithStateAndMsg=false] 輸入是否回傳含狀態與訊息物件布林值，若為true則回傳{ state, msg }物件，state為'success'或'error'，msg於success時為回傳結果、於error時為錯誤訊息字串，預設false
- * @returns {Object|Array} 回傳物件或陣列資料，其內二進位數據依標記所記之原型別還原，Uint8Array、Uint16Array、ArrayBuffer皆原型別原數值返回；輸入非Uint8Array或封包損毀時回傳空物件，封包標頭內分塊資訊非真陣列、含非負有限整數以外之項、、總量逾封包長度、或分塊數量逾主區塊可容納之二進位標記數(每個分塊在主區塊內至少有一個25位元組之標記)亦視為損毀(msg為'invalid pks, <原因>')；同一二進位索引被引用多次亦視為損毀；若opt.returnWithStateAndMsg為true則回傳{ state, msg }物件
+ * @returns {Object|Array} 回傳物件或陣列資料，其內二進位數據依標記所記之原型別還原，Uint8Array、Uint16Array、ArrayBuffer皆原型別原數值返回；輸入非Uint8Array或封包損毀時回傳空物件，封包標頭記載之分塊資訊區長度非非負整數或逾封包資料區長度(含封包短於8位元組)、分塊資訊非真陣列、含非負有限整數以外之項、總量逾封包長度、或分塊數量逾主區塊可容納之二進位標記數(每個分塊在主區塊內至少有一個25位元組之標記)亦視為損毀(msg為'invalid pks, <原因>')；同一二進位索引被引用多次亦視為損毀；若opt.returnWithStateAndMsg為true則回傳{ state, msg }物件
  * @example
  *
  * let u8a = new Uint8Array([
@@ -129,7 +139,7 @@ function sliceU8arr(u8a, inds) {
  * console.log(u8arr2obj(new Uint8Array([1, 2, 3]), { returnWithStateAndMsg: true }))
  * // => {
  * //     state: 'error',
- * //     msg: 'SyntaxError: Unexpected end of JSON input'
+ * //     msg: 'invalid pks, head length must be a non-negative integer not exceeding the packet'
  * // }
  *
  */
@@ -169,6 +179,10 @@ function u8arr2obj(u8a, opt = {}) {
 
         //lenHead
         let lenHead = bufReadDbl(bHead) //讀取分塊資訊區長度
+        let errHead = checkLenHead(lenHead, getBufferSize(bOthers)) //來自封包(不可信), 須先驗證才可用於切分
+        if (errHead !== '') {
+            return retError(`invalid pks, ${errHead}`)
+        }
         let bvPks = bOthers.slice(0, lenHead) //分塊資訊區之二進位數據(Uint8Array)
         let bbPks = bOthers.slice(lenHead, getBufferSize(bOthers)) //各分塊區之二進位數據(Uint8Array)
 
@@ -239,7 +253,7 @@ export default u8arr2obj
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Oct 19 2026 23:54:10 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 Tue Oct 20 2026 18:08:33 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/u8arr2str.mjs.html

@@ -132,7 +132,7 @@ export default u8arr2str
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Oct 19 2026 23:54:10 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 Tue Oct 20 2026 18:08:33 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/u8arr2u16arr.mjs.html

@@ -130,7 +130,7 @@ export default u8arr2u16arr
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Oct 19 2026 23:54:10 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 Tue Oct 20 2026 18:08:33 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/urlParse.mjs.html

@@ -111,7 +111,7 @@ export default urlParse
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Oct 19 2026 23:54:10 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 Tue Oct 20 2026 18:08:33 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/verifyValue.mjs.html

@@ -224,7 +224,7 @@ export default verifyValue
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Oct 19 2026 23:54:10 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 Tue Oct 20 2026 18:08:33 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/waitFun.mjs.html

@@ -236,7 +236,7 @@ export default waitFun
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Oct 19 2026 23:54:10 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 Tue Oct 20 2026 18:08:33 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/wsemi.html

@@ -15497,14 +15497,37 @@ await test3()
 <p>Depend on: <a href="https://jsxss.com/zh/index.html">https://jsxss.com/zh/index.html</a></p>
 <p>白名單外之標籤轉義，白名單內之標籤刪除白名單外之屬性與危險網址(style屬性保留)，標籤外之文字只轉義會開始標籤之&lt;(其後為英文字母、斜線、驚嘆號、問號或位於結尾)，&gt;與其餘之&lt;維持原樣，故'a &lt; b'等數學式不改寫</p>
 <p>輸出僅供以HTML內文呈現(如v-html、innerHTML)，不可放入屬性值或註解內</p>
-<p>物件與陣列遞迴處理，物件只依自有可列舉鍵走訪，length視為一般鍵(不使走訪改為類陣列，不新增鍵)，成本與length值無關</p>
+<p>走訪採顯式堆疊並以來源物件之參照記憶化，不遞迴：深巢狀與循環參照不拋錯(循環保持)，共用子結構只處理一次且輸出中保持共用，成本與節點數成正比，不設深度上限(僅受堆積限制)。處置如下：</p>
+<ol>
+<li>
+<p>字串清除(含包裝String，清除後為原始字串)；空字串與number、boolean、null、undefined等非字串原值回傳</p>
+</li>
+<li>
+<p>物件(含類別實例)與真陣列(含子類別)走訪並保留原型(null原型物件變一般物件)，length視為一般鍵(不使走訪改為類陣列，不新增鍵)，成本與length值無關；物件依自有可列舉之字串鍵與Symbol鍵，陣列依索引(空洞補undefined，非索引屬性不複製，正規表示式比對結果之index與input除外，其input亦清除)；Map走訪值、Set走訪元素(Map之鍵不處理，清除後相同之Set元素合併)，Map與Set之自有可列舉屬性一併走訪；不可列舉屬性不複製，原型上之資料不處理</p>
+</li>
+<li>
+<p>物件之字串鍵與Map之鍵不清除，由使用端自行檢核</p>
+</li>
+<li>
+<p>arguments物件與以Symbol.toStringTag偽稱Array或Arguments之物件，視為物件並依自有可列舉鍵走訪，轉為一般物件</p>
+</li>
+<li>
+<p>Date、RegExp、型別陣列、Buffer、ArrayBuffer、包裝Number等回傳複本，其自有字串屬性不清除(物件值屬性依上述走訪)；函數、Error、WeakMap、Promise、URL等不可複製者，巢狀時回傳同一參照而不清除其內字串，位於最外層時函數複製為一般物件(清除其可列舉屬性)、Error等回傳{}；其餘經lodash cloneDeep複製後仍帶自訂Symbol.toStringTag之物件亦不清除其內字串</p>
+</li>
+<li>
+<p>經lodash cloneDeep複製之物件(上述第4、5點以外之非一般物件，如類別實例、null原型物件、陣列子類別、自訂標籤者)沿用其複製行為(含原型上之setter)，再依複本之終態逐鍵清除；除此之外輸入不被修改</p>
+</li>
+<li>
+<p>清除對字串不保證冪等(如&lt;b='&lt;&lt;&gt;清一次與清兩次結果不同)，已清除之值再送入可能再被改寫</p>
+</li>
+</ol>
 <p>Unit Test: <a href="https://github.com/yuda-lyu/wsemi/blob/master/test/clearXSS.test.mjs">Github</a></p></li></ul></dd>
     
 
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="clearXSS.mjs.html">clearXSS.mjs</a>, <a href="clearXSS.mjs.html#line35">line 35</a>
+        <a href="clearXSS.mjs.html">clearXSS.mjs</a>, <a href="clearXSS.mjs.html#line138">line 138</a>
     </li></ul></dd>
     
 
@@ -15551,7 +15574,7 @@ await test3()
 
     <h5 class="h5-examples">Example</h5>
     
-    <pre class="prettyprint"><code>console.log(clearXSS(`>&lt;script>alert('XSS')&lt;/script>`))
+    <pre class="prettyprint"><code>console.log(clearXSS(`>&lt;script>alert('XSS')&lt;/script>`))
 
 
 
@@ -15604,7 +15627,7 @@ await test3()
 
             
 
-            <td class="description last"><p>輸入資料</p></td>
+            <td class="description last"><p>輸入資料，可為字串，或含字串之物件、陣列、Map、Set</p></td>
         </tr>
 
     
@@ -15630,7 +15653,7 @@ await test3()
 
         
 <div class="param-desc">
-    <p>輸出資料</p>
+    <p>輸出資料，字串輸入回傳清除後字串，其餘回傳清除後之新結構(原始值原樣回傳)</p>
 </div>
 
 
@@ -40582,7 +40605,7 @@ if (true) {
 <dl class="details">
     
     <dt class="tag-description">Description:</dt>
-    <dd class="tag-description"><ul class="dummy"><li><p>展平物件或陣列成為關聯陣列</p>
+    <dd class="tag-description"><ul class="dummy"><li><p>展平物件或陣列成為關聯陣列，真陣列(含帶其他Symbol.toStringTag者)依索引，物件依自有鍵(length視為一般鍵)，以Symbol.toStringTag偽稱Array之物件視為物件</p>
 <p>Unit Test: <a href="https://github.com/yuda-lyu/wsemi/blob/master/test/flattenToConn.test.mjs">Github</a></p></li></ul></dd>
     
 
@@ -41045,7 +41068,7 @@ if (true) {
 <dl class="details">
     
     <dt class="tag-description">Description:</dt>
-    <dd class="tag-description"><ul class="dummy"><li><p>展平樹狀物件或陣列</p>
+    <dd class="tag-description"><ul class="dummy"><li><p>展平樹狀物件或陣列，以Symbol.toStringTag偽稱Array之物件視為物件</p>
 <p>Unit Test: <a href="https://github.com/yuda-lyu/wsemi/blob/master/test/flattenTree.test.mjs">Github</a></p></li></ul></dd>
     
 
@@ -62434,7 +62457,7 @@ console.log(wb2.sheets[0].name)
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="getFileAccept.mjs.html">getFileAccept.mjs</a>, <a href="getFileAccept.mjs.html#line32">line 32</a>
+        <a href="getFileAccept.mjs.html">getFileAccept.mjs</a>, <a href="getFileAccept.mjs.html#line31">line 31</a>
     </li></ul></dd>
     
 
@@ -63723,7 +63746,7 @@ console.log(wb2.sheets[0].name)
 
     
 
-    <h4 class="name" id=".getFileType"><span class="type-signature type-signature-static">(static) </span>getFileType<span class="signature">(name<span class="signature-attributes">opt</span>)</span><span class="type-signature"> &rarr; {Object|Array}</span></h4>
+    <h4 class="name" id=".getFileType"><span class="type-signature type-signature-static">(static) </span>getFileType<span class="signature">(name<span class="signature-attributes">opt</span>)</span><span class="type-signature"> &rarr; {Object|Array|null}</span></h4>
 
     
 
@@ -63733,14 +63756,17 @@ console.log(wb2.sheets[0].name)
 <dl class="details">
     
     <dt class="tag-description">Description:</dt>
-    <dd class="tag-description"><ul class="dummy"><li><p>取得檔案類型資訊</p>
+    <dd class="tag-description"><ul class="dummy"><li><p>取得檔案類型資訊
+副檔名不含點，比對不分大小寫(回傳列之name維持表內原樣，如'z'回傳name為'Z'之列)
+若副檔名多義或無IANA登錄，該列會附msg欄位說明(如gpx、las、obj)
+heic之acp為image/heic，heif之acp為image/heif</p>
 <p>Unit Test: <a href="https://github.com/yuda-lyu/wsemi/blob/master/test/getFileType.test.mjs">Github</a></p></li></ul></dd>
     
 
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="getFileType.mjs.html">getFileType.mjs</a>, <a href="getFileType.mjs.html#line1078">line 1078</a>
+        <a href="getFileType.mjs.html">getFileType.mjs</a>, <a href="getFileType.mjs.html#line1222">line 1222</a>
     </li></ul></dd>
     
 
@@ -63787,7 +63813,7 @@ console.log(wb2.sheets[0].name)
 
     <h5 class="h5-examples">Example</h5>
     
-    <pre class="prettyprint"><code>let r
+    <pre class="prettyprint"><code>let r
 
 
 
@@ -63854,7 +63880,7 @@ console.log(wb2.sheets[0].name)
                 </td>
             
 
-            <td class="description last"><p>輸入過濾副檔名字串，預設''</p></td>
+            <td class="description last"><p>輸入過濾副檔名字串(不含點，不分大小寫)，預設''</p></td>
         </tr>
 
     
@@ -63880,7 +63906,7 @@ console.log(wb2.sheets[0].name)
 
         
 <div class="param-desc">
-    <p>回傳檔案關聯性資訊物件或陣列</p>
+    <p>回傳檔案關聯性資訊物件，未收錄之副檔名回傳null，未給予有效字串則回傳全部資訊陣列</p>
 </div>
 
 
@@ -63895,6 +63921,9 @@ console.log(wb2.sheets[0].name)
 |
 
 <span class="param-type">Array</span>
+|
+
+<span class="param-type">null</span>
 
 
 
@@ -66009,7 +66038,7 @@ console.log(wb2.sheets[0].name)
 <dl class="details">
     
     <dt class="tag-description">Description:</dt>
-    <dd class="tag-description"><ul class="dummy"><li><p>由ltdt提取不重複keys</p>
+    <dd class="tag-description"><ul class="dummy"><li><p>由ltdt提取不重複keys，各列物件只依自有可列舉鍵(length視為一般鍵)</p>
 <p>Unit Test: <a href="https://github.com/yuda-lyu/wsemi/blob/master/test/getltdtkeys.test.mjs">Github</a></p></li></ul></dd>
     
 
@@ -107202,7 +107231,7 @@ console.log(strTruncate('abcdefghij', -1))
 <dl class="details">
     
     <dt class="tag-description">Description:</dt>
-    <dd class="tag-description"><ul class="dummy"><li><p>遍歷物件並回傳複製物件，類似JSON.stringify，但不會序列化成為字串</p>
+    <dd class="tag-description"><ul class="dummy"><li><p>遍歷物件並回傳複製物件，類似JSON.stringify，但不會序列化成為字串。真陣列(含帶其他Symbol.toStringTag者)依索引遍歷，物件依自有鍵遍歷(length視為一般鍵)，以Symbol.toStringTag偽稱Array之物件視為物件</p>
 <p>Unit Test: <a href="https://github.com/yuda-lyu/wsemi/blob/master/test/treeObj.test.mjs">Github</a></p></li></ul></dd>
     
 
@@ -109916,7 +109945,7 @@ console.log(u8arr2bs('abc', { returnWithStateAndMsg: true }))
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="u8arr2obj.mjs.html">u8arr2obj.mjs</a>, <a href="u8arr2obj.mjs.html#line89">line 89</a>
+        <a href="u8arr2obj.mjs.html">u8arr2obj.mjs</a>, <a href="u8arr2obj.mjs.html#line99">line 99</a>
     </li></ul></dd>
     
 
@@ -109963,7 +109992,7 @@ console.log(u8arr2bs('abc', { returnWithStateAndMsg: true }))
 
     <h5 class="h5-examples">Example</h5>
     
-    <pre class="prettyprint"><code>let u8a = new Uint8Array([
    64, 24, 0, 0, 0, 0, 0, 0, 91, 54, 54, 44,
    51, 93, 123, 34, 97, 34, 58, 91, 49, 50, 51, 44,
    52, 53, 46, 54, 55, 44, 34, 116, 101, 115, 116, 228,
    184, 173, 230, 150, 135, 34, 93, 44, 34, 98, 34, 58,
    123, 34, 99, 34, 58, 34, 91, 66, 108, 97, 122, 101,
    70, 111, 114, 85, 105, 110, 116, 56, 65, 114, 114, 97,
    121, 93, 58, 58, 48, 34, 125, 125, 66, 97, 115
+    <pre class="prettyprint"><code>let u8a = new Uint8Array([
    64, 24, 0, 0, 0, 0, 0, 0, 91, 54, 54, 44,
    51, 93, 123, 34, 97, 34, 58, 91, 49, 50, 51, 44,
    52, 53, 46, 54, 55, 44, 34, 116, 101, 115, 116, 228,
    184, 173, 230, 150, 135, 34, 93, 44, 34, 98, 34, 58,
    123, 34, 99, 34, 58, 34, 91, 66, 108, 97, 122, 101,
    70, 111, 114, 85, 105, 110, 116, 56, 65, 114, 114, 97,
    121, 93, 58, 58, 48, 34, 125, 125, 66, 97, 115
 
 
 
@@ -110162,7 +110191,7 @@ console.log(u8arr2bs('abc', { returnWithStateAndMsg: true }))
 
         
 <div class="param-desc">
-    <p>回傳物件或陣列資料，其內二進位數據依標記所記之原型別還原，Uint8Array、Uint16Array、ArrayBuffer皆原型別原數值返回；輸入非Uint8Array或封包損毀時回傳空物件，封包標頭內分塊資訊非真陣列、含非負有限整數以外之項、、總量逾封包長度、或分塊數量逾主區塊可容納之二進位標記數(每個分塊在主區塊內至少有一個25位元組之標記)亦視為損毀(msg為'invalid pks, &lt;原因&gt;')；同一二進位索引被引用多次亦視為損毀；若opt.returnWithStateAndMsg為true則回傳{ state, msg }物件</p>
+    <p>回傳物件或陣列資料，其內二進位數據依標記所記之原型別還原，Uint8Array、Uint16Array、ArrayBuffer皆原型別原數值返回；輸入非Uint8Array或封包損毀時回傳空物件，封包標頭記載之分塊資訊區長度非非負整數或逾封包資料區長度(含封包短於8位元組)、分塊資訊非真陣列、含非負有限整數以外之項、總量逾封包長度、或分塊數量逾主區塊可容納之二進位標記數(每個分塊在主區塊內至少有一個25位元組之標記)亦視為損毀(msg為'invalid pks, &lt;原因&gt;')；同一二進位索引被引用多次亦視為損毀；若opt.returnWithStateAndMsg為true則回傳{ state, msg }物件</p>
 </div>
 
 
@@ -111455,7 +111484,7 @@ console.log(u8arr2u16arr('abc', { returnWithStateAndMsg: true }))
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Oct 19 2026 23:54:10 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 Tue Oct 20 2026 18:08:33 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wsemi",
-  "version": "1.9.21",
+  "version": "1.9.23",
   "main": "dist/wsemi.umd.js",
   "dependencies": {
     "@zumer/snapdom": "^3.3.0",