@studiotitta/studio-editori 0.1.6 → 0.1.7

package/dist/selain/Paneeli.js

@@ -11,8 +11,8 @@ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-run
    siis kovakoodata mitään sivustokohtaista: kun sivusto lisää kentän, se
    ilmestyy paneeliin oikeana säätimenä.
    ========================================================================== */
-import { useState } from "react";
-import { asetaArvo, lueArvo, vapaaTunnus } from "./polku.js";
+import { useEffect, useRef, useState } from "react";
+import { asetaArvo, lueArvo, vapaaTunnus, virheenAlikentta, } from "./polku.js";
 function onOlio(arvo) {
     return typeof arvo === "object" && arvo !== null && !Array.isArray(arvo);
 }
@@ -125,6 +125,36 @@ function Vapaana({ polku, maaritys, arvo, tiedot, }) {
 function uusi(tunnus) {
     return /^uusi(-\d+)?$/.test(tunnus);
 }
+/** Tyhjä arvo: puuttuva, pelkkää välilyöntiä tai tyhjä lista. */
+function tyhja(arvo) {
+    if (arvo === undefined || arvo === null)
+        return true;
+    if (typeof arvo === "string")
+        return arvo.trim() === "";
+    if (Array.isArray(arvo))
+        return arvo.length === 0;
+    /* Käännettävä kenttä on olio kielittäin: tyhjä, jos yksikään ei ole täytetty. */
+    if (onOlio(arvo))
+        return Object.values(arvo).every((osa) => tyhja(osa));
+    return false;
+}
+/**
+ * Onko kohde vielä kesken, eli puuttuuko siltä pakollisia tietoja?
+ *
+ * Piilotetun kohteen saa tallentaa keskeneräisenä, joten tämä on aivan
+ * tavallinen tila eikä virhe. Merkintä listassa kertoo sen avaamatta
+ * jokaista kohdetta, ja samasta tiedosta tiedetään, ettei kohteella ole
+ * vielä omaa sivua.
+ */
+function kesken(maaritys, kohde) {
+    return Object.entries(maaritys.kentat).some(([alikentta, kenttä]) => {
+        if (kenttä.tyyppi === "ryhma") {
+            const ryhma = onOlio(kohde[alikentta]) ? kohde[alikentta] : {};
+            return Object.entries(kenttä.kentat).some(([ryhmanKentta, sisempi]) => sisempi.pakollinen === true && tyhja(ryhma[ryhmanKentta]));
+        }
+        return kenttä.pakollinen === true && tyhja(kohde[alikentta]);
+    });
+}
 function kohteenOtsikko(maaritys, kohde, kieli) {
     const arvo = kohde[maaritys.otsikko];
     if (typeof arvo === "string")
@@ -242,6 +272,22 @@ function Kaannos({ tiedot, mihin }) {
                             setTila("valmis");
                         }, children: tila === "kaantaa" ? "Käännetään…" : `Käännä ${kielella}` })) : null] })) : null, viesti ? (_jsx("p", { className: "ohje", role: "status", children: viesti })) : null] }));
 }
