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

package/toolkit/dist/ui/context/LocaleContext.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocaleProvider = LocaleProvider;
+exports.useLocale = useLocale;
+exports.readPersistedLocale = readPersistedLocale;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const locale_1 = require("../../theme/visitor/locale");
+const visitorLocale_1 = require("../../theme/visitor/visitorLocale");
+const LocaleContext = (0, react_1.createContext)(null);
+function LocaleProvider({ locale: initialLocale, locales, messages: initialMessages, catalog, children, persistLocale = true, onLocaleChange, }) {
+    const [locale, setLocaleState] = (0, react_1.useState)(initialLocale);
+    const [messages, setMessages] = (0, react_1.useState)(initialMessages);
+    (0, react_1.useEffect)(() => {
+        setMessages({ ...(catalog[locale] ?? {}) });
+    }, [catalog, locale]);
+    const setLocale = (0, react_1.useCallback)((next) => {
+        if (!locales.includes(next))
+            return;
+        setLocaleState(next);
+        setMessages({ ...(catalog[next] ?? {}) });
+        if (persistLocale && typeof window !== 'undefined') {
+            window.localStorage.setItem(visitorLocale_1.VISITOR_LOCALE_COOKIE, next);
+        }
+        onLocaleChange?.(next);
+    }, [catalog, locales, onLocaleChange, persistLocale]);
+    const value = (0, react_1.useMemo)(() => {
+        const t = (0, locale_1.createTranslator)(messages);
+        return {
+            locale,
+            locales,
+            messages,
+            catalog,
+            setLocale,
+            t,
+        };
+    }, [catalog, locale, locales, messages, setLocale]);
+    return (0, jsx_runtime_1.jsx)(LocaleContext.Provider, { value: value, children: children });
+}
+function useLocale() {
+    const ctx = (0, react_1.useContext)(LocaleContext);
+    if (!ctx) {
+        throw new Error('useLocale must be used within ReactPressProvider or LocaleProvider');
+    }
+    return ctx;
+}
+function readPersistedLocale(locales, fallback) {
+    if (typeof window === 'undefined')
+        return fallback;
+    try {
+        const stored = window.localStorage.getItem(visitorLocale_1.VISITOR_LOCALE_COOKIE);
+        if (stored && locales.includes(stored))
+            return stored;
+    }
+    catch {
+        // ignore
+    }
+    return fallback;
+}

package/toolkit/dist/ui/context/ReactPressProvider.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReactPressProvider = ReactPressProvider;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const LocaleContext_1 = require("./LocaleContext");
+const ThemeRuntimeContext_1 = require("./ThemeRuntimeContext");
+/** Wraps the theme app with locale + active theme / customizer context. */
+function ReactPressProvider({ locale, locales, messages, catalog = {}, themeId, activeThemeId, mods = {}, isPreview = false, siteMeta, children, persistLocale = true, onLocaleChange, }) {
+    return ((0, jsx_runtime_1.jsx)(LocaleContext_1.LocaleProvider, { locale: locale, locales: locales, messages: messages, catalog: catalog, persistLocale: persistLocale, onLocaleChange: onLocaleChange, children: (0, jsx_runtime_1.jsx)(ThemeRuntimeContext_1.ThemeRuntimeProvider, { themeId: themeId, activeThemeId: activeThemeId, mods: mods, isPreview: isPreview, siteMeta: siteMeta, children: children }) }));
+}

package/toolkit/dist/ui/context/SiteCatalogContext.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SiteCatalogContext = void 0;
+exports.SiteCatalogProvider = SiteCatalogProvider;
+exports.useSiteCatalog = useSiteCatalog;
+exports.useSiteSetting = useSiteSetting;
+exports.useSiteUser = useSiteUser;
+exports.useColorMode = useColorMode;
+exports.useSiteConfig = useSiteConfig;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const siteCatalogTypes_1 = require("./siteCatalogTypes");
+/** Global site catalog + session state for full-featured themes. */
+exports.SiteCatalogContext = (0, react_1.createContext)(siteCatalogTypes_1.defaultSiteCatalogContext);
+function SiteCatalogProvider({ value, children, }) {
+    return ((0, jsx_runtime_1.jsx)(exports.SiteCatalogContext.Provider, { value: value, children: children }));
+}
+function useSiteCatalog() {
+    const ctx = (0, react_1.useContext)(exports.SiteCatalogContext);
+    return {
+        categories: ctx.categories ?? [],
+        tags: ctx.tags ?? [],
+        pages: ctx.pages ?? [],
+        siteConfig: ctx.siteConfig,
+        globalSetting: ctx.globalSetting,
+        locale: ctx.locale,
+        locales: ctx.locales ?? [],
+        i18n: ctx.i18n,
+        changeLocale: ctx.changeLocale,
+        collapsed: ctx.collapsed,
+        toggleCollapse: ctx.toggleCollapse,
+    };
+}
+function useSiteSetting() {
+    const ctx = (0, react_1.useContext)(exports.SiteCatalogContext);
+    return ctx.setting ?? {};
+}
+function useSiteUser() {
+    const ctx = (0, react_1.useContext)(exports.SiteCatalogContext);
+    return {
+        user: ctx.user,
+        setUser: ctx.setUser,
+        removeUser: ctx.removeUser,
+    };
+}
+function useColorMode() {
+    const ctx = (0, react_1.useContext)(exports.SiteCatalogContext);
+    return {
+        colorMode: ctx.theme ?? 'light',
+        changeColorMode: ctx.changeTheme,
+    };
+}
+/** @deprecated Prefer `useSiteCatalog().siteConfig`. */
+function useSiteConfig() {
+    const ctx = (0, react_1.useContext)(exports.SiteCatalogContext);
+    return {
+        siteConfig: ctx.siteConfig,
+        globalSetting: ctx.globalSetting,
+    };
+}

