@geekity/cms 0.29.0 → 0.31.0

package/dist/site/robots.js

@@ -0,0 +1,130 @@
+import { ADMIN_PREFIX } from './admin-paths.js';
+/**
+ * How a site treats the crawlers that feed AI products, as one choice.
+ *
+ * `allow` writes nothing, so they read the `*` group like any other crawler.
+ * `block-training` shuts out the crawlers that gather training data and leaves
+ * the ones that fetch a page because somebody asked an assistant about it, so
+ * the site can still be cited. `block-all` shuts out both.
+ */
+export const AI_CRAWLER_POLICIES = ['allow', 'block-training', 'block-all'];
+/**
+ * The crawlers that gather training data, by the token each one obeys.
+ *
+ * From specification.website's robots-for-AI-crawlers list, with Meta's
+ * training crawler beside them.
+ */
+export const AI_TRAINING_CRAWLERS = [
+    'GPTBot',
+    'ClaudeBot',
+    'anthropic-ai',
+    'Google-Extended',
+    'Applebot-Extended',
+    'Bytespider',
+    'CCBot',
+    'meta-externalagent',
+];
+/** The crawlers that fetch a page live, for an answer or a search result. */
+export const AI_RETRIEVAL_CRAWLERS = [
+    'OAI-SearchBot',
+    'ChatGPT-User',
+    'PerplexityBot',
+    'Perplexity-User',
+    'Claude-SearchBot',
+    'Claude-User',
+    'meta-webindexer',
+    'meta-externalfetcher',
+];
+/** The signals a `Content-Signal` line may carry, in the order it lists them. */
+export const CONTENT_SIGNALS = ['search', 'ai-input', 'ai-train'];
+/** A robots file as the CMS writes it with nothing set. */
+export const DEFAULT_ROBOTS_POLICY = {
+    aiCrawlers: 'allow',
+    contentSignal: {},
+    rules: [],
+};
+/** The fields a line a site adds may have, as the file spells them. */
+const FIELDS = ['User-agent', 'Allow', 'Disallow', 'Crawl-delay', 'Content-Signal', 'Sitemap'];
+export function parseRobotsLine(text) {
+    const trimmed = text.trim();
+    if (trimmed === '' || trimmed.startsWith('#'))
+        return { kind: 'blank' };
+    const match = /^([A-Za-z-]+)\s*:\s*(.*)$/.exec(trimmed);
+    const field = FIELDS.find((name) => name.toLowerCase() === match?.[1]?.toLowerCase());
+    if (match === null || field === undefined)
+        return { kind: 'bad' };
+    return { kind: 'line', line: { field, value: match[2] ?? '' } };
+}
+/**
+ * Whether a rule would let a crawler into the admin. RFC 9309 lets the longer
+ * match win, so an `Allow` for anything under the admin beats the CMS's own
+ * `Disallow`.
+ */
+function opensAdmin(line) {
+    return line.field === 'Allow' && line.value.startsWith(`${ADMIN_PREFIX}/`);
+}
+/**
+ * Each line a site added, trimmed, with what is wrong with it if anything is.
+ * A line may hold several, as a hand-edited `site.json` entry might.
+ */
+function judgeLines(lines) {
+    let inGroup = false;
+    return lines
+        .flatMap((entry) => entry.split(/\r?\n/))
+        .map((raw) => {
+        const text = raw.trim();
+        const parsed = parseRobotsLine(text);
+        if (parsed.kind === 'blank')
+            return { text };
+        if (parsed.kind === 'bad') {
+            return {
+                text,
+                problem: `"${text}" is not a robots.txt rule. A rule is a field such as User-agent, Allow or Disallow, a colon and a value.`,
+            };
+        }
+        const { line } = parsed;
+        if (line.field === 'User-agent') {
+            if (line.value === '') {
+                return { text, problem: 'A User-agent line names a crawler, or * for every one.' };
+            }
+            inGroup = true;
+        }
+        else if (line.field !== 'Sitemap' && !inGroup) {
+            return {
+                text,
+                problem: `"${text}" needs a User-agent line above it to say which crawler it is for.`,
+            };
+        }
+        else if (opensAdmin(line)) {
+            return {
+                text,
+                problem: `"${text}" would let crawlers into ${ADMIN_PREFIX}/, which the site always keeps them out of.`,
+            };
+        }
+        return { text };
+    });
+}
+/**
+ * What is wrong with the rules a site typed, or `undefined` when nothing is.
+ * The first bad line is what it names: a textarea has one message.
+ */
+export function robotsRuleProblem(lines) {
+    return judgeLines(lines).find((line) => line.problem !== undefined)?.problem;
+}
+/**
+ * Rules as the site added them, minus any line {@link robotsRuleProblem}
+ * would refuse. A hand edit of `site.json` is read through this, so a typo is
+ * a line left out of the file rather than one published or a site down.
+ */
+export function robotsRuleLines(lines) {
+    const kept = judgeLines(lines)
+        .filter((line) => line.problem === undefined)
+        .map((line) => line.text);
+    // Blank lines only at the edges of the list say nothing.
+    while (kept[0] === '')
+        kept.shift();
+    while (kept.at(-1) === '')
+        kept.pop();
+    return kept;
+}
+//# sourceMappingURL=robots.js.map