+/**
+ * Taitos kerran asetettaville kentille.
+ *
+ * Taitos aukeaa itsestään, kun tallennus pysähtyy sen sisällä olevaan
+ * kenttään: virhelistan rivi ei auta, jos kenttä on piilossa taitoksen alla.
+ * Auki mennyttä taitosta ei suljeta ohjelmallisesti — muokkaaja päättää itse,
+ * milloin se menee kiinni, eikä se saa napsahtaa kiinni kesken työn.
+ */
+function Lisatiedot({ avaa, children }) {
+    const taitos = useRef(null);
+    useEffect(() => {
+        if (avaa && taitos.current)
+            taitos.current.open = true;
+    }, [avaa]);
+    return (_jsxs("details", { className: "lisatiedot", ref: taitos, children: [_jsx("summary", { children: "Lis\u00E4tiedot" }), children] }));
+}
 function Kohteet({ avain, maaritys, tiedot, }) {
     if (maaritys.tyyppi !== "kohdelista")
         return null;
@@ -258,6 +304,10 @@ function Kohteet({ avain, maaritys, tiedot, }) {
         for (const [alikentta, kenttä] of Object.entries(maaritys.kentat)) {
             if (kenttä.tyyppi === "kytkin" && kenttä.piilottaa && kohde[alikentta] === true) {
                 tulos.push("piilossa");
+                /* Vain piilotettu kohde voi olla kesken: näkyvältä puuttuvat tiedot
+                   ovat virhe, eivätkä ne pääse tallennuksesta läpi. */
+                if (kesken(maaritys, kohde))
+                    tulos.push("kesken");
             }
             if (kenttä.tyyppi === "valinta") {
                 const valittu = kenttä.vaihtoehdot.find((vaihtoehto) => vaihtoehto.arvo === kohde[alikentta]);
@@ -284,6 +334,16 @@ function Kohteet({ avain, maaritys, tiedot, }) {
     /* Usein muuttuvat kentät esiin, kerran asetettavat taitoksen alle. */
     const ensisijaiset = alikentat.filter(([, kenttä]) => kenttä.lisatieto !== true);
     const lisatiedot = alikentat.filter(([, kenttä]) => kenttä.lisatieto === true);
+    /* Osuuko jokin virhe valitun kohteen lisätietokenttään? Jos osuu, taitos
+       avataan: virhelistan rivi ei auta, jos kenttä on piilossa sen alla. */
+    const virheLisatiedoissa = (tiedot.virheet ?? []).some((virhe) => {
+        const alikentta = virheenAlikentta(virhe.kohde, {
+            sivu: tiedot.sivu,
+            kentta: avain,
+            tunnus: valitunTunnus ?? "",
+        });
+        return alikentta !== undefined && maaritys.kentat[alikentta]?.lisatieto === true;
+    });
     const kentta = ([alikentta, kenttä]) => kenttä.tyyppi === "ryhma" ? (_jsxs("div", { className: "ryhma", children: [_jsx("h3", { children: kenttä.nimi ?? alikentta }), kenttä.ohje ? _jsx("p", { className: "ohje", children: kenttä.ohje }) : null, Object.entries(kenttä.kentat).map(([ryhmanKentta, ryhmanMaaritys]) => (_jsx(Kentta_, { polku: {
                     sivu: tiedot.sivu,
                     kentta: avain,
@@ -294,7 +354,7 @@ function Kohteet({ avain, maaritys, tiedot, }) {
                             const tunnus = String(kohde[maaritys.tunnus] ?? "");
                             const omatMerkinnat = merkinnat(kohde);
                             return (_jsx("li", { children: _jsxs("button", { type: "button", className: tunnus === valitunTunnus ? "valittu" : undefined, "aria-current": tunnus === valitunTunnus ? "true" : undefined, onClick: () => tiedot.valitse(tunnus), children: [_jsx("span", { children: nimi(kohde) }), omatMerkinnat.length > 0 ? (_jsx("span", { className: "merkki", children: omatMerkinnat.join(" · ") })) : null] }) }, tunnus));
-                        }) }), _jsx("div", { className: "napit", children: _jsxs("button", { type: "button", onClick: () => tiedot.lisaaKohde(avain, maaritys), children: ["+ Lis\u00E4\u00E4 ", yksikko] }) }), valittu ? null : (_jsxs("p", { className: "ohje", children: ["Valitse ", yksikko, ", niin n\u00E4et sen tiedot."] }))] }), valittu && valitunTunnus ? (_jsxs("section", { children: [_jsx("h2", { children: nimi(valittu) }), maaritys.osoite ? (uusi(valitunTunnus) ? (_jsx("p", { className: "ohje", children: "Oma sivu syntyy, kun tallennat." })) : (_jsx("p", { className: "ohje", children: _jsx("a", { className: "linkki", href: maaritys.osoite.replace("{tunnus}", valitunTunnus), children: "Avaa sivu" }) }))) : null, ensisijaiset.map(kentta), tiedot.kielet.length > 1 ? _jsx(Kaannos, { tiedot: tiedot, mihin: "kohde" }) : null, lisatiedot.length > 0 ? (_jsxs("details", { className: "lisatiedot", children: [_jsx("summary", { children: "Lis\u00E4tiedot" }), lisatiedot.map(kentta)] })) : null, _jsx("div", { className: "napit", children: _jsxs("button", { type: "button", className: "vaarallinen", onClick: () => tiedot.poistaKohde(avain, maaritys.tunnus, valitunTunnus), children: ["Poista ", yksikko] }) })] })) : null] }));
+                        }) }), _jsx("div", { className: "napit", children: _jsxs("button", { type: "button", onClick: () => tiedot.lisaaKohde(avain, maaritys), children: ["+ Lis\u00E4\u00E4 ", yksikko] }) }), valittu ? null : (_jsxs("p", { className: "ohje", children: ["Valitse ", yksikko, ", niin n\u00E4et sen tiedot."] }))] }), valittu && valitunTunnus ? (_jsxs("section", { children: [_jsx("h2", { children: nimi(valittu) }), maaritys.osoite ? (uusi(valitunTunnus) ? (_jsx("p", { className: "ohje", children: "Oma sivu syntyy, kun tallennat." })) : kesken(maaritys, valittu) ? (_jsx("p", { className: "ohje", children: "Oma sivu syntyy, kun pakolliset tiedot on t\u00E4ytetty." })) : (_jsx("p", { className: "ohje", children: _jsx("a", { className: "linkki", href: maaritys.osoite.replace("{tunnus}", valitunTunnus), children: "Avaa sivu" }) }))) : null, ensisijaiset.map(kentta), tiedot.kielet.length > 1 ? _jsx(Kaannos, { tiedot: tiedot, mihin: "kohde" }) : null, lisatiedot.length > 0 ? (_jsx(Lisatiedot, { avaa: virheLisatiedoissa, children: lisatiedot.map(kentta) })) : null, _jsx("div", { className: "napit", children: _jsxs("button", { type: "button", className: "vaarallinen", onClick: () => tiedot.poistaKohde(avain, maaritys.tunnus, valitunTunnus), children: ["Poista ", yksikko] }) })] })) : null] }));
 }
 /**
  * Kuvakenttä: nykyinen kuva, vaihto ja vaihtoehtoinen teksti.

package/dist/selain/polku.d.ts

@@ -23,5 +23,21 @@ export declare function kirjoitaKentanpolku(polku: Kentanpolku): string;
 export declare function asetaArvo(sivunData: Record<string, unknown>, polku: Kentanpolku, arvo: unknown, kieli?: string, tunnusKentta?: string): Record<string, unknown>;
 /** Lukee yhden arvon sivun sisällöstä. */
 export declare function lueArvo(sivunData: Record<string, unknown>, polku: Kentanpolku, tunnusKentta?: string): unknown;
