npm - w-md2docx - Versions diffs - 1.0.0 - Mend

w-md2docx 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (69) hide show

package/.editorconfig +9 -0
package/.eslintignore +3 -0
package/.eslintrc.js +55 -0
package/.jsdoc +25 -0
package/LICENSE +21 -0
package/README.md +83 -0
package/SECURITY.md +5 -0
package/babel.config.js +16 -0
package/dist/w-md2docx.umd.js +7 -0
package/dist/w-md2docx.umd.js.map +1 -0
package/docs/ApiClient.mjs.html +539 -0
package/docs/ApiServer.mjs.html +516 -0
package/docs/WMd2docx.mjs.html +101 -0
package/docs/cvMdTo.mjs.html +288 -0
package/docs/cvMdToDocx.mjs.html +243 -0
package/docs/fonts/Montserrat/Montserrat-Bold.eot +0 -0
package/docs/fonts/Montserrat/Montserrat-Bold.ttf +0 -0
package/docs/fonts/Montserrat/Montserrat-Bold.woff +0 -0
package/docs/fonts/Montserrat/Montserrat-Bold.woff2 +0 -0
package/docs/fonts/Montserrat/Montserrat-Regular.eot +0 -0
package/docs/fonts/Montserrat/Montserrat-Regular.ttf +0 -0
package/docs/fonts/Montserrat/Montserrat-Regular.woff +0 -0
package/docs/fonts/Montserrat/Montserrat-Regular.woff2 +0 -0
package/docs/fonts/Source-Sans-Pro/sourcesanspro-light-webfont.eot +0 -0
package/docs/fonts/Source-Sans-Pro/sourcesanspro-light-webfont.svg +978 -0
package/docs/fonts/Source-Sans-Pro/sourcesanspro-light-webfont.ttf +0 -0
package/docs/fonts/Source-Sans-Pro/sourcesanspro-light-webfont.woff +0 -0
package/docs/fonts/Source-Sans-Pro/sourcesanspro-light-webfont.woff2 +0 -0
package/docs/fonts/Source-Sans-Pro/sourcesanspro-regular-webfont.eot +0 -0
package/docs/fonts/Source-Sans-Pro/sourcesanspro-regular-webfont.svg +1049 -0
package/docs/fonts/Source-Sans-Pro/sourcesanspro-regular-webfont.ttf +0 -0
package/docs/fonts/Source-Sans-Pro/sourcesanspro-regular-webfont.woff +0 -0
package/docs/fonts/Source-Sans-Pro/sourcesanspro-regular-webfont.woff2 +0 -0
package/docs/global.html +5453 -0
package/docs/index.html +84 -0
package/docs/scripts/collapse.js +39 -0
package/docs/scripts/commonNav.js +28 -0
package/docs/scripts/linenumber.js +25 -0
package/docs/scripts/nav.js +12 -0
package/docs/scripts/polyfill.js +4 -0
package/docs/scripts/prettify/Apache-License-2.0.txt +202 -0
package/docs/scripts/prettify/lang-css.js +2 -0
package/docs/scripts/prettify/prettify.js +28 -0
package/docs/scripts/search.js +99 -0
package/docs/styles/jsdoc.css +776 -0
package/docs/styles/prettify.css +80 -0
package/docs/utils.mjs.html +520 -0
package/g.mjs +34 -0
package/package.json +32 -0
package/script.txt +18 -0
package/src/ApiClient.mjs +467 -0
package/src/ApiServer.mjs +444 -0
package/src/WMd2docx.mjs +29 -0
package/src/cvMdTo.mjs +216 -0
package/src/cvMdToDocx.mjs +171 -0
package/src/templates/temp_tpc.docx +0 -0
package/src/utils.mjs +448 -0
package/test/api-ApiClient.test.mjs +221 -0
package/test/api-ApiServer.test.mjs +191 -0
package/test/cocktail.svg +3 -0
package/test/report.md +257 -0
package/test/unit-cvMdTo.test.mjs +132 -0
package/test/unit-cvMdToDocx.test.mjs +185 -0
package/test/unit-utils.test.mjs +370 -0
package/toolg/addVersion.mjs +4 -0
package/toolg/cleanFolder.mjs +5 -0
package/toolg/gDistRollup.mjs +56 -0
package/toolg/gDocsExams.mjs +51 -0
package/toolg/modifyReadme.mjs +4 -0