package/toolkit/dist/ui/context/ThemeRuntimeContext.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ThemeRuntimeProvider = ThemeRuntimeProvider;
+exports.useThemeRuntime = useThemeRuntime;
+exports.useThemeMod = useThemeMod;
+exports.useThemeModBool = useThemeModBool;
+exports.useThemeId = useThemeId;
+exports.useActiveThemeId = useActiveThemeId;
+exports.useIsThemePreview = useIsThemePreview;
+exports.useSiteMeta = useSiteMeta;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const setting_1 = require("../../theme/ssr/setting");
+const ThemeRuntimeContext = (0, react_1.createContext)(null);
+function ThemeRuntimeProvider({ themeId, activeThemeId, mods = {}, isPreview = false, siteMeta = setting_1.DEFAULT_SITE_META, children, }) {
+    const value = (0, react_1.useMemo)(() => ({
+        themeId,
+        activeThemeId,
+        mods,
+        isPreview,
+        siteMeta,
+    }), [activeThemeId, isPreview, mods, siteMeta, themeId]);
+    return ((0, jsx_runtime_1.jsx)(ThemeRuntimeContext.Provider, { value: value, children: children }));
+}
+function useThemeRuntime() {
+    const ctx = (0, react_1.useContext)(ThemeRuntimeContext);
+    if (!ctx) {
+        throw new Error('useThemeRuntime must be used within ReactPressProvider or ThemeRuntimeProvider');
+    }
+    return ctx;
+}
+/** Read a single customizer mod with optional default (from `theme.json` customizer). */
+function useThemeMod(modId, defaultValue = '') {
+    const ctx = (0, react_1.useContext)(ThemeRuntimeContext);
+    if (!ctx)
+        return defaultValue;
+    return ctx.mods[modId] ?? defaultValue;
+}
+const TRUTHY = new Set(['1', 'true', 'yes', 'on']);
+/** Checkbox mods are stored as strings (`"1"` / `"0"`). */
+function useThemeModBool(modId, defaultValue = false) {
+    const raw = useThemeMod(modId, defaultValue ? '1' : '0');
+    if (raw === '')
+        return defaultValue;
+    return TRUTHY.has(raw.trim().toLowerCase());
+}
+function useThemeId() {
+    return useThemeRuntime().themeId;
+}
+function useActiveThemeId() {
+    return useThemeRuntime().activeThemeId;
+}
+function useIsThemePreview() {
+    return useThemeRuntime().isPreview;
+}
+function useSiteMeta() {
+    const ctx = (0, react_1.useContext)(ThemeRuntimeContext);
+    return ctx?.siteMeta ?? setting_1.DEFAULT_SITE_META;
+}

