sa2kit 2.0.0 → 2.0.2

package/dist/types-ERmJyjx8.d.ts

@@ -0,0 +1,292 @@
+import { S as StorageType$1, C as CDNType$1, F as FileMetadata, A as AccessPermission, U as UploadStatus, P as ProcessorType$1, a as UploadFileInfo$1, b as ProcessingOptions$1 } from './types-DyG3ZV9V.js';
+
+/**
+ * UniversalFile Server 端类型定义
+ */
+
+type StorageType = StorageType$1;
+type CDNType = CDNType$1;
+type ProcessorType = ProcessorType$1;
+type UploadFileInfo = UploadFileInfo$1;
+type ProcessingOptions = ProcessingOptions$1;
+/** 存储提供者接口 */
+interface IStorageProvider {
+    /** 提供者类型 */
+    readonly type: StorageType;
+    /** 初始化 */
+    initialize(config: StorageConfig): Promise<void>;
+    /** 上传文件 */
+    upload(fileInfo: UploadFileInfo, path: string): Promise<StorageResult>;
+    /** 下载文件 */
+    download(path: string): Promise<Buffer>;
+    /** 删除文件 */
+    delete(path: string): Promise<StorageResult>;
+    /** 获取文件信息 */
+    getFileInfo(path: string): Promise<StorageResult>;
+    /** 生成访问URL */
+    getAccessUrl(path: string, expiresIn?: number): Promise<string>;
+    /** 生成预签名上传URL */
+    getUploadUrl(path: string, expiresIn?: number): Promise<string>;
+    /** 检查文件是否存在 */
+    exists(path: string): Promise<boolean>;
+    /** 列出文件 */
+    list(prefix: string, maxKeys?: number): Promise<string[]>;
+}
+/** CDN 提供者接口 */
+interface ICDNProvider {
+    /** 提供者类型 */
+    readonly type: CDNType;
+    /** 初始化 */
+    initialize(config: CDNConfig): Promise<void>;
+    /** 生成CDN URL */
+    generateUrl(originalUrl: string): Promise<string>;
+    /** 刷新缓存 */
+    refreshCache(urls: string[]): Promise<CDNResult>;
+    /** 预热缓存 */
+    preheatCache(urls: string[]): Promise<CDNResult>;
+    /** 获取访问统计 */
+    getAccessStats(startTime: Date, endTime: Date): Promise<CDNResult>;
+}
+/** 文件处理器接口 */
+interface IFileProcessor {
+    /** 处理器类型 */
+    readonly type: ProcessorType;
+    /** 初始化 */
+    initialize(): Promise<void>;
+    /** 处理文件 */
+    process(inputPath: string, outputPath: string, options: ProcessingOptions): Promise<ProcessingResult>;
+    /** 检查文件是否支持处理 */
+    supports(mimeType: string): boolean;
+    /** 获取文件信息 */
+    getFileInfo(filePath: string): Promise<Record<string, any>>;
+}
+/** 存储配置基础接口 */
+interface StorageConfig {
+    /** 存储类型 */
+    type: StorageType;
+    /** 是否启用 */
+    enabled: boolean;
+}
+/** 阿里云 OSS 配置 */
+interface AliyunOSSConfig extends StorageConfig {
+    type: 'aliyun-oss';
+    /** 地域 */
+    region: string;
+    /** 存储桶名称 */
+    bucket: string;
+    /** 访问密钥ID */
+    accessKeyId: string;
+    /** 访问密钥密码 */
+    accessKeySecret: string;
+    /** 自定义域名 */
+    customDomain?: string;
+    /** 是否使用HTTPS */
+    secure?: boolean;
+    /** 是否使用内网访问 */
+    internal?: boolean;
+}
+/** CDN配置基础接口 */
+interface CDNConfig {
+    /** CDN类型 */
+    type: CDNType;
+    /** 是否启用 */
+    enabled: boolean;
+}
+/** 缓存配置 */
+interface CacheConfig {
+    /** 是否启用缓存 */
+    enabled: boolean;
+    /** 最大缓存大小 */
+    maxSize?: number;
+    /** 缓存 TTL（秒） */
+    ttl?: number;
+    /** 是否使用 Redis */
+    useRedis?: boolean;
+    /** Redis 配置 */
+    redisConfig?: {
+        host: string;
+        port: number;
+        password?: string;
+        db?: number;
+    };
+}
+/** 文件服务配置 */
+/** 缓存配置扩展 */
+interface CacheConfig {
+    /** 是否启用缓存 */
+    enabled: boolean;
+    /** 元数据缓存TTL（秒） */
+    metadataTTL?: number;
+    /** URL缓存TTL（秒） */
+    urlTTL?: number;
+    /** 最大缓存条目数 */
+    maxSize?: number;
+}
+interface UniversalFileServiceConfig {
+    /** 存储配置 */
+    storage: StorageConfig;
+    /** CDN 配置（可选） */
+    cdn?: CDNConfig;
+    /** 缓存配置（可选） */
+    cache?: CacheConfig;
+    /** 数据库持久化配置（可选） */
+    persistence?: FileServicePersistenceConfig;
+    /** 启用的处理器 */
+    processors?: ProcessorType[];
+    /** 数据库连接（可选） @deprecated 使用 persistence.repository 代替 */
+    db?: any;
+    /** 最大文件大小（字节） */
+    maxFileSize?: number;
+    /** 允许的文件类型 */
+    allowedMimeTypes?: string[];
+    /** 是否启用监控 */
+    enableMonitoring?: boolean;
+    /** 存储提供者映射（内部使用） */
+    storageProviders?: Map<StorageType, IStorageProvider>;
+    /** 默认存储类型 */
+    defaultStorage?: StorageType;
+    /** 默认CDN类型 */
+    defaultCDN?: CDNType;
+}
+/** 存储结果 */
+/** 存储操作结果 */
+interface StorageResult {
+    /** 是否成功 */
+    success: boolean;
+    /** 存储路径 */
+    path?: string;
+    /** 访问URL */
+    url?: string;
+    /** 文件大小 */
+    size?: number;
+    /** 错误信息 */
+    error?: string;
+    /** 额外数据 */
+    data?: Record<string, any>;
+}
+/** CDN 结果 */
+/** CDN操作结果 */
+interface CDNResult {
+    /** 是否成功 */
+    success: boolean;
+    /** CDN URL */
+    url?: string;
+    /** 错误信息 */
+    error?: string;
+    /** 额外数据 */
+    data?: Record<string, any>;
+}
+/** 处理结果 */
+interface ProcessingResult {
+    /** 是否成功 */
+    success: boolean;
+    /** 处理后的文件路径 */
+    processedPath?: string;
+    /** 处理后的文件大小 */
+    processedSize?: number;
+    /** 缩略图路径 */
+    thumbnailPath?: string;
+    /** 错误信息 */
+    error?: string;
+    /** 处理耗时(毫秒) */
+    processingTime?: number;
+    /** 额外数据 */
+    data?: Record<string, any>;
+}
+/** 文件查询选项 */
+interface FileQueryOptions {
+    /** 模块 ID */
+    moduleId?: string;
+    /** 业务 ID */
+    businessId?: string;
+    /** 上传者 ID */
+    uploaderId?: string;
+    /** 文件类型 */
+    mimeType?: string;
+    /** 访问权限 */
+    permission?: AccessPermission;
+    /** 状态 */
+    status?: UploadStatus;
+    /** 分页 */
+    page?: number;
+    pageSize?: number;
+    /** 排序 */
+    orderBy?: string;
+    orderDirection?: 'asc' | 'desc';
+}
+/** 分页结果 */
+interface PaginatedResult<T> {
+    /** 数据列表 */
+    items: T[];
+    /** 总数 */
+    total: number;
+    /** 当前页 */
+    page: number;
+    /** 每页大小 */
+    pageSize: number;
+    /** 总页数 */
+    totalPages: number;
+}
+/**
+ * 文件元数据数据库持久化接口
+ *
+ * 实现此接口以提供自定义的数据库持久化支持
+ *
+ * @example
+ * ```typescript
+ * // Drizzle ORM 实现
+ * class DrizzleFileRepository implements IFileMetadataRepository {
+ *   async save(metadata: FileMetadata): Promise<void> {
+ *     await db.insert(fileMetadata).values(metadata);
+ *   }
+ *   // ... 其他方法
+ * }
+ * ```
+ */
+interface IFileMetadataRepository {
+    /**
+     * 保存文件元数据到数据库
+     */
+    save(metadata: FileMetadata): Promise<void>;
+    /**
+     * 从数据库获取文件元数据
+     */
+    get(fileId: string): Promise<FileMetadata | null>;
+    /**
+     * 查询文件列表
+     */
+    query(options: FileQueryOptions): Promise<PaginatedResult<FileMetadata>>;
+    /**
+     * 从数据库删除文件元数据
+     */
+    delete(fileId: string): Promise<void>;
+    /**
+     * 批量删除文件元数据
+     */
+    batchDelete(fileIds: string[]): Promise<void>;
+}
+/**
+ * 数据库持久化配置
+ */
+interface FileServicePersistenceConfig {
+    /**
+     * 是否启用持久化
+     */
+    enabled: boolean;
+    /**
+     * 持久化仓储实现
+     */
+    repository: IFileMetadataRepository;
+    /**
+     * 是否自动持久化（默认 true）
+     * 如果为 true，文件上传完成后自动保存到数据库
+     */
+    autoPersist?: boolean;
+    /**
+     * 是否优先使用缓存（默认 false）
+     * 如果为 true，查询时优先从缓存获取
+     */
+    cacheFirst?: boolean;
+}
+
+export type { AliyunOSSConfig as A, IStorageProvider as I, UniversalFileServiceConfig as U, ICDNProvider as a, IFileProcessor as b };

