@es-plus/core

@es-plus/core

Framework-agnostic core for the es-plus ecosystem — shared types, configuration, layout algorithms, request helpers, and pure logic powering both the Vue 3 (@es-plus/vue3) and Vue 2 (@es-plus/vue2) renderers.

Overview

@es-plus/core contains zero Vue / Element / framework dependencies. It is the single source of truth for the schema-driven CRUD configuration shared by every renderer in the family:

A columns / formItemList JSON config that validates against the core schemas works identically in every renderer.

Install

npm install @es-plus/core
# or
pnpm add @es-plus/core

You normally don't install this directly — it ships as a dependency of the renderer packages.

What's inside

Quick example

import { configureEsPlus } from '@es-plus/core/config'
import { getRowColsAlgorithm } from '@es-plus/core/form-layout'
import { findValueByKey } from '@es-plus/core/shared'

configureEsPlus({
  httpRequest: async ({ url, method, data }) => {
    return fetch(url, { method, body: JSON.stringify(data) }).then(r => r.json())
  },
  configTableOut: (res) => ({ list: res.data.records, total: res.data.total }),
  permission: (code) => userPermissions.includes(code),
})

const layout = getRowColsAlgorithm({
  width: 1200,
  span: { xs: 24, sm: 12, md: 8, lg: 6, xl: 4 },
})

const status = findValueByKey(record, 'profile.status')

Versioning & compatibility

• Follows SemVer. Breaking changes bump the major version.
• Renderer packages declare a caret range on @es-plus/core (e.g. ^1.0.0). Upgrading a renderer pulls compatible core upgrades automatically.
• Pre-release renderers may pin tighter ranges; check each renderer's peerDependencies / dependencies.

Repository

Monorepo: github.com/liujiaao/es-plus

packages/
├── core/        ← this package
├── es-plus/     ← @es-plus/vue3 (formerly es-plus-ui)
├── vue2/        ← @es-plus/vue2
├── mcp-server/  ← @es-plus/mcp-server
└── cli/         ← @es-plus/cli

License

MIT © liujiaao