@geekity/cms 0.3.0 → 0.5.0

package/dist/admin/settings-page.d.ts

@@ -0,0 +1,119 @@
+/**
+ * What every settings page is made of.
+ *
+ * The settings used to be one form with twelve headings. They are six pages
+ * now — General, Reading, Permalinks, Discussion and Email under Settings, and
+ * Federation under its own section (TASK-109) — and this is what they have in
+ * common: a description of the page, and the one pair of routes that turns it
+ * into a screen you can read and a form you can save. A page module describes
+ * itself and writes its own template; nothing about how a page is wired lives
+ * in the page.
+ *
+ * The save is the part worth reading twice. A page writes only the fields it
+ * carries, and it writes them onto `content/_data/site.json` as re-read inside
+ * the atomic update (decision-9), not onto the copy the form was rendered
+ * from. So two people saving two different pages at the same moment both land:
+ * the second save is applied to what the first one actually wrote, and a
+ * setting neither page shows is not even in the picture.
+ */
+import type { Context, Hono } from 'hono';
+import type { ResolvedConfig } from '../config.ts';
+import type { GeekityEnv } from '../env.ts';
+import type { DeliveryReport } from '../federation/delivery.ts';
+import type { AdminRender } from './documents.ts';
+import type { SettingsField, SettingsForm, SiteSettings } from './settings.ts';
+/** What {@link mountSettingsPage} needs from the admin around it. */
+export interface MountSettingsOptions {
+    /** The admin's renderer, which injects the chrome, the CSRF token and the flash. */
+    render: AdminRender;
+}
+/** A submitted form, before anything has been read out of it. */
+export type SubmittedBody = Record<string, unknown>;
+/** One settings page, wherever the menu files it. */
+export interface SettingsPage {
+    /** The child of its section it is, as `src/admin/menu.ts` names it. */
+    child: string;
+    /** What the menu calls it. */
+    label: string;
+    /**
+     * The section it is under, when it is not Settings.
+     *
+     * Five of the six are Settings' own children. Federation's is a child of
+     * the Federation section instead (TASK-109): what a settings page is has
+     * nothing to do with where the menu files it, so the page says where it is
+     * and the rest of this module carries on as before.
+     */
+    section?: string;
+    /**
+     * What the page is headed and what a save says it saved, when the menu's
+     * label is not that on its own. Only Federation has one: under its own
+     * section it is listed as Settings, and "Settings settings saved" is not a
+     * sentence.
+     */
+    heading?: string;
+    /** Where it is: {@link settingsPagePath}, or its own section's path. */
+    path: string;
+    /** The template it renders, from {@link ADMIN_TEMPLATES}. */
+    template: string;
+    /** The settings it carries. Every setting is on exactly one page. */
+    fields: readonly SettingsField[];
+    /**
+     * The settings as this page shows them, where what is stored is not what is
+     * in effect. Only General has one, for the base URL a deployment overrides.
+     */
+    shown?: (config: ResolvedConfig, settings: SiteSettings) => SiteSettings;
+    /** What the page renders beyond its own fields: a panel, a credential, a list. */
+    panels?: (c: Context<GeekityEnv>, settings: SiteSettings) => Record<string, unknown>;
+    /**
+     * The fields this page does not read straight off the body, because
+     * something other than the form decides them — a field rendered read-only
+     * submits nothing, and a save must not clear it.
+     */
+    reads?: (options: {
+        c: Context<GeekityEnv>;
+        body: SubmittedBody;
+        current: SiteSettings;
+    }) => Partial<SettingsForm>;
+    /**
+     * What a save of this page sets off beyond the file, as the sentence the
+     * flash adds. The side effect stays where the field is: the actor is told
+     * about a profile change on the page the profile is on, and the relays are
+     * reconciled on the page the relay list is on.
+     */
+    saved?: (c: Context<GeekityEnv>, before: SiteSettings, after: SiteSettings) => Promise<string> | string;
+    /**
+     * The page's own endpoints: a credential, a test message. Each is its own
+     * POST so a refused one cannot lose an edit to a field.
+     */
+    endpoints?: (app: Hono<GeekityEnv>, options: MountSettingsOptions) => void;
+}
+/**
+ * Where one settings page lives.
+ *
+ * General is `/admin/settings` itself rather than `/admin/settings/general`:
+ * it is where the Settings heading lands, where every save that has nothing
+ * better to say redirects, and the URL every older bookmark holds.
+ */
+export declare function settingsPagePath(child: string): string;
+/**
+ * Register one settings page: the screen, the save, and whatever endpoints of
+ * its own it has.
+ *
+ * Every read is of `content/_data/site.json` as it is at that moment, and a
+ * save rewrites it: a page is a view of the file rather than of anything this
+ * process remembers (decision-9). A form the page's own validator has anything
+ * to say about is a 400 that writes nothing at all and comes back with the
+ * problems on the fields that have them.
+ */
+export declare function mountSettingsPage(app: Hono<GeekityEnv>, page: SettingsPage, options: MountSettingsOptions): void;
+/** Everything one settings page's template renders. */
+export declare function settingsScreen(c: Context<GeekityEnv>, page: SettingsPage, settings: SiteSettings): Record<string, unknown>;
+/** A form field as a string. A file upload, or a missing field, is the empty one. */
+export declare function bodyField(value: unknown): string;
+/**
+ * The sentence a flash adds about the followers, when there were any: a save
+ * of the profile is also an announcement, and it should say so rather than
+ * leave the admin wondering.
+ */
+export declare function toldFollowers(report: DeliveryReport | undefined): string;
+//# sourceMappingURL=settings-page.d.ts.map