+/**
+ * Mihin kohteen kenttään virheen polku osoittaa?
+ *
+ * Palvelin kertoo virheen polkuna ("kurssit.lista.testi.location"), mutta
+ * paneelin pitää tietää kaksi asiaa: koskeeko virhe juuri avattua kohdetta,
+ * ja mitä kenttää. Palauttaa kentän nimen tai undefined, jos virhe tulee
+ * muualta — toisesta kohteesta, toisesta kentästä tai sivun omista kentistä.
+ *
+ * Ryhmän sisällä olevasta kentästä ("...meta.title") palautuu ryhmän nimi,
+ * koska paneelissa ryhmä on yksi lohko.
+ */
+export declare function virheenAlikentta(kohde: string, polku: {
+    sivu: string;
+    kentta: string;
+    tunnus: string;
+}): string | undefined;
 /** Tunnus, joka ei ole vielä käytössä. Uusi kohde saa sen pohjaksi. */
 export declare function vapaaTunnus(kaytossa: readonly string[], ehdotus: string): string;

package/dist/selain/polku.js

@@ -110,6 +110,24 @@ export function lueArvo(sivunData, polku, tunnusKentta = "tunnus") {
         return arvo;
     return onOlio(arvo) ? arvo[ryhmanKentta] : undefined;
 }