package/dist/types-HorDyIRv.d.mts

@@ -0,0 +1,303 @@
+import { Vector3 } from 'three';
+
+/** MMD 资源配置 */
+interface MMDResources {
+    /** 模型文件路径 (.pmx/.pmd) */
+    modelPath: string;
+    /** 动作文件路径 (.vmd) - 可选 */
+    motionPath?: string;
+    /** 相机动画路径 (.vmd) - 可选 */
+    cameraPath?: string;
+    /** 音频文件路径 - 可选 */
+    audioPath?: string;
+    /** 舞台/场景模型路径 (.pmx/.x) - 可选 */
+    stageModelPath?: string | string[];
+    /** 舞台/场景动作路径 (.vmd) - 可选 */
+    stageMotionPath?: string;
+    /** 附加动作文件 - 可选 */
+    additionalMotions?: string[];
+}
+/** 资源列表项 - 用于预设切换 */
+interface MMDResourceItem {
+    id: string;
+    name: string;
+    resources: MMDResources;
+    thumbnail?: string;
+    description?: string;
+}
+/** 资源选项 - 用于自由组合 */
+interface ResourceOption {
+    id: string;
+    name: string;
+    path: string;
+    thumbnail?: string;
+}
+interface MMDResourceOptions {
+    models: ResourceOption[];
+    motions: ResourceOption[];
+    cameras?: ResourceOption[];
+    audios?: ResourceOption[];
+    stages?: ResourceOption[];
+}
+/** 舞台/场景配置 */
+interface MMDStage {
+    /** 背景颜色 */
+    backgroundColor?: string;
+    /** 背景图片 URL */
+    backgroundImage?: string;
+    /** 是否启用物理模拟 (默认 true) */
+    enablePhysics?: boolean;
+    /** 物理引擎路径 (ammo.wasm.js 的路径) */
+    physicsPath?: string;
+    /** 是否启用阴影 (默认 true) */
+    enableShadow?: boolean;
+    /** 环境光强度 (默认 0.5) */
+    ambientLightIntensity?: number;
+    /** 方向光强度 (默认 0.8) */
+    directionalLightIntensity?: number;
+    /** 方向光位置 (默认 { x: 0, y: 10, z: 0 }) */
+    directionalLightPosition?: {
+        x: number;
+        y: number;
+        z: number;
+    } | Vector3;
+    /** 半球光强度 (默认关闭，设置值以启用) */
+    hemisphereLightIntensity?: number;
+    /** 半球光天空颜色 (默认 0xffffff) */
+    hemisphereLightSkyColor?: string | number;
+    /** 半球光地面颜色 (默认 0x444444) */
+    hemisphereLightGroundColor?: string | number;
+    /** 侧面补光强度 (默认关闭，设置值以启用) */
+    sideLightIntensity?: number;
+    /** 侧面补光位置 (默认 { x: -3, y: 8, z: 8 }) */
+    sideLightPosition?: {
+        x: number;
+        y: number;
+        z: number;
+    } | Vector3;
+    /** 色调映射类型 (默认 'ACESFilmic') */
+    toneMapping?: 'None' | 'Linear' | 'Reinhard' | 'Cineon' | 'ACESFilmic';
+    /** 色调映射曝光度 (默认 1.0) */
+    toneMappingExposure?: number;
+    /** 相机初始位置 */
+    cameraPosition?: {
+        x: number;
+        y: number;
+        z: number;
+    } | Vector3;
+    /** 相机目标点 */
+    cameraTarget?: {
+        x: number;
+        y: number;
+        z: number;
+    } | Vector3;
+    /** 渲染特效模式 (默认 'default') */
+    renderEffect?: 'default' | 'outline';
+    /** 描边效果配置 */
+    outlineOptions?: OutlineOptions;
+    /** 材质自发光强度 (默认 0) */
+    emissiveIntensity?: number;
+    /** 颜色亮度系数 (默认 1.0) */
+    colorBrightness?: number;
+    /** 颜色饱和度系数 (默认 1.0) */
+    colorSaturation?: number;
+    /** 高光强度 Shininess (默认 30) */
+    shininess?: number;
+    /** 高光颜色强度 (默认 0.5) */
+    specularIntensity?: number;
+    /** 反射率 (默认 0.5) */
+    reflectivity?: number;
+    /** 金属度 PBR (默认 0) */
+    metalness?: number;
+    /** 粗糙度 PBR (默认 0.8) */
+    roughness?: number;
+    /** 环境光遮蔽强度 (默认 1.0) */
+    aoMapIntensity?: number;
+    /** 边缘光强度 (默认 0) */
+    rimLightIntensity?: number;
+    /** 边缘光颜色 (默认 '#ffffff') */
+    rimLightColor?: string;
+    /** 模型是否接收阴影 (默认 true) */
+    modelReceiveShadow?: boolean;
+    /** 阴影偏移 (默认 -0.0001) */
+    shadowBias?: number;
+    /**
+     * FX效果文件路径 (.fx文件，MME格式)
+     * 注意：
+     * - .fx 文件用于模型级效果（应用到人物模型）
+     * - .x 文件用于场景级渲染（渲染整个环境，包括模型）
+     * 如需同时使用多个效果，请使用 fxConfigs
+     */
+    fxPath?: string;
+    /** FX纹理基础路径 */
+    fxTexturePath?: string;
+    /**
+     * 多个FX效果配置（高级用法）
+     * 支持同时应用多个.fx和.x文件
+     */
+    fxConfigs?: Array<{
+        path: string;
+        texturePath?: string;
+        type?: 'fx' | 'x' | 'auto';
+        priority?: number;
+        target?: 'all' | 'model' | 'stage' | 'scene' | string[];
+        description?: string;
+    }>;
+}
+/** 移动端优化配置 */
+interface MobileOptimization {
+    /** 是否启用优化 (默认 true) */
+    enabled: boolean;
+    /** 像素比 (默认 1.0, 桌面端通常为 window.devicePixelRatio) */
+    pixelRatio?: number;
+    /** 是否强制关闭物理引擎 (默认 false) */
+    disablePhysics?: boolean;
+    /** 是否降低阴影质量 (默认 true) */
+    reduceShadowQuality?: boolean;
+}
+/** 描边效果配置 */
+interface OutlineOptions {
+    /** 是否启用描边 (默认 false) */
+    enabled?: boolean;
+    /** 描边粗细 (默认 0.003) */
+    thickness?: number;
+    /** 描边颜色 (默认 '#000000') */
+    color?: string;
+}
+/** MMDPlayerBase Ref 接口 */
+interface MMDPlayerBaseRef {
+    /** 开始播放 */
+    play: () => void;
+    /** 暂停播放 */
+    pause: () => void;
+    /** 停止播放 (重置到开头) */
+    stop: () => void;
+    /** 跳转到指定时间 (秒) */
+    seek: (time: number) => void;
+    /** 获取当前播放时间 */
+    getCurrentTime: () => number;
+    /** 获取总时长 */
+    getDuration: () => number;
+    /** 获取播放状态 */
+    isPlaying: () => boolean;
+    /** 截图并返回 Base64 字符串 */
+    snapshot: () => string;
+    /** 重置相机到初始位置 */
+    resetCamera: () => void;
+}
+/** 基础播放器属性 */
+interface MMDPlayerBaseProps {
+    /** 资源配置 */
+    resources: MMDResources;
+    /** 舞台配置 */
+    stage?: MMDStage;
+    /** 移动端优化配置 */
+    mobileOptimization?: MobileOptimization;
+    /** 播放控制 */
+    autoPlay?: boolean;
+    loop?: boolean;
+    volume?: number;
+    muted?: boolean;
+    /** 调试与辅助 */
+    showAxes?: boolean;
+    /** 渲染特效配置 */
+    renderEffect?: 'default' | 'outline';
+    /** 描边效果配置 */
+    outlineOptions?: OutlineOptions;
+    /** FX效果文件路径 */
+    fxPath?: string;
+    /** FX纹理基础路径 */
+    fxTexturePath?: string;
+    /** 多个FX效果配置（高级用法） */
+    fxConfigs?: Array<{
+        path: string;
+        texturePath?: string;
+        type?: 'fx' | 'x' | 'auto';
+        priority?: number;
+        target?: 'all' | 'model' | 'stage' | 'scene' | string[];
+        description?: string;
+    }>;
+    /** 事件回调 */
+    onLoad?: () => void;
+    onLoadProgress?: (progress: number, item: string) => void;
+    onError?: (error: Error) => void;
+    onPlay?: () => void;
+    onPause?: () => void;
+    onEnded?: () => void;
+    onTimeUpdate?: (time: number) => void;
+    onCameraChange?: (isManual: boolean) => void;
+    /** 样式 */
+    className?: string;
+    style?: React.CSSProperties;
+}
+/** 增强播放器属性 */
+interface MMDPlayerEnhancedProps extends Omit<MMDPlayerBaseProps, 'resources'> {
+    /** 单一资源模式 */
+    resources?: MMDResources;
+    /** 列表模式资源 */
+    resourcesList?: MMDResourceItem[];
+    /** 自由组合模式选项 */
+    resourceOptions?: MMDResourceOptions;
+    /** 列表模式下的默认 ID */
+    defaultResourceId?: string;
+    /** 自由组合模式下的默认选择 */
+    defaultSelection?: {
+        modelId?: string;
+        motionId?: string;
+        cameraId?: string;
+        audioId?: string;
+        stageId?: string;
+    };
+    /** 是否显示调试信息面板 */
+    showDebugInfo?: boolean;
+}
+/** 播放列表节点 */
+interface MMDPlaylistNode {
+    id: string;
+    name: string;
+    resources: MMDResources;
+    /** 节点特定的舞台配置（可选，覆盖全局配置） */
+    stage?: MMDStage;
+    /** 该节点是否循环播放 */
+    loop?: boolean;
+    /** 预计时长（秒）- 用于进度计算 */
+    duration?: number;
+    /** 缩略图 */
+    thumbnail?: string;
+}
+/** 播放列表配置 */
+interface MMDPlaylistConfig {
+    id: string;
+    name: string;
+    nodes: MMDPlaylistNode[];
+    /** 整个播放列表是否循环 */
+    loop?: boolean;
+    /** 预加载策略
+     * - 'none': 不预加载 (默认)
+     * - 'next': 预加载下一个节点
+     * - 'all': 预加载所有节点
+     */
+    preload?: 'none' | 'next' | 'all';
+    /** 是否自动播放 */
+    autoPlay?: boolean;
+}
+/** 播放列表组件属性 */
+interface MMDPlaylistProps {
+    /** 播放列表配置 */
+    playlist: MMDPlaylistConfig;
+    /** 舞台配置 */
+    stage?: MMDStage;
+    /** 移动端优化配置 */
+    mobileOptimization?: MobileOptimization;
+    /** 事件回调 */
+    onNodeChange?: (node: MMDPlaylistNode, index: number) => void;
+    onPlaylistComplete?: () => void;
+    onError?: (error: Error) => void;
+    /** 是否显示调试信息面板 */
+    showDebugInfo?: boolean;
+    /** 样式 */
+    className?: string;
+    style?: React.CSSProperties;
+}
+
+export type { MMDPlaylistConfig as M, OutlineOptions as O, ResourceOption as R, MMDResourceItem as a, MMDPlaylistNode as b, MMDResourceOptions as c, MMDResources as d, MMDPlayerBaseProps as e, MMDPlayerBaseRef as f, MMDPlayerEnhancedProps as g, MMDPlaylistProps as h, MMDStage as i, MobileOptimization as j };