@studiotitta/studio-editori 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { aika, kohdelista, kuva, kytkin, luku, kielivalinta, kuvanOsoite, maaritteleSisalto, onSallittuKuvapolku, onSallittuPolku, ryhma, teksti, tekstialue, tekstilista, valinta, type AikaKentta, type Kaannos, type KentanArvo, type KentanPolku, type Kentta, type KielivalintaKentta, type KohdelistaKentta, type KuvaKentta, type KytkinKentta, type LukuKentta, type RyhmaKentta, type TekstilistaKentta, type ValintaKentta, type SisallonMaarittely, type Sivu, type SivunMaarittely, type TallennettuSivu, type TekstiKentta, type TekstialueKentta, } from "./maarittely.ts";
+export { kielista, merkkimaara, tarkistaSivu, type Huomio, type Tarkistustulos, } from "./tarkistus.ts";

package/dist/index.js

@@ -0,0 +1,9 @@
+/*
+  Studio Editori — yhteinen osa.
+
+  Sisältömalli ja sen tarkistus. Ei riippuvuuksia Nextiin, Reactiin tai
+  Nodeen, joten tätä voi käyttää sivuston asetustiedostossa, palvelimella
+  ja selaimessa.
+*/
+export { aika, kohdelista, kuva, kytkin, luku, kielivalinta, kuvanOsoite, maaritteleSisalto, onSallittuKuvapolku, onSallittuPolku, ryhma, teksti, tekstialue, tekstilista, valinta, } from "./maarittely.js";
+export { kielista, merkkimaara, tarkistaSivu, } from "./tarkistus.js";

package/dist/komponentit/Editori.d.ts

@@ -0,0 +1 @@
+export declare function Editori(): Promise<import("react").JSX.Element | null>;

package/dist/komponentit/Editori.js

@@ -0,0 +1,29 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { draftMode } from "next/headers";
+/* ==========================================================================
+   EDITORIN KYTKIN
+   ==========================================================================
+   Sivusto lisää tämän juurilayoutiin kerran:
+
+     <Editori />
+
+   Tavallinen kävijä ei saa siitä riviäkään koodia: komponentti palauttaa
+   tyhjää, ellei Draft Mode ole päällä, ja Draft Mode kytkeytyy vasta
+   editorin kirjautumisessa. Palkki tarkistaa lisäksi istunnon palvelimelta
+   ja piilottaa itsensä, jos sitä ei ole — Draft Mode yksin ei ole oikeus
+   muokata mitään.
+   ========================================================================== */
+export async function Editori() {
+    const { isEnabled: muokkaustila } = await draftMode();
+    if (!muokkaustila)
+        return null;
+    /*
+      Tuonti tehdään vasta tässä, ei tiedoston alussa. Muuten editorin
+      selainkoodi päätyisi samaan nippuun sivuston oman koodin kanssa, ja
+      tavallinen kävijä lataisi sen turhaan — vaikka komponenttia ei koskaan
+      näytetä hänelle. Tarkistettavissa: `npm run build` ja etusivun
+      js-tiedostoista ei löydy editorin tekstejä.
+    */
+    const { PalkkiLataaja } = await import("../selain/PalkkiLataaja.js");
+    return _jsx(PalkkiLataaja, {});
+}

package/dist/komponentit/Muokattava.d.ts

@@ -0,0 +1,10 @@
+import type { ComponentPropsWithoutRef, ElementType, ReactNode } from "react";
+type MuokattavaProps<T extends ElementType> = {
+    /** Kentän polku sisältömallissa: "sivu.kentta". */
+    kentta: string;
+    /** HTML-elementti, oletuksena span. */
+    as?: T;
+    children?: ReactNode;
+} & Omit<ComponentPropsWithoutRef<T>, "as" | "children">;
+export declare function Muokattava<T extends ElementType = "span">({ kentta, as, children, ...muut }: MuokattavaProps<T>): Promise<import("react").JSX.Element>;
+export {};

package/dist/komponentit/Muokattava.js

@@ -0,0 +1,7 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { draftMode } from "next/headers";
+export async function Muokattava({ kentta, as, children, ...muut }) {
+    const Elementti = as ?? "span";
+    const { isEnabled: muokkaustila } = await draftMode();
+    return (_jsx(Elementti, { ...muut, ...(muokkaustila ? { "data-editori-kentta": kentta } : {}), children: children }));
+}

package/dist/komponentit/index.d.ts

@@ -0,0 +1,2 @@
+export { Muokattava } from "./Muokattava.tsx";
+export { Editori } from "./Editori.tsx";

package/dist/komponentit/index.js

