@indos/bibliotheque 1.3.0 → 1.5.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 CHANGED
@@ -2,6 +2,31 @@
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.5.0
6
+
7
+ - 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.
8
+ - 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.
9
+ - `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.
10
+ - `useRelireLesChoses(app)` relit la liste et les choses de l'app, après un geste propre qui les change.
11
+ - 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.
12
+ - 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.
13
+ - 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.
14
+
15
+ ## 1.4.0
16
+
17
+ - 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 ».
18
+ - 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.
19
+ - En bas de la barre, au-dessus du nom : « Toutes les apps » (`/apps`) et « Configurer l'espace » (`/reglages`).
20
+ - `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.
21
+ - `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.
22
+
23
+ ### Ruptures
24
+
25
+ - 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`.
26
+ - 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 ».
27
+ - Les versions de React, Vite et TanStack ne changent pas ; `npm view @indos/bibliotheque@1.4.0 peerDependencies` les donne toutes.
28
+ - Pour monter : `"@indos/bibliotheque": "1.4.0"` dans ses `dependencies`, puis `npm install` et `npm run build`.
29
+
5
30
  ## 1.3.0
6
31
 
7
32
  - 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
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@indos/bibliotheque",
3
- "version": "1.3.0",
3
+ "version": "1.5.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",
@@ -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>;
@@ -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 ; une autre réponse que 200 lève
34
- // `ErreurDUnAppel`, avec l'`erreur` rendue, ou le texte du résultat d'un outil refusé.
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,105 @@
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?: MotsDeLaPublication;
58
+ consequenceDeLaSuppression?: string;
59
+ chercher?: (critere: CritereDeRecherche) => Promise<ChosesTrouvees<C>>;
60
+ lire: (id: string) => Promise<C | undefined>;
61
+ corps: (chose: C) => ReactNode;
62
+ pleinePage?: (chose: C) => string | undefined;
63
+ renommer?: (chose: C, nom: string) => Promise<unknown>;
64
+ supprimer?: (chose: C) => Promise<unknown>;
65
+ peutSupprimer?: (chose: C) => boolean;
66
+ lirePartage?: (chose: C) => Promise<OuvertureDUneChose[]>;
67
+ partager?: (chose: C, cibles: CiblesDuPartage & {
68
+ droit: 'lecture' | 'modification';
69
+ confirmer?: true;
70
+ }) => Promise<unknown>;
71
+ nePlusPartager?: (chose: C, cibles: CiblesDuPartage) => Promise<unknown>;
72
+ publier?: (chose: C, oui: boolean, confirmer: boolean) => Promise<unknown>;
73
+ nouveau?: () => Promise<{
74
+ chemin: string;
75
+ } | undefined | void>;
76
+ geste?: (chose: C) => ReactNode;
77
+ };
78
+ export type MotsDeLaPublication = {
79
+ titre?: string;
80
+ verbe?: string;
81
+ fermer?: string;
82
+ consequence?: string;
83
+ };
84
+ export declare function motsDeLaPublication(publication?: MotsDeLaPublication): Required<MotsDeLaPublication>;
85
+ export declare function vuesDuPartage(feminin?: boolean): VueDeLaListe[];
86
+ export type RechercheDeLaListe = {
87
+ texte?: string;
88
+ vue?: string;
89
+ page?: number;
90
+ };
91
+ export declare function rechercheDeLaListe(recherche: Record<string, unknown>): RechercheDeLaListe;
92
+ export declare function chercherParLOutil<C extends ChoseTrouvee>(critere: CritereDeRecherche): Promise<ChosesTrouvees<C>>;
93
+ export declare function motsDe(declaration: {
94
+ une: string;
95
+ feminin?: boolean;
96
+ }): {
97
+ e: string;
98
+ laChose: string;
99
+ titre: string;
100
+ aucune: string;
101
+ nouvelle: string;
102
+ pronom: string;
103
+ };
104
+ export declare function cleDesChoses(app: string, ...suite: unknown[]): unknown[];
105
+ export declare function useRelireLesChoses(app: string): () => Promise<void>;
@@ -0,0 +1,63 @@
1
+ import { useQueryClient } from '@tanstack/react-query';
2
+ import { appeler, texteDe } from './appels.js';
3
+ // Les mots de la publication d'une app, ses défauts compris.
4
+ export function motsDeLaPublication(publication = {}) {
5
+ return {
6
+ titre: publication.titre ?? 'Par un lien',
7
+ verbe: publication.verbe ?? 'Ouvrir le lien',
8
+ fermer: publication.fermer ?? 'Fermer le lien',
9
+ consequence: publication.consequence ?? 'Toute personne qui a le lien y accède, sans compte.',
10
+ };
11
+ }
12
+ // Les vues d'une app qui partage : toutes, à moi, partagées avec moi.
13
+ export function vuesDuPartage(feminin = false) {
14
+ return [
15
+ { valeur: 'toutes', titre: feminin ? 'Toutes' : 'Tous' },
16
+ { valeur: 'a_moi', titre: 'À moi' },
17
+ { valeur: 'partagees', titre: feminin ? 'Partagées avec moi' : 'Partagés avec moi' },
18
+ ];
19
+ }
20
+ export function rechercheDeLaListe(recherche) {
21
+ const page = Number(recherche.page);
22
+ return {
23
+ ...(typeof recherche.texte === 'string' && recherche.texte ? { texte: recherche.texte } : {}),
24
+ ...(typeof recherche.vue === 'string' && recherche.vue ? { vue: recherche.vue } : {}),
25
+ ...(Number.isInteger(page) && page > 1 ? { page } : {}),
26
+ };
27
+ }
28
+ // `chercher` par défaut : l'outil `chercher` de l'app, son texte lu en JSON.
29
+ export async function chercherParLOutil(critere) {
30
+ const resultat = await appeler('chercher', {
31
+ ...(critere.texte ? { texte: critere.texte } : {}),
32
+ ...(critere.vue ? { vue: critere.vue } : {}),
33
+ page: critere.page,
34
+ });
35
+ return JSON.parse(texteDe(resultat));
36
+ }
37
+ // Les mots d'une chose, selon son genre.
38
+ export function motsDe(declaration) {
39
+ const { une, feminin = false } = declaration;
40
+ const e = feminin ? 'e' : '';
41
+ const la = /^[aeiouyàâéèêëîïôûü]/i.test(une) ? 'l\'' : feminin ? 'la ' : 'le ';
42
+ return {
43
+ e,
44
+ // « la page », « le tableau », « l'image ».
45
+ laChose: `${la}${une}`,
46
+ // « Page », pour l'en-tête de la colonne.
47
+ titre: une.charAt(0).toLocaleUpperCase('fr') + une.slice(1),
48
+ aucune: `${feminin ? 'Aucune' : 'Aucun'} ${une}`,
49
+ nouvelle: `${feminin ? 'Nouvelle' : 'Nouveau'} ${une}`,
50
+ // Le pronom : « la », « le ».
51
+ pronom: feminin ? 'la' : 'le',
52
+ };
53
+ }
54
+ // Les clés des requêtes des choses d'une app, que chaque geste relit.
55
+ export function cleDesChoses(app, ...suite) {
56
+ return ['choses', app, ...suite];
57
+ }
58
+ // Relire la liste et les choses d'une app, après un geste propre de l'app qui les change (une
59
+ // facture émise passe d'une vue à l'autre).
60
+ export function useRelireLesChoses(app) {
61
+ const client = useQueryClient();
62
+ return () => client.invalidateQueries({ queryKey: cleDesChoses(app) });
63
+ }
@@ -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 contenu, `Ecran`) et, au
14
- // pied, la version de la pièce. L'entrée active (`entreeActive`) est marquée `aria-current="page"`.
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 le nom de la
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. Un écran qui attend ses données laisse la
33
- // barre et l'en-tête de l'app affichés.
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
- return (_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: "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", children: _jsxs("div", { className: pleineLargeur ? 'flex min-h-0 flex-1 flex-col' : 'max-w-[880px]', children: [_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] })] })] }) })] })] }));
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: "border-t border-trait pt-3", 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" }) }) })] })] }) }));
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
- return (_jsxs("div", { className: "mb-8 border-b border-trait", children: [_jsx("p", { className: "m-0 mb-2.5 text-[11px] tracking-[.07em] text-gris uppercase", children: app.titre }), _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))) })] }));
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
  }
@@ -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, motsDeLaPublication, rechercheDeLaListe, useRelireLesChoses, vuesDuPartage, type ChoseTrouvee, type ChosesTrouvees, type CiblesDuPartage, type ColonneDUneChose, type CritereDeRecherche, type DeclarationDesChoses, type DroitSurUneChose, type MotsDeLaPublication, 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';
@@ -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, motsDeLaPublication, rechercheDeLaListe, useRelireLesChoses, 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';
@@ -0,0 +1,4 @@
1
+ import { type ChoseTrouvee, type DeclarationDesChoses } from './choses.ts';
2
+ export declare function ListeDesChoses<C extends ChoseTrouvee>({ choses }: {
3
+ choses: DeclarationDesChoses<C>;
4
+ }): import("react").JSX.Element;