@allbluecn/shared 0.2.0

package/src/modules/dependencies/index.ts

@@ -0,0 +1,186 @@
+// 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/dependencies/index.ts
+// 第三方依赖版本管理：类型 + 常量 + 预设关注列表
+
+/** 依赖分类 */
+export type DependencyCategory =
+  | 'framework' // 框架核心（TanStack Start / React / Vite / Prisma）
+  | 'ui' // UI 组件库（radix / motion / lucide / tailwind）
+  | 'editor' // 编辑器（TipTap / mind-elixir / lowlight）
+  | 'ai' // AI 相关（@tanstack/ai / openai）
+  | 'state' // 状态管理（react-query / react-form）
+  | 'auth' // 认证（start-authjs / @auth/core / bcryptjs）
+  | 'tool' // 工具库（zod / nanoid / i18next / sonner）
+  | 'other'
+
+/** 优先级 */
+export type DependencyPriority = 'high' | 'normal' | 'low'
+
+/** 版本状态（前端展示用，由 serverFn 计算） */
+export type VersionStatus = 'latest' | 'patch' | 'minor' | 'major' | 'unknown'
+
+/** 依赖分类元信息 */
+export const DEPENDENCY_CATEGORIES: Array<{
+  value: DependencyCategory
+  label: string
+  description: string
+}> = [
+  { value: 'framework', label: '框架核心', description: 'TanStack Start / React / Vite / Prisma 等基础设施' },
+  { value: 'ui', label: 'UI 组件', description: 'radix / motion / lucide / tailwind 等界面库' },
+  { value: 'editor', label: '编辑器', description: 'TipTap / mind-elixir / lowlight 等富文本/思维导图' },
+  { value: 'ai', label: 'AI 能力', description: '@tanstack/ai / openai 等 LLM 集成' },
+  { value: 'state', label: '状态管理', description: 'react-query / react-form 等状态/数据层' },
+  { value: 'auth', label: '认证', description: 'start-authjs / @auth/core / bcryptjs' },
+  { value: 'tool', label: '工具库', description: 'zod / nanoid / i18next 等通用工具' },
+  { value: 'other', label: '其他', description: '未分类依赖' },
+]
+
+export const DEPENDENCY_PRIORITIES: Array<{
+  value: DependencyPriority
+  label: string
+}> = [
+  { value: 'high', label: '高' },
+  { value: 'normal', label: '中' },
+  { value: 'low', label: '低' },
+]
+
+/** monorepo 中某个 app 的使用情况 */
+export interface DependencyUsage {
+  /** 相对路径，如 "apps/web" */
+  app: string
+  /** 该 app 的 package.json 中声明的版本（semver range，如 "^3.23.6"） */
+  declaredRange: string
+}
+
+/** DB 行 + 实时聚合数据（列表页主结构） */
+export interface ThirdPartyDependencyRow {
+  id: string
+  /** npm 包名 */
+  name: string
+  /** 展示名（默认取 name） */
+  displayName: string
+  /** 依赖用途说明 */
+  description: string | null
+  /** 官网 / 仓库地址 */
+  homepage: string | null
+  /** npm 包页面地址 */
+  npmUrl: string
+  category: DependencyCategory
+  isWatched: boolean
+  priority: DependencyPriority
+  /** 项目中实际使用的版本信息（聚合 monorepo，来自 package.json，不缓存） */
+  usages: DependencyUsage[]
+  /** 当前使用版本（取 usages 中第一个 semver clean 值，便于表格直接展示） */
+  currentVersion: string | null
+  /** 缓存的 npm registry latest 版本 */
+  latestVersion: string | null
+  /** 最新版本的更新日志（GitHub Releases，markdown 原文） */
+  latestChangelog: string | null
+  /** 最后同步时间（ISO） */
+  lastSyncAt: string | null
+  /** 版本状态（由 currentVersion / latestVersion 比较得出） */
+  versionStatus: VersionStatus
+  notes: string | null
+  sortOrder: number
+  updatedAt: string
+}
+
+/** 编辑表单 payload */
+export interface UpdateDependencyInput {
+  displayName?: string
+  description?: string | null
+  homepage?: string | null
+  category?: DependencyCategory
+  isWatched?: boolean
+  priority?: DependencyPriority
+  notes?: string | null
+  sortOrder?: number
+}
+
+/** 单个包同步结果 */
+export interface SyncDependencyResult {
+  name: string
+  success: boolean
+  latestVersion?: string
+  homepage?: string | null
+  changelog?: string | null
+  error?: string
+}
+
+/**
+ * 预设关注列表（首次启动 seed 用）。
+ * 只放核心关注包；其余 monorepo 依赖在 list 时动态归入「全部依赖」分组。
+ * homepage 取官网或 GitHub 仓库，npmUrl 由 name 推导（不存表）。
+ */
+export interface DependencySeed {
+  name: string
+  displayName: string
+  description: string
+  homepage: string
+  category: DependencyCategory
+  priority: DependencyPriority
+}
+
+export const DEFAULT_WATCHED_DEPENDENCIES: DependencySeed[] = [
+  // framework
+  { name: '@tanstack/react-start', displayName: 'TanStack Start', description: '全栈 React 框架，文件路由 + SSR/SSG', homepage: 'https://tanstack.com/start', category: 'framework', priority: 'high' },
+  { name: '@tanstack/react-router', displayName: 'TanStack Router', description: '类型安全的路由库，支持文件路由与代码拆分', homepage: 'https://tanstack.com/router', category: 'framework', priority: 'high' },
+  { name: 'vite', displayName: 'Vite', description: '下一代前端构建工具，ESM 原生 + 极速 HMR', homepage: 'https://vite.dev', category: 'framework', priority: 'high' },
+  { name: 'react', displayName: 'React', description: '声明式 UI 库，组件化开发基础', homepage: 'https://react.dev', category: 'framework', priority: 'high' },
+  { name: 'react-dom', displayName: 'React DOM', description: 'React 的 DOM 渲染器', homepage: 'https://react.dev', category: 'framework', priority: 'high' },
+  { name: 'prisma', displayName: 'Prisma', description: 'TypeScript ORM，Schema 优先的数据库工具链', homepage: 'https://prisma.io', category: 'framework', priority: 'high' },
+  { name: '@prisma/client', displayName: 'Prisma Client', description: 'Prisma 自动生成的类型安全查询客户端', homepage: 'https://prisma.io', category: 'framework', priority: 'high' },
+  { name: 'start-authjs', displayName: 'start-authjs', description: 'TanStack Start 的 Auth.js 集成，提供登录态管理', homepage: 'https://github.com/kophzeior/start-authjs', category: 'auth', priority: 'high' },
+  { name: '@auth/core', displayName: 'Auth.js Core', description: 'Auth.js 核心，支持 Credentials/OAuth 等多种登录方式', homepage: 'https://authjs.dev', category: 'auth', priority: 'normal' },
+
+  // editor
+  { name: '@tiptap/core', displayName: 'TipTap Core', description: '无头（headless）富文本编辑器核心，可扩展', homepage: 'https://tiptap.dev', category: 'editor', priority: 'high' },
+  { name: '@tiptap/react', displayName: 'TipTap React', description: 'TipTap 编辑器的 React 绑定', homepage: 'https://tiptap.dev', category: 'editor', priority: 'high' },
+  { name: '@tiptap/starter-kit', displayName: 'TipTap Starter Kit', description: 'TipTap 预置扩展集合（段落/列表/历史等）', homepage: 'https://tiptap.dev', category: 'editor', priority: 'normal' },
+  { name: 'mind-elixir', displayName: 'Mind Elixir', description: '轻量思维导图库，支持节点编辑与导出', homepage: 'https://github.com/ssshooter/mind-elixir', category: 'editor', priority: 'high' },
+  { name: 'lowlight', displayName: 'Lowlight', description: '基于 highlight.js 的语法高亮解析器', homepage: 'https://github.com/wooorm/lowlight', category: 'editor', priority: 'normal' },
+
+  // ai
+  { name: '@tanstack/ai', displayName: 'TanStack AI', description: '类型安全的 LLM SDK，支持流式输出与工具调用', homepage: 'https://tanstack.com/ai', category: 'ai', priority: 'high' },
+  { name: '@tanstack/ai-react', displayName: 'TanStack AI React', description: 'TanStack AI 的 React hooks（useChat 等）', homepage: 'https://tanstack.com/ai', category: 'ai', priority: 'normal' },
+  { name: '@tanstack/ai-openai', displayName: 'TanStack AI OpenAI Adapter', description: 'TanStack AI 的 OpenAI 官方模型适配器', homepage: 'https://tanstack.com/ai', category: 'ai', priority: 'normal' },
+  { name: '@tanstack/ai-anthropic', displayName: 'TanStack AI Anthropic Adapter', description: 'TanStack AI 的 Anthropic Claude 适配器', homepage: 'https://tanstack.com/ai', category: 'ai', priority: 'normal' },
+  { name: '@tanstack/ai-openrouter', displayName: 'TanStack AI OpenRouter Adapter', description: 'OpenRouter 多模型聚合适配器', homepage: 'https://tanstack.com/ai', category: 'ai', priority: 'normal' },
+  { name: 'openai', displayName: 'OpenAI SDK', description: 'OpenAI 官方 SDK，本项目用于 embedding 生成', homepage: 'https://openai.com', category: 'ai', priority: 'normal' },
+
+  // ui
+  { name: 'radix-ui', displayName: 'Radix UI', description: '无样式可访问组件库统一入口（dialog/menu 等）', homepage: 'https://radix-ui.com', category: 'ui', priority: 'high' },
+  { name: 'motion', displayName: 'Motion', description: 'React 动画库（原 framer-motion），声明式动画', homepage: 'https://motion.dev', category: 'ui', priority: 'normal' },
+  { name: 'lucide-react', displayName: 'Lucide React', description: 'Lucide 图标库的 React 版本', homepage: 'https://lucide.dev', category: 'ui', priority: 'normal' },
+  { name: 'next-themes', displayName: 'Next Themes', description: '主题切换库，支持暗黑模式持久化', homepage: 'https://github.com/pacocoursey/next-themes', category: 'ui', priority: 'normal' },
+  { name: 'tailwindcss', displayName: 'Tailwind CSS', description: '原子化 CSS 框架，工具类优先', homepage: 'https://tailwindcss.com', category: 'ui', priority: 'high' },
+  { name: 'shadcn', displayName: 'shadcn', description: '可复制粘贴的组件集合 CLI，项目 UI 组件来源', homepage: 'https://ui.shadcn.com', category: 'ui', priority: 'normal' },
+  { name: 'sonner', displayName: 'Sonner', description: 'Toast 通知组件，项目消息提示', homepage: 'https://sonner.emilkowal.ski', category: 'ui', priority: 'normal' },
+
+  // state
+  { name: '@tanstack/react-query', displayName: 'TanStack Query', description: '服务端状态管理与缓存，数据获取利器', homepage: 'https://tanstack.com/query', category: 'state', priority: 'high' },
+  { name: '@tanstack/react-form', displayName: 'TanStack Form', description: '类型安全的表单管理库', homepage: 'https://tanstack.com/form', category: 'state', priority: 'normal' },
+
+  // tool
+  { name: 'zod', displayName: 'Zod', description: 'TypeScript 优先的 Schema 校验库', homepage: 'https://zod.dev', category: 'tool', priority: 'high' },
+  { name: 'i18next', displayName: 'i18next', description: '国际化框架，多语言文案管理', homepage: 'https://www.i18next.com', category: 'tool', priority: 'normal' },
+  { name: 'react-i18next', displayName: 'React i18next', description: 'i18next 的 React 绑定', homepage: 'https://react.i18next.com', category: 'tool', priority: 'normal' },
+  { name: 'nanoid', displayName: 'Nano ID', description: '轻量 URL 友好的唯一 ID 生成器', homepage: 'https://github.com/ai/nanoid', category: 'tool', priority: 'low' },
+  { name: 'bcryptjs', displayName: 'bcryptjs', description: '密码哈希库，纯 JS 实现', homepage: 'https://github.com/dcodeIO/bcrypt.js', category: 'auth', priority: 'normal' },
+]

