@fecommunity/reactpress-toolkit 3.0.4 → 3.7.0

package/dist/theme/server.js

@@ -0,0 +1,177 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchSearchArticles = exports.fetchCategoryIndex = exports.fetchCategoryArchive = exports.fetchArticlePageProps = exports.createDefaultVisitorContext = exports.createArchiveGetStaticProps = exports.fetchTagArchivePageProps = exports.fetchSearchPageProps = exports.fetchKnowledgeIndexPageProps = exports.fetchKnowledgeChapterPageProps = exports.fetchKnowledgeBookPageProps = exports.fetchHomePageProps = exports.fetchCmsPageProps = exports.fetchCategoryArchivePageProps = exports.fetchArticleDetailProps = exports.fetchArchivesPageProps = exports.resolveCarouselArticles = exports.sortedArchiveYears = exports.slimArchiveTree = exports.formatArchiveDay = exports.countArchiveArticles = exports.slimArticlesForList = exports.slimArticlesForCarousel = exports.slimArticleForList = exports.slimArticleForCarousel = exports.slimAppBootstrapForRoute = exports.createBootstrapSlimmer = exports.fetchRecommendArticles = exports.fetchPublishedPages = exports.fetchKnowledgeList = exports.fetchKnowledgeDetail = exports.fetchCmsPage = exports.fetchArchives = exports.fetchAppBootstrap = exports.createDefaultAppBootstrap = exports.truncateWords = exports.stripHtml = exports.resolveArchiveExcerpt = exports.rewriteArticleHtmlAssets = exports.resolvePublicAssetUrl = exports.isLikelyValidHeaderLogoPath = exports.isLikelyValidAssetPath = exports.unpackPaginatedPair = exports.unpackPaginated = exports.unpackOne = exports.unpackList = exports.themeApi = exports.resolveThemeApiBaseUrl = exports.getThemeApiBaseUrl = exports.createThemeApi = void 0;
+exports.jsonp = exports.getSiteTitle = exports.getPageTitle = exports.readCommentAuthor = exports.persistCommentAuthor = exports.isValidCommentEmail = exports.isValidCommentAuthor = exports.getCommentEmailError = exports.COMMENT_EMAIL_REGEXP = exports.COMMENT_AUTHOR_STORAGE_KEY = exports.VISITOR_LOCALE_COOKIE = exports.resolveVisitorLocale = exports.readRequestCookie = exports.readBrowserCookie = exports.persistVisitorLocale = exports.LEGACY_LOCALE_STORAGE_KEY = exports.DEFAULT_VISITOR_LOCALES = exports.resolvePreferredColorMode = exports.resolveInitialColorModeState = exports.resolveClientThemeMode = exports.persistColorMode = exports.colorModeInitScript = exports.COLOR_MODE_STORAGE_KEY = exports.buildColorModeInitScript = exports.applyColorModeClass = exports.THEME_USER_STORAGE_KEY = exports.THEME_TOKEN_STORAGE_KEY = exports.resolveStoredUser = exports.persistThemeSession = exports.getStoredAccessToken = exports.clearThemeSession = exports.ADMIN_AUTH_STORAGE_KEY = exports.resolveImageUrl = exports.safeJsonParse = exports.pickSiteSettings = exports.formatPublishDateShort = exports.formatPublishDate = exports.withThemeStaticProps = exports.withApiRetry = exports.themeStaticProps = exports.THEME_ISR_REVALIDATE_SECONDS = exports.sanitizeNextProps = exports.resolveStaticVisitorContext = exports.fetchVisitorContext = exports.fetchThemeCatalog = exports.fetchTagIndex = exports.fetchTagArchive = exports.fetchSiteSettings = exports.fetchSiteMeta = exports.fetchSingleArticle = void 0;
+exports.ThemeTemplate = exports.resolveTemplateFiles = exports.DEFAULT_TEMPLATE_FILES = exports.themeStaticNotFound = exports.themeOnDemandPaths = exports.themeNotFound = exports.defaultModsFromManifest = exports.createThemeHttpStack = exports.createThemeProviders = exports.unwrapSetting = exports.parseSiteMeta = exports.DEFAULT_SITE_META = exports.resolveThemeRuntime = exports.tagPath = exports.getNavActiveId = exports.categoryPath = exports.articlePath = exports.slimVisitorI18nForSsr = exports.mergeVisitorI18n = exports.resolveRequestLocale = exports.parseSiteLocale = exports.createTranslator = exports.resolveThemeAxiosBaseUrl = exports.encodeAxiosUrlPath = exports.createThemeAxiosClient = void 0;
+var api_1 = require("./api/api");
+Object.defineProperty(exports, "createThemeApi", { enumerable: true, get: function () { return api_1.createThemeApi; } });
+Object.defineProperty(exports, "getThemeApiBaseUrl", { enumerable: true, get: function () { return api_1.getThemeApiBaseUrl; } });
+Object.defineProperty(exports, "resolveThemeApiBaseUrl", { enumerable: true, get: function () { return api_1.resolveThemeApiBaseUrl; } });
+Object.defineProperty(exports, "themeApi", { enumerable: true, get: function () { return api_1.themeApi; } });
+var api_envelope_1 = require("../utils/api-envelope");
+Object.defineProperty(exports, "unpackList", { enumerable: true, get: function () { return api_envelope_1.unpackList; } });
+Object.defineProperty(exports, "unpackOne", { enumerable: true, get: function () { return api_envelope_1.unpackOne; } });
+Object.defineProperty(exports, "unpackPaginated", { enumerable: true, get: function () { return api_envelope_1.unpackPaginated; } });
+Object.defineProperty(exports, "unpackPaginatedPair", { enumerable: true, get: function () { return api_envelope_1.unpackPaginatedPair; } });
+var assets_1 = require("./content/assets");
+Object.defineProperty(exports, "isLikelyValidAssetPath", { enumerable: true, get: function () { return assets_1.isLikelyValidAssetPath; } });
+Object.defineProperty(exports, "isLikelyValidHeaderLogoPath", { enumerable: true, get: function () { return assets_1.isLikelyValidHeaderLogoPath; } });
+Object.defineProperty(exports, "resolvePublicAssetUrl", { enumerable: true, get: function () { return assets_1.resolvePublicAssetUrl; } });
+Object.defineProperty(exports, "rewriteArticleHtmlAssets", { enumerable: true, get: function () { return assets_1.rewriteArticleHtmlAssets; } });
+var excerpt_1 = require("./content/excerpt");
+Object.defineProperty(exports, "resolveArchiveExcerpt", { enumerable: true, get: function () { return excerpt_1.resolveArchiveExcerpt; } });
+Object.defineProperty(exports, "stripHtml", { enumerable: true, get: function () { return excerpt_1.stripHtml; } });
+Object.defineProperty(exports, "truncateWords", { enumerable: true, get: function () { return excerpt_1.truncateWords; } });
+var bootstrap_1 = require("./ssr/bootstrap");
+Object.defineProperty(exports, "createDefaultAppBootstrap", { enumerable: true, get: function () { return bootstrap_1.createDefaultAppBootstrap; } });
+Object.defineProperty(exports, "fetchAppBootstrap", { enumerable: true, get: function () { return bootstrap_1.fetchAppBootstrap; } });
+Object.defineProperty(exports, "fetchArchives", { enumerable: true, get: function () { return bootstrap_1.fetchArchives; } });
+Object.defineProperty(exports, "fetchCmsPage", { enumerable: true, get: function () { return bootstrap_1.fetchCmsPage; } });
+Object.defineProperty(exports, "fetchKnowledgeDetail", { enumerable: true, get: function () { return bootstrap_1.fetchKnowledgeDetail; } });
+Object.defineProperty(exports, "fetchKnowledgeList", { enumerable: true, get: function () { return bootstrap_1.fetchKnowledgeList; } });
+Object.defineProperty(exports, "fetchPublishedPages", { enumerable: true, get: function () { return bootstrap_1.fetchPublishedPages; } });
+Object.defineProperty(exports, "fetchRecommendArticles", { enumerable: true, get: function () { return bootstrap_1.fetchRecommendArticles; } });
+var slimBootstrap_1 = require("./ssr/slimBootstrap");
+Object.defineProperty(exports, "createBootstrapSlimmer", { enumerable: true, get: function () { return slimBootstrap_1.createBootstrapSlimmer; } });
+Object.defineProperty(exports, "slimAppBootstrapForRoute", { enumerable: true, get: function () { return slimBootstrap_1.slimAppBootstrapForRoute; } });
+var articleSlim_1 = require("./content/articleSlim");
+Object.defineProperty(exports, "slimArticleForCarousel", { enumerable: true, get: function () { return articleSlim_1.slimArticleForCarousel; } });
+Object.defineProperty(exports, "slimArticleForList", { enumerable: true, get: function () { return articleSlim_1.slimArticleForList; } });
+Object.defineProperty(exports, "slimArticlesForCarousel", { enumerable: true, get: function () { return articleSlim_1.slimArticlesForCarousel; } });
+Object.defineProperty(exports, "slimArticlesForList", { enumerable: true, get: function () { return articleSlim_1.slimArticlesForList; } });
+var archiveSlim_1 = require("./content/archiveSlim");
+Object.defineProperty(exports, "countArchiveArticles", { enumerable: true, get: function () { return archiveSlim_1.countArchiveArticles; } });
+Object.defineProperty(exports, "formatArchiveDay", { enumerable: true, get: function () { return archiveSlim_1.formatArchiveDay; } });
+Object.defineProperty(exports, "slimArchiveTree", { enumerable: true, get: function () { return archiveSlim_1.slimArchiveTree; } });
+Object.defineProperty(exports, "sortedArchiveYears", { enumerable: true, get: function () { return archiveSlim_1.sortedArchiveYears; } });
+var carouselArticles_1 = require("./content/carouselArticles");
+Object.defineProperty(exports, "resolveCarouselArticles", { enumerable: true, get: function () { return carouselArticles_1.resolveCarouselArticles; } });
+var pageProps_1 = require("./ssr/pageProps");
+Object.defineProperty(exports, "fetchArchivesPageProps", { enumerable: true, get: function () { return pageProps_1.fetchArchivesPageProps; } });
+Object.defineProperty(exports, "fetchArticleDetailProps", { enumerable: true, get: function () { return pageProps_1.fetchArticleDetailProps; } });
+Object.defineProperty(exports, "fetchCategoryArchivePageProps", { enumerable: true, get: function () { return pageProps_1.fetchCategoryArchivePageProps; } });
+Object.defineProperty(exports, "fetchCmsPageProps", { enumerable: true, get: function () { return pageProps_1.fetchCmsPageProps; } });
+Object.defineProperty(exports, "fetchHomePageProps", { enumerable: true, get: function () { return pageProps_1.fetchHomePageProps; } });
+Object.defineProperty(exports, "fetchKnowledgeBookPageProps", { enumerable: true, get: function () { return pageProps_1.fetchKnowledgeBookPageProps; } });
+Object.defineProperty(exports, "fetchKnowledgeChapterPageProps", { enumerable: true, get: function () { return pageProps_1.fetchKnowledgeChapterPageProps; } });
+Object.defineProperty(exports, "fetchKnowledgeIndexPageProps", { enumerable: true, get: function () { return pageProps_1.fetchKnowledgeIndexPageProps; } });
+Object.defineProperty(exports, "fetchSearchPageProps", { enumerable: true, get: function () { return pageProps_1.fetchSearchPageProps; } });
+Object.defineProperty(exports, "fetchTagArchivePageProps", { enumerable: true, get: function () { return pageProps_1.fetchTagArchivePageProps; } });
+var fetch_1 = require("./ssr/fetch");
+Object.defineProperty(exports, "createArchiveGetStaticProps", { enumerable: true, get: function () { return fetch_1.createArchiveGetStaticProps; } });
+Object.defineProperty(exports, "createDefaultVisitorContext", { enumerable: true, get: function () { return fetch_1.createDefaultVisitorContext; } });
+Object.defineProperty(exports, "fetchArticlePageProps", { enumerable: true, get: function () { return fetch_1.fetchArticlePageProps; } });
+Object.defineProperty(exports, "fetchCategoryArchive", { enumerable: true, get: function () { return fetch_1.fetchCategoryArchive; } });
+Object.defineProperty(exports, "fetchCategoryIndex", { enumerable: true, get: function () { return fetch_1.fetchCategoryIndex; } });
+Object.defineProperty(exports, "fetchSearchArticles", { enumerable: true, get: function () { return fetch_1.fetchSearchArticles; } });
+Object.defineProperty(exports, "fetchSingleArticle", { enumerable: true, get: function () { return fetch_1.fetchSingleArticle; } });
+Object.defineProperty(exports, "fetchSiteMeta", { enumerable: true, get: function () { return fetch_1.fetchSiteMeta; } });
+Object.defineProperty(exports, "fetchSiteSettings", { enumerable: true, get: function () { return fetch_1.fetchSiteSettings; } });
+Object.defineProperty(exports, "fetchTagArchive", { enumerable: true, get: function () { return fetch_1.fetchTagArchive; } });
+Object.defineProperty(exports, "fetchTagIndex", { enumerable: true, get: function () { return fetch_1.fetchTagIndex; } });
+Object.defineProperty(exports, "fetchThemeCatalog", { enumerable: true, get: function () { return fetch_1.fetchThemeCatalog; } });
+Object.defineProperty(exports, "fetchVisitorContext", { enumerable: true, get: function () { return fetch_1.fetchVisitorContext; } });
+Object.defineProperty(exports, "resolveStaticVisitorContext", { enumerable: true, get: function () { return fetch_1.resolveStaticVisitorContext; } });
+Object.defineProperty(exports, "sanitizeNextProps", { enumerable: true, get: function () { return fetch_1.sanitizeNextProps; } });
+Object.defineProperty(exports, "THEME_ISR_REVALIDATE_SECONDS", { enumerable: true, get: function () { return fetch_1.THEME_ISR_REVALIDATE_SECONDS; } });
+Object.defineProperty(exports, "themeStaticProps", { enumerable: true, get: function () { return fetch_1.themeStaticProps; } });
+Object.defineProperty(exports, "withApiRetry", { enumerable: true, get: function () { return fetch_1.withApiRetry; } });
+Object.defineProperty(exports, "withThemeStaticProps", { enumerable: true, get: function () { return fetch_1.withThemeStaticProps; } });
+var date_1 = require("../utils/date");
+Object.defineProperty(exports, "formatPublishDate", { enumerable: true, get: function () { return date_1.formatPublishDate; } });
+Object.defineProperty(exports, "formatPublishDateShort", { enumerable: true, get: function () { return date_1.formatPublishDateShort; } });
+var setting_1 = require("../utils/setting");
+Object.defineProperty(exports, "pickSiteSettings", { enumerable: true, get: function () { return setting_1.pickSiteSettings; } });
+var json_1 = require("../utils/json");
+Object.defineProperty(exports, "safeJsonParse", { enumerable: true, get: function () { return json_1.safeJsonParse; } });
+var image_1 = require("../utils/image");
+Object.defineProperty(exports, "resolveImageUrl", { enumerable: true, get: function () { return image_1.resolveImageUrl; } });
+var authSession_1 = require("./visitor/authSession");
+Object.defineProperty(exports, "ADMIN_AUTH_STORAGE_KEY", { enumerable: true, get: function () { return authSession_1.ADMIN_AUTH_STORAGE_KEY; } });
+Object.defineProperty(exports, "clearThemeSession", { enumerable: true, get: function () { return authSession_1.clearThemeSession; } });
+Object.defineProperty(exports, "getStoredAccessToken", { enumerable: true, get: function () { return authSession_1.getStoredAccessToken; } });
+Object.defineProperty(exports, "persistThemeSession", { enumerable: true, get: function () { return authSession_1.persistThemeSession; } });
+Object.defineProperty(exports, "resolveStoredUser", { enumerable: true, get: function () { return authSession_1.resolveStoredUser; } });
+Object.defineProperty(exports, "THEME_TOKEN_STORAGE_KEY", { enumerable: true, get: function () { return authSession_1.THEME_TOKEN_STORAGE_KEY; } });
+Object.defineProperty(exports, "THEME_USER_STORAGE_KEY", { enumerable: true, get: function () { return authSession_1.THEME_USER_STORAGE_KEY; } });
+var colorMode_1 = require("./visitor/colorMode");
+Object.defineProperty(exports, "applyColorModeClass", { enumerable: true, get: function () { return colorMode_1.applyColorModeClass; } });
+Object.defineProperty(exports, "buildColorModeInitScript", { enumerable: true, get: function () { return colorMode_1.buildColorModeInitScript; } });
+Object.defineProperty(exports, "COLOR_MODE_STORAGE_KEY", { enumerable: true, get: function () { return colorMode_1.COLOR_MODE_STORAGE_KEY; } });
+Object.defineProperty(exports, "colorModeInitScript", { enumerable: true, get: function () { return colorMode_1.colorModeInitScript; } });
+Object.defineProperty(exports, "persistColorMode", { enumerable: true, get: function () { return colorMode_1.persistColorMode; } });
+Object.defineProperty(exports, "resolveClientThemeMode", { enumerable: true, get: function () { return colorMode_1.resolveClientThemeMode; } });
+Object.defineProperty(exports, "resolveInitialColorModeState", { enumerable: true, get: function () { return colorMode_1.resolveInitialColorModeState; } });
+Object.defineProperty(exports, "resolvePreferredColorMode", { enumerable: true, get: function () { return colorMode_1.resolvePreferredColorMode; } });
+var visitorLocale_1 = require("./visitor/visitorLocale");
+Object.defineProperty(exports, "DEFAULT_VISITOR_LOCALES", { enumerable: true, get: function () { return visitorLocale_1.DEFAULT_VISITOR_LOCALES; } });
+Object.defineProperty(exports, "LEGACY_LOCALE_STORAGE_KEY", { enumerable: true, get: function () { return visitorLocale_1.LEGACY_LOCALE_STORAGE_KEY; } });
+Object.defineProperty(exports, "persistVisitorLocale", { enumerable: true, get: function () { return visitorLocale_1.persistVisitorLocale; } });
+Object.defineProperty(exports, "readBrowserCookie", { enumerable: true, get: function () { return visitorLocale_1.readBrowserCookie; } });
+Object.defineProperty(exports, "readRequestCookie", { enumerable: true, get: function () { return visitorLocale_1.readRequestCookie; } });
+Object.defineProperty(exports, "resolveVisitorLocale", { enumerable: true, get: function () { return visitorLocale_1.resolveVisitorLocale; } });
+Object.defineProperty(exports, "VISITOR_LOCALE_COOKIE", { enumerable: true, get: function () { return visitorLocale_1.VISITOR_LOCALE_COOKIE; } });
+var commentAuthor_1 = require("./visitor/commentAuthor");
+Object.defineProperty(exports, "COMMENT_AUTHOR_STORAGE_KEY", { enumerable: true, get: function () { return commentAuthor_1.COMMENT_AUTHOR_STORAGE_KEY; } });
+Object.defineProperty(exports, "COMMENT_EMAIL_REGEXP", { enumerable: true, get: function () { return commentAuthor_1.COMMENT_EMAIL_REGEXP; } });
+Object.defineProperty(exports, "getCommentEmailError", { enumerable: true, get: function () { return commentAuthor_1.getCommentEmailError; } });
+Object.defineProperty(exports, "isValidCommentAuthor", { enumerable: true, get: function () { return commentAuthor_1.isValidCommentAuthor; } });
+Object.defineProperty(exports, "isValidCommentEmail", { enumerable: true, get: function () { return commentAuthor_1.isValidCommentEmail; } });
+Object.defineProperty(exports, "persistCommentAuthor", { enumerable: true, get: function () { return commentAuthor_1.persistCommentAuthor; } });
+Object.defineProperty(exports, "readCommentAuthor", { enumerable: true, get: function () { return commentAuthor_1.readCommentAuthor; } });
+var seo_1 = require("./content/seo");
+Object.defineProperty(exports, "getPageTitle", { enumerable: true, get: function () { return seo_1.getPageTitle; } });
+Object.defineProperty(exports, "getSiteTitle", { enumerable: true, get: function () { return seo_1.getSiteTitle; } });
+var jsonp_1 = require("../utils/jsonp");
+Object.defineProperty(exports, "jsonp", { enumerable: true, get: function () { return jsonp_1.jsonp; } });
+var httpClient_1 = require("./api/httpClient");
+Object.defineProperty(exports, "createThemeAxiosClient", { enumerable: true, get: function () { return httpClient_1.createThemeAxiosClient; } });
+Object.defineProperty(exports, "encodeAxiosUrlPath", { enumerable: true, get: function () { return httpClient_1.encodeAxiosUrlPath; } });
+Object.defineProperty(exports, "resolveThemeAxiosBaseUrl", { enumerable: true, get: function () { return httpClient_1.resolveThemeAxiosBaseUrl; } });
+var locale_1 = require("./visitor/locale");
+Object.defineProperty(exports, "createTranslator", { enumerable: true, get: function () { return locale_1.createTranslator; } });
+Object.defineProperty(exports, "parseSiteLocale", { enumerable: true, get: function () { return locale_1.parseSiteLocale; } });
+Object.defineProperty(exports, "resolveRequestLocale", { enumerable: true, get: function () { return locale_1.resolveRequestLocale; } });
+var i18n_1 = require("./visitor/i18n");
+Object.defineProperty(exports, "mergeVisitorI18n", { enumerable: true, get: function () { return i18n_1.mergeVisitorI18n; } });
+Object.defineProperty(exports, "slimVisitorI18nForSsr", { enumerable: true, get: function () { return i18n_1.slimVisitorI18nForSsr; } });
+var nav_1 = require("./content/nav");
+Object.defineProperty(exports, "articlePath", { enumerable: true, get: function () { return nav_1.articlePath; } });
+Object.defineProperty(exports, "categoryPath", { enumerable: true, get: function () { return nav_1.categoryPath; } });
+Object.defineProperty(exports, "getNavActiveId", { enumerable: true, get: function () { return nav_1.getNavActiveId; } });
+Object.defineProperty(exports, "tagPath", { enumerable: true, get: function () { return nav_1.tagPath; } });
+var runtime_1 = require("./visitor/runtime");
+Object.defineProperty(exports, "resolveThemeRuntime", { enumerable: true, get: function () { return runtime_1.resolveThemeRuntime; } });
+var setting_2 = require("./ssr/setting");
+Object.defineProperty(exports, "DEFAULT_SITE_META", { enumerable: true, get: function () { return setting_2.DEFAULT_SITE_META; } });
+Object.defineProperty(exports, "parseSiteMeta", { enumerable: true, get: function () { return setting_2.parseSiteMeta; } });
+Object.defineProperty(exports, "unwrapSetting", { enumerable: true, get: function () { return setting_2.unwrapSetting; } });
+var providers_1 = require("./providers");
+Object.defineProperty(exports, "createThemeProviders", { enumerable: true, get: function () { return providers_1.createThemeProviders; } });
+var setup_1 = require("./providers/setup");
+Object.defineProperty(exports, "createThemeHttpStack", { enumerable: true, get: function () { return setup_1.createThemeHttpStack; } });
+var appearance_1 = require("./visitor/appearance");
+Object.defineProperty(exports, "defaultModsFromManifest", { enumerable: true, get: function () { return appearance_1.defaultModsFromManifest; } });
+__exportStar(require("./extension"), exports);
+var static_1 = require("./ssr/static");
+Object.defineProperty(exports, "themeNotFound", { enumerable: true, get: function () { return static_1.themeNotFound; } });
+Object.defineProperty(exports, "themeOnDemandPaths", { enumerable: true, get: function () { return static_1.themeOnDemandPaths; } });
+Object.defineProperty(exports, "themeStaticNotFound", { enumerable: true, get: function () { return static_1.themeStaticNotFound; } });
+var templates_1 = require("./ssr/templates");
+Object.defineProperty(exports, "DEFAULT_TEMPLATE_FILES", { enumerable: true, get: function () { return templates_1.DEFAULT_TEMPLATE_FILES; } });
+Object.defineProperty(exports, "resolveTemplateFiles", { enumerable: true, get: function () { return templates_1.resolveTemplateFiles; } });
+Object.defineProperty(exports, "ThemeTemplate", { enumerable: true, get: function () { return templates_1.ThemeTemplate; } });

