@fecommunity/reactpress-toolkit 3.0.0 → 3.1.0

package/dist/theme/ssr/fetch.js

@@ -0,0 +1,264 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.THEME_ISR_REVALIDATE_SECONDS = void 0;
+exports.withApiRetry = withApiRetry;
+exports.fetchThemeCatalog = fetchThemeCatalog;
+exports.sanitizeNextProps = sanitizeNextProps;
+exports.themeStaticProps = themeStaticProps;
+exports.resolveStaticVisitorContext = resolveStaticVisitorContext;
+exports.fetchCategoryIndex = fetchCategoryIndex;
+exports.fetchTagIndex = fetchTagIndex;
+exports.fetchSiteSettings = fetchSiteSettings;
+exports.createDefaultVisitorContext = createDefaultVisitorContext;
+exports.fetchVisitorContext = fetchVisitorContext;
+exports.fetchSiteMeta = fetchSiteMeta;
+exports.fetchCategoryArchive = fetchCategoryArchive;
+exports.fetchTagArchive = fetchTagArchive;
+exports.fetchSingleArticle = fetchSingleArticle;
+exports.fetchSearchArticles = fetchSearchArticles;
+exports.withThemeStaticProps = withThemeStaticProps;
+exports.createArchiveGetStaticProps = createArchiveGetStaticProps;
+exports.fetchArticlePageProps = fetchArticlePageProps;
+const api_1 = require("../api/api");
+const api_data_1 = require("../api/api-data");
+const assets_1 = require("../content/assets");
+const format_1 = require("./format");
+const json_1 = require("../api/json");
+const locale_1 = require("../visitor/locale");
+const runtime_1 = require("../visitor/runtime");
+const setting_1 = require("./setting");
+const static_1 = require("./static");
+/** Default ISR interval for theme list/home pages. */
+exports.THEME_ISR_REVALIDATE_SECONDS = 60;
+function isConnectionRefused(error) {
+    const err = error;
+    return err?.code === 'ECONNREFUSED' || err?.cause?.code === 'ECONNREFUSED';
+}
+function isRetryableNetworkError(error) {
+    if (isConnectionRefused(error))
+        return true;
+    const err = error;
+    const code = err?.code || err?.cause?.code;
+    const message = `${err?.message || ''} ${err?.cause?.message || ''}`.toLowerCase();
+    return (code === 'ECONNRESET' ||
+        code === 'ETIMEDOUT' ||
+        code === 'EPIPE' ||
+        message.includes('socket hang up') ||
+        message.includes('network error') ||
+        message.includes('timeout'));
+}
+/** Retry SSR API calls during dev startup or flaky remote connections. */
+async function withApiRetry(fn, attempts = 8, delayMs = 400) {
+    let lastError;
+    for (let i = 0; i < attempts; i += 1) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            if (!isRetryableNetworkError(error) || i >= attempts - 1) {
+                throw error;
+            }
+            await new Promise((resolve) => {
+                setTimeout(resolve, delayMs);
+            });
+        }
+    }
+    throw lastError;
+}
+/** Articles, categories, and tags for home / toolkit demo pages. */
+async function fetchThemeCatalog(api) {
+    return withApiRetry(async () => {
+        const [articlesResponse, categoriesResponse, tagsResponse] = await Promise.all([
+            api.article.findAll(),
+            api.category.findAll(),
+            api.tag.findAll(),
+        ]);
+        return {
+            articles: (0, api_data_1.unpackPaginated)(articlesResponse),
+            categories: (0, api_data_1.unpackList)(categoriesResponse),
+            tags: (0, api_data_1.unpackList)(tagsResponse),
+        };
+    });
+}
+/** Strip `undefined` values so Next.js can serialize `getStaticProps` results. */
+function sanitizeNextProps(props) {
+    return JSON.parse(JSON.stringify(props));
+}
+function themeStaticProps(props, revalidate = exports.THEME_ISR_REVALIDATE_SECONDS) {
+    return { props: sanitizeNextProps(props), revalidate };
+}
+let staticVisitorContextPromise = null;
+let staticVisitorContextKey = '';
+/** Visitor context for `getStaticProps` — `_app.getInitialProps` does not run on SSR for static pages. */
+async function resolveStaticVisitorContext() {
+    const themeId = process.env.REACTPRESS_THEME_ID?.trim() || 'starter-theme';
+    const honorPreview = process.env.REACTPRESS_HONOR_PREVIEW === '1';
+    const cacheKey = `${themeId}:${honorPreview ? '1' : '0'}`;
+    if (staticVisitorContextPromise && staticVisitorContextKey === cacheKey) {
+        return staticVisitorContextPromise;
+    }
+    staticVisitorContextKey = cacheKey;
+    staticVisitorContextPromise = (async () => {
+        try {
+            return await fetchVisitorContext(api_1.themeApi, { themeId, honorPreview });
+        }
+        catch (error) {
+            const code = error?.code
+                ?? error?.cause?.code;
+            if (code !== 'ECONNREFUSED') {
+                console.error('[reactpress] resolveStaticVisitorContext failed', error);
+            }
+            return createDefaultVisitorContext(themeId);
+        }
+    })();
+    return staticVisitorContextPromise;
+}
+/** All categories — `getStaticProps` for `pages/category/index.tsx`. */
+async function fetchCategoryIndex(api) {
+    return { categories: (0, api_data_1.unpackList)(await api.category.findAll()) };
+}
+/** All tags — `getStaticProps` for `pages/tag/index.tsx`. */
+async function fetchTagIndex(api) {
+    return { tags: (0, api_data_1.unpackList)(await api.tag.findAll()) };
+}
+/** Site settings for about/footer pages (`getStaticProps`). */
+async function fetchSiteSettings(api, schema) {
+    const rows = (0, api_data_1.unpackList)(await api.setting.findAll());
+    return (0, format_1.pickSiteSettings)(rows, schema);
+}
+/** Safe defaults when API is unreachable (still wraps pages in Provider). */
+function createDefaultVisitorContext(themeId, partial = {}) {
+    return {
+        locale: 'zh',
+        locales: ['zh', 'en'],
+        messages: {},
+        catalog: {},
+        themeId,
+        activeThemeId: themeId,
+        mods: {},
+        isPreview: false,
+        siteMeta: setting_1.DEFAULT_SITE_META,
+        ...partial,
+    };
+}
+async function fetchVisitorContext(api, options) {
+    if (!api?.setting?.findAll) {
+        throw new Error('fetchVisitorContext: invalid ThemeApi instance');
+    }
+    return withApiRetry(async () => {
+        const row = (0, setting_1.unwrapSetting)(await api.setting.findAll());
+        const localeState = (0, locale_1.parseSiteLocale)(row?.i18n, {
+            locale: options.locale,
+            fallbackLocale: options.fallbackLocale,
+            preferredLocale: options.preferredLocale,
+            acceptLanguage: options.acceptLanguage,
+        });
+        const globalSetting = (0, json_1.safeJsonParse)(row?.globalSetting, {});
+        const runtime = (0, runtime_1.resolveThemeRuntime)(globalSetting, {
+            themeId: options.themeId,
+            honorPreview: options.honorPreview,
+        });
+        const siteMeta = (0, setting_1.parseSiteMeta)(row);
+        return {
+            locale: localeState.locale,
+            locales: localeState.locales,
+            messages: localeState.messages,
+            catalog: localeState.catalog,
+            themeId: runtime.themeId,
+            activeThemeId: runtime.activeThemeId,
+            mods: runtime.mods,
+            isPreview: runtime.isPreview,
+            siteMeta,
+        };
+    });
+}
+/** Common site meta from the Setting row (`systemTitle`, `systemSubTitle`, …). */
+async function fetchSiteMeta(api) {
+    return withApiRetry(async () => {
+        const row = (0, setting_1.unwrapSetting)(await api.setting.findAll());
+        return (0, setting_1.parseSiteMeta)(row);
+    });
+}
+/** Category archive — `getStaticProps` for `pages/category/[category].tsx`. */
+async function fetchCategoryArchive(api, category) {
+    const [articlesResponse, categoriesResponse] = await Promise.all([
+        api.article.findArticlesByCategory(category),
+        api.category.findAll(),
+    ]);
+    return {
+        category,
+        articles: (0, api_data_1.unpackPaginated)(articlesResponse),
+        categories: (0, api_data_1.unpackList)(categoriesResponse),
+    };
+}
+/** Tag archive — `getStaticProps` for `pages/tag/[tag].tsx`. */
+async function fetchTagArchive(api, tag) {
+    const [articlesResponse, tagsResponse] = await Promise.all([
+        api.article.findArticlesByTag(tag),
+        api.tag.findAll(),
+    ]);
+    return {
+        tag,
+        articles: (0, api_data_1.unpackPaginated)(articlesResponse),
+        tags: (0, api_data_1.unpackList)(tagsResponse),
+    };
+}
+/** Single article — `getStaticProps` for `pages/article/[id].tsx`. */
+async function fetchSingleArticle(api, id) {
+    const articleResponse = await api.article.findById(id);
+    return { article: (0, api_data_1.unpackOne)(articleResponse) };
+}
+/** Site search — `getServerSideProps` / `getStaticProps` helper. */
+async function fetchSearchArticles(api, keyword) {
+    if (!keyword.trim()) {
+        return { query: '', articles: [] };
+    }
+    const searchResponse = await api.search.searchArticle({
+        query: { keyword: keyword.trim() },
+    });
+    return {
+        query: keyword.trim(),
+        articles: (0, api_data_1.unpackList)(searchResponse),
+    };
+}
+/**
+ * Wrap `getStaticProps` fetchers with consistent logging and ISR fallback props.
+ */
+async function withThemeStaticProps(label, fetchFn, fallback) {
+    const reactPress = await resolveStaticVisitorContext();
+    try {
+        const data = await withApiRetry(fetchFn);
+        return themeStaticProps({ ...data, reactPress });
+    }
+    catch (error) {
+        console.error(`[reactpress] ${label}`, error);
+        const props = typeof fallback === 'function' ? fallback(error) : fallback;
+        return themeStaticProps({ ...props, reactPress });
+    }
+}
+/** Factory for category/tag archive pages — removes duplicated `getStaticProps` boilerplate. */
+function createArchiveGetStaticProps(kind, fetchArchive, emptyFallback) {
+    return async (ctx) => {
+        const slug = ctx.params?.[kind];
+        if (typeof slug !== 'string' || !slug)
+            return (0, static_1.themeNotFound)();
+        return withThemeStaticProps(`fetch ${kind} archive failed`, () => fetchArchive(api_1.themeApi, slug), () => emptyFallback(slug));
+    };
+}
+/** Standard on-demand article page props. */
+async function fetchArticlePageProps(api, id) {
+    if (!id)
+        return { article: null };
+    const data = await fetchSingleArticle(api, id);
+    const article = data.article ?? null;
+    if (!article)
+        return { article: null };
+    return {
+        article: {
+            ...article,
+            html: article.html ? (0, assets_1.rewriteArticleHtmlAssets)(article.html) : article.html,
+            cover: article.cover ? (0, assets_1.resolvePublicAssetUrl)(article.cover) : article.cover,
+        },
+    };
+}

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

