# Instalación

# Requisitos del entorno

  • Vue 2.7 (la versión definitiva; no admite 2.6 ni inferior, ni IE11)
  • Se recomienda Node 20 + pnpm 10

# Instalación con un gestor de paquetes

npm install @lh-ui/vue2
# o
pnpm add @lh-ui/vue2
# o
yarn add @lh-ui/vue2

La única dependencia en tiempo de ejecución de @lh-ui/vue2 es @lh-ui/share (capa compartida: funciones puras del core, theme, constants, locales, types y el origen de los estilos de los componentes), que se instala automáticamente.

# Instalación desde un servidor privado

Si el paquete está alojado en un servidor privado en lugar de un registry público, usa cualquiera de los métodos siguientes.

# Método 1: enlace directo al tarball

Basta con que el servidor ofrezca alojamiento de archivos estáticos. Coloca el lh-ui-vue2-x.y.z.tgz generado por npm pack en un directorio del servidor y, a continuación:

npm install https://tu-dominio.com/pkg/lh-ui-vue2-1.0.0.tgz
# o
pnpm add https://tu-dominio.com/pkg/lh-ui-vue2-1.0.0.tgz
# o
yarn add https://tu-dominio.com/pkg/lh-ui-vue2-1.0.0.tgz

Con el enlace directo al tarball, @lh-ui/share se sigue resolviendo desde el registry actual, por lo que el paquete debe ser visible en el registry público o en tu registry privado.

# Método 2: registry propio (p. ej., Verdaccio)

Un registry propio permite la obtención de versiones mediante semver y su gestión. Enruta con precisión por scope en el .npmrc de la raíz del proyecto (sin afectar al origen de instalación de los demás paquetes):

@lh-ui:registry=https://tu-dominio.com/

A continuación, instala como de costumbre:

pnpm add @lh-ui/vue2

# Importación manual de estilos

// Variables del tema (claro + oscuro)
import '@lh-ui/vue2/theme.css'
// Importación de los estilos de un componente concreto bajo demanda (opcional: la entrada completa ya los incluye)
import '@lh-ui/vue2/style/button'

# Política de versiones

  • La actualización de @lh-ui/share debe seguir la disciplina de «primero se publica share → la biblioteca de UI se actualiza y se hace la regresión → después se publica».
  • Estado actual: @lh-ui/vue2 está publicado en 1.0.0 y @lh-ui/share en 0.1.0.

Copyright © 2024-2026 FengMo WenXue