Wip ne pas utiliser
  • TypeScript 88.6%
  • CSS 9.6%
  • JavaScript 1.2%
  • Shell 0.5%
Find a file
leduc 70235fc277 docs(devbook,journal): D112 — A et B tranches par Sam (A2, phosphore AMBRE) ; seance en pause
Sam tranche les deux questions bloquantes :

**A = la reponse 2** : l'afficheur est une FENETRE ENFONCEE, plus sombre que la
plaque, avec la trace claire DEDANS. Plaque a 23, ecran a ~6, trace a ~120. La
hierarchie sombre de D103 (10/16/23/34) est INTACTE : aucun niveau ajoute
au-dessus de 34. C'est ce que PreviewCanvas pratique deja.

**B = AMBRE** — et le motif de Sam bat le mien : « puisque l'UI est gris/orange ».
--title-fg: #d6cabd (D105) est un beige orange, R-B = 25 : le phosphore ambre est
de la MEME FAMILLE que les serigraphies. Le vert P31 que je proposais aurait ete
la seule couleur froide de la maison — contre la loi de D105, pas avec elle.
→ --phosphore: #ffab2e. Regle d'usage : l'ambre est la couleur de CE QUI EST
ALIMENTE (trace, valeur affichee, lampe d'activite) ; ce qui ne l'est pas reste au
gris de la plaque. Le rouge RESTE RESERVE A RECORD : une lampe rouge parmi des
lampes ambres se lit, l'ambre ne doit pas lui voler ce sens-la.

Ce que B decide automatiquement : G (les lampes « ce qui marche » deviennent
ambres, pas vertes), E (le graticule est SERIGAPHIE SOUS le phosphore, donc ambre
a faible opacite, 3 divisions sur les mini-ecrans), et A2 impose le halo de trace
en overlay — la loi de D108, une couche en alpha n'est pas symetrique en luminance.

La seance est EN PAUSE (Sam recupere le GPU). Par ou reprendre : l'ordre de la
question H, WaveIcons d'abord (3 instances, aucune geometrie touchee, c'est le cas
que Sam a nomme). Restent a trancher C, D, F, qui se decident en codant.

Corrections de coherence au passage : « rien n'est commité » date (commits et
push faits le soir meme), l'ILDA a 8 tests et non 7, et l'amont de main est
desormais configure.

Aucune ligne de code pour D112. Pousse sur demande explicite de Sam.
2026-11-12 23:28:19 +01:00
docs docs(devbook,journal): D112 — A et B tranches par Sam (A2, phosphore AMBRE) ; seance en pause 2026-11-12 23:28:19 +01:00
packages style(client): palette centralisee, alu brossé, titres, colonnes figees, chassis eurorack, atelier couleur (D103-D111) 2026-11-12 14:42:40 +01:00
.editorconfig chore: initialize pnpm monorepo 2026-09-05 21:30:33 +02:00
.gitignore chore: initialize pnpm monorepo 2026-09-05 21:30:33 +02:00
biome.json feat(client): UI fidele a l'originale — MIXER centre, colonne 1-2 en flux, glow du titre 2026-10-21 14:39:00 +02:00
CClist feat: port local du 2026-09-22 (WS host adaptatif, TranslatorStack row-based, ports 8210/8211, DAC bridge koffi, docs layout) 2026-10-20 14:26:58 +02:00
maxwell2.jpg feat: source audio Redis, bouton INV (le cercle), couleur solid — D56 a D62 2026-10-22 23:31:57 +02:00
maxwellUI.jpg feat: port local du 2026-09-22 (WS host adaptatif, TranslatorStack row-based, ports 8210/8211, DAC bridge koffi, docs layout) 2026-10-20 14:26:58 +02:00
package.json feat(server): la sortie laser reelle — generateur de points + pont EtherDream 2026-10-24 03:15:38 +02:00
pnpm-lock.yaml feat: port local du 2026-09-22 (WS host adaptatif, TranslatorStack row-based, ports 8210/8211, DAC bridge koffi, docs layout) 2026-10-20 14:26:58 +02:00
pnpm-workspace.yaml chore(workspace): garder koffi dans allowBuilds (dep FFI native) 2026-10-20 14:27:20 +02:00
README.md fix(lint): faire passer pnpm run lint (0 erreur sur 111 fichiers) 2026-10-20 17:40:04 +02:00
redis_audio.md feat: source audio Redis, bouton INV (le cercle), couleur solid — D56 a D62 2026-10-22 23:31:57 +02:00
remaxwell feat: port local du 2026-09-22 (WS host adaptatif, TranslatorStack row-based, ports 8210/8211, DAC bridge koffi, docs layout) 2026-10-20 14:26:58 +02:00
tsconfig.base.json chore: initialize pnpm monorepo 2026-09-05 21:30:33 +02:00

remaxwell-web

Portail web de Maxwell (pilotage laser) — UI fidèle à maxwellUI.jpg, 194 pattrs, mixeur A/B crossfade, preview live, panneau DAC. React 18 + Vite + Zustand d'un côté, serveur Node (WebSocket + HTTP static + pont EtherDream via koffi) de l'autre.

