@sharpee/stdlib 0.9.60-beta

package/dist/actions/standard/restarting/restarting-events.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Event type definitions for the restarting action
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=restarting-events.js.map

package/dist/actions/standard/restarting/restarting-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restarting-events.js","sourceRoot":"","sources":["../../../../src/actions/standard/restarting/restarting-events.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/actions/standard/restarting/restarting.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Restarting action - restart the game from the beginning
+ *
+ * This action emits a platform event that will be processed after turn completion.
+ * The engine will handle any necessary confirmations through its restart hook.
+ *
+ * Four-phase pattern:
+ * 1. validate: Check if restart is allowed, gather game state
+ * 2. execute: Analyze restart context, store in sharedData (no world mutations)
+ * 3. blocked: Handle validation failures (n/a - always succeeds)
+ * 4. report: Emit platform event and notifications
+ */
+import { Action } from '../../enhanced-types';
+import { ActionMetadata } from '../../../validation';
+export declare const restartingAction: Action & {
+    metadata: ActionMetadata;
+};
+//# sourceMappingURL=restarting.d.ts.map

package/dist/actions/standard/restarting/restarting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restarting.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/restarting/restarting.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,MAAM,EAAmC,MAAM,sBAAsB,CAAC;AAG/E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAqErD,eAAO,MAAM,gBAAgB,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAA;CA0DjE,CAAC"}

package/dist/actions/standard/restarting/restarting.js

@@ -0,0 +1,116 @@
+"use strict";
+/**
+ * Restarting action - restart the game from the beginning
+ *
+ * This action emits a platform event that will be processed after turn completion.
+ * The engine will handle any necessary confirmations through its restart hook.
+ *
+ * Four-phase pattern:
+ * 1. validate: Check if restart is allowed, gather game state
+ * 2. execute: Analyze restart context, store in sharedData (no world mutations)
+ * 3. blocked: Handle validation failures (n/a - always succeeds)
+ * 4. report: Emit platform event and notifications
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.restartingAction = void 0;
+const core_1 = require("@sharpee/core");
+const constants_1 = require("../../constants");
+/**
+ * Analyze restart context from game state
+ */
+function analyzeRestartContext(context) {
+    // Get game state for context
+    const sharedData = context.world.getCapability('sharedData') || {};
+    const hasUnsavedProgress = sharedData.moves > (sharedData.lastSaveMove || 0);
+    const score = sharedData.score || 0;
+    const moves = sharedData.moves || 0;
+    const currentLocation = context.currentLocation?.name || 'unknown';
+    // Check if force restart
+    const forceRestart = context.command.parsed.extras?.force ||
+        context.command.parsed.extras?.now ||
+        context.command.parsed.action === 'reset';
+    // Build restart context
+    const restartContext = {
+        currentProgress: {
+            score,
+            moves,
+            location: currentLocation
+        },
+        confirmationRequired: !forceRestart && (hasUnsavedProgress || moves > 10),
+        hasUnsavedChanges: hasUnsavedProgress,
+        force: forceRestart
+    };
+    // Build event data
+    const eventData = {
+        timestamp: Date.now(),
+        hasUnsavedChanges: hasUnsavedProgress,
+        force: forceRestart,
+        currentProgress: {
+            score,
+            moves,
+            location: currentLocation
+        }
+    };
+    // Show hint if not force restart and there's significant progress
+    const showHint = !forceRestart && (hasUnsavedProgress || moves > 10);
+    return {
+        forceRestart,
+        hasUnsavedProgress,
+        score,
+        moves,
+        currentLocation,
+        restartContext,
+        eventData,
+        showHint
+    };
+}
+exports.restartingAction = {
+    id: constants_1.IFActions.RESTARTING,
+    requiredMessages: [
+        // Confirmation messages
+        'restart_confirm',
+        'restart_unsaved',
+        'restart_requested',
+        // Status messages
+        'game_restarting',
+        'starting_over',
+        'new_game'
+    ],
+    validate(context) {
+        // Restart is always allowed - platform handles confirmation
+        return { valid: true };
+    },
+    execute(context) {
+        // Analyze restart context and store in sharedData
+        const data = analyzeRestartContext(context);
+        Object.assign(context.sharedData, data);
+    },
+    blocked(context, result) {
+        // Restarting always succeeds, but include blocked for consistency
+        return [context.event('if.event.restart_blocked', {
+                messageId: `if.action.restarting.${result.error}`,
+                params: result.params || {},
+                blocked: true,
+                reason: result.error
+            })];
+    },
+    report(context) {
+        const events = [];
+        const data = context.sharedData;
+        // Emit platform restart requested event
+        // The engine will handle this after turn completion
+        const platformEvent = (0, core_1.createRestartRequestedEvent)(data.restartContext);
+        events.push(platformEvent);
+        // Emit the restart requested event
+        events.push(context.event('if.event.restart_requested', data.eventData));
+        // Hint about confirmation is conveyed via the restart_requested event's data
+        // (showHint, hasUnsavedChanges fields)
+        return events;
+    },
+    group: "meta",
+    metadata: {
+        requiresDirectObject: false,
+        requiresIndirectObject: false
+    }
+};
+//# sourceMappingURL=restarting.js.map