+/**
+ * Mihin kohteen kenttään virheen polku osoittaa?
+ *
+ * Palvelin kertoo virheen polkuna ("kurssit.lista.testi.location"), mutta
+ * paneelin pitää tietää kaksi asiaa: koskeeko virhe juuri avattua kohdetta,
+ * ja mitä kenttää. Palauttaa kentän nimen tai undefined, jos virhe tulee
+ * muualta — toisesta kohteesta, toisesta kentästä tai sivun omista kentistä.
+ *
+ * Ryhmän sisällä olevasta kentästä ("...meta.title") palautuu ryhmän nimi,
+ * koska paneelissa ryhmä on yksi lohko.
+ */
+export function virheenAlikentta(kohde, polku) {
+    const osat = kohde.split(".");
+    if (osat[0] !== polku.sivu || osat[1] !== polku.kentta || osat[2] !== polku.tunnus) {
+        return undefined;
+    }
+    return osat[3];
+}
 /** Tunnus, joka ei ole vielä käytössä. Uusi kohde saa sen pohjaksi. */
 export function vapaaTunnus(kaytossa, ehdotus) {
     const siisti = ehdotus

package/dist/tarkistus.d.ts

@@ -5,6 +5,14 @@ export interface Huomio {
     /** Kieli, jos huomio koskee yhtä kieliversiota. */
     kieli?: string;
     viesti: string;
+    /**
+     * "puuttuu" = pakollinen kenttä on tyhjä, ei siis väärässä muodossa.
+     *
+     * Ero on tarpeen, koska piilotetussa kohteessa tyhjä kenttä on varoitus
+     * eikä virhe: keskeneräisen luonnoksen pitää voida tallentaa. Väärä muoto
+     * on virhe silloinkin — sitä ei kirjoiteta tiedostoon missään tilanteessa.
+     */
+    syy?: "puuttuu";
 }
 export interface Tarkistustulos {
     virheet: Huomio[];

package/dist/tarkistus.js

@@ -33,7 +33,7 @@ function tarkistaTeksti(teksti, maaritys, kohde, kieli, tulos) {
         tulos.virheet.push(huomio("Tähän kenttään ei voi lisätä rivinvaihtoa."));
     }
     if (maaritys.pakollinen && teksti.trim() === "") {
-        tulos.virheet.push(huomio("Kenttä ei voi olla tyhjä."));
+        tulos.virheet.push({ ...huomio("Kenttä ei voi olla tyhjä."), syy: "puuttuu" });
     }
     const suositus = "suositusPituus" in maaritys ? maaritys.suositusPituus : undefined;
     if (suositus !== undefined) {
@@ -53,7 +53,7 @@ function tarkistaTekstilista(arvo, maaritys, kohde, kieli, tulos) {
         tulos.virheet.push(huomio(`Listassa voi olla enintään ${maaritys.enintaan} kohtaa.`));
     }
     if (maaritys.pakollinen && arvo.length === 0) {
-        tulos.virheet.push(huomio("Kenttä ei voi olla tyhjä."));
+        tulos.virheet.push({ ...huomio("Kenttä ei voi olla tyhjä."), syy: "puuttuu" });
     }
     arvo.forEach((kohta, sija) => {
         if (typeof kohta !== "string") {
@@ -120,8 +120,9 @@ function tarkistaKentta(kielet, maaritys, arvo, kohde, sisarukset, tulos) {
     /* null on sama kuin tyhjä: sisältötiedostoissa sillä merkitään "ei vielä
        tiedossa" (esimerkiksi maksulinkki, jota ei ole avattu). */
     if (arvo === undefined || arvo === null) {
-        if (maaritys.pakollinen)
-            tulos.virheet.push({ kohde, viesti: "Kenttä ei voi olla tyhjä." });
+        if (maaritys.pakollinen) {
+            tulos.virheet.push({ kohde, viesti: "Kenttä ei voi olla tyhjä.", syy: "puuttuu" });
+        }
         return;
     }
     if (onKaannettava(maaritys)) {
@@ -145,7 +146,7 @@ function tarkistaKentta(kielet, maaritys, arvo, kohde, sisarukset, tulos) {
                   varoituksena, jotta se ei myöskään unohdu.
                 */
                 if (maaritys.pakollinen && kieli === oletuskieli) {
-                    tulos.virheet.push({ kohde, kieli, viesti: "Kenttä ei voi olla tyhjä." });
+                    tulos.virheet.push({ kohde, kieli, viesti: "Kenttä ei voi olla tyhjä.", syy: "puuttuu" });
                 }
                 else if (maaritys.pakollinen || Object.values(arvo).some((muu) => !onTyhja(muu))) {
                     tulos.varoitukset.push({ kohde, kieli, viesti: "Käännös puuttuu." });
@@ -205,7 +206,7 @@ function tarkistaKentta(kielet, maaritys, arvo, kohde, sisarukset, tulos) {
                 tulos.virheet.push({ kohde, viesti: "Sama kieli on valittu kahdesti." });
             }
             if (maaritys.pakollinen && arvo.length === 0) {
-                tulos.virheet.push({ kohde, viesti: "Valitse vähintään yksi kieli." });
+                tulos.virheet.push({ kohde, viesti: "Valitse vähintään yksi kieli.", syy: "puuttuu" });
             }
             return;
         }
@@ -239,12 +240,42 @@ function tarkistaKentta(kielet, maaritys, arvo, kohde, sisarukset, tulos) {
                     }
                     tunnukset.add(tunnus);
                 }
+                /*
+                  Piilotettu kohde on luonnos, ja luonnoksen pitää voida olla kesken:
+                  muokkaaja lisää kurssin nimen ja hinnan nyt, kuvan ja ajankohdan
+                  ensi viikolla. Tyhjä pakollinen kenttä on siksi varoitus, ei virhe.
+                  Kun piilotus otetaan pois, samat kentät vaaditaan taas — portti on
+                  julkaisussa, ei tallennuksessa.
+                */
+                if (onPiilotettu(maaritys, kohta)) {
+                    const omat = { virheet: [], varoitukset: [] };
+                    tarkistaJoukko(kielet, maaritys.kentat, kohta, `${kohde}.${nimi}`, omat);
+                    for (const virhe of omat.virheet) {
+                        if (virhe.syy === "puuttuu") {
+                            tulos.varoitukset.push({ ...virhe, viesti: "Täytä tämä ennen kuin julkaiset." });
+                        }
+                        else {
+                            tulos.virheet.push(virhe);
+                        }
+                    }
+                    tulos.varoitukset.push(...omat.varoitukset);
+                    return;
+                }
                 tarkistaJoukko(kielet, maaritys.kentat, kohta, `${kohde}.${nimi}`, tulos);
             });
             return;
         }
     }
 }
+/**
+ * Onko kohde piilotettu sivustolta?
+ *
+ * Piilotus on kytkin, jonka mallissa on `piilottaa: true`. Sama tieto
+ * näkyy paneelissa merkintänä "piilossa".
+ */
+function onPiilotettu(maaritys, kohta) {
+    return Object.entries(maaritys.kentat).some(([avain, kenttä]) => kenttä.tyyppi === "kytkin" && kenttä.piilottaa === true && kohta[avain] === true);
+}
 function tarkistaJoukko(kielet, kentat, data, polku, tulos) {
     for (const avain of Object.keys(data)) {
         if (!Object.hasOwn(kentat, avain)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@studiotitta/studio-editori",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "Studio Titan sisältöeditori asiakassivustoille: tekstit ja kuvat muokataan suoraan sivulla",
   "license": "UNLICENSED",
   "type": "module",