@lystech/sections 0.1.0 → 0.3.0

package/dist/useSection.d.ts

@@ -0,0 +1,50 @@
+/**
+ * LES ATTRIBUTS À POSER SUR LE CONTENEUR DE LA SECTION.
+ *
+ * L'éditeur doit pouvoir retrouver, DANS LA PAGE, le rectangle qui correspond
+ * à un bloc — pour l'encadrer et y poser un bouton. Il n'existe aucun moyen
+ * fiable de le deviner : deux sections peuvent afficher les mêmes mots, et un
+ * site est libre de sa structure. Le site le dit donc explicitement, en
+ * étalant ces attributs sur son élément :
+ *
+ *     const { contenu, ancrage } = useSection("tarifs", { defaut });
+ *     return <section {...ancrage}>…</section>;
+ *
+ * Hors mode édition, c'est un attribut `data-` inerte : aucun poids, aucun
+ * effet, aucun style.
+ */
+export type AncrageEdition = {
+    "data-lystech-section": string;
+};
+export type ResultatSection<T> = {
+    /** Le contenu à afficher : aperçu, sinon publié, sinon défaut. */
+    contenu: T;
+    /** Vrai quand le contenu vient du serveur, faux quand c'est le défaut. */
+    publie: boolean;
+    /** L'identifiant de la section — nécessaire à l'édition. */
+    UID: string | null;
+    chargement: boolean;
+    /** À étaler sur le conteneur pour que l'éditeur puisse le situer. */
+    ancrage: AncrageEdition;
+};
+/**
+ * Le contenu d'un type de bloc sur la page courante.
+ *
+ * Le cas visé est celui d'un site DÉJÀ DESSINÉ : un bloc par type et par page,
+ * dont on veut rendre les mots et les images modifiables — pas un constructeur
+ * de pages. Pour des blocs répétables, voir `useSectionList`.
+ */
+export declare function useSection<T extends object>(blockType: string, options: {
+    defaut: T;
+}): ResultatSection<T>;
+/** Plusieurs blocs du même type, dans l'ordre choisi par le client. */
+export declare function useSectionList<T extends object>(blockType: string, options?: {
+    defaut?: T[];
+}): {
+    items: Array<T & {
+        __uid: string;
+    }>;
+    publie: boolean;
+    chargement: boolean;
+    ancrage: AncrageEdition;
+};

package/package.json

@@ -1,19 +1,25 @@
 {
   "name": "@lystech/sections",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Contenu de site editable par le client — lecture legere, edition chargee a la demande.",
   "type": "module",
-  "main": "./dist/index.umd.cjs",
+  "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.umd.cjs"
+      "import": "./dist/index.js"
+    },
+    "./editeur": {
+      "types": "./dist/editeur/index.d.ts",
+      "import": "./dist/editeur.js"
     }
   },
-  "files": ["dist"],
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
   "scripts": {
     "build": "tsc -b && vite build",
     "dev": "vite build --watch"
@@ -31,5 +37,7 @@
     "vite": "^7.0.0",
     "vite-plugin-dts": "^4.5.4"
   },
-  "publishConfig": { "access": "public" }
+  "publishConfig": {
+    "access": "public"
+  }
 }

package/dist/index.umd.cjs

@@ -1 +0,0 @@
-(function(s,a){typeof exports=="object"&&typeof module<"u"?a(exports,require("react/jsx-runtime"),require("react")):typeof define=="function"&&define.amd?define(["exports","react/jsx-runtime","react"],a):(s=typeof globalThis<"u"?globalThis:s||self,a(s.LystechSections={},s.jsxRuntime,s.React))})(this,(function(s,a,c){"use strict";const y=c.createContext(null),j="https://api.lystech.ca/api";function A({site:t,page:n,langue:e="fr",apiBaseUrl:o=j,children:r}){const[i,l]=c.useState([]),[S,h]=c.useState("chargement"),[E,P]=c.useState(0),b=c.useRef(null);c.useEffect(()=>{if(!t||!n)return;b.current?.abort();const f=new AbortController;return b.current=f,h("chargement"),fetch(`${o}/site-sections/public/${encodeURIComponent(t)}/${encodeURIComponent(n)}`,{signal:f.signal}).then(u=>u.ok?u.json():Promise.reject(new Error(String(u.status)))).then(u=>{f.signal.aborted||(l(Array.isArray(u)?u:[]),h("pret"))}).catch(u=>{f.signal.aborted||u?.name==="AbortError"||h("erreur")}),()=>f.abort()},[t,n,o,E]);const R=c.useMemo(()=>({site:t,langue:e,sections:i,etat:S,recharger:()=>P(f=>f+1)}),[t,e,i,S]);return a.jsx(y.Provider,{value:R,children:r})}function m(){return c.useContext(y)}function g(t){return!!t&&typeof t=="object"&&!Array.isArray(t)&&Object.keys(t).every(n=>/^[a-z]{2}(-[A-Za-z]{2})?$/.test(n))}function d(t,n){if(Array.isArray(t))return t.map(e=>d(e,n));if(g(t)){const e=t,o=n.slice(0,2);return e[n]??e[o]??Object.values(e).find(i=>i!=null)??""}if(t&&typeof t=="object"){const e={};for(const[o,r]of Object.entries(t))e[o]=d(r,n);return e}return t}function p(t,n){if(!n||typeof n!="object"||Array.isArray(n))return t;const e={...t};for(const[o,r]of Object.entries(n))r!=null&&(e[o]=r);return e}function x(t,n){const e=m();return c.useMemo(()=>{const o=e?.sections.find(l=>l.blockType===t),r=o?.data??null,i=r?d(r,e?.langue??"fr"):null;return{contenu:p(n.defaut,i),publie:!!r,UID:o?.UID??null,chargement:e?.etat==="chargement"}},[e?.sections,e?.langue,e?.etat,t,n.defaut])}function C(t,n){const e=m();return c.useMemo(()=>{const o=(e?.sections??[]).filter(r=>r.blockType===t);return o.length===0?{items:(n?.defaut??[]).map((r,i)=>({...r,__uid:`defaut-${i}`})),publie:!1,chargement:e?.etat==="chargement"}:{items:o.map(r=>({...d(r.data??{},e?.langue??"fr"),__uid:r.UID})),publie:!0,chargement:e?.etat==="chargement"}},[e?.sections,e?.langue,e?.etat,t,n?.defaut])}s.SectionsProvider=A,s.useSection=x,s.useSectionList=C,s.useSectionsContext=m,Object.defineProperty(s,Symbol.toStringTag,{value:"Module"})}));