Installation

Le widget est livré comme un custom element indépendant du framework, plus un fin wrapper React.

Paquet	Ce que c’est
`@capitality-io/mildport-widget`	Le custom element `<mildport-import>` (fonctionne partout).
`@capitality-io/mildport-react`	Les bindings React sur le même élément.
`@capitality-io/mildport-contract`	Le contrat Zod public (types + formes de payload).
`@capitality-io/mildport-matcher`	Le matcher déterministe en-tête → champ.

Accès au registre

Les paquets sont publiés sur GitHub Packages sous le scope restreint @capitality-io ; il vous faut donc un token avec read:packages et un .npmrc qui route le scope :

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

Installer

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

Sous le capot, le widget est une bibliothèque Angular — elle livre du code partiellement compilé que le build consommateur lie. Les projets Angular CLI et Analog le font d’office. Dans tout autre projet Vite, ajoutez le linker une fois :

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()] });

Le plugin lit tsconfig.app.json par défaut (réglez son option tsconfig si votre fichier porte un autre nom). Sans le linker, le build ou le premier rendu échoue avec des erreurs JIT compilation failed.

Enregistrez ensuite l’élément une fois et intégrez-le — choisissez l’hôte sur Frameworks, puis Configuration.