Instalacion
Los paquetes pptx-viewer se publican independientemente en npm. Instale solo lo que necesite: el motor principal independiente del framework o uno de los paquetes de visualizacion.
Version de Node
Se requiere Node.js 18 o superior para la compilacion TypeScript y para ejecutar los paquetes fuera del navegador.
Elegir su framework
| Framework | Paquete | Notas |
|---|---|---|
| React | pptx-react-viewer | Completo: visualizador, editor, presentador, exportacion, collab |
| Vue 3 | pptx-vue-viewer | Mismo motor y conjunto de funciones |
| Angular | pptx-angular-viewer | Mismo motor y conjunto de funciones |
| Headless (Node / navegador) | pptx-viewer-core | Sin interfaz, sin dependencia de framework |
| Herramientas IA / MCP | pptx-viewer-mcp | 25 herramientas MCP + CLI + codec Y.Doc |
Instalacion desde npm
Visualizador React
El componente visualizador/editor React completo, publicado como pptx-react-viewer. El motor principal esta incluido, no necesita instalarlo por separado.
npm install pptx-react-viewer react react-dompnpm add pptx-react-viewer react react-domyarn add pptx-react-viewer react react-dombun add pptx-react-viewer react react-domOtras dependencias
El visualizador tambien requiere framer-motion, lucide-react, react-icons, jspdf, jszip, fast-xml-parser e i18next/react-i18next - instale los que necesite.
Visualizador Vue 3
El componente Vue 3, publicado como pptx-vue-viewer. El motor principal esta incluido.
npm install pptx-vue-viewer vuepnpm add pptx-vue-viewer vueyarn add pptx-vue-viewer vuebun add pptx-vue-viewer vueVisualizador Angular
El componente Angular, publicado como pptx-angular-viewer. El motor principal esta incluido.
npm install pptx-angular-viewer @angular/core @angular/commonpnpm add pptx-angular-viewer @angular/core @angular/commonyarn add pptx-angular-viewer @angular/core @angular/commonbun add pptx-angular-viewer @angular/core @angular/commonMotor principal
El motor independiente del framework para analizar, editar, serializar y convertir archivos PPTX.
npm install pptx-viewer-corepnpm add pptx-viewer-coreyarn add pptx-viewer-corebun add pptx-viewer-coreServidor MCP y herramientas
25 funciones de herramientas de manipulacion PPTX, un servidor MCP para agentes IA y el codec de colaboracion Y.Doc.
npm install pptx-viewer-mcppnpm add pptx-viewer-mcpyarn add pptx-viewer-mcpbun add pptx-viewer-mcpDependencias opcionales
Algunas funciones del paquete React solo se activan cuando sus dependencias opcionales estan presentes.
| Funcion | Dependencias opcionales | Notas |
|---|---|---|
| Modelos 3D (GLB/GLTF) | three | Sin ellas, los elementos 3D muestran su imagen. |
| Colaboracion en tiempo real | yjs, y-websocket | Yjs CRDT con seguimiento de presencia. |
Desarrollo local (clonacion del monorepo)
El monorepo usa Bun como gestor de paquetes. Los paquetes se referencian mutuamente mediante el protocolo workspace:*.
# Clonar el repositorio
git clone https://github.com/ChristopherVR/pptx-viewer
cd pptx-viewer
# Instalar todas las dependencias
bun install
# Construir todos los paquetes
bun run build
# Pruebas y verificacion de tipos
bun run test
bun run typecheckEl orden de construccion importa
Los paquetes deben construirse en el orden de dependencias:
core -> shared -> react / vue / angularbun run build desde la raiz del repositorio gestiona esto automaticamente.
Comandos comunes
bun run build # Construir todos los paquetes en orden
bun run test # Ejecutar vitest en todos los paquetes
bun run typecheck # Verificar tipos de todos los paquetes
bun run fmt # Formatear con oxfmt
bun run lint # Linting con oxlint
bun run demo # Iniciar servidor de demo React (puerto 4173)
bun run demo:vue # Iniciar servidor de demo Vue (puerto 4175)
bun run demo:angular # Iniciar servidor de demo Angular (puerto 4174)Proximos pasos
- Inicio rapido - crear, analizar, convertir y renderizar presentaciones.
- Arquitectura - como encajan las capas.
- Limitaciones - advertencias importantes antes de ir a produccion.