@jant/core 0.6.14 → 0.6.15

package/src/types/bindings.ts

@@ -40,6 +40,8 @@ export interface Bindings {
   TIME_ZONE?: EnvBindingValue;
   SITE_FOOTER?: EnvBindingValue;
   NOINDEX?: EnvBindingValue;
+  PUBLIC_API_ENABLED?: EnvBindingValue;
+  RSS_FEEDS_ENABLED?: EnvBindingValue;
   R2_PUBLIC_URL?: EnvBindingValue;
   IMAGE_TRANSFORM_URL?: EnvBindingValue;
   DEMO_EMAIL?: EnvBindingValue;
@@ -83,6 +85,7 @@ export interface Bindings {
   SLUG_ID_LENGTH?: EnvBindingValue;
   // RSS feed
   RSS_FEED_LIMIT?: EnvBindingValue;
+  RSS_PUBLISH_DELAY_SECONDS?: EnvBindingValue;
   // Node runtime database URL. SQLite uses file: URLs; Postgres uses
   // postgres:/postgresql: URLs.
   DATABASE_URL?: string;

package/src/types/config.ts

@@ -4,7 +4,48 @@
  * Single Source of Truth for all configuration fields.
  */
 
-import type { FeedKind } from "./constants.js";
+import {
+  MAX_SITE_DESCRIPTION_LENGTH,
+  MAX_SITE_FOOTER_LENGTH,
+  MAX_SITE_NAME_LENGTH,
+  type FeedKind,
+} from "./constants.js";
+
+export type ConfigEditorOptionsSource = "contentLanguage" | "timeZone";
+
+export type ConfigEditorDefinition =
+  | {
+      type: "boolean";
+    }
+  | {
+      type: "string";
+      maxLength?: number;
+    }
+  | {
+      type: "number";
+      min?: number;
+      max?: number;
+      step?: number;
+    }
+  | {
+      type: "enum";
+      options: readonly string[];
+      optionsSource?: never;
+    }
+  | {
+      type: "enum";
+      options?: never;
+      optionsSource: ConfigEditorOptionsSource;
+    };
+
+export interface ConfigEditorLinkDefinition {
+  type: "boolean" | "string";
+  settingsPath: string;
+  display: "value" | "configured";
+  fallbackKey?: "DEFAULT_THEME" | "DEFAULT_FONT_THEME";
+  fallbackValue?: string;
+  resettable?: boolean;
+}
 
 /**
  * Configuration Registry - Single Source of Truth
@@ -20,6 +61,21 @@ interface ConfigField {
   defaultValue: string;
   envOnly: boolean;
   internal?: boolean;
+  /** Another runtime field to inherit when this field has no own value. */
+  fallbackKey?: "PAGE_SIZE";
+  /**
+   * Explicitly opts a safe runtime setting into Config Editor.
+   *
+   * Omission is intentional: environment infrastructure, secrets, and
+   * internal state must never become editable merely because they are added
+   * to the broader config registry.
+   */
+  editor?: ConfigEditorDefinition;
+  /**
+   * Adds a safe dedicated-page setting to the searchable Config Editor index
+   * without duplicating its specialized editing workflow.
+   */
+  configEditorLink?: ConfigEditorLinkDefinition;
   /**
    * Environment variable names in resolution order.
    */
@@ -32,16 +88,31 @@ export const CONFIG_FIELDS = {
     defaultValue: "Jant",
     envOnly: false,
     envKeys: ["SITE_NAME"],
+    editor: { type: "string", maxLength: MAX_SITE_NAME_LENGTH },
+    configEditorLink: {
+      type: "string",
+      settingsPath: "/settings/general",
+      display: "value",
+      resettable: true,
+    },
   },
   SITE_DESCRIPTION: {
     defaultValue: "",
     envOnly: false,
     envKeys: ["SITE_DESCRIPTION"],
+    editor: { type: "string", maxLength: MAX_SITE_DESCRIPTION_LENGTH },
+    configEditorLink: {
+      type: "string",
+      settingsPath: "/settings/general",
+      display: "configured",
+      resettable: true,
+    },
   },
   SITE_LANGUAGE: {
     defaultValue: "en",
     envOnly: false,
     envKeys: ["SITE_LANGUAGE"],
+    editor: { type: "enum", optionsSource: "contentLanguage" },
   },
   // Admin dashboard UI locale. Empty means "follow the content language"
   // (resolved through the catalog fallback chain, i.e. today's behaviour).
@@ -49,16 +120,25 @@ export const CONFIG_FIELDS = {
     defaultValue: "",
     envOnly: false,
     envKeys: ["DASHBOARD_LANGUAGE"],
+    editor: {
+      type: "enum",
+      options: ["", "en", "zh-Hans", "zh-Hant"],
+    },
   },
   CJK_SERIF_FONT: {
     defaultValue: "off",
     envOnly: false,
     envKeys: ["CJK_SERIF_FONT"],
+    editor: {
+      type: "enum",
+      options: ["off", "zh-Hans", "zh-Hant", "ja", "ko"],
+    },
   },
   MAIN_RSS_FEED: {
     defaultValue: "featured",
     envOnly: false,
     envKeys: ["MAIN_RSS_FEED"],
+    editor: { type: "enum", options: ["featured", "latest"] },
   },
   // Environment-only (deployment/infrastructure config)
   DEFAULT_THEME: {
@@ -113,18 +193,23 @@ export const CONFIG_FIELDS = {
   },
   PAGE_SIZE: {
     defaultValue: "50",
-    envOnly: true,
+    envOnly: false,
     envKeys: ["PAGE_SIZE"],
+    editor: { type: "number", min: 1, max: 100, step: 1 },
   },
   SEARCH_PAGE_SIZE: {
     defaultValue: "",
-    envOnly: true,
+    envOnly: false,
+    fallbackKey: "PAGE_SIZE",
     envKeys: ["SEARCH_PAGE_SIZE"],
+    editor: { type: "number", min: 1, max: 100, step: 1 },
   },
   ARCHIVE_PAGE_SIZE: {
     defaultValue: "",
-    envOnly: true,
+    envOnly: false,
+    fallbackKey: "PAGE_SIZE",
     envKeys: ["ARCHIVE_PAGE_SIZE"],
+    editor: { type: "number", min: 1, max: 100, step: 1 },
   },
   STORAGE_DRIVER: {
     defaultValue: "r2",
@@ -173,13 +258,15 @@ export const CONFIG_FIELDS = {
   },
   SUMMARY_MAX_PARAGRAPHS: {
     defaultValue: "5",
-    envOnly: true,
+    envOnly: false,
     envKeys: ["SUMMARY_MAX_PARAGRAPHS"],
+    editor: { type: "number", min: 1, max: 50, step: 1 },
   },
   SUMMARY_MAX_CHARS: {
     defaultValue: "500",
-    envOnly: true,
+    envOnly: false,
     envKeys: ["SUMMARY_MAX_CHARS"],
+    editor: { type: "number", min: 1, max: 1500, step: 1 },
   },
   SLUG_ID_LENGTH: {
     defaultValue: "5",
@@ -188,8 +275,15 @@ export const CONFIG_FIELDS = {
   },
   RSS_FEED_LIMIT: {
     defaultValue: "50",
-    envOnly: true,
+    envOnly: false,
     envKeys: ["RSS_FEED_LIMIT"],
+    editor: { type: "number", min: 1, max: 200, step: 1 },
+  },
+  RSS_PUBLISH_DELAY_SECONDS: {
+    defaultValue: "300",
+    envOnly: false,
+    envKeys: ["RSS_PUBLISH_DELAY_SECONDS"],
+    editor: { type: "number", min: 0, max: 7200, step: 1 },
   },
 
   // Internal settings (DB-only, not configurable via env or settings UI)
@@ -197,31 +291,65 @@ export const CONFIG_FIELDS = {
     defaultValue: "",
     envOnly: false,
     internal: true,
+    configEditorLink: {
+      type: "string",
+      settingsPath: "/settings/color-theme",
+      display: "value",
+      fallbackKey: "DEFAULT_THEME",
+      resettable: true,
+    },
   },
   CUSTOM_CSS: {
     defaultValue: "",
     envOnly: false,
     internal: true,
+    configEditorLink: {
+      type: "string",
+      settingsPath: "/settings/custom-css",
+      display: "configured",
+    },
   },
   CUSTOM_HEAD_HTML: {
     defaultValue: "",
     envOnly: false,
     internal: true,
+    configEditorLink: {
+      type: "string",
+      settingsPath: "/settings/code-injection",
+      display: "configured",
+    },
   },
   CUSTOM_BODY_END_HTML: {
     defaultValue: "",
     envOnly: false,
     internal: true,
+    configEditorLink: {
+      type: "string",
+      settingsPath: "/settings/code-injection",
+      display: "configured",
+    },
   },
   SITE_AVATAR: {
     defaultValue: "",
     envOnly: false,
     internal: true,
+    configEditorLink: {
+      type: "string",
+      settingsPath: "/settings/avatar",
+      display: "configured",
+    },
   },
   SHOW_HEADER_AVATAR: {
     defaultValue: "",
     envOnly: false,
     internal: true,
+    configEditorLink: {
+      type: "boolean",
+      settingsPath: "/settings/avatar",
+      display: "value",
+      fallbackValue: "false",
+      resettable: true,
+    },
   },
   SITE_FAVICON_ICO: {
     defaultValue: "",
@@ -242,31 +370,67 @@ export const CONFIG_FIELDS = {
     defaultValue: "",
     envOnly: false,
     internal: true,
+    configEditorLink: {
+      type: "string",
+      settingsPath: "/settings/font-theme",
+      display: "value",
+      fallbackKey: "DEFAULT_FONT_THEME",
+      resettable: true,
+    },
   },
   THEME_MODE: {
     defaultValue: "",
     envOnly: false,
     internal: true,
+    configEditorLink: {
+      type: "string",
+      settingsPath: "/settings/color-theme",
+      display: "value",
+      fallbackValue: "auto",
+      resettable: true,
+    },
   },
   TIME_ZONE: {
     defaultValue: "UTC",
     envOnly: false,
     envKeys: ["TIME_ZONE"],
+    editor: { type: "enum", optionsSource: "timeZone" },
   },
   SITE_FOOTER: {
     defaultValue: "",
     envOnly: false,
     envKeys: ["SITE_FOOTER"],
+    editor: { type: "string", maxLength: MAX_SITE_FOOTER_LENGTH },
+    configEditorLink: {
+      type: "string",
+      settingsPath: "/settings/general",
+      display: "configured",
+      resettable: true,
+    },
   },
   SHOW_JANT_BRANDING_ON_HOME: {
-    defaultValue: "",
+    defaultValue: "false",
     envOnly: false,
     envKeys: ["SHOW_JANT_BRANDING_ON_HOME"],
+    editor: { type: "boolean" },
   },
   NOINDEX: {
-    defaultValue: "",
+    defaultValue: "false",
     envOnly: false,
     envKeys: ["NOINDEX"],
+    editor: { type: "boolean" },
+  },
+  PUBLIC_API_ENABLED: {
+    defaultValue: "true",
+    envOnly: false,
+    envKeys: ["PUBLIC_API_ENABLED"],
+    editor: { type: "boolean" },
+  },
+  RSS_FEEDS_ENABLED: {
+    defaultValue: "true",
+    envOnly: false,
+    envKeys: ["RSS_FEEDS_ENABLED"],
+    editor: { type: "boolean" },
   },
   DISCOVERY_COMPOSE_OPEN_SHORTCUT_AT: {
     defaultValue: "",
@@ -299,11 +463,21 @@ export const CONFIG_FIELDS = {
     defaultValue: "false",
     envOnly: false,
     internal: true,
+    configEditorLink: {
+      type: "boolean",
+      settingsPath: "/settings/github-sync",
+      display: "value",
+    },
   },
   GITHUB_SYNC_REPO: {
     defaultValue: "",
     envOnly: false,
     internal: true,
+    configEditorLink: {
+      type: "string",
+      settingsPath: "/settings/github-sync",
+      display: "configured",
+    },
   },
   GITHUB_SYNC_TOKEN: {
     defaultValue: "",
@@ -433,6 +607,11 @@ export const CONFIG_FIELDS = {
     defaultValue: "",
     envOnly: false,
     internal: true,
+    configEditorLink: {
+      type: "string",
+      settingsPath: "/settings/telegram",
+      display: "configured",
+    },
   },
   /** Per-site `secret_token` for a bring-your-own bot's webhook. */
   TELEGRAM_BOT_WEBHOOK_SECRET: {
@@ -443,6 +622,52 @@ export const CONFIG_FIELDS = {
 } as const satisfies Record<string, ConfigField>;
 
 export type ConfigKey = keyof typeof CONFIG_FIELDS;
+export type ConfigEditorKey = {
+  [K in ConfigKey]: (typeof CONFIG_FIELDS)[K] extends {
+    editor: ConfigEditorDefinition;
+  }
+    ? K
+    : never;
+}[ConfigKey];
+
+export type ConfigEditorVisibleKey = {
+  [K in ConfigKey]: (typeof CONFIG_FIELDS)[K] extends
+    | { editor: ConfigEditorDefinition }
+    | { configEditorLink: ConfigEditorLinkDefinition }
+    ? K
+    : never;
+}[ConfigKey];
+
+export type ConfigEditorResettableKey = {
+  [K in ConfigKey]: (typeof CONFIG_FIELDS)[K] extends {
+    editor: ConfigEditorDefinition;
+  }
+    ? K
+    : (typeof CONFIG_FIELDS)[K] extends {
+          configEditorLink: { resettable: true };
+        }
+      ? K
+      : never;
+}[ConfigKey];
+
+export interface ConfigEditorFieldState {
+  key: ConfigEditorVisibleKey;
+  mode: "edit" | "link";
+  type: ConfigEditorDefinition["type"];
+  value: string;
+  fallbackValue: string;
+  modified: boolean;
+  locked: boolean;
+  maxLength?: number;
+  min?: number;
+  max?: number;
+  step?: number;
+  options?: readonly string[];
+  settingsPath?: string;
+  display?: ConfigEditorLinkDefinition["display"];
+  resettable?: boolean;
+  fallbackKey?: "PAGE_SIZE";
+}
 export const THEME_MODES = ["auto", "light", "dark"] as const;
 export type ThemeMode = (typeof THEME_MODES)[number];
 
@@ -465,7 +690,7 @@ export interface AppConfig {
    * the translated catalog locales ("en", "zh-Hans", "zh-Hant").
    */
   dashboardLanguage: string;
-  /** CJK serif font locale: "off", "zh-Hans", "zh-Hant", "ja", or "ko" */
+  /** Optional CJK font fallback when the content language has no profile. */
   cjkSerifFont: string;
   mainRssFeed: FeedKind;
   /** Canonical IANA timezone identifier used for date/time display. */
@@ -473,6 +698,10 @@ export interface AppConfig {
   siteFooter: string;
   showJantBrandingOnHome: boolean;
   noindex: boolean;
+  /** Whether published content can be read from JSON APIs without authentication. */
+  publicApiEnabled: boolean;
+  /** Whether the site publishes its Atom feed endpoints. */
+  rssFeedsEnabled: boolean;
 
   // Infrastructure (ENV only)
   siteUrl: string;
@@ -492,17 +721,19 @@ export interface AppConfig {
   /** Max upload file size in MB. Defaults to 500. */
   uploadMaxFileSize: number;
 
-  // Summary extraction (ENV only)
+  // Summary extraction (DB > ENV > Default)
   /** Max paragraphs to include in auto-extracted summary. Defaults to 5. */
   summaryMaxParagraphs: number;
   /** Max characters to include in auto-extracted summary. Defaults to 500. */
   summaryMaxChars: number;
 
-  // Pagination/Feed (ENV only, parsed to number)
+  // Pagination/feed (DB > ENV > Default)
   pageSize: number;
   searchPageSize: number;
   archivePageSize: number;
   rssFeedLimit: number;
+  /** Seconds a published Post waits before it can appear in Atom feeds. */
+  rssPublishDelaySeconds: number;
 
   // Slug (ENV only)
   /** Length of random IDs used in auto-generated slugs. Defaults to 5. */

package/src/types/constants.ts

@@ -29,7 +29,7 @@ export const COLLECTION_SORT_ORDERS = [
 ] as const;
 export type CollectionSortOrder = (typeof COLLECTION_SORT_ORDERS)[number];
 
-export const NAV_ITEM_TYPES = ["link", "system", "collection"] as const;
+export const NAV_ITEM_TYPES = ["link", "system", "collection", "page"] as const;
 export type NavItemType = (typeof NAV_ITEM_TYPES)[number];
 
 export const NAV_ITEM_PLACEMENTS = ["header", "more"] as const;
@@ -81,6 +81,27 @@ export const SYSTEM_NAV_KEYS = {
   }
 >;
 
+export interface DefaultNavigationProfile {
+  version: number;
+  systemKeys: readonly SystemNavKey[];
+}
+
+/**
+ * Append-only default navigation profiles. A profile is materialized during
+ * initial setup/provisioning and incomplete-setup recovery. Existing rows are
+ * never removed, updated, or reordered to match a profile.
+ */
+export const DEFAULT_NAVIGATION_PROFILES = {
+  1: {
+    version: 1,
+    systemKeys: ["featured", "collections", "archive", "rss", "settings"],
+  },
+} as const satisfies Record<number, DefaultNavigationProfile>;
+
+export const DEFAULT_NAVIGATION_PROFILE_VERSION = 1 as const;
+export const DEFAULT_NAVIGATION_PROFILE =
+  DEFAULT_NAVIGATION_PROFILES[DEFAULT_NAVIGATION_PROFILE_VERSION];
+
 export const MAX_MEDIA_ATTACHMENTS = 20;
 export const MAX_THREAD_POSTS = 20;
 export const MAX_PINNED_POSTS = 3;

package/src/types/entities.ts

@@ -132,7 +132,7 @@ export interface Collection {
 }
 
 export interface CollectionDirectoryCollection extends Collection {
-  postCount: number;
+  threadCount: number;
   recentActivityAt: number;
 }
 
@@ -166,9 +166,9 @@ export interface CollectionsDirectoryData {
   directoryItems: CollectionDirectoryEntry[];
 }
 
-export interface PostCollection {
+export interface ThreadCollection {
   siteId: string;
-  postId: string;
+  threadId: string;
   collectionId: string;
 }
 
@@ -178,6 +178,7 @@ export interface NavItem {
   type: NavItemType;
   systemKey?: SystemNavKey;
   collectionId?: string;
+  postId?: string;
   label: string;
   url: string;
   placement: NavItemPlacement;
@@ -228,12 +229,12 @@ export interface ApiToken {
   updatedAt: number;
 }
 
-/** Latest-reply context for a thread root, used in timeline display */
+/** Bounded reply context for a thread root, used in timeline display. */
 export interface ThreadTimelineContext {
-  /** Second chronological post in the thread (the first published reply). */
-  secondReply: Post | null;
-  /** Penultimate chronological post in the thread, when distinct from latest. */
-  penultimateReply: Post | null;
+  /** Earliest published replies, in chronological order. */
+  leadingReplies: Post[];
+  /** Published replies immediately before latest, in chronological order. */
+  trailingReplies: Post[];
   latestReply: Post;
   totalReplyCount: number;
 }

package/src/types/operations.ts

@@ -35,17 +35,17 @@ export interface TextAttachmentContent {
 }
 
 /**
- * A single collection membership entry, with all the per-row metadata the
- * `post_collection` junction table carries. Used by the Hugo importer to
+ * A single Thread collection membership entry, with all the per-row metadata
+ * the `thread_collection` junction table carries. Used by the Hugo importer to
  * restore per-entry `createdAt` / `position` / `pinnedAt` losslessly.
  */
-export interface PostCollectionEntry {
+export interface ThreadCollectionEntry {
   collectionId: string;
-  /** Unix seconds — when the post was added to the collection. Defaults to now() when omitted. */
+  /** Unix seconds — when the Thread was added to the collection. Defaults to now() when omitted. */
   createdAt?: number;
   /** Sort position within the collection. Defaults to append-at-end when omitted. */
   position?: number;
-  /** Unix seconds when the post was pinned in this specific collection; null means unpinned. */
+  /** Unix seconds when the Thread was pinned in this specific collection; null means unpinned. */
   pinnedAt?: number | null;
 }
 
@@ -79,9 +79,10 @@ export interface CreatePost {
   quoteText?: string;
   rating?: number;
   /**
-   * Simple slug/ID list of collections to add the post to. Uses `now()` for
-   * `createdAt` and append-at-end for `position`. For lossless import that
-   * preserves those fields, use `collectionEntries` instead.
+   * Simple slug/ID list for the shared Thread collection set. Set this while
+   * creating a Thread root; reply creation rejects non-empty membership input.
+   * Uses `now()` for `createdAt` and append-at-end for `position`. For lossless
+   * import that preserves those fields, use `collectionEntries` instead.
    */
   collectionIds?: string[];
   /**
@@ -89,7 +90,7 @@ export interface CreatePost {
    * `collectionIds` and restores per-entry `createdAt` / `position` /
    * `pinnedAt` losslessly.
    */
-  collectionEntries?: PostCollectionEntry[];
+  collectionEntries?: ThreadCollectionEntry[];
   replyToId?: string;
   quietReply?: boolean;
   publishedAt?: number;
@@ -116,7 +117,7 @@ export interface UpdatePost {
   quoteText?: string | null;
   rating?: number | null;
   collectionIds?: string[];
-  collectionEntries?: PostCollectionEntry[];
+  collectionEntries?: ThreadCollectionEntry[];
   publishedAt?: number;
   attachments?: PostAttachmentInput[];
 }
@@ -142,6 +143,13 @@ export type CreateNavItem =
       url: string;
       placement?: NavItemPlacement;
       position?: string;
+    }
+  | {
+      type: "page";
+      postId: string;
+      label?: string;
+      placement?: NavItemPlacement;
+      position?: string;
     };
 
 export interface UpdateNavItem {

package/src/types/props.ts

@@ -30,6 +30,8 @@ export interface HomePageProps {
 export interface PostPageProps {
   post: PostView;
   threadPosts?: PostView[];
+  /** Hide owner-only actions while preserving the public post rendering. */
+  isPreview?: boolean;
 }
 
 /** Props for the featured page component */
@@ -108,7 +110,10 @@ export interface CollectionPageProps {
   defaultSort: CollectionSortOrder;
   showRatingSort: boolean;
   isAuthenticated: boolean;
+  isInNavigation?: boolean;
   sitePathPrefix?: string;
+  /** Href for this collection selection's Atom feed when feeds are enabled. */
+  feedHref?: string;
 }
 
 /** Props for the collection editor page component */
@@ -123,6 +128,7 @@ export interface CollectionEditorPageProps {
 export interface CollectionsPageProps {
   items: CollectionDirectoryItem[];
   isAuthenticated: boolean;
+  navigationCollectionIds?: string[];
   sitePathPrefix?: string;
   siteOrigin?: string;
 }
@@ -179,8 +185,8 @@ export interface TimelineCardProps {
 /** Props for thread inline preview */
 export interface ThreadPreviewProps {
   rootPost: PostView;
-  secondReply?: PostView;
-  penultimateReply?: PostView;
+  leadingReplies: PostView[];
+  trailingReplies: PostView[];
   latestReply: PostView;
   totalReplyCount: number;
 }

package/src/types/raw-assets.d.ts

@@ -26,6 +26,11 @@ declare module "*.js?raw" {
   export default content;
 }
 
+declare module "*.md?raw" {
+  const content: string;
+  export default content;
+}
+
 declare module "*.xml?raw" {
   const content: string;
   export default content;