bpm-component

0.1.0-beta.0 verified Mon Apr 27 auth: no javascript

A Vue 2 UI components library integrating Ant Design Vue, umy-ui, and custom widgets such as BpmUpload and BpmKdFooterOperator. Current version is 0.1.0-beta.0, built with webpack and rollup. Designed for internal business process management (BPM) applications. Key differentiator: pre-bundles multiple UI frameworks and utility libraries (jsplumb, vue-codemirror, kd-parser) with heavy reliance on vue@2 and ant-design-vue@1.7.8. Breaking: requires Vue 2.x exclusively; not compatible with Vue 3. Low release cadence (beta pre-release).

Common errors

error Module not found: Error: Can't resolve 'ant-design-vue' in '...' ↓

cause Missing peer dependency ant-design-vue.

fix

npm install ant-design-vue@^1.7.8

error Cannot find module 'vue' ↓

cause Vue 2 not installed.

fix

npm install vue@^2.6.12

error Unknown custom element: <BpmUpload> - did you register the component correctly? ↓

cause Component not imported and registered locally or globally.

fix

import { BpmUpload } from 'bpm-component' and add to components option.

Warnings

gotcha Requires Vue 2.6.12+; not compatible with Vue 3. ↓

fix Use Vue 2 and ensure vue@^2.6.12 is installed.

deprecated This package is a pre-release (beta 0.1.0). APIs may change without notice. ↓

fix Pin exact version and test thoroughly.

gotcha Peer dependency ant-design-vue@^1.7.8 must be installed; version 2.x incompatible. ↓

fix Install ant-design-vue@1.7.8.

gotcha Peer dependency jsplumb@^2.15.6 required for flowchart components. ↓

fix Install jsplumb@2.15.6 (note: npm package name is 'jsplumb', not 'jsPlumb').

Install

npm install bpm-component

yarn add bpm-component

pnpm add bpm-component

Imports

BpmUpload

wrong

import BpmUpload from 'bpm-component'

correct

import { BpmUpload } from 'bpm-component'

Named export for each component.

BpmKdFooterOperator

wrong

import BpmKdFooterOperator from 'bpm-component'

correct

import { BpmKdFooterOperator } from 'bpm-component'

Named export from package root.

default

wrong

import { default } from 'bpm-component'

correct

import BpmComponent from 'bpm-component'

Default export is the entire library object, not a component.

Quickstart

Shows how to import and use a single component (BpmUpload) from the library in a Vue 2 project, including the required CSS import.

import Vue from 'vue';
import { BpmUpload } from 'bpm-component';
import 'bpm-component/dist/bpm-component.css';

export default {
  name: 'App',
  components: { BpmUpload },
  template: `<BpmUpload :action="uploadUrl" />`,
  data() {
    return {
      uploadUrl: process.env.VUE_APP_UPLOAD_URL ?? 'https://api.example.com/upload'
    };
  }
};