package/src/modules/register-defaults.ts

@@ -0,0 +1,27 @@
+// 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 { moduleRegistry } from "./registry"
+import { prdModule } from "./definitions/prd.module"
+import { prototypeModule } from "./definitions/prototype.module"
+import { pluginModule } from "./definitions/plugin.module"
+
+export function registerDefaultModules(): void {
+  moduleRegistry.register(prdModule)
+  moduleRegistry.register(prototypeModule)
+  moduleRegistry.register(pluginModule)
+}

package/src/modules/registry.ts

@@ -0,0 +1,53 @@
+// 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 { AllBlueModule, AICommandDef } from "../interfaces/module"
+
+class ModuleRegistry {
+  private modules = new Map<string, AllBlueModule>()
+
+  register(mod: AllBlueModule): void {
+    if (this.modules.has(mod.id)) {
+      console.warn(`[ModuleRegistry] "${mod.id}" already registered, overwriting`)
+    }
+    this.modules.set(mod.id, mod)
+  }
+
+  getModule(id: string): AllBlueModule | undefined {
+    return this.modules.get(id)
+  }
+
+  getAll(): AllBlueModule[] {
+    return [...this.modules.values()]
+  }
+
+  getAICommands(): AICommandDef[] {
+    return [...this.modules.values()].flatMap(m => m.aiCommands)
+  }
+
+  getSearchFields(): { module: string; type: string; fields: string[] }[] {
+    return [...this.modules.values()].flatMap(m =>
+      m.entities.map(e => ({
+        module: m.id,
+        type: e.type,
+        fields: e.searchFields,
+      }))
+    )
+  }
+}
+
+export const moduleRegistry = new ModuleRegistry()