package/toolkit/dist/ui/context/index.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useSiteUser = exports.useSiteSetting = exports.useSiteConfig = exports.useSiteCatalog = exports.useColorMode = exports.SiteCatalogProvider = exports.SiteCatalogContext = exports.useThemeRuntime = exports.useThemeModBool = exports.useThemeMod = exports.useThemeId = exports.useSiteMeta = exports.useIsThemePreview = exports.useActiveThemeId = exports.ThemeRuntimeProvider = exports.ReactPressProvider = exports.useLocale = exports.readPersistedLocale = exports.LocaleProvider = void 0;
+var LocaleContext_1 = require("./LocaleContext");
+Object.defineProperty(exports, "LocaleProvider", { enumerable: true, get: function () { return LocaleContext_1.LocaleProvider; } });
+Object.defineProperty(exports, "readPersistedLocale", { enumerable: true, get: function () { return LocaleContext_1.readPersistedLocale; } });
+Object.defineProperty(exports, "useLocale", { enumerable: true, get: function () { return LocaleContext_1.useLocale; } });
+var ReactPressProvider_1 = require("./ReactPressProvider");
+Object.defineProperty(exports, "ReactPressProvider", { enumerable: true, get: function () { return ReactPressProvider_1.ReactPressProvider; } });
+var ThemeRuntimeContext_1 = require("./ThemeRuntimeContext");
+Object.defineProperty(exports, "ThemeRuntimeProvider", { enumerable: true, get: function () { return ThemeRuntimeContext_1.ThemeRuntimeProvider; } });
+Object.defineProperty(exports, "useActiveThemeId", { enumerable: true, get: function () { return ThemeRuntimeContext_1.useActiveThemeId; } });
+Object.defineProperty(exports, "useIsThemePreview", { enumerable: true, get: function () { return ThemeRuntimeContext_1.useIsThemePreview; } });
+Object.defineProperty(exports, "useSiteMeta", { enumerable: true, get: function () { return ThemeRuntimeContext_1.useSiteMeta; } });
+Object.defineProperty(exports, "useThemeId", { enumerable: true, get: function () { return ThemeRuntimeContext_1.useThemeId; } });
+Object.defineProperty(exports, "useThemeMod", { enumerable: true, get: function () { return ThemeRuntimeContext_1.useThemeMod; } });
+Object.defineProperty(exports, "useThemeModBool", { enumerable: true, get: function () { return ThemeRuntimeContext_1.useThemeModBool; } });
+Object.defineProperty(exports, "useThemeRuntime", { enumerable: true, get: function () { return ThemeRuntimeContext_1.useThemeRuntime; } });
+var SiteCatalogContext_1 = require("./SiteCatalogContext");
+Object.defineProperty(exports, "SiteCatalogContext", { enumerable: true, get: function () { return SiteCatalogContext_1.SiteCatalogContext; } });
+Object.defineProperty(exports, "SiteCatalogProvider", { enumerable: true, get: function () { return SiteCatalogContext_1.SiteCatalogProvider; } });
+Object.defineProperty(exports, "useColorMode", { enumerable: true, get: function () { return SiteCatalogContext_1.useColorMode; } });
+Object.defineProperty(exports, "useSiteCatalog", { enumerable: true, get: function () { return SiteCatalogContext_1.useSiteCatalog; } });
+Object.defineProperty(exports, "useSiteConfig", { enumerable: true, get: function () { return SiteCatalogContext_1.useSiteConfig; } });
+Object.defineProperty(exports, "useSiteSetting", { enumerable: true, get: function () { return SiteCatalogContext_1.useSiteSetting; } });
+Object.defineProperty(exports, "useSiteUser", { enumerable: true, get: function () { return SiteCatalogContext_1.useSiteUser; } });

package/toolkit/dist/ui/context/siteCatalogTypes.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultSiteCatalogContext = void 0;
+exports.defaultSiteCatalogContext = {
+    setting: {},
+    i18n: {},
+    locale: '',
+    locales: [],
+    pages: [],
+    categories: [],
+    tags: [],
+    changeLocale: () => { },
+    user: null,
+    setUser: () => { },
+    removeUser: () => { },
+    changeTheme: () => { },
+    theme: 'light',
+    getSetting: () => { },
+    toggleCollapse: () => { },
+};

