Registry / web-framework / rax-miniapp-babel-plugins

rax-miniapp-babel-plugins

library0.2.0jsnpmunverified

A collection of Babel plugins for optimizing Rax mini-program (MiniApp) applications, version 0.2.0. These plugins enable pre-compilation analysis to determine used lifecycle methods, built-in components, and native/npm components, reducing runtime overhead and eliminating dead code. Part of the Rax MiniApp ecosystem, maintained for Alibaba-affiliated mini-program platforms. Key differentiator: performance optimization via compile-time introspection, avoiding full lifecycle registration and component tree traversal common in alternative solutions. Last updated 2022-05-17, with maintenance focused on bug fixes (event handling, WeChat map component).

web-framework

npm install rax-miniapp-babel-plugins

github ↗package ↗

INSTALL

IMPORT

SIG · RAX-MINIAPP-BABEL-

rax-miniapp-babel-plugins

web-frameworkjavascriptv0.2.0

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default

✓ const plugin = require('rax-miniapp-babel-plugins')

CommonJS import; no ESM default export documented.

NativeLifeCycle

✓ const { NativeLifeCycle } = require('rax-miniapp-babel-plugins')

✗ import { NativeLifeCycle } from 'rax-miniapp-babel-plugins'

ESM import may not be supported; prefer CommonJS.

UsedBuiltInComponents

✓ const { UsedBuiltInComponents } = require('rax-miniapp-babel-plugins')

✗ const UsedBuiltInComponents = require('rax-miniapp-babel-plugins').UsedBuiltInComponents

Direct destructuring works; no default export.

Shows how to configure Babel with NativeLifeCycle and UsedBuiltInComponents plugins for Rax MiniApp optimization.

// babel.config.js module.exports = { plugins: [ [require('rax-miniapp-babel-plugins').NativeLifeCycle, {}], [require('rax-miniapp-babel-plugins').UsedBuiltInComponents, {}], ], };

Debug

Known issues

breakingRequires Babel 7+; not compatible with Babel 6.

fix

Upgrade to Babel 7 and use version 0.2.0 of this package.

affects: <0.1.0

deprecatedPlugin configuration may be replaced by higher-level Rax CLI tools; manual Babel setup discouraged.

fix

Consider using `rax-miniapp-runtime-webpack-plugin` instead for automated configuration.

affects: >=0.2.0

gotchaPlugins must be applied in order: first NativeLifeCycle, then UsedBuiltInComponents.

fix

Ensure the plugins array order in babel.config.js matches documentation.

affects: >=0.2.0

gotchaOnly supports Alibaba-affiliated mini-program platforms (WeChat, ByteDance, Baidu, Kuaishou, Alipay); not for generic web or Node.js.

fix

Verify your target platform is supported; if not, seek alternative optimization methods.

affects: >=0.2.0

breakingNativeLifeCycle plugin expects lifecycle names in camelCase; incorrect casing fails silently.

fix

Use standard Rax lifecycle names: `onShow`, `onHide`, `onLoad`, etc.

affects: >=0.2.0

Errors

Common errors & fixes

Error: Cannot find module 'rax-miniapp-babel-plugins'

Package not installed or incorrectly referenced in babel.config.js.

fix

Run `npm install rax-miniapp-babel-plugins --save-dev` and ensure path is correct.

Plugin/Preset files are not allowed to export objects, only functions.

Using a default export different from CommonJS require; Babel expects a function.

fix

Use `require('rax-miniapp-babel-plugins').NativeLifeCycle` instead of `require('rax-miniapp-babel-plugins')` directly.

TypeError: Cannot read property 'NativeLifeCycle' of undefined

Package exports incorrect structure; possibly due to version mismatch.

fix

Ensure version >=0.2.0; if not, update package. Check package.json "main" field.

Upgrade

Version history

0.2.0latest on npm

Audit

Dependencies

babeloptionalPeer dependency for Babel plugin functionality

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/raxjs/miniapp ↗

packagehttps://www.npmjs.com/package/rax-miniapp-babel-plugins ↗