package/dist/actions/standard/restarting/restarting.js.map

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

package/dist/actions/standard/restoring/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Restoring action module exports
+ */
+export { restoringAction } from './restoring';
+export * from './restoring-events';
+//# sourceMappingURL=index.d.ts.map

package/dist/actions/standard/restoring/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/restoring/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,cAAc,oBAAoB,CAAC"}

package/dist/actions/standard/restoring/index.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * Restoring action module exports
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.restoringAction = void 0;
+var restoring_1 = require("./restoring");
+Object.defineProperty(exports, "restoringAction", { enumerable: true, get: function () { return restoring_1.restoringAction; } });
+__exportStar(require("./restoring-events"), exports);
+//# sourceMappingURL=index.js.map

package/dist/actions/standard/restoring/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/actions/standard/restoring/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;AAEH,yCAA8C;AAArC,4GAAA,eAAe,OAAA;AACxB,qDAAmC"}

package/dist/actions/standard/restoring/restoring-events.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Event type definitions for the restoring action
+ */
+/**
+ * Event data for when a restore is requested
+ */
+export interface RestoreRequestedEventData {
+    /** Name/slot of the save to restore */
+    saveName: string;
+    /** Timestamp of the restore request */
+    timestamp: number;
+    /** Number of available saves */
+    availableSaves: number;
+}
+/**
+ * Error data for restoring failures
+ */
+export interface RestoringErrorData {
+    reason: 'restore_not_allowed' | 'no_saves' | 'save_not_found' | 'corrupt_save' | 'incompatible_save';
+    saveName?: string;
+}
+/**
+ * Complete event map for restoring action
+ */
+export interface RestoringEventMap {
+    'if.event.restore_requested': RestoreRequestedEventData;
+    'platform.restore_requested': any;
+    'action.success': {
+        actionId: string;
+        messageId: string;
+        params?: Record<string, any>;
+    };
+    'action.error': {
+        actionId: string;
+        messageId: string;
+        params?: Record<string, any>;
+    };
+}
+//# sourceMappingURL=restoring-events.d.ts.map

package/dist/actions/standard/restoring/restoring-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restoring-events.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/restoring/restoring-events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IAEjB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAElB,gCAAgC;IAChC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,qBAAqB,GAAG,UAAU,GAAG,gBAAgB,GACrD,cAAc,GAAG,mBAAmB,CAAC;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,4BAA4B,EAAE,yBAAyB,CAAC;IACxD,4BAA4B,EAAE,GAAG,CAAC;IAClC,gBAAgB,EAAE;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAC9B,CAAC;IACF,cAAc,EAAE;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAC9B,CAAC;CACH"}

package/dist/actions/standard/restoring/restoring-events.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Event type definitions for the restoring action
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=restoring-events.js.map

package/dist/actions/standard/restoring/restoring-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restoring-events.js","sourceRoot":"","sources":["../../../../src/actions/standard/restoring/restoring-events.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/actions/standard/restoring/restoring.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Restoring action - restore saved game state
+ *
+ * This is a meta action that triggers game restore functionality.
+ * It emits a platform event that the engine will process after turn completion.
+ *
+ * Four-phase pattern:
+ * 1. validate: Check if restore is allowed, check for available saves
+ * 2. execute: Analyze restore context, store in sharedData (no world mutations)
+ * 3. blocked: Handle validation failures
+ * 4. report: Emit platform event and notifications
+ */
+import { Action } from '../../enhanced-types';
+import { ActionMetadata } from '../../../validation';
+export declare const restoringAction: Action & {
+    metadata: ActionMetadata;
+};
+//# sourceMappingURL=restoring.d.ts.map

