@fecommunity/reactpress-toolkit 3.0.0 → 3.1.0

package/dist/ui/SiteDocumentFallback.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import { type SiteDocumentProps } from './SiteDocument';
+export interface SiteDocumentFallbackProps extends Omit<SiteDocumentProps, 'children'> {
+    message?: React.ReactNode;
+    messageClassName?: string;
+}
+/** Standard ISR fallback shell while on-demand pages compile. */
+export declare function SiteDocumentFallback({ message, messageClassName, ...shell }: SiteDocumentFallbackProps): import("react/jsx-runtime").JSX.Element;

package/dist/ui/SiteDocumentFallback.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SiteDocumentFallback = SiteDocumentFallback;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const SiteDocument_1 = require("./SiteDocument");
+/** Standard ISR fallback shell while on-demand pages compile. */
+function SiteDocumentFallback({ message = 'Loading…', messageClassName = 'empty-state', ...shell }) {
+    return ((0, jsx_runtime_1.jsx)(SiteDocument_1.SiteDocument, { ...shell, children: (0, jsx_runtime_1.jsx)("p", { className: messageClassName, children: message }) }));
+}

package/dist/ui/SiteLogo.d.ts

@@ -0,0 +1,6 @@
+export interface SiteLogoProps {
+    className?: string;
+    alt?: string;
+}
+/** Site logo: customizer `siteLogo` when set, otherwise `systemLogo` from site settings. */
+export declare function SiteLogo({ className, alt }: SiteLogoProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/ui/SiteLogo.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SiteLogo = SiteLogo;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const assets_1 = require("../theme/assets");
+const ThemeRuntimeContext_1 = require("./context/ThemeRuntimeContext");
+/** Site logo: customizer `siteLogo` when set, otherwise `systemLogo` from site settings. */
+function SiteLogo({ className, alt }) {
+    const mod = (0, ThemeRuntimeContext_1.useThemeMod)('siteLogo', '').trim();
+    const { siteLogo } = (0, ThemeRuntimeContext_1.useSiteMeta)();
+    const raw = mod || siteLogo?.trim() || '';
+    const src = (0, assets_1.resolvePublicAssetUrl)(raw);
+    if (!src)
+        return null;
+    return (0, jsx_runtime_1.jsx)("img", { src: src, alt: alt ?? '', className: className });
+}

package/dist/ui/SiteTagline.d.ts

@@ -0,0 +1,7 @@
+export interface SiteTaglineProps {
+    /** Used when customizer tagline and site subtitle are both empty. */
+    fallback?: string;
+    className?: string;
+}
+/** Site tagline: customizer `displayTagline` when set, otherwise `systemSubTitle`. */
+export declare function SiteTagline({ fallback, className }: SiteTaglineProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/ui/SiteTagline.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SiteTagline = SiteTagline;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const context_1 = require("./context");
+const ThemeRuntimeContext_1 = require("./context/ThemeRuntimeContext");
+/** Site tagline: customizer `displayTagline` when set, otherwise `systemSubTitle`. */
+function SiteTagline({ fallback = '', className = 'site-tagline' }) {
+    const mod = (0, ThemeRuntimeContext_1.useThemeMod)('displayTagline', '');
+    const { siteDescription } = (0, context_1.useSiteMeta)();
+    const text = mod.trim() || siteDescription.trim() || fallback.trim();
+    if (!text)
+        return null;
+    return ((0, jsx_runtime_1.jsx)("p", { className: className, "data-rp-component": "site-tagline", children: text }));
+}

package/dist/ui/TaxonomyList.d.ts

@@ -0,0 +1,25 @@
+import React from 'react';
+export interface TaxonomyItem {
+    value: string;
+    label: string;
+    articleCount?: number;
+}
+export interface TaxonomyListRenderLinkProps {
+    item: TaxonomyItem;
+    href: string;
+    active: boolean;
+}
+export type TaxonomyListVariant = 'inline' | 'list';
+export interface TaxonomyListProps {
+    items: TaxonomyItem[];
+    kind: 'category' | 'tag';
+    /** `list` → `ul`/`li` (sidebar); `inline` → flex-friendly wrappers (tag cloud). */
+    variant?: TaxonomyListVariant;
+    currentValue?: string;
+    className?: string;
+    itemClassName?: string;
+    hrefFor?: (item: TaxonomyItem) => string;
+    renderLink: (props: TaxonomyListRenderLinkProps) => React.ReactNode;
+}
+/** Headless category/tag list (sidebar, footer, tag cloud). */
+export declare function TaxonomyList({ items, kind, variant, currentValue, className, itemClassName, hrefFor, renderLink, }: TaxonomyListProps): import("react/jsx-runtime").JSX.Element;

package/dist/ui/TaxonomyList.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TaxonomyList = TaxonomyList;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const nav_1 = require("../theme/nav");
+function defaultHref(kind, item) {
+    return kind === 'category' ? (0, nav_1.categoryPath)(item.value) : (0, nav_1.tagPath)(item.value);
+}
+/** Headless category/tag list (sidebar, footer, tag cloud). */
+function TaxonomyList({ items, kind, variant = 'inline', currentValue, className, itemClassName, hrefFor, renderLink, }) {
+    const safeItems = Array.isArray(items) ? items : [];
+    const resolveHref = hrefFor ?? ((item) => defaultHref(kind, item));
+    const component = `${kind}-list`;
+    const nodes = safeItems.map((item) => {
+        const href = resolveHref(item);
+        const link = renderLink({
+            item,
+            href,
+            active: currentValue === item.value,
+        });
+        if (variant === 'list') {
+            return ((0, jsx_runtime_1.jsx)("li", { className: itemClassName, children: link }, item.value));
+        }
+        return ((0, jsx_runtime_1.jsx)("span", { className: itemClassName, children: link }, item.value));
+    });
+    if (variant === 'list') {
+        return ((0, jsx_runtime_1.jsx)("ul", { className: className, "data-rp-component": component, children: nodes }));
+    }
+    return ((0, jsx_runtime_1.jsx)("div", { className: className, "data-rp-component": component, children: nodes }));
+}

package/dist/ui/ThemeCssVars.d.ts

@@ -0,0 +1,2 @@
+/** Injects Customizer colors, background, dark mode, and extra CSS (WP `theme_mod` → `:root`). */
+export declare function ThemeCssVars(): import("react/jsx-runtime").JSX.Element;

package/dist/ui/ThemeCssVars.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ThemeCssVars = ThemeCssVars;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const assets_1 = require("../theme/assets");
+const ThemeRuntimeContext_1 = require("./context/ThemeRuntimeContext");
+function BgImageHtmlClass({ enabled }) {
+    (0, react_1.useEffect)(() => {
+        if (typeof document === 'undefined')
+            return;
+        document.documentElement.classList.toggle('rp-has-bg-image', enabled);
+        return () => document.documentElement.classList.remove('rp-has-bg-image');
+    }, [enabled]);
+    return null;
+}
+function escapeCssValue(value) {
+    return value.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+}
+/** Injects Customizer colors, background, dark mode, and extra CSS (WP `theme_mod` → `:root`). */
+function ThemeCssVars() {
+    const primary = (0, ThemeRuntimeContext_1.useThemeMod)('primaryColor', '#3b82f6');
+    const accent = (0, ThemeRuntimeContext_1.useThemeMod)('accentColor', '#8b5cf6');
+    const background = (0, ThemeRuntimeContext_1.useThemeMod)('backgroundColor', '#f8f9fa');
+    const backgroundImage = (0, assets_1.resolvePublicAssetUrl)((0, ThemeRuntimeContext_1.useThemeMod)('backgroundImage', ''));
+    const darkMode = (0, ThemeRuntimeContext_1.useThemeModBool)('darkMode', false);
+    const additionalCss = (0, ThemeRuntimeContext_1.useThemeMod)('additionalCss', '').trim();
+    const hasBgImage = Boolean(backgroundImage);
+    const bgLayer = hasBgImage
+        ? `background-image: url("${escapeCssValue(backgroundImage)}"); background-size: cover; background-position: center center; background-repeat: no-repeat; background-attachment: fixed;`
+        : '';
+    const darkVars = darkMode
+        ? `
+    --rp-background: #1a1a1a;
+    --rp-text: #e8e8e8;
+    --rp-muted: #a3a3a3;
+    color-scheme: dark;
+  `
+        : `
+    --rp-text: #1d2327;
+    --rp-muted: #646970;
+    color-scheme: light;
+  `;
+    const css = `
+    :root {
+      --rp-primary: ${primary};
+      --rp-accent: ${accent};
+      --rp-background: ${background};
+      ${hasBgImage ? '--rp-has-bg-image: 1;' : ''}
+      ${darkVars}
+    }
+    html${hasBgImage ? '.rp-has-bg-image' : ''} {
+      ${bgLayer}
+    }
+    html,
+    body {
+      background-color: var(--rp-background, #f8f9fa) !important;
+    }
+    html.rp-has-bg-image,
+    html.rp-has-bg-image body,
+    html.rp-has-bg-image .container,
+    html.rp-has-bg-image [data-rp-component='layout'],
+    html.rp-has-bg-image [data-rp-component='main'] {
+      background-color: transparent !important;
+    }
+    .container,
+    [data-rp-component='layout'],
+    [data-rp-component='main'] {
+      background-color: ${hasBgImage ? 'transparent' : 'var(--rp-background, #f8f9fa)'} !important;
+    }
+    [data-rp-component='layout'][data-rp-dark='true'],
+    [data-rp-component='layout'][data-rp-dark='true'] .container {
+      background-color: var(--rp-background, #1a1a1a) !important;
+      color: var(--rp-text, #e8e8e8);
+    }
+    [data-rp-component='layout'][data-rp-dark='true'] a {
+      color: var(--rp-primary);
+    }
+    [data-rp-component='layout'] {
+      color: var(--rp-text, #1d2327);
+    }
+    ${additionalCss}
+  `;
+    return ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)(BgImageHtmlClass, { enabled: hasBgImage }), (0, jsx_runtime_1.jsx)("style", { dangerouslySetInnerHTML: { __html: css } })] }));
+}

