@vue/compiler-core 3.5.0-alpha.1 → 3.5.0-alpha.3

package/dist/compiler-core.d.ts

@@ -1,6 +1,7 @@
+import { PatchFlags } from '@vue/shared';
+export { generateCodeFrame } from '@vue/shared';
 import { Node as Node$1, Identifier, Function, BlockStatement as BlockStatement$1, Program, ObjectProperty } from '@babel/types';
 import { ParserPlugin } from '@babel/parser';
-export { generateCodeFrame } from '@vue/shared';
 
 export declare const FRAGMENT: unique symbol;
 export declare const TELEPORT: unique symbol;
@@ -34,7 +35,14 @@ export declare const CAMELIZE: unique symbol;
 export declare const CAPITALIZE: unique symbol;
 export declare const TO_HANDLER_KEY: unique symbol;
 export declare const SET_BLOCK_TRACKING: unique symbol;
+/**
+ * @deprecated no longer needed in 3.5+ because we no longer hoist element nodes
+ * but kept for backwards compat
+ */
 export declare const PUSH_SCOPE_ID: unique symbol;
+/**
+ * @deprecated kept for backwards compat
+ */
 export declare const POP_SCOPE_ID: unique symbol;
 export declare const WITH_CTX: unique symbol;
 export declare const UNREF: unique symbol;
@@ -88,7 +96,7 @@ export interface TransformContext extends Required<Omit<TransformOptions, keyof
     hoists: (JSChildNode | null)[];
     imports: ImportItem[];
     temps: number;
-    cached: number;
+    cached: (CacheExpression | null)[];
     identifiers: {
         [name: string]: number | undefined;
     };
@@ -112,7 +120,7 @@ export interface TransformContext extends Required<Omit<TransformOptions, keyof
     addIdentifiers(exp: ExpressionNode | string): void;
     removeIdentifiers(exp: ExpressionNode | string): void;
     hoist(exp: string | JSChildNode | ArrayExpression): SimpleExpressionNode;
-    cache<T extends JSChildNode>(exp: T, isVNode?: boolean): CacheExpression | T;
+    cache(exp: JSChildNode, isVNode?: boolean): CacheExpression;
     constantCache: WeakMap<TemplateChildNode, ConstantTypes>;
     filters?: Set<string>;
 }
