@fecommunity/reactpress 4.0.0-beta.1 → 4.0.0-beta.10

package/toolkit/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/toolkit/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/toolkit/dist/theme/ssr/pageProps.js

@@ -0,0 +1,155 @@
+"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 assets_1 = require("../content/assets");
+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 or path slug (admin → 页面). */
+async function fetchCmsPageProps(api, idOrPath) {
+    if (!idOrPath?.trim())
+        return { page: null };
+    const raw = (0, api_data_1.unpackOne)(await api.page.findById(idOrPath.trim()));
+    if (!raw || raw.status !== 'publish')
+        return { page: null };
+    return {
+        page: {
+            id: raw.id,
+            name: raw.name,
+            path: raw.path,
+            html: raw.html ? (0, assets_1.rewriteArticleHtmlAssets)(raw.html) : raw.html,
+            toc: raw.toc,
+            status: raw.status,
+            publishAt: raw.publishAt,
+            views: raw.views,
+        },
+    };
+}
+/** 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/toolkit/dist/theme/ssr/setting.js

@@ -0,0 +1,45 @@
+"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,
+        siteKeywords: row.seoKeyword != null && String(row.seoKeyword).trim()
+            ? String(row.seoKeyword).trim()
+            : undefined,
+        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/toolkit/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/toolkit/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 };
+}

package/toolkit/dist/theme/ssr/templates.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_TEMPLATE_FILES = exports.ThemeTemplate = void 0;
+exports.resolveTemplateFiles = resolveTemplateFiles;
+/**
+ * WordPress-style template hierarchy → Next.js Pages Router paths.
+ * @see https://developer.wordpress.org/themes/basics/template-hierarchy/
+ */
+exports.ThemeTemplate = {
+    /** Site front page / blog index */
+    HOME: 'home',
+    /** Single post */
+    SINGLE: 'single',
+    /** Static page */
+    PAGE: 'page',
+    /** Category archive */
+    ARCHIVE_CATEGORY: 'archive-category',
+    /** Tag archive */
+    ARCHIVE_TAG: 'archive-tag',
+    /** Search results */
+    SEARCH: 'search',
+    /** Post archives by date */
+    ARCHIVES: 'archives',
+    /** Knowledge base index */
+    KNOWLEDGE: 'knowledge',
+    /** URL navigation hub */
+    NAV: 'nav',
+    /** Login page */
+    LOGIN: 'login',
+    /** 404 */
+    NOT_FOUND: '404',
+};
+/** Default file mapping (override in `theme.json` → `templates`). */
+exports.DEFAULT_TEMPLATE_FILES = {
+    [exports.ThemeTemplate.HOME]: 'pages/index.tsx',
+    [exports.ThemeTemplate.SINGLE]: 'pages/article/[id].tsx',
+    [exports.ThemeTemplate.PAGE]: 'pages/[path].tsx',
+    [exports.ThemeTemplate.ARCHIVE_CATEGORY]: 'pages/category/[category].tsx',
+    [exports.ThemeTemplate.ARCHIVE_TAG]: 'pages/tag/[tag].tsx',
+    [exports.ThemeTemplate.SEARCH]: 'pages/search.tsx',
+    [exports.ThemeTemplate.ARCHIVES]: 'pages/archives/index.tsx',
+    [exports.ThemeTemplate.KNOWLEDGE]: 'pages/knowledge/index.tsx',
+    [exports.ThemeTemplate.NAV]: 'pages/nav/index.tsx',
+    [exports.ThemeTemplate.LOGIN]: 'pages/login/index.tsx',
+    [exports.ThemeTemplate.NOT_FOUND]: 'pages/404.tsx',
+};
+function resolveTemplateFiles(manifest) {
+    const custom = manifest?.templates ?? {};
+    return { ...exports.DEFAULT_TEMPLATE_FILES, ...custom };
+}

package/toolkit/dist/theme/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 };
+}

package/toolkit/dist/theme/templates.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_TEMPLATE_FILES = exports.ThemeTemplate = void 0;
+exports.resolveTemplateFiles = resolveTemplateFiles;
+/**
+ * WordPress-style template hierarchy → Next.js Pages Router paths.
+ * @see https://developer.wordpress.org/themes/basics/template-hierarchy/
+ */
+exports.ThemeTemplate = {
+    /** Site front page / blog index */
+    HOME: 'home',
+    /** Single post */
+    SINGLE: 'single',
+    /** Static page */
+    PAGE: 'page',
+    /** Category archive */
+    ARCHIVE_CATEGORY: 'archive-category',
+    /** Tag archive */
+    ARCHIVE_TAG: 'archive-tag',
+    /** Search results */
+    SEARCH: 'search',
+    /** 404 */
+    NOT_FOUND: '404',
+};
+/** Default file mapping (override in `theme.json` → `templates`). */
+exports.DEFAULT_TEMPLATE_FILES = {
+    [exports.ThemeTemplate.HOME]: 'pages/index.tsx',
+    [exports.ThemeTemplate.SINGLE]: 'pages/article/[id].tsx',
+    [exports.ThemeTemplate.PAGE]: 'pages/about.tsx',
+    [exports.ThemeTemplate.ARCHIVE_CATEGORY]: 'pages/category/[category].tsx',
+    [exports.ThemeTemplate.ARCHIVE_TAG]: 'pages/tag/[tag].tsx',
+    [exports.ThemeTemplate.SEARCH]: 'pages/search.tsx',
+    [exports.ThemeTemplate.NOT_FOUND]: 'pages/404.tsx',
+};
+function resolveTemplateFiles(manifest) {
+    const custom = manifest?.templates ?? {};
+    return { ...exports.DEFAULT_TEMPLATE_FILES, ...custom };
+}