create-pixi-vn 2.0.14 → 2.1.0

package/template-react-vite-muijoy-ink/src/lib/hooks/hotkeys-hooks.ts

@@ -2,22 +2,47 @@ import { useAlertDialog } from "@/components/providers/alert-dialog-provider";
 import { useNarrationFunctions } from "@/lib/hooks/narration-hooks";
 import { useSetSearchParamState } from "@/lib/hooks/navigation-hooks";
 import { useGameProps } from "@/lib/hooks/props-hooks";
-import { useQueryInputValue } from "@/lib/query/narration-query";
+import { useQueryCanGoNext, useQueryInputValue } from "@/lib/query/narration-query";
 import {
     LAST_SAVE_USE_QUERY_KEY,
     SAVES_USE_QUERY_KEY,
     useQueryLastSave,
 } from "@/lib/query/save-query";
+import { AlertDialogState } from "@/lib/stores/alert-dialog-store";
 import { QuickActionsWheelState } from "@/lib/stores/quick-actions-wheel-store";
+import { SearchParams } from "@/lib/stores/search-param-store";
 import { SkipSettings } from "@/lib/stores/skip-settings-store";
+import { TextDisplaySettings } from "@/lib/stores/text-display-settings-store";
 import { loadSave, saveGameToIndexDB } from "@/lib/utils/save-utility";
+import { narration } from "@drincs/pixi-vn";
 import { useHotkeys } from "@tanstack/react-hotkeys";
 import { useQueryClient } from "@tanstack/react-query";
 import { useLocation } from "@tanstack/react-router";
-import { useCallback } from "react";
+import { useSelector } from "@tanstack/react-store";
+import { useCallback, useMemo, useRef } from "react";
 import { useTranslation } from "react-i18next";
 import { toast } from "sonner";
 