package/toolkit/dist/ui/context/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/toolkit/dist/ui/hooks/index.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useWarningOnExit = exports.useToggle = exports.useRouteParam = exports.useReportArticleView = exports.useReportPageView = exports.usePagination = exports.useNavActive = exports.useForceUpdate = exports.useAsyncLoading = exports.useThemeRuntime = exports.useThemeMod = exports.useThemeId = exports.useLocale = exports.useIsThemePreview = exports.useActiveThemeId = exports.readPersistedLocale = void 0;
+var context_1 = require("../context");
+Object.defineProperty(exports, "readPersistedLocale", { enumerable: true, get: function () { return context_1.readPersistedLocale; } });
+Object.defineProperty(exports, "useActiveThemeId", { enumerable: true, get: function () { return context_1.useActiveThemeId; } });
+Object.defineProperty(exports, "useIsThemePreview", { enumerable: true, get: function () { return context_1.useIsThemePreview; } });
+Object.defineProperty(exports, "useLocale", { enumerable: true, get: function () { return context_1.useLocale; } });
+Object.defineProperty(exports, "useThemeId", { enumerable: true, get: function () { return context_1.useThemeId; } });
+Object.defineProperty(exports, "useThemeMod", { enumerable: true, get: function () { return context_1.useThemeMod; } });
+Object.defineProperty(exports, "useThemeRuntime", { enumerable: true, get: function () { return context_1.useThemeRuntime; } });
+var useAsyncLoading_1 = require("./useAsyncLoading");
+Object.defineProperty(exports, "useAsyncLoading", { enumerable: true, get: function () { return useAsyncLoading_1.useAsyncLoading; } });
+var useForceUpdate_1 = require("./useForceUpdate");
+Object.defineProperty(exports, "useForceUpdate", { enumerable: true, get: function () { return useForceUpdate_1.useForceUpdate; } });
+var useNavActive_1 = require("./useNavActive");
+Object.defineProperty(exports, "useNavActive", { enumerable: true, get: function () { return useNavActive_1.useNavActive; } });
+var usePagination_1 = require("./usePagination");
+Object.defineProperty(exports, "usePagination", { enumerable: true, get: function () { return usePagination_1.usePagination; } });
+var useReportPageView_1 = require("./useReportPageView");
+Object.defineProperty(exports, "useReportPageView", { enumerable: true, get: function () { return useReportPageView_1.useReportPageView; } });
+var useReportArticleView_1 = require("./useReportArticleView");
+Object.defineProperty(exports, "useReportArticleView", { enumerable: true, get: function () { return useReportArticleView_1.useReportArticleView; } });
+var useRouteParam_1 = require("./useRouteParam");
+Object.defineProperty(exports, "useRouteParam", { enumerable: true, get: function () { return useRouteParam_1.useRouteParam; } });
+var useToggle_1 = require("./useToggle");
+Object.defineProperty(exports, "useToggle", { enumerable: true, get: function () { return useToggle_1.useToggle; } });
+var useWarningOnExit_1 = require("./useWarningOnExit");
+Object.defineProperty(exports, "useWarningOnExit", { enumerable: true, get: function () { return useWarningOnExit_1.useWarningOnExit; } });

package/toolkit/dist/ui/hooks/useAsyncLoading.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useAsyncLoading = useAsyncLoading;
+const react_1 = require("react");
+/**
+ * Wrap an async function and expose a debounced `loading` flag (avoids flicker on fast requests).
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function useAsyncLoading(action, wait = 200, initialLoading = false) {
+    const timerRef = (0, react_1.useRef)(null);
+    const [pending, setPending] = (0, react_1.useState)(false);
+    const [loading, setLoading] = (0, react_1.useState)(initialLoading);
+    const actionWithPending = (0, react_1.useCallback)((...args) => {
+        setPending(true);
+        const promise = action(...args);
+        promise.then(() => setPending(false), () => setPending(false));
+        return promise;
+    }, [action]);
+    (0, react_1.useEffect)(() => {
+        if (timerRef.current)
+            clearTimeout(timerRef.current);
+        timerRef.current = setTimeout(() => {
+            setLoading(pending);
+        }, wait);
+        return () => {
+            if (timerRef.current)
+                clearTimeout(timerRef.current);
+        };
+    }, [wait, pending]);
+    return [actionWithPending, loading];
+}

package/toolkit/dist/ui/hooks/useForceUpdate.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useForceUpdate = useForceUpdate;
+const react_1 = require("react");
+/** Force a function component re-render without changing state props. */
+function useForceUpdate() {
+    const [, update] = (0, react_1.useState)(0);
+    return (0, react_1.useCallback)(() => {
+        update((v) => v + 1);
+    }, []);
+}

package/toolkit/dist/ui/hooks/useNavActive.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useNavActive = useNavActive;
+const react_1 = require("react");
+const nav_1 = require("../../theme/content/nav");
+/**
+ * Derive active nav id from pathname (pass `router.pathname` from `next/router` in client components).
+ */
+function useNavActive(items, pathname) {
+    return (0, react_1.useMemo)(() => (0, nav_1.getNavActiveId)(pathname, items), [pathname, items]);
+}

