@vue/compiler-core 3.4.0-alpha.3 → 3.4.0-beta.1

package/dist/compiler-core.d.ts

@@ -1,6 +1,6 @@
+import { Node as Node$1, Identifier, Function, BlockStatement as BlockStatement$1, Program, ObjectProperty } from '@babel/types';
 import { ParserPlugin } from '@babel/parser';
 import { RawSourceMap, SourceMapGenerator } from 'source-map-js';
-import { Node as Node$1, Identifier, Function, BlockStatement as BlockStatement$1, Program, ObjectProperty } from '@babel/types';
 export { generateCodeFrame } from '@vue/shared';
 
 export declare const FRAGMENT: unique symbol;
@@ -45,7 +45,7 @@ export declare const IS_MEMO_SAME: unique symbol;
 export declare const helperNameMap: Record<symbol, string>;
 export declare function registerRuntimeHelpers(helpers: Record<symbol, string>): void;
 
-type OptionalOptions = 'decodeEntities' | 'whitespace' | 'isNativeTag' | 'isBuiltInComponent' | keyof CompilerCompatOptions;
+type OptionalOptions = 'decodeEntities' | 'whitespace' | 'isNativeTag' | 'isBuiltInComponent' | 'expressionPlugins' | keyof CompilerCompatOptions;
 type MergedParserOptions = Omit<Required<ParserOptions>, OptionalOptions> & Pick<ParserOptions, OptionalOptions>;
 export declare function baseParse(input: string, options?: ParserOptions): RootNode;
 
@@ -55,7 +55,7 @@ type CompilerCompatConfig = Partial<Record<CompilerDeprecationTypes, boolean | '
 interface CompilerCompatOptions {
     compatConfig?: CompilerCompatConfig;
 }
