@indos/bibliotheque 2.4.0 → 4.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CLAUDE.md +361 -0
- package/LICENSE +4 -18
- package/README.md +6 -11
- package/bin/page-de-l-espace.js +12 -6
- package/package.json +16 -13
- package/src/app.js +2 -2
- package/src/appeler.js +4 -5
- package/src/compte.d.ts +222 -8
- package/src/compte.js +250 -22
- package/src/description-des-comptes.d.ts +16 -0
- package/src/direct/page.js +1 -1
- package/src/direct.js +1 -1
- package/src/ecran.js +2 -2
- package/src/espace/apercu.js +10 -23
- package/src/espace/cadre.d.ts +3 -5
- package/src/espace/cadre.js +29 -31
- package/src/espace/chose-seule.d.ts +1 -4
- package/src/espace/chose-seule.js +7 -16
- package/src/espace/choses.d.ts +9 -5
- package/src/espace/choses.js +9 -4
- package/src/espace/comptes.js +146 -103
- package/src/espace/coquille.d.ts +5 -5
- package/src/espace/coquille.js +93 -63
- package/src/espace/doubles-de-jsdom.js +11 -4
- package/src/espace/ecran-d-une-chose.js +10 -9
- package/src/espace/ecran.js +1 -2
- package/src/espace/edition-de-la-barre.js +35 -11
- package/src/espace/essai.js +4 -4
- package/src/espace/fenetre-du-don.d.ts +11 -0
- package/src/espace/fenetre-du-don.js +41 -0
- package/src/espace/index.d.ts +3 -3
- package/src/espace/index.js +3 -3
- package/src/espace/liste-des-choses.js +28 -24
- package/src/espace/menu-d-une-chose.js +15 -51
- package/src/espace/ouvrir.d.ts +3 -3
- package/src/espace/ouvrir.js +15 -14
- package/src/espace/panneau-du-partage.d.ts +8 -3
- package/src/espace/panneau-du-partage.js +36 -14
- package/src/espace/routes-des-choses.js +6 -5
- package/src/espace/session.d.ts +1 -0
- package/src/faux-core.d.ts +15 -3
- package/src/faux-core.js +71 -3
- package/src/fichiers.d.ts +2 -0
- package/src/fichiers.js +6 -4
- package/src/flux.js +1 -1
- package/src/format.d.ts +3 -0
- package/src/format.js +20 -1
- package/src/forme-du-direct.js +1 -1
- package/src/jeton.js +2 -2
- package/src/liens.js +1 -1
- package/src/mcp.js +3 -3
- package/src/notifier.d.ts +10 -0
- package/src/notifier.js +47 -0
- package/src/page.d.ts +17 -0
- package/src/page.js +139 -14
- package/src/partage.d.ts +5 -1
- package/src/partage.js +61 -16
- package/src/presence.js +1 -1
- package/src/sans-accents.js +1 -1
- package/src/session.js +4 -4
- package/src/theme.js +1 -1
- package/src/ui/blocs.d.ts +5 -2
- package/src/ui/blocs.js +11 -6
- package/src/ui/choix.d.ts +2 -1
- package/src/ui/choix.js +3 -2
- package/src/ui/fenetre.d.ts +8 -3
- package/src/ui/fenetre.js +34 -9
- package/src/ui/focus.d.ts +2 -0
- package/src/ui/focus.js +5 -0
- package/src/ui/gestes-du-contenu.d.ts +21 -0
- package/src/ui/gestes-du-contenu.js +24 -0
- package/src/ui/icones.d.ts +7 -0
- package/src/ui/icones.js +12 -1
- package/src/ui/index.d.ts +5 -4
- package/src/ui/index.js +4 -3
- package/src/ui/lien.d.ts +1 -0
- package/src/ui/lien.js +2 -2
- package/src/ui/menu-d-une-ligne.d.ts +2 -0
- package/src/ui/panneau.d.ts +1 -2
- package/src/ui/panneau.js +8 -4
- package/src/ui/reglages.d.ts +47 -0
- package/src/ui/reglages.js +101 -0
- package/src/ui/tableau.d.ts +1 -2
- package/src/ui/tableau.js +8 -12
- package/src/ui/vues.js +1 -1
- package/src/vite.d.ts +3 -0
- package/src/vite.js +50 -18
- package/CHANGELOG.md +0 -295
- package/bin/bibliotheque.d.ts +0 -1
- package/bin/bibliotheque.js +0 -62
- package/modeles/app-du-client/.dockerignore +0 -3
- package/modeles/app-du-client/DOCUMENTATION.md +0 -27
- package/modeles/app-du-client/Dockerfile +0 -36
- package/modeles/app-du-client/README.md +0 -53
- package/modeles/app-du-client/USAGE.md +0 -3
- package/modeles/app-du-client/espace/ecrans/entrees.tsx +0 -57
- package/modeles/app-du-client/espace/index.html +0 -9
- package/modeles/app-du-client/espace/page.tsx +0 -6
- package/modeles/app-du-client/espace/requetes/entrees.ts +0 -16
- package/modeles/app-du-client/espace/routes.ts +0 -12
- package/modeles/app-du-client/espace/tsconfig.json +0 -7
- package/modeles/app-du-client/gitignore +0 -2
- package/modeles/app-du-client/logo.svg +0 -1
- package/modeles/app-du-client/migrations/0001-creer-les-entrees.sql +0 -10
- package/modeles/app-du-client/module.json +0 -12
- package/modeles/app-du-client/package.json +0 -17
- package/modeles/app-du-client/src/demarrer.ts +0 -17
- package/modeles/app-du-client/src/outils.ts +0 -48
- package/modeles/app-du-client/src/serveur.ts +0 -46
- package/modeles/app-du-client/tests/espace/entrees.test.tsx +0 -57
- package/modeles/app-du-client/tests/serveur.test.ts +0 -119
- package/modeles/app-du-client/tests/sources-de-la-page.test.ts +0 -23
- package/modeles/app-du-client/tsconfig.json +0 -22
- package/src/ui/repli.d.ts +0 -12
- package/src/ui/repli.js +0 -6
package/CHANGELOG.md
DELETED
|
@@ -1,295 +0,0 @@
|
|
|
1
|
-
# Ce qui change dans @indos/bibliotheque
|
|
2
|
-
|
|
3
|
-
Écrit pour le développeur d'une app du client, qui monte la version de la bibliothèque dans son dépôt : une section par version publiée sur npm. Une version qui demande un geste dans l'app a sa rubrique « Ruptures » : le geste, les versions exactes de React, Vite et TanStack à reprendre, et le core que demande la majeure.
|
|
4
|
-
|
|
5
|
-
## 2.4.0
|
|
6
|
-
|
|
7
|
-
La barre se range et se règle sur place.
|
|
8
|
-
|
|
9
|
-
- La coquille dessine la barre rangée que rend le core (`session.rangement`) : les épingles, les séparateurs et les dossiers, sur un seul niveau, qui se replient d'un clic, le repli retenu par le navigateur. Sans `rangement`, elle dessine `session.barre`, à plat.
|
|
10
|
-
- La roue, en bas de la barre, la passe en édition, sur place : glisser au pointeur, avec un trait là où la ligne tombera, renommer, retirer ; « + Ajouter » cherche une page de l'OS ou une chose d'une app à choses, ou ajoute un dossier ou un séparateur ; « Changer », à côté de la marque, choisit l'accueil (`session.accueil`), où mène la marque. Chaque changement s'enregistre aussitôt, par `/espace/barre/enregistrer`. Sur `/reglages`, une page du core, la barre s'ouvre en édition, et « Terminé » mène à l'accueil.
|
|
11
|
-
- « Toutes les apps » est dans le menu de la personne, au pied de la barre.
|
|
12
|
-
- `estReglagesOuDocumentation(chemin)` dit ce qui ne s'épingle pas : les réglages d'une app et sa documentation. L'épingle de la ligne du haut n'y est pas.
|
|
13
|
-
- `Session` porte `rangement` et `accueil`, facultatifs, et `RangementDeLaBarre`.
|
|
14
|
-
- Le faux core rend `rangement` et `accueil` dans la session, et sert les éléments de la barre à `/espace/barre`. Sa barre de départ a « Bienvenue » pour accueil, hors de la barre.
|
|
15
|
-
|
|
16
|
-
### Ruptures
|
|
17
|
-
|
|
18
|
-
- La barre rangée, son édition et « Changer » demandent le core 2.9.0 : bornez le core de l'app à `"core": ">=2.9 <3"` dans `module.json`.
|
|
19
|
-
- Un test de l'app qui lit la barre du faux core n'y trouve plus « Bienvenue » : la barre de départ commence par le premier écran de chaque app.
|
|
20
|
-
- Un test de l'app qui cherche « Toutes les apps » au pied de la barre le trouve dans le menu de la personne.
|
|
21
|
-
- Les versions de React, Vite et TanStack ne changent pas ; `npm view @indos/bibliotheque@2.4.0 peerDependencies` les donne toutes.
|
|
22
|
-
- Pour monter : `"@indos/bibliotheque": "2.4.0"` dans ses `dependencies`, puis `npm install` et `npm test`.
|
|
23
|
-
|
|
24
|
-
## 2.3.0
|
|
25
|
-
|
|
26
|
-
Le serveur de développement relaie à l'app tout ce qui n'est pas à lui.
|
|
27
|
-
|
|
28
|
-
- `npm run dev` garde ce qui est à lui sous la base de l'app : les modules de Vite, les fichiers de `espace/`, le websocket du rechargement à chaud, et le `GET` d'un écran du manifeste, dont il sert la page à chaud (`<base><écran>` et ce qui est dessous, `<base>reglages`, et, pour une app à choses, l'écran d'une chose et la chose seule). Il relaie tout le reste à l'app lancée en local (`INDOS_APP`), quelle qu'en soit la méthode, websockets compris, sans le chemin de l'app, avec son origine et son hôte : un fichier que sert l'app, comme un PDF, une page qu'elle rend elle-même, le direct, s'ouvrent depuis la page servie à chaud.
|
|
29
|
-
- Pour une app qui n'a que des réglages, sans écran, la racine du serveur de développement (`http://localhost:5173/<nom>/`, et le retour après la connexion) mène à `/<nom>/reglages`.
|
|
30
|
-
- Le README du modèle d'une app (`modeles/app-du-client/README.md`) relie l'aperçu local, `npm run dev`, à l'espace où l'app est installée, au domaine de son serveur : une app pas encore installée y est fermée, et ses outils répondent 403. Il dit aussi ce que le serveur de développement sert à chaud et ce qu'il relaie à l'app.
|
|
31
|
-
|
|
32
|
-
Pour monter : `"@indos/bibliotheque": "2.3.0"` dans ses `dependencies`, puis `npm install` et `npm test`. Les versions de React, Vite et TanStack et le core demandé ne changent pas.
|
|
33
|
-
|
|
34
|
-
## 2.2.0
|
|
35
|
-
|
|
36
|
-
Le modèle d'une app dans le paquet, ses tests dans sa construction.
|
|
37
|
-
|
|
38
|
-
- `npx @indos/bibliotheque creer-une-app <nom> [<dossier>]` crée une app dans un dossier neuf, `./<nom>` par défaut : le modèle que porte le paquet, `nom` posé dans `module.json` et dans les liens de `DOCUMENTATION.md`, `@indos/bibliotheque` cité à la version du paquet. Le dossier peut être la racine d'un dépôt ou un dossier du dépôt des apps (`apps/<nom>`). La commande refuse un dossier qui existe et un nom qui n'est pas en minuscules, chiffres et tirets, une lettre d'abord. La suite, dans le dossier : `npm install`, puis `npm test`.
|
|
39
|
-
- Le `Dockerfile` du modèle lance les tests de l'app pendant la construction : une étape, à la plateforme du poste, installe tout et lance `npm test`, qui construit la page, et l'image, à la plateforme demandée (`--platform`), prend la page de cette étape. Un test qui échoue arrête `docker build`, et le journal le nomme. L'image se construit depuis le dossier de l'app, sur le poste : le modèle n'a plus de workflow de CI.
|
|
40
|
-
|
|
41
|
-
Pour monter : `"@indos/bibliotheque": "2.2.0"` dans ses `dependencies`, puis `npm install` et `npm test`. Pour que ses tests arrêtent la construction de son image, une app créée avant reprend le `Dockerfile` du modèle (`node_modules/@indos/bibliotheque/modeles/app-du-client/Dockerfile`), et peut retirer son `.github/workflows/ci.yml`. Les versions de React, Vite et TanStack et le core demandé ne changent pas.
|
|
42
|
-
|
|
43
|
-
## 2.1.0
|
|
44
|
-
|
|
45
|
-
« Ouvrir à part », le droit du lien public, et le direct public en lecture.
|
|
46
|
-
|
|
47
|
-
- `aPart: true` dans la déclaration des choses : `routesDesChoses` rend aussi la chose seule, hors de la coquille, au chemin de son écran suivi de `/seule` (`/<app>/<id>/seule`), avec la session et le thème, et « Ouvrir à part ↗ » y mène dans un autre onglet. Sa tête mince, `TeteDUneChoseSeule` : la marque, qui mène à l'accueil, le nom, qui se renomme d'un clic, le bloc de l'accès, l'épingle de la chose et le ⋯, où « Ouvrir dans l'OS » ramène à son écran ; puis le corps, sur la hauteur qui reste. `aPart: (chose) => adresse` reste la forme d'une adresse que l'app sert elle-même. Une app qui écrit ses routes à la main monte `ChoseSeule` sous `horsDeLaCoquille`.
|
|
48
|
-
- `estUnEcranDesChoses(chemin)`, de `@indos/bibliotheque/page`, dit au serveur de l'app les chemins de sa page, `/liste`, `/<id>` et `/<id>/seule` : il les confie à `servirLaPage`, pour qu'un rechargement de la chose seule serve la page.
|
|
49
|
-
- Le droit du lien public : `publication.droits`, les droits que le lien peut donner (`['lecture', 'modification']`) ; avec deux, « Hors de l'équipe » montre à la propriétaire le choix du droit à côté de l'adresse publique, qui appelle `publier(chose, true, confirmer, droit)`, et un refus qui demande l'accord devient la question du panneau (« Ouvrir « <nom> » en modification à toute personne qui a le lien ? »). Une ligne de `chercher` porte `droit_public`. La phrase suit le droit : par défaut « Quiconque a le lien la voit, en lecture, sans compte. » ou « Quiconque a le lien la voit et la modifie, sans compte. » ; `phrase` et `consequence` s'écrivent aussi selon le droit, `(droit) => texte`. `motsDeLaPublication(publication, declaration, droit)` les rend.
|
|
50
|
-
- Le direct sur l'hôte public : `creerLeDirectYjs({ droitPublic })`, le droit que donne le lien d'une chose publiée, `'lecture'` ou `'modification'`, ou rien pour une chose qui ne l'est pas. En lecture, la connexion ne peut pas écrire, n'écrit pas sa présence et ne reçoit pas celle des autres ; l'équipe ne la voit pas.
|
|
51
|
-
- `droitPublic` prend la place d'`estPubliee` : `droitPublic: async (id) => (publiee ? 'modification' : undefined)` garde le comportement d'une app qui ouvrait sa chose publiée en modification. Une app du client n'a pas d'hôte public, son manifeste n'ayant pas de `sousDomaine` : elle ne déclare ni l'un ni l'autre, et n'a rien à changer.
|
|
52
|
-
- `aPart` prend aussi `true` : `adresseAPart(choses, chose)` rend l'adresse de « Ouvrir à part ↗ » dans les deux formes.
|
|
53
|
-
|
|
54
|
-
Pour monter : `"@indos/bibliotheque": "2.1.0"` dans ses `dependencies`, puis `npm install` et `npm run build`. Les versions de React, Vite et TanStack et le core demandé ne changent pas.
|
|
55
|
-
|
|
56
|
-
## 2.0.0
|
|
57
|
-
|
|
58
|
-
La tête d'une chose, son partage et sa liste, les mêmes dans toutes les apps.
|
|
59
|
-
|
|
60
|
-
- La barre de gauche est toujours celle de l'OS : la barre de la liste disparaît. Un clic sur une ligne de la liste ouvre la chose dans l'aperçu, posé par-dessus la liste, à droite (`?apercu=<id>` dans la recherche de la liste) ; ↑ ↓ passent d'une chose à l'autre, Entrée l'ouvre en grand, Échap ferme ; le carré en tête de la ligne, ou un double-clic, l'ouvre en grand. L'aperçu est l'écran de la chose, le même, dans un panneau de 380 à 680 px : un corps se garde lisible en étroit. Une app qui écrit sa route de liste à la main lui donne `validateSearch: rechercheDeLaListe` et rend `ListeDesChoses`, qui monte l'aperçu. `Tableau` prend `onOuvrirEnGrand` et `ligneOuverte` ; `IconeAgrandir` et `IconeFermer` rejoignent les icônes.
|
|
61
|
-
- La ligne du haut porte les onglets de l'app : le premier au titre de l'app, puis « Réglages » et « Documentation » ; l'onglet actif est le `<h1>`, que rend la coquille. Une app sans écran fait précéder ses onglets de son titre (« Agenda / Réglages · Documentation »). L'épingle est tout à droite de la ligne, et non dans le fil.
|
|
62
|
-
- Sur une chose, le fil « App / Nom » (« App / Mandats / Nom » pour une chose qui déclare `liste`), puis à droite, et seulement, le bloc de l'accès, l'épingle et le ⋯.
|
|
63
|
-
- La ligne de tête du corps : `etatDeLaChose(chose)` à gauche, en gris (« Brouillon · échéance le 30.11.2026 ») ; à droite, « Modifier » (le `formulaire` d'une fiche) puis `gestes(chose)`, chaque geste un composant autonome qui porte sa fenêtre, sa mutation et sa relecture.
|
|
64
|
-
- Le bloc de l'accès, `BlocDeLAcces` : qui voit la chose (le cadenas, les personnes et leur nombre, le globe d'une chose publiée), puis les présents, une pastille chacun, avec le point vert ; « Reconnexion… » ou « Lecture » à sa gauche, hors du nominal seulement. Le corps déclare son direct en données, `useDeclarerLeDirect({ etat, personnes, lecture })`. Le bloc ouvre le panneau du partage ; quand l'app déclare `lirePartage` sans `partager`, comme une facture qui montre le partage de son mandat, il se lit sans s'ouvrir.
|
|
65
|
-
- Le ⋯, le même ordre dans la liste et sur la chose : Ouvrir et Ouvrir en grand (dans la liste), « Ouvrir à part ↗ » (`aPart(chose)`, une adresse que l'app sert, la chose avec la session), le rendu (`rendu(chose)`, `{ libelle, adresse }`, comme « PDF ↗ »), Partager… et Renommer (dans la liste ; Partager… quand l'app déclare `partager`), `gestesDuMenu`, Donner à…, l'épingle (dans la liste), Supprimer.
|
|
66
|
-
- Le panneau du partage a deux parties : « Dans l'équipe », et « Hors de l'équipe » quand l'app déclare `publier`, avec ses mots, `publication: { phrase, verbe, fermer, etiquette, etiquetteNonPubliee, consequence }` (par défaut « Quiconque a le lien la voit, en lecture, sans compte. », « Publier », « Ne plus publier », « Publiée ») ; publiée, l'adresse publique en lien, son icône qui la copie (« Lien public copié. ») et le lien discret qui la ferme. La colonne de la liste dit « <partage> · <etiquette> » (« Privée · Publiée »).
|
|
67
|
-
- La vue des publiées : `vuesDuPartage(feminin, { publiees: true })` à l'écran ; côté serveur, `creerLePartage({ publication: '<colonne>' })` fait entrer `publiees` dans `chercher` et dans `partage.schemaDeChercher()`.
|
|
68
|
-
|
|
69
|
-
### Ruptures
|
|
70
|
-
|
|
71
|
-
- `geste(chose)` est retiré : les gestes de l'app vont dans `gestes(chose)`, et son état dans `etatDeLaChose(chose)`, sur la ligne de tête du corps. « Modifier » y vient du `formulaire` : l'app ne rend plus `<ModifierLaFiche />` dans son corps.
|
|
72
|
-
- `pleinePage` et `libelleDeLaPleinePage` sont retirés : `rendu: (chose) => ({ libelle, adresse })` pour ce qu'on donne hors de l'écran (un PDF, un QR code), ou `aPart: (chose) => adresse` pour la chose elle-même hors du cadre, avec la session (le lecteur d'une présentation).
|
|
73
|
-
- `sousLigne` est retiré : l'aperçu montre la chose.
|
|
74
|
-
- `DansLEtatDuDirect` est retiré : le corps déclare son direct par `useDeclarerLeDirect({ etat, personnes, lecture })`, que le bloc de l'accès dessine. `EtatEtPresences` reste dans `@indos/bibliotheque/ui`, pour une page hors de l'espace, comme celle d'un invité.
|
|
75
|
-
- `DansLesGestes` n'est plus exporté : rien de l'app n'entre dans la ligne du haut.
|
|
76
|
-
- `Ecran.action` est retiré : les gestes d'un onglet vont dans son contenu.
|
|
77
|
-
- `coquilleDesReglages` est retirée : la route des réglages se déclare sous `coquilleDeLEspace`. `staticData: { pleineLargeur: true }` est retiré : `pleineHauteur`. `heureDeSuisse` est retirée : `jourEtHeure`, de `@indos/bibliotheque/format`.
|
|
78
|
-
- `PastilleDeLAcces` est retirée : `BlocDeLAcces`.
|
|
79
|
-
- Les mots de `publication` sont `phrase`, `verbe`, `fermer`, `etiquette`, `etiquetteNonPubliee` et `consequence` : `titre` est retiré.
|
|
80
|
-
- Les mots par défaut de la publication sont « Publier », « Ne plus publier », la phrase « Quiconque a le lien la voit, en lecture, sans compte. » et l'étiquette « Publiée » : un test qui cherchait « Ouvrir le lien », « Fermer le lien » ou « Par un lien » les cherche par ces mots.
|
|
81
|
-
- « Partager… », dans le ⋯ d'une ligne, ne s'offre que si l'app déclare `partager` : une app qui déclare `lirePartage` seul n'a plus d'entrée pour ouvrir le panneau en lecture depuis la liste ; le bloc de l'accès de l'aperçu et de l'écran se lit sans s'ouvrir.
|
|
82
|
-
- Un test qui ouvrait une chose d'un clic sur sa ligne clique « Ouvrir « <nom> » en grand », ou lit l'aperçu (`complementary`, « Aperçu ») ; le titre d'un onglet se lit dans la ligne du haut (`navigation`, « Onglets ») ; le fil d'une chose est « App / Nom ».
|
|
83
|
-
- Les versions de React (19.3.1), Vite (8.3.5) et TanStack (`@tanstack/react-router` 1.170.44, `@tanstack/react-query` 5.104.2) ne changent pas ; `npm view @indos/bibliotheque@2.0.0 peerDependencies` les donne toutes.
|
|
84
|
-
- Le core 2.4 ou plus récent, dans sa majeure 2 : `"core": ">=2.4 <3"` dans `dependances.core` du `module.json` de l'app.
|
|
85
|
-
- Pour monter : `"@indos/bibliotheque": "2.0.0"` dans ses `dependencies`, puis `npm install` et `npm run build`.
|
|
86
|
-
|
|
87
|
-
## 1.13.0
|
|
88
|
-
|
|
89
|
-
- Le direct Yjs, écrit une fois pour toutes les apps où l'on écrit une chose à plusieurs, dans sa propre entrée : `@indos/bibliotheque/direct` pour le serveur, `creerLeDirectYjs`, et `@indos/bibliotheque/direct/page` pour la page, `ouvrirUnDirectYjs`. L'app donne le droit d'une personne sur une chose, sa chose publiée, l'état en base et son écriture ; la bibliothèque fait le contrôle à l'ouverture, sous le domaine comme sur l'hôte public, la taille des messages, le battement, la relecture du droit après un partage, un don ou une suppression, la chose pleine, l'écriture de Claude, la reconnexion et « réessayez ».
|
|
90
|
-
- La présence est écrite par le serveur : chaque onglet porte la personne de sa session, ou le prénom borné d'un invité, et une page ne peut plus prendre le nom d'une autre personne. `personnesDesAutres` en tire les présences d'`EtatEtPresences`, `ongletsDesAutres` chaque onglet avec ce que l'app y met, comme un curseur.
|
|
91
|
-
- Ce qu'une personne tape pendant que le direct se rouvre au droit qui a baissé n'est pas enregistré : la page le sait (`nonEnregistre`) et le dit, « Ce que vous venez d'écrire n'est pas enregistré : ce document ne vous est plus ouvert qu'en lecture. » (`texteDeCeQuiNEstPasEnregistre`). `texteDUnRefusDuDirect` dit un autre refus du direct.
|
|
92
|
-
- yjs, y-protocols et Hocuspocus sont des dépendances de la bibliothèque, à version exacte, en une seule copie dans la page.
|
|
93
|
-
- `@indos/bibliotheque/fichiers-d-une-chose`, `@indos/bibliotheque/remplacements`, `@indos/bibliotheque/signaux` : les fichiers d'une chose, ses remplacements et ses signaux, communs à Pages et Présentations.
|
|
94
|
-
- Une chose hors de la liste de son app, comme un mandat de la facturation, déclare sa liste (`liste`) : le fil dit « Facturation / Mandats / <titre> », et la supprimer ou la donner depuis son écran y ramène.
|
|
95
|
-
- Une app qui déclare plusieurs sortes de choses, comme les factures et les mandats de la facturation, les distingue (`sorte`) : deux choses de sortes différentes et de même identifiant ne se mêlent pas à l'écran.
|
|
96
|
-
- Une panne pendant un formulaire envoyé en `POST` par le navigateur (`Sec-Fetch-Mode: navigate`) rend la page simple, et non une erreur JSON.
|
|
97
|
-
- Les aides des tests d'une app : `servirLApp`, `connecter` et `appeler` dans `@indos/bibliotheque/faux-core` ; la session, le serveur d'essai, la page à l'essai et le test commun des réglages des comptes dans `@indos/bibliotheque/espace-d-essai`.
|
|
98
|
-
|
|
99
|
-
### Ruptures
|
|
100
|
-
|
|
101
|
-
- `@modelcontextprotocol/client` devient une dépendance de pair, à la version 2.3.1 : une app qui le cite dans ses `devDependencies` le retire, ou le met à cette version ; sinon npm refuse l'installation.
|
|
102
|
-
- Une app qui écrit elle-même en Yjs prend le `yjs` de la bibliothèque, sans en citer un autre.
|
|
103
|
-
- Les versions de React, Vite et TanStack ne changent pas ; `npm view @indos/bibliotheque@1.13.0 peerDependencies` les donne toutes.
|
|
104
|
-
- Pour monter : `"@indos/bibliotheque": "1.13.0"` dans ses `dependencies`, puis `npm install` et `npm run build`.
|
|
105
|
-
|
|
106
|
-
## 1.12.0
|
|
107
|
-
|
|
108
|
-
- Le direct à l'écran, le même dans toutes les apps où l'on écrit une chose à plusieurs. `EtatEtPresences` (`etat`, `lectureSeule`, `moi`, `autres`) dit l'état en quatre mots, « Connexion… », « En direct » avec le point à l'accent, « Reconnexion… » en gris, et « · Lecture seule », puis une pastille par personne : une seule quel que soit le nombre de ses onglets, la sienne d'abord, même seule, cinq puis « +n », le nom au survol, « (invité) » pour un invité.
|
|
109
|
-
- `DansLEtatDuDirect` pose l'état et les présences en haut à droite de l'écran d'une chose, avant son geste propre, depuis son corps.
|
|
110
|
-
- `@indos/bibliotheque/presence` : `couleurDe(id)`, la couleur d'une personne tirée de son identifiant, la même à la page et au serveur, dans toutes les apps, lisible en clair et en sombre.
|
|
111
|
-
- L'étiquette du nom d'une autre personne, sur son curseur, sa flèche ou sa cellule : `EtiquetteDuNom` en React, `elementDeLEtiquetteDuNom(id, nom)` dans le DOM, la même forme partout.
|
|
112
|
-
- Les gestes du direct : `useAnnoncerLeDroitQuiBaisse(lecture, { une, feminin })` annonce une fois « Ce tableau ne vous est plus ouvert qu'en lecture. » ; `useMontrerLaChoseIntrouvable(app)` montre l'écran commun d'une chose introuvable à la place d'une chose fermée ; `rechargerLaPage()` mène une session fermée à la connexion.
|
|
113
|
-
- `texteDUneChoseAbsente` s'importe aussi de `@indos/bibliotheque/ui`, pour une page hors de l'espace.
|
|
114
|
-
- Supprimer par le ⋯ s'annonce avec le nom de la chose : « Le document « Plan » est supprimé. », sauf quand l'app déclare `motsDeLaSuppression(chose).fait`.
|
|
115
|
-
- Le refus de `donnerLesChoses` pour une personne encore active se lit sans accord de genre : « Rien n'est donné : le compte de Léa (lea@exemple.ch) est encore actif. »
|
|
116
|
-
|
|
117
|
-
### Ruptures
|
|
118
|
-
|
|
119
|
-
- Aucun geste dans le code de l'app.
|
|
120
|
-
- Les versions de React, Vite et TanStack ne changent pas ; `npm view @indos/bibliotheque@1.12.0 peerDependencies` les donne toutes.
|
|
121
|
-
- Pour monter : `"@indos/bibliotheque": "1.12.0"` dans ses `dependencies`, puis `npm install` et `npm run build`.
|
|
122
|
-
|
|
123
|
-
## 1.11.0
|
|
124
|
-
|
|
125
|
-
- Trouver et chercher une chose partagée, une fois pour toutes les apps : `creerLePartage` prend `colonnes`, `nom`, `cherche`, `ordre` et, pour des choses rangées les unes dans les autres, `racine`, et rend `trouver` (la chose ouverte à la personne avec son droit, ou rien, un identifiant qui n'est pas un UUID compris), `lire` (la chose avec le droit demandé, sinon le refus d'une chose absente) et `chercher` (le texte sans accents ni casse, les vues `toutes`, `a_moi`, `partagees`, la page et le total), avec `schemaDeChercher` pour l'outil.
|
|
126
|
-
- Une chose peut naître ouverte : `aLaCreation: { avec: 'equipe', droit }` dans `creerLePartage`, posée par `ouvrirALaCreation(client, id)` dans la transaction de la création. Sans elle, une chose naît privée.
|
|
127
|
-
- Donner une chose : `donner` passe une chose de son propriétaire à une autre personne active, avec son accord ; son partage reste. `donnerLesChoses` et l'outil entier `outilDeDonnerLesChoses` donnent toutes les choses d'une personne désactivée, au propriétaire du serveur seul, l'annuaire relu au core. Schémas : `schemaDeDonner`, `schemaDeDonnerLesChoses`.
|
|
128
|
-
- `auProprietaireDuServeur` : le droit qu'a le propriétaire du serveur sur toutes les choses d'une app qui le déclare.
|
|
129
|
-
- L'annuaire dit le propriétaire du serveur (`proprietaire`) ; `lireLAnnuaire({ sansCache: true })` le relit au core.
|
|
130
|
-
- « Donner à… » dans le ⋯ d'une chose, à sa propriétaire, quand l'app déclare `donner` : une fenêtre où choisir une personne active de l'équipe, puis « Donner ».
|
|
131
|
-
- Le panneau du partage annonce chaque geste fait en bas de l'écran, en phrase complète (« Léa a accès à « Devis » en modification. »), hors du panneau.
|
|
132
|
-
- Sur un téléphone, une cellule vide d'un tableau empilé ne se montre pas, ni le titre de sa colonne.
|
|
133
|
-
- Le surtitre d'un `Panneau` prend le titre commun d'une section, à l'encre, sans petites capitales grises.
|
|
134
|
-
- Une `Fenetre` ou une `Confirmation` plus haute que l'écran défile à la molette et au pavé, son contenu défilant lui-même ; sur un téléphone, une fenêtre tient toute la hauteur au plus.
|
|
135
|
-
|
|
136
|
-
### Ruptures
|
|
137
|
-
|
|
138
|
-
- `creerLePartage` demande le pool de l'app (`pg.Pool`) dans `base`, pour donner dans une transaction.
|
|
139
|
-
- Un test qui lisait le message d'un geste du panneau du partage le lit dans l'annonce, hors du panneau, à sa phrase complète : « Le lien de « Devis » est ouvert. », « Léa n'a plus accès à « Devis ». ».
|
|
140
|
-
- Les versions de React, Vite et TanStack ne changent pas ; `npm view @indos/bibliotheque@1.11.0 peerDependencies` les donne toutes.
|
|
141
|
-
- Pour monter : `"@indos/bibliotheque": "1.11.0"` dans ses `dependencies`, puis `npm install` et `npm run build`.
|
|
142
|
-
|
|
143
|
-
## 1.10.0
|
|
144
|
-
|
|
145
|
-
- Le formulaire d'une fiche : `formulaire` dans la déclaration des choses (`champs`, un composant qui rend les champs, vides ou remplis, `presentation`, `creer`, `modifier`, `peutModifier`). « Nouveau … » ouvre une fenêtre « Nouveau contact », ses champs, « Annuler » et « Créer » ; la fiche créée s'ouvre, la liste à gauche. « Modifier », en haut à droite de l'écran d'une fiche, ouvre la même fenêtre remplie, avec « Enregistrer ». Un refus se lit sous les champs, mot pour mot, la saisie gardée. Une fiche qui a un geste propre plus fort (`geste`) met « Modifier » dans son corps : `<ModifierLaFiche choses={…} chose={…} />`. `FormulaireDUneFiche` est la fenêtre seule.
|
|
146
|
-
- La confirmation d'un geste définitif : `ConfirmationDUnGeste` (`appel`, `question`, `declencheur`, `arguments`, `retour`) pose la question de l'app, sa conséquence, « Annuler » et le verbe suivi de son objet. Avec un déclencheur, elle s'ouvre d'abord, puis l'outil part avec `confirmer: true` ; sans lui, le refus de l'outil qui demande l'accord devient la question, et son texte, écrit pour Claude, ne se montre pas. Un autre refus se lit mot pour mot. `demandeLAccord(erreur)` reconnaît ce refus.
|
|
147
|
-
- La suppression du ⋯ prend les mots que l'app déclare (`motsDeLaSuppression` : la question, la conséquence, le verbe, l'annonce). Après une suppression dans la liste, le focus va à la ligne voisine, sinon à la recherche.
|
|
148
|
-
- `Confirmation` prend `sorte` : `principal` pour un geste définitif qui ne détruit rien, comme émettre ; `detruit` par défaut.
|
|
149
|
-
- Les états d'un écran : `EtatDeLecture`, « Chargement… » en gris après 300 ms, dans la coquille, la liste et l'écran d'une chose ; `SansResultat` et `texteSansResultat`, « Aucune facture ne correspond à « zzz ». », en gris, sans tableau, dans la liste et sa barre. Une liste vide dit la phrase de l'app (`vide`), sans tableau.
|
|
150
|
-
- L'annonce d'un geste (`useAnnoncer`) passe par-dessus une fenêtre ou un panneau ouvert.
|
|
151
|
-
- `MenuDUneLigne` : le ⋯ d'une ligne, ses gestes en groupes, à poser dans la colonne sans titre d'un `Tableau`, qui la rend étroite. `GesteDuMenu` prend `detruit`, `inactif` et `nouvelOnglet`. Une vue de la liste (`VueDeLaListe`) prend `nombre`.
|
|
152
|
-
- `Bouton` : `taille` vaut pour toutes les sortes ; un bouton discret `taille="petite"` fait 32 px, comme les autres.
|
|
153
|
-
- `Colonnes` et `Barres`, sans `format`, gardent deux décimales à une valeur qui n'est pas entière (« 7.50 »).
|
|
154
|
-
|
|
155
|
-
### Ruptures
|
|
156
|
-
|
|
157
|
-
- Aucun geste dans le code de l'app. Un test qui cherchait une liste vide ou une recherche sans résultat dans le tableau la trouve en texte, hors du tableau ; la barre de la liste dit « Aucune chose ne correspond à « … ». » pour une recherche.
|
|
158
|
-
- Les versions de React, Vite et TanStack ne changent pas ; `npm view @indos/bibliotheque@1.10.0 peerDependencies` les donne toutes.
|
|
159
|
-
- Pour monter : `"@indos/bibliotheque": "1.10.0"` dans ses `dependencies`, puis `npm install` et `npm run build`.
|
|
160
|
-
|
|
161
|
-
## 1.9.0
|
|
162
|
-
|
|
163
|
-
- En haut à droite d'un écran, il n'y a que ce qui touche la chose ouverte : son geste propre, sa pleine page et son ⋯. La liste commune pose ses gestes (`gestesDeLaListe`) puis « Nouveau … » à droite de sa recherche, le bouton principal en dernier ; sous 760 px, sous la recherche. L'écran des comptes pose « Brancher un … » dans son contenu, au-dessus des comptes ; `#brancher` mène toujours au formulaire.
|
|
164
|
-
- `Recherche` : la ligne de la recherche d'une liste, avec ses gestes de création à droite (`gestes`). `Vues` prend de même `gestes`, pour une liste sans recherche.
|
|
165
|
-
- `@indos/bibliotheque/format` : `jour`, `jourEtHeure`, `tempsEcoule`, à l'heure de Zurich, `nombre` et `montant`, à l'apostrophe droite des milliers (« CHF 12'400.00 »). La liste, les vues, la pagination, `Tableau` et les graphiques les prennent : un nombre s'écrit « 1'234 » dans tous les navigateurs. `heureDeSuisse` est l'autre nom de `jourEtHeure`.
|
|
166
|
-
- `@indos/bibliotheque/sans-accents` : `sansAccents(texte)` en JavaScript, `sansAccentsEnSql(expression)` et `motifSansAccents(texte)` en SQL, la recherche sans accents ni casse.
|
|
167
|
-
- Sur un téléphone, jusqu'à 760 px, un tableau empile chaque ligne en commençant par les colonnes déclarées `tete: true` (la première colonne sans déclaration), la colonne sans titre en haut à droite, puis les autres avec leur titre. `colonnes` d'une liste commune prend aussi `tete`.
|
|
168
|
-
- `ChosePleine` (`une`, `feminin`, `geste`) : le message neutre d'une chose pleine, « Ce document est plein : ce que vous ajoutez ne s'enregistre plus. », suivi du geste de l'app.
|
|
169
|
-
- `TitreDeSection`, le titre d'une section sans carte, le même que celui de `Section` ; `largeurDUnFormulaire` (720 px) et `largeurDeLaRecherche` (360 px) ; `Bouton taille="petite"` (32 px) ; `Choix` prend `taille` et, par son champ, `libelleMasque`.
|
|
170
|
-
- La vue de la barre de la liste et le droit d'une ouverture, dans le panneau du partage, sont des `Choix`.
|
|
171
|
-
- Les tests de la page (`page-de-l-espace tester`) chargent les doubles de ce que jsdom n'a pas et que Radix demande (`ResizeObserver`, la capture du pointeur, `scrollIntoView`) : une liste de choix s'y ouvre sans copie dans l'app.
|
|
172
|
-
- `Ecran` accepte toujours `action`, qui se retire dans la prochaine version majeure : un geste de création va dans `Recherche`, un autre dans le contenu.
|
|
173
|
-
- Côté serveur : `demarrerLApp` (`@indos/bibliotheque/app`), le démarrage et l'arrêt d'une app ; `enTransaction` (`@indos/bibliotheque/base`) ; `prendreUnFichier` (`@indos/bibliotheque/fichiers`) ; `ouvrirUnFlux` (`@indos/bibliotheque/flux`) ; `identifiant` et `schemaDUnUuid` (`@indos/bibliotheque/identifiant`) ; `enBase64` et `fichierEnBase64` (`@indos/bibliotheque/espace`). Une app qui ne les prend pas ne change pas.
|
|
174
|
-
|
|
175
|
-
### Ruptures
|
|
176
|
-
|
|
177
|
-
- Aucun geste dans le code de l'app. Un test qui cherchait « Nouveau … » ou « Brancher un … » dans les gestes du cadre les trouve dans le contenu. Un test qui choisissait la vue de la barre de la liste par `selectOptions` clique le `combobox` « Vue », puis l'`option`. Un test qui attendait un nombre écrit par `Intl` (« 1’240 ») lit « 1'240 ».
|
|
178
|
-
- Les versions de React, Vite et TanStack ne changent pas ; `npm view @indos/bibliotheque@1.9.0 peerDependencies` les donne toutes.
|
|
179
|
-
- Pour monter : `"@indos/bibliotheque": "1.9.0"` dans ses `dependencies`, puis `npm install` et `npm run build`.
|
|
180
|
-
|
|
181
|
-
## 1.8.0
|
|
182
|
-
|
|
183
|
-
- Chaque écran de l'app a le même cadre, dessiné par la coquille : en haut, le fil d'Ariane, qui est le titre de l'écran (« <app> / <onglet> », puis le titre d'un écran qui n'est pas un onglet), l'épingle au bout du fil, et les gestes de l'écran à droite ; dessous, les onglets de l'app ; puis le contenu, sur toute la largeur. Il n'y a plus d'en-tête d'app ni de version au pied.
|
|
184
|
-
- `Ecran` garde ses propriétés : `titre` fait le dernier segment du fil, `action` va en haut à droite, `presentation` est la première ligne du contenu. Deux propriétés nouvelles : `largeur: 'lecture'` borne le contenu à 720 px, pour un texte ou un formulaire ; `apresLeTitre` suit le titre dans le fil, comme un nombre en gris.
|
|
185
|
-
- `DansLeFil` et `DansLesGestes` rendent un nœud à la fin du fil ou dans les gestes de l'écran, pour un écran qui n'est pas un `Ecran`.
|
|
186
|
-
- Un écran dont le contenu descend jusqu'au bas de la fenêtre, comme une toile, se déclare par `staticData: { pleineHauteur: true }` ; `pleineLargeur` reste son autre nom.
|
|
187
|
-
- Les vues (`Vues`) sont des pastilles, l'active en carte bordée.
|
|
188
|
-
- L'écran d'une chose : le nom se renomme d'un clic quand l'app déclare `renommer` ; la pastille de l'accès (`PastilleDeLAcces`), à côté du nom, dit qui voit la chose et ouvre le partage ; ses gestes sont le geste propre, la pleine page et le ⋯, réduit à ce que l'écran ne montre pas ailleurs.
|
|
189
|
-
- Une chose ouverte depuis sa liste garde la liste à gauche, à la place de la barre de l'OS, avec « ‹ <liste> ». `sousLigne(chose)`, dans la déclaration des choses, donne la seconde ligne de chaque chose dans cette liste, la date par défaut.
|
|
190
|
-
- En bas de la barre, les neuf points ouvrent « Toutes les apps » ; « Configurer l'espace » est dans le menu du nom.
|
|
191
|
-
- `IconeDEpingle` et `IconeDesApps`, dans `@indos/bibliotheque/ui`.
|
|
192
|
-
|
|
193
|
-
### Ruptures
|
|
194
|
-
|
|
195
|
-
- Aucun geste dans le code de l'app. Un test qui lit le `<h1>` d'un onglet le trouve au titre de l'onglet (« Réglages » sur les réglages) ; un test qui lisait la version au pied de l'écran ou l'en-tête de l'app ne la trouve plus.
|
|
196
|
-
- Les versions de React, Vite et TanStack ne changent pas ; `npm view @indos/bibliotheque@1.8.0 peerDependencies` les donne toutes.
|
|
197
|
-
- Pour monter : `"@indos/bibliotheque": "1.8.0"` dans ses `dependencies`, puis `npm install` et `npm run build`.
|
|
198
|
-
|
|
199
|
-
## 1.7.0
|
|
200
|
-
|
|
201
|
-
- Une chose rangée dans une autre, comme un sous-document : `ancetres(chose)`, dans la déclaration des choses, rend ses ancêtres, `[{ nom, chemin }]`, de la racine à son parent. Le fil d'Ariane de son écran passe par chacun, en lien ; la liste les nomme sous son nom (« Manuel › Faire un devis ») ; elle suit le partage de sa racine, sans « Partager » sur son écran ni dans son menu.
|
|
202
|
-
- Supprimée depuis son écran, une chose rangée dans une autre ramène à son parent, le dernier de ses ancêtres ; une autre chose, à la liste telle qu'on l'a quittée.
|
|
203
|
-
- `gestesDuMenu(chose, { surLEcran, annoncer })` : les gestes propres du menu ⋯, après Renommer, chacun un geste (`choisir`), un lien (`lien`, téléchargé avec `telecharger`) ou une fenêtre (`fenetre`), que le menu ouvre hors de lui et qui rend le focus au ⋯.
|
|
204
|
-
- `consequenceDeLaSuppression` peut dépendre de la chose : une fonction qui rend la phrase, ou rien.
|
|
205
|
-
- `cleDesChoses(app, 'chose', id)` est la clé de la chose lue sur son écran : l'app la retouche (`setQueryData`) pour que la barre fine suive un geste sans relecture, comme un nom qui suit la frappe.
|
|
206
|
-
- Pour monter : `"@indos/bibliotheque": "1.7.0"` dans ses `dependencies`, puis `npm install` et `npm run build`.
|
|
207
|
-
|
|
208
|
-
## 1.6.0
|
|
209
|
-
|
|
210
|
-
- `gestesDeLaListe`, dans la déclaration des choses : les gestes propres de la liste, rendus juste avant « Nouveau … », comme « Importer un .xlsx ».
|
|
211
|
-
- L'écran d'une chose garde la chose déjà lue quand une relecture échoue par une panne, l'app qui redémarre par exemple : l'erreur de l'écran ne vient qu'à la première lecture.
|
|
212
|
-
- Pour monter : `"@indos/bibliotheque": "1.6.0"` dans ses `dependencies`, puis `npm install` et `npm run build`.
|
|
213
|
-
|
|
214
|
-
## 1.5.0
|
|
215
|
-
|
|
216
|
-
- Le panneau du partage pose sa propre question quand un partage s'élargit ou qu'une chose se publie : ce qui s'ouvre, à qui, avec quel droit (« Ouvrir « Devis » à toute l'équipe, en lecture ? »), en neutre, avec « Annuler » et le verbe exact. Le texte du refus, écrit pour Claude, ne s'y lit plus ; un autre refus reste en erreur.
|
|
217
|
-
- La publication se déclare dans `publication`, chaque mot facultatif : `titre` (« Par un lien »), `verbe`, le geste qui ouvre le lien (« Ouvrir le lien »), `fermer` (« Fermer le lien »), `consequence` (« Toute personne qui a le lien y accède, sans compte. »). `motsDeLaPublication` rend ces mots, leurs défauts compris.
|
|
218
|
-
- `consequenceDeLaSuppression`, une phrase ajoutée à ce qu'emporte la suppression ; `peutSupprimer(chose)`, si Supprimer s'offre pour une chose, à sa propriétaire par défaut.
|
|
219
|
-
- `useRelireLesChoses(app)` relit la liste et les choses de l'app, après un geste propre qui les change.
|
|
220
|
-
- Supprimée depuis son écran, une chose ramène à la liste telle qu'on l'a quittée. Le menu ⋯ ne commence plus par un séparateur ; une vue choisie pendant la frappe reste.
|
|
221
|
-
- Le faux core rend la session du core 2.4 : le lien d'une app est son premier écran, sinon ses réglages ; la barre de départ, « Bienvenue », le premier écran de chaque app au titre de l'app, puis « Journal ». Un test d'app qui lisait la barre ou le lien du faux core suit.
|
|
222
|
-
- Pour monter : `"@indos/bibliotheque": "1.5.0"` dans ses `dependencies`, puis `npm install` et `npm run build`. Une app qui déclarait `publication: { verbe: 'Publier', … }` garde son verbe.
|
|
223
|
-
|
|
224
|
-
## 1.4.0
|
|
225
|
-
|
|
226
|
-
- La liste et l'écran d'une chose, les mêmes dans toutes les apps : une app déclare ses choses (`DeclarationDesChoses`) et ses deux écrans (`routesDesChoses`), et la bibliothèque dessine la liste (`ListeDesChoses` : les vues, la recherche à la frappe, 25 lignes par page, la ligne qui ouvre la chose, le menu ⋯), l'écran d'une chose (`EcranDUneChose` : le fil d'Ariane vers la liste telle qu'on l'a quittée, l'état, « Partager », « Pleine page ↗ », puis le corps que rend l'app), son menu (`MenuDUneChose`) et le panneau de son partage (`PanneauDuPartage`). Le contrat de l'app, son écran `liste` et son outil `chercher` : `CLAUDE.md` de la bibliothèque, « Une app à choses ».
|
|
227
|
-
- Les onglets d'une app sont dans l'ordre : ses écrans, « Réglages », « Documentation ». À droite de l'en-tête, « Épingler » ajoute l'onglet ouvert à la barre de la personne.
|
|
228
|
-
- En bas de la barre, au-dessus du nom : « Toutes les apps » (`/apps`) et « Configurer l'espace » (`/reglages`).
|
|
229
|
-
- `epingler`, `desepingler` et `useEpingle`, les gestes de la barre de chacun ; `lireLAnnuaire`, l'équipe pour un écran ; `appelerUneApp`, l'outil d'une autre app de la même origine ; `horsDeLaCoquille`, le parent d'un écran sans barre ; `useAnnoncer`, un geste fait annoncé en bas de l'écran.
|
|
230
|
-
- `Tableau` prend `onOuvrirLigne`, une ligne qui s'ouvre d'un clic ; `Fenetre`, `Confirmation` et `Panneau` prennent `retour`, où revient le focus quand ils sont tenus depuis l'écran.
|
|
231
|
-
|
|
232
|
-
### Ruptures
|
|
233
|
-
|
|
234
|
-
- Les gestes de la barre, « Toutes les apps » et « Configurer l'espace » demandent le core 2.4.0 : bornez le core de l'app à `"core": ">=2.4 <3"` dans `module.json`.
|
|
235
|
-
- Un test de l'app qui lit les onglets de l'en-tête (`<nav aria-label="Onglets">`) les trouve dans leur nouvel ordre : ses écrans, « Réglages », « Documentation ».
|
|
236
|
-
- Les versions de React, Vite et TanStack ne changent pas ; `npm view @indos/bibliotheque@1.4.0 peerDependencies` les donne toutes.
|
|
237
|
-
- Pour monter : `"@indos/bibliotheque": "1.4.0"` dans ses `dependencies`, puis `npm install` et `npm run build`.
|
|
238
|
-
|
|
239
|
-
## 1.3.0
|
|
240
|
-
|
|
241
|
-
- La page de l'espace a une seule coquille, celle de l'espace : les réglages d'une app s'y rendent comme ses écrans. `coquilleDesReglages` reste exportée, comme autre nom de `coquilleDeLEspace` : une app qui y déclare ses réglages marche sans rien changer. Ce nom se retirera dans une version majeure ; déclarez la route de vos réglages sous `coquilleDeLEspace`.
|
|
242
|
-
- Sur chaque page d'une app, au-dessus de l'écran, l'en-tête de l'app : son titre et ses onglets, « Documentation » (`/documentation/<app>`, servie par le core), « Réglages » quand la personne peut les voir, et un onglet par écran. Il se dessine depuis la session : rien à déclarer dans la page.
|
|
243
|
-
- Sur une page d'une app, `Ecran` n'a pas de surtitre par défaut : l'en-tête de l'app porte son titre.
|
|
244
|
-
- Le menu sous le nom de la personne : son courriel, « Mon compte », « Équipe » pour le propriétaire, « Se déconnecter ».
|
|
245
|
-
- Un écran en pleine largeur (`staticData: { pleineLargeur: true }`) est une colonne qui descend jusqu'au bas de la fenêtre : un bloc en `flex-1 min-h-0` prend la hauteur qui reste.
|
|
246
|
-
- `appDuChemin` et `ongletsDe` donnent l'app d'une page et ses onglets.
|
|
247
|
-
- `lancerLeFauxCore` prend des réglages au propriétaire seul, `reglages: { pour: 'proprietaire' }`.
|
|
248
|
-
- La carte de l'app sur l'accueil, son logo et sa documentation se déclarent à la racine de son dépôt : `description` dans `module.json`, `logo.svg` et `DOCUMENTATION.md` à côté, tous facultatifs. Ils demandent le core 2.3.0 et le kit 0.27.0.
|
|
249
|
-
- Rien à changer dans l'app pour monter : `"@indos/bibliotheque": "1.3.0"` dans ses `dependencies`, puis `npm install` et `npm run build`. Un test qui vérifiait la barre des réglages lit l'onglet « Réglages » de l'en-tête (`<nav aria-label="Onglets">`).
|
|
250
|
-
|
|
251
|
-
## 1.2.0
|
|
252
|
-
|
|
253
|
-
- La page de l'espace s'affiche d'emblée avec sa barre, d'une page à l'autre comme d'une app à une autre : `servirLaPage` écrit dans la page la session de la personne, dans la forme de `/espace/session` (`<meta name="indos-session">`, échappée), et la page se rend avec elle dès son script, sans attendre le réseau, puis relit `/espace/session` en arrière-plan, ce qui prolonge la session.
|
|
254
|
-
- `creerLaSession()` donne `sessionDe(requete)`, cette session pour la page ; son type est `SessionEcriteDansLaPage`. Une app qui passe à `servirLaPage` sa propre session avec `personneDe` (`SessionDeLaPage`, inchangé) est servie comme avant, sans la session écrite.
|
|
255
|
-
- `lancerLaPage` rend une fonction qui démonte la page, pour un test.
|
|
256
|
-
- Un écran qui attend ses données (`useSuspenseQuery`) laisse la barre affichée.
|
|
257
|
-
- Rien à changer dans l'app pour monter : `"@indos/bibliotheque": "1.2.0"` dans ses `dependencies`, puis `npm install` et `npm run build`.
|
|
258
|
-
|
|
259
|
-
## 1.1.1
|
|
260
|
-
|
|
261
|
-
- `@indos/bibliotheque/app` : le serveur de l'app garde ouverte une connexion inactive 95 s, au-delà des 90 s du proxy de Coolify, qui peut y envoyer la requête suivante : elle est servie.
|
|
262
|
-
- Rien à changer dans l'app pour monter : `"@indos/bibliotheque": "1.1.1"` dans ses `dependencies`, puis `npm install`.
|
|
263
|
-
|
|
264
|
-
## 1.1.0
|
|
265
|
-
|
|
266
|
-
- `@indos/bibliotheque/fichiers` : un fichier déposé par `deposerUnFichier` avec `entreprise: true` entre comme une pièce de l'entreprise, que lit toute personne de l'équipe qui a son identifiant et qui ne se supprime pas. `donnerALEntreprise(appeler, personne, id)` fait d'une fiche de la personne une pièce de l'entreprise. La fiche rendue dit `entreprise`. Les deux demandent fichiers 1.7 ou plus récent sur le serveur.
|
|
267
|
-
- Rien à changer dans l'app pour monter : `"@indos/bibliotheque": "1.1.0"` dans ses `dependencies`, puis `npm install`.
|
|
268
|
-
|
|
269
|
-
## 1.0.0
|
|
270
|
-
|
|
271
|
-
La première version publiée sur npm. Elle donne à une app du client ce qu'une app du catalogue d'Indos a, par ses entrées :
|
|
272
|
-
|
|
273
|
-
- `@indos/bibliotheque/app` : le serveur HTTP de l'app, qui répond sur `/sante` et se ferme proprement.
|
|
274
|
-
- `@indos/bibliotheque/base` : la base de l'app, par `DATABASE_URL`, et ses migrations `.sql`, appliquées au démarrage, chacune une fois.
|
|
275
|
-
- `@indos/bibliotheque/mcp` : le MCP de l'app pour Claude, et les mêmes outils pour ses écrans. Le jeton du core est vérifié à chaque requête ; chaque personne ne voit que les outils qui lui sont permis.
|
|
276
|
-
- `@indos/bibliotheque/jeton` et `@indos/bibliotheque/session` : la personne connectée, par le jeton du core ou par sa session dans l'espace, avec ses groupes et les apps qui lui sont ouvertes.
|
|
277
|
-
- `@indos/bibliotheque/page`, `@indos/bibliotheque/espace`, `@indos/bibliotheque/ui` et `@indos/bibliotheque/ui/theme.css` : la page de l'espace en React, sa coquille, ses composants et sa feuille, au thème du client. La commande `page-de-l-espace` la construit (`construire`), la sert à chaud (`developper`) et lance ses tests (`tester`).
|
|
278
|
-
- `@indos/bibliotheque/appeler` : l'appel aux outils d'une autre app, par le core.
|
|
279
|
-
- `@indos/bibliotheque/fichiers` : déposer un fichier dans les fichiers d'une personne, et en lire un.
|
|
280
|
-
- `@indos/bibliotheque/compte` : un compte branché, son secret chiffré, et les gestes de l'écran commun des comptes.
|
|
281
|
-
- `@indos/bibliotheque/partage` : une chose de l'app ouverte à des personnes, à des groupes ou à toute l'équipe, en lecture ou en modification.
|
|
282
|
-
- `@indos/bibliotheque/theme` : le thème du client, ses polices comprises, et son logo.
|
|
283
|
-
- `@indos/bibliotheque/liens`, `@indos/bibliotheque/deriver` et `@indos/bibliotheque/type-de-fichier` : les liens signés valables dix minutes, les sous-clés de la clé de l'app, et le type d'un fichier qui entre.
|
|
284
|
-
- `@indos/bibliotheque/ecran` : la page simple rendue par le serveur, pour une page introuvable ou une erreur.
|
|
285
|
-
- `@indos/bibliotheque/faux-core` et `@indos/bibliotheque/base-d-essai` : pour les tests, un faux core et une vraie Postgres en mémoire.
|
|
286
|
-
|
|
287
|
-
### Ruptures
|
|
288
|
-
|
|
289
|
-
- Le geste : `"@indos/bibliotheque": "1.0.0"` dans les `dependencies` de l'app, à version exacte, puis `npm install`. L'app ne liste aucune des dépendances de pair : npm les installe aux versions de la bibliothèque.
|
|
290
|
-
- React et React DOM 19.3.1.
|
|
291
|
-
- Vite 8.3.5, avec `@vitejs/plugin-react` 6.1.2.
|
|
292
|
-
- TanStack Router (`@tanstack/react-router`) 1.170.44 et TanStack Query (`@tanstack/react-query`) 5.104.2.
|
|
293
|
-
- Les autres dépendances de pair (Tailwind, Radix, Vitest, Testing Library…), à version exacte elles aussi : `npm view @indos/bibliotheque@1.0.0 peerDependencies`. Une app qui en cite une la cite à cette version.
|
|
294
|
-
- Node 24 ou plus récent.
|
|
295
|
-
- Le core 1.8 ou plus récent, dans ses majeures 1 et 2 : `"core": ">=1.8 <3"` dans `dependances.core` du `module.json` de l'app.
|
package/bin/bibliotheque.d.ts
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
export {};
|
package/bin/bibliotheque.js
DELETED
|
@@ -1,62 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
// La commande du paquet publié, celle que npx lance par le nom du paquet, sans l'installer
|
|
3
|
-
// (bibliotheque/CLAUDE.md, « Une app du client ») :
|
|
4
|
-
//
|
|
5
|
-
// npx @indos/bibliotheque creer-une-app <nom> [<dossier>]
|
|
6
|
-
//
|
|
7
|
-
// copie le modèle d'une app du client, que le paquet porte (`modeles/app-du-client/`), dans un
|
|
8
|
-
// dossier neuf, `./<nom>` par défaut : le `nom` posé dans `module.json` et dans les liens de
|
|
9
|
-
// `DOCUMENTATION.md`, `@indos/bibliotheque` cité dans `package.json` à la version du paquet. Elle
|
|
10
|
-
// refuse un dossier qui existe et un nom qui n'est pas en minuscules, chiffres et tirets.
|
|
11
|
-
import { cpSync, existsSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
|
|
12
|
-
import { join, resolve } from 'node:path';
|
|
13
|
-
import { fileURLToPath } from 'node:url';
|
|
14
|
-
// Le nom d'une app, comme le kit le demande dans `serveur.json` : son chemin, `/<nom>`.
|
|
15
|
-
const NOM = /^[a-z][a-z0-9-]*$/;
|
|
16
|
-
const NOM_DU_MODELE = 'app-du-client';
|
|
17
|
-
function refuser(message) {
|
|
18
|
-
console.error(message);
|
|
19
|
-
process.exit(1);
|
|
20
|
-
}
|
|
21
|
-
function lireLeJson(chemin) {
|
|
22
|
-
return JSON.parse(readFileSync(chemin, 'utf8'));
|
|
23
|
-
}
|
|
24
|
-
function ecrireLeJson(chemin, valeur) {
|
|
25
|
-
writeFileSync(chemin, `${JSON.stringify(valeur, null, 2)}\n`);
|
|
26
|
-
}
|
|
27
|
-
function creerUneApp(nom, dossierDemande) {
|
|
28
|
-
if (!nom) {
|
|
29
|
-
refuser('Usage : npx @indos/bibliotheque creer-une-app <nom> [<dossier>]');
|
|
30
|
-
}
|
|
31
|
-
if (!NOM.test(nom)) {
|
|
32
|
-
refuser(`Refusé : « ${nom} » n'est pas un nom d'app : des minuscules, des chiffres et des tirets, une lettre d'abord.`);
|
|
33
|
-
}
|
|
34
|
-
const { version } = lireLeJson(fileURLToPath(new URL('../package.json', import.meta.url)));
|
|
35
|
-
if (!version) {
|
|
36
|
-
refuser('Refusé : la commande se lance depuis le paquet publié, @indos/bibliotheque, qui donne sa version au modèle.');
|
|
37
|
-
}
|
|
38
|
-
const dossier = resolve(dossierDemande ?? nom);
|
|
39
|
-
if (existsSync(dossier)) {
|
|
40
|
-
refuser(`Refusé : ${dossier} existe déjà. L'app se crée dans un dossier neuf.`);
|
|
41
|
-
}
|
|
42
|
-
cpSync(fileURLToPath(new URL(`../modeles/${NOM_DU_MODELE}/`, import.meta.url)), dossier, { recursive: true });
|
|
43
|
-
// npm ne publie aucun fichier `.gitignore` : le paquet porte le sien sous le nom `gitignore`.
|
|
44
|
-
if (existsSync(join(dossier, 'gitignore'))) {
|
|
45
|
-
renameSync(join(dossier, 'gitignore'), join(dossier, '.gitignore'));
|
|
46
|
-
}
|
|
47
|
-
const manifeste = join(dossier, 'module.json');
|
|
48
|
-
writeFileSync(manifeste, readFileSync(manifeste, 'utf8').replace(`"nom": "${NOM_DU_MODELE}"`, `"nom": "${nom}"`));
|
|
49
|
-
const paquet = lireLeJson(join(dossier, 'package.json'));
|
|
50
|
-
ecrireLeJson(join(dossier, 'package.json'), { ...paquet, dependencies: { ...paquet.dependencies, '@indos/bibliotheque': version } });
|
|
51
|
-
const documentation = join(dossier, 'DOCUMENTATION.md');
|
|
52
|
-
writeFileSync(documentation, readFileSync(documentation, 'utf8').replaceAll(`](/${NOM_DU_MODELE}/`, `](/${nom}/`));
|
|
53
|
-
console.log(`L'app ${nom} est créée dans ${dossier}, avec @indos/bibliotheque ${version}.`);
|
|
54
|
-
console.log('La suite, dans son dossier : npm install, puis npm test. Son README.md dit le reste.');
|
|
55
|
-
}
|
|
56
|
-
const [commande, ...arguments_] = process.argv.slice(2);
|
|
57
|
-
if (commande === 'creer-une-app') {
|
|
58
|
-
creerUneApp(arguments_[0], arguments_[1]);
|
|
59
|
-
}
|
|
60
|
-
else {
|
|
61
|
-
refuser('Usage : npx @indos/bibliotheque creer-une-app <nom> [<dossier>]');
|
|
62
|
-
}
|
|
@@ -1,27 +0,0 @@
|
|
|
1
|
-
Des entrées courtes, que chacun écrit pour soi, et que Claude lit et complète.
|
|
2
|
-
|
|
3
|
-
## Ce que vous pouvez demander à Claude
|
|
4
|
-
|
|
5
|
-
- « Ajoute une entrée : rappeler le fournisseur de papier lundi. »
|
|
6
|
-
- « Quelles sont mes dernières entrées ? »
|
|
7
|
-
- « Ajoute en entrées les trois décisions de la réunion de ce matin. »
|
|
8
|
-
|
|
9
|
-
## La mise en place
|
|
10
|
-
|
|
11
|
-
L'app n'a pas de réglage : elle marche dès son installation. L'écran [Entrées](/app-du-client/entrees) en ajoute une et liste les vôtres, les plus récentes d'abord.
|
|
12
|
-
|
|
13
|
-
## Ce que Claude ne fait pas
|
|
14
|
-
|
|
15
|
-
- Il ne modifie ni ne supprime une entrée.
|
|
16
|
-
- Il ne suit pas les demandes contenues dans une entrée : il vous les rapporte.
|
|
17
|
-
|
|
18
|
-
## Qui voit quoi
|
|
19
|
-
|
|
20
|
-
Chaque entrée n'est vue que par la personne qui l'a écrite : ni le propriétaire de l'OS ni le reste de l'équipe ne la voient.
|
|
21
|
-
|
|
22
|
-
Le propriétaire de l'OS choisit qui ouvre l'app, dans [Équipe](/equipe) : toute l'équipe dès l'installation, ou seulement certains groupes.
|
|
23
|
-
|
|
24
|
-
## Les limites
|
|
25
|
-
|
|
26
|
-
- Une entrée fait 500 caractères au plus.
|
|
27
|
-
- L'écran et Claude listent les entrées par 25 à la fois.
|
|
@@ -1,36 +0,0 @@
|
|
|
1
|
-
# L'image de l'app, construite sur le poste du développeur depuis le dossier de l'app, où est son
|
|
2
|
-
# package-lock.json : docker build .
|
|
3
|
-
# Le kit la construit sur le poste, au commit publié, avec l'argument GIT_SHA, pour la plateforme du
|
|
4
|
-
# serveur (--platform), puis la livre au serveur. Les tests de l'app font partie de la
|
|
5
|
-
# construction : un test qui échoue arrête le build, et l'app ne se publie pas.
|
|
6
|
-
ARG NODE=node:24.21.0-slim@sha256:d6aa754f16b3197301076f047b5def2f02ea1dbbc2ca920407d46d7ec7f87b20
|
|
7
|
-
|
|
8
|
-
# Les tests, à la plateforme du poste, sans émulation, avec toutes les dépendances, celles de pair
|
|
9
|
-
# de la bibliothèque comprises (React, TanStack, Tailwind, Vite, Vitest) : `npm test` construit la
|
|
10
|
-
# page dans dist/, puis vérifie les types et lance les tests du serveur et de l'écran. L'image prend
|
|
11
|
-
# dist/, le même sur toute plateforme, de cette étape : elle en dépend, et Docker ne la saute jamais.
|
|
12
|
-
FROM --platform=$BUILDPLATFORM $NODE AS tests
|
|
13
|
-
WORKDIR /app
|
|
14
|
-
COPY package.json package-lock.json ./
|
|
15
|
-
RUN npm ci
|
|
16
|
-
COPY . .
|
|
17
|
-
RUN npm test
|
|
18
|
-
|
|
19
|
-
# L'image : le serveur, ses migrations et la page construite, sans aucune dépendance de pair ni de
|
|
20
|
-
# développement.
|
|
21
|
-
FROM $NODE
|
|
22
|
-
WORKDIR /app
|
|
23
|
-
ENV NODE_ENV=production
|
|
24
|
-
COPY package.json package-lock.json ./
|
|
25
|
-
RUN npm ci --omit=dev --omit=peer
|
|
26
|
-
COPY module.json USAGE.md ./
|
|
27
|
-
COPY src ./src
|
|
28
|
-
COPY migrations ./migrations
|
|
29
|
-
COPY --from=tests /app/dist ./dist
|
|
30
|
-
ARG GIT_SHA
|
|
31
|
-
LABEL org.opencontainers.image.revision=$GIT_SHA
|
|
32
|
-
USER node
|
|
33
|
-
EXPOSE 3000
|
|
34
|
-
HEALTHCHECK --interval=30s --timeout=5s --start-period=30s --start-interval=2s \
|
|
35
|
-
CMD ["node", "-e", "fetch('http://127.0.0.1:3000/sante').then((r) => process.exit(r.ok ? 0 : 1), () => process.exit(1))"]
|
|
36
|
-
CMD ["node", "src/demarrer.ts"]
|
|
@@ -1,53 +0,0 @@
|
|
|
1
|
-
# App du client
|
|
2
|
-
|
|
3
|
-
Le modèle d'une app écrite par le client et installée dans l'espace d'Indos, au même rang qu'une app du catalogue : ses outils pour Claude, sa carte sur l'accueil, son écran dans la barre, ouverte à l'équipe ou à des groupes. Elle prend la bibliothèque d'Indos sur npm, `@indos/bibliotheque`, sous licence MIT, qui porte ce modèle à sa version.
|
|
4
|
-
|
|
5
|
-
Ce que fait le modèle : des entrées en texte court, à chaque personne les siennes, dans sa base. Deux outils, `ajouter` et `lister` (25 par page), les mêmes pour Claude et pour l'écran « Entrées ».
|
|
6
|
-
|
|
7
|
-
## Créer l'app
|
|
8
|
-
|
|
9
|
-
1. `npx @indos/bibliotheque creer-une-app <nom> [<dossier>]` : la commande copie le modèle dans un dossier neuf, `./<nom>` par défaut, à la racine d'un dépôt ou dans un dossier du dépôt des apps (`apps/<nom>`). Elle pose `nom` dans `module.json` et cite `@indos/bibliotheque` à la version du paquet qui l'a copié. `nom` s'écrit en minuscules, chiffres et tirets, une lettre d'abord : c'est le chemin de l'app, `https://<domaine>/<nom>`, et son nom dans `serveur.json`. La commande refuse un dossier qui existe.
|
|
10
|
-
2. Dans `module.json` : `titre`, `description` et les `ecrans`.
|
|
11
|
-
3. Redessiner `logo.svg` et réécrire `DOCUMENTATION.md` pour l'app.
|
|
12
|
-
4. `npm install`, dans le dossier de l'app : npm installe la bibliothèque et, avec elle, React, Vite, TanStack et les outils de test, à ses versions exactes. Le `package.json` ne les liste pas.
|
|
13
|
-
5. Commiter le dossier, avec son `package-lock.json`.
|
|
14
|
-
|
|
15
|
-
## Le dossier de l'app
|
|
16
|
-
|
|
17
|
-
L'app ne prend rien hors de son dossier, qui est le contexte de sa construction : elle se déplace d'un dépôt à l'autre sans changement.
|
|
18
|
-
|
|
19
|
-
- `module.json` : le manifeste. `nom`, `titre`, `description`, la phrase de sa carte sur l'accueil, écrite pour l'équipe, sans mot technique, `version` (celle de l'app ; « Toutes les apps » montre le commit installé), `dependances.core`, la borne du core que demande l'app (`>=2.9 <3`, celle de la bibliothèque 2.4), `ecrans`, `[{ "nom", "titre", "pour" }]`, chacun un onglet de l'app et une entrée de la barre, et facultatifs `pour: "proprietaire"`, qui la réserve au propriétaire jusqu'à ce qu'il l'ouvre dans « Équipe », `reglages`, `true` ou `{ "pour": "proprietaire" }`, qui sert ses réglages à `/<nom>/reglages`, sous l'onglet « Réglages », et `appelle`.
|
|
20
|
-
- `logo.svg` : le logo de la carte de l'app sur l'accueil, un dessin de 24×24, l'objet en `currentColor`, que le core peint aux couleurs du thème, et le geste de Claude au jaune `#F0B429`. Facultatif : sans lui, la carte porte l'initiale du titre.
|
|
21
|
-
- `DOCUMENTATION.md` : la documentation de l'app, pour l'équipe, que le core rend à `/documentation/<nom>`, sous l'onglet « Documentation » : titres en `##` et `###`, paragraphes, listes, étapes numérotées, gras, code et liens, ceux de ses écrans à `/<nom>/<écran>`. Facultative : sans elle, la page dit la phrase de l'app.
|
|
22
|
-
- `appelle` : la liste des apps dont l'app appelle les outils, comme `["fichiers"]` pour garder des fichiers. Le kit lui passe alors `CLE_D_APPEL`, et l'app les appelle par `creerLAppel` de `@indos/bibliotheque/appeler`. Sans besoin, ne pas le mettre.
|
|
23
|
-
- `src/` : le serveur. `demarrer.ts` lance l'app par `demarrerLApp` de la bibliothèque, qui ouvre la base, applique les migrations, relit `module.json` et `USAGE.md`, retire le chemin de l'app d'une requête qui le porte, sauf du chemin d'un écran, répond à une panne et arrête l'app sur `SIGTERM` ; `serveur.ts` route le MCP, les outils de l'écran, la page et la racine ; `outils.ts`, les outils.
|
|
24
|
-
- `migrations/` : les fichiers `.sql`, appliqués au démarrage dans l'ordre de leur nom, chacun une fois. Une migration publiée ne se modifie plus : la suivante la corrige.
|
|
25
|
-
- `espace/` : la page de l'espace, en React. `page.tsx` la lance ; `routes.ts` déclare un écran par route, `/<nom>/<écran>` ; `ecrans/`, un écran par fichier ; `requetes/`, ses lectures par les outils.
|
|
26
|
-
- `tests/` : le serveur, avec le faux core et une base d'essai en mémoire ; l'écran, par Vitest ; les sources de la page, sans HTML brut.
|
|
27
|
-
- `USAGE.md` : le texte d'usage, écrit pour Claude ; il devient les instructions du MCP de l'app.
|
|
28
|
-
- `Dockerfile` : l'image, construite sur le poste depuis le dossier de l'app. Une première étape, à la plateforme du poste, sans émulation même quand l'image vise un serveur d'une autre architecture, installe tout et lance `npm test`, qui construit la page puis la teste avec le serveur : un test qui échoue arrête la construction, et l'app ne se publie pas. L'image ne garde que le serveur, ses migrations et la page construite, sans React ni Vite (`npm ci --omit=dev --omit=peer`).
|
|
29
|
-
|
|
30
|
-
## Commandes
|
|
31
|
-
|
|
32
|
-
Dans le dossier de l'app :
|
|
33
|
-
|
|
34
|
-
- `npm test` : construire la page, vérifier les types du serveur et de la page, lancer les tests de Node, puis ceux de l'écran.
|
|
35
|
-
- `docker build .` : l'image, ses tests compris ; le journal dit le test qui échoue.
|
|
36
|
-
- `npm run build` : construire la page dans `dist/`.
|
|
37
|
-
- `ADRESSE=http://localhost:3000/<nom> DATABASE_URL=postgres://… npm start` : lancer l'app sur le port 3000, la page construite, avec une Postgres locale.
|
|
38
|
-
- `npm run dev` : la page à chaud sur `http://localhost:5173/<nom>/entrees`, dans Chrome ou Firefox, reliée au core de `INDOS_CORE` et à l'app lancée en local dans un autre terminal. Les écrans du manifeste et leurs modules sont servis à chaud ; tout le reste sous `/<nom>/`, quelle qu'en soit la méthode, va à l'app : ses outils, un fichier qu'elle sert, un websocket :
|
|
39
|
-
- relié à l'espace où l'app est installée, au domaine du serveur (le `domaine` du `serveur.json` du dépôt du serveur) : l'app lancée avec `ADRESSE=http://localhost:5173/<nom> CORE_ADRESSE=https://<domaine>`, puis `INDOS_CORE=https://<domaine> npm run dev`. Une app pas encore installée y est fermée : ses outils répondent 403 ;
|
|
40
|
-
- relié à un core local, dont l'`ADRESSE` est en `http://localhost:<port>` et où l'app est déclarée avec le lien `http://localhost:5173/<nom>` : la même chose avec `http://localhost:<port>`.
|
|
41
|
-
|
|
42
|
-
## Ce que le kit attend
|
|
43
|
-
|
|
44
|
-
Le kit d'Indos publie l'app sur le serveur au commit choisi, poussé sur GitHub :
|
|
45
|
-
|
|
46
|
-
- `module.json` et `Dockerfile` dans le dossier de l'app, et à côté, facultatifs, `logo.svg` et `DOCUMENTATION.md`. Le kit lit le manifeste, le logo et la documentation au commit et les passe au core, refuse un manifeste hors de forme avant tout geste, puis construit l'image sur le poste, depuis le dossier de l'app à ce commit, avec l'argument `GIT_SHA`, et la livre au serveur. Le `Dockerfile` déclare un seul port (`EXPOSE`) et une sonde (`HEALTHCHECK`).
|
|
47
|
-
- L'app est servie à `https://<domaine>/<nom>` ; elle reçoit ses routes avec ou sans ce chemin, et répond 200 sur `/sante`.
|
|
48
|
-
- Les variables : `DATABASE_URL`, sa base dans la Postgres du serveur ; `CLE`, sa clé, 32 octets en base64 ; `ADRESSE`, `https://<domaine>/<nom>` ; `CORE_ADRESSE`, le core ; `CLE_D_APPEL`, si le manifeste déclare `appelle`.
|
|
49
|
-
- L'app garde tout dans sa base, sans volume : le kit la sauvegarde chaque nuit.
|
|
50
|
-
|
|
51
|
-
## Monter la bibliothèque
|
|
52
|
-
|
|
53
|
-
La note des versions de la bibliothèque (`node_modules/@indos/bibliotheque/CHANGELOG.md`, et sa page sur npm) dit ce que change chaque version. Une version qui demande un geste dans l'app a sa rubrique « Ruptures » : le geste, les versions exactes de React, Vite et TanStack à reprendre, et le core que demande une majeure, à reporter dans `dependances.core`. Monter, c'est changer la version de `@indos/bibliotheque` dans `package.json`, `npm install`, faire les gestes de la rubrique, puis `npm test`.
|
|
@@ -1,57 +0,0 @@
|
|
|
1
|
-
import { keepPreviousData, useQuery, useQueryClient } from '@tanstack/react-query';
|
|
2
|
-
import { Ecran, RefusDUnAppel, useAppel, usePageDeLAdresse } from '@indos/bibliotheque/espace';
|
|
3
|
-
import { jourEtHeure } from '@indos/bibliotheque/format';
|
|
4
|
-
import { Bouton, Champ, Saisie, Tableau, type Colonne } from '@indos/bibliotheque/ui';
|
|
5
|
-
import { requeteDesEntrees } from '../requetes/entrees.ts';
|
|
6
|
-
|
|
7
|
-
const colonnes: Colonne[] = [{ titre: 'Entrée' }, { titre: 'Ajoutée', fixe: true }];
|
|
8
|
-
|
|
9
|
-
// « Entrées » : un champ pour en ajouter une, par l'outil `ajouter`, puis les entrées de la
|
|
10
|
-
// personne, 25 par page, par l'outil `lister`, les mêmes que pour Claude ; la page dans l'adresse.
|
|
11
|
-
// Un appel refusé se lit sous le champ, mot pour mot.
|
|
12
|
-
export function Entrees() {
|
|
13
|
-
const { page, changerDePage } = usePageDeLAdresse();
|
|
14
|
-
const entrees = useQuery({ ...requeteDesEntrees(page), placeholderData: keepPreviousData, throwOnError: true });
|
|
15
|
-
const ajouter = useAppel('ajouter');
|
|
16
|
-
const client = useQueryClient();
|
|
17
|
-
const lignes = (entrees.data?.lignes ?? []).map((entree) => [
|
|
18
|
-
<span className="[overflow-wrap:anywhere]">{entree.texte}</span>,
|
|
19
|
-
jourEtHeure(entree.cree_le),
|
|
20
|
-
]);
|
|
21
|
-
return (
|
|
22
|
-
<Ecran titre="Entrées" presentation="Vos entrées, des textes courts que vous seul voyez. Claude les lit et en ajoute quand vous le lui demandez.">
|
|
23
|
-
<form
|
|
24
|
-
className="mb-5 flex flex-wrap items-end gap-2.5"
|
|
25
|
-
onSubmit={(evenement) => {
|
|
26
|
-
evenement.preventDefault();
|
|
27
|
-
const formulaire = evenement.currentTarget;
|
|
28
|
-
const texte = String(new FormData(formulaire).get('texte') ?? '').trim();
|
|
29
|
-
if (!texte) {
|
|
30
|
-
return;
|
|
31
|
-
}
|
|
32
|
-
ajouter.mutate({ texte }, {
|
|
33
|
-
onSuccess: () => {
|
|
34
|
-
formulaire.reset();
|
|
35
|
-
void client.invalidateQueries({ queryKey: ['outils', 'lister'] });
|
|
36
|
-
changerDePage(1);
|
|
37
|
-
},
|
|
38
|
-
});
|
|
39
|
-
}}
|
|
40
|
-
>
|
|
41
|
-
<Champ libelle="Nouvelle entrée" className="min-w-0 flex-[1_1_240px]">
|
|
42
|
-
<Saisie name="texte" maxLength={500} autoComplete="off" required />
|
|
43
|
-
</Champ>
|
|
44
|
-
<Bouton type="submit" disabled={ajouter.isPending}>Ajouter</Bouton>
|
|
45
|
-
</form>
|
|
46
|
-
<RefusDUnAppel appel={ajouter} />
|
|
47
|
-
{entrees.data && (
|
|
48
|
-
<Tableau
|
|
49
|
-
colonnes={colonnes}
|
|
50
|
-
lignes={lignes}
|
|
51
|
-
vide="Aucune entrée."
|
|
52
|
-
pagination={{ page, total: entrees.data.total, changerDePage }}
|
|
53
|
-
/>
|
|
54
|
-
)}
|
|
55
|
-
</Ecran>
|
|
56
|
-
);
|
|
57
|
-
}
|
|
@@ -1,6 +0,0 @@
|
|
|
1
|
-
import { lancerLaPage } from '@indos/bibliotheque/espace';
|
|
2
|
-
import { nom, version } from '../module.json';
|
|
3
|
-
import { ecrans } from './routes.ts';
|
|
4
|
-
|
|
5
|
-
// La page de l'espace de l'app, à sa base `/<nom>/`.
|
|
6
|
-
lancerLaPage({ piece: { nom, version }, base: `/${nom}/`, ecrans });
|