package/dist/theme/setting.d.ts

@@ -0,0 +1,12 @@
+/** Unwrap `setting.findAll()` — API returns a single Setting row in the envelope. */
+export declare function unwrapSetting(response: unknown): Record<string, unknown> | null;
+export interface SiteMeta {
+    siteName: string;
+    siteDescription: string;
+    siteUrl?: string;
+    siteLogo?: string;
+    siteFavicon?: string;
+}
+export declare const DEFAULT_SITE_META: SiteMeta;
+/** Parse branding from an effective Setting row (mods overlay applied by API). */
+export declare function parseSiteMeta(row: Record<string, unknown> | null): SiteMeta;

package/dist/theme/setting.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_SITE_META = void 0;
+exports.unwrapSetting = unwrapSetting;
+exports.parseSiteMeta = parseSiteMeta;
+const api_data_1 = require("./api-data");
+/** Unwrap `setting.findAll()` — API returns a single Setting row in the envelope. */
+function unwrapSetting(response) {
+    const data = (0, api_data_1.unpackOne)(response);
+    if (data && typeof data === 'object' && !Array.isArray(data)) {
+        return data;
+    }
+    if (response && typeof response === 'object' && !Array.isArray(response)) {
+        const maybe = response;
+        if ('i18n' in maybe || 'globalSetting' in maybe || 'systemTitle' in maybe) {
+            return maybe;
+        }
+    }
+    return null;
+}
+exports.DEFAULT_SITE_META = {
+    siteName: 'ReactPress Site',
+    siteDescription: 'A ReactPress powered site',
+};
+/** Parse branding from an effective Setting row (mods overlay applied by API). */
+function parseSiteMeta(row) {
+    if (!row) {
+        return { ...exports.DEFAULT_SITE_META };
+    }
+    return {
+        siteName: String(row.systemTitle ?? 'ReactPress Site').trim() || exports.DEFAULT_SITE_META.siteName,
+        siteDescription: String(row.systemSubTitle ?? exports.DEFAULT_SITE_META.siteDescription).trim() ||
+            exports.DEFAULT_SITE_META.siteDescription,
+        siteUrl: row.systemUrl != null ? String(row.systemUrl).trim() || undefined : undefined,
+        siteLogo: row.systemLogo != null && String(row.systemLogo).trim()
+            ? String(row.systemLogo).trim()
+            : undefined,
+        siteFavicon: row.systemFavicon != null && String(row.systemFavicon).trim()
+            ? String(row.systemFavicon).trim()
+            : undefined,
+    };
+}