@@ -0,0 +1,5 @@
+/*
+  Studio Editori — sivuston komponentit (React Server Components).
+*/
+export { Muokattava } from "./Muokattava.js";
+export { Editori } from "./Editori.js";

package/dist/maarittely.d.ts

@@ -0,0 +1,215 @@
+interface KentanPerus {
+    /** Nimi, jonka muokkaaja näkee editorissa. Oletuksena kentän avain. */
+    nimi?: string;
+    /** Lyhyt ohje muokkaajalle, näkyy kentän alla. */
+    ohje?: string;
+    /** Tyhjää arvoa ei hyväksytä tallennettaessa. */
+    pakollinen?: boolean;
+    /**
+     * true, jos kenttä asetetaan kerran eikä siihen palata viikoittain
+     * (alkamisaika, ryhmäkoko, kuva). Editori siirtää sen "Lisätiedot"-
+     * taitoksen alle, jotta arkinen työ pysyy yhdessä silmäyksessä.
+     */
+    lisatieto?: boolean;
+}
+interface TekstinPerus<K extends boolean> extends KentanPerus {
+    /** Kenttä tallennetaan jokaisella sivuston kielellä: { "fi": "…", "en": "…" }. */
+    kaannettava: K;
+    /**
+     * Suunniteltu enimmäispituus merkkeinä. Ylitys tuottaa varoituksen,
+     * ei estä tallennusta: designin rajat ovat ohjeita, eivät lukkoja.
+     */
+    suositusPituus?: number;
+}
+/** Lyhyt yksirivinen teksti: otsikot, iskulauseet, painikkeet. */
+export interface TekstiKentta<K extends boolean = boolean> extends TekstinPerus<K> {
+    tyyppi: "teksti";
+}
+/** Kappaleet ilman muotoilua. Rivinvaihdot säilyvät. */
+export interface TekstialueKentta<K extends boolean = boolean> extends TekstinPerus<K> {
+    tyyppi: "tekstialue";
+}
+/** Kokonaisluku, esimerkiksi ryhmäkoko tai varatut paikat. */
+export interface LukuKentta extends KentanPerus {
+    tyyppi: "luku";
+    pienin?: number;
+    suurin?: number;
+    /** Mihin toiseen kenttään tätä verrataan: arvo ei saa ylittää sitä. */
+    enintaanKuin?: string;
+}
+/** Valinta muutamasta vaihtoehdosta, esimerkiksi kurssin tila. */
+export interface ValintaKentta extends KentanPerus {
+    tyyppi: "valinta";
+    /**
+     * `merkitse: true` nostaa arvon näkyviin kohdelistaan. Sitä käytetään
+     * tiloille, jotka muokkaajan on syytä nähdä yhdellä silmäyksellä —
+     * esimerkiksi "loppunut", ei "auki".
+     */
+    vaihtoehdot: readonly {
+        arvo: string;
+        nimi: string;
+        selite?: string;
+        merkitse?: boolean;
+    }[];
+}
+/**
+ * Kyllä/ei, esimerkiksi onko kurssi piilotettu.
+ *
+ * Teksti on kiinteä ja kertoo, mitä rastin laittaminen tekee — ei sitä,
+ * mikä tila nyt on. Vaihtuva teksti rastin vieressä on juuri niin
+ * hämmentävä kuin miltä kuulostaa: "Piilotettu" ilman rastia näyttää
+ * siltä, että kurssi olisi piilotettu.
+ */
+export interface KytkinKentta extends KentanPerus {
+    tyyppi: "kytkin";
+    /** Teksti rastin vieressä, esim. "Piilota kurssi sivustolta". */
+    teksti?: string;
+    /** true, jos rastittaminen piilottaa kohteen. Listassa näkyy merkintä. */
+    piilottaa?: boolean;
+}
+/** Päivä ja kellonaika ISO-muodossa. */
+export interface AikaKentta extends KentanPerus {
+    tyyppi: "aika";
+    /** Näytetäänkö kellonaika vai pelkkä päivä. */
+    kellonaika?: boolean;
+}
+/**
+ * Millä kielillä kohde näkyy.
+ *
+ * Monikielisellä sivustolla kaikki ei kuulu kaikille: englanninkielinen
+ * kurssi voi olla tarjolla vain englanninkielisillä sivuilla. Arvo on lista
+ * kielikoodeja; tyhjä lista tarkoittaa, ettei kohde näy millään kielellä.
+ *
+ * Yksikielisellä sivustolla kenttää ei näytetä editorissa lainkaan.
+ */
+export interface KielivalintaKentta extends KentanPerus {
+    tyyppi: "kielivalinta";
+}
+/** Kuva: tiedosto sekä sen vaihtoehtoinen teksti. */
+export interface KuvaKentta extends KentanPerus {
+    tyyppi: "kuva";
+    /** Kuvasuhde, esim. 3 / 2. Kuva rajataan tähän. */
+    suhde?: number;
+    /** Kansio sivuston mediakirjastossa, esim. "kurssit". */
+    kansio?: string;
+    /** Vaaditaanko vaihtoehtoinen teksti. Oletuksena kyllä. */
+    pakollinenAlt?: boolean;
+}
+/** Lista tekstejä, esimerkiksi kappaleet tai "mitä otat mukaan". */
+export interface TekstilistaKentta<K extends boolean = boolean> extends KentanPerus {
+    tyyppi: "tekstilista";
+    kaannettava: K;
+    /** Monirivinen kohta listassa. */
+    monirivinen?: boolean;
+    enintaan?: number;
+}
+/**
+ * Kenttäryhmä, esimerkiksi hakukonetiedot.
+ *
+ * Tallennetussa tiedostossa ryhmä on olio: `meta: { title, description }`.
+ * Editorissa se näkyy omana lohkonaan, jotta sivun kentät eivät sekoitu
+ * hakukoneteksteihin.
+ */
+export interface RyhmaKentta extends KentanPerus {
+    tyyppi: "ryhma";
+    kentat: Record<string, Kentta>;
+}
+/**
+ * Lista samanlaisia kohteita, esimerkiksi kurssit.
+ *
+ * Jokaisella kohteella on omat kenttänsä, ja kohteita voi lisätä, poistaa ja
+ * järjestää. `tunnus` kertoo, mikä kenttä yksilöi kohteen (esimerkiksi kurssin
+ * osoitetunnus), jotta muutokset osataan yhdistää oikeaan kohteeseen.
+ */
+export interface KohdelistaKentta extends KentanPerus {
+    tyyppi: "kohdelista";
+    tunnus: string;
+    /** Mikä kenttä näytetään listassa kohteen nimenä. */
+    otsikko: string;
+    /**
+     * Yksi kohde omalla nimellään, esimerkiksi "kurssi".
+     *
+     * Editori käyttää sanaa painikkeissa ja ohjeissa: "Lisää kurssi",
+     * "Poista kurssi", "Valitse kurssi, niin näet sen tiedot." Ilman tätä
+     * puhuttaisiin kohteista, mikä ei ole kenenkään sana omasta työstään.
+     */
+    yksikko?: string;
+    kentat: Record<string, Kentta>;
+}
+export type Kentta = TekstiKentta | TekstialueKentta | LukuKentta | ValintaKentta | KytkinKentta | AikaKentta | KuvaKentta | KielivalintaKentta | TekstilistaKentta | RyhmaKentta | KohdelistaKentta;
+type TekstinAsetukset<K extends boolean> = Omit<TekstinPerus<K>, "kaannettava"> & {
+    kaannettava?: K;
+};
+export declare function teksti<K extends boolean = false>(asetukset?: TekstinAsetukset<K>): TekstiKentta<K>;
+export declare function tekstialue<K extends boolean = false>(asetukset?: TekstinAsetukset<K>): TekstialueKentta<K>;
+export declare function luku(asetukset?: Omit<LukuKentta, "tyyppi">): LukuKentta;
+export declare function valinta(asetukset: Omit<ValintaKentta, "tyyppi">): ValintaKentta;
+export declare function kytkin(asetukset?: Omit<KytkinKentta, "tyyppi">): KytkinKentta;
+export declare function aika(asetukset?: Omit<AikaKentta, "tyyppi">): AikaKentta;
+export declare function kuva(asetukset?: Omit<KuvaKentta, "tyyppi">): KuvaKentta;
+export declare function kielivalinta(asetukset?: Omit<KielivalintaKentta, "tyyppi">): KielivalintaKentta;
+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 kohdelista(asetukset: Omit<KohdelistaKentta, "tyyppi">): KohdelistaKentta;
+export interface SivunMaarittely {
+    /** Nimi, jonka muokkaaja näkee editorissa. Oletuksena sivun avain. */
+    nimi?: string;
+    /** Sisältötiedosto sivuston repossa, esim. "sisalto/etusivu.json". */
+    tiedosto: string;
+    kentat: Record<string, Kentta>;
+}
+export interface SisallonMaarittely<L extends string = string, S extends Record<string, SivunMaarittely> = Record<string, SivunMaarittely>> {
+    /** Sivuston kielet. Ensimmäinen on oletuskieli. */
+    kielet: readonly [L, ...L[]];
+    sivut: S;
+}
+export declare function onSallittuPolku(polku: string): boolean;
+export declare function onSallittuKuvapolku(polku: string): boolean;
+/** Kuvan julkinen osoite repopolusta: public/kuvat/x.webp → /kuvat/x.webp */
+export declare function kuvanOsoite(polku: string): string;
+/**
+ * Tarkistaa sivuston sisältömallin ja palauttaa sen sellaisenaan. Virhe
+ * kaataa buildin heti, jotta rikkinäinen malli ei koskaan päädy
+ * tuotantoon asti.
+ */
+export declare function maaritteleSisalto<const L extends string, const S extends Record<string, SivunMaarittely>>(maarittely: SisallonMaarittely<L, S>): SisallonMaarittely<L, S>;
+/** Käännettävän kentän tallennettu muoto. Puuttuva kieli = kääntämättä. */
+export type Kaannos<L extends string> = Partial<Record<L, string>>;
+/** Kentän arvo valmiiksi yhdellä kielellä, niin kuin komponentti sen saa. */
+export type KentanArvo<K extends Kentta> = K extends {
+    tyyppi: "luku";
+} ? number | undefined : K extends {
+    tyyppi: "kytkin";
+} ? boolean : K extends {
+    tyyppi: "kuva";
+} ? {
+    src: string;
+    alt: string;
+} | undefined : K extends {
+    tyyppi: "tekstilista" | "kielivalinta";
+} ? string[] : K extends {
+    tyyppi: "kohdelista";
+} ? Record<string, unknown>[] : K extends {
+    tyyppi: "ryhma";
+} ? Record<string, unknown> : string;
+/** Kentän arvo sellaisena kuin se on tiedostossa. */
+type TallennettuArvo<K extends Kentta, L extends string> = K extends {
+    kaannettava: true;
+} ? K extends {
+    tyyppi: "tekstilista";
+} ? Partial<Record<L, string[]>> : Kaannos<L> : KentanArvo<K>;
+/** Sivun sisältö sellaisena kuin se on JSON-tiedostossa. */
+export type TallennettuSivu<S extends SivunMaarittely, L extends string> = {
+    [A in keyof S["kentat"]]?: TallennettuArvo<S["kentat"][A], L>;
+};
+/** Sivun sisältö yhdellä kielellä, valmiina komponentin käyttöön. */
+export type Sivu<S extends SivunMaarittely> = {
+    [A in keyof S["kentat"]]: KentanArvo<S["kentat"][A]>;
+};
+/** Kentän polku editorissa ja sivun merkinnöissä: "sivu.kentta". */
+export type KentanPolku<M extends SisallonMaarittely> = {
+    [S in keyof M["sivut"] & string]: `${S}.${keyof M["sivut"][S]["kentat"] & string}`;
+}[keyof M["sivut"] & string];
+export {};