package/dist/ui/ThemeLayout.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+export interface ThemeLayoutProps {
+    header?: React.ReactNode;
+    footer?: React.ReactNode;
+    children: React.ReactNode;
+    className?: string;
+    mainClassName?: string;
+    contentClassName?: string;
+    /** When true, wraps children in an inner content container (`data-rp-part="content"`). */
+    wrapContent?: boolean;
+}
+/** Unstyled page shell: header + main (+ optional content wrapper) + footer. */
+export declare function ThemeLayout({ header, footer, children, className, mainClassName, contentClassName, wrapContent, }: ThemeLayoutProps): import("react/jsx-runtime").JSX.Element;

package/dist/ui/ThemeLayout.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ThemeLayout = ThemeLayout;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const ThemeRuntimeContext_1 = require("./context/ThemeRuntimeContext");
+/** Unstyled page shell: header + main (+ optional content wrapper) + footer. */
+function ThemeLayout({ header, footer, children, className, mainClassName, contentClassName, wrapContent = false, }) {
+    const darkMode = (0, ThemeRuntimeContext_1.useThemeModBool)('darkMode', false);
+    const mainContent = wrapContent ? ((0, jsx_runtime_1.jsx)("div", { className: contentClassName, "data-rp-part": "content", children: children })) : (children);
+    return ((0, jsx_runtime_1.jsxs)("div", { className: className, "data-rp-component": "layout", ...(darkMode ? { 'data-rp-dark': 'true' } : {}), children: [header, (0, jsx_runtime_1.jsx)("main", { className: mainClassName, "data-rp-component": "main", children: mainContent }), footer] }));
+}