-export declare const enum CompilerDeprecationTypes {
+export declare enum CompilerDeprecationTypes {
     COMPILER_IS_ON_ELEMENT = "COMPILER_IS_ON_ELEMENT",
     COMPILER_V_BIND_SYNC = "COMPILER_V_BIND_SYNC",
     COMPILER_V_BIND_OBJECT_ORDER = "COMPILER_V_BIND_OBJECT_ORDER",
@@ -80,7 +80,7 @@ interface ImportItem {
     exp: string | ExpressionNode;
     path: string;
 }
-export interface TransformContext extends Required<Omit<TransformOptions, 'filename' | keyof CompilerCompatOptions>>, CompilerCompatOptions {
+export interface TransformContext extends Required<Omit<TransformOptions, keyof CompilerCompatOptions>>, CompilerCompatOptions {
     selfName: string | null;
     root: RootNode;
     helpers: Map<symbol, number>;
@@ -134,12 +134,12 @@ export declare function buildProps(node: ElementNode, context: TransformContext,
 export declare function buildDirectiveArgs(dir: DirectiveNode, context: TransformContext): ArrayExpression;
 
 export type Namespace = number;
-export declare const enum Namespaces {
+export declare enum Namespaces {
     HTML = 0,
     SVG = 1,
     MATH_ML = 2
 }
-export declare const enum NodeTypes {
+export declare enum NodeTypes {
     ROOT = 0,
     ELEMENT = 1,
     TEXT = 2,
@@ -168,7 +168,7 @@ export declare const enum NodeTypes {
     JS_SEQUENCE_EXPRESSION = 25,
     JS_RETURN_STATEMENT = 26
 }
-export declare const enum ElementTypes {
+export declare enum ElementTypes {
     ELEMENT = 0,
     COMPONENT = 1,
     SLOT = 2,
@@ -275,7 +275,7 @@ export interface DirectiveNode extends Node {
  * Higher levels implies lower levels. e.g. a node that can be stringified
  * can always be hoisted and skipped for patch.
  */
-export declare const enum ConstantTypes {
+export declare enum ConstantTypes {
     NOT_CONSTANT = 0,
     CAN_SKIP_PATCH = 1,
     CAN_HOIST = 2,
@@ -286,6 +286,12 @@ export interface SimpleExpressionNode extends Node {
     content: string;
     isStatic: boolean;
     constType: ConstantTypes;
+    /**
+     * - `null` means the expression is a simple identifier that doesn't need
+     *    parsing
+     * - `false` means there was a parsing error
+     */
+    ast?: Node$1 | null | false;
     /**
      * Indicates this is an identifier for a hoist vnode call and points to the
      * hoisted node.
@@ -304,6 +310,12 @@ export interface InterpolationNode extends Node {
 }
 export interface CompoundExpressionNode extends Node {
     type: NodeTypes.COMPOUND_EXPRESSION;
+    /**
+     * - `null` means the expression is a simple identifier that doesn't need
+     *    parsing
+     * - `false` means there was a parsing error
+     */
+    ast?: Node$1 | null | false;
     children: (SimpleExpressionNode | CompoundExpressionNode | InterpolationNode | TextNode | string | symbol)[];
     /**
      * an expression parsed as the params of a function will track
@@ -547,7 +559,7 @@ type InferCompilerError<T> = T extends ErrorCodes ? CoreCompilerError : Compiler
 export declare function createCompilerError<T extends number>(code: T, loc?: SourceLocation, messages?: {
     [code: number]: string;
 }, additionalMessage?: string): InferCompilerError<T>;
-export declare const enum ErrorCodes {
+export declare enum ErrorCodes {
     ABRUPT_CLOSING_OF_EMPTY_COMMENT = 0,
     CDATA_IN_HTML_CONTENT = 1,
     DUPLICATE_ATTRIBUTE = 2,
@@ -599,9 +611,8 @@ export declare const enum ErrorCodes {
     X_MODULE_MODE_NOT_SUPPORTED = 48,
     X_CACHE_HANDLER_NOT_SUPPORTED = 49,
     X_SCOPE_ID_NOT_SUPPORTED = 50,
-    DEPRECATION_VNODE_HOOKS = 51,
-    DEPRECATION_V_IS = 52,
-    __EXTEND_POINT__ = 53
+    X_VNODE_HOOKS = 51,
+    __EXTEND_POINT__ = 52
 }
 export declare const errorMessages: Record<ErrorCodes, string>;
 
@@ -624,8 +635,8 @@ export interface ParserOptions extends ErrorHandlingOptions, CompilerCompatOptio
      */
     parseMode?: 'base' | 'html' | 'sfc';
     /**
-     * Specify the root namepsace to use when parsing a tempalte.
-     * Defaults to `Namepsaces.HTML` (0).
+     * Specify the root namespace to use when parsing a template.
+     * Defaults to `Namespaces.HTML` (0).
      */
     ns?: Namespaces;
     /**
@@ -670,9 +681,20 @@ export interface ParserOptions extends ErrorHandlingOptions, CompilerCompatOptio
      * This defaults to `true` in development and `false` in production builds.
      */
     comments?: boolean;
+    /**
+     * Parse JavaScript expressions with Babel.
+     * @default false
+     */
+    prefixIdentifiers?: boolean;
+    /**
+     * A list of parser plugins to enable for `@babel/parser`, which is used to
+     * parse expressions in bindings and interpolations.
+     * https://babeljs.io/docs/en/next/babel-parser#plugins
+     */
+    expressionPlugins?: ParserPlugin[];
 }
 export type HoistTransform = (children: TemplateChildNode[], context: TransformContext, parent: ParentNode) => void;
-export declare const enum BindingTypes {
+export declare enum BindingTypes {
     /**
      * returned from data()
      */
@@ -973,6 +995,7 @@ export declare const isFunctionType: (node: Node$1) => node is Function;
 export declare const isStaticProperty: (node: Node$1) => node is ObjectProperty;
 export declare const isStaticPropertyKey: (node: Node$1, parent: Node$1) => boolean;
 export declare const TS_NODE_TYPES: string[];
+export declare function unwrapTSNode(node: Node$1): Node$1;
 
 export declare const transformModel: DirectiveTransform;