diff --git a/AGENTS.md b/AGENTS.md index 20375c20b..b2533eab5 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -28,7 +28,7 @@ This is a **monorepo** containing the Comark Markdown parser, document model, pl │ ├── comark-react/ # React renderer + plugins (@comark/react) │ ├── comark-svelte/ # Svelte renderer + plugins (@comark/svelte) │ ├── comark-angular/ # Angular renderer + plugins (@comark/angular) -│ └── comark-nuxt/ # Nuxt module (@comark/nuxt) +│ └── comark-nuxt/ # Deprecated @comark/nuxt: installs @comark/vue/nuxt and logs a warning ├── examples/ # Example applications │ ├── 1.frameworks/ # Framework examples (Nuxt, Next.js, Astro, SvelteKit, VitePress) │ ├── 2.vite/ # Vite examples (Vue, React, Svelte, Angular, HTML, ANSI) @@ -235,6 +235,7 @@ packages/comark-vue/ │ ├── parse.ts # Re-exports comark/parse (@comark/vue/parse) │ ├── render.ts # Re-exports comark/render (@comark/vue/render) │ ├── vite.ts # Vite plugin: `` transform + prose component auto-registration (@comark/vue/vite) +│ ├── nuxt.ts # Nuxt module: auto-imports components + helpers, adds the Vite plugin (@comark/vue/nuxt) │ ├── components/ │ │ ├── Markdown.ts # High-level markdown → render component │ │ ├── MarkdownDocument.ts # Low-level AST → render component @@ -258,6 +259,7 @@ packages/comark-vue/ { ".": "./dist/index.js", "./vite": "./dist/vite.js", + "./nuxt": "./dist/nuxt.js", "./plugins/*": "./dist/plugins/*.js", "./utils": "./dist/utils/index.js", "./parse": "./dist/parse.js", @@ -274,6 +276,8 @@ import math, { Math } from '@comark/vue/plugins/math' import mermaid, { Mermaid } from '@comark/vue/plugins/mermaid' ``` +`@comark/vue/nuxt` is the Nuxt module: `modules: ['@comark/vue']` loads it because Nuxt tries the `/nuxt` subpath first. It auto-imports `Markdown`, `MarkdownDocument`, `defineMarkdownComponent` and `defineMarkdownDocumentComponent`, plus `parseMarkdown` and `createMarkdownParser` in the app and in server routes (from `@comark/vue/parse`), turns on Nuxt UI prose components, and adds the `@comark/vue/vite` plugin with `prose: false`. It does not register `~/components/prose`. `@nuxt/kit` and `@nuxt/schema` are optional peer dependencies. + ## Package: @comark/react Located at `packages/comark-react/`. React renderer with framework-specific plugin wrappers. @@ -952,7 +956,7 @@ There is no ESLint or Prettier config. The docs content is linted with [comark-linter](https://comark-ui.onmax.me/lint/) (`pnpm --filter comark-docs-site lint`): unknown components, unclosed blocks, and broken links and anchors. `docs/comark-lint.config.ts` extends the -comark-docs layer's preset with the site's own `app/components/prose/` components and its Vue pages. +comark-docs layer's preset with the site's own `app/components/prose/` components (registered globally in `docs/nuxt.config.ts`) and its Vue pages. Utility scripts: diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 79b78ac63..b385ae522 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -44,7 +44,7 @@ pnpm docs - `packages/comark`: parser, document model, core plugins and Markdown string rendering. - `packages/comark-html` and `packages/comark-ansi`: HTML and terminal renderers. - `packages/comark-vue`, `packages/comark-react`, `packages/comark-svelte`, and `packages/comark-angular`: framework renderers. -- `packages/comark-nuxt`: Nuxt integration. +- `packages/comark-nuxt`: deprecated `@comark/nuxt`, which installs the Nuxt module from `packages/comark-vue/src/nuxt.ts`. - `docs/content`: user-facing documentation. Keep parser-only behavior in the core package and framework-specific behavior in its renderer. The [architecture reference](./AGENTS.md) has a more detailed package map. diff --git a/SECURITY.md b/SECURITY.md index 4baffc1f9..0d4f0ac82 100644 --- a/SECURITY.md +++ b/SECURITY.md @@ -38,7 +38,7 @@ This policy applies to all packages in the Comark monorepo: - `@comark/vue` - `@comark/react` - `@comark/svelte` -- `@comark/nuxt` +- `@comark/nuxt` (deprecated) ## Built-in Security diff --git a/docs/app/components/ComarkPlaygroundRenderer.ts b/docs/app/components/ComarkPlaygroundRenderer.ts index 3c52e77e1..a6d2925b5 100644 --- a/docs/app/components/ComarkPlaygroundRenderer.ts +++ b/docs/app/components/ComarkPlaygroundRenderer.ts @@ -1,8 +1,8 @@ import { defineMarkdownDocumentComponent } from '@comark/vue' -import { Math } from '@comark/nuxt/plugins/math' +import { Math } from '@comark/vue/plugins/math' import 'katex/dist/katex.min.css' -import { Mermaid } from '@comark/nuxt/plugins/mermaid' -import { Binding } from '@comark/nuxt/plugins/binding' +import { Mermaid } from '@comark/vue/plugins/mermaid' +import { Binding } from '@comark/vue/plugins/binding' export default defineMarkdownDocumentComponent({ name: 'ComarkPlaygroundRenderer', diff --git a/docs/app/components/Playground.vue b/docs/app/components/Playground.vue index 6ea9087c5..22714ee2d 100644 --- a/docs/app/components/Playground.vue +++ b/docs/app/components/Playground.vue @@ -1,26 +1,26 @@ - - -``` - -For math and mermaid plugins, also pass the companion components: - -```vue [app.vue] - - - -``` - -#### `components` - -Use this prop to map custom Vue components to Comark elements and use them in your markdown. - -::steps{level="4"} - -#### Create a Vue component - -Save a component such as `components/Alert.vue`: - -```vue [components/Alert.vue] - - - -``` - -#### Map the tag to your component - -Pass the `components` prop to ``: - -```vue [app.vue] - - - -``` - -:::note -Components receive props from the markdown and render children via slots. -::: - -#### Use it in your Markdown content - -```mdc -::alert{type="warning"} -This is a warning message! -:: -``` - -:: - -::tip -To override how native HTML elements render (such as `h1` or `pre`), place components in `~/components/prose` instead. See [Overriding HTML elements](#overriding-html-elements). -:: - -#### `componentsManifest` - -For lazy-loading components on demand. Components are resolved once and cached. - -```vue [app.vue] - - - -``` - ---- - -## Server-side rendering - -Comark fully supports multiple rendering modes in Nuxt: - -### Static generation - -```vue [pages/index.vue] - - - -``` - -### Dynamic SSR - -```vue [pages/blog/[slug].vue] - - - -``` - -### Prerendering - -```typescript [nuxt.config.ts] -export default defineNuxtConfig({ - modules: ['@comark/nuxt'], - nitro: { - prerender: { - routes: ['/blog', '/docs'] - } - } -}) -``` - ---- - -## Overriding HTML elements - -Place Vue components in `~/components/prose` to override how native HTML elements render. They are automatically registered, no imports or `components` prop needed. - -### Directory structure - -``` -~/components/ - prose/ - ProseH1.vue - ProseH2.vue - ProsePre.vue - ProseA.vue -``` - -### Example - -```vue [components/prose/ProseH1.vue] - - - -``` - -### Resolution order - -When Comark encounters a tag, it looks for a matching component in this order, stopping at the first match: - -1. **`Prose{PascalTag}`**: for example, `ProseH1` for `h1`. Nuxt auto-registers all components from `~/components/prose` matching this convention. -2. **`{PascalTag}`**: for example, `Alert` for `alert`. PascalCase version of the tag name. -3. **`{tag}`**: for example, `alert`. Exact tag name as-is. -4. **Global**: any component registered via `app.component()` or Nuxt auto-imports. - -If none match, the tag renders as a native HTML element. - ---- - -## Component bindings - -Comark automatically bridges the gap between Comark syntax and your component's interface. - -### Prop binding - -Attributes in Comark syntax are passed as props to your component. Use the `:` prefix to pass typed values: - -| Markdown | Prop value | -|----------|------------| -| `{type="warning"}` | `"warning"` (string) | -| `{:count="5"}` | `5` (number) | -| `{:active="true"}` | `true` (boolean) | -| `{:config='{"key":"val"}'}` | `{ key: 'val' }` (object) | - -### Named slots - -Named slots in Comark (`#slotname`) map to Vue named slots: - -- **Default slot** → `` -- **Named slots** → `` (for example, `#footer` → ``) - -::code-group - -```vue [Vue] - - - -``` - -```mdc [Comark] -::card{title="My Card"} -Default slot content. - -#footer -Footer slot content. -:: -``` - -:: - ---- - -## Nuxt UI integration - -When [`@nuxt/ui`](https://ui.nuxt.com) is installed, Comark automatically uses Nuxt UI's prose components for enhanced styling. - -::callout{icon="i-lucide-sparkles" color="info"} -No extra configuration needed. The `@comark/nuxt` module detects `@nuxt/ui` in your dependencies and configures prose components automatically. -:: - -```typescript [nuxt.config.ts] -export default defineNuxtConfig({ - modules: ['@comark/nuxt', '@nuxt/ui'] -}) -``` - -### CSS setup - -```css [app/assets/css/main.css] -@import "tailwindcss"; -@import "@nuxt/ui"; -``` - -```typescript [nuxt.config.ts] -export default defineNuxtConfig({ - modules: ['@comark/nuxt', '@nuxt/ui'], - css: ['~/assets/css/main.css'] -}) -``` - ---- - -## Streaming - -Enable real-time rendering as content arrives, ideal for AI chat interfaces and live previews. - -### Setup - -Set `streaming` to `true` while content is being received, then `false` when done: - -```vue [app.vue] - - - -``` - -::callout{icon="i-lucide-info" color="info"} -`autoClose` is enabled by default: incomplete syntax like `**bold text` is automatically closed on every parse. Disable with `:options="{ autoClose: false }"`. -:: - -### Caret - -The `caret` prop appends a blinking cursor to the last text node while `streaming` is `true`: - -```vue [app.vue] - -{{ content }} - - -{{ content }} -``` - -```css -.my-caret { - display: inline-block; - width: 2px; - height: 1em; - background: currentColor; - animation: blink 1s step-end infinite; - vertical-align: text-bottom; -} - -@keyframes blink { - 50% { opacity: 0; } -} -``` - ---- - -## TypeScript support - -Use `ComarkPlugin` from `comark` to type plugin arrays, and `ElementNode` to type the `__node` prop in components that override HTML elements: - -```vue [components/ComarkWrapper.vue] - - - -``` - -```vue [components/prose/ProseH1.vue] - -``` - ---- diff --git a/docs/content/4.plugins/0.defaults/alert.md b/docs/content/4.plugins/0.defaults/alert.md index 5edaa6b53..aa5bd7d13 100644 --- a/docs/content/4.plugins/0.defaults/alert.md +++ b/docs/content/4.plugins/0.defaults/alert.md @@ -160,4 +160,4 @@ Alert types without a registered component render as a regular `
` component maps to ``. For a pre-parsed document, use `` directly instead of passing it to the all-in-one component. -::tip{to="/rendering/nuxt"} -See Render Comark in Nuxt for the full component API, streaming setup, and SSR examples. +::tip{to="/rendering/vue#nuxt"} +See Render Comark in Vue and Nuxt for the full component API, streaming setup, and SSR examples. :: ### `defineMarkdownComponent` @@ -430,9 +430,9 @@ A typical app needs at least two configurations: a full one for articles (highli ```typescript [composables/markdown.ts] import { defineMarkdownComponent, defineMarkdownDocumentComponent } from '@comark/vue' -import shiki from '@comark/nuxt/plugins/shiki' -import toc from '@comark/nuxt/plugins/toc' -import emoji from '@comark/nuxt/plugins/emoji' +import shiki from '@comark/vue/plugins/shiki' +import toc from '@comark/vue/plugins/toc' +import emoji from '@comark/vue/plugins/emoji' import githubLight from '@shikijs/themes/github-light' import githubDark from '@shikijs/themes/github-dark' import CustomAlert from '~/components/Alert.vue' @@ -580,7 +580,14 @@ In Vue, render only the summary with the `summary` prop: ### Prose components -Both MDC and Comark support dropping custom Vue components into `components/prose/` to override how standard HTML elements render. The Nuxt module auto-registers them globally. +Both MDC and Comark resolve `Prose*` components to override how standard HTML elements render. Unlike `@nuxtjs/mdc`, the Comark Nuxt module does not register `components/prose/` globally. Pass the components with the `components` prop or `defineMarkdownComponent()`, or register the directory in `nuxt.config.ts`: + +```typescript [nuxt.config.ts] +export default defineNuxtConfig({ + modules: ['@comark/vue'], + components: [{ path: '~/components/prose', global: true, pathPrefix: false }, '~/components'], +}) +``` The resolution naming changed: @@ -592,7 +599,7 @@ The resolution naming changed: | `
` | `ProsePre` | `ProsePre` |
 | `` | `ProseCode` | `ProseCode` |
 
-The names are the same. The internal resolution mechanism changed: MDC resolved `prose-p` (kebab-case) in the renderer, then looked up the registered `ProseP` component. Comark resolves directly by `ProseP` (PascalCase). If your prose components are in `components/prose/` and follow the `Prose*.vue` naming convention, they work without changes.
+The names are the same. The internal resolution mechanism changed: MDC resolved `prose-p` (kebab-case) in the renderer, then looked up the registered `ProseP` component. Comark resolves directly by `ProseP` (PascalCase). Components that follow the `Prose*.vue` naming convention work without changes once they are registered.
 
 ::note
 Custom `ProsePre` components that relied on a `code` prop (or `meta.lines`) for copy buttons or collapse thresholds need a small update: after highlighting, Comark does not expose the raw source as a prop. Declare `__node` and reconstruct the text with `textContent()` from `comark/utils`. See [Custom Pre](/kb/custom-code-block).
@@ -600,7 +607,7 @@ Custom `ProsePre` components that relied on a `code` prop (or `meta.lines`) for
 
 ### Nuxt UI
 
-If your project uses [Nuxt UI](https://ui.nuxt.com), `@comark/nuxt` registers [Nuxt UI prose components](https://ui.nuxt.com/docs/typography) automatically.
+If your project uses [Nuxt UI](https://ui.nuxt.com), the `@comark/vue` Nuxt module registers [Nuxt UI prose components](https://ui.nuxt.com/docs/typography) automatically.
 
 [Nuxt UI](https://ui.nuxt.com) also exposes convenience shorthand components for common callout patterns. Instead of `::callout{icon="..." color="..."}`, you can use:
 
@@ -675,7 +682,7 @@ Wire the plugin once (Nuxt example):
 
 ```vue
 
