DSL support

MorJS does not define its own template language. You write mini-programs using the native DSL of either WeChat or Alipay, and MorJS converts that DSL to the syntax required by the output target.

Source types

The sourceType configuration field tells MorJS which DSL your source files use:

Value	DSL	Template extension	Global object
`wechat`	WeChat mini-program DSL	`.wxml`	`wx`
`alipay`	Alipay mini-program DSL	`.axml`	`my`

These are the only two valid values for sourceType. All other targets are compilation outputs, not source types.

Automatic detection

By default you do not need to set sourceType. MorJS inspects the file extensions in your source directory:

If it finds .wxml files, it treats the source as WeChat DSL (wechat).
If it finds .axml files, it treats the source as Alipay DSL (alipay).

The default value in the schema is wechat:

// From packages/plugin-compiler/src/constants.ts
sourceType: z.nativeEnum(SourceTypes).default(SourceTypes.wechat)

When to set sourceType explicitly

Set sourceType manually when:

Both .wxml and .axml files exist in the same directory (MorJS cannot infer unambiguously).
You want to make the source type explicit in CI or configuration-as-code.

export default defineConfig([
  {
    target: 'alipay',
    sourceType: 'wechat',  // WeChat source compiled to Alipay
  }
])

You can also pass it on the command line:

mor compile --target alipay --source-type wechat

DSL differences

WeChat DSL
Alipay DSL

WeChat-flavored mini-program source uses wx-prefixed attributes and the wx global object:

<!-- pages/index/index.wxml -->
<view wx:if="{{show}}">
  <text>Hello World</text>
</view>
<block wx:for="{{list}}" wx:key="id">
  <view>{{item.name}}</view>
</block>

// pages/index/index.js
Page({
  data: { show: true, list: [] },
  onLoad() {
    wx.showToast({ title: 'Loaded' })
  }
})

Alipay-flavored mini-program source uses a-prefixed attributes and the my global object:

<!-- pages/index/index.axml -->
<view a:if="{{show}}">
  <text>Hello World</text>
</view>
<block a:for="{{list}}" a:key="id">
  <view>{{item.name}}</view>
</block>

// pages/index/index.js
Page({
  data: { show: true, list: [] },
  onLoad() {
    my.showToast({ content: 'Loaded' })
  }
})

MorJS rewrites template directives at compile time. When compiling WeChat source to Alipay, wx:if becomes a:if, wx:for becomes a:for, and so on.

Inline script: wxs and sjs

Both DSLs support small inline or imported script modules:

Feature	WeChat	Alipay
Tag name	`<wxs>`	`<import-sjs>`
Source attribute	`src`	`from`
Module attribute	`module`	`name`
Inline content	Supported	Not supported
File extension	`.wxs`	`.sjs`

Supported file types

Beyond the native mini-program file types, MorJS adds support for the following extensions:

Scripts

Extension	Description
`.js`	Standard JavaScript (all targets)
`.ts`	TypeScript
`.mjs`	ES module JavaScript
`.mts`	ES module TypeScript

Styles

Extension	Description
`.wxss`	WeChat stylesheet
`.acss`	Alipay stylesheet
`.css`	Standard CSS (Baidu and others)
`.less`	Less preprocessor
`.scss` / `.sass`	Sass preprocessor

Config files

Extension	Description
`.json`	Standard JSON
`.jsonc`	JSON with comments
`.json5`	JSON5 (relaxed JSON syntax)

Templates

Extension	Description
`.wxml`	WeChat template
`.axml`	Alipay template
`.swan`	Baidu template
`.ttml`	ByteDance template
`.qml`	QQ template

Using TypeScript (.ts) is recommended. MorJS has first-class TypeScript support with configurable compilerOptions.module and compilerOptions.target per platform.

Introduction

Core Concepts

Guides

Advanced

Migration

Community

Source types

Automatic detection

When to set sourceType explicitly

DSL differences

Inline script: wxs and sjs

Supported file types

Build docs developers (and LLMs) love

Introduction

Core Concepts

Guides

Advanced

Migration

Community

​Source types

​Automatic detection

​When to set sourceType explicitly

​DSL differences

​Inline script: wxs and sjs

​Supported file types

Build docs developers (and LLMs) love

Source types

Automatic detection

When to set sourceType explicitly

DSL differences

Inline script: wxs and sjs

Supported file types