package/src/server-seam.ts

@@ -0,0 +1,51 @@
+// 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/>.
+
+/**
+ * PrismaSeam — 注入式 prisma 接入点
+ *
+ * 解决 shared → database (prisma) → shared 的循环依赖：
+ * shared 包声明 seam 接口，database 包启动时注册实现。
+ * 复用 kernel 的 ServerSeam 注入模式。
+ */
+
+export interface PrismaSeam {
+  reference: {
+    create: (data: unknown) => Promise<unknown>
+    findMany: (where: unknown) => Promise<unknown[]>
+  }
+  $queryRawUnsafe: <T = Record<string, unknown>>(
+    sql: string,
+    ...params: unknown[]
+  ) => Promise<T[]>
+}
+
+let _seam: PrismaSeam | null = null
+
+export function registerPrismaSeam(seam: PrismaSeam): void {
+  _seam = seam
+}
+
+export function getPrismaSeam(): PrismaSeam {
+  if (!_seam) {
+    throw new Error(
+      "[@allbluecn/shared] PrismaSeam not registered. " +
+      "Call registerPrismaSeam(prisma) before using reference engine."
+    )
+  }
+  return _seam
+}

package/src/types/outline.ts

@@ -0,0 +1,26 @@
+// 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 { CanvasElement } from "./prototype";
+
+export interface OutlineNode {
+  id: string;
+  label: string;
+  type: "container" | "atom";
+  elementId: string;
+  children: OutlineNode[];
+}

