Registry / web-framework / mcl-ui-framework

mcl-ui-framework

library1.0.12jsnpmunverified

A Vue 3 + TypeScript UI component library built on Element Plus, tailored for Chinese enterprise middle-backend systems. Current stable version is 1.0.12, released as an alpha-quality package with sparse documentation and no changelog. It offers layout components (header, sidebar, content), theme toggling (multiple colors, dark mode with localStorage persistence), and routing integration via meta properties. Compared to alternatives like Ant Design Vue or Naive UI, it provides a simpler API but lacks community adoption and maturity.

web-framework

npm install mcl-ui-framework

package ↗

INSTALL

IMPORT

SIG · MCL-UI-FRAMEWORK

mcl-ui-framework

web-frameworkjavascriptv1.0.12

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–223 runs

build_error

glibc

node 18–223 runs

build_error

Code

Verified usage

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

MclUI

✓ import MclUI from 'mcl-ui-framework'

✗ const MclUI = require('mcl-ui-framework')

Default import for plugin; CJS require may not work due to ESM-first packaging.

mcl-layout

✓ import 'mcl-ui-framework' // then use <mcl-layout> globally

✗ import { MclLayout } from 'mcl-ui-framework'

Component is registered globally via plugin; named exports are not documented.

theme CSS

✓ import 'mcl-ui-framework/dist/mcl-ui-framework.css'

✗ import 'mcl-ui-framework/styles/index.css'

CSS file path is dist/mcl-ui-framework.css; other paths may not exist.

Full setup: install plugin, import CSS, and use layout component with Vue Router.

import { createApp } from 'vue'; import App from './App.vue'; import router from './router'; import MclUI from 'mcl-ui-framework'; import 'mcl-ui-framework/dist/mcl-ui-framework.css'; const app = createApp(App); app.use(router); app.use(MclUI); app.mount('#app'); // Vue component template: // <template> // <mcl-layout :routes="router.options.routes" :use-external-routes="true" :router="router"> // <router-view /> // </mcl-layout> // </template>

Debug

Known issues

deprecatedPackage is in early alpha (1.0.x) with no stable release; API may change.

fix

Pin exact version and monitor repository for breaking changes.

affects: >=1.0.0

gotchaElement Plus is a required peer dependency; not installing it will cause runtime errors.

fix

Run npm install element-plus@latest

affects: >=1.0.0

gotchaUsing named imports like { MclLayout } may not work; components are globally registered via plugin.

fix

Use app.use(MclUI) and rely on global registration.

affects: >=1.0.0

breakingThe CSS file path changed from 'dist/mcl-ui-framework.css' to something else in undocumented versions.

fix

Always import from 'mcl-ui-framework/dist/mcl-ui-framework.css' or check latest docs.

affects: <1.0.10

Errors

Common errors & fixes

Uncaught TypeError: Cannot read properties of undefined (reading 'install')

MclUI plugin not properly imported or vue not installed.

fix

Ensure Vue 3 is installed and import MclUI from 'mcl-ui-framework'.

[Vue warn]: Failed to resolve component: mcl-layout

Plugin not registered via app.use(MclUI) or component name misspelled.

fix

Call app.use(MclUI) after creating app and before mounting.

Module not found: Error: Can't resolve 'element-plus'

Element Plus not installed or not listed in dependencies.

fix

npm install element-plus@latest

Upgrade

Version history

1.0.12latest on npm

Audit

Dependencies

vuerequiredPeer dependency for Vue 3 reactivity and component system.

element-plusrequiredBundles Element Plus components; required at runtime for internal UI.

Agent activity

2 hits · last 30 days

node

Resources

packagehttps://www.npmjs.com/package/mcl-ui-framework ↗