package/dist/admin/settings-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-page.d.ts","sourceRoot":"","sources":["../../src/admin/settings-page.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAWlD,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE/E,qEAAqE;AACrE,MAAM,WAAW,oBAAoB;IACnC,oFAAoF;IACpF,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,iEAAiE;AACjE,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEpD,qDAAqD;AACrD,MAAM,WAAW,YAAY;IAC3B,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IACjC;;;OAGG;IACH,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,YAAY,KAAK,YAAY,CAAC;IACzE,kFAAkF;IAClF,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,YAAY,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrF;;;;OAIG;IACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE;QAChB,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;QACvB,IAAI,EAAE,aAAa,CAAC;QACpB,OAAO,EAAE,YAAY,CAAC;KACvB,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IAC5B;;;;;OAKG;IACH,KAAK,CAAC,EAAE,CACN,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,EACtB,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,YAAY,KAChB,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;IAC9B;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,oBAAoB,KAAK,IAAI,CAAC;CAC5E;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,IAAI,CAAC,UAAU,CAAC,EACrB,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,oBAAoB,GAC5B,IAAI,CA4CN;AAED,uDAAuD;AACvD,wBAAgB,cAAc,CAC5B,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,EACtB,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,YAAY,GACrB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiBzB;AA2BD,qFAAqF;AACrF,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEhD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,GAAG,MAAM,CAMxE"}

package/dist/admin/settings-page.js