package/dist/maarittely.js

@@ -0,0 +1,170 @@
+/* ==========================================================================
+   SISÄLTÖMALLI
+   ==========================================================================
+   Sivusto kuvaa kerran, mitä sen sivuilla saa muokata. Kaikki muu johdetaan
+   tästä kuvauksesta: editorin kentät, tallennuksen tarkistus ja tyypit, joilla
+   sivuston komponentit lukevat sisältönsä.
+
+     export default maaritteleSisalto({
+       kielet: ["fi", "en"],
+       sivut: {
+         etusivu: {
+           tiedosto: "sisalto/etusivu.json",
+           kentat: {
+             avauskysymys: teksti({ kaannettava: true, suositusPituus: 90 }),
+           },
+         },
+       },
+     });
+
+   Tiedosto on tarkoituksella riippumaton Nextistä, Reactista ja Nodesta:
+   samaa kuvausta käyttävät palvelin, selaimen editori ja testit.
+   ========================================================================== */
+export function teksti(asetukset = {}) {
+    return { ...asetukset, tyyppi: "teksti", kaannettava: (asetukset.kaannettava ?? false) };
+}
+export function tekstialue(asetukset = {}) {
+    return { ...asetukset, tyyppi: "tekstialue", kaannettava: (asetukset.kaannettava ?? false) };
+}
+export function luku(asetukset = {}) {
+    return { ...asetukset, tyyppi: "luku" };
+}
+export function valinta(asetukset) {
+    return { ...asetukset, tyyppi: "valinta" };
+}
+export function kytkin(asetukset = {}) {
+    return { ...asetukset, tyyppi: "kytkin" };
+}
+export function aika(asetukset = {}) {
+    return { ...asetukset, tyyppi: "aika" };
+}
+export function kuva(asetukset = {}) {
+    return { ...asetukset, tyyppi: "kuva" };
+}
+export function kielivalinta(asetukset = {}) {
+    return { ...asetukset, tyyppi: "kielivalinta" };
+}
+export function tekstilista(asetukset = {}) {
+    return {
+        ...asetukset,
+        tyyppi: "tekstilista",
+        kaannettava: (asetukset.kaannettava ?? false),
+    };
+}
+export function ryhma(asetukset) {
+    return { ...asetukset, tyyppi: "ryhma" };
+}
+export function kohdelista(asetukset) {
+    return { ...asetukset, tyyppi: "kohdelista" };
+}
+/**
+ * Sallitut sisältötiedostot. Editori kirjoittaa sivuston repoon vain näihin
+ * polkuihin, joten sääntö on tarkoituksella tiukka: ei hakemistosta ulos
+ * pääsyä, ei piilotiedostoja, ei muuta kuin JSONia sisalto-kansiossa.
+ */
+const SALLITTU_POLKU = /^sisalto\/(?:[a-z0-9][a-z0-9-]*\/)*[a-z0-9][a-z0-9-]*\.json$/;
+const SALLITTU_KIELI = /^[a-z]{2}$/;
+const SALLITTU_AVAIN = /^[a-zA-Z][a-zA-Z0-9]*$/;
+export function onSallittuPolku(polku) {
+    return SALLITTU_POLKU.test(polku);
+}
+/**
+ * Sallitut kuvatiedostot sivuston repossa.
+ *
+ * Kuvat ovat julkisessa kansiossa, koska sivusto tarjoilee ne sellaisenaan.
+ * Kansion nimen saa valita sivustokohtaisesti (`public/kuvat`,
+ * `public/media`), mutta sääntö on yhtä tiukka kuin sisällöllä: ei
+ * hakemistosta ulos, ei isoja kirjaimia, vain webp.
+ */
+const SALLITTU_KUVAPOLKU = /^public\/[a-z0-9][a-z0-9-]*\/(?:[a-z0-9][a-z0-9-]*\/)*[a-z0-9][a-z0-9-]*\.webp$/;
+export function onSallittuKuvapolku(polku) {
+    return SALLITTU_KUVAPOLKU.test(polku);
+}
+/** Kuvan julkinen osoite repopolusta: public/kuvat/x.webp → /kuvat/x.webp */
+export function kuvanOsoite(polku) {
+    return polku.replace(/^public/, "");
+}
+/**
+ * Tarkistaa sivuston sisältömallin ja palauttaa sen sellaisenaan. Virhe
+ * kaataa buildin heti, jotta rikkinäinen malli ei koskaan päädy
+ * tuotantoon asti.
+ */
+export function maaritteleSisalto(maarittely) {
+    const virheet = [];
+    const { kielet, sivut } = maarittely;
+    if (kielet.length === 0)
+        virheet.push("Kieliä on oltava vähintään yksi.");
+    for (const kieli of kielet) {
+        if (!SALLITTU_KIELI.test(kieli)) {
+            virheet.push(`Kielikoodi "${kieli}" ei kelpaa. Käytä kahta pientä kirjainta, esim. "fi".`);
+        }
+    }
+    if (new Set(kielet).size !== kielet.length)
+        virheet.push("Sama kieli on listassa kahdesti.");
+    const tiedostot = new Map();
+    for (const [avain, sivu] of Object.entries(sivut)) {
+        if (!SALLITTU_AVAIN.test(avain))
+            virheet.push(`Sivun avain "${avain}" ei kelpaa.`);
+        if (!onSallittuPolku(sivu.tiedosto)) {
+            virheet.push(`Sivun "${avain}" tiedosto "${sivu.tiedosto}" ei kelpaa. ` +
+                `Sallittu muoto on sisalto/nimi.json (pienet kirjaimet, numerot ja väliviivat).`);
+        }
+        const aiempi = tiedostot.get(sivu.tiedosto);
+        if (aiempi)
+            virheet.push(`Sivut "${aiempi}" ja "${avain}" käyttävät samaa tiedostoa.`);
+        tiedostot.set(sivu.tiedosto, avain);
+        tarkistaKentat(sivu.kentat, avain, virheet);
+    }
+    if (virheet.length > 0) {
+        throw new Error("Sisältömallissa on virheitä:\n- " + virheet.join("\n- "));
+    }
+    return maarittely;
+}
+/**
+ * Tarkistaa yhden kenttäjoukon. Kutsuu itseään kohdelistan sisällä, jotta
+ * myös listan kohteiden kentät tulevat tarkistetuiksi.
+ */
+function tarkistaKentat(kentat, polku, virheet) {
+    for (const [avain, maaritys] of Object.entries(kentat)) {
+        const kohde = `${polku}.${avain}`;
+        if (!SALLITTU_AVAIN.test(avain))
+            virheet.push(`Kentän avain "${kohde}" ei kelpaa.`);
+        if ("suositusPituus" in maaritys) {
+            const pituus = maaritys.suositusPituus;
+            if (pituus !== undefined && !(Number.isInteger(pituus) && pituus > 0)) {
+                virheet.push(`Kentän "${kohde}" suositusPituus on oltava positiivinen kokonaisluku.`);
+            }
+        }
+        if (maaritys.tyyppi === "valinta") {
+            if (maaritys.vaihtoehdot.length === 0) {
+                virheet.push(`Valintakentällä "${kohde}" ei ole yhtään vaihtoehtoa.`);
+            }
+            const arvot = new Set(maaritys.vaihtoehdot.map((vaihtoehto) => vaihtoehto.arvo));
+            if (arvot.size !== maaritys.vaihtoehdot.length) {
+                virheet.push(`Valintakentässä "${kohde}" on sama arvo kahdesti.`);
+            }
+        }
+        if (maaritys.tyyppi === "luku") {
+            const { pienin, suurin } = maaritys;
+            if (pienin !== undefined && suurin !== undefined && pienin > suurin) {
+                virheet.push(`Kentän "${kohde}" pienin arvo on suurempi kuin suurin.`);
+            }
+        }
+        if (maaritys.tyyppi === "ryhma") {
+            tarkistaKentat(maaritys.kentat, kohde, virheet);
+        }
+        if (maaritys.tyyppi === "kohdelista") {
+            if (!Object.hasOwn(maaritys.kentat, maaritys.tunnus)) {
+                virheet.push(`Kohdelistan "${kohde}" tunnuskenttää "${maaritys.tunnus}" ei ole sen kentissä.`);
+            }
+            if (!Object.hasOwn(maaritys.kentat, maaritys.otsikko)) {
+                virheet.push(`Kohdelistan "${kohde}" otsikkokenttää "${maaritys.otsikko}" ei ole sen kentissä.`);
+            }
+            const tunnus = maaritys.kentat[maaritys.tunnus];
+            if (tunnus && tunnus.tyyppi !== "teksti") {
+                virheet.push(`Kohdelistan "${kohde}" tunnuksen pitää olla tekstikenttä.`);
+            }
+            tarkistaKentat(maaritys.kentat, kohde, virheet);
+        }
+    }
+}