package/dist/theme/ssr/bootstrap.d.ts

@@ -0,0 +1,48 @@
+import type { IncomingMessage } from 'http';
+import type { ThemeApi } from '../api/api';
+import type { ThemeConfigurationSchema } from '../extension/configuration/types';
+import type { NextPreviewCtx } from '../extension/preview';
+import type { ThemeMods } from '../extension/theme';
+export interface AppBootstrapResult {
+    setting: Record<string, unknown>;
+    tags: unknown[];
+    categories: unknown[];
+    pages: unknown[];
+    i18n: Record<string, unknown>;
+    globalSetting: Record<string, unknown> | undefined;
+    siteConfig: Record<string, unknown>;
+    locales: string[];
+    initialLocale: string;
+    colorPrimary: string;
+    themeMods: ThemeMods;
+}
+export interface FetchAppBootstrapOptions {
+    api?: ThemeApi;
+    manifest?: {
+        id: string;
+        options?: ThemeConfigurationSchema;
+    };
+    ctx?: NextPreviewCtx;
+    /** Explicit request (e.g. App Router `cookies()` / `headers()` shim) for locale resolution. */
+    req?: IncomingMessage;
+}
+/** Safe defaults when the API is unreachable during dev startup or SSR. */
+export declare function createDefaultAppBootstrap(partial?: Partial<AppBootstrapResult>): AppBootstrapResult;
+/**
+ * SSR bootstrap for full-featured themes — setting, taxonomy, pages, preview mods.
+ * Call once from `_app.getInitialProps` or `createReactPressApp`.
+ */
+export declare function fetchAppBootstrap(options?: FetchAppBootstrapOptions): Promise<AppBootstrapResult>;
+/** Fetch helpers for pages not covered by `fetchThemeCatalog`. */
+export declare function fetchArchives(api?: ThemeApi): Promise<any>;
+export declare function fetchKnowledgeList(api?: ThemeApi, params?: Record<string, unknown>): Promise<unknown[]>;
+export declare function fetchPublishedPages(api?: ThemeApi): Promise<{
+    pages: unknown[];
+    total: number;
+}>;
+export declare function fetchCmsPage(api: ThemeApi | undefined, id: string): Promise<{
+    setting: Record<string, unknown> | null;
+    page: unknown;
+}>;
+export declare function fetchKnowledgeDetail(api: ThemeApi | undefined, id: string): Promise<any>;
+export declare function fetchRecommendArticles(api?: ThemeApi, articleId?: string): Promise<unknown[]>;

