init with react+axum+spacetimedb

src/routing/appPageRoutes.ts

@@ -0,0 +1,69 @@
+import type { SelectionStage } from '../components/platform-entry';
+
+export type RuntimePageRoute = 'rpg-character-select' | 'rpg-adventure';
+
+const STAGE_ROUTE_ENTRIES = [
+  ['platform', '/'],
+  ['detail', '/worlds/detail'],
+  ['agent-workspace', '/creation/rpg/agent'],
+  ['custom-world-generating', '/creation/rpg/generating'],
+  ['custom-world-result', '/creation/rpg/result'],
+  ['big-fish-agent-workspace', '/creation/big-fish/agent'],
+  ['big-fish-result', '/creation/big-fish/result'],
+  ['big-fish-runtime', '/runtime/big-fish'],
+  ['puzzle-agent-workspace', '/creation/puzzle/agent'],
+  ['puzzle-result', '/creation/puzzle/result'],
+  ['puzzle-gallery-detail', '/gallery/puzzle/detail'],
+  ['puzzle-runtime', '/runtime/puzzle'],
+] as const satisfies readonly (readonly [SelectionStage, string])[];
+
+export const APP_STAGE_ROUTES: Record<SelectionStage, string> =
+  Object.fromEntries(STAGE_ROUTE_ENTRIES) as Record<SelectionStage, string>;
+
+export const APP_RUNTIME_ROUTES: Record<RuntimePageRoute, string> = {
+  'rpg-character-select': '/runtime/rpg/characters',
+  'rpg-adventure': '/runtime/rpg/adventure',
+};
+
+const ROUTE_STAGE_BY_PATH = new Map(
+  STAGE_ROUTE_ENTRIES.map(([stage, path]) => [path, stage] as const),
+) as Map<string, SelectionStage>;
+
+export function normalizeAppPath(pathname: string) {
+  const trimmedPathname = pathname.trim().toLowerCase();
+
+  if (!trimmedPathname || trimmedPathname === '/') {
+    return '/';
+  }
+
+  return trimmedPathname.replace(/\/+$/u, '');
+}
+
+export function resolveSelectionStageFromPath(
+  pathname: string,
+): SelectionStage {
+  return ROUTE_STAGE_BY_PATH.get(normalizeAppPath(pathname)) ?? 'platform';
+}
+
+export function resolvePathForSelectionStage(stage: SelectionStage) {
+  return APP_STAGE_ROUTES[stage] ?? APP_STAGE_ROUTES.platform;
+}
+
+export function isKnownMainAppPagePath(pathname: string) {
+  const normalizedPath = normalizeAppPath(pathname);
+  const runtimePaths: readonly string[] = Object.values(APP_RUNTIME_ROUTES);
+  return (
+    ROUTE_STAGE_BY_PATH.has(normalizedPath) ||
+    runtimePaths.includes(normalizedPath)
+  );
+}
+
+export function pushAppHistoryPath(path: string) {
+  const normalizedPath = normalizeAppPath(path);
+  if (normalizeAppPath(window.location.pathname) === normalizedPath) {
+    return;
+  }
+
+  // 页面阶段变化是用户可感知导航，写入 history 以支持前进后退。
+  window.history.pushState(null, '', normalizedPath);
+}