@cardinali-studio/adminkit 1.0.0

package/dist/yaml.js

@@ -0,0 +1,90 @@
+/* Emissione di valori YAML su una riga.
+ *
+ * Quello che c'era prima faceva escape del solo `"`. Bastava un titolo con un backslash, un a
+ * capo o un carattere di controllo per produrre un file che Hugo non legge più — cioè una
+ * pagina rotta a causa di quello che qualcuno ha scritto in un campo di testo.
+ *
+ * Qui la regola è: o so rappresentarlo con certezza, o LANCIO. Un emettitore che si ferma
+ * produce un errore visibile e un salvataggio rifiutato; uno che tira a indovinare produce un
+ * file corrotto che si scopre giorni dopo. Fra le due, la prima è sempre preferibile — è la
+ * stessa ragione per cui il middleware di Access fallisce chiuso.
+ */
+export class YamlEmitError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "YamlEmitError";
+    }
+}
+/** Stringa YAML fra doppi apici, sicura su una riga sola. */
+export function yamlStr(value) {
+    const s = String(value ?? "");
+    // I caratteri di controllo si potrebbero rappresentare con \u…, ma in un titolo o in un
+    // percorso non hanno alcun motivo di esistere: quasi sempre sono un copia-incolla andato
+    // storto, e passarli oltre in silenzio è peggio che fermarsi.
+    const bad = s.match(/[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F]/);
+    if (bad) {
+        throw new YamlEmitError(`Carattere di controllo non rappresentabile (U+${bad[0].charCodeAt(0).toString(16).padStart(4, "0")}) nel valore: ${JSON.stringify(s.slice(0, 60))}`);
+    }
+    if (/[\r\n]/.test(s)) {
+        throw new YamlEmitError(`Valore su più righe non ammesso qui: ${JSON.stringify(s.slice(0, 60))}`);
+    }
+    return `"${s.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
+}
+/** Scalare non quotato dove è sicuro (numeri, booleani), quotato altrimenti. */
+export function yamlScalar(value) {
+    if (typeof value === "boolean")
+        return value ? "true" : "false";
+    if (typeof value === "number") {
+        if (!Number.isFinite(value))
+            throw new YamlEmitError(`Numero non rappresentabile: ${value}`);
+        return String(value);
+    }
+    return yamlStr(value);
+}
+/* Valore annidato su più righe, per il singleton della home (sezioni, liste di oggetti).
+ * Volutamente limitato: stringhe, numeri, booleani, array e oggetti piani. Su tutto il resto
+ * lancia. Quaranta righe di cui conosco il comportamento battono una libreria YAML nel bundle
+ * del Worker di cui dovrei caratterizzare ordinamento e commenti. */
+export function toYamlLines(value, indent = 0, maxDepth = 6) {
+    if (maxDepth < 0)
+        throw new YamlEmitError("Struttura troppo annidata");
+    const pad = "  ".repeat(indent);
+    if (Array.isArray(value)) {
+        if (!value.length)
+            return [];
+        return value.flatMap((v) => {
+            if (v !== null && typeof v === "object" && !Array.isArray(v)) {
+                const inner = toYamlLines(v, indent + 1, maxDepth - 1);
+                if (!inner.length)
+                    return [];
+                // primo campo sulla riga del trattino, il resto allineato sotto
+                return [`${pad}- ${inner[0].trimStart()}`, ...inner.slice(1)];
+            }
+            return [`${pad}- ${yamlScalar(v)}`];
+        });
+    }
+    if (value !== null && typeof value === "object") {
+        // Solo oggetti PIANI. Una Date, una Map, una classe: `Object.entries` ne restituirebbe le
+        // proprietà enumerabili (spesso nessuna) e si emetterebbe `chiave: {}` — cioè si
+        // perderebbe il dato in silenzio. Meglio fermarsi.
+        const proto = Object.getPrototypeOf(value);
+        if (proto !== Object.prototype && proto !== null) {
+            throw new YamlEmitError(`Tipo non rappresentabile in YAML: ${value.constructor?.name ?? "oggetto non piano"}`);
+        }
+        return Object.entries(value).flatMap(([k, v]) => {
+            if (v === undefined)
+                return [];
+            if (Array.isArray(v)) {
+                if (!v.length)
+                    return [`${pad}${k}: []`];
+                return [`${pad}${k}:`, ...toYamlLines(v, indent + 1, maxDepth - 1)];
+            }
+            if (v !== null && typeof v === "object") {
+                const inner = toYamlLines(v, indent + 1, maxDepth - 1);
+                return inner.length ? [`${pad}${k}:`, ...inner] : [`${pad}${k}: {}`];
+            }
+            return [`${pad}${k}: ${yamlScalar(v)}`];
+        });
+    }
+    return [`${pad}${yamlScalar(value)}`];
+}

package/package.json

@@ -0,0 +1,97 @@
+{
+  "name": "@cardinali-studio/adminkit",
+  "version": "1.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",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./form": {
+      "types": "./dist/form/index.d.ts",
+      "default": "./dist/form/index.js"
+    },
+    "./preview": {
+      "types": "./dist/preview.d.ts",
+      "default": "./dist/preview.js"
+    },
+    "./theme.css": "./dist/theme.css",
+    "./app": {
+      "types": "./dist/app/index.d.ts",
+      "default": "./dist/app/index.js"
+    },
+    "./functions": {
+      "default": "./dist/functions/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "default": "./dist/testing.js"
+    },
+    "./functions/*": "./dist/functions/*"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.json && cp src/theme.css dist/theme.css && cp src/app/app.css dist/app/app.css && cp -R src/functions dist/functions",
+    "test": "node --test \"test/*.test.js\"",
+    "check": "npm run build && npm test"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@dnd-kit/core": "^6.3.1",
+    "@dnd-kit/modifiers": "^9.0.0",
+    "@dnd-kit/sortable": "^10.0.0",
+    "@dnd-kit/utilities": "^3.2.2",
+    "react": "^19",
+    "react-dom": "^19",
+    "react-hook-form": "^7",
+    "zod": "^4",
+    "@cloudflare/pages-plugin-cloudflare-access": "^1"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    },
+    "react-hook-form": {
+      "optional": true
+    },
+    "@dnd-kit/core": {
+      "optional": true
+    },
+    "@dnd-kit/modifiers": {
+      "optional": true
+    },
+    "@dnd-kit/sortable": {
+      "optional": true
+    },
+    "@dnd-kit/utilities": {
+      "optional": true
+    },
+    "@cloudflare/pages-plugin-cloudflare-access": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@dnd-kit/core": "^6.3.1",
+    "@dnd-kit/modifiers": "^9.0.0",
+    "@dnd-kit/sortable": "^10.0.0",
+    "@dnd-kit/utilities": "^3.2.2",
+    "@types/react": "^19.2.18",
+    "@types/react-dom": "^19.2.4",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
+    "react-hook-form": "^7.85.0",
+    "typescript": "^5.9.3",
+    "zod": "^4.4.3"
+  }
+}