@qnroa/qtype 0.0.5 → 0.0.7

package/dist/view/assets/{index-DIBSxFYl.js → index-DNcGZhd7.js}

@@ -1,3 +1,3 @@
-const __vite__mapDeps=(i,m=__vite__mapDeps,d=(m.f||(m.f=["assets/index-DgHvnMV9.js","assets/index-1XXyxiQO.js","assets/index-BLryk3W4.css"])))=>i.map(i=>d[i]);
-import{r as l,_ as h,u as g,j as f,C as p,M as m,T as y,a as w}from"./index-1XXyxiQO.js";let o=null,c=null;async function L(){return o||c||(c=h(()=>import("./index-DgHvnMV9.js"),__vite__mapDeps([0,1,2])).then(async e=>(o=await e.createHighlighter({themes:["github-dark","github-light"],langs:[]}),o)),c)}async function _(e,t){if(!e.getLoadedLanguages().includes(t))try{await e.loadLanguage(t)}catch{}}function x(e){const[t,n]=l.useState(o);return l.useEffect(()=>{if(!e)return;let r=!1;return(async()=>{const s=await L();await _(s,e),r||n(s)})(),()=>{r=!0}},[e]),t}const A=/```(\w+)/;function E(e){const t=e.toLowerCase();return t.includes("typescript")||t.endsWith(".ts")?"typescript":t.includes("python")||t.endsWith(".py")?"python":t.includes("cpp")||t.includes("c++")?"cpp":t.includes("java")&&!t.includes("script")?"java":t.includes("go")?"go":t.includes("rust")||t.endsWith(".rs")?"rust":t.includes("code-c")||t.endsWith(".c")?"c":"javascript"}function j(e,t){if(e){const n=e.match(A);if(n)return n[1]}return E(t)}function k(e,t,n,r){if(!r||!r.getLoadedLanguages().includes(t))return new Array(Array.from(e).length).fill(null);try{const s=r.codeToTokens(e,{lang:t,theme:n}),i=[];for(const u of s.tokens){for(const a of u)for(const d of a.content)i.push(a.color??null);i.push(null)}return!e.endsWith(`
+const __vite__mapDeps=(i,m=__vite__mapDeps,d=(m.f||(m.f=["assets/index-BM7BgXjn.js","assets/index-C1KzsLUa.js","assets/index-BLryk3W4.css"])))=>i.map(i=>d[i]);
+import{r as l,_ as h,u as g,j as f,C as p,M as m,T as y,a as w}from"./index-C1KzsLUa.js";let o=null,c=null;async function L(){return o||c||(c=h(()=>import("./index-BM7BgXjn.js"),__vite__mapDeps([0,1,2])).then(async e=>(o=await e.createHighlighter({themes:["github-dark","github-light"],langs:[]}),o)),c)}async function _(e,t){if(!e.getLoadedLanguages().includes(t))try{await e.loadLanguage(t)}catch{}}function x(e){const[t,n]=l.useState(o);return l.useEffect(()=>{if(!e)return;let r=!1;return(async()=>{const s=await L();await _(s,e),r||n(s)})(),()=>{r=!0}},[e]),t}const A=/```(\w+)/;function E(e){const t=e.toLowerCase();return t.includes("typescript")||t.endsWith(".ts")?"typescript":t.includes("python")||t.endsWith(".py")?"python":t.includes("cpp")||t.includes("c++")?"cpp":t.includes("java")&&!t.includes("script")?"java":t.includes("go")?"go":t.includes("rust")||t.endsWith(".rs")?"rust":t.includes("code-c")||t.endsWith(".c")?"c":"javascript"}function j(e,t){if(e){const n=e.match(A);if(n)return n[1]}return E(t)}function k(e,t,n,r){if(!r||!r.getLoadedLanguages().includes(t))return new Array(Array.from(e).length).fill(null);try{const s=r.codeToTokens(e,{lang:t,theme:n}),i=[];for(const u of s.tokens){for(const a of u)for(const d of a.content)i.push(a.color??null);i.push(null)}return!e.endsWith(`
 `)&&i.length>Array.from(e).length&&i.pop(),i}catch{return new Array(Array.from(e).length).fill(null)}}function v(e){var d;const{material:t,card:n}=e,[r]=g(),s=l.useMemo(()=>r?j(n.question,t.filePath):"",[n.question,t.filePath,r]),i=typeof document<"u"&&((d=document.documentElement.getAttribute("data-theme"))!=null&&d.includes("latte"))?"github-light":"github-dark",u=x(r?s:""),a=l.useMemo(()=>r?k(n.answer,s,i,u):void 0,[n.answer,s,i,u,r]);return f.jsx(p,{type:"code",variant:"flow",slots:[{role:"title",content:n.title},n.question?{role:"question",content:f.jsx(m,{source:n.question})}:{role:"question",content:null},{role:"arena",content:f.jsx(y,{...w(e),charColors:a},n.id)}]})}export{v as CodeCard};

package/dist/view/index.html

@@ -13,7 +13,7 @@
     <meta name="referrer" content="no-referrer" />
     <link rel="icon" type="image/svg+xml" href="/qtype-mark.svg" />
     <title>qtype — 打字复习</title>
-    <script type="module" crossorigin src="/assets/index-1XXyxiQO.js"></script>
+    <script type="module" crossorigin src="/assets/index-C1KzsLUa.js"></script>
     <link rel="stylesheet" crossorigin href="/assets/index-BLryk3W4.css">
   </head>
   <body>

package/package.json

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

package/templates/en/QTYPE.md

@@ -41,7 +41,8 @@ The whole document is organized into four modules: **Concepts / Format / Operati
 ├── qtype.config.json
 ├── material/
 │   ├── .gitkeep
-│   ├── <slug>.md
+│   ├── <slug>.md                    # flat placement — fine
+│   ├── <category>/<slug>.md         # nested placement — also fine
 │   └── assets/<material-slug>/
 └── raw/
     ├── .gitkeep
@@ -49,6 +50,8 @@ The whole document is organized into four modules: **Concepts / Format / Operati
     └── assets/<raw-slug>/
 ```
 
