@materializecms/server 0.7.0 → 0.8.0

package/CHANGELOG.md

@@ -4,6 +4,12 @@ Ogni versione, dalla più recente. Le novità in arrivo si scrivono sotto «Pros
 
 ## Prossima versione
 
+## 0.8.0 — 2026-11-07
+
+- **Un documento alla volta**: se un'altra persona sta modificando la pagina che apri, la vedi in sola lettura con chi ci lavora e da quanto, e puoi prendere il controllo. Nessuno sovrascrive più il lavoro di un altro senza saperlo, nemmeno da due schede.
+- **Sezioni con effetti**: nuova categoria **Effetti** nella libreria, con 7 sezioni pronte che usano le scene WebGL e il 3D: apertura su aurora, apertura con seta, logo 3D (carica il tuo SVG), oggetto 3D (scegli un modello `.glb`), numeri sul globo, immagine animata e invito con particelle. Si trovano anche cercando «webgl».
+- Nuovo schema di colori **Scuro** per le sezioni: resta scuro con il testo chiaro in qualsiasi tema.
+- **Oscura** ora funziona anche sugli sfondi animati delle sezioni, non solo sulle foto.
 ## 0.7.0 — 2026-11-06
 
 - **Tour del pannello**: la prima volta che entri, un tour mostra il pannello una zona alla volta, come quello dell'editor. Si rifà dal menu del profilo (**Tour del pannello**) o cercando «tour» con ⌘K.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@materializecms/server",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Il server di Materialize: API, accessi, media, backup, aggiornamenti dal pannello e server MCP.",
   "type": "module",
   "license": "MIT",
@@ -20,9 +20,9 @@
   "dependencies": {
     "@anthropic-ai/sdk": "1.3.0",
     "@hono/node-server": "2.1.5",
-    "@materializecms/admin": "0.7.0",
-    "@materializecms/core": "0.7.0",
-    "@materializecms/db": "0.7.0",
+    "@materializecms/admin": "0.8.0",
+    "@materializecms/core": "0.8.0",
+    "@materializecms/db": "0.8.0",
     "@modelcontextprotocol/sdk": "1.32.2",
     "hono": "4.13.14",
     "htmlparser2": "12.0.0",

package/src/app.js

@@ -1676,6 +1676,68 @@ export function createApp(base) {
         await comments.remove(comment.id);
         return c.body(null, 204);
     });