package/docs/cvMdTo.mjs.html ADDED Viewed

@@ -0,0 +1,288 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <title>cvMdTo.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>Global</h3><ul><li><a href="global.html#ApiServer">ApiServer</a></li><li><a href="global.html#WMd2docx">WMd2docx</a></li><li><a href="global.html#checkDocxReady">checkDocxReady</a></li><li><a href="global.html#cleanWorkDir">cleanWorkDir</a></li><li><a href="global.html#cvMdTo">cvMdTo</a></li><li><a href="global.html#cvMdToDocx">cvMdToDocx</a></li><li><a href="global.html#getFpExe">getFpExe</a></li><li><a href="global.html#getQueueSize">getQueueSize</a></li><li><a href="global.html#health">health</a></li><li><a href="global.html#readAssets">readAssets</a></li><li><a href="global.html#resolveAssetPaths">resolveAssetPaths</a></li><li><a href="global.html#retryBusy">retryBusy</a></li><li><a href="global.html#runExclusive">runExclusive</a></li><li><a href="global.html#scanAssetPaths">scanAssetPaths</a></li><li><a href="global.html#toErrText">toErrText</a></li><li><a href="global.html#toSafeName">toSafeName</a></li><li><a href="global.html#transErrAsset">transErrAsset</a></li><li><a href="global.html#writeAssets">writeAssets</a></li></ul>
+</nav>
+<div id="main">
+    <h1 class="page-title">cvMdTo.mjs</h1>
+    <section>
+        <article>
+            <pre class="prettyprint source linenums"><code>import fs from 'fs'
+import os from 'os'
+import path from 'path'
+import get from 'lodash-es/get.js'
+import isestr from 'wsemi/src/isestr.mjs'
+import isbol from 'wsemi/src/isbol.mjs'
+import isobj from 'wsemi/src/isobj.mjs'
+import isarr from 'wsemi/src/isarr.mjs'
+import fsIsFile from 'wsemi/src/fsIsFile.mjs'
+import WMd2html from 'w-md2html/src/WMd2html.mjs'
+import cvMdToDocx from './cvMdToDocx.mjs'
+import { mimeHtml, mimeDocx, toErrText, retryBusy, toSafeName, writeAssets, transErrAsset } from './utils.mjs'
+/**
+ * Markdown內容轉Html與Docx內容
+ *
+ * 與cvMdToDocx之差異：本函數接收Markdown「內容」與其引用之資產(圖片等)，於獨立工作資料夾內還原後轉檔，完成後回傳產物之base64內容並清除工作資料夾。適用於服務端等無實體來源檔之情境；有實體md檔者請直接用cvMdToDocx。
+ *
+ * @param {Object} [opt={}] 輸入設定物件，預設{}
+ * @param {String} [opt.md=''] 輸入Markdown內容字串，與mdBase64二擇一
+ * @param {String} [opt.mdBase64=''] 輸入Markdown內容之base64字串，與md二擇一
+ * @param {String} [opt.name='output'] 輸入輸出檔名主體字串(不含副檔名)，將自動移除路徑成分與非法字元，預設'output'
+ * @param {String} [opt.out='docx'] 輸入產出類型字串，可為'html'、'docx'、'both'，預設'docx'
+ * @param {Array} [opt.assets=[]] 輸入md內引用之相對路徑資產陣列，格式[{path,base64}]，預設[]
+ * @param {String} [opt.dirWork=''] 輸入工作資料夾根位置字串，未給則用系統暫存夾下之w-md2docx，預設''
+ * @param {String} [opt.fpInTemp=''] 輸入Docx模板檔位置字串，未給則由w-html2docx使用其內建模板，預設''
+ * @param {Object} [opt.optMd2html={}] 輸入傳予w-md2html之設定物件，預設{}
+ * @param {Object} [opt.optHtml2docx={}] 輸入傳予w-html2docx之設定物件，預設{}
+ * @param {Boolean} [opt.keepWork=false] 輸入是否保留工作資料夾供除錯布林值，預設false
+ * @returns {Promise} 回傳Promise，resolve回傳結果物件{name,out,ms,nAssets,[msDocx],[html],[docx]}，其中html與docx為{fileName,mime,size,base64}，reject回傳錯誤訊息
+ * @example
+ *
+ * import cvMdTo from 'w-md2docx/src/cvMdTo.mjs'
+ *
+ * let r = await cvMdTo({
+ *     md: '# 標題\n\n&lt;img src="pics/圖.png" />',
+ *     name: '報告R00.01',
+ *     out: 'docx',
+ *     assets: [{ path: 'pics/圖.png', base64: '…' }],
+ * })
+ * console.log(r)
+ * // => { name: '報告R00.01', out: 'docx', ms: 8342, nAssets: 1, msDocx: 8300, docx: { fileName: '報告R00.01.docx', mime: '…', size: 39856, base64: '…' } }
+ *
+ */
+async function cvMdTo(opt = {}) {
+    let msStart = Date.now()
+    //out
+    let out = get(opt, 'out', '')
+    if (out !== 'html' &amp;&amp; out !== 'docx' &amp;&amp; out !== 'both') {
+        out = 'docx'
+    }
+    let needHtml = (out === 'html' || out === 'both')
+    let needDocx = (out === 'docx' || out === 'both')
+    //md
+    let md = ''
+    let mdIn = get(opt, 'md', '')
+    let mdBase64 = get(opt, 'mdBase64', '')
+    if (isestr(mdIn)) {
+        md = mdIn
+    }
+    else if (isestr(mdBase64)) {
+        md = Buffer.from(mdBase64, 'base64').toString('utf8')
+    }
+    if (md.trim() === '') {
+        return Promise.reject('md is empty: md (string) or mdBase64 is required')
+    }
+    //name
+    let name = toSafeName(get(opt, 'name', ''))
+    //assets
+    let assets = get(opt, 'assets', [])
+    if (!isarr(assets)) {
+        assets = []
+    }
+    //dirWork (未指定則用系統暫存夾)
+    let dirWork = get(opt, 'dirWork', '')
+    if (!isestr(dirWork)) {
+        dirWork = path.join(os.tmpdir(), 'w-md2docx')
+    }
+    dirWork = path.resolve(dirWork)
+    //fpInTemp (存在性由 cvMdToDocx 檢查)
+    let fpInTemp = get(opt, 'fpInTemp', '')
+    if (!isestr(fpInTemp)) {
+        fpInTemp = ''
+    }
+    //optMd2html
+    let optMd2html = get(opt, 'optMd2html', {})
+    if (!isobj(optMd2html)) {
+        optMd2html = {}
+    }
+    //optHtml2docx
+    let optHtml2docx = get(opt, 'optHtml2docx', {})
+    if (!isobj(optHtml2docx)) {
+        optHtml2docx = {}
+    }
+    //keepWork (除錯用, 保留工作資料夾)
+    let keepWork = get(opt, 'keepWork', false)
+    if (!isbol(keepWork)) {
+        keepWork = false
+    }
+    //dirJob (每次作業獨立資料夾, 使同名檔案與資產互不干擾)
+    let idJob = `${Date.now()}_${Math.random().toString(36).slice(2, 8)}`
+    let dirJob = path.resolve(dirWork, `job_${idJob}`)
+    fs.mkdirSync(dirJob, { recursive: true })
+    let rt = {
+        name,
+        out,
+        ms: 0,
+        nAssets: 0,
+    }
+    try {
+        //寫入 md (資產以 md 所在資料夾為基準解析, 故兩者同置於 dirJob)
+        let fpMd = path.resolve(dirJob, `${name}.md`)
+        fs.writeFileSync(fpMd, md, 'utf8')
+        //寫入資產
+        try {
+            rt.nAssets = writeAssets(dirJob, assets)
+        }
+        catch (err) {
+            return Promise.reject(toErrText(err))
+        }
+        let fpHtml = path.resolve(dirJob, `${name}.html`)
+        if (needDocx) {
+            //md -> html -> docx (中介 html 指定產於作業夾, 供 out 含 html 時一併回傳)
+            let fpDocx = path.resolve(dirJob, `${name}.docx`)
+            let errDocx = null
+            let r = await cvMdToDocx(fpMd, fpDocx, {
+                fpInTemp,
+                fpOutHtml: fpHtml,
+                optMd2html,
+                optHtml2docx,
+            })
+                .catch((err) => {
+                    errDocx = transErrAsset(toErrText(err))
+                })
+            if (errDocx !== null) {
+                return Promise.reject(errDocx)
+            }
+            let buf = fs.readFileSync(fpDocx)
+            rt.docx = {
+                fileName: `${name}.docx`,
+                mime: mimeDocx,
+                size: buf.length,
+                base64: buf.toString('base64'),
+            }
+            rt.msDocx = get(r, 'ms', 0)
+        }
+        else {
+            //僅需 html, 不啟動 Word
+            let errHtml = null
+            await retryBusy(() => WMd2html(fpMd, fpHtml, optMd2html))
+                .catch((err) => {
+                    errHtml = toErrText(err)
+                })
+            if (errHtml !== null) {
+                return Promise.reject(transErrAsset(`Failed to convert md to html: ${errHtml}`))
+            }
+            if (!fsIsFile(fpHtml) || fs.statSync(fpHtml).size === 0) {
+                return Promise.reject('Failed to convert md to html: html was not generated or is empty')
+            }
+        }
+        if (needHtml) {
+            let buf = fs.readFileSync(fpHtml)
+            rt.html = {
+                fileName: `${name}.html`,
+                mime: mimeHtml,
+                size: buf.length,
+                base64: buf.toString('base64'),
+            }
+        }
+        rt.ms = Date.now() - msStart
+        return rt
+    }
+    finally {
+        //清除作業資料夾(除錯模式保留)
+        if (!keepWork) {
+            try {
+                fs.rmSync(dirJob, { recursive: true, force: true })
+            }
+            catch (err) {
+                //殘檔被鎖, 留待下次清理
+            }
+        }
+    }
+}
+export default cvMdTo
+</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 Tue Sep 01 2026 16:40:03 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/cvMdToDocx.mjs.html ADDED Viewed

