@spacecorexdev/core 0.0.2 → 0.0.5

package/src/contract.ts

@@ -0,0 +1,50 @@
+/**
+ * core 包导出的模块契约类型 —— 壳层与模块包之间的稳定接口。
+ */
+
+/** 模块在壳层运行时接收的 props */
+export interface ModuleRuntimeProps {
+  projectId?: string | null;
+  fileId?: string | null;
+  memberId?: string | null;
+  tab?: string | null;
+  onlyView?: boolean;
+  onBack?: () => void;
+  onNavigate?: (key: string) => void;
+  onPendingCountChange?: (count: number) => void;
+  onEmailUnreadCountChange?: (count: number, accountId?: string) => void;
+  emailAccounts?: Array<{
+    id: string; email: string; provider: string; sync_enabled?: boolean;
+    sync_interval?: number; last_sync_time?: string; token_expire_time?: string;
+    imapHost?: string; imapPort?: number; imapSsl?: boolean;
+    smtpHost?: string; smtpPort?: number; smtpSsl?: boolean;
+    createTime?: string; updateTime?: string;
+  }>;
+  onEmailAccountsChange?: (accounts: Array<{ id: string; email: string; provider: string }>) => void;
+}
+
+/** 模块包必须导出的 manifest —— 壳层通过它发现和装配模块 */
+export interface ModuleManifest {
+  /** 模块唯一标识，与 src/displayModules 的 key 对齐 */
+  key: string;
+  /** 展示名 */
+  label: string;
+  /** 导航图标组件 */
+  icon?: unknown;
+  /** 路由段（会被加入路由表） */
+  routes: string[];
+  /** 权限码 */
+  permissions: string[];
+  /** 是否出现在顶部主导航 */
+  topNav: boolean;
+  /** 模块主组件（lazy 包装） */
+  component: React.LazyExoticComponent<React.ComponentType<ModuleRuntimeProps>>;
+  /** 构建时烘焙的 core 版本 —— 运行时与 CORE_VERSION 比对 */
+  coreVersion: string;
+}
+
+/**
+ * 当前 core 包版本 —— 由 package.json 的 version 字段决定。
+ * 运行时壳层会将模块 manifest.coreVersion 与本值比对，不一致则警告并拒绝运行。
+ */
+export const CORE_VERSION = '0.1.0';

package/src/hooks/index.ts

@@ -0,0 +1,2 @@
+export * from './useLongPress';
+export * from './useOnlineStatus';

package/{dist/hooks/index.js → src/hooks/useLongPress.ts}

