@fecommunity/reactpress-toolkit 3.0.4 → 3.7.0

package/dist/theme/visitor/visitorLocale.d.ts

@@ -0,0 +1,11 @@
+import type { IncomingMessage } from 'http';
+import { readRequestCookie } from '../../utils/cookie';
+export declare const VISITOR_LOCALE_COOKIE = "reactpress-locale";
+export declare const LEGACY_LOCALE_STORAGE_KEY = "locale";
+/** Fallback when CMS locales are unavailable (e.g. `_document` before bootstrap). */
+export declare const DEFAULT_VISITOR_LOCALES: readonly ["zh", "en"];
+export { readRequestCookie };
+/** Read a visitor cookie in the browser (client `getInitialProps`, hydration). */
+export declare function readBrowserCookie(name: string): string | undefined;
+export declare function resolveVisitorLocale(supported: string[], req?: IncomingMessage): string;
+export declare function persistVisitorLocale(locale: string): void;

package/dist/theme/visitor/visitorLocale.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readRequestCookie = exports.DEFAULT_VISITOR_LOCALES = exports.LEGACY_LOCALE_STORAGE_KEY = exports.VISITOR_LOCALE_COOKIE = void 0;
+exports.readBrowserCookie = readBrowserCookie;
+exports.resolveVisitorLocale = resolveVisitorLocale;
+exports.persistVisitorLocale = persistVisitorLocale;
+const cookie_1 = require("../../utils/cookie");
+Object.defineProperty(exports, "readRequestCookie", { enumerable: true, get: function () { return cookie_1.readRequestCookie; } });
+const locale_1 = require("./locale");
+exports.VISITOR_LOCALE_COOKIE = 'reactpress-locale';
+exports.LEGACY_LOCALE_STORAGE_KEY = 'locale';
+/** Fallback when CMS locales are unavailable (e.g. `_document` before bootstrap). */
+exports.DEFAULT_VISITOR_LOCALES = ['zh', 'en'];
+function readCookieFromHeader(header, name) {
+    const match = new RegExp(`(?:^|;\\s*)${name}=([^;]*)`).exec(header);
+    if (!match?.[1])
+        return undefined;
+    try {
+        return decodeURIComponent(match[1]);
+    }
+    catch {
+        return match[1];
+    }
+}
+/** Read a visitor cookie in the browser (client `getInitialProps`, hydration). */
+function readBrowserCookie(name) {
+    if (typeof document === 'undefined')
+        return undefined;
+    return readCookieFromHeader(document.cookie, name);
+}
+function resolveVisitorLocale(supported, req) {
+    const locales = supported.length ? supported : ['zh', 'en'];
+    const preferred = (0, cookie_1.readRequestCookie)(req, exports.VISITOR_LOCALE_COOKIE) ||
+        (0, cookie_1.readRequestCookie)(req, exports.LEGACY_LOCALE_STORAGE_KEY) ||
+        readBrowserCookie(exports.VISITOR_LOCALE_COOKIE) ||
+        readBrowserCookie(exports.LEGACY_LOCALE_STORAGE_KEY);
+    let acceptLanguage;
+    if (typeof req?.headers?.['accept-language'] === 'string') {
+        acceptLanguage = req.headers['accept-language'];
+    }
+    else if (typeof navigator !== 'undefined' && navigator.language) {
+        acceptLanguage = navigator.language;
+    }
+    return (0, locale_1.resolveRequestLocale)(locales, {
+        preferred,
+        acceptLanguage,
+        fallback: locales.includes('zh') ? 'zh' : locales[0] ?? 'zh',
+    });
+}
+function persistVisitorLocale(locale) {
+    if (typeof window === 'undefined')
+        return;
+    window.localStorage.setItem(exports.LEGACY_LOCALE_STORAGE_KEY, locale);
+    window.localStorage.setItem(exports.VISITOR_LOCALE_COOKIE, locale);
+    document.cookie = `${exports.VISITOR_LOCALE_COOKIE}=${encodeURIComponent(locale)}; path=/; max-age=31536000; SameSite=Lax`;
+}

package/dist/theme/visitorLocale.d.ts

