sa2kit 1.6.33 → 1.6.35

package/dist/mikuFireworks3D/server/index.mjs

@@ -0,0 +1,335 @@
+import '../../chunk-BJTO5JO5.mjs';
+
+// src/mikuFireworks3D/server/FireworksRoomHub.ts
+var DEFAULT_MAX_USERS_PER_ROOM = 200;
+var DEFAULT_HISTORY_LIMIT = 50;
+var DEFAULT_MAX_DANMAKU_LENGTH = 64;
+var FireworksRoomHub = class {
+  constructor(options) {
+    this.rooms = /* @__PURE__ */ new Map();
+    this.sessions = /* @__PURE__ */ new Map();
+    this.maxUsersPerRoom = options?.maxUsersPerRoom ?? DEFAULT_MAX_USERS_PER_ROOM;
+    this.historyLimit = options?.historyLimit ?? DEFAULT_HISTORY_LIMIT;
+    this.maxDanmakuLength = options?.maxDanmakuLength ?? DEFAULT_MAX_DANMAKU_LENGTH;
+    this.logger = options?.logger;
+  }
+  connect(transport, id) {
+    const connectionId = id ?? createId("conn");
+    const session = {
+      id: connectionId,
+      transport
+    };
+    this.sessions.set(connectionId, session);
+    return {
+      id: connectionId,
+      handleMessage: (raw) => this.handleRawMessage(connectionId, raw),
+      disconnect: (reason) => this.disconnect(connectionId, reason),
+      send: (message) => this.sendToConnection(connectionId, message)
+    };
+  }
+  disconnect(connectionId, reason) {
+    const session = this.sessions.get(connectionId);
+    if (!session) {
+      return;
+    }
+    this.leaveRoom(session, false);
+    this.sessions.delete(connectionId);
+    if (reason) {
+      this.logger?.info?.(`[FireworksRoomHub] disconnected ${connectionId}: ${reason}`);
+    }
+  }
+  getStats() {
+    return {
+      rooms: this.rooms.size,
+      connections: this.sessions.size
+    };
+  }
+  getRoomOnlineCount(roomId) {
+    return this.rooms.get(roomId)?.connections.size ?? 0;
+  }
+  handleRawMessage(connectionId, raw) {
+    const message = parseClientMessage(raw);
+    if (!message.ok) {
+      this.sendError(connectionId, "BAD_MESSAGE", message.error);
+      return;
+    }
+    const session = this.sessions.get(connectionId);
+    if (!session) {
+      return;
+    }
+    const clientMessage = message.value;
+    switch (clientMessage.type) {
+      case "join": {
+        this.joinRoom(session, clientMessage.roomId, clientMessage.user);
+        return;
+      }
+      case "leave": {
+        this.leaveRoom(session, true);
+        return;
+      }
+      case "danmaku.send": {
+        this.handleDanmaku(session, clientMessage.payload);
+        return;
+      }
+      case "firework.launch": {
+        this.handleFirework(session, clientMessage.payload);
+        return;
+      }
+      case "ping": {
+        this.sendToConnection(connectionId, {
+          type: "pong",
+          ts: clientMessage.ts ?? Date.now()
+        });
+        return;
+      }
+      default: {
+        this.sendError(connectionId, "UNSUPPORTED_MESSAGE", "Unsupported message type.");
+      }
+    }
+  }
+  joinRoom(session, roomId, user) {
+    const normalizedRoomId = roomId.trim();
+    const normalizedUserId = user.userId.trim();
+    if (!normalizedRoomId) {
+      this.sendError(session.id, "ROOM_ID_REQUIRED", "roomId is required.");
+      return;
+    }
+    if (!normalizedUserId) {
+      this.sendError(session.id, "USER_ID_REQUIRED", "user.userId is required.");
+      return;
+    }
+    if (session.roomId && session.roomId !== normalizedRoomId) {
+      this.leaveRoom(session, true);
+    }
+    const room = this.rooms.get(normalizedRoomId) ?? this.createRoom(normalizedRoomId);
+    if (room.connections.size >= this.maxUsersPerRoom && !room.connections.has(session.id)) {
+      this.sendError(session.id, "ROOM_FULL", "Room is full.");
+      return;
+    }
+    const identity = {
+      userId: normalizedUserId,
+      nickname: user.nickname,
+      avatarUrl: user.avatarUrl
+    };
+    const wasMember = room.connections.has(session.id);
+    room.connections.add(session.id);
+    room.usersByConnection.set(session.id, identity);
+    session.roomId = normalizedRoomId;
+    session.user = identity;
+    this.sendToConnection(session.id, {
+      type: "joined",
+      roomId: normalizedRoomId,
+      self: identity,
+      onlineCount: room.connections.size
+    });
+    this.sendToConnection(session.id, {
+      type: "room.snapshot",
+      roomId: normalizedRoomId,
+      users: Array.from(room.usersByConnection.values()),
+      danmakuHistory: [...room.danmakuHistory],
+      fireworkHistory: [...room.fireworkHistory]
+    });
+    if (!wasMember) {
+      this.broadcastToRoom(normalizedRoomId, {
+        type: "room.user_joined",
+        roomId: normalizedRoomId,
+        user: identity,
+        onlineCount: room.connections.size
+      }, session.id);
+    }
+  }
+  leaveRoom(session, notify) {
+    const roomId = session.roomId;
+    if (!roomId) {
+      return;
+    }
+    const room = this.rooms.get(roomId);
+    if (!room) {
+      session.roomId = void 0;
+      session.user = void 0;
+      return;
+    }
+    const leavingUserId = room.usersByConnection.get(session.id)?.userId;
+    room.connections.delete(session.id);
+    room.usersByConnection.delete(session.id);
+    session.roomId = void 0;
+    session.user = void 0;
+    if (notify && leavingUserId) {
+      this.broadcastToRoom(roomId, {
+        type: "room.user_left",
+        roomId,
+        userId: leavingUserId,
+        onlineCount: room.connections.size
+      });
+    }
+    if (room.connections.size === 0) {
+      this.rooms.delete(roomId);
+    }
+  }
+  handleDanmaku(session, payload) {
+    if (!session.roomId || !session.user) {
+      this.sendError(session.id, "NOT_JOINED", "Join a room before sending danmaku.");
+      return;
+    }
+    const room = this.rooms.get(session.roomId);
+    if (!room) {
+      this.sendError(session.id, "ROOM_NOT_FOUND", "Room does not exist.");
+      return;
+    }
+    const text = payload.text.trim().slice(0, this.maxDanmakuLength);
+    if (!text) {
+      this.sendError(session.id, "EMPTY_DANMAKU", "Danmaku text cannot be empty.");
+      return;
+    }
+    const event = {
+      id: `${session.roomId}-d-${room.seq++}`,
+      roomId: session.roomId,
+      text,
+      color: payload.color,
+      kind: payload.kind,
+      user: session.user,
+      timestamp: Date.now()
+    };
+    room.danmakuHistory.push(event);
+    trimHistory(room.danmakuHistory, this.historyLimit);
+    this.broadcastToRoom(session.roomId, {
+      type: "danmaku.broadcast",
+      roomId: session.roomId,
+      event
+    });
+  }
+  handleFirework(session, payload) {
+    if (!session.roomId || !session.user) {
+      this.sendError(session.id, "NOT_JOINED", "Join a room before launching fireworks.");
+      return;
+    }
+    const room = this.rooms.get(session.roomId);
+    if (!room) {
+      this.sendError(session.id, "ROOM_NOT_FOUND", "Room does not exist.");
+      return;
+    }
+    const event = {
+      id: `${session.roomId}-f-${room.seq++}`,
+      roomId: session.roomId,
+      payload,
+      user: session.user,
+      timestamp: Date.now()
+    };
+    room.fireworkHistory.push(event);
+    trimHistory(room.fireworkHistory, this.historyLimit);
+    this.broadcastToRoom(session.roomId, {
+      type: "firework.broadcast",
+      roomId: session.roomId,
+      event
+    });
+  }
+  createRoom(roomId) {
+    const room = {
+      id: roomId,
+      connections: /* @__PURE__ */ new Set(),
+      usersByConnection: /* @__PURE__ */ new Map(),
+      danmakuHistory: [],
+      fireworkHistory: [],
+      seq: 1
+    };
+    this.rooms.set(roomId, room);
+    return room;
+  }
+  sendToConnection(connectionId, message) {
+    const session = this.sessions.get(connectionId);
+    if (!session) {
+      return;
+    }
+    try {
+      session.transport.send(JSON.stringify(message));
+    } catch (error) {
+      this.logger?.warn?.("[FireworksRoomHub] failed to send message", error);
+    }
+  }
+  broadcastToRoom(roomId, message, excludeConnectionId) {
+    const room = this.rooms.get(roomId);
+    if (!room) {
+      return;
+    }
+    for (const connectionId of room.connections) {
+      if (excludeConnectionId && connectionId === excludeConnectionId) {
+        continue;
+      }
+      this.sendToConnection(connectionId, message);
+    }
+  }
+  sendError(connectionId, code, message) {
+    this.sendToConnection(connectionId, {
+      type: "error",
+      code,
+      message
+    });
+  }
+};
+function createId(prefix) {
+  return `${prefix}-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+}
+function trimHistory(history, limit) {
+  if (history.length <= limit) {
+    return;
+  }
+  history.splice(0, history.length - limit);
+}
+function parseClientMessage(raw) {
+  if (typeof raw === "string") {
+    try {
+      const parsed = JSON.parse(raw);
+      return { ok: true, value: parsed };
+    } catch {
+      return { ok: false, error: "Invalid JSON payload." };
+    }
+  }
+  if (isObject(raw)) {
+    return { ok: true, value: raw };
+  }
+  return { ok: false, error: "Unsupported message payload." };
+}
+function isObject(value) {
+  return typeof value === "object" && value !== null;
+}
+
+// src/mikuFireworks3D/server/wsAdapter.ts
+function bindWsSocket(hub, socket, options) {
+  const connection = hub.connect(
+    {
+      send: (encodedMessage) => {
+        socket.send(encodedMessage);
+      }
+    },
+    options?.connectionId
+  );
+  options?.onConnected?.(connection);
+  socket.on("message", (raw) => {
+    connection.handleMessage(normalizeWsRawData(raw));
+  });
+  socket.on("close", () => {
+    connection.disconnect("socket_closed");
+    options?.onDisconnected?.(connection.id);
+  });
+  socket.on("error", () => {
+    connection.disconnect("socket_error");
+    options?.onDisconnected?.(connection.id);
+  });
+  return connection;
+}
+function normalizeWsRawData(raw) {
+  if (typeof raw === "string") {
+    return raw;
+  }
+  if (raw instanceof ArrayBuffer) {
+    return new TextDecoder().decode(new Uint8Array(raw));
+  }
+  if (ArrayBuffer.isView(raw)) {
+    return new TextDecoder().decode(raw);
+  }
+  return "";
+}
+
+export { FireworksRoomHub, bindWsSocket };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/mikuFireworks3D/server/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/mikuFireworks3D/server/FireworksRoomHub.ts","../../../src/mikuFireworks3D/server/wsAdapter.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import type {\n  DanmakuBroadcastEvent,\n  FireworkBroadcastEvent,\n  FireworksClientMessage,\n  FireworksConnection,\n  FireworksConnectionTransport,\n  FireworksRoomHubOptions,\n  FireworksServerMessage,\n  FireworksUserIdentity,\n} from './types';\n\ninterface Session {\n  id: string;\n  transport: FireworksConnectionTransport;\n  roomId?: string;\n  user?: FireworksUserIdentity;\n}\n\ninterface RoomState {\n  id: string;\n  connections: Set<string>;\n  usersByConnection: Map<string, FireworksUserIdentity>;\n  danmakuHistory: DanmakuBroadcastEvent[];\n  fireworkHistory: FireworkBroadcastEvent[];\n  seq: number;\n}\n\nconst DEFAULT_MAX_USERS_PER_ROOM = 200;\nconst DEFAULT_HISTORY_LIMIT = 50;\nconst DEFAULT_MAX_DANMAKU_LENGTH = 64;\n\nexport class FireworksRoomHub {\n  private readonly rooms = new Map<string, RoomState>();\n  private readonly sessions = new Map<string, Session>();\n  private readonly maxUsersPerRoom: number;\n  private readonly historyLimit: number;\n  private readonly maxDanmakuLength: number;\n  private readonly logger?: Pick<Console, 'info' | 'warn' | 'error'>;\n\n  constructor(options?: FireworksRoomHubOptions) {\n    this.maxUsersPerRoom = options?.maxUsersPerRoom ?? DEFAULT_MAX_USERS_PER_ROOM;\n    this.historyLimit = options?.historyLimit ?? DEFAULT_HISTORY_LIMIT;\n    this.maxDanmakuLength = options?.maxDanmakuLength ?? DEFAULT_MAX_DANMAKU_LENGTH;\n    this.logger = options?.logger;\n  }\n\n  connect(transport: FireworksConnectionTransport, id?: string): FireworksConnection {\n    const connectionId = id ?? createId('conn');\n    const session: Session = {\n      id: connectionId,\n      transport,\n    };\n\n    this.sessions.set(connectionId, session);\n\n    return {\n      id: connectionId,\n      handleMessage: (raw) => this.handleRawMessage(connectionId, raw),\n      disconnect: (reason) => this.disconnect(connectionId, reason),\n      send: (message) => this.sendToConnection(connectionId, message),\n    };\n  }\n\n  disconnect(connectionId: string, reason?: string): void {\n    const session = this.sessions.get(connectionId);\n    if (!session) {\n      return;\n    }\n\n    this.leaveRoom(session, false);\n    this.sessions.delete(connectionId);\n\n    if (reason) {\n      this.logger?.info?.(`[FireworksRoomHub] disconnected ${connectionId}: ${reason}`);\n    }\n  }\n\n  getStats(): { rooms: number; connections: number } {\n    return {\n      rooms: this.rooms.size,\n      connections: this.sessions.size,\n    };\n  }\n\n  getRoomOnlineCount(roomId: string): number {\n    return this.rooms.get(roomId)?.connections.size ?? 0;\n  }\n\n  private handleRawMessage(connectionId: string, raw: unknown): void {\n    const message = parseClientMessage(raw);\n    if (!message.ok) {\n      this.sendError(connectionId, 'BAD_MESSAGE', message.error);\n      return;\n    }\n\n    const session = this.sessions.get(connectionId);\n    if (!session) {\n      return;\n    }\n\n    const clientMessage = message.value;\n\n    switch (clientMessage.type) {\n      case 'join': {\n        this.joinRoom(session, clientMessage.roomId, clientMessage.user);\n        return;\n      }\n      case 'leave': {\n        this.leaveRoom(session, true);\n        return;\n      }\n      case 'danmaku.send': {\n        this.handleDanmaku(session, clientMessage.payload);\n        return;\n      }\n      case 'firework.launch': {\n        this.handleFirework(session, clientMessage.payload);\n        return;\n      }\n      case 'ping': {\n        this.sendToConnection(connectionId, {\n          type: 'pong',\n          ts: clientMessage.ts ?? Date.now(),\n        });\n        return;\n      }\n      default: {\n        this.sendError(connectionId, 'UNSUPPORTED_MESSAGE', 'Unsupported message type.');\n      }\n    }\n  }\n\n  private joinRoom(session: Session, roomId: string, user: FireworksUserIdentity): void {\n    const normalizedRoomId = roomId.trim();\n    const normalizedUserId = user.userId.trim();\n\n    if (!normalizedRoomId) {\n      this.sendError(session.id, 'ROOM_ID_REQUIRED', 'roomId is required.');\n      return;\n    }\n    if (!normalizedUserId) {\n      this.sendError(session.id, 'USER_ID_REQUIRED', 'user.userId is required.');\n      return;\n    }\n\n    if (session.roomId && session.roomId !== normalizedRoomId) {\n      this.leaveRoom(session, true);\n    }\n\n    const room = this.rooms.get(normalizedRoomId) ?? this.createRoom(normalizedRoomId);\n    if (room.connections.size >= this.maxUsersPerRoom && !room.connections.has(session.id)) {\n      this.sendError(session.id, 'ROOM_FULL', 'Room is full.');\n      return;\n    }\n\n    const identity: FireworksUserIdentity = {\n      userId: normalizedUserId,\n      nickname: user.nickname,\n      avatarUrl: user.avatarUrl,\n    };\n\n    const wasMember = room.connections.has(session.id);\n    room.connections.add(session.id);\n    room.usersByConnection.set(session.id, identity);\n\n    session.roomId = normalizedRoomId;\n    session.user = identity;\n\n    this.sendToConnection(session.id, {\n      type: 'joined',\n      roomId: normalizedRoomId,\n      self: identity,\n      onlineCount: room.connections.size,\n    });\n\n    this.sendToConnection(session.id, {\n      type: 'room.snapshot',\n      roomId: normalizedRoomId,\n      users: Array.from(room.usersByConnection.values()),\n      danmakuHistory: [...room.danmakuHistory],\n      fireworkHistory: [...room.fireworkHistory],\n    });\n\n    if (!wasMember) {\n      this.broadcastToRoom(normalizedRoomId, {\n        type: 'room.user_joined',\n        roomId: normalizedRoomId,\n        user: identity,\n        onlineCount: room.connections.size,\n      }, session.id);\n    }\n  }\n\n  private leaveRoom(session: Session, notify: boolean): void {\n    const roomId = session.roomId;\n    if (!roomId) {\n      return;\n    }\n\n    const room = this.rooms.get(roomId);\n    if (!room) {\n      session.roomId = undefined;\n      session.user = undefined;\n      return;\n    }\n\n    const leavingUserId = room.usersByConnection.get(session.id)?.userId;\n\n    room.connections.delete(session.id);\n    room.usersByConnection.delete(session.id);\n\n    session.roomId = undefined;\n    session.user = undefined;\n\n    if (notify && leavingUserId) {\n      this.broadcastToRoom(roomId, {\n        type: 'room.user_left',\n        roomId,\n        userId: leavingUserId,\n        onlineCount: room.connections.size,\n      });\n    }\n\n    if (room.connections.size === 0) {\n      this.rooms.delete(roomId);\n    }\n  }\n\n  private handleDanmaku(\n    session: Session,\n    payload: {\n      text: string;\n      color?: string;\n      kind?: 'normal' | 'miku' | 'avatar';\n    }\n  ): void {\n    if (!session.roomId || !session.user) {\n      this.sendError(session.id, 'NOT_JOINED', 'Join a room before sending danmaku.');\n      return;\n    }\n\n    const room = this.rooms.get(session.roomId);\n    if (!room) {\n      this.sendError(session.id, 'ROOM_NOT_FOUND', 'Room does not exist.');\n      return;\n    }\n\n    const text = payload.text.trim().slice(0, this.maxDanmakuLength);\n    if (!text) {\n      this.sendError(session.id, 'EMPTY_DANMAKU', 'Danmaku text cannot be empty.');\n      return;\n    }\n\n    const event: DanmakuBroadcastEvent = {\n      id: `${session.roomId}-d-${room.seq++}`,\n      roomId: session.roomId,\n      text,\n      color: payload.color,\n      kind: payload.kind,\n      user: session.user,\n      timestamp: Date.now(),\n    };\n\n    room.danmakuHistory.push(event);\n    trimHistory(room.danmakuHistory, this.historyLimit);\n\n    this.broadcastToRoom(session.roomId, {\n      type: 'danmaku.broadcast',\n      roomId: session.roomId,\n      event,\n    });\n  }\n\n  private handleFirework(session: Session, payload: FireworkBroadcastEvent['payload']): void {\n    if (!session.roomId || !session.user) {\n      this.sendError(session.id, 'NOT_JOINED', 'Join a room before launching fireworks.');\n      return;\n    }\n\n    const room = this.rooms.get(session.roomId);\n    if (!room) {\n      this.sendError(session.id, 'ROOM_NOT_FOUND', 'Room does not exist.');\n      return;\n    }\n\n    const event: FireworkBroadcastEvent = {\n      id: `${session.roomId}-f-${room.seq++}`,\n      roomId: session.roomId,\n      payload,\n      user: session.user,\n      timestamp: Date.now(),\n    };\n\n    room.fireworkHistory.push(event);\n    trimHistory(room.fireworkHistory, this.historyLimit);\n\n    this.broadcastToRoom(session.roomId, {\n      type: 'firework.broadcast',\n      roomId: session.roomId,\n      event,\n    });\n  }\n\n  private createRoom(roomId: string): RoomState {\n    const room: RoomState = {\n      id: roomId,\n      connections: new Set(),\n      usersByConnection: new Map(),\n      danmakuHistory: [],\n      fireworkHistory: [],\n      seq: 1,\n    };\n\n    this.rooms.set(roomId, room);\n    return room;\n  }\n\n  private sendToConnection(connectionId: string, message: FireworksServerMessage): void {\n    const session = this.sessions.get(connectionId);\n    if (!session) {\n      return;\n    }\n\n    try {\n      session.transport.send(JSON.stringify(message));\n    } catch (error) {\n      this.logger?.warn?.('[FireworksRoomHub] failed to send message', error);\n    }\n  }\n\n  private broadcastToRoom(roomId: string, message: FireworksServerMessage, excludeConnectionId?: string): void {\n    const room = this.rooms.get(roomId);\n    if (!room) {\n      return;\n    }\n\n    for (const connectionId of room.connections) {\n      if (excludeConnectionId && connectionId === excludeConnectionId) {\n        continue;\n      }\n      this.sendToConnection(connectionId, message);\n    }\n  }\n\n  private sendError(connectionId: string, code: string, message: string): void {\n    this.sendToConnection(connectionId, {\n      type: 'error',\n      code,\n      message,\n    });\n  }\n}\n\nfunction createId(prefix: string): string {\n  return `${prefix}-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;\n}\n\nfunction trimHistory<T>(history: T[], limit: number): void {\n  if (history.length <= limit) {\n    return;\n  }\n  history.splice(0, history.length - limit);\n}\n\nfunction parseClientMessage(raw: unknown):\n  | { ok: true; value: FireworksClientMessage }\n  | { ok: false; error: string } {\n  if (typeof raw === 'string') {\n    try {\n      const parsed = JSON.parse(raw) as FireworksClientMessage;\n      return { ok: true, value: parsed };\n    } catch {\n      return { ok: false, error: 'Invalid JSON payload.' };\n    }\n  }\n\n  if (isObject(raw)) {\n    return { ok: true, value: raw as FireworksClientMessage };\n  }\n\n  return { ok: false, error: 'Unsupported message payload.' };\n}\n\nfunction isObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null;\n}\n","import type { FireworksRoomHub } from './FireworksRoomHub';\nimport type { FireworksConnection, WsLikeSocket } from './types';\n\nexport interface BindWsSocketOptions {\n  connectionId?: string;\n  onConnected?: (connection: FireworksConnection) => void;\n  onDisconnected?: (connectionId: string) => void;\n}\n\n/**\n * Bind a ws-like socket to FireworksRoomHub.\n *\n * Example (ws package):\n * const hub = new FireworksRoomHub();\n * wss.on('connection', (socket) => bindWsSocket(hub, socket));\n */\nexport function bindWsSocket(\n  hub: FireworksRoomHub,\n  socket: WsLikeSocket,\n  options?: BindWsSocketOptions\n): FireworksConnection {\n  const connection = hub.connect(\n    {\n      send: (encodedMessage) => {\n        socket.send(encodedMessage);\n      },\n    },\n    options?.connectionId\n  );\n\n  options?.onConnected?.(connection);\n\n  socket.on('message', (raw) => {\n    connection.handleMessage(normalizeWsRawData(raw));\n  });\n\n  socket.on('close', () => {\n    connection.disconnect('socket_closed');\n    options?.onDisconnected?.(connection.id);\n  });\n\n  socket.on('error', () => {\n    connection.disconnect('socket_error');\n    options?.onDisconnected?.(connection.id);\n  });\n\n  return connection;\n}\n\nfunction normalizeWsRawData(raw: unknown): string {\n  if (typeof raw === 'string') {\n    return raw;\n  }\n\n  if (raw instanceof ArrayBuffer) {\n    return new TextDecoder().decode(new Uint8Array(raw));\n  }\n\n  if (ArrayBuffer.isView(raw)) {\n    return new TextDecoder().decode(raw);\n  }\n\n  return '';\n}\n"]}

