@lystech/sections 0.4.6 → 0.5.0

package/README.md

@@ -93,6 +93,42 @@ si la personne est administratrice : un lien qui fuite ne peut pas ouvrir la
 console. Le droit est relu dans les rôles à chaque requête, donc retirer un
 accès ferme les jetons déjà émis sur-le-champ.
 
+### Des gestes propres au site : `appelEdition`
+
+Un site peut offrir, à la personne connectée, des gestes que l'éditeur
+générique ne connaît pas — retirer un résultat, masquer un évènement. Le
+contexte fournit un appel qui porte le jeton, sans jamais en livrer la valeur :
+
+```tsx
+const ctx = useSectionsContext();
+if (ctx?.modeEdition) {
+  const r = await ctx.appelEdition("/results/site/droits");
+}
+```
+
+Seuls les chemins de l'API sont acceptés. Un `401` fait sortir du mode édition
+(jeton expiré) ; un `403` revient tel quel. C'est la ROUTE qui décide de ce que
+le jeton ouvre : plafonné à l'éditeur partout, il n'obtient plus qu'en de rares
+routes qui le disent explicitement (ex. `/results/site`, admins seulement).
+
+### Des boutons qui restent des boutons
+
+En mode « modifier », cliquer un texte le corrige au lieu de l'actionner — mais
+seulement un texte qui a un bloc déclaré où s'enregistrer. Pour qu'une zone
+reste actionnable quoi qu'il arrive (une suppression et sa confirmation), posez
+`CLASSE_HORS_EDITION` dessus — et sur `rootClassName` des fenêtres surgissantes,
+qui se rendent hors de l'arbre :
+
+```tsx
+<section className={CLASSE_HORS_EDITION}>…</section>
+<Popconfirm rootClassName={CLASSE_HORS_EDITION} …>
+```
+
+### Un site qui signe déjà
+
+`<SignatureLystech mention={null} />` ne garde que le bouton « Connexion » —
+pour un pied de page qui porte déjà sa propre mention de Lystech.
+
 ## Sites prérendus
 
 Un site généré au build affiche les replis du code dans son HTML, puis bascule

package/dist/SectionsProvider.d.ts

@@ -35,6 +35,25 @@ type Contexte = {
      * marchait.
      */
     declarerRepli: (blockType: string, defaut: unknown) => void;
+    /**
+     * APPELER L'API LYSTECH AU NOM DE LA PERSONNE CONNECTÉE.
+     *
+     * Pour les gestes propres à un site — retirer un résultat, masquer un
+     * évènement — que l'éditeur générique ne connaît pas. Le site ne reçoit
+     * jamais la valeur du jeton : il obtient un appel qui le porte, et c'est
+     * le paquet qui décide où il part. Seuls les chemins de l'API sont
+     * acceptés (« /results/site/droits ») : collé à `apiBaseUrl`, un chemin ne
+     * peut pas changer de serveur.
+     *
+     * Le serveur reste seul juge de ce que le jeton autorise : ce que l'appel
+     * ouvre, c'est ce que la route accepte pour cette personne, pas plus.
+     *
+     * Un 401 veut dire que le jeton ne vaut plus rien : on sort du mode
+     * édition, comme l'éditeur le fait pour ses propres appels. Un 403, lui,
+     * est une réponse normale (« pas pour vous ») et revient telle quelle.
+     * Hors mode édition, l'appel échoue sans rien envoyer.
+     */
+    appelEdition: (chemin: string, init?: RequestInit) => Promise<Response>;
 };
 export declare function SectionsProvider({ site, page, langue, apiBaseUrl, sectionsInitiales, sourceTexte, pagesPartagees, children, }: {
     /** Sous-domaine de l'organisation (ex. « armoise »). */

package/dist/SignatureLystech.d.ts

@@ -1,10 +1,17 @@
+import { ReactNode } from 'react';
 export declare function SignatureLystech({ site, apiBaseUrl, className, mention, connexion, methodes, }: {
     /** Sous-domaine de l'organisation. Pris du fournisseur si omis. */
     site?: string | undefined;
     apiBaseUrl?: string | undefined;
     className?: string | undefined;
-    /** Les mots de la mention, si le site en préfère d'autres. */
-    mention?: string | undefined;
+    /**
+     * Les mots de la mention, si le site en préfère d'autres.
+     *
+     * `null` la retire : pour un site qui signe déjà à sa façon (un logo, une
+     * phrase à lui), il ne reste que « Connexion » — deux liens vers Lystech
+     * côte à côte, c'est un de trop.
+     */
+    mention?: ReactNode | undefined;
     connexion?: string | undefined;
     /**
      * Les facons de se connecter proposees a la personne qui edite.

package/dist/constantes.d.ts

@@ -0,0 +1,14 @@
+/**
+ * LA ZONE QUE L'ÉDITION EN PLACE NE TOUCHE PAS.
+ *
+ * En mode « modifier », un clic sur un texte du site le corrige au lieu de
+ * l'actionner. C'est voulu pour un titre ou un lien de menu ; c'est une panne
+ * pour un bouton qui doit AGIR même en mode édition — une suppression, sa
+ * confirmation. Un élément portant cette classe (ou dans un parent qui la
+ * porte) n'est jamais repéré : ses clics passent.
+ *
+ * Une classe plutôt qu'un attribut : les fenêtres surgissantes des
+ * bibliothèques (antd, etc.) se rendent hors de l'arbre, et n'acceptent en
+ * général qu'un nom de classe (`rootClassName`).
+ */
+export declare const CLASSE_HORS_EDITION = "lystech-hors-edition";

package/dist/editeur/TexteEnPlace.d.ts

@@ -1,7 +1,12 @@
 import { SourceTexte } from '../sourceTexte';
-export declare function TexteEnPlace({ source, actif, surModification, }: {
+export declare function TexteEnPlace({ source, actif, modifiable, surModification, }: {
     source: SourceTexte;
     /** Faux pendant qu'un panneau est ouvert : on ne veut pas deux modes. */
     actif: boolean;
+    /**
+     * Ce texte a-t-il un bloc où s'enregistrer ? Change quand le catalogue
+     * arrive : avant lui, rien n'est repéré — c'est le bon défaut.
+     */
+    modifiable: (ns: string, chemin: string) => boolean;
     surModification: (ns: string, chemin: string, langue: string, valeur: string) => void | Promise<void>;
 }): import("react").JSX.Element | null;