Installazione

Il widget viene distribuito come un custom element indipendente dal framework, più un sottile wrapper React.

Pacchetto	Cos’è
@capitality-io/mildport-widget	Il custom element <mildport-import> (funziona ovunque).
@capitality-io/mildport-react	I binding React sullo stesso elemento.
@capitality-io/mildport-contract	Il contratto Zod pubblico (tipi + forme del payload).
@capitality-io/mildport-matcher	Il matcher deterministico intestazione → campo.

Accesso al registro

I pacchetti vengono pubblicati su GitHub Packages sotto lo scope ristretto @capitality-io, quindi ti serve un token con read:packages e un .npmrc che instradi lo scope:

.npmrc

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

Non nel registro npm pubblico

Un semplice npm install @capitality-io/mildport-widget contro il registro pubblico fallirà. L’accesso arriva con ogni piano, incluso Free/Dev: scrivete a [email protected] con lo username GitHub da autorizzare — l’accesso viene concesso entro un giorno lavorativo, e l’installazione usa il vostro token GitHub (classic, read:packages) come mostrato sopra.

Installa

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

Host non Angular: un passo di build

Sotto il cofano il widget è una libreria Angular: distribuisce codice parzialmente compilato che il build consumatore collega. I progetti Angular CLI e Analog lo fanno di serie. In qualsiasi altro progetto Vite, aggiungi il linker una volta:

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

vite.config.ts

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

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

Il plugin legge tsconfig.app.json di default (imposta l’opzione tsconfig se il tuo file ha un altro nome). Senza il linker, il build o il primo render fallisce con errori JIT compilation failed.

Poi registra l’elemento una volta e integralo — scegli l’host su Frameworks, poi Configurazione.