+function useMenuDialogState() {
+    const searchParams = useSelector(SearchParams.store, (state) => state);
+    const alertDialogCount = useSelector(AlertDialogState.store, (state) => state.count);
+    const { data: { isRequired } = {} } = useQueryInputValue<string | number>();
+
+    /** true when the settings menu (or any sub-page) is open */
+    const isSettingsOpen = useMemo(
+        () => Object.values(searchParams).some((v) => v !== undefined),
+        [searchParams],
+    );
+
+    /** true when an alert confirmation dialog or the input-request dialog is blocking interaction */
+    const isAlertOrInputOpen = alertDialogCount > 0 || !!isRequired;
+
+    /** true when any menu or dialog that should disable hotkeys is open */
+    const isAnyMenuOrDialogOpen = isSettingsOpen || isAlertOrInputOpen;
+
+    return { isAnyMenuOrDialogOpen, isSettingsOpen, isAlertOrInputOpen };
+}
+
 /**
  * useSaveHotkeys
  *
@@ -40,6 +65,7 @@ export function useSaveHotkeys(): null {
     const { data: lastSave = null } = useQueryLastSave();
     const { openAlertDialog } = useAlertDialog();
     const gameProps = useGameProps();
+    const { isSettingsOpen } = useMenuDialogState();
 
     const quickSave = useCallback(() => {
         if (location.pathname === "/") {
@@ -87,6 +113,7 @@ export function useSaveHotkeys(): null {
             hotkey: "F5",
             callback: quickSave,
             options: {
+                enabled: !isSettingsOpen,
                 meta: {
                     name: t("quick_save"),
                     description: t("quick_save_hotkey_description"),
@@ -97,6 +124,7 @@ export function useSaveHotkeys(): null {
             hotkey: "Control+S",
             callback: quickSave,
             options: {
+                enabled: !isSettingsOpen,
                 meta: {
                     name: t("quick_save"),
                     description: t("quick_save_hotkey_alternative_description"),
@@ -107,6 +135,7 @@ export function useSaveHotkeys(): null {
             hotkey: "F9",
             callback: quickLoad,
             options: {
+                enabled: !isSettingsOpen,
                 meta: {
                     name: t("load_last_save"),
                     description: t("quick_load_hotkey_description"),
@@ -117,6 +146,7 @@ export function useSaveHotkeys(): null {
             hotkey: "Control+L",
             callback: quickLoad,
             options: {
+                enabled: !isSettingsOpen,
                 meta: {
                     name: t("load_last_save"),
                     description: t("quick_load_hotkey_alternative_description"),
@@ -132,6 +162,7 @@ export function useSettingsHotkeys(): null {
     const { t } = useTranslation(["ui"]);
     const setSettingsOpen = useSetSearchParamState<boolean>("settings");
     const setSettingsTab = useSetSearchParamState<string>("settings_tab");
+    const { isAnyMenuOrDialogOpen } = useMenuDialogState();
 
     const openControlsPage = useCallback(() => {
         setSettingsOpen(true);
@@ -150,9 +181,10 @@ export function useSettingsHotkeys(): null {
             },
         },
         {
-            hotkey: "Control+K",
+            hotkey: "K",
             callback: openControlsPage,
             options: {
+                enabled: !isAnyMenuOrDialogOpen,
                 meta: {
                     name: t("hotkeys_menu"),
                     description: t("hotkeys_menu_shortcut_description"),
@@ -169,6 +201,7 @@ export function useGameHotkeys(): null {
     const setSettingsTab = useSetSearchParamState<string>("settings_tab");
     const setHistory = useSetSearchParamState<boolean>("history");
     const { t } = useTranslation(["ui"]);
+    const { isAnyMenuOrDialogOpen } = useMenuDialogState();
 
     const openHistoryPage = useCallback(() => {
         setHistory(undefined);
@@ -187,9 +220,10 @@ export function useGameHotkeys(): null {
 
     useHotkeys([
         {
-            hotkey: "Control+H",
+            hotkey: "H",
             callback: openHistoryPage,
             options: {
+                enabled: !isAnyMenuOrDialogOpen,
                 meta: {
                     name: t("history"),
                     description: t("history_hotkey_description"),
@@ -200,6 +234,7 @@ export function useGameHotkeys(): null {
             hotkey: "Tab",
             callback: toggleQuickActionsWheel,
             options: {
+                enabled: !isAnyMenuOrDialogOpen,
                 meta: {
                     name: t("quick_actions"),
                     description: t("quick_actions_open_description"),
@@ -211,38 +246,104 @@ export function useGameHotkeys(): null {
     return null;
 }
 
+export function useChoiceMenuHotkeys(menuLength: number) {
+    const { t } = useTranslation(["ui"]);
+    const menuRef = useRef<HTMLDivElement>(null);
+
+    function getMenuItems(): HTMLButtonElement[] {
+        if (!menuRef.current) return [];
+        return Array.from(
+            menuRef.current.querySelectorAll<HTMLButtonElement>(
+                "button[role='menuitem']:not(:disabled)",
+            ),
+        );
+    }
+
+    function focusMenuItem(direction: "up" | "down") {
+        const items = getMenuItems();
+        if (!items.length) return;
+        const active = document.activeElement as HTMLElement;
+        const currentIndex = items.indexOf(active as HTMLButtonElement);
+        let next: number;
+        if (direction === "down") {
+            next = currentIndex < items.length - 1 ? currentIndex + 1 : 0;
+        } else {
+            next = currentIndex > 0 ? currentIndex - 1 : items.length - 1;
+        }
+        items[next].focus();
+    }
+
+    useHotkeys([
+        {
+            hotkey: "ArrowDown",
+            callback: () => focusMenuItem("down"),
+            options: {
+                enabled: menuLength > 0,
+                preventDefault: true,
+                meta: {
+                    name: t("choice_navigation"),
+                    description: t("choice_navigation_description"),
+                },
+            },
+        },
+        {
+            hotkey: "ArrowUp",
+            callback: () => focusMenuItem("up"),
+            options: {
+                enabled: menuLength > 0,
+                preventDefault: true,
+                meta: {
+                    name: t("choice_navigation"),
+                    description: t("choice_navigation_description"),
+                },
+            },
+        },
+    ]);
+
+    return { menuRef };
+}
+
 export function useNarrationHotkeys(): null {
     const { t } = useTranslation(["ui"]);
     const { goNext } = useNarrationFunctions();
-    const { data: { isRequired } = {} } = useQueryInputValue<string | number>();
+    const typewriterInProgress = useSelector(
+        TextDisplaySettings.store,
+        (state) => state.inProgress,
+    );
+    const { isAnyMenuOrDialogOpen } = useMenuDialogState();
+    const { data: canGoNext } = useQueryCanGoNext();
 
     const onSkipKeyDown = useCallback(() => SkipSettings.setEnabled(true), []);
     const onSkipKeyUp = useCallback(() => {
         SkipSettings.setEnabled(false);
+        if (typewriterInProgress && !narration.dialogGlue) {
+            TextDisplaySettings.complete();
+            return;
+        }
         goNext();
-    }, [goNext]);
+    }, [goNext, typewriterInProgress]);
 
     useHotkeys([
         {
             hotkey: "Enter",
             callback: onSkipKeyDown,
             options: {
+                enabled: !isAnyMenuOrDialogOpen && canGoNext,
                 meta: {
                     name: t("skip"),
                     description: t("skip_hold_description"),
                 },
-                enabled: !isRequired,
             },
         },
         {
             hotkey: "Space",
             callback: onSkipKeyDown,
             options: {
+                enabled: !isAnyMenuOrDialogOpen && canGoNext,
                 meta: {
                     name: t("skip"),
                     description: t("skip_hold_space_description"),
                 },
-                enabled: !isRequired,
             },
         },
         {
@@ -251,11 +352,11 @@ export function useNarrationHotkeys(): null {
             options: {
                 eventType: "keyup",
                 conflictBehavior: "allow",
+                enabled: !isAnyMenuOrDialogOpen && canGoNext,
                 meta: {
                     name: t("next"),
                     description: t("skip_release_description"),
                 },
-                enabled: !isRequired,
             },
         },
         {
@@ -264,11 +365,11 @@ export function useNarrationHotkeys(): null {
             options: {
                 eventType: "keyup",
                 conflictBehavior: "allow",
+                enabled: !isAnyMenuOrDialogOpen && canGoNext,
                 meta: {
                     name: t("next"),
                     description: t("skip_release_space_description"),
                 },
-                enabled: !isRequired,
             },
         },
     ]);

package/template-react-vite-muijoy-ink/src/lib/hooks/narration-hooks.ts

@@ -22,6 +22,7 @@ export function useNarrationFunctions() {
 
     const goNext = useCallback(async () => {
         if (hasOpenMenu) return;
+        TextDisplaySettings.resetForNext();
         GameStatus.setLoading(true);
         try {
             if (!narration.canContinue) {
@@ -94,6 +95,7 @@ const isDragGesture = (dx: number, dy: number) =>
 export function useNarrationPointerHandlers() {
     const { goNext } = useNarrationFunctions();
     const skipEnabled = useSelector(SkipSettings.store, (state) => state.enabled);
+    const typewriterInProgress = useSelector(TextDisplaySettings.store, (state) => state.inProgress);
     const pointerDownPos = useRef<{ x: number; y: number } | null>(null);
     const longPressTimer = useRef<ReturnType<typeof setTimeout> | null>(null);
     const longPressTriggered = useRef(false);
@@ -166,9 +168,13 @@ export function useNarrationPointerHandlers() {
             if (skipEnabled) {
                 SkipSettings.setEnabled(false);
             }
+            if (typewriterInProgress && !narration.dialogGlue) {
+                TextDisplaySettings.complete();
+                return;
+            }
             goNext();
         },
-        [clearLongPressTimer, goNext, skipEnabled],
+        [clearLongPressTimer, goNext, skipEnabled, typewriterInProgress],
     );
 
     const handlePointerMove = useCallback(

package/template-react-vite-muijoy-ink/src/lib/query/narration-query.ts

@@ -1,6 +1,9 @@
 import { INTERFACE_DATA_USE_QUERY_KEY } from "@/constants";
+import { TextDisplaySettings } from "@/lib/stores/text-display-settings-store";
 import { type CharacterInterface, narration, stepHistory } from "@drincs/pixi-vn";
 import { keepPreviousData, useQuery, useQueryClient } from "@tanstack/react-query";
+import { useSelector } from "@tanstack/react-store";
+import { useCallback } from "react";
 import { useTranslation } from "react-i18next";
 
 const CAN_GO_BACK_USE_QUERY_KEY = "can_go_back_use_query_key";
@@ -24,7 +27,6 @@ export function useQueryChoiceMenuOptions() {
                         ? t(option.text)
                         : option.text.map((text) => t(text)).join(" "),
             })) || [],
-        placeholderData: keepPreviousData,
     });
 }
 
@@ -45,13 +47,30 @@ type DialogueModel = {
     animatedText?: string;
     text?: string;
     character?: CharacterInterface;
+    lastText?: string;
 };
 const DIALOGUE_USE_QUERY_KEY = "dialogue_use_query_key";
 export function useQueryDialogue() {
     const { t } = useTranslation(["narration"]);
     const queryClient = useQueryClient();
+    const forceComplete = useSelector(TextDisplaySettings.store, (state) => state.forceComplete);
 
-    return useQuery<DialogueModel>({
+    const finalizeDialogue = useCallback(() => {
+        queryClient.setQueryData<DialogueModel>(
+            [INTERFACE_DATA_USE_QUERY_KEY, DIALOGUE_USE_QUERY_KEY],
+            (prev) => {
+                if (!prev) return prev;
+                const fullText = (prev.text || "") + (prev.animatedText || "");
+                return {
+                    ...prev,
+                    text: fullText || undefined,
+                    animatedText: undefined,
+                };
+            },
+        );
+    }, [queryClient]);
+
+    const query = useQuery<DialogueModel>({
         queryKey: [INTERFACE_DATA_USE_QUERY_KEY, DIALOGUE_USE_QUERY_KEY],
         queryFn: async ({ queryKey }) => {
             const dialogue = narration.dialogue;
@@ -78,6 +97,7 @@ export function useQueryDialogue() {
                 }
                 return {
                     animatedText: newText,
+                    lastText: newText,
                     text: oldText,
                     character: character,
                 };
@@ -85,11 +105,21 @@ export function useQueryDialogue() {
 
             return {
                 animatedText: text,
+                lastText: text,
                 character: character,
             };
         },
         placeholderData: keepPreviousData,
+        select: forceComplete
+            ? (data) => ({
+                  ...data,
+                  text: (data.text || "") + (data.animatedText || "") || undefined,
+                  animatedText: undefined,
+              })
+            : undefined,
     });
+
+    return { ...query, finalizeDialogue };
 }
 
 const CAN_GO_NEXT_USE_QUERY_KEY = "can_go_next_use_query_key";

package/template-react-vite-muijoy-ink/src/lib/stores/alert-dialog-store.ts

@@ -0,0 +1,13 @@
+import { Store } from "@tanstack/store";
+
+export namespace AlertDialogState {
+    export const store = new Store<{ count: number }>({ count: 0 });
+
+    export function increment() {
+        store.setState((state) => ({ count: state.count + 1 }));
+    }
+
+    export function decrement() {
+        store.setState((state) => ({ count: Math.max(0, state.count - 1) }));
+    }
+}

package/template-react-vite-muijoy-ink/src/lib/stores/text-display-settings-store.ts

@@ -9,6 +9,10 @@ type TextDisplayStorage = {
      * Whether the typewriter effect is in progress
      */
     inProgress: boolean;