package/dist/theme/ssr/bootstrap.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDefaultAppBootstrap = createDefaultAppBootstrap;
+exports.fetchAppBootstrap = fetchAppBootstrap;
+exports.fetchArchives = fetchArchives;
+exports.fetchKnowledgeList = fetchKnowledgeList;
+exports.fetchPublishedPages = fetchPublishedPages;
+exports.fetchCmsPage = fetchCmsPage;
+exports.fetchKnowledgeDetail = fetchKnowledgeDetail;
+exports.fetchRecommendArticles = fetchRecommendArticles;
+const api_1 = require("../api/api");
+const api_data_1 = require("../api/api-data");
+const json_1 = require("../api/json");
+const preview_1 = require("../extension/preview");
+const httpClient_1 = require("../api/httpClient");
+const providers_1 = require("../providers");
+const visitorLocale_1 = require("../visitor/visitorLocale");
+const i18n_1 = require("../visitor/i18n");
+const visitorLocale_2 = require("../visitor/visitorLocale");
+const fetch_1 = require("./fetch");
+const setting_1 = require("./setting");
+/** Safe defaults when the API is unreachable during dev startup or SSR. */
+function createDefaultAppBootstrap(partial = {}) {
+    const i18n = (0, i18n_1.mergeVisitorI18n)({});
+    const locales = partial.locales ?? [...visitorLocale_2.DEFAULT_VISITOR_LOCALES];
+    return {
+        setting: {},
+        tags: [],
+        categories: [],
+        pages: [],
+        i18n,
+        globalSetting: undefined,
+        siteConfig: {},
+        locales,
+        initialLocale: partial.initialLocale ?? locales[0] ?? 'zh',
+        colorPrimary: '#f44336',
+        themeMods: {},
+        ...partial,
+    };
+}
+/**
+ * SSR bootstrap for full-featured themes — setting, taxonomy, pages, preview mods.
+ * Call once from `_app.getInitialProps` or `createReactPressApp`.
+ */
+async function fetchAppBootstrap(options = {}) {
+    const api = options.api ?? api_1.themeApi;
+    const http = (0, httpClient_1.createThemeAxiosClient)({ unwrapEnvelope: true });
+    const { SettingProvider, TagProvider, CategoryProvider, PageProvider } = (0, providers_1.createThemeProviders)(http);
+    const [setting, tags, categories, pagesResult] = await (0, fetch_1.withApiRetry)(() => Promise.all([
+        SettingProvider.getSetting(),
+        TagProvider.getTags({ articleStatus: 'publish' }),
+        CategoryProvider.getCategory({ articleStatus: 'publish' }),
+        PageProvider.getAllPublisedPages(),
+    ]));
+    const i18n = (0, i18n_1.mergeVisitorI18n)((0, json_1.safeJsonParse)(setting.i18n, {}));
+    const globalSettingRaw = (0, json_1.safeJsonParse)(setting.globalSetting, {});
+    const localeKeys = Object.keys(i18n);
+    const locale = (0, visitorLocale_1.resolveVisitorLocale)(localeKeys, (options.req ?? options.ctx?.req));
+    const globalSetting = (globalSettingRaw?.[locale] ?? undefined);
+    const preview = await (0, preview_1.resolveThemePreviewContext)({
+        globalSettingRaw,
+        setting: setting,
+        locale,
+        ctx: options.ctx,
+        manifest: options.manifest,
+        fetchDraft: async (token) => (0, preview_1.normalizePreviewDraftData)(await http.get((0, preview_1.previewDraftApiPath)(token))),
+    });
+    return {
+        setting: preview.setting,
+        tags,
+        categories,
+        pages: pagesResult[0] || [],
+        i18n,
+        globalSetting,
+        siteConfig: preview.siteConfig,
+        locales: localeKeys,
+        initialLocale: locale,
+        colorPrimary: preview.colorPrimary,
+        themeMods: preview.effectiveMods,
+    };
+}
+/** Fetch helpers for pages not covered by `fetchThemeCatalog`. */
+async function fetchArchives(api = api_1.themeApi) {
+    return api.article.getArchives();
+}
+async function fetchKnowledgeList(api = api_1.themeApi, params = {}) {
+    return (0, api_data_1.unpackPaginated)(await api.knowledge.findAll({ query: params }));
+}
+async function fetchPublishedPages(api = api_1.themeApi) {
+    const response = await api.page.findAll({ query: { status: 'publish' } });
+    const [pages, total] = (0, api_data_1.unpackPaginated)(response);
+    return {
+        pages: [...pages].sort((a, b) => -(a.order ?? 0) + (b.order ?? 0)),
+        total,
+    };
+}
+async function fetchCmsPage(api = api_1.themeApi, id) {
+    const row = (0, setting_1.unwrapSetting)(await api.setting.findAll());
+    const page = await api.page.findById(id);
+    return {
+        setting: row,
+        page: page,
+    };
+}
+async function fetchKnowledgeDetail(api = api_1.themeApi, id) {
+    return api.knowledge.findById(id);
+}
+async function fetchRecommendArticles(api = api_1.themeApi, articleId) {
+    return (0, api_data_1.unpackList)(await api.article.getRecommendArticles({
+        query: articleId ? { articleId } : {},
+    }));
+}

