Installation & statut beta

Deux statuts distincts : npm et candidate locale

@newvexa/flowora@0.1.0-beta.1 est public sur npm sous licence MIT. La page npm de cette version est disponible. Le tag next pointe vers 0.1.0-beta.1. Cette beta ne promet ni API stable, ni aptitude automatique à la production.

La candidate @newvexa/flowora@0.1.0-beta.2 a été reçue et vérifiée pour l’intégration locale du site. Elle est locale, non publiée sur npm : le package embarqué par les outils du site n’est plus le tarball registry beta.1. Sa réception et son intégration ne changent ni la version publique ni les tags npm.

Installer depuis npm

Choisissez l’une de ces commandes dans votre projet consommateur. @next suit le canal de prereleases ; la version exacte et votre lockfile fixent la beta utilisée. Les imports applicatifs utilisent ensuite le nom normal du package.

# Suivre le canal de prereleases :
npm install @newvexa/flowora@next

# Ou épingler exactement cette beta pour un build reproductible :
npm install @newvexa/flowora@0.1.0-beta.1

Pour reproduire la version publique actuelle, préférez @0.1.0-beta.1 avec votre lockfile ; @next peut évoluer lors d’une future publication. Un tarball beta.1 local reste utilisable si vous possédez ce fichier. Aucune de ces installations beta.1 ne fournit les nouveaux noms de connexions de beta.2.

Utiliser la candidate beta.2 reçue localement

Si vous avez reçu le tarball vérifié, installez son fichier local dans votre application hôte. Le chemin ci-dessous est une convention à adapter, pas un téléchargement ni une commande d’installation depuis le registry. Le site conserve ce vendor exact pour son intégration locale.

# Seulement si vous possédez la candidate locale vérifiée :
# adaptez ce chemin à l'emplacement réel du fichier reçu.
npm install ./vendor/newvexa-flowora-0.1.0-beta.2.tgz

Les imports restent @newvexa/flowora et ses entrées optionnelles. Le guide Afficher & gérer les liens décrit les panneaux, EditorConnection.name et updateConnection() de cette candidate ; ces nouveautés ne sont pas disponibles dans npm beta.1. Le schéma JSON reste à 1, mais beta.1 refuse les documents dont une connexion contient name.

Choisir une entrée, pas tout installer

@newvexa/flowora est portable en ESM et CommonJS. Il fournit Editor, les types, le catalogue, le document fictif et la géométrie, sans Angular, Rete, Workify ni API Node. Il fonctionne pour l’édition et la validation de modèles dans un navigateur ou un environnement serveur.

@newvexa/flowora/angular fournit le renderer Angular ESM/partial-Ivy. @newvexa/flowora/layout fournit le placement ELK. Les peers @angular/core ^22.2.4, @angular/common ^22.2.4 et elkjs ^0.12.1 sont tous optionnels dans le manifeste ; ils deviennent nécessaires lorsque vous utilisez leur entrée respective.

# Uniquement si vous utilisez le renderer Angular
# dans une application Angular 22 compatible :
npm install @angular/core@22.2.4 @angular/common@22.2.4

# Uniquement si vous utilisez @newvexa/flowora/layout :
npm install elkjs@0.12.1

Installer seulement les deux peers ne crée pas une application Angular ni sa chaîne de build. Alignez aussi le compilateur, la plateforme et les outils de votre application Angular. La compatibilité vérifiée du package concerne Angular 22.2.4 et TypeScript 6.0.2, pas toutes les versions futures autorisées par une plage semver.

Angular : AOT et linker obligatoires

L’entrée Angular contient des déclarations partial-Ivy : un import direct du bundle partiel dans le navigateur n’est pas une intégration valide. Angular CLI fournit le pipeline de compilation et de linker. Un consommateur personnalisé doit reproduire ce contrat : compilation AOT via ngc, passage du linker Angular sur les bibliothèques partielles avec Babel 8, puis bundling avec esbuild. Le consommateur de ce projet suit ce pipeline équivalent ; esbuild seul ne remplace ni ngc ni le linker.

La candidate a été consommée séparément en AOT avec linker. Cela ne signifie pas que ces pages exécutent les snippets, que votre propre build a été validé ou que le site est publié. Consultez ensuite le composant standalone, son service DI et les templates.

Premier programme sans renderer

Cet exemple complet utilise uniquement la racine portable. Il édite un document fictif, sérialise des données et libère l’instance ; il n’envoie rien et n’exécute aucun nœud.

import { Editor, createDemoDocument } from '@newvexa/flowora';

const editor = new Editor(createDemoDocument());
try {
  const id = editor.addFromCatalog('response', { x: 1200, y: 280 });
  editor.updateNode(id, { name: 'Mon brouillon fictif' });
  console.log(editor.toJSON());
} finally {
  editor.dispose();
}

Hauteur et propriété de l’instance

Créez une instance stable d’Editor par document édité. Ne la recréez pas à chaque rendu. Le conteneur Angular a une hauteur explicite ; le propriétaire du store appelle dispose() lorsqu’il n’est plus utilisé. Chaque subscribe() ou onEvent() renvoie également sa fonction de désabonnement.

MIT et dépendances tierces

Le nouveau code Flowora est sous MIT. L’archive inclut LICENSE et THIRD-PARTY-NOTICES.md ; Angular, ELK et les autres composants tiers conservent leurs propres obligations. La licence Flowora ne modifie ni Workify ni Workify Pro.