+    /**
+     * Whether the typewriter effect should be force-completed instantly
+     */
+    forceComplete: boolean;
     /**
      * The font size in percent (100 = default)
      */
@@ -22,6 +26,7 @@ export namespace TextDisplaySettings {
     export const store = new Store<TextDisplayStorage>({
         delay: Number(localStorage.getItem("typewriter_delay_millisecond") ?? 10),
         inProgress: false,
+        forceComplete: false,
         fontSize: initialFontSize,
     });
 
@@ -57,6 +62,20 @@ export namespace TextDisplaySettings {
      * End the typewriter effect
      */
     export function end() {
-        store.setState((state) => ({ ...state, inProgress: false }));
+        store.setState((state) => ({ ...state, inProgress: false, forceComplete: false }));
+    }
+
+    /**
+     * Force the typewriter effect to complete instantly
+     */
+    export function complete() {
+        store.setState((state) => ({ ...state, forceComplete: true, inProgress: false }));
+    }
+
+    /**
+     * Clear the forceComplete flag before advancing to the next step
+     */
+    export function resetForNext() {
+        store.setState((state) => ({ ...state, forceComplete: false }));
     }
 }

package/template-react-vite-muijoy-ink/src/locales/en.json

@@ -81,6 +81,8 @@
     "menu_navigation_up_description": "Focus the previous menu item.",
     "menu_navigation_home_description": "Focus the first menu item.",
     "menu_navigation_end_description": "Focus the last menu item.",
+    "choice_navigation": "Choices",
+    "choice_navigation_description": "Use ↑ / ↓ to select an choice, then Enter to run it.",
     "success_delete": "Delete successful",
     "success_load": "Load successful",
     "success_save": "Save successful",

package/template-react-vite-muijoy-ink/src/pixi-vn.keys.gen.ts

@@ -18,7 +18,80 @@ declare module "@drincs/pixi-vn/narration" {
         "start_|_c-1": never;
     }
 }