@@ -200,7 +208,7 @@ export interface RootNode extends Node {
     directives: string[];
     hoists: (JSChildNode | null)[];
     imports: ImportItem[];
-    cached: number;
+    cached: (CacheExpression | null)[];
     temps: number;
     ssrHelpers?: symbol[];
     codegenNode?: TemplateChildNode | JSChildNode | BlockStatement;
@@ -278,7 +286,7 @@ export interface DirectiveNode extends Node {
 export declare enum ConstantTypes {
     NOT_CONSTANT = 0,
     CAN_SKIP_PATCH = 1,
-    CAN_HOIST = 2,
+    CAN_CACHE = 2,
     CAN_STRINGIFY = 3
 }
 export interface SimpleExpressionNode extends Node {
@@ -363,8 +371,8 @@ export interface VNodeCall extends Node {
     type: NodeTypes.VNODE_CALL;
     tag: string | symbol | CallExpression;
     props: PropsExpression | undefined;
-    children: TemplateChildNode[] | TemplateTextChildNode | SlotsExpression | ForRenderListExpression | SimpleExpressionNode | undefined;
-    patchFlag: string | undefined;
+    children: TemplateChildNode[] | TemplateTextChildNode | SlotsExpression | ForRenderListExpression | SimpleExpressionNode | CacheExpression | undefined;
+    patchFlag: PatchFlags | undefined;
     dynamicProps: string | SimpleExpressionNode | undefined;
     directives: DirectiveArguments | undefined;
     isBlock: boolean;
@@ -418,7 +426,8 @@ export interface CacheExpression extends Node {
     type: NodeTypes.JS_CACHE_EXPRESSION;
     index: number;
     value: JSChildNode;
-    isVNode: boolean;
+    needPauseTracking: boolean;
+    needArraySpread: boolean;
 }
 export interface MemoExpression extends CallExpression {
     callee: typeof WITH_MEMO;
@@ -478,7 +487,7 @@ export interface SlotsObjectProperty extends Property {
     value: SlotFunctionExpression;
 }
 export interface SlotFunctionExpression extends FunctionExpression {
-    returns: TemplateChildNode[];
+    returns: TemplateChildNode[] | CacheExpression;
 }
 export interface DynamicSlotsExpression extends CallExpression {
     callee: typeof CREATE_SLOTS;
@@ -514,7 +523,7 @@ export interface ForCodegenNode extends VNodeCall {
     tag: typeof FRAGMENT;
     props: undefined;
     children: ForRenderListExpression;
-    patchFlag: string;
+    patchFlag: PatchFlags;
     disableTracking: boolean;
 }
 export interface ForRenderListExpression extends CallExpression {
@@ -522,7 +531,7 @@ export interface ForRenderListExpression extends CallExpression {
     arguments: [ExpressionNode, ForIteratorExpression];
 }
 export interface ForIteratorExpression extends FunctionExpression {
-    returns: BlockCodegenNode;
+    returns?: BlockCodegenNode;
 }
 export declare const locStub: SourceLocation;
 export declare function createRoot(children: TemplateChildNode[], source?: string): RootNode;
@@ -537,7 +546,7 @@ type InferCodegenNodeType<T> = T extends typeof RENDER_SLOT ? RenderSlotCall : C
 export declare function createCallExpression<T extends CallExpression['callee']>(callee: T, args?: CallExpression['arguments'], loc?: SourceLocation): InferCodegenNodeType<T>;
 export declare function createFunctionExpression(params: FunctionExpression['params'], returns?: FunctionExpression['returns'], newline?: boolean, isSlot?: boolean, loc?: SourceLocation): FunctionExpression;
 export declare function createConditionalExpression(test: ConditionalExpression['test'], consequent: ConditionalExpression['consequent'], alternate: ConditionalExpression['alternate'], newline?: boolean): ConditionalExpression;
-export declare function createCacheExpression(index: number, value: JSChildNode, isVNode?: boolean): CacheExpression;
+export declare function createCacheExpression(index: number, value: JSChildNode, needPauseTracking?: boolean): CacheExpression;
 export declare function createBlockStatement(body: BlockStatement['body']): BlockStatement;
 export declare function createTemplateLiteral(elements: TemplateLiteral['elements']): TemplateLiteral;
 export declare function createIfStatement(test: IfStatement['test'], consequent: IfStatement['consequent'], alternate?: IfStatement['alternate']): IfStatement;
@@ -834,7 +843,7 @@ export interface TransformOptions extends SharedTransformCodegenOptions, ErrorHa
      */
     prefixIdentifiers?: boolean;
     /**
-     * Hoist static VNodes and props objects to `_hoisted_x` constants
+     * Cache static VNodes and props objects to `_hoisted_x` constants
      * @default false
      */
     hoistStatic?: boolean;
@@ -1018,11 +1027,14 @@ export declare function isTemplateNode(node: RootNode | TemplateChildNode): node
 export declare function isSlotOutlet(node: RootNode | TemplateChildNode): node is SlotOutletNode;
 export declare function injectProp(node: VNodeCall | RenderSlotCall, prop: Property, context: TransformContext): void;
 export declare function toValidAssetId(name: string, type: 'component' | 'directive' | 'filter'): string;
-export declare function hasScopeRef(node: TemplateChildNode | IfBranchNode | ExpressionNode | undefined, ids: TransformContext['identifiers']): boolean;
+export declare function hasScopeRef(node: TemplateChildNode | IfBranchNode | ExpressionNode | CacheExpression | undefined, ids: TransformContext['identifiers']): boolean;
 export declare function getMemoedVNodeCall(node: BlockCodegenNode | MemoExpression): VNodeCall | RenderSlotCall;
 export declare const forAliasRE: RegExp;
 
-export declare function walkIdentifiers(root: Node$1, onIdentifier: (node: Identifier, parent: Node$1, parentStack: Node$1[], isReference: boolean, isLocal: boolean) => void, includeAll?: boolean, parentStack?: Node$1[], knownIds?: Record<string, number>): void;
+/**
+ * Return value indicates whether the AST walked can be a constant
+ */
+export declare function walkIdentifiers(root: Node$1, onIdentifier: (node: Identifier, parent: Node$1 | null, parentStack: Node$1[], isReference: boolean, isLocal: boolean) => void, includeAll?: boolean, parentStack?: Node$1[], knownIds?: Record<string, number>): void;
 export declare function isReferencedIdentifier(id: Identifier, parent: Node$1 | null, parentStack: Node$1[]): boolean;
 export declare function isInDestructureAssignment(parent: Node$1, parentStack: Node$1[]): boolean;
 export declare function isInNewExpression(parentStack: Node$1[]): boolean;
@@ -1066,5 +1078,5 @@ interface SlotOutletProcessResult {
 }
 export declare function processSlotOutlet(node: SlotOutletNode, context: TransformContext): SlotOutletProcessResult;
 
-export declare function getConstantType(node: TemplateChildNode | SimpleExpressionNode, context: TransformContext): ConstantTypes;
+export declare function getConstantType(node: TemplateChildNode | SimpleExpressionNode | CacheExpression, context: TransformContext): ConstantTypes;