@@ -0,0 +1,6 @@
+import type { IncomingMessage } from 'http';
+export declare const VISITOR_LOCALE_COOKIE = "reactpress-locale";
+export declare const LEGACY_LOCALE_STORAGE_KEY = "locale";
+export declare function readRequestCookie(req: IncomingMessage | undefined, name: string): string | undefined;
+export declare function resolveVisitorLocale(supported: string[], req?: IncomingMessage): string;
+export declare function persistVisitorLocale(locale: string): void;

package/dist/theme/visitorLocale.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LEGACY_LOCALE_STORAGE_KEY = exports.VISITOR_LOCALE_COOKIE = void 0;
+exports.readRequestCookie = readRequestCookie;
+exports.resolveVisitorLocale = resolveVisitorLocale;
+exports.persistVisitorLocale = persistVisitorLocale;
+const locale_1 = require("./locale");
+exports.VISITOR_LOCALE_COOKIE = 'reactpress-locale';
+exports.LEGACY_LOCALE_STORAGE_KEY = 'locale';
+function readRequestCookie(req, name) {
+    const header = req?.headers?.cookie ?? '';
+    const match = new RegExp(`(?:^|;\\s*)${name}=([^;]*)`).exec(header);
+    if (!match?.[1])
+        return undefined;
+    try {
+        return decodeURIComponent(match[1]);
+    }
+    catch {
+        return match[1];
+    }
+}
+function resolveVisitorLocale(supported, req) {
+    const locales = supported.length ? supported : ['zh', 'en'];
+    return (0, locale_1.resolveRequestLocale)(locales, {
+        preferred: readRequestCookie(req, exports.VISITOR_LOCALE_COOKIE) ||
+            readRequestCookie(req, exports.LEGACY_LOCALE_STORAGE_KEY),
+        acceptLanguage: typeof req?.headers?.['accept-language'] === 'string'
+            ? req.headers['accept-language']
+            : undefined,
+        fallback: locales.includes('zh') ? 'zh' : locales[0] ?? 'zh',
+    });
+}
+function persistVisitorLocale(locale) {
+    if (typeof window === 'undefined')
+        return;
+    window.localStorage.setItem(exports.LEGACY_LOCALE_STORAGE_KEY, locale);
+    window.localStorage.setItem(exports.VISITOR_LOCALE_COOKIE, locale);
+    document.cookie = `${exports.VISITOR_LOCALE_COOKIE}=${encodeURIComponent(locale)}; path=/; max-age=31536000; SameSite=Lax`;
+}

package/dist/types/index.d.ts