package/dist/site/robots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"robots.js","sourceRoot":"","sources":["../../src/site/robots.ts"],"names":[],"mappings":"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"}

package/dist/site/setting-rows.d.ts

@@ -0,0 +1,46 @@
+import type { SiteSettings } from './settings.ts';
+export type CarriedField = 'taxonomyRedirects' | 'menus' | 'indexNowKey' | 'clientsWithoutPkce';
+/** The settings the form on the settings screen carries. */
+export type SettingsField = Exclude<keyof SiteSettings, CarriedField>;
+export type CarriedSettings = Partial<Pick<SiteSettings, CarriedField>>;
+/** A submitted settings form, before it is known to be valid. */
+export type SettingsForm = Record<SettingsField, string>;
+export interface SettingsDirs {
+    readonly themesDir: string;
+    readonly contentDir: string;
+}
+export type SettingsContext = {
+    readonly [D in keyof SettingsDirs]?: string | undefined;
+};
+export interface OnDiskCheck {
+    readonly dir: keyof SettingsDirs;
+    readonly problem: (value: string, dir: string) => string | undefined;
+}
+type SiteJson = Readonly<Record<string, unknown>>;
+export interface SettingRow<V> {
+    readonly read: (file: SiteJson) => V | undefined;
+    readonly write: (file: Record<string, unknown>, settings: SiteSettings) => void;
+    readonly submitted: (form: SettingsForm, onFile: CarriedSettings) => V;
+}
+export interface FormSettingRow<V> extends SettingRow<V> {
+    readonly field: string;
+    readonly shown: (value: V) => string;
+    readonly check: (form: SettingsForm) => string | undefined;
+    readonly onDisk?: OnDiskCheck;
+}
+export declare function requiredWholeDays(typed: string): number | undefined;
+export type FrontPage = Pick<SiteSettings, 'homepage' | 'postsPage'>;
+export declare function frontPageOf(form: SettingsForm): FrontPage;
+export declare function frontPageProblems(form: SettingsForm): {
+    readonly [K in keyof FrontPage]?: string | undefined;
+};
+export declare const ROWS: {
+    readonly [K in keyof SiteSettings]: SettingRow<SiteSettings[K]>;
+};
+export declare const FORM_ROWS: {
+    readonly [K in SettingsField]: FormSettingRow<SiteSettings[K]>;
+};
+export declare const SETTING_KEYS: readonly (keyof SiteSettings)[];
+export declare const SETTINGS_FIELD_NAMES: readonly SettingsField[];
+export {};
+//# sourceMappingURL=setting-rows.d.ts.map

