123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542 |
- import * as _babel_types from '@babel/types';
- import { Statement, Expression, TSType, Node, Program, CallExpression, ObjectPattern, TSModuleDeclaration, TSPropertySignature, TSMethodSignature, TSCallSignatureDeclaration, TSFunctionType } from '@babel/types';
- import { RootNode, CompilerOptions, CodegenResult, ParserOptions, CompilerError, RawSourceMap, SourceLocation, BindingMetadata as BindingMetadata$1 } from '@vue/compiler-core';
- export { BindingMetadata, CompilerError, CompilerOptions, extractIdentifiers, generateCodeFrame, isInDestructureAssignment, isStaticProperty, walkIdentifiers } from '@vue/compiler-core';
- import { ParserPlugin } from '@babel/parser';
- export { parse as babelParse } from '@babel/parser';
- import { Result, LazyResult } from 'postcss';
- import MagicString from 'magic-string';
- export { default as MagicString } from 'magic-string';
- import TS from 'typescript';
-
- export interface AssetURLTagConfig {
- [name: string]: string[];
- }
- export interface AssetURLOptions {
- /**
- * If base is provided, instead of transforming relative asset urls into
- * imports, they will be directly rewritten to absolute urls.
- */
- base?: string | null;
- /**
- * If true, also processes absolute urls.
- */
- includeAbsolute?: boolean;
- tags?: AssetURLTagConfig;
- }
-
- export interface TemplateCompiler {
- compile(source: string | RootNode, options: CompilerOptions): CodegenResult;
- parse(template: string, options: ParserOptions): RootNode;
- }
- export interface SFCTemplateCompileResults {
- code: string;
- ast?: RootNode;
- preamble?: string;
- source: string;
- tips: string[];
- errors: (string | CompilerError)[];
- map?: RawSourceMap;
- }
- export interface SFCTemplateCompileOptions {
- source: string;
- ast?: RootNode;
- filename: string;
- id: string;
- scoped?: boolean;
- slotted?: boolean;
- isProd?: boolean;
- ssr?: boolean;
- ssrCssVars?: string[];
- inMap?: RawSourceMap;
- compiler?: TemplateCompiler;
- compilerOptions?: CompilerOptions;
- preprocessLang?: string;
- preprocessOptions?: any;
- /**
- * In some cases, compiler-sfc may not be inside the project root (e.g. when
- * linked or globally installed). In such cases a custom `require` can be
- * passed to correctly resolve the preprocessors.
- */
- preprocessCustomRequire?: (id: string) => any;
- /**
- * Configure what tags/attributes to transform into asset url imports,
- * or disable the transform altogether with `false`.
- */
- transformAssetUrls?: AssetURLOptions | AssetURLTagConfig | boolean;
- }
- export declare function compileTemplate(options: SFCTemplateCompileOptions): SFCTemplateCompileResults;
-
- export interface SFCScriptCompileOptions {
- /**
- * Scope ID for prefixing injected CSS variables.
- * This must be consistent with the `id` passed to `compileStyle`.
- */
- id: string;
- /**
- * Production mode. Used to determine whether to generate hashed CSS variables
- */
- isProd?: boolean;
- /**
- * Enable/disable source map. Defaults to true.
- */
- sourceMap?: boolean;
- /**
- * https://babeljs.io/docs/en/babel-parser#plugins
- */
- babelParserPlugins?: ParserPlugin[];
- /**
- * A list of files to parse for global types to be made available for type
- * resolving in SFC macros. The list must be fully resolved file system paths.
- */
- globalTypeFiles?: string[];
- /**
- * Compile the template and inline the resulting render function
- * directly inside setup().
- * - Only affects `<script setup>`
- * - This should only be used in production because it prevents the template
- * from being hot-reloaded separately from component state.
- */
- inlineTemplate?: boolean;
- /**
- * Generate the final component as a variable instead of default export.
- * This is useful in e.g. @vitejs/plugin-vue where the script needs to be
- * placed inside the main module.
- */
- genDefaultAs?: string;
- /**
- * Options for template compilation when inlining. Note these are options that
- * would normally be passed to `compiler-sfc`'s own `compileTemplate()`, not
- * options passed to `compiler-dom`.
- */
- templateOptions?: Partial<SFCTemplateCompileOptions>;
- /**
- * Hoist <script setup> static constants.
- * - Only enables when one `<script setup>` exists.
- * @default true
- */
- hoistStatic?: boolean;
- /**
- * (**Experimental**) Enable reactive destructure for `defineProps`
- * @default false
- */
- propsDestructure?: boolean;
- /**
- * File system access methods to be used when resolving types
- * imported in SFC macros. Defaults to ts.sys in Node.js, can be overwritten
- * to use a virtual file system for use in browsers (e.g. in REPLs)
- */
- fs?: {
- fileExists(file: string): boolean;
- readFile(file: string): string | undefined;
- realpath?(file: string): string;
- };
- /**
- * Transform Vue SFCs into custom elements.
- */
- customElement?: boolean | ((filename: string) => boolean);
- }
- interface ImportBinding {
- isType: boolean;
- imported: string;
- local: string;
- source: string;
- isFromSetup: boolean;
- isUsedInTemplate: boolean;
- }
- /**
- * Compile `<script setup>`
- * It requires the whole SFC descriptor because we need to handle and merge
- * normal `<script>` + `<script setup>` if both are present.
- */
- export declare function compileScript(sfc: SFCDescriptor, options: SFCScriptCompileOptions): SFCScriptBlock;
-
- export interface SFCParseOptions {
- filename?: string;
- sourceMap?: boolean;
- sourceRoot?: string;
- pad?: boolean | 'line' | 'space';
- ignoreEmpty?: boolean;
- compiler?: TemplateCompiler;
- templateParseOptions?: ParserOptions;
- /**
- * TODO remove in 3.5
- * @deprecated use `templateParseOptions: { prefixIdentifiers: false }` instead
- */
- parseExpressions?: boolean;
- }
- export interface SFCBlock {
- type: string;
- content: string;
- attrs: Record<string, string | true>;
- loc: SourceLocation;
- map?: RawSourceMap;
- lang?: string;
- src?: string;
- }
- export interface SFCTemplateBlock extends SFCBlock {
- type: 'template';
- ast?: RootNode;
- }
- export interface SFCScriptBlock extends SFCBlock {
- type: 'script';
- setup?: string | boolean;
- bindings?: BindingMetadata$1;
- imports?: Record<string, ImportBinding>;
- scriptAst?: _babel_types.Statement[];
- scriptSetupAst?: _babel_types.Statement[];
- warnings?: string[];
- /**
- * Fully resolved dependency file paths (unix slashes) with imported types
- * used in macros, used for HMR cache busting in @vitejs/plugin-vue and
- * vue-loader.
- */
- deps?: string[];
- }
- export interface SFCStyleBlock extends SFCBlock {
- type: 'style';
- scoped?: boolean;
- module?: string | boolean;
- }
- export interface SFCDescriptor {
- filename: string;
- source: string;
- template: SFCTemplateBlock | null;
- script: SFCScriptBlock | null;
- scriptSetup: SFCScriptBlock | null;
- styles: SFCStyleBlock[];
- customBlocks: SFCBlock[];
- cssVars: string[];
- /**
- * whether the SFC uses :slotted() modifier.
- * this is used as a compiler optimization hint.
- */
- slotted: boolean;
- /**
- * compare with an existing descriptor to determine whether HMR should perform
- * a reload vs. re-render.
- *
- * Note: this comparison assumes the prev/next script are already identical,
- * and only checks the special case where <script setup lang="ts"> unused import
- * pruning result changes due to template changes.
- */
- shouldForceReload: (prevImports: Record<string, ImportBinding>) => boolean;
- }
- export interface SFCParseResult {
- descriptor: SFCDescriptor;
- errors: (CompilerError | SyntaxError)[];
- }
- export declare function parse(source: string, options?: SFCParseOptions): SFCParseResult;
-
- type PreprocessLang = 'less' | 'sass' | 'scss' | 'styl' | 'stylus';
-
- export interface SFCStyleCompileOptions {
- source: string;
- filename: string;
- id: string;
- scoped?: boolean;
- trim?: boolean;
- isProd?: boolean;
- inMap?: RawSourceMap;
- preprocessLang?: PreprocessLang;
- preprocessOptions?: any;
- preprocessCustomRequire?: (id: string) => any;
- postcssOptions?: any;
- postcssPlugins?: any[];
- /**
- * @deprecated use `inMap` instead.
- */
- map?: RawSourceMap;
- }
- /**
- * Aligns with postcss-modules
- * https://github.com/css-modules/postcss-modules
- */
- interface CSSModulesOptions {
- scopeBehaviour?: 'global' | 'local';
- generateScopedName?: string | ((name: string, filename: string, css: string) => string);
- hashPrefix?: string;
- localsConvention?: 'camelCase' | 'camelCaseOnly' | 'dashes' | 'dashesOnly';
- exportGlobals?: boolean;
- globalModulePaths?: RegExp[];
- }
- export interface SFCAsyncStyleCompileOptions extends SFCStyleCompileOptions {
- isAsync?: boolean;
- modules?: boolean;
- modulesOptions?: CSSModulesOptions;
- }
- export interface SFCStyleCompileResults {
- code: string;
- map: RawSourceMap | undefined;
- rawResult: Result | LazyResult | undefined;
- errors: Error[];
- modules?: Record<string, string>;
- dependencies: Set<string>;
- }
- export declare function compileStyle(options: SFCStyleCompileOptions): SFCStyleCompileResults;
- export declare function compileStyleAsync(options: SFCAsyncStyleCompileOptions): Promise<SFCStyleCompileResults>;
-
- export declare function rewriteDefault(input: string, as: string, parserPlugins?: ParserPlugin[]): string;
- /**
- * Utility for rewriting `export default` in a script block into a variable
- * declaration so that we can inject things into it
- */
- export declare function rewriteDefaultAST(ast: Statement[], s: MagicString, as: string): void;
-
- type PropsDestructureBindings = Record<string, // public prop key
- {
- local: string;
- default?: Expression;
- }>;
- export declare function extractRuntimeProps(ctx: TypeResolveContext): string | undefined;
-
- interface ModelDecl {
- type: TSType | undefined;
- options: string | undefined;
- identifier: string | undefined;
- runtimeOptionNodes: Node[];
- }
-
- declare enum BindingTypes {
- /**
- * returned from data()
- */
- DATA = "data",
- /**
- * declared as a prop
- */
- PROPS = "props",
- /**
- * a local alias of a `<script setup>` destructured prop.
- * the original is stored in __propsAliases of the bindingMetadata object.
- */
- PROPS_ALIASED = "props-aliased",
- /**
- * a let binding (may or may not be a ref)
- */
- SETUP_LET = "setup-let",
- /**
- * a const binding that can never be a ref.
- * these bindings don't need `unref()` calls when processed in inlined
- * template expressions.
- */
- SETUP_CONST = "setup-const",
- /**
- * a const binding that does not need `unref()`, but may be mutated.
- */
- SETUP_REACTIVE_CONST = "setup-reactive-const",
- /**
- * a const binding that may be a ref.
- */
- SETUP_MAYBE_REF = "setup-maybe-ref",
- /**
- * bindings that are guaranteed to be refs
- */
- SETUP_REF = "setup-ref",
- /**
- * declared by other options, e.g. computed, inject
- */
- OPTIONS = "options",
- /**
- * a literal constant, e.g. 'foo', 1, true
- */
- LITERAL_CONST = "literal-const"
- }
- type BindingMetadata = {
- [key: string]: BindingTypes | undefined;
- } & {
- __isScriptSetup?: boolean;
- __propsAliases?: Record<string, string>;
- };
-
- export declare class ScriptCompileContext {
- descriptor: SFCDescriptor;
- options: Partial<SFCScriptCompileOptions>;
- isJS: boolean;
- isTS: boolean;
- isCE: boolean;
- scriptAst: Program | null;
- scriptSetupAst: Program | null;
- source: string;
- filename: string;
- s: MagicString;
- startOffset: number | undefined;
- endOffset: number | undefined;
- scope?: TypeScope;
- globalScopes?: TypeScope[];
- userImports: Record<string, ImportBinding>;
- hasDefinePropsCall: boolean;
- hasDefineEmitCall: boolean;
- hasDefineExposeCall: boolean;
- hasDefaultExportName: boolean;
- hasDefaultExportRender: boolean;
- hasDefineOptionsCall: boolean;
- hasDefineSlotsCall: boolean;
- hasDefineModelCall: boolean;
- propsCall: CallExpression | undefined;
- propsDecl: Node | undefined;
- propsRuntimeDecl: Node | undefined;
- propsTypeDecl: Node | undefined;
- propsDestructureDecl: ObjectPattern | undefined;
- propsDestructuredBindings: PropsDestructureBindings;
- propsDestructureRestId: string | undefined;
- propsRuntimeDefaults: Node | undefined;
- emitsRuntimeDecl: Node | undefined;
- emitsTypeDecl: Node | undefined;
- emitDecl: Node | undefined;
- modelDecls: Record<string, ModelDecl>;
- optionsRuntimeDecl: Node | undefined;
- bindingMetadata: BindingMetadata;
- helperImports: Set<string>;
- helper(key: string): string;
- /**
- * to be exposed on compiled script block for HMR cache busting
- */
- deps?: Set<string>;
- /**
- * cache for resolved fs
- */
- fs?: NonNullable<SFCScriptCompileOptions['fs']>;
- constructor(descriptor: SFCDescriptor, options: Partial<SFCScriptCompileOptions>);
- getString(node: Node, scriptSetup?: boolean): string;
- error(msg: string, node: Node, scope?: TypeScope): never;
- }
-
- export type SimpleTypeResolveOptions = Partial<Pick<SFCScriptCompileOptions, 'globalTypeFiles' | 'fs' | 'babelParserPlugins' | 'isProd'>>;
- /**
- * TypeResolveContext is compatible with ScriptCompileContext
- * but also allows a simpler version of it with minimal required properties
- * when resolveType needs to be used in a non-SFC context, e.g. in a babel
- * plugin. The simplest context can be just:
- * ```ts
- * const ctx: SimpleTypeResolveContext = {
- * filename: '...',
- * source: '...',
- * options: {},
- * error() {},
- * ast: []
- * }
- * ```
- */
- export type SimpleTypeResolveContext = Pick<ScriptCompileContext, 'source' | 'filename' | 'error' | 'helper' | 'getString' | 'propsTypeDecl' | 'propsRuntimeDefaults' | 'propsDestructuredBindings' | 'emitsTypeDecl' | 'isCE'> & Partial<Pick<ScriptCompileContext, 'scope' | 'globalScopes' | 'deps' | 'fs'>> & {
- ast: Statement[];
- options: SimpleTypeResolveOptions;
- };
- export type TypeResolveContext = ScriptCompileContext | SimpleTypeResolveContext;
- type Import = Pick<ImportBinding, 'source' | 'imported'>;
- interface WithScope {
- _ownerScope: TypeScope;
- }
- type ScopeTypeNode = Node & WithScope & {
- _ns?: TSModuleDeclaration & WithScope;
- };
- declare class TypeScope {
- filename: string;
- source: string;
- offset: number;
- imports: Record<string, Import>;
- types: Record<string, ScopeTypeNode>;
- declares: Record<string, ScopeTypeNode>;
- constructor(filename: string, source: string, offset?: number, imports?: Record<string, Import>, types?: Record<string, ScopeTypeNode>, declares?: Record<string, ScopeTypeNode>);
- isGenericScope: boolean;
- resolvedImportSources: Record<string, string>;
- exportedTypes: Record<string, ScopeTypeNode>;
- exportedDeclares: Record<string, ScopeTypeNode>;
- }
- interface MaybeWithScope {
- _ownerScope?: TypeScope;
- }
- interface ResolvedElements {
- props: Record<string, (TSPropertySignature | TSMethodSignature) & {
- _ownerScope: TypeScope;
- }>;
- calls?: (TSCallSignatureDeclaration | TSFunctionType)[];
- }
- /**
- * Resolve arbitrary type node to a list of type elements that can be then
- * mapped to runtime props or emits.
- */
- export declare function resolveTypeElements(ctx: TypeResolveContext, node: Node & MaybeWithScope & {
- _resolvedElements?: ResolvedElements;
- }, scope?: TypeScope, typeParameters?: Record<string, Node>): ResolvedElements;
- /**
- * @private
- */
- export declare function registerTS(_loadTS: () => typeof TS): void;
- /**
- * @private
- */
- export declare function invalidateTypeCache(filename: string): void;
- export declare function inferRuntimeType(ctx: TypeResolveContext, node: Node & MaybeWithScope, scope?: TypeScope, isKeyOf?: boolean): string[];
-
- export declare function extractRuntimeEmits(ctx: TypeResolveContext): Set<string>;
-
- export declare const version: string;
-
- export declare const parseCache: Map<string, SFCParseResult>;
- export declare const errorMessages: {
- 0: string;
- 1: string;
- 2: string;
- 3: string;
- 4: string;
- 5: string;
- 6: string;
- 7: string;
- 8: string;
- 9: string;
- 10: string;
- 11: string;
- 12: string;
- 13: string;
- 14: string;
- 15: string;
- 16: string;
- 17: string;
- 18: string;
- 19: string;
- 20: string;
- 21: string;
- 22: string;
- 23: string;
- 24: string;
- 25: string;
- 26: string;
- 27: string;
- 28: string;
- 29: string;
- 30: string;
- 31: string;
- 32: string;
- 33: string;
- 34: string;
- 35: string;
- 36: string;
- 37: string;
- 38: string;
- 39: string;
- 40: string;
- 41: string;
- 42: string;
- 43: string;
- 44: string;
- 45: string;
- 46: string;
- 47: string;
- 48: string;
- 49: string;
- 50: string;
- 51: string;
- 52: string;
- 53: string;
- };
-
- export declare const walk: any;
-
- /**
- * @deprecated this is preserved to avoid breaking vite-plugin-vue < 5.0
- * with reactivityTransform: true. The desired behavior should be silently
- * ignoring the option instead of breaking.
- */
- export declare const shouldTransformRef: () => boolean;
|