@@ -23,6 +23,9 @@ export interface ISetting {
     systemFavicon: string;
     systemNoticeInfo: string;
     systemFooterInfo: string;
+    aboutUsGithubUrl: string;
+    aboutUsCommentQr: string;
+    aboutUsWechatQr: string;
     adminSystemUrl: string;
     baiduAnalyticsId: string;
     googleAnalyticsId: string;
@@ -49,6 +52,13 @@ export interface I_SMTP {
     /** @format date-time */
     createAt: string;
 }
+export interface IFileVariant {
+    url: string;
+    filename: string;
+    width: number;
+    height: number;
+    size: number;
+}
 export interface IFile {
     id: string;
     originalname: string;
@@ -56,6 +66,7 @@ export interface IFile {
     type: string;
     size: number;
     url: string;
+    variants?: Record<string, IFileVariant>;
     /** @format date-time */
     createAt: string;
 }
@@ -175,71 +186,71 @@ export interface IView {
     /** @format date-time */
     updateAt: string;
 }
-export declare type IUserControllerFindAllData = IUser[];
-export declare type IUserControllerRegisterData = IUser[];
-export declare type IUserControllerUpdateData = IUser[];
-export declare type IUserControllerUpdatePasswordData = IUser[];
-export declare type IAuthControllerLoginData = any;
-export declare type IAuthControllerCreateBookData = any;
-export declare type IAuthControllerLoginWithGithubData = any;
-export declare type ISettingControllerUpdateData = ISetting[];
-export declare type ISettingControllerFindAllData = any;
-export declare type ISmtpControllerCreateData = I_SMTP[];
-export declare type ISmtpControllerFindAllData = any;
-export declare type ISmtpControllerDeleteByIdData = any;
-export declare type IFileControllerUploadFileData = IFile[];
-export declare type IFileControllerFindAllData = any;
-export declare type IFileControllerFindByIdData = any;
-export declare type IFileControllerDeleteByIdData = any;
-export declare type ITagControllerCreateData = ITag[];
-export declare type ITagControllerFindAllData = any;
-export declare type ITagControllerFindByIdData = any;
-export declare type ITagControllerUpdateByIdData = any;
-export declare type ITagControllerDeleteByIdData = any;
-export declare type ITagControllerGetArticleByIdData = any;
-export declare type IArticleControllerCreateData = IArticle[];
-export declare type IArticleControllerFindAllData = any;
-export declare type IArticleControllerFindArticlesByCategoryData = any;
-export declare type IArticleControllerFindArticlesByTagData = any;
-export declare type IArticleControllerGetRecommendArticlesData = any;
-export declare type IArticleControllerGetArchivesData = any;
-export declare type IArticleControllerRecommendData = any;
-export declare type IArticleControllerFindByIdData = any;
-export declare type IArticleControllerUpdateByIdData = any;
-export declare type IArticleControllerDeleteByIdData = any;
-export declare type IArticleControllerCheckPasswordData = any;
-export declare type IArticleControllerUpdateViewsByIdData = any;
-export declare type IArticleControllerUpdateLikesByIdData = any;
-export declare type ICategoryControllerCreateData = ICategory[];
-export declare type ICategoryControllerFindAllData = any;
-export declare type ICategoryControllerFindByIdData = any;
-export declare type ICategoryControllerUpdateByIdData = any;
-export declare type ICategoryControllerDeleteByIdData = any;
-export declare type IKnowledgeControllerCreateBookData = IKnowledge[];
-export declare type IKnowledgeControllerCreateChapterData = IKnowledge[];
-export declare type IKnowledgeControllerDeleteByIdData = any;
-export declare type IKnowledgeControllerUpdateByIdData = any;
-export declare type IKnowledgeControllerFindByIdData = any;
-export declare type IKnowledgeControllerFindAllData = any;
-export declare type IKnowledgeControllerUpdateViewsByIdData = any;
-export declare type IKnowledgeControllerUpdateLikesByIdData = any;
-export declare type ICommentControllerCreateData = IComment[];
-export declare type ICommentControllerFindAllData = any;
-export declare type ICommentControllerFindByIdData = any;
-export declare type ICommentControllerUpdateByIdData = any;
-export declare type ICommentControllerDeleteByIdData = any;
-export declare type ICommentControllerGetArticleCommentsData = any;
-export declare type IPageControllerCreateData = IPage[];
-export declare type IPageControllerFindAllData = any;
-export declare type IPageControllerFindByIdData = any;
-export declare type IPageControllerUpdateByIdData = any;
-export declare type IPageControllerDeleteByIdData = any;
-export declare type IPageControllerUpdateViewsByIdData = any;
-export declare type IViewControllerCreateData = IView[];
-export declare type IViewControllerFindAllData = any;
-export declare type IViewControllerFindByUrlData = any;
-export declare type IViewControllerFindByIdData = any;
-export declare type IViewControllerDeleteByIdData = any;
-export declare type ISearchControllerSearchArticleData = any;
-export declare type ISearchControllerFindAllData = any;
-export declare type ISearchControllerDeleteByIdData = any;
+export type IUserControllerFindAllData = IUser[];
+export type IUserControllerRegisterData = IUser[];
+export type IUserControllerUpdateData = IUser[];
+export type IUserControllerUpdatePasswordData = IUser[];
+export type IAuthControllerLoginData = any;
+export type IAuthControllerCreateBookData = any;
+export type IAuthControllerLoginWithGithubData = any;
+export type ISettingControllerUpdateData = ISetting[];
+export type ISettingControllerFindAllData = any;
+export type ISmtpControllerCreateData = I_SMTP[];
+export type ISmtpControllerFindAllData = any;
+export type ISmtpControllerDeleteByIdData = any;
+export type IFileControllerUploadFileData = IFile[];
+export type IFileControllerFindAllData = any;
+export type IFileControllerFindByIdData = any;
+export type IFileControllerDeleteByIdData = any;
+export type ITagControllerCreateData = ITag[];
+export type ITagControllerFindAllData = any;
+export type ITagControllerFindByIdData = any;
+export type ITagControllerUpdateByIdData = any;
+export type ITagControllerDeleteByIdData = any;
+export type ITagControllerGetArticleByIdData = any;
+export type IArticleControllerCreateData = IArticle[];
+export type IArticleControllerFindAllData = any;
+export type IArticleControllerFindArticlesByCategoryData = any;
+export type IArticleControllerFindArticlesByTagData = any;
+export type IArticleControllerGetRecommendArticlesData = any;
+export type IArticleControllerGetArchivesData = any;
+export type IArticleControllerRecommendData = any;
+export type IArticleControllerFindByIdData = any;
+export type IArticleControllerUpdateByIdData = any;
+export type IArticleControllerDeleteByIdData = any;
+export type IArticleControllerCheckPasswordData = any;
+export type IArticleControllerUpdateViewsByIdData = any;
+export type IArticleControllerUpdateLikesByIdData = any;
+export type ICategoryControllerCreateData = ICategory[];
+export type ICategoryControllerFindAllData = any;
+export type ICategoryControllerFindByIdData = any;
+export type ICategoryControllerUpdateByIdData = any;
+export type ICategoryControllerDeleteByIdData = any;
+export type IKnowledgeControllerCreateBookData = IKnowledge[];
+export type IKnowledgeControllerCreateChapterData = IKnowledge[];
+export type IKnowledgeControllerDeleteByIdData = any;
+export type IKnowledgeControllerUpdateByIdData = any;
+export type IKnowledgeControllerFindByIdData = any;
+export type IKnowledgeControllerFindAllData = any;
+export type IKnowledgeControllerUpdateViewsByIdData = any;
+export type IKnowledgeControllerUpdateLikesByIdData = any;
+export type ICommentControllerCreateData = IComment[];
+export type ICommentControllerFindAllData = any;
+export type ICommentControllerFindByIdData = any;
+export type ICommentControllerUpdateByIdData = any;
+export type ICommentControllerDeleteByIdData = any;
+export type ICommentControllerGetArticleCommentsData = any;
+export type IPageControllerCreateData = IPage[];
+export type IPageControllerFindAllData = any;
+export type IPageControllerFindByIdData = any;
+export type IPageControllerUpdateByIdData = any;
+export type IPageControllerDeleteByIdData = any;
+export type IPageControllerUpdateViewsByIdData = any;
+export type IViewControllerCreateData = IView[];
+export type IViewControllerFindAllData = any;
+export type IViewControllerFindByUrlData = any;
+export type IViewControllerFindByIdData = any;
+export type IViewControllerDeleteByIdData = any;
+export type ISearchControllerSearchArticleData = any;
+export type ISearchControllerFindAllData = any;
+export type ISearchControllerDeleteByIdData = any;

package/dist/ui/AntdStyleTransitionFix.d.ts

@@ -0,0 +1,5 @@
+export interface AntdStyleTransitionFixProps {
+    id?: string;
+}
+/** Disable Ant Design CSS transitions during hydration to avoid style flash. */
+export declare function AntdStyleTransitionFix({ id, }: AntdStyleTransitionFixProps): import("react/jsx-runtime").JSX.Element;

package/dist/ui/AntdStyleTransitionFix.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AntdStyleTransitionFix = AntdStyleTransitionFix;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const STYLE_ELEMENT_ID = 'reactpress-antd-style-transition-fix';
+/** Disable Ant Design CSS transitions during hydration to avoid style flash. */
+function AntdStyleTransitionFix({ id = STYLE_ELEMENT_ID, }) {
+    (0, react_1.useEffect)(() => {
+        const el = document.querySelector(`#${id}`);
+        el?.parentNode?.removeChild(el);
+    }, [id]);
+    return ((0, jsx_runtime_1.jsx)("style", { id: id, dangerouslySetInnerHTML: {
+            __html: `[class^="ant-"], [class*=" ant-"] { transition: none !important; }`,
+        } }));
+}

package/dist/ui/ArchiveEmptyState.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+export interface ArchiveEmptyStateProps {
+    message: React.ReactNode;
+    backHref?: string;
+    backLabel?: React.ReactNode;
+    className?: string;
+    renderBackLink?: (props: {
+        href: string;
+        label: React.ReactNode;
+    }) => React.ReactNode;
+}
+/** Headless empty archive/search state with optional back link slot. */
+export declare function ArchiveEmptyState({ message, backHref, backLabel, className, renderBackLink, }: ArchiveEmptyStateProps): import("react/jsx-runtime").JSX.Element;

package/dist/ui/ArchiveEmptyState.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArchiveEmptyState = ArchiveEmptyState;
+const jsx_runtime_1 = require("react/jsx-runtime");
+/** Headless empty archive/search state with optional back link slot. */
+function ArchiveEmptyState({ message, backHref = '/', backLabel = '← Back to archives', className = 'empty-state', renderBackLink, }) {
+    return ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)("p", { className: className, "data-rp-component": "archive-empty", children: message }), renderBackLink ? ((0, jsx_runtime_1.jsx)("p", { children: renderBackLink({ href: backHref, label: backLabel }) })) : null] }));
+}