@@ -717,8 +724,8 @@ Full reference: binding plugin, `||` defaults, `::if` / `#else`, and per-rendere
 | Task | MDC | Comark |
 |------|-----|--------|
 | Install (core only) | `@nuxtjs/mdc` | `comark` |
-| Install (Nuxt) | `@nuxtjs/mdc` | `@comark/nuxt` |
-| Nuxt module | `@nuxtjs/mdc` | `@comark/nuxt` |
+| Install (Nuxt) | `@nuxtjs/mdc` | `@comark/vue` |
+| Nuxt module | `@nuxtjs/mdc` | `@comark/vue` |
 | Global plugin config | `mdc: { ... }` in nuxt.config | — (no global config) |
 | Reusable configured component | — | `defineMarkdownComponent({ plugins, components })` |
 | Reusable configured renderer | — | `defineMarkdownDocumentComponent({ components })` |
@@ -734,7 +741,7 @@ Full reference: binding plugin, `||` defaults, `::if` / `#else`, and per-rendere
 | Highlight | `mdc.highlight` in nuxt.config | `shiki()` plugin in `defineMarkdownComponent` |
 | Binding `{{ var }}` | Built-in, bare paths + parse-time `data` | `binding()` + `Binding`; paths like `data.x` / `frontmatter.x`; render-time `:data` |
 | Prop data binding | Parse-time `data` + `{{ }}` | `:prop="path"` always; `data` prop on renderer |