@@ -0,0 +1,132 @@
+/**
+ * What every settings page is made of.
+ *
+ * The settings used to be one form with twelve headings. They are six pages
+ * now — General, Reading, Permalinks, Discussion and Email under Settings, and
+ * Federation under its own section (TASK-109) — and this is what they have in
+ * common: a description of the page, and the one pair of routes that turns it
+ * into a screen you can read and a form you can save. A page module describes
+ * itself and writes its own template; nothing about how a page is wired lives
+ * in the page.
+ *
+ * The save is the part worth reading twice. A page writes only the fields it
+ * carries, and it writes them onto `content/_data/site.json` as re-read inside
+ * the atomic update (decision-9), not onto the copy the form was rendered
+ * from. So two people saving two different pages at the same moment both land:
+ * the second save is applied to what the first one actually wrote, and a
+ * setting neither page shows is not even in the picture.
+ */
+import { flash } from './flash.js';
+import { formFromSettings, readSiteSettings, SETTINGS_FIELDS, SETTINGS_PATH, settingsFromForm, settingsProblems, updateSiteSettings, } from './settings.js';
+/**
+ * Where one settings page lives.
+ *
+ * General is `/admin/settings` itself rather than `/admin/settings/general`:
+ * it is where the Settings heading lands, where every save that has nothing
+ * better to say redirects, and the URL every older bookmark holds.
+ */
+export function settingsPagePath(child) {
+    return child === 'general' ? SETTINGS_PATH : `${SETTINGS_PATH}/${child}`;
+}
+/**
+ * Register one settings page: the screen, the save, and whatever endpoints of
+ * its own it has.
+ *
+ * Every read is of `content/_data/site.json` as it is at that moment, and a
+ * save rewrites it: a page is a view of the file rather than of anything this
+ * process remembers (decision-9). A form the page's own validator has anything
+ * to say about is a 400 that writes nothing at all and comes back with the
+ * problems on the fields that have them.
+ */
+export function mountSettingsPage(app, page, options) {
+    const { render } = options;
+    app.get(page.path, (c) => render(c, page.template, settingsScreen(c, page, readSiteSettings(c.var.config.contentDir))));
+    app.post(page.path, async (c) => {
+        const body = await c.req.parseBody();
+        const stored = readSiteSettings(c.var.config.contentDir);
+        const submitted = pageForm(c, page, body, stored);
+        // The themes directory goes in because one check needs the file system:
+        // whether the name a page submitted is a theme that is actually there.
+        const problems = settingsProblems(submitted, page.fields, {
+            themesDir: c.var.config.themesDir,
+        });
+        if (Object.keys(problems).length > 0) {
+            c.status(400);
+            return render(c, page.template, {
+                ...settingsScreen(c, page, stored),
+                form: submitted,
+                problems,
+                hasProblems: true,
+            });
+        }
+        // The change is applied to the settings re-read inside the write, so a
+        // field this page does not carry is whatever the file says now rather than
+        // whatever it said when the form was drawn. The archive renames and the
+        // menus come from there for the same reason: a save of the title must not
+        // undo a term somebody renamed, or a menu somebody edited, while this form
+        // was open.
+        const settings = await updateSiteSettings({
+            contentDir: c.var.config.contentDir,
+            change: (current) => settingsFromForm(pageForm(c, page, body, current), current),
+        });
+        const note = page.saved === undefined ? '' : await page.saved(c, stored, settings);
+        flash(c, 'notice', `${pageHeading(page)} settings saved.${note}`);
+        return c.redirect(page.path, 303);
+    });
+    page.endpoints?.(app, options);
+}
+/** Everything one settings page's template renders. */
+export function settingsScreen(c, page, settings) {
+    const shown = page.shown === undefined ? settings : page.shown(c.var.config, settings);
+    return {
+        section: page.section ?? 'settings',
+        child: page.child,
+        settingsUrl: page.path,
+        settingsLabel: pageHeading(page),
+        fields: SETTINGS_FIELDS,
+        form: formFromSettings(shown),
+        problems: {},
+        // Whether to say "nothing was saved" over the form. A template cannot ask
+        // an object whether it is empty, and every page would otherwise spell out
+        // the list of its own fields to find out.
+        hasProblems: false,
+        ...page.panels?.(c, settings),
+    };
+}
+/** What the page is headed, and what a save of it says it saved. */
+function pageHeading(page) {
+    return page.heading ?? page.label;
+}
+/**
+ * The whole form as this page's save means it: what is stored, with the
+ * page's own fields taken from what was submitted.
+ *
+ * Every other field comes from `current` rather than from the body, which is
+ * what makes a page write only its own settings — and it is read out of a
+ * checkbox correctly for free, since a clear checkbox submits nothing at all
+ * and only this page's checkboxes are read off the body.
+ */
+function pageForm(c, page, body, current) {
+    const form = formFromSettings(current);
+    for (const name of page.fields)
+        form[name] = bodyField(body[SETTINGS_FIELDS[name]]);
+    return { ...form, ...page.reads?.({ c, body, current }) };
+}
+/** A form field as a string. A file upload, or a missing field, is the empty one. */
+export function bodyField(value) {
+    return typeof value === 'string' ? value : '';
+}
+/**
+ * The sentence a flash adds about the followers, when there were any: a save
+ * of the profile is also an announcement, and it should say so rather than
+ * leave the admin wondering.
+ */
+export function toldFollowers(report) {
+    const total = report?.deliveries.length ?? 0;
+    if (total === 0)
+        return '';
+    return total === 1
+        ? ' One follower has been told.'
+        : ` ${String(total)} followers have been told.`;
+}
+//# sourceMappingURL=settings-page.js.map

package/dist/admin/settings-page.js.map

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