package/dist/ui/ArchivePageLayout.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+export interface ArchivePageLayoutProps {
+    main: React.ReactNode;
+    sidebar?: React.ReactNode;
+    className?: string;
+    mainClassName?: string;
+    sidebarClassName?: string;
+}
+/** Two-column archive layout (main list + sidebar widgets). */
+export declare function ArchivePageLayout({ main, sidebar, className, mainClassName, sidebarClassName, }: ArchivePageLayoutProps): import("react/jsx-runtime").JSX.Element;

package/dist/ui/ArchivePageLayout.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArchivePageLayout = ArchivePageLayout;
+const jsx_runtime_1 = require("react/jsx-runtime");
+/** Two-column archive layout (main list + sidebar widgets). */
+function ArchivePageLayout({ main, sidebar, className = 'content-layout', mainClassName = 'articles-section', sidebarClassName = 'sidebar', }) {
+    return ((0, jsx_runtime_1.jsxs)("div", { className: className, "data-rp-component": "archive-layout", children: [(0, jsx_runtime_1.jsx)("section", { className: mainClassName, children: main }), sidebar ? (0, jsx_runtime_1.jsx)("aside", { className: sidebarClassName, children: sidebar }) : null] }));
+}

package/dist/ui/ArticleCard.d.ts

