@fecommunity/reactpress 4.0.0-beta.15 → 4.0.0-beta.18

package/plugins/image-optimizer/admin/api.ts

@@ -0,0 +1,133 @@
+import { resolveApiBaseUrl } from "@fecommunity/reactpress-toolkit/plugin/react";
+
+const DEFAULT_API_BASE = "/api";
+
+export interface ImageOptimizeReport {
+  total: number;
+  alreadyOptimized: number;
+  needsOptimization: number;
+  skipped: {
+    nonImage: number;
+    svg: number;
+    gif: number;
+    missing: number;
+  };
+  storageBytes: {
+    current: number;
+    estimatedAfter: number;
+    estimatedSaved: number;
+  };
+  contentRefs: {
+    articles: number;
+    pages: number;
+  };
+}
+
+export interface OptimizeRunOptions {
+  dryRun?: boolean;
+  batchSize?: number;
+  skipGif?: boolean;
+  rewriteContent?: boolean;
+  cleanupOriginals?: boolean;
+  limit?: number;
+}
+
+export interface OptimizeJobItemResult {
+  fileId: string;
+  originalname: string;
+  status: "success" | "skipped" | "failed";
+  oldUrl?: string;
+  newUrl?: string;
+  savedBytes?: number;
+  error?: string;
+}
+
+export interface OptimizeJob {
+  id: string;
+  status: "pending" | "running" | "completed" | "failed";
+  dryRun: boolean;
+  total: number;
+  processed: number;
+  succeeded: number;
+  failed: number;
+  skipped: number;
+  savedBytes: number;
+  urlMap: Record<string, string>;
+  items: OptimizeJobItemResult[];
+  rewriteContent: boolean;
+  contentRewrite?: {
+    articles: number;
+    pages: number;
+    revisions: number;
+  };
+  error?: string;
+  startedAt: string;
+  finishedAt?: string;
+}
+
+function readAccessToken(): string | null {
+  if (typeof localStorage === "undefined") return null;
+  try {
+    const raw = localStorage.getItem("auth-storage");
+    if (!raw) return null;
+    const parsed = JSON.parse(raw) as { state?: { tokens?: { accessToken?: string } } };
+    return parsed.state?.tokens?.accessToken ?? null;
+  } catch {
+    return null;
+  }
+}
+
+function readApiErrorMessage(err: unknown, fallback: string): string {
+  if (err instanceof Error && err.message.trim()) return err.message;
+  return fallback;
+}
+
+async function optimizeFetch<T>(path: string, init?: RequestInit): Promise<T> {
+  const base = (await resolveApiBaseUrl(DEFAULT_API_BASE)).replace(/\/$/, "");
+  const token = readAccessToken();
+  const res = await fetch(`${base}${path}`, {
+    ...init,
+    headers: {
+      "Content-Type": "application/json",
+      ...(token ? { Authorization: `Bearer ${token}` } : {}),
+      ...init?.headers,
+    },
+  });
+  const body = (await res.json()) as {
+    success?: boolean;
+    code?: number;
+    data?: T;
+    msg?: string;
+    message?: string;
+  };
+  if (res.status === 401) {
+    throw new Error("SESSION_EXPIRED");
+  }
+  if (!res.ok) {
+    throw new Error(body.msg ?? body.message ?? `Request failed: ${res.status}`);
+  }
+  if (typeof body.code === "number" && body.code !== 0) {
+    throw new Error(body.message ?? "Request failed");
+  }
+  if (body.success === false) {
+    throw new Error(body.msg ?? "Request failed");
+  }
+  return body.data as T;
+}
+
+export function fetchOptimizeReport() {
+  return optimizeFetch<ImageOptimizeReport>("/file/optimize/report");
+}
+
+export function startOptimizeJob(options: OptimizeRunOptions) {
+  return optimizeFetch<OptimizeJob>("/file/optimize/run", {
+    method: "POST",
+    body: JSON.stringify(options),
+  });
+}
+
+export function fetchOptimizeJob(jobId: string) {
+  return optimizeFetch<OptimizeJob>(`/file/optimize/job/${encodeURIComponent(jobId)}`);
+}
+
+export { readApiErrorMessage };

package/plugins/image-optimizer/admin/index.ts

