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

import type { ProjectResourceCategory } from './resourceProjectionModel';

export type ResourceBookCategory = ProjectResourceCategory;

/**
 * 「所有资源」是渲染层的特殊项，不是真实资源栏目。
 *
 * 它只存在于画本（资源总览）自己的状态与渲染里：跨端契约的
 * `ProjectResourceCanvasCategory` 不新增 `'all'`，落盘布局的 `section` 也不会出现它，
 * 因此既不需要改 sidecar schema，也不会污染写入侧的分区口径。
 */
export const RESOURCE_BOOK_ALL_TARGET = 'all' as const;

/** 画本可以打开的目标：真实栏目，或渲染层的「所有资源」。 */
export type ResourceBookTarget =
  | ResourceBookCategory
  | typeof RESOURCE_BOOK_ALL_TARGET;

export function isResourceBookAllTarget(
  value: unknown,
): value is typeof RESOURCE_BOOK_ALL_TARGET {
  return value === RESOURCE_BOOK_ALL_TARGET;
}

export type ResourceBookPhase = 'idle' | 'entering' | 'returning-main';

export type ResourceBookState = {
  view: 'main' | 'child';
  category: ResourceBookTarget | null;
  phase: ResourceBookPhase;
  token: number;
};

export type ResourceBookAction =
  | { type: 'open-category'; category: ResourceBookTarget; token: number }
  | { type: 'finish-transition'; token: number }
  | { type: 'return-to-main'; token: number }
  | { type: 'reset'; token: number };

export const initialResourceBookState: ResourceBookState = {
  view: 'main',
  category: null,
  phase: 'idle',
  token: 0,
};

export function resourceBookReducer(
  state: ResourceBookState,
  action: ResourceBookAction,
): ResourceBookState {
  switch (action.type) {
    case 'open-category': {
      if (
        state.view === 'child' &&
        state.category === action.category &&
        state.phase === 'idle'
      ) {
        return state;
      }
      return {
        ...state,
        view: 'child',
        category: action.category,
        phase: 'entering',
        token: action.token,
      };
    }
    case 'finish-transition':
      return state.token === action.token ? { ...state, phase: 'idle' } : state;
    case 'return-to-main':
      if (state.view !== 'child') {
        return state;
      }
      return {
        ...state,
        view: 'main',
        category: null,
        phase: 'returning-main',
        token: action.token,
      };
    case 'reset':
      return {
        ...initialResourceBookState,
        token: action.token,
      };
    default:
      return state;
  }
}

export function resourceBookSceneCategory(state: ResourceBookState) {
  return state.category;
}

export function resourceBookShowsOverviewCards(state: ResourceBookState) {
  return state.view === 'main';
}

export function resourceBookShowsChildCards(state: ResourceBookState) {
  return state.view === 'child';
}

/**
 * 栏目卡片的呈现方式：
 * - `child`：子画布布局，当前栏目；
 * - `overview`：总览摞布局。进入栏目时其他栏目保留在 DOM 里淡出，总览/返回态全部用总览布局；
 * - `null`：不渲染（子画布静止态的非活动栏目）。
 *
 * 返回总览时，源栏目里没有回到摞上的卡片由布局层额外标成 `exiting`。
 */
export type ResourceBookCardPresentation = 'child' | 'overview' | 'exiting';

/**
 * 是否停在「所有资源」展开态（子画布里的 `all`）。
 *
 * 它与总览态（`main`）不是一回事：总览态每个栏目只铺一小摞，展开态把每个栏目的**全部**
 * 卡片铺在自己那条分带上。判定收在这一处，计划层与渲染层不得各写一份。
 */
export function resourceBookShowsAllCategories(state: ResourceBookState) {
  return state.view === 'child' && isResourceBookAllTarget(state.category);
}

export function resourceBookCategoryCardPresentation(
  state: ResourceBookState,
  category: ResourceBookTarget,
): Exclude<ResourceBookCardPresentation, 'exiting'> | null {
  if (state.view === 'main') {
    return 'overview';
  }
  // 「所有资源」展开态：卡片由各**真实栏目**组承载，而每张资源只属于一个栏目，
  // 因此每张卡在画本场景里仍然只有一个宿主（DOM 查询与 FLIP 键都不会撞车）；
  // `all` 自己不再复制一份卡片，只出钉住的标题栏与全量计数。
  if (isResourceBookAllTarget(state.category)) {
    return isResourceBookAllTarget(category) ? null : 'child';
  }
  if (category === state.category) {
    return 'child';
  }
  // 进入栏目期间其他栏目的卡片留在 DOM 里淡出，不再整层克隆。
  return state.phase === 'entering' ? 'overview' : null;
}

/** 返回总览期间，需要把源栏目未回到摞上的卡片按子画布布局淡出。 */
export function resourceBookShowsExitingCards(state: ResourceBookState) {
  return state.view === 'main' && state.phase === 'returning-main';
}