@@ -0,0 +1,27 @@
+import React from 'react';
+export interface ArticleCardArticle {
+    id: string;
+    title: string;
+    summary?: string;
+    cover?: string;
+    publishAt?: string;
+    category?: {
+        label: string;
+        value: string;
+    };
+}
+export interface ArticleCardLinkProps {
+    href: string;
+    children: React.ReactNode;
+}
+export interface ArticleCardProps {
+    article: ArticleCardArticle;
+    className?: string;
+    titleTag?: 'h2' | 'h3';
+    showCategory?: boolean;
+    renderTitleLink: (props: ArticleCardLinkProps) => React.ReactNode;
+    renderCategoryLink?: (props: ArticleCardLinkProps) => React.ReactNode;
+    renderDate?: (publishAt: string) => React.ReactNode;
+}
+/** Headless article card — theme supplies Link markup and CSS. */
+export declare function ArticleCard({ article, className, titleTag, showCategory, renderTitleLink, renderCategoryLink, renderDate, }: ArticleCardProps): import("react/jsx-runtime").JSX.Element;

package/dist/ui/ArticleCard.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArticleCard = ArticleCard;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const format_1 = require("../theme/format");
+const nav_1 = require("../theme/nav");
+/** Headless article card — theme supplies Link markup and CSS. */
+function ArticleCard({ article, className, titleTag = 'h3', showCategory = true, renderTitleLink, renderCategoryLink, renderDate, }) {
+    const TitleTag = titleTag;
+    const dateNode = article.publishAt &&
+        (renderDate ? renderDate(article.publishAt) : (0, format_1.formatPublishDate)(article.publishAt));
+    return ((0, jsx_runtime_1.jsxs)("article", { className: className, "data-rp-component": "article-card", children: [article.cover ? ((0, jsx_runtime_1.jsx)("div", { className: "article-image", "data-rp-part": "cover", children: (0, jsx_runtime_1.jsx)("img", { src: article.cover, alt: article.title, loading: "lazy" }) })) : null, (0, jsx_runtime_1.jsxs)("div", { className: "article-content", "data-rp-part": "content", children: [(0, jsx_runtime_1.jsx)(TitleTag, { className: "article-title", children: renderTitleLink({ href: (0, nav_1.articlePath)(article.id), children: article.title }) }), article.summary ? (0, jsx_runtime_1.jsx)("p", { className: "article-summary", children: article.summary }) : null, dateNode || (showCategory && article.category && renderCategoryLink) ? ((0, jsx_runtime_1.jsxs)("div", { className: "article-meta", children: [dateNode ? (0, jsx_runtime_1.jsx)("span", { className: "publish-date", children: dateNode }) : null, showCategory && article.category && renderCategoryLink ? ((0, jsx_runtime_1.jsx)("span", { className: "article-category", children: renderCategoryLink({
+                                    href: (0, nav_1.categoryPath)(article.category.value),
+                                    children: article.category.label,
+                                }) })) : null] })) : null] })] }));
+}