package/dist/theme/ssr/fetch.d.ts

@@ -0,0 +1,134 @@
+import type { ThemeApi } from '../api/api';
+import type { ParseSiteLocaleOptions } from '../visitor/locale';
+import type { ThemeRuntime } from '../visitor/runtime';
+import type { SiteMeta } from './setting';
+/** Default ISR interval for theme list/home pages. */
+export declare const THEME_ISR_REVALIDATE_SECONDS = 60;
+/** Retry SSR API calls during dev startup or flaky remote connections. */
+export declare function withApiRetry<T>(fn: () => Promise<T>, attempts?: number, delayMs?: number): Promise<T>;
+/** Articles, categories, and tags for home / toolkit demo pages. */
+export declare function fetchThemeCatalog(api: ThemeApi): Promise<{
+    articles: unknown[];
+    categories: unknown[];
+    tags: unknown[];
+}>;
+/** Strip `undefined` values so Next.js can serialize `getStaticProps` results. */
+export declare function sanitizeNextProps<T>(props: T): T;
+export declare function themeStaticProps<T extends Record<string, unknown>>(props: T, revalidate?: number): {
+    props: T;
+    revalidate: number;
+};
+/** Visitor context for `getStaticProps` — `_app.getInitialProps` does not run on SSR for static pages. */
+export declare function resolveStaticVisitorContext(): Promise<VisitorContextProps>;
+/** All categories — `getStaticProps` for `pages/category/index.tsx`. */
+export declare function fetchCategoryIndex(api: ThemeApi): Promise<{
+    categories: unknown[];
+}>;
+/** All tags — `getStaticProps` for `pages/tag/index.tsx`. */
+export declare function fetchTagIndex(api: ThemeApi): Promise<{
+    tags: unknown[];
+}>;
+/** Site settings for about/footer pages (`getStaticProps`). */
+export declare function fetchSiteSettings<T extends Record<string, {
+    key: string;
+    default: string;
+}>>(api: ThemeApi, schema: T): Promise<{
+    [K in keyof T]: string;
+}>;
+export interface FetchVisitorContextOptions extends ParseSiteLocaleOptions {
+    themeId: string;
+    honorPreview?: boolean;
+}
+/** Props for `ReactPressProvider` — fetch once in `_app.getInitialProps` or `getStaticProps`. */
+export interface VisitorContextProps {
+    locale: string;
+    locales: string[];
+    messages: Record<string, string>;
+    catalog: Record<string, Record<string, string>>;
+    themeId: string;
+    activeThemeId: string;
+    mods: ThemeRuntime['mods'];
+    isPreview: boolean;
+    /** Site settings (`systemTitle`, `systemSubTitle`, …) for branding fallbacks. */
+    siteMeta: SiteMeta;
+}
+/** Safe defaults when API is unreachable (still wraps pages in Provider). */
+export declare function createDefaultVisitorContext(themeId: string, partial?: Partial<VisitorContextProps>): VisitorContextProps;
+export declare function fetchVisitorContext(api: ThemeApi, options: FetchVisitorContextOptions): Promise<VisitorContextProps>;
+/** Common site meta from the Setting row (`systemTitle`, `systemSubTitle`, …). */
+export declare function fetchSiteMeta(api: ThemeApi): Promise<SiteMeta>;
+/** Category archive — `getStaticProps` for `pages/category/[category].tsx`. */
+export declare function fetchCategoryArchive(api: ThemeApi, category: string): Promise<{
+    category: string;
+    articles: unknown[];
+    categories: unknown[];
+}>;
+/** Tag archive — `getStaticProps` for `pages/tag/[tag].tsx`. */
+export declare function fetchTagArchive(api: ThemeApi, tag: string): Promise<{
+    tag: string;
+    articles: unknown[];
+    tags: unknown[];
+}>;
+/** Article shape returned by theme article detail pages. */
+export type ThemeArticlePage = {
+    id: string;
+    title: string;
+    summary?: string;
+    html?: string;
+    cover?: string;
+    publishAt?: string;
+    views?: number;
+    category?: {
+        label: string;
+        value: string;
+    };
+    tags?: Array<{
+        label: string;
+        value: string;
+    }>;
+};
+/** Single article — `getStaticProps` for `pages/article/[id].tsx`. */
+export declare function fetchSingleArticle(api: ThemeApi, id: string): Promise<{
+    article: ThemeArticlePage | null;
+}>;
+/** Site search — `getServerSideProps` / `getStaticProps` helper. */
+export declare function fetchSearchArticles(api: ThemeApi, keyword: string): Promise<{
+    query: string;
+    articles: Array<{
+        id: string;
+        title: string;
+        summary?: string;
+        publishAt?: string;
+        category?: {
+            label: string;
+            value: string;
+        };
+    }>;
+}>;
+export type ThemeArchiveKind = 'category' | 'tag';
+type StaticPropsContext = {
+    params?: Record<string, string | string[] | undefined>;
+};
+/**
+ * Wrap `getStaticProps` fetchers with consistent logging and ISR fallback props.
+ */
+export declare function withThemeStaticProps<T extends Record<string, unknown>>(label: string, fetchFn: () => Promise<T>, fallback: T | ((error: unknown) => T)): Promise<{
+    props: T & {
+        reactPress: VisitorContextProps;
+    };
+    revalidate: number;
+}>;
+/** Factory for category/tag archive pages — removes duplicated `getStaticProps` boilerplate. */
+export declare function createArchiveGetStaticProps<T extends Record<string, unknown>>(kind: ThemeArchiveKind, fetchArchive: (api: ThemeApi, slug: string) => Promise<T>, emptyFallback: (slug: string) => T): (ctx: StaticPropsContext) => Promise<{
+    notFound: true;
+} | {
+    props: T & {
+        reactPress: VisitorContextProps;
+    };
+    revalidate: number;
+}>;
+/** Standard on-demand article page props. */
+export declare function fetchArticlePageProps(api: ThemeApi, id: string | undefined): Promise<{
+    article: ThemeArticlePage | null;
+}>;
+export {};