@kawaijs/runtime 0.1.10 → 0.1.12

package/dist/save.d.ts

@@ -1,12 +1,34 @@
-import type { Snapshot } from './state.js';
+import type { StoryPackage } from '@kawaijs/ast';
+import type { DialogueHistoryEntry } from './history.js';
+import { type Snapshot, type StoryState } from './state.js';
+export declare const CURRENT_SAVE_SCHEMA_VERSION = 2;
 export interface SaveSlot {
+    readonly schemaVersion?: number;
+    readonly storyHash?: string;
     readonly id: string;
     readonly name: string;
     readonly timestamp: number;
     readonly snapshot: Snapshot;
     readonly previewText?: string;
     readonly screenshotUrl?: string;
+    /** Persisted dialogue backlog (schema v2+). */
+    readonly historyEntries?: readonly DialogueHistoryEntry[];
 }
+export type LoadFailureReason = 'not_found' | 'corrupt' | 'incompatible_schema' | 'incompatible_story';
+export interface LoadResult {
+    readonly success: boolean;
+    readonly slot?: SaveSlot;
+    readonly reason?: LoadFailureReason;
+}
+export declare function fnv1a(str: string): string;
+export declare function computeStoryHash(story: StoryPackage): string;
+/** Explicit v1 → v2: add historyEntries (empty if missing). */
+export declare function migrateSaveV1ToV2(slot: SaveSlot): SaveSlot;
+/**
+ * Migrate / normalize a parsed save slot to the current schema.
+ * Returns null if the slot cannot be recovered.
+ */
+export declare function migrateSaveSlot(raw: unknown): SaveSlot | null;
 export interface StorageAdapter {
     getItem(key: string): string | null | Promise<string | null>;
     setItem(key: string, value: string): void | Promise<void>;
@@ -27,9 +49,11 @@ export declare class SaveManager {
     private readonly storage;
     private readonly storagePrefix;
     constructor(storage?: StorageAdapter, storagePrefix?: string);
-    saveSlot(slotId: string, snapshot: Snapshot, previewText?: string): Promise<SaveSlot>;
-    loadSlot(slotId: string): Promise<SaveSlot | null>;
+    saveSlot(slotId: string, snapshot: Snapshot, previewText?: string, storyHash?: string, historyEntries?: readonly DialogueHistoryEntry[]): Promise<SaveSlot>;
+    loadSlot(slotId: string, expectedStoryHash?: string): Promise<LoadResult>;
     deleteSlot(slotId: string): Promise<void>;
-    listSlots(totalSlots?: number): Promise<(SaveSlot | null)[]>;
+    listSlots(totalSlots?: number, expectedStoryHash?: string): Promise<(SaveSlot | null)[]>;
 }
+/** @internal helper for tests */
+export type { StoryState };
 //# sourceMappingURL=save.d.ts.map

package/dist/save.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"save.d.ts","sourceRoot":"","sources":["../src/save.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7D,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED,qBAAa,oBAAqB,YAAW,cAAc;IACzD,OAAO,CAAC,KAAK,CAA6B;IAEnC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAInC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIzC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAGrC;AAED,qBAAa,mBAAoB,YAAW,cAAc;IACjD,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKnC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAKzC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAIrC;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;gBAE3B,OAAO,CAAC,EAAE,cAAc,EAAE,aAAa,SAAkB;IAKxD,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAcrF,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAYlD,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzC,SAAS,CAAC,UAAU,SAAI,GAAG,OAAO,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC;CAQrE"}
+{"version":3,"file":"save.d.ts","sourceRoot":"","sources":["../src/save.ts"],"names":[],"mappings":"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"}

package/dist/save.js

@@ -1,3 +1,106 @@
+import { normalizeStoryState } from './state.js';
+export const CURRENT_SAVE_SCHEMA_VERSION = 2;
+export function fnv1a(str) {
+    let hash = 0x811c9dc5;
+    for (let i = 0; i < str.length; i++) {
+        hash ^= str.charCodeAt(i);
+        hash = Math.imul(hash, 0x01000193);
+    }
+    return (hash >>> 0).toString(16).padStart(8, '0');
+}
+export function computeStoryHash(story) {
+    const sortedLabels = Object.keys(story.labels ?? {}).sort();
+    const parts = [];
+    parts.push(`start:${story.meta?.startLabel ?? 'start'}`);
+    for (const label of sortedLabels) {
+        parts.push(`label:${label}`);
+        const instructions = story.labels[label] ?? [];
+        for (const inst of instructions) {
+            const { loc: _, ...rest } = inst;
+            parts.push(JSON.stringify(rest));
+        }
+    }
+    return fnv1a(parts.join('\n'));
+}
+function normalizeHistoryEntries(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    const out = [];
+    for (const item of raw) {
+        if (!item || typeof item !== 'object')
+            continue;
+        const e = item;
+        if (typeof e['text'] !== 'string')
+            continue;
+        out.push({
+            id: typeof e['id'] === 'string' ? e['id'] : `hist_${out.length}`,
+            speaker: typeof e['speaker'] === 'string' ? e['speaker'] : undefined,
+            speakerDisplayName: typeof e['speakerDisplayName'] === 'string' ? e['speakerDisplayName'] : undefined,
+            text: e['text'],
+            timestamp: typeof e['timestamp'] === 'number' ? e['timestamp'] : 0
+        });
+    }
+    return out;
+}
+/** Explicit v1 → v2: add historyEntries (empty if missing). */
+export function migrateSaveV1ToV2(slot) {
+    return {
+        ...slot,
+        schemaVersion: 2,
+        historyEntries: slot.historyEntries ? [...slot.historyEntries] : [],
+        snapshot: {
+            ...slot.snapshot,
+            historyLength: typeof slot.snapshot.historyLength === 'number'
+                ? slot.snapshot.historyLength
+                : (slot.historyEntries?.length ?? 0)
+        }
+    };
+}
+/**
+ * Migrate / normalize a parsed save slot to the current schema.
+ * Returns null if the slot cannot be recovered.
+ */
+export function migrateSaveSlot(raw) {
+    if (!raw || typeof raw !== 'object')
+        return null;
+    const slot = raw;
+    const snapshotRaw = slot['snapshot'];
+    if (!snapshotRaw || typeof snapshotRaw !== 'object')
+        return null;
+    const snap = snapshotRaw;
+    const normalizedState = normalizeStoryState(snap['state']);
+    if (!normalizedState)
+        return null;
+    const id = typeof slot['id'] === 'string' ? slot['id'] : 'unknown';
+    const timestamp = typeof slot['timestamp'] === 'number' ? slot['timestamp'] : Date.now();
+    const rawVersion = typeof slot['schemaVersion'] === 'number' ? slot['schemaVersion'] : 1;
+    let migrated = {
+        schemaVersion: rawVersion,
+        storyHash: typeof slot['storyHash'] === 'string' ? slot['storyHash'] : undefined,
+        id,
+        name: typeof slot['name'] === 'string' ? slot['name'] : `Slot ${id}`,
+        timestamp,
+        snapshot: {
+            id: typeof snap['id'] === 'string' ? snap['id'] : `snap_${timestamp}`,
+            timestamp: typeof snap['timestamp'] === 'number' ? snap['timestamp'] : timestamp,
+            state: normalizedState,
+            historyLength: typeof snap['historyLength'] === 'number' ? snap['historyLength'] : undefined
+        },
+        previewText: typeof slot['previewText'] === 'string' ? slot['previewText'] : undefined,
+        screenshotUrl: typeof slot['screenshotUrl'] === 'string' ? slot['screenshotUrl'] : undefined,
+        historyEntries: normalizeHistoryEntries(slot['historyEntries'])
+    };
+    if (migrated.schemaVersion === undefined || migrated.schemaVersion < 2) {
+        migrated = migrateSaveV1ToV2(migrated);
+    }
+    else {
+        migrated = {
+            ...migrated,
+            schemaVersion: CURRENT_SAVE_SCHEMA_VERSION
+        };
+    }
+    return migrated;
+}
 export class MemoryStorageAdapter {
     store = new Map();
     getItem(key) {
@@ -34,39 +137,57 @@ export class SaveManager {
         this.storage = storage ?? (typeof localStorage !== 'undefined' ? new LocalStorageAdapter() : new MemoryStorageAdapter());
         this.storagePrefix = storagePrefix;
     }
-    async saveSlot(slotId, snapshot, previewText) {
+    async saveSlot(slotId, snapshot, previewText, storyHash = '', historyEntries = []) {
         const slot = {
+            schemaVersion: CURRENT_SAVE_SCHEMA_VERSION,
+            storyHash,
             id: slotId,
             name: `Slot ${slotId}`,
             timestamp: Date.now(),
             snapshot,
-            previewText
+            previewText,
+            historyEntries: [...historyEntries]
         };
         const key = `${this.storagePrefix}${slotId}`;
         await this.storage.setItem(key, JSON.stringify(slot));
         return slot;
     }
-    async loadSlot(slotId) {
+    async loadSlot(slotId, expectedStoryHash) {
         const key = `${this.storagePrefix}${slotId}`;
         const raw = await this.storage.getItem(key);
         if (!raw)
-            return null;
+            return { success: false, reason: 'not_found' };
         try {
-            return JSON.parse(raw);
+            const parsed = JSON.parse(raw);
+            const slot = migrateSaveSlot(parsed);
+            if (!slot) {
+                return { success: false, reason: 'corrupt' };
+            }
+            const rawObj = parsed;
+            if (typeof rawObj['schemaVersion'] === 'number' && rawObj['schemaVersion'] > CURRENT_SAVE_SCHEMA_VERSION) {
+                return { success: false, reason: 'incompatible_schema', slot };
+            }
+            // When a story hash is expected, require a matching hash (reject missing hashes).
+            if (expectedStoryHash) {
+                if (!slot.storyHash || slot.storyHash !== expectedStoryHash) {
+                    return { success: false, reason: 'incompatible_story', slot };
+                }
+            }
+            return { success: true, slot };
         }
         catch {
-            return null;
+            return { success: false, reason: 'corrupt' };
         }
     }
     async deleteSlot(slotId) {
         const key = `${this.storagePrefix}${slotId}`;
         await this.storage.removeItem(key);
     }
-    async listSlots(totalSlots = 6) {
+    async listSlots(totalSlots = 6, expectedStoryHash) {
         const slots = [];
         for (let i = 1; i <= totalSlots; i++) {
-            const slot = await this.loadSlot(String(i));
-            slots.push(slot);
+            const res = await this.loadSlot(String(i), expectedStoryHash);
+            slots.push(res.success && res.slot ? res.slot : null);
         }
         return slots;
     }

package/dist/save.js.map

@@ -1 +1 @@
-{"version":3,"file":"save.js","sourceRoot":"","sources":["../src/save.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"save.js","sourceRoot":"","sources":["../src/save.ts"],"names":[],"mappings":"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"}

package/dist/state.d.ts

@@ -1,7 +1,22 @@
-import type { ChoiceOption } from '@kawaijs/ast';
+import type { ChoiceOption, HotspotOption } from '@kawaijs/ast';
 export interface CharacterState {
     readonly expression?: string;
     readonly position?: string;
+    readonly transition?: string;
+    readonly layer?: string;
+    readonly z?: number;
+    readonly cssAnimation?: {
+        readonly name: string;
+        readonly durationMs?: number;
+        /** Bumps so the same animation can re-trigger. */
+        readonly token?: number;
+    };
+}
+export interface AchievementState {
+    readonly id: string;
+    readonly title?: string;
+    readonly description?: string;
+    readonly unlockedAt: number;
 }
 export interface DialogueState {
     readonly speaker?: string;
@@ -9,10 +24,19 @@ export interface DialogueState {
     readonly speakerColor?: string;
     readonly text: string;
 }
+export interface VfxState {
+    readonly effect: 'rain' | 'snow' | 'sakura' | 'fog' | 'tint' | 'stop';
+    readonly intensity?: number | string;
+    readonly color?: string;
+}
 export interface VisualState {
     readonly background: string | null;
     readonly transition: string | null;
     readonly characters: Record<string, CharacterState>;
+    readonly vfx: VfxState | null;
+    readonly activeCG: string | null;
+    /** Default layer name applied to subsequent shows without an explicit layer. */
+    readonly defaultLayer: string | null;
 }
 export interface AudioState {
     readonly music: string | null;
@@ -31,6 +55,29 @@ export interface StoryState {
     readonly audio: AudioState;
     readonly dialogue: DialogueState | null;
     readonly choices: readonly ChoiceOption[] | null;
+    /** Clickable stage/CG regions waiting for a player pick. */
+    readonly hotspots: readonly HotspotOption[] | null;
+    /** CSS theme token applied on the player root (`data-kawa-theme`). */
+    readonly theme: string | null;
+    /** Named style tokens keyed by UI target (dialogue, stage, root, choices). */
+    readonly styleClasses: Readonly<Record<string, string>>;
+    readonly unlockedCGs: Record<string, boolean>;
+    /** Unlocked achievements / exportable flags. */
+    readonly achievements: Readonly<Record<string, AchievementState>>;
+    /** Active language code for `{t:key}` string tables. */
+    readonly lang: string | null;
+    /**
+     * When set, the presentation layer should auto-advance after this many ms.
+     * Click/keyboard advance may skip the remaining delay.
+     */
+    readonly pendingPauseMs: number | null;
+    /** Text prompt waiting for the player (`input` directive). */
+    readonly pendingInput: {
+        readonly variable: string;
+        readonly prompt: string;
+    } | null;
+    /** When false, the dialogue window should be hidden (`window hide`). */
+    readonly windowVisible: boolean;
     readonly isWaitingForInput: boolean;
     readonly isFinished: boolean;
 }
@@ -38,7 +85,14 @@ export interface Snapshot {
     readonly id: string;
     readonly timestamp: number;
     readonly state: StoryState;
+    /** Dialogue history length at snapshot time — used to trim backlog on rollback. */
+    readonly historyLength?: number;
 }
 export declare function createInitialState(startLabel?: string): StoryState;
+/**
+ * Normalize a partially-shaped / older save state into a full StoryState.
+ * Returns null when the payload is too corrupt to recover.
+ */
+export declare function normalizeStoryState(raw: unknown): StoryState | null;
 export declare function cloneState(state: StoryState): StoryState;
 //# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,SAAS,SAAS,EAAE,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,GAAG,IAAI,CAAC;IACjD,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B;AAED,wBAAgB,kBAAkB,CAAC,UAAU,SAAU,GAAG,UAAU,CAoBnE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAmBxD"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"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"}

package/dist/state.js

@@ -3,11 +3,14 @@ export function createInitialState(startLabel = 'start') {
         currentLabel: startLabel,
         instructionPointer: 0,
         callStack: [],
-        variables: {},
+        variables: Object.create(null),
         visual: {
             background: null,
             transition: null,
-            characters: {}
+            characters: {},
+            vfx: null,
+            activeCG: null,
+            defaultLayer: null
         },
         audio: {
             music: null,
@@ -15,24 +18,126 @@ export function createInitialState(startLabel = 'start') {
         },
         dialogue: null,
         choices: null,
+        hotspots: null,
+        theme: null,
+        styleClasses: Object.create(null),
+        unlockedCGs: Object.create(null),
+        achievements: Object.create(null),
+        lang: null,
+        pendingPauseMs: null,
+        pendingInput: null,
+        windowVisible: true,
         isWaitingForInput: false,
         isFinished: false
     };
 }
+/**
+ * Normalize a partially-shaped / older save state into a full StoryState.
+ * Returns null when the payload is too corrupt to recover.
+ */
+export function normalizeStoryState(raw) {
+    if (!raw || typeof raw !== 'object')
+        return null;
+    const s = raw;
+    if (typeof s['currentLabel'] !== 'string' || typeof s['instructionPointer'] !== 'number') {
+        return null;
+    }
+    const base = createInitialState(s['currentLabel']);
+    const visualRaw = (s['visual'] && typeof s['visual'] === 'object' ? s['visual'] : {});
+    const audioRaw = (s['audio'] && typeof s['audio'] === 'object' ? s['audio'] : {});
+    const dialogueRaw = s['dialogue'] && typeof s['dialogue'] === 'object' ? s['dialogue'] : null;
+    const callStack = Array.isArray(s['callStack'])
+        ? s['callStack']
+            .filter((f) => !!f && typeof f === 'object')
+            .map(f => ({
+            returnLabel: typeof f['returnLabel'] === 'string' ? f['returnLabel'] : base.currentLabel,
+            returnPointer: typeof f['returnPointer'] === 'number' ? f['returnPointer'] : 0
+        }))
+        : [];
+    const charactersRaw = visualRaw['characters'] && typeof visualRaw['characters'] === 'object'
+        ? visualRaw['characters']
+        : {};
+    return {
+        currentLabel: s['currentLabel'],
+        instructionPointer: s['instructionPointer'],
+        callStack,
+        variables: s['variables'] && typeof s['variables'] === 'object'
+            ? Object.assign(Object.create(null), s['variables'])
+            : Object.create(null),
+        visual: {
+            background: typeof visualRaw['background'] === 'string' ? visualRaw['background'] : null,
+            transition: typeof visualRaw['transition'] === 'string' ? visualRaw['transition'] : null,
+            characters: { ...charactersRaw },
+            vfx: visualRaw['vfx'] ?? null,
+            activeCG: typeof visualRaw['activeCG'] === 'string' ? visualRaw['activeCG'] : null,
+            defaultLayer: typeof visualRaw['defaultLayer'] === 'string' ? visualRaw['defaultLayer'] : null
+        },
+        audio: {
+            music: typeof audioRaw['music'] === 'string' ? audioRaw['music'] : null,
+            voice: typeof audioRaw['voice'] === 'string' ? audioRaw['voice'] : null
+        },
+        dialogue: dialogueRaw && typeof dialogueRaw['text'] === 'string'
+            ? {
+                speaker: typeof dialogueRaw['speaker'] === 'string' ? dialogueRaw['speaker'] : undefined,
+                speakerDisplayName: typeof dialogueRaw['speakerDisplayName'] === 'string'
+                    ? dialogueRaw['speakerDisplayName']
+                    : undefined,
+                speakerColor: typeof dialogueRaw['speakerColor'] === 'string' ? dialogueRaw['speakerColor'] : undefined,
+                text: dialogueRaw['text']
+            }
+            : null,
+        choices: Array.isArray(s['choices']) ? s['choices'] : null,
+        hotspots: null, // never restore mid-hotspot from saves
+        theme: typeof s['theme'] === 'string' ? s['theme'] : null,
+        styleClasses: s['styleClasses'] && typeof s['styleClasses'] === 'object'
+            ? Object.assign(Object.create(null), s['styleClasses'])
+            : Object.create(null),
+        unlockedCGs: s['unlockedCGs'] && typeof s['unlockedCGs'] === 'object'
+            ? Object.assign(Object.create(null), s['unlockedCGs'])
+            : Object.create(null),
+        achievements: s['achievements'] && typeof s['achievements'] === 'object'
+            ? Object.assign(Object.create(null), s['achievements'])
+            : Object.create(null),
+        lang: typeof s['lang'] === 'string' ? s['lang'] : null,
+        pendingPauseMs: typeof s['pendingPauseMs'] === 'number' ? s['pendingPauseMs'] : null,
+        pendingInput: null, // never restore mid-prompt from saves
+        windowVisible: s['windowVisible'] === false ? false : true,
+        isWaitingForInput: Boolean(s['isWaitingForInput']),
+        isFinished: Boolean(s['isFinished'])
+    };
+}
 export function cloneState(state) {
     return {
         currentLabel: state.currentLabel,
         instructionPointer: state.instructionPointer,
         callStack: state.callStack.map(frame => ({ ...frame })),
-        variables: { ...state.variables },
+        variables: Object.assign(Object.create(null), state.variables),
         visual: {
             background: state.visual.background,
             transition: state.visual.transition,
-            characters: Object.fromEntries(Object.entries(state.visual.characters).map(([k, v]) => [k, { ...v }]))
+            vfx: state.visual.vfx ? { ...state.visual.vfx } : null,
+            activeCG: state.visual.activeCG,
+            defaultLayer: state.visual.defaultLayer,
+            characters: Object.fromEntries(Object.entries(state.visual.characters).map(([k, v]) => [
+                k,
+                {
+                    ...v,
+                    cssAnimation: v.cssAnimation ? { ...v.cssAnimation } : undefined
+                }
+            ]))
         },
         audio: { ...state.audio },
         dialogue: state.dialogue ? { ...state.dialogue } : null,
         choices: state.choices ? state.choices.map(c => ({ ...c })) : null,
+        hotspots: state.hotspots ? state.hotspots.map(h => ({ ...h })) : null,
+        theme: state.theme,
+        styleClasses: Object.assign(Object.create(null), state.styleClasses),
+        unlockedCGs: Object.assign(Object.create(null), state.unlockedCGs),
+        achievements: Object.assign(Object.create(null), state.achievements),
+        lang: state.lang,
+        pendingPauseMs: state.pendingPauseMs ?? null,
+        pendingInput: state.pendingInput ? { ...state.pendingInput } : null,
+        windowVisible: state.windowVisible !== false,
         isWaitingForInput: state.isWaitingForInput,
         isFinished: state.isFinished
     };

package/dist/state.js.map

@@ -1 +1 @@
-{"version":3,"file":"state.js","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAiDA,MAAM,UAAU,kBAAkB,CAAC,UAAU,GAAG,OAAO;IACrD,OAAO;QACL,YAAY,EAAE,UAAU;QACxB,kBAAkB,EAAE,CAAC;QACrB,SAAS,EAAE,EAAE;QACb,SAAS,EAAE,EAAE;QACb,MAAM,EAAE;YACN,UAAU,EAAE,IAAI;YAChB,UAAU,EAAE,IAAI;YAChB,UAAU,EAAE,EAAE;SACf;QACD,KAAK,EAAE;YACL,KAAK,EAAE,IAAI;YACX,KAAK,EAAE,IAAI;SACZ;QACD,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,IAAI;QACb,iBAAiB,EAAE,KAAK;QACxB,UAAU,EAAE,KAAK;KAClB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAiB;IAC1C,OAAO;QACL,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;QAC5C,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;QACvD,SAAS,EAAE,EAAE,GAAG,KAAK,CAAC,SAAS,EAAE;QACjC,MAAM,EAAE;YACN,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,UAAU;YACnC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,UAAU;YACnC,UAAU,EAAE,MAAM,CAAC,WAAW,CAC5B,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CACvE;SACF;QACD,KAAK,EAAE,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE;QACzB,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI;QACvD,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;QAClE,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;QAC1C,UAAU,EAAE,KAAK,CAAC,UAAU;KAC7B,CAAC;AACJ,CAAC"}
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAiGA,MAAM,UAAU,kBAAkB,CAAC,UAAU,GAAG,OAAO;IACrD,OAAO;QACL,YAAY,EAAE,UAAU;QACxB,kBAAkB,EAAE,CAAC;QACrB,SAAS,EAAE,EAAE;QACb,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAA4B;QACzD,MAAM,EAAE;YACN,UAAU,EAAE,IAAI;YAChB,UAAU,EAAE,IAAI;YAChB,UAAU,EAAE,EAAE;YACd,GAAG,EAAE,IAAI;YACT,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,IAAI;SACnB;QACD,KAAK,EAAE;YACL,KAAK,EAAE,IAAI;YACX,KAAK,EAAE,IAAI;SACZ;QACD,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE,IAAI;QACd,KAAK,EAAE,IAAI;QACX,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAA2B;QAC3D,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAA4B;QAC3D,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAqC;QACrE,IAAI,EAAE,IAAI;QACV,cAAc,EAAE,IAAI;QACpB,YAAY,EAAE,IAAI;QAClB,aAAa,EAAE,IAAI;QACnB,iBAAiB,EAAE,KAAK;QACxB,UAAU,EAAE,KAAK;KAClB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC9C,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACjD,MAAM,CAAC,GAAG,GAA8B,CAAC;IAEzC,IAAI,OAAO,CAAC,CAAC,cAAc,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,oBAAoB,CAAC,KAAK,QAAQ,EAAE,CAAC;QACzF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,IAAI,GAAG,kBAAkB,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAA4B,CAAC;IACjH,MAAM,QAAQ,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAA4B,CAAC;IAC7G,MAAM,WAAW,GAAG,CAAC,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,CAAC,UAAU,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,CAAC,CAAC,UAAU,CAA6B,CAAC,CAAC,CAAC,IAAI,CAAC;IAE3H,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;aACX,MAAM,CAAC,CAAC,CAAC,EAAgC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,CAAC;aACzE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACT,WAAW,EAAE,OAAO,CAAC,CAAC,aAAa,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY;YACxF,aAAa,EAAE,OAAO,CAAC,CAAC,eAAe,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;SAC/E,CAAC,CAAC;QACP,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,aAAa,GACjB,SAAS,CAAC,YAAY,CAAC,IAAI,OAAO,SAAS,CAAC,YAAY,CAAC,KAAK,QAAQ;QACpE,CAAC,CAAE,SAAS,CAAC,YAAY,CAAoC;QAC7D,CAAC,CAAC,EAAE,CAAC;IAET,OAAO;QACL,YAAY,EAAE,CAAC,CAAC,cAAc,CAAW;QACzC,kBAAkB,EAAE,CAAC,CAAC,oBAAoB,CAAW;QACrD,SAAS;QACT,SAAS,EACP,CAAC,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,CAAC,WAAW,CAAC,KAAK,QAAQ;YAClD,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC;YACpD,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;QACzB,MAAM,EAAE;YACN,UAAU,EAAE,OAAO,SAAS,CAAC,YAAY,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI;YACxF,UAAU,EAAE,OAAO,SAAS,CAAC,YAAY,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI;YACxF,UAAU,EAAE,EAAE,GAAG,aAAa,EAAE;YAChC,GAAG,EAAG,SAAS,CAAC,KAAK,CAAqB,IAAI,IAAI;YAClD,QAAQ,EAAE,OAAO,SAAS,CAAC,UAAU,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI;YAClF,YAAY,EAAE,OAAO,SAAS,CAAC,cAAc,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI;SAC/F;QACD,KAAK,EAAE;YACL,KAAK,EAAE,OAAO,QAAQ,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI;YACvE,KAAK,EAAE,OAAO,QAAQ,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI;SACxE;QACD,QAAQ,EAAE,WAAW,IAAI,OAAO,WAAW,CAAC,MAAM,CAAC,KAAK,QAAQ;YAC9D,CAAC,CAAC;gBACE,OAAO,EAAE,OAAO,WAAW,CAAC,SAAS,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS;gBACxF,kBAAkB,EAChB,OAAO,WAAW,CAAC,oBAAoB,CAAC,KAAK,QAAQ;oBACnD,CAAC,CAAC,WAAW,CAAC,oBAAoB,CAAC;oBACnC,CAAC,CAAC,SAAS;gBACf,YAAY,EAAE,OAAO,WAAW,CAAC,cAAc,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,SAAS;gBACvG,IAAI,EAAE,WAAW,CAAC,MAAM,CAAW;aACpC;YACH,CAAC,CAAC,IAAI;QACR,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,SAAS,CAAoB,CAAC,CAAC,CAAC,IAAI;QAC9E,QAAQ,EAAE,IAAI,EAAE,uCAAuC;QACvD,KAAK,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI;QACzD,YAAY,EACV,CAAC,CAAC,cAAc,CAAC,IAAI,OAAO,CAAC,CAAC,cAAc,CAAC,KAAK,QAAQ;YACxD,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,cAAc,CAAC,CAAC;YACvD,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;QACzB,WAAW,EACT,CAAC,CAAC,aAAa,CAAC,IAAI,OAAO,CAAC,CAAC,aAAa,CAAC,KAAK,QAAQ;YACtD,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC;YACtD,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;QACzB,YAAY,EACV,CAAC,CAAC,cAAc,CAAC,IAAI,OAAO,CAAC,CAAC,cAAc,CAAC,KAAK,QAAQ;YACxD,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,cAAc,CAAC,CAAC;YACvD,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;QACzB,IAAI,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI;QACtD,cAAc,EAAE,OAAO,CAAC,CAAC,gBAAgB,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,IAAI;QACpF,YAAY,EAAE,IAAI,EAAE,sCAAsC;QAC1D,aAAa,EAAE,CAAC,CAAC,eAAe,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;QAC1D,iBAAiB,EAAE,OAAO,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;QAClD,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;KACrC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAiB;IAC1C,OAAO;QACL,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;QAC5C,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;QACvD,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;QAC9D,MAAM,EAAE;YACN,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,UAAU;YACnC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,UAAU;YACnC,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI;YACtD,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,QAAQ;YAC/B,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,YAAY;YACvC,UAAU,EAAE,MAAM,CAAC,WAAW,CAC5B,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;gBACtD,CAAC;gBACD;oBACE,GAAG,CAAC;oBACJ,YAAY,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,SAAS;iBACjE;aACF,CAAC,CACH;SACF;QACD,KAAK,EAAE,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE;QACzB,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI;QACvD,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;QAClE,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;QACrE,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC;QACpE,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC;QAClE,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC;QACpE,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,cAAc,EAAE,KAAK,CAAC,cAAc,IAAI,IAAI;QAC5C,YAAY,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,IAAI;QACnE,aAAa,EAAE,KAAK,CAAC,aAAa,KAAK,KAAK;QAC5C,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;QAC1C,UAAU,EAAE,KAAK,CAAC,UAAU;KAC7B,CAAC;AACJ,CAAC"}

package/dist/vm.d.ts

@@ -1,7 +1,7 @@
 import type { StoryPackage } from '@kawaijs/ast';
-import { type StoryState } from './state.js';
+import { type AchievementState, type StoryState } from './state.js';
 import { HistoryManager } from './history.js';
-import { SaveManager } from './save.js';
+import { SaveManager, type SaveSlot, type LoadResult } from './save.js';
 export interface AudioEvent {
     readonly action: 'play' | 'stop';
     readonly channel: 'music' | 'sound' | 'voice';
@@ -9,32 +9,74 @@ export interface AudioEvent {
     readonly fade?: number;
     readonly loop?: boolean;
 }
+export interface CameraEvent {
+    readonly action: 'shake' | 'vpunch' | 'hpunch' | 'flash';
+    readonly duration?: number;
+}
 export type StateChangeListener = (state: StoryState) => void;
 export type AudioEventListener = (event: AudioEvent) => void;
+export type CameraEventListener = (event: CameraEvent) => void;
+export type TickListener = (deltaMs: number, totalTimeMs: number) => void;
+export type ErrorListener = (error: Error) => void;
+export interface VMOptions {
+    readonly saveManager?: SaveManager;
+    readonly maxSnapshots?: number;
+    readonly maxCallDepth?: number;
+    /** Hard cap on instructions executed in a single burst (prevents infinite jump loops). */
+    readonly maxInstructionsPerBurst?: number;
+}
 export declare class StoryVM {
+    readonly storyHash: string;
     private readonly story;
     private state;
     private snapshotStack;
     private readonly historyManager;
     private readonly saveManager;
+    private readonly maxSnapshots;
+    private readonly maxCallDepth;
+    private readonly maxInstructionsPerBurst;
     private stateChangeListeners;
     private audioEventListeners;
+    private cameraEventListeners;
+    private errorListeners;
+    private tickListeners;
+    private executionTrace;
+    private virtualTimeMs;
     private isExecuting;
-    constructor(story: StoryPackage, saveManager?: SaveManager);
+    constructor(story: StoryPackage, saveManagerOrOptions?: SaveManager | VMOptions);
     getState(): StoryState;
+    getStory(): StoryPackage;
     getHistoryManager(): HistoryManager;
     getSaveManager(): SaveManager;
+    getExecutionTrace(): readonly string[];
+    clearExecutionTrace(): void;
+    private recordTrace;
+    getVirtualTime(): number;
+    tick(deltaMs: number): void;
+    onTick(listener: TickListener): () => void;
     onStateChange(listener: StateChangeListener): () => void;
     onAudioEvent(listener: AudioEventListener): () => void;
-    start(): void;
+    onCameraEvent(listener: CameraEventListener): () => void;
+    onError(listener: ErrorListener): () => void;
+    private emitCameraEvent;
+    private emitError;
+    start(atLabel?: string): void;
     /**
      * Advances the story to the next dialogue, choice, or scene event.
      */
     next(): void;
+    /**
+     * Completes a pending `input` prompt and continues the story.
+     */
+    submitInput(value: string): void;
     /**
      * Selects an option from the current choice menu.
      */
     choose(choiceIndex: number): void;
+    /**
+     * Selects a clickable hotspot and jumps to its target label.
+     */
+    selectHotspot(id: string): void;
     /**
      * Jumps directly to a label.
      */
@@ -44,13 +86,36 @@ export declare class StoryVM {
      */
     rollback(): boolean;
     canRollback(): boolean;
-    save(slotId: string): Promise<void>;
-    load(slotId: string): Promise<boolean>;
+    save(slotId: string): Promise<SaveSlot>;
+    load(slotId: string, validateStoryHash?: boolean): Promise<boolean>;
+    loadWithDetails(slotId: string, validateStoryHash?: boolean): Promise<LoadResult>;
+    /**
+     * Restore from an in-memory SaveSlot (continue-links, imported saves).
+     * Validates storyHash when present on the slot.
+     */
+    loadFromSlot(slot: SaveSlot, validateStoryHash?: boolean): LoadResult;
+    private applyLoadedSlot;
+    /**
+     * Emit stop/play audio events so the presentation layer matches restored state
+     * after load or rollback (snapshots store track ids but not live Audio elements).
+     */
+    private resyncAudio;
     private executeUntilWaiting;
     private executeInstruction;
     private captureSnapshot;
     private recordSnapshot;
     private notifyStateChanged;
     private emitAudioEvent;
+    private persistAchievement;
+    /** Merge locally persisted achievements into the current state (call after start/load). */
+    hydrateAchievements(): void;
+    /** Export achievements as a plain JSON-serializable object (itch / analytics). */
+    exportAchievementsJson(): {
+        storyHash: string;
+        exportedAt: number;
+        achievements: AchievementState[];
+    };
+    /** Set active language for `{t:key}` lookups (also used by `?lang=`). */
+    setLang(code: string): void;
 }
 //# sourceMappingURL=vm.d.ts.map