package/dist/ui/ArticleList.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+export interface ArticleListProps<T extends {
+    id: string;
+}> {
+    articles: T[];
+    limit?: number;
+    className?: string;
+    empty?: React.ReactNode;
+    renderArticle: (article: T, index: number) => React.ReactNode;
+}
+/** Headless article grid/list — theme supplies markup and styles per item. */
+export declare function ArticleList<T extends {
+    id: string;
+}>({ articles, limit, className, empty, renderArticle, }: ArticleListProps<T>): import("react/jsx-runtime").JSX.Element;

package/dist/ui/ArticleList.js

@@ -0,0 +1,16 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArticleList = ArticleList;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = __importDefault(require("react"));
+/** Headless article grid/list — theme supplies markup and styles per item. */
+function ArticleList({ articles, limit, className, empty = null, renderArticle, }) {
+    const list = limit != null ? articles.slice(0, limit) : articles;
+    if (!list.length) {
+        return (0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: empty });
+    }
+    return ((0, jsx_runtime_1.jsx)("div", { className: className, "data-rp-component": "article-list", children: list.map((article, index) => ((0, jsx_runtime_1.jsx)(react_1.default.Fragment, { children: renderArticle(article, index) }, article.id))) }));
+}

package/dist/ui/BaseGlobalStyles.d.ts

@@ -0,0 +1,5 @@
+export interface BaseGlobalStylesProps {
+    extra?: string;
+}
+/** Shared reset used by starter themes (override via `extra` CSS). */
+export declare function BaseGlobalStyles({ extra }: BaseGlobalStylesProps): import("react/jsx-runtime").JSX.Element;

package/dist/ui/BaseGlobalStyles.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseGlobalStyles = BaseGlobalStyles;
+const jsx_runtime_1 = require("react/jsx-runtime");
+/** Shared reset used by starter themes (override via `extra` CSS). */
+function BaseGlobalStyles({ extra }) {
+    const css = `
+    html, body {
+      padding: 0;
+      margin: 0;
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu,
+        Cantarell, 'Open Sans', 'Helvetica Neue', sans-serif;
+    }
+    * { box-sizing: border-box; }
+    ${extra ?? ''}
+  `;
+    return (0, jsx_runtime_1.jsx)("style", { dangerouslySetInnerHTML: { __html: css } });
+}

package/dist/ui/LocaleSwitcher.d.ts