package/toolkit/dist/ui/hooks/usePagination.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.usePagination = usePagination;
+const react_1 = require("react");
+const useAsyncLoading_1 = require("./useAsyncLoading");
+const DEFAULT_PAGE = 1;
+const DEFAULT_PAGE_SIZE = 12;
+/**
+ * Paginated list state for APIs that return `[items, total]`.
+ */
+function usePagination(fetch, options) {
+    const defaultPage = options?.page ?? DEFAULT_PAGE;
+    const defaultPageSize = options?.pageSize ?? DEFAULT_PAGE_SIZE;
+    const defaultParams = options?.params ?? {};
+    const after = options?.after;
+    const [api, loading] = (0, useAsyncLoading_1.useAsyncLoading)(fetch);
+    const [page, setPage] = (0, react_1.useState)(defaultPage);
+    const [pageSize, setPageSize] = (0, react_1.useState)(defaultPageSize);
+    const [params, setParams] = (0, react_1.useState)(defaultParams);
+    const [total, setTotal] = (0, react_1.useState)(0);
+    const [data, setData] = (0, react_1.useState)([]);
+    const callAfter = (0, react_1.useCallback)(() => {
+        after?.({ page, pageSize, data, total, loading });
+    }, [after, page, pageSize, data, total, loading]);
+    const query = (0, react_1.useCallback)((queryParams) => api(queryParams).then((res) => {
+        const [items, count] = res;
+        setData(items);
+        setTotal(count);
+        callAfter();
+        return res;
+    }), [api, callAfter]);
+    const refresh = (0, react_1.useCallback)(() => query({ page, pageSize, ...params }), [query, page, pageSize, params]);
+    const reset = (0, react_1.useCallback)(() => {
+        setPage(defaultPage);
+        setPageSize(defaultPageSize);
+        setParams(defaultParams);
+    }, [defaultPage, defaultPageSize, defaultParams]);
+    (0, react_1.useEffect)(() => {
+        query({ page, pageSize, ...params });
+        // eslint-disable-next-line react-hooks/exhaustive-deps -- refresh when page/size/filters change only
+    }, [page, pageSize, params]);
+    return {
+        loading,
+        data,
+        total,
+        page,
+        pageSize,
+        params,
+        setPage,
+        setPageSize,
+        setParams,
+        refresh,
+        reset,
+    };
+}