package/dist/site/setting-rows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setting-rows.d.ts","sourceRoot":"","sources":["../../src/site/setting-rows.ts"],"names":[],"mappings":"AAoCA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,MAAM,MAAM,YAAY,GAAG,mBAAmB,GAAG,OAAO,GAAG,aAAa,GAAG,oBAAoB,CAAC;AAEhG,4DAA4D;AAC5D,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,YAAY,EAAE,YAAY,CAAC,CAAC;AAEtE,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC;AAExE,iEAAiE;AACjE,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;AAEzD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,MAAM,eAAe,GAAG;IAAE,QAAQ,EAAE,CAAC,IAAI,MAAM,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS;CAAE,CAAC;AAE1F,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,YAAY,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CACtE;AAED,KAAK,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAElD,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,CAAC,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;IAChF,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,eAAe,KAAK,CAAC,CAAC;CACxE;AAED,MAAM,WAAW,cAAc,CAAC,CAAC,CAAE,SAAQ,UAAU,CAAC,CAAC,CAAC;IACtD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,MAAM,GAAG,SAAS,CAAC;IAC3D,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAwHD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKnE;AAyFD,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,UAAU,GAAG,WAAW,CAAC,CAAC;AAErE,wBAAgB,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,SAAS,CAGzD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,GAAG;IACrD,QAAQ,EAAE,CAAC,IAAI,MAAM,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS;CACrD,CAMA;AAmaD,eAAO,MAAM,IAAI,EAAE;IAAE,QAAQ,EAAE,CAAC,IAAI,MAAM,YAAY,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;CACtE,CAAC;AAEf,eAAO,MAAM,SAAS,EAAE;IAAE,QAAQ,EAAE,CAAC,IAAI,aAAa,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;CAC1E,CAAC;AAEf,eAAO,MAAM,YAAY,EAAgC,SAAS,CAAC,MAAM,YAAY,CAAC,EAAE,CAAC;AAMzF,eAAO,MAAM,oBAAoB,EAAE,SAAS,aAAa,EAAmC,CAAC"}

package/dist/site/setting-rows.js