@@ -0,0 +1,7 @@
+export interface LocaleSwitcherProps {
+    className?: string;
+    buttonClassName?: string;
+    activeClassName?: string;
+}
+/** Minimal locale toggle — style with theme CSS. */
+export declare function LocaleSwitcher({ className, buttonClassName, activeClassName, }: LocaleSwitcherProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/ui/LocaleSwitcher.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocaleSwitcher = LocaleSwitcher;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const LocaleContext_1 = require("./context/LocaleContext");
+/** Minimal locale toggle — style with theme CSS. */
+function LocaleSwitcher({ className, buttonClassName, activeClassName, }) {
+    const { locale, locales, setLocale } = (0, LocaleContext_1.useLocale)();
+    if (locales.length < 2) {
+        return null;
+    }
+    return ((0, jsx_runtime_1.jsx)("div", { className: className, "data-rp-component": "locale-switcher", role: "group", "aria-label": "Language", children: locales.map((code) => ((0, jsx_runtime_1.jsx)("button", { type: "button", className: locale === code && activeClassName
+                ? `${buttonClassName ?? ''} ${activeClassName}`.trim()
+                : buttonClassName, "aria-pressed": locale === code, onClick: () => setLocale(code), children: code.toUpperCase() }, code))) }));
+}

package/dist/ui/NavMenu.d.ts

@@ -0,0 +1,16 @@
+import React from 'react';
+import type { NavItem } from '../theme/nav';
+export interface NavMenuRenderLinkProps {
+    item: NavItem;
+    active: boolean;
+}
+export interface NavMenuProps {
+    items: NavItem[];
+    activeId?: string;
+    className?: string;
+    listClassName?: string;
+    itemClassName?: string;
+    renderLink: (props: NavMenuRenderLinkProps) => React.ReactNode;
+}
+/** Headless site navigation — styling via theme `renderLink` (e.g. Next.js `Link`). */
+export declare function NavMenu({ items, activeId, className, listClassName, itemClassName, renderLink, }: NavMenuProps): import("react/jsx-runtime").JSX.Element;

package/dist/ui/NavMenu.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NavMenu = NavMenu;
+const jsx_runtime_1 = require("react/jsx-runtime");
+/** Headless site navigation — styling via theme `renderLink` (e.g. Next.js `Link`). */
+function NavMenu({ items, activeId, className, listClassName, itemClassName, renderLink, }) {
+    return ((0, jsx_runtime_1.jsx)("nav", { className: className, "data-rp-component": "nav", "aria-label": "Site", children: (0, jsx_runtime_1.jsx)("ul", { className: listClassName, children: items.map((item) => ((0, jsx_runtime_1.jsx)("li", { className: itemClassName, children: renderLink({ item, active: item.id === activeId }) }, item.id))) }) }));
+}

package/dist/ui/NotFoundPanel.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+export interface NotFoundPanelProps {
+    title?: React.ReactNode;
+    subtitle?: React.ReactNode;
+    description?: React.ReactNode;
+    illustration?: React.ReactNode;
+    actions?: React.ReactNode;
+    className?: string;
+}
+/** Headless 404 / not-found content block (theme supplies styles). */
+export declare function NotFoundPanel({ title, subtitle, description, illustration, actions, className, }: NotFoundPanelProps): import("react/jsx-runtime").JSX.Element;

package/dist/ui/NotFoundPanel.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotFoundPanel = NotFoundPanel;
+const jsx_runtime_1 = require("react/jsx-runtime");
+/** Headless 404 / not-found content block (theme supplies styles). */
+function NotFoundPanel({ title = 'Not found', subtitle, description, illustration, actions, className, }) {
+    return ((0, jsx_runtime_1.jsxs)("div", { className: className, "data-rp-component": "not-found-panel", children: [illustration ? (0, jsx_runtime_1.jsx)("div", { "data-rp-part": "illustration", children: illustration }) : null, (0, jsx_runtime_1.jsx)("h1", { "data-rp-part": "title", children: title }), subtitle != null && subtitle !== '' ? (0, jsx_runtime_1.jsx)("h2", { "data-rp-part": "subtitle", children: subtitle }) : null, description != null && description !== '' ? ((0, jsx_runtime_1.jsx)("p", { "data-rp-part": "description", children: description })) : null, actions ? (0, jsx_runtime_1.jsx)("div", { "data-rp-part": "actions", children: actions }) : null] }));
+}

package/dist/ui/PageHeader.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+export interface PageHeaderProps {
+    title: React.ReactNode;
+    description?: React.ReactNode;
+    className?: string;
+    titleClassName?: string;
+    descriptionClassName?: string;
+}
+/** Unstyled archive / page title block (WP `the_archive_title` pattern). */
+export declare function PageHeader({ title, description, className, titleClassName, descriptionClassName, }: PageHeaderProps): import("react/jsx-runtime").JSX.Element;

package/dist/ui/PageHeader.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PageHeader = PageHeader;
+const jsx_runtime_1 = require("react/jsx-runtime");
+/** Unstyled archive / page title block (WP `the_archive_title` pattern). */
+function PageHeader({ title, description, className, titleClassName, descriptionClassName, }) {
+    return ((0, jsx_runtime_1.jsxs)("header", { className: className, "data-rp-component": "page-header", children: [(0, jsx_runtime_1.jsx)("h1", { className: titleClassName, children: title }), description != null && description !== '' ? ((0, jsx_runtime_1.jsx)("p", { className: descriptionClassName, children: description })) : null] }));
+}

package/dist/ui/SiteBranding.d.ts

@@ -0,0 +1,10 @@
+export interface SiteBrandingProps {
+    /** Last-resort title when customizer mod and site settings are both empty. */
+    fallback?: string;
+    className?: string;
+    as?: 'h1' | 'span' | 'div';
+}
+/**
+ * Site title: customizer `displayTitle` when set, otherwise `systemTitle` from site settings.
+ */
+export declare function SiteBranding({ fallback, className, as: Tag }: SiteBrandingProps): import("react/jsx-runtime").JSX.Element;

package/dist/ui/SiteBranding.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SiteBranding = SiteBranding;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const ThemeRuntimeContext_1 = require("./context/ThemeRuntimeContext");
+/**
+ * Site title: customizer `displayTitle` when set, otherwise `systemTitle` from site settings.
+ */
+function SiteBranding({ fallback = '', className, as: Tag = 'span' }) {
+    const mod = (0, ThemeRuntimeContext_1.useThemeMod)('displayTitle', '');
+    const { siteName } = (0, ThemeRuntimeContext_1.useSiteMeta)();
+    const title = mod.trim() || siteName.trim() || fallback;
+    return (0, jsx_runtime_1.jsx)(Tag, { className: className, children: title });
+}

package/dist/ui/SiteDocument.d.ts

@@ -0,0 +1,20 @@
+import React from 'react';
+export interface SiteDocumentProps {
+    /** Pass Next `<Head>` from `next/head` in the theme page. */
+    head?: React.ReactNode;
+    header?: React.ReactNode;
+    footer?: React.ReactNode;
+    children: React.ReactNode;
+    className?: string;
+    mainClassName?: string;
+    contentClassName?: string;
+    wrapContent?: boolean;
+    globalCss?: string;
+    skipBaseStyles?: boolean;
+    /** Skip CSS vars when `createThemeApp` already injects `ThemeCssVars` in `_app`. */
+    skipCssVars?: boolean;
+}
+/**
+ * WordPress-style shell: head slot + header + main + footer (like `get_header()` / `get_footer()`).
+ */
+export declare function SiteDocument({ head, header, footer, children, className, mainClassName, contentClassName, wrapContent, globalCss, skipBaseStyles, skipCssVars, }: SiteDocumentProps): import("react/jsx-runtime").JSX.Element;

package/dist/ui/SiteDocument.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SiteDocument = SiteDocument;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const ThemeLayout_1 = require("./ThemeLayout");
+const ThemeCssVars_1 = require("./ThemeCssVars");
+const BaseGlobalStyles_1 = require("./BaseGlobalStyles");
+/**
+ * WordPress-style shell: head slot + header + main + footer (like `get_header()` / `get_footer()`).
+ */
+function SiteDocument({ head, header, footer, children, className = 'container', mainClassName = 'main', contentClassName = 'content-wrapper', wrapContent = true, globalCss, skipBaseStyles = false, skipCssVars = true, }) {
+    return ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [head, !skipCssVars ? (0, jsx_runtime_1.jsx)(ThemeCssVars_1.ThemeCssVars, {}) : null, (0, jsx_runtime_1.jsx)(ThemeLayout_1.ThemeLayout, { className: className, mainClassName: mainClassName, contentClassName: contentClassName, wrapContent: wrapContent, header: header, footer: footer, children: children }), !skipBaseStyles ? ((0, jsx_runtime_1.jsx)(BaseGlobalStyles_1.BaseGlobalStyles, { extra: globalCss })) : globalCss ? ((0, jsx_runtime_1.jsx)("style", { dangerouslySetInnerHTML: { __html: globalCss } })) : null] }));
+}