+    const turns = new Map();
+    const TURN_TTL = 45_000;
+    const turnOf = (docId) => {
+        const turn = turns.get(docId);
+        if (turn && Date.now() - turn.at > TURN_TTL) {
+            turns.delete(docId);
+            return null;
+        }
+        return turn ?? null;
+    };
+    const turnJson = (turn, user, tab) => ({
+        mine: !!turn && turn.userId === user.id && turn.tab === tab,
+        holder: turn ? { name: turn.name, since: new Date(turn.since).toISOString(), self: turn.userId === user.id } : null,
+    });
+    /** Holds the turn (or asks for it); take: true takes it from whoever has it. */
+    app.post('/api/documents/:id/turn', requireUser, async (c) => {
+        const input = await body(c, z.object({ tab: z.string().min(8).max(64), take: z.boolean().optional() }));
+        const user = c.get('user');
+        const docId = c.req.param('id');
+        const now = Date.now();
+        for (const [k, t] of turns)
+            if (now - t.at > TURN_TTL * 4)
+                turns.delete(k);
+        const turn = turnOf(docId);
+        if (!turn || (turn.userId === user.id && turn.tab === input.tab) || input.take) {
+            if (input.take && turn && turn.tab !== input.tab) {
+                // The one who had it learns who took it, at their next beat.
+                turns.set(`lost:${docId}:${turn.tab}`, { ...turn, takenBy: user.name, at: now });
+                await record(c, 'document.turn_taken', '', { id: docId, from: turn.name });
+            }
+            const keep = turn && turn.userId === user.id && turn.tab === input.tab;
+            turns.set(docId, { userId: user.id, name: user.name, tab: input.tab, since: keep ? turn.since : now, at: now });
+            return c.json(turnJson(turnOf(docId), user, input.tab));
+        }
+        const taken = turns.get(`lost:${docId}:${input.tab}`);
+        if (taken)
+            turns.delete(`lost:${docId}:${input.tab}`);
+        return c.json({ ...turnJson(turn, user, input.tab), takenBy: taken?.takenBy ?? null });
+    });
+    /** Leaves the turn: the document closed. */
+    app.delete('/api/documents/:id/turn', requireUser, async (c) => {
+        const docId = c.req.param('id');
+        const turn = turnOf(docId);
+        if (turn && turn.userId === c.get('user').id && turn.tab === c.req.query('tab'))
+            turns.delete(docId);
+        return c.body(null, 204);
+    });
+    /**
+     * Changes to a document from someone who is not on turn are refused: from another person, or
+     * from another tab of the same person. The API and AI tools of the person on turn pass.
+     */
+    const guardTurn = (c, docId) => {
+        const turn = turnOf(docId);
+        if (!turn)
+            return;
+        const user = c.get('user');
+        const tab = c.req.header('x-mz-tab');
+        if (turn.userId !== user.id)
+            throw new ApiError(409, 'not_your_turn', `${turn.name} sta modificando questo documento: le tue modifiche non sono state salvate`);
+        if (tab && tab !== turn.tab)
+            throw new ApiError(409, 'not_your_turn', 'Questo documento è aperto in un’altra scheda: le modifiche di qui non sono state salvate');
+    };
     app.post('/api/documents/:id/presence', requireUser, async (c) => {
         const input = await body(c, z.object({ selected: z.string().max(200).nullable() }));
         const user = c.get('user');
@@ -2888,6 +2950,7 @@ When done, say in one or two short sentences what you changed. Reply in the pers
     app.get('/api/documents/:id', requireUser, async (c) => c.json(await toJson(await loadDocument(c.req.param('id')))));
     app.put('/api/documents/:id', requireUser, async (c) => {
         const existing = await loadDocument(c.req.param('id'));
+        guardTurn(c, existing.id);
         const input = await body(c, documentBody);
         const def = collection(existing.collection);
         const draft = draftData(def, input.data);
@@ -3811,6 +3874,7 @@ When done, say in one or two short sentences what you changed. Reply in the pers
     });
     app.post('/api/documents/:id/revisions/:revision/restore', requireUser, async (c) => {
         const existing = await loadDocument(c.req.param('id'));
+        guardTurn(c, existing.id);
         const doc = await content.restore(existing.id, c.req.param('revision'), c.get('user').id);
         if (!doc)
             throw new ApiError(404, 'not_found', 'This version does not exist');

package/src/tools.d.ts

@@ -50,7 +50,7 @@ type Schema = {
     collections: CollectionInfo[];
 };
 /** How the page model works, for a model that is about to edit one. */
-export declare const PAGE_GUIDE = "Pages are trees of nodes. The top level holds sections (type \"frame\"); sections hold frames, texts, images, buttons, icons, videos, scenes and form inputs.\nEvery node has an \"id\" (keep existing ids; new nodes may omit it, one is assigned) and a \"type\".\n\nCommon properties:\n- Layout of a frame: layout \"col\" | \"row\" | \"grid\", cols (grid columns), gap (px), align \"start\"|\"center\"|\"end\"|\"stretch\", justify \"start\"|\"center\"|\"end\"|\"between\", wrap.\n- Size: width \"fill\"|\"hug\"|\"fixed\" with fixedW, maxW, h (px or \"60vh\"), minH (percent of screen height, sections), padX/padY (px), size \"xs\"|\"s\"|\"m\"|\"l\" (a section's vertical padding).\n- Look: bg (theme token or CSS color), scheme \"default\"|\"surface\"|\"inverse\"|\"accent\" (a section's color scheme), radius (px | \"btn\" | \"card\"), border, shadow \"none\"|\"sm\"|\"lg\", gradient, bgImage {src, alt}, bgDim 0-1.\n- Text (\"text\"): text (plain) or runs [{t, b?, i?, href?}], style \"display\"|\"h1\"|\"h2\"|\"h3\"|\"body\"|\"small\"|\"eyebrow\"|\"logo\"|\"button\", tag \"h1\"..\"h4\"|\"p\" (HTML element, defaults from style), color, talign \"left\"|\"center\"|\"right\", fontSize, weight, upper, italic.\n- Button (\"button\"): text, href, variant \"primary\"|\"secondary\"|\"ghost\", newTab.\n- Image (\"image\"): src (a URL from the media library, e.g. /media/photo.jpg), alt, ratio (\"16/9\", \"1/1\"\u2026), fit \"cover\"|\"contain\".\n- Icon (\"icon\"): icon \"lucide:arrow-right\" style names.\n- Motion: anim \"fade\"|\"up\"|\"down\"|\"left\"|\"right\"|\"zoom\"|\"blur\"|\"reveal\"|\"pop\", animTrig \"load\"|\"scroll\", hover \"lift\"|\"grow\"|\"dim\"|\"zoomimg\".\n- Tablet and mobile changes go in over: {tablet: {...}, mobile: {...}} (only the properties that differ).\nTheme color tokens: bg, surface, text, muted, accent, onAccent, inverse, onInverse, border, line.\nPrefer adding ready-made sections from the library (add_section) and then changing their texts, images and colors: they are designed and responsive. Write content in the site's language.";
+export declare const PAGE_GUIDE = "Pages are trees of nodes. The top level holds sections (type \"frame\"); sections hold frames, texts, images, buttons, icons, videos, scenes and form inputs.\nEvery node has an \"id\" (keep existing ids; new nodes may omit it, one is assigned) and a \"type\".\n\nCommon properties:\n- Layout of a frame: layout \"col\" | \"row\" | \"grid\", cols (grid columns), gap (px), align \"start\"|\"center\"|\"end\"|\"stretch\", justify \"start\"|\"center\"|\"end\"|\"between\", wrap.\n- Size: width \"fill\"|\"hug\"|\"fixed\" with fixedW, maxW, h (px or \"60vh\"), minH (percent of screen height, sections), padX/padY (px), size \"xs\"|\"s\"|\"m\"|\"l\" (a section's vertical padding).\n- Look: bg (theme token or CSS color), scheme \"default\"|\"surface\"|\"inverse\"|\"accent\"|\"dark\" (a section's color scheme; \"dark\" stays dark with light text in any theme), radius (px | \"btn\" | \"card\"), border, shadow \"none\"|\"sm\"|\"lg\", gradient, bgImage {src, alt}, bgDim 0-1.\n- Text (\"text\"): text (plain) or runs [{t, b?, i?, href?}], style \"display\"|\"h1\"|\"h2\"|\"h3\"|\"body\"|\"small\"|\"eyebrow\"|\"logo\"|\"button\", tag \"h1\"..\"h4\"|\"p\" (HTML element, defaults from style), color, talign \"left\"|\"center\"|\"right\", fontSize, weight, upper, italic.\n- Button (\"button\"): text, href, variant \"primary\"|\"secondary\"|\"ghost\", newTab.\n- Image (\"image\"): src (a URL from the media library, e.g. /media/photo.jpg), alt, ratio (\"16/9\", \"1/1\"\u2026), fit \"cover\"|\"contain\".\n- Icon (\"icon\"): icon \"lucide:arrow-right\" style names.\n- Motion: anim \"fade\"|\"up\"|\"down\"|\"left\"|\"right\"|\"zoom\"|\"blur\"|\"reveal\"|\"pop\", animTrig \"load\"|\"scroll\", hover \"lift\"|\"grow\"|\"dim\"|\"zoomimg\".\n- Tablet and mobile changes go in over: {tablet: {...}, mobile: {...}} (only the properties that differ).\nTheme color tokens: bg, surface, text, muted, accent, onAccent, inverse, onInverse, border, line.\nPrefer adding ready-made sections from the library (add_section) and then changing their texts, images and colors: they are designed and responsive. Write content in the site's language.";
 /** One line per node, indented: what the model reads before editing. */
 export declare function outline(nodes: PageNode[]): string;
 declare const operation: z.ZodDiscriminatedUnion<[z.ZodObject<{

package/src/tools.js

@@ -13,7 +13,7 @@ Every node has an "id" (keep existing ids; new nodes may omit it, one is assigne
 Common properties:
 - Layout of a frame: layout "col" | "row" | "grid", cols (grid columns), gap (px), align "start"|"center"|"end"|"stretch", justify "start"|"center"|"end"|"between", wrap.
 - Size: width "fill"|"hug"|"fixed" with fixedW, maxW, h (px or "60vh"), minH (percent of screen height, sections), padX/padY (px), size "xs"|"s"|"m"|"l" (a section's vertical padding).
-- Look: bg (theme token or CSS color), scheme "default"|"surface"|"inverse"|"accent" (a section's color scheme), radius (px | "btn" | "card"), border, shadow "none"|"sm"|"lg", gradient, bgImage {src, alt}, bgDim 0-1.
+- Look: bg (theme token or CSS color), scheme "default"|"surface"|"inverse"|"accent"|"dark" (a section's color scheme; "dark" stays dark with light text in any theme), radius (px | "btn" | "card"), border, shadow "none"|"sm"|"lg", gradient, bgImage {src, alt}, bgDim 0-1.
 - Text ("text"): text (plain) or runs [{t, b?, i?, href?}], style "display"|"h1"|"h2"|"h3"|"body"|"small"|"eyebrow"|"logo"|"button", tag "h1".."h4"|"p" (HTML element, defaults from style), color, talign "left"|"center"|"right", fontSize, weight, upper, italic.
 - Button ("button"): text, href, variant "primary"|"secondary"|"ghost", newTab.
 - Image ("image"): src (a URL from the media library, e.g. /media/photo.jpg), alt, ratio ("16/9", "1/1"…), fit "cover"|"contain".