@indos/bibliotheque 1.3.0 → 1.4.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 +15 -0
- package/package.json +1 -1
- package/src/espace/appels.d.ts +2 -0
- package/src/espace/appels.js +11 -3
- package/src/espace/barre.d.ts +29 -0
- package/src/espace/barre.js +40 -0
- package/src/espace/choses.d.ts +98 -0
- package/src/espace/choses.js +47 -0
- package/src/espace/coquille.js +17 -9
- package/src/espace/ecran-d-une-chose.d.ts +6 -0
- package/src/espace/ecran-d-une-chose.js +45 -0
- package/src/espace/en-tete-de-l-app.js +21 -3
- package/src/espace/index.d.ts +10 -2
- package/src/espace/index.js +13 -4
- package/src/espace/liste-des-choses.d.ts +4 -0
- package/src/espace/liste-des-choses.js +109 -0
- package/src/espace/menu-d-une-chose.d.ts +8 -0
- package/src/espace/menu-d-une-chose.js +53 -0
- package/src/espace/ouvrir.d.ts +7 -0
- package/src/espace/ouvrir.js +54 -0
- package/src/espace/page.d.ts +3 -1
- package/src/espace/page.js +12 -1
- package/src/espace/panneau-du-partage.d.ts +15 -0
- package/src/espace/panneau-du-partage.js +117 -0
- package/src/espace/routes-des-choses.d.ts +5 -0
- package/src/espace/routes-des-choses.js +19 -0
- package/src/mcp.d.ts +5 -2
- package/src/mcp.js +2 -1
- package/src/ui/confirmation.d.ts +3 -2
- package/src/ui/confirmation.js +3 -2
- package/src/ui/fenetre.d.ts +3 -2
- package/src/ui/fenetre.js +3 -2
- package/src/ui/focus.d.ts +2 -0
- package/src/ui/focus.js +9 -0
- package/src/ui/panneau.d.ts +3 -2
- package/src/ui/panneau.js +4 -3
- package/src/ui/tableau.d.ts +2 -1
- package/src/ui/tableau.js +25 -4
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,21 @@
|
|
|
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.4.0
|
|
6
|
+
|
|
7
|
+
- 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 ».
|
|
8
|
+
- 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.
|
|
9
|
+
- En bas de la barre, au-dessus du nom : « Toutes les apps » (`/apps`) et « Configurer l'espace » (`/reglages`).
|
|
10
|
+
- `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.
|
|
11
|
+
- `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.
|
|
12
|
+
|
|
13
|
+
### Ruptures
|
|
14
|
+
|
|
15
|
+
- 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`.
|
|
16
|
+
- 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 ».
|
|
17
|
+
- Les versions de React, Vite et TanStack ne changent pas ; `npm view @indos/bibliotheque@1.4.0 peerDependencies` les donne toutes.
|
|
18
|
+
- Pour monter : `"@indos/bibliotheque": "1.4.0"` dans ses `dependencies`, puis `npm install` et `npm run build`.
|
|
19
|
+
|
|
5
20
|
## 1.3.0
|
|
6
21
|
|
|
7
22
|
- 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`.
|
package/package.json
CHANGED
package/src/espace/appels.d.ts
CHANGED
|
@@ -18,6 +18,8 @@ export declare function texteDe(resultat: ResultatDUnOutil): string;
|
|
|
18
18
|
export declare function demander<T>(chemin: string, options?: {
|
|
19
19
|
methode?: 'GET' | 'POST';
|
|
20
20
|
corps?: unknown;
|
|
21
|
+
sansConnexion?: boolean;
|
|
21
22
|
}): Promise<T>;
|
|
22
23
|
export declare function faireUnGeste<T = Record<string, unknown>>(chemin: string, corps?: Record<string, unknown>): Promise<T>;
|
|
23
24
|
export declare function appeler(outil: string, arguments_?: Record<string, unknown>): Promise<ResultatDUnOutil>;
|
|
25
|
+
export declare function appelerUneApp(app: string, outil: string, arguments_?: Record<string, unknown>): Promise<ResultatDUnOutil>;
|
package/src/espace/appels.js
CHANGED
|
@@ -30,8 +30,9 @@ export function allerALaConnexion() {
|
|
|
30
30
|
export function texteDe(resultat) {
|
|
31
31
|
return resultat.content.flatMap((partie) => (partie.type === 'text' && partie.text ? [partie.text] : [])).join('\n');
|
|
32
32
|
}
|
|
33
|
-
// Un appel en JSON à la même origine. Un 401 mène à la connexion
|
|
34
|
-
// `ErreurDUnAppel
|
|
33
|
+
// Un appel en JSON à la même origine. Un 401 mène à la connexion, sauf `sansConnexion`, où il lève
|
|
34
|
+
// `ErreurDUnAppel` comme toute autre réponse que 200, avec l'`erreur` rendue, ou le texte du
|
|
35
|
+
// résultat d'un outil refusé.
|
|
35
36
|
export async function demander(chemin, options = {}) {
|
|
36
37
|
const methode = options.methode ?? 'POST';
|
|
37
38
|
let reponse;
|
|
@@ -46,7 +47,7 @@ export async function demander(chemin, options = {}) {
|
|
|
46
47
|
catch {
|
|
47
48
|
throw new ErreurDUnAppel(0, 'Le serveur ne répond pas. Vérifier la connexion, puis réessayer.');
|
|
48
49
|
}
|
|
49
|
-
if (reponse.status === 401) {
|
|
50
|
+
if (reponse.status === 401 && !options.sansConnexion) {
|
|
50
51
|
allerALaConnexion();
|
|
51
52
|
return new Promise(() => { });
|
|
52
53
|
}
|
|
@@ -79,3 +80,10 @@ export function faireUnGeste(chemin, corps = {}) {
|
|
|
79
80
|
export function appeler(outil, arguments_ = {}) {
|
|
80
81
|
return demander(`${base}outils/${encodeURIComponent(outil)}`, { corps: arguments_ });
|
|
81
82
|
}
|
|
83
|
+
// L'appel d'un outil d'une autre app de la même origine, avec les droits de la personne :
|
|
84
|
+
// `POST /<app>/outils/<outil>`, comme le ferait l'écran de cette app. Toute autre réponse que 200,
|
|
85
|
+
// un 401 compris, lève `ErreurDUnAppel` sans mener à la connexion : une app en panne, fermée à la
|
|
86
|
+
// personne ou qui refuse ne fait pas quitter l'écran qui l'appelle.
|
|
87
|
+
export function appelerUneApp(app, outil, arguments_ = {}) {
|
|
88
|
+
return demander(`/${encodeURIComponent(app)}/outils/${encodeURIComponent(outil)}`, { corps: arguments_, sansConnexion: true });
|
|
89
|
+
}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
export type Epingle = {
|
|
2
|
+
chemin: string;
|
|
3
|
+
nom: string;
|
|
4
|
+
};
|
|
5
|
+
export type AnnuaireDeLEcran = {
|
|
6
|
+
personnes: {
|
|
7
|
+
id: string;
|
|
8
|
+
nom: string;
|
|
9
|
+
email: string;
|
|
10
|
+
}[];
|
|
11
|
+
groupes: {
|
|
12
|
+
id: string;
|
|
13
|
+
nom: string;
|
|
14
|
+
}[];
|
|
15
|
+
};
|
|
16
|
+
export declare function epingler(epingle: Epingle): Promise<unknown>;
|
|
17
|
+
export declare function desepingler(epingle: Pick<Epingle, 'chemin'>): Promise<unknown>;
|
|
18
|
+
export declare function lireLAnnuaire(): Promise<AnnuaireDeLEcran>;
|
|
19
|
+
export declare function estEpingle(barre: {
|
|
20
|
+
chemin: string;
|
|
21
|
+
}[], chemin: string): boolean;
|
|
22
|
+
export declare function useEpingle(chemin: string, suites?: {
|
|
23
|
+
fait?: (epinglee: boolean) => void;
|
|
24
|
+
echec?: (texte: string) => void;
|
|
25
|
+
}): {
|
|
26
|
+
epinglee: boolean;
|
|
27
|
+
basculer: (nom: string) => void;
|
|
28
|
+
enCours: boolean;
|
|
29
|
+
};
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
import { useMutation, useQueryClient } from '@tanstack/react-query';
|
|
2
|
+
import { faireUnGeste } from './appels.js';
|
|
3
|
+
import { cheminDe } from './entree-active.js';
|
|
4
|
+
import { requeteDeLaSession, useSession } from './session.js';
|
|
5
|
+
// `POST /espace/epingler`, `{ chemin, nom }` : l'épingle à la fin de la barre.
|
|
6
|
+
export function epingler(epingle) {
|
|
7
|
+
return faireUnGeste('/espace/epingler', { chemin: epingle.chemin, nom: epingle.nom });
|
|
8
|
+
}
|
|
9
|
+
// `POST /espace/desepingler`, `{ chemin }` : l'épingle retirée de la barre.
|
|
10
|
+
export function desepingler(epingle) {
|
|
11
|
+
return faireUnGeste('/espace/desepingler', { chemin: epingle.chemin });
|
|
12
|
+
}
|
|
13
|
+
// `POST /espace/annuaire`, `{}` : les personnes actives (`id`, `nom`, `email`) et les groupes (`id`,
|
|
14
|
+
// `nom`), pour le panneau du partage.
|
|
15
|
+
export function lireLAnnuaire() {
|
|
16
|
+
return faireUnGeste('/espace/annuaire');
|
|
17
|
+
}
|
|
18
|
+
// Si un chemin est épinglé dans la barre de la session.
|
|
19
|
+
export function estEpingle(barre, chemin) {
|
|
20
|
+
return barre.some((entree) => cheminDe(entree.chemin) === chemin);
|
|
21
|
+
}
|
|
22
|
+
// Pour un écran : l'épingle d'un chemin, et le geste qui l'ajoute ou la retire, après lequel la
|
|
23
|
+
// session se relit, et la barre avec elle. `suites.fait` reçoit l'état nouveau, `suites.echec` le
|
|
24
|
+
// texte d'un geste refusé, mot pour mot.
|
|
25
|
+
export function useEpingle(chemin, suites = {}) {
|
|
26
|
+
const session = useSession();
|
|
27
|
+
const client = useQueryClient();
|
|
28
|
+
const geste = useMutation({
|
|
29
|
+
mutationFn: ({ epinglee, nom }) => (epinglee ? desepingler({ chemin }) : epingler({ chemin, nom })),
|
|
30
|
+
onSuccess: (_rendu, { epinglee }) => suites.fait?.(!epinglee),
|
|
31
|
+
onError: (erreur) => suites.echec?.(erreur.message),
|
|
32
|
+
onSettled: () => client.invalidateQueries({ queryKey: requeteDeLaSession.queryKey }),
|
|
33
|
+
});
|
|
34
|
+
const epinglee = estEpingle(session.barre, chemin);
|
|
35
|
+
return {
|
|
36
|
+
epinglee,
|
|
37
|
+
basculer: (nom) => geste.mutate({ epinglee, nom }),
|
|
38
|
+
enCours: geste.isPending,
|
|
39
|
+
};
|
|
40
|
+
}
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
import type { ReactNode } from 'react';
|
|
2
|
+
export type DroitSurUneChose = 'proprietaire' | 'modification' | 'lecture';
|
|
3
|
+
export type ChoseTrouvee = {
|
|
4
|
+
id: string;
|
|
5
|
+
nom: string;
|
|
6
|
+
chemin: string;
|
|
7
|
+
droit?: DroitSurUneChose;
|
|
8
|
+
auteur?: string;
|
|
9
|
+
partagee?: boolean;
|
|
10
|
+
publiee?: boolean;
|
|
11
|
+
adresse_publique?: string;
|
|
12
|
+
modifie_le?: string;
|
|
13
|
+
[champ: string]: unknown;
|
|
14
|
+
};
|
|
15
|
+
export type ChosesTrouvees<C extends ChoseTrouvee = ChoseTrouvee> = {
|
|
16
|
+
lignes: C[];
|
|
17
|
+
total: number;
|
|
18
|
+
};
|
|
19
|
+
export type CritereDeRecherche = {
|
|
20
|
+
texte?: string;
|
|
21
|
+
vue?: string;
|
|
22
|
+
page: number;
|
|
23
|
+
};
|
|
24
|
+
export type OuvertureDUneChose = {
|
|
25
|
+
avec: 'equipe' | 'groupe' | 'personne';
|
|
26
|
+
nom: string;
|
|
27
|
+
email?: string;
|
|
28
|
+
droit: 'lecture' | 'modification';
|
|
29
|
+
};
|
|
30
|
+
export type CiblesDuPartage = {
|
|
31
|
+
personnes?: string[];
|
|
32
|
+
groupes?: string[];
|
|
33
|
+
equipe?: true;
|
|
34
|
+
};
|
|
35
|
+
export type ColonneDUneChose<C extends ChoseTrouvee = ChoseTrouvee> = {
|
|
36
|
+
titre: string;
|
|
37
|
+
fixe?: boolean;
|
|
38
|
+
valeur: (chose: C) => ReactNode;
|
|
39
|
+
};
|
|
40
|
+
export type VueDeLaListe = {
|
|
41
|
+
valeur: string;
|
|
42
|
+
titre: string;
|
|
43
|
+
};
|
|
44
|
+
export type DeclarationDesChoses<C extends ChoseTrouvee = ChoseTrouvee> = {
|
|
45
|
+
app: string;
|
|
46
|
+
une: string;
|
|
47
|
+
feminin?: boolean;
|
|
48
|
+
colonnes?: ColonneDUneChose<C>[];
|
|
49
|
+
vues?: VueDeLaListe[];
|
|
50
|
+
etat?: (chose: C) => ReactNode;
|
|
51
|
+
date?: {
|
|
52
|
+
titre: string;
|
|
53
|
+
valeur: (chose: C) => ReactNode;
|
|
54
|
+
} | false;
|
|
55
|
+
plein?: boolean;
|
|
56
|
+
libelleDeLaPleinePage?: string;
|
|
57
|
+
publication?: {
|
|
58
|
+
verbe: string;
|
|
59
|
+
consequence: string;
|
|
60
|
+
};
|
|
61
|
+
chercher?: (critere: CritereDeRecherche) => Promise<ChosesTrouvees<C>>;
|
|
62
|
+
lire: (id: string) => Promise<C | undefined>;
|
|
63
|
+
corps: (chose: C) => ReactNode;
|
|
64
|
+
pleinePage?: (chose: C) => string | undefined;
|
|
65
|
+
renommer?: (chose: C, nom: string) => Promise<unknown>;
|
|
66
|
+
supprimer?: (chose: C) => Promise<unknown>;
|
|
67
|
+
lirePartage?: (chose: C) => Promise<OuvertureDUneChose[]>;
|
|
68
|
+
partager?: (chose: C, cibles: CiblesDuPartage & {
|
|
69
|
+
droit: 'lecture' | 'modification';
|
|
70
|
+
confirmer?: true;
|
|
71
|
+
}) => Promise<unknown>;
|
|
72
|
+
nePlusPartager?: (chose: C, cibles: CiblesDuPartage) => Promise<unknown>;
|
|
73
|
+
publier?: (chose: C, oui: boolean, confirmer: boolean) => Promise<unknown>;
|
|
74
|
+
nouveau?: () => Promise<{
|
|
75
|
+
chemin: string;
|
|
76
|
+
} | undefined | void>;
|
|
77
|
+
geste?: (chose: C) => ReactNode;
|
|
78
|
+
};
|
|
79
|
+
export declare function vuesDuPartage(feminin?: boolean): VueDeLaListe[];
|
|
80
|
+
export type RechercheDeLaListe = {
|
|
81
|
+
texte?: string;
|
|
82
|
+
vue?: string;
|
|
83
|
+
page?: number;
|
|
84
|
+
};
|
|
85
|
+
export declare function rechercheDeLaListe(recherche: Record<string, unknown>): RechercheDeLaListe;
|
|
86
|
+
export declare function chercherParLOutil<C extends ChoseTrouvee>(critere: CritereDeRecherche): Promise<ChosesTrouvees<C>>;
|
|
87
|
+
export declare function motsDe(declaration: {
|
|
88
|
+
une: string;
|
|
89
|
+
feminin?: boolean;
|
|
90
|
+
}): {
|
|
91
|
+
e: string;
|
|
92
|
+
laChose: string;
|
|
93
|
+
titre: string;
|
|
94
|
+
aucune: string;
|
|
95
|
+
nouvelle: string;
|
|
96
|
+
pronom: string;
|
|
97
|
+
};
|
|
98
|
+
export declare function cleDesChoses(app: string, ...suite: unknown[]): unknown[];
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
import { appeler, texteDe } from './appels.js';
|
|
2
|
+
// Les vues d'une app qui partage : toutes, à moi, partagées avec moi.
|
|
3
|
+
export function vuesDuPartage(feminin = false) {
|
|
4
|
+
return [
|
|
5
|
+
{ valeur: 'toutes', titre: feminin ? 'Toutes' : 'Tous' },
|
|
6
|
+
{ valeur: 'a_moi', titre: 'À moi' },
|
|
7
|
+
{ valeur: 'partagees', titre: feminin ? 'Partagées avec moi' : 'Partagés avec moi' },
|
|
8
|
+
];
|
|
9
|
+
}
|
|
10
|
+
export function rechercheDeLaListe(recherche) {
|
|
11
|
+
const page = Number(recherche.page);
|
|
12
|
+
return {
|
|
13
|
+
...(typeof recherche.texte === 'string' && recherche.texte ? { texte: recherche.texte } : {}),
|
|
14
|
+
...(typeof recherche.vue === 'string' && recherche.vue ? { vue: recherche.vue } : {}),
|
|
15
|
+
...(Number.isInteger(page) && page > 1 ? { page } : {}),
|
|
16
|
+
};
|
|
17
|
+
}
|
|
18
|
+
// `chercher` par défaut : l'outil `chercher` de l'app, son texte lu en JSON.
|
|
19
|
+
export async function chercherParLOutil(critere) {
|
|
20
|
+
const resultat = await appeler('chercher', {
|
|
21
|
+
...(critere.texte ? { texte: critere.texte } : {}),
|
|
22
|
+
...(critere.vue ? { vue: critere.vue } : {}),
|
|
23
|
+
page: critere.page,
|
|
24
|
+
});
|
|
25
|
+
return JSON.parse(texteDe(resultat));
|
|
26
|
+
}
|
|
27
|
+
// Les mots d'une chose, selon son genre.
|
|
28
|
+
export function motsDe(declaration) {
|
|
29
|
+
const { une, feminin = false } = declaration;
|
|
30
|
+
const e = feminin ? 'e' : '';
|
|
31
|
+
const la = /^[aeiouyàâéèêëîïôûü]/i.test(une) ? 'l\'' : feminin ? 'la ' : 'le ';
|
|
32
|
+
return {
|
|
33
|
+
e,
|
|
34
|
+
// « la page », « le tableau », « l'image ».
|
|
35
|
+
laChose: `${la}${une}`,
|
|
36
|
+
// « Page », pour l'en-tête de la colonne.
|
|
37
|
+
titre: une.charAt(0).toLocaleUpperCase('fr') + une.slice(1),
|
|
38
|
+
aucune: `${feminin ? 'Aucune' : 'Aucun'} ${une}`,
|
|
39
|
+
nouvelle: `${feminin ? 'Nouvelle' : 'Nouveau'} ${une}`,
|
|
40
|
+
// Le pronom : « la », « le ».
|
|
41
|
+
pronom: feminin ? 'la' : 'le',
|
|
42
|
+
};
|
|
43
|
+
}
|
|
44
|
+
// Les clés des requêtes des choses d'une app, que chaque geste relit.
|
|
45
|
+
export function cleDesChoses(app, ...suite) {
|
|
46
|
+
return ['choses', app, ...suite];
|
|
47
|
+
}
|
package/src/espace/coquille.js
CHANGED
|
@@ -1,40 +1,48 @@
|
|
|
1
1
|
import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
|
|
2
2
|
import { Outlet, useLocation, useMatches } from '@tanstack/react-router';
|
|
3
3
|
import { Suspense, useEffect, useId, useState } from 'react';
|
|
4
|
+
import { Annonce } from '../ui/annonce.js';
|
|
4
5
|
import { cn } from '../ui/classes.js';
|
|
5
6
|
import { Menu, MenuContenu, MenuDeclencheur, MenuEntree, MenuLibelle, MenuSeparateur } from '../ui/menu.js';
|
|
6
7
|
import { usePiece } from './contexte.js';
|
|
7
8
|
import { EnTeteDeLApp } from './en-tete-de-l-app.js';
|
|
8
9
|
import { entreeActive } from './entree-active.js';
|
|
9
10
|
import { LienDansLaPage } from './lien.js';
|
|
11
|
+
import { ContexteDeLAnnonce } from './ouvrir.js';
|
|
10
12
|
import { useSession } from './session.js';
|
|
11
13
|
// La coquille de la page, rendue d'après la session (docs/architecture.md, « L'espace ») : la barre,
|
|
12
14
|
// à la hauteur de l'écran, repliée en menu sur un téléphone ; puis, sur une page d'une app, son
|
|
13
|
-
// en-tête et ses onglets (`EnTeteDeLApp`) ; l'écran (son en-tête et son
|
|
14
|
-
// pied, la version de la pièce. L'entrée active (`entreeActive`) est marquée
|
|
15
|
+
// en-tête et ses onglets (`EnTeteDeLApp`), sauf sur l'écran d'une chose ; l'écran (son en-tête et son
|
|
16
|
+
// contenu, `Ecran`) et, au pied, la version de la pièce. L'entrée active (`entreeActive`) est marquée
|
|
17
|
+
// `aria-current="page"`. Un geste fait s'y annonce en bas de l'écran (`useAnnoncer`), d'un écran à
|
|
18
|
+
// l'autre.
|
|
15
19
|
// La largeur sous laquelle la barre se replie en menu, celle du tableau empilé (`ui/theme.css`).
|
|
16
20
|
const large = 'max-[760px]:hidden';
|
|
17
21
|
const etroit = 'min-[761px]:hidden';
|
|
18
|
-
// La barre : la marque, qui mène à l'accueil, les entrées de la barre, et en bas
|
|
19
|
-
// personne, qui ouvre son menu.
|
|
22
|
+
// La barre : la marque, qui mène à l'accueil, les entrées de la barre, et en bas « Toutes les apps »,
|
|
23
|
+
// « Configurer l'espace » et le nom de la personne, qui ouvre son menu.
|
|
20
24
|
export function CoquilleDeLEspace() {
|
|
21
25
|
const session = useSession();
|
|
22
26
|
const ici = useLocation({ select: (lieu) => lieu.pathname });
|
|
23
27
|
const active = entreeActive(session.barre.map((entree) => entree.chemin), ici);
|
|
24
28
|
const navigation = (_jsx("nav", { "aria-label": "Espace", className: "grid content-start gap-px", children: session.barre.map((entree) => (_jsx(EntreeDeLaBarre, { chemin: entree.chemin, active: entree.chemin === active, children: entree.titre }, entree.chemin))) }));
|
|
25
|
-
return (_jsx(Coquille, { haut: _jsx(Marque, { session: session, active: ici === '/' }), navigation: navigation, bas: _jsx(MenuDeLaPersonne, { session: session }) }));
|
|
29
|
+
return (_jsx(Coquille, { haut: _jsx(Marque, { session: session, active: ici === '/' }), navigation: navigation, bas: (_jsxs("div", { className: "grid gap-px border-t border-trait pt-3", children: [_jsx(EntreeDeLaBarre, { chemin: "/apps", active: ici === '/apps', children: "Toutes les apps" }), _jsx(EntreeDeLaBarre, { chemin: "/reglages", active: ici === '/reglages', children: "Configurer l'espace" }), _jsx(MenuDeLaPersonne, { session: session })] })) }));
|
|
26
30
|
}
|
|
27
31
|
// La structure : la barre large, à la hauteur de l'écran ; sur un téléphone, la barre repliée, son
|
|
28
32
|
// haut et le bouton « Menu », qui déplie les entrées ; l'en-tête de l'app, le contenu et son pied. Le
|
|
29
33
|
// contenu se lit sur 880 px au plus, sauf pour un écran déclaré en pleine largeur
|
|
30
34
|
// (`staticData: { pleineLargeur: true }`), comme la page hôte d'une page, qui encadre une page entière :
|
|
31
35
|
// son contenu est alors une colonne qui descend jusqu'au bas de la fenêtre, où un bloc qui prend
|
|
32
|
-
// `flex-1` occupe la hauteur qui reste, comme une toile.
|
|
33
|
-
//
|
|
36
|
+
// `flex-1` occupe la hauteur qui reste, comme une toile. L'écran d'une chose
|
|
37
|
+
// (`staticData: { ecranDUneChose: true }`) est de même sur toute la largeur, plus près des bords, sans
|
|
38
|
+
// l'en-tête de l'app : sa barre fine le remplace. Un écran qui attend ses données laisse la barre et
|
|
39
|
+
// l'en-tête de l'app affichés.
|
|
34
40
|
function Coquille({ haut, navigation, bas }) {
|
|
35
41
|
const piece = usePiece();
|
|
36
42
|
const pleineLargeur = useMatches({ select: (routes) => routes.some((route) => route.staticData?.pleineLargeur === true) });
|
|
37
|
-
|
|
43
|
+
const ecranDUneChose = useMatches({ select: (routes) => routes.some((route) => route.staticData?.ecranDUneChose === true) });
|
|
44
|
+
const [annonce, setAnnonce] = useState();
|
|
45
|
+
return (_jsx(ContexteDeLAnnonce.Provider, { value: setAnnonce, children: _jsxs("div", { className: "grid min-h-dvh grid-cols-[248px_minmax(0,1fr)] max-[760px]:grid-cols-[minmax(0,1fr)]", children: [_jsxs("aside", { className: cn('sticky top-0 flex h-dvh flex-col gap-[18px] overflow-y-auto border-r border-trait bg-surface px-3 py-3.5', large), children: [haut, _jsx("div", { className: "flex-1", children: navigation }), bas] }), _jsxs("div", { className: "flex min-h-dvh min-w-0 flex-col", children: [_jsx(BarreRepliee, { haut: haut, navigation: navigation, bas: bas }), _jsx("main", { className: cn('flex min-w-0 flex-1 flex-col px-10 pt-9 pb-14 max-[760px]:px-4 max-[760px]:pt-6 max-[760px]:pb-10', ecranDUneChose && 'px-6 pt-4 pb-6 max-[760px]:px-3 max-[760px]:pt-3 max-[760px]:pb-6'), children: _jsxs("div", { className: pleineLargeur || ecranDUneChose ? 'flex min-h-0 flex-1 flex-col' : 'max-w-[880px]', children: [!ecranDUneChose && _jsx(EnTeteDeLApp, {}), _jsxs(Suspense, { fallback: null, children: [_jsx(Outlet, {}), _jsxs("p", { className: "mt-10 mb-0 font-mono text-[11.5px] leading-[1.4] text-gris", children: [piece.nom, " ", piece.version] })] })] }) })] }), annonce && _jsx(Annonce, { message: annonce, onFin: () => setAnnonce(undefined) })] }) }));
|
|
38
46
|
}
|
|
39
47
|
// La barre repliée, sur un téléphone : son haut et « Menu », qui déplie les entrées et le bas de la
|
|
40
48
|
// barre. Elle se replie quand on change d'écran.
|
|
@@ -62,5 +70,5 @@ function EntreeDeLaBarre({ chemin, active, children }) {
|
|
|
62
70
|
// « Équipe » pour le propriétaire, et « Se déconnecter », un formulaire `POST /deconnexion` du core,
|
|
63
71
|
// sans script.
|
|
64
72
|
function MenuDeLaPersonne({ session }) {
|
|
65
|
-
return (_jsx("div", { className: "
|
|
73
|
+
return (_jsx("div", { className: "mt-2", children: _jsxs(Menu, { children: [_jsxs(MenuDeclencheur, { className: "flex h-9 w-full cursor-pointer items-center justify-between gap-2 rounded-md border-0 bg-transparent px-2 text-left font-medium text-encre hover:bg-survol data-[state=open]:bg-survol", children: [_jsx("span", { className: "truncate", children: session.nom }), _jsx("svg", { "aria-hidden": "true", viewBox: "0 0 16 16", className: "size-4 flex-none text-gris", children: _jsx("path", { d: "M4 6l4 4 4-4", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round" }) })] }), _jsxs(MenuContenu, { side: "top", align: "start", className: "w-[224px]", children: [_jsx(MenuLibelle, { className: "font-mono", children: session.email }), _jsx(MenuSeparateur, {}), _jsx(MenuEntree, { asChild: true, children: _jsx(LienDansLaPage, { href: "/compte", children: "Mon compte" }) }), session.proprietaire && (_jsx(MenuEntree, { asChild: true, children: _jsx(LienDansLaPage, { href: "/equipe", children: "\u00C9quipe" }) })), _jsx(MenuSeparateur, {}), _jsx("form", { method: "post", action: "/deconnexion", children: _jsx(MenuEntree, { asChild: true, onSelect: (evenement) => evenement.preventDefault(), children: _jsx("button", { type: "submit", children: "Se d\u00E9connecter" }) }) })] })] }) }));
|
|
66
74
|
}
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
import { type ChoseTrouvee, type DeclarationDesChoses } from './choses.ts';
|
|
2
|
+
export declare const texteDUneChoseAbsente = "Cette chose n'existe pas, ou vous n'y avez pas acc\u00E8s.";
|
|
3
|
+
export declare function EcranDUneChose<C extends ChoseTrouvee>({ choses, id }: {
|
|
4
|
+
choses: DeclarationDesChoses<C>;
|
|
5
|
+
id: string;
|
|
6
|
+
}): import("react").JSX.Element;
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
|
|
2
|
+
import { useQuery } from '@tanstack/react-query';
|
|
3
|
+
import { useState } from 'react';
|
|
4
|
+
import { Message } from '../ui/blocs.js';
|
|
5
|
+
import { Bouton } from '../ui/bouton.js';
|
|
6
|
+
import { Lien } from '../ui/lien.js';
|
|
7
|
+
import { ErreurDUnAppel } from './appels.js';
|
|
8
|
+
import { cleDesChoses } from './choses.js';
|
|
9
|
+
import { MenuDUneChose } from './menu-d-une-chose.js';
|
|
10
|
+
import { adresseDeLaListe, titreDeLaListe, useOuvrir } from './ouvrir.js';
|
|
11
|
+
import { EtatDuPartage, PanneauDuPartage } from './panneau-du-partage.js';
|
|
12
|
+
import { useSession } from './session.js';
|
|
13
|
+
// L'écran d'une chose : la barre fine (le fil d'Ariane vers la liste telle qu'on l'a quittée, le
|
|
14
|
+
// nom, l'état ; à droite le geste propre de l'app, « Partager », la pleine page dans un autre
|
|
15
|
+
// onglet, et le ⋯), puis le corps que l'app rend. La coquille n'y dessine pas l'en-tête de l'app
|
|
16
|
+
// (`staticData: { ecranDUneChose: true }`, que pose `routesDesChoses`). Le corps est à l'app : un
|
|
17
|
+
// cadre qu'il porte reste isolé, et rien de ce qu'il envoie ne déclenche un geste de la barre fine
|
|
18
|
+
// ni du panneau du partage, qui n'écoutent que leurs boutons.
|
|
19
|
+
// Une chose absente, ou fermée à la personne : un refus ou une réponse 4xx de `lire`, ou rien.
|
|
20
|
+
function estAbsente(erreur) {
|
|
21
|
+
return erreur instanceof ErreurDUnAppel && erreur.statut >= 400 && erreur.statut < 500;
|
|
22
|
+
}
|
|
23
|
+
export const texteDUneChoseAbsente = 'Cette chose n\'existe pas, ou vous n\'y avez pas accès.';
|
|
24
|
+
export function EcranDUneChose({ choses, id }) {
|
|
25
|
+
const session = useSession();
|
|
26
|
+
const ouvrir = useOuvrir();
|
|
27
|
+
const [partage, setPartage] = useState(false);
|
|
28
|
+
const lecture = useQuery({
|
|
29
|
+
queryKey: cleDesChoses(choses.app, 'chose', id),
|
|
30
|
+
queryFn: async () => (await choses.lire(id)) ?? null,
|
|
31
|
+
throwOnError: (erreur) => !estAbsente(erreur),
|
|
32
|
+
});
|
|
33
|
+
const titre = titreDeLaListe(session, choses.app);
|
|
34
|
+
const chose = lecture.data;
|
|
35
|
+
const absente = chose === null || (lecture.error !== null && estAbsente(lecture.error));
|
|
36
|
+
const pleinePage = chose ? choses.pleinePage?.(chose) : undefined;
|
|
37
|
+
const fil = (fin) => (_jsxs("nav", { "aria-label": "Fil d'Ariane", className: "flex min-w-0 items-center gap-2 text-[14px]", children: [_jsx(Lien, { href: adresseDeLaListe(choses.app), className: "font-medium whitespace-nowrap text-gris no-underline hover:text-encre", children: titre }), fin] }));
|
|
38
|
+
if (absente) {
|
|
39
|
+
return (_jsxs(_Fragment, { children: [_jsx("title", { children: `${titre} · ${session.theme.nom}` }), _jsx("div", { className: "mb-5", children: fil() }), _jsx(Message, { erreur: true, titre: texteDUneChoseAbsente })] }));
|
|
40
|
+
}
|
|
41
|
+
if (!chose) {
|
|
42
|
+
return _jsx("div", { className: "mb-3 h-9", children: fil(_jsx("span", { "aria-hidden": "true", className: "text-trait-champ", children: "/" })) });
|
|
43
|
+
}
|
|
44
|
+
return (_jsxs(_Fragment, { children: [_jsx("title", { children: `${chose.nom} · ${session.theme.nom}` }), _jsxs("div", { className: "mb-3 flex flex-wrap items-center justify-between gap-x-4 gap-y-2", children: [fil(_jsxs(_Fragment, { children: [_jsx("span", { "aria-hidden": "true", className: "text-trait-champ", children: "/" }), _jsx("h1", { className: "m-0 truncate text-[14px] font-semibold text-encre", title: chose.nom, children: chose.nom }), (choses.etat || choses.lirePartage) && _jsx(EtatDuPartage, { choses: choses, chose: chose })] })), _jsxs("div", { className: "flex flex-wrap items-center gap-2", children: [choses.geste?.(chose), choses.lirePartage && (_jsx(PanneauDuPartage, { choses: choses, chose: chose, ouvert: partage, onOuvertChange: setPartage, declencheur: _jsx(Bouton, { type: "button", sorte: "secondaire", children: "Partager" }) })), pleinePage && (_jsx(Bouton, { asChild: true, sorte: "secondaire", children: _jsxs("a", { href: pleinePage, target: "_blank", rel: "noopener noreferrer", children: [choses.libelleDeLaPleinePage ?? 'Pleine page', " \u2197"] }) })), _jsx(MenuDUneChose, { choses: choses, chose: chose, surLEcran: true, surSupprimee: () => ouvrir(adresseDeLaListe(choses.app)) })] })] }), _jsx("div", { className: choses.plein ? 'flex min-h-0 flex-1 flex-col' : 'max-w-[880px]', children: choses.corps(chose) })] }));
|
|
45
|
+
}
|
|
@@ -1,7 +1,10 @@
|
|
|
1
1
|
import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
|
|
2
2
|
import { useLocation } from '@tanstack/react-router';
|
|
3
|
+
import { Bouton } from '../ui/bouton.js';
|
|
4
|
+
import { useEpingle } from './barre.js';
|
|
3
5
|
import { entreeActive } from './entree-active.js';
|
|
4
6
|
import { LienDansLaPage } from './lien.js';
|
|
7
|
+
import { useAnnoncer } from './ouvrir.js';
|
|
5
8
|
import { useSession } from './session.js';
|
|
6
9
|
// L'app de la page, d'après son chemin : `/documentation/<app>`, ou `/<app>/…` pour une app ouverte
|
|
7
10
|
// à la personne. Le core, ses écrans (`/journal`, `/compte`) et l'accueil n'en ont pas.
|
|
@@ -13,11 +16,16 @@ export function appDuChemin(session, ici) {
|
|
|
13
16
|
// Les onglets d'une app, dans leur ordre.
|
|
14
17
|
export function ongletsDe(app) {
|
|
15
18
|
return [
|
|
16
|
-
{ titre: 'Documentation', chemin: `/documentation/${app.nom}` },
|
|
17
|
-
...(app.reglages ? [{ titre: 'Réglages', chemin: `/${app.nom}/reglages` }] : []),
|
|
18
19
|
...app.ecrans.map((ecran) => ({ titre: ecran.titre, chemin: ecran.chemin })),
|
|
20
|
+
...(app.reglages ? [{ titre: 'Réglages', chemin: `/${app.nom}/reglages` }] : []),
|
|
21
|
+
{ titre: 'Documentation', chemin: `/documentation/${app.nom}` },
|
|
19
22
|
];
|
|
20
23
|
}
|
|
24
|
+
// Le nom d'un onglet épinglé dans la barre : le titre de l'app pour son premier écran, sinon
|
|
25
|
+
// « <app> · <onglet> ».
|
|
26
|
+
function nomDeLEpingle(app, onglet) {
|
|
27
|
+
return onglet.chemin === app.ecrans[0]?.chemin ? app.titre : `${app.titre} · ${onglet.titre}`;
|
|
28
|
+
}
|
|
21
29
|
export function EnTeteDeLApp() {
|
|
22
30
|
const session = useSession();
|
|
23
31
|
const ici = useLocation({ select: (lieu) => lieu.pathname });
|
|
@@ -29,5 +37,15 @@ export function EnTeteDeLApp() {
|
|
|
29
37
|
// L'onglet du chemin ; sinon le premier écran de l'app sous le même `/<app>/`, comme « Pages » sur
|
|
30
38
|
// la page hôte d'une page (`/pages/<id>`).
|
|
31
39
|
const active = onglets.find((onglet) => onglet.chemin === ici)?.chemin ?? entreeActive(app.ecrans.map((ecran) => ecran.chemin), ici);
|
|
32
|
-
|
|
40
|
+
const ouvert = onglets.find((onglet) => onglet.chemin === active);
|
|
41
|
+
return (_jsxs("div", { className: "mb-8 border-b border-trait", children: [_jsxs("div", { className: "mb-1.5 flex min-h-7 items-center justify-between gap-3", children: [_jsx("p", { className: "m-0 text-[11px] tracking-[.07em] text-gris uppercase", children: app.titre }), ouvert && _jsx(BoutonEpingler, { chemin: ouvert.chemin, nom: nomDeLEpingle(app, ouvert) }, ouvert.chemin)] }), _jsx("nav", { "aria-label": "Onglets", className: "-mb-px flex flex-wrap gap-x-6", children: onglets.map((onglet) => (_jsx(LienDansLaPage, { href: onglet.chemin, "aria-current": onglet.chemin === active ? 'page' : undefined, className: "border-b-2 border-transparent pb-2.5 font-medium text-gris no-underline hover:text-encre aria-[current=page]:border-accent aria-[current=page]:text-encre", children: onglet.titre }, onglet.chemin))) })] }));
|
|
42
|
+
}
|
|
43
|
+
// « Épingler » ajoute l'onglet ouvert à la barre de la personne, « Épinglé » l'en retire.
|
|
44
|
+
function BoutonEpingler({ chemin, nom }) {
|
|
45
|
+
const annoncer = useAnnoncer();
|
|
46
|
+
const epingle = useEpingle(chemin, {
|
|
47
|
+
fait: (epinglee) => annoncer(epinglee ? `${nom} est dans votre barre.` : `${nom} n'est plus dans votre barre.`),
|
|
48
|
+
echec: annoncer,
|
|
49
|
+
});
|
|
50
|
+
return (_jsx(Bouton, { type: "button", sorte: "discret", "aria-pressed": epingle.epinglee, disabled: epingle.enCours, onClick: () => epingle.basculer(nom), className: "h-7 px-2 text-[13px]", children: epingle.epinglee ? 'Épinglé' : 'Épingler' }));
|
|
33
51
|
}
|
package/src/espace/index.d.ts
CHANGED
|
@@ -1,13 +1,21 @@
|
|
|
1
1
|
export { lancerLaPage } from './lancer.tsx';
|
|
2
|
-
export { coquilleDeLEspace, coquilleDesReglages, creerLaPage, racine, type ContexteDuRouteur, type OptionsDeLaPage } from './page.tsx';
|
|
2
|
+
export { coquilleDeLEspace, coquilleDesReglages, creerLaPage, horsDeLaCoquille, racine, type ContexteDuRouteur, type OptionsDeLaPage } from './page.tsx';
|
|
3
3
|
export { usePiece, type Piece } from './contexte.ts';
|
|
4
4
|
export { Ecran, type ProprietesDUnEcran } from './ecran.tsx';
|
|
5
5
|
export { appDuChemin, ongletsDe, type Onglet } from './en-tete-de-l-app.tsx';
|
|
6
6
|
export { ErreurDUnEcran } from './erreur.tsx';
|
|
7
7
|
export { useSession, requeteDeLaSession, type AppOuverte, type EcranDUneApp, type EntreeDeLaBarre, type Session } from './session.ts';
|
|
8
|
-
export { appeler, faireUnGeste, texteDe, ErreurDUnAppel, type ResultatDUnOutil } from './appels.ts';
|
|
8
|
+
export { appeler, appelerUneApp, faireUnGeste, texteDe, ErreurDUnAppel, type ResultatDUnOutil } from './appels.ts';
|
|
9
9
|
export { useAppel, RefusDUnAppel, type Appel } from './appel.tsx';
|
|
10
10
|
export { rechercheDUnePage, usePageDeLAdresse, type RechercheDUnePage } from './pagination.ts';
|
|
11
11
|
export { heureDeSuisse } from './heure.ts';
|
|
12
12
|
export { EcranDesComptes } from './comptes.tsx';
|
|
13
13
|
export type { ChampDecrit, CompteListe, DescriptionDesComptes, ListeDesComptes } from '../description-des-comptes.ts';
|
|
14
|
+
export { desepingler, epingler, lireLAnnuaire, useEpingle, type AnnuaireDeLEcran, type Epingle } from './barre.ts';
|
|
15
|
+
export { useAnnoncer } from './ouvrir.ts';
|
|
16
|
+
export { chercherParLOutil, rechercheDeLaListe, vuesDuPartage, type ChoseTrouvee, type ChosesTrouvees, type CiblesDuPartage, type ColonneDUneChose, type CritereDeRecherche, type DeclarationDesChoses, type DroitSurUneChose, type OuvertureDUneChose, type RechercheDeLaListe, type VueDeLaListe, } from './choses.ts';
|
|
17
|
+
export { ListeDesChoses } from './liste-des-choses.tsx';
|
|
18
|
+
export { EcranDUneChose, texteDUneChoseAbsente } from './ecran-d-une-chose.tsx';
|
|
19
|
+
export { MenuDUneChose, type ProprietesDuMenuDUneChose } from './menu-d-une-chose.tsx';
|
|
20
|
+
export { EtatDuPartage, PanneauDuPartage, type ProprietesDuPanneauDuPartage } from './panneau-du-partage.tsx';
|
|
21
|
+
export { routesDesChoses } from './routes-des-choses.tsx';
|
package/src/espace/index.js
CHANGED
|
@@ -1,14 +1,23 @@
|
|
|
1
|
-
// @indos/bibliotheque/espace : la page de l'espace d'une pièce en React, sa coquille, ses appels
|
|
2
|
-
// (bibliotheque/CLAUDE.md, « La page de l'espace
|
|
1
|
+
// @indos/bibliotheque/espace : la page de l'espace d'une pièce en React, sa coquille, ses appels, et
|
|
2
|
+
// la liste et l'écran des choses d'une app (bibliotheque/CLAUDE.md, « La page de l'espace », « Une
|
|
3
|
+
// app à choses »).
|
|
3
4
|
export { lancerLaPage } from './lancer.js';
|
|
4
|
-
export { coquilleDeLEspace, coquilleDesReglages, creerLaPage, racine } from './page.js';
|
|
5
|
+
export { coquilleDeLEspace, coquilleDesReglages, creerLaPage, horsDeLaCoquille, racine } from './page.js';
|
|
5
6
|
export { usePiece } from './contexte.js';
|
|
6
7
|
export { Ecran } from './ecran.js';
|
|
7
8
|
export { appDuChemin, ongletsDe } from './en-tete-de-l-app.js';
|
|
8
9
|
export { ErreurDUnEcran } from './erreur.js';
|
|
9
10
|
export { useSession, requeteDeLaSession } from './session.js';
|
|
10
|
-
export { appeler, faireUnGeste, texteDe, ErreurDUnAppel } from './appels.js';
|
|
11
|
+
export { appeler, appelerUneApp, faireUnGeste, texteDe, ErreurDUnAppel } from './appels.js';
|
|
11
12
|
export { useAppel, RefusDUnAppel } from './appel.js';
|
|
12
13
|
export { rechercheDUnePage, usePageDeLAdresse } from './pagination.js';
|
|
13
14
|
export { heureDeSuisse } from './heure.js';
|
|
14
15
|
export { EcranDesComptes } from './comptes.js';
|
|
16
|
+
export { desepingler, epingler, lireLAnnuaire, useEpingle } from './barre.js';
|
|
17
|
+
export { useAnnoncer } from './ouvrir.js';
|
|
18
|
+
export { chercherParLOutil, rechercheDeLaListe, vuesDuPartage, } from './choses.js';
|
|
19
|
+
export { ListeDesChoses } from './liste-des-choses.js';
|
|
20
|
+
export { EcranDUneChose, texteDUneChoseAbsente } from './ecran-d-une-chose.js';
|
|
21
|
+
export { MenuDUneChose } from './menu-d-une-chose.js';
|
|
22
|
+
export { EtatDuPartage, PanneauDuPartage } from './panneau-du-partage.js';
|
|
23
|
+
export { routesDesChoses } from './routes-des-choses.js';
|