@bbki.ng/site 5.5.14 → 5.5.16

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @bbki.ng/site
 
+## 5.5.16
+
+### Patch Changes
+
+- 22df0c4: fix global loading
+
+## 5.5.15
+
+### Patch Changes
+
+- b377c66: add new plugin
+- Updated dependencies [b377c66]
+  - @bbki.ng/ui@0.2.11
+
 ## 5.5.14
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bbki.ng/site",
-  "version": "5.5.14",
+  "version": "5.5.16",
   "description": "code behind bbki.ng",
   "main": "index.js",
   "type": "module",
@@ -14,7 +14,7 @@
     "react-dom": "^18.0.0",
     "react-router-dom": "6",
     "swr": "^2.2.5",
-    "@bbki.ng/ui": "0.2.10"
+    "@bbki.ng/ui": "0.2.11"
   },
   "devDependencies": {
     "@eslint/compat": "^1.0.0",

package/src/blog/app.tsx

@@ -11,10 +11,9 @@ import { SWR } from '@/swr';
 import { GlobalLoadingContext } from '@/context/global_loading_state_provider';
 import { BotRedirect } from '@/pages/bot';
 import { BBContext } from '@/context/bbcontext';
+import { Slot } from '#/core/components/SlotComp';
+import { usePlugins } from '#/core/hooks/use_plugins';
 import { useDynamicLogo } from './hooks/use_dynamic_logo';
-import { Slot } from '../core/components/SlotComp';
-import { pluginManager } from '#/core/pluginManager';
-import { useSticker } from './hooks/use_sticker';
 
 const Layout = () => {
   const paths = usePaths();
@@ -60,7 +59,7 @@ const Layout = () => {
 };
 
 export const App = () => {
-  useSticker();
+  usePlugins(['sticker', 'fontstyler']);
 
   return (
     <SWR>

package/src/blog/components/Spinner.tsx

@@ -1,20 +1,10 @@
-import React, { useContext, useEffect } from 'react';
-import { GlobalLoadingContext } from '@/context/global_loading_state_provider';
+import React from 'react';
+import { useLoading } from '@/hooks';
 
 export const Spinner = (props: { disableDotIndicator?: boolean }) => {
   const { disableDotIndicator } = props;
 
-  const { setIsLoading } = useContext(GlobalLoadingContext);
-
-  useEffect(() => {
-    if (disableDotIndicator) {
-      return;
-    }
-    setIsLoading(true);
-    return () => {
-      setIsLoading(false);
-    };
-  }, []);
+  useLoading('spinner', !disableDotIndicator);
 
   return <div className="h-full w-full grid place-items-center"></div>;
 };

package/src/blog/context/global_loading_state_provider.tsx

@@ -1,29 +1,69 @@
-import React, { createContext, ReactNode, useState, Dispatch, SetStateAction } from 'react';
+import React, { createContext, ReactNode, useState, useCallback, useMemo } from 'react';
 import { useFontLoading } from '@/hooks/use_font_loading';
 
+type LoadingStates = Map<string, boolean>;
+
 type LoadingContext = {
   isLoading: boolean;
   isFontLoading: boolean;
-  setIsLoading: Dispatch<SetStateAction<boolean>>;
+  register: (id: string) => void;
+  setLoading: (id: string, loading: boolean) => void;
+  unregister: (id: string) => void;
 };
 
 export const GlobalLoadingContext = createContext<LoadingContext>({
   isFontLoading: false,
   isLoading: false,
-  setIsLoading: () => false,
+  register: () => {},
+  setLoading: () => {},
+  unregister: () => {},
 });
 
 export const GlobalLoadingStateProvider = (props: { children: ReactNode }) => {
-  const [isLoading, setIsLoading] = useState(false);
+  const [loadingStates, setLoadingStates] = useState<LoadingStates>(new Map());
   const isFontLoading = useFontLoading();
+
+  const register = useCallback((id: string) => {
+    setLoadingStates(prev => {
+      const next = new Map(prev);
+      next.set(id, false);
+      return next;
+    });
+  }, []);
+
+  const setLoading = useCallback((id: string, loading: boolean) => {
+    setLoadingStates(prev => {
+      const next = new Map(prev);
+      next.set(id, loading);
+      return next;
+    });
+  }, []);
+
+  const unregister = useCallback((id: string) => {
+    setLoadingStates(prev => {
+      const next = new Map(prev);
+      next.delete(id);
+      return next;
+    });
+  }, []);
+
+  const isLoading = useMemo(() => {
+    return Array.from(loadingStates.values()).some(Boolean);
+  }, [loadingStates]);
+
+  const contextValue = useMemo(
+    () => ({
+      isLoading,
+      isFontLoading,
+      register,
+      setLoading,
+      unregister,
+    }),
+    [isLoading, isFontLoading, register, setLoading, unregister]
+  );
+
   return (
-    <GlobalLoadingContext.Provider
-      value={{
-        isLoading,
-        setIsLoading,
-        isFontLoading,
-      }}
-    >
+    <GlobalLoadingContext.Provider value={contextValue}>
       {props.children}
     </GlobalLoadingContext.Provider>
   );

package/src/blog/hooks/index.ts

@@ -1,3 +1,4 @@
 export { usePaths } from './use_paths';
 export { useStreaming } from './use_streaming';
 export type { StreamingItem } from './use_streaming';
+export { useLoading } from './use_loading';

package/src/blog/hooks/use_loading.ts

@@ -0,0 +1,29 @@
+import { useContext, useEffect } from 'react';
+import { GlobalLoadingContext } from '@/context/global_loading_state_provider';
+
+/**
+ * Hook to register a loading state with the global loading context.
+ * The global loading state is true if ANY registered loading state is true.
+ *
+ * @param id - Unique identifier for this loading state
+ * @param loading - Whether this specific loading state is active
+ *
+ * @example
+ * // In a data fetching hook
+ * useLoading('posts', isDataLoading);
+ *
+ * @example
+ * // In a component
+ * useLoading('spinner', true);
+ */
+export function useLoading(id: string, loading: boolean) {
+  const { register, setLoading, unregister } = useContext(GlobalLoadingContext);
+
+  useEffect(() => {
+    register(id);
+    setLoading(id, loading);
+    return () => {
+      unregister(id);
+    };
+  }, [id, loading, register, setLoading, unregister]);
+}

package/src/blog/hooks/use_posts.ts

@@ -1,55 +1,71 @@
 import useSWR from 'swr';
-import { useContext, useEffect } from 'react';
-import { GlobalLoadingContext } from '@/context/global_loading_state_provider';
+import { useMemo } from 'react';
+import { useLoading } from '@/hooks';
 import { baseFetcher } from '@/utils';
 import { API_ENDPOINT } from '@/constants/routes';
+import { useMiddlewareTransData } from '#/core/hooks';
 
 // In dev, use /api prefix to leverage Vite proxy to localhost:8787
 const isProd = true;
 // const isProd = typeof window !== 'undefined' && /^https:\/\/bbki\.ng/.test(window.location.href);
 const POSTS_API = !isProd ? '/api/posts' : `${API_ENDPOINT}/posts`;
 
-// Use baseFetcher for full URLs, cfApiFetcher is for relative paths
-const postsFetcher = (resource: string) => baseFetcher(resource);
+export interface TitleListItem {
+  name: string;
+  to: string;
+  children: string;
+  className?: string;
+}
 
 export const usePosts = (name: string = '', suspense?: boolean) => {
-  const { data: response, error } = useSWR(POSTS_API, postsFetcher, {
+  const { data: response, error: swrError } = useSWR(POSTS_API, baseFetcher, {
     revalidateOnFocus: false,
     suspense,
   });
 
   // Extract posts array from API response { status: "success", data: [...] }
   const data = response?.data;
+  const isDataLoading = !data && !swrError;
 
-  let isLoading = !data && !error;
-  const { setIsLoading } = useContext(GlobalLoadingContext);
-  const titleList =
-    isLoading || error || !data
-      ? []
-      : [
-          ...data.map((p: any) => ({
-            name: p.title,
-            to: p.title,
-            children: p.title,
-          })),
-          {
-            name: 'cd ~',
-            to: '/',
-            children: 'cd ~',
-          },
-        ];
-
-  useEffect(() => {
-    setIsLoading(isLoading);
-  }, [isLoading]);
+  // Build base title list from posts data
+  const baseTitleList: TitleListItem[] = useMemo(() => {
+    if (!data || swrError) return [];
+    return [
+      ...data.map((p: any) => ({
+        name: p.title,
+        to: p.title,
+        children: p.title,
+      })),
+      {
+        name: 'cd ~',
+        to: '/',
+        children: 'cd ~',
+      },
+    ];
+  }, [data, swrError]);
+
+  // Use middleware hook to transform title list
+  const {
+    data: titleList,
+    loading: isTransforming,
+    error: transformError,
+  } = useMiddlewareTransData({
+    hookPoint: 'transformTitleList',
+    baseData: baseTitleList,
+    immediate: baseTitleList.length > 0,
+  });
+
+  useLoading('posts', isDataLoading || isTransforming);
 
   const posts =
-    isLoading || name == '' || error || !data ? data : data.find((p: any) => p.title == name);
+    isDataLoading || name === '' || swrError || !data
+      ? data
+      : data.find((p: any) => p.title === name);
 
   return {
-    posts: posts,
-    titleList,
-    isError: error,
-    isLoading: !data && !error,
+    posts,
+    titleList: titleList ?? [],
+    isError: swrError || transformError,
+    isLoading: isDataLoading || (baseTitleList.length > 0 && isTransforming),
   };
 };

package/src/blog/hooks/use_streaming.ts

@@ -2,8 +2,8 @@ import useSWR from 'swr';
 import useSWRInfinite from 'swr/infinite';
 import { baseFetcher, withBBApi } from '@/utils';
 import { API_ENDPOINT } from '@/constants/routes';
-import { useContext, useEffect, useState, useCallback } from 'react';
-import { GlobalLoadingContext } from '@/context/global_loading_state_provider';
+import { useEffect, useState, useCallback } from 'react';
+import { useLoading } from '@/hooks';
 
 // In dev, use /api prefix to leverage Vite proxy to localhost:8787
 // const isProd = typeof window !== 'undefined' && /^https:\/\/bbki.ng/.test(window.location.href);
@@ -101,11 +101,7 @@ export function useStreaming(options: UseStreamingOptions = {}) {
     });
   }, []);
 
-  const { setIsLoading } = useContext(GlobalLoadingContext);
-
-  useEffect(() => {
-    setIsLoading(isLoading);
-  }, [isLoading, setIsLoading]);
+  useLoading('streaming', isLoading);
 
   return {
     streaming: data?.data ?? [],

package/src/core/components/SlotComp.tsx

@@ -4,7 +4,7 @@ import { useSlotComp } from '../hooks/useSlotComp';
 
 export interface ISlotProps {
   name: SlotName;
-  data?: any;
+  data?: unknown;
 }
 
 export const Slot: React.FC<ISlotProps> = ({ name, data }) => {

package/src/core/hooks/index.ts

@@ -0,0 +1,6 @@
+export { useSlotComp } from './useSlotComp';
+export { useMiddlewareTransData } from './useMiddlewareTransData';
+export type {
+  UseMiddlewareTransDataOptions,
+  UseMiddlewareTransDataResult,
+} from './useMiddlewareTransData';

package/src/core/hooks/useMiddlewareTransData.ts

@@ -0,0 +1,68 @@
+import { useState, useEffect, useCallback, useRef } from 'react';
+
+import { registry } from '#/core/registry';
+import type { HookPoint } from '#/types/slots';
+
+export interface UseMiddlewareTransDataOptions<T> {
+  hookPoint: HookPoint;
+  baseData: T;
+  immediate?: boolean;
+}
+
+export interface UseMiddlewareTransDataResult<T> {
+  data: T | undefined;
+  loading: boolean;
+  error: Error | null;
+  run: () => Promise<T>;
+}
+
+export function useMiddlewareTransData<T>({
+  hookPoint,
+  baseData,
+  immediate = true,
+}: UseMiddlewareTransDataOptions<T>): UseMiddlewareTransDataResult<T> {
+  const [data, setData] = useState<T | undefined>(undefined);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState<Error | null>(null);
+
+  const immediateRef = useRef(immediate);
+  immediateRef.current = immediate;
+
+  const run = useCallback(async (): Promise<T> => {
+    setLoading(true);
+    setError(null);
+
+    try {
+      const result = await registry.runMiddleware(hookPoint, baseData);
+      setData(result);
+      return result;
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error(String(err));
+      setError(error);
+      throw error;
+    } finally {
+      setLoading(false);
+    }
+  }, [hookPoint, baseData]);
+
+  useEffect(() => {
+    if (!immediateRef.current) return;
+
+    let cancelled = false;
+
+    run()
+      .then(result => {
+        if (cancelled) return;
+        setData(result);
+      })
+      .catch(() => {
+        // 错误已在 run 中设置到 state
+      });
+
+    return () => {
+      cancelled = true;
+    };
+  }, [hookPoint, baseData, run]);
+
+  return { data, loading, error, run };
+}

package/src/core/hooks/use_plugins.ts

@@ -0,0 +1,28 @@
+import { useEffect } from 'react';
+
+import { pluginManager } from '#/core/pluginManager';
+
+/**
+ * 通用插件管理 hook
+ * 根据传入的插件ID列表加载和卸载插件
+ *
+ * @param pluginIds - 要加载的插件ID列表
+ *
+ * @example
+ * usePlugins(['sticker', 'fontstyler']);
+ */
+export const usePlugins = (pluginIds: string[]) => {
+  useEffect(() => {
+    // 加载指定的插件
+    pluginIds.forEach(id => {
+      pluginManager.loadPlugin(id);
+    });
+
+    return () => {
+      // 卸载所有指定的插件
+      pluginIds.forEach(id => {
+        pluginManager.disablePlugin(id);
+      });
+    };
+  }, [pluginIds]);
+};

package/src/core/pluginManager.ts

@@ -1,3 +1,5 @@
+import React from 'react';
+
 import { IHostContext } from '#/types/hostApi';
 import { registry } from './registry';
 import type { SlotName, HookPoint } from '#/types/slots';

package/src/plugins/fontstyler/index.ts

@@ -0,0 +1,132 @@
+import { IHostContext } from '#/types/hostApi';
+import { IPlugin } from '#/types/plugin';
+
+export interface TitleListItem {
+  name: string;
+  to: string;
+  children: string;
+  className?: string;
+}
+
+export interface FontConfig {
+  name: string;
+  src: string;
+  format: 'woff2' | 'woff' | 'ttf' | 'otf';
+  fontWeight?: string;
+  fontStyle?: string;
+}
+
+export interface FontRule {
+  match: string | RegExp;
+  fontFamily: string;
+  fontConfig?: FontConfig;
+  extraCls?: string;
+}
+
+class FontStylerPlugin implements IPlugin {
+  id = 'fontstyler';
+  name = 'Font Styler';
+  description = 'Apply custom fonts to specific post titles';
+  version = '1.0.0';
+  author = 'bbki.ng';
+
+  /**
+   * 配置：标题匹配规则 → 字体配置
+   * 支持精确字符串匹配或正则表达式匹配
+   *
+   * 示例：
+   * - 精确匹配: { match: '某篇文章标题', fontFamily: 'CustomFont1', fontConfig: {...} }
+   * - 正则匹配: { match: /^示例/, fontFamily: 'CustomFont2', fontConfig: {...} }
+   */
+  private fontRules: FontRule[] = [
+    {
+      match: '小乌鸦合集',
+      fontFamily: 'xwy',
+      fontConfig: {
+        name: 'xwy',
+        src: '/fonts/xwy.woff2',
+        format: 'woff2',
+      },
+      extraCls: 'text-2xl',
+    },
+  ];
+
+  private loadedFonts = new Set<string>();
+
+  onInstall = (ctx: IHostContext) => {
+    // 加载所有需要的字体文件
+    this.fontRules.forEach(rule => {
+      if (rule.fontConfig && !this.loadedFonts.has(rule.fontConfig.name)) {
+        this.loadFont(rule.fontConfig);
+        this.loadedFonts.add(rule.fontConfig.name);
+      }
+    });
+
+    ctx.api.registerMiddleware(
+      'transformTitleList',
+      this.transformTitleList,
+      this.id,
+      10 // weight
+    );
+  };
+
+  /**
+   * 动态加载字体文件
+   * 通过创建 style 标签添加 @font-face 规则
+   */
+  private loadFont = (config: FontConfig) => {
+    const styleId = `font-${config.name}`;
+    if (document.getElementById(styleId)) return;
+
+    const style = document.createElement('style');
+    style.id = styleId;
+    style.textContent = `
+      @font-face {
+        font-family: '${config.name}';
+        src: url('${config.src}') format('${config.format}');
+        font-weight: ${config.fontWeight || 'normal'};
+        font-style: ${config.fontStyle || 'normal'};
+        font-display: swap;
+      }
+      .font-${config.name} {
+        font-family: '${config.name}', monospace;
+      }
+    `;
+    document.head.appendChild(style);
+  };
+
+  /**
+   * 转换标题列表，为匹配的标题添加字体类名
+   */
+  private transformTitleList = (titleList: TitleListItem[]): TitleListItem[] => {
+    return titleList.map(item => {
+      for (const rule of this.fontRules) {
+        const match =
+          typeof rule.match === 'string' ? item.name === rule.match : rule.match.test(item.name);
+
+        if (match) {
+          return {
+            ...item,
+            className: `font-${rule.fontFamily} ${rule.extraCls || ''}`.trim(),
+          };
+        }
+      }
+      return item;
+    });
+  };
+
+  onDisable = async () => {
+    // 清理加载的字体样式
+    this.loadedFonts.forEach(fontName => {
+      const styleEl = document.getElementById(`font-${fontName}`);
+      if (styleEl) {
+        styleEl.remove();
+      }
+    });
+    this.loadedFonts.clear();
+  };
+
+  onDestroy = () => {};
+}
+
+export default new FontStylerPlugin();

package/src/plugins/manifest.ts

@@ -11,4 +11,10 @@ export const PLUGIN_MANIFEST = [
     version: '0.1.0',
     description: 'A sticker plugin',
   },
+  {
+    name: 'fontstyler',
+    id: 'fontstyler',
+    version: '0.1.0',
+    description: 'Apply custom fonts to specific post',
+  },
 ];

package/src/types/hostApi.ts

@@ -1,12 +1,19 @@
+import React from 'react';
+
 import { HookPoint, SlotName } from './slots';
 import { type FingerprintData } from '@/utils/fingerprints';
 
 export interface IHostApi {
   getDeviceId: () => Promise<{ id: string; fp: FingerprintData }>;
-  registerMiddleware: (point: HookPoint, fn: Function, pluginId: string, weight?: number) => void;
-  registerSlot: (
+  registerMiddleware: <T>(
+    point: HookPoint,
+    fn: (baseData: T) => T,
+    pluginId: string,
+    weight?: number
+  ) => void;
+  registerSlot: <T>(
     slotName: SlotName,
-    component: React.ComponentType<any>,
+    component: React.ComponentType<T>,
     pluginId: string,
     weight?: number
   ) => void;

package/src/types/slots.ts

@@ -1,2 +1,2 @@
 export type SlotName = 'leftCol' | 'rightCol' | 'articleActionRow';
-export type HookPoint = 'filterPosts' | 'transformPostContent';
+export type HookPoint = 'filterPosts' | 'transformPostContent' | 'transformTitleList';