@cardinali-studio/adminkit 1.0.0 → 2.1.0-rc.0

package/dist/i18n.js

@@ -0,0 +1,119 @@
+/* Bilinguismo opzionale, interamente guidato dallo schema.
+ *
+ * Un campo traducibile non è una seconda forma di contenuto: è lo stesso campo, marcato nello
+ * schema. Il file della lingua secondaria resta completo, ma questo modulo ricopia dal modello
+ * della lingua predefinita ogni valore che non porta il marchio. Così i template Hugo leggono
+ * file ordinari e non devono conoscere alcuna logica di merge.
+ */
+import * as z from "zod";
+/** Registro separato da `ui`: la scelta influenza il Worker e il codec, non solo il form. */
+export const i18n = z.registry();
+/** Marca un campo (anche un array o un oggetto intero) come modificabile in una traduzione. */
+export function translatable(field) {
+    // Zod esprime `register()` con un conditional type che non conserva il nostro generico T;
+    // il registro è comunque quello tipizzato appena sopra e l'operazione non trasforma il campo.
+    field.register(i18n, { translatable: true });
+    return field;
+}
+export function isTranslatable(schema) {
+    return i18n.get(schema)?.translatable === true;
+}
+function defOf(schema) {
+    return schema?._zod?.def ?? schema?._def ?? null;
+}
+function shapeOf(schema) {
+    const def = defOf(schema);
+    if (def?.type === "object" || def?.typeName === "ZodObject") {
+        return (typeof def.shape === "function" ? def.shape() : def.shape) ?? null;
+    }
+    return null;
+}
+function elementOf(schema) {
+    const def = defOf(schema);
+    if (def?.type === "array" || def?.typeName === "ZodArray")
+        return def.element ?? def.type ?? null;
+    return null;
+}
+function clone(value) {
+    if (Array.isArray(value))
+        return value.map(clone);
+    if (value && typeof value === "object") {
+        return Object.fromEntries(Object.entries(value).map(([k, v]) => [k, clone(v)]));
+    }
+    return value;
+}
+/** Unisce una traduzione al modello predefinito senza lasciarle modificare dati ereditati.
+ *
+ * Gli array non traducibili mantengono la loro struttura predefinita; i loro elementi possono
+ * però contenere campi foglia traducibili. Se un'intera lista deve essere traducibile (titolo
+ * spezzato in righe, paragrafi, ecc.), va marcata la lista stessa, non ogni sua stringa. */
+export function mergeTranslation(schema, defaultValue, translationValue) {
+    if (isTranslatable(schema)) {
+        return clone(translationValue === undefined ? defaultValue : translationValue);
+    }
+    const shape = shapeOf(schema);
+    if (shape) {
+        const source = defaultValue && typeof defaultValue === "object" && !Array.isArray(defaultValue)
+            ? defaultValue : {};
+        const translated = translationValue && typeof translationValue === "object" && !Array.isArray(translationValue)
+            ? translationValue : {};
+        return Object.fromEntries(Object.entries(shape).map(([key, child]) => [
+            key,
+            mergeTranslation(child, source[key], translated[key]),
+        ]));
+    }
+    const element = elementOf(schema);
+    if (element) {
+        const source = Array.isArray(defaultValue) ? defaultValue : [];
+        const translated = Array.isArray(translationValue) ? translationValue : [];
+        return source.map((value, index) => mergeTranslation(element, value, translated[index]));
+    }
+    return clone(defaultValue);
+}
+/** Modello completo della traduzione: utile sia al primo salvataggio sia a ogni risalvataggio. */
+export function translationModel(shape, defaultModel, translationModel = {}) {
+    return Object.fromEntries(Object.entries(shape).map(([key, schema]) => [
+        key,
+        mergeTranslation(schema, defaultModel[key], translationModel[key]),
+    ]));
+}
+/** Percorsi dei valori che saranno sempre ricopiati dalla lingua predefinita. */
+export function inheritedFieldPaths(shape) {
+    const visit = (schema, path) => {
+        if (isTranslatable(schema))
+            return [];
+        const nested = shapeOf(schema);
+        if (nested)
+            return Object.entries(nested).flatMap(([key, child]) => visit(child, `${path}.${key}`));
+        const element = elementOf(schema);
+        if (element) {
+            const child = shapeOf(element);
+            return child
+                ? Object.entries(child).flatMap(([key, nestedSchema]) => visit(nestedSchema, `${path}[].${key}`))
+                : [path];
+        }
+        return [path];
+    };
+    return Object.entries(shape).flatMap(([key, schema]) => visit(schema, key));
+}
+const HEADER_START = "# adminkit: translation metadata (generated)";
+const HEADER_END = "# adminkit: end translation metadata";
+/** Inserisce (o aggiorna) l'avviso che impedisce modifiche manuali ingannevoli ai dati ereditati. */
+export function withTranslationHeader(markdown, options) {
+    if (!markdown.startsWith("---\n"))
+        throw new Error("Una traduzione richiede front matter YAML.");
+    const inherited = options.inherited.length ? options.inherited.join(", ") : "nessuno";
+    const header = [
+        HEADER_START,
+        `# Lingua: ${options.language}. I campi non traducibili sono ereditati da ${options.defaultLanguage}.`,
+        `# Campi ereditati: ${inherited}. Modificarli qui non ha effetto: il pannello li risincronizza.`,
+        HEADER_END,
+    ].join("\n") + "\n";
+    let rest = markdown.slice(4);
+    if (rest.startsWith(`${HEADER_START}\n`)) {
+        const end = rest.indexOf(`${HEADER_END}\n`);
+        if (end >= 0)
+            rest = rest.slice(end + HEADER_END.length + 1);
+    }
+    return `---\n${header}${rest}`;
+}

package/dist/index.d.ts

@@ -8,3 +8,4 @@ export * from "./api.js";
 export * from "./prose.js";
 export * from "./gallery.js";
 export * from "./normalize.js";
+export * from "./i18n.js";

package/dist/index.js

@@ -8,3 +8,4 @@ export * from "./api.js";
 export * from "./prose.js";
 export * from "./gallery.js";
 export * from "./normalize.js";
+export * from "./i18n.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cardinali-studio/adminkit",
-  "version": "1.0.0",
+  "version": "2.1.0-rc.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",