+**Flat and nested placements are both supported.** All `.md` under `material/` are discovered recursively. Choose whichever fits the repo — small repos are usually flat, larger ones group by category folder.
+
 ---
 
 ## Format
@@ -68,13 +71,58 @@ updated: YYYY-MM-DD
 ```
 
 - `title`: human-readable
-- `type`: **required**. Decides how every card is parsed and rendered
-- `tags`: array or space-separated
+- `type`: **default** for every card in the file. Individual cards can
+  override via card-level frontmatter (see below).
+- `tags`: default tag set for every card. Card-level tags are unioned
+  with these (deduped).
 - `created` / `updated`: dates. Bump `updated` on any content change
 
-**One material, one type. All cards in a file share the same shape.**
+**Material-level fields set defaults; cards can override.** A single
+file can mix qa / code / article / etc. by giving each card its own
+`type` in card-level frontmatter.
+
+### Card-level frontmatter (optional)
+
+Immediately after an H1, you may open a second YAML block. It uses the
+same `---\n...\n---` syntax as the file-level frontmatter:
+
+```md
+---
+title: 704 Binary search
+type: qa
+tags: [algo]
+---
 
-There is **no card-level frontmatter**. All per-card info lives in markdown structure.
+# Principle
+---
+type: qa
+tags: [L1]
+---
+
+## Q
+Which invariant do I keep for the closed interval version?
+
+## A
+Loop while lo <= hi; update `lo = mid+1` / `hi = mid-1`.
+
+# C++ implementation
+---
+type: code
+tags: [cpp, L1]
+---
+
+## Q
+Write the closed-interval binary search in C++.
+
+## A
+​```cpp
+int search(vector<int>& nums, int target) { ... }
+​```
+```
+
+- `type` (if present) overrides the material default for this one card.
+- `tags` (if present) are unioned with material tags and deduped.
+- Omit the block entirely and the card inherits both fields as-is.
 
 ### Card structure
 
@@ -231,11 +279,21 @@ sqrt(pi)
 
 ### Naming
 
-Material files: `material/<slug>.md`
-- kebab-case, ASCII lowercase + hyphens, ≤ 60 chars
+Material files: `material/<slug>.md` — or `material/<category>/<slug>.md` if grouping by folder.
+
+- Each path segment (`<slug>`, `<category>`) uses the same rules: kebab-case, ASCII lowercase + hyphens, ≤ 60 chars
 - Chinese topics: use English translation or pinyin
 - Collision: append `-2` / `-3`
 
+### Grouping by folder (optional)
+
+`material/` may contain category subfolders. Two things to know when you use them:
+
+- **Discovery is recursive.** All `.md` files under `material/` are picked up regardless of depth. Nested folders don't hide their contents.
+- **The first path segment is a fallback `type`.** When a material's frontmatter omits `type`, the first folder name is used instead — e.g. a file at `material/code/hello.md` with no `type:` line is treated as `type: code`. This is a shortcut for repos organized by type folder; explicit `type:` in frontmatter always wins.
+
+Group by folder when the repo has many materials of clearly different subjects (e.g. `skills/`, `experience/`, `projects/`, `code/`). Stay flat when there are only a handful of files — extra folders add friction without payoff.
+
 ### Links
 
 - **Markdown link syntax only**, no Wikilinks
@@ -256,7 +314,9 @@ Ingest, Update, Quiz-gen, Cascade, Check, Level-up — semantics as before. Key
 - Concept questions, interviews → **qa**
 - Coding problems, snippets → **code**
 
-**One material, one type.** Mixed content → multiple materials.
+**Material-level `type` is the default for its cards.** Cards can
+override with card-level frontmatter, so one file can mix shapes
+(e.g. one qa "principle" card + four code cards for cpp/py/go/java).
 
 ---
 
@@ -272,7 +332,7 @@ Ingest, Update, Quiz-gen, Cascade, Check, Level-up — semantics as before. Key
 6. **No Wikilinks**
 7. **No absolute paths**
 8. **Never `git commit` / `push`** — the user commits
-9. **No unspec'd directories** — flat `material/` + `assets/` only
+9. **No unspec'd directories** — only `material/` (may contain category subfolders, see "Grouping by folder"), `material/assets/`, and `raw/` are allowed at the repo root
 10. **Never fabricate IPA / gloss / translation** — leave blank, report in log
-11. **One `type` per material** — no mixing
-12. **No card-level frontmatter** — per-card info lives in markdown structure
+11. **Material-level `type` is a default** — cards can override via
+    card-level frontmatter (see "Card-level frontmatter (optional)")

package/templates/zh/QTYPE.md

@@ -43,8 +43,9 @@ qtype 是一个以 Markdown 为源、以 OS 键盘（含中文 IME）为输入
 ├── qtype.config.json  # 用户可调设置
 ├── material/          # 你写的素材
 │   ├── .gitkeep
-│   ├── <slug>.md      # 一个素材一个文件
-│   └── assets/        # 素材引用的图片
+│   ├── <slug>.md              # 平铺放法 —— 可以
+│   ├── <category>/<slug>.md   # 按分类嵌套 —— 也可以
+│   └── assets/                # 素材引用的图片
 │       └── <material-slug>/
 └── raw/               # （可选）用户扔进来的原始材料
     ├── .gitkeep
@@ -52,6 +53,8 @@ qtype 是一个以 Markdown 为源、以 OS 键盘（含中文 IME）为输入
     └── assets/
 ```
 
