refactor(studio): l'interface passe dans studio/ui, studio/ devient l'ensemble host + ui
Studio regroupe l'exécutable hôte (C++, à venir dans studio/host) et l'interface web (TypeScript, studio/ui). Chemins mis à jour dans les scripts, .gitignore et la documentation ; paquet renommé @sequa/studio-ui.
This commit is contained in:
Ange-Marie MAURIN - A2M Systèmes committed
1 parent
15c0b0abd0
commit
e231e643cd
29 files changed
+162
-139
No files matched your search
+1
-1
@@ -7,7 +7,7 @@ vcpkg_installed/
|
||||
|
||||
# Node / Studio
|
||||
node_modules/
|
||||
studio/dist/
|
||||
studio/ui/dist/
|
||||
|
||||
# IDE / OS
|
||||
.vs/
|
||||
|
||||
@@ -12,7 +12,7 @@ Documentation de référence : [docs/SEQUA_Engine_resume_complet_v2.md](docs/SEQ
|
||||
|
||||
| Dossier | Rôle | Langage |
|
||||
|---|---|---|
|
||||
| [studio/](studio) | SEQUA Studio : application web de création | TypeScript |
|
||||
| [studio/](studio) | SEQUA Studio : `host/` (exécutable qui gère le Core et sert l'interface) + `ui/` (interface web) | C++20, TypeScript |
|
||||
| [core/](core) | SEQUA Core : projet, simulation déterministe, rejeu, intentions, orchestrateur, confiance | C++20 |
|
||||
| [3d/](3d) | SEQUA 3D : interface vers les moteurs 3D (adaptateurs, capacités, synchronisation) | C++20 |
|
||||
| [schema/](schema) | Contrat de données et protocole Studio↔Core | Protobuf / FlatBuffers |
|
||||
|
||||
+1
-1
@@ -38,7 +38,7 @@ Le test « empreinte de référence multiplateforme » fige l'empreinte d'une se
|
||||
|
||||
Bibliothèque `sequa::core_server` (`include/sequa/core/server/`) et exécutable `sequa-core` ([ADR 0005](../docs/adr/0005-serveur-websocket-du-core.md)) :
|
||||
|
||||
- `ProtocolSession` : poignée de main `hello` -> `welcome` ou `error` + fermeture, en JSON **provisoire** identique à `studio/src/protocol/messages.ts` (même règle de compatibilité de version). Pure, testée sans réseau.
|
||||
- `ProtocolSession` : poignée de main `hello` -> `welcome` ou `error` + fermeture, en JSON **provisoire** identique à `studio/ui/src/protocol/messages.ts` (même règle de compatibilité de version). Pure, testée sans réseau.
|
||||
- `CoreServer` : transport IXWebSocket, une session par connexion, écoute locale (`127.0.0.1:9100`) par défaut, refus explicite si le port est déjà pris.
|
||||
- Pas encore de messages métier : après la poignée de main, tout message reçoit `not-implemented`.
|
||||
|
||||
|
||||
@@ -10,7 +10,7 @@ namespace sequa::core::server {
|
||||
|
||||
// Protocole Studio - Core, messages JSON PROVISOIRES.
|
||||
//
|
||||
// Miroir de studio/src/protocol/messages.ts : enveloppe { v, type, payload }, poignée de
|
||||
// Miroir de studio/ui/src/protocol/messages.ts : enveloppe { v, type, payload }, poignée de
|
||||
// main hello -> welcome | error. Le format définitif (Protobuf ou FlatBuffers) sera fixé
|
||||
// par une ADR et généré depuis schema/ ; rien en dehors de ce module ne doit dépendre de
|
||||
// la forme JSON.
|
||||
|
||||
+1
-1
@@ -41,7 +41,7 @@ foreach ($preset in "windows-msvc-debug", "windows-msvc-release", "windows-msvc-
|
||||
& (Join-Path $PSScriptRoot "build.ps1") -Preset $preset
|
||||
}
|
||||
|
||||
$studio = Join-Path $root "studio"
|
||||
$studio = Join-Path $root "studio\ui"
|
||||
if (-not $SkipStudio -and (Test-Path (Join-Path $studio "package.json"))) {
|
||||
Push-Location $studio
|
||||
try {
|
||||
|
||||
+1
-1
@@ -63,7 +63,7 @@ if ($Help) {
|
||||
}
|
||||
|
||||
$ErrorActionPreference = "Stop"
|
||||
$studio = Join-Path (Split-Path -Parent $PSScriptRoot) "studio"
|
||||
$studio = Join-Path (Split-Path -Parent $PSScriptRoot) "studio\ui"
|
||||
|
||||
if (-not (Get-Command npm -ErrorAction SilentlyContinue)) {
|
||||
throw "npm introuvable : installer Node.js 24 (https://nodejs.org)."
|
||||
|
||||
+1
-1
@@ -32,7 +32,7 @@ stop_mock_core() {
|
||||
}
|
||||
trap stop_mock_core EXIT
|
||||
|
||||
cd "$root/studio"
|
||||
cd "$root/studio/ui"
|
||||
if [[ ! -f node_modules/.package-lock.json || package-lock.json -nt node_modules/.package-lock.json ]]; then
|
||||
echo "==> npm ci"
|
||||
npm ci --no-audit --no-fund
|
||||
|
||||
+11
-125
@@ -1,137 +1,23 @@
|
||||
# SEQUA Studio
|
||||
|
||||
**SEQUA** signifie *Simulate Environments, Quantify Uncertainty, Adapt* : simuler des environnements, quantifier l'incertitude liée à leur représentation et aux traitements, puis adapter les méthodes de calcul et de rendu au contexte. SEQUA Engine réunit quatre couches : **Studio** (la création), **Core** (la source de vérité : projet, simulation déterministe, rejeu, intentions, orchestrateur de rendu, confiance), **SEQUA 3D** (le contrat de données et la synchronisation vers les moteurs) et des **moteurs 3D interchangeables** (Godot, puis Unreal, à terme un moteur maison). SEQUA possède le projet et pilote les moteurs ; il n'est pas un plugin d'un autre moteur.
|
||||
## SEQUA Engine en bref
|
||||
|
||||
## Rôle de Studio
|
||||
**SEQUA** : *Simulate Environments, Quantify Uncertainty, Adapt.* SEQUA Engine est un environnement de création et d'exécution de mondes virtuels, d'abord pour le jeu vidéo, où l'auteur dirige un monde par l'intention, le ressenti et les règles plutôt que par des paramètres. Il est composé de quatre couches : **Studio** (outil de création), **Core** (source de vérité), **SEQUA 3D** (seule porte vers un moteur 3D) et des **moteurs 3D** interchangeables.
|
||||
|
||||
Studio est le **cœur et le visage du produit** : c'est là que l'auteur exprime son intention, règle le ressenti, compose les modes de jeu et compare des variantes. Studio est une application web TypeScript indépendante de tout moteur ; il ne parle au Core que par un **protocole** (WebSocket et schéma partagé, Protobuf ou FlatBuffers — format non encore choisi). Son conteneur (navigateur, webview système, CEF) est un détail remplaçable.
|
||||
Référence : [docs/SEQUA_Engine_resume_complet_v2.md](../docs/SEQUA_Engine_resume_complet_v2.md)
|
||||
|
||||
L'interface est une **vue d'un modèle d'état sérialisable** : elle ne porte aucune logique produit. Les interactions produisent des événements, l'état évolue uniquement par une fonction pure de réduction, puis la vue est réaffichée.
|
||||
## Rôle de Studio dans l'engine
|
||||
|
||||
## État actuel
|
||||
Studio est le produit que l'auteur ouvre : le cœur et le visage de SEQUA (§4). Il a deux faces, développées ensemble ([ADR 0006](../docs/adr/0006-studio-host-et-cycle-de-vie-du-core.md)) :
|
||||
|
||||
Squelette sans framework UI ni bibliothèque de composants :
|
||||
|
||||
- projet Vite + TypeScript strict, tests Vitest ;
|
||||
- état minimal sérialisable (`connection`, `protocolVersion`, version du Core, raison de la dernière déconnexion, liste d'intentions vide) et réduction pure ;
|
||||
- interface sobre affichant le titre, le statut de connexion, le badge **« Core simulé »** ou **« Core réel »**, la version du Core et la raison de la dernière déconnexion ;
|
||||
- connexion **simulée** par défaut : `SimulatedCoreConnection` n'ouvre aucune socket et reproduit la séquence `connecting` → `connected` avec une version de Core fictive marquée comme simulée ;
|
||||
- connexion **réelle** optionnelle : `WebSocketCoreConnection` utilise l'API WebSocket native du navigateur, sans bibliothèque, et effectue la poignée de main `hello` → `welcome` ;
|
||||
- messages JSON **provisoires** dans `src/protocol/messages.ts`, en attendant le schéma partagé (Protobuf ou FlatBuffers, fixé par une ADR) ;
|
||||
- faux Core de développement (`tools/mock-core.mjs`) pour tester le chemin WebSocket sans compiler le C++ (voir ci-dessous) ;
|
||||
- pas encore de reconnexion automatique.
|
||||
|
||||
## Se connecter à un Core
|
||||
|
||||
Par défaut, Studio reste en mode simulé. Pour viser un Core réel, ajouter le paramètre d'URL `core` avec une URL `ws://` ou `wss://` :
|
||||
|
||||
```text
|
||||
http://localhost:5173/?core=ws://127.0.0.1:9100
|
||||
```
|
||||
|
||||
Tout autre schéma (ou une URL invalide) est refusé : Studio reste en simulé et affiche la raison. Le vrai Core est l'exécutable `sequa-core` ; pour le développement sans le compiler, voir « Faux Core de développement » ci-dessous.
|
||||
|
||||
Le format des messages est **provisoire** et confiné à `src/protocol/` :
|
||||
|
||||
- enveloppe `{ "v": 1, "type": "...", "payload": { ... } }` ;
|
||||
- client → Core : `hello` `{ protocolVersion, client: "sequa-studio" }` ;
|
||||
- Core → client : `welcome` `{ protocolVersion, coreVersion }` et `error` `{ code, message }` ;
|
||||
- la poignée de main réussit si la version majeure de `welcome.protocolVersion` est celle de Studio et, tant que cette majeure vaut `0` (API instable selon semver), si la mineure est identique aussi ; un message `error`, un message indécodable, une version incompatible ou un délai de poignée de main dépassé (5 s par défaut) ferme le socket et affiche la raison.
|
||||
|
||||
Ce format sera remplacé par un schéma binaire généré depuis `schema/` ; aucun autre module ne doit en dépendre.
|
||||
|
||||
## Faux Core de développement
|
||||
|
||||
Pour tester le chemin WebSocket **sans compiler le vrai Core** (l'exécutable `sequa-core`), Studio fournit un faux serveur Core dans `studio/tools/mock-core.mjs` :
|
||||
|
||||
- **SIMULÉ** : ce serveur n'est **pas** le Core. Il imite uniquement le protocole WebSocket du vrai Core (`hello` → `welcome` / `error`, mêmes messages d'erreur, mêmes codes de fermeture 1002/1003/1008…) et ne fournit aucune donnée réelle ;
|
||||
- **aucune dépendance** : modules `node:` uniquement, implémentation minimale de la RFC 6455 (poignée de main, trames client masquées, ping → pong, close propre, trames fragmentées refusées) ;
|
||||
- écoute par défaut sur `127.0.0.1:9101` (jamais sur toutes les interfaces) et journalise chaque connexion et message.
|
||||
|
||||
Six scénarios couvrent des cas d'erreur difficiles à provoquer avec le vrai Core :
|
||||
|
||||
| Scénario (`--scenario`) | Comportement du faux Core | Effet côté Studio |
|
||||
| Dossier | Rôle | Langage |
|
||||
|---|---|---|
|
||||
| `ok` | poignée de main normale : `hello` → `welcome` | **Core réel** connecté, version `0.0.0-mock` |
|
||||
| `incompatible` | répond `welcome` avec une version de protocole d'une autre mineure | déconnexion : « Version de protocole incompatible » |
|
||||
| `error` | répond `error { code: 'incompatible-protocol', … }` puis ferme (1008), comme le vrai Core | déconnexion avec la raison du Core |
|
||||
| `silent` | ne répond jamais | délai de poignée de main dépassé (5 s) |
|
||||
| `garbage` | répond du texte non JSON | « Message illisible pendant la poignée de main » |
|
||||
| `close` | ferme immédiatement (code 1011 + raison) | déconnexion avec la raison de fermeture |
|
||||
| [host/](host) | Exécutable `sequa-studio` : démarre ou rejoint le Core, le supervise (arrêt, redémarrage, rechargement d'un Core recompilé **par rejeu de la session**), sert l'interface ; plus tard, fenêtre webview | C++20 |
|
||||
| [ui/](ui) | Interface web : vue d'un état sérialisable, parle au Core uniquement par protocole | TypeScript |
|
||||
|
||||
Lancement autonome (arrêt : Ctrl+C) :
|
||||
|
||||
```bash
|
||||
npm run mock-core # scénario ok sur ws://127.0.0.1:9101
|
||||
npm run mock-core -- --scenario error --port 9200
|
||||
node tools/mock-core.mjs --help
|
||||
```
|
||||
|
||||
Ou lancement couplé à Studio (le faux Core démarre en arrière-plan et s'arrête avec Studio) :
|
||||
|
||||
```powershell
|
||||
.\scripts\studio.ps1 -MockCore # ouvre Studio sur le faux Core
|
||||
.\scripts\studio.ps1 -MockCore -Scenario garbage
|
||||
```
|
||||
|
||||
```bash
|
||||
MOCK_CORE=garbage ./scripts/studio.sh # équivalent Unix
|
||||
```
|
||||
|
||||
Les tests d'intégration `tests/mock-core.test.ts` connectent la vraie `WebSocketCoreConnection` à chaque scénario sur un port libre, via l'API `startMockCore({ port: 0, scenario })` exportée par `tools/mock-core.mjs`.
|
||||
|
||||
> **Avertissement** : le faux Core est un outil de développement, marqué SIMULÉ dans ses messages et au démarrage. Le vrai Core reste l'exécutable `sequa-core` ; seul ce dernier fournit des données réelles. Le faux Core écoute sur 9101 et le vrai `sequa-core` sur 9100 : les deux peuvent tourner en même temps. Si le port 9101 est déjà occupé, le faux Core refuse de démarrer avec un message explicite.
|
||||
|
||||
## Commandes
|
||||
|
||||
Prérequis : Node.js 24 recommandé (Vitest 5 accepte `^22.12`, `^24` et `>=26` ; Vite 8 accepte `^20.19` ou `>=22.12`).
|
||||
|
||||
```bash
|
||||
npm ci # installation reproductible depuis package-lock.json
|
||||
npm run dev # serveur de développement Vite
|
||||
npm run check # typecheck, tests, puis build de production
|
||||
```
|
||||
|
||||
Autres scripts : `npm run typecheck` (`tsc --noEmit`), `npm run test` (`vitest run`), `npm run build` (`vite build`), `npm run preview`, `npm run mock-core` (`node tools/mock-core.mjs`, le faux Core de développement).
|
||||
|
||||
## Structure
|
||||
|
||||
```text
|
||||
studio/
|
||||
├── index.html
|
||||
├── package.json
|
||||
├── tsconfig.json
|
||||
├── src/
|
||||
│ ├── main.ts # montage dans #app, câblage connexion ↔ vue
|
||||
│ ├── style.css # thème sombre minimal
|
||||
│ ├── model/state.ts # StudioState, événements, état initial, reduce pure
|
||||
│ ├── protocol/
|
||||
│ │ ├── connection.ts # interface CoreConnection + connexion SIMULÉE
|
||||
│ │ ├── messages.ts # messages JSON provisoires (encode/decode validants)
|
||||
│ │ └── websocket.ts # connexion WebSocket réelle (API native)
|
||||
│ └── ui/app.ts # rendu de l'état et actions de connexion
|
||||
├── tools/
|
||||
│ ├── mock-core.mjs # FAUX Core de développement (SIMULÉ) : serveur WebSocket RFC 6455
|
||||
│ └── mock-core.d.mts # types publics du faux Core (contrat pour les tests)
|
||||
└── tests/
|
||||
├── state.test.ts
|
||||
├── connection.test.ts
|
||||
├── messages.test.ts
|
||||
├── websocket.test.ts
|
||||
├── mock-core.test.ts # intégration : vraie WebSocket contre le faux Core
|
||||
└── node-net.d.ts # déclarations minimales de node:net pour ces tests
|
||||
```
|
||||
L'auteur ne lance que Studio ; le Core reste un processus séparé, lançable seul pour les tests et les usages avancés.
|
||||
|
||||
## Licences
|
||||
|
||||
**SEQUA Studio est distribué sous Mozilla Public License 2.0 (MPL-2.0).** Chaque fichier source porte son identifiant SPDX.
|
||||
|
||||
Dépendances directes de développement (versions et licences relevées dans `node_modules/<paquet>/package.json` après installation) :
|
||||
|
||||
| Paquet | Version | Licence |
|
||||
|---|---|---|
|
||||
| vite | 8.3.6 | MIT |
|
||||
| typescript | 7.0.2 | Apache-2.0 |
|
||||
| vitest | 5.1.0 | MIT |
|
||||
|
||||
Ce sont les seules dépendances directes. Les paquets transitifs nécessaires à Vite, TypeScript et Vitest sont verrouillés par `package-lock.json` et restent des dépendances de développement, absentes du build de production en dehors des fichiers générés par Vite.
|
||||
- SEQUA Studio : [MPL 2.0](../LICENSE).
|
||||
- Dépendances : voir [ui/README.md](ui/README.md) et, pour `host/`, les bibliothèques déclarées dans `cmake/SequaDependencies.cmake`.
|
||||
@@ -0,0 +1,137 @@
|
||||
# SEQUA Studio
|
||||
|
||||
**SEQUA** signifie *Simulate Environments, Quantify Uncertainty, Adapt* : simuler des environnements, quantifier l'incertitude liée à leur représentation et aux traitements, puis adapter les méthodes de calcul et de rendu au contexte. SEQUA Engine réunit quatre couches : **Studio** (la création), **Core** (la source de vérité : projet, simulation déterministe, rejeu, intentions, orchestrateur de rendu, confiance), **SEQUA 3D** (le contrat de données et la synchronisation vers les moteurs) et des **moteurs 3D interchangeables** (Godot, puis Unreal, à terme un moteur maison). SEQUA possède le projet et pilote les moteurs ; il n'est pas un plugin d'un autre moteur.
|
||||
|
||||
## Rôle de Studio
|
||||
|
||||
Studio est le **cœur et le visage du produit** : c'est là que l'auteur exprime son intention, règle le ressenti, compose les modes de jeu et compare des variantes. Studio est une application web TypeScript indépendante de tout moteur ; il ne parle au Core que par un **protocole** (WebSocket et schéma partagé, Protobuf ou FlatBuffers — format non encore choisi). Son conteneur (navigateur, webview système, CEF) est un détail remplaçable.
|
||||
|
||||
L'interface est une **vue d'un modèle d'état sérialisable** : elle ne porte aucune logique produit. Les interactions produisent des événements, l'état évolue uniquement par une fonction pure de réduction, puis la vue est réaffichée.
|
||||
|
||||
## État actuel
|
||||
|
||||
Squelette sans framework UI ni bibliothèque de composants :
|
||||
|
||||
- projet Vite + TypeScript strict, tests Vitest ;
|
||||
- état minimal sérialisable (`connection`, `protocolVersion`, version du Core, raison de la dernière déconnexion, liste d'intentions vide) et réduction pure ;
|
||||
- interface sobre affichant le titre, le statut de connexion, le badge **« Core simulé »** ou **« Core réel »**, la version du Core et la raison de la dernière déconnexion ;
|
||||
- connexion **simulée** par défaut : `SimulatedCoreConnection` n'ouvre aucune socket et reproduit la séquence `connecting` → `connected` avec une version de Core fictive marquée comme simulée ;
|
||||
- connexion **réelle** optionnelle : `WebSocketCoreConnection` utilise l'API WebSocket native du navigateur, sans bibliothèque, et effectue la poignée de main `hello` → `welcome` ;
|
||||
- messages JSON **provisoires** dans `src/protocol/messages.ts`, en attendant le schéma partagé (Protobuf ou FlatBuffers, fixé par une ADR) ;
|
||||
- faux Core de développement (`tools/mock-core.mjs`) pour tester le chemin WebSocket sans compiler le C++ (voir ci-dessous) ;
|
||||
- pas encore de reconnexion automatique.
|
||||
|
||||
## Se connecter à un Core
|
||||
|
||||
Par défaut, Studio reste en mode simulé. Pour viser un Core réel, ajouter le paramètre d'URL `core` avec une URL `ws://` ou `wss://` :
|
||||
|
||||
```text
|
||||
http://localhost:5173/?core=ws://127.0.0.1:9100
|
||||
```
|
||||
|
||||
Tout autre schéma (ou une URL invalide) est refusé : Studio reste en simulé et affiche la raison. Le vrai Core est l'exécutable `sequa-core` ; pour le développement sans le compiler, voir « Faux Core de développement » ci-dessous.
|
||||
|
||||
Le format des messages est **provisoire** et confiné à `src/protocol/` :
|
||||
|
||||
- enveloppe `{ "v": 1, "type": "...", "payload": { ... } }` ;
|
||||
- client → Core : `hello` `{ protocolVersion, client: "sequa-studio" }` ;
|
||||
- Core → client : `welcome` `{ protocolVersion, coreVersion }` et `error` `{ code, message }` ;
|
||||
- la poignée de main réussit si la version majeure de `welcome.protocolVersion` est celle de Studio et, tant que cette majeure vaut `0` (API instable selon semver), si la mineure est identique aussi ; un message `error`, un message indécodable, une version incompatible ou un délai de poignée de main dépassé (5 s par défaut) ferme le socket et affiche la raison.
|
||||
|
||||
Ce format sera remplacé par un schéma binaire généré depuis `schema/` ; aucun autre module ne doit en dépendre.
|
||||
|
||||
## Faux Core de développement
|
||||
|
||||
Pour tester le chemin WebSocket **sans compiler le vrai Core** (l'exécutable `sequa-core`), Studio fournit un faux serveur Core dans `studio/ui/tools/mock-core.mjs` :
|
||||
|
||||
- **SIMULÉ** : ce serveur n'est **pas** le Core. Il imite uniquement le protocole WebSocket du vrai Core (`hello` → `welcome` / `error`, mêmes messages d'erreur, mêmes codes de fermeture 1002/1003/1008…) et ne fournit aucune donnée réelle ;
|
||||
- **aucune dépendance** : modules `node:` uniquement, implémentation minimale de la RFC 6455 (poignée de main, trames client masquées, ping → pong, close propre, trames fragmentées refusées) ;
|
||||
- écoute par défaut sur `127.0.0.1:9101` (jamais sur toutes les interfaces) et journalise chaque connexion et message.
|
||||
|
||||
Six scénarios couvrent des cas d'erreur difficiles à provoquer avec le vrai Core :
|
||||
|
||||
| Scénario (`--scenario`) | Comportement du faux Core | Effet côté Studio |
|
||||
|---|---|---|
|
||||
| `ok` | poignée de main normale : `hello` → `welcome` | **Core réel** connecté, version `0.0.0-mock` |
|
||||
| `incompatible` | répond `welcome` avec une version de protocole d'une autre mineure | déconnexion : « Version de protocole incompatible » |
|
||||
| `error` | répond `error { code: 'incompatible-protocol', … }` puis ferme (1008), comme le vrai Core | déconnexion avec la raison du Core |
|
||||
| `silent` | ne répond jamais | délai de poignée de main dépassé (5 s) |
|
||||
| `garbage` | répond du texte non JSON | « Message illisible pendant la poignée de main » |
|
||||
| `close` | ferme immédiatement (code 1011 + raison) | déconnexion avec la raison de fermeture |
|
||||
|
||||
Lancement autonome (arrêt : Ctrl+C) :
|
||||
|
||||
```bash
|
||||
npm run mock-core # scénario ok sur ws://127.0.0.1:9101
|
||||
npm run mock-core -- --scenario error --port 9200
|
||||
node tools/mock-core.mjs --help
|
||||
```
|
||||
|
||||
Ou lancement couplé à Studio (le faux Core démarre en arrière-plan et s'arrête avec Studio) :
|
||||
|
||||
```powershell
|
||||
.\scripts\studio.ps1 -MockCore # ouvre Studio sur le faux Core
|
||||
.\scripts\studio.ps1 -MockCore -Scenario garbage
|
||||
```
|
||||
|
||||
```bash
|
||||
MOCK_CORE=garbage ./scripts/studio.sh # équivalent Unix
|
||||
```
|
||||
|
||||
Les tests d'intégration `tests/mock-core.test.ts` connectent la vraie `WebSocketCoreConnection` à chaque scénario sur un port libre, via l'API `startMockCore({ port: 0, scenario })` exportée par `tools/mock-core.mjs`.
|
||||
|
||||
> **Avertissement** : le faux Core est un outil de développement, marqué SIMULÉ dans ses messages et au démarrage. Le vrai Core reste l'exécutable `sequa-core` ; seul ce dernier fournit des données réelles. Le faux Core écoute sur 9101 et le vrai `sequa-core` sur 9100 : les deux peuvent tourner en même temps. Si le port 9101 est déjà occupé, le faux Core refuse de démarrer avec un message explicite.
|
||||
|
||||
## Commandes
|
||||
|
||||
Prérequis : Node.js 24 recommandé (Vitest 5 accepte `^22.12`, `^24` et `>=26` ; Vite 8 accepte `^20.19` ou `>=22.12`).
|
||||
|
||||
```bash
|
||||
npm ci # installation reproductible depuis package-lock.json
|
||||
npm run dev # serveur de développement Vite
|
||||
npm run check # typecheck, tests, puis build de production
|
||||
```
|
||||
|
||||
Autres scripts : `npm run typecheck` (`tsc --noEmit`), `npm run test` (`vitest run`), `npm run build` (`vite build`), `npm run preview`, `npm run mock-core` (`node tools/mock-core.mjs`, le faux Core de développement).
|
||||
|
||||
## Structure
|
||||
|
||||
```text
|
||||
studio/
|
||||
├── index.html
|
||||
├── package.json
|
||||
├── tsconfig.json
|
||||
├── src/
|
||||
│ ├── main.ts # montage dans #app, câblage connexion ↔ vue
|
||||
│ ├── style.css # thème sombre minimal
|
||||
│ ├── model/state.ts # StudioState, événements, état initial, reduce pure
|
||||
│ ├── protocol/
|
||||
│ │ ├── connection.ts # interface CoreConnection + connexion SIMULÉE
|
||||
│ │ ├── messages.ts # messages JSON provisoires (encode/decode validants)
|
||||
│ │ └── websocket.ts # connexion WebSocket réelle (API native)
|
||||
│ └── ui/app.ts # rendu de l'état et actions de connexion
|
||||
├── tools/
|
||||
│ ├── mock-core.mjs # FAUX Core de développement (SIMULÉ) : serveur WebSocket RFC 6455
|
||||
│ └── mock-core.d.mts # types publics du faux Core (contrat pour les tests)
|
||||
└── tests/
|
||||
├── state.test.ts
|
||||
├── connection.test.ts
|
||||
├── messages.test.ts
|
||||
├── websocket.test.ts
|
||||
├── mock-core.test.ts # intégration : vraie WebSocket contre le faux Core
|
||||
└── node-net.d.ts # déclarations minimales de node:net pour ces tests
|
||||
```
|
||||
|
||||
## Licences
|
||||
|
||||
**SEQUA Studio est distribué sous Mozilla Public License 2.0 (MPL-2.0).** Chaque fichier source porte son identifiant SPDX.
|
||||
|
||||
Dépendances directes de développement (versions et licences relevées dans `node_modules/<paquet>/package.json` après installation) :
|
||||
|
||||
| Paquet | Version | Licence |
|
||||
|---|---|---|
|
||||
| vite | 8.3.6 | MIT |
|
||||
| typescript | 7.0.2 | Apache-2.0 |
|
||||
| vitest | 5.1.0 | MIT |
|
||||
|
||||
Ce sont les seules dépendances directes. Les paquets transitifs nécessaires à Vite, TypeScript et Vitest sont verrouillés par `package-lock.json` et restent des dépendances de développement, absentes du build de production en dehors des fichiers générés par Vite.
|
||||
File renamed without changes.
+2
-2
@@ -1,11 +1,11 @@
|
||||
{
|
||||
"name": "@sequa/studio",
|
||||
"name": "@sequa/studio-ui",
|
||||
"version": "0.0.0",
|
||||
"lockfileVersion": 3,
|
||||
"requires": true,
|
||||
"packages": {
|
||||
"": {
|
||||
"name": "@sequa/studio",
|
||||
"name": "@sequa/studio-ui",
|
||||
"version": "0.0.0",
|
||||
"license": "MPL-2.0",
|
||||
"devDependencies": {
|
||||
@@ -1,5 +1,5 @@
|
||||
{
|
||||
"name": "@sequa/studio",
|
||||
"name": "@sequa/studio-ui",
|
||||
"version": "0.0.0",
|
||||
"private": true,
|
||||
"license": "MPL-2.0",
|
||||
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
@@ -1,7 +1,7 @@
|
||||
// SPDX-License-Identifier: MPL-2.0
|
||||
|
||||
/**
|
||||
* Types publics de studio/tools/mock-core.mjs, pour les importateurs.
|
||||
* Types publics de studio/ui/tools/mock-core.mjs, pour les importateurs.
|
||||
*
|
||||
* Le .mjs n'est pas couvert par tsc (tsconfig.json n'inclut que src/ et
|
||||
* tests/, et le typer exigerait @types/node — dépendance interdite) :
|
||||
@@ -8,7 +8,7 @@
|
||||
// Ce serveur N'EST PAS le Core : il imite le serveur WebSocket du vrai Core
|
||||
// (l'exécutable sequa-core, core/src/server/) pour tester le chemin
|
||||
// WebSocket de Studio sans compiler de C++, y compris les cas d'erreur
|
||||
// difficiles à provoquer avec le vrai Core. Voir studio/README.md.
|
||||
// difficiles à provoquer avec le vrai Core. Voir studio/ui/README.md.
|
||||
//
|
||||
// - Aucune dépendance : modules node: uniquement (http, crypto, os, url).
|
||||
// - RFC 6455, strict minimum : poignée de main HTTP Upgrade (Sec-WebSocket-
|
||||
@@ -43,7 +43,7 @@ import { PROTOCOL_VERSION } from '../src/model/state.ts';
|
||||
/** GUID de la poignée de main (RFC 6455 §1.3). */
|
||||
const WEBSOCKET_GUID = '258EAFA5-E914-47DA-95CA-C5AB0DC85B11';
|
||||
|
||||
/** Miroir de ENVELOPE_VERSION dans studio/src/protocol/messages.ts. */
|
||||
/** Miroir de ENVELOPE_VERSION dans studio/ui/src/protocol/messages.ts. */
|
||||
const ENVELOPE_VERSION = 1;
|
||||
|
||||
/** Version annoncée dans welcome ; le suffixe la marque comme fictive. */
|
||||
@@ -788,7 +788,7 @@ const BANNER = [
|
||||
'==========================================================================',
|
||||
' FAUX CORE DE DÉVELOPPEMENT (SIMULÉ)',
|
||||
' Ce serveur n\'est PAS sequa-core : il imite son protocole WebSocket',
|
||||
' pour tester Studio sans compiler de C++. Voir studio/README.md.',
|
||||
' pour tester Studio sans compiler de C++. Voir studio/ui/README.md.',
|
||||
'==========================================================================',
|
||||
].join('\n');
|
||||
|
||||
File renamed without changes.
Reference in new issue
Block a user