@qnroa/qtype 0.0.4 → 0.0.5

package/CHANGELOG.md

@@ -13,6 +13,24 @@ can land in any minor bump (`0.x.0`).
 
 ## [Unreleased]
 
+## [0.0.5] - 2026-08-22
+
+### Fixed
+
+- **Mermaid pre-render no longer fails under `npx` / hosted CI.**
+  `mermaidPrerender.init()` now uses `createRequire(import.meta.url).resolve('mermaid/…')`
+  to locate the mermaid ESM, so Node's own module resolver walks the
+  actual `node_modules` chain regardless of where qtype was installed
+  — user repo, npx cache, Cloudflare Pages build root, monorepo hoist.
+  The previous two hard-coded lookup paths remain as fallbacks but
+  are no longer the primary strategy. This fixes the
+  `mermaid ESM not found in node_modules` error on Cloudflare Pages
+  when a deck actually contains ` ```mermaid ` code blocks.
+- **`publish build` now copies `material/assets/**`** into
+  `dist/material/assets/` verbatim. Previously the CLI only walked
+  `.md` files, so any image the cards referenced via
+  `![](/material/assets/…)` returned 404 on the deployed site.
+
 ## [0.0.4] - 2026-08-22
 
 ### Added

package/CHANGELOG.zh.md

@@ -12,6 +12,22 @@ English: [CHANGELOG.md](https://www.npmjs.com/package/@qnroa/qtype?activeTab=cod
 
 ## [Unreleased]
 
+## [0.0.5] - 2026-08-22
+
+### 修复
+
+- **Mermaid 预渲染在 `npx` / 托管 CI 环境不再失败**。
+  `mermaidPrerender.init()` 改用
+  `createRequire(import.meta.url).resolve('mermaid/…')`,让 Node
+  自己顺着 `node_modules` 链找 mermaid,不管 qtype 是装到用户仓库、
+  npx 缓存、Cloudflare Pages build root 还是 monorepo hoist 都能
+  找到。之前的两条硬编码查找路径保留作为兜底,但不再是主要策略。
+  修复了 deck 里真的有 ` ```mermaid ` 代码块时,Cloudflare Pages 上
+  `mermaid ESM not found in node_modules` 报错。
+- **`publish build` 现在会把 `material/assets/**`** 原样拷进
+  `dist/material/assets/`。之前 CLI 只遍历 `.md` 文件,导致卡片
+  引用的 `![](/material/assets/…)` 图片在部署后 404。
+
 ## [0.0.4] - 2026-08-22
 
 ### 新增

package/dist/cli/commands/publish/build/mermaidPrerender.js

@@ -38,15 +38,37 @@ export class MermaidRenderer {
     pageDark = null;
     pageLight = null;
     async init() {
-        const candidates = [
-            path.resolve(__dirname, '..', '..', '..', '..', '..', 'node_modules', 'mermaid', 'dist', 'mermaid.esm.min.mjs'),
-            path.resolve(process.cwd(), 'node_modules', 'mermaid', 'dist', 'mermaid.esm.min.mjs'),
-        ];
+        // Ask Node's own module resolver where mermaid actually lives. It
+        // walks the `node_modules` chain from this file up, so it works
+        // regardless of where the caller installed qtype:
+        //
+        //   * user repo with `npm install @qnroa/qtype`      → resolves in
+        //                                                     `<user>/node_modules/mermaid`
+        //   * `npx @qnroa/qtype` on any host (Cloudflare,     → resolves in
+        //     Vercel, GitHub Pages) that hoists deps into      the npx cache
+        //     an npx cache
+        //   * monorepo with hoisted deps                     → resolves in
+        //                                                     the hoisted root
+        //
+        // The two hard-coded fallbacks below only fire if Node's resolver
+        // fails entirely (older Node, exotic packaging), which shouldn't
+        // happen in any supported deployment.
         let mermaidEsm = null;
-        for (const c of candidates) {
-            if (fs.existsSync(c)) {
-                mermaidEsm = c;
-                break;
+        try {
+            const { createRequire } = await import('node:module');
+            const req = createRequire(import.meta.url);
+            mermaidEsm = req.resolve('mermaid/dist/mermaid.esm.min.mjs');
+        }
+        catch {
+            const candidates = [
+                path.resolve(__dirname, '..', '..', '..', '..', '..', 'node_modules', 'mermaid', 'dist', 'mermaid.esm.min.mjs'),
+                path.resolve(process.cwd(), 'node_modules', 'mermaid', 'dist', 'mermaid.esm.min.mjs'),
+            ];
+            for (const c of candidates) {
+                if (fs.existsSync(c)) {
+                    mermaidEsm = c;
+                    break;
+                }
             }
         }
         if (!mermaidEsm) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qnroa/qtype",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "Turn Markdown notes into typing practice — CLI + review + static-site publisher",
   "keywords": [
     "typing",