@momoyu-ink/kit 0.5.0 → 0.5.1

package/dist/lib.cjs

@@ -855,6 +855,138 @@ function useFadeOut(outTime, pause = false, onFinished) {
 
 // src/hooks/useScenario.ts
 var import_react4 = require("react");
+var currentScenarioSession = null;
+var scenarioSessionId = 0;
+var scenarioLifecycleQueue = Promise.resolve();
+function normalizeStories(stories) {
+  return stories.filter((story) => Boolean(story));
+}
+function createScenarioSessionKey(config) {
+  return JSON.stringify({
+    stories: config.stories,
+    startName: config.startName ?? null,
+    entryName: config.entryName ?? null,
+    goNextOnLoad: config.goNextOnLoad
+  });
+}
+function isCurrentScenarioSession(session) {
+  return currentScenarioSession?.id === session.id && !session.disposed;
+}
+function enqueueScenarioLifecycleTask(task) {
+  const nextTask = scenarioLifecycleQueue.then(task, task);
+  scenarioLifecycleQueue = nextTask.catch(() => {
+  });
+  return nextTask;
+}
+function clearScenarioDisposeTimer(session) {
+  if (session.disposeTimer !== null) {
+    clearTimeout(session.disposeTimer);
+    session.disposeTimer = null;
+  }
+}
+async function terminateCurrentScenario() {
+  try {
+    await executePluginCommand("scenario", {
+      subCommand: "terminateStory"
+    });
+  } catch (error) {
+    console.error("Failed to terminate scenario:", error);
+  }
+}
+async function startScenarioSession(session, config) {
+  for (const story of config.stories) {
+    if (!isCurrentScenarioSession(session)) return;
+    try {
+      await executePluginCommand("scenario", {
+        subCommand: "addStory",
+        name: story
+      });
+    } catch (error) {
+      console.error("Failed to load scenario:", error);
+    }
+  }
+  if (!isCurrentScenarioSession(session)) return;
+  try {
+    if (config.startName) {
+      await executePluginCommand("scenario", {
+        subCommand: "startStory",
+        name: config.startName,
+        entry: config.entryName
+      });
+    }
+    if (!isCurrentScenarioSession(session)) return;
+    if (config.goNextOnLoad) {
+      await nextLine();
+    }
+  } catch (error) {
+    console.error(`Failed to start scenario ${config.startName}:`, error);
+  }
+}
+function ensureScenarioSessionStarted(session, config) {
+  if (session.started || session.startPromise !== null) {
+    return;
+  }
+  const startPromise = enqueueScenarioLifecycleTask(async () => {
+    if (!isCurrentScenarioSession(session)) return;
+    await startScenarioSession(session, config);
+    if (isCurrentScenarioSession(session)) {
+      session.started = true;
+    }
+  });
+  session.startPromise = startPromise;
+  void startPromise.finally(() => {
+    if (session.startPromise === startPromise) {
+      session.startPromise = null;
+    }
+  });
+}
+function disposeScenarioSession(session, delayMs) {
+  clearScenarioDisposeTimer(session);
+  session.disposeTimer = setTimeout(() => {
+    if (!isCurrentScenarioSession(session) || session.refCount > 0) {
+      return;
+    }
+    session.disposeTimer = null;
+    session.disposed = true;
+    currentScenarioSession = null;
+    void enqueueScenarioLifecycleTask(terminateCurrentScenario);
+  }, delayMs);
+}
+function acquireScenarioSession(config) {
+  const key = createScenarioSessionKey(config);
+  if (currentScenarioSession !== null && currentScenarioSession.key !== key) {
+    const previousSession = currentScenarioSession;
+    clearScenarioDisposeTimer(previousSession);
+    previousSession.disposed = true;
+    currentScenarioSession = null;
+    void enqueueScenarioLifecycleTask(terminateCurrentScenario);
+  }
+  if (currentScenarioSession === null) {
+    currentScenarioSession = {
+      id: ++scenarioSessionId,
+      key,
+      refCount: 0,
+      started: false,
+      startPromise: null,
+      disposeTimer: null,
+      disposed: false
+    };
+  }
+  clearScenarioDisposeTimer(currentScenarioSession);
+  currentScenarioSession.refCount += 1;
+  ensureScenarioSessionStarted(currentScenarioSession, config);
+  return currentScenarioSession;
+}
+function releaseScenarioSession(session) {
+  if (!isCurrentScenarioSession(session)) {
+    return;
+  }
+  session.refCount = Math.max(0, session.refCount - 1);
+  if (session.refCount > 0) {
+    return;
+  }
+  disposeScenarioSession(session, 0);
+}
 function nextLine() {
   return executePluginCommand("scenario", { subCommand: "nextLine" });
 }
@@ -863,39 +995,14 @@ function setWaiting(time, skippable) {
 }
 function useScenario(stories, startName, entryName, goNextOnLoad = false) {
   (0, import_react4.useEffect)(() => {
-    const loadScenario = async () => {
-      for (const story of stories) {
-        if (!story) continue;
-        try {
-          await executePluginCommand("scenario", {
-            subCommand: "addStory",
-            name: story
-          });
-        } catch (error) {
-          console.error(`Failed to load scenario:`, error);
-        }
-      }
-    };
-    void loadScenario().then(async () => {
-      try {
-        if (startName) {
-          await executePluginCommand("scenario", {
-            subCommand: "startStory",
-            name: startName,
-            entry: entryName
-          });
-        }
-        if (goNextOnLoad) {
-          await nextLine();
-        }
-      } catch (error) {
-        console.error(`Failed to start scenario ${startName}:`, error);
-      }
+    const session = acquireScenarioSession({
+      stories: normalizeStories(stories),
+      startName,
+      entryName,
+      goNextOnLoad
     });
     return () => {
-      executePluginCommand("scenario", {
-        subCommand: "terminateStory"
-      });
+      releaseScenarioSession(session);
     };
   }, [stories, startName, entryName, goNextOnLoad]);
 }

package/dist/lib.d.mts

@@ -516,6 +516,7 @@ declare function nextLine(): any;
 declare function setWaiting(time: number, skippable: boolean): void;
 /**
  * Custom hook to manage scenario lifecycle (load, start, terminate).
+ * The underlying session is resilient to transient remounts such as Fast Refresh.
  *
  * @param {string[]} stories - An array of story names to load.
  * @param {string} [startName] - The name of the story to start.

package/dist/lib.d.ts

@@ -516,6 +516,7 @@ declare function nextLine(): any;
 declare function setWaiting(time: number, skippable: boolean): void;
 /**
  * Custom hook to manage scenario lifecycle (load, start, terminate).
+ * The underlying session is resilient to transient remounts such as Fast Refresh.
  *
  * @param {string[]} stories - An array of story names to load.
  * @param {string} [startName] - The name of the story to start.

package/dist/lib.mjs

@@ -843,6 +843,138 @@ function useFadeOut(outTime, pause = false, onFinished) {
 
 // src/hooks/useScenario.ts
 import { useEffect } from "react";
+var currentScenarioSession = null;
+var scenarioSessionId = 0;
+var scenarioLifecycleQueue = Promise.resolve();
+function normalizeStories(stories) {
+  return stories.filter((story) => Boolean(story));
+}
+function createScenarioSessionKey(config) {
+  return JSON.stringify({
+    stories: config.stories,
+    startName: config.startName ?? null,
+    entryName: config.entryName ?? null,
+    goNextOnLoad: config.goNextOnLoad
+  });
+}
+function isCurrentScenarioSession(session) {
+  return currentScenarioSession?.id === session.id && !session.disposed;
+}
+function enqueueScenarioLifecycleTask(task) {
+  const nextTask = scenarioLifecycleQueue.then(task, task);
+  scenarioLifecycleQueue = nextTask.catch(() => {
+  });
+  return nextTask;
+}
+function clearScenarioDisposeTimer(session) {
+  if (session.disposeTimer !== null) {
+    clearTimeout(session.disposeTimer);
+    session.disposeTimer = null;
+  }
+}
+async function terminateCurrentScenario() {
+  try {
+    await executePluginCommand("scenario", {
+      subCommand: "terminateStory"
+    });
+  } catch (error) {
+    console.error("Failed to terminate scenario:", error);
+  }
+}
+async function startScenarioSession(session, config) {
+  for (const story of config.stories) {
+    if (!isCurrentScenarioSession(session)) return;
+    try {
+      await executePluginCommand("scenario", {
+        subCommand: "addStory",
+        name: story
+      });
+    } catch (error) {
+      console.error("Failed to load scenario:", error);
+    }
+  }
+  if (!isCurrentScenarioSession(session)) return;
+  try {
+    if (config.startName) {
+      await executePluginCommand("scenario", {
+        subCommand: "startStory",
+        name: config.startName,
+        entry: config.entryName
+      });
+    }
+    if (!isCurrentScenarioSession(session)) return;
+    if (config.goNextOnLoad) {
+      await nextLine();
+    }
+  } catch (error) {
+    console.error(`Failed to start scenario ${config.startName}:`, error);
+  }
+}
+function ensureScenarioSessionStarted(session, config) {
+  if (session.started || session.startPromise !== null) {
+    return;
+  }
+  const startPromise = enqueueScenarioLifecycleTask(async () => {
+    if (!isCurrentScenarioSession(session)) return;
+    await startScenarioSession(session, config);
+    if (isCurrentScenarioSession(session)) {
+      session.started = true;
+    }
+  });
+  session.startPromise = startPromise;
+  void startPromise.finally(() => {
+    if (session.startPromise === startPromise) {
+      session.startPromise = null;
+    }
+  });
+}
+function disposeScenarioSession(session, delayMs) {
+  clearScenarioDisposeTimer(session);
+  session.disposeTimer = setTimeout(() => {
+    if (!isCurrentScenarioSession(session) || session.refCount > 0) {
+      return;
+    }
+    session.disposeTimer = null;
+    session.disposed = true;
+    currentScenarioSession = null;
+    void enqueueScenarioLifecycleTask(terminateCurrentScenario);
+  }, delayMs);
+}
+function acquireScenarioSession(config) {
+  const key = createScenarioSessionKey(config);
+  if (currentScenarioSession !== null && currentScenarioSession.key !== key) {
+    const previousSession = currentScenarioSession;
+    clearScenarioDisposeTimer(previousSession);
+    previousSession.disposed = true;
+    currentScenarioSession = null;
+    void enqueueScenarioLifecycleTask(terminateCurrentScenario);
+  }
+  if (currentScenarioSession === null) {
+    currentScenarioSession = {
+      id: ++scenarioSessionId,
+      key,
+      refCount: 0,
+      started: false,
+      startPromise: null,
+      disposeTimer: null,
+      disposed: false
+    };
+  }
+  clearScenarioDisposeTimer(currentScenarioSession);
+  currentScenarioSession.refCount += 1;
+  ensureScenarioSessionStarted(currentScenarioSession, config);
+  return currentScenarioSession;
+}
+function releaseScenarioSession(session) {
+  if (!isCurrentScenarioSession(session)) {
+    return;
+  }
+  session.refCount = Math.max(0, session.refCount - 1);
+  if (session.refCount > 0) {
+    return;
+  }
+  disposeScenarioSession(session, 0);
+}
 function nextLine() {
   return executePluginCommand("scenario", { subCommand: "nextLine" });
 }
@@ -851,39 +983,14 @@ function setWaiting(time, skippable) {
 }
 function useScenario(stories, startName, entryName, goNextOnLoad = false) {
   useEffect(() => {
-    const loadScenario = async () => {
-      for (const story of stories) {
-        if (!story) continue;
-        try {
-          await executePluginCommand("scenario", {
-            subCommand: "addStory",
-            name: story
-          });
-        } catch (error) {
-          console.error(`Failed to load scenario:`, error);
-        }
-      }
-    };
-    void loadScenario().then(async () => {
-      try {
-        if (startName) {
-          await executePluginCommand("scenario", {
-            subCommand: "startStory",
-            name: startName,
-            entry: entryName
-          });
-        }
-        if (goNextOnLoad) {
-          await nextLine();
-        }
-      } catch (error) {
-        console.error(`Failed to start scenario ${startName}:`, error);
-      }
+    const session = acquireScenarioSession({
+      stories: normalizeStories(stories),
+      startName,
+      entryName,
+      goNextOnLoad
     });
     return () => {
-      executePluginCommand("scenario", {
-        subCommand: "terminateStory"
-      });
+      releaseScenarioSession(session);
     };
   }, [stories, startName, entryName, goNextOnLoad]);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@momoyu-ink/kit",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Software Development Kit of Moyu Visual Novel Engine",
   "main": "dist/lib.cjs",
   "module": "dist/lib.mjs",