@vue/compiler-sfc 3.2.21 → 3.2.25

package/dist/compiler-sfc.d.ts

@@ -15,13 +15,13 @@ import { ParserPlugin } from '@babel/parser';
 import { RawSourceMap } from 'source-map';
 import { Result } from 'postcss';
 import { RootNode } from '@vue/compiler-core';
-import { shouldTransform as shouldTransformRef } from '@vue/ref-transform';
+import { shouldTransform as shouldTransformRef } from '@vue/reactivity-transform';
 import { SourceLocation } from '@vue/compiler-core';
-import { transform as transformRef } from '@vue/ref-transform';
-import { transformAST as transformRefAST } from '@vue/ref-transform';
+import { transform as transformRef } from '@vue/reactivity-transform';
+import { transformAST as transformRefAST } from '@vue/reactivity-transform';
 import { walkIdentifiers } from '@vue/compiler-core';
 
-declare interface AssetURLOptions {
+export declare interface AssetURLOptions {
     /**
      * If base is provided, instead of transforming relative asset urls into
      * imports, they will be directly rewritten to absolute urls.
@@ -34,7 +34,7 @@ declare interface AssetURLOptions {
     tags?: AssetURLTagConfig;
 }
 
-declare interface AssetURLTagConfig {
+export declare interface AssetURLTagConfig {
     [name: string]: string[];
 }
 
@@ -76,6 +76,14 @@ export { extractIdentifiers }
 
 export { generateCodeFrame }
 
+declare interface ImportBinding {
+    isType: boolean;
+    imported: string;
+    source: string;
+    isFromSetup: boolean;
+    isUsedInTemplate: boolean;
+}
+
 export { isInDestructureAssignment }
 
 export { isStaticProperty }
@@ -117,7 +125,20 @@ export declare interface SFCDescriptor {
     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 declare interface SFCParseOptions {
@@ -129,7 +150,7 @@ export declare interface SFCParseOptions {
     compiler?: TemplateCompiler;
 }
 
-declare interface SFCParseResult {
+export declare interface SFCParseResult {
     descriptor: SFCDescriptor;
     errors: (CompilerError | SyntaxError)[];
 }
@@ -138,6 +159,7 @@ export declare interface SFCScriptBlock extends SFCBlock {
     type: 'script';
     setup?: string | boolean;
     bindings?: BindingMetadata;
+    imports?: Record<string, ImportBinding>;
     /**
      * import('\@babel/types').Statement
      */
@@ -150,7 +172,7 @@ export declare interface SFCScriptBlock extends SFCBlock {
 
 export declare interface SFCScriptCompileOptions {
     /**
-     * Scope ID for prefixing injected CSS varialbes.
+     * Scope ID for prefixing injected CSS variables.
      * This must be consistent with the `id` passed to `compileStyle`.
      */
     id: string;
@@ -166,15 +188,22 @@ export declare interface SFCScriptCompileOptions {
      * https://babeljs.io/docs/en/babel-parser#plugins
      */
     babelParserPlugins?: ParserPlugin[];
+    /**
+     * (Experimental) Enable syntax transform for using refs without `.value` and
+     * using destructured props with reactivity
+     */
+    reactivityTransform?: boolean;
     /**
      * (Experimental) Enable syntax transform for using refs without `.value`
      * https://github.com/vuejs/rfcs/discussions/369
+     * @deprecated now part of `reactivityTransform`
      * @default false
      */
     refTransform?: boolean;
     /**
      * (Experimental) Enable syntax transform for destructuring from defineProps()
      * https://github.com/vuejs/rfcs/discussions/394
+     * @deprecated now part of `reactivityTransform`
      * @default false
      */
     propsDestructureTransform?: boolean;
@@ -192,7 +221,7 @@ export declare interface SFCScriptCompileOptions {
     inlineTemplate?: boolean;
     /**
      * Options for template compilation when inlining. Note these are options that
-     * would normally be pased to `compiler-sfc`'s own `compileTemplate()`, not
+     * would normally be passed to `compiler-sfc`'s own `compileTemplate()`, not
      * options passed to `compiler-dom`.
      */
     templateOptions?: Partial<SFCTemplateCompileOptions>;