package/dist/admin/settings-pages.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Every settings page there is, and which of them Settings lists.
+ *
+ * This module is the list. What a page is made of is `settings-page.ts`, what
+ * each page carries is its own module, and what a setting means is
+ * `settings.ts`; the only thing that has to know all six exists is the mount
+ * and the menu.
+ *
+ * The order is the order the menu shows them, General first: the Settings
+ * heading lands on its first child, and General is `/admin/settings` itself.
+ *
+ * Five of the six are Settings' own children. Federation's is a settings page
+ * in every other respect — the same fields, the same save, the same refusals —
+ * but the menu files it under the Federation section, beside the followers it
+ * is about (TASK-109), so it is in {@link ALL_SETTINGS_PAGES} and not in
+ * {@link SETTINGS_PAGES}. Both lists matter: {@link ALL_SETTINGS_PAGES} is
+ * what the mount registers and what "every setting is on exactly one page" is
+ * checked against, and {@link SETTINGS_PAGES} is what the Settings menu has to
+ * agree with.
+ */
+import type { Hono } from 'hono';
+import type { GeekityEnv } from '../env.ts';
+import type { MountSettingsOptions, SettingsPage } from './settings-page.ts';
+/** The settings pages the Settings menu lists, in the order it lists them. */
+export declare const SETTINGS_PAGES: readonly SettingsPage[];
+/** Every settings page, wherever the menu files it. */
+export declare const ALL_SETTINGS_PAGES: readonly SettingsPage[];
+/** Register every settings page, including the one filed under Federation. */
+export declare function mountSettings(app: Hono<GeekityEnv>, options: MountSettingsOptions): void;
+//# sourceMappingURL=settings-pages.d.ts.map

package/dist/admin/settings-pages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-pages.d.ts","sourceRoot":"","sources":["../../src/admin/settings-pages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEjC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAM5C,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAI7E,8EAA8E;AAC9E,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EAMjD,CAAC;AAEF,uDAAuD;AACvD,eAAO,MAAM,kBAAkB,EAAE,SAAS,YAAY,EAA6C,CAAC;AAEpG,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAExF"}

package/dist/admin/settings-pages.js

@@ -0,0 +1,43 @@
+/**
+ * Every settings page there is, and which of them Settings lists.
+ *
+ * This module is the list. What a page is made of is `settings-page.ts`, what
+ * each page carries is its own module, and what a setting means is
+ * `settings.ts`; the only thing that has to know all six exists is the mount
+ * and the menu.
+ *
+ * The order is the order the menu shows them, General first: the Settings
+ * heading lands on its first child, and General is `/admin/settings` itself.
+ *
+ * Five of the six are Settings' own children. Federation's is a settings page
+ * in every other respect — the same fields, the same save, the same refusals —
+ * but the menu files it under the Federation section, beside the followers it
+ * is about (TASK-109), so it is in {@link ALL_SETTINGS_PAGES} and not in
+ * {@link SETTINGS_PAGES}. Both lists matter: {@link ALL_SETTINGS_PAGES} is
+ * what the mount registers and what "every setting is on exactly one page" is
+ * checked against, and {@link SETTINGS_PAGES} is what the Settings menu has to
+ * agree with.
+ */
+import { DISCUSSION_SETTINGS } from './settings-discussion.js';
+import { EMAIL_SETTINGS } from './settings-email.js';
+import { FEDERATION_SETTINGS } from './settings-federation.js';
+import { GENERAL_SETTINGS } from './settings-general.js';
+import { mountSettingsPage } from './settings-page.js';
+import { PERMALINKS_SETTINGS } from './settings-permalinks.js';
+import { READING_SETTINGS } from './settings-reading.js';
+/** The settings pages the Settings menu lists, in the order it lists them. */
+export const SETTINGS_PAGES = [
+    GENERAL_SETTINGS,
+    READING_SETTINGS,
+    PERMALINKS_SETTINGS,
+    DISCUSSION_SETTINGS,
+    EMAIL_SETTINGS,
+];
+/** Every settings page, wherever the menu files it. */
+export const ALL_SETTINGS_PAGES = [...SETTINGS_PAGES, FEDERATION_SETTINGS];
+/** Register every settings page, including the one filed under Federation. */
+export function mountSettings(app, options) {
+    for (const page of ALL_SETTINGS_PAGES)
+        mountSettingsPage(app, page, options);
+}
+//# sourceMappingURL=settings-pages.js.map

package/dist/admin/settings-pages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-pages.js","sourceRoot":"","sources":["../../src/admin/settings-pages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAKH,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,8EAA8E;AAC9E,MAAM,CAAC,MAAM,cAAc,GAA4B;IACrD,gBAAgB;IAChB,gBAAgB;IAChB,mBAAmB;IACnB,mBAAmB;IACnB,cAAc;CACf,CAAC;AAEF,uDAAuD;AACvD,MAAM,CAAC,MAAM,kBAAkB,GAA4B,CAAC,GAAG,cAAc,EAAE,mBAAmB,CAAC,CAAC;AAEpG,8EAA8E;AAC9E,MAAM,UAAU,aAAa,CAAC,GAAqB,EAAE,OAA6B;IAChF,KAAK,MAAM,IAAI,IAAI,kBAAkB;QAAE,iBAAiB,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AAC/E,CAAC"}