package/dist/palvelin/apurit.d.ts

@@ -0,0 +1,26 @@
+import { type EditorinAsetukset } from "./asetukset.ts";
+/** Sivu, jolla kirjautuminen ja muokkaustila näytetään. */
+export declare const EDITORIN_SIVU = "/editori";
+export declare function onSuojattu(pyynto: Request): boolean;
+export declare function lueEvaste(pyynto: Request, nimi: string): string | undefined;
+/** Ohjaa editorin sivulle ja kertoo tilan osoiterivillä. */
+export declare function ohjaa(pyynto: Request, tila: string, evasteet?: string[]): Response;
+/** JSON-vastaus. Editorin rajapinta puhuu selaimelle JSONia, ei HTML:ää. */
+export declare function json(data: unknown, tila?: number): Response;
+/**
+ * Kirjautunut muokkaaja pyynnöstä, tai `null`.
+ *
+ * Tämä lukee evästeen suoraan pyynnöstä eikä `next/headers`-rajapinnasta,
+ * jotta reittejä voi testata tavallisilla Request-olioilla.
+ */
+export declare function muokkaajaPyynnosta(pyynto: Request, asetukset: EditorinAsetukset): Promise<string | null>;
+/**
+ * Lukee asetukset niin, ettei puuttuva ympäristömuuttuja kaada pyyntöä
+ * virhesivuun.
+ *
+ * Tämä on käyttöönoton yleisin virhe: avain on jäänyt lisäämättä Verceliin,
+ * arvo on kopioitu väärään kenttään tai siihen on tarttunut lainausmerkit.
+ * Muokkaaja saa ymmärrettävän viestin, ja tarkka syy menee palvelimen
+ * lokiin — ei koskaan selaimeen.
+ */
+export declare function asetuksetTaiNull(yliajot: Partial<EditorinAsetukset>): EditorinAsetukset | null;

