@psychomantic/ui-react

Composants React exportables de Psychomantic — roue astrologique, Matrice du Destin et visualiseur de payloads, alimentés par les calculs IshtarEngine (kernel quantifié maison DE442Q, dérivé de l'éphéméride NASA JPL DE442, millésime 2024 ; précision mesurée 0,052″ en moyenne / 0,095″ au maximum contre JPL Horizons, 63 points).

Principes : stateless (aucun fetch, aucune clé API dans le widget), zéro calcul côté client, design Pastelo scopé (aucune pollution du CSS hôte), light/dark/auto, i18n fr/en, accessible (ARIA, clavier, prefers-reduced-motion).

Installation

Le package n'est pas encore publié sur npm : npm view @psychomantic/ui-react version rend 404 au 2026-10-22. Il est distribué aujourd'hui avec le portail B2B, via une copie vendorisée synchronisée depuis ce dépôt (psychomantic-platform/vendor/ui-react, script scripts/sync-ui.sh, empreinte vérifiée par test).

Le scope @psychomantic est réservé par l'organisation npm créée le 2026-10-22, et le contrat ChartResponse est aligné sur l'app (extraPoints, commit 3deea0e). La publication du package reste une décision explicite : npm publish --access public depuis ce dossier, après validation du build. Pour un accès anticipé : [email protected].

Peer deps prévues une fois publié : react, react-dom, et recharts + lucide-react pour la Matrice.

Démarrage rapide

Exemple d'API cible, valable une fois le package publié sur npm. Aujourd'hui, les composants s'utilisent depuis la copie vendorisée du portail B2B.

import { PsychomanticNatalChart } from '@psychomantic/ui-react';
import '@psychomantic/ui-react/styles.css';

// 1. Récupérez la donnée via l'API IshtarEngine (POST /v1/astro/natal)
const chart = await fetch('https://api.psychomantic.com/v1/astro/natal', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'X-API-Key': 'ish_live_...' },
  body: JSON.stringify({ date: '1990-06-15', time: '14:30', latitude: 48.8566, longitude: 2.3522, timezone: 'Europe/Paris' }),
}).then(r => r.json()).then(j => j.data);

// 2. Passez-la au composant — c'est tout.
export default function App() {
  return <PsychomanticNatalChart data={chart} theme="light" />;
}

Les 3 widgets

<PsychomanticNatalChart /> — roue astrologique SVG

// Mode simple
<PsychomanticNatalChart data={chart} size={640} theme="auto" />

// Mode bi-roue (synastrie ou transits)
<PsychomanticNatalChart
  innerData={natalChart}
  outerData={transitChart}
  biWheelMode="transit"
  outerLabel="Transits"
  innerLabel="Natal"
  onPlanetHover={(key) => console.log(key)}
/>

Props principales : data, innerData/outerData, biWheelMode, showHouses, showAspects, visiblePlanets, visibleAngles, crossAspects, onPlanetHover, size (px), theme, lang, className.

<PsychomanticMatrixGrid /> — Matrice du Destin (exclusivité)

Aucun équivalent chez les API concurrentes : octogramme des 22 arcanes, clés Cœur/Portefeuille, queue karmique, 7 chakras, énergies annuelles.

// Donnée : POST /v1/matrix { birthDate }
<PsychomanticMatrixGrid
  data={matrixResponse}
  sections={['octogram', 'keys', 'chakras', 'yearly']}
  theme="auto"
  lang="fr"
/>

<PayloadViewer /> — inspecteur double vue

Debug d'intégration : JSON brut vs résumé visuel, pour tout payload IshtarEngine.

<PayloadViewer
  payload={apiResponse}
  view="json"                       // 'visual' | 'json'
  jsonOptions={{ collapsedDepth: 2, searchable: true, copyButton: true }}
/>

Thème light / dark

Trois mécanismes cumulables :

1. Prop theme="light" | "dark" | "auto" (défaut auto)
2. Héritage : data-theme="dark" ou classe .dark sur un ancêtre
3. prefers-color-scheme en l'absence d'indication

Les tokens CSS sont scopés sous .pm-widget : rien ne fuit dans le :root de votre application.

Sans build (essai en 10 secondes)

Ouvrez demo/index.html via n'importe quel serveur statique :

cd demo && python3 -m http.server 8791
# → http://localhost:8791

La démo utilise de vrais payloads IshtarEngine (thème natal + matrice du destin calculés par le kernel DE442Q).

API IshtarEngine

• REST : https://api.psychomantic.com/v1/* (clé ish_live_... via le dashboard)
• Remote MCP (agents IA) : https://api.psychomantic.com/mcp — tools/list public, compact: true pour -53 % de tokens
• Précision certifiée : docs/PRECISION_CERTIFICATION.md (0,110″ moyenne / 0,802″ max vs JPL Horizons)

Licence

MIT © Kossmonot