---
toc_max_heading_level: 2
sidebar_position: 3
sidebar_label: "Change Logs"
sidebar_custom_props:
section: "Releases"
section_position: 3
---
# Changelog
## `@sp-days-framework/docusaurus-plugin-slidev`
[](https://www.npmjs.com/package/@sp-days-framework/docusaurus-plugin-slidev)
:::note
All packages within `@sp-days-framework` use the same version number. In some cases, a package might just be "bumped" to match the rest without any functional changes.
:::
---
## Version 1.1.4 
Security hardening and dependency maintenance
Details (2026 September 11)
### Improvements
- **SVGO override**: Pinned `svgo` to `^3.3.5`, resolving two high-severity `removeScripts` sanitisation bypasses (GHSA-w27v-7q3p-w38r, GHSA-4vpr-x523-8j87) inherited through the Docusaurus toolchain
### Bug Fixes
- **Security**: Applied Dependabot `npm_and_yarn` group updates covering `qs`, `js-yaml`, `joi`, `fast-uri`, `browserslist`, `http-proxy-middleware`, `esbuild`, `form-data`, `minimatch`, `shell-quote`, `brace-expansion`, `tar`, `ws`, `nanoid`, `postcss`, `body-parser`, `dompurify` and `mermaid`
---
## Version 1.1.3 
SlidevLink UI improvement and security updates
Details (2026 May 29)
### Improvements
- **SlidevLink spacing**: Added bottom margin (16px) to the SlidevLink card element for improved spacing between consecutive presentation links
### Bug Fixes
- **Security**: Updated transitive dependencies to resolve known vulnerabilities across multiple dependency groups
- **Dependencies**: Upgraded Dependabot-managed packages including npm_and_yarn group updates
---
## Version 1.1.2 
Security updates and dependency upgrades
Details (2026 March 11)
### Bug Fixes
- **Security**: Fixed RCE vulnerability in `serialize-javascript` by overriding to ^7.0.4 (GHSA-5c6j-r48x-rmvq)
- **Security**: Fixed source code theft vulnerability in `webpack-dev-server` by overriding to ^5.2.3 (GHSA-9jgg-88mc-972h, GHSA-4v9v-hfq4-rm2v)
- **Dependencies**: Upgraded transitive dependencies including `ajv`, `markdown-it`, `minimatch`, `nanotar`, `qs`, `rollup`, `svgo`, and more via Dependabot
---
## Version 1.1.1 
Asset handling support and security updates
Details (2026 February 09)
### New Features
- **Asset Copying**: Automatically copies assets (images, videos, fonts, etc.) alongside presentations during build. Assets referenced via relative paths are now properly resolved
- **Explicit Asset Mode**: New `assets` frontmatter option to declare specific asset paths for precise control over what gets copied
- **Asset Filtering**: New plugin options `assetExcludePatterns`, `assetIncludePatterns`, and `assetCopyRecursive` for fine-grained control over asset copying behavior
- **Large File Warning**: Warns when more than 100 files are copied for a single presentation, suggesting use of explicit assets
### Improvements
- **Security**: Added `lodash-es` and `chevrotain` overrides to fix prototype pollution vulnerability (CVE in lodash-es < 4.17.23)
- **Dependencies**: Upgraded all dependencies to latest versions — Slidev 52.11.5, React 19.2.4, @types/node 24.10.12, and more
### Important Notes
- **Relative Path Syntax**: Always use `./` prefix for relative asset paths (e.g., `./image.png` not `image.png`). Slidev requires explicit relative paths to resolve assets correctly
### Configuration
New plugin options:
| Option | Type | Default | Description |
| ---------------------- | ---------- | ----------- | ---------------------------------------------- |
| `assetExcludePatterns` | `string[]` | `[]` | Glob patterns to exclude from copying |
| `assetIncludePatterns` | `string[]` | `undefined` | Glob patterns to include (whitelist mode) |
| `assetCopyRecursive` | `boolean` | `true` | Whether to copy subdirectories |
New frontmatter option:
| Option | Type | Description |
| -------- | -------------------- | ------------------------------------------------ |
| `assets` | `string \| string[]` | Explicit asset paths (relative to .md file) |
---
## Version 1.1.0 
Major improvements with directory support, parallel builds, and cleaner workspace
Details (2026 January 07)
### Bug Fixes
- **Grid View Sorting**: Fixed sorting to use natural sort on `sourcePath` instead of `title`, correctly handling numeric sequences like `module-01`, `module-02`, ..., `module-10`
- **Strict Theme Validation**: Changed from warning to error when theme is not installed, preventing build hangs
- **Build Output Filtering**: Suppressed verbose Vite/Slidev output including chunk manifests, transformation progress, and outDir warnings
- **Build Timeout**: Increased default timeout from 60s to 120s for large presentations
### New Features
- **Hidden Build Output**: Presentations are now built to a hidden `.docusaurus` cache directory instead of `static/`, keeping the user's workspace clean. Build artifacts are automatically copied to the final output during the Docusaurus build process
- **Directory Support**: Organize presentations into directories with `_category_.yml`/`_category_.json` metadata files for better navigation and grouping
- **Parallel Builds**: Added `maxParallelBuilds` option (default: 4) to build multiple presentations simultaneously, significantly reducing total build time
- **Position Frontmatter**: Added `position` field to manually control sort order (lower numbers first, supports decimals)
- **SlidevLink Component**: New embeddable component for displaying slide previews in MDX documentation
### Breaking Changes
- **Removed `outputDir` option**: The URL path is now automatically derived from `path`. For example, `path: './slidev'` serves presentations at `/slidev/`. This simplifies configuration and eliminates the need for manual `.gitignore` entries for build artifacts
### Deprecated Options
The following options have been renamed and will be removed in a future version:
| Deprecated Option | New Option | Notes |
| ----------------- | --------------- | --------------------------------------- |
| `sourceDir` | `path` | Matches Docusaurus plugin conventions |
| `overviewPath` | `routeBasePath` | Matches Docusaurus `docs` plugin naming |
| `overviewTitle` | `pageTitle` | More concise naming |
| `overviewTagline` | `pageTagline` | More concise naming |
The old options still work but will log a deprecation warning. Update your configuration to use the new names.
### Improvements
- **Cleaner Workspace**: No more `static/slides/` directory cluttering your project
- **Faster Builds**: Parallel build support reduces build time by up to 4x on multi-core machines
- **Cleaner Build Output**: Build now shows only completion messages with timing (no Vite noise)
- **Natural Sorting**: File paths with numbers now sort correctly using `Intl.Collator`
- **Better Error Messages**: Theme not found errors now include installation command
- **Visual Consistency**: Improved sidebar and navbar logo handling for better branding support
- **Package Documentation**: Documentation is now bundled with the npm package, making it accessible during development and for offline reference
---
## Version 1.0.4 
Version bump to match other packages in the framework
---
## Version 1.0.3 
Version bump to match other packages in the framework
---
## Version 1.0.2 
Version bump to match other packages in the framework
---
## Version 1.0.0 
Initial release of the Slidev Integration plugin
Details (2025 November 24)
### New Features
- Initial release with Slidev integration functionality