\n\nThe core module for Vue Language Tools, responsible for parsing Vue Single File Components (SFCs) and transforming them into virtual code structures that TypeScript can understand. This package is a low-level dependency for `@vue/language-server` and `vue-tsc`.\n\n## Installation\n\n```bash\nnpm install @vue/language-core\n```\n\n## Core API\n\n### `createVueLanguagePlugin`\n\nCreates a Vue language plugin for integration with Volar language services.\n\n```typescript\nimport { createVueLanguagePlugin } from '@vue/language-core';\nimport type { LanguagePlugin } from '@volar/language-core';\nimport ts from 'typescript';\n\nconst plugin: LanguagePlugin = createVueLanguagePlugin(\n ts,\n compilerOptions, // ts.CompilerOptions\n vueCompilerOptions, // VueCompilerOptions\n (scriptId) => scriptId // asFileName: Converts scriptId to a file name\n);\n```\n\n### `createParsedCommandLine`\n\nParses TypeScript and Vue compiler options from `tsconfig.json`.\n\n```typescript\nimport { createParsedCommandLine } from '@vue/language-core';\nimport ts from 'typescript';\n\nconst parsed = createParsedCommandLine(ts, ts.sys, '/path/to/tsconfig.json');\n// parsed.options: ts.CompilerOptions\n// parsed.vueOptions: VueCompilerOptions\n```\n\n### `parse`\n\nParses Vue SFC source code and returns an `SFCParseResult`.\n\n```typescript\nimport { parse } from '@vue/language-core';\n\nconst result = parse(`\n\n
{{ msg }}
\n\n\n`);\n\n// result.descriptor.template\n// result.descriptor.scriptSetup\n// result.descriptor.styles\n// result.errors\n```\n\n## `vueCompilerOptions`\n\nConfigure Vue compiler behavior through the `vueCompilerOptions` field in `tsconfig.json`:\n\n```jsonc\n{\n \"compilerOptions\": { /* ... */ },\n \"vueCompilerOptions\": {\n \"target\": 3.5,\n \"strictTemplates\": true,\n \"plugins\": [\"@vue/language-plugin-pug\"]\n }\n}\n```\n\n### File Handling Options\n\n| Option | Type | Default | Description |\n| :--- | :--- | :--- | :--- |\n| `target` | `number \\| 'auto'` | `'auto'` | Vue version. `'auto'` reads from `node_modules/vue/package.json`. |\n| `extensions` | `string[]` | `['.vue']` | File extensions to be treated as Vue SFCs. |\n| `vitePressExtensions` | `string[]` | `[]` | File extensions to be treated as VitePress Markdown. |\n| `petiteVueExtensions` | `string[]` | `[]` | File extensions to be treated as Petite Vue HTML. |\n| `plugins` | `string[]` | `[]` | Custom language plugins, e.g., [`@vue/language-plugin-pug`](../language-plugin-pug). |\n\n### Type Checking Options\n\n| Option | Type | Default | Description |\n| :--- | :--- | :--- | :--- |\n| `strictTemplates` | `boolean` | `false` | A convenience option that enables the four `check*` options below and `strictVModel`. |\n| `checkUnknownProps` | `boolean` | `false` | Check for unknown props. |\n| `checkUnknownEvents` | `boolean` | `false` | Check for unknown events. |\n| `checkUnknownComponents` | `boolean` | `false` | Check for unknown components. |\n| `checkUnknownDirectives` | `boolean` | `false` | Check for unknown directives. |\n| `strictVModel` | `boolean` | `false` | Strictly check v-model bindings. |\n| `strictCssModules` | `boolean` | `false` | Strictly check CSS Modules class names (not affected by `strictTemplates`). |\n\n### Advanced Options\n\n| Option | Type | Default | Description |\n| :--- | :--- | :--- | :--- |\n| `lib` | `string` | `'vue'` | Vue package name, used for generating import statements. |\n| `skipTemplateCodegen` | `boolean` | `false` | Skip virtual code generation for templates. |\n| `fallthroughAttributes` | `boolean` | `false` | Enable type inference for fallthrough attributes. |\n| `jsxSlots` | `boolean` | `false` | Use JSX-style slots types. |\n| `dataAttributes` | `string[]` | `[]` | Allowed data-* attribute patterns. |\n| `htmlAttributes` | `string[]` | `['aria-*']` | Allowed HTML attribute patterns. |\n| `resolveStyleImports` | `boolean` | `false` | Resolve import statements in styles. |\n| `resolveStyleClassNames` | `boolean \\| 'scoped'` | `'scoped'` | Resolve class names in styles. |\n\n## Built-in Plugins\n\nThis package includes the following built-in plugins to handle different file types and blocks:\n\n### File Parsing Plugins\n\n| Plugin | Function | Controlled By |\n| :--- | :--- | :--- |\n| `file-vue` | Parses `.vue` files into an SFC structure. | `extensions` |\n| `file-md` | Parses Markdown files into an SFC structure. | `vitePressExtensions` |\n| `file-html` | Parses HTML files into an SFC structure. | `petiteVueExtensions` |\n\n### Virtual Code Generation Plugins\n\n| Plugin | Function |\n| :--- | :--- |\n| `vue-tsx` | Generates TypeScript virtual code from an SFC. |\n| `vue-template-html` | Compiles HTML templates. |\n| `vue-template-inline-ts` | Handles TypeScript expressions in templates. |\n| `vue-template-inline-css` | Handles inline styles in templates. |\n| `vue-style-css` | Compiles CSS styles. |\n| `vue-script-js` | Handles JavaScript script blocks. |\n\n### Embedded Code Extraction Plugins\n\n| Plugin | Function |\n| :--- | :--- |\n| `vue-sfc-template` | Extracts the `` block. |\n| `vue-sfc-styles` | Extracts `
![\"NPM](\"https://img.shields.io/npm/v/@vue/language-core.svg?labelColor=18181B&color=1584FC\")
\n ![\"License\"](\"https://img.shields.io/github/license/vuejs/language-tools.svg?labelColor=18181B&color=1584FC\")
\n