@qnroa/qtype 0.0.2 → 0.0.3

package/templates/en/README.md

@@ -1,12 +1,12 @@
 # {{name}}
 
-An LLM-maintained **{{description}}** typing deck, following the [QTYPE spec](./QTYPE.md).
+An LLM-maintained **{{description}}** typing material, following the [QTYPE spec](./QTYPE.md).
 
 > You pick topics and throw in material. An LLM Agent produces structured Markdown cards. You practice typing; progress stays local.
 
 ## Scope
 
-<!-- Use a nested list to define the first- and second-level topics this deck covers, e.g.:
+<!-- Use a nested list to define the first- and second-level topics this material covers, e.g.:
 
 - **English**
   - GRE vocab: list 1 / list 2 / list 3
@@ -28,9 +28,9 @@ An LLM-maintained **{{description}}** typing deck, following the [QTYPE spec](./
 ├── GEMINI.md         # symlink → QTYPE.md (created by qtype init)
 ├── README.md         # this file (scope maintained by humans)
 ├── TODO.md           # gap list (Agent-maintained)
-├── index.md          # global deck index
+├── index.md          # global material index
 ├── log.md            # activity log (append-only)
-├── material/            # deck files (one .md per deck)
+├── material/            # material files (one .md per material)
 │   └── assets/<slug>/
 ├── raw/              # (optional) raw material for the Agent to process
 │   └── assets/<slug>/
@@ -41,12 +41,12 @@ An LLM-maintained **{{description}}** typing deck, following the [QTYPE spec](./
 
 | Operation | Trigger | Effect |
 |---|---|---|
-| ingest    | `ingest <path-or-topic>` | read material or generate → create/update deck → append log |
-| quiz-gen  | `generate <N> cards on <topic>` | build a new deck from a topic |
-| update    | `edit <field> in <deck-slug>` | modify an existing deck |
-| cascade   | `cascade check` | after editing one deck, sync related ones |
+| ingest    | `ingest <path-or-topic>` | read material or generate → create/update material → append log |
+| quiz-gen  | `generate <N> cards on <topic>` | build a new material from a topic |
+| update    | `edit <field> in <material-slug>` | modify an existing material |
+| cascade   | `cascade check` | after editing one material, sync related ones |
 | check     | `check` (or run the CLI) | validate card formatting |
-| level-up  | `merge/split <slug>` | reorganize too-small / too-large decks |
+| level-up  | `merge/split <slug>` | reorganize too-small / too-large materials |
 
 Full rules live in [QTYPE.md](./QTYPE.md).
 
@@ -54,10 +54,10 @@ Full rules live in [QTYPE.md](./QTYPE.md).
 
 | Command | Effect |
 |---|---|
-| `qtype check` | Validate deck files. **Read-only**, CI-friendly. |
+| `qtype check` | Validate material files. **Read-only**, CI-friendly. |
 | `qtype publish build` | Build a static site under `dist/`. |
 | `qtype publish serve` | Preview typing locally. |
-| `qtype pack` | Bundle the entire deck repo into a shareable archive. |
+| `qtype pack` | Bundle the entire material repo into a shareable archive. |
 
 ## Typing settings
 

package/templates/en/TODO.md

@@ -1,6 +1,6 @@
 # TODO
 
-Coverage gaps for this deck repo. Maintained by Agents through the standard operations; you may also edit it by hand.
+Coverage gaps for this material repo. Maintained by Agents through the standard operations; you may also edit it by hand.
 
 - [ ] missing
 - [ ] thin coverage

package/templates/en/material/article.md

@@ -0,0 +1,20 @@
+---
+title: Article example
+type: article
+tags: [example, article]
+created: 2026-01-01
+updated: 2026-08-22
+---
+
+# Morning ritual
+
+![sunrise](./assets/article/sunrise.svg)
+
+Wake up early. Drink a glass of water. Start typing for ten minutes.
+Consistency beats intensity — that is how habits compound over time.
+
+# On learning to type
+
+Typing well is less about speed and more about rhythm. If your hands
+feel calm, the words follow. Start slow, keep your errors low, and
+the speed comes on its own.

package/templates/en/material/assets/article/sunrise.svg

@@ -0,0 +1,12 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 200 200" fill="none" stroke="currentColor" stroke-width="3" stroke-linecap="round" stroke-linejoin="round" aria-label="sunrise">
+  <line x1="15" y1="140" x2="185" y2="140" />
+  <path d="M55 140 A 45 45 0 0 1 145 140" />
+  <line x1="100" y1="60" x2="100" y2="45" />
+  <line x1="55" y1="80" x2="45" y2="70" />
+  <line x1="145" y1="80" x2="155" y2="70" />
+  <line x1="30" y1="115" x2="15" y2="115" />
+  <line x1="170" y1="115" x2="185" y2="115" />
+  <line x1="15" y1="165" x2="60" y2="165" />
+  <line x1="75" y1="165" x2="125" y2="165" />
+  <line x1="140" y1="165" x2="185" y2="165" />
+</svg>

package/templates/en/material/assets/code/tree.svg

@@ -0,0 +1,19 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 260 200" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-label="binary tree">
+  <line x1="130" y1="35"  x2="70"  y2="90"  />
+  <line x1="130" y1="35"  x2="190" y2="90"  />
+  <line x1="70"  y1="90"  x2="35"  y2="150" />
+  <line x1="70"  y1="90"  x2="105" y2="150" />
+  <line x1="190" y1="90"  x2="225" y2="150" />
+  <circle cx="130" cy="35"  r="18" fill="var(--qt-base, #fff)" />
+  <circle cx="70"  cy="90"  r="18" fill="var(--qt-base, #fff)" />
+  <circle cx="190" cy="90"  r="18" fill="var(--qt-base, #fff)" />
+  <circle cx="35"  cy="150" r="18" fill="var(--qt-base, #fff)" />
+  <circle cx="105" cy="150" r="18" fill="var(--qt-base, #fff)" />
+  <circle cx="225" cy="150" r="18" fill="var(--qt-base, #fff)" />
+  <text x="130" y="40"  text-anchor="middle" font-family="ui-monospace, Menlo, monospace" font-size="14" fill="currentColor" stroke="none">1</text>
+  <text x="70"  y="95"  text-anchor="middle" font-family="ui-monospace, Menlo, monospace" font-size="14" fill="currentColor" stroke="none">2</text>
+  <text x="190" y="95"  text-anchor="middle" font-family="ui-monospace, Menlo, monospace" font-size="14" fill="currentColor" stroke="none">3</text>
+  <text x="35"  y="155" text-anchor="middle" font-family="ui-monospace, Menlo, monospace" font-size="14" fill="currentColor" stroke="none">4</text>
+  <text x="105" y="155" text-anchor="middle" font-family="ui-monospace, Menlo, monospace" font-size="14" fill="currentColor" stroke="none">5</text>
+  <text x="225" y="155" text-anchor="middle" font-family="ui-monospace, Menlo, monospace" font-size="14" fill="currentColor" stroke="none">6</text>
+</svg>

package/templates/en/material/assets/qa/login-flow.svg

@@ -0,0 +1,17 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 120" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-label="login flow">
+  <rect x="10"  y="35" width="70" height="50" rx="6" />
+  <rect x="125" y="35" width="70" height="50" rx="6" />
+  <rect x="240" y="35" width="70" height="50" rx="6" />
+  <text x="45"  y="65" text-anchor="middle" font-family="ui-sans-serif, system-ui" font-size="12" fill="currentColor" stroke="none">User</text>
+  <text x="160" y="65" text-anchor="middle" font-family="ui-sans-serif, system-ui" font-size="12" fill="currentColor" stroke="none">Client</text>
+  <text x="275" y="65" text-anchor="middle" font-family="ui-sans-serif, system-ui" font-size="12" fill="currentColor" stroke="none">Server</text>
+  <line x1="80"  y1="60" x2="120" y2="60" />
+  <polyline points="115,55 125,60 115,65" />
+  <line x1="195" y1="60" x2="235" y2="60" />
+  <polyline points="230,55 240,60 230,65" />
+  <text x="103" y="30" text-anchor="middle" font-family="ui-sans-serif, system-ui" font-size="10" fill="currentColor" stroke="none">creds</text>
+  <text x="217" y="30" text-anchor="middle" font-family="ui-sans-serif, system-ui" font-size="10" fill="currentColor" stroke="none">POST /login</text>
+  <line x1="240" y1="95" x2="80" y2="95" />
+  <polyline points="85,90 75,95 85,100" />
+  <text x="160" y="112" text-anchor="middle" font-family="ui-sans-serif, system-ui" font-size="10" fill="currentColor" stroke="none">token</text>
+</svg>

package/templates/en/material/assets/sentence/pangram.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 200 200" fill="none" stroke="currentColor" stroke-width="3" stroke-linecap="round" stroke-linejoin="round" aria-label="a-to-z">
+  <text x="100" y="90" text-anchor="middle" font-family="ui-serif, Georgia, serif" font-size="52" font-style="italic" fill="currentColor" stroke="none">A</text>
+  <text x="100" y="150" text-anchor="middle" font-family="ui-serif, Georgia, serif" font-size="52" font-style="italic" fill="currentColor" stroke="none">Z</text>
+  <line x1="80" y1="105" x2="120" y2="105" />
+  <path d="M60 170 Q 100 180 140 170" />
+</svg>

package/templates/en/material/assets/snippet/moon.svg

@@ -0,0 +1,8 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 200 200" fill="none" stroke="currentColor" stroke-width="3" stroke-linecap="round" stroke-linejoin="round" aria-label="crescent moon">
+  <path d="M130 40 A 70 70 0 1 0 130 160 A 55 55 0 1 1 130 40 Z" />
+  <circle cx="55" cy="55" r="2" fill="currentColor" />
+  <circle cx="45" cy="90" r="1.6" fill="currentColor" />
+  <circle cx="75" cy="35" r="1.6" fill="currentColor" />
+  <circle cx="35" cy="135" r="2" fill="currentColor" />
+  <circle cx="60" cy="155" r="1.4" fill="currentColor" />
+</svg>

package/templates/en/material/assets/word/apple.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 200 200" fill="none" stroke="currentColor" stroke-width="3" stroke-linecap="round" stroke-linejoin="round" aria-label="apple">
+  <path d="M100 60 C 80 40, 55 50, 55 90 C 55 130, 80 165, 100 165 C 120 165, 145 130, 145 90 C 145 50, 120 40, 100 60 Z" />
+  <path d="M100 60 C 100 45, 105 30, 118 22" />
+  <path d="M100 60 C 92 52, 88 42, 90 30 C 100 30, 108 42, 108 52" fill="currentColor" fill-opacity="0.15" />
+</svg>

package/templates/en/material/code.md

@@ -0,0 +1,55 @@
+---
+title: Code example
+type: code
+tags: [example, code]
+created: 2026-01-01
+updated: 2026-08-22
+---
+
+# Binary tree in-order traversal
+
+## Q
+From the tree below, write an iterative in-order traversal:
+
+![binary tree](./assets/code/tree.svg)
+
+## A
+```py
+def inorder(root):
+    stack, result = [], []
+    while root or stack:
+        while root:
+            stack.append(root)
+            root = root.left
+        root = stack.pop()
+        result.append(root.val)
+        root = root.right
+    return result
+```
+
+# Two Sum
+
+## Q
+Given an array `nums` and a target integer, return the indices of the two numbers that add up to `target`.
+
+## A
+```py
+def two_sum(nums, target):
+    seen = {}
+    for i, x in enumerate(nums):
+        if target - x in seen:
+            return [seen[target - x], i]
+        seen[x] = i
+```
+
+# Reverse a string
+
+## Q
+Write a TypeScript function that reverses a string.
+
+## A
+```ts
+function reverse(s: string): string {
+  return s.split('').reverse().join('')
+}
+```

package/templates/en/material/qa.md

@@ -0,0 +1,33 @@
+---
+title: Q&A example
+type: qa
+tags: [example, qa]
+created: 2026-01-01
+updated: 2026-08-22
+---
+
+# Describe the login flow
+
+## Q
+Describe the user login flow shown in the diagram below:
+
+![login flow](./assets/qa/login-flow.svg)
+
+## A
+The user submits credentials, the client POSTs /login, and the server verifies them and returns a token.
+
+# What is a closure
+
+## Q
+Explain what a JavaScript closure is in one sentence.
+
+## A
+A closure is a function bundled with the lexical scope in which it was born — after the outer function returns, the inner function can still reach the outer variables.
+
+# The event loop
+
+## Q
+How does the browser event loop work at a high level?
+
+## A
+The main thread runs the current task to completion, then pulls the next task off the queue; microtasks generated in between are drained between tasks.

package/templates/en/material/sentence.md

@@ -0,0 +1,18 @@
+---
+title: Sentence example
+type: sentence
+tags: [example, sentence]
+created: 2026-01-01
+updated: 2026-08-22
+---
+
+# The quick brown fox jumps over the lazy dog.
+## /ðə kwɪk braʊn fɑks/
+### The classic English pangram — every letter A–Z appears once.
+#### ![A-Z](./assets/sentence/pangram.svg)
+
+# Practice makes perfect.
+### With enough practice, anything becomes easy.
+
+# Simplicity is the ultimate sophistication.
+### Attributed to Leonardo da Vinci.

package/templates/en/material/snippet.md

@@ -0,0 +1,17 @@
+---
+title: Snippet example
+type: snippet
+tags: [example, snippet]
+created: 2026-01-01
+updated: 2026-08-22
+---
+
+# Simplicity is the ultimate sophistication.
+
+![moonlight](./assets/snippet/moon.svg)
+
+— Attributed to Leonardo da Vinci
+
+# Fortune favors the prepared mind.
+
+— Louis Pasteur

package/templates/en/material/word.md

@@ -0,0 +1,20 @@
+---
+title: Word example
+type: word
+tags: [example, word]
+created: 2026-01-01
+updated: 2026-08-22
+---
+
+# apple
+## /ˈæp.əl/
+### the fruit
+#### ![apple](./assets/word/apple.svg)
+
+# ephemeral
+## /əˈfem(ə)rəl/
+### short-lived, transient
+
+# serendipity
+## /ˌser.ənˈdɪp.ə.ti/
+### the occurrence of finding pleasant things by chance