refactor(types): mark internal API exports and exclude from d.ts

BREAKING CHANGE: Internal APIs are now excluded from type decalrations.

Author: yyx990803

packages/compiler-core/api-extractor.json

@@ -2,6 +2,6 @@
   "extends": "../../api-extractor.json",
   "mainEntryPointFilePath": "./dist/packages/<unscopedPackageName>/src/index.d.ts",
   "dtsRollup": {
-    "untrimmedFilePath": "./dist/<unscopedPackageName>.d.ts"
+    "publicTrimmedFilePath": "./dist/<unscopedPackageName>.d.ts"
   }
 }

packages/compiler-dom/api-extractor.json

@@ -2,6 +2,6 @@
   "extends": "../../api-extractor.json",
   "mainEntryPointFilePath": "./dist/packages/<unscopedPackageName>/src/index.d.ts",
   "dtsRollup": {
-    "untrimmedFilePath": "./dist/<unscopedPackageName>.d.ts"
+    "publicTrimmedFilePath": "./dist/<unscopedPackageName>.d.ts"
   }
-}
+}

packages/compiler-sfc/api-extractor.json

@@ -2,6 +2,6 @@
   "extends": "../../api-extractor.json",
   "mainEntryPointFilePath": "./dist/packages/<unscopedPackageName>/src/index.d.ts",
   "dtsRollup": {
-    "untrimmedFilePath": "./dist/<unscopedPackageName>.d.ts"
+    "publicTrimmedFilePath": "./dist/<unscopedPackageName>.d.ts"
   }
-}
+}

packages/compiler-ssr/api-extractor.json

@@ -2,6 +2,6 @@
   "extends": "../../api-extractor.json",
   "mainEntryPointFilePath": "./dist/packages/<unscopedPackageName>/src/index.d.ts",
   "dtsRollup": {
-    "untrimmedFilePath": "./dist/<unscopedPackageName>.d.ts"
+    "publicTrimmedFilePath": "./dist/<unscopedPackageName>.d.ts"
   }
-}
+}

packages/reactivity/api-extractor.json

@@ -2,6 +2,6 @@
   "extends": "../../api-extractor.json",
   "mainEntryPointFilePath": "./dist/packages/<unscopedPackageName>/src/index.d.ts",
   "dtsRollup": {
-    "untrimmedFilePath": "./dist/<unscopedPackageName>.d.ts"
+    "publicTrimmedFilePath": "./dist/<unscopedPackageName>.d.ts"
   }
 }

packages/runtime-core/api-extractor.json

@@ -2,6 +2,6 @@
   "extends": "../../api-extractor.json",
   "mainEntryPointFilePath": "./dist/packages/<unscopedPackageName>/src/index.d.ts",
   "dtsRollup": {
-    "untrimmedFilePath": "./dist/<unscopedPackageName>.d.ts"
+    "publicTrimmedFilePath": "./dist/<unscopedPackageName>.d.ts"
   }
 }

packages/runtime-core/src/component.ts