package/dist/ui/components/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/components/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/components/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/components/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/components/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/components/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/components/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/components/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 date_1 = require("../../utils/date");
+const nav_1 = require("../../theme/content/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, date_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/components/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/components/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/components/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/components/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/components/LocaleSwitcher.d.ts

@@ -0,0 +1,10 @@
+export interface LocaleSwitcherProps {
+    className?: string;
+    buttonClassName?: string;
+    /** @deprecated No longer used; kept for backward compatibility. */
+    activeClassName?: string;
+    size?: number;
+    ariaLabel?: string;
+}
+/** Click to cycle locales — same control as admin and theme headers. */
+export declare function LocaleSwitcher({ className, buttonClassName, size, ariaLabel, }: LocaleSwitcherProps): import("react/jsx-runtime").JSX.Element;

package/dist/ui/components/LocaleSwitcher.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocaleSwitcher = LocaleSwitcher;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const LocaleToggleButton_1 = require("./toolbar/LocaleToggleButton");
+const LocaleContext_1 = require("../context/LocaleContext");
+/** Click to cycle locales — same control as admin and theme headers. */
+function LocaleSwitcher({ className, buttonClassName, size = 20, ariaLabel, }) {
+    const { locale, locales, setLocale } = (0, LocaleContext_1.useLocale)();
+    return ((0, jsx_runtime_1.jsx)(LocaleToggleButton_1.LocaleToggleButton, { locale: locale, locales: locales, onLocaleChange: setLocale, size: size, className: buttonClassName ?? className, "aria-label": ariaLabel }));
+}

package/dist/ui/components/NavMenu.d.ts

@@ -0,0 +1,16 @@
+import React from 'react';
+import type { NavItem } from '../../theme/content/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/components/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/components/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/components/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/components/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/components/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/components/RouteProgress.d.ts

@@ -0,0 +1,9 @@
+export interface RouteProgressProps {
+    /** Delay before showing the bar (ms). */
+    delay?: number;
+}
+/**
+ * Next.js route transition progress bar.
+ * Requires `nprogress` as a peer dependency in the theme package.
+ */
+export declare function RouteProgress({ delay }: RouteProgressProps): null;

package/dist/ui/components/RouteProgress.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RouteProgress = RouteProgress;
+const react_1 = require("react");
+/**
+ * Next.js route transition progress bar.
+ * Requires `nprogress` as a peer dependency in the theme package.
+ */
+function RouteProgress({ delay = 100 }) {
+    (0, react_1.useEffect)(() => {
+        let nprogress = null;
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            nprogress = require('nprogress');
+        }
+        catch {
+            return undefined;
+        }
+        let timeout;
+        const Router = require('next/router').default;
+        const start = () => {
+            timeout = setTimeout(() => nprogress?.start(), delay);
+        };
+        const done = () => {
+            if (timeout)
+                clearTimeout(timeout);
+            nprogress?.done();
+        };
+        Router.events.on('routeChangeStart', start);
+        Router.events.on('routeChangeComplete', done);
+        Router.events.on('routeChangeError', done);
+        return () => {
+            Router.events.off('routeChangeStart', start);
+            Router.events.off('routeChangeComplete', done);
+            Router.events.off('routeChangeError', done);
+            nprogress?.done();
+        };
+    }, [delay]);
+    return null;
+}

