474 lines
16 KiB
TypeScript
474 lines
16 KiB
TypeScript
|
import * as _babel_types from '@babel/types';
|
||
|
import { Statement, Expression, TSType, Program, Node, ObjectPattern, TSModuleDeclaration, TSPropertySignature, TSMethodSignature, TSCallSignatureDeclaration, TSFunctionType } from '@babel/types';
|
||
|
import { CompilerOptions, CodegenResult, ParserOptions, RootNode, CompilerError, SourceLocation, ElementNode, BindingMetadata as BindingMetadata$1 } from '@vue/compiler-core';
|
||
|
export { BindingMetadata, CompilerError, CompilerOptions, extractIdentifiers, generateCodeFrame, isInDestructureAssignment, isStaticProperty, walkIdentifiers } from '@vue/compiler-core';
|
||
|
import { RawSourceMap } from 'source-map-js';
|
||
|
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';
|
||
|
export { shouldTransform as shouldTransformRef, transform as transformRef, transformAST as transformRefAST } from '@vue/reactivity-transform';
|
||
|
|
||
|
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(template: string, 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;
|
||
|
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 macro `defineModel`
|
||
|
* @default false
|
||
|
*/
|
||
|
defineModel?: 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;
|
||
|
};
|
||
|
/**
|
||
|
* (Experimental) Enable syntax transform for using refs without `.value` and
|
||
|
* using destructured props with reactivity
|
||
|
* @deprecated the Reactivity Transform proposal has been dropped. This
|
||
|
* feature will be removed from Vue core in 3.4. If you intend to continue
|
||
|
* using it, disable this and switch to the [Vue Macros implementation](https://vue-macros.sxzz.moe/features/reactivity-transform.html).
|
||
|
*/
|
||
|
reactivityTransform?: 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;
|
||
|
}
|
||
|
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: ElementNode;
|
||
|
}
|
||
|
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 const parseCache: Map<string, SFCParseResult> & {
|
||
|
max?: number | undefined;
|
||
|
};
|
||
|
export declare function parse(source: string, { sourceMap, filename, sourceRoot, pad, ignoreEmpty, compiler }?: 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;
|
||
|
}>;
|
||
|
|
||
|
interface ModelDecl {
|
||
|
type: TSType | undefined;
|
||
|
options: string | undefined;
|
||
|
identifier: string | undefined;
|
||
|
}
|
||
|
|
||
|
declare const 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;
|
||
|
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;
|
||
|
propsIdentifier: string | undefined;
|
||
|
propsRuntimeDecl: Node | undefined;
|
||
|
propsTypeDecl: Node | undefined;
|
||
|
propsDestructureDecl: ObjectPattern | undefined;
|
||
|
propsDestructuredBindings: PropsDestructureBindings;
|
||
|
propsDestructureRestId: string | undefined;
|
||
|
propsRuntimeDefaults: Node | undefined;
|
||
|
emitsRuntimeDecl: Node | undefined;
|
||
|
emitsTypeDecl: Node | undefined;
|
||
|
emitIdentifier: string | 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;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* 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' | 'options'> & Partial<Pick<ScriptCompileContext, 'scope' | 'globalScopes' | 'deps' | 'fs'>> & {
|
||
|
ast: Statement[];
|
||
|
};
|
||
|
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>);
|
||
|
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): ResolvedElements;
|
||
|
/**
|
||
|
* @private
|
||
|
*/
|
||
|
export declare function registerTS(_ts: any): void;
|
||
|
/**
|
||
|
* @private
|
||
|
*/
|
||
|
export declare function invalidateTypeCache(filename: string): void;
|
||
|
export declare function inferRuntimeType(ctx: TypeResolveContext, node: Node & MaybeWithScope, scope?: TypeScope): string[];
|
||
|
|
||
|
export declare const version: string;
|
||
|
|
||
|
export declare const walk: any;
|
||
|
|