Installation

Das Widget wird als framework-agnostisches Custom Element ausgeliefert, plus ein schlanker React-Wrapper.

Paket	Was es ist
@capitality-io/mildport-widget	Das <mildport-import>-Custom-Element (funktioniert überall).
@capitality-io/mildport-react	React-Bindings über demselben Element.
@capitality-io/mildport-contract	Der öffentliche Zod-Vertrag (Typen + Payload-Formen).
@capitality-io/mildport-matcher	Der deterministische Header-→-Feld-Matcher.

Registry-Zugriff

Pakete werden in GitHub Packages unter dem eingeschränkten Scope @capitality-io veröffentlicht, Sie benötigen also ein Token mit read:packages und eine .npmrc, die den Scope routet:

.npmrc

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

Nicht in der öffentlichen npm-Registry

Ein einfaches npm install @capitality-io/mildport-widget gegen die öffentliche Registry schlägt fehl. Zugriff kommt mit jedem Tarif, auch Free/Dev ($0 — Preise): Schreiben Sie an [email protected] mit dem GitHub-Benutzernamen, der Zugriff bekommen soll — wir schalten ihn innerhalb eines Werktags frei, und Sie installieren mit Ihrem eigenen GitHub-Token (classic, read:packages) wie oben gezeigt.

Installieren

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

Nicht-Angular-Hosts: ein Build-Tool-Schritt

Unter der Haube ist das Widget eine Angular-Bibliothek — sie liefert teilkompilierten Code aus, den der konsumierende Build linkt. Angular-CLI- und Analog-Projekte tun das von Haus aus. In jedem anderen Vite-Projekt fügen Sie den Linker einmal hinzu:

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

Das Plugin liest standardmäßig tsconfig.app.json (setzen Sie die tsconfig-Option, falls Ihre Datei anders heißt). Ohne den Linker schlägt der Build oder das erste Rendern mit JIT compilation failed-Fehlern fehl.

Registrieren Sie dann das Element einmal und betten Sie es ein — Host wählen unter Frameworks, dann Konfiguration.