@allbluecn/shared 0.2.0

package/src/lib/prd-tree-utils.ts

@@ -0,0 +1,94 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+export interface PRDPage {
+  id: string;
+  name: string;
+  type: "folder" | "page";
+  parentId: string | null;
+  order: number;
+  version: number;
+}
+
+export interface TreeNode extends PRDPage {
+  children: TreeNode[];
+}
+
+export function buildTree(pages: PRDPage[]): TreeNode[] {
+  const map = new Map<string, TreeNode>();
+  const roots: TreeNode[] = [];
+
+  for (const p of pages) {
+    map.set(p.id, { ...p, children: [] });
+  }
+  for (const p of pages) {
+    const node = map.get(p.id)!;
+    if (p.parentId && map.has(p.parentId)) {
+      map.get(p.parentId)!.children.push(node);
+    } else {
+      roots.push(node);
+    }
+  }
+
+  const sortNodes = (nodes: TreeNode[]) => nodes.sort((a, b) => a.order - b.order);
+  sortNodes(roots);
+  for (const node of map.values()) sortNodes(node.children);
+  return roots;
+}
+
+export function flattenTree(nodes: TreeNode[]): PRDPage[] {
+  const result: PRDPage[] = [];
+  for (const n of nodes) {
+    result.push({ id: n.id, name: n.name, type: n.type, parentId: n.parentId, order: n.order, version: n.version });
+    result.push(...flattenTree(n.children));
+  }
+  return result;
+}
+
+export function findNode(nodes: TreeNode[], id: string): TreeNode | null {
+  for (const n of nodes) {
+    if (n.id === id) return n;
+    const found = findNode(n.children, id);
+    if (found) return found;
+  }
+  return null;
+}
+
+export function canMove(node: TreeNode, targetParentId: string | null, allPages: PRDPage[]): boolean {
+  if (node.type === "folder" && targetParentId !== null) return false;
+  if (targetParentId === node.id) return false;
+  const targetPage = allPages.find(p => p.id === targetParentId);
+  if (targetPage?.type === "folder") return false;
+  return true;
+}
+
+export function sortSnapshotsByTree<T extends { pageId: string }>(
+  snapshots: T[],
+  prdPages: PRDPage[],
+): T[] {
+  if (snapshots.length <= 1) return snapshots;
+  const ordered = flattenTree(buildTree(prdPages));
+  const indexMap = new Map(ordered.map((p, i) => [p.id, i]));
+  return [...snapshots].sort((a, b) => {
+    const ia = indexMap.get(a.pageId);
+    const ib = indexMap.get(b.pageId);
+    if (ia === undefined && ib === undefined) return 0;
+    if (ia === undefined) return 1;
+    if (ib === undefined) return -1;
+    return ia - ib;
+  });
+}

package/src/lib/prototype-registry.ts

@@ -0,0 +1,24 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+export {
+  registerComponent,
+  registerComponents,
+  unregisterComponent,
+  getAllComponents,
+  getComponent,
+} from "@allblue/prototype";

package/src/lib/query-client-seam.ts

@@ -0,0 +1,14 @@
+import type { QueryClient } from '@tanstack/react-query'
+
+let instance: QueryClient | null = null
+
+export function setQueryClient(client: QueryClient) {
+  instance = client
+}
+
+export function getQueryClient(): QueryClient {
+  if (!instance) {
+    throw new Error('QueryClient 未注入：宿主需在 router 初始化时调用 setQueryClient()')
+  }
+  return instance
+}

package/src/lib/share-events.ts

@@ -0,0 +1,78 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+const clients = new Map<string, Set<ReadableStreamDefaultController>>();
+
+const MAX_CLIENTS_PER_PRD = 20;
+
+const CLEANUP_INTERVAL = 60_000;
+const IDLE_TIMEOUT = 5 * 60_000;
+
+setInterval(() => {
+  const now = Date.now();
+  for (const [prdId, set] of clients) {
+    for (const controller of set) {
+      try {
+        controller.enqueue(new TextEncoder().encode(":cleanup-ping\n\n"));
+      } catch {
+        set.delete(controller);
+      }
+    }
+    if (set.size === 0) clients.delete(prdId);
+  }
+}, CLEANUP_INTERVAL);
+
+const controllerMeta = new WeakMap<ReadableStreamDefaultController, number>();
+
+export function addClient(prdId: string, controller: ReadableStreamDefaultController) {
+  const set = clients.get(prdId);
+  if (set && set.size >= MAX_CLIENTS_PER_PRD) {
+    throw new Error("连接数已达上限");
+  }
+  if (!set) clients.set(prdId, new Set());
+  clients.get(prdId)!.add(controller);
+  controllerMeta.set(controller, Date.now());
+}
+
+export function removeClient(prdId: string, controller: ReadableStreamDefaultController) {
+  const set = clients.get(prdId);
+  if (!set) return;
+  set.delete(controller);
+  controllerMeta.delete(controller);
+  if (set.size === 0) clients.delete(prdId);
+}
+
+export function notifyClients(prdId: string, event: string, data: unknown) {
+  const set = clients.get(prdId);
+  if (!set) return;
+  const message = new TextEncoder().encode(`event: ${event}\ndata: ${JSON.stringify(data)}\n\n`);
+  for (const controller of set) {
+    try {
+      controller.enqueue(message);
+      controllerMeta.set(controller, Date.now());
+    } catch {
+      set.delete(controller);
+      controllerMeta.delete(controller);
+    }
+  }
+}
+
+export function getClientCount(): number {
+  let total = 0;
+  for (const set of clients.values()) total += set.size;
+  return total;
+}