Docs de référence (source de vérité du port) :

  • packages/docs/05-patcher-complete.md — manuel exhaustif du patch Maxwell
  • packages/docs/05-patcher-mechanical.md — référence mécanique des sous-patchers
  • CClist — référence brute Maxwell/Maxwellator (OSC → ArtNet/MIDI CC), non modifiée. C'est une table externe : pour « est-ce câblé ici ? », lire le code, pas ce fichier.
  • maxwellUI.jpg — capture de l'UI Maxwell originale, cible de layout

Quick start

pnpm install
pnpm build          # tsc + vite build (client) / tsc (server)
./remaxwell start   # serveur : HTTP 8210 + WS 8211, bind 0.0.0.0

Le serveur bind 0.0.0.0 par défaut (UI et WS accessibles depuis le LAN). Ouvrir http://<ip-du-serveur>:8210 dans un navigateur. Le client se connecte au WebSocket sur le même host que la page (ws://<hostname>:8211) — pas besoin de config du côté client.

Dev (hot reload) :

pnpm dev            # vite dev 5173 (proxy /ws → 8211) + tsx watch (server)

Wrapper CLI (lifecycle) :

./remaxwell {start|stop|restart|status|logs|help}
# logs → /tmp/remaxwell-server.log, pid → /tmp/remaxwell-server.pid

Ports & configuration

Service Port Bind par défaut Override env
HTTP (UI + static) 8210 0.0.0.0 REMAXWELL_HTTP_PORT / REMAXWELL_HTTP_HOST
WebSocket (pattrs) 8211 0.0.0.0 REMAXWELL_WS_PORT / REMAXWELL_WS_HOST

Autres env : REMAXWELL_DAC_LIB (chemin du dylib EtherDream), REMAXWELL_PRESETS_DIR (défaut ~/.remaxwell/presets). Tout est dans packages/server/src/config.ts.

DAC

packages/server/bin/etherdream.dylib est gitignoré (non redistribué) : le serveur démarre et l'UI tourne sans lui, mais il n'y a aucune sortie laser. Poser le dylib à cet emplacement, ou le pointer via REMAXWELL_DAC_LIB=/chemin/....

Tests

NODE_ENV=test pnpm test   # shared 38 + server 40 + client 37, tous verts

⚠️ Sur les machines où NODE_ENV=production est exporté globalement, vitest charge le build production de React et act() échoue (9 faux échecs client). Toujours lancer les tests avec NODE_ENV=test.

Note : les tests server existent en double (.js + .ts parité) → 40 exécutés, 20 fichiers de test réels.

Lint / build

pnpm run lint        # biome check .
pnpm run build       # par package : tsc --noEmit + vite build (client), tsc (server)

pnpm run lint passe (0 erreur, 111 fichiers vérifiés). Les règles a11y structurelles sont désactivées dans biome.json — l'UI Maxwell se dessine avec des <label> de légende et des <div onClick> (dials), sans équivalent sémantique sans refaire toute la grille. Les règles non-a11y sont toutes actives.

Structure

packages/shared/   types + PATTRS (194) + protocoles (pattrs, lfo, vec3, quat, etherdream-point)
packages/server/   Node.js : PattrEngine, WS server (8211), HTTP static (8210), DAC bridge koffi
packages/client/   React 18 + Vite : UI Maxwell 1280×800 (pas de scroll)
packages/docs/     docs portées du projet RE original
remaxwell          wrapper CLI bash (start/stop/restart/status/logs)

Layout UI (grille 4 colonnes × 4 rangées, 1280×800)

Rangées en fr (210fr 115fr 100fr 130fr), PREVIEW spanne les rangées 1-3 :

col 1 col 2 col 3 col 4
Row 1 OSC LEFT (X/Y/Z) OSC RIGHT (X/Y/Z) LFO 1/2/3 PREVIEW (live, rows 1-3)
Row 2 MIXER A/B crossfade (col 1-2) ↙ ROTATOR (XYZ) ↙ (preview)
Row 3 COLOR MODULATOR (col 1-2) ↙ TRANSLATOR X/Y/Z (stack) ↙ (preview)
Row 4 POINT COLOR DUP + INTENSITY DRAW MODE + SCALER DAC Settings

Sources : packages/client/src/styles.css (classes .col-*, .span-mixer, .span-color) et App.tsx.

Protocole WS

Minimal : setPattr / getPattrs / setPattrs (client → serveur), pattrs / pattrChanged / error (serveur → client). Voir packages/shared/src/protocol.ts.

État du port

  • ✅ 194 pattrs typés + validation des clés (getPattr rejette les clés inconnues, tests de régression)
  • ✅ UI compacte complète : header, OSC, LFO, mixer A/B, translateurs, rotator, couleurs, DAC
  • ✅ Preview live (Lissajous 3D, point cloud 500 pts)
  • ✅ Serveur bind 0.0.0.0 + client adaptatif (window.location.hostname)
  • ✅ 115 tests verts (voir Tests)
  • 🔜 Câblage DAC réel (bridge EtherDream via koffi) — REMAXWELL_DAC_LIB
  • 🔜 Persistance presets (presetsDir)
  • 🔜 MIDI/ILDA (référence dans CClist)