-| Prose components | `components/prose/Prose*.vue` | `components/prose/Prose*.vue` |
+| Prose components | `components/prose/Prose*.vue`, registered by the module | `Prose*` components, registered by you |
 | Render slot | `` | `` |
 | Unwrap slot | `` or `` | `` |
 | Streaming | Not supported | `streaming` prop + `autoClose` |
diff --git a/docs/content/8.examples/1.frameworks/nuxt.md b/docs/content/8.examples/1.frameworks/nuxt.md
index b1e7e1517..bcf1a1c78 100644
--- a/docs/content/8.examples/1.frameworks/nuxt.md
+++ b/docs/content/8.examples/1.frameworks/nuxt.md
@@ -1,6 +1,6 @@
 ---
 title: 'Nuxt UI Markdown Example with Comark'
-description: 'A minimal Nuxt app that renders Comark component syntax with Nuxt UI components through the @comark/nuxt module.'
+description: 'A minimal Nuxt app that renders Comark component syntax with Nuxt UI components through the @comark/vue Nuxt module.'
 navigation:
   title: 'Nuxt'
   icon:  i-simple-icons-nuxt
@@ -18,11 +18,10 @@ defaultValue: content/posts/comark-syntax.md
 ::Browser{src="https://comark-nuxt.vercel.app/blog/comark-syntax"}
 ::
 