@@ -0,0 +1,3 @@
+export { formatPublishDate, formatPublishDateShort, } from '../../utils/date';
+export type { SettingRow } from '../../utils/setting';
+export { pickSiteSettings } from '../../utils/setting';

package/dist/theme/ssr/format.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pickSiteSettings = exports.formatPublishDateShort = exports.formatPublishDate = void 0;
+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; } });

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

@@ -0,0 +1,62 @@
+import type { ThemeApi } from '../api/api';
+import { type CarouselArticle, type ListArticle } from '../content/articleSlim';
+import { type ArchiveTree } from '../content/archiveSlim';
+import type { IArticle, ICategory, IKnowledge, ITag } from '../../types';
+export type HomePageProps = {
+    articles: ListArticle[];
+    total: number;
+    recommendedArticles: CarouselArticle[];
+};
+export type CategoryArchivePageProps = {
+    articles: ListArticle[];
+    total: number;
+    category: Pick<ICategory, 'value' | 'label'> & Partial<ICategory>;
+};
+export type TagArchivePageProps = {
+    articles: ListArticle[];
+    total: number;
+    tag: Pick<ITag, 'value' | 'label'> & Partial<ITag>;
+};
+export type KnowledgeIndexPageProps = {
+    books: IKnowledge[];
+    total: number;
+};
+export type SearchPageProps = {
+    keyword: string;
+    articles: IArticle[];
+};
+/** Home / blog index — first page of articles + carousel recommendations. */
+export declare function fetchHomePageProps(api?: ThemeApi, pageSize?: number): Promise<HomePageProps>;
+/** Category archive — paginated list with taxonomy metadata. */
+export declare function fetchCategoryArchivePageProps(api: ThemeApi, categoryValue: string, pageSize?: number): Promise<CategoryArchivePageProps>;
+/** Tag archive — paginated list with taxonomy metadata. */
+export declare function fetchTagArchivePageProps(api: ThemeApi, tagValue: string, pageSize?: number): Promise<TagArchivePageProps>;
+/** Archives tree — year/month grouped article index. */
+export declare function fetchArchivesPageProps(api?: ThemeApi): Promise<{
+    articles: ArchiveTree;
+}>;
+/** Knowledge library index — first page. */
+export declare function fetchKnowledgeIndexPageProps(api?: ThemeApi, pageSize?: number): Promise<KnowledgeIndexPageProps>;
+/** Knowledge book detail with sibling books for sidebar. */
+export declare function fetchKnowledgeBookPageProps(api: ThemeApi, pId: string): Promise<{
+    pId: string;
+    book: IKnowledge | null;
+    otherBooks: IKnowledge[];
+}>;
+/** Knowledge chapter detail. */
+export declare function fetchKnowledgeChapterPageProps(api: ThemeApi, pId: string, id: string): Promise<{
+    pId: string;
+    book: IKnowledge | null;
+    id: string;
+    chapter: IKnowledge | null;
+}>;
+/** Site search results for `/search?keyword=`. */
+export declare function fetchSearchPageProps(api: ThemeApi, keyword: string): Promise<SearchPageProps>;
+/** CMS static page by id. */
+export declare function fetchCmsPageProps(api: ThemeApi, id: string): Promise<{
+    page: unknown;
+}>;
+/** Single article by id (full entity from API). */
+export declare function fetchArticleDetailProps(api: ThemeApi, id: string): Promise<{
+    article: IArticle | null;
+}>;

