w-md2docx 1.0.0

package/test/api-ApiClient.test.mjs

@@ -0,0 +1,221 @@
+import fs from 'fs'
+import path from 'path'
+import assert from 'assert'
+import ApiServer from '../src/ApiServer.mjs'
+import ApiClient, { cvMdTo, health, scanAssetPaths, readAssets } from '../src/ApiClient.mjs'
+
+
+describe('ApiClient', function() {
+
+    describe('scanAssetPaths(純函數)', function() {
+
+        it('涵蓋<img src>與![]() , 去重, 保留原字串', function() {
+            let md = [
+                '![a](pics/a.png)',
+                '<img src="pics/b.png" />',
+                `<IMG class='x' SRC='pics/c.png'>`,
+                '![a2](pics/a.png)',
+                '![e](<pics/e.png>)',
+                '![enc](pics/%E5%9C%96.png)',
+            ].join('\n')
+            assert.strict.deepEqual(scanAssetPaths(md), ['pics/b.png', 'pics/c.png', 'pics/a.png', 'pics/e.png', 'pics/%E5%9C%96.png'])
+        })
+
+        it('排除網路位址/data/mailto/錨點/絕對路徑', function() {
+            let md = [
+                '![1](https://x.com/1.png)',
+                '![2](//x.com/2.png)',
+                '![3](data:image/png;base64,AAAA)',
+                '[m](mailto:a@b.c)',
+                '![4](#top)',
+                '![5](C:/x/5.png)',
+                '![6](/abs/6.png)',
+                '![ok](rel/ok.png)',
+            ].join('\n')
+            assert.strict.deepEqual(scanAssetPaths(md), ['rel/ok.png'])
+        })
+
+        it('去除錨點與查詢字串', function() {
+            assert.strict.deepEqual(scanAssetPaths('![a](pics/a.png?v=1#x)'), ['pics/a.png'])
+        })
+
+        it('非字串回空陣列', function() {
+            assert.strict.deepEqual(scanAssetPaths(null), [])
+            assert.strict.deepEqual(scanAssetPaths(123), [])
+        })
+
+    })
+
+    describe('readAssets(讀本機檔)', function() {
+
+        let fdTmp = path.resolve('./tmp/zt_ApiClient_ra')
+
+        before(function() {
+            fs.mkdirSync(path.resolve(fdTmp, 'pics'), { recursive: true })
+            fs.writeFileSync(path.resolve(fdTmp, 'pics/圖.png'), 'IMG')
+            fs.writeFileSync(path.resolve(fdTmp, 'pics/a b.png'), 'IMG2')
+        })
+
+        after(function() {
+            fs.rmSync(fdTmp, { recursive: true, force: true })
+        })
+
+        it('URL編碼引用可對應解碼後實體檔, path保留原字串', function() {
+            let { assets, missing } = readAssets('![p](pics/%E5%9C%96.png)\n<img src="pics/a%20b.png">', fdTmp)
+            assert.strict.deepEqual(missing, [])
+            assert.strict.deepEqual(assets.map((v) => v.path), ['pics/a%20b.png', 'pics/%E5%9C%96.png'])
+            assert.strict.equal(Buffer.from(assets[1].base64, 'base64').toString('utf8'), 'IMG')
+        })
+
+        it('找不到者列入missing', function() {
+            let { assets, missing } = readAssets('![p](pics/圖.png)\n![n](pics/no.png)', fdTmp)
+            assert.strict.equal(assets.length, 1)
+            assert.strict.deepEqual(missing, ['pics/no.png'])
+        })
+
+        it('dirMd未給以cwd為基準', function() {
+            let { assets, missing } = readAssets('![c](test/cocktail.svg)')
+            assert.strict.equal(assets.length, 1)
+            assert.strict.deepEqual(missing, [])
+        })
+
+    })
+
+    describe('cvMdTo/health(對接ApiServer, html路徑不需Word)', function() {
+
+        let fdTmp = path.resolve('./tmp/zt_ApiClient')
+        let dirWork = path.resolve(fdTmp, 'work')
+        let token = 'tk-client'
+        let srv = null
+        let host = '127.0.0.1'
+        let port = 0
+        let url = ''
+        let fpOutHtml = path.resolve(fdTmp, 'out/report.html')
+
+        before(async function() {
+            fs.mkdirSync(fdTmp, { recursive: true })
+            srv = await ApiServer({ port: 0, host, token, dirWork })
+            port = srv.server.info.port
+            url = `http://${host}:${port}`
+        })
+
+        after(async function() {
+            if (srv) {
+                await srv.stop()
+            }
+            fs.rmSync(fdTmp, { recursive: true, force: true })
+        })
+
+        it('default export匯整四函數', function() {
+            assert.strict.deepEqual(Object.keys(ApiClient), ['cvMdTo', 'health', 'scanAssetPaths', 'readAssets'])
+            assert.strict.equal(ApiClient.cvMdTo, cvMdTo)
+        })
+
+        it('health', async function() {
+            let r = await health({ host, port, token })
+            assert.strict.equal(r.success, true)
+            assert.strict.equal(r.tokenRequired, true)
+            assert.strict.deepEqual(r.templates, ['temp_tpc.docx'])
+        })
+
+        it('host/port未給時取環境變數WMD2DOCX_HOST/WMD2DOCX_PORT', async function() {
+            process.env.WMD2DOCX_HOST = host
+            process.env.WMD2DOCX_PORT = String(port)
+            try {
+                let r = await health({ token })
+                assert.strict.equal(r.success, true)
+            }
+            finally {
+                delete process.env.WMD2DOCX_HOST
+                delete process.env.WMD2DOCX_PORT
+            }
+        })
+
+        it('host/port與環境變數皆未給時預設127.0.0.1:22000(與ApiServer預設埠一致)', async function() {
+            await assert.rejects(health({ token, timeoutMs: 3000 }), (e) => /^Unable to connect to the conversion service http:\/\/127\.0\.0\.1:22000: /.test(e) || /^Invalid response from the conversion service http:\/\/127\.0\.0\.1:22000/.test(e))
+        })
+
+        it('port非正整數視為未給', async function() {
+            await assert.rejects(health({ host, port: 'x', token, timeoutMs: 3000 }), (e) => /http:\/\/127\.0\.0\.1:22000/.test(e))
+        })
+
+        it('url給予時覆寫host/port', async function() {
+            let r = await health({ url, host: '10.255.255.1', port: 1, token })
+            assert.strict.equal(r.success, true)
+        })
+
+        it('health 連不上則reject', async function() {
+            await assert.rejects(health({ host: '127.0.0.1', port: 1, token, timeoutMs: 3000 }), (e) => /^Unable to connect to the conversion service http:\/\/127\.0\.0\.1:1: /.test(e))
+        })
+
+        it('cvMdTo fpOutHtml: 寫出檔案並回傳大小(自動夾帶md引用之圖)', async function() {
+            let r = await cvMdTo({ host, port, token, fpInMd: './test/report.md', fpOutHtml })
+            assert.strict.equal(r.nAssets, 1) //report.md 引用 ./cocktail.svg
+            assert.strict.equal(r.template, 'default')
+            assert.strict.equal(typeof r.ms, 'number')
+            assert.strict.equal(r.docx, undefined)
+            assert.strict.equal(r.html.fp, fpOutHtml)
+            assert.strict.equal(r.html.size, fs.statSync(fpOutHtml).size)
+            let h = fs.readFileSync(fpOutHtml, 'utf8')
+            assert.strict.equal(h.includes('計畫報告'), true)
+            assert.strict.equal(h.includes('<title>report</title>'), true) //name預設取md檔名
+            assert.strict.equal(h.includes('src="data:image/png;base64,'), true)
+        })
+
+        it('cvMdTo name/url尾斜線/環境變數token', async function() {
+            let fpOut2 = path.resolve(fdTmp, 'out/n.html')
+            process.env.WMD2DOCX_TOKEN = token
+            try {
+                let r = await cvMdTo({ url: `${url}///`, fpInMd: './test/report.md', fpOutHtml: fpOut2, name: '自訂名' })
+                assert.strict.equal(r.html.fp, fpOut2)
+                assert.strict.equal(fs.readFileSync(fpOut2, 'utf8').includes('<title>自訂名</title>'), true)
+            }
+            finally {
+                delete process.env.WMD2DOCX_TOKEN
+            }
+        })
+
+        it('cvMdTo 輸入檢查', async function() {
+            await assert.rejects(cvMdTo({ host, port, token, fpOutHtml }), (e) => e === 'fpInMd must be a non-empty string')
+            await assert.rejects(cvMdTo({ host, port, token, fpInMd: './test/nope.md', fpOutHtml }), (e) => /^fpInMd\[.+nope\.md\] does not exist$/.test(e))
+            await assert.rejects(cvMdTo({ host, port, token, fpInMd: './test/report.md', fpOutHtml, fpInTemp: './nope.docx' }), (e) => /^fpInTemp\[.+nope\.docx\] does not exist$/.test(e))
+        })
+
+        it('cvMdTo 資產缺漏預設reject, allowMissingAssets=true放行', async function() {
+            let fpMd = path.resolve(fdTmp, 'missing.md')
+            fs.writeFileSync(fpMd, '# m\n\n![x](nope.png)\n![y](nope2.png)\n', 'utf8')
+            await assert.rejects(cvMdTo({ host, port, token, fpInMd: fpMd, fpOutHtml }), (e) => e === '2 asset file(s) referenced in md do not exist: nope.png, nope2.png. Set allowMissingAssets:true to skip this check')
+            let r = await cvMdTo({ host, port, token, fpInMd: fpMd, fpOutHtml, allowMissingAssets: true })
+            assert.strict.equal(r.nAssets, 0)
+            assert.strict.equal(r.html.size > 0, true)
+        })
+
+        it('cvMdTo fpInTemp 以base64夾帶模板(template=request)', async function() {
+            let r = await cvMdTo({ host, port, token, fpInMd: './test/report.md', fpOutHtml, fpInTemp: './src/templates/temp_tpc.docx' })
+            assert.strict.equal(r.template, 'request')
+        })
+
+        it('cvMdTo templateName 指定服務端模板(template=server), 不存在則HTTP錯誤不重試', async function() {
+            let r = await cvMdTo({ host, port, token, fpInMd: './test/report.md', fpOutHtml, templateName: 'temp_tpc.docx' })
+            assert.strict.equal(r.template, 'server')
+            await assert.rejects(cvMdTo({ host, port, token, fpInMd: './test/report.md', fpOutHtml, templateName: 'nope.docx' }), (e) => e === 'Conversion failed: templateName[nope.docx] does not exist (available templates: temp_tpc.docx)')
+        })
+
+        it('cvMdTo token錯誤', async function() {
+            await assert.rejects(cvMdTo({ host, port, token: 'bad', fpInMd: './test/report.md', fpOutHtml }), (e) => e === 'Conversion failed: unauthorized: a valid x-api-token header is required')
+        })
+
+        it('cvMdTo 連不上: retries=0不重試', async function() {
+            let t0 = Date.now()
+            await assert.rejects(cvMdTo({ host: '127.0.0.1', port: 1, token, fpInMd: './test/report.md', fpOutHtml, retries: 0 }), (e) => /^Unable to connect to the conversion service http:\/\/127\.0\.0\.1:1 \(retried 0 times\): /.test(e))
+            assert.strict.equal(Date.now() - t0 < 3000, true) //無重試等待
+        })
+
+        it('cvMdTo 逾時: 不重試, 訊息含timeoutMs', async function() {
+            //以極短timeout使fetch逾時(轉檔需時>1ms)
+            await assert.rejects(cvMdTo({ host, port, token, fpInMd: './test/report.md', fpOutHtml, timeoutMs: 1 }), (e) => e === `Conversion timed out (no response within 1 ms): ${url}`)
+        })
+
+    })
+
+})

