TextNode,
CommentNode,
ExpressionNode,
- NodeTypes
+ NodeTypes,
+ JSChildNode,
+ CallExpression,
+ ArrayExpression,
+ ObjectExpression,
+ IfBranchNode
} from './ast'
import { SourceMapGenerator, RawSourceMap } from 'source-map'
-import { advancePositionWithMutation } from './utils'
+import { advancePositionWithMutation, assert } from './utils'
+import { isString, isArray } from '@vue/shared'
+import { RENDER_LIST_HELPER } from './transforms/vFor'
+
+type CodegenNode = ChildNode | JSChildNode
export interface CodegenOptions {
- // Assume ES module environment. If true, will generate import statements for
+ // will generate import statements for
// runtime helpers; otherwise will grab the helpers from global `Vue`.
// default: false
- module?: boolean
+ mode?: 'module' | 'function'
+ useWith?: boolean
// Filename for source map generation.
filename?: string
}
line: number
column: number
offset: number
- indent: number
+ indentLevel: number
imports: Set<string>
knownIdentifiers: Set<string>
map?: SourceMapGenerator
- push(generatedCode: string, astNode?: ChildNode): void
-}
-
-export function generate(
- ast: RootNode,
- options: CodegenOptions = {}
-): CodegenResult {
- const context = createCodegenContext(ast, options)
- if (context.module) {
- // TODO inject import statements on RootNode
- context.push(`export function render() {\n`)
- context.indent++
- context.push(` return `)
- }
- if (ast.children.length === 1) {
- genNode(ast.children[0], context)
- } else {
- genChildren(ast.children, context)
- }
- if (context.module) {
- context.indent--
- context.push(`\n}`)
- }
- return {
- code: context.code,
- map: context.map ? context.map.toJSON() : undefined
- }
+ push(code: string, node?: CodegenNode): void
+ indent(): void
+ deindent(): void
+ newline(): void
}
function createCodegenContext(
ast: RootNode,
- { module = false, filename = `template.vue.html` }: CodegenOptions
+ {
+ mode = 'function',
+ useWith = true,
+ filename = `template.vue.html`
+ }: CodegenOptions
): CodegenContext {
const context: CodegenContext = {
- module,
+ mode,
+ useWith,
filename,
source: ast.loc.source,
code: ``,
column: 1,
line: 1,
offset: 0,
- indent: 0,
+ indentLevel: 0,
imports: new Set(),
knownIdentifiers: new Set(),
? undefined
: new (require('source-map')).SourceMapGenerator(),
- push(generatedCode, node) {
- // TODO handle indent
- context.code += generatedCode
+ push(code, node?: CodegenNode) {
+ context.code += code
if (context.map) {
if (node) {
context.map.addMapping({
}
})
}
- advancePositionWithMutation(
- context,
- generatedCode,
- generatedCode.length
- )
+ advancePositionWithMutation(context, code, code.length)
}
+ },
+ indent() {
+ newline(++context.indentLevel)
+ },
+ deindent() {
+ newline(--context.indentLevel)
+ },
+ newline() {
+ newline(context.indentLevel)
}
}
+ const newline = (n: number) => context.push('\n' + ` `.repeat(n))
if (!__BROWSER__) {
context.map!.setSourceContent(filename, context.source)
}
return context
}
+export function generate(
+ ast: RootNode,
+ options: CodegenOptions = {}
+): CodegenResult {
+ const context = createCodegenContext(ast, options)
+ // TODO handle different output for module mode and IIFE mode
+ const { mode, push, useWith, indent, deindent } = context
+ if (mode === 'function') {
+ // TODO generate const declarations for helpers
+ push(`return `)
+ } else {
+ // TODO generate import statements for helpers
+ push(`export default `)
+ }
+ push(`function render() {`)
+ if (useWith) {
+ indent()
+ push(`with (this) {`)
+ }
+ indent()
+ push(`return `)
+ genChildren(ast.children, context)
+ if (useWith) {
+ deindent()
+ push(`}`)
+ }
+ deindent()
+ push(`}`)
+ return {
+ code: context.code,
+ map: context.map ? context.map.toJSON() : undefined
+ }
+}
+
+// This will generate a single vnode call if the list has length === 1.
function genChildren(children: ChildNode[], context: CodegenContext) {
- context.push(`[`)
- for (let i = 0; i < children.length; i++) {
- genNode(children[i], context)
- if (i < children.length - 1) context.push(', ')
+ if (children.length === 1) {
+ genNode(children[0], context)
+ } else {
+ genNodeListAsArray(children, context)
}
+}
+
+function genNodeListAsArray(
+ nodes: (string | CodegenNode | ChildNode[])[],
+ context: CodegenContext
+) {
+ const multilines = nodes.length > 1
+ context.push(`[`)
+ multilines && context.indent()
+ genNodeList(nodes, context, multilines)
+ multilines && context.deindent()
context.push(`]`)
}
-function genNode(node: ChildNode, context: CodegenContext) {
+function genNodeList(
+ nodes: (string | CodegenNode | ChildNode[])[],
+ context: CodegenContext,
+ multilines: boolean = false
+) {
+ const { push, newline } = context
+ for (let i = 0; i < nodes.length; i++) {
+ const node = nodes[i]
+ if (isString(node)) {
+ // plain code string
+ // note not adding quotes here because this can be any code,
+ // not just plain strings.
+ push(node)
+ } else if (isArray(node)) {
+ // child VNodes in a h() call
+ // not using genChildren here because we want them to always be an array
+ genNodeListAsArray(node, context)
+ } else {
+ genNode(node, context)
+ }
+ if (i < nodes.length - 1) {
+ if (multilines) {
+ push(',')
+ newline()
+ } else {
+ push(', ')
+ }
+ }
+ }
+}
+
+function genNode(node: CodegenNode, context: CodegenContext) {
switch (node.type) {
case NodeTypes.ELEMENT:
genElement(node, context)
case NodeTypes.FOR:
genFor(node, context)
break
+ case NodeTypes.JS_CALL_EXPRESSION:
+ genCallExpression(node, context)
+ break
+ case NodeTypes.JS_OBJECT_EXPRESSION:
+ genObjectExpression(node, context)
+ break
+ case NodeTypes.JS_ARRAY_EXPRESSION:
+ genArrayExpression(node, context)
}
}
-function genElement(node: ElementNode, context: CodegenContext) {}
+function genElement(node: ElementNode, context: CodegenContext) {
+ __DEV__ &&
+ assert(
+ node.codegenNode != null,
+ `AST is not transformed for codegen. ` +
+ `Apply appropriate transforms first.`
+ )
+ genCallExpression(node.codegenNode!, context, false)
+}
function genText(node: TextNode | ExpressionNode, context: CodegenContext) {
context.push(JSON.stringify(node.content), node)
}
function genExpression(node: ExpressionNode, context: CodegenContext) {
- if (!__BROWSER__) {
- // TODO parse expression content and rewrite identifiers
+ // if (node.codegenNode) {
+ // TODO handle transformed expression
+ // }
+ const text = node.isStatic ? JSON.stringify(node.content) : node.content
+ context.push(text, node)
+}
+
+function genExpressionAsPropertyKey(
+ node: ExpressionNode,
+ context: CodegenContext
+) {
+ // if (node.codegenNode) {
+ // TODO handle transformed expression
+ // }
+ if (node.isStatic) {
+ // only quote keys if necessary
+ const text = /^\d|[^\w]/.test(node.content)
+ ? JSON.stringify(node.content)
+ : node.content
+ context.push(text, node)
+ } else {
+ context.push(`[${node.content}]`, node)
}
- context.push(node.content, node)
}
function genComment(node: CommentNode, context: CodegenContext) {
}
// control flow
-function genIf(node: IfNode, context: CodegenContext) {}
+function genIf(node: IfNode, context: CodegenContext) {
+ genIfBranch(node.branches[0], node.branches, 1, context)
+}
-function genFor(node: ForNode, context: CodegenContext) {}
+function genIfBranch(
+ { condition, children }: IfBranchNode,
+ branches: IfBranchNode[],
+ nextIndex: number,
+ context: CodegenContext
+) {
+ if (condition) {
+ // v-if or v-else-if
+ context.push(`(${condition.content})`, condition)
+ context.push(`?`)
+ genChildren(children, context)
+ context.push(`:`)
+ if (nextIndex < branches.length) {
+ genIfBranch(branches[nextIndex], branches, nextIndex + 1, context)
+ } else {
+ context.push(`null`)
+ }
+ } else {
+ // v-else
+ __DEV__ && assert(nextIndex === branches.length)
+ genChildren(children, context)
+ }
+}
+
+function genFor(node: ForNode, context: CodegenContext) {
+ const { push } = context
+ const { source, keyAlias, valueAlias, objectIndexAlias, children } = node
+ push(`${RENDER_LIST_HELPER}(`, node)
+ genExpression(source, context)
+ context.push(`(`)
+ if (valueAlias) {
+ // not using genExpression here because these aliases can only be code
+ // that is valid in the function argument position, so the parse rule can
+ // be off and they don't need identifier prefixing anyway.
+ push(valueAlias.content, valueAlias)
+ push(`, `)
+ }
+ if (keyAlias) {
+ if (!valueAlias) {
+ push(`_, `)
+ }
+ push(keyAlias.content, keyAlias)
+ push(`, `)
+ }
+ if (objectIndexAlias) {
+ if (!keyAlias) {
+ if (!valueAlias) {
+ push(`_, `)
+ }
+ push(`_, `)
+ }
+ push(objectIndexAlias.content, objectIndexAlias)
+ }
+ context.push(`) => `)
+ genChildren(children, context)
+ context.push(`)`)
+}
+
+// JavaScript
+function genCallExpression(
+ node: CallExpression,
+ context: CodegenContext,
+ multilines = node.arguments.length > 1
+) {
+ context.push(node.callee + `(`, node)
+ multilines && context.indent()
+ genNodeList(node.arguments, context, multilines)
+ multilines && context.deindent()
+ context.push(`)`)
+}
+
+function genObjectExpression(node: ObjectExpression, context: CodegenContext) {
+ const { push, indent, deindent, newline } = context
+ const { properties } = node
+ const multilines = properties.length > 1
+ push(`{`, node)
+ multilines && indent()
+ for (let i = 0; i < properties.length; i++) {
+ const { key, value } = properties[i]
+ // key
+ genExpressionAsPropertyKey(key, context)
+ push(`: `)
+ // value
+ genExpression(value, context)
+ if (i < properties.length - 1) {
+ if (multilines) {
+ push(`,`)
+ newline()
+ } else {
+ push(`, `)
+ }
+ }
+ }
+ multilines && deindent()
+ push(`}`)
+}
+
+function genArrayExpression(node: ArrayExpression, context: CodegenContext) {
+ genNodeListAsArray(node.elements, context)
+}