package/dist/theme/ssr/pageProps.js

@@ -0,0 +1,138 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchHomePageProps = fetchHomePageProps;
+exports.fetchCategoryArchivePageProps = fetchCategoryArchivePageProps;
+exports.fetchTagArchivePageProps = fetchTagArchivePageProps;
+exports.fetchArchivesPageProps = fetchArchivesPageProps;
+exports.fetchKnowledgeIndexPageProps = fetchKnowledgeIndexPageProps;
+exports.fetchKnowledgeBookPageProps = fetchKnowledgeBookPageProps;
+exports.fetchKnowledgeChapterPageProps = fetchKnowledgeChapterPageProps;
+exports.fetchSearchPageProps = fetchSearchPageProps;
+exports.fetchCmsPageProps = fetchCmsPageProps;
+exports.fetchArticleDetailProps = fetchArticleDetailProps;
+const api_1 = require("../api/api");
+const api_data_1 = require("../api/api-data");
+const articleSlim_1 = require("../content/articleSlim");
+const archiveSlim_1 = require("../content/archiveSlim");
+const carouselArticles_1 = require("../content/carouselArticles");
+const fetch_1 = require("./fetch");
+const DEFAULT_PAGE_SIZE = 12;
+function fallbackCategory(value) {
+    return { value, label: value };
+}
+function fallbackTag(value) {
+    return { value, label: value };
+}
+/** Home / blog index — first page of articles + carousel recommendations. */
+async function fetchHomePageProps(api = api_1.themeApi, pageSize = DEFAULT_PAGE_SIZE) {
+    return (0, fetch_1.withApiRetry)(async () => {
+        const response = await api.article.findAll({
+            query: { page: 1, pageSize, status: 'publish' },
+        });
+        const [rawArticles, total] = (0, api_data_1.unpackPaginatedPair)(response);
+        const recommendedArticles = await (0, carouselArticles_1.resolveCarouselArticles)(rawArticles, {
+            fetchRecommended: async () => (0, api_data_1.unpackList)(await api.article.getRecommendArticles({})),
+        });
+        return {
+            articles: (0, articleSlim_1.slimArticlesForList)(rawArticles),
+            total,
+            recommendedArticles,
+        };
+    });
+}
+/** Category archive — paginated list with taxonomy metadata. */
+async function fetchCategoryArchivePageProps(api, categoryValue, pageSize = DEFAULT_PAGE_SIZE) {
+    const [articlesResponse, categoryResponse] = await Promise.all([
+        api.article.findArticlesByCategory(categoryValue, {
+            query: { page: 1, pageSize, status: 'publish' },
+        }),
+        api.category.findById(categoryValue),
+    ]);
+    const [rawArticles, total] = (0, api_data_1.unpackPaginatedPair)(articlesResponse);
+    const category = (0, api_data_1.unpackOne)(categoryResponse) ?? fallbackCategory(categoryValue);
+    return {
+        articles: (0, articleSlim_1.slimArticlesForList)(rawArticles),
+        total,
+        category,
+    };
+}
+/** Tag archive — paginated list with taxonomy metadata. */
+async function fetchTagArchivePageProps(api, tagValue, pageSize = DEFAULT_PAGE_SIZE) {
+    const [articlesResponse, tagResponse] = await Promise.all([
+        api.article.findArticlesByTag(tagValue, {
+            query: { page: 1, pageSize, status: 'publish' },
+        }),
+        api.tag.findById(tagValue),
+    ]);
+    const [rawArticles, total] = (0, api_data_1.unpackPaginatedPair)(articlesResponse);
+    const tag = (0, api_data_1.unpackOne)(tagResponse) ?? fallbackTag(tagValue);
+    return {
+        articles: (0, articleSlim_1.slimArticlesForList)(rawArticles),
+        total,
+        tag,
+    };
+}
+/** Archives tree — year/month grouped article index. */
+async function fetchArchivesPageProps(api = api_1.themeApi) {
+    const response = await api.article.getArchives({});
+    const raw = (0, api_data_1.unpackOne)(response) ??
+        response;
+    return {
+        articles: (0, archiveSlim_1.slimArchiveTree)(raw ?? {}),
+    };
+}
+/** Knowledge library index — first page. */
+async function fetchKnowledgeIndexPageProps(api = api_1.themeApi, pageSize = DEFAULT_PAGE_SIZE) {
+    const response = await api.knowledge.findAll({
+        query: { page: 1, pageSize, status: 'publish' },
+    });
+    const [books, total] = (0, api_data_1.unpackPaginatedPair)(response);
+    return { books, total };
+}
+/** Knowledge book detail with sibling books for sidebar. */
+async function fetchKnowledgeBookPageProps(api, pId) {
+    const [bookResponse, listResponse] = await Promise.all([
+        api.knowledge.findById(pId),
+        api.knowledge.findAll({ query: { page: 1, pageSize: 6, status: 'publish' } }),
+    ]);
+    const book = (0, api_data_1.unpackOne)(bookResponse);
+    const [allBooks] = (0, api_data_1.unpackPaginatedPair)(listResponse);
+    return {
+        pId,
+        book,
+        otherBooks: book ? allBooks.filter((item) => item.id !== book.id) : allBooks,
+    };
+}
+/** Knowledge chapter detail. */
+async function fetchKnowledgeChapterPageProps(api, pId, id) {
+    const [bookResponse, chapterResponse] = await Promise.all([
+        api.knowledge.findById(pId),
+        api.knowledge.findById(id),
+    ]);
+    return {
+        pId,
+        book: (0, api_data_1.unpackOne)(bookResponse),
+        id,
+        chapter: (0, api_data_1.unpackOne)(chapterResponse),
+    };
+}
+/** Site search results for `/search?keyword=`. */
+async function fetchSearchPageProps(api, keyword) {
+    const trimmed = keyword.trim();
+    if (!trimmed) {
+        return { keyword: '', articles: [] };
+    }
+    const response = await api.search.searchArticle({
+        query: { keyword: trimmed },
+    });
+    const articles = (0, api_data_1.unpackList)(response).filter((article) => article.status === 'publish');
+    return { keyword: trimmed, articles };
+}
+/** CMS static page by id. */
+async function fetchCmsPageProps(api, id) {
+    return { page: (0, api_data_1.unpackOne)(await api.page.findById(id)) };
+}
+/** Single article by id (full entity from API). */
+async function fetchArticleDetailProps(api, id) {
+    return { article: (0, api_data_1.unpackOne)(await api.article.findById(id)) };
+}