package/test/api-ApiServer.test.mjs

@@ -0,0 +1,191 @@
+import fs from 'fs'
+import path from 'path'
+import assert from 'assert'
+import ApiServer from '../src/ApiServer.mjs'
+
+
+//ApiServer: 直打HTTP端點(不經UI); docx相關以html路徵替代, 不需Word
+describe('ApiServer', function() {
+
+    let fdTmp = path.resolve('./tmp/zt_ApiServer')
+    let dirWork = path.resolve(fdTmp, 'work')
+    let token = 'tk-test'
+    let svgB64 = fs.readFileSync('./test/cocktail.svg').toString('base64')
+    let srv = null
+    let url = ''
+
+    let post = (body, q = '', tk = token) => {
+        let headers = { 'content-type': 'application/json' }
+        if (tk !== '') {
+            headers['x-api-token'] = tk
+        }
+        return fetch(`${url}/api/convert${q}`, { method: 'POST', headers, body: JSON.stringify(body) })
+    }
+
+    before(async function() {
+        fs.mkdirSync(fdTmp, { recursive: true })
+        srv = await ApiServer({ port: 0, host: '127.0.0.1', token, dirWork }) //port 0 由系統配置, 避免並行測試撞埠
+        url = `http://127.0.0.1:${srv.server.info.port}`
+    })
+
+    after(async function() {
+        if (srv) {
+            await srv.stop()
+        }
+        fs.rmSync(fdTmp, { recursive: true, force: true })
+    })
+
+    it('回傳物件與settings', function() {
+        assert.strict.equal(typeof srv.server.info.port, 'number')
+        assert.strict.equal(typeof srv.getState, 'function')
+        assert.strict.equal(typeof srv.stop, 'function')
+        assert.strict.equal(srv.settings.host, '127.0.0.1')
+        assert.strict.equal(srv.settings.token, token)
+        assert.strict.equal(srv.settings.maxMb, 256)
+        assert.strict.equal(srv.settings.maxBytes, 256 * 1024 * 1024)
+        assert.strict.equal(srv.settings.dirWork, dirWork)
+        assert.strict.equal(srv.settings.templateDef, 'temp_tpc.docx')
+        assert.strict.equal(/src[\\/]templates$/.test(srv.settings.dirTemplates), true) //預設模板夾為套件 src/templates
+        assert.strict.equal(fs.existsSync(dirWork), true) //啟動時建立工作夾
+    })
+
+    it('GET / 不需token, 回服務說明', async function() {
+        let res = await fetch(`${url}/`)
+        assert.strict.equal(res.status, 200)
+        let r = await res.json()
+        assert.strict.equal(r.service, 'w-md2docx')
+        assert.strict.deepEqual(Object.keys(r.endpoints), ['GET /api/health', 'GET /api/selftest', 'POST /api/convert'])
+    })
+
+    it('/api/* 無token或錯token回401', async function() {
+        let res = await fetch(`${url}/api/health`)
+        assert.strict.equal(res.status, 401)
+        let r = await res.json()
+        assert.strict.deepEqual(r, { success: false, error: 'unauthorized: a valid x-api-token header is required' })
+        let res2 = await post({ md: '# t', out: 'html' }, '', 'bad')
+        assert.strict.equal(res2.status, 401)
+    })
+
+    it('GET /api/health 回環境狀態', async function() {
+        let res = await fetch(`${url}/api/health`, { headers: { 'x-api-token': token } })
+        assert.strict.equal(res.status, 200)
+        let r = await res.json()
+        assert.strict.equal(r.success, true)
+        assert.strict.equal(r.platform, process.platform)
+        assert.strict.equal(r.node, process.version)
+        assert.strict.equal(r.tokenRequired, true)
+        assert.strict.equal(r.dirWork, dirWork)
+        assert.strict.deepEqual(r.templates, ['temp_tpc.docx'])
+        assert.strict.equal(/temp_tpc\.docx$/.test(r.templateDefault), true)
+        assert.strict.equal(r.queue, 0)
+        assert.strict.equal(typeof r.winwordProcesses, 'number')
+        assert.strict.equal(r.maxBytes, 256 * 1024 * 1024)
+        assert.strict.equal(typeof r.docxReady, 'boolean')
+        let st = await srv.getState()
+        assert.strict.equal(st.docxReady, r.docxReady)
+    })
+
+    it('POST /api/convert out=html: 回傳結構與資產內嵌', async function() {
+        let res = await post({
+            md: '# 標題A\n\n![p](pics/圖.svg)',
+            name: '報告',
+            out: 'html',
+            assets: [{ path: 'pics/圖.svg', base64: svgB64 }],
+        })
+        assert.strict.equal(res.status, 200)
+        let r = await res.json()
+        assert.strict.equal(r.success, true)
+        assert.strict.equal(r.name, '報告')
+        assert.strict.equal(r.out, 'html')
+        assert.strict.equal(r.nAssets, 1)
+        assert.strict.equal(r.template, 'default') //服務端預設模板(temp_tpc.docx)存在
+        assert.strict.equal(typeof r.ms, 'number')
+        assert.strict.equal(r.docx, undefined)
+        assert.strict.equal(r.html.fileName, '報告.html')
+        assert.strict.equal(r.html.mime, 'text/html; charset=utf-8')
+        let h = Buffer.from(r.html.base64, 'base64').toString('utf8')
+        assert.strict.equal(h.includes('標題A'), true)
+        assert.strict.equal(h.includes('src="data:image/png;base64,'), true)
+    })
+
+    it('POST /api/convert mdBase64 與 templateName 指定服務端模板', async function() {
+        let res = await post({ mdBase64: Buffer.from('# b64', 'utf8').toString('base64'), out: 'html', templateName: 'temp_tpc.docx' })
+        assert.strict.equal(res.status, 200)
+        let r = await res.json()
+        assert.strict.equal(r.template, 'server')
+    })
+
+    it('POST /api/convert templateBase64 夾帶模板, 用畢刪除暫存模板', async function() {
+        let tplB64 = fs.readFileSync('./src/templates/temp_tpc.docx').toString('base64')
+        let res = await post({ md: '# t', out: 'html', templateBase64: tplB64 })
+        assert.strict.equal(res.status, 200)
+        let r = await res.json()
+        assert.strict.equal(r.template, 'request')
+        assert.strict.equal(fs.readdirSync(dirWork).filter((v) => v.startsWith('tmpl_')).length, 0)
+    })
+
+    it('POST /api/convert 非JSON物件回400', async function() {
+        let res = await fetch(`${url}/api/convert`, { method: 'POST', headers: { 'content-type': 'application/json', 'x-api-token': token }, body: '"str"' })
+        assert.strict.equal(res.status, 400)
+        let r = await res.json()
+        assert.strict.deepEqual(r, { success: false, error: 'parameters must be provided as a JSON object' })
+    })
+
+    it('POST /api/convert 輸入錯誤回400(md為空/templateName不存在/資產穿越)', async function() {
+        let res1 = await post({ out: 'html' })
+        assert.strict.equal(res1.status, 400)
+        assert.strict.deepEqual(await res1.json(), { success: false, error: 'md is empty: md (string) or mdBase64 is required' })
+        let res2 = await post({ md: '# t', out: 'html', templateName: 'nope.docx' })
+        assert.strict.equal(res2.status, 400)
+        assert.strict.deepEqual(await res2.json(), { success: false, error: 'templateName[nope.docx] does not exist (available templates: temp_tpc.docx)' })
+        let res3 = await post({ md: '# t', out: 'html', assets: [{ path: '../x.png', base64: 'QUI=' }] })
+        assert.strict.equal(res3.status, 400)
+        assert.strict.deepEqual(await res3.json(), { success: false, error: 'asset.path is outside the working folder: ../x.png' })
+    })
+
+    it('POST /api/convert 轉檔錯誤(資產缺漏)回500', async function() {
+        let res = await post({ md: '# t\n\n<img src="no.png" />', out: 'html' })
+        assert.strict.equal(res.status, 500)
+        assert.strict.deepEqual(await res.json(), { success: false, error: 'Failed to convert md to html: the referenced file (no.png) does not exist, please make sure it is included in assets' })
+    })
+
+    it('POST /api/convert?download=1 單一格式直接回二進位, 中文檔名走filename*', async function() {
+        let res = await post({ md: '# hi', out: 'html', name: '報告' }, '?download=1')
+        assert.strict.equal(res.status, 200)
+        assert.strict.equal(res.headers.get('content-type').startsWith('text/html'), true)
+        assert.strict.equal(res.headers.get('content-disposition'), `attachment; filename="__.html"; filename*=UTF-8''%E5%A0%B1%E5%91%8A.html`)
+        let h = await res.text()
+        assert.strict.equal(h.includes('hi'), true)
+    })
+
+    it('POST /api/convert?download=true out=both 轉檔前即回400', async function() {
+        let res = await post({ md: '# hi', out: 'both' }, '?download=true')
+        assert.strict.equal(res.status, 400)
+        assert.strict.deepEqual(await res.json(), { success: false, error: 'download only supports out of html or docx (single format)' })
+    })
+
+    it('工作夾於請求後不殘留job_', async function() {
+        assert.strict.equal(fs.readdirSync(dirWork).filter((v) => v.startsWith('job_')).length, 0)
+    })
+
+    it('opt非法值採預設; autoStart=false不啟動', async function() {
+        let s2 = await ApiServer({ port: 'x', host: '', token: 5, maxMb: -1, templateDef: '', autoStart: false, dirWork: path.resolve(fdTmp, 'work2') })
+        assert.strict.equal(s2.settings.port, 22000)
+        assert.strict.equal(s2.settings.host, '0.0.0.0')
+        assert.strict.equal(s2.settings.token, '')
+        assert.strict.equal(s2.settings.maxMb, 256)
+        assert.strict.equal(s2.settings.templateDef, 'temp_tpc.docx')
+        assert.strict.equal(s2.server.info.started, 0) //未啟動
+        await s2.stop()
+    })
+
+    it('stop後不再回應', async function() {
+        let s3 = await ApiServer({ port: 0, host: '127.0.0.1', dirWork: path.resolve(fdTmp, 'work3') })
+        let u3 = `http://127.0.0.1:${s3.server.info.port}`
+        let res = await fetch(`${u3}/api/health`)
+        assert.strict.equal(res.status, 200) //無token時不需標頭
+        await s3.stop()
+        await assert.rejects(fetch(`${u3}/api/health`, { signal: AbortSignal.timeout(3000) }))
+    })
+
+})