package/dist/mikuFusionGame/index.d.mts

@@ -1,6 +1,7 @@
 import React__default, { RefObject } from 'react';
 
 type MikuFusionGameStatus = 'ready' | 'playing' | 'paused' | 'gameOver';
+type OrbImageMapping = Partial<Record<number, string>>;
 interface FusionOrb {
     id: string;
     x: number;
@@ -46,11 +47,15 @@ interface MergeResult {
 interface MikuFusionGameProps extends Partial<MikuFusionGameConfig>, MikuFusionGameCallbacks {
     className?: string;
     storageKey?: string;
+    orbImageStorageKey?: string;
+    enableImageConfigPanel?: boolean;
+    presetOrbImageMapping?: OrbImageMapping;
 }
-declare function MikuFusionGame({ className, storageKey, ...options }: MikuFusionGameProps): React__default.JSX.Element;
+declare function MikuFusionGame({ className, storageKey, orbImageStorageKey, enableImageConfigPanel, presetOrbImageMapping, ...options }: MikuFusionGameProps): React__default.JSX.Element;
 
 interface UseMikuFusionGameOptions extends Partial<MikuFusionGameConfig>, MikuFusionGameCallbacks {
     storageKey?: string;
+    orbImageMapping?: OrbImageMapping;
 }
 interface UseMikuFusionGameResult {
     canvasRef: RefObject<HTMLCanvasElement>;
@@ -109,4 +114,4 @@ declare const RADIUS_STEP = 4;
 declare const LEVEL_LABEL_PREFIX = "M";
 declare const DEFAULT_MIKU_FUSION_CONFIG: MikuFusionGameConfig;
 
-export { BASE_RADIUS, DEFAULT_MIKU_FUSION_CONFIG, type FusionOrb, LEVEL_LABEL_PREFIX, type MergeResult, type MikuFusionContentRegistry, MikuFusionGame, type MikuFusionGameCallbacks, type MikuFusionGameConfig, type MikuFusionGameProps, type MikuFusionGameStatus, type MikuFusionTheme, type ProducerPack, RADIUS_STEP, type SongPack, type ThemePack, type UseMikuFusionGameOptions, type UseMikuFusionGameResult, defaultContentRegistry, useMikuFusionGame, useResponsiveCanvas };
+export { BASE_RADIUS, DEFAULT_MIKU_FUSION_CONFIG, type FusionOrb, LEVEL_LABEL_PREFIX, type MergeResult, type MikuFusionContentRegistry, MikuFusionGame, type MikuFusionGameCallbacks, type MikuFusionGameConfig, type MikuFusionGameProps, type MikuFusionGameStatus, type MikuFusionTheme, type OrbImageMapping, type ProducerPack, RADIUS_STEP, type SongPack, type ThemePack, type UseMikuFusionGameOptions, type UseMikuFusionGameResult, defaultContentRegistry, useMikuFusionGame, useResponsiveCanvas };

package/dist/mikuFusionGame/index.d.ts

@@ -1,6 +1,7 @@
 import React__default, { RefObject } from 'react';
 
 type MikuFusionGameStatus = 'ready' | 'playing' | 'paused' | 'gameOver';
+type OrbImageMapping = Partial<Record<number, string>>;
 interface FusionOrb {
     id: string;
     x: number;
@@ -46,11 +47,15 @@ interface MergeResult {
 interface MikuFusionGameProps extends Partial<MikuFusionGameConfig>, MikuFusionGameCallbacks {
     className?: string;
     storageKey?: string;
+    orbImageStorageKey?: string;
+    enableImageConfigPanel?: boolean;
+    presetOrbImageMapping?: OrbImageMapping;
 }
-declare function MikuFusionGame({ className, storageKey, ...options }: MikuFusionGameProps): React__default.JSX.Element;
+declare function MikuFusionGame({ className, storageKey, orbImageStorageKey, enableImageConfigPanel, presetOrbImageMapping, ...options }: MikuFusionGameProps): React__default.JSX.Element;
 
 interface UseMikuFusionGameOptions extends Partial<MikuFusionGameConfig>, MikuFusionGameCallbacks {
     storageKey?: string;
+    orbImageMapping?: OrbImageMapping;
 }
 interface UseMikuFusionGameResult {
     canvasRef: RefObject<HTMLCanvasElement>;
@@ -109,4 +114,4 @@ declare const RADIUS_STEP = 4;
 declare const LEVEL_LABEL_PREFIX = "M";
 declare const DEFAULT_MIKU_FUSION_CONFIG: MikuFusionGameConfig;
 
-export { BASE_RADIUS, DEFAULT_MIKU_FUSION_CONFIG, type FusionOrb, LEVEL_LABEL_PREFIX, type MergeResult, type MikuFusionContentRegistry, MikuFusionGame, type MikuFusionGameCallbacks, type MikuFusionGameConfig, type MikuFusionGameProps, type MikuFusionGameStatus, type MikuFusionTheme, type ProducerPack, RADIUS_STEP, type SongPack, type ThemePack, type UseMikuFusionGameOptions, type UseMikuFusionGameResult, defaultContentRegistry, useMikuFusionGame, useResponsiveCanvas };
+export { BASE_RADIUS, DEFAULT_MIKU_FUSION_CONFIG, type FusionOrb, LEVEL_LABEL_PREFIX, type MergeResult, type MikuFusionContentRegistry, MikuFusionGame, type MikuFusionGameCallbacks, type MikuFusionGameConfig, type MikuFusionGameProps, type MikuFusionGameStatus, type MikuFusionTheme, type OrbImageMapping, type ProducerPack, RADIUS_STEP, type SongPack, type ThemePack, type UseMikuFusionGameOptions, type UseMikuFusionGameResult, defaultContentRegistry, useMikuFusionGame, useResponsiveCanvas };

package/dist/mikuFusionGame/index.js

@@ -1,7 +1,10 @@
 'use strict';
 
+var chunkHHVDOIPV_js = require('../chunk-HHVDOIPV.js');
+require('../chunk-ZWQJSZEY.js');
 var chunkKO73EBUT_js = require('../chunk-KO73EBUT.js');
 require('../chunk-XJ7ZAGC5.js');
+require('../chunk-25OFOKNF.js');
 require('../chunk-DGUM43GV.js');
 var React3 = require('react');
 
@@ -223,7 +226,7 @@ function getOrbColor(level, config) {
   const index = Math.max(0, Math.min(config.theme.orbColors.length - 1, level - 1));
   return config.theme.orbColors[index] || "#22d3ee";
 }
-function drawScene(context, width, height, config, orbs, aimX, nextLevel, status) {
+function drawScene(context, width, height, config, orbs, aimX, nextLevel, status, imageCache) {
   const gradient = context.createLinearGradient(0, 0, 0, height);
   gradient.addColorStop(0, config.theme.backgroundTop);
   gradient.addColorStop(1, config.theme.backgroundBottom);
@@ -244,15 +247,51 @@ function drawScene(context, width, height, config, orbs, aimX, nextLevel, status
   context.lineTo(aimX, config.spawnY);
   context.stroke();
   const previewRadius = getRadiusByLevel(nextLevel);
-  context.fillStyle = getOrbColor(nextLevel, config);
+  const previewY = config.spawnY - previewRadius - 4;
+  const previewImage = imageCache[nextLevel];
   context.beginPath();
-  context.arc(aimX, config.spawnY - previewRadius - 4, previewRadius, 0, Math.PI * 2);
-  context.fill();
+  context.arc(aimX, previewY, previewRadius, 0, Math.PI * 2);
+  context.closePath();
+  if (previewImage && previewImage.complete && previewImage.naturalWidth > 0) {
+    context.save();
+    context.clip();
+    context.drawImage(
+      previewImage,
+      aimX - previewRadius,
+      previewY - previewRadius,
+      previewRadius * 2,
+      previewRadius * 2
+    );
+    context.restore();
+  } else {
+    context.fillStyle = getOrbColor(nextLevel, config);
+    context.fill();
+  }
   orbs.forEach((orb) => {
     context.beginPath();
-    context.fillStyle = getOrbColor(orb.level, config);
     context.arc(orb.x, orb.y, orb.radius, 0, Math.PI * 2);
-    context.fill();
+    context.closePath();
+    const orbImage = imageCache[orb.level];
+    if (orbImage && orbImage.complete && orbImage.naturalWidth > 0) {
+      context.save();
+      context.clip();
+      context.drawImage(
+        orbImage,
+        orb.x - orb.radius,
+        orb.y - orb.radius,
+        orb.radius * 2,
+        orb.radius * 2
+      );
+      context.restore();
+      context.beginPath();
+      context.strokeStyle = "rgba(15, 23, 42, 0.15)";
+      context.lineWidth = 1;
+      context.arc(orb.x, orb.y, orb.radius, 0, Math.PI * 2);
+      context.stroke();
+    } else {
+      context.fillStyle = getOrbColor(orb.level, config);
+      context.fill();
+    }
     context.fillStyle = "#0f172a";
     context.font = "bold 12px system-ui";
     context.textAlign = "center";
@@ -291,10 +330,26 @@ function useMikuFusionGame(options = {}) {
   const config = configRef.current;
   const onScoreChangeRef = React3.useRef(options.onScoreChange);
   const onGameOverRef = React3.useRef(options.onGameOver);
+  const orbImageMappingRef = React3.useRef(options.orbImageMapping ?? {});
+  const imageCacheRef = React3.useRef({});
   React3.useEffect(() => {
     onScoreChangeRef.current = options.onScoreChange;
     onGameOverRef.current = options.onGameOver;
   }, [options.onGameOver, options.onScoreChange]);
+  React3.useEffect(() => {
+    orbImageMappingRef.current = options.orbImageMapping ?? {};
+    const nextCache = {};
+    Object.entries(orbImageMappingRef.current).forEach(([levelText, src]) => {
+      const level = Number(levelText);
+      if (!src || Number.isNaN(level)) {
+        return;
+      }
+      const image = new window.Image();
+      image.src = src;
+      nextCache[level] = image;
+    });
+    imageCacheRef.current = nextCache;
+  }, [options.orbImageMapping]);
   const [bestScore, setBestScore] = chunkKO73EBUT_js.useLocalStorage(
     options.storageKey || "sa2kit:mikuFusionGame:bestScore",
     0
@@ -327,7 +382,8 @@ function useMikuFusionGame(options = {}) {
         orbsRef.current,
         aimXRef.current,
         nextLevel,
-        nextStatus
+        nextStatus,
+        imageCacheRef.current
       );
     },
     [config, nextLevel, status]
@@ -571,8 +627,24 @@ function GameResultModal({ open, score, bestScore, onRestart }) {
 }
 
 // src/mikuFusionGame/components/MikuFusionGame.tsx
-function MikuFusionGame({ className, storageKey, ...options }) {
+function MikuFusionGame({
+  className,
+  storageKey,
+  orbImageStorageKey = "sa2kit:mikuFusionGame:orbImages",
+  enableImageConfigPanel = true,
+  presetOrbImageMapping = {},
+  ...options
+}) {
   const containerRef = React3.useRef(null);
+  const [orbImageMapping, setOrbImageMapping] = React3.useState({});
+  const [isUserDefineMode] = React3.useState(() => {
+    if (typeof window === "undefined") {
+      return false;
+    }
+    const value = new URLSearchParams(window.location.search).get("userDefine");
+    return value === "true";
+  });
+  const activeOrbImageMapping = isUserDefineMode ? orbImageMapping : presetOrbImageMapping;
   const {
     canvasRef,
     status,
@@ -584,7 +656,46 @@ function MikuFusionGame({ className, storageKey, ...options }) {
     handleDrop,
     togglePause,
     restart
-  } = useMikuFusionGame({ ...options, storageKey });
+  } = useMikuFusionGame({ ...options, storageKey, orbImageMapping: activeOrbImageMapping });
+  const panelItems = React3.useMemo(
+    () => Array.from({ length: config.maxLevel }, (_, index) => ({
+      id: String(index + 1),
+      label: `M${index + 1}`
+    })),
+    [config.maxLevel]
+  );
+  const panelValue = React3.useMemo(
+    () => Object.entries(orbImageMapping).reduce((acc, [key, value]) => {
+      if (value) {
+        acc[String(key)] = value;
+      }
+      return acc;
+    }, {}),
+    [orbImageMapping]
+  );
+  React3.useEffect(() => {
+    if (typeof window === "undefined") {
+      return;
+    }
+    try {
+      const raw = window.localStorage.getItem(orbImageStorageKey);
+      if (!raw) {
+        setOrbImageMapping({});
+        return;
+      }
+      const parsed = JSON.parse(raw);
+      const normalized = {};
+      Object.entries(parsed).forEach(([key, value]) => {
+        const level = Number(key);
+        if (!Number.isNaN(level) && typeof value === "string" && value) {
+          normalized[level] = value;
+        }
+      });
+      setOrbImageMapping(normalized);
+    } catch {
+      setOrbImageMapping({});
+    }
+  }, [orbImageStorageKey]);
   const { displayWidth, displayHeight } = useResponsiveCanvas(
     config.width,
     config.height,
@@ -624,6 +735,16 @@ function MikuFusionGame({ className, storageKey, ...options }) {
       togglePause();
     }
   };
+  const handlePanelValueChange = (next) => {
+    const normalized = {};
+    Object.entries(next).forEach(([key, value]) => {
+      const level = Number(key);
+      if (!Number.isNaN(level) && value) {
+        normalized[level] = value;
+      }
+    });
+    setOrbImageMapping(normalized);
+  };
   return /* @__PURE__ */ React3__default.default.createElement(
     "div",
     {
@@ -657,7 +778,17 @@ function MikuFusionGame({ className, storageKey, ...options }) {
         onTogglePause: togglePause,
         onRestart: restart
       }
-    )
+    ),
+    enableImageConfigPanel && isUserDefineMode ? /* @__PURE__ */ React3__default.default.createElement(
+      chunkHHVDOIPV_js.LocalImageMappingPanel,
+      {
+        storageKey: orbImageStorageKey,
+        title: "\u7403\u4F53\u56FE\u7247\u914D\u7F6E\uFF08\u4FDD\u5B58\u5230\u672C\u5730\uFF09",
+        items: panelItems,
+        defaultValue: panelValue,
+        onValueChange: handlePanelValueChange
+      }
+    ) : null
   );
 }