@studiotitta/studio-editori 0.1.5 → 0.1.7

package/dist/maarittely.d.ts

@@ -118,9 +118,9 @@ export interface TekstilistaKentta<K extends boolean = boolean> extends KentanPe
  * Editorissa se näkyy omana lohkonaan, jotta sivun kentät eivät sekoitu
  * hakukoneteksteihin.
  */
-export interface RyhmaKentta extends KentanPerus {
+export interface RyhmaKentta<R extends Record<string, Kentta> = Record<string, Kentta>> extends KentanPerus {
     tyyppi: "ryhma";
-    kentat: Record<string, Kentta>;
+    kentat: R;
 }
 /**
  * Lista samanlaisia kohteita, esimerkiksi kurssit.
@@ -167,7 +167,7 @@ export declare function kielivalinta(asetukset?: Omit<KielivalintaKentta, "tyypp
 export declare function tekstilista<K extends boolean = false>(asetukset?: Omit<TekstilistaKentta<K>, "tyyppi" | "kaannettava"> & {
     kaannettava?: K;
 }): TekstilistaKentta<K>;
-export declare function ryhma(asetukset: Omit<RyhmaKentta, "tyyppi">): RyhmaKentta;
+export declare function ryhma<R extends Record<string, Kentta>>(asetukset: Omit<RyhmaKentta<R>, "tyyppi">): RyhmaKentta<R>;
 export declare function kohdelista(asetukset: Omit<KohdelistaKentta, "tyyppi">): KohdelistaKentta;
 export interface SivunMaarittely {
     /** Nimi, jonka muokkaaja näkee editorissa. Oletuksena sivun avain. */
@@ -209,7 +209,10 @@ export type KentanArvo<K extends Kentta> = K extends {
     tyyppi: "kohdelista";
 } ? Record<string, unknown>[] : K extends {
     tyyppi: "ryhma";
-} ? Record<string, unknown> : string;
+    kentat: infer R extends Record<string, Kentta>;
+} ? {
+    [A in keyof R]: KentanArvo<R[A]>;
+} : string;
 /** Kentän arvo sellaisena kuin se on tiedostossa. */
 type TallennettuArvo<K extends Kentta, L extends string> = K extends {
     kaannettava: true;

package/dist/selain/Muokkaustila.js

@@ -464,6 +464,13 @@ export function Muokkaustila() {
                 }
                 continue;
             }
+            /* Sivun oma ryhmä: kentät ovat ryhmän sisällä, eivät sivun juuressa. */
+            if (kenttä.tyyppi === "ryhma") {
+                for (const [ryhmanKentta, ryhmanMaaritys] of Object.entries(kenttä.kentat)) {
+                    tutki({ sivu: sivunAvain, kentta: avain, alikentta: ryhmanKentta }, ryhmanMaaritys);
+                }
+                continue;
+            }
             tutki({ sivu: sivunAvain, kentta: avain }, kenttä);
         }
         return loydot;