+**平铺和嵌套都支持**：`material/` 下所有 `.md` 会被递归发现，深几层都能扫到。文件少时平铺就够了，文件多时按分类开子目录更清爽。
+
 ---
 
 ## 格式
@@ -73,12 +76,55 @@ updated: YYYY-MM-DD
 **规则**：
 
 - `title`：素材标题，人看的
-- `type`：**必填**，决定所有卡片的解析规则和渲染样式
-- `tags`：数组或空格分隔，至少一个
+- `type`：**默认值**，决定每张卡的解析规则和渲染样式。单卡可通过
+  card-level frontmatter 覆盖(见下)。
+- `tags`：素材级 tag 集,和 card-level tag 合并去重
 - `created` / `updated`：日期。内容变化时 bump `updated`
-- **一个 material 只有一个 type**，一个文件的所有卡片形态一致
 
-**没有 card-level frontmatter**。所有卡片信息都由 markdown 结构表达。
+**素材级 type 是默认值，卡片可以 override。** 一个文件里可以混合
+qa / code / article 等多种卡型 —— 只需要给对应的卡加卡级 frontmatter。
+
+### 卡级 frontmatter（可选）
+
+H1 之后可以再写一段 YAML,和文件顶部一样用 `---\n...\n---` 包起来:
+
+```md
+---
+title: 704 二分查找
+type: qa
+tags: [algo]
+---
+
+# 原理
+---
+type: qa
+tags: [L1]
+---
+
+## Q
+左闭右闭需要保持什么循环不变量?
+
+## A
+while lo <= hi;更新 `lo = mid+1` 或 `hi = mid-1`。
+
+# C++ 实现
+---
+type: code
+tags: [cpp, L1]
+---
+
+## Q
+用 C++ 写左闭右闭版本。
+
+## A
+​```cpp
+int search(vector<int>& nums, int target) { ... }
+​```
+```
+
+- 卡级 `type` 存在则覆盖素材默认
+- 卡级 `tags` 存在则和素材 tags 并集(去重)
+- 卡级 frontmatter 完全省略则继承素材默认
 
 ### Card 结构
 
