yanki 2.0.8 → 2.0.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yanki",
-  "version": "2.0.8",
+  "version": "2.0.10",
   "description": "A CLI tool and TypeScript library to turn Markdown into Anki flashcards.",
   "keywords": [
     "anki",
@@ -49,16 +49,16 @@
     "dist/*"
   ],
   "dependencies": {
-    "@shikijs/langs": "^4.0.2",
-    "@shikijs/rehype": "^4.0.2",
-    "@shikijs/themes": "^4.0.2",
+    "@shikijs/langs": "^4.3.0",
+    "@shikijs/rehype": "^4.3.0",
+    "@shikijs/themes": "^4.3.0",
     "@sindresorhus/fnv1a": "^3.1.0",
     "@sindresorhus/slugify": "^3.0.0",
     "@stdlib/assert-is-absolute-path": "^0.2.3",
     "@types/hast": "^3.0.4",
     "@types/lodash-es": "^4.17.12",
     "@types/mdast": "^4.0.4",
-    "@types/node": "~20.11.30",
+    "@types/node": "~20.19.43",
     "@types/unist": "^3.0.3",
     "@types/yargs": "^17.0.35",
     "crypto-hash": "^4.0.1",
@@ -70,7 +70,7 @@
     "mdast-util-from-markdown": "^2.0.3",
     "micromark-util-sanitize-uri": "^2.0.1",
     "micromark-util-types": "^2.0.2",
-    "nanoid": "^5.1.11",
+    "nanoid": "^5.1.16",
     "path-browserify-esm": "^1.0.6",
     "picocolors": "^1.1.1",
     "plur": "^6.0.0",
@@ -82,50 +82,50 @@
     "remark": "^15.0.1",
     "remark-breaks": "^4.0.0",
     "remark-denden-ruby": "^0.3.1",
-    "remark-flexible-markers": "^1.3.4",
+    "remark-flexible-markers": "^1.3.5",
     "remark-frontmatter": "^5.0.0",
     "remark-gfm": "^4.0.1",
     "remark-github-beta-blockquote-admonitions": "^3.1.2",
     "remark-math": "^6.0.0",
     "remark-parse": "^11.0.0",
     "remark-rehype": "^11.1.2",
-    "shiki": "^4.0.2",
+    "shiki": "^4.3.0",
     "slash": "^5.1.0",
-    "sort-keys": "^6.0.0",
+    "sort-keys": "^6.0.1",
     "strip-ansi": "^7.2.0",
-    "type-fest": "^5.6.0",
+    "type-fest": "^5.7.0",
     "uint8array-extras": "^1.5.0",
     "unified": "^11.0.5",
     "unist-builder": "^4.0.0",
     "unist-util-visit": "^5.1.0",
     "untildify": "^6.0.0",
     "yaml": "^2.9.0",
-    "yanki-connect": "^4.0.4",
+    "yanki-connect": "^4.0.6",
     "yargs": "^18.0.0"
   },
   "devDependencies": {
-    "@arethetypeswrong/cli": "^0.18.2",
-    "@kitschpatrol/shared-config": "^7.5.3",
-    "@vitest/browser-playwright": "^4.1.6",
-    "@vitest/coverage-v8": "^4.1.6",
+    "@arethetypeswrong/cli": "^0.18.4",
+    "@kitschpatrol/shared-config": "^8.0.0",
+    "@vitest/browser-playwright": "^4.1.9",
+    "@vitest/coverage-v8": "^4.1.9",
     "bumpp": "^11.1.0",
     "execa": "^9.6.1",
-    "mdat-plugin-cli-help": "^3.0.0",
-    "playwright": "^1.60.0",
-    "publint": "^0.3.20",
+    "mdat-plugin-cli-help": "^3.0.2",
+    "playwright": "^1.61.1",
+    "publint": "^0.3.21",
     "shx": "^0.4.0",
-    "tsdown": "^0.22.0",
-    "tsx": "^4.21.0",
-    "typescript": "~5.9.3",
-    "vitest": "^4.1.6"
+    "tsdown": "^0.22.3",
+    "tsx": "^4.22.4",
+    "typescript": "~6.0.3",
+    "vitest": "^4.1.9"
   },
   "engines": {
-    "node": ">=20.19.0"
+    "node": "^20.19.0 || >=22.12.0"
   },
   "devEngines": {
     "runtime": {
       "name": "node",
-      "version": ">=22.18.0"
+      "version": ">=24.16.0"
     }
   },
   "scripts": {
@@ -134,7 +134,7 @@
     "coverage": "vitest run --coverage",
     "fix": "ksc fix",
     "lint": "ksc lint",
-    "release": "bumpp --commit 'Release: %s' && pnpm build && NPM_AUTH_TOKEN=$(op read 'op://Personal/npm/token') && pnpm publish",
+    "release": "bumpp --commit 'Release: %s' && pnpm build && NPM_AUTH_TOKEN=$(op read 'op://Personal/npm/token') pnpm publish",
     "test": "vitest run"
   }
 }

package/readme.md

@@ -58,7 +58,7 @@ The "Y" prefix in "Yanki" is in the "Yet another" naming tradition; a nod to Ank
 
 ## Quick start
 
-Install [Node.js](https://nodejs.org) if you haven't already. (Yanki requires Node 20.11 or newer.)
+Install [Node.js](https://nodejs.org) if you haven't already. (Yanki requires Node 20.19 or newer.)
 
 Assuming you have a folder of Markdown note files, the [Anki app](https://apps.ankiweb.net) is open and has the [AnkiConnect](https://ankiweb.net/shared/info/2055492159) add-on installed:
 
@@ -170,6 +170,8 @@ The most minimal examples to "trigger" different note types are shown below, but
 
 You're free to use additional Markdown in your note files to style and structure the front and back of your flashcards.
 
+Note that you _can not_ mix Anki's native syntax (e.g. `{{c1::...` cloze markup) alongside your Yanki Markdown.
+
 ### Basic
 
 A **basic** card is created from any file with a `---`:
@@ -290,7 +292,7 @@ _If you delete one of several implicitly numbered clozes (e.g. `~~hidden~~`) fro
 
 ### Dependencies
 
-The `yanki` CLI tool requires Node 20.11+. The exported TypeScript / JavaScript APIs are isomorphic, and can run in both browser-based and Node runtime environments. The Yanki library is ESM-only, is implemented in TypeScript, and bundles a complete set of type definitions.
+The `yanki` CLI tool requires Node 20.19+. The exported TypeScript / JavaScript APIs are isomorphic, and can run in both browser-based and Node runtime environments. The Yanki library is ESM-only, is implemented in TypeScript, and bundles a complete set of type definitions.
 
 The tool has been tested on Windows, macOS, and Linux.
 
@@ -646,6 +648,8 @@ Linux testing was performed with Debian 12 and Ubuntu 22, both running on an arm
 
 - The Anki application lets you split the cards from a single note across multiple decks. (E.g. you might have a card with dozens of clozes, some of which you want to study under a different deck.) Yanki does _not_ support this scenario in the notes / cards it manages — it maintains a strict hierarchical relationship in which a note and its cards always live in a single deck. Notes may be deleted / recreated and study progress might be lost if this is attempted.
 
+- Anki does not let you use cloze syntax in note types that aren't explicitly configured to handle them. For this reason, don't [mix and match native Anki syntax](https://github.com/kitschpatrol/yanki/issues/18) alongside Yanki's Markdown syntax. If you do this, you risk receiving cryptic "cannot create note for unknown reason" errors from AnkiConnect.
+
 ## Maintainers
 
 [kitschpatrol](https://github.com/kitschpatrol)