package/test/cocktail.svg

@@ -0,0 +1,3 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Uploaded to: SVG Repo, www.svgrepo.com, Generator: SVG Repo Mixer Tools -->
+<svg width="800px" height="800px" viewBox="0 0 1024 1024" class="icon"  version="1.1" xmlns="http://www.w3.org/2000/svg"><path d="M948.6 703c-13.8 0-20.7-9.8-25.7-17-5.1-7.3-7.7-10.2-12.7-10.2s-7.5 3-12.7 10.2c-5.1 7.2-12 17-25.7 17-13.8 0-20.7-9.8-25.7-17-5.1-7.3-7.7-10.2-12.7-10.2s-7.5 3-12.7 10.2c-5.1 7.2-12 17-25.7 17s-20.7-9.8-25.7-17c-5.1-7.3-7.7-10.2-12.7-10.2-4.4 0-8-3.6-8-8s3.6-8 8-8c13.8 0 20.7 9.8 25.7 17 5.1 7.3 7.7 10.2 12.7 10.2 5 0 7.5-3 12.7-10.2 5.1-7.2 12-17 25.7-17 13.8 0 20.7 9.8 25.7 17 5.1 7.3 7.7 10.2 12.7 10.2 5 0 7.5-3 12.7-10.2 5.1-7.2 12-17 25.7-17s20.7 9.8 25.7 17c5.1 7.3 7.7 10.2 12.7 10.2 4.4 0 8 3.6 8 8s-3.6 8-8 8zM948.6 653c-13.8 0-20.7-9.8-25.7-17-5.1-7.3-7.7-10.2-12.7-10.2s-7.5 3-12.7 10.2c-5.1 7.2-12 17-25.7 17-13.8 0-20.7-9.8-25.7-17-5.1-7.3-7.7-10.2-12.7-10.2s-7.5 3-12.7 10.2c-5.1 7.2-12 17-25.7 17s-20.7-9.8-25.7-17c-5.1-7.3-7.7-10.2-12.7-10.2-4.4 0-8-3.6-8-8s3.6-8 8-8c13.8 0 20.7 9.8 25.7 17 5.1 7.3 7.7 10.2 12.7 10.2s7.5-3 12.7-10.2c5.1-7.2 12-17 25.7-17 13.8 0 20.7 9.8 25.7 17 5.1 7.3 7.7 10.2 12.7 10.2 5 0 7.5-3 12.7-10.2 5.1-7.2 12-17 25.7-17s20.7 9.8 25.7 17c5.1 7.3 7.7 10.2 12.7 10.2 4.4 0 8 3.6 8 8s-3.6 8-8 8zM261.6 282.9c-13.8 0-20.7-9.8-25.7-17-5.1-7.3-7.7-10.2-12.7-10.2s-7.5 3-12.7 10.2c-5.1 7.2-12 17-25.7 17-13.8 0-20.7-9.8-25.7-17-5.1-7.3-7.7-10.2-12.7-10.2-5 0-7.5 3-12.7 10.2-5.1 7.2-12 17-25.7 17-13.8 0-20.7-9.8-25.7-17-5.1-7.3-7.7-10.2-12.7-10.2-4.4 0-8-3.6-8-8s3.6-8 8-8c13.8 0 20.7 9.9 25.7 17 5.1 7.3 7.7 10.2 12.7 10.2 5 0 7.5-3 12.7-10.2 5.1-7.2 12-17 25.7-17 13.8 0 20.7 9.8 25.7 17 5.1 7.3 7.7 10.2 12.7 10.2 5 0 7.5-3 12.7-10.2 5.1-7.2 12-17 25.7-17s20.7 9.8 25.7 17c5.1 7.3 7.7 10.2 12.7 10.2 4.4 0 8 3.6 8 8s-3.6 8-8 8zM261.6 233c-13.8 0-20.7-9.8-25.7-17-5.1-7.3-7.7-10.2-12.7-10.2s-7.5 3-12.7 10.2c-5.1 7.2-12 17-25.7 17-13.8 0-20.7-9.8-25.7-17-5.1-7.3-7.7-10.2-12.7-10.2-5 0-7.5 3-12.7 10.2-5.1 7.2-12 17-25.7 17-13.8 0-20.7-9.8-25.7-17-5.1-7.3-7.7-10.2-12.7-10.2-4.4 0-8-3.6-8-8s3.6-8 8-8c13.8 0 20.7 9.8 25.7 17 5.1 7.3 7.7 10.2 12.7 10.2 5 0 7.5-3 12.7-10.2 5.1-7.2 12-17 25.7-17 13.8 0 20.7 9.8 25.7 17 5.1 7.3 7.7 10.2 12.7 10.2 5 0 7.5-3 12.7-10.2 5.1-7.2 12-17 25.7-17 13.8 0 20.7 9.8 25.7 17 5.1 7.3 7.7 10.2 12.7 10.2 4.4 0 8 3.6 8 8s-3.6 8-8 8z" fill="#9A2D2F" /><path d="M348.7 103.3m-32 0a32 32 0 1 0 64 0 32 32 0 1 0-64 0Z" fill="#FFEB4D" /><path d="M348.7 143.3c-22.1 0-40-17.9-40-40s17.9-40 40-40 40 17.9 40 40-18 40-40 40z m0-64c-13.2 0-24 10.8-24 24s10.8 24 24 24 24-10.8 24-24-10.8-24-24-24z" fill="#9A2D2F" /><path d="M554.1 408.8c58.3 0 105.5-47.2 105.5-105.5s-47.2-105.5-105.5-105.5S448.6 245 448.6 303.3s47.2 105.5 105.5 105.5z" fill="#C0FCD0" /><path d="M330.6 627.3l224-324h-448z" fill="#FFFFFF" /><path d="M500.6 381.3h-340l170 246z" fill="#FFACC2" /><path d="M330.6 613.2l54.5-78.8c-18.2 5.1-28.8 25.9-49.1 23.5-25.5-3-24-37.8-42.7-40.5-3.3-0.5-15.1-3.7-28 1.3l65.3 94.5z" fill="#FFFFFF" /><path d="M823.1 408.8c58.3 0 105.5-47.2 105.5-105.5s-47.2-105.5-105.5-105.5S717.6 245 717.6 303.3s47.2 105.5 105.5 105.5z" fill="#FFEB4D" /><path d="M599.6 627.3l224-324h-448z" fill="#FFFFFF" /><path d="M769.5 381.3h-340l170 246z" fill="#C0FCD0" /><path d="M599.6 613.2l54.5-78.8c-18.2 5.1-28.8 25.9-49.1 23.5-25.5-3-24-37.8-42.7-40.5-3.3-0.5-15.1-3.7-28 1.3l65.3 94.5z" fill="#FFFFFF" /><path d="M920.6 943.3H607.3V630.2l158.4-229.1c16.9 10 36.5 15.7 57.5 15.7 62.6 0 113.5-50.9 113.5-113.5s-50.9-113.5-113.5-113.5c-59.9 0-109.1 46.6-113.2 105.4h-42.6c-1.2-17.5-6.4-33.9-14.7-48.3-0.1-0.1-0.1-0.3-0.2-0.4-0.1-0.2-0.2-0.4-0.3-0.5-19.7-33.6-56.2-56.2-97.9-56.2s-78.2 22.6-97.9 56.2c-0.1 0.2-0.2 0.3-0.3 0.5-0.1 0.1-0.1 0.3-0.2 0.4-8.3 14.4-13.5 30.8-14.7 48.3h-65.3c-0.3 0-0.6 0-0.9 0.1H106.6c-3 0-5.7 1.7-7.1 4.3-1.4 2.6-1.2 5.8 0.5 8.3l222.6 321.9v313.5h-225c-4.4 0-8 3.6-8 8s3.6 8 8 8h823c4.4 0 8-3.6 8-8s-3.6-8-8-8z m-10.4-681c0.4-0.2 0.7-0.5 1-0.7 6 12.7 9.4 26.8 9.4 41.8s-3.4 29.1-9.4 41.8c-0.3-0.3-0.7-0.5-1-0.7l-71.1-41 71.1-41.2z m-6.9-14.4c-0.4 0.1-0.8 0.3-1.1 0.5l-71.1 41v-82.1c0-0.4 0-0.9-0.1-1.3 29.9 2.6 56.1 18.5 72.3 41.9z m-72.2 151.3v-82.1l71.1 41c0.4 0.2 0.7 0.4 1.1 0.5-16.2 23.4-42.4 39.4-72.3 41.8 0.1-0.3 0.1-0.7 0.1-1.2zM599.9 612.7h-0.6-0.1L466.9 421.3l-22.1-32h304.3c1.1 0.9 2.2 1.9 3.3 2.7L599.9 612.7z m174.8-224.8l40.4-58.4v69.7c0 0.4 0 0.9 0.1 1.3-14.6-1.2-28.3-5.6-40.5-12.6z m40.5-181.8c-0.1 0.4-0.1 0.8-0.1 1.3v82.1l-71.1-41c-0.4-0.2-0.7-0.4-1.1-0.5 16.2-23.5 42.4-39.4 72.3-41.9zM735 261.6c0.3 0.3 0.7 0.5 1 0.7l57.1 33h-67.2c1-12 4.2-23.4 9.1-33.7z m-92.7 0.1c4.9 10.3 8 21.7 9 33.6h-67.2l58.2-33.6z m-80.2-55.5c29.8 2.4 55.9 18.4 72.1 41.7l-72.1 41.6v-83.3z m-16 0v83.3L474 247.8c16.2-23.3 42.3-39.2 72.1-41.6zM466 261.7l58.2 33.6H457c0.9-12 4.1-23.3 9-33.6z m243.9 49.6H808.2L797 327.7l-31.5 45.6H433.7l-42.9-62h319.1z m-588 0h249.6l42.9 62H164.7l-42.8-62z m54 78h249.5l28.1 40.7 1.9 2.7-123.5 178.7c-0.4-0.1-0.8-0.1-1.3-0.1s-0.8 0-1.3 0.1L175.9 389.3z m162.7 240.5l126.5-183 126.1 182.5v314H338.6V629.8z" fill="#9A2D2F" /></svg>