@@ -1,53 +1,72 @@
-// src/hooks/useLongPress.ts
-import { useCallback, useEffect, useRef } from "react";
-var SUPPRESS_CONTEXT_MENU_MS = 1200;
-var suppressContextMenuUntil = 0;
-var contextMenuListenerCount = 0;
-var handleSuppressedContextMenu = (event) => {
+import { useCallback, useEffect, useRef } from 'react';
+
+interface UseLongPressOptions {
+  delay?: number;
+  smallView?: boolean;
+  moveThreshold?: number;
+}
+
+const SUPPRESS_CONTEXT_MENU_MS = 1200;
+let suppressContextMenuUntil = 0;
+let contextMenuListenerCount = 0;
+
+const handleSuppressedContextMenu = (event: MouseEvent) => {
   if (Date.now() > suppressContextMenuUntil) {
     return;
   }
+
   event.preventDefault();
   event.stopPropagation();
   event.stopImmediatePropagation();
 };
-var suppressNextContextMenu = () => {
+
+const suppressNextContextMenu = () => {
   suppressContextMenuUntil = Date.now() + SUPPRESS_CONTEXT_MENU_MS;
 };
-function useLongPress(onLongPress, options = {}) {
+
+export function useLongPress<T>(
+  onLongPress: (data: T, event: React.TouchEvent) => void,
+  options: UseLongPressOptions = {}
+) {
   const { delay = 500, smallView = false, moveThreshold = 10 } = options;
-  const timers = useRef(/* @__PURE__ */ new Map());
-  const longPressedMap = useRef(/* @__PURE__ */ new Map());
-  const startPositions = useRef(/* @__PURE__ */ new Map());
-  const getKey = useCallback((data) => {
-    if (typeof data === "string") return data;
-    if (typeof data === "object" && data !== null && "id" in data) {
-      return String(data.id);
+  const timers = useRef<Map<string, ReturnType<typeof setTimeout>>>(new Map());
+  const longPressedMap = useRef<Map<string, boolean>>(new Map());
+  const startPositions = useRef<Map<string, { x: number; y: number }>>(new Map());
+
+  const getKey = useCallback((data: T): string => {
+    if (typeof data === 'string') return data;
+    if (typeof data === 'object' && data !== null && 'id' in data) {
+      return String((data as any).id);
     }
     return String(data);
   }, []);
+
   useEffect(() => () => {
     timers.current.forEach((timer) => clearTimeout(timer));
     timers.current.clear();
     longPressedMap.current.clear();
     startPositions.current.clear();
   }, []);
+
   useEffect(() => {
     if (!smallView) {
       return;
     }
+
     if (contextMenuListenerCount === 0) {
-      document.addEventListener("contextmenu", handleSuppressedContextMenu, true);
+      document.addEventListener('contextmenu', handleSuppressedContextMenu, true);
     }
     contextMenuListenerCount += 1;
+
     return () => {
       contextMenuListenerCount -= 1;
       if (contextMenuListenerCount === 0) {
-        document.removeEventListener("contextmenu", handleSuppressedContextMenu, true);
+        document.removeEventListener('contextmenu', handleSuppressedContextMenu, true);
       }
     };
   }, [smallView]);
-  const cancelTimer = useCallback((key) => {
+
+  const cancelTimer = useCallback((key: string) => {
     const timer = timers.current.get(key);
     if (timer) {
       clearTimeout(timer);
@@ -55,9 +74,10 @@ function useLongPress(onLongPress, options = {}) {
     }
     startPositions.current.delete(key);
   }, []);
-  const handleTouchStart = useCallback((data) => (e) => {
+
+  const handleTouchStart = useCallback((data: T) => (e: React.TouchEvent) => {
     if (!smallView) return;
-    if (e.touches.length !== 1) return;
+    if (e.touches.length !== 1) return; // 只处理单指
     const key = getKey(data);
     longPressedMap.current.set(key, false);
     const touch = e.touches[0];
@@ -69,7 +89,8 @@ function useLongPress(onLongPress, options = {}) {
     }, delay);
     timers.current.set(key, timer);
   }, [smallView, delay, onLongPress, getKey]);
-  const handleTouchMove = useCallback((data) => (e) => {
+
+  const handleTouchMove = useCallback((data: T) => (e: React.TouchEvent) => {
     if (!smallView) return;
     const key = getKey(data);
     const startPos = startPositions.current.get(key);
@@ -80,54 +101,37 @@ function useLongPress(onLongPress, options = {}) {
     const touch = e.touches[0];
     const deltaX = Math.abs(touch.clientX - startPos.x);
     const deltaY = Math.abs(touch.clientY - startPos.y);
+    // 如果移动超过阈值，取消长按计时器（用户在滚动）
     if (deltaX > moveThreshold || deltaY > moveThreshold) {
       cancelTimer(key);
     }
   }, [smallView, moveThreshold, getKey, cancelTimer]);
-  const handleTouchEnd = useCallback((data) => () => {
+
+  const handleTouchEnd = useCallback((data: T) => () => {
     const key = getKey(data);
     cancelTimer(key);
   }, [getKey, cancelTimer]);
-  const handleTouchCancel = useCallback((data) => () => {
+
+  const handleTouchCancel = useCallback((data: T) => () => {
     handleTouchEnd(data)();
   }, [handleTouchEnd]);
-  const wasLongPressed = useCallback((data) => {
+
+  const wasLongPressed = useCallback((data: T): boolean => {
     const key = getKey(data);
     return longPressedMap.current.get(key) || false;
   }, [getKey]);
-  const resetLongPress = useCallback((data) => {
+
+  const resetLongPress = useCallback((data: T) => {
     const key = getKey(data);
     longPressedMap.current.set(key, false);
   }, [getKey]);
+
   return {
     handleTouchStart,
     handleTouchMove,
     handleTouchEnd,
     handleTouchCancel,
     wasLongPressed,
-    resetLongPress
+    resetLongPress,
   };
 }
-
-// src/hooks/useOnlineStatus.ts
-import { useEffect as useEffect2, useState } from "react";
-function useOnlineStatus() {
-  const [isOnline, setIsOnline] = useState(
-    typeof navigator !== "undefined" ? navigator.onLine : true
-  );
-  useEffect2(() => {
-    const handleOnline = () => setIsOnline(true);
-    const handleOffline = () => setIsOnline(false);
-    window.addEventListener("online", handleOnline);
-    window.addEventListener("offline", handleOffline);
-    return () => {
-      window.removeEventListener("online", handleOnline);
-      window.removeEventListener("offline", handleOffline);
-    };
-  }, []);
-  return isOnline;
-}
-export {
-  useLongPress,
-  useOnlineStatus
-};

package/src/hooks/useOnlineStatus.ts

@@ -0,0 +1,22 @@
+import { useEffect, useState } from 'react';
+
+export function useOnlineStatus(): boolean {
+  const [isOnline, setIsOnline] = useState<boolean>(
+    typeof navigator !== 'undefined' ? navigator.onLine : true
+  );
+
+  useEffect(() => {
+    const handleOnline = () => setIsOnline(true);
+    const handleOffline = () => setIsOnline(false);
+
+    window.addEventListener('online', handleOnline);
+    window.addEventListener('offline', handleOffline);
+
+    return () => {
+      window.removeEventListener('online', handleOnline);
+      window.removeEventListener('offline', handleOffline);
+    };
+  }, []);
+
+  return isOnline;
+}

package/src/index.ts

@@ -0,0 +1,14 @@
+/**
+ * @spacecorex/core 主入口 —— 公共层统一导出。
+ * 消费方应从子路径导入以获得精确的类型和 tree-shaking：
+ *   import { API } from '@spacecorex/core/api';
+ *   import { uiConfirm } from '@spacecorex/core/ui';
+ *   import { CORE_VERSION } from '@spacecorex/core/contract';
+ */
+export { CORE_VERSION } from './contract';
+export type { ModuleRuntimeProps, ModuleManifest } from './contract';
+
+export * from './api';
+export * from './utils';
+export * from './hooks';
+export * from './types';

package/src/types/id.ts

@@ -0,0 +1,2 @@
+/** 通用标识符类型（后端实体 id 约定为 string） */
+export type ID = string;

package/src/types/index.ts

@@ -0,0 +1,5 @@
+export * from './project/index';
+export * from './user/index';
+export * from './projectRole';
+export * from './id';
+export * from './theme';

package/src/types/project/base.ts

@@ -0,0 +1,63 @@
+import dayjs from 'dayjs';
+
+/** 项目基础信息。 */
+export interface Project {
+  /** 项目唯一标识。 */
+  id: string;
+  /** 项目名称。 */
+  name: string;
+  /** 项目描述。 */
+  descs: string;
+  /** 所属公司 ID。 */
+  companyId: string;
+  /** 项目状态值，对应 ProjectStatus。 */
+  status: number;
+  /** 项目说明的 Markdown 内容。 */
+  markdown: string;
+  /** 项目开始时间。 */
+  startTime: Date;
+  /** 表单中使用的项目开始时间。 */
+  startTime2?: dayjs.Dayjs;
+  /** 计划结束时间。 */
+  plannedEndTime: Date;
+  /** 表单中使用的计划结束时间。 */
+  plannedEndTime2?: dayjs.Dayjs;
+  /** 实际结束时间，未结束时为空。 */
+  endTime: Date | null;
+  /** 表单中使用的实际结束时间。 */
+  endTime2?: dayjs.Dayjs;
+  /** 项目负责人 ID。 */
+  leaderId: string;
+  /** 关联 CRM 客户 ID（可选）。 */
+  customerId?: string;
+  /** 项目负责人名称。 */
+  leaderName?: string;
+  /** 创建时间。 */
+  createTime: Date;
+  /** 更新时间。 */
+  updateTime: Date;
+  /** 创建人 ID。 */
+  createBy: string;
+  /** 创建人名称。 */
+  createName?: string;
+  /** 更新人 ID。 */
+  updateBy: string;
+  /** 更新人名称。 */
+  updateName?: string;
+}
+
+/** 项目状态。 */
+export enum ProjectStatus {
+  /** 准备中。 */
+  PREPARATION = 0,
+  /** 进行中。 */
+  PROGRESS = 1,
+  /** 已完成。 */
+  COMPLETED = 2,
+  /** 已延期。 */
+  DELAYED = 3,
+  /** 已终止。 */
+  TERMINATED = 4,
+  /** 临时项目。 */
+  TEMP = 5,
+}

package/src/types/project/contract.ts

@@ -0,0 +1,79 @@
+/** 合同签署与审批状态。 */
+export enum ContractStatus {
+  /** 草稿。 */
+  DRAFT = 'DRAFT',
+  /** 审批中。 */
+  APPROVALLING = 'APPROVALLING',
+  /** 待签署。 */
+  PENDING = 'PENDING',
+  /** 已签署。 */
+  SIGNED = 'SIGNED',
+}
+
+/** 项目合同基础信息。 */
+export interface Contract {
+  /** 合同唯一标识。 */
+  id: string;
+  /** 关联合同所属项目 ID。 */
+  projectId: string;
+  /** 合同名称。 */
+  name: string;
+  /** 合同编号。 */
+  code: string;
+  /** 甲方名称。 */
+  partyA: string;
+  /** 乙方名称。 */
+  partyB: string;
+  /** 合同金额。 */
+  amount: number;
+  /** 签署日期。 */
+  signDate: Date;
+  /** 合同开始日期。 */
+  startDate: Date;
+  /** 合同结束日期。 */
+  endDate: Date;
+  /** 合同状态。 */
+  status: ContractStatus;
+  /** 创建时间。 */
+  createTime: Date;
+  /** 更新时间。 */
+  updateTime: Date;
+  /** 创建人 ID。 */
+  createBy: string;
+  /** 更新人 ID。 */
+  updateBy: string;
+  /** 合同版本数量。 */
+  versionCount: number;
+  /** 最新合同版本 ID。 */
+  latestVersionId?: string;
+}
+
+/** 合同版本文件信息。 */
+export interface ContractVersion {
+  /** 合同版本唯一标识。 */
+  id: string;
+  /** 所属合同 ID。 */
+  contractId: string;
+  /** 版本号。 */
+  versionNumber: string;
+  /** 版本名称。 */
+  versionName: string;
+  /** 合同文件存储路径。 */
+  filePath: string;
+  /** 合同文件名称。 */
+  fileName: string;
+  /** 合同文件大小，单位通常为字节。 */
+  fileSize: number;
+  /** 上传时间。 */
+  uploadTime: Date;
+  /** 上传人 ID。 */
+  uploaderId: string;
+  /** 上传人名称。 */
+  uploaderName: string;
+  /** 创建时间。 */
+  createTime: Date;
+  /** 更新时间。 */
+  updateTime: Date;
+  /** 本版本变更说明。 */
+  changes?: string;
+}

package/src/types/project/contractStatus.tsx

@@ -0,0 +1,15 @@
+import React from 'react';
+import { Tag } from 'antd';
+import { ContractStatus } from './contract';
+
+/** 根据合同状态生成对应的状态标签。 */
+export const getContractStatusTag = (status: ContractStatus, className?: string) => {
+  const statusMap: Record<string, { color: string; text: string }> = {
+    [ContractStatus.DRAFT]: { color: 'orange', text: '草稿' },
+    [ContractStatus.APPROVALLING]: { color: 'yellow', text: '审核中' },
+    [ContractStatus.PENDING]: { color: 'blue', text: '待签署' },
+    [ContractStatus.SIGNED]: { color: 'green', text: '已签署' },
+  };
+  const item = statusMap[status];
+  return React.createElement(Tag, { color: item?.color, className }, item?.text);
+};

package/src/types/project/index.ts

@@ -0,0 +1,5 @@
+export * from './base';
+export * from './contract';
+export * from './contractStatus';
+export * from './member';
+export * from './progress';

package/src/types/project/member.ts

@@ -0,0 +1,46 @@
+import { ProjectRole } from '../projectRole';
+
+
+/** 项目成员权限摘要。 */
+export interface ProjectPermission {
+  /** 用户 ID。 */
+  userId: string;
+  /** 用户名称。 */
+  userName: string;
+  /** 项目角色。 */
+  role: ProjectRole;
+}
+
+/** 项目成员详情。 */
+export interface ProjectMember {
+  /** 成员记录唯一标识。 */
+  id: string;
+  /** 所属项目 ID。 */
+  projectId: string;
+  /** 用户 ID。 */
+  userId: string;
+  /** 成员职位或头衔。 */
+  title: string;
+  /** 用户头像地址。 */
+  avatar: string;
+  /** 用户昵称。 */
+  nickname: string;
+  /** 用户登录名。 */
+  username: string;
+  /** 用户手机号。 */
+  phone: string;
+  /** 用户邮箱。 */
+  email: string;
+  /** 成员项目角色。 */
+  role: ProjectRole;
+  /** 权限位或权限等级。 */
+  permission: number;
+  /** 创建时间。 */
+  createTime: Date;
+  /** 更新时间。 */
+  updateTime: Date;
+  /** 创建人 ID。 */
+  createBy: string;
+  /** 更新人 ID。 */
+  updateBy: string;
+}

package/src/types/project/progress.ts

@@ -0,0 +1,43 @@
+import type { CommentSubItem } from '../../ui/CommentTimeline/index';
+
+/** 项目进度记录。 */
+export interface ProjectProgress {
+  /** 进度记录唯一标识。 */
+  id: string;
+  /** 所属项目 ID。 */
+  projectId: string;
+  /** 进度评论数量。 */
+  commentCount: number;
+  /** 进度描述。 */
+  descs: string;
+  /** 是否已删除。 */
+  isDeleted: boolean;
+  /** 进度发生时间。 */
+  progressTime: Date;
+  /** 创建时间。 */
+  createTime: Date;
+  /** 更新时间。 */
+  updateTime: Date;
+  /** 创建人 ID。 */
+  createBy: string;
+  /** 更新人 ID。 */
+  updateBy: string;
+}
+
+/** 项目进度评论。 */
+export interface ProgressComment extends CommentSubItem {
+  /** 评论唯一标识。 */
+  id: string;
+  /** 所属进度记录 ID。 */
+  progressId: string;
+  /** 评论内容。 */
+  comment: string;
+  /** 创建时间。 */
+  createTime: Date;
+  /** 更新时间。 */
+  updateTime: Date;
+  /** 创建人 ID。 */
+  createBy: string;
+  /** 更新人 ID。 */
+  updateBy: string;
+}

package/src/types/projectRole.ts

@@ -0,0 +1,17 @@
+/**
+ * 项目成员角色枚举 —— 跨包共享的公共类型。
+ * 原定义在 src/ui/FileManager/types.ts，因 FileManager 留在壳层，
+ * 故将此公共枚举迁入 core 的 types/ 目录。
+ */
+export enum ProjectRole {
+  /** 项目所有者。 */
+  OWNER = 'owner',
+  /** 图层或分层角色。 */
+  LAYER = 'layer',
+  /** 项目管理员。 */
+  MANAGER = 'manager',
+  /** 普通成员。 */
+  MEMBER = 'member',
+  /** 只读查看者。 */
+  VIEWER = 'viewer',
+}

package/src/types/theme.ts

@@ -0,0 +1 @@
+export type ThemeMode = 'light' | 'dark';

package/src/types/user/index.ts

@@ -0,0 +1 @@
+export * from './role';

package/src/types/user/role.ts

@@ -0,0 +1,7 @@
+/** 系统角色。 */
+export interface Role {
+  /** 角色唯一标识。 */
+  id: string;
+  /** 角色名称。 */
+  name: string;
+}