@jant/core 0.6.14 → 0.6.15

package/src/ui/dash/appearance/__tests__/NavigationContent.test.tsx

@@ -24,6 +24,7 @@ function renderNavigationContent(
       directoryData: { collections: [], items: [], directoryItems: [] },
       suggestedLinks: [],
       mainRssFeed: "latest",
+      rssFeedsEnabled: true,
       siteName: "Test Site",
       ...props,
     }),
@@ -53,6 +54,28 @@ describe("NavigationContent", () => {
     expect(html).toContain("Built-in links");
   });
 
+  it("hides the saved RSS item only from the preview when feeds are off", () => {
+    const html = renderNavigationContent({
+      rssFeedsEnabled: false,
+      navItems: [
+        {
+          id: "nav_rss",
+          type: "system",
+          systemKey: "rss",
+          label: "Saved feed",
+          url: "/feed",
+          placement: "header",
+          position: "a0",
+          createdAt: 1,
+          updatedAt: 1,
+        },
+      ],
+    });
+
+    expect(html).not.toContain(">Saved feed<");
+    expect(html).toContain("&quot;systemKey&quot;:&quot;rss&quot;");
+  });
+
   it("serializes suggested links with translated target labels", () => {
     const html = renderNavigationContent({
       suggestedLinks: [

package/src/ui/dash/settings/ConfigEditorContent.tsx

@@ -0,0 +1,578 @@
+/**
+ * Config Editor — searchable runtime preferences with a server-rendered
+ * fallback and a Light DOM Lit enhancement.
+ */
+
+import { msg } from "@lingui/core/macro";
+import { useLingui } from "../../../i18n/context.js";
+import { getOrBuildEntry } from "../../../i18n/supported-locales.js";
+import { getTimeZoneOptions } from "../../../lib/timezones.js";
+import { toPublicPath } from "../../../lib/url.js";
+import type {
+  ConfigEditorFieldState,
+  ConfigEditorVisibleKey,
+} from "../../../types.js";
+
+interface FieldPresentation {
+  description: string;
+  optionLabels?: Record<string, string>;
+}
+
+export function ConfigEditorContent({
+  fields,
+  endpoint,
+  sitePathPrefix,
+}: {
+  fields: ConfigEditorFieldState[];
+  endpoint: string;
+  sitePathPrefix: string;
+}) {
+  const { i18n } = useLingui();
+
+  const presentations: Record<ConfigEditorVisibleKey, FieldPresentation> = {
+    SITE_NAME: {
+      description: i18n._(
+        msg({
+          message: "The title used across your site, browser tabs, and feeds.",
+          comment: "@context: Config Editor setting description",
+        }),
+      ),
+    },
+    SITE_DESCRIPTION: {
+      description: i18n._(
+        msg({
+          message:
+            "Edit the multi-line introduction used on your home page and in metadata.",
+          comment: "@context: Config Editor linked setting description",
+        }),
+      ),
+    },
+    SITE_LANGUAGE: {
+      description: i18n._(
+        msg({
+          message:
+            "Choose the content language announced to readers and search engines.",
+          comment: "@context: Config Editor setting description",
+        }),
+      ),
+    },
+    DASHBOARD_LANGUAGE: {
+      description: i18n._(
+        msg({
+          message: "The language used by the private Jant dashboard.",
+          comment: "@context: Config Editor setting description",
+        }),
+      ),
+      optionLabels: {
+        "": i18n._(
+          msg({
+            message: "Follow content language",
+            comment:
+              "@context: Config Editor enum option for no explicit dashboard language",
+          }),
+        ),
+        en: "English",
+        "zh-Hans": "简体中文",
+        "zh-Hant": "繁體中文",
+      },
+    },
+    CJK_SERIF_FONT: {
+      description: i18n._(
+        msg({
+          message:
+            "The serif fallback used when the content language has no built-in profile.",
+          comment: "@context: Config Editor setting description",
+        }),
+      ),
+      optionLabels: {
+        off: i18n._(
+          msg({
+            message: "Follow content language",
+            comment:
+              "@context: Config Editor enum option for automatic CJK font fallback",
+          }),
+        ),
+        "zh-Hans": "简体中文",
+        "zh-Hant": "繁體中文",
+        ja: "日本語",
+        ko: "한국어",
+      },
+    },
+    MAIN_RSS_FEED: {
+      description: i18n._(
+        msg({
+          message: "Which post stream the canonical /feed URL returns.",
+          comment: "@context: Config Editor setting description",
+        }),
+      ),
+      optionLabels: {
+        featured: i18n._(
+          msg({
+            message: "Featured posts",
+            comment: "@context: Config Editor RSS feed enum option",
+          }),
+        ),
+        latest: i18n._(
+          msg({
+            message: "Latest posts",
+            comment: "@context: Config Editor RSS feed enum option",
+          }),
+        ),
+      },
+    },
+    PAGE_SIZE: {
+      description: i18n._(
+        msg({
+          message: "Set the default number of items shown per page.",
+          comment: "@context: Config Editor setting description",
+        }),
+      ),
+    },
+    SEARCH_PAGE_SIZE: {
+      description: i18n._(
+        msg({
+          message:
+            "Set results per search page; reset to inherit the main page size.",
+          comment: "@context: Config Editor setting description",
+        }),
+      ),
+    },
+    ARCHIVE_PAGE_SIZE: {
+      description: i18n._(
+        msg({
+          message:
+            "Set posts per archive page; reset to inherit the main page size.",
+          comment: "@context: Config Editor setting description",
+        }),
+      ),
+    },
+    SUMMARY_MAX_PARAGRAPHS: {
+      description: i18n._(
+        msg({
+          message:
+            "Limit paragraphs used in automatically generated summaries.",
+          comment: "@context: Config Editor setting description",
+        }),
+      ),
+    },
+    SUMMARY_MAX_CHARS: {
+      description: i18n._(
+        msg({
+          message:
+            "Limit characters used in automatically generated summaries.",
+          comment: "@context: Config Editor setting description",
+        }),
+      ),
+    },
+    RSS_FEED_LIMIT: {
+      description: i18n._(
+        msg({
+          message: "Limit posts included in each RSS feed.",
+          comment: "@context: Config Editor setting description",
+        }),
+      ),
+    },
+    RSS_PUBLISH_DELAY_SECONDS: {
+      description: i18n._(
+        msg({
+          message:
+            "Delay new posts and replies before they appear in feeds. Use 0 to turn this off.",
+          comment: "@context: Config Editor setting description",
+        }),
+      ),
+    },
+    THEME: {
+      description: i18n._(
+        msg({
+          message: "Choose the color palette used across Jant.",
+          comment: "@context: Config Editor linked setting description",
+        }),
+      ),
+    },
+    CUSTOM_CSS: {
+      description: i18n._(
+        msg({
+          message: "Add site-wide CSS in the dedicated code editor.",
+          comment: "@context: Config Editor linked setting description",
+        }),
+      ),
+    },
+    CUSTOM_HEAD_HTML: {
+      description: i18n._(
+        msg({
+          message: "Add site-wide HTML before the closing head tag.",
+          comment: "@context: Config Editor linked setting description",
+        }),
+      ),
+    },
+    CUSTOM_BODY_END_HTML: {
+      description: i18n._(
+        msg({
+          message: "Add site-wide HTML before the closing body tag.",
+          comment: "@context: Config Editor linked setting description",
+        }),
+      ),
+    },
+    SITE_AVATAR: {
+      description: i18n._(
+        msg({
+          message: "Upload the profile image and generated site icons.",
+          comment: "@context: Config Editor linked setting description",
+        }),
+      ),
+    },
+    SHOW_HEADER_AVATAR: {
+      description: i18n._(
+        msg({
+          message: "Show the site avatar in the public header.",
+          comment: "@context: Config Editor linked setting description",
+        }),
+      ),
+    },
+    FONT_THEME: {
+      description: i18n._(
+        msg({
+          message: "Choose the typography used across Jant.",
+          comment: "@context: Config Editor linked setting description",
+        }),
+      ),
+    },
+    THEME_MODE: {
+      description: i18n._(
+        msg({
+          message:
+            "Follow the device appearance or force a light or dark theme.",
+          comment: "@context: Config Editor linked setting description",
+        }),
+      ),
+    },
+    TIME_ZONE: {
+      description: i18n._(
+        msg({
+          message: "Choose the time zone used to display dates and times.",
+          comment: "@context: Config Editor setting description",
+        }),
+      ),
+    },
+    SITE_FOOTER: {
+      description: i18n._(
+        msg({
+          message:
+            "Edit the multi-line footer rendered at the bottom of public pages.",
+          comment: "@context: Config Editor linked setting description",
+        }),
+      ),
+    },
+    SHOW_JANT_BRANDING_ON_HOME: {
+      description: i18n._(
+        msg({
+          message: "Show the Jant credit on the home page.",
+          comment: "@context: Config Editor setting description",
+        }),
+      ),
+    },
+    NOINDEX: {
+      description: i18n._(
+        msg({
+          message:
+            "Ask search engines not to index public pages or include them in results.",
+          comment: "@context: Config Editor setting description",
+        }),
+      ),
+    },
+    PUBLIC_API_ENABLED: {
+      description: i18n._(
+        msg({
+          message: "Allow published content to be read without an API token.",
+          comment: "@context: Config Editor setting description",
+        }),
+      ),
+    },
+    RSS_FEEDS_ENABLED: {
+      description: i18n._(
+        msg({
+          message: "Publish Atom feeds for the site, archive, and collections.",
+          comment: "@context: Config Editor setting description",
+        }),
+      ),
+    },
+    GITHUB_SYNC_ENABLED: {
+      description: i18n._(
+        msg({
+          message: "Connect or manage automatic content backups to GitHub.",
+          comment: "@context: Config Editor linked setting description",
+        }),
+      ),
+    },
+    GITHUB_SYNC_REPO: {
+      description: i18n._(
+        msg({
+          message: "Choose the repository used for content backups.",
+          comment: "@context: Config Editor linked setting description",
+        }),
+      ),
+    },
+    TELEGRAM_BOT_USERNAME: {
+      description: i18n._(
+        msg({
+          message: "Connect or manage the bot used to post from Telegram.",
+          comment: "@context: Config Editor linked setting description",
+        }),
+      ),
+    },
+  };
+
+  const localizedFields = fields.map((field) => {
+    let optionLabels = presentations[field.key].optionLabels;
+    if (field.key === "SITE_LANGUAGE") {
+      optionLabels = Object.fromEntries(
+        (field.options ?? []).map((option) => [
+          option,
+          `${getOrBuildEntry(option).native} — ${option}`,
+        ]),
+      );
+    } else if (field.key === "TIME_ZONE") {
+      const timeZoneLabels = new Map(
+        getTimeZoneOptions(field.value).map((entry) => [
+          entry.value,
+          entry.label,
+        ]),
+      );
+      optionLabels = Object.fromEntries(
+        (field.options ?? []).map((option) => [
+          option,
+          `${timeZoneLabels.get(option) ?? option} — ${option}`,
+        ]),
+      );
+    }
+
+    return {
+      ...field,
+      ...presentations[field.key],
+      ...(optionLabels && { optionLabels }),
+      ...(field.settingsPath && {
+        settingsPath: toPublicPath(field.settingsPath, sitePathPrefix),
+      }),
+    };
+  });
+  const initialData = JSON.stringify({ fields: localizedFields }).replace(
+    /</g,
+    "\\u003c",
+  );
+  const countTemplate = i18n._(
+    msg({
+      message: "{count} settings shown",
+      comment: "@context: Config Editor live search result count",
+    }),
+    { count: "{count}" },
+  );
+  const modifiedLabel = i18n._(
+    msg({
+      message: "Modified",
+      comment: "@context: Config Editor badge for a database override",
+    }),
+  );
+  const labels = JSON.stringify({
+    search: i18n._(
+      msg({
+        message: "Search settings",
+        comment: "@context: Config Editor search input placeholder",
+      }),
+    ),
+    modifiedOnly: i18n._(
+      msg({
+        message: "Show only modified",
+        comment: "@context: Config Editor filter checkbox",
+      }),
+    ),
+    modified: modifiedLabel,
+    locked: i18n._(
+      msg({
+        message: "Locked",
+        comment:
+          "@context: Config Editor badge for a setting locked by the runtime",
+      }),
+    ),
+    reset: i18n._(
+      msg({
+        message: "Reset to default",
+        comment: "@context: Config Editor row action",
+      }),
+    ),
+    saving: i18n._(
+      msg({
+        message: "Saving…",
+        comment: "@context: Config Editor row save status",
+      }),
+    ),
+    saved: i18n._(
+      msg({
+        message: "Saved",
+        comment: "@context: Config Editor row save status",
+      }),
+    ),
+    saveError: i18n._(
+      msg({
+        message: "This setting wasn't saved. Check the value and try again.",
+        comment: "@context: Config Editor fallback error message",
+      }),
+    ),
+    noMatches: i18n._(
+      msg({
+        message:
+          "Nothing matches this search. Try a different name or description.",
+        comment: "@context: Config Editor empty search state",
+      }),
+    ),
+    countTemplate,
+    openSetting: i18n._(
+      msg({
+        message: "Open setting",
+        comment: "@context: Config Editor link to a dedicated settings page",
+      }),
+    ),
+    configured: i18n._(
+      msg({
+        message: "Configured",
+        comment: "@context: Config Editor linked setting status",
+      }),
+    ),
+    notConfigured: i18n._(
+      msg({
+        message: "Not configured",
+        comment: "@context: Config Editor linked setting status",
+      }),
+    ),
+  }).replace(/</g, "\\u003c");
+
+  return (
+    <div class="config-editor-page">
+      <header class="page-intro">
+        <h1 class="page-intro-title">
+          {i18n._(
+            msg({
+              message: "Config Editor",
+              comment: "@context: Config Editor page title",
+            }),
+          )}
+        </h1>
+        <p class="page-intro-description">
+          {i18n._(
+            msg({
+              message:
+                "Search and edit runtime settings. Changes apply immediately; reset restores the environment or built-in default.",
+              comment: "@context: Config Editor page description",
+            }),
+          )}
+        </p>
+      </header>
+
+      <jant-config-editor
+        endpoint={endpoint}
+        initial-data={initialData}
+        labels={labels}
+      >
+        <div class="config-editor-fallback">
+          <div class="config-editor-toolbar">
+            <input
+              type="search"
+              name="config-search"
+              class="input config-editor-search-input"
+              placeholder={i18n._(
+                msg({
+                  message: "Search settings",
+                  comment: "@context: Config Editor search input placeholder",
+                }),
+              )}
+              disabled
+            />
+          </div>
+          <div class="config-editor-toolbar-meta">
+            <p class="config-editor-count">
+              {countTemplate.replace("{count}", String(localizedFields.length))}
+            </p>
+          </div>
+          <ul class="config-editor-list">
+            {localizedFields.map((field) => (
+              <li class="config-editor-row" key={field.key}>
+                <div class="config-editor-copy">
+                  <div class="config-editor-heading">
+                    <code class="config-editor-key" translate="no">
+                      {field.key}
+                    </code>
+                    {field.modified ? (
+                      <span class="config-editor-state config-editor-modified">
+                        {modifiedLabel}
+                      </span>
+                    ) : null}
+                  </div>
+                  <p class="config-editor-description">{field.description}</p>
+                </div>
+                <div class="config-editor-value-column">
+                  <div class="config-editor-control-row">
+                    {field.mode === "link" ? (
+                      <a
+                        class="config-editor-open-control"
+                        href={field.settingsPath}
+                      >
+                        <span class="config-editor-linked-value" translate="no">
+                          {field.display === "configured"
+                            ? field.value === "true"
+                              ? i18n._(
+                                  msg({
+                                    message: "Configured",
+                                    comment:
+                                      "@context: Config Editor linked setting status",
+                                  }),
+                                )
+                              : i18n._(
+                                  msg({
+                                    message: "Not configured",
+                                    comment:
+                                      "@context: Config Editor linked setting status",
+                                  }),
+                                )
+                            : field.value}
+                        </span>
+                        <span class="config-editor-open-action">
+                          {i18n._(
+                            msg({
+                              message: "Open setting",
+                              comment:
+                                "@context: Config Editor link to a dedicated settings page",
+                            }),
+                          )}
+                          <svg
+                            xmlns="http://www.w3.org/2000/svg"
+                            width="15"
+                            height="15"
+                            viewBox="0 0 24 24"
+                            fill="none"
+                            stroke="currentColor"
+                            stroke-width="2"
+                            stroke-linecap="round"
+                            stroke-linejoin="round"
+                            aria-hidden="true"
+                          >
+                            <path d="M5 12h14" />
+                            <path d="m13 6 6 6-6 6" />
+                          </svg>
+                        </span>
+                      </a>
+                    ) : (
+                      <output class="config-editor-fallback-value">
+                        {field.type === "enum"
+                          ? (field.optionLabels?.[field.value] ?? field.value)
+                          : field.value}
+                      </output>
+                    )}
+                  </div>
+                </div>
+              </li>
+            ))}
+          </ul>
+        </div>
+      </jant-config-editor>
+    </div>
+  );
+}

package/src/ui/dash/settings/GeneralContent.tsx

@@ -193,15 +193,16 @@ export function GeneralContent({
     ),
     cjkFont: i18n._(
       msg({
-        message: "CJK Font",
-        comment: "@context: Settings form field for CJK serif font selection",
+        message: "CJK fallback",
+        comment:
+          "@context: Settings field for a manual Chinese, Japanese, or Korean font fallback",
       }),
     ),
     cjkFontHelp: i18n._(
       msg({
         message:
-          "Load a serif font optimized for Chinese, Japanese, or Korean content.",
-        comment: "@context: Help text for CJK serif font selection",
+          "Used when the content language has no built-in font profile. Your font theme still controls serif and sans styling.",
+        comment: "@context: Help text for the manual CJK font fallback setting",
       }),
     ),
     timeZone: i18n._(
@@ -395,7 +396,16 @@ export function GeneralContent({
   ]).replace(/</g, "\\u003c");
 
   const cjkFontsJson = JSON.stringify([
-    { value: "off", label: "None" },
+    {
+      value: "off",
+      label: i18n._(
+        msg({
+          message: "Follow content language",
+          comment:
+            "@context: CJK font fallback option that uses the configured content language",
+        }),
+      ),
+    },
     {
       value: "zh-Hans",
       label: "\u7B80\u4F53\u4E2D\u6587 (Simplified Chinese)",

package/src/ui/dash/settings/SettingsRootContent.tsx

@@ -5,6 +5,7 @@
 import { msg } from "@lingui/core/macro";
 import { coalesceDisplayText } from "../../../lib/display-text.js";
 import { useLingui } from "../../../i18n/context.js";
+import { NAVIGATION_SETTINGS_PATH } from "../../../lib/settings-paths.js";
 import { extractDomain, toPublicPath } from "../../../lib/url.js";
 import {
   SettingsDirectoryLink,
@@ -27,6 +28,7 @@ const ICONS = {
   gitBranch: `<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><line x1="6" x2="6" y1="3" y2="15"/><circle cx="18" cy="6" r="3"/><circle cx="6" cy="18" r="3"/><path d="M18 9a9 9 0 0 1-9 9"/></svg>`,
   send: `<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M14.536 21.686a.5.5 0 0 0 .937-.024l6.5-19a.496.496 0 0 0-.635-.635l-19 6.5a.5.5 0 0 0-.024.937l7.93 3.18a2 2 0 0 1 1.112 1.11z"/><path d="m21.854 2.147-10.94 10.939"/></svg>`,
   cloud: `<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M17.5 19H9a7 7 0 1 1 6.71-9h1.79a4.5 4.5 0 1 1 0 9Z"/></svg>`,
+  sliders: `<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><line x1="4" x2="4" y1="21" y2="14"/><line x1="4" x2="4" y1="10" y2="3"/><line x1="12" x2="12" y1="21" y2="12"/><line x1="12" x2="12" y1="8" y2="3"/><line x1="20" x2="20" y1="21" y2="16"/><line x1="20" x2="20" y1="12" y2="3"/><line x1="1" x2="7" y1="14" y2="14"/><line x1="9" x2="15" y1="8" y2="8"/><line x1="17" x2="23" y1="16" y2="16"/></svg>`,
 };
 
 export function SettingsRootContent({
@@ -161,7 +163,7 @@ export function SettingsRootContent({
           )}
         />
         <SettingsDirectoryLink
-          href={toPublicPath("/settings/navigation", sitePathPrefix)}
+          href={toPublicPath(NAVIGATION_SETTINGS_PATH, sitePathPrefix)}
           icon={ICONS.menu}
           name={i18n._(
             msg({
@@ -317,6 +319,24 @@ export function SettingsRootContent({
             }),
           )}
         />
+        <SettingsDirectoryLink
+          href={toPublicPath("/settings/config", sitePathPrefix)}
+          icon={ICONS.sliders}
+          tone="subtle"
+          name={i18n._(
+            msg({
+              message: "Config Editor",
+              comment: "@context: Settings item — Config Editor",
+            }),
+          )}
+          description={i18n._(
+            msg({
+              message:
+                "Search runtime settings and open advanced configuration",
+              comment: "@context: Settings item description for Config Editor",
+            }),
+          )}
+        />
       </SettingsDirectorySection>
 
       <SettingsDirectorySection