@@ -0,0 +1,16 @@
+import type { PluginAdminModule } from "@fecommunity/reactpress-toolkit/plugin/admin";
+
+export { SettingsPanel } from "./OptimizeDashboard";
+
+import { SettingsPanel } from "./OptimizeDashboard";
+
+export function registerAdmin(): void {
+  // Dashboard is mounted via SettingsPanel on the plugin settings page.
+}
+
+const pluginAdmin: PluginAdminModule = {
+  registerAdmin,
+  SettingsPanel,
+};
+
+export default pluginAdmin;

package/plugins/image-optimizer/admin/locale.ts

@@ -0,0 +1,68 @@
+import { useEffect, useMemo, useState } from "react";
+
+import { resolveApiBaseUrl } from "@fecommunity/reactpress-toolkit/plugin/react";
+
+type LocaleMessages = Record<string, unknown>;
+
+function readNestedMessage(messages: LocaleMessages, path: string): string | undefined {
+  const parts = path.split(".");
+  let current: unknown = messages;
+  for (const part of parts) {
+    if (!current || typeof current !== "object") return undefined;
+    current = (current as Record<string, unknown>)[part];
+  }
+  return typeof current === "string" ? current : undefined;
+}
+
+function detectLocale(): string {
+  if (typeof document === "undefined") return "en";
+  const lang = document.documentElement.lang || navigator.language || "en";
+  return lang.toLowerCase().startsWith("zh") ? "zh" : "en";
+}
+
+async function fetchPluginLocale(pluginId: string, locale: string): Promise<LocaleMessages> {
+  const base = (await resolveApiBaseUrl("/api")).replace(/\/$/, "");
+  const token = (() => {
+    try {
+      const raw = localStorage.getItem("auth-storage");
+      if (!raw) return null;
+      const parsed = JSON.parse(raw) as { state?: { tokens?: { accessToken?: string } } };
+      return parsed.state?.tokens?.accessToken ?? null;
+    } catch {
+      return null;
+    }
+  })();
+  const res = await fetch(
+    `${base}/extension/plugins/${encodeURIComponent(pluginId)}/locales/${encodeURIComponent(locale)}`,
+    {
+      headers: {
+        ...(token ? { Authorization: `Bearer ${token}` } : {}),
+      },
+    },
+  );
+  if (!res.ok) return {};
+  const body = (await res.json()) as { data?: { messages?: LocaleMessages } };
+  return body.data?.messages ?? {};
+}
+
+export function usePluginDashboardText(pluginId: string) {
+  const locale = detectLocale();
+  const [messages, setMessages] = useState<LocaleMessages>({});
+
+  useEffect(() => {
+    let cancelled = false;
+    void fetchPluginLocale(pluginId, locale).then((next) => {
+      if (!cancelled) setMessages(next);
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [locale, pluginId]);
+
+  return useMemo(
+    () =>
+      (key: string, fallback: string) =>
+        readNestedMessage(messages, `dashboard.${key}`) ?? fallback,
+    [messages],
+  );
+}

package/plugins/image-optimizer/admin/optimize-dashboard.module.css

@@ -0,0 +1,80 @@
+.optimizeDashboard {
+  margin-bottom: 24px;
+  padding-bottom: 20px;
+  border-bottom: 1px solid var(--ant-color-border-secondary);
+}
+
+.sectionTitle {
+  margin: 0 0 16px;
+  font-size: 14px;
+  font-weight: 600;
+  color: var(--ant-color-text);
+}
+
+.statsGrid {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(140px, 1fr));
+  gap: 12px;
+  margin-bottom: 16px;
+}
+
+.statCard {
+  padding: 12px 14px;
+  border: 1px solid var(--ant-color-border-secondary);
+  border-radius: 8px;
+  background: var(--ant-color-fill-quaternary);
+}
+
+.statLabel {
+  margin: 0 0 4px;
+  font-size: 12px;
+  color: var(--ant-color-text-secondary);
+}
+
+.statValue {
+  margin: 0;
+  font-size: 20px;
+  font-weight: 600;
+  line-height: 1.2;
+  color: var(--ant-color-text);
+}
+
+.actions {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+  margin-bottom: 16px;
+}
+
+.progressBlock {
+  margin-top: 12px;
+}
+
+.hint {
+  margin: 8px 0 0;
+  font-size: 13px;
+  color: var(--ant-color-text-secondary);
+}
+
+.emptyJob {
+  margin: 8px 0 0;
+  font-size: 13px;
+  color: var(--ant-color-text-tertiary);
+}
+
+.warn {
+  margin: 0 0 16px;
+  padding: 10px 12px;
+  border-radius: 8px;
+  background: var(--ant-color-warning-bg);
+  border: 1px solid var(--ant-color-warning-border);
+  color: var(--ant-color-text);
+  font-size: 13px;
+}
+
+.errorList {
+  margin: 8px 0 0;
+  padding-left: 18px;
+  font-size: 13px;
+  color: var(--ant-color-error);
+}

package/plugins/image-optimizer/dist/config.d.ts

@@ -0,0 +1,8 @@
+import type { PluginContext } from '@fecommunity/reactpress-toolkit/plugin/server';
+export interface ImageOptimizerConfig {
+    batchSize: number;
+    skipGif: boolean;
+    rewriteContent: boolean;
+    cleanupOriginals: boolean;
+}
+export declare function resolveConfig(ctx: PluginContext): ImageOptimizerConfig;

package/plugins/image-optimizer/dist/config.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveConfig = resolveConfig;
+function resolveConfig(ctx) {
+    const raw = ctx.config ?? {};
+    const batchSize = Number(raw.batchSize);
+    return {
+        batchSize: Number.isFinite(batchSize) ? Math.min(Math.max(batchSize, 1), 200) : 50,
+        skipGif: raw.skipGif !== false,
+        rewriteContent: raw.rewriteContent === true,
+        cleanupOriginals: raw.cleanupOriginals === true,
+    };
+}

package/plugins/image-optimizer/dist/index.d.ts

@@ -0,0 +1,10 @@
+import type { HookService, PluginContext } from '@fecommunity/reactpress-toolkit/plugin/server';
+/**
+ * 图片资源优化：批量压缩历史素材由 Core FileOptimizationService 执行；
+ * 本插件负责注册与配置，管理端仪表盘见 admin/OptimizeDashboard。
+ */
+export declare function register(_hooks: HookService, ctx: PluginContext): void;
+declare const _default: {
+    register: typeof register;
+};
+export default _default;

package/plugins/image-optimizer/dist/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.register = register;
+const config_1 = require("./config");
+/**
+ * 图片资源优化：批量压缩历史素材由 Core FileOptimizationService 执行；
+ * 本插件负责注册与配置，管理端仪表盘见 admin/OptimizeDashboard。
+ */
+function register(_hooks, ctx) {
+    const config = (0, config_1.resolveConfig)(ctx);
+    ctx.logger.log(`registered (batchSize=${config.batchSize}, skipGif=${config.skipGif}, rewriteContent=${config.rewriteContent})`);
+}
+exports.default = { register };

package/plugins/image-optimizer/locales/en.json

@@ -0,0 +1,51 @@
+{
+  "meta": {
+    "name": "Image Optimizer",
+    "description": "Analyze legacy media and batch-compress to WebP variants; optionally rewrite URLs in articles and pages."
+  },
+  "settings": {
+    "batchSize": {
+      "title": "Batch size",
+      "description": "Maximum images processed per job (1–200)."
+    },
+    "skipGif": {
+      "title": "Skip GIF",
+      "description": "GIF to WebP loses animation; skipped by default."
+    },
+    "rewriteContent": {
+      "title": "Rewrite content URLs after optimize",
+      "description": "Replace old image URLs in articles and pages when the job completes."
+    },
+    "cleanupOriginals": {
+      "title": "Delete originals after optimize",
+      "description": "Enable only after verification; old URLs will stop working."
+    }
+  },
+  "dashboard": {
+    "title": "Asset analysis",
+    "analyze": "Analyze",
+    "dryRun": "Dry run",
+    "run": "Start batch optimize",
+    "refresh": "Refresh",
+    "total": "Total assets",
+    "optimized": "Optimized",
+    "pending": "Pending",
+    "estimatedSaved": "Est. savings",
+    "contentRefs": "Content references",
+    "articles": "Articles",
+    "pages": "Pages",
+    "skipped": "Skipped",
+    "jobRunning": "Optimization in progress…",
+    "jobScanning": "Scanning for optimizable assets…",
+    "jobEmpty": "No images to optimize (already optimized or source files missing).",
+    "jobDone": "Job completed",
+    "jobFailed": "Job failed",
+    "processed": "Processed",
+    "succeeded": "Succeeded",
+    "failed": "Failed",
+    "savedBytes": "Space saved",
+    "inactiveHint": "Activate this plugin from the plugin list before running analysis or optimization.",
+    "analyzeFailed": "Analysis failed",
+    "runFailed": "Failed to start job"
+  }
+}

package/plugins/image-optimizer/locales/zh.json

@@ -0,0 +1,53 @@
+{
+  "meta": {
+    "name": "图片资源优化",
+    "description": "分析历史图片素材并批量压缩为 WebP 多尺寸变体，可选回写文章与页面中的图片 URL。"
+  },
+  "settings": {
+    "batchSize": {
+      "title": "每批处理数量",
+      "description": "单次任务最多处理的图片数量（1–200）。"
+    },
+    "skipGif": {
+      "title": "跳过 GIF",
+      "description": "GIF 转 WebP 后会失去动画，默认跳过。"
+    },
+    "rewriteContent": {
+      "title": "优化后回写内容 URL",
+      "description": "批量优化完成后，自动替换文章/页面中引用的旧图片地址。"
+    },
+    "cleanupOriginals": {
+      "title": "优化后删除原文件",
+      "description": "确认无误后再开启；删除后无法通过旧 URL 访问原图。"
+    }
+  },
+  "dashboard": {
+    "title": "资源分析",
+    "analyze": "分析现状",
+    "dryRun": "试运行（不写入）",
+    "dryRunDone": "试运行完成（未写入数据库）",
+    "run": "开始批量优化",
+    "refresh": "刷新",
+    "total": "素材总数",
+    "optimized": "已优化",
+    "pending": "待优化",
+    "estimatedSaved": "预估可节省",
+    "contentRefs": "内容引用",
+    "articles": "文章",
+    "pages": "页面",
+    "skipped": "已跳过",
+    "jobRunning": "优化任务进行中…",
+    "jobScanning": "正在扫描待优化素材…",
+    "jobEmpty": "没有待优化的图片（可能已全部优化，或原文件已不存在）。",
+    "jobDone": "任务已完成",
+    "jobFailed": "任务失败",
+    "processed": "已处理",
+    "succeeded": "成功",
+    "failed": "失败",
+    "savedBytes": "已节省空间",
+    "inactiveHint": "请先在插件列表中启用本插件，才能执行分析与优化。",
+    "analyzeFailed": "分析失败",
+    "runFailed": "启动任务失败",
+    "jobPollFailed": "获取任务进度失败，请重试"
+  }
+}

package/plugins/image-optimizer/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@fecommunity/reactpress-plugin-image-optimizer",
+  "version": "1.0.0",
+  "private": true,
+  "description": "Legacy image optimization plugin for ReactPress",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@fecommunity/reactpress-toolkit": "workspace:*"
+  },
+  "devDependencies": {
+    "typescript": "~5.9.3"
+  }
+}