@@ -677,6 +684,10 @@ function kentanMaaritys(sisalto, polku) {
         return undefined;
     if (polku.alikentta === undefined)
         return kentta;
+    /* Ilman tunnusta alikenttä on sivun oman ryhmän kenttä. */
+    if (polku.tunnus === undefined) {
+        return kentta.tyyppi === "ryhma" ? kentta.kentat[polku.alikentta] : undefined;
+    }
     if (kentta.tyyppi !== "kohdelista")
         return undefined;
     const [ensimmainen, ryhmanKentta] = polku.alikentta.split(".");

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")
@@ -151,6 +181,14 @@ function virheenKohde(tiedot, kohde) {
     const maaritys = kentta ? tiedot.malli.kentat[kentta] : undefined;
     if (!maaritys)
         return { nimi: osat.at(-1) ?? kohde, sivulla: false };
+    if (maaritys.tyyppi === "ryhma") {
+        const ryhmanKentta = osat[2];
+        const sisempi = ryhmanKentta ? maaritys.kentat[ryhmanKentta] : undefined;
+        return {
+            nimi: sisempi?.nimi ?? ryhmanKentta ?? maaritys.nimi ?? kentta,
+            sivulla: tiedot.sivullaNakyvat.has(`${tiedot.sivu}.${kentta}.${ryhmanKentta}`),
+        };
+    }
     if (maaritys.tyyppi !== "kohdelista") {
         return {
             nimi: maaritys.nimi ?? kentta,
@@ -183,13 +221,20 @@ export function Paneeli(tiedot) {
         /* Kielivalinta on turha, jos sivustolla on vain yksi kieli. */
         if (maaritys.tyyppi === "kielivalinta" && tiedot.kielet.length < 2)
             return false;
+        /* Ryhmä, jonka jokainen kenttä muokataan jo sivulla, ei kuulu paneeliin:
+           tyhjä otsikko näyttäisi siltä, että jotain puuttuu. */
+        if (maaritys.tyyppi === "ryhma") {
+            return Object.keys(maaritys.kentat).some((ryhmanKentta) => !tiedot.sivullaNakyvat.has(`${tiedot.sivu}.${avain}.${ryhmanKentta}`));
+        }
         return !tiedot.sivullaNakyvat.has(`${tiedot.sivu}.${avain}`);
     };
     const omat = kentat.filter(([avain, maaritys]) => maaritys.tyyppi !== "kohdelista" && nayta([avain, maaritys]));
     return (_jsxs("aside", { className: "paneeli", "aria-label": "Sis\u00E4ll\u00F6n tiedot", children: [tiedot.virheet && tiedot.virheet.length > 0 ? (_jsxs("section", { className: "virheet", role: "alert", children: [_jsx("h2", { children: "Tallennus pys\u00E4htyi" }), _jsx("ul", { children: tiedot.virheet.slice(0, 6).map((virhe) => {
                             const tiedot_ = virheenKohde(tiedot, virhe.kohde);
                             return (_jsxs("li", { children: [_jsx("strong", { children: tiedot_.nimi }), " ", virhe.viesti, tiedot_.kohteenNimi ? (_jsx("button", { type: "button", className: "linkki", onClick: () => tiedot_.tunnus && tiedot.valitse(tiedot_.tunnus), children: tiedot_.kohteenNimi })) : null, tiedot_.sivulla ? _jsx("span", { className: "merkki", children: " Muokataan sivulla." }) : null] }, `${virhe.kohde}-${virhe.viesti}`));
-                        }) })] })) : null, omat.length > 0 || tiedot.kaannettavia.sivu.length > 0 ? (_jsxs("section", { children: [_jsx("h2", { children: tiedot.malli.nimi }), omat.map(([avain, maaritys]) => (_jsx(Kentta_, { polku: { sivu: tiedot.sivu, kentta: avain }, maaritys: maaritys, tiedot: tiedot }, avain))), tiedot.kielet.length > 1 ? _jsx(Kaannos, { tiedot: tiedot, mihin: "sivu" }) : null] })) : null, lista ? _jsx(Kohteet, { avain: lista[0], maaritys: lista[1], tiedot: tiedot }) : null] }));
+                        }) })] })) : null, omat.length > 0 || tiedot.kaannettavia.sivu.length > 0 ? (_jsxs("section", { children: [_jsx("h2", { children: tiedot.malli.nimi }), omat.map(([avain, maaritys]) => maaritys.tyyppi === "ryhma" ? (_jsxs("div", { className: "ryhma", children: [_jsx("h3", { children: maaritys.nimi ?? avain }), maaritys.ohje ? _jsx("p", { className: "ohje", children: maaritys.ohje }) : null, Object.entries(maaritys.kentat)
+                                .filter(([ryhmanKentta]) => !tiedot.sivullaNakyvat.has(`${tiedot.sivu}.${avain}.${ryhmanKentta}`))
+                                .map(([ryhmanKentta, ryhmanMaaritys]) => (_jsx(Kentta_, { polku: { sivu: tiedot.sivu, kentta: avain, alikentta: ryhmanKentta }, maaritys: ryhmanMaaritys, tiedot: tiedot }, ryhmanKentta)))] }, avain)) : (_jsx(Kentta_, { polku: { sivu: tiedot.sivu, kentta: avain }, maaritys: maaritys, tiedot: tiedot }, avain))), tiedot.kielet.length > 1 ? _jsx(Kaannos, { tiedot: tiedot, mihin: "sivu" }) : null] })) : null, lista ? _jsx(Kohteet, { avain: lista[0], maaritys: lista[1], tiedot: tiedot }) : null] }));
 }
 const KIELELLE = {
     fi: "suomeksi",
@@ -227,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;
@@ -243,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]);
@@ -269,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,
@@ -279,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

@@ -3,7 +3,13 @@ export interface Kentanpolku {
     kentta: string;
     /** Kohteen tunnus, jos kenttä on listan sisällä. */
     tunnus?: string;
-    /** Kentän nimi kohteen sisällä. */
+    /**
+     * Kentän nimi ryhmän sisällä.
+     *
+     * Ilman tunnusta tämä on sivun oman ryhmän kenttä ("hero.otsikko" →
+     * kentta "hero", alikenttä "otsikko"). Tunnuksen kanssa se on kohteen
+     * kenttä, joka voi olla myös kohteen ryhmässä ("meta.title").
+     */
     alikentta?: string;
 }
 export declare function lueKentanpolku(polku: string): Kentanpolku | null;
@@ -17,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

@@ -4,6 +4,7 @@
    Sivulla oleva merkintä kertoo, mitä kohtaa sisällöstä elementti näyttää:
 
      kurssit.otsikko                      sivun oma kenttä
+     etusivu.hero.otsikko                 kenttä sivun ryhmässä
      kurssit.lista[joogaretriitti].nimi   yhden kohteen kenttä listassa
 
    Hakasulkeissa on kohteen tunnus, ei järjestysnumero. Näin muokkaus osuu