package/test/report.md

@@ -0,0 +1,257 @@
+<div pretitle style="font-size:14pt; text-align:center;">
+    測試範例
+</div>
+
+# 計畫報告
+
+## 一、摘要
+
+本計畫旨在提升 **系統效能** 與 *資料處理品質*。  
+專案期間共完成三大目標：
+
+1. 資料流程自動化
+2. 系統效能優化
+3. 使用者介面改善
+
+> 「流程讓人專注，工具讓人加速。」—— 計畫紀錄語
+
+---
+
+## 二、背景與目的
+
+### 2.1 背景說明
+
+隨著資料量逐年增加，需要一套能：
+
+- 自動化處理
+- 智慧化調整
+- 高效能儲存
+
+的整合方案。
+
+### 2.2 計畫目的（含核取方塊）
+
+- [x] 建置自動化流程  
+- [x] 建立監控警示  
+- [ ] 完成第三方 API 串接（下一期目標）
+
+---
+
+## 三、工作項目與進度
+
+### 3.1 工作項目列表
+
+測試無序巢狀清單
+
+- **資料前處理**
+  - 格式轉換
+  - 欄位標準化
+  - 雜訊清理
+
+- **資料分析模組**
+  - 統計分析
+  - 時間序列模型
+    - ARIMA
+    - Prophet
+
+- **視覺化平台**
+  - 儀表板建立
+  - 自訂圖層呈現
+
+- **資料流程自動化**：各自獨立運行，且兼顧完整性與流程自動化之執行方式。
+
+- **使用者介面改善**：通過多人協作與回饋等方式，協助使用者介面改善。
+
+- **統計分析**
+
+    須說明統計分析之數學模型，以及輸出入之資料格式。
+
+- **時間序列模型**
+
+    須說明所採用之時間序列模型，包含數學基礎、演算法與回測之統計分析結果。
+
+測試有序巢狀清單
+
+1. **資料前處理**
+    - 格式轉換
+    - 欄位標準化
+    - 雜訊清理
+
+1. **資料分析模組**
+    - 統計分析
+    - 時間序列模型
+      - ARIMA
+      - Prophet
+
+1. **視覺化平台**
+    - 儀表板建立
+    - 自訂圖層呈現
+
+1. **資料流程自動化**：各自獨立運行，且兼顧完整性與流程自動化之執行方式。
+
+1. **使用者介面改善**：通過多人協作與回饋等方式，協助使用者介面改善。
+
+1. **統計分析**
+
+    須說明統計分析之數學模型，以及輸出入之資料格式。
+
+1. **時間序列模型**
+
+    須說明所採用之時間序列模型，包含數學基礎、演算法與回測之統計分析結果。
+
+---
+
+## 四、成果內容
+
+### 4.1 表格測試
+
+| 項目 | 完成度 | 備註 |
+|------|--------|------|
+| 自動化流程 | 100% | 已完成 |
+| 系統效能優化 | 95% | 尚可持續改善 |
+| 介面改善 | 80% | 預計下期延伸 |
+
+---
+
+### 4.1.1 表格字型大小標記（data-for="tab"）
+
+以空 div 標記於表格前，data-style-th／data-style-td 分別設定該表 th／td 字型大小，處理後標記自動移除。
+
+大字級表（th 16pt、td 13pt）：
+
+<div data-for="tab" data-style-th="font-size:16pt;" data-style-td="font-size:13pt;"></div>
+
+| 欄位 | 說明 |
+|------|------|
+| 甲 | 大字級示範 |
+| 乙 | 大字級示範 |
+
+小字級表（僅設 td 8pt，th 維持預設）：
+
+<div data-for="tab" data-style-td="font-size:8pt;"></div>
+
+| 代號 | 數量 |
+|------|------|
+| A | 1 |
+| B | 2 |
+
+---
+
+### 4.1.2 逐欄樣式標記（data-style-th-{n}／data-style-td-{n}）
+
+n 為 0 起算之欄索引（4 欄則 n=0~3），套用至該欄各列之 th／td。可與全域 data-style-th／data-style-td 併用，逐欄設定後套故可覆寫全域。
+
+下表：全欄 td 10pt（全域）；第 0 欄不換行（轉 docx 時文字不斷行）；第 1 欄表頭置中；第 2 欄字級縮小覆寫全域。
+
+<div data-for="tab" data-style-td="font-size:10pt;" data-style-td-0="white-space:nowrap;" data-style-th-1="text-align:center;" data-style-td-2="font-size:8pt;"></div>
+
+| 項目代號 | 狀態 | 備註說明 |
+|------|------|------|
+| A-001-XYZ | 完成 | 第二欄字級較小 |
+| B-002-ABC | 進行中 | 第二欄字級較小 |
+
+---
+
+### 4.2 程式碼區塊（JavaScript）
+
+```js
+import dayjs from 'dayjs'
+
+function calcPerformance(a, b) {
+  const diff = b - a
+  return {
+    start: a,
+    end: b,
+    improved: diff,
+    time: dayjs().format('YYYY-MM-DD HH:mm:ss')
+  }
+}
+
+console.log(calcPerformance(100, 260))
+```
+
+### 4.3 程式碼區塊（bash）
+
+```bash
+#!/bin/bash
+echo "Start processing..."
+python analyze.py --input=data.json --output=report.csv
+echo "Done."
+```
+
+---
+
+## 五、圖片、連結與註腳
+
+### 5.1 相關連結
+
+- 官方網站：https://example.com  
+- GitHub Repo: [點我連結](https://github.com/)  
+- 參考文獻：見文末註腳[^ref1]  
+
+### 5.2 圖片插入
+
+![測試圖片](./cocktail.svg)
+
+---
+
+## 六、結論與後續建議
+
+### 6.1 成果總結
+
+本計畫成功達成主要目標，並建立：
+
+- 模組化程式架構
+- 可擴充資料處理流程
+- 具彈性的視覺化平台
+
+### 6.2 後續建議
+
+1. 增加第三方 API 整合
+2. 加強 AI 模型訓練與部署
+3. 系統導入自動化測試（CI/CD）
+
+---
+
+## 七、附錄
+
+### 7.1 引用區塊層級
+
+> 第一層引用
+>> 第二層引用
+>>> 第三層引用
+
+---
+
+### 7.2 數學公式
+
+行內公式：$E = mc^2$
+
+區塊公式：
+
+$$
+y = ax^2 + bx + c
+$$
+
+---
+
+### 7.3 刪除隱藏元素
+
+<div style="margin:1rem 0;">
+    <div style="margin:1rem 0;">顯示文字</div>
+    <div style="margin:1rem 0; display:none;">不能顯示文字</div>
+</div>
+
+---
+
+### 7.4 特殊元素
+
+前段文字
+<div data-for="br"></div>
+後段文字
+
+---
+
+## 註腳
+
+[^ref1]: 本註腳示範 Markdown footnote 語法。