package/plugins/image-optimizer/plugin.json

@@ -0,0 +1,58 @@
+{
+  "$schema": "../plugin.manifest.schema.json",
+  "id": "image-optimizer",
+  "name": "图片资源优化",
+  "version": "1.0.0",
+  "description": "分析历史图片素材并批量压缩为 WebP 多尺寸变体，可选回写文章与页面中的图片 URL。",
+  "author": "ReactPress",
+  "requires": ">=3.5.0",
+  "server": {
+    "module": "./dist/index.js"
+  },
+  "admin": {
+    "menu": {
+      "title": "图片优化",
+      "path": "/plugins/image-optimizer/settings",
+      "permission": "extension:manage",
+      "sort": 30
+    }
+  },
+  "settings": {
+    "schema": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "batchSize": {
+          "type": "integer",
+          "title": "每批处理数量",
+          "description": "单次任务最多处理的图片数量（1–200）。",
+          "minimum": 1,
+          "maximum": 200,
+          "default": 50
+        },
+        "skipGif": {
+          "type": "boolean",
+          "title": "跳过 GIF",
+          "description": "GIF 转 WebP 后会失去动画，默认跳过。",
+          "default": true
+        },
+        "rewriteContent": {
+          "type": "boolean",
+          "title": "优化后回写内容 URL",
+          "description": "批量优化完成后，自动替换文章/页面中引用的旧图片地址。",
+          "default": false
+        },
+        "cleanupOriginals": {
+          "type": "boolean",
+          "title": "优化后删除原文件",
+          "description": "确认无误后再开启；删除后无法通过旧 URL 访问原图。",
+          "default": false
+        }
+      }
+    }
+  },
+  "permissions": ["file:read", "file:write", "article:read"],
+  "capabilities": {
+    "headless": true
+  }
+}