@@ -13,23 +14,31 @@
    Tämä tiedosto on tarkoituksella pelkkää logiikkaa ilman selainta, jotta
    sen voi testata suoraan.
    ========================================================================== */
-/* Alikenttä voi olla ryhmän sisällä: "kurssit.lista[tunnus].meta.title". */
-const MUOTO = /^([a-zA-Z][a-zA-Z0-9]*)\.([a-zA-Z][a-zA-Z0-9]*)(?:\[([^\]]+)\]\.([a-zA-Z][a-zA-Z0-9]*(?:\.[a-zA-Z][a-zA-Z0-9]*)?))?$/;
+/* Kolme muotoa: sivun kenttä, sivun ryhmän kenttä ja kohteen kenttä
+   listassa. Kohteen kenttä voi olla vielä kohteen oman ryhmän sisällä:
+   "kurssit.lista[tunnus].meta.title". */
+const MUOTO = /^([a-zA-Z][a-zA-Z0-9]*)\.([a-zA-Z][a-zA-Z0-9]*)(?:\[([^\]]+)\]\.([a-zA-Z][a-zA-Z0-9]*(?:\.[a-zA-Z][a-zA-Z0-9]*)?)|\.([a-zA-Z][a-zA-Z0-9]*))?$/;
 export function lueKentanpolku(polku) {
     const osuma = MUOTO.exec(polku.trim());
     if (!osuma)
         return null;
-    const [, sivu, kentta, tunnus, alikentta] = osuma;
+    const [, sivu, kentta, tunnus, kohteenKentta, ryhmanKentta] = osuma;
     if (!sivu || !kentta)
         return null;
-    if (tunnus !== undefined && !alikentta)
-        return null;
-    return tunnus === undefined ? { sivu, kentta } : { sivu, kentta, tunnus, alikentta };
+    if (tunnus !== undefined) {
+        if (!kohteenKentta)
+            return null;
+        return { sivu, kentta, tunnus, alikentta: kohteenKentta };
+    }
+    return ryhmanKentta === undefined ? { sivu, kentta } : { sivu, kentta, alikentta: ryhmanKentta };
 }
 export function kirjoitaKentanpolku(polku) {
-    return polku.tunnus === undefined
+    if (polku.tunnus !== undefined) {
+        return `${polku.sivu}.${polku.kentta}[${polku.tunnus}].${polku.alikentta}`;
+    }
+    return polku.alikentta === undefined
         ? `${polku.sivu}.${polku.kentta}`
-        : `${polku.sivu}.${polku.kentta}[${polku.tunnus}].${polku.alikentta}`;
+        : `${polku.sivu}.${polku.kentta}.${polku.alikentta}`;
 }
 /* ---- Arvon asettaminen --------------------------------------------------- */
 function onOlio(arvo) {
@@ -49,7 +58,17 @@ export function asetaArvo(sivunData, polku, arvo, kieli, tunnusKentta = "tunnus"
         return { ...pohja, [kieli]: arvo };
     };
     if (polku.tunnus === undefined) {
-        return { ...sivunData, [polku.kentta]: yhdista(sivunData[polku.kentta]) };
+        if (polku.alikentta === undefined) {
+            return { ...sivunData, [polku.kentta]: yhdista(sivunData[polku.kentta]) };
+        }
+        /* Sivun ryhmä: muut ryhmän kentät säilyvät ennallaan. */
+        const ryhma = onOlio(sivunData[polku.kentta])
+            ? sivunData[polku.kentta]
+            : {};
+        return {
+            ...sivunData,
+            [polku.kentta]: { ...ryhma, [polku.alikentta]: yhdista(ryhma[polku.alikentta]) },
+        };
     }
     const lista = Array.isArray(sivunData[polku.kentta]) ? [...sivunData[polku.kentta]] : [];
     const sija = lista.findIndex((kohde) => onOlio(kohde) && kohde[tunnusKentta] === polku.tunnus);
@@ -73,8 +92,12 @@ export function asetaArvo(sivunData, polku, arvo, kieli, tunnusKentta = "tunnus"
 }
 /** Lukee yhden arvon sivun sisällöstä. */
 export function lueArvo(sivunData, polku, tunnusKentta = "tunnus") {
-    if (polku.tunnus === undefined)
-        return sivunData[polku.kentta];
+    if (polku.tunnus === undefined) {
+        const arvo = sivunData[polku.kentta];
+        if (polku.alikentta === undefined)
+            return arvo;
+        return onOlio(arvo) ? arvo[polku.alikentta] : undefined;
+    }
     const lista = sivunData[polku.kentta];
     if (!Array.isArray(lista))
         return undefined;
@@ -87,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.5",
+  "version": "0.1.7",
   "description": "Studio Titan sisältöeditori asiakassivustoille: tekstit ja kuvat muokataan suoraan sivulla",
   "license": "UNLICENSED",
   "type": "module",