@@ -417,7 +417,11 @@ type CompileFunction = (
 
 let compile: CompileFunction | undefined
 
-// exported method uses any to avoid d.ts relying on the compiler types.
+/**
+ * For runtime-dom to register the compiler.
+ * Note the exported method uses any to avoid d.ts relying on the compiler types.
+ * @internal
+ */
 export function registerRuntimeCompiler(_compile: any) {
   compile = _compile
 }

packages/runtime-core/src/directives.ts

@@ -80,6 +80,10 @@ export type DirectiveArguments = Array<
   | [Directive, any, string, DirectiveModifiers]
 >
 
+/**
+ * Adds directives to a VNode.
+ * @internal
+ */
 export function withDirectives<T extends VNode>(
   vnode: T,
   directives: DirectiveArguments

packages/runtime-core/src/helpers/createSlots.ts

@@ -6,6 +6,10 @@ interface CompiledSlotDescriptor {
   fn: Slot
 }
 
+/**
+ * Compiler runtime helper for creating dynamic slots object
+ * @internal
+ */
 export function createSlots(
   slots: Record<string, Slot>,
   dynamicSlots: (

packages/runtime-core/src/helpers/renderList.ts

@@ -1,31 +1,46 @@
 import { VNodeChild } from '../vnode'
 import { isArray, isString, isObject } from '@vue/shared'
 
-// v-for string
+/**
+ * v-for string
+ * @internal
+ */
 export function renderList(
   source: string,
   renderItem: (value: string, index: number) => VNodeChild
 ): VNodeChild[]
 
-// v-for number
+/**
+ * v-for number
+ * @internal
+ */
 export function renderList(
   source: number,
   renderItem: (value: number, index: number) => VNodeChild
 ): VNodeChild[]
 
-// v-for array
+/**
+ * v-for array
+ * @internal
+ */
 export function renderList<T>(
   source: T[],
   renderItem: (value: T, index: number) => VNodeChild
 ): VNodeChild[]
 
-// v-for iterable
+/**
+ * v-for iterable
+ * @internal
+ */
 export function renderList<T>(
   source: Iterable<T>,
   renderItem: (value: T, index: number) => VNodeChild
 ): VNodeChild[]
 
-// v-for object
+/**
+ * v-for object
+ * @internal
+ */
 export function renderList<T>(
   source: T,
   renderItem: <K extends keyof T>(

packages/runtime-core/src/helpers/renderSlot.ts

@@ -10,6 +10,10 @@ import {
 import { PatchFlags } from '@vue/shared'
 import { warn } from '../warning'
 
+/**
+ * Compiler runtime helper for rendering <slot/>
+ * @internal
+ */
 export function renderSlot(
   slots: Slots,
   name: string,

packages/runtime-core/src/helpers/resolveAssets.ts

@@ -12,12 +12,18 @@ import { warn } from '../warning'
 const COMPONENTS = 'components'
 const DIRECTIVES = 'directives'
 
+/**
+ * @internal
+ */
 export function resolveComponent(name: string): Component | string | undefined {
   return resolveAsset(COMPONENTS, name) || name
 }
 
 export const NULL_DYNAMIC_COMPONENT = Symbol()
 
+/**
+ * @internal
+ */
 export function resolveDynamicComponent(
   component: unknown
 ): Component | string | typeof NULL_DYNAMIC_COMPONENT {
@@ -29,6 +35,9 @@ export function resolveDynamicComponent(
   }
 }
 
+/**
+ * @internal
+ */
 export function resolveDirective(name: string): Directive | undefined {
   return resolveAsset(DIRECTIVES, name)
 }

packages/runtime-core/src/helpers/scopeId.ts

@@ -7,15 +7,24 @@ import { withCtx } from './withRenderContext'
 export let currentScopeId: string | null = null
 const scopeIdStack: string[] = []
 
+/**
+ * @internal
+ */
 export function pushScopeId(id: string) {
   scopeIdStack.push((currentScopeId = id))
 }
 
+/**
+ * @internal
+ */
 export function popScopeId() {
   scopeIdStack.pop()
   currentScopeId = scopeIdStack[scopeIdStack.length - 1] || null
 }
 
+/**
+ * @internal
+ */
 export function withScopeId(id: string): <T extends Function>(fn: T) => T {
   return ((fn: Function) =>
     withCtx(function(this: any) {

packages/runtime-core/src/helpers/toHandlers.ts

@@ -1,7 +1,10 @@
 import { isObject } from '@vue/shared'
 import { warn } from '../warning'
 
-// For prefixing keys in v-on="obj" with "on"
+/**
+ * For prefixing keys in v-on="obj" with "on"
+ * @internal
+ */
 export function toHandlers(obj: Record<string, any>): Record<string, any> {
   const ret: Record<string, any> = {}
   if (__DEV__ && !isObject(obj)) {

packages/runtime-core/src/helpers/withRenderContext.ts

@@ -5,6 +5,10 @@ import {
 } from '../componentRenderUtils'
 import { ComponentInternalInstance } from '../component'
 
+/**
+ * Wrap a slot function to memoize current rendering instance
+ * @internal
+ */
 export function withCtx(
   fn: Slot,
   ctx: ComponentInternalInstance | null = currentRenderingInstance

packages/runtime-core/src/index.ts

@@ -74,9 +74,8 @@ export { useCSSModule } from './helpers/useCssModule'
 // SSR context
 export { useSSRContext, ssrContextKey } from './helpers/useSsrContext'
 
-// Internal API ----------------------------------------------------------------
+// Custom Renderer API ---------------------------------------------------------
 
-// For custom renderers
 export { createRenderer, createHydrationRenderer } from './renderer'
 export { queuePostFlushCb } from './scheduler'
 export { warn } from './warning'
@@ -92,57 +91,6 @@ export {
   setTransitionHooks
 } from './components/BaseTransition'
 
-// For compiler generated code
-// should sync with '@vue/compiler-core/src/runtimeConstants.ts'
-export { withCtx } from './helpers/withRenderContext'
-export { withDirectives } from './directives'
-export {
-  resolveComponent,
-  resolveDirective,
-  resolveDynamicComponent
-} from './helpers/resolveAssets'
-export { renderList } from './helpers/renderList'
-export { toHandlers } from './helpers/toHandlers'
-export { renderSlot } from './helpers/renderSlot'
-export { createSlots } from './helpers/createSlots'
-export { pushScopeId, popScopeId, withScopeId } from './helpers/scopeId'
-export {
-  setBlockTracking,
-  createTextVNode,
-  createCommentVNode,
-  createStaticVNode
-} from './vnode'
-export { toDisplayString, camelize } from '@vue/shared'
-
-// For integration with runtime compiler
-export { registerRuntimeCompiler } from './component'
-
-// For test-utils
-export { transformVNodeArgs } from './vnode'
-
-// SSR -------------------------------------------------------------------------
-
-import { createComponentInstance, setupComponent } from './component'
-import {
-  renderComponentRoot,
-  setCurrentRenderingInstance
-} from './componentRenderUtils'
-import { isVNode, normalizeVNode } from './vnode'
-import { normalizeSuspenseChildren } from './components/Suspense'
-
-// SSR utils are only exposed in cjs builds.
-const _ssrUtils = {
-  createComponentInstance,
-  setupComponent,
-  renderComponentRoot,
-  setCurrentRenderingInstance,
-  isVNode,
-  normalizeVNode,
-  normalizeSuspenseChildren
-}
-
-export const ssrUtils = (__NODE_JS__ ? _ssrUtils : null) as typeof _ssrUtils
-
 // Types -----------------------------------------------------------------------
 
 export {
@@ -233,3 +181,63 @@ export {
   AsyncComponentLoader
 } from './apiAsyncComponent'
 export { HMRRuntime } from './hmr'
+
+// Internal API ----------------------------------------------------------------
+
+// **IMPORTANT** Internal APIs may change without notice between versions and
+// user code should avoid relying on them.
+
+// For compiler generated code
+// should sync with '@vue/compiler-core/src/runtimeConstants.ts'
+export { withCtx } from './helpers/withRenderContext'
+export { withDirectives } from './directives'
+export {
+  resolveComponent,
+  resolveDirective,
+  resolveDynamicComponent
+} from './helpers/resolveAssets'
+export { renderList } from './helpers/renderList'
+export { toHandlers } from './helpers/toHandlers'
+export { renderSlot } from './helpers/renderSlot'
+export { createSlots } from './helpers/createSlots'
+export { pushScopeId, popScopeId, withScopeId } from './helpers/scopeId'
+export {
+  setBlockTracking,
+  createTextVNode,
+  createCommentVNode,
+  createStaticVNode
+} from './vnode'
+export { toDisplayString, camelize } from '@vue/shared'
+// For integration with runtime compiler
+export { registerRuntimeCompiler } from './component'
+// For test-utils
+export { transformVNodeArgs } from './vnode'
+
+// SSR -------------------------------------------------------------------------
+
+// **IMPORTANT** These APIs are exposed solely for @vue/server-renderer and may
+// change without notice between versions. User code should never rely on them.
+
+import { createComponentInstance, setupComponent } from './component'
+import {
+  renderComponentRoot,
+  setCurrentRenderingInstance
+} from './componentRenderUtils'
+import { isVNode, normalizeVNode } from './vnode'
+import { normalizeSuspenseChildren } from './components/Suspense'
+
+const _ssrUtils = {
+  createComponentInstance,
+  setupComponent,
+  renderComponentRoot,
+  setCurrentRenderingInstance,
+  isVNode,
+  normalizeVNode,
+  normalizeSuspenseChildren
+}
+
+/**
+ * SSR utils for \@vue/server-renderer. Only exposed in cjs builds.
+ * @internal
+ */
+export const ssrUtils = (__NODE_JS__ ? _ssrUtils : null) as typeof _ssrUtils