package/plugins/image-optimizer/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "rootDir": "./src",
+    "outDir": "./dist",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/plugins/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "@fecommunity/reactpress-plugins",
+  "version": "1.0.0",
+  "private": true,
+  "description": "ReactPress plugin registry — local and npm plugin sources for the publishing platform",
+  "license": "MIT",
+  "scripts": {
+    "build": "pnpm --filter @fecommunity/reactpress-plugin-hello-world run build && pnpm --filter @fecommunity/reactpress-plugin-seo run build && pnpm --filter @fecommunity/reactpress-plugin-image-optimizer run build",
+    "typecheck": "pnpm --filter @fecommunity/reactpress-plugin-hello-world run typecheck && pnpm --filter @fecommunity/reactpress-plugin-seo run typecheck && pnpm --filter @fecommunity/reactpress-plugin-image-optimizer run typecheck"
+  },
+  "reactpress": {
+    "local": ["hello-world", "seo", "image-optimizer"]
+  }
+}

package/plugins/seo/README.md

@@ -0,0 +1,60 @@
+# seo (SEO Enhancement)
+
+Official plugin — **URL slug**, **SEO keywords**, and **meta description** with optional auto-fill and an Admin editor panel.
+
+> WordPress-style SEO fields · Headless-friendly meta for Next.js themes
+
+- **Plugin id**: `seo`
+- **Version**: see [`plugin.json`](./plugin.json)
+
+## Features
+
+| Field | Description |
+| :--- | :--- |
+| `slug` | URL alias, accessible at `/article/{slug}` |
+| `seoKeywords` | meta keywords, comma-separated |
+| `seoDescription` | meta description |
+
+| Scenario | Behavior (when plugin enabled and option on) |
+| :--- | :--- |
+| Slug empty | Generate slug from title |
+| SEO description empty | Prefer summary, else truncate body |
+| SEO keywords empty | Use title + tag names |
+
+## Hooks
+
+| Hook | Type | Description |
+| :--- | :--- | :--- |
+| `article.beforeCreate` | filter | Fill SEO fields on create |
+| `article.beforePublish` | filter | Fill SEO fields on publish |
+
+## Configuration
+
+| Field | Type | Default | Description |
+| :--- | :--- | :--- | :--- |
+| `enabled` | boolean | `true` | Master switch |
+| `autoSlug` | boolean | `true` | Auto-generate slug |
+| `autoDescription` | boolean | `true` | Auto-generate description |
+| `autoKeywords` | boolean | `true` | Auto-generate keywords |
+| `descriptionMaxLength` | number | `160` | Max description length |
+| `descriptionSuffix` | string | `…` | Truncation suffix |
+
+## Usage
+
+1. `pnpm dev` (plugins are compiled automatically)
+2. Admin → **Plugins** → install **SEO Enhancement** → **Enable**
+3. Fill slug, keywords, and description in the **SEO Settings** panel (leave empty for auto-fill)
+4. After publish, check `<meta name="description">` and `<meta name="keywords">` on the theme article page
+
+## Admin UI
+
+The **SEO Settings** panel in the article editor is injected via Admin slot `article.editor.meta.afterSummary` (see [`admin/`](./admin/)). The panel unmounts automatically when the plugin is deactivated.
+
+## Development
+
+```bash
+pnpm --filter @fecommunity/reactpress-plugin-seo run build
+pnpm --filter @fecommunity/reactpress-plugin-seo run typecheck
+```
+
+See [`../README.md`](../README.md) for the plugin system overview.