+declare module "@drincs/pixi-vn/canvas" {
+    interface PixivnBundleIds {
+        "default": never;
+        "audio": never;
+        "/": never;
+        "start": never;
+        "second_part": never;
+        "fm01": never;
+        "fm02": never;
+        "m01": never;
+    }
+    interface PixivnAssetAliasIds {
+        "bgm_cheerful": never;
+        "sfx_whoosh": never;
+        "background_main_menu": never;
+        "bg01-hallway": never;
+        "bg02-dorm": never;
+        "fm01-body": never;
+        "fm01-eyes-grin": never;
+        "fm01-eyes-smile": never;
+        "fm01-eyes-soft": never;
+        "fm01-eyes-upset": never;
+        "fm01-eyes-wow": never;
+        "fm01-mouth-grin00": never;
+        "fm01-mouth-serious00": never;
+        "fm01-mouth-serious01": never;
+        "fm01-mouth-smile00": never;
+        "fm01-mouth-smile01": never;
+        "fm01-mouth-soft00": never;
+        "fm01-mouth-soft01": never;
+        "fm01-mouth-upset00": never;
+        "fm01-mouth-upset01": never;
+        "fm01-mouth-wow01": never;
+        "fm02-body": never;
+        "fm02-eyes-bawl": never;
+        "fm02-eyes-joy": never;
+        "fm02-eyes-nervous": never;
+        "fm02-eyes-smile": never;
+        "fm02-eyes-upset": never;
+        "fm02-eyes-wow": never;
+        "fm02-mouth-cry01": never;
+        "fm02-mouth-nervous00": never;
+        "fm02-mouth-nervous01": never;
+        "fm02-mouth-smile00": never;
+        "fm02-mouth-smile01": never;
+        "fm02-mouth-upset00": never;
+        "fm02-mouth-upset01": never;
+        "fm02-mouth-wow01": never;
+        "m01-body": never;
+        "m01-eyes-annoy": never;
+        "m01-eyes-concern": never;
+        "m01-eyes-cry": never;
+        "m01-eyes-grin": never;
+        "m01-eyes-smile": never;
+        "m01-eyes-wow": never;
+        "m01-mouth-annoy00": never;
+        "m01-mouth-annoy01": never;
+        "m01-mouth-concern00": never;
+        "m01-mouth-concern01": never;
+        "m01-mouth-cry00": never;
+        "m01-mouth-cry01": never;
+        "m01-mouth-grin00": never;
+        "m01-mouth-neutral00": never;
+        "m01-mouth-neutral01": never;
+        "m01-mouth-smile00": never;
+        "m01-mouth-smile01": never;
+        "m01-mouth-wow01": never;
+    }
+}
 export const characterIds = ["mc","james","steph","sly"] as const;
 export const characterIdsEnum = {"mc":"mc","james":"james","steph":"steph","sly":"sly"} as const;
 export const labelIds = ["animation_01","second_part","start","start_|_c-0","start_|_c-1"] as const;
 export const labelIdsEnum = {"animation_01":"animation_01","second_part":"second_part","start":"start","start_|_c-0":"start_|_c-0","start_|_c-1":"start_|_c-1"} as const;