package/src/lib/sidebar-utils.ts

@@ -0,0 +1,21 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+export function isParentActive(pathname: string, parentLink: string): boolean {
+  if (!parentLink || parentLink === "#") return false;
+  return pathname === parentLink;
+}

package/src/lib/stores/prd-canvas-store.ts

@@ -0,0 +1,69 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+import type { SetStateAction } from 'react'
+import { createStore } from '@tanstack/store'
+import type { CanvasElement } from '../../types/prototype'
+
+interface PrdCanvasState {
+  elements: CanvasElement[]
+  selectedElementId: string | null
+  viewMode: 'edit' | 'preview' | 'prototype'
+}
+
+export type { CanvasElement, PrdCanvasState }
+
+export const prdCanvasStore = createStore<PrdCanvasState>({
+  elements: [],
+  selectedElementId: null,
+  viewMode: 'edit',
+})
+
+export function setCanvasElements(value: SetStateAction<CanvasElement[]>) {
+  prdCanvasStore.setState((s) => ({
+    ...s,
+    elements: typeof value === 'function' ? value(s.elements) : value,
+  }))
+}
+
+export function setCanvasSelectedElementId(id: string | null) {
+  prdCanvasStore.setState((s) => ({
+    ...s,
+    selectedElementId: id,
+  }))
+}
+
+export function setCanvasViewMode(mode: PrdCanvasState['viewMode']) {
+  prdCanvasStore.setState((s) => ({
+    ...s,
+    viewMode: mode,
+  }))
+}
+
+export function updateCanvasElement(id: string, patch: Partial<CanvasElement>) {
+  prdCanvasStore.setState((s) => ({
+    ...s,
+    elements: s.elements.map((e) => (e.id === id ? { ...e, ...patch } : e)),
+  }))
+}
+
+export function deleteCanvasElement(id: string) {
+  prdCanvasStore.setState((s) => ({
+    ...s,
+    elements: s.elements.filter((e) => e.id !== id),
+  }))
+}

package/src/lib/tag-colors.ts

@@ -0,0 +1,35 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+const TAG_COLORS = [
+  { bg: "bg-blue-100 dark:bg-blue-900/30", text: "text-blue-700 dark:text-blue-300", border: "border-blue-200 dark:border-blue-700", selected: "border-blue-500", check: "text-blue-700 dark:text-blue-300", label: "蓝色" },
+  { bg: "bg-emerald-100 dark:bg-emerald-900/30", text: "text-emerald-700 dark:text-emerald-300", border: "border-emerald-200 dark:border-emerald-700", selected: "border-emerald-500", check: "text-emerald-700 dark:text-emerald-300", label: "绿色" },
+  { bg: "bg-violet-100 dark:bg-violet-900/30", text: "text-violet-700 dark:text-violet-300", border: "border-violet-200 dark:border-violet-700", selected: "border-violet-500", check: "text-violet-700 dark:text-violet-300", label: "紫色" },
+  { bg: "bg-amber-100 dark:bg-amber-900/30", text: "text-amber-700 dark:text-amber-300", border: "border-amber-200 dark:border-amber-700", selected: "border-amber-500", check: "text-amber-700 dark:text-amber-300", label: "琥珀" },
+  { bg: "bg-rose-100 dark:bg-rose-900/30", text: "text-rose-700 dark:text-rose-300", border: "border-rose-200 dark:border-rose-700", selected: "border-rose-500", check: "text-rose-700 dark:text-rose-300", label: "玫红" },
+  { bg: "bg-cyan-100 dark:bg-cyan-900/30", text: "text-cyan-700 dark:text-cyan-300", border: "border-cyan-200 dark:border-cyan-700", selected: "border-cyan-500", check: "text-cyan-700 dark:text-cyan-300", label: "青色" },
+  { bg: "bg-orange-100 dark:bg-orange-900/30", text: "text-orange-700 dark:text-orange-300", border: "border-orange-200 dark:border-orange-700", selected: "border-orange-500", check: "text-orange-700 dark:text-orange-300", label: "橙色" },
+  { bg: "bg-pink-100 dark:bg-pink-900/30", text: "text-pink-700 dark:text-pink-300", border: "border-pink-200 dark:border-pink-700", selected: "border-pink-500", check: "text-pink-700 dark:text-pink-300", label: "粉色" },
+];
+
+function hashColorIndex(name: string) {
+  let hash = 0;
+  for (let i = 0; i < name.length; i++) hash = ((hash << 5) - hash) + name.charCodeAt(i);
+  return Math.abs(hash) % TAG_COLORS.length;
+}
+
+export { TAG_COLORS, hashColorIndex };

