Merge branch 'main' into ci/cr

docs/.vitepress/config.ts

@@ -65,7 +65,10 @@ export default defineConfig({
       transformerTwoslash({
         twoslashOptions: {
           // The @slidev/* installed in docs package are very old and should only be used in the homepage demo
-          vfsRoot: fileURLToPath(new URL('../../demo/starter/', import.meta.url)),
+          vfsRoot: fileURLToPath(import.meta.url),
+          compilerOptions: {
+            resolveJsonModule: true,
+          },
         },
       }),
     ],

docs/.vitepress/scripts/prepare.js

@@ -2,7 +2,7 @@ import { copy, remove } from 'fs-extra'
 
 async function main() {
   await remove('.vitepress/@slidev')
-  await copy('node_modules/@slidev', '.vitepress/@slidev', { dereference: true })
+  await copy('node_modules/@slidev-old', '.vitepress/@slidev', { dereference: true })
 }
 
 main()

docs/custom/config-code-runners.md

@@ -8,7 +8,12 @@ By default, JavaScript, TypeScript runners are supported built-in. They run in t
 
 Create `./setup/code-runners.ts` with the following content:
 
+<!-- eslint-disable import/first -->
+
 ```ts twoslash
+declare const executePythonCodeRemotely: (code: string) => Promise<string>
+declare const sanitizeHtml: (html: string) => string
+// ---cut---
 import { defineCodeRunnersSetup } from '@slidev/types'
 
 export default defineCodeRunnersSetup(() => {
@@ -35,6 +40,9 @@ export default defineCodeRunnersSetup(() => {
 The second argument `ctx` is the runner context, which contains the following properties:
 
 ```ts twoslash
+import type { CodeRunnerOutputs } from '@slidev/types'
+import type { CodeToHastOptions } from 'shiki'
+// ---cut---
 export interface CodeRunnerContext {
   /**
    * Options passed to runner via the `runnerOptions` prop.

docs/custom/config-context-menu.md

@@ -6,9 +6,16 @@ Customize the context menu items in Slidev.
 
 Create `./setup/context-menu.ts` with the following content:
 
+<!-- eslint-disable import/first -->
+
 ```ts twoslash
+// ---cut---
 import { defineContextMenuSetup } from '@slidev/types'
+import { useNav } from '@slidev/client'
 import { computed } from 'vue'
+// ---cut-start---
+// @ts-expect-error missing types
+// ---cut-end---
 import Icon3DCursor from '~icons/carbon/3d-cursor'
 
 export default defineContextMenuSetup((items) => {

docs/custom/config-highlighter.md

@@ -30,14 +30,15 @@ If you want to add custom theme or language (TextMate grammar/themes in JSON), y
 <!-- eslint-disable import/first-->
 
 ```ts twoslash
-declare module '*.tmTheme.json' {
-  const value: any
-  export default value
-}
-// ---cut---
 /* ./setup/shiki.ts */
 import { defineShikiSetup } from '@slidev/types'
+// ---cut-start---
+// @ts-expect-error missing types
+// ---cut-end---
 import customTheme from './customTheme.tmTheme.json'
+// ---cut-start---
+// @ts-expect-error missing types
+// ---cut-end---
 import customLanguage from './customLanguage.tmLanguage.json'
 
 export default defineShikiSetup(() => {

docs/custom/config-parser.md

@@ -1,7 +1,7 @@
 # Configure Pre-Parser
 
 ::: info
-Custom pre-parsers are not supposed to be used too often. Please only use it if you really want to have your custom syntax.
+Custom pre-parsers are not supposed to be used too often. Usually you can use [Transformers](./config-transformers) for custom syntaxes.
 :::
 
 Slidev parses your presentation file (e.g. `slides.md`) in three steps:
@@ -162,7 +162,7 @@ import { definePreparserSetup } from '@slidev/types'
 export default definePreparserSetup(() => {
   return [
     {
-      transformSlide(content, frontmatter) {
+      async transformSlide(content, frontmatter) {
         if ('_scale' in frontmatter) {
           return [
             `<Transform :scale=${frontmatter._scale}>`,

docs/custom/config-routes.md

@@ -16,6 +16,9 @@ export default defineRoutesSetup((routes) => {
     ...routes,
     {
       path: '/my-page',
+      // ---cut-start---
+      // @ts-expect-error missing types
+      // ---cut-end---
       component: () => import('../pages/my-page.vue'),
     },
   ]

docs/custom/config-vite.md

@@ -19,7 +19,13 @@ Slidev internally adds the following plugins to Vite:
 
 To configure the built-in plugins listed above, create a `vite.config.ts` with the following content. Please note that Slidev has some [default configurations](https://github.com/slidevjs/slidev/blob/main/packages/slidev/node/vite/index.ts) for those plugins, this usage will override some of them, which may potentially cause the app to break. Please treat this as **an advanced feature**, and make sure you know what you are doing before moving on.
 
+<!-- eslint-disable import/first -->
+
 ```ts twoslash
+/// <reference types="@slidev/types" />
+import type MarkdownIt from 'markdown-it'
+declare const MyPlugin: (md: MarkdownIt) => void
+// ---cut---
 import { defineConfig } from 'vite'
 
 export default defineConfig({
@@ -31,7 +37,7 @@ export default defineConfig({
       /* markdown-it options */
       markdownItSetup(md) {
         /* custom markdown-it plugins */
-        md.use(/* ... */)
+        md.use(MyPlugin/* ... */)
       },
     },
     /* options for other plugins */

docs/custom/config-vue.md

@@ -6,7 +6,12 @@ Slidev uses [Vue 3](https://v3.vuejs.org/) to render the application on the clie
 
 Create `./setup/main.ts` with the following content:
 
+<!-- eslint-disable import/first -->
+
 ```ts twoslash
+import type { Plugin } from 'vue'
+declare const YourPlugin: Plugin
+// ---cut---
 import { defineAppSetup } from '@slidev/types'
 
 export default defineAppSetup(({ app, router }) => {

docs/package.json

@@ -1,7 +1,7 @@
 {
   "name": "docs",
   "type": "module",
-  "version": "0.49.21",
+  "version": "0.49.22",
   "private": true,
   "packageManager": "pnpm@9.6.0",
   "scripts": {
@@ -17,10 +17,13 @@
   "devDependencies": {
     "@iconify/json": "^2.2.230",
     "@shikijs/vitepress-twoslash": "^1.11.1",
-    "@slidev/client": "0.34.3",
-    "@slidev/parser": "0.34.3",
-    "@slidev/theme-default": "0.21.2",
-    "@slidev/types": "0.34.3",
+    "@slidev-old/client": "npm:@slidev/client@0.34.3",
+    "@slidev-old/parser": "npm:@slidev/parser@0.34.3",
+    "@slidev-old/theme-default": "npm:@slidev/theme-default@0.21.2",
+    "@slidev-old/types": "npm:@slidev/types@0.34.3",
+    "@slidev/client": "workspace:*",
+    "@slidev/parser": "workspace:*",
+    "@slidev/types": "workspace:*",
     "@types/fs-extra": "^11.0.4",
     "@types/node": "^20.14.11",
     "@unocss/reset": "^0.61.5",

package.json

@@ -1,6 +1,6 @@
 {
   "type": "module",
-  "version": "0.49.21",
+  "version": "0.49.22",
   "private": true,
   "packageManager": "pnpm@9.6.0",
   "engines": {
@@ -21,7 +21,7 @@
     "lint:fix": "nr lint --fix",
     "typecheck": "vue-tsc --noEmit",
     "docs": "pnpm -C docs run dev",
-    "docs:build": "pnpm -C docs run build && pnpm demo:build",
+    "docs:build": "pnpm run --filter {./docs}... build && pnpm demo:build",
     "release": "bumpp package.json packages/*/package.json docs/package.json --all -x \"zx scripts/update-versions.mjs\"",
     "test": "vitest test",
     "prepare": "simple-git-hooks"

packages/client/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@slidev/client",
   "type": "module",
-  "version": "0.49.21",
+  "version": "0.49.22",
   "description": "Presentation slides for developers",
   "author": "antfu <anthonyfu117@hotmail.com>",
   "license": "MIT",

packages/create-app/package.json

@@ -1,7 +1,7 @@
 {
   "name": "create-slidev",
   "type": "module",
-  "version": "0.49.21",
+  "version": "0.49.22",
   "description": "Create starter template for Slidev",
   "author": "antfu <anthonyfu117@hotmail.com>",
   "license": "MIT",

packages/create-app/template/package.json

@@ -8,7 +8,7 @@
     "export": "slidev export"
   },
   "dependencies": {
-    "@slidev/cli": "^0.49.21",
+    "@slidev/cli": "^0.49.22",
     "@slidev/theme-default": "latest",
     "@slidev/theme-seriph": "latest",
     "vue": "^3.4.33"

packages/create-theme/package.json

@@ -1,7 +1,7 @@
 {
   "name": "create-slidev-theme",
   "type": "module",
-  "version": "0.49.21",
+  "version": "0.49.22",
   "description": "Create starter theme template for Slidev",
   "author": "antfu <anthonyfu117@hotmail.com>",
   "license": "MIT",

packages/create-theme/template/package.json

@@ -14,11 +14,11 @@
     "screenshot": "slidev export example.md --format png"
   },
   "dependencies": {
-    "@slidev/types": "^0.49.21",
+    "@slidev/types": "^0.49.22",
     "prism-theme-vars": "^0.2.5"
   },
   "devDependencies": {
-    "@slidev/cli": "^0.49.21"
+    "@slidev/cli": "^0.49.22"
   },
   "//": "Learn more: https://sli.dev/guide/write-theme.html",
   "slidev": {

packages/parser/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@slidev/parser",
-  "version": "0.49.21",
+  "version": "0.49.22",
   "description": "Markdown parser for Slidev",
   "author": "antfu <anthonyfu117@hotmail.com>",
   "license": "MIT",

packages/slidev/node/setups/transformers.ts

@@ -9,7 +9,7 @@ export default async function setupTransformers(roots: string[]) {
     postCodeblock: [],
     post: [],
   }
-  for (const r of returns.toReversed()) {
+  for (const r of [...returns].reverse()) {
     if (r.pre)
       result.pre.push(...r.pre)
     if (r.preCodeblock)

packages/slidev/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@slidev/cli",
   "type": "module",
-  "version": "0.49.21",
+  "version": "0.49.22",
   "description": "Presentation slides for developers",
   "author": "antfu <anthonyfu117@hotmail.com>",
   "license": "MIT",

packages/types/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@slidev/types",
-  "version": "0.49.21",
+  "version": "0.49.22",
   "description": "Shared types declarations for Slidev",
   "author": "antfu <anthonyfu117@hotmail.com>",
   "license": "MIT",

packages/vscode/package.json

@@ -4,7 +4,7 @@
   "displayName": "Slidev",
   "type": "module",
   "preview": true,
-  "version": "0.49.21",
+  "version": "0.49.22",
   "private": true,
   "description": "Slidev support for VS Code",
   "license": "MIT",