Instalación

El widget se entrega como un custom element independiente del framework, más un wrapper de React ligero.

Paquete	Qué es
`@capitality-io/mildport-widget`	El custom element `<mildport-import>` (funciona en cualquier sitio).
`@capitality-io/mildport-react`	Los bindings de React sobre el mismo elemento.
`@capitality-io/mildport-contract`	El contrato Zod público (tipos + formas de payload).
`@capitality-io/mildport-matcher`	El matcher determinista de encabezado → campo.

Acceso al registro

Los paquetes se publican en GitHub Packages bajo el scope restringido @capitality-io, así que necesitas un token con read:packages y un .npmrc que enrute el scope:

@capitality-io:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=${MILDPORT_NPM_TOKEN}

Instalar

npm install @capitality-io/mildport-widget
# React wrapper, optional:
npm install @capitality-io/mildport-react

Por dentro, el widget es una librería Angular: distribuye código parcialmente compilado que el build consumidor enlaza. Los proyectos Angular CLI y Analog lo hacen de serie. En cualquier otro proyecto Vite, añade el linker una vez:

npm install -D @analogjs/vite-plugin-angular @angular/compiler-cli @angular/compiler @angular/build "typescript@~5.9.0"

import angular from '@analogjs/vite-plugin-angular';
import { defineConfig } from 'vite';

export default defineConfig({ plugins: [angular()] });

El plugin lee tsconfig.app.json por defecto (ajusta su opción tsconfig si tu archivo se llama distinto). Sin el linker, el build o el primer render falla con errores JIT compilation failed.

Luego registra el elemento una vez e intégralo — elige el host en Frameworks, luego Configuración.