package/dist/actions/standard/restoring/restoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restoring.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/restoring/restoring.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,MAAM,EAAmC,MAAM,sBAAsB,CAAC;AAG/E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAyFrD,eAAO,MAAM,eAAe,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAA;CA8FhE,CAAC"}

package/dist/actions/standard/restoring/restoring.js

@@ -0,0 +1,156 @@
+"use strict";
+/**
+ * Restoring action - restore saved game state
+ *
+ * This is a meta action that triggers game restore functionality.
+ * It emits a platform event that the engine will process after turn completion.
+ *
+ * Four-phase pattern:
+ * 1. validate: Check if restore is allowed, check for available saves
+ * 2. execute: Analyze restore context, store in sharedData (no world mutations)
+ * 3. blocked: Handle validation failures
+ * 4. report: Emit platform event and notifications
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.restoringAction = void 0;
+const core_1 = require("@sharpee/core");
+const constants_1 = require("../../constants");
+/**
+ * Build list of available saves from game state
+ * Filters out autosave - that's for internal use only
+ */
+function buildAvailableSaves(existingSaves) {
+    return Object.entries(existingSaves)
+        .filter(([slot]) => slot !== 'autosave')
+        .map(([slot, data]) => ({
+        slot,
+        name: data.name || slot,
+        timestamp: data.timestamp || Date.now(),
+        metadata: {
+            score: data.score,
+            moves: data.moves,
+            version: data.version
+        }
+    }));
+}
+/**
+ * Find the most recent save
+ */
+function findLastSave(saves) {
+    if (saves.length === 0)
+        return null;
+    const latest = saves.reduce((best, save) => !best || save.timestamp > best.timestamp ? save : best, null);
+    return latest ? { slot: latest.slot, timestamp: latest.timestamp } : null;
+}
+/**
+ * Analyze restore context from game state
+ */
+function analyzeRestoreContext(context, saveName) {
+    // Get game state
+    const sharedData = context.world.getCapability('sharedData') || {};
+    const existingSaves = sharedData.saves || {};
+    // Build available saves info
+    const availableSaves = buildAvailableSaves(existingSaves);
+    const lastSave = findLastSave(availableSaves);
+    // Build restore context
+    const restoreContext = {
+        slot: saveName !== 'default' ? saveName : undefined,
+        availableSaves,
+        lastSave: lastSave || undefined
+    };
+    // Build event data
+    const eventData = {
+        saveName,
+        timestamp: Date.now(),
+        availableSaves: availableSaves.length
+    };
+    return {
+        saveName,
+        availableSaves,
+        lastSave,
+        restoreContext,
+        eventData
+    };
+}
+exports.restoringAction = {
+    id: constants_1.IFActions.RESTORING,
+    requiredMessages: [
+        'game_restored',
+        'game_loaded',
+        'restore_successful',
+        'welcome_back',
+        'restore_details',
+        'quick_restore',
+        'resuming_game',
+        'restore_failed',
+        'save_not_found',
+        'no_saves',
+        'corrupt_save',
+        'incompatible_save',
+        'restore_not_allowed',
+        'confirm_restore',
+        'unsaved_progress',
+        'available_saves',
+        'no_saves_available',
+        'choose_save',
+        'import_save',
+        'save_imported'
+    ],
+    validate(context) {
+        // Get game state info
+        const sharedData = context.world.getCapability('sharedData') || {};
+        const existingSaves = sharedData.saves || {};
+        // Check for restore restrictions
+        const restoreRestrictions = sharedData.restoreRestrictions || {};
+        if (restoreRestrictions.disabled) {
+            return {
+                valid: false,
+                error: 'restore_not_allowed'
+            };
+        }
+        // Check if any user saves exist (autosave doesn't count)
+        const userSaves = Object.keys(existingSaves).filter(slot => slot !== 'autosave');
+        if (userSaves.length === 0) {
+            return {
+                valid: false,
+                error: 'no_saves'
+            };
+        }
+        return { valid: true };
+    },
+    execute(context) {
+        // Extract save slot or name if provided
+        const saveName = context.command.parsed.extras?.name ||
+            context.command.parsed.extras?.slot ||
+            context.command.indirectObject?.parsed?.text ||
+            'default';
+        // Analyze restore context and store in sharedData
+        const data = analyzeRestoreContext(context, saveName);
+        Object.assign(context.sharedData, data);
+    },
+    blocked(context, result) {
+        return [context.event('if.event.restore_blocked', {
+                messageId: `if.action.restoring.${result.error}`,
+                params: result.params || {},
+                blocked: true,
+                reason: result.error
+            })];
+    },
+    report(context) {
+        const events = [];
+        const data = context.sharedData;
+        // Emit platform restore requested event
+        // The engine will handle this after turn completion
+        const platformEvent = (0, core_1.createRestoreRequestedEvent)(data.restoreContext);
+        events.push(platformEvent);
+        // Emit the restore requested event
+        events.push(context.event('if.event.restore_requested', data.eventData));
+        return events;
+    },
+    group: "meta",
+    metadata: {
+        requiresDirectObject: false,
+        requiresIndirectObject: false
+    }
+};
+//# sourceMappingURL=restoring.js.map