@@ -0,0 +1,243 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <title>cvMdToDocx.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>Global</h3><ul><li><a href="global.html#ApiServer">ApiServer</a></li><li><a href="global.html#WMd2docx">WMd2docx</a></li><li><a href="global.html#checkDocxReady">checkDocxReady</a></li><li><a href="global.html#cleanWorkDir">cleanWorkDir</a></li><li><a href="global.html#cvMdTo">cvMdTo</a></li><li><a href="global.html#cvMdToDocx">cvMdToDocx</a></li><li><a href="global.html#getFpExe">getFpExe</a></li><li><a href="global.html#getQueueSize">getQueueSize</a></li><li><a href="global.html#health">health</a></li><li><a href="global.html#readAssets">readAssets</a></li><li><a href="global.html#resolveAssetPaths">resolveAssetPaths</a></li><li><a href="global.html#retryBusy">retryBusy</a></li><li><a href="global.html#runExclusive">runExclusive</a></li><li><a href="global.html#scanAssetPaths">scanAssetPaths</a></li><li><a href="global.html#toErrText">toErrText</a></li><li><a href="global.html#toSafeName">toSafeName</a></li><li><a href="global.html#transErrAsset">transErrAsset</a></li><li><a href="global.html#writeAssets">writeAssets</a></li></ul>
+</nav>
+<div id="main">
+    <h1 class="page-title">cvMdToDocx.mjs</h1>
+    <section>
+        <article>
+            <pre class="prettyprint source linenums"><code>import fs from 'fs'
+import os from 'os'
+import path from 'path'
+import get from 'lodash-es/get.js'
+import isestr from 'wsemi/src/isestr.mjs'
+import isobj from 'wsemi/src/isobj.mjs'
+import fsIsFile from 'wsemi/src/fsIsFile.mjs'
+import WMd2html from 'w-md2html/src/WMd2html.mjs'
+import WHtml2docx from 'w-html2docx/src/WHtml2docx.mjs'
+import { toErrText, retryBusy, runExclusive, getFpExe } from './utils.mjs'
+/**
+ * Markdown檔轉Docx檔
+ *
+ * 內部流程為md -> html -> docx。docx階段係調用本機Microsoft Word(win32com)，故僅能於已安裝Word之Windows執行，且同時間僅一份轉檔作業(內部佇列自動排隊)。
+ *
+ * 注意：底層w-html2docx於Word未安裝或COM呼叫失敗時「仍回傳ok」，本函數一律以產物實體檔之存在與大小驗證成敗，失敗即reject，不會回報假成功。
+ *
+ * @param {String} fpInMd 輸入來源Markdown檔位置字串
+ * @param {String} fpOutDocx 輸入轉出Docx檔位置字串
+ * @param {Object} [opt={}] 輸入設定物件，預設{}
+ * @param {String} [opt.fpInTemp=''] 輸入Docx模板檔位置字串，未給則由w-html2docx使用其內建模板，預設''
+ * @param {String} [opt.fpOutHtml=''] 輸入另存中介Html檔位置字串，未給則中介檔產於系統暫存夾並於轉檔後刪除，預設''
+ * @param {Object} [opt.optMd2html={}] 輸入傳予w-md2html之設定物件(如imgWidthMax、fontSizeScale等)，預設{}
+ * @param {Object} [opt.optHtml2docx={}] 輸入傳予w-html2docx之設定物件(如imgRatioWidthMax、fontFamilies等)，預設{}
+ * @returns {Promise} 回傳Promise，resolve回傳結果物件{fpOutDocx,sizeDocx,sizeHtml,ms,[fpOutHtml]}，reject回傳錯誤訊息
+ * @example
+ *
+ * import cvMdToDocx from 'w-md2docx/src/cvMdToDocx.mjs'
+ *
+ * let r = await cvMdToDocx('./test/report.md', './test/report.docx', {
+ *     fpInTemp: './src/templates/temp_tpc.docx',
+ *     optMd2html: {
+ *         imgWidthMax: '500px',
+ *     },
+ * })
+ * console.log(r)
+ * // => { fpOutDocx: '…', sizeDocx: 39856, sizeHtml: 12345, ms: 8342 }
+ *
+ */
+async function cvMdToDocx(fpInMd, fpOutDocx, opt = {}) {
+    let msStart = Date.now()
+    //check fpInMd
+    if (!isestr(fpInMd)) {
+        return Promise.reject('fpInMd must be a non-empty string')
+    }
+    fpInMd = path.resolve(fpInMd)
+    if (!fsIsFile(fpInMd)) {
+        return Promise.reject(`fpInMd[${fpInMd}] does not exist`)
+    }
+    //check fpOutDocx
+    if (!isestr(fpOutDocx)) {
+        return Promise.reject('fpOutDocx must be a non-empty string')
+    }
+    fpOutDocx = path.resolve(fpOutDocx)
+    //fpOutHtml (未指定則產於系統暫存夾, 轉檔後刪除)
+    let fpOutHtml = get(opt, 'fpOutHtml', '')
+    let bKeepHtml = isestr(fpOutHtml)
+    if (bKeepHtml) {
+        fpOutHtml = path.resolve(fpOutHtml)
+    }
+    else {
+        //檔名唯一, 避免與被鎖定之同名殘檔衝突造成 EBUSY
+        fpOutHtml = path.join(os.tmpdir(), `wmd2docx_${process.pid}_${Date.now()}_${Math.random().toString(36).slice(2, 8)}.html`)
+    }
+    //optMd2html
+    let optMd2html = get(opt, 'optMd2html', {})
+    if (!isobj(optMd2html)) {
+        optMd2html = {}
+    }
+    //optHtml2docx (複製一份, 避免改動呼叫端物件)
+    let optHtml2docx = get(opt, 'optHtml2docx', {})
+    if (!isobj(optHtml2docx)) {
+        optHtml2docx = {}
+    }
+    optHtml2docx = { ...optHtml2docx }
+    //fpInTemp (未給則交由 w-html2docx 使用內建模板)
+    let fpInTemp = get(opt, 'fpInTemp', '')
+    if (isestr(fpInTemp)) {
+        fpInTemp = path.resolve(fpInTemp)
+        if (!fsIsFile(fpInTemp)) {
+            return Promise.reject(`fpInTemp[${fpInTemp}] does not exist`)
+        }
+        optHtml2docx.fpInTemp = fpInTemp
+    }
+    try {
+        //md -> html
+        //note: w-md2html 係以 md 所在資料夾解析其內引用之相對路徑圖片, 並預設轉為 base64 內嵌,
+        //      故中介 html 置於他處亦不影響圖片
+        fs.mkdirSync(path.dirname(fpOutHtml), { recursive: true })
+        let errHtml = null
+        await retryBusy(() => WMd2html(fpInMd, fpOutHtml, optMd2html))
+            .catch((err) => {
+                errHtml = toErrText(err)
+            })
+        if (errHtml !== null) {
+            return Promise.reject(`Failed to convert md to html: ${errHtml}`)
+        }
+        //驗證 html(產物實體檔為準, 不憑回傳值)
+        if (!fsIsFile(fpOutHtml) || fs.statSync(fpOutHtml).size === 0) {
+            return Promise.reject('Failed to convert md to html: html was not generated or is empty')
+        }
+        let sizeHtml = fs.statSync(fpOutHtml).size
+        //事前檢查轉檔器(依 cwd 定位, 查無則此 cwd 下必定失敗, 先行明確報錯)
+        let fpExe = getFpExe()
+        if (fpExe === '') {
+            return Promise.reject(`htmlToDocx.exe not found (cwd=${path.resolve()}), please run from the folder that contains node_modules/w-html2docx`)
+        }
+        //html -> docx(排隊逐一執行, 避免同時調用本機 Word)
+        fs.mkdirSync(path.dirname(fpOutDocx), { recursive: true })
+        let errDocx = null
+        await runExclusive(() => retryBusy(() => WHtml2docx(fpOutHtml, fpOutDocx, optHtml2docx)))
+            .catch((err) => {
+                errDocx = toErrText(err)
+            })
+        if (errDocx !== null) {
+            return Promise.reject(`Failed to convert html to docx: ${errDocx}`)
+        }
+        //驗證 docx
+        //why: w-html2docx 於 Word 未安裝、COM 呼叫失敗等情形「仍回傳 ok」(錯誤僅印於其子程序之輸出),
+        //     故一律以產物實體檔之存在與大小為準, 否則將回報假成功
+        if (!fsIsFile(fpOutDocx) || fs.statSync(fpOutDocx).size === 0) {
+            return Promise.reject('docx was not generated: please make sure Microsoft Word is installed and no stale WINWORD process is locking the files')
+        }
+        let sizeDocx = fs.statSync(fpOutDocx).size
+        let rt = {
+            fpOutDocx,
+            sizeDocx,
+            sizeHtml,
+            ms: Date.now() - msStart,
+        }
+        if (bKeepHtml) {
+            rt.fpOutHtml = fpOutHtml
+        }
+        return rt
+    }
+    finally {
+        //刪除中介 html(使用者指定保留者不刪; 被鎖就略過, 留待系統暫存清理)
+        if (!bKeepHtml &amp;&amp; fsIsFile(fpOutHtml)) {
+            try {
+                fs.unlinkSync(fpOutHtml)
+            }
+            catch (err) {
+                //殘檔被鎖, 略過
+            }
+        }
+    }
+}
+export default cvMdToDocx
+</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 Tue Sep 01 2026 16:40:03 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>