package/dist/admin/settings-permalinks.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Permalinks: the URLs the archives live at, and the ones they used to.
+ *
+ * WordPress's own name for the page that decides URL shape. The two bases are
+ * a pair — they may not be the same, and neither may take a path the site
+ * already answers on — so they are validated together and shown together.
+ *
+ * The recorded archive renames are here as well, read-only: they are a record
+ * of what happened rather than a preference, written by the taxonomy screens
+ * as a term is renamed or merged, and this is the page whose fields decide
+ * which URLs they are about.
+ */
+import type { SettingsPage } from './settings-page.ts';
+/** The Permalinks settings page. */
+export declare const PERMALINKS_SETTINGS: SettingsPage;
+//# sourceMappingURL=settings-permalinks.d.ts.map

package/dist/admin/settings-permalinks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-permalinks.d.ts","sourceRoot":"","sources":["../../src/admin/settings-permalinks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,oCAAoC;AACpC,eAAO,MAAM,mBAAmB,EAAE,YAejC,CAAC"}

package/dist/admin/settings-permalinks.js

@@ -0,0 +1,32 @@
+/**
+ * Permalinks: the URLs the archives live at, and the ones they used to.
+ *
+ * WordPress's own name for the page that decides URL shape. The two bases are
+ * a pair — they may not be the same, and neither may take a path the site
+ * already answers on — so they are validated together and shown together.
+ *
+ * The recorded archive renames are here as well, read-only: they are a record
+ * of what happened rather than a preference, written by the taxonomy screens
+ * as a term is renamed or merged, and this is the page whose fields decide
+ * which URLs they are about.
+ */
+import { TAXONOMY_LABELS } from '../web/taxonomy.js';
+import { settingsPagePath } from './settings-page.js';
+import { ADMIN_TEMPLATES } from './templates.js';
+/** The Permalinks settings page. */
+export const PERMALINKS_SETTINGS = {
+    child: 'permalinks',
+    label: 'Permalinks',
+    path: settingsPagePath('permalinks'),
+    template: ADMIN_TEMPLATES.settingsPermalinks,
+    fields: ['tagBase', 'categoryBase'],
+    panels: (_c, settings) => ({
+        taxonomyRedirects: settings.taxonomyRedirects.map((entry) => ({
+            ...entry,
+            // What the taxonomy is called in a sentence, so the list reads as the
+            // taxonomy screens name it rather than as the file spells it.
+            label: TAXONOMY_LABELS[entry.taxonomy],
+        })),
+    }),
+};
+//# sourceMappingURL=settings-permalinks.js.map

package/dist/admin/settings-permalinks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-permalinks.js","sourceRoot":"","sources":["../../src/admin/settings-permalinks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,oCAAoC;AACpC,MAAM,CAAC,MAAM,mBAAmB,GAAiB;IAC/C,KAAK,EAAE,YAAY;IACnB,KAAK,EAAE,YAAY;IACnB,IAAI,EAAE,gBAAgB,CAAC,YAAY,CAAC;IACpC,QAAQ,EAAE,eAAe,CAAC,kBAAkB;IAC5C,MAAM,EAAE,CAAC,SAAS,EAAE,cAAc,CAAC;IAEnC,MAAM,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;QACzB,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC5D,GAAG,KAAK;YACR,sEAAsE;YACtE,8DAA8D;YAC9D,KAAK,EAAE,eAAe,CAAC,KAAK,CAAC,QAAQ,CAAC;SACvC,CAAC,CAAC;KACJ,CAAC;CACH,CAAC"}