package/dist/theme/ssr/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/ssr/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/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/slimBootstrap.d.ts

@@ -0,0 +1,11 @@
+import type { AppBootstrapResult } from './bootstrap';
+export type SlimBootstrapOptions = {
+    /** Routes that receive full `siteConfig` and `globalSetting`. Default: `/nav` prefix. */
+    fullSiteConfigRoutes?: string[] | ((pathname: string) => boolean);
+    /** Keys stripped from `setting` in SSR payload. */
+    settingOmitKeys?: readonly string[];
+};
+/** Shrink `_app` SSR payload — drop duplicate JSON blobs and heavy site config on list pages. */
+export declare function slimAppBootstrapForRoute(bootstrap: AppBootstrapResult, pathname: string, options?: SlimBootstrapOptions): AppBootstrapResult;
+/** Preset slimmer for catalog themes with `/nav` pages (Twenty Twenty-Five pattern). */
+export declare function createBootstrapSlimmer(options?: SlimBootstrapOptions): (bootstrap: AppBootstrapResult, pathname: string) => AppBootstrapResult;

package/dist/theme/ssr/slimBootstrap.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.slimAppBootstrapForRoute = slimAppBootstrapForRoute;
+exports.createBootstrapSlimmer = createBootstrapSlimmer;
+const i18n_1 = require("../visitor/i18n");
+const DEFAULT_SETTING_OMIT_KEYS = [
+    'i18n',
+    'globalSetting',
+    'adminSystemUrl',
+    'oss',
+    'smtpHost',
+    'smtpPort',
+    'smtpUser',
+    'smtpPass',
+    'smtpFromUser',
+    'createAt',
+    'updateAt',
+];
+function slimTags(tags) {
+    return tags.map(({ id, label, value, articleCount }) => ({
+        id,
+        label,
+        value,
+        articleCount,
+    }));
+}
+function slimCategories(categories) {
+    return categories.map(({ value, label }) => ({ value, label }));
+}
+function slimPages(pages) {
+    return pages.map(({ path, name }) => ({ path, name }));
+}
+function slimSetting(setting, omitKeys) {
+    const next = { ...setting };
+    for (const key of omitKeys) {
+        delete next[key];
+    }
+    return next;
+}
+function defaultFullSiteConfigRoute(pathname) {
+    return pathname === '/nav' || pathname.startsWith('/nav/');
+}
+function resolveFullSiteConfigRoute(pathname, options) {
+    const matcher = options?.fullSiteConfigRoutes ?? defaultFullSiteConfigRoute;
+    return typeof matcher === 'function' ? matcher(pathname) : matcher.some((route) => {
+        if (route.endsWith('*')) {
+            const prefix = route.slice(0, -1);
+            return pathname === prefix || pathname.startsWith(prefix);
+        }
+        return pathname === route || pathname.startsWith(`${route}/`);
+    });
+}
+/** Shrink `_app` SSR payload — drop duplicate JSON blobs and heavy site config on list pages. */
+function slimAppBootstrapForRoute(bootstrap, pathname, options) {
+    const fullSiteConfig = resolveFullSiteConfigRoute(pathname, options);
+    const omitKeys = options?.settingOmitKeys ?? DEFAULT_SETTING_OMIT_KEYS;
+    let siteConfig = bootstrap.siteConfig;
+    if (!fullSiteConfig) {
+        siteConfig = bootstrap.siteConfig?.header ? { header: bootstrap.siteConfig.header } : {};
+    }
+    return {
+        ...bootstrap,
+        setting: slimSetting(bootstrap.setting, omitKeys),
+        tags: slimTags(bootstrap.tags),
+        categories: slimCategories(bootstrap.categories),
+        pages: slimPages(bootstrap.pages),
+        i18n: (0, i18n_1.slimVisitorI18nForSsr)(bootstrap.i18n, bootstrap.initialLocale),
+        siteConfig,
+        globalSetting: fullSiteConfig ? bootstrap.globalSetting : undefined,
+    };
+}
+/** Preset slimmer for catalog themes with `/nav` pages (Twenty Twenty-Five pattern). */
+function createBootstrapSlimmer(options) {
+    return (bootstrap, pathname) => slimAppBootstrapForRoute(bootstrap, pathname, options);
+}

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

@@ -0,0 +1,10 @@
+import type { GetStaticPathsResult } from 'next';
+/** WordPress-style on-demand ISR paths (`fallback: true`). */
+export declare const themeOnDemandPaths: GetStaticPathsResult;
+export declare function themeNotFound(): {
+    notFound: true;
+};
+export declare function themeStaticNotFound(revalidate?: number): {
+    notFound: true;
+    revalidate: number;
+};

package/dist/theme/ssr/static.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.themeOnDemandPaths = void 0;
+exports.themeNotFound = themeNotFound;
+exports.themeStaticNotFound = themeStaticNotFound;
+const fetch_1 = require("./fetch");
+/** WordPress-style on-demand ISR paths (`fallback: true`). */
+exports.themeOnDemandPaths = {
+    paths: [],
+    fallback: true,
+};
+function themeNotFound() {
+    return { notFound: true };
+}
+function themeStaticNotFound(revalidate = fetch_1.THEME_ISR_REVALIDATE_SECONDS) {
+    return { notFound: true, revalidate };
+}