package/src/lib/time-format.ts

@@ -0,0 +1,50 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+import { formatDate } from "./datetime";
+
+function isSameDay(a: Date, b: Date, timezone: string): boolean {
+  const aDate = formatDate(a, timezone, "yyyy-MM-dd");
+  const bDate = formatDate(b, timezone, "yyyy-MM-dd");
+  return aDate === bDate;
+}
+
+export function formatSaveTime(savedAt: Date, type: "auto" | "manual", timezone: string): string {
+  const now = new Date();
+  const time = formatDate(savedAt, timezone, "HH:mm");
+  const label = type === "auto" ? "自动保存" : "手动保存";
+
+  if (isSameDay(savedAt, now, timezone)) {
+    return `${time} ${label}`;
+  }
+
+  const yesterday = new Date(now);
+  yesterday.setDate(yesterday.getDate() - 1);
+  if (isSameDay(savedAt, yesterday, timezone)) {
+    return `昨日 ${time} ${label}`;
+  }
+
+  const oneYearAgo = new Date(now);
+  oneYearAgo.setFullYear(oneYearAgo.getFullYear() - 1);
+  if (savedAt > oneYearAgo) {
+    const month = formatDate(savedAt, timezone, "MM");
+    const day = formatDate(savedAt, timezone, "dd");
+    return `${month}-${day} ${time} ${label}`;
+  }
+
+  return `1年前 ${label}`;
+}

package/src/modules/ai-providers/constants.ts

@@ -0,0 +1,79 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+// packages/shared/src/modules/ai-providers/constants.ts
+import type { AdapterKind, ProviderCategory } from './types'
+
+export const ADAPTER_KINDS: Array<{ value: AdapterKind; label: string; description: string }> = [
+  { value: 'openai', label: 'OpenAI 官方', description: 'GPT 系列，OpenAI 协议' },
+  { value: 'anthropic', label: 'Anthropic', description: 'Claude 系列，Anthropic 协议' },
+  { value: 'gemini', label: 'Google Gemini', description: 'Gemini 系列，Google 协议' },
+  { value: 'groq', label: 'Groq', description: 'Groq 极速推理引擎' },
+  { value: 'grok', label: 'xAI Grok', description: 'Grok 系列，xAI 协议' },
+  { value: 'openrouter', label: 'OpenRouter 聚合', description: '一个 Key 访问 200+ 模型' },
+  { value: 'ollama', label: 'Ollama 本地', description: '本地部署开源模型，无需 API Key' },
+  { value: 'openai-compatible', label: 'OpenAI 兼容', description: 'DeepSeek/Moonshot/Mistral 等兼容协议' },
+]
+
+export const PROVIDER_CATEGORIES: Array<{ value: ProviderCategory; label: string }> = [
+  { value: 'recommended', label: '推荐' },
+  { value: 'popular', label: '热门' },
+  { value: 'local', label: '本地' },
+]
+
+export const ADAPTER_KIND_VALUES: AdapterKind[] = ADAPTER_KINDS.map((k) => k.value)
+export const PROVIDER_CATEGORY_VALUES: ProviderCategory[] = PROVIDER_CATEGORIES.map((c) => c.value)
+
+export const MODEL_CAPABILITY_OPTIONS: Array<{ value: import('./types').ModelCapability; label: string }> = [
+  { value: 'text', label: '文本' },
+  { value: 'vision', label: '视觉' },
+  { value: 'tools', label: '工具' },
+  { value: 'reasoning', label: '推理' },
+  { value: 'audio', label: '音频' },
+]
+
+/**
+ * 模型管理 tabs 筛选项（参考 lobehub）。
+ * value 对应 ModelCapability，'all' 为全部，'video' 暂预留（无对应 capability）。
+ */
+export type ModelTab = 'all' | 'text' | 'reasoning' | 'tools' | 'vision' | 'video'
+
+export const MODEL_TABS: Array<{ value: ModelTab; label: string }> = [
+  { value: 'all', label: '全部' },
+  { value: 'text', label: '文本' },
+  { value: 'reasoning', label: '推理' },
+  { value: 'tools', label: '对话' },
+  { value: 'vision', label: '图片' },
+  { value: 'video', label: '视频' },
+]
+
+/**
+ * our providerId → @lobehub/icons PascalCase 导出名
+ * 未知 providerId 返回 null，调用方 fallback 到首字母
+ */
+export const LOBE_ICON_MAP: Record<string, string> = {
+  openai: 'OpenAI',
+  anthropic: 'Anthropic',
+  google: 'Gemini',
+  deepseek: 'DeepSeek',
+  groq: 'Groq',
+  xai: 'XAI',
+  openrouter: 'OpenRouter',
+  mistral: 'Mistral',
+  ollama: 'Ollama',
+  moonshot: 'Moonshot',
+}

package/src/modules/ai-providers/index.ts

@@ -0,0 +1,21 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+// packages/shared/src/modules/ai-providers/index.ts
+export * from './types'
+export * from './constants'
+export * from './seed-data'