-This example demonstrates how to use Comark Syntax with Nuxt UI. Comark Syntax automatically detects when Nuxt UI is installed and uses its components for rendering. Simply add both `@comark/nuxt` and `@nuxt/ui` modules to your Nuxt config, and the `Markdown` component will use Nuxt UI components automatically.
+This example demonstrates how to use Comark Syntax with Nuxt UI. Comark Syntax automatically detects when Nuxt UI is installed and uses its components for rendering. Simply add both `@comark/vue` and `@nuxt/ui` modules to your Nuxt config, and the `Markdown` component will use Nuxt UI components automatically.
 
-## What does `@comark/nuxt` module do
+## What does the `@comark/vue` Nuxt module do
 
-- Registers the `` and `` components in Nuxt for automatic import.
-- Registers the `~/components/prose` directory in the app and all layers as a global components directory.
-  - This allows users to override prose components by creating components in this directory.
-- Detects Nuxt UI and tells Nuxt UI to register its Prose components
+- Auto-imports the `` and `` components.
+- Auto-imports the `defineMarkdownComponent()` and `defineMarkdownDocumentComponent()` helpers.
+- Detects Nuxt UI and tells Nuxt UI to register its Prose components.
diff --git a/docs/nuxt.config.ts b/docs/nuxt.config.ts
index e9abcc630..fad18ff98 100644
--- a/docs/nuxt.config.ts
+++ b/docs/nuxt.config.ts
@@ -7,6 +7,9 @@ export default defineNuxtConfig({
 
   modules: ['@vercel/analytics', '@vercel/speed-insights'],
 
+  // The Markdown content renders app/components/prose/ by name, for example `::ecosystem-cta`.
+  components: [{ path: '~/components/prose', global: true, pathPrefix: false }, '~/components'],
+
   site: {
     url: 'https://comark.dev',
     name: 'Comark',
@@ -59,6 +62,8 @@ export default defineNuxtConfig({
     '/plugins/built-in/syntax-highlight': { redirect: '/plugins/built-in/shiki' },
     '/plugins/built-in/headings': { redirect: '/plugins/built-in/title-description' },
     '/syntax/comark-ast': { redirect: '/getting-started/document-model' },
+    // @comark/nuxt is deprecated: the Nuxt module ships in @comark/vue
+    '/rendering/nuxt': { redirect: '/rendering/vue#nuxt' },
     // The API Reference section moved from /api (which collided with the server endpoints) to /reference
     '/api/render': { redirect: '/reference/render' },
     '/api/parse': { redirect: '/reference/parse' },
diff --git a/docs/package.json b/docs/package.json
index 3f9186da1..8fd6ccfb6 100644
--- a/docs/package.json
+++ b/docs/package.json
@@ -13,7 +13,6 @@
   "dependencies": {
     "@ai-sdk/gateway": "catalog:",
     "@ai-sdk/vue": "catalog:",
-    "@comark/nuxt": "workspace:*",
     "@comark/vue": "workspace:*",
     "@monaco-editor/loader": "catalog:",
     "@nuxtlabs/monarch-mdc": "catalog:",
diff --git a/docs/server/utils/llms.ts b/docs/server/utils/llms.ts
index e401bfd0d..207af8624 100644
--- a/docs/server/utils/llms.ts
+++ b/docs/server/utils/llms.ts
@@ -51,7 +51,7 @@ export const LLMS_BUNDLES: LlmsBundle[] = [
     slug: 'vue',
     title: 'Comark for Vue and Nuxt',
     description: 'Render Markdown in Vue 3 and Nuxt, with custom components, plugins, and streaming.',
-    pages: ['/rendering/vue', '/rendering/nuxt', '/use-cases/vue-ai-chat', '/reference/auto-close'],
+    pages: ['/rendering/vue', '/use-cases/vue-ai-chat', '/reference/auto-close'],
   },
   {
     slug: 'react',
diff --git a/docs/skills/comark/SKILL.md b/docs/skills/comark/SKILL.md
index 13290907c..439c2af2d 100644
--- a/docs/skills/comark/SKILL.md
+++ b/docs/skills/comark/SKILL.md
@@ -33,7 +33,7 @@ A high-performance markdown parser with Comark (Components in Markdown) support,
   - Angular components: `@comark/angular`
   - HTML rendering: `@comark/html`
   - ANSI terminal rendering: `@comark/ansi`
-  - Nuxt module: `@comark/nuxt`
+  - Nuxt module: `@comark/vue` (`modules: ['@comark/vue']`)
 
 ## Quick Start
 
diff --git a/docs/skills/migrate-mdc-to-comark/SKILL.md b/docs/skills/migrate-mdc-to-comark/SKILL.md
index 42105b8f2..647265189 100644
--- a/docs/skills/migrate-mdc-to-comark/SKILL.md
+++ b/docs/skills/migrate-mdc-to-comark/SKILL.md
@@ -12,7 +12,7 @@ The migration has two parts: **Core Package** (programmatic API) and **Nuxt Modu
 
 ## Quick Overview
 
-- **Package**: `@nuxtjs/mdc` → `comark` (core only) or `@comark/nuxt` (Nuxt module)
+- **Package**: `@nuxtjs/mdc` → `comark` (core only) or `@comark/vue` (Vue renderer and Nuxt module)
 - **Parse**: `parseMarkdown()` → `parseMarkdown()` · factory: `createMarkdownParser()` (sync, no await)
 - **Render**: `stringifyMarkdown()` → `renderMarkdown()` from `comark/render`
 - **AST**: object tree → compact tuples `['tag', props, ...children]`
@@ -78,7 +78,7 @@ The `unified`/`remark`/`rehype` pipeline is replaced by Comark's own lighter plu
 | Excerpt / Summary | `result.excerpt` (built-in) | `summary()` plugin → `document.meta.summary` |
 | Emoji | `remark-emoji` (enabled by default) | `emoji()` plugin (opt-in) |
 
-Available plugins include: `toc`, `shiki`, `emoji`, `task-list`, `summary`, `security`, `alert`, `math`, `mermaid`, `punctuation`, `binding`. Prefer framework paths in apps (`@comark/nuxt/plugins/*` or `@comark/vue/plugins/*`); use `comark/plugins/*` only for bare `parseMarkdown()`.
+Available plugins include: `toc`, `shiki`, `emoji`, `task-list`, `summary`, `security`, `alert`, `math`, `mermaid`, `punctuation`, `binding`. Prefer framework paths in apps (`@comark/vue/plugins/*`); use `comark/plugins/*` only for bare `parseMarkdown()`.
 
 ## Nuxt Module
 
@@ -93,16 +93,16 @@ export default defineNuxtConfig({
 
 // After
 export default defineNuxtConfig({
-  modules: ['@comark/nuxt'],
+  modules: ['@comark/vue'],
   // No plugin config here (plugins are defined per-component)
 })
 ```
 
-`@comark/nuxt` auto-imports: `Markdown`, `MarkdownDocument`, `defineMarkdownComponent`, `defineMarkdownDocumentComponent`.
+`@comark/vue` auto-imports: `Markdown`, `MarkdownDocument`, `defineMarkdownComponent`, `defineMarkdownDocumentComponent`.
 
 ### Components
 
-| `@nuxtjs/mdc` | `@comark/nuxt` |
+| `@nuxtjs/mdc` | `@comark/vue` |
 |---|---|
 | `` | `` |
 | `` | `` or `{{ md }}` |
@@ -143,8 +143,8 @@ Replaces global `mdc: { ... }` config. Define reusable components with their own
 
 ```typescript
 import { defineMarkdownComponent } from '@comark/vue'
-import shiki from '@comark/nuxt/plugins/shiki'
-import toc from '@comark/nuxt/plugins/toc'
+import shiki from '@comark/vue/plugins/shiki'
+import toc from '@comark/vue/plugins/toc'
 import githubLight from '@shikijs/themes/github-light'
 import githubDark from '@shikijs/themes/github-dark'
 
@@ -161,11 +161,11 @@ export const ArticleMarkdown = defineMarkdownComponent({
 
 ### Prose Components
 
-Same `Prose*.vue` naming convention in `components/prose/`. Resolution changed from kebab-case (`prose-p`) to PascalCase (`ProseP`) internally. No file changes needed.
+Same `Prose*.vue` naming convention. Resolution changed from kebab-case (`prose-p`) to PascalCase (`ProseP`) internally. The Comark Nuxt module does not register `components/prose/` globally: pass the components through `components` / `defineMarkdownComponent()`, or add `components: [{ path: '~/components/prose', global: true, pathPrefix: false }, '~/components']` to `nuxt.config.ts`.
 
 ### Nuxt UI Integration
 
-When using Nuxt UI, `@comark/nuxt` registers Nuxt UI prose components automatically. Shorthand callout components are available:
+When using Nuxt UI, the `@comark/vue` Nuxt module registers Nuxt UI prose components automatically. Shorthand callout components are available:
 
 ```mdc
 ::note    (informational)
@@ -199,7 +199,7 @@ Supported via the binding plugin + render-time `data` prop. Differences from MDC
 
 ```vue