package/dist/palvelin/apurit.js

@@ -0,0 +1,70 @@
+/* Pyyntöjen pikkuapurit, joita sekä kirjautuminen että tallennus käyttävät. */
+import { lueAsetukset } from "./asetukset.js";
+import { EVASTE_ISTUNTO } from "./istunto.js";
+import { lueTunnus } from "./tunnus.js";
+/** Sivu, jolla kirjautuminen ja muokkaustila näytetään. */
+export const EDITORIN_SIVU = "/editori";
+export function onSuojattu(pyynto) {
+    return new URL(pyynto.url).protocol === "https:";
+}
+export function lueEvaste(pyynto, nimi) {
+    const otsake = pyynto.headers.get("cookie");
+    if (!otsake)
+        return undefined;
+    for (const pala of otsake.split(";")) {
+        const [avain, ...arvo] = pala.trim().split("=");
+        if (avain === nimi)
+            return arvo.join("=");
+    }
+    return undefined;
+}
+/** Ohjaa editorin sivulle ja kertoo tilan osoiterivillä. */
+export function ohjaa(pyynto, tila, evasteet = []) {
+    const kohde = new URL(EDITORIN_SIVU, pyynto.url);
+    kohde.searchParams.set("tila", tila);
+    const otsakkeet = new Headers({ Location: kohde.toString() });
+    for (const arvo of evasteet)
+        otsakkeet.append("Set-Cookie", arvo);
+    /* 303 vaihtaa POSTin GETiksi, joten sivun päivitys ei lähetä lomaketta uudelleen. */
+    return new Response(null, { status: 303, headers: otsakkeet });
+}
+/** JSON-vastaus. Editorin rajapinta puhuu selaimelle JSONia, ei HTML:ää. */
+export function json(data, tila = 200) {
+    return new Response(JSON.stringify(data), {
+        status: tila,
+        headers: { "Content-Type": "application/json; charset=utf-8", "Cache-Control": "no-store" },
+    });
+}
+/**
+ * Kirjautunut muokkaaja pyynnöstä, tai `null`.
+ *
+ * Tämä lukee evästeen suoraan pyynnöstä eikä `next/headers`-rajapinnasta,
+ * jotta reittejä voi testata tavallisilla Request-olioilla.
+ */
+export async function muokkaajaPyynnosta(pyynto, asetukset) {
+    const tunnus = lueEvaste(pyynto, EVASTE_ISTUNTO);
+    if (!tunnus)
+        return null;
+    const sisalto = await lueTunnus(tunnus, asetukset.avain, "istunto");
+    if (!sisalto)
+        return null;
+    return asetukset.sallitut.includes(sisalto.sahkoposti) ? sisalto.sahkoposti : null;
+}
+/**
+ * Lukee asetukset niin, ettei puuttuva ympäristömuuttuja kaada pyyntöä
+ * virhesivuun.
+ *
+ * Tämä on käyttöönoton yleisin virhe: avain on jäänyt lisäämättä Verceliin,
+ * arvo on kopioitu väärään kenttään tai siihen on tarttunut lainausmerkit.
+ * Muokkaaja saa ymmärrettävän viestin, ja tarkka syy menee palvelimen
+ * lokiin — ei koskaan selaimeen.
+ */
+export function asetuksetTaiNull(yliajot) {
+    try {
+        return lueAsetukset(yliajot);
+    }
+    catch (virhe) {
+        console.error("[editori] Asetukset puuttuvat:", virhe instanceof Error ? virhe.message : virhe);
+        return null;
+    }
+}

