@agence-zef/astro 0.4.1 → 0.6.0-pilot.0

package/dist/helpers.js

@@ -43,6 +43,85 @@ export async function zefLayoutProps(opts) {
     };
 }
 const toParam = (url) => url.replace(/^\/+|\/+$/g, "") || undefined;
+/** Arborescence des pages : fil d'Ariane d'une page, accueil de chaque langue. */
+function pageTree(entries, site) {
+    const byId = new Map(entries.map((e) => [e.id, e]));
+    const homeOf = (locale) => entries.find((e) => e.urls[locale] === "/" || e.urls[locale] === `/${locale}`);
+    /** Accueil, puis les pages parentes, puis la page elle-même. */
+    const trail = (id, locale) => {
+        const out = [];
+        for (let e = byId.get(id); e; e = e.parentId ? byId.get(e.parentId) : undefined) {
+            const url = e.urls[locale];
+            if (url)
+                out.unshift({ title: e.titles[locale] || e.titles[site.defaultLocale] || "", url });
+        }
+        const home = homeOf(locale);
+        if (home && out[0]?.url !== home.urls[locale]) {
+            out.unshift({ title: home.titles[locale] || site.name, url: home.urls[locale] });
+        }
+        return out;
+    };
+    return { trail, homeOf };
+}
+/**
+ * Rendu à la demande (`rendering: "cached"`) : les props du gabarit pour une adresse, page ou
+ * élément de collection, sans parcourir tout le site. `null` si rien n'est publié à cette
+ * adresse ; une erreur du CMS remonte (la page en cache reste servie).
+ */
+export async function zefRouteProps(path, visitor) {
+    const api = getClient();
+    const [found, site, entries] = await Promise.all([
+        api.document(path, visitor).catch((error) => {
+            if (error.status === 404)
+                return null;
+            throw error;
+        }),
+        api.site(),
+        api.pages(),
+    ]);
+    if (!found)
+        return null;
+    const { trail, homeOf } = pageTree(entries, site);
+    if (found.kind === "page") {
+        const { page } = found;
+        const layout = await api.layout({ locale: page.locale });
+        const entry = entries.find((e) => e.id === page.id);
+        return {
+            kind: "page",
+            page,
+            site,
+            locale: page.locale,
+            title: page.seo.title ?? page.title,
+            seo: page.seo,
+            alternates: page.alternates,
+            url: page.url,
+            breadcrumbs: entry ? trail(entry.id, page.locale) : [],
+            header: layout.header,
+            footer: layout.footer,
+        };
+    }
+    const { item, collection, titleField } = found;
+    const locale = Object.entries(item.alternates ?? {}).find(([, url]) => url === item.url)?.[0] ??
+        site.defaultLocale;
+    const layout = await api.layout({ locale });
+    const title = String(item[titleField] ?? "");
+    const listingPath = item.url?.replace(/\/[^/]+\/?$/, "") ?? "";
+    const listing = entries.find((e) => e.urls[locale] === listingPath) ?? homeOf(locale);
+    return {
+        kind: "item",
+        collection,
+        item,
+        site,
+        locale,
+        title: item.seo?.title ?? title,
+        seo: item.seo,
+        alternates: item.alternates ?? {},
+        url: item.url ?? path,
+        breadcrumbs: [...(listing ? trail(listing.id, locale) : []), { title, url: item.url ?? path }],
+        header: layout.header,
+        footer: layout.footer,
+    };
+}
 let staticPaths;
 /**
  * Toutes les routes du site : pages publiées, puis éléments des collections avec page. Calculé
@@ -61,22 +140,7 @@ async function buildStaticPaths(config) {
     const paths = [];
     const layouts = new Map(await Promise.all(site.locales.map(async (l) => [l, await api.layout({ locale: l })])));
     const entries = await api.pages();
-    const byId = new Map(entries.map((e) => [e.id, e]));
-    const homeOf = (locale) => entries.find((e) => e.urls[locale] === "/" || e.urls[locale] === `/${locale}`);
-    /** Accueil, puis les pages parentes, puis la page elle-même. */
-    const trail = (id, locale) => {
-        const out = [];
-        for (let e = byId.get(id); e; e = e.parentId ? byId.get(e.parentId) : undefined) {
-            const url = e.urls[locale];
-            if (url)
-                out.unshift({ title: e.titles[locale] || e.titles[site.defaultLocale] || "", url });
-        }
-        const home = homeOf(locale);
-        if (home && out[0]?.url !== home.urls[locale]) {
-            out.unshift({ title: home.titles[locale] || site.name, url: home.urls[locale] });
-        }
-        return out;
-    };
+    const { trail, homeOf } = pageTree(entries, site);
     for (const entry of entries) {
         for (const [locale, url] of Object.entries(entry.urls)) {
             const page = await api.page(url);
@@ -111,12 +175,7 @@ async function buildStaticPaths(config) {
             for (const item of list.items) {
                 if (!item.url || item.access?.reserved)
                     continue;
-                const alternates = {};
-                for (const other of byLocale) {
-                    const url = other.list.items.find((i) => i.id === item.id)?.url;
-                    if (url)
-                        alternates[other.locale] = url;
-                }
+                const alternates = { ...item.alternates };
                 // Fil d'Ariane : accueil, page de la liste si elle existe (`/vins`), puis l'élément.
                 const listing = entries.find((e) => e.urls[locale] === def.page.path || e.urls[locale] === `/${locale}${def.page.path}`) ?? homeOf(locale);
                 const title = String(item[def.titleField] ?? "");

package/dist/index.js

@@ -8,6 +8,20 @@ export * from "./helpers.js";
 export * from "./seo.js";
 export * from "./shop.js";
 const MEDIA_URL = "https://medias.agence-zef.fr";
+/** `rendering` de `zef.config.ts` (lu comme la CLI, avec jiti) ; `static` en cas de doute. */
+async function readRendering(file) {
+    if (!existsSync(file))
+        return "static";
+    try {
+        const { createJiti } = await import("jiti");
+        const jiti = createJiti(import.meta.url, { moduleCache: false, fsCache: false });
+        const config = await jiti.import(file, { default: true });
+        return config?.rendering === "cached" ? "cached" : "static";
+    }
+    catch {
+        return "static";
+    }
+}
 /** Domaines autorisés pour l'optimisation des images distantes (`image.remotePatterns`). */
 function mediaPatterns(urls) {
     return urls.flatMap((raw) => {
@@ -84,30 +98,64 @@ export default function zef(options = {}) {
                         ]),
                     },
                 });
+                // Performance : le CSS (quelques Ko par page) est écrit dans la page plutôt que chargé à
+                // part, ce qui retire une requête bloquante du premier affichage. Un site peut choisir
+                // « never » dans son `astro.config`.
+                if (config.build.inlineStylesheets === "auto") {
+                    updateConfig({ build: { inlineStylesheets: "always" } });
+                }
                 addWatchFile(join(root, ".env"));
                 const layout = join(root, options.layout ?? "src/layouts/Page.astro");
                 const configFile = join(root, "zef.config.ts");
+                // Rendu des pages (`defineConfig({ rendering })`) : construites au build (`static`), ou
+                // rendues à la demande et gardées en cache par le CDN, invalidé par une publication
+                // (`cached`, demande un adaptateur).
+                const rendering = await readRendering(configFile);
+                const cached = rendering === "cached" && Boolean(config.adapter || command === "dev");
+                if (rendering === "cached" && !cached) {
+                    logger.warn("rendering « cached » sans adaptateur : pages construites au build");
+                }
+                if (cached && !config.cache?.provider) {
+                    // Cache du CDN de l'hébergeur : Vercel (tags, invalidation), sinon en mémoire.
+                    const vercelProvider = config.adapter?.name === "@astrojs/vercel";
+                    updateConfig({
+                        cache: {
+                            provider: vercelProvider
+                                ? { name: "vercel", entrypoint: "@astrojs/vercel/cache/provider" }
+                                : { name: "memory", entrypoint: "astro/cache/memory" },
+                        },
+                    });
+                }
                 injectRoute({
                     pattern: "/[...path]",
-                    entrypoint: "@agence-zef/astro/routes/page.astro",
-                    prerender: true,
+                    entrypoint: cached
+                        ? "@agence-zef/astro/routes/page-cached.astro"
+                        : "@agence-zef/astro/routes/page.astro",
+                    prerender: !cached,
                 });
                 injectRoute({
                     pattern: "/robots.txt",
                     entrypoint: "@agence-zef/astro/routes/robots.ts",
-                    prerender: true,
+                    prerender: !cached,
                 });
                 // Référencement prêt à l'emploi (§ 5.13) : sitemap et présentation pour les IA.
                 injectRoute({
                     pattern: "/sitemap.xml",
                     entrypoint: "@agence-zef/astro/routes/sitemap.ts",
-                    prerender: true,
+                    prerender: !cached,
                 });
                 injectRoute({
                     pattern: "/llms.txt",
                     entrypoint: "@agence-zef/astro/routes/llms.ts",
-                    prerender: true,
+                    prerender: !cached,
                 });
+                if (cached) {
+                    injectRoute({
+                        pattern: "/__zef/revalidate",
+                        entrypoint: "@agence-zef/astro/routes/revalidate.ts",
+                        prerender: false,
+                    });
+                }
                 // Aperçu de l'éditeur : rendu à la demande, donc avec un adaptateur (Vercel) ou en dev.
                 if (command === "dev" || config.adapter) {
                     injectRoute({
@@ -131,7 +179,7 @@ export default function zef(options = {}) {
                 }
                 // Contenu réservé (lot 14e5c) : les adresses que la route statique n'a pas générées
                 // (pages et éléments réservés) sont rendues à la demande, avec la session du compte.
-                if (options.shop && (command === "dev" || config.adapter)) {
+                if (options.shop && !cached && (command === "dev" || config.adapter)) {
                     injectRoute({
                         pattern: "/[...zefReserved]",
                         entrypoint: "@agence-zef/astro/routes/reserved.astro",

package/dist/seo.d.ts

@@ -46,6 +46,8 @@ export type SeoInput = {
     type?: string;
     /** Données structurées en plus (article, évènement, FAQ…). */
     jsonLd?: Record<string, unknown> | Record<string, unknown>[];
+    /** Icône de l'onglet (`/favicon.svg`) ; à défaut, le logo du client dans le CMS. */
+    icon?: string | null;
 };
 export type SeoTags = {
     title: string;

package/dist/seo.js

@@ -73,6 +73,9 @@ export function seoTags(input) {
     if (image)
         add("name", "twitter:image", absolute(origin, image.url));
     const links = [{ rel: "canonical", href: canonical }];
+    const icon = input.icon ?? site.logo;
+    if (icon)
+        links.push({ rel: "icon", href: icon });
     const langs = Object.entries(alternates);
     if (langs.length > 1) {
         for (const [lang, href] of langs)

package/dist/ui.d.ts

@@ -0,0 +1,7 @@
+/** Ouvre une fenêtre `<Dialog>` par son identifiant. */
+export declare function openDialog(id: string): void;
+/**
+ * Ferme une fenêtre en laissant jouer son animation de sortie (`[data-closing]`), puis la
+ * ferme vraiment ; tout de suite si le visiteur réduit les animations ou sans animation CSS.
+ */
+export declare function closeDialog(target: HTMLDialogElement | string): void;

package/dist/ui.js

@@ -0,0 +1,33 @@
+/*
+ * Comportements des composants d'interface (`<Dialog>`, `<Accordion>`) partagés par leurs
+ * scripts : exportés pour qu'un site les déclenche lui-même.
+ */
+const reduced = () => window.matchMedia("(prefers-reduced-motion: reduce)").matches;
+/** Ouvre une fenêtre `<Dialog>` par son identifiant. */
+export function openDialog(id) {
+    const dialog = document.getElementById(id);
+    if (dialog instanceof HTMLDialogElement && !dialog.open)
+        dialog.showModal();
+}
+/**
+ * Ferme une fenêtre en laissant jouer son animation de sortie (`[data-closing]`), puis la
+ * ferme vraiment ; tout de suite si le visiteur réduit les animations ou sans animation CSS.
+ */
+export function closeDialog(target) {
+    const dialog = typeof target === "string" ? document.getElementById(target) : target;
+    if (!(dialog instanceof HTMLDialogElement) || !dialog.open || dialog.hasAttribute("data-closing"))
+        return;
+    const finish = () => {
+        dialog.removeAttribute("data-closing");
+        dialog.close();
+    };
+    if (reduced())
+        return finish();
+    dialog.setAttribute("data-closing", "");
+    const animated = getComputedStyle(dialog).animationName !== "none";
+    if (!animated)
+        return finish();
+    dialog.addEventListener("animationend", finish, { once: true });
+    // Filet : si l'animation ne se termine pas (onglet en arrière-plan), on ferme quand même.
+    setTimeout(() => dialog.hasAttribute("data-closing") && finish(), 400);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agence-zef/astro",
-  "version": "0.4.1",
+  "version": "0.6.0-pilot.0",
   "description": "Intégration Astro du CMS ZEF : routes, rendu des sections, aperçu, composants réutilisables sans style.",
   "license": "MIT",
   "type": "module",
@@ -50,11 +50,27 @@
     "./VideoPlayer.astro": "./components/VideoPlayer.astro",
     "./Subscriptions.astro": "./components/Subscriptions.astro",
     "./ReservedNotice.astro": "./components/ReservedNotice.astro",
-    "./routes/shop.ts": "./components/routes/shop.ts"
+    "./routes/shop.ts": "./components/routes/shop.ts",
+    "./Dialog.astro": "./components/Dialog.astro",
+    "./Accordion.astro": "./components/Accordion.astro",
+    "./AccordionItem.astro": "./components/AccordionItem.astro",
+    "./Popover.astro": "./components/Popover.astro",
+    "./Field.astro": "./components/Field.astro",
+    "./Input.astro": "./components/Input.astro",
+    "./Select.astro": "./components/Select.astro",
+    "./Checkbox.astro": "./components/Checkbox.astro",
+    "./styles.css": "./styles.css",
+    "./ui": {
+      "types": "./dist/ui.d.ts",
+      "import": "./dist/ui.js"
+    },
+    "./routes/page-cached.astro": "./components/routes/page-cached.astro",
+    "./routes/revalidate.ts": "./components/routes/revalidate.ts"
   },
   "files": [
     "dist",
-    "components"
+    "components",
+    "styles.css"
   ],
   "publishConfig": {
     "access": "public"
@@ -67,8 +83,9 @@
     "@types/node": "^24.0.0"
   },
   "dependencies": {
-    "@agence-zef/schema": "0.4.0",
-    "@agence-zef/sdk": "0.4.1"
+    "jiti": "^2.6.1",
+    "@agence-zef/schema": "0.6.0-pilot.0",
+    "@agence-zef/sdk": "0.6.0-pilot.0"
   },
   "homepage": "https://agence-zef.fr",
   "scripts": {