package/dist/actions/standard/restoring/restoring.js.map

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

package/dist/actions/standard/saving/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Saving action module exports
+ */
+export { savingAction } from './saving';
+export * from './saving-events';
+//# sourceMappingURL=index.d.ts.map

package/dist/actions/standard/saving/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/saving/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,cAAc,iBAAiB,CAAC"}

package/dist/actions/standard/saving/index.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * Saving action module exports
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.savingAction = void 0;
+var saving_1 = require("./saving");
+Object.defineProperty(exports, "savingAction", { enumerable: true, get: function () { return saving_1.savingAction; } });
+__exportStar(require("./saving-events"), exports);
+//# sourceMappingURL=index.js.map

package/dist/actions/standard/saving/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/actions/standard/saving/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;AAEH,mCAAwC;AAA/B,sGAAA,YAAY,OAAA;AACrB,kDAAgC"}

package/dist/actions/standard/saving/saving-events.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Event type definitions for the saving action
+ */
+/**
+ * Event data for when a save is requested
+ */
+export interface SaveRequestedEventData {
+    /** Name of the save */
+    saveName: string;
+    /** Timestamp of the save request */
+    timestamp: number;
+    /** Metadata about the game state */
+    metadata: {
+        score: number;
+        moves: number;
+        turnCount: number;
+        quickSave?: boolean;
+    };
+}
+/**
+ * Error data for saving failures
+ */
+export interface SavingErrorData {
+    reason: 'save_not_allowed' | 'save_in_progress' | 'invalid_save_name' | 'no_save_slots';
+    saveName?: string;
+}
+/**
+ * Complete event map for saving action
+ */
+export interface SavingEventMap {
+    'if.event.save_requested': SaveRequestedEventData;
+    'platform.save_requested': any;
+    'action.success': {
+        actionId: string;
+        messageId: string;
+        params?: Record<string, any>;
+    };
+    'action.error': {
+        actionId: string;
+        messageId: string;
+        params?: Record<string, any>;
+    };
+}
+//# sourceMappingURL=saving-events.d.ts.map

package/dist/actions/standard/saving/saving-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"saving-events.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/saving/saving-events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IAEjB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAElB,oCAAoC;IACpC,QAAQ,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,kBAAkB,GAAG,kBAAkB,GAAG,mBAAmB,GAC7D,eAAe,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,yBAAyB,EAAE,sBAAsB,CAAC;IAClD,yBAAyB,EAAE,GAAG,CAAC;IAC/B,gBAAgB,EAAE;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAC9B,CAAC;IACF,cAAc,EAAE;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAC9B,CAAC;CACH"}

package/dist/actions/standard/saving/saving-events.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Event type definitions for the saving action
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=saving-events.js.map

package/dist/actions/standard/saving/saving-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"saving-events.js","sourceRoot":"","sources":["../../../../src/actions/standard/saving/saving-events.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/actions/standard/saving/saving.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Saving action - save game state
+ *
+ * This is a meta action that triggers game save functionality.
+ * It emits a platform event that the engine will process after turn completion.
+ *
+ * Four-phase pattern:
+ * 1. validate: Check if save is allowed, validate save name
+ * 2. execute: Analyze save context, store in sharedData (no world mutations)
+ * 3. blocked: Handle validation failures
+ * 4. report: Emit platform event and notifications
+ */
+import { Action } from '../../enhanced-types';
+import { ActionMetadata } from '../../../validation';
+export declare const savingAction: Action & {
+    metadata: ActionMetadata;
+};
+//# sourceMappingURL=saving.d.ts.map

package/dist/actions/standard/saving/saving.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"saving.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/saving/saving.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,MAAM,EAAmC,MAAM,sBAAsB,CAAC;AAG/E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAiErD,eAAO,MAAM,YAAY,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAA;CAuG7D,CAAC"}