package/dist/palvelin/asetukset.d.ts

@@ -0,0 +1,26 @@
+export interface EditorinAsetukset {
+    /** Salainen avain istuntojen ja kirjautumislinkkien allekirjoitukseen. */
+    avain: string;
+    /** Sähköpostiosoitteet, jotka saavat muokata sivustoa. */
+    sallitut: string[];
+    /** Lähettäjä, esim. `Studio Titta <editori@studiotitta.fi>`. */
+    lahettaja: string;
+    /** Resendin API-avain. Ilman tätä viestiä ei lähetetä. */
+    postiAvain?: string;
+    /** Kirjautumislinkin voimassaolo minuutteina. */
+    linkinKestoMinuuttia: number;
+    /** Istunnon kesto päivinä. */
+    istunnonKestoPaivaa: number;
+    /**
+     * Sidotaanko kirjautumislinkki siihen selaimeen, josta se pyydettiin.
+     * Oletuksena kyllä: sähköpostistaan kalasteltu linkki ei silloin kelpaa
+     * muualla. Jos muokkaaja avaa postinsa eri laitteella kuin missä pyysi
+     * linkin, hän saa selkeän ohjeen pyytää uusi linkki samassa selaimessa.
+     */
+    selainsidos: boolean;
+}
+/** Sähköpostiosoite vertailumuodossa. Ei validointi, vaan normalisointi. */
+export declare function normalisoiOsoite(osoite: string): string;
+export declare function lueAsetukset(yliajot?: Partial<EditorinAsetukset>): EditorinAsetukset;
+/** Saako tämä osoite muokata sivustoa? */
+export declare function onSallittuMuokkaaja(osoite: string, asetukset: EditorinAsetukset): boolean;