@@ -0,0 +1,480 @@
+import path from 'node:path';
+import { LANGUAGE_TAG_PATTERN } from '../content/language.js';
+import { isLocationSharing, LOCATION_SHARING } from '../content/location.js';
+import { parseIconSetting } from '../images/icons.js';
+import { sourceFile } from '../images/paths.js';
+import { MAIL_PROVIDERS } from '../mail/provider.js';
+import { isFileSync } from '../util/files.js';
+import { DEFAULT_FEED_CADENCE, isUpdatePeriod, UPDATE_PERIODS } from './feed-settings.js';
+import { generateIndexNowKey, isIndexNowKey } from './indexnow-key.js';
+import { classifyLicense, isLicenseUrl, NO_LICENSE } from '../content/license.js';
+import { canonicalLocale } from '../content/locale.js';
+import { menusOf } from './navigation.js';
+import { AI_CRAWLER_POLICIES, robotsRuleLines, robotsRuleProblem } from './robots.js';
+import { taxonomyBaseProblems, taxonomyRedirectsOf } from '../content/taxonomy.js';
+import { PACKAGED_THEME, readTheme, themeNameProblem } from '../theme/themes.js';
+import { clientsWithoutPkceOf, EMAIL_PATTERN, isAiCrawlerPolicy, isContentSignalChoice, isLicenseChoice, isMailProvider, isPollCount, isValidTimezone, isWholeDays, normalizeBaseUrl, normalizeLanguageList, normalizeRelayInbox, normalizeSecurityContact, normalizeSecurityPolicy, relayLines, relayList, securityContactList, } from './setting-values.js';
+import { DEFAULT_SITE_SETTINGS } from './settings.js';
+function always(key, value) {
+    return (file, settings) => {
+        file[key] = value(settings);
+    };
+}
+function unlessEmpty(key) {
+    return (file, settings) => {
+        const value = settings[key];
+        if (value.length === 0)
+            delete file[key];
+        else
+            file[key] = typeof value === 'string' ? value : [...value];
+    };
+}
+function stringIn(file, key) {
+    const value = file[key];
+    return typeof value === 'string' ? value : undefined;
+}
+function nonEmptyStringIn(file, key) {
+    const value = stringIn(file, key);
+    return value === '' ? undefined : value;
+}
+function stringsIn(file, key) {
+    const value = file[key];
+    return Array.isArray(value) ? value.filter((entry) => typeof entry === 'string') : undefined;
+}
+function chosen(file, key, guard) {
+    const value = file[key];
+    return guard(value) ? value : undefined;
+}
+const checkbox = (value) => (value ? '1' : '');
+const ticked = (value) => value !== '';
+const asIs = (value) => value;
+const lines = (value) => value.join('\n');
+const nothingWrong = () => undefined;
+function text(key, field, options) {
+    return {
+        field,
+        read: (file) => options.empty === 'default' ? nonEmptyStringIn(file, key) : stringIn(file, key),
+        write: options.empty === 'absent' ? unlessEmpty(key) : always(key, (settings) => settings[key]),
+        submitted: (form) => form[key].trim(),
+        shown: asIs,
+        check: options.check ?? nothingWrong,
+    };
+}
+/** A checkbox, which submits nothing at all when it is clear. */
+function flag(key, field) {
+    return {
+        field,
+        read: (file) => chosen(file, key, (value) => typeof value === 'boolean'),
+        write: always(key, (settings) => settings[key]),
+        submitted: (form) => ticked(form[key]),
+        shown: checkbox,
+        check: nothingWrong,
+    };
+}
+function choice(key, field, guard, fallback, problem) {
+    return {
+        field,
+        read: (file) => chosen(file, key, guard),
+        write: always(key, (settings) => settings[key]),
+        submitted: (form) => (guard(form[key]) ? form[key] : fallback),
+        shown: (value) => value,
+        check: (form) => (guard(form[key]) ? undefined : problem),
+    };
+}
+export function requiredWholeDays(typed) {
+    const trimmed = typed.trim();
+    if (trimmed === '')
+        return undefined;
+    const days = Number(trimmed);
+    return isWholeDays(days) ? days : undefined;
+}
+function retention(key, field) {
+    return {
+        field,
+        read: (file) => chosen(file, key, isWholeDays),
+        write: always(key, (settings) => settings[key]),
+        submitted: (form) => Number(form[key]),
+        shown: String,
+        check: (form) => requiredWholeDays(form[key]) === undefined
+            ? 'Keep it for a whole number of days, or 0 to keep it forever.'
+            : undefined,
+    };
+}
+function contentSignal(key, field) {
+    return choice(key, field, isContentSignalChoice, '', 'A content signal is yes, no, or not said.');
+}
+function list(key, field, parse, check) {
+    return {
+        field,
+        read: (file) => {
+            const entries = stringsIn(file, key);
+            return entries === undefined ? undefined : parse(entries.join('\n'));
+        },
+        write: always(key, (settings) => [...settings[key]]),
+        submitted: (form) => parse(form[key]),
+        shown: lines,
+        check,
+    };
+}
+function licenseIn(file) {
+    const said = classifyLicense(file['license']);
+    if (said === undefined || said === NO_LICENSE)
+        return undefined;
+    if ('key' in said)
+        return { license: said.key, licenseUrl: '', licenseName: '' };
+    return {
+        license: 'custom',
+        licenseUrl: said.url,
+        licenseName: stringIn(file, 'licenseName')?.trim() ?? '',
+    };
+}
+const isCustomLicense = (form) => form.license.trim() === 'custom';
+const PAGE_SLUG_PATTERN = /^[A-Za-z0-9._~-]{1,200}$/;
+/** What is wrong with one page pick, or `undefined`. Empty is a value. */
+function slugProblem(value, what) {
+    const slug = value.trim();
+    return slug === '' || PAGE_SLUG_PATTERN.test(slug)
+        ? undefined
+        : `${what} is the slug of one of the site's pages, such as about.`;
+}
+function iconProblem(icon) {
+    if (icon === '')
+        return undefined;
+    const parsed = parseIconSetting(icon);
+    if (!('problem' in parsed))
+        return undefined;
+    return parsed.problem === 'not-an-upload'
+        ? 'The site icon has to be a file in the media library, a path such as /uploads/2026/10/icon.png.'
+        : 'The site icon has to be an image: PNG, JPEG, GIF, WebP, AVIF, TIFF or SVG.';
+}
+const ICON_UPLOADED = {
+    dir: 'contentDir',
+    problem: (icon, contentDir) => {
+        const parsed = parseIconSetting(icon);
+        if ('problem' in parsed)
+            return undefined;
+        const file = sourceFile({ contentDir }, parsed.source);
+        return file !== undefined && isFileSync(file)
+            ? undefined
+            : `There is no upload at ${icon}. Upload the picture on the Media screen first.`;
+    },
+};
+export function frontPageOf(form) {
+    const homepage = form.homepage.trim();
+    return { homepage, postsPage: homepage === '' ? '' : form.postsPage.trim() };
+}
+export function frontPageProblems(form) {
+    const homepage = form.homepage.trim();
+    return {
+        homepage: slugProblem(homepage, 'A homepage'),
+        postsPage: postsPageProblem(homepage, form.postsPage.trim()),
+    };
+}
+function postsPageProblem(homepage, postsPage) {
+    if (postsPage === '')
+        return undefined;
+    if (homepage === '') {
+        return 'A posts page needs a homepage: pick the page the front page shows first.';
+    }
+    if (postsPage === homepage) {
+        return 'The homepage and the posts page have to be two different pages.';
+    }
+    return slugProblem(postsPage, 'A posts page');
+}
+function frontPageRows() {
+    const row = (key, field) => ({
+        ...text(key, field, { empty: 'absent' }),
+        submitted: (form) => frontPageOf(form)[key],
+        check: (form) => frontPageProblems(form)[key],
+    });
+    return { homepage: row('homepage', 'homepage'), postsPage: row('postsPage', 'posts_page') };
+}
+function countIn(file, key, accept) {
+    const count = Number(file[key]);
+    return Number.isInteger(count) && accept(count) ? count : undefined;
+}
+function emailCheck(key, problem) {
+    return (form) => form[key].trim() !== '' && !EMAIL_PATTERN.test(form[key].trim()) ? problem : undefined;
+}
+const THEME_INSTALLED = {
+    dir: 'themesDir',
+    problem: (name, themesDir) => {
+        if (name === PACKAGED_THEME)
+            return undefined;
+        const read = readTheme(path.join(themesDir, name));
+        return read.ok ? undefined : `There is no theme called "${name}": ${read.reason}`;
+    },
+};
+const SETTING_ROWS = {
+    title: text('title', 'title', {
+        empty: 'default',
+        check: (form) => (form.title.trim() === '' ? 'The site needs a title.' : undefined),
+    }),
+    tagline: text('tagline', 'tagline', { empty: 'value' }),
+    baseUrl: {
+        field: 'base_url',
+        read: (file) => stringIn(file, 'url'),
+        write: always('url', (settings) => settings.baseUrl),
+        submitted: (form) => normalizeBaseUrl(form.baseUrl) ?? '',
+        shown: asIs,
+        check: (form) => normalizeBaseUrl(form.baseUrl) === undefined
+            ? 'The base URL has to be an absolute http:// or https:// URL.'
+            : undefined,
+    },
+    postsPerPage: {
+        field: 'posts_per_page',
+        read: (file) => countIn(file, 'postsPerPage', (count) => count > 0),
+        write: always('postsPerPage', (settings) => settings.postsPerPage),
+        submitted: (form) => Number(form.postsPerPage),
+        shown: String,
+        check: (form) => {
+            const perPage = Number(form.postsPerPage);
+            return !Number.isInteger(perPage) || perPage < 1
+                ? 'Posts per page has to be a whole number of one or more.'
+                : undefined;
+        },
+    },
+    timezone: text('timezone', 'timezone', {
+        empty: 'default',
+        check: (form) => isValidTimezone(form.timezone)
+            ? undefined
+            : 'That is not an IANA time zone name, such as Europe/London.',
+    }),
+    language: text('language', 'language', {
+        empty: 'default',
+        check: (form) => LANGUAGE_TAG_PATTERN.test(form.language.trim())
+            ? undefined
+            : 'That is not a language tag, such as en, en-GB or pt-BR.',
+    }),
+    // The two archive bases are checked as a pair, because two of the rules —
+    // that they differ, and that neither takes a path the site already answers
+    // on — are about the pair rather than either one. They are on one page for
+    // exactly that reason.
+    tagBase: text('tagBase', 'tag_base', {
+        empty: 'default',
+        check: (form) => taxonomyBaseProblems({ tag: form.tagBase, category: form.categoryBase }).tag,
+    }),
+    categoryBase: text('categoryBase', 'category_base', {
+        empty: 'default',
+        check: (form) => taxonomyBaseProblems({ tag: form.tagBase, category: form.categoryBase }).category,
+    }),
+    comments: flag('comments', 'comments'),
+    // The empty string is refused rather than read as zero, which is what
+    // `Number('')` would make it: a cleared field is a mistake, and "never close
+    // comments" should have to be typed.
+    commentsCloseAfterDays: {
+        field: 'comments_close_after_days',
+        read: (file) => countIn(file, 'commentsCloseAfterDays', (days) => days >= 0),
+        write: always('commentsCloseAfterDays', (settings) => settings.commentsCloseAfterDays),
+        submitted: (form) => Number(form.commentsCloseAfterDays),
+        shown: String,
+        check: (form) => {
+            const typed = form.commentsCloseAfterDays.trim();
+            const days = Number(typed);
+            return typed === '' || !Number.isInteger(days) || days < 0
+                ? 'Comments close after a whole number of days, or 0 for never.'
+                : undefined;
+        },
+    },
+    commentEmailRetentionDays: retention('commentEmailRetentionDays', 'comment_email_retention_days'),
+    addressHashRetentionDays: retention('addressHashRetentionDays', 'address_hash_retention_days'),
+    contactMessageRetentionDays: retention('contactMessageRetentionDays', 'contact_message_retention_days'),
+    webmentionsSend: flag('webmentionsSend', 'webmentions_send'),
+    webmentionsReceive: flag('webmentionsReceive', 'webmentions_receive'),
+    // Empty is a value here — it is how a site turns real-time notification off
+    // — so only a non-empty one has to be a URL. http as well as https, because
+    // a notify server on a private network or a loopback port is a real one.
+    notifyServer: {
+        ...text('notifyServer', 'notify_server', { empty: 'value' }),
+        submitted: (form) => normalizeBaseUrl(form.notifyServer) ?? '',
+        check: (form) => form.notifyServer.trim() !== '' && normalizeBaseUrl(form.notifyServer) === undefined
+            ? 'A notify server is an absolute http:// or https:// URL, or empty for none.'
+            : undefined,
+    },
+    feedUpdatePeriod: choice('feedUpdatePeriod', 'feed_update_period', isUpdatePeriod, DEFAULT_FEED_CADENCE.period, `An update period is one of ${UPDATE_PERIODS.join(', ')}.`),
+    feedUpdateFrequency: {
+        field: 'feed_update_frequency',
+        read: (file) => chosen(file, 'feedUpdateFrequency', isPollCount),
+        write: always('feedUpdateFrequency', (settings) => settings.feedUpdateFrequency),
+        submitted: (form) => Number(form.feedUpdateFrequency),
+        shown: String,
+        check: (form) => form.feedUpdateFrequency.trim() !== '' && isPollCount(Number(form.feedUpdateFrequency))
+            ? undefined
+            : 'Polls per period is a whole number, 1 or more.',
+    },
+    aiCrawlers: choice('aiCrawlers', 'ai_crawlers', isAiCrawlerPolicy, 'allow', `An AI-crawler policy is one of ${AI_CRAWLER_POLICIES.join(', ')}.`),
+    contentSignalSearch: contentSignal('contentSignalSearch', 'content_signal_search'),
+    contentSignalAiInput: contentSignal('contentSignalAiInput', 'content_signal_ai_input'),
+    contentSignalAiTrain: contentSignal('contentSignalAiTrain', 'content_signal_ai_train'),
+    robotsRules: list('robotsRules', 'robots_rules', (typed) => robotsRuleLines([typed]), (form) => robotsRuleProblem([form.robotsRules])),
+    llmsTxt: flag('llmsTxt', 'llms_txt'),
+    indexNow: flag('indexNow', 'index_now'),
+    mailProvider: choice('mailProvider', 'mail_provider', isMailProvider, 'none', `A mail provider is one of ${MAIL_PROVIDERS.join(', ')}.`),
+    mailFromName: text('mailFromName', 'mail_from_name', { empty: 'value' }),
+    mailFromAddress: text('mailFromAddress', 'mail_from_address', {
+        empty: 'value',
+        check: emailCheck('mailFromAddress', 'A From address is an email address, such as blog@example.com, or empty for the default.'),
+    }),
+    mailReplyTo: text('mailReplyTo', 'mail_reply_to', {
+        empty: 'value',
+        check: emailCheck('mailReplyTo', 'A reply-to is an email address, such as hello@example.com, or empty to reply to the From address.'),
+    }),
+    contactEmail: text('contactEmail', 'contact_email', {
+        empty: 'value',
+        check: emailCheck('contactEmail', 'A contact address is an email address, such as hello@example.com, or empty for the first admin with one.'),
+    }),
+    // These three are printed line by line into security.txt, so a hand edit
+    // with a line break in it must not become a field nobody set.
+    securityContacts: list('securityContacts', 'security_contacts', securityContactList, (form) => {
+        const bad = relayLines(form.securityContacts).find((line) => normalizeSecurityContact(line) === undefined);
+        return bad === undefined
+            ? undefined
+            : 'A security contact is an email address, an https:// URL or a tel: number, one per line. ' +
+                `"${bad}" is not one.`;
+    }),
+    // RFC 9116 wants every web URI in the file to be https.
+    securityPolicy: {
+        ...text('securityPolicy', 'security_policy', { empty: 'value' }),
+        read: (file) => {
+            const policy = stringIn(file, 'securityPolicy');
+            return policy === undefined ? undefined : (normalizeSecurityPolicy(policy) ?? '');
+        },
+        submitted: (form) => normalizeSecurityPolicy(form.securityPolicy) ?? '',
+        check: (form) => form.securityPolicy.trim() !== '' &&
+            normalizeSecurityPolicy(form.securityPolicy) === undefined
+            ? 'A security policy is an https:// URL, or empty for none.'
+            : undefined,
+    },
+    securityLanguages: {
+        ...text('securityLanguages', 'security_languages', { empty: 'value' }),
+        read: (file) => {
+            const languages = stringIn(file, 'securityLanguages');
+            return languages === undefined ? undefined : (normalizeLanguageList(languages) ?? '');
+        },
+        submitted: (form) => normalizeLanguageList(form.securityLanguages) ?? '',
+        check: (form) => normalizeLanguageList(form.securityLanguages) === undefined
+            ? 'Preferred languages are language tags separated by commas, such as en, fr, or empty for none.'
+            : undefined,
+    },
+    relays: list('relays', 'relays', relayList, (form) => {
+        const bad = relayLines(form.relays).find((line) => normalizeRelayInbox(line) === undefined);
+        return bad === undefined
+            ? undefined
+            : `A relay is its inbox as an absolute http:// or https:// URL, one per line. ` +
+                `"${bad}" is not one.`;
+    }),
+    locationSharing: choice('locationSharing', 'location_sharing', isLocationSharing, 'none', `Location sharing is one of ${LOCATION_SHARING.join(', ')}.`),
+    menus: {
+        read: (file) => (file['menus'] === undefined ? undefined : menusOf(file['menus'])),
+        write: always('menus', (settings) => Object.fromEntries(Object.entries(settings.menus).map(([name, items]) => [
+            name,
+            items.map((item) => ({ ...item })),
+        ]))),
+        submitted: (_form, onFile) => onFile.menus ?? DEFAULT_SITE_SETTINGS.menus,
+    },
+    taxonomyRedirects: {
+        read: (file) => Array.isArray(file['taxonomyRedirects'])
+            ? taxonomyRedirectsOf(file['taxonomyRedirects'])
+            : undefined,
+        write: always('taxonomyRedirects', (settings) => settings.taxonomyRedirects.map((entry) => ({ ...entry }))),
+        submitted: (_form, onFile) => onFile.taxonomyRedirects ?? DEFAULT_SITE_SETTINGS.taxonomyRedirects,
+    },
+    ...frontPageRows(),
+    theme: {
+        ...text('theme', 'theme', {
+            empty: 'absent',
+            check: (form) => themeNameProblem(form.theme),
+        }),
+        onDisk: THEME_INSTALLED,
+    },
+    locale: text('locale', 'locale', {
+        empty: 'absent',
+        check: (form) => {
+            const locale = form.locale.trim();
+            return locale === '' ||
+                (LANGUAGE_TAG_PATTERN.test(locale) && canonicalLocale(locale) !== undefined)
+                ? undefined
+                : 'That is not a locale, such as en-US, fr-CA or pt-BR, or empty for the language.';
+        },
+    }),
+    author: text('author', 'author', { empty: 'absent' }),
+    icon: {
+        ...text('icon', 'icon', {
+            empty: 'absent',
+            check: (form) => iconProblem(form.icon.trim()),
+        }),
+        onDisk: ICON_UPLOADED,
+        read: (file) => stringIn(file, 'icon')?.trim(),
+    },
+    license: {
+        field: 'license',
+        read: (file) => licenseIn(file)?.license,
+        write: (file, settings) => {
+            if (settings.license === '')
+                delete file['license'];
+            else
+                file['license'] = settings.license === 'custom' ? settings.licenseUrl : settings.license;
+        },
+        submitted: (form) => {
+            const license = form.license.trim();
+            return isLicenseChoice(license) ? license : '';
+        },
+        shown: asIs,
+        check: (form) => isLicenseChoice(form.license.trim()) ? undefined : 'Choose a license from the list.',
+    },
+    licenseUrl: {
+        field: 'license_url',
+        read: (file) => licenseIn(file)?.licenseUrl,
+        write: () => undefined,
+        submitted: (form) => (isCustomLicense(form) ? form.licenseUrl.trim() : ''),
+        shown: asIs,
+        check: (form) => isCustomLicense(form) && !isLicenseUrl(form.licenseUrl.trim())
+            ? 'A custom license needs the URL of its terms, starting http:// or https://.'
+            : undefined,
+    },
+    licenseName: {
+        field: 'license_name',
+        read: (file) => licenseIn(file)?.licenseName,
+        write: (file, settings) => {
+            delete file['licenseName'];
+            if (settings.license === 'custom')
+                file['licenseName'] = settings.licenseName;
+        },
+        submitted: (form) => (isCustomLicense(form) ? form.licenseName.trim() : ''),
+        shown: asIs,
+        check: (form) => isCustomLicense(form) && form.licenseName.trim() === ''
+            ? 'A custom license needs a name for the footer to show.'
+            : undefined,
+    },
+    // Minted the first time IndexNow is turned on and never again, so the key
+    // the search engines verified outlives turning it off and on. A key IndexNow
+    // would refuse is no key: the site then has none to serve or send, which is
+    // IndexNow off rather than a stream of 403s.
+    indexNowKey: {
+        read: (file) => {
+            const key = stringIn(file, 'indexNowKey');
+            return key !== undefined && isIndexNowKey(key) ? key : undefined;
+        },
+        write: unlessEmpty('indexNowKey'),
+        submitted: (form, onFile) => onFile.indexNowKey !== undefined && onFile.indexNowKey !== ''
+            ? onFile.indexNowKey
+            : ticked(form.indexNow)
+                ? generateIndexNowKey()
+                : '',
+    },
+    clientsWithoutPkce: {
+        read: (file) => Array.isArray(file['clientsWithoutPkce'])
+            ? clientsWithoutPkceOf(file['clientsWithoutPkce'])
+            : undefined,
+        write: unlessEmpty('clientsWithoutPkce'),
+        submitted: (_form, onFile) => onFile.clientsWithoutPkce ?? DEFAULT_SITE_SETTINGS.clientsWithoutPkce,
+    },
+};
+export const ROWS = SETTING_ROWS;
+export const FORM_ROWS = SETTING_ROWS;
+export const SETTING_KEYS = Object.keys(SETTING_ROWS);
+function isFormKey(key) {
+    return SETTING_ROWS[key].field !== undefined;
+}
+export const SETTINGS_FIELD_NAMES = SETTING_KEYS.filter(isFormKey);
+//# sourceMappingURL=setting-rows.js.map