@@ -259,12 +305,21 @@ sqrt(pi)
 
 ### 命名
 
-**素材文件名**：`material/<slug>.md`
+**素材文件名**：`material/<slug>.md` —— 或者按分类嵌套时 `material/<category>/<slug>.md`。
 
-- `<slug>`：主题的 kebab-case，小写，英文字母和短横线，最长 60 字符
+- 每一段路径（`<slug>`、`<category>`）都用同一套规则：kebab-case，小写，英文字母和短横线，最长 60 字符
 - 中文主题用英译或拼音
 - 同名冲突：末尾追加 `-2` / `-3`
 
+### 按分类分子目录（可选）
+
+`material/` 下可以开分类子目录。启用时需要知道两件事：
+
+- **发现是递归的**。`material/` 下所有 `.md` 文件不论深度都会被扫到，嵌套目录不会被跳过
+- **首段路径充当 `type` 的 fallback**。如果一个 material 的 frontmatter 没有写 `type`，第一段目录名会被当作 type —— 比如 `material/code/hello.md` 不写 `type:` 会被视为 `type: code`。这是给"按 type 分目录"的仓库的捷径；只要 frontmatter 里显式写了 `type`，永远以 frontmatter 为准。
+
+素材数量多、主题差异明显时（比如 `skills/` / `experience/` / `projects/` / `code/`）用子目录归类；素材只有几个时保持平铺就好，多开一层目录只会增摩擦不增收益。
+
 ### 链接
 
 - **只用 Markdown link**，不用 Wikilink
@@ -314,7 +369,8 @@ updated: YYYY-MM-DD
 - 问答、面试题、概念解释 → **qa**
 - 代码题、算法题、片段 → **code**
 
-**一个 material 只有一个 type**。混合内容拆成多个 material。
+**素材级 `type` 是默认值。** 一个文件里可以混合多种卡型 —— 靠卡级
+frontmatter 覆盖(比如 1 张 qa 原理卡 + 4 张不同语言的 code 实现卡)。
 
 ---
 
@@ -330,7 +386,7 @@ updated: YYYY-MM-DD
 6. **不用 Wikilink**
 7. **不绝对路径**
 8. **不主动 git commit / push**
-9. **不建规则外的目录**
+9. **不建规则外的目录**：仓库根下只允许 `material/`（内部可按分类开子目录，见"按分类分子目录"）、`material/assets/`、`raw/`
 10. **不凭空造 IPA / 释义 / 翻译**：不确定的宁可空着
-11. **一个 material 只有一个 type**：不能混
-12. **没有 card-level frontmatter**：所有 per-card 信息都用 markdown 结构表达
+11. **素材级 `type` 是默认值**：卡片可以通过卡级 frontmatter 覆盖
+    (见"卡级 frontmatter(可选)"章节)