package/dist/admin/settings-reading.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Reading: what a visitor is shown, and who is told when it changes.
+ *
+ * WordPress's Reading page is what the homepage displays and how many posts a
+ * listing holds; this one adds the notify server, which is how a subscriber
+ * hears that a feed moved on without waiting for their next poll. The site
+ * menu was here too until TASK-108 gave the menus a screen of their own: which
+ * menus there are to edit comes from the active theme, which is not something
+ * a page of fields can be.
+ */
+import type { Context } from 'hono';
+import type { GeekityEnv } from '../env.ts';
+import type { SettingsPage } from './settings-page.ts';
+/** One page the homepage or the posts page may be. */
+export interface PageChoice {
+    /** What the setting stores. */
+    slug: string;
+    /** What the option reads. */
+    title: string;
+}
+/** The published pages, by title, as the two picks offer them. */
+export declare function pageChoices(c: Context<GeekityEnv>): PageChoice[];
+/**
+ * The Reading settings page.
+ *
+ * The two picks are a select each rather than a text field, so what a site can
+ * choose is what it actually has. A pick whose page has since been drafted,
+ * trashed or deleted is not on the list any more: the setting keeps the slug —
+ * putting the page back puts the front page back — and the page says which one
+ * has gone, because a select that had quietly reset itself to "Your latest
+ * posts" would be the screen lying about what is stored.
+ */
+export declare const READING_SETTINGS: SettingsPage;
+//# sourceMappingURL=settings-reading.d.ts.map

package/dist/admin/settings-reading.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-reading.d.ts","sourceRoot":"","sources":["../../src/admin/settings-reading.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAGpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,sDAAsD;AACtD,MAAM,WAAW,UAAU;IACzB,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,kEAAkE;AAClE,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,EAAE,CAQhE;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,EAAE,YAkB9B,CAAC"}

package/dist/admin/settings-reading.js

@@ -0,0 +1,49 @@
+/**
+ * Reading: what a visitor is shown, and who is told when it changes.
+ *
+ * WordPress's Reading page is what the homepage displays and how many posts a
+ * listing holds; this one adds the notify server, which is how a subscriber
+ * hears that a feed moved on without waiting for their next poll. The site
+ * menu was here too until TASK-108 gave the menus a screen of their own: which
+ * menus there are to edit comes from the active theme, which is not something
+ * a page of fields can be.
+ */
+import { isPublicDocument } from '../web/documents.js';
+import { settingsPagePath } from './settings-page.js';
+import { ADMIN_TEMPLATES } from './templates.js';
+/** The published pages, by title, as the two picks offer them. */
+export function pageChoices(c) {
+    const now = c.var.store.now();
+    return c.var.store
+        .listAll({ type: 'page', draft: false, trashed: false, scheduled: false })
+        .filter((document) => isPublicDocument(document, now))
+        .map((document) => ({ slug: document.slug, title: document.title }))
+        .sort((a, b) => a.title.localeCompare(b.title));
+}
+/**
+ * The Reading settings page.
+ *
+ * The two picks are a select each rather than a text field, so what a site can
+ * choose is what it actually has. A pick whose page has since been drafted,
+ * trashed or deleted is not on the list any more: the setting keeps the slug —
+ * putting the page back puts the front page back — and the page says which one
+ * has gone, because a select that had quietly reset itself to "Your latest
+ * posts" would be the screen lying about what is stored.
+ */
+export const READING_SETTINGS = {
+    child: 'reading',
+    label: 'Reading',
+    path: settingsPagePath('reading'),
+    template: ADMIN_TEMPLATES.settingsReading,
+    fields: ['homepage', 'postsPage', 'postsPerPage', 'notifyServer'],
+    panels: (c, settings) => {
+        const choices = pageChoices(c);
+        const missing = (slug) => slug !== '' && !choices.some((choice) => choice.slug === slug);
+        return {
+            pageChoices: choices,
+            homepageMissing: missing(settings.homepage),
+            postsPageMissing: missing(settings.postsPage),
+        };
+    },
+};
+//# sourceMappingURL=settings-reading.js.map

package/dist/admin/settings-reading.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-reading.js","sourceRoot":"","sources":["../../src/admin/settings-reading.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAUjD,kEAAkE;AAClE,MAAM,UAAU,WAAW,CAAC,CAAsB;IAChD,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;IAE9B,OAAO,CAAC,CAAC,GAAG,CAAC,KAAK;SACf,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;SACzE,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,gBAAgB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;SACrD,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;SACnE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;AACpD,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAiB;IAC5C,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,gBAAgB,CAAC,SAAS,CAAC;IACjC,QAAQ,EAAE,eAAe,CAAC,eAAe;IACzC,MAAM,EAAE,CAAC,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,CAAC;IAEjE,MAAM,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE;QACtB,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,OAAO,GAAG,CAAC,IAAY,EAAW,EAAE,CACxC,IAAI,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAEjE,OAAO;YACL,WAAW,EAAE,OAAO;YACpB,eAAe,EAAE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAC3C,gBAAgB,EAAE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;SAC9C,CAAC;IACJ,CAAC;CACF,CAAC"}