+export const bundleIds = ["default","audio","/","start","second_part","fm01","fm02","m01"] as const;
+export const bundleIdsEnum = {"default":"default","audio":"audio","/":"/","start":"start","second_part":"second_part","fm01":"fm01","fm02":"fm02","m01":"m01"} as const;
+export const assetAliasIds = ["bgm_cheerful","sfx_whoosh","background_main_menu","bg01-hallway","bg02-dorm","fm01-body","fm01-eyes-grin","fm01-eyes-smile","fm01-eyes-soft","fm01-eyes-upset","fm01-eyes-wow","fm01-mouth-grin00","fm01-mouth-serious00","fm01-mouth-serious01","fm01-mouth-smile00","fm01-mouth-smile01","fm01-mouth-soft00","fm01-mouth-soft01","fm01-mouth-upset00","fm01-mouth-upset01","fm01-mouth-wow01","fm02-body","fm02-eyes-bawl","fm02-eyes-joy","fm02-eyes-nervous","fm02-eyes-smile","fm02-eyes-upset","fm02-eyes-wow","fm02-mouth-cry01","fm02-mouth-nervous00","fm02-mouth-nervous01","fm02-mouth-smile00","fm02-mouth-smile01","fm02-mouth-upset00","fm02-mouth-upset01","fm02-mouth-wow01","m01-body","m01-eyes-annoy","m01-eyes-concern","m01-eyes-cry","m01-eyes-grin","m01-eyes-smile","m01-eyes-wow","m01-mouth-annoy00","m01-mouth-annoy01","m01-mouth-concern00","m01-mouth-concern01","m01-mouth-cry00","m01-mouth-cry01","m01-mouth-grin00","m01-mouth-neutral00","m01-mouth-neutral01","m01-mouth-smile00","m01-mouth-smile01","m01-mouth-wow01"] as const;
+export const assetAliasIdsEnum = {"bgm_cheerful":"bgm_cheerful","sfx_whoosh":"sfx_whoosh","background_main_menu":"background_main_menu","bg01-hallway":"bg01-hallway","bg02-dorm":"bg02-dorm","fm01-body":"fm01-body","fm01-eyes-grin":"fm01-eyes-grin","fm01-eyes-smile":"fm01-eyes-smile","fm01-eyes-soft":"fm01-eyes-soft","fm01-eyes-upset":"fm01-eyes-upset","fm01-eyes-wow":"fm01-eyes-wow","fm01-mouth-grin00":"fm01-mouth-grin00","fm01-mouth-serious00":"fm01-mouth-serious00","fm01-mouth-serious01":"fm01-mouth-serious01","fm01-mouth-smile00":"fm01-mouth-smile00","fm01-mouth-smile01":"fm01-mouth-smile01","fm01-mouth-soft00":"fm01-mouth-soft00","fm01-mouth-soft01":"fm01-mouth-soft01","fm01-mouth-upset00":"fm01-mouth-upset00","fm01-mouth-upset01":"fm01-mouth-upset01","fm01-mouth-wow01":"fm01-mouth-wow01","fm02-body":"fm02-body","fm02-eyes-bawl":"fm02-eyes-bawl","fm02-eyes-joy":"fm02-eyes-joy","fm02-eyes-nervous":"fm02-eyes-nervous","fm02-eyes-smile":"fm02-eyes-smile","fm02-eyes-upset":"fm02-eyes-upset","fm02-eyes-wow":"fm02-eyes-wow","fm02-mouth-cry01":"fm02-mouth-cry01","fm02-mouth-nervous00":"fm02-mouth-nervous00","fm02-mouth-nervous01":"fm02-mouth-nervous01","fm02-mouth-smile00":"fm02-mouth-smile00","fm02-mouth-smile01":"fm02-mouth-smile01","fm02-mouth-upset00":"fm02-mouth-upset00","fm02-mouth-upset01":"fm02-mouth-upset01","fm02-mouth-wow01":"fm02-mouth-wow01","m01-body":"m01-body","m01-eyes-annoy":"m01-eyes-annoy","m01-eyes-concern":"m01-eyes-concern","m01-eyes-cry":"m01-eyes-cry","m01-eyes-grin":"m01-eyes-grin","m01-eyes-smile":"m01-eyes-smile","m01-eyes-wow":"m01-eyes-wow","m01-mouth-annoy00":"m01-mouth-annoy00","m01-mouth-annoy01":"m01-mouth-annoy01","m01-mouth-concern00":"m01-mouth-concern00","m01-mouth-concern01":"m01-mouth-concern01","m01-mouth-cry00":"m01-mouth-cry00","m01-mouth-cry01":"m01-mouth-cry01","m01-mouth-grin00":"m01-mouth-grin00","m01-mouth-neutral00":"m01-mouth-neutral00","m01-mouth-neutral01":"m01-mouth-neutral01","m01-mouth-smile00":"m01-mouth-smile00","m01-mouth-smile01":"m01-mouth-smile01","m01-mouth-wow01":"m01-mouth-wow01"} as const;