package/dist/palvelin/asetukset.js

@@ -0,0 +1,55 @@
+/* ==========================================================================
+   EDITORIN ASETUKSET
+   ==========================================================================
+   Kaikki salaisuudet luetaan ympäristömuuttujista, ei koskaan koodista.
+   Sivusto voi antaa arvot myös suoraan, jos se haluaa lukea ne muualta.
+
+     EDITORI_AVAIN       satunnainen salainen avain, allekirjoittaa istunnot
+     EDITORI_SALLITUT    sähköpostiosoitteet, jotka saavat muokata, pilkuilla
+     EDITORI_LAHETTAJA   lähettäjä kirjautumisviesteissä
+     RESEND_API_KEY      sähköpostin lähetys (ilman tätä linkki tulostuu lokiin)
+
+   Puuttuva tai liian lyhyt avain on virhe heti pyynnön alussa. Editori ei
+   saa koskaan toimia heikolla avaimella "väliaikaisesti".
+   ========================================================================== */
+const OLETUKSET = {
+    linkinKestoMinuuttia: 15,
+    istunnonKestoPaivaa: 30,
+    selainsidos: true,
+};
+/** Sähköpostiosoite vertailumuodossa. Ei validointi, vaan normalisointi. */
+export function normalisoiOsoite(osoite) {
+    return osoite.trim().toLowerCase();
+}
+export function lueAsetukset(yliajot = {}) {
+    const avain = yliajot.avain ?? process.env.EDITORI_AVAIN ?? "";
+    const sallitut = yliajot.sallitut ??
+        (process.env.EDITORI_SALLITUT ?? "")
+            .split(",")
+            .map(normalisoiOsoite)
+            .filter((osoite) => osoite !== "");
+    const lahettaja = yliajot.lahettaja ?? process.env.EDITORI_LAHETTAJA ?? "";
+    if (avain.length < 32) {
+        throw new Error("Editorin asetus EDITORI_AVAIN puuttuu tai on liian lyhyt (vähintään 32 merkkiä). " +
+            "Luo uusi arvo komennolla: openssl rand -base64 32");
+    }
+    if (sallitut.length === 0) {
+        throw new Error("Editorin asetus EDITORI_SALLITUT puuttuu. Anna sähköpostiosoitteet pilkuilla eroteltuna.");
+    }
+    if (lahettaja === "") {
+        throw new Error('Editorin asetus EDITORI_LAHETTAJA puuttuu, esim. "Studio Titta <editori@studiotitta.fi>".');
+    }
+    return {
+        avain,
+        sallitut,
+        lahettaja,
+        postiAvain: yliajot.postiAvain ?? process.env.RESEND_API_KEY,
+        linkinKestoMinuuttia: yliajot.linkinKestoMinuuttia ?? OLETUKSET.linkinKestoMinuuttia,
+        istunnonKestoPaivaa: yliajot.istunnonKestoPaivaa ?? OLETUKSET.istunnonKestoPaivaa,
+        selainsidos: yliajot.selainsidos ?? OLETUKSET.selainsidos,
+    };
+}
+/** Saako tämä osoite muokata sivustoa? */
+export function onSallittuMuokkaaja(osoite, asetukset) {
+    return asetukset.sallitut.includes(normalisoiOsoite(osoite));
+}

package/dist/palvelin/github/avain.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Lukee avaimen ympäristömuuttujan arvosta.
+ *
+ * Hyväksyy kolme muotoa, koska kaikkia näkee käytännössä:
+ *   - PEM sellaisenaan (rivinvaihdot tallessa)
+ *   - PEM, jossa rivinvaihdot on kirjoitettu merkkeinä \n
+ *   - koko PEM base64-koodattuna yhdelle riville
+ */
+export declare function lueYksityinenAvain(arvo: string): Promise<CryptoKey>;
+/**
+ * GitHub Appin JWT. Voimassa GitHubin sallimat 10 minuuttia, mutta
+ * käytämme yhdeksää: GitHub hylkää tunnuksen, jos palvelimen kello on
+ * hieman edellä.
+ */
+export declare function luoAppJwt(appId: string, avain: CryptoKey): Promise<string>;