Skip to content

armgit / peach

Public Imported from GitHub
0

Peach: Local-first video metadata scraper and media manager.

3.4 KB
Raw Blame
import { FOLLOW_RANDOM_SORT, type FollowFeedActions, type FollowFeedHelpers, type FollowFeedProps, type FollowView } from './follow-feed';
import { followViewPath, readFollowView } from './follow-view';

export interface FollowSession {
  discoverySeed: number;
  revision: number;
  scrollY: number;
}
export type FollowPreferences = Pick<FollowFeedProps, 'selectMode' | 'selected' | 'photoSize' | 'photoLayout' | 'imagesOnly'>;

/** 地址认领、会话存储与宿主操作分别由唯一拥有者提供。 */
export interface FollowControllerPorts {
  location(): { pathname: string; search: string };
  view(): FollowView;
  adoptView(view: FollowView): void;
  session(): FollowSession;
  writeSession(patch: Partial<FollowSession>): void;
  preferences(): FollowPreferences;
  live(): boolean;
  push(patch: Partial<FollowFeedProps>): void;
  route(path: string): void;
  openPage(path: string): void;
  rollSeed(): number;
  enterSeed(): number;
  revealFeed(): void;
  syncPhotoWalls(): void;
  scrollTop(): void;
}

export function createFollowController(ports: FollowControllerPorts, helpers: FollowFeedHelpers,
  delegated: Omit<FollowFeedActions, 'route' | 'shuffle'>) {
  const read = () => {
    const view = readFollowView(ports.location().search, ports.view().seed, ports.rollSeed);
    ports.adoptView(view);
    return view;
  };
  const push = (patch: Partial<FollowFeedProps>) => { if (ports.live()) ports.push(patch) };
  const route = (view: FollowView, patch: Partial<FollowFeedProps> = {}) => {
    ports.adoptView(view);
    ports.route(followViewPath(view));
    push({ ...patch, view: ports.view() });
    ports.syncPhotoWalls();
  };
  const shuffle = () => {
    const seed = ports.rollSeed();
    ports.writeSession({ discoverySeed: seed });
    route({ ...ports.view(), seed, sort: FOLLOW_RANDOM_SORT }, { seed: ports.session().discoverySeed });
  };
  // 动作对象跨 props 推送保持身份,卡片的 memo 不因页内筛选失效。
  const actions: FollowFeedActions = { ...delegated, route, shuffle };
  const props = (): FollowFeedProps => {
    const session = ports.session(), preferences = ports.preferences();
    return { ...preferences, selected: new Set(preferences.selected), view: ports.view(),
      seed: session.discoverySeed, revision: session.revision, helpers, actions };
  };
  return {
    actions, props, read, route, shuffle,
    refresh(restored?: Pick<FollowFeedProps, 'view' | 'seed' | 'revision'>): boolean {
      if (restored) {
        ports.adoptView(restored.view);
        ports.writeSession({ discoverySeed: restored.seed, revision: restored.revision });
      }
      const view = read();
      if (!ports.live()) return false;
      ports.revealFeed();
      push({ view, seed: ports.session().discoverySeed, revision: ports.session().revision });
      ports.syncPhotoWalls();
      return true;
    },
    enter(fresh = false): void {
      if (fresh) {
        ports.writeSession({ discoverySeed: ports.enterSeed(), scrollY: 0,
          revision: ports.session().revision + 1 });
        ports.openPage('/follow');
      } else if (ports.location().pathname !== '/follow') ports.openPage(followViewPath(ports.view()));
    },
  };
}

/** 资料页在线卡复用详情与偏好动作,页级筛选、抽屉与本地多选各由资料页持有。 */
export function entityFollowActions(actions: FollowFeedActions): FollowFeedActions {
  return { ...actions, route: () => {}, shuffle: () => {}, loaded: () => {}, toggleSelection: () => {} };
}