package/toolkit/dist/ui/hooks/useReportArticleView.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useReportArticleView = useReportArticleView;
+const react_1 = require("react");
+const api_envelope_1 = require("../../utils/api-envelope");
+const api_1 = require("../../theme/api/api");
+/**
+ * Report article view on mount and return the latest view count for display.
+ */
+function useReportArticleView(articleId, initialViews) {
+    const [views, setViews] = (0, react_1.useState)(initialViews);
+    (0, react_1.useEffect)(() => {
+        setViews(initialViews);
+    }, [articleId, initialViews]);
+    (0, react_1.useEffect)(() => {
+        if (!articleId)
+            return undefined;
+        let cancelled = false;
+        api_1.themeApi.article
+            .updateViewsById(articleId)
+            .then((res) => {
+            if (cancelled)
+                return;
+            const updated = (0, api_envelope_1.unpackOne)(res);
+            if (typeof updated?.views === 'number') {
+                setViews(updated.views);
+            }
+            else {
+                setViews((prev) => (typeof prev === 'number' ? prev + 1 : 1));
+            }
+        })
+            .catch((error) => {
+            console.error('[reactpress] report article view failed', error);
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [articleId]);
+    return views;
+}

package/toolkit/dist/ui/hooks/useReportPageView.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useReportPageView = useReportPageView;
+const react_1 = require("react");
+const api_1 = require("../../theme/api/api");
+/**
+ * POST a page view once per distinct URL (browser only). Pair with layout shell or `_app`.
+ */
+function useReportPageView(options = {}) {
+    const { url, skipLocalhost = true, enabled = true } = options;
+    const lastUrl = (0, react_1.useRef)(undefined);
+    (0, react_1.useEffect)(() => {
+        if (!enabled || typeof window === 'undefined')
+            return undefined;
+        const target = url ?? window.location.href;
+        if (skipLocalhost && /localhost|127\.0\.0\.1/.test(target))
+            return undefined;
+        if (lastUrl.current === target)
+            return undefined;
+        lastUrl.current = target;
+        api_1.themeApi.view
+            .create({ body: { url: target } })
+            .catch((error) => {
+            console.error('[reactpress] report page view failed', error);
+        });
+        return undefined;
+    });
+}

package/toolkit/dist/ui/hooks/useRouteParam.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useRouteParam = useRouteParam;
+const router_1 = require("next/router");
+/**
+ * Resolve a dynamic route param during ISR fallback.
+ * Prefers the value from `getStaticProps`, then falls back to `router.query`.
+ */
+function useRouteParam(propValue, paramName) {
+    const router = (0, router_1.useRouter)();
+    if (propValue)
+        return propValue;
+    const queryValue = router.query[paramName];
+    return typeof queryValue === 'string' ? queryValue : '';
+}

package/toolkit/dist/ui/hooks/useToggle.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useToggle = useToggle;
+const react_1 = require("react");
+/** Boolean state with `toggle(next?)` — pass a boolean to set explicitly, or omit to flip. */
+function useToggle(initialValue) {
+    const [value, setValue] = (0, react_1.useState)(initialValue);
+    const toggle = (0, react_1.useCallback)((arg = null) => {
+        if (arg !== null && typeof arg === 'boolean') {
+            setValue(arg);
+        }
+        else {
+            setValue((v) => !v);
+        }
+    }, []);
+    return [value, toggle];
+}

package/toolkit/dist/ui/hooks/useWarningOnExit.js

@@ -0,0 +1,59 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useWarningOnExit = useWarningOnExit;
+const router_1 = __importDefault(require("next/router"));
+const react_1 = require("react");
+/**
+ * Confirm before leaving the page (browser refresh/close or Next.js route change).
+ * `warn` should return `true` to allow navigation, `false` to cancel.
+ */
+function useWarningOnExit(shouldWarn, warn = () => true) {
+    (0, react_1.useEffect)(() => {
+        let isWarned = false;
+        const routeChangeStart = (url) => {
+            if (router_1.default.asPath !== url && shouldWarn && !isWarned) {
+                isWarned = true;
+                if (warn()) {
+                    router_1.default.push(url);
+                }
+                else {
+                    isWarned = false;
+                    router_1.default.events.emit('routeChangeError');
+                    router_1.default.replace(router_1.default, router_1.default.asPath, { shallow: true });
+                    throw 'Abort route change. Please ignore this error.';
+                }
+            }
+        };
+        const beforeUnload = (e) => {
+            if (shouldWarn && !isWarned) {
+                const event = e || window.event;
+                event.returnValue = 'Abort route change. Please ignore this error.';
+                return 'Abort route change. Please ignore this error.';
+            }
+            return null;
+        };
+        router_1.default.events.on('routeChangeStart', routeChangeStart);
+        window.addEventListener('beforeunload', beforeUnload);
+        router_1.default.beforePopState(({ url }) => {
+            if (router_1.default.asPath !== url && shouldWarn && !isWarned) {
+                isWarned = true;
+                if (warn()) {
+                    return true;
+                }
+                isWarned = false;
+                window.history.pushState(null, '', url);
+                router_1.default.replace(router_1.default, router_1.default.asPath, { shallow: true });
+                return false;
+            }
+            return true;
+        });
+        return () => {
+            router_1.default.events.off('routeChangeStart', routeChangeStart);
+            window.removeEventListener('beforeunload', beforeUnload);
+            router_1.default.beforePopState(() => true);
+        };
+    }, [warn, shouldWarn]);
+}

package/toolkit/dist/ui/index.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotFoundPanel = exports.NavMenu = exports.ToolbarIconButton = exports.TOOLBAR_ICON_SIZE = exports.ThemeToggleButton = exports.SunIcon = exports.RP_TOOLBAR_BTN_CLASS = exports.SearchIcon = exports.nextLocale = exports.MoonIcon = exports.localeToggleLabel = exports.LocaleZhToggleIcon = exports.LocaleToggleButton = exports.LocaleEnToggleIcon = exports.LocaleActiveIcon = exports.LanguagesIcon = exports.LocaleSwitcher = exports.useWarningOnExit = exports.useToggle = exports.useRouteParam = exports.useReportPageView = exports.useReportArticleView = exports.usePagination = exports.useNavActive = exports.useForceUpdate = exports.useAsyncLoading = exports.useThemeRuntime = exports.useThemeModBool = exports.useThemeMod = exports.useThemeId = exports.useSiteMeta = exports.useLocale = exports.useIsThemePreview = exports.useActiveThemeId = exports.useSiteUser = exports.useSiteSetting = exports.useSiteConfig = exports.useSiteCatalog = exports.useColorMode = exports.ThemeRuntimeProvider = exports.SiteCatalogProvider = exports.SiteCatalogContext = exports.readPersistedLocale = exports.ReactPressProvider = exports.LocaleProvider = exports.BaseGlobalStyles = exports.ArticleList = exports.ArticleCard = exports.ArchivePageLayout = exports.ArchiveEmptyState = void 0;
+exports.SiteSeo = exports.SiteAnalytics = exports.ThemeLayout = exports.ThemeCssVars = exports.TaxonomyList = exports.SiteTagline = exports.SiteLogo = exports.SiteDocumentFallback = exports.SiteDocument = exports.SiteBranding = exports.PageHeader = void 0;
+var ArchiveEmptyState_1 = require("./components/ArchiveEmptyState");
+Object.defineProperty(exports, "ArchiveEmptyState", { enumerable: true, get: function () { return ArchiveEmptyState_1.ArchiveEmptyState; } });
+var ArchivePageLayout_1 = require("./components/ArchivePageLayout");
+Object.defineProperty(exports, "ArchivePageLayout", { enumerable: true, get: function () { return ArchivePageLayout_1.ArchivePageLayout; } });
+var ArticleCard_1 = require("./components/ArticleCard");
+Object.defineProperty(exports, "ArticleCard", { enumerable: true, get: function () { return ArticleCard_1.ArticleCard; } });
+var ArticleList_1 = require("./components/ArticleList");
+Object.defineProperty(exports, "ArticleList", { enumerable: true, get: function () { return ArticleList_1.ArticleList; } });
+var BaseGlobalStyles_1 = require("./components/BaseGlobalStyles");
+Object.defineProperty(exports, "BaseGlobalStyles", { enumerable: true, get: function () { return BaseGlobalStyles_1.BaseGlobalStyles; } });
+var context_1 = require("./context");
+Object.defineProperty(exports, "LocaleProvider", { enumerable: true, get: function () { return context_1.LocaleProvider; } });
+Object.defineProperty(exports, "ReactPressProvider", { enumerable: true, get: function () { return context_1.ReactPressProvider; } });
+Object.defineProperty(exports, "readPersistedLocale", { enumerable: true, get: function () { return context_1.readPersistedLocale; } });
+Object.defineProperty(exports, "SiteCatalogContext", { enumerable: true, get: function () { return context_1.SiteCatalogContext; } });
+Object.defineProperty(exports, "SiteCatalogProvider", { enumerable: true, get: function () { return context_1.SiteCatalogProvider; } });
+Object.defineProperty(exports, "ThemeRuntimeProvider", { enumerable: true, get: function () { return context_1.ThemeRuntimeProvider; } });
+Object.defineProperty(exports, "useColorMode", { enumerable: true, get: function () { return context_1.useColorMode; } });
+Object.defineProperty(exports, "useSiteCatalog", { enumerable: true, get: function () { return context_1.useSiteCatalog; } });
+Object.defineProperty(exports, "useSiteConfig", { enumerable: true, get: function () { return context_1.useSiteConfig; } });
+Object.defineProperty(exports, "useSiteSetting", { enumerable: true, get: function () { return context_1.useSiteSetting; } });
+Object.defineProperty(exports, "useSiteUser", { enumerable: true, get: function () { return context_1.useSiteUser; } });
+Object.defineProperty(exports, "useActiveThemeId", { enumerable: true, get: function () { return context_1.useActiveThemeId; } });
+Object.defineProperty(exports, "useIsThemePreview", { enumerable: true, get: function () { return context_1.useIsThemePreview; } });
+Object.defineProperty(exports, "useLocale", { enumerable: true, get: function () { return context_1.useLocale; } });
+Object.defineProperty(exports, "useSiteMeta", { enumerable: true, get: function () { return context_1.useSiteMeta; } });
+Object.defineProperty(exports, "useThemeId", { enumerable: true, get: function () { return context_1.useThemeId; } });
+Object.defineProperty(exports, "useThemeMod", { enumerable: true, get: function () { return context_1.useThemeMod; } });
+Object.defineProperty(exports, "useThemeModBool", { enumerable: true, get: function () { return context_1.useThemeModBool; } });
+Object.defineProperty(exports, "useThemeRuntime", { enumerable: true, get: function () { return context_1.useThemeRuntime; } });
+var hooks_1 = require("./hooks");
+Object.defineProperty(exports, "useAsyncLoading", { enumerable: true, get: function () { return hooks_1.useAsyncLoading; } });
+Object.defineProperty(exports, "useForceUpdate", { enumerable: true, get: function () { return hooks_1.useForceUpdate; } });
+Object.defineProperty(exports, "useNavActive", { enumerable: true, get: function () { return hooks_1.useNavActive; } });
+Object.defineProperty(exports, "usePagination", { enumerable: true, get: function () { return hooks_1.usePagination; } });
+Object.defineProperty(exports, "useReportArticleView", { enumerable: true, get: function () { return hooks_1.useReportArticleView; } });
+Object.defineProperty(exports, "useReportPageView", { enumerable: true, get: function () { return hooks_1.useReportPageView; } });
+Object.defineProperty(exports, "useRouteParam", { enumerable: true, get: function () { return hooks_1.useRouteParam; } });
+Object.defineProperty(exports, "useToggle", { enumerable: true, get: function () { return hooks_1.useToggle; } });
+Object.defineProperty(exports, "useWarningOnExit", { enumerable: true, get: function () { return hooks_1.useWarningOnExit; } });
+var LocaleSwitcher_1 = require("./components/LocaleSwitcher");
+Object.defineProperty(exports, "LocaleSwitcher", { enumerable: true, get: function () { return LocaleSwitcher_1.LocaleSwitcher; } });
+var toolbar_1 = require("./components/toolbar");
+Object.defineProperty(exports, "LanguagesIcon", { enumerable: true, get: function () { return toolbar_1.LanguagesIcon; } });
+Object.defineProperty(exports, "LocaleActiveIcon", { enumerable: true, get: function () { return toolbar_1.LocaleActiveIcon; } });
+Object.defineProperty(exports, "LocaleEnToggleIcon", { enumerable: true, get: function () { return toolbar_1.LocaleEnToggleIcon; } });
+Object.defineProperty(exports, "LocaleToggleButton", { enumerable: true, get: function () { return toolbar_1.LocaleToggleButton; } });
+Object.defineProperty(exports, "LocaleZhToggleIcon", { enumerable: true, get: function () { return toolbar_1.LocaleZhToggleIcon; } });
+Object.defineProperty(exports, "localeToggleLabel", { enumerable: true, get: function () { return toolbar_1.localeToggleLabel; } });
+Object.defineProperty(exports, "MoonIcon", { enumerable: true, get: function () { return toolbar_1.MoonIcon; } });
+Object.defineProperty(exports, "nextLocale", { enumerable: true, get: function () { return toolbar_1.nextLocale; } });
+Object.defineProperty(exports, "SearchIcon", { enumerable: true, get: function () { return toolbar_1.SearchIcon; } });
+Object.defineProperty(exports, "RP_TOOLBAR_BTN_CLASS", { enumerable: true, get: function () { return toolbar_1.RP_TOOLBAR_BTN_CLASS; } });
+Object.defineProperty(exports, "SunIcon", { enumerable: true, get: function () { return toolbar_1.SunIcon; } });
+Object.defineProperty(exports, "ThemeToggleButton", { enumerable: true, get: function () { return toolbar_1.ThemeToggleButton; } });
+Object.defineProperty(exports, "TOOLBAR_ICON_SIZE", { enumerable: true, get: function () { return toolbar_1.TOOLBAR_ICON_SIZE; } });
+Object.defineProperty(exports, "ToolbarIconButton", { enumerable: true, get: function () { return toolbar_1.ToolbarIconButton; } });
+var NavMenu_1 = require("./components/NavMenu");
+Object.defineProperty(exports, "NavMenu", { enumerable: true, get: function () { return NavMenu_1.NavMenu; } });
+var NotFoundPanel_1 = require("./components/NotFoundPanel");
+Object.defineProperty(exports, "NotFoundPanel", { enumerable: true, get: function () { return NotFoundPanel_1.NotFoundPanel; } });
+var PageHeader_1 = require("./components/PageHeader");
+Object.defineProperty(exports, "PageHeader", { enumerable: true, get: function () { return PageHeader_1.PageHeader; } });
+var SiteBranding_1 = require("./components/SiteBranding");
+Object.defineProperty(exports, "SiteBranding", { enumerable: true, get: function () { return SiteBranding_1.SiteBranding; } });
+var SiteDocument_1 = require("./components/SiteDocument");
+Object.defineProperty(exports, "SiteDocument", { enumerable: true, get: function () { return SiteDocument_1.SiteDocument; } });
+var SiteDocumentFallback_1 = require("./components/SiteDocumentFallback");
+Object.defineProperty(exports, "SiteDocumentFallback", { enumerable: true, get: function () { return SiteDocumentFallback_1.SiteDocumentFallback; } });
+var SiteLogo_1 = require("./components/SiteLogo");
+Object.defineProperty(exports, "SiteLogo", { enumerable: true, get: function () { return SiteLogo_1.SiteLogo; } });
+var SiteTagline_1 = require("./components/SiteTagline");
+Object.defineProperty(exports, "SiteTagline", { enumerable: true, get: function () { return SiteTagline_1.SiteTagline; } });
+var TaxonomyList_1 = require("./components/TaxonomyList");
+Object.defineProperty(exports, "TaxonomyList", { enumerable: true, get: function () { return TaxonomyList_1.TaxonomyList; } });
+var ThemeCssVars_1 = require("./components/ThemeCssVars");
+Object.defineProperty(exports, "ThemeCssVars", { enumerable: true, get: function () { return ThemeCssVars_1.ThemeCssVars; } });
+var ThemeLayout_1 = require("./components/ThemeLayout");
+Object.defineProperty(exports, "ThemeLayout", { enumerable: true, get: function () { return ThemeLayout_1.ThemeLayout; } });
+var SiteAnalytics_1 = require("./components/SiteAnalytics");
+Object.defineProperty(exports, "SiteAnalytics", { enumerable: true, get: function () { return SiteAnalytics_1.SiteAnalytics; } });
+var SiteSeo_1 = require("./components/SiteSeo");
+Object.defineProperty(exports, "SiteSeo", { enumerable: true, get: function () { return SiteSeo_1.SiteSeo; } });