Genarrative/apps/ai-game-creator-shell/src/view/project-development/resourceCanvasSectionMapping.ts

import {
  isLegacyProjectResourceCanvasSection,
  isProjectResourceCanvasCategory,
  type LegacyProjectResourceCanvasSection,
  type PersistedProjectResourceCanvasSection,
  type ProjectResourceCanvasCategory,
} from '../../../../../packages/shared/src/contracts/gameCreationApp';

/**
 * 旧栏目值 → 现行分区集合。旧四 / 五栏目是「扩展名 + mediaType」口径，无法 1:1 归并到
 * 6 类资产分类，因此按资源当前分区做保守归并：
 *
 * - `document` / `audio` / `version` 在新旧口径下同名，1:1 保留；
 * - 旧 `art` 混合了 UI 交互、角色与对象、场景与环境与待归类，按资源当前分区落入其中之一；
 * - 旧 `code` 在 6 类资产分类里没有对应栏目，统一落入「待归类」。
 */
export const LEGACY_RESOURCE_CANVAS_SECTION_TARGETS: Record<
  LegacyProjectResourceCanvasSection,
  readonly ProjectResourceCanvasCategory[]
> = {
  document: ['document'],
  audio: ['audio'],
  version: ['version'],
  art: ['ui-interaction', 'character', 'scene', 'unclassified'],
  code: ['unclassified'],
};

/**
 * 把磁盘上的 `section` 值归一到现行分区。
 *
 * 两条归并语义都由**资源当前分类**收口，因为"这张卡属于哪一栏"的唯一真源本来就是
 * `resource.category`（协调时按它分组），持久化的 `section` 只是"它当初放在哪一栏"的记录：
 *
 * 1. **现行栏目值**：原样返回资源当前分类。旧实现里"现行值但不等于当前分类"直接判 null、
 *    整条坐标被丢弃 —— 那等于把用户手摆的位置换成自动排布。资源分类会变（例如
 *    `kind:"UI"` 的资产从「待归类」被修到「UI 交互」），一改就静默丢掉落盘坐标，是用户可见的损失。
 * 2. **旧栏目值**：落在该旧栏目的归并目标集合内就归并到资源当前分类，否则判 null。
 *
 * 两处都**只改写 `section`，x / y / manuallyPlaced 原样保留**；坐标是栏目内局部坐标
 * （相邻的 `reconcileResourceCanvasLayout` 按 section 分组后再算栏目带原点），所以换栏目
 * 保留 x / y 得到的正是"这张卡在新栏目里的同一个槽位"。
 *
 * 返回 `null` 只留给**真正无从归并**的取值：无法识别的分区值，以及旧栏目目标的集合
 * 不含资源当前分类的情况（如旧 `code` 遇到已归为 `document` 的资源）。
 */
export function resolveResourceCanvasSection(
  section: unknown,
  resourceCategory: ProjectResourceCanvasCategory,
): ProjectResourceCanvasCategory | null {
  if (isProjectResourceCanvasCategory(section)) {
    return resourceCategory;
  }
  if (!isLegacyProjectResourceCanvasSection(section)) {
    return null;
  }
  return LEGACY_RESOURCE_CANVAS_SECTION_TARGETS[section].includes(
    resourceCategory,
  )
    ? resourceCategory
    : null;
}

export type NormalizedResourceCanvasPosition = {
  resourceId: string;
  section: ProjectResourceCanvasCategory;
  x: number;
  y: number;
  manuallyPlaced: boolean;
};

export type NormalizedResourceCanvasPositionResult = {
  position: NormalizedResourceCanvasPosition;
  /**
   * 该坐标的 `section` 是否被读时改写。改写后的布局与原布局逐项不同，
   * 既有协调路径据此判定 `changed` 并写入一次新分区的 sidecar。
   */
  changed: boolean;
};

/**
 * 读时兼容映射：把一条持久化坐标归一到现行分区，原样保留 `x / y / manuallyPlaced`。
 *
 * 返回 `null` 表示资源不存在或该坐标确实无从归并，调用方不应把它放进任何分区；
 * **分区取值与资源当前分类不一致不属于"无从归并"**，见 [`resolveResourceCanvasSection`]。
 */
export function normalizeResourceCanvasPosition(
  position: {
    resourceId: string;
    section: PersistedProjectResourceCanvasSection;
    x: number;
    y: number;
    manuallyPlaced: boolean;
  },
  categoryByResourceId: ReadonlyMap<string, ProjectResourceCanvasCategory>,
): NormalizedResourceCanvasPositionResult | null {
  const resourceCategory = categoryByResourceId.get(position.resourceId);
  if (resourceCategory === undefined) {
    return null;
  }
  const section = resolveResourceCanvasSection(
    position.section,
    resourceCategory,
  );
  if (section === null) {
    return null;
  }
  return {
    position: {
      resourceId: position.resourceId,
      section,
      x: position.x,
      y: position.y,
      manuallyPlaced: position.manuallyPlaced,
    },
    changed: section !== position.section,
  };
}