package/template-react-vite-muijoy-ink/src/routes/__root.tsx

@@ -12,14 +12,13 @@ import { defineAssets } from "@/lib/utils/assets-utility";
 import { initializeIndexedDB } from "@/lib/utils/db-utility";
 import { loadRefreshSave } from "@/lib/utils/save-utility";
 import type { RouterContext } from "@/router";
+import { narration } from "@drincs/pixi-vn";
 import { setupInkHmrListener } from "@drincs/pixi-vn-ink/vite-listener";
 import { setupPixivnViteData } from "@drincs/pixi-vn/vite-listener";
 import { createRootRouteWithContext, ErrorComponent, Outlet } from "@tanstack/react-router";
 import { lazy, Suspense } from "react";
 
-const DevDevtools = import.meta.env.DEV
-    ? lazy(() => import("@/components/dev-devtools"))
-    : null;
+const DevDevtools = import.meta.env.DEV ? lazy(() => import("@/components/dev-devtools")) : null;
 
 export const Route = createRootRouteWithContext<RouterContext>()({
     validateSearch: (search) => SearchParams.setMany(search),
@@ -30,7 +29,7 @@ export const Route = createRootRouteWithContext<RouterContext>()({
         await Promise.all([import("@/content"), initializeIndexedDB(), defineAssets(), useI18n()]);
         await setupPixivnViteData();
         await setupInkHmrListener();
-        if (location.pathname !== "/") {
+        if (location.pathname !== "/" && narration.stepCounter === 0) {
             const isRefreshSaveExist = await loadRefreshSave();
             if (isRefreshSaveExist) {
                 await context.queryClient.invalidateQueries({

package/template-react-vite-muijoy-ink/vite.config.ts

@@ -1,5 +1,6 @@
 import { AssetPack } from "@assetpack/core";
 import { vitePluginInk } from "@drincs/pixi-vn-ink/vite";
+import type { AssetsManifest } from "@drincs/pixi-vn/pixi.js";
 import { vitePluginPixivn } from "@drincs/pixi-vn/vite";
 import tailwindcss from "@tailwindcss/vite";
 import { devtools } from "@tanstack/devtools-vite";
@@ -37,6 +38,14 @@ export default defineConfig(({ mode }) => ({
             characters: "./src/content/characters.ts",
             labels: "./src/content/labels/*.label.ts",
             typeFilePath: "./src/pixi-vn.keys.gen.ts",
+            assetsManifest: async (ssrLoadModule) => {
+                const mod = (await ssrLoadModule("/src/assets/index.ts")) as {
+                    manifest: AssetsManifest;
+                };
+                if (!mod.manifest)
+                    throw new Error("Assets manifest not found in /src/assets/index.ts");
+                return mod.manifest;
+            },
         }),
         vitePluginInk({
             inkGlob: "./ink/**/*.ink",
@@ -94,6 +103,7 @@ export default defineConfig(({ mode }) => ({
     ],
     resolve: {
         tsconfigPaths: true,
+        preserveSymlinks: true,
     },
     define: {
         __APP_VERSION__: JSON.stringify(process.env.npm_package_version),

package/template-react-vite-muijoy-ink-tauri/ink/start.ink

@@ -8,7 +8,7 @@ INCLUDE second_part.ink
 # play sound sfx_whoosh delay 0.1
 # show imagecontainer james [m01-body m01-eyes-smile m01-mouth-neutral01] xAlign 0.5 yAlign 1 with movein direction right ease circInOut type spring
 james: You're my roommate's replacement, huh?
-# play sound sfx_whoosh channel bgm loop true
+# play sound bgm_cheerful channel bgm loop true
 # show imagecontainer james [m01-body m01-eyes-grin m01-mouth-smile01]
 james: Don't worry, you don't have much to live up to. Just don't use heroin like the last guy, and you'll be fine!
 # show imagecontainer james [m01-body m01-eyes-smile m01-mouth-grin00]