package/dist/ui/components/SiteAnalytics.d.ts

@@ -0,0 +1,5 @@
+export interface SiteAnalyticsProps {
+    children?: React.ReactNode;
+}
+/** Inject Google Analytics / Baidu Tongji scripts from site settings. */
+export declare function SiteAnalytics({ children }: SiteAnalyticsProps): string | number | boolean | import("react").ReactElement<any, string | import("react").JSXElementConstructor<any>> | Iterable<import("react").ReactNode> | import("react").ReactPortal | null;

package/dist/ui/components/SiteAnalytics.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SiteAnalytics = SiteAnalytics;
+const react_1 = require("react");
+const SiteCatalogContext_1 = require("../context/SiteCatalogContext");
+/** Inject Google Analytics / Baidu Tongji scripts from site settings. */
+function SiteAnalytics({ children = null }) {
+    const setting = (0, SiteCatalogContext_1.useSiteSetting)();
+    (0, react_1.useEffect)(() => {
+        const googleAnalyticsId = setting.googleAnalyticsId;
+        if (!googleAnalyticsId)
+            return undefined;
+        const w = window;
+        w.dataLayer = w.dataLayer || [];
+        function gtag(...args) {
+            w.dataLayer?.push(args);
+        }
+        w.gtag = gtag;
+        gtag('js', new Date());
+        gtag('config', googleAnalyticsId);
+        const script = document.createElement('script');
+        script.src = `https://www.googletagmanager.com/gtag/js?id=${googleAnalyticsId}`;
+        script.async = true;
+        document.body?.appendChild(script);
+        return () => {
+            script.remove();
+        };
+    }, [setting.googleAnalyticsId]);
+    (0, react_1.useEffect)(() => {
+        const baiduAnalyticsId = setting.baiduAnalyticsId;
+        if (!baiduAnalyticsId)
+            return undefined;
+        const hm = document.createElement('script');
+        hm.src = `https://hm.baidu.com/hm.js?${baiduAnalyticsId}`;
+        const s = document.getElementsByTagName('script')[0];
+        s?.parentNode?.insertBefore(hm, s);
+        return () => {
+            hm.remove();
+        };
+    }, [setting.baiduAnalyticsId]);
+    return children;
+}

package/dist/ui/components/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;