package/src/types/prd.ts

@@ -0,0 +1,90 @@
+// 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 {
+  Folder, FileText, BarChart3, Users, Settings as SettingsIcon,
+  Package, Database, ShoppingCart, Heart, Sparkles, Link,
+  MessageSquare, Calendar, Bell, Building2, SquareChartGantt,
+  HeartHandshake, Shrimp, Fish, VenetianMask, GraduationCap,
+  HandFist, LoaderPinwheel, ToolCase, PartyPopper, PencilRuler,
+  CircleStar, Brain, BadgeDollarSign, Earth, Music4,
+} from "lucide-react";
+
+export interface PRD {
+  id: string;
+  name: string;
+  icon: string;
+  description?: string | null;
+  prdTags?: { tag: { id: string; name: string; color: number } }[];
+}
+
+export interface PRDDetail extends PRD {
+  createdAt: Date;
+  updatedAt: Date;
+}
+
+export interface PRDVersionBase {
+  id: string;
+  versionLabel: string;
+  notes: string | null;
+  createdAt: string;
+  updatedAt?: string | null;
+}
+
+export interface PRDVersionWithPages extends PRDVersionBase {
+  pageVersions: { pageId: string; pageName: string; type?: "folder" | "page"; parentId?: string | null; version: number; pageVersionId?: string | null; canvas?: any; content?: any; isPlaceholder?: boolean }[];
+}
+
+export interface PRDVersionWithSemver extends PRDVersionBase {
+  major: number;
+  minor: number;
+  patch: number;
+}
+
+export const ICON_MAP: Record<string, React.ComponentType<{ className?: string }>> = {
+  folder: Folder,
+  file: FileText,
+  chart: BarChart3,
+  users: Users,
+  settings: SettingsIcon,
+  package: Package,
+  database: Database,
+  cart: ShoppingCart,
+  heart: Heart,
+  sparkles: Sparkles,
+  link: Link,
+  message: MessageSquare,
+  calendar: Calendar,
+  bell: Bell,
+  building2: Building2,
+  squareChartGantt: SquareChartGantt,
+  heartHandshake: HeartHandshake,
+  shrimp: Shrimp,
+  fish: Fish,
+  venetianMask: VenetianMask,
+  graduationCap: GraduationCap,
+  handFist: HandFist,
+  loaderPinwheel: LoaderPinwheel,
+  toolCase: ToolCase,
+  partyPopper: PartyPopper,
+  pencilRuler: PencilRuler,
+  circleStar: CircleStar,
+  brain: Brain,
+  badgeDollarSign: BadgeDollarSign,
+  earth: Earth,
+  music4: Music4,
+};

package/src/types/prototype.ts

@@ -0,0 +1,12 @@
+export {
+  DEVICE_SIZES,
+  type CanvasElement,
+  type ComponentCategory,
+  type ComponentSource,
+  type DeviceType,
+  type EditableFieldType,
+  type EditablePropField,
+  type PrototypeComponentConfig,
+  type ResizeDirection,
+  type ResizeMode,
+} from '@allblue/prototype'

package/src/virtual.d.ts

@@ -0,0 +1,4 @@
+// 声明 vite 专属 API 类型（供依赖 prototype 的包使用）
+interface ImportMeta {
+  glob: (pattern: string, options?: { eager?: boolean; import?: string }) => Record<string, () => Promise<unknown>>
+}