@cardinali-studio/adminkit 2.2.3 → 2.2.6

package/dist/app/App.js

@@ -58,6 +58,7 @@ export function App() {
     const local = isLocalPreview();
     const pages = usePages();
     const home = useHome(section === "home");
+    const HomeEditorView = site().homeEditor ?? HomeEditor;
     /* Anche la Panoramica: le sue card devono sapere quali funzioni aggiuntive sono attive, e
        lo stato è quello — non una seconda copia. È una lettura sola, e la Panoramica è la
        schermata da cui si entra, quindi arriva prima che serva. */
@@ -257,7 +258,7 @@ export function App() {
                                         /* Con un errore di caricamento c'era solo la riga rossa: nessun modo di riprovare
                                            se non ricaricando il pannello a mano. Le altre sezioni il bottone ce l'hanno. */
                                         home.error ? (_jsxs("div", { className: "pane-empty", children: [_jsx("p", { className: "ak-error", children: home.error }), _jsx("button", { className: "ak-btn", onClick: () => void home.load(), children: "Riprova" })] }))
-                                            : home.data ? _jsx(HomeEditor, { data: home.data, group: homeGroup, onChange: home.change, pickMedia: pickMedia })
+                                            : home.data ? _jsx(HomeEditorView, { data: home.data, group: homeGroup, onChange: home.change, pickMedia: pickMedia })
                                                 : _jsx("p", { className: "ak-hint", children: "Carico\u2026" })), section === "settings" && (settings.error ? (_jsxs("div", { className: "pane-empty", children: [_jsx("p", { className: "ak-error", children: settings.error }), _jsx("button", { className: "ak-btn", onClick: () => void settings.load(), children: "Riprova" })] })) : settings.data ? (settingsView === "seo"
                                             ? _jsx(WebsiteSeoSettingsEditor, { value: settings.data, onChange: settings.change })
                                             : _jsx(SiteSettingsEditor, { value: settings.data, onChange: settings.change, pickMediaFiles: pickMediaFiles, focus: route[1] })) : _jsx("p", { className: "pane-empty ak-hint", children: "Carico\u2026" })), view === "media" && _jsx(MediaGrid, { lib: media }), view === "trash" && _jsx(Trash, {}), section === "requests" && (requests.error ? _jsx("p", { className: "ak-error", children: requests.error })

package/dist/app/lib/home.js

@@ -60,7 +60,11 @@ export function useHome(active) {
             const mapped = site().homeDocument;
             if (contentPersistenceMode() === "d1" && mapped && revision) {
                 const revisionId = crypto.randomUUID();
-                await api.saveContent({ revisionId, documentId: mapped.documentId, baseRevisionId: revision.base, expectedDraftRevisionId: revision.expected, kind: mapped.kind, locale: mapped.locale, schemaVersion: mapped.schemaVersion, payload: data, tombstone: false });
+                /* The Worker validates and may normalize a document before checking its signed
+                 * representation. Sign the site-owned canonical payload here too, otherwise an
+                 * obsolete/unknown client field becomes a misleading "documento non valido". */
+                const payload = mapped.toPayload ? mapped.toPayload(data) : data;
+                await api.saveContent({ revisionId, documentId: mapped.documentId, baseRevisionId: revision.base, expectedDraftRevisionId: revision.expected, kind: mapped.kind, locale: mapped.locale, schemaVersion: mapped.schemaVersion, payload: payload, tombstone: false });
                 setRevision({ base: revisionId, expected: revisionId });
                 setNotice("Bozza D1 salvata");
                 setDirty(false);

package/dist/app/lib/settings.js

@@ -45,7 +45,11 @@ export function useSiteSettings(active) {
                 const payload = document.draftPayload ?? document.publishedPayload;
                 if (!payload || (document.draftPayload !== null ? document.draftTombstone : document.publishedTombstone))
                     throw new Error("content_unavailable");
-                setData({ ...empty, ...JSON.parse(payload), password: "" });
+                const stored = JSON.parse(payload);
+                const settings = mapped.fromPayload ? mapped.fromPayload(stored) : stored;
+                if (!settings || typeof settings !== "object" || Array.isArray(settings))
+                    throw new Error("content_unavailable");
+                setData({ ...empty, ...settings, password: "" });
                 setRevision({ base: document.draftRevisionId ?? document.publishedRevisionId, expected: document.draftRevisionId });
             }
             else {
@@ -72,7 +76,8 @@ export function useSiteSettings(active) {
             const mapped = site().siteSettingsDocument;
             if (contentPersistenceMode() === "d1" && mapped && revision) {
                 const revisionId = crypto.randomUUID();
-                await api.saveContent({ revisionId, documentId: mapped.documentId, baseRevisionId: revision.base, expectedDraftRevisionId: revision.expected, kind: mapped.kind, locale: mapped.locale, schemaVersion: mapped.schemaVersion, payload: data, tombstone: false });
+                const payload = mapped.toPayload ? mapped.toPayload(data) : data;
+                await api.saveContent({ revisionId, documentId: mapped.documentId, baseRevisionId: revision.base, expectedDraftRevisionId: revision.expected, kind: mapped.kind, locale: mapped.locale, schemaVersion: mapped.schemaVersion, payload: payload, tombstone: false });
                 setRevision({ base: revisionId, expected: revisionId });
                 setDirty(false);
                 setNotice("Bozza D1 salvata");

package/dist/app/site.d.ts

@@ -1,4 +1,5 @@
 import type * as z from "zod";
+import type { ComponentType } from "react";
 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
@@ -38,6 +39,17 @@ export interface SiteAdminConfig {
     languages?: LanguagesConfig;
     /** Forma del singleton home: i suoi `group` diventano le voci della seconda colonna. */
     home: Shape;
+    /** Optional site-owned Home surface. The kit keeps its legacy visual editor
+     * as a fallback, while a site with a different document shape can render its
+     * own schema-driven editor without teaching the shared package its fields. */
+    homeEditor?: ComponentType<{
+        data: Record<string, unknown>;
+        group: string;
+        onChange: (next: Record<string, unknown>) => void;
+        pickMedia: (opts: {
+            multiple: boolean;
+        }) => Promise<string[] | null>;
+    }>;
     /** Peso di ordinamento di una pagina data la sua posizione nell'elenco. */
     positionWeight: (item: Record<string, unknown>, index: number, all: Record<string, unknown>[]) => number;
     /**
@@ -49,18 +61,26 @@ export interface SiteAdminConfig {
     modules?: Record<string, boolean>;
     /** Git remains the compatibility default. D1 is an explicit, later site cutover. */
     contentPersistence?: "github" | "d1";
-    /** Lossless D1 identity for the singleton home; required before its editor may leave Git. */
+    /** Lossless D1 identity for the singleton home; required before its editor may leave Git.
+     * A site can canonicalize its editor value before the client signs it: this keeps the
+     * checksum aligned with the same schema normalization performed by the Worker. */
     homeDocument?: {
         documentId: string;
         kind: string;
         locale: string;
         schemaVersion: number;
+        toPayload?: (home: Record<string, unknown>) => unknown;
     };
+    /** Identity plus the deliberately site-owned conversion between the generic
+     * settings form and an immutable D1 document payload. A site may persist the
+     * object directly or keep it inside a repository-specific file envelope. */
     siteSettingsDocument?: {
         documentId: string;
         kind: string;
         locale: string;
         schemaVersion: number;
+        fromPayload?: (payload: unknown) => Record<string, unknown>;
+        toPayload?: (settings: Record<string, unknown>) => unknown;
     };
 }
 /** Chiamata da `mountAdmin` prima del primo render. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cardinali-studio/adminkit",
-  "version": "2.2.3",
+  "version": "2.2.6",
   "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",