@cardinali-studio/adminkit 1.0.0 → 2.0.0

package/dist/app/routes/PageActions.js

@@ -14,7 +14,6 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * scomparire mentre la si rinomina fa perdere il segno di dove si era.
  */
 import { useMemo, useState } from "react";
-import { ui } from "../../index.js";
 import { site } from "../site.js";
 import { slugify, uniqueSlug } from "../lib/slug";
 import { Icon } from "../ui/icons";
@@ -33,7 +32,7 @@ import { Icon } from "../ui/icons";
  * modulo andava bene: è il genere di cosa che cambia quando una dipendenza smette di essere
  * statica e diventa iniettata. */
 function tipiDisponibili() {
-    const tipi = ui.get(site().page.type)?.options ?? [];
+    const tipi = Object.entries(site().pages).map(([value, page]) => ({ value, label: page.label }));
     /* La preselezione: "Pagina" se c'è (è la scelta di gran lunga più frequente), altrimenti la
      * prima opzione — così questo elenco non può restare senza un valore valido. */
     const iniziale = tipi.some((t) => t.value === "page") ? "page" : (tipi[0]?.value ?? "page");

package/dist/app/routes/PageEditor.js

@@ -14,7 +14,7 @@ import { SortableContext, arrayMove, rectSortingStrategy, sortableKeyboardCoordi
 import { CSS } from "@dnd-kit/utilities";
 import { ProseField, SchemaForm } from "../../form/index.js";
 import { api } from "../../index.js";
-import { site } from "../site.js";
+import { pageType } from "../site.js";
 import { uniqueSlug } from "../lib/slug";
 import { proseStats } from "../lib/text";
 import { Icon } from "../ui/icons";
@@ -163,7 +163,8 @@ function GalleryEditor({ value, onChange, pickMediaFiles, }) {
 }
 export function PageEditor({ page, onChange, onRefresh, pristine, pickMedia, pickMediaFiles, }) {
     const [bodyState, setBodyState] = useState("idle");
-    const showBody = site().hasBody(page.type);
+    const definition = pageType(page.type);
+    const showBody = definition?.hasBody === true;
     const isGallery = page.type === "gallery";
     const isPortfolio = page.type === "portfolio";
     /* APRENDO UNA PAGINA SI RILEGGE DAL REPO, non dal manifest pubblicato. */
@@ -229,5 +230,5 @@ export function PageEditor({ page, onChange, onRefresh, pristine, pickMedia, pic
            il caso in cui la stessa griglia si vedeva due volte. */
         return (_jsxs("div", { className: "ed ed-gallery", children: [bodyState === "error" && (_jsx("p", { className: "pe-load-error", children: "Non sono riuscito ad aggiornare i dati della pagina dal sito." })), _jsx(GallerySectionsEditor, { value: page.sections, onChange: (sections) => onChange({ ...page, sections }), renderGallery: (images, onImages) => (_jsx(GalleryEditor, { value: images, onChange: onImages, pickMediaFiles: pickMediaFiles })), pickMediaFiles: pickMediaFiles })] }));
     }
-    return (_jsxs("div", { className: "ed", children: [_jsx(SchemaForm, { shape: site().page, value: page, omit: commonOmissions, onChange: (next) => onChange({ ...next, slug: page.slug }), pickMedia: pickMedia, pickMediaFiles: pickMediaFiles }), showBody && (_jsxs("fieldset", { className: "ak-group", children: [_jsx("legend", { className: "ak-legend", children: "testo della pagina" }), bodyState === "loading" && _jsx("p", { className: "ak-hint", children: "Carico\u2026" }), bodyState === "error" && _jsx("p", { className: "ak-error", children: "Non sono riuscito a caricare il testo." }), _jsx("textarea", { className: "ak-input ak-textarea", rows: 12, value: typeof page.body === "string" ? page.body : "", onChange: (event) => onChange({ ...page, body: event.target.value }) })] }))] }));
+    return (_jsxs("div", { className: "ed", children: [_jsx(SchemaForm, { shape: definition?.shape ?? {}, value: page, omit: commonOmissions, onChange: (next) => onChange({ ...next, slug: page.slug }), pickMedia: pickMedia, pickMediaFiles: pickMediaFiles }), showBody && (_jsxs("fieldset", { className: "ak-group", children: [_jsx("legend", { className: "ak-legend", children: "testo della pagina" }), bodyState === "loading" && _jsx("p", { className: "ak-hint", children: "Carico\u2026" }), bodyState === "error" && _jsx("p", { className: "ak-error", children: "Non sono riuscito a caricare il testo." }), _jsx("textarea", { className: "ak-input ak-textarea", rows: 12, value: typeof page.body === "string" ? page.body : "", onChange: (event) => onChange({ ...page, body: event.target.value }) })] }))] }));
 }

package/dist/app/site.d.ts

@@ -1,5 +1,15 @@
 import type * as z from "zod";
 export type Shape = Record<string, z.ZodType>;
+/** Contratto di UNA tipologia di pagina. Il tipo sceglie la forma prima che un file venga
+ * letto, validato o riscritto: non esiste più uno schema che contenga i campi di tutte le
+ * pagine del sito. */
+export interface PageTypeConfig {
+    label: string;
+    shape: Shape;
+    object: z.ZodType;
+    payload: z.ZodType;
+    hasBody: boolean;
+}
 export interface SiteAdminConfig {
     /** Il nome mostrato in cima al rail, e il ripiego del titolo nell'anteprima SEO. */
     name: string;
@@ -16,14 +26,12 @@ export interface SiteAdminConfig {
         name: string;
         email: string;
     };
-    /** Forma del front matter di una pagina della collezione. */
-    page: Shape;
+    /** Forme delle pagine della collezione, indicizzate dal loro `type` nel front matter. */
+    pages: Record<string, PageTypeConfig>;
     /** Forma del singleton home: i suoi `group` diventano le voci della seconda colonna. */
     home: Shape;
     /** Peso di ordinamento di una pagina data la sua posizione nell'elenco. */
     positionWeight: (item: Record<string, unknown>, index: number, all: Record<string, unknown>[]) => number;
-    /** Quali tipi di pagina hanno un corpo markdown oltre al front matter. */
-    hasBody: (type: unknown) => boolean;
     /**
      * Le funzioni aggiuntive accese su questo sito. Ciò che non è dichiarato è SPENTO: un
      * interruttore dimenticato deve dare una funzione assente, non una accesa per sbaglio.
@@ -35,3 +43,4 @@ export interface SiteAdminConfig {
 /** Chiamata da `mountAdmin` prima del primo render. */
 export declare function setSiteConfig(config: SiteAdminConfig): void;
 export declare function site(): SiteAdminConfig;
+export declare function pageType(type: unknown): PageTypeConfig | null;

package/dist/app/site.js

@@ -16,3 +16,6 @@ export function site() {
     }
     return current;
 }
+export function pageType(type) {
+    return site().pages[String(type ?? "")] ?? null;
+}

package/dist/functions/_shared/media-content.js

@@ -5,7 +5,7 @@
  * quando possibile, riscritti durante delete/move dei media.
  */
 import { deserializeItem, checkFidelity } from "../../index.js";
-import { site } from "../site.js";
+import { site, pageType } from "../site.js";
 import {
   getRepoSnapshot, getText, commitUpserts, GitHubConflictError,
 } from "./github.js";
@@ -36,6 +36,12 @@ function jsonSource(path, text, label) {
   return { kind: "settings", path, text, label };
 }
 
+function typeOf(md) {
+  const m = (md || "").match(/^---\n([\s\S]*?)\n---/);
+  const t = m && m[1].match(/^type:\s*(.+)$/m);
+  return t ? t[1].trim().replace(/^["']|["']$/g, "") : "";
+}
+
 /** Legge tutte le sorgenti dallo stesso commit, senza trasformare errori in file vuoti. */
 export async function readMediaSources(env) {
   const snapshot = await getRepoSnapshot(env);
@@ -61,7 +67,9 @@ export async function readMediaSources(env) {
     }
     const slug = path.split("/")[1] || "";
     const extra = { slug };
-    return frontmatterSource(path, text, pageLabel(text, path, site().page, extra), site().page, site().pageObject, extra);
+    const definition = pageType(typeOf(text));
+    if (!definition) throw new Error(`${path}: tipo pagina non gestito`);
+    return frontmatterSource(path, text, pageLabel(text, path, definition.shape, extra), definition.shape, definition.object, extra);
   });
   return { base: { commitSha: snapshot.commitSha, treeSha: snapshot.treeSha }, sources };
 }

package/dist/functions/api/pages/get.js

@@ -4,7 +4,13 @@
 import { json } from "../../_shared/assets.js";
 import { getText } from "../../_shared/github.js";
 import { splitFrontMatter, deserializeItem } from "../../../index.js";
-import { site } from "../../site.js";
+import { pageType } from "../../site.js";
+
+function typeOf(md) {
+  const m = (md || "").match(/^---\n([\s\S]*?)\n---/);
+  const t = m && m[1].match(/^type:\s*(.+)$/m);
+  return t ? t[1].trim().replace(/^["']|["']$/g, "") : "";
+}
 
 export async function onRequestGet({ request, env }) {
   if (!env.GITHUB_TOKEN || !env.GITHUB_REPO) return json({ ok: false, error: "backend GitHub non configurato" }, 500);
@@ -20,7 +26,9 @@ export async function onRequestGet({ request, env }) {
   // Il front matter lo legge lo schema, non uno scanner di righe scritto qui: prima questo
   // file aveva la sua interpretazione, diversa da quella del serializzatore, e due letture
   // dello stesso formato sono due occasioni di divergere.
-  const model = deserializeItem(text, site().page, { slug });
+  const definition = pageType(typeOf(text));
+  if (!definition) return json({ ok: false, error: "tipo pagina non gestito" }, 404);
+  const model = deserializeItem(text, definition.shape, { slug });
 
   return json({ ok: true, slug, body, page: model });
 }

package/dist/functions/api/pages.js

@@ -17,7 +17,7 @@
  * Secret/vars: GITHUB_TOKEN (secret), GITHUB_REPO, GITHUB_BRANCH.
  */
 import { serializeItem, deserializeItem, checkFidelity } from "../../index.js";
-import { site } from "../site.js";
+import { site, pageType } from "../site.js";
 import { getRepoSnapshot, getText, DRAFT } from "../_shared/github.js";
 
 const GH = "https://api.github.com";
@@ -90,7 +90,9 @@ export async function onRequestGet({ env }) {
       // due criteri erano scritti in due posti e coincidevano solo per caso.
       if (site().excludedTypes.includes(typeOf(text))) return null;
       const slug = t.path.split("/")[1];
-      return { slug, url: `/${slug}/`, sha: t.sha, page: deserializeItem(text, site().page, { slug }) };
+      const definition = pageType(typeOf(text));
+      if (!definition) return null;
+      return { slug, url: `/${slug}/`, sha: t.sha, page: deserializeItem(text, definition.shape, { slug }) };
     }));
 
     const pages = letti.filter(Boolean)
@@ -140,7 +142,17 @@ export async function onRequestPost({ request, env, data }) {
    * risultato del parse la romperebbe in silenzio. Si valida l'oggetto e si serializza quello. */
   const problems = [];
   for (const p of pages) {
-    const r = site().pagePayload.safeParse(p);
+    const definition = pageType(p?.type);
+    if (!definition) {
+      /* Le pagine lasciate intatte viaggiano intenzionalmente come solo riferimento
+       * (`slug`, `_orig`, `_sha`, `inMenu`): il loro tipo si ricava dal file esistente più
+       * avanti, quando lo stesso giro carica il contenuto da preservare. Una pagina NUOVA,
+       * invece, non ha nessun file da cui scoprirlo e deve dichiararlo qui. */
+      if (p?.type === undefined && p?._orig) continue;
+      problems.push({ slug: typeof p?.slug === "string" ? p.slug : "?", detail: "tipo pagina non gestito" });
+      continue;
+    }
+    const r = definition.payload.safeParse(p);
     if (r.success) continue;
     const detail = r.error.issues.slice(0, 5)
       .map((i) => `${i.path.join(".") || "?"} ${i.message}`).join("; ");
@@ -226,6 +238,7 @@ async function commitPages(args, attempt = 0) {
   const entries = [];
   const desiredSlugs = new Set();
   const rejected = [];
+  const invalidTypes = [];
 
   for (const p of pages) {
     desiredSlugs.add(p.slug);
@@ -235,12 +248,14 @@ async function commitPages(args, attempt = 0) {
     const oldMd = sourceSlug
       ? await readFile(env, repo, branch, `content/${sourceSlug}/index.md`)
       : null;
+    const definition = pageType(p.type || typeOf(oldMd));
+    if (!definition) { invalidTypes.push(p.slug); continue; }
 
     // GUARDIA DI FEDELTÀ: se non sappiamo riprodurre il file che stiamo per sovrascrivere,
     // non lo sovrascriviamo. Intercetta i costrutti che il lettore del front matter non regge
     // e trasforma una corruzione silenziosa in un rifiuto visibile.
     if (oldMd) {
-      const f = checkFidelity(oldMd, site().page, { slug: sourceSlug });
+      const f = checkFidelity(oldMd, definition.shape, { slug: sourceSlug });
       if (!f.ok) { rejected.push(sourceSlug); continue; }
     }
 
@@ -249,17 +264,29 @@ async function commitPages(args, attempt = 0) {
       mode: "100644",
       type: "blob",
       content: serializeItem(p, {
-        shape: site().page,
+        shape: definition.shape,
         oldMd,
         // Solo per i tipi che un corpo ce l'hanno: su una gallery il segnaposto sarebbe
         // testo scritto nel repo che non compare da nessuna parte (vedi hasBody).
-        placeholderBody: site().hasBody(p.type)
+        placeholderBody: definition.hasBody
           ? (m) => `Placeholder content for **${m.title || p.slug}**.`
           : undefined,
       }),
     });
   }
 
+  if (invalidTypes.length) {
+    return {
+      status: 400,
+      body: {
+        ok: false,
+        code: "invalid",
+        error: `Tipo pagina non gestito per: ${invalidTypes.join(", ")}. Non ho salvato nulla.`,
+        slugs: invalidTypes,
+      },
+    };
+  }
+
   if (rejected.length) {
     return {
       status: 409,

package/dist/functions/site.js

@@ -36,3 +36,9 @@ export function site() {
 export function moduleEnabled(name) {
   return current?.modules?.[name] === true;
 }
+
+/** La stessa scelta di tipo che fa la shell. Tenerla qui evita che endpoint diversi
+ * deserializzino, validino e serializzino una pagina con forme differenti. */
+export function pageType(type) {
+  return current?.pages?.[String(type ?? "")] ?? null;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cardinali-studio/adminkit",
-  "version": "1.0.0",
+  "version": "2.0.0",
   "type": "module",
   "description": "Motore riusabile di un pannello di amministrazione per siti Hugo su Cloudflare Pages: codec del front matter guidato dallo schema, form React, libreria media su R2. NIENTE di specifico di un sito qui dentro.",
   "license": "UNLICENSED",