@indos/bibliotheque 1.7.0 → 1.9.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/CHANGELOG.md +38 -0
- package/package.json +17 -1
- package/src/app.d.ts +43 -1
- package/src/app.js +113 -0
- package/src/base.d.ts +3 -0
- package/src/base.js +29 -0
- package/src/espace/barre-de-la-liste.d.ts +6 -0
- package/src/espace/barre-de-la-liste.js +77 -0
- package/src/espace/base64.d.ts +2 -0
- package/src/espace/base64.js +14 -0
- package/src/espace/cadre.d.ts +46 -0
- package/src/espace/cadre.js +100 -0
- package/src/espace/choses.d.ts +5 -0
- package/src/espace/choses.js +28 -0
- package/src/espace/comptes.js +5 -4
- package/src/espace/coquille.d.ts +5 -0
- package/src/espace/coquille.js +82 -38
- package/src/espace/doubles-de-jsdom.d.ts +1 -0
- package/src/espace/doubles-de-jsdom.js +15 -0
- package/src/espace/ecran-d-une-chose.d.ts +1 -1
- package/src/espace/ecran-d-une-chose.js +93 -19
- package/src/espace/ecran.d.ts +3 -1
- package/src/espace/ecran.js +11 -15
- package/src/espace/entree-active.js +3 -1
- package/src/espace/heure.js +4 -12
- package/src/espace/index.d.ts +3 -2
- package/src/espace/index.js +3 -2
- package/src/espace/lien.d.ts +3 -2
- package/src/espace/lien.js +4 -2
- package/src/espace/liste-des-choses.js +26 -21
- package/src/espace/menu-d-une-chose.d.ts +1 -1
- package/src/espace/menu-d-une-chose.js +13 -6
- package/src/espace/ouvrir.d.ts +4 -1
- package/src/espace/ouvrir.js +13 -5
- package/src/espace/page.d.ts +3 -0
- package/src/espace/page.js +1 -1
- package/src/espace/panneau-du-partage.d.ts +16 -1
- package/src/espace/panneau-du-partage.js +67 -11
- package/src/espace/routes-des-choses.js +5 -3
- package/src/fichiers.d.ts +8 -0
- package/src/fichiers.js +47 -3
- package/src/flux.d.ts +15 -0
- package/src/flux.js +102 -0
- package/src/format.d.ts +6 -0
- package/src/format.js +92 -0
- package/src/identifiant.d.ts +6 -0
- package/src/identifiant.js +13 -0
- package/src/sans-accents.d.ts +3 -0
- package/src/sans-accents.js +21 -0
- package/src/ui/blocs.d.ts +17 -1
- package/src/ui/blocs.js +23 -3
- package/src/ui/bouton.d.ts +3 -1
- package/src/ui/bouton.js +6 -2
- package/src/ui/champ.d.ts +2 -1
- package/src/ui/champ.js +2 -2
- package/src/ui/choix.d.ts +3 -1
- package/src/ui/choix.js +2 -2
- package/src/ui/graphiques.js +3 -3
- package/src/ui/icones.d.ts +7 -0
- package/src/ui/icones.js +11 -0
- package/src/ui/index.d.ts +4 -2
- package/src/ui/index.js +3 -1
- package/src/ui/recherche.d.ts +13 -0
- package/src/ui/recherche.js +16 -0
- package/src/ui/tableau.d.ts +1 -0
- package/src/ui/tableau.js +14 -5
- package/src/ui/theme.css +17 -9
- package/src/ui/vues.d.ts +2 -1
- package/src/ui/vues.js +7 -3
- package/src/vite.js +9 -5
- package/src/espace/en-tete-de-l-app.d.ts +0 -8
- package/src/espace/en-tete-de-l-app.js +0 -51
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,44 @@
|
|
|
2
2
|
|
|
3
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
4
|
|
|
5
|
+
## 1.9.0
|
|
6
|
+
|
|
7
|
+
- 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.
|
|
8
|
+
- `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.
|
|
9
|
+
- `@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`.
|
|
10
|
+
- `@indos/bibliotheque/sans-accents` : `sansAccents(texte)` en JavaScript, `sansAccentsEnSql(expression)` et `motifSansAccents(texte)` en SQL, la recherche sans accents ni casse.
|
|
11
|
+
- 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`.
|
|
12
|
+
- `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.
|
|
13
|
+
- `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`.
|
|
14
|
+
- La vue de la barre de la liste et le droit d'une ouverture, dans le panneau du partage, sont des `Choix`.
|
|
15
|
+
- 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.
|
|
16
|
+
- `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.
|
|
17
|
+
- 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.
|
|
18
|
+
|
|
19
|
+
### Ruptures
|
|
20
|
+
|
|
21
|
+
- 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 ».
|
|
22
|
+
- Les versions de React, Vite et TanStack ne changent pas ; `npm view @indos/bibliotheque@1.9.0 peerDependencies` les donne toutes.
|
|
23
|
+
- Pour monter : `"@indos/bibliotheque": "1.9.0"` dans ses `dependencies`, puis `npm install` et `npm run build`.
|
|
24
|
+
|
|
25
|
+
## 1.8.0
|
|
26
|
+
|
|
27
|
+
- 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.
|
|
28
|
+
- `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.
|
|
29
|
+
- `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`.
|
|
30
|
+
- 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.
|
|
31
|
+
- Les vues (`Vues`) sont des pastilles, l'active en carte bordée.
|
|
32
|
+
- 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.
|
|
33
|
+
- 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.
|
|
34
|
+
- En bas de la barre, les neuf points ouvrent « Toutes les apps » ; « Configurer l'espace » est dans le menu du nom.
|
|
35
|
+
- `IconeDEpingle` et `IconeDesApps`, dans `@indos/bibliotheque/ui`.
|
|
36
|
+
|
|
37
|
+
### Ruptures
|
|
38
|
+
|
|
39
|
+
- 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.
|
|
40
|
+
- Les versions de React, Vite et TanStack ne changent pas ; `npm view @indos/bibliotheque@1.8.0 peerDependencies` les donne toutes.
|
|
41
|
+
- Pour monter : `"@indos/bibliotheque": "1.8.0"` dans ses `dependencies`, puis `npm install` et `npm run build`.
|
|
42
|
+
|
|
5
43
|
## 1.7.0
|
|
6
44
|
|
|
7
45
|
- 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.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@indos/bibliotheque",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.9.0",
|
|
4
4
|
"description": "La bibliothèque des apps d'Indos : le serveur, le MCP, la base et la page de l'espace d'une app.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
|
@@ -44,6 +44,14 @@
|
|
|
44
44
|
"types": "./src/fichiers.d.ts",
|
|
45
45
|
"default": "./src/fichiers.js"
|
|
46
46
|
},
|
|
47
|
+
"./flux": {
|
|
48
|
+
"types": "./src/flux.d.ts",
|
|
49
|
+
"default": "./src/flux.js"
|
|
50
|
+
},
|
|
51
|
+
"./identifiant": {
|
|
52
|
+
"types": "./src/identifiant.d.ts",
|
|
53
|
+
"default": "./src/identifiant.js"
|
|
54
|
+
},
|
|
47
55
|
"./jeton": {
|
|
48
56
|
"types": "./src/jeton.d.ts",
|
|
49
57
|
"default": "./src/jeton.js"
|
|
@@ -80,6 +88,14 @@
|
|
|
80
88
|
"types": "./src/type-de-fichier.d.ts",
|
|
81
89
|
"default": "./src/type-de-fichier.js"
|
|
82
90
|
},
|
|
91
|
+
"./format": {
|
|
92
|
+
"types": "./src/format.d.ts",
|
|
93
|
+
"default": "./src/format.js"
|
|
94
|
+
},
|
|
95
|
+
"./sans-accents": {
|
|
96
|
+
"types": "./src/sans-accents.d.ts",
|
|
97
|
+
"default": "./src/sans-accents.js"
|
|
98
|
+
},
|
|
83
99
|
"./ui": {
|
|
84
100
|
"types": "./src/ui/index.d.ts",
|
|
85
101
|
"default": "./src/ui/index.js"
|
package/src/app.d.ts
CHANGED
|
@@ -1,3 +1,45 @@
|
|
|
1
|
-
import { type RequestListener, type Server } from 'node:http';
|
|
1
|
+
import { type IncomingMessage, type RequestListener, type Server, type ServerResponse } from 'node:http';
|
|
2
|
+
import type pg from 'pg';
|
|
2
3
|
export declare function creerLeServeur(traiter: RequestListener): Server;
|
|
3
4
|
export declare function demarrer(nom: string, traiter: RequestListener): Server;
|
|
5
|
+
export type ManifesteDeLApp = {
|
|
6
|
+
nom: string;
|
|
7
|
+
version: string;
|
|
8
|
+
ecrans?: {
|
|
9
|
+
nom: string;
|
|
10
|
+
titre?: string;
|
|
11
|
+
}[];
|
|
12
|
+
reglages?: boolean | {
|
|
13
|
+
pour: 'proprietaire';
|
|
14
|
+
};
|
|
15
|
+
[cle: string]: unknown;
|
|
16
|
+
};
|
|
17
|
+
export type ContexteDeLApp = {
|
|
18
|
+
adresse: string;
|
|
19
|
+
adresseDuCore: string | undefined;
|
|
20
|
+
manifeste: ManifesteDeLApp;
|
|
21
|
+
instructions: string;
|
|
22
|
+
serveur: Server;
|
|
23
|
+
};
|
|
24
|
+
export type TraitementDeLApp = (requete: IncomingMessage, reponse: ServerResponse) => unknown;
|
|
25
|
+
type OptionsDeLApp<C> = {
|
|
26
|
+
dossier: URL;
|
|
27
|
+
traiter: (app: C) => TraitementDeLApp | {
|
|
28
|
+
traiter: TraitementDeLApp;
|
|
29
|
+
avantDeQuitter?: () => unknown;
|
|
30
|
+
} | Promise<TraitementDeLApp | {
|
|
31
|
+
traiter: TraitementDeLApp;
|
|
32
|
+
avantDeQuitter?: () => unknown;
|
|
33
|
+
}>;
|
|
34
|
+
chemin?: (requete: IncomingMessage) => boolean;
|
|
35
|
+
};
|
|
36
|
+
export declare const delaiDArret = 8000;
|
|
37
|
+
export declare function demarrerLApp(options: OptionsDeLApp<ContexteDeLApp & {
|
|
38
|
+
base: pg.Pool;
|
|
39
|
+
}> & {
|
|
40
|
+
migrations: true;
|
|
41
|
+
}): Promise<Server>;
|
|
42
|
+
export declare function demarrerLApp(options: OptionsDeLApp<ContexteDeLApp> & {
|
|
43
|
+
migrations?: false;
|
|
44
|
+
}): Promise<Server>;
|
|
45
|
+
export {};
|
package/src/app.js
CHANGED
|
@@ -1,4 +1,10 @@
|
|
|
1
|
+
import { readFileSync } from 'node:fs';
|
|
2
|
+
import { once } from 'node:events';
|
|
1
3
|
import { createServer } from 'node:http';
|
|
4
|
+
import { repondreEnJson } from './appel-d-ecran.js';
|
|
5
|
+
import { appliquerLesMigrations, ouvrirLaBase } from './base.js';
|
|
6
|
+
import { envoyerLaPage, pageSimple } from './ecran.js';
|
|
7
|
+
import { fermerLesFlux } from './flux.js';
|
|
2
8
|
// Le serveur HTTP d'une app : GET /sante (et HEAD) répond « ok » pour la sonde de Coolify
|
|
3
9
|
// et de la surveillance ; tout le reste va à l'app.
|
|
4
10
|
export function creerLeServeur(traiter) {
|
|
@@ -33,3 +39,110 @@ export function demarrer(nom, traiter) {
|
|
|
33
39
|
process.on('SIGTERM', arreter);
|
|
34
40
|
return serveur;
|
|
35
41
|
}
|
|
42
|
+
// L'arrêt de l'app ne dure pas plus de huit secondes : Docker la coupe au bout de dix.
|
|
43
|
+
export const delaiDArret = 8_000;
|
|
44
|
+
export async function demarrerLApp(options) {
|
|
45
|
+
const manifeste = JSON.parse(readFileSync(new URL('module.json', options.dossier), 'utf8'));
|
|
46
|
+
const instructions = readFileSync(new URL('USAGE.md', options.dossier), 'utf8').trim();
|
|
47
|
+
const { nom } = manifeste;
|
|
48
|
+
const adresse = lireLAdresse(nom);
|
|
49
|
+
const prefixe = new URL(adresse).pathname.replace(/\/$/, '');
|
|
50
|
+
const base = options.migrations ? ouvrirLaBase() : undefined;
|
|
51
|
+
if (base) {
|
|
52
|
+
const appliquees = await appliquerLesMigrations(base, new URL('migrations/', options.dossier));
|
|
53
|
+
if (appliquees.length > 0) {
|
|
54
|
+
console.log(`Migrations appliquées : ${appliquees.join(', ')}`);
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
// Le traitement que l'app crée ci-dessous, avant que le serveur écoute.
|
|
58
|
+
let traitement;
|
|
59
|
+
const serveur = creerLeServeur((requete, reponse) => {
|
|
60
|
+
if (prefixe && (options.chemin?.(requete) ?? true)) {
|
|
61
|
+
requete.url = sansLeChemin(requete.url ?? '/', prefixe);
|
|
62
|
+
}
|
|
63
|
+
void servir(traitement, requete, reponse);
|
|
64
|
+
});
|
|
65
|
+
// Sans `migrations`, `base` reste vide : la forme de `demarrerLApp` sans migrations ne la donne pas.
|
|
66
|
+
const rendu = await options.traiter({ adresse, adresseDuCore: process.env.CORE_ADRESSE, manifeste, instructions, serveur, base: base });
|
|
67
|
+
traitement = typeof rendu === 'function' ? rendu : rendu.traiter;
|
|
68
|
+
const avantDeQuitter = typeof rendu === 'function' ? undefined : rendu.avantDeQuitter;
|
|
69
|
+
// Un seul arrêt : il cesse d'accepter, ferme les flux, coupe toutes les connexions, puis fait ce
|
|
70
|
+
// que l'app déclare avant de quitter, ferme la base et quitte. Aucune requête ne reçoit donc de
|
|
71
|
+
// réponse pendant ou après `avantDeQuitter` : une écriture confirmée est une écriture que
|
|
72
|
+
// `avantDeQuitter` enregistre. Une requête coupée en vol n'a rien confirmé.
|
|
73
|
+
let enArret = false;
|
|
74
|
+
async function arreter() {
|
|
75
|
+
if (enArret) {
|
|
76
|
+
return;
|
|
77
|
+
}
|
|
78
|
+
enArret = true;
|
|
79
|
+
setTimeout(() => {
|
|
80
|
+
console.error(`${nom} ne s'est pas arrêtée en ${delaiDArret / 1000} secondes : elle quitte.`);
|
|
81
|
+
process.exit(1);
|
|
82
|
+
}, delaiDArret).unref();
|
|
83
|
+
serveur.close();
|
|
84
|
+
fermerLesFlux();
|
|
85
|
+
serveur.closeAllConnections();
|
|
86
|
+
try {
|
|
87
|
+
await avantDeQuitter?.();
|
|
88
|
+
}
|
|
89
|
+
catch (erreur) {
|
|
90
|
+
console.error(erreur);
|
|
91
|
+
}
|
|
92
|
+
await base?.end().catch(() => { });
|
|
93
|
+
process.exit(0);
|
|
94
|
+
}
|
|
95
|
+
process.on('SIGTERM', arreter);
|
|
96
|
+
process.on('SIGINT', arreter);
|
|
97
|
+
serveur.listen(Number(process.env.PORT || 3000));
|
|
98
|
+
await once(serveur, 'listening');
|
|
99
|
+
console.log(`${nom} écoute sur le port ${serveur.address().port}`);
|
|
100
|
+
return serveur;
|
|
101
|
+
}
|
|
102
|
+
// ADRESSE, l'adresse publique de l'app, que le kit lui donne, sans barre finale.
|
|
103
|
+
function lireLAdresse(nom) {
|
|
104
|
+
const exemple = nom === 'core' ? 'https://exemple.ch' : `https://exemple.ch/${nom}`;
|
|
105
|
+
const adresse = process.env.ADRESSE?.replace(/\/$/, '');
|
|
106
|
+
if (!adresse || !URL.canParse(adresse)) {
|
|
107
|
+
throw new Error(`La variable ADRESSE manque ou n'est pas une adresse : l'adresse publique de ${nom}, avec son chemin, comme ${exemple}.`);
|
|
108
|
+
}
|
|
109
|
+
return adresse;
|
|
110
|
+
}
|
|
111
|
+
// L'adresse d'une requête sans le chemin de l'app, sa recherche gardée ; telle quelle sans lui.
|
|
112
|
+
function sansLeChemin(url, prefixe) {
|
|
113
|
+
const { pathname, search } = new URL(url, 'http://app');
|
|
114
|
+
if (pathname !== prefixe && !pathname.startsWith(`${prefixe}/`)) {
|
|
115
|
+
return url;
|
|
116
|
+
}
|
|
117
|
+
return `${pathname.slice(prefixe.length) || '/'}${search}`;
|
|
118
|
+
}
|
|
119
|
+
// Sert une requête et attrape l'erreur du traitement, écrite au journal avec sa pile : la page
|
|
120
|
+
// simple à une navigation, une erreur JSON à un appel (un outil, un geste d'écran, une lecture de
|
|
121
|
+
// la page), rien de plus sur une réponse commencée, dont la connexion se coupe.
|
|
122
|
+
async function servir(traitement, requete, reponse) {
|
|
123
|
+
try {
|
|
124
|
+
await traitement(requete, reponse);
|
|
125
|
+
}
|
|
126
|
+
catch (erreur) {
|
|
127
|
+
console.error(erreur);
|
|
128
|
+
if (reponse.writableEnded) {
|
|
129
|
+
return;
|
|
130
|
+
}
|
|
131
|
+
if (reponse.headersSent) {
|
|
132
|
+
reponse.destroy();
|
|
133
|
+
}
|
|
134
|
+
else if (estUneNavigation(requete)) {
|
|
135
|
+
envoyerLaPage(reponse, 500, pageSimple('Une erreur est survenue', 'Réessayez dans un moment.'));
|
|
136
|
+
}
|
|
137
|
+
else {
|
|
138
|
+
repondreEnJson(reponse, 500, { erreur: 'Une erreur est survenue. Réessayez dans un moment.' });
|
|
139
|
+
}
|
|
140
|
+
}
|
|
141
|
+
}
|
|
142
|
+
// Une navigation : le navigateur charge une page, et non un appel de script.
|
|
143
|
+
function estUneNavigation(requete) {
|
|
144
|
+
if (requete.method !== 'GET' && requete.method !== 'HEAD') {
|
|
145
|
+
return false;
|
|
146
|
+
}
|
|
147
|
+
return requete.headers['sec-fetch-mode'] === 'navigate' || (requete.headers.accept ?? '').includes('text/html');
|
|
148
|
+
}
|
package/src/base.d.ts
CHANGED
|
@@ -1,3 +1,6 @@
|
|
|
1
1
|
import pg from 'pg';
|
|
2
2
|
export declare function ouvrirLaBase(adresse?: string | undefined, connexions?: number): pg.Pool;
|
|
3
3
|
export declare function appliquerLesMigrations(base: pg.Pool, dossier: URL): Promise<string[]>;
|
|
4
|
+
export declare function enTransaction<T>(base: pg.Pool, geste: (client: pg.PoolClient) => Promise<T>, options?: {
|
|
5
|
+
verrou?: string | string[];
|
|
6
|
+
}): Promise<T>;
|
package/src/base.js
CHANGED
|
@@ -47,3 +47,32 @@ export async function appliquerLesMigrations(base, dossier) {
|
|
|
47
47
|
}
|
|
48
48
|
return appliquees;
|
|
49
49
|
}
|
|
50
|
+
// Un geste en plusieurs requêtes, tout ou rien, sur une connexion à lui : `geste` y lit et y écrit
|
|
51
|
+
// par `client`, jamais par le pool, qui peut n'avoir qu'une connexion. Il rend ce que rend le geste ;
|
|
52
|
+
// une erreur annule tout et passe telle quelle. `verrou`, une clé ou plusieurs, est pris d'abord,
|
|
53
|
+
// jusqu'à la fin de la transaction : deux gestes sous une même clé passent l'un après l'autre.
|
|
54
|
+
// Plusieurs clés se prennent dans l'ordre de leur nom, pour que deux gestes ne s'attendent pas en
|
|
55
|
+
// croix. La clé d'un verrou est `pg_advisory_xact_lock(hashtextextended(<clé>, 0))`, celle qu'un
|
|
56
|
+
// déclencheur de la base prend aussi pour la même chose (`'presentation:' || id`).
|
|
57
|
+
export async function enTransaction(base, geste, options = {}) {
|
|
58
|
+
const cles = [...new Set([].concat(options.verrou ?? []))].sort();
|
|
59
|
+
const client = await base.connect();
|
|
60
|
+
let cassee = false;
|
|
61
|
+
try {
|
|
62
|
+
await client.query('begin');
|
|
63
|
+
for (const cle of cles) {
|
|
64
|
+
await client.query('select pg_advisory_xact_lock(hashtextextended($1, 0))', [cle]);
|
|
65
|
+
}
|
|
66
|
+
const resultat = await geste(client);
|
|
67
|
+
await client.query('commit');
|
|
68
|
+
return resultat;
|
|
69
|
+
}
|
|
70
|
+
catch (erreur) {
|
|
71
|
+
// Une connexion qui ne sait plus annuler est cassée : elle ne retourne pas au pool.
|
|
72
|
+
cassee = await client.query('rollback').then(() => false, () => true);
|
|
73
|
+
throw erreur;
|
|
74
|
+
}
|
|
75
|
+
finally {
|
|
76
|
+
client.release(cassee);
|
|
77
|
+
}
|
|
78
|
+
}
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
import { type ReactNode } from 'react';
|
|
2
|
+
import { type ChoseTrouvee, type DeclarationDesChoses } from './choses.ts';
|
|
3
|
+
export declare function BarreDeLaListe<C extends ChoseTrouvee>({ choses, bas }: {
|
|
4
|
+
choses: DeclarationDesChoses<C>;
|
|
5
|
+
bas: ReactNode;
|
|
6
|
+
}): import("react").JSX.Element;
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
|
|
2
|
+
import { keepPreviousData, useQuery } from '@tanstack/react-query';
|
|
3
|
+
import { useLocation, useRouter } from '@tanstack/react-router';
|
|
4
|
+
import { useEffect, useState } from 'react';
|
|
5
|
+
import { nombre } from '../format.js';
|
|
6
|
+
import { lignesParPage } from '../pagination.js';
|
|
7
|
+
import { Bouton } from '../ui/bouton.js';
|
|
8
|
+
import { Saisie } from '../ui/champ.js';
|
|
9
|
+
import { Choix } from '../ui/choix.js';
|
|
10
|
+
import { chercherParLOutil, cleDesChoses, critereDeLaListe, dateDe, motsDe, rechercheDeLaListe } from './choses.js';
|
|
11
|
+
import { LienDansLaPage } from './lien.js';
|
|
12
|
+
import { adresseDeLaListe, depuisLaListe, retenirLaListe, titreDeLaListe } from './ouvrir.js';
|
|
13
|
+
import { useSession } from './session.js';
|
|
14
|
+
// La barre de la liste, à la place de la barre de l'OS sur une chose ouverte depuis la liste de son
|
|
15
|
+
// app (docs/architecture.md, « L'espace ») : « ‹ <liste> », qui mène à la liste telle qu'on l'a
|
|
16
|
+
// quittée et rend la barre de l'OS ; la vue, quand l'app en a plusieurs, et la recherche ; les choses
|
|
17
|
+
// de la page, chacune sur deux lignes, son nom et `sousLigne` (la date par défaut), l'ouverte en
|
|
18
|
+
// carte bordée ; « 1–25 sur N » et les pages ; le pied de la barre. Sa vue, son texte et sa page
|
|
19
|
+
// vivent dans l'adresse retenue de la liste (`retenirLaListe`), jamais dans l'adresse de la chose :
|
|
20
|
+
// les changer garde la chose ouverte et son origine. Elle lit le même `chercher`, sous la même clé
|
|
21
|
+
// que la liste.
|
|
22
|
+
const attenteDeLaFrappe = 300;
|
|
23
|
+
const chevron = (_jsx("svg", { "aria-hidden": "true", viewBox: "0 0 16 16", className: "size-4 flex-none", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", children: _jsx("path", { d: "M10 3.5L5.5 8l4.5 4.5" }) }));
|
|
24
|
+
export function BarreDeLaListe({ choses, bas }) {
|
|
25
|
+
const session = useSession();
|
|
26
|
+
const router = useRouter();
|
|
27
|
+
const ici = useLocation({ select: (lieu) => lieu.pathname });
|
|
28
|
+
const mots = motsDe(choses);
|
|
29
|
+
const titre = titreDeLaListe(session, choses.app);
|
|
30
|
+
const vues = choses.vues ?? [];
|
|
31
|
+
const premiere = vues[0]?.valeur;
|
|
32
|
+
// La recherche de l'adresse retenue de la liste.
|
|
33
|
+
function rechercheRetenue() {
|
|
34
|
+
const adresse = new URL(adresseDeLaListe(choses.app), window.location.origin);
|
|
35
|
+
return rechercheDeLaListe(router.options.parseSearch(adresse.search));
|
|
36
|
+
}
|
|
37
|
+
const [recherche, setRecherche] = useState(rechercheRetenue);
|
|
38
|
+
const [saisie, setSaisie] = useState(recherche.texte ?? '');
|
|
39
|
+
// Une recherche nouvelle devient l'adresse retenue de la liste.
|
|
40
|
+
function changer(suite) {
|
|
41
|
+
const prochaine = {
|
|
42
|
+
...(suite.texte ? { texte: suite.texte } : {}),
|
|
43
|
+
...(suite.vue && suite.vue !== premiere ? { vue: suite.vue } : {}),
|
|
44
|
+
...(suite.page && suite.page > 1 ? { page: suite.page } : {}),
|
|
45
|
+
};
|
|
46
|
+
setRecherche(prochaine);
|
|
47
|
+
retenirLaListe(choses.app, `/${choses.app}/liste${router.options.stringifySearch(prochaine)}`);
|
|
48
|
+
}
|
|
49
|
+
useEffect(() => {
|
|
50
|
+
const propre = saisie.trim();
|
|
51
|
+
if (propre === (recherche.texte ?? '')) {
|
|
52
|
+
return undefined;
|
|
53
|
+
}
|
|
54
|
+
const minuteur = setTimeout(() => changer({ texte: propre, vue: recherche.vue }), attenteDeLaFrappe);
|
|
55
|
+
return () => clearTimeout(minuteur);
|
|
56
|
+
}, [saisie, recherche.texte, recherche.vue]);
|
|
57
|
+
const chercher = choses.chercher ?? chercherParLOutil;
|
|
58
|
+
const critere = critereDeLaListe(vues, recherche);
|
|
59
|
+
const trouvees = useQuery({
|
|
60
|
+
queryKey: cleDesChoses(choses.app, 'liste', critere),
|
|
61
|
+
queryFn: () => chercher(critere),
|
|
62
|
+
placeholderData: keepPreviousData,
|
|
63
|
+
});
|
|
64
|
+
const page = critere.page;
|
|
65
|
+
const lignes = trouvees.data?.lignes ?? [];
|
|
66
|
+
const total = trouvees.data?.total ?? 0;
|
|
67
|
+
const derniere = Math.max(1, Math.ceil(total / lignesParPage));
|
|
68
|
+
const debut = (page - 1) * lignesParPage + 1;
|
|
69
|
+
const vue = recherche.vue && vues.some((une) => une.valeur === recherche.vue) ? recherche.vue : premiere;
|
|
70
|
+
const classesDuChamp = 'h-8 w-full text-[13.5px]';
|
|
71
|
+
return (_jsxs(_Fragment, { children: [_jsxs(LienDansLaPage, { href: adresseDeLaListe(choses.app), className: "flex h-9 flex-none items-center gap-1.5 rounded-md px-2 font-medium text-gris no-underline hover:bg-survol hover:text-encre", children: [chevron, _jsx("span", { className: "truncate", children: titre })] }), _jsxs("div", { className: "grid flex-1 content-start gap-2", children: [_jsxs("div", { className: "grid gap-1.5", children: [vues.length > 1 && (_jsx(Choix, { libelle: "Vue", libelleMasque: true, taille: "petite", options: vues.map((une) => ({ valeur: une.valeur, libelle: une.titre })), valeur: vue, onValeurChange: (prochaine) => changer({ texte: recherche.texte, vue: prochaine }) })), _jsx(Saisie, { type: "search", "aria-label": "Chercher", placeholder: "Chercher", value: saisie, autoComplete: "off", className: classesDuChamp, onChange: (evenement) => setSaisie(evenement.currentTarget.value) })] }), trouvees.error
|
|
72
|
+
? (_jsxs("div", { className: "grid justify-items-start gap-2 px-1 text-[13px] text-gris", children: [_jsx("p", { role: "alert", className: "m-0", children: trouvees.error.message }), _jsx(Bouton, { type: "button", sorte: "secondaire", className: "h-8", onClick: () => void trouvees.refetch(), children: "R\u00E9essayer" })] }))
|
|
73
|
+
: trouvees.data && (_jsxs(_Fragment, { children: [_jsxs("nav", { "aria-label": titre, className: "grid gap-0.5", children: [lignes.length === 0 && _jsxs("p", { className: "m-0 px-2.5 py-2 text-[13px] text-gris", children: [mots.aucune, "."] }), lignes.map((chose) => {
|
|
74
|
+
const dessous = choses.sousLigne ? choses.sousLigne(chose) : dateDe(choses, chose);
|
|
75
|
+
return (_jsxs(LienDansLaPage, { href: chose.chemin, state: depuisLaListe, "aria-current": chose.chemin === ici ? 'page' : undefined, className: "grid gap-px rounded-lg border border-transparent px-2.5 py-2 no-underline hover:bg-survol aria-[current=page]:border-trait aria-[current=page]:bg-papier", children: [_jsx("span", { className: "truncate font-medium text-encre", children: chose.nom }), dessous !== undefined && dessous !== '' && _jsx("span", { className: "truncate text-[12.5px] text-gris", children: dessous })] }, chose.id));
|
|
76
|
+
})] }), lignes.length > 0 && (_jsxs("div", { className: "flex items-center justify-between gap-2 px-1", children: [_jsx("p", { className: "m-0 font-mono text-[12px] text-gris tabular-nums", children: `${nombre(debut)}–${nombre(debut + lignes.length - 1)} sur ${nombre(total)}` }), derniere > 1 && (_jsxs("nav", { "aria-label": "Pages", className: "flex gap-1", children: [_jsx(Bouton, { type: "button", sorte: "discret", "aria-label": "Pr\u00E9c\u00E9dent", disabled: page <= 1, onClick: () => changer({ ...recherche, page: Math.min(page - 1, derniere) }), children: "\u2039" }), _jsx(Bouton, { type: "button", sorte: "discret", "aria-label": "Suivant", disabled: page >= derniere, onClick: () => changer({ ...recherche, page: page + 1 }), children: "\u203A" })] }))] }))] }))] }), bas] }));
|
|
77
|
+
}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
// Des octets en base64, pour un geste d'écran qui porte un fichier dans son corps JSON : une image
|
|
2
|
+
// déposée, un classeur importé. Par tranches de 32 Kio : `String.fromCharCode` ne prend pas un
|
|
3
|
+
// fichier entier en arguments.
|
|
4
|
+
export function enBase64(octets) {
|
|
5
|
+
let texte = '';
|
|
6
|
+
for (let debut = 0; debut < octets.length; debut += 0x8000) {
|
|
7
|
+
texte += String.fromCharCode(...octets.subarray(debut, debut + 0x8000));
|
|
8
|
+
}
|
|
9
|
+
return btoa(texte);
|
|
10
|
+
}
|
|
11
|
+
// Un fichier choisi, collé ou lu d'une réponse, en base64.
|
|
12
|
+
export async function fichierEnBase64(fichier) {
|
|
13
|
+
return enBase64(new Uint8Array(await fichier.arrayBuffer()));
|
|
14
|
+
}
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
import { type ReactNode } from 'react';
|
|
2
|
+
import type { AppOuverte, Session } from './session.ts';
|
|
3
|
+
export type Onglet = {
|
|
4
|
+
titre: string;
|
|
5
|
+
chemin: string;
|
|
6
|
+
};
|
|
7
|
+
export type SegmentDuFil = {
|
|
8
|
+
titre: string;
|
|
9
|
+
chemin: string;
|
|
10
|
+
};
|
|
11
|
+
export declare function appDuChemin(session: Session, ici: string): AppOuverte | undefined;
|
|
12
|
+
export declare function ongletsDe(app: AppOuverte): Onglet[];
|
|
13
|
+
export declare function sEpingle(session: Session, ici: string): boolean;
|
|
14
|
+
export type CadreDeLaPage = {
|
|
15
|
+
app?: AppOuverte;
|
|
16
|
+
onglets: Onglet[];
|
|
17
|
+
actif?: Onglet;
|
|
18
|
+
surLOnglet: boolean;
|
|
19
|
+
debut: SegmentDuFil[];
|
|
20
|
+
dernier?: string;
|
|
21
|
+
nomDeLEpingle?: string;
|
|
22
|
+
};
|
|
23
|
+
export declare function cadreDe(session: Session, ici: string): CadreDeLaPage;
|
|
24
|
+
export type EcranDeclare = {
|
|
25
|
+
nom?: string;
|
|
26
|
+
introuvable?: boolean;
|
|
27
|
+
};
|
|
28
|
+
export type Cadre = {
|
|
29
|
+
fin: HTMLElement | null;
|
|
30
|
+
gestes: HTMLElement | null;
|
|
31
|
+
declarer: (ecran: EcranDeclare) => void;
|
|
32
|
+
};
|
|
33
|
+
export declare const ContexteDuCadre: import("react").Context<Cadre | null>;
|
|
34
|
+
export declare function useCadre(): Cadre | null;
|
|
35
|
+
export declare function useDeclarerLEcran(ecran: EcranDeclare): void;
|
|
36
|
+
export declare function DansLeFil({ children }: {
|
|
37
|
+
children: ReactNode;
|
|
38
|
+
}): import("react").ReactPortal | null;
|
|
39
|
+
export declare function DansLesGestes({ children }: {
|
|
40
|
+
children: ReactNode;
|
|
41
|
+
}): import("react").ReactPortal | null;
|
|
42
|
+
export declare const separateurDuFil: import("react").JSX.Element;
|
|
43
|
+
export declare const classesDuTitre = "m-0 min-w-0 truncate text-[15px] leading-[1.4] font-semibold text-encre";
|
|
44
|
+
export declare function TitreDuFil({ children }: {
|
|
45
|
+
children: ReactNode;
|
|
46
|
+
}): import("react").JSX.Element;
|
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
import { jsx as _jsx } from "react/jsx-runtime";
|
|
2
|
+
import { createContext, useContext, useEffect } from 'react';
|
|
3
|
+
import { createPortal } from 'react-dom';
|
|
4
|
+
import { entreeActive } from './entree-active.js';
|
|
5
|
+
import { adresseDeLaListe } from './ouvrir.js';
|
|
6
|
+
// L'app de la page, d'après son chemin : `/documentation/<app>`, ou `/<app>/…` pour une app ouverte
|
|
7
|
+
// à la personne. Le core, ses écrans (`/journal`, `/compte`) et l'accueil n'en ont pas.
|
|
8
|
+
export function appDuChemin(session, ici) {
|
|
9
|
+
const [, premier, second] = ici.split('/');
|
|
10
|
+
const nom = premier === 'documentation' ? second : premier;
|
|
11
|
+
return session.apps.find((app) => app.nom === nom);
|
|
12
|
+
}
|
|
13
|
+
// Les onglets d'une app, dans leur ordre : ses écrans, « Réglages » quand la personne a le droit de
|
|
14
|
+
// les voir, et « Documentation ».
|
|
15
|
+
export function ongletsDe(app) {
|
|
16
|
+
return [
|
|
17
|
+
...app.ecrans.map((ecran) => ({ titre: ecran.titre, chemin: ecran.chemin })),
|
|
18
|
+
...(app.reglages ? [{ titre: 'Réglages', chemin: `/${app.nom}/reglages` }] : []),
|
|
19
|
+
{ titre: 'Documentation', chemin: `/documentation/${app.nom}` },
|
|
20
|
+
];
|
|
21
|
+
}
|
|
22
|
+
// Les écrans de l'OS qui s'épinglent, avec tout chemin d'une app ouverte et sa documentation : la
|
|
23
|
+
// règle du core (core/src/barre.ts). « Mon compte » et « Équipe » ne s'épinglent pas.
|
|
24
|
+
const ecransDeLOS = ['/bienvenue', '/apps', '/journal'];
|
|
25
|
+
export function sEpingle(session, ici) {
|
|
26
|
+
return ecransDeLOS.includes(ici) || appDuChemin(session, ici) !== undefined;
|
|
27
|
+
}
|
|
28
|
+
// Le lien d'un onglet dans le fil : celui de la liste d'une app à choses mène à la liste telle qu'on
|
|
29
|
+
// l'a quittée.
|
|
30
|
+
function lienDeLOnglet(app, onglet) {
|
|
31
|
+
return app.ecrans.some((ecran) => ecran.nom === 'liste' && ecran.chemin === onglet.chemin) ? adresseDeLaListe(app.nom) : onglet.chemin;
|
|
32
|
+
}
|
|
33
|
+
// Le cadre d'une page. Sur une page d'une app : le titre de l'app, puis l'onglet actif quand son
|
|
34
|
+
// titre n'est pas celui de l'app, puis, sur un écran qui n'est pas l'onglet lui-même, le titre que
|
|
35
|
+
// l'écran donne. Sur une page du core, le titre de l'écran seul.
|
|
36
|
+
export function cadreDe(session, ici) {
|
|
37
|
+
const app = appDuChemin(session, ici);
|
|
38
|
+
if (!app) {
|
|
39
|
+
return { onglets: [], surLOnglet: false, debut: [] };
|
|
40
|
+
}
|
|
41
|
+
const onglets = ongletsDe(app);
|
|
42
|
+
// L'onglet du chemin ; sinon le premier écran de l'app sous le même `/<app>/`, comme « Pages » sur
|
|
43
|
+
// l'écran d'une page (`/pages/<id>`).
|
|
44
|
+
const exact = onglets.find((onglet) => onglet.chemin === ici);
|
|
45
|
+
const cheminActif = exact?.chemin ?? entreeActive(app.ecrans.map((ecran) => ecran.chemin), ici);
|
|
46
|
+
const actif = onglets.find((onglet) => onglet.chemin === cheminActif);
|
|
47
|
+
const premier = onglets[0];
|
|
48
|
+
const titreDeLApp = { titre: app.titre, chemin: premier ? lienDeLOnglet(app, premier) : app.lien };
|
|
49
|
+
const ongletDistinct = actif && actif.titre !== app.titre ? actif : undefined;
|
|
50
|
+
if (exact) {
|
|
51
|
+
return {
|
|
52
|
+
app,
|
|
53
|
+
onglets,
|
|
54
|
+
actif,
|
|
55
|
+
surLOnglet: true,
|
|
56
|
+
debut: ongletDistinct ? [titreDeLApp] : [],
|
|
57
|
+
dernier: ongletDistinct ? ongletDistinct.titre : app.titre,
|
|
58
|
+
nomDeLEpingle: exact.chemin === app.ecrans[0]?.chemin ? app.titre : `${app.titre} · ${exact.titre}`,
|
|
59
|
+
};
|
|
60
|
+
}
|
|
61
|
+
return {
|
|
62
|
+
app,
|
|
63
|
+
onglets,
|
|
64
|
+
actif,
|
|
65
|
+
surLOnglet: false,
|
|
66
|
+
debut: [titreDeLApp, ...(ongletDistinct ? [{ titre: ongletDistinct.titre, chemin: lienDeLOnglet(app, ongletDistinct) }] : [])],
|
|
67
|
+
};
|
|
68
|
+
}
|
|
69
|
+
export const ContexteDuCadre = createContext(null);
|
|
70
|
+
export function useCadre() {
|
|
71
|
+
return useContext(ContexteDuCadre);
|
|
72
|
+
}
|
|
73
|
+
// L'écran dit ce que la coquille ne sait pas de lui, tant qu'il est rendu.
|
|
74
|
+
export function useDeclarerLEcran(ecran) {
|
|
75
|
+
const cadre = useCadre();
|
|
76
|
+
const { nom, introuvable } = ecran;
|
|
77
|
+
useEffect(() => {
|
|
78
|
+
if (!cadre) {
|
|
79
|
+
return undefined;
|
|
80
|
+
}
|
|
81
|
+
cadre.declarer({ nom, introuvable });
|
|
82
|
+
return () => cadre.declarer({});
|
|
83
|
+
}, [cadre?.declarer, nom, introuvable]);
|
|
84
|
+
}
|
|
85
|
+
// Rendre à la fin du fil, et dans les gestes de l'écran : par un portail, dans l'emplacement que
|
|
86
|
+
// donne la coquille.
|
|
87
|
+
export function DansLeFil({ children }) {
|
|
88
|
+
const cadre = useCadre();
|
|
89
|
+
return cadre?.fin ? createPortal(children, cadre.fin) : null;
|
|
90
|
+
}
|
|
91
|
+
export function DansLesGestes({ children }) {
|
|
92
|
+
const cadre = useCadre();
|
|
93
|
+
return cadre?.gestes ? createPortal(children, cadre.gestes) : null;
|
|
94
|
+
}
|
|
95
|
+
// Le séparateur du fil, et le dernier segment, le `<h1>` de l'écran.
|
|
96
|
+
export const separateurDuFil = _jsx("span", { "aria-hidden": "true", className: "text-trait-champ max-[760px]:hidden", children: "/" });
|
|
97
|
+
export const classesDuTitre = 'm-0 min-w-0 truncate text-[15px] leading-[1.4] font-semibold text-encre';
|
|
98
|
+
export function TitreDuFil({ children }) {
|
|
99
|
+
return _jsx("h1", { className: classesDuTitre, children: children });
|
|
100
|
+
}
|
package/src/espace/choses.d.ts
CHANGED
|
@@ -35,6 +35,7 @@ export type CiblesDuPartage = {
|
|
|
35
35
|
export type ColonneDUneChose<C extends ChoseTrouvee = ChoseTrouvee> = {
|
|
36
36
|
titre: string;
|
|
37
37
|
fixe?: boolean;
|
|
38
|
+
tete?: boolean;
|
|
38
39
|
valeur: (chose: C) => ReactNode;
|
|
39
40
|
};
|
|
40
41
|
export type VueDeLaListe = {
|
|
@@ -68,6 +69,7 @@ export type DeclarationDesChoses<C extends ChoseTrouvee = ChoseTrouvee> = {
|
|
|
68
69
|
titre: string;
|
|
69
70
|
valeur: (chose: C) => ReactNode;
|
|
70
71
|
} | false;
|
|
72
|
+
sousLigne?: (chose: C) => ReactNode;
|
|
71
73
|
plein?: boolean;
|
|
72
74
|
libelleDeLaPleinePage?: string;
|
|
73
75
|
publication?: MotsDeLaPublication;
|
|
@@ -111,6 +113,9 @@ export type RechercheDeLaListe = {
|
|
|
111
113
|
page?: number;
|
|
112
114
|
};
|
|
113
115
|
export declare function rechercheDeLaListe(recherche: Record<string, unknown>): RechercheDeLaListe;
|
|
116
|
+
export declare function critereDeLaListe(vues: VueDeLaListe[] | undefined, recherche: RechercheDeLaListe): CritereDeRecherche;
|
|
117
|
+
export declare function dateDe<C extends ChoseTrouvee>(choses: DeclarationDesChoses<C>, chose: C): ReactNode;
|
|
118
|
+
export declare function texteDuNoeud(noeud: ReactNode): string;
|
|
114
119
|
export declare function chercherParLOutil<C extends ChoseTrouvee>(critere: CritereDeRecherche): Promise<ChosesTrouvees<C>>;
|
|
115
120
|
export declare function estRangee<C extends ChoseTrouvee>(choses: DeclarationDesChoses<C>, chose: C): boolean;
|
|
116
121
|
export declare function motsDe(declaration: {
|
package/src/espace/choses.js
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { useQueryClient } from '@tanstack/react-query';
|
|
2
|
+
import { jourEtHeure } from '../format.js';
|
|
2
3
|
import { appeler, texteDe } from './appels.js';
|
|
3
4
|
// Les mots de la publication d'une app, ses défauts compris.
|
|
4
5
|
export function motsDeLaPublication(publication = {}) {
|
|
@@ -25,6 +26,33 @@ export function rechercheDeLaListe(recherche) {
|
|
|
25
26
|
...(Number.isInteger(page) && page > 1 ? { page } : {}),
|
|
26
27
|
};
|
|
27
28
|
}
|
|
29
|
+
// Le critère que `chercher` reçoit pour une recherche de la liste : la vue par défaut ne s'y dit
|
|
30
|
+
// pas. La liste et la barre de la liste le lisent sous la même clé.
|
|
31
|
+
export function critereDeLaListe(vues, recherche) {
|
|
32
|
+
const premiere = vues?.[0]?.valeur;
|
|
33
|
+
const vue = recherche.vue && vues?.some((une) => une.valeur === recherche.vue) ? recherche.vue : undefined;
|
|
34
|
+
return { ...(recherche.texte ? { texte: recherche.texte } : {}), ...(vue && vue !== premiere ? { vue } : {}), page: recherche.page ?? 1 };
|
|
35
|
+
}
|
|
36
|
+
// La date d'une chose : celle que l'app déclare, sinon sa dernière modification, sinon aucune.
|
|
37
|
+
export function dateDe(choses, chose) {
|
|
38
|
+
if (choses.date === false) {
|
|
39
|
+
return undefined;
|
|
40
|
+
}
|
|
41
|
+
return choses.date ? choses.date.valeur(chose) : chose.modifie_le ? jourEtHeure(chose.modifie_le) : undefined;
|
|
42
|
+
}
|
|
43
|
+
// Le texte d'un état que rend l'app, comme « Invités par un lien » dans son étiquette.
|
|
44
|
+
export function texteDuNoeud(noeud) {
|
|
45
|
+
if (typeof noeud === 'string' || typeof noeud === 'number') {
|
|
46
|
+
return String(noeud);
|
|
47
|
+
}
|
|
48
|
+
if (Array.isArray(noeud)) {
|
|
49
|
+
return noeud.map(texteDuNoeud).join('');
|
|
50
|
+
}
|
|
51
|
+
if (noeud && typeof noeud === 'object' && 'props' in noeud) {
|
|
52
|
+
return texteDuNoeud(noeud.props.children);
|
|
53
|
+
}
|
|
54
|
+
return '';
|
|
55
|
+
}
|
|
28
56
|
// `chercher` par défaut : l'outil `chercher` de l'app, son texte lu en JSON.
|
|
29
57
|
export async function chercherParLOutil(critere) {
|
|
30
58
|
const resultat = await appeler('chercher', {
|