[{"data":1,"prerenderedAt":2808},["ShallowReactive",2],{"docs-navigation-en":3,"mdc--tctnej-key":338,"docs--en-docs-getting-started-migration":351,"surround--en-docs-getting-started-migration":2797,"-en-docs-getting-started-migration-description":2800},[4],{"title":5,"path":6,"stem":7,"children":8,"page":113},"Docs","\u002Fen\u002Fdocs","en\u002Fdocs",[9,38,114,150,191,239],{"title":10,"path":11,"stem":12,"children":13,"category":16,"description":16,"icon":37},"Get Started","\u002Fen\u002Fdocs\u002Fgetting-started","en\u002Fdocs\u002F1.getting-started\u002F1.index",[14,19,25,31],{"title":15,"path":11,"stem":12,"category":16,"description":17,"icon":18},"Introduction",null,"Movk Nuxt Docs is a Nuxt Layer you can extend to get typography, navigation, search, SEO and AI features for a documentation site. This page explains what it suits, what is included by default and what you can turn on.","i-lucide-book-open",{"title":20,"path":21,"stem":22,"category":16,"description":23,"icon":24},"Installation","\u002Fen\u002Fdocs\u002Fgetting-started\u002Finstallation","en\u002Fdocs\u002F1.getting-started\u002F2.installation","Create a documentation site from an official template, or add @movk\u002Fnuxt-docs as a layer to an existing Nuxt project. This page compares the default, i18n and module templates and lists the runtime requirements and required dependencies.","i-lucide-download",{"title":26,"path":27,"stem":28,"category":16,"description":29,"icon":30},"Project Structure","\u002Fen\u002Fdocs\u002Fgetting-started\u002Fproject-structure","en\u002Fdocs\u002F1.getting-started\u002F3.project-structure","What each directory and file does in a Movk Nuxt Docs project, where content goes, how routes are generated, which files turn into the releases and showcase pages, and what the two config files control.","i-lucide-folder-tree",{"title":32,"path":33,"stem":34,"category":16,"description":35,"icon":36},"Migrating from v2","\u002Fen\u002Fdocs\u002Fgetting-started\u002Fmigration","en\u002Fdocs\u002F1.getting-started\u002F4.migration","Every breaking change when upgrading @movk\u002Fnuxt-docs from v2 to v3, each with a v2 and v3 comparison. Work through dependencies and feature flags, content paths, config fields, visual defaults and component overrides in order to finish the upgrade.","i-lucide-arrow-right-left","i-lucide-square-play",{"title":39,"category":16,"description":16,"icon":40,"path":41,"stem":42,"children":43,"page":113},"Guide","i-lucide-compass","\u002Fen\u002Fdocs\u002Fguide","en\u002Fdocs\u002F2.guide",[44,51,58,64,70,76,82,89,95,101,107],{"title":45,"path":46,"stem":47,"category":48,"description":49,"icon":50},"Configuration Overview","\u002Fen\u002Fdocs\u002Fguide\u002Fconfiguration","en\u002Fdocs\u002F2.guide\u002F1.configuration","basics","Movk Nuxt Docs is configured in two places. nuxt.config.ts decides at build time which modules and features are included; app.config.ts controls UI, text and navigation at runtime. This page explains the split, when each takes effect, and where common changes belong.","i-lucide-settings",{"title":52,"path":53,"stem":54,"category":55,"description":56,"icon":57},"Troubleshooting","\u002Fen\u002Fdocs\u002Fguide\u002Ftroubleshooting","en\u002Fdocs\u002F2.guide\u002F10.troubleshooting","shipping","Fix common build and runtime errors involving optional dependencies, AI Chat and MCP, docs 404s, i18n configuration, pnpm build approvals and commit history.","i-lucide-life-buoy",{"title":59,"path":60,"stem":61,"category":55,"description":62,"icon":63},"FAQ","\u002Fen\u002Fdocs\u002Fguide\u002Ffaq","en\u002Fdocs\u002F2.guide\u002F11.faq","Answers to common questions about Movk Nuxt Docs, from how it relates to the Nuxt UI docs template, package managers and Node.js versions, and single-language sites, to turning off GitHub, using other AI providers, upgrading, overriding components and static hosting limits.","i-lucide-circle-help",{"title":65,"path":66,"stem":67,"category":48,"description":68,"icon":69},"Theme & Fonts","\u002Fen\u002Fdocs\u002Fguide\u002Ftheme","en\u002Fdocs\u002F2.guide\u002F2.theme","The default theme is editorial - a warm paper background, a vermilion accent, serif headings and monospaced metadata. This page covers the default colors and fonts, switching colors and heading fonts in app.config, adding a CJK serif font, the visitor theme picker and motion preferences.","i-lucide-palette",{"title":71,"path":72,"stem":73,"category":48,"description":74,"icon":75},"Navigation & Categories","\u002Fen\u002Fdocs\u002Fguide\u002Fnavigation","en\u002Fdocs\u002F2.guide\u002F3.navigation","Header links, the mobile menu and sidebar groups are declared in app.config, while the docs directory structure drives the section bar and the sidebar order. This page covers where each navigation comes from, localized labels and link prefixes, sidebar grouping rules, the sidebar filter and ⌘K search.","i-lucide-map",{"title":77,"path":78,"stem":79,"category":48,"description":80,"icon":81},"Feature Flags","\u002Fen\u002Fdocs\u002Fguide\u002Ffeatures","en\u002Fdocs\u002F2.guide\u002F4.features","Optional features such as component docs, Mermaid, AI Chat and accessibility checks are controlled by switches in nuxt.config, and features that are off bundle none of their dependencies. This page lists each flag's default, the dependencies to install when enabling it, and what happens when it is off.","i-lucide-toggle-right",{"title":83,"path":84,"stem":85,"category":86,"description":87,"icon":88},"Customization","\u002Fen\u002Fdocs\u002Fguide\u002Fcustomization","en\u002Fdocs\u002F2.guide\u002F5.customization","customization","Create a Vue file with the same name as a built-in component in your component directory to replace the header, sidebars, footer and other UI regions. This page lists the components v3 promises to keep stable, where each is mounted, and a minimal override for every one of them.","i-lucide-paintbrush",{"title":90,"path":91,"stem":92,"category":86,"description":93,"icon":94},"Pages & Layouts","\u002Fen\u002Fdocs\u002Fguide\u002Fpages","en\u002Fdocs\u002F2.guide\u002F6.pages","Besides docs pages, the layer generates the landing page, a releases page and a showcase page from files in the content directory, and you can write any Vue page in app\u002Fpages. This page covers when each built-in route is generated and its content format, header and footer switches for custom pages, and the built-in layouts.","i-lucide-layout-panel-top",{"title":96,"path":97,"stem":98,"category":86,"description":99,"icon":100},"Internationalization","\u002Fen\u002Fdocs\u002Fguide\u002Fi18n","en\u002Fdocs\u002F2.guide\u002F7.i18n","Turn on multiple languages with @nuxtjs\u002Fi18n. This page covers installation, the content directory layout, per-locale collections, UI text overrides and hreflang SEO. Without it the site stays single-language, and you can still switch the UI language.","i-lucide-languages",{"title":102,"path":103,"stem":104,"category":86,"description":105,"icon":106},"OG Images","\u002Fen\u002Fdocs\u002Fguide\u002Fog-image","en\u002Fdocs\u002F2.guide\u002F8.og-image","Every docs page gets a social sharing image (OG image) generated at build time. This page covers the fields the built-in template reads, generating images for custom pages, replacing the template, and what happens when the feature is off.","i-lucide-image",{"title":108,"path":109,"stem":110,"category":55,"description":111,"icon":112},"Deployment","\u002Fen\u002Fdocs\u002Fguide\u002Fdeployment","en\u002Fdocs\u002F2.guide\u002F9.deployment","Deploy the docs site to Vercel, Netlify, Cloudflare or any Node.js server, or generate a fully static site. This page lists the build commands, environment variables, per-platform notes and the features that are unavailable on static hosting.","i-lucide-rocket",false,{"title":115,"category":16,"description":16,"icon":116,"path":117,"stem":118,"children":119,"page":113},"AI","i-lucide-sparkles","\u002Fen\u002Fdocs\u002Fai","en\u002Fdocs\u002F3.ai",[120,126,132,138,144],{"title":121,"path":122,"stem":123,"category":16,"description":124,"icon":125},"AI Chat","\u002Fen\u002Fdocs\u002Fai\u002Fai-chat","en\u002Fdocs\u002F3.ai\u002F1.ai-chat","Turn on the built-in AI assistant for your docs site. Covers the enable conditions and dependencies, model and endpoint routing, adding other providers, and the component and composable API, so readers can ask the docs directly within minutes.","i-lucide-bot",{"title":127,"path":128,"stem":129,"category":16,"description":130,"icon":131},"MCP Server","\u002Fen\u002Fdocs\u002Fai\u002Fmcp","en\u002Fdocs\u002F3.ai\u002F2.mcp","Every docs site serves a Model Context Protocol server at \u002Fmcp by default. This page lists the built-in tools, resources and prompts, shows how to connect Claude Code, Cursor, VS Code and other clients, and explains how to disable, restrict or extend the server.","i-lucide-plug",{"title":133,"path":134,"stem":135,"category":16,"description":136,"icon":137},"Agent Skills","\u002Fen\u002Fdocs\u002Fai\u002Fskills","en\u002Fdocs\u002F3.ai\u002F3.skills","Publish the Agent Skills in your project's skills\u002F directory under \u002F.well-known\u002Fskills\u002F together with the docs site, so readers install them into Claude Code, Cursor and other assistants with one command. Covers layout, naming, publishing and the two built-in skills.","i-lucide-wand-sparkles",{"title":139,"path":140,"stem":141,"category":16,"description":142,"icon":143},"llms.txt","\u002Fen\u002Fdocs\u002Fai\u002Fllms-txt","en\u002Fdocs\u002F3.ai\u002F4.llms-txt","The docs site generates \u002Fllms.txt and \u002Fllms-full.txt automatically, giving language models an index and the full text of your docs. Learn where the defaults come from, how to set titles and sections, how they relate to each page's Markdown, and how to use them in Cursor and other tools.","i-lucide-file-text",{"title":145,"path":146,"stem":147,"category":16,"description":148,"icon":149},"Agent Discovery","\u002Fen\u002Fdocs\u002Fai\u002Fagent-discovery","en\u002Fdocs\u002F3.ai\u002F5.agent-discovery","The docs site serves AI agents a Markdown version of every page, a Markdown sitemap and a set of \u002F.well-known discovery documents, so agents can find and read content without parsing HTML. This page lists every endpoint, the negotiation rules and what the layer adds.","i-lucide-radar",{"title":151,"category":16,"description":16,"icon":152,"path":153,"stem":154,"children":155,"page":113},"Writing","i-lucide-square-pilcrow","\u002Fen\u002Fdocs\u002Fwriting","en\u002Fdocs\u002F4.writing",[156,162,168,174,179,185],{"title":157,"path":158,"stem":159,"category":16,"description":160,"icon":161},"Markdown Syntax","\u002Fen\u002Fdocs\u002Fwriting\u002Fmarkdown-syntax","en\u002Fdocs\u002F4.writing\u002F1.markdown-syntax","Docs pages are written in standard Markdown. Headings drive the table of contents and anchors, while emphasis, links, lists, tables and blockquotes structure the content. This page lists the common syntax and how Movk Nuxt Docs renders it.","i-lucide-heading",{"title":163,"path":164,"stem":165,"category":16,"description":166,"icon":167},"Code Blocks","\u002Fen\u002Fdocs\u002Fwriting\u002Fcode-blocks","en\u002Fdocs\u002F4.writing\u002F2.code-blocks","Code blocks are highlighted with github-light \u002F github-dark and support filenames, line highlights, a copy button, and color and icon previews. Use code-group, code-tree, code-preview and code-collapse for multi-file, multi-package-manager and long examples.","i-lucide-square-code",{"title":169,"path":170,"stem":171,"category":16,"description":172,"icon":173},"MDC Components","\u002Fen\u002Fdocs\u002Fwriting\u002Fmdc-components","en\u002Fdocs\u002F4.writing\u002F3.mdc-components","Embed Nuxt UI prose components in Markdown with MDC syntax, including callouts, badges, cards, accordions, tabs, steps, fields, icons and keyboard keys, to structure richer docs without writing Vue code.","i-lucide-puzzle",{"title":175,"path":176,"stem":177,"category":16,"description":178,"icon":106},"Images and Video","\u002Fen\u002Fdocs\u002Fwriting\u002Fmedia","en\u002Fdocs\u002F4.writing\u002F4.media","Insert remote or local images with Markdown image syntax, provide separate light and dark screenshots with `u-color-mode-image`, and embed videos with `:video`. Also covers where to put images and how to write alt text.",{"title":180,"path":181,"stem":182,"category":16,"description":183,"icon":184},"Mermaid Diagrams","\u002Fen\u002Fdocs\u002Fwriting\u002Fmermaid","en\u002Fdocs\u002F4.writing\u002F5.mermaid","With `movkNuxtDocs.mermaid` enabled and mermaid and dompurify installed, code blocks in the `mermaid` language render as flowcharts, sequence diagrams, class diagrams and more. Diagrams follow the color mode, load when scrolled into view and support copy and fullscreen.","i-lucide-workflow",{"title":186,"path":187,"stem":188,"category":16,"description":189,"icon":190},"Content Components","\u002Fen\u002Fdocs\u002Fwriting\u002Fcontent-components","en\u002Fdocs\u002F4.writing\u002F6.content-components","Content components the layer adds on top of Nuxt UI prose. Motion adds entrance animations, StarsBg lays an animated star field behind a section, and LandingCover, LandingSection and friends build an editorial landing page. All work directly in Markdown.","i-lucide-sparkle",{"title":192,"category":16,"description":16,"icon":193,"path":194,"stem":195,"children":196,"page":113},"Components","i-lucide-component","\u002Fen\u002Fdocs\u002Fcomponents","en\u002Fdocs\u002F5.components",[197,203,209,215,221,227,233],{"title":198,"path":199,"stem":200,"category":16,"description":201,"icon":202},"ComponentProps","\u002Fen\u002Fdocs\u002Fcomponents\u002Fcomponent-props","en\u002Fdocs\u002F5.components\u002F1.component-props","Generate a props table for a Vue component with a single `:component-props` line. Names, defaults, types and JSDoc descriptions come from nuxt-component-meta, so the docs stay in sync with the component.","i-lucide-list",{"title":204,"path":205,"stem":206,"category":16,"description":207,"icon":208},"ComponentSlots","\u002Fen\u002Fdocs\u002Fcomponents\u002Fcomponent-slots","en\u002Fdocs\u002F5.components\u002F2.component-slots","List every slot of a Vue component with a single `:component-slots` line. Slot names, scoped parameter types and JSDoc descriptions come from the `defineSlots` type, so there is nothing to write by hand.","i-lucide-layout-panel-left",{"title":210,"path":211,"stem":212,"category":16,"description":213,"icon":214},"ComponentEmits","\u002Fen\u002Fdocs\u002Fcomponents\u002Fcomponent-emits","en\u002Fdocs\u002F5.components\u002F3.component-emits","List every event of a Vue component with a single `:component-emits` line. Event names, parameter signatures and JSDoc descriptions come from the `defineEmits` type and complete the API docs next to the props and slots tables.","i-lucide-radio-tower",{"title":216,"path":217,"stem":218,"category":16,"description":219,"icon":220},"ComponentExample","\u002Fen\u002Fdocs\u002Fcomponents\u002Fcomponent-example","en\u002Fdocs\u002F5.components\u002F4.component-example","Render a Vue file from the examples directory as a live preview with its highlighted source below. Supports line highlights, collapsing, adjustable options and client-only rendering for showing components in realistic compositions.","i-lucide-app-window",{"title":222,"path":223,"stem":224,"category":16,"description":225,"icon":226},"ComponentCode","\u002Fen\u002Fdocs\u002Fcomponents\u002Fcomponent-code","en\u002Fdocs\u002F5.components\u002F5.component-code","Drive any registered Vue component from a props matrix with `::component-code`. Readers switch prop values above the live preview and the Vue snippet below updates in sync, ready to copy.","i-lucide-sliders-horizontal",{"title":228,"path":229,"stem":230,"category":16,"description":231,"icon":232},"CommitChangelog","\u002Fen\u002Fdocs\u002Fcomponents\u002Fcommit-changelog","en\u002Fdocs\u002F5.components\u002F6.commit-changelog","Fetch the GitHub commit history of a component or source file with `:commit-changelog` and show it as a timeline grouped by release. The file path is inferred from the name and can be tuned by directory, extension, casing and author, or cover several files.","i-lucide-git-commit-horizontal",{"title":234,"path":235,"stem":236,"category":16,"description":237,"icon":238},"PageLastCommit","\u002Fen\u002Fdocs\u002Fcomponents\u002Fpage-last-commit","en\u002Fdocs\u002F5.components\u002F7.page-last-commit","The meta row below the lead of every docs page shows the latest commit of its Markdown file, with time, author and message. This page covers when it appears, date formatting and author detection for PR squash merges.","i-lucide-history",{"title":240,"category":16,"description":16,"icon":241,"path":242,"stem":243,"children":244,"page":113},"Reference","i-lucide-book-marked","\u002Fen\u002Fdocs\u002Freference","en\u002Fdocs\u002F6.reference",[245,251,257,332],{"title":246,"path":247,"stem":248,"category":16,"description":249,"icon":250},"app.config Reference","\u002Fen\u002Fdocs\u002Freference\u002Fapp-config","en\u002Fdocs\u002F6.reference\u002F1.app-config","Every field of app.config.ts with its type, default value and description, generated from the layer's nuxt.schema.ts so it always matches the published version. Follow the links to the guides for usage details.","i-lucide-file-cog",{"title":252,"path":253,"stem":254,"category":16,"description":255,"icon":256},"nuxt.config Options","\u002Fen\u002Fdocs\u002Freference\u002Fnuxt-config","en\u002Fdocs\u002F6.reference\u002F2.nuxt-config","Every nuxt.config option and environment variable the layer reads at build time, including feature flags, AI Chat, component metadata, MCP, llms.txt, agent discovery and site info. Changing these options requires a rebuild or a dev server restart.","i-lucide-settings-2",{"title":258,"category":16,"description":16,"icon":259,"path":260,"stem":261,"children":262,"page":113},"Composables","i-lucide-square-function","\u002Fen\u002Fdocs\u002Freference\u002Fcomposables","en\u002Fdocs\u002F6.reference\u002F3.composables",[263,268,274,280,286,292,298,304,310,315,321,327],{"title":264,"path":265,"stem":266,"category":16,"description":267,"icon":100},"useMovkI18n","\u002Fen\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-movk-i18n","en\u002Fdocs\u002F6.reference\u002F3.composables\u002F1.use-movk-i18n","A single i18n entry point that works the same whether or not @nuxtjs\u002Fi18n is enabled. Read the current locale, translate built-in strings, build locale-prefixed links, and get the content collection and docs root for the current locale.",{"title":269,"path":270,"stem":271,"category":16,"description":272,"icon":273},"useLocaleSeo","\u002Fen\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-locale-seo","en\u002Fdocs\u002F6.reference\u002F3.composables\u002F10.use-locale-seo","Inject hreflang alternate links, x-default and og:locale on multilingual sites so search engines can tell the language versions apart. The layer's app.vue already calls it globally; call it yourself only when you rewrite app.vue.","i-lucide-globe",{"title":275,"path":276,"stem":277,"category":16,"description":278,"icon":279},"useFetchComponentMeta","\u002Fen\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-fetch-component-meta","en\u002Fdocs\u002F6.reference\u002F3.composables\u002F11.use-fetch-component-meta","Read the component metadata generated by nuxt-component-meta, including the types and descriptions of props, slots and events. ComponentProps and the other component docs components are built on it; call it directly to render your own API tables. Available only with component docs enabled.","i-lucide-braces",{"title":281,"path":282,"stem":283,"category":16,"description":284,"icon":285},"useFetchComponentExample","\u002Fen\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-fetch-component-example","en\u002Fdocs\u002F6.reference\u002F3.composables\u002F12.use-fetch-component-example","Read the source code, file path and name of example components under components\u002Fcontent\u002Fexamples. ComponentExample uses it to show example code; call it directly to display example source in your own components. Available only with component docs enabled.","i-lucide-file-code",{"title":287,"path":288,"stem":289,"category":16,"description":290,"icon":291},"useDocsNavigation","\u002Fen\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-docs-navigation","en\u002Fdocs\u002F6.reference\u002F3.composables\u002F2.use-docs-navigation","Read the docs navigation tree that the shell has already loaded. The header section bar, sidebar and docs pages all take their navigation from here, so custom components reuse the same data without querying the collection again.","i-lucide-list-tree",{"title":293,"path":294,"stem":295,"category":16,"description":296,"icon":297},"useNavigation","\u002Fen\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-navigation","en\u002Fdocs\u002F6.reference\u002F3.composables\u002F3.use-navigation","Shape the docs navigation tree for the sidebar - top-level sections, the current section's pages grouped by docs.categories, and breadcrumbs for any path. Use it in a custom sidebar or table of contents to keep the default grouping rules.","i-lucide-panel-left",{"title":299,"path":300,"stem":301,"category":16,"description":302,"icon":303},"useHeader","\u002Fen\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-header","en\u002Fdocs\u002F6.reference\u002F3.composables\u002F4.use-header","Provides the desktop and mobile header navigation links. Declare them in header.nav and header.mobileNav in app.config; override the composable with a same-named file in your project only when links must be generated from runtime state.","i-lucide-panel-top",{"title":305,"path":306,"stem":307,"category":16,"description":308,"icon":309},"useCategory","\u002Fen\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-category","en\u002Fdocs\u002F6.reference\u002F3.composables\u002F5.use-category","Provides the sidebar category definitions that decide how pages with a category are grouped and ordered within a section. Declare them in docs.categories in app.config; override the composable in your project only when categories must be computed at runtime.","i-lucide-folders",{"title":311,"path":312,"stem":313,"category":16,"description":314,"icon":69},"useTheme","\u002Fen\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-theme","en\u002Fdocs\u002F6.reference\u002F3.composables\u002F6.use-theme","The state and actions behind the theme picker - primary color, neutral color, radius, icon set, black as primary and color mode. Visitor choices persist in localStorage and can be exported as app.config or CSS. Use it for a custom theme picker or to switch themes from a page.",{"title":316,"path":317,"stem":318,"category":16,"description":319,"icon":320},"useDocsRoute","\u002Fen\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-docs-route","en\u002Fdocs\u002F6.reference\u002F3.composables\u002F7.use-docs-route","Check whether the current route is a docs page, covering \u002Fdocs\u002F* for the default locale and \u002F{locale}\u002Fdocs\u002F* for others. Use it in site-wide components such as a custom header or footer that should show something only on docs pages.","i-lucide-route",{"title":322,"path":323,"stem":324,"category":16,"description":325,"icon":326},"useDocsFilterConfig","\u002Fen\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-docs-filter-config","en\u002Fdocs\u002F6.reference\u002F3.composables\u002F8.use-docs-filter-config","Config, visibility check and filter function behind the sidebar navigation filter, mapped to aside.filter in app.config. Use them in a custom sidebar top or sidebar body component to keep the default filtering behavior.","i-lucide-list-filter",{"title":328,"path":329,"stem":330,"category":16,"description":331,"icon":220},"useDocsShell","\u002Fen\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-docs-shell","en\u002Fdocs\u002F6.reference\u002F3.composables\u002F9.use-docs-shell","The site shell shared by app.vue and error.vue. It loads the navigation tree and search index for the current locale, sets the html language, direction, font and grain attributes, and provides navigation to the component tree. Call it directly only when you rewrite app.vue or error.vue.",{"title":333,"path":334,"stem":335,"category":16,"description":336,"icon":337},"A–Z Index","\u002Fen\u002Fdocs\u002Freference\u002Fa-z","en\u002Fdocs\u002F6.reference\u002F9.a-z","Every documentation page listed alphabetically by title. Use it when you remember the name of a feature but not which section it lives in.","i-lucide-list-ordered",{"data":339,"body":340},{},{"type":341,"children":342},"root",[343],{"type":344,"tag":345,"props":346,"children":347},"element","p",{},[348],{"type":349,"value":350},"text","Copyright © 2024 - 2026",{"id":352,"title":32,"body":353,"category":16,"description":35,"difficulty":2789,"extension":424,"index":113,"keywords":16,"links":16,"meta":2790,"navigation":2791,"path":33,"requires":2792,"seo":2793,"sitemap":2795,"stem":34,"__hash__":2796},"docs_en\u002Fen\u002Fdocs\u002F1.getting-started\u002F4.migration.md",{"type":354,"value":355,"toc":2756},"minimark",[356,361,404,408,415,1461,1464,1470,1475,1488,1571,1575,1585,1651,1661,1665,1675,1692,1696,1699,1749,1753,1768,1833,1839,1843,1852,1890,1894,1914,1950,1954,1957,2032,2036,2050,2291,2297,2301,2304,2308,2325,2381,2384,2387,2423,2430,2492,2498,2502,2515,2588,2592,2596,2606,2610,2613,2628,2635,2644,2651,2660,2705,2716,2736,2752],[357,358,360],"h2",{"id":359},"upgrade-steps","Upgrade steps",[362,363,364,376,384,390,397],"ol",{},[365,366,367,368,372,373],"li",{},"Upgrade ",[369,370,371],"code",{},"@movk\u002Fnuxt-docs"," to ",[369,374,375],{},"^3.0.0",[365,377,378,379],{},"Install the optional dependencies you use, see ",[380,381,383],"a",{"href":382},"#dependencies-and-feature-flags","Dependencies and feature flags",[365,385,386,387],{},"Make sure your docs live in ",[369,388,389],{},"content\u002Fdocs\u002F",[365,391,392,393,396],{},"Review ",[369,394,395],{},"app.config.ts"," and any overridden components",[365,398,399,400,403],{},"Run ",[369,401,402],{},"nuxt build",". Missing dependencies and conflicting options fail the build with an explanation",[357,405,407],{"id":406},"migrate-with-ai","Migrate with AI",[345,409,410,411,414],{},"Give the prompt below to a coding agent such as Claude Code, Cursor or Codex. It checks and updates your project against the changes on this page. Agents can also read the Markdown version of this page directly: ",[369,412,413],{},"https:\u002F\u002Fdocs.mhaibaraai.cn\u002Fraw\u002Fen\u002Fdocs\u002Fgetting-started\u002Fmigration.md",".",[416,417,419],"collapsible",{"name":418},"full migration prompt",[420,421,426],"pre",{"className":422,"code":423,"language":424,"meta":425,"style":425},"language-md shiki shiki-themes github-light github-light github-dark","You are upgrading **this project** (a consumer of @movk\u002Fnuxt-docs) to **@movk\u002Fnuxt-docs 3.0**.\n\nv3 turns features that are off by default into optional peer dependencies, fixes the content directory, renames some config fields, and makes an editorial layout the new visual default. Most changes fail the build outright; a few (visual defaults, component overrides) only change how the site looks.\n\nYour job:\n\n1. Find code, config and content affected by the changes below, in **this repository only**.\n2. Rewrite them to the v3 form. Do not add compatibility shims for the old form.\n3. Keep the site's current behavior and look. For the visual defaults in section 6, ask me whether to keep the v2 look before changing anything.\n4. When done, run the project's `nuxt build`, typecheck and tests, and fix failures caused by the migration.\n5. Finish with a list of changed files, newly installed dependencies, and items I need to review by hand.\n\n## Do not change\n\n- `extends: ['@movk\u002Fnuxt-docs']` stays as is\n- Overriding `useHeader` \u002F `useCategory` still works; switch to `header.nav` \u002F `docs.categories` in `app.config` only if I agree\n- MDC syntax, frontmatter fields and numeric filename prefixes are unchanged\n- The `AI_API_KEY`, `AI_BASE_URL` and `NUXT_GITHUB_TOKEN` environment variable names are unchanged\n\n## Prerequisite\n\nUpgrade `@movk\u002Fnuxt-docs` to `^3.0.0` first, using the project's package manager:\n\n```bash\npnpm add @movk\u002Fnuxt-docs@^3.0.0\n```\n\n## Change list\n\n### 1. Dependencies of optional features\n\nThese features no longer bring their dependencies with the layer. Install only for the features the project actually uses:\n\n| Feature | Enabled when | Install |\n|---|---|---|\n| Component docs | Pages use `ComponentProps` \u002F `ComponentSlots` \u002F `ComponentEmits` \u002F `ComponentCode` \u002F `ComponentExample` | `nuxt-component-meta vue-component-meta prettier`, and set `movkNuxtDocs.componentDocs: true` |\n| AI Chat | `AI_API_KEY` is present at build time, or `aiChat.enabled: true` | `ai @ai-sdk\u002Fopenai @ai-sdk\u002Fvue @comark\u002Fvue @shikijs\u002Fengine-javascript @shikijs\u002Flangs @shikijs\u002Fthemes` |\n| Mermaid | `movkNuxtDocs.mermaid` is on | `mermaid dompurify` (v2 silently skipped missing dependencies, v3 fails the build) |\n| Accessibility checks | On by default in v2, off in v3 | If needed, set `movkNuxtDocs.a11y: true` and install `@nuxt\u002Fa11y` |\n| i18n | `modules` includes `@nuxtjs\u002Fi18n` | `@nuxtjs\u002Fi18n` |\n\nTo tell whether component docs are used, search `content\u002F` and `app\u002F` for the component names above.\n\n### 2. AI Chat and MCP\n\nWith AI Chat enabled, `movkNuxtDocs.mcp: false` fails the build. If both are present, remove `mcp: false`.\n\n### 3. Content directory\n\nDocs must live in `content\u002Fdocs\u002F`, other languages in `content\u002F{locale}\u002Fdocs\u002F`, and the route prefix is always `\u002Fdocs`. If docs sit directly under `content\u002F` (e.g. `content\u002F1.getting-started\u002F`), move them into `content\u002Fdocs\u002F` and update paths in internal links, `header.nav`, `docs.categories` and similar places. `content\u002Findex.md`, `content\u002Freleases.*` and `content\u002Ftemplates.*` stay at the root of `content\u002F`.\n\n### 4. Config fields\n\n- `github.per_page` in `app.config.ts` is renamed to `github.perPage`\n- v2 only showed commits after `2025-01-31` and before build time; v3 applies no filter. If the site relied on that, set `github.since` \u002F `github.until` explicitly\n\n### 5. Removed author-specific defaults\n\nv3 no longer ships these defaults. If the site depends on them, set them explicitly in the project config:\n\n- `header.avatar` (pointed to the author's avatar in v2)\n- `github.dateFormat.options.timeZone: 'Asia\u002FShanghai'`\n- The Alibaba PuHuiTi font CDN: the font stack still prefers that font, so load its stylesheet through `app.head.link` if needed\n\n### 6. Visual defaults (ask me first)\n\n| Item | v2 | v3 | Restore v2 |\n|---|---|---|---|\n| Primary \u002F neutral color | `green` \u002F `slate` | `vermilion` \u002F `paper` | In `app.config.ts`, set `ui.colors.primary: 'green'` and `ui.colors.neutral: 'slate'` |\n| Heading font | Sans-serif | Serif (Fraunces) | `theme.font: 'sans'` |\n| Code highlighting | Nuxt Content default | `github-light` \u002F `github-dark` | Set `content.build.markdown.highlight.theme` in `nuxt.config.ts` |\n\nColors, fonts and highlight themes the project already sets explicitly stay unchanged.\n\n### 7. Component overrides\n\nLook in `app\u002Fcomponents\u002F` for overrides with the same name as layer components:\n\n- The override contract table on the Customization page lists the overridable components, mount points and props. Components not listed there (such as `ThemePickerButton`) are internal; flag them for me to review\n- The header, sidebar, table of contents, prev\u002Fnext links and footer are redesigned. Flag overrides of these components, and CSS that depends on their DOM structure, for me to review\n- `PageHeaderLinks` now mounts in the meta row below the lead paragraph of doc pages\n- The layer overrides Nuxt UI's `ProsePre`; a `ProsePre` override in the project still wins and needs no change\n\n### 8. Removed APIs\n\n- Remove every reference to the `HeroBackground` component and the `heroBackground` key in `definePageMeta({ heroBackground: ... })`\n- If the project overrides `useToolCall`, change the `state` parameter type from `ToolState` to `string` and drop the unused `ToolState` import\n\n## Verification\n\n1. Run `nuxt build`. If it reports enabled features with missing dependencies, install them as instructed; `[request error]` logs mean dead links, so fix those links\n2. Run the project's typecheck and tests\n3. Start the dev server and spot-check the home page, a doc page and a page that uses component docs\n","md","",[369,427,428,450,457,463,468,474,479,494,503,512,528,537,542,549,554,566,603,611,637,642,648,653,669,674,680,694,700,705,711,716,722,727,733,738,744,750,794,815,833,850,871,876,893,898,904,909,926,931,937,942,1011,1016,1022,1027,1046,1071,1076,1082,1087,1093,1098,1109,1117,1131,1136,1142,1147,1153,1159,1201,1212,1239,1244,1250,1255,1261,1266,1278,1283,1297,1305,1316,1335,1340,1346,1351,1374,1410,1415,1421,1426,1445,1453],{"__ignoreMap":425},[429,430,433,437,441,444,447],"span",{"class":431,"line":432},"line",1,[429,434,436],{"class":435},"sxrX7","You are upgrading ",[429,438,440],{"class":439},"sEO0R","**this project**",[429,442,443],{"class":435}," (a consumer of @movk\u002Fnuxt-docs) to ",[429,445,446],{"class":439},"**@movk\u002Fnuxt-docs 3.0**",[429,448,449],{"class":435},".\n",[429,451,453],{"class":431,"line":452},2,[429,454,456],{"emptyLinePlaceholder":455},true,"\n",[429,458,460],{"class":431,"line":459},3,[429,461,462],{"class":435},"v3 turns features that are off by default into optional peer dependencies, fixes the content directory, renames some config fields, and makes an editorial layout the new visual default. Most changes fail the build outright; a few (visual defaults, component overrides) only change how the site looks.\n",[429,464,466],{"class":431,"line":465},4,[429,467,456],{"emptyLinePlaceholder":455},[429,469,471],{"class":431,"line":470},5,[429,472,473],{"class":435},"Your job:\n",[429,475,477],{"class":431,"line":476},6,[429,478,456],{"emptyLinePlaceholder":455},[429,480,482,486,489,492],{"class":431,"line":481},7,[429,483,485],{"class":484},"sP4rz","1.",[429,487,488],{"class":435}," Find code, config and content affected by the changes below, in ",[429,490,491],{"class":439},"**this repository only**",[429,493,449],{"class":435},[429,495,497,500],{"class":431,"line":496},8,[429,498,499],{"class":484},"2.",[429,501,502],{"class":435}," Rewrite them to the v3 form. Do not add compatibility shims for the old form.\n",[429,504,506,509],{"class":431,"line":505},9,[429,507,508],{"class":484},"3.",[429,510,511],{"class":435}," Keep the site's current behavior and look. For the visual defaults in section 6, ask me whether to keep the v2 look before changing anything.\n",[429,513,515,518,521,525],{"class":431,"line":514},10,[429,516,517],{"class":484},"4.",[429,519,520],{"class":435}," When done, run the project's ",[429,522,524],{"class":523},"sBjJW","`nuxt build`",[429,526,527],{"class":435},", typecheck and tests, and fix failures caused by the migration.\n",[429,529,531,534],{"class":431,"line":530},11,[429,532,533],{"class":484},"5.",[429,535,536],{"class":435}," Finish with a list of changed files, newly installed dependencies, and items I need to review by hand.\n",[429,538,540],{"class":431,"line":539},12,[429,541,456],{"emptyLinePlaceholder":455},[429,543,545],{"class":431,"line":544},13,[429,546,548],{"class":547},"syb_3","## Do not change\n",[429,550,552],{"class":431,"line":551},14,[429,553,456],{"emptyLinePlaceholder":455},[429,555,557,560,563],{"class":431,"line":556},15,[429,558,559],{"class":484},"-",[429,561,562],{"class":523}," `extends: ['@movk\u002Fnuxt-docs']`",[429,564,565],{"class":435}," stays as is\n",[429,567,569,571,574,577,580,583,586,589,591,594,597,600],{"class":431,"line":568},16,[429,570,559],{"class":484},[429,572,573],{"class":435}," Overriding ",[429,575,576],{"class":523},"`useHeader`",[429,578,579],{"class":435}," \u002F ",[429,581,582],{"class":523},"`useCategory`",[429,584,585],{"class":435}," still works; switch to ",[429,587,588],{"class":523},"`header.nav`",[429,590,579],{"class":435},[429,592,593],{"class":523},"`docs.categories`",[429,595,596],{"class":435}," in ",[429,598,599],{"class":523},"`app.config`",[429,601,602],{"class":435}," only if I agree\n",[429,604,606,608],{"class":431,"line":605},17,[429,607,559],{"class":484},[429,609,610],{"class":435}," MDC syntax, frontmatter fields and numeric filename prefixes are unchanged\n",[429,612,614,616,619,622,625,628,631,634],{"class":431,"line":613},18,[429,615,559],{"class":484},[429,617,618],{"class":435}," The ",[429,620,621],{"class":523},"`AI_API_KEY`",[429,623,624],{"class":435},", ",[429,626,627],{"class":523},"`AI_BASE_URL`",[429,629,630],{"class":435}," and ",[429,632,633],{"class":523},"`NUXT_GITHUB_TOKEN`",[429,635,636],{"class":435}," environment variable names are unchanged\n",[429,638,640],{"class":431,"line":639},19,[429,641,456],{"emptyLinePlaceholder":455},[429,643,645],{"class":431,"line":644},20,[429,646,647],{"class":547},"## Prerequisite\n",[429,649,651],{"class":431,"line":650},21,[429,652,456],{"emptyLinePlaceholder":455},[429,654,656,658,661,663,666],{"class":431,"line":655},22,[429,657,367],{"class":435},[429,659,660],{"class":523},"`@movk\u002Fnuxt-docs`",[429,662,372],{"class":435},[429,664,665],{"class":523},"`^3.0.0`",[429,667,668],{"class":435}," first, using the project's package manager:\n",[429,670,672],{"class":431,"line":671},23,[429,673,456],{"emptyLinePlaceholder":455},[429,675,677],{"class":431,"line":676},24,[429,678,679],{"class":435},"```bash\n",[429,681,683,687,691],{"class":431,"line":682},25,[429,684,686],{"class":685},"snPdu","pnpm",[429,688,690],{"class":689},"sIIMD"," add",[429,692,693],{"class":689}," @movk\u002Fnuxt-docs@^3.0.0\n",[429,695,697],{"class":431,"line":696},26,[429,698,699],{"class":435},"```\n",[429,701,703],{"class":431,"line":702},27,[429,704,456],{"emptyLinePlaceholder":455},[429,706,708],{"class":431,"line":707},28,[429,709,710],{"class":547},"## Change list\n",[429,712,714],{"class":431,"line":713},29,[429,715,456],{"emptyLinePlaceholder":455},[429,717,719],{"class":431,"line":718},30,[429,720,721],{"class":547},"### 1. Dependencies of optional features\n",[429,723,725],{"class":431,"line":724},31,[429,726,456],{"emptyLinePlaceholder":455},[429,728,730],{"class":431,"line":729},32,[429,731,732],{"class":435},"These features no longer bring their dependencies with the layer. Install only for the features the project actually uses:\n",[429,734,736],{"class":431,"line":735},33,[429,737,456],{"emptyLinePlaceholder":455},[429,739,741],{"class":431,"line":740},34,[429,742,743],{"class":435},"| Feature | Enabled when | Install |\n",[429,745,747],{"class":431,"line":746},35,[429,748,749],{"class":435},"|---|---|---|\n",[429,751,753,756,759,761,764,766,769,771,774,776,779,782,785,788,791],{"class":431,"line":752},36,[429,754,755],{"class":435},"| Component docs | Pages use ",[429,757,758],{"class":523},"`ComponentProps`",[429,760,579],{"class":435},[429,762,763],{"class":523},"`ComponentSlots`",[429,765,579],{"class":435},[429,767,768],{"class":523},"`ComponentEmits`",[429,770,579],{"class":435},[429,772,773],{"class":523},"`ComponentCode`",[429,775,579],{"class":435},[429,777,778],{"class":523},"`ComponentExample`",[429,780,781],{"class":435}," | ",[429,783,784],{"class":523},"`nuxt-component-meta vue-component-meta prettier`",[429,786,787],{"class":435},", and set ",[429,789,790],{"class":523},"`movkNuxtDocs.componentDocs: true`",[429,792,793],{"class":435}," |\n",[429,795,797,800,802,805,808,810,813],{"class":431,"line":796},37,[429,798,799],{"class":435},"| AI Chat | ",[429,801,621],{"class":523},[429,803,804],{"class":435}," is present at build time, or ",[429,806,807],{"class":523},"`aiChat.enabled: true`",[429,809,781],{"class":435},[429,811,812],{"class":523},"`ai @ai-sdk\u002Fopenai @ai-sdk\u002Fvue @comark\u002Fvue @shikijs\u002Fengine-javascript @shikijs\u002Flangs @shikijs\u002Fthemes`",[429,814,793],{"class":435},[429,816,818,821,824,827,830],{"class":431,"line":817},38,[429,819,820],{"class":435},"| Mermaid | ",[429,822,823],{"class":523},"`movkNuxtDocs.mermaid`",[429,825,826],{"class":435}," is on | ",[429,828,829],{"class":523},"`mermaid dompurify`",[429,831,832],{"class":435}," (v2 silently skipped missing dependencies, v3 fails the build) |\n",[429,834,836,839,842,845,848],{"class":431,"line":835},39,[429,837,838],{"class":435},"| Accessibility checks | On by default in v2, off in v3 | If needed, set ",[429,840,841],{"class":523},"`movkNuxtDocs.a11y: true`",[429,843,844],{"class":435}," and install ",[429,846,847],{"class":523},"`@nuxt\u002Fa11y`",[429,849,793],{"class":435},[429,851,853,856,859,862,865,867,869],{"class":431,"line":852},40,[429,854,855],{"class":435},"| i18n | ",[429,857,858],{"class":523},"`modules`",[429,860,861],{"class":435}," includes ",[429,863,864],{"class":523},"`@nuxtjs\u002Fi18n`",[429,866,781],{"class":435},[429,868,864],{"class":523},[429,870,793],{"class":435},[429,872,874],{"class":431,"line":873},41,[429,875,456],{"emptyLinePlaceholder":455},[429,877,879,882,885,887,890],{"class":431,"line":878},42,[429,880,881],{"class":435},"To tell whether component docs are used, search ",[429,883,884],{"class":523},"`content\u002F`",[429,886,630],{"class":435},[429,888,889],{"class":523},"`app\u002F`",[429,891,892],{"class":435}," for the component names above.\n",[429,894,896],{"class":431,"line":895},43,[429,897,456],{"emptyLinePlaceholder":455},[429,899,901],{"class":431,"line":900},44,[429,902,903],{"class":547},"### 2. AI Chat and MCP\n",[429,905,907],{"class":431,"line":906},45,[429,908,456],{"emptyLinePlaceholder":455},[429,910,912,915,918,921,924],{"class":431,"line":911},46,[429,913,914],{"class":435},"With AI Chat enabled, ",[429,916,917],{"class":523},"`movkNuxtDocs.mcp: false`",[429,919,920],{"class":435}," fails the build. If both are present, remove ",[429,922,923],{"class":523},"`mcp: false`",[429,925,449],{"class":435},[429,927,929],{"class":431,"line":928},47,[429,930,456],{"emptyLinePlaceholder":455},[429,932,934],{"class":431,"line":933},48,[429,935,936],{"class":547},"### 3. Content directory\n",[429,938,940],{"class":431,"line":939},49,[429,941,456],{"emptyLinePlaceholder":455},[429,943,945,948,951,954,957,960,963,966,968,971,974,977,979,982,984,986,988,991,994,996,999,1001,1004,1007,1009],{"class":431,"line":944},50,[429,946,947],{"class":435},"Docs must live in ",[429,949,950],{"class":523},"`content\u002Fdocs\u002F`",[429,952,953],{"class":435},", other languages in ",[429,955,956],{"class":523},"`content\u002F{locale}\u002Fdocs\u002F`",[429,958,959],{"class":435},", and the route prefix is always ",[429,961,962],{"class":523},"`\u002Fdocs`",[429,964,965],{"class":435},". If docs sit directly under ",[429,967,884],{"class":523},[429,969,970],{"class":435}," (e.g. ",[429,972,973],{"class":523},"`content\u002F1.getting-started\u002F`",[429,975,976],{"class":435},"), move them into ",[429,978,950],{"class":523},[429,980,981],{"class":435}," and update paths in internal links, ",[429,983,588],{"class":523},[429,985,624],{"class":435},[429,987,593],{"class":523},[429,989,990],{"class":435}," and similar places. ",[429,992,993],{"class":523},"`content\u002Findex.md`",[429,995,624],{"class":435},[429,997,998],{"class":523},"`content\u002Freleases.*`",[429,1000,630],{"class":435},[429,1002,1003],{"class":523},"`content\u002Ftemplates.*`",[429,1005,1006],{"class":435}," stay at the root of ",[429,1008,884],{"class":523},[429,1010,449],{"class":435},[429,1012,1014],{"class":431,"line":1013},51,[429,1015,456],{"emptyLinePlaceholder":455},[429,1017,1019],{"class":431,"line":1018},52,[429,1020,1021],{"class":547},"### 4. Config fields\n",[429,1023,1025],{"class":431,"line":1024},53,[429,1026,456],{"emptyLinePlaceholder":455},[429,1028,1030,1032,1035,1037,1040,1043],{"class":431,"line":1029},54,[429,1031,559],{"class":484},[429,1033,1034],{"class":523}," `github.per_page`",[429,1036,596],{"class":435},[429,1038,1039],{"class":523},"`app.config.ts`",[429,1041,1042],{"class":435}," is renamed to ",[429,1044,1045],{"class":523},"`github.perPage`\n",[429,1047,1049,1051,1054,1057,1060,1063,1065,1068],{"class":431,"line":1048},55,[429,1050,559],{"class":484},[429,1052,1053],{"class":435}," v2 only showed commits after ",[429,1055,1056],{"class":523},"`2025-01-31`",[429,1058,1059],{"class":435}," and before build time; v3 applies no filter. If the site relied on that, set ",[429,1061,1062],{"class":523},"`github.since`",[429,1064,579],{"class":435},[429,1066,1067],{"class":523},"`github.until`",[429,1069,1070],{"class":435}," explicitly\n",[429,1072,1074],{"class":431,"line":1073},56,[429,1075,456],{"emptyLinePlaceholder":455},[429,1077,1079],{"class":431,"line":1078},57,[429,1080,1081],{"class":547},"### 5. Removed author-specific defaults\n",[429,1083,1085],{"class":431,"line":1084},58,[429,1086,456],{"emptyLinePlaceholder":455},[429,1088,1090],{"class":431,"line":1089},59,[429,1091,1092],{"class":435},"v3 no longer ships these defaults. If the site depends on them, set them explicitly in the project config:\n",[429,1094,1096],{"class":431,"line":1095},60,[429,1097,456],{"emptyLinePlaceholder":455},[429,1099,1101,1103,1106],{"class":431,"line":1100},61,[429,1102,559],{"class":484},[429,1104,1105],{"class":523}," `header.avatar`",[429,1107,1108],{"class":435}," (pointed to the author's avatar in v2)\n",[429,1110,1112,1114],{"class":431,"line":1111},62,[429,1113,559],{"class":484},[429,1115,1116],{"class":523}," `github.dateFormat.options.timeZone: 'Asia\u002FShanghai'`\n",[429,1118,1120,1122,1125,1128],{"class":431,"line":1119},63,[429,1121,559],{"class":484},[429,1123,1124],{"class":435}," The Alibaba PuHuiTi font CDN: the font stack still prefers that font, so load its stylesheet through ",[429,1126,1127],{"class":523},"`app.head.link`",[429,1129,1130],{"class":435}," if needed\n",[429,1132,1134],{"class":431,"line":1133},64,[429,1135,456],{"emptyLinePlaceholder":455},[429,1137,1139],{"class":431,"line":1138},65,[429,1140,1141],{"class":547},"### 6. Visual defaults (ask me first)\n",[429,1143,1145],{"class":431,"line":1144},66,[429,1146,456],{"emptyLinePlaceholder":455},[429,1148,1150],{"class":431,"line":1149},67,[429,1151,1152],{"class":435},"| Item | v2 | v3 | Restore v2 |\n",[429,1154,1156],{"class":431,"line":1155},68,[429,1157,1158],{"class":435},"|---|---|---|---|\n",[429,1160,1162,1165,1168,1170,1173,1175,1178,1180,1183,1186,1188,1191,1194,1196,1199],{"class":431,"line":1161},69,[429,1163,1164],{"class":435},"| Primary \u002F neutral color | ",[429,1166,1167],{"class":523},"`green`",[429,1169,579],{"class":435},[429,1171,1172],{"class":523},"`slate`",[429,1174,781],{"class":435},[429,1176,1177],{"class":523},"`vermilion`",[429,1179,579],{"class":435},[429,1181,1182],{"class":523},"`paper`",[429,1184,1185],{"class":435}," | In ",[429,1187,1039],{"class":523},[429,1189,1190],{"class":435},", set ",[429,1192,1193],{"class":523},"`ui.colors.primary: 'green'`",[429,1195,630],{"class":435},[429,1197,1198],{"class":523},"`ui.colors.neutral: 'slate'`",[429,1200,793],{"class":435},[429,1202,1204,1207,1210],{"class":431,"line":1203},70,[429,1205,1206],{"class":435},"| Heading font | Sans-serif | Serif (Fraunces) | ",[429,1208,1209],{"class":523},"`theme.font: 'sans'`",[429,1211,793],{"class":435},[429,1213,1215,1218,1221,1223,1226,1229,1232,1234,1237],{"class":431,"line":1214},71,[429,1216,1217],{"class":435},"| Code highlighting | Nuxt Content default | ",[429,1219,1220],{"class":523},"`github-light`",[429,1222,579],{"class":435},[429,1224,1225],{"class":523},"`github-dark`",[429,1227,1228],{"class":435}," | Set ",[429,1230,1231],{"class":523},"`content.build.markdown.highlight.theme`",[429,1233,596],{"class":435},[429,1235,1236],{"class":523},"`nuxt.config.ts`",[429,1238,793],{"class":435},[429,1240,1242],{"class":431,"line":1241},72,[429,1243,456],{"emptyLinePlaceholder":455},[429,1245,1247],{"class":431,"line":1246},73,[429,1248,1249],{"class":435},"Colors, fonts and highlight themes the project already sets explicitly stay unchanged.\n",[429,1251,1253],{"class":431,"line":1252},74,[429,1254,456],{"emptyLinePlaceholder":455},[429,1256,1258],{"class":431,"line":1257},75,[429,1259,1260],{"class":547},"### 7. Component overrides\n",[429,1262,1264],{"class":431,"line":1263},76,[429,1265,456],{"emptyLinePlaceholder":455},[429,1267,1269,1272,1275],{"class":431,"line":1268},77,[429,1270,1271],{"class":435},"Look in ",[429,1273,1274],{"class":523},"`app\u002Fcomponents\u002F`",[429,1276,1277],{"class":435}," for overrides with the same name as layer components:\n",[429,1279,1281],{"class":431,"line":1280},78,[429,1282,456],{"emptyLinePlaceholder":455},[429,1284,1286,1288,1291,1294],{"class":431,"line":1285},79,[429,1287,559],{"class":484},[429,1289,1290],{"class":435}," The override contract table on the Customization page lists the overridable components, mount points and props. Components not listed there (such as ",[429,1292,1293],{"class":523},"`ThemePickerButton`",[429,1295,1296],{"class":435},") are internal; flag them for me to review\n",[429,1298,1300,1302],{"class":431,"line":1299},80,[429,1301,559],{"class":484},[429,1303,1304],{"class":435}," The header, sidebar, table of contents, prev\u002Fnext links and footer are redesigned. Flag overrides of these components, and CSS that depends on their DOM structure, for me to review\n",[429,1306,1308,1310,1313],{"class":431,"line":1307},81,[429,1309,559],{"class":484},[429,1311,1312],{"class":523}," `PageHeaderLinks`",[429,1314,1315],{"class":435}," now mounts in the meta row below the lead paragraph of doc pages\n",[429,1317,1319,1321,1324,1327,1330,1332],{"class":431,"line":1318},82,[429,1320,559],{"class":484},[429,1322,1323],{"class":435}," The layer overrides Nuxt UI's ",[429,1325,1326],{"class":523},"`ProsePre`",[429,1328,1329],{"class":435},"; a ",[429,1331,1326],{"class":523},[429,1333,1334],{"class":435}," override in the project still wins and needs no change\n",[429,1336,1338],{"class":431,"line":1337},83,[429,1339,456],{"emptyLinePlaceholder":455},[429,1341,1343],{"class":431,"line":1342},84,[429,1344,1345],{"class":547},"### 8. Removed APIs\n",[429,1347,1349],{"class":431,"line":1348},85,[429,1350,456],{"emptyLinePlaceholder":455},[429,1352,1354,1356,1359,1362,1365,1368,1371],{"class":431,"line":1353},86,[429,1355,559],{"class":484},[429,1357,1358],{"class":435}," Remove every reference to the ",[429,1360,1361],{"class":523},"`HeroBackground`",[429,1363,1364],{"class":435}," component and the ",[429,1366,1367],{"class":523},"`heroBackground`",[429,1369,1370],{"class":435}," key in ",[429,1372,1373],{"class":523},"`definePageMeta({ heroBackground: ... })`\n",[429,1375,1377,1379,1382,1385,1388,1391,1394,1397,1399,1402,1405,1407],{"class":431,"line":1376},87,[429,1378,559],{"class":484},[429,1380,1381],{"class":435}," If the project overrides ",[429,1383,1384],{"class":523},"`useToolCall`",[429,1386,1387],{"class":435},", change the ",[429,1389,1390],{"class":523},"`state`",[429,1392,1393],{"class":435}," parameter type from ",[429,1395,1396],{"class":523},"`ToolState`",[429,1398,372],{"class":435},[429,1400,1401],{"class":523},"`string`",[429,1403,1404],{"class":435}," and drop the unused ",[429,1406,1396],{"class":523},[429,1408,1409],{"class":435}," import\n",[429,1411,1413],{"class":431,"line":1412},88,[429,1414,456],{"emptyLinePlaceholder":455},[429,1416,1418],{"class":431,"line":1417},89,[429,1419,1420],{"class":547},"## Verification\n",[429,1422,1424],{"class":431,"line":1423},90,[429,1425,456],{"emptyLinePlaceholder":455},[429,1427,1429,1431,1434,1436,1439,1442],{"class":431,"line":1428},91,[429,1430,485],{"class":484},[429,1432,1433],{"class":435}," Run ",[429,1435,524],{"class":523},[429,1437,1438],{"class":435},". If it reports enabled features with missing dependencies, install them as instructed; ",[429,1440,1441],{"class":523},"`[request error]`",[429,1443,1444],{"class":435}," logs mean dead links, so fix those links\n",[429,1446,1448,1450],{"class":431,"line":1447},92,[429,1449,499],{"class":484},[429,1451,1452],{"class":435}," Run the project's typecheck and tests\n",[429,1454,1456,1458],{"class":431,"line":1455},93,[429,1457,508],{"class":484},[429,1459,1460],{"class":435}," Start the dev server and spot-check the home page, a doc page and a page that uses component docs\n",[357,1462,383],{"id":1463},"dependencies-and-feature-flags",[345,1465,1466,1467,1469],{},"v3 turns the dependencies of features that are off by default into optional peers, cutting the layer's direct dependencies from 47 to 35. If you enable a feature without its dependencies, the build fails and prints the install command. See ",[380,1468,77],{"href":78}," for details.",[1471,1472,1474],"h3",{"id":1473},"component-docs-are-off-by-default","Component docs are off by default",[345,1476,1477,624,1479,624,1481,624,1483,630,1485,1487],{},[369,1478,198],{},[369,1480,204],{},[369,1482,210],{},[369,1484,222],{},[369,1486,216],{}," must be enabled explicitly:",[1489,1490,1491,1548],"code-group",{},[420,1492,1497],{"className":1493,"code":1494,"filename":1495,"language":1496,"meta":425,"style":425},"language-ts shiki shiki-themes github-light github-light github-dark","export default defineNuxtConfig({\n  extends: ['@movk\u002Fnuxt-docs'],\n  movkNuxtDocs: {\n    componentDocs: true\n  }\n})\n","v3 nuxt.config.ts","ts",[369,1498,1499,1514,1525,1530,1538,1543],{"__ignoreMap":425},[429,1500,1501,1505,1508,1511],{"class":431,"line":432},[429,1502,1504],{"class":1503},"s8jYJ","export",[429,1506,1507],{"class":1503}," default",[429,1509,1510],{"class":685}," defineNuxtConfig",[429,1512,1513],{"class":435},"({\n",[429,1515,1516,1519,1522],{"class":431,"line":452},[429,1517,1518],{"class":435},"  extends: [",[429,1520,1521],{"class":689},"'@movk\u002Fnuxt-docs'",[429,1523,1524],{"class":435},"],\n",[429,1526,1527],{"class":431,"line":459},[429,1528,1529],{"class":435},"  movkNuxtDocs: {\n",[429,1531,1532,1535],{"class":431,"line":465},[429,1533,1534],{"class":435},"    componentDocs: ",[429,1536,1537],{"class":523},"true\n",[429,1539,1540],{"class":431,"line":470},[429,1541,1542],{"class":435},"  }\n",[429,1544,1545],{"class":431,"line":476},[429,1546,1547],{"class":435},"})\n",[420,1549,1554],{"className":1550,"code":1551,"filename":1552,"language":1553,"meta":425,"style":425},"language-bash shiki shiki-themes github-light github-light github-dark","pnpm add nuxt-component-meta vue-component-meta prettier\n","Install","bash",[369,1555,1556],{"__ignoreMap":425},[429,1557,1558,1560,1562,1565,1568],{"class":431,"line":432},[429,1559,686],{"class":685},[429,1561,690],{"class":689},[429,1563,1564],{"class":689}," nuxt-component-meta",[429,1566,1567],{"class":689}," vue-component-meta",[429,1569,1570],{"class":689}," prettier\n",[1471,1572,1574],{"id":1573},"install-dependencies-for-ai-chat-accessibility-checks-and-i18n","Install dependencies for AI Chat, accessibility checks and i18n",[345,1576,1577,1578,804,1581,1584],{},"AI Chat turns on under the same conditions as before: ",[369,1579,1580],{},"AI_API_KEY",[369,1582,1583],{},"aiChat.enabled: true"," is set. The difference is that its dependencies no longer ship with the layer:",[420,1586,1588],{"className":1550,"code":1587,"language":1553,"meta":425,"style":425},"# AI Chat\npnpm add ai @ai-sdk\u002Fopenai @ai-sdk\u002Fvue @comark\u002Fvue @shikijs\u002Fengine-javascript @shikijs\u002Flangs @shikijs\u002Fthemes\n# movkNuxtDocs.a11y: true\npnpm add @nuxt\u002Fa11y\n# @nuxtjs\u002Fi18n in modules\npnpm add @nuxtjs\u002Fi18n\n",[369,1589,1590,1596,1623,1628,1637,1642],{"__ignoreMap":425},[429,1591,1592],{"class":431,"line":432},[429,1593,1595],{"class":1594},"sCsY4","# AI Chat\n",[429,1597,1598,1600,1602,1605,1608,1611,1614,1617,1620],{"class":431,"line":452},[429,1599,686],{"class":685},[429,1601,690],{"class":689},[429,1603,1604],{"class":689}," ai",[429,1606,1607],{"class":689}," @ai-sdk\u002Fopenai",[429,1609,1610],{"class":689}," @ai-sdk\u002Fvue",[429,1612,1613],{"class":689}," @comark\u002Fvue",[429,1615,1616],{"class":689}," @shikijs\u002Fengine-javascript",[429,1618,1619],{"class":689}," @shikijs\u002Flangs",[429,1621,1622],{"class":689}," @shikijs\u002Fthemes\n",[429,1624,1625],{"class":431,"line":459},[429,1626,1627],{"class":1594},"# movkNuxtDocs.a11y: true\n",[429,1629,1630,1632,1634],{"class":431,"line":465},[429,1631,686],{"class":685},[429,1633,690],{"class":689},[429,1635,1636],{"class":689}," @nuxt\u002Fa11y\n",[429,1638,1639],{"class":431,"line":470},[429,1640,1641],{"class":1594},"# @nuxtjs\u002Fi18n in modules\n",[429,1643,1644,1646,1648],{"class":431,"line":476},[429,1645,686],{"class":685},[429,1647,690],{"class":689},[429,1649,1650],{"class":689}," @nuxtjs\u002Fi18n\n",[345,1652,1653,1656,1657,1660],{},[369,1654,1655],{},"@nuxt\u002Fa11y"," is off by default in v3; set ",[369,1658,1659],{},"movkNuxtDocs.a11y: true"," to enable it.",[1471,1662,1664],{"id":1663},"mermaid-fails-the-build-when-dependencies-are-missing","Mermaid fails the build when dependencies are missing",[345,1666,1667,1668,579,1671,1674],{},"In v2, enabling Mermaid without ",[369,1669,1670],{},"mermaid",[369,1672,1673],{},"dompurify"," installed was silently skipped. v3 fails the build instead:",[420,1676,1678],{"className":1550,"code":1677,"language":1553,"meta":425,"style":425},"pnpm add mermaid dompurify\n",[369,1679,1680],{"__ignoreMap":425},[429,1681,1682,1684,1686,1689],{"class":431,"line":432},[429,1683,686],{"class":685},[429,1685,690],{"class":689},[429,1687,1688],{"class":689}," mermaid",[429,1690,1691],{"class":689}," dompurify\n",[1471,1693,1695],{"id":1694},"mcp-cannot-be-disabled-while-ai-chat-is-on","MCP cannot be disabled while AI Chat is on",[345,1697,1698],{},"AI Chat retrieves docs through the MCP Server. Setting both of these throws at build time:",[420,1700,1703],{"className":1493,"code":1701,"filename":1702,"language":1496,"meta":425,"style":425},"export default defineNuxtConfig({\n  aiChat: { enabled: true },\n  movkNuxtDocs: {\n    mcp: false \u002F\u002F Error: aiChat depends on the MCP Server\n  }\n})\n","nuxt.config.ts",[369,1704,1705,1715,1726,1730,1741,1745],{"__ignoreMap":425},[429,1706,1707,1709,1711,1713],{"class":431,"line":432},[429,1708,1504],{"class":1503},[429,1710,1507],{"class":1503},[429,1712,1510],{"class":685},[429,1714,1513],{"class":435},[429,1716,1717,1720,1723],{"class":431,"line":452},[429,1718,1719],{"class":435},"  aiChat: { enabled: ",[429,1721,1722],{"class":523},"true",[429,1724,1725],{"class":435}," },\n",[429,1727,1728],{"class":431,"line":459},[429,1729,1529],{"class":435},[429,1731,1732,1735,1738],{"class":431,"line":465},[429,1733,1734],{"class":435},"    mcp: ",[429,1736,1737],{"class":523},"false",[429,1739,1740],{"class":1594}," \u002F\u002F Error: aiChat depends on the MCP Server\n",[429,1742,1743],{"class":431,"line":470},[429,1744,1542],{"class":435},[429,1746,1747],{"class":431,"line":476},[429,1748,1547],{"class":435},[357,1750,1752],{"id":1751},"content-directory","Content directory",[345,1754,947,1755,1757,1758,959,1761,1764,1765,1767],{},[369,1756,389],{},", other locales in ",[369,1759,1760],{},"content\u002F{locale}\u002Fdocs\u002F",[369,1762,1763],{},"\u002Fdocs",". Without ",[369,1766,389],{},", v2 mounted docs at the root path, but docs pages were unreachable in that mode, so v3 removes it.",[420,1769,1771],{"className":1550,"code":1770,"language":1553,"meta":425,"style":425},"# v2: directly under content\u002F\ncontent\u002F\n├── 1.getting-started\u002F\n└── 2.guide\u002F\n\n# v3: move into content\u002Fdocs\u002F\ncontent\u002F\n└── docs\u002F\n    ├── 1.getting-started\u002F\n    └── 2.guide\u002F\n",[369,1772,1773,1778,1783,1791,1799,1803,1808,1812,1819,1826],{"__ignoreMap":425},[429,1774,1775],{"class":431,"line":432},[429,1776,1777],{"class":1594},"# v2: directly under content\u002F\n",[429,1779,1780],{"class":431,"line":452},[429,1781,1782],{"class":685},"content\u002F\n",[429,1784,1785,1788],{"class":431,"line":459},[429,1786,1787],{"class":685},"├──",[429,1789,1790],{"class":689}," 1.getting-started\u002F\n",[429,1792,1793,1796],{"class":431,"line":465},[429,1794,1795],{"class":685},"└──",[429,1797,1798],{"class":689}," 2.guide\u002F\n",[429,1800,1801],{"class":431,"line":470},[429,1802,456],{"emptyLinePlaceholder":455},[429,1804,1805],{"class":431,"line":476},[429,1806,1807],{"class":1594},"# v3: move into content\u002Fdocs\u002F\n",[429,1809,1810],{"class":431,"line":481},[429,1811,1782],{"class":685},[429,1813,1814,1816],{"class":431,"line":496},[429,1815,1795],{"class":685},[429,1817,1818],{"class":689}," docs\u002F\n",[429,1820,1821,1824],{"class":431,"line":505},[429,1822,1823],{"class":685},"    ├──",[429,1825,1790],{"class":689},[429,1827,1828,1831],{"class":431,"line":514},[429,1829,1830],{"class":685},"    └──",[429,1832,1798],{"class":689},[345,1834,1835,1836,1838],{},"The build log prints a warning when ",[369,1837,389],{}," is missing.",[357,1840,1842],{"id":1841},"config-fields","Config fields",[1471,1844,1846,1042,1849],{"id":1845},"githubper_page-is-renamed-to-githubperpage",[369,1847,1848],{},"github.per_page",[369,1850,1851],{},"github.perPage",[420,1853,1858],{"className":1854,"code":1855,"filename":1856,"language":1857,"meta":425,"style":425},"language-diff shiki shiki-themes github-light github-light github-dark","export default defineAppConfig({\n  github: {\n-   per_page: 50\n+   perPage: 50\n  }\n})\n","app\u002Fapp.config.ts","diff",[369,1859,1860,1865,1870,1876,1882,1886],{"__ignoreMap":425},[429,1861,1862],{"class":431,"line":432},[429,1863,1864],{"class":435},"export default defineAppConfig({\n",[429,1866,1867],{"class":431,"line":452},[429,1868,1869],{"class":435},"  github: {\n",[429,1871,1872],{"class":431,"line":459},[429,1873,1875],{"class":1874},"s8CdH","-   per_page: 50\n",[429,1877,1878],{"class":431,"line":465},[429,1879,1881],{"class":1880},"sovSZ","+   perPage: 50\n",[429,1883,1884],{"class":431,"line":470},[429,1885,1542],{"class":435},[429,1887,1888],{"class":431,"line":476},[429,1889,1547],{"class":435},[1471,1891,1893],{"id":1892},"commits-are-no-longer-filtered-by-date","Commits are no longer filtered by date",[345,1895,1896,1897,372,1900,630,1903,1906,1907,630,1910,1913],{},"v2 defaulted ",[369,1898,1899],{},"since",[369,1901,1902],{},"2025-01-31",[369,1904,1905],{},"until"," to the build time, hiding commits older than that date or made after the build. In v3, ",[369,1908,1909],{},"github.since",[369,1911,1912],{},"github.until"," are empty by default, with no limit. Set them explicitly to restrict the range:",[420,1915,1917],{"className":1493,"code":1916,"filename":1856,"language":1496,"meta":425,"style":425},"export default defineAppConfig({\n  github: {\n    since: '2025-01-01T00:00:00Z'\n  }\n})\n",[369,1918,1919,1930,1934,1942,1946],{"__ignoreMap":425},[429,1920,1921,1923,1925,1928],{"class":431,"line":432},[429,1922,1504],{"class":1503},[429,1924,1507],{"class":1503},[429,1926,1927],{"class":685}," defineAppConfig",[429,1929,1513],{"class":435},[429,1931,1932],{"class":431,"line":452},[429,1933,1869],{"class":435},[429,1935,1936,1939],{"class":431,"line":459},[429,1937,1938],{"class":435},"    since: ",[429,1940,1941],{"class":689},"'2025-01-01T00:00:00Z'\n",[429,1943,1944],{"class":431,"line":465},[429,1945,1542],{"class":435},[429,1947,1948],{"class":431,"line":470},[429,1949,1547],{"class":435},[1471,1951,1953],{"id":1952},"author-specific-defaults-are-removed","Author-specific defaults are removed",[345,1955,1956],{},"The v3 package no longer ships these defaults. Set them in your own config if you need them:",[1958,1959,1960,1976],"table",{},[1961,1962,1963],"thead",{},[1964,1965,1966,1970,1973],"tr",{},[1967,1968,1969],"th",{},"v2 default",[1967,1971,1972],{},"v3 default",[1967,1974,1975],{},"How to restore",[1977,1978,1979,1998,2016],"tbody",{},[1964,1980,1981,1988,1993],{},[1982,1983,1984,1987],"td",{},[369,1985,1986],{},"header.avatar"," pointing to the author's avatar",[1982,1989,1990],{},[369,1991,1992],{},"''",[1982,1994,1995,1996],{},"Set ",[369,1997,1986],{},[1964,1999,2000,2005,2008],{},[1982,2001,2002],{},[369,2003,2004],{},"github.dateFormat.options.timeZone: 'Asia\u002FShanghai'",[1982,2006,2007],{},"No time zone",[1982,2009,1995,2010,596,2013],{},[369,2011,2012],{},"timeZone",[369,2014,2015],{},"github.dateFormat.options",[1964,2017,2018,2021,2024],{},[1982,2019,2020],{},"Loads the Alibaba PuHuiTi font CDN",[1982,2022,2023],{},"Not loaded",[1982,2025,2026,2027,2031],{},"See ",[380,2028,2030],{"href":2029},"#fonts","Fonts"," below",[357,2033,2035],{"id":2034},"header-navigation-and-sidebar-categories","Header navigation and sidebar categories",[345,2037,2038,2039,579,2041,596,2043,2046,2047,2049],{},"In v2 you defined navigation by overriding ",[369,2040,299],{},[369,2042,305],{},[369,2044,2045],{},"app\u002Fcomposables\u002F",". v3 recommends declaring it in ",[369,2048,395],{},": labels can be localized, and internal links get the locale prefix and active state automatically. The old way still works.",[1489,2051,2052,2147],{},[420,2053,2056],{"className":1493,"code":2054,"filename":2055,"language":1496,"meta":425,"style":425},"export function useHeader() {\n  const desktopLinks = computed(() => [\n    { label: 'Docs', to: '\u002Fdocs\u002Fgetting-started', active: useRoute().path.startsWith('\u002Fdocs') }\n  ])\n  return { desktopLinks, mobileLinks: desktopLinks }\n}\n","v2 app\u002Fcomposables\u002FuseHeader.ts",[369,2057,2058,2071,2094,2129,2134,2142],{"__ignoreMap":425},[429,2059,2060,2062,2065,2068],{"class":431,"line":432},[429,2061,1504],{"class":1503},[429,2063,2064],{"class":1503}," function",[429,2066,2067],{"class":685}," useHeader",[429,2069,2070],{"class":435},"() {\n",[429,2072,2073,2076,2079,2082,2085,2088,2091],{"class":431,"line":452},[429,2074,2075],{"class":1503},"  const",[429,2077,2078],{"class":523}," desktopLinks",[429,2080,2081],{"class":1503}," =",[429,2083,2084],{"class":685}," computed",[429,2086,2087],{"class":435},"(() ",[429,2089,2090],{"class":1503},"=>",[429,2092,2093],{"class":435}," [\n",[429,2095,2096,2099,2102,2105,2108,2111,2114,2117,2120,2123,2126],{"class":431,"line":459},[429,2097,2098],{"class":435},"    { label: ",[429,2100,2101],{"class":689},"'Docs'",[429,2103,2104],{"class":435},", to: ",[429,2106,2107],{"class":689},"'\u002Fdocs\u002Fgetting-started'",[429,2109,2110],{"class":435},", active: ",[429,2112,2113],{"class":685},"useRoute",[429,2115,2116],{"class":435},"().path.",[429,2118,2119],{"class":685},"startsWith",[429,2121,2122],{"class":435},"(",[429,2124,2125],{"class":689},"'\u002Fdocs'",[429,2127,2128],{"class":435},") }\n",[429,2130,2131],{"class":431,"line":465},[429,2132,2133],{"class":435},"  ])\n",[429,2135,2136,2139],{"class":431,"line":470},[429,2137,2138],{"class":1503},"  return",[429,2140,2141],{"class":435}," { desktopLinks, mobileLinks: desktopLinks }\n",[429,2143,2144],{"class":431,"line":476},[429,2145,2146],{"class":435},"}\n",[420,2148,2151],{"className":1493,"code":2149,"filename":2150,"language":1496,"meta":425,"style":425},"export default defineAppConfig({\n  header: {\n    nav: [\n      { label: { 'zh-CN': '文档', 'en': 'Docs' }, to: '\u002Fdocs\u002Fgetting-started', activeMatch: '\u002Fdocs' }\n    ]\n  },\n  docs: {\n    categories: {\n      guide: [\n        { id: 'basics', title: { 'zh-CN': '基础', 'en': 'Basics' }, icon: 'i-lucide-settings' }\n      ]\n    }\n  }\n})\n","v3 app\u002Fapp.config.ts",[369,2152,2153,2163,2168,2173,2209,2214,2219,2224,2229,2234,2273,2278,2283,2287],{"__ignoreMap":425},[429,2154,2155,2157,2159,2161],{"class":431,"line":432},[429,2156,1504],{"class":1503},[429,2158,1507],{"class":1503},[429,2160,1927],{"class":685},[429,2162,1513],{"class":435},[429,2164,2165],{"class":431,"line":452},[429,2166,2167],{"class":435},"  header: {\n",[429,2169,2170],{"class":431,"line":459},[429,2171,2172],{"class":435},"    nav: [\n",[429,2174,2175,2178,2181,2184,2187,2189,2192,2194,2196,2199,2201,2204,2206],{"class":431,"line":465},[429,2176,2177],{"class":435},"      { label: { ",[429,2179,2180],{"class":689},"'zh-CN'",[429,2182,2183],{"class":435},": ",[429,2185,2186],{"class":689},"'文档'",[429,2188,624],{"class":435},[429,2190,2191],{"class":689},"'en'",[429,2193,2183],{"class":435},[429,2195,2101],{"class":689},[429,2197,2198],{"class":435}," }, to: ",[429,2200,2107],{"class":689},[429,2202,2203],{"class":435},", activeMatch: ",[429,2205,2125],{"class":689},[429,2207,2208],{"class":435}," }\n",[429,2210,2211],{"class":431,"line":470},[429,2212,2213],{"class":435},"    ]\n",[429,2215,2216],{"class":431,"line":476},[429,2217,2218],{"class":435},"  },\n",[429,2220,2221],{"class":431,"line":481},[429,2222,2223],{"class":435},"  docs: {\n",[429,2225,2226],{"class":431,"line":496},[429,2227,2228],{"class":435},"    categories: {\n",[429,2230,2231],{"class":431,"line":505},[429,2232,2233],{"class":435},"      guide: [\n",[429,2235,2236,2239,2242,2245,2247,2249,2252,2254,2256,2258,2261,2264,2271],{"class":431,"line":514},[429,2237,2238],{"class":435},"        { id: ",[429,2240,2241],{"class":689},"'basics'",[429,2243,2244],{"class":435},", title: { ",[429,2246,2180],{"class":689},[429,2248,2183],{"class":435},[429,2250,2251],{"class":689},"'基础'",[429,2253,624],{"class":435},[429,2255,2191],{"class":689},[429,2257,2183],{"class":435},[429,2259,2260],{"class":689},"'Basics'",[429,2262,2263],{"class":435}," }, icon: ",[429,2265,2266,2270],{"class":689},[2267,2268],"i",{"class":2269},"shiki-icon-highlight sFRD0","'i-lucide-settings'",[429,2272,2208],{"class":435},[429,2274,2275],{"class":431,"line":530},[429,2276,2277],{"class":435},"      ]\n",[429,2279,2280],{"class":431,"line":539},[429,2281,2282],{"class":435},"    }\n",[429,2284,2285],{"class":431,"line":544},[429,2286,1542],{"class":435},[429,2288,2289],{"class":431,"line":551},[429,2290,1547],{"class":435},[345,2292,2026,2293,2296],{},[380,2294,2295],{"href":72},"Navigation and Categories"," for the fields.",[357,2298,2300],{"id":2299},"visual-defaults","Visual defaults",[345,2302,2303],{},"v3 uses editorial typography as the default look. To keep the v2 appearance, revert the items one by one.",[1471,2305,2307],{"id":2306},"primary-and-neutral-colors","Primary and neutral colors",[345,2309,2310,2311,372,2314,2317,2318,372,2321,2324],{},"The default primary color changes from ",[369,2312,2313],{},"green",[369,2315,2316],{},"vermilion",", the neutral from ",[369,2319,2320],{},"slate",[369,2322,2323],{},"paper",", and the background is no longer pure white:",[420,2326,2328],{"className":1493,"code":2327,"filename":1856,"language":1496,"meta":425,"style":425},"export default defineAppConfig({\n  ui: {\n    colors: {\n      primary: 'green',\n      neutral: 'slate'\n    }\n  }\n})\n",[369,2329,2330,2340,2345,2350,2361,2369,2373,2377],{"__ignoreMap":425},[429,2331,2332,2334,2336,2338],{"class":431,"line":432},[429,2333,1504],{"class":1503},[429,2335,1507],{"class":1503},[429,2337,1927],{"class":685},[429,2339,1513],{"class":435},[429,2341,2342],{"class":431,"line":452},[429,2343,2344],{"class":435},"  ui: {\n",[429,2346,2347],{"class":431,"line":459},[429,2348,2349],{"class":435},"    colors: {\n",[429,2351,2352,2355,2358],{"class":431,"line":465},[429,2353,2354],{"class":435},"      primary: ",[429,2356,2357],{"class":689},"'green'",[429,2359,2360],{"class":435},",\n",[429,2362,2363,2366],{"class":431,"line":470},[429,2364,2365],{"class":435},"      neutral: ",[429,2367,2368],{"class":689},"'slate'\n",[429,2370,2371],{"class":431,"line":476},[429,2372,2282],{"class":435},[429,2374,2375],{"class":431,"line":481},[429,2376,1542],{"class":435},[429,2378,2379],{"class":431,"line":496},[429,2380,1547],{"class":435},[1471,2382,2030],{"id":2383},"fonts",[345,2385,2386],{},"The layer loads Inter, Fraunces and JetBrains Mono (Latin only) by default, with serif headings. To use sans-serif everywhere:",[420,2388,2390],{"className":1493,"code":2389,"filename":1856,"language":1496,"meta":425,"style":425},"export default defineAppConfig({\n  theme: {\n    font: 'sans'\n  }\n})\n",[369,2391,2392,2402,2407,2415,2419],{"__ignoreMap":425},[429,2393,2394,2396,2398,2400],{"class":431,"line":432},[429,2395,1504],{"class":1503},[429,2397,1507],{"class":1503},[429,2399,1927],{"class":685},[429,2401,1513],{"class":435},[429,2403,2404],{"class":431,"line":452},[429,2405,2406],{"class":435},"  theme: {\n",[429,2408,2409,2412],{"class":431,"line":459},[429,2410,2411],{"class":435},"    font: ",[429,2413,2414],{"class":689},"'sans'\n",[429,2416,2417],{"class":431,"line":465},[429,2418,1542],{"class":435},[429,2420,2421],{"class":431,"line":470},[429,2422,1547],{"class":435},[345,2424,2425,2426,2429],{},"The Alibaba PuHuiTi Chinese font CDN that v2 loaded automatically is gone. The font stack still prefers ",[369,2427,2428],{},"Alibaba PuHuiTi",", so loading the stylesheet yourself is enough:",[420,2431,2433],{"className":1493,"code":2432,"filename":1702,"language":1496,"meta":425,"style":425},"export default defineNuxtConfig({\n  app: {\n    head: {\n      link: [\n        { rel: 'stylesheet', href: 'https:\u002F\u002Fyour-cdn.example.com\u002Ffonts\u002Falibaba-puhuiti.css' }\n      ]\n    }\n  }\n})\n",[369,2434,2435,2445,2450,2455,2460,2476,2480,2484,2488],{"__ignoreMap":425},[429,2436,2437,2439,2441,2443],{"class":431,"line":432},[429,2438,1504],{"class":1503},[429,2440,1507],{"class":1503},[429,2442,1510],{"class":685},[429,2444,1513],{"class":435},[429,2446,2447],{"class":431,"line":452},[429,2448,2449],{"class":435},"  app: {\n",[429,2451,2452],{"class":431,"line":459},[429,2453,2454],{"class":435},"    head: {\n",[429,2456,2457],{"class":431,"line":465},[429,2458,2459],{"class":435},"      link: [\n",[429,2461,2462,2465,2468,2471,2474],{"class":431,"line":470},[429,2463,2464],{"class":435},"        { rel: ",[429,2466,2467],{"class":689},"'stylesheet'",[429,2469,2470],{"class":435},", href: ",[429,2472,2473],{"class":689},"'https:\u002F\u002Fyour-cdn.example.com\u002Ffonts\u002Falibaba-puhuiti.css'",[429,2475,2208],{"class":435},[429,2477,2478],{"class":431,"line":476},[429,2479,2277],{"class":435},[429,2481,2482],{"class":431,"line":481},[429,2483,2282],{"class":435},[429,2485,2486],{"class":431,"line":496},[429,2487,1542],{"class":435},[429,2489,2490],{"class":431,"line":505},[429,2491,1547],{"class":435},[345,2493,2026,2494,2497],{},[380,2495,2496],{"href":66},"Theme and Fonts"," for adding Chinese serif headings.",[1471,2499,2501],{"id":2500},"code-highlighting-theme","Code highlighting theme",[345,2503,2504,2505,579,2508,2511,2512,2514],{},"Code blocks now use ",[369,2506,2507],{},"github-light",[369,2509,2510],{},"github-dark"," instead of the Nuxt Content default theme. Override it in ",[369,2513,1702],{}," for a different theme:",[420,2516,2518],{"className":1493,"code":2517,"filename":1702,"language":1496,"meta":425,"style":425},"export default defineNuxtConfig({\n  content: {\n    build: {\n      markdown: {\n        highlight: {\n          theme: { default: 'material-theme-lighter', dark: 'material-theme-palenight' }\n        }\n      }\n    }\n  }\n})\n",[369,2519,2520,2530,2535,2540,2545,2550,2566,2571,2576,2580,2584],{"__ignoreMap":425},[429,2521,2522,2524,2526,2528],{"class":431,"line":432},[429,2523,1504],{"class":1503},[429,2525,1507],{"class":1503},[429,2527,1510],{"class":685},[429,2529,1513],{"class":435},[429,2531,2532],{"class":431,"line":452},[429,2533,2534],{"class":435},"  content: {\n",[429,2536,2537],{"class":431,"line":459},[429,2538,2539],{"class":435},"    build: {\n",[429,2541,2542],{"class":431,"line":465},[429,2543,2544],{"class":435},"      markdown: {\n",[429,2546,2547],{"class":431,"line":470},[429,2548,2549],{"class":435},"        highlight: {\n",[429,2551,2552,2555,2558,2561,2564],{"class":431,"line":476},[429,2553,2554],{"class":435},"          theme: { default: ",[429,2556,2557],{"class":689},"'material-theme-lighter'",[429,2559,2560],{"class":435},", dark: ",[429,2562,2563],{"class":689},"'material-theme-palenight'",[429,2565,2208],{"class":435},[429,2567,2568],{"class":431,"line":481},[429,2569,2570],{"class":435},"        }\n",[429,2572,2573],{"class":431,"line":496},[429,2574,2575],{"class":435},"      }\n",[429,2577,2578],{"class":431,"line":505},[429,2579,2282],{"class":435},[429,2581,2582],{"class":431,"line":514},[429,2583,1542],{"class":435},[429,2585,2586],{"class":431,"line":530},[429,2587,1547],{"class":435},[357,2589,2591],{"id":2590},"component-overrides","Component overrides",[1471,2593,2595],{"id":2594},"the-override-contract-is-the-source-of-truth","The override contract is the source of truth",[345,2597,2598,2599,2601,2602,2605],{},"From v3, overridable components, where they mount and their props are listed in the override contract table on the ",[380,2600,83],{"href":84}," page, and stay stable within v3.x. Components that are not listed, such as ",[369,2603,2604],{},"ThemePickerButton",", are internal and may change between versions.",[1471,2607,2609],{"id":2608},"page-structure-is-redesigned","Page structure is redesigned",[345,2611,2612],{},"The header, sidebar, table of contents, previous \u002F next links and footer have new structure and styles. If you overrode these components or depend on their DOM structure in CSS, compare against the new implementation:",[2614,2615,2616,2619,2625],"ul",{},[365,2617,2618],{},"The header is a two-row masthead: wordmark, text navigation and search on top, the numbered section bar below",[365,2620,2621,2624],{},[369,2622,2623],{},"PageHeaderLinks"," moves from the right of the page title to the meta row below the lead paragraph",[365,2626,2627],{},"The active sidebar item is marked by a vermilion bar on the left",[1471,2629,2631,2632],{"id":2630},"the-layer-overrides-prosepre","The layer overrides ",[369,2633,2634],{},"ProsePre",[345,2636,2637,2638,2640,2641,2643],{},"The layer overrides Nuxt UI's ",[369,2639,2634],{}," so the copy button shows \"Copy \u002F Copied\" text. If you override ",[369,2642,2634],{}," in your project, yours takes precedence.",[1471,2645,2647,2650],{"id":2646},"herobackground-is-removed",[369,2648,2649],{},"HeroBackground"," is removed",[345,2652,2653,2654,1364,2656,2659],{},"The ",[369,2655,2649],{},[369,2657,2658],{},"heroBackground"," page meta are gone. Remove any references:",[420,2661,2664],{"className":1854,"code":2662,"filename":2663,"language":1857,"meta":425,"style":425},"\u003Cscript setup lang=\"ts\">\n- definePageMeta({ heroBackground: 'opacity-30' })\n\u003C\u002Fscript>\n\n\u003Ctemplate>\n- \u003CHeroBackground \u002F>\n  \u003CContentRenderer :value=\"page\" \u002F>\n\u003C\u002Ftemplate>\n","app\u002Fpages\u002Findex.vue",[369,2665,2666,2671,2676,2681,2685,2690,2695,2700],{"__ignoreMap":425},[429,2667,2668],{"class":431,"line":432},[429,2669,2670],{"class":435},"\u003Cscript setup lang=\"ts\">\n",[429,2672,2673],{"class":431,"line":452},[429,2674,2675],{"class":1874},"- definePageMeta({ heroBackground: 'opacity-30' })\n",[429,2677,2678],{"class":431,"line":459},[429,2679,2680],{"class":435},"\u003C\u002Fscript>\n",[429,2682,2683],{"class":431,"line":465},[429,2684,456],{"emptyLinePlaceholder":455},[429,2686,2687],{"class":431,"line":470},[429,2688,2689],{"class":435},"\u003Ctemplate>\n",[429,2691,2692],{"class":431,"line":476},[429,2693,2694],{"class":1874},"- \u003CHeroBackground \u002F>\n",[429,2696,2697],{"class":431,"line":481},[429,2698,2699],{"class":435},"  \u003CContentRenderer :value=\"page\" \u002F>\n",[429,2701,2702],{"class":431,"line":496},[429,2703,2704],{"class":435},"\u003C\u002Ftemplate>\n",[1471,2706,2708,2711,2712,2715],{"id":2707},"usetoolcall-accepts-a-string-state",[369,2709,2710],{},"useToolCall"," accepts a ",[369,2713,2714],{},"string"," state",[345,2717,2718,2719,2721,2722,2725,2726,372,2729,2731,2732,2735],{},"When overriding ",[369,2720,2710],{},", the ",[369,2723,2724],{},"state"," parameter is widened from the AI SDK's ",[369,2727,2728],{},"ToolState",[369,2730,2714],{},", so core code does not depend on the optional ",[369,2733,2734],{},"ai"," package:",[420,2737,2740],{"className":1854,"code":2738,"filename":2739,"language":1857,"meta":425,"style":425},"-export function useToolCall(state: ToolState, toolName: string, input: Record\u003Cstring, string | undefined>) {\n+export function useToolCall(state: string, toolName: string, input: Record\u003Cstring, string | undefined>) {\n","app\u002Fcomposables\u002FuseToolCall.ts",[369,2741,2742,2747],{"__ignoreMap":425},[429,2743,2744],{"class":431,"line":432},[429,2745,2746],{"class":1874},"-export function useToolCall(state: ToolState, toolName: string, input: Record\u003Cstring, string | undefined>) {\n",[429,2748,2749],{"class":431,"line":452},[429,2750,2751],{"class":1880},"+export function useToolCall(state: string, toolName: string, input: Record\u003Cstring, string | undefined>) {\n",[2753,2754,2755],"style",{},"html pre.shiki code .sxrX7, html code.shiki .sxrX7{--shiki-light:#24292E;--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sEO0R, html code.shiki .sEO0R{--shiki-light:#24292E;--shiki-light-font-weight:bold;--shiki-default:#24292E;--shiki-default-font-weight:bold;--shiki-dark:#E1E4E8;--shiki-dark-font-weight:bold}html pre.shiki code .sP4rz, html code.shiki .sP4rz{--shiki-light:#E36209;--shiki-default:#E36209;--shiki-dark:#FFAB70}html pre.shiki code .sBjJW, html code.shiki .sBjJW{--shiki-light:#005CC5;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .syb_3, html code.shiki .syb_3{--shiki-light:#005CC5;--shiki-light-font-weight:bold;--shiki-default:#005CC5;--shiki-default-font-weight:bold;--shiki-dark:#79B8FF;--shiki-dark-font-weight:bold}html pre.shiki code .snPdu, html code.shiki .snPdu{--shiki-light:#6F42C1;--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sIIMD, html code.shiki .sIIMD{--shiki-light:#032F62;--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .s8jYJ, html code.shiki .s8jYJ{--shiki-light:#D73A49;--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sCsY4, html code.shiki .sCsY4{--shiki-light:#6A737D;--shiki-default:#6A737D;--shiki-dark:#6A737D}html pre.shiki code .s8CdH, html code.shiki .s8CdH{--shiki-light:#B31D28;--shiki-default:#B31D28;--shiki-dark:#FDAEB7}html pre.shiki code .sovSZ, html code.shiki .sovSZ{--shiki-light:#22863A;--shiki-default:#22863A;--shiki-dark:#85E89D}html pre.shiki code .sFRD0, html code.shiki .sFRD0{--shiki-icon-url:url(https:\u002F\u002Fapi.iconify.design\u002Flucide\u002Fsettings.svg?color=%23000)}",{"title":425,"searchDepth":452,"depth":452,"links":2757},[2758,2759,2760,2766,2767,2773,2774,2779],{"id":359,"depth":452,"text":360},{"id":406,"depth":452,"text":407},{"id":1463,"depth":452,"text":383,"children":2761},[2762,2763,2764,2765],{"id":1473,"depth":459,"text":1474},{"id":1573,"depth":459,"text":1574},{"id":1663,"depth":459,"text":1664},{"id":1694,"depth":459,"text":1695},{"id":1751,"depth":452,"text":1752},{"id":1841,"depth":452,"text":1842,"children":2768},[2769,2771,2772],{"id":1845,"depth":459,"text":2770},"github.per_page is renamed to github.perPage",{"id":1892,"depth":459,"text":1893},{"id":1952,"depth":459,"text":1953},{"id":2034,"depth":452,"text":2035},{"id":2299,"depth":452,"text":2300,"children":2775},[2776,2777,2778],{"id":2306,"depth":459,"text":2307},{"id":2383,"depth":459,"text":2030},{"id":2500,"depth":459,"text":2501},{"id":2590,"depth":452,"text":2591,"children":2780},[2781,2782,2783,2785,2787],{"id":2594,"depth":459,"text":2595},{"id":2608,"depth":459,"text":2609},{"id":2630,"depth":459,"text":2784},"The layer overrides ProsePre",{"id":2646,"depth":459,"text":2786},"HeroBackground is removed",{"id":2707,"depth":459,"text":2788},"useToolCall accepts a string state","intermediate",{},{"icon":36},"@movk\u002Fnuxt-docs 3.0",{"title":32,"description":2794},"Upgrade @movk\u002Fnuxt-docs from v2 to v3 with a checklist of breaking changes covering feature flags, content paths, config fields, theme defaults and overrides.",{"loc":33},"sKdFcVwHTf_4khVuX4hkxuD2Mvuyk0CXgHY8M4LC_FA",[2798,2799],{"title":26,"path":27,"stem":28,"description":29,"icon":30,"children":-1},{"title":45,"path":46,"stem":47,"description":49,"icon":50,"children":-1},{"data":2801,"body":2802},{},{"type":341,"children":2803},[2804],{"type":344,"tag":345,"props":2805,"children":2806},{},[2807],{"type":349,"value":35},1794996145235]