@sharpee/sharpee 0.9.76-beta → 0.9.77-beta

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sharpee/sharpee",
-  "version": "0.9.76-beta",
+  "version": "0.9.77-beta",
   "description": "Sharpee - Interactive Fiction Engine for TypeScript",
   "main": "./index.js",
   "types": "./index.d.ts",
@@ -15,23 +15,23 @@
     }
   },
   "dependencies": {
-    "@sharpee/core": "^0.9.76-beta",
-    "@sharpee/engine": "^0.9.76-beta",
-    "@sharpee/event-processor": "^0.9.76-beta",
-    "@sharpee/ext-testing": "^0.9.76-beta",
-    "@sharpee/if-domain": "^0.9.76-beta",
-    "@sharpee/if-services": "^0.9.76-beta",
-    "@sharpee/lang-en-us": "^0.9.76-beta",
-    "@sharpee/parser-en-us": "^0.9.76-beta",
-    "@sharpee/platform-browser": "^0.9.76-beta",
-    "@sharpee/plugin-npc": "^0.9.76-beta",
-    "@sharpee/plugin-scheduler": "^0.9.76-beta",
-    "@sharpee/plugin-state-machine": "^0.9.76-beta",
-    "@sharpee/plugins": "^0.9.76-beta",
-    "@sharpee/stdlib": "^0.9.76-beta",
-    "@sharpee/text-blocks": "^0.9.76-beta",
-    "@sharpee/text-service": "^0.9.76-beta",
-    "@sharpee/world-model": "^0.9.76-beta",
+    "@sharpee/core": "^0.9.77-beta",
+    "@sharpee/engine": "^0.9.77-beta",
+    "@sharpee/event-processor": "^0.9.77-beta",
+    "@sharpee/ext-testing": "^0.9.77-beta",
+    "@sharpee/if-domain": "^0.9.77-beta",
+    "@sharpee/if-services": "^0.9.77-beta",
+    "@sharpee/lang-en-us": "^0.9.77-beta",
+    "@sharpee/parser-en-us": "^0.9.77-beta",
+    "@sharpee/platform-browser": "^0.9.77-beta",
+    "@sharpee/plugin-npc": "^0.9.77-beta",
+    "@sharpee/plugin-scheduler": "^0.9.77-beta",
+    "@sharpee/plugin-state-machine": "^0.9.77-beta",
+    "@sharpee/plugins": "^0.9.77-beta",
+    "@sharpee/stdlib": "^0.9.77-beta",
+    "@sharpee/text-blocks": "^0.9.77-beta",
+    "@sharpee/text-service": "^0.9.77-beta",
+    "@sharpee/world-model": "^0.9.77-beta",
     "fflate": "^0.8.2"
   },
   "keywords": [

package/templates/browser/browser-entry.ts.template

@@ -0,0 +1,274 @@
+/**
+ * Browser Entry Point for {{STORY_TITLE}}
+ *
+ * This file connects your story to the browser UI.
+ * Generated by: npx sharpee init-browser
+ */
+
+import { GameEngine } from '@sharpee/engine';
+import { WorldModel, EntityType } from '@sharpee/world-model';
+import { Parser } from '@sharpee/parser-en-us';
+import { LanguageProvider } from '@sharpee/lang-en-us';
+import { PerceptionService } from '@sharpee/stdlib';
+import { story, config } from './index';
+
+// DOM elements
+let statusLocation: HTMLElement | null;
+let statusScore: HTMLElement | null;
+let textContent: HTMLElement | null;
+let mainWindow: HTMLElement | null;
+let commandInput: HTMLInputElement | null;
+
+// Game state
+let engine: GameEngine;
+let world: WorldModel;
+let commandHistory: string[] = [];
+let historyIndex = -1;
+let currentTurn = 0;
+let currentScore = 0;
+
+/**
+ * Initialize the game
+ */
+function initializeGame(): void {
+  // Create world and player
+  world = new WorldModel();
+  const player = world.createEntity('player', EntityType.ACTOR);
+  world.setPlayer(player.id);
+
+  // Create parser and language
+  const language = new LanguageProvider();
+  const parser = new Parser(language);
+
+  // Extend parser and language with story-specific vocabulary
+  if (story.extendParser) {
+    story.extendParser(parser);
+  }
+  if (story.extendLanguage) {
+    story.extendLanguage(language);
+  }
+
+  // Create perception service
+  const perceptionService = new PerceptionService();
+
+  // Create engine
+  engine = new GameEngine({
+    world,
+    player,
+    parser,
+    language,
+    perceptionService,
+  });
+
+  // Set up event handlers
+  engine.on('text:output', (text: string, turn: number) => {
+    displayText(text);
+    currentTurn = turn;
+    updateStatusLine();
+  });
+
+  engine.on('event', (event: any) => {
+    // Track score changes
+    if (event.type === 'game.score_changed' && event.data) {
+      currentScore = event.data.newScore ?? currentScore;
+      updateStatusLine();
+    }
+  });
+
+  // Set the story
+  engine.setStory(story);
+}
+
+/**
+ * Set up DOM elements and event handlers
+ */
+function setupDOM(): void {
+  statusLocation = document.getElementById('location-name');
+  statusScore = document.getElementById('score-turns');
+  textContent = document.getElementById('text-content');
+  mainWindow = document.getElementById('main-window');
+  commandInput = document.getElementById('command-input') as HTMLInputElement;
+
+  if (!commandInput) {
+    console.error('Command input element not found');
+    return;
+  }
+
+  // Handle keyboard input
+  commandInput.addEventListener('keydown', (e: KeyboardEvent) => {
+    if (e.key === 'Enter') {
+      handleCommand();
+    } else if (e.key === 'ArrowUp') {
+      e.preventDefault();
+      navigateHistory(-1);
+    } else if (e.key === 'ArrowDown') {
+      e.preventDefault();
+      navigateHistory(1);
+    }
+  });
+
+  // Keep focus on input
+  document.addEventListener('click', () => {
+    if (commandInput && !commandInput.disabled) {
+      commandInput.focus();
+    }
+  });
+}
+
+/**
+ * Handle command submission
+ */
+async function handleCommand(): Promise<void> {
+  if (!commandInput) return;
+
+  const command = commandInput.value.trim();
+  if (!command) return;
+
+  // Add to history
+  commandHistory.push(command);
+  historyIndex = commandHistory.length;
+
+  // Clear input
+  commandInput.value = '';
+
+  // Display command echo
+  displayCommand(command);
+
+  // Execute command
+  try {
+    await engine.executeTurn(command);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    displayText(`[Error: ${message}]`);
+  }
+}
+
+/**
+ * Navigate command history
+ */
+function navigateHistory(direction: number): void {
+  if (!commandInput) return;
+
+  const newIndex = historyIndex + direction;
+
+  if (newIndex < 0) return;
+
+  if (newIndex >= commandHistory.length) {
+    historyIndex = commandHistory.length;
+    commandInput.value = '';
+    return;
+  }
+
+  historyIndex = newIndex;
+  commandInput.value = commandHistory[historyIndex];
+
+  // Move cursor to end
+  commandInput.setSelectionRange(
+    commandInput.value.length,
+    commandInput.value.length
+  );
+}
+
+/**
+ * Display text in the main window
+ */
+function displayText(text: string): void {
+  if (!textContent) return;
+
+  // Split on double newlines to get paragraphs
+  const paragraphs = text.split(/\n\n+/);
+
+  for (const para of paragraphs) {
+    const trimmed = para.trim();
+    if (trimmed) {
+      const p = document.createElement('p');
+      p.style.whiteSpace = 'pre-line';
+      p.textContent = trimmed;
+      textContent.appendChild(p);
+    }
+  }
+
+  scrollToBottom();
+}
+
+/**
+ * Display command echo
+ */
+function displayCommand(command: string): void {
+  if (!textContent) return;
+
+  const div = document.createElement('div');
+  div.className = 'command-echo';
+  div.textContent = `> ${command}`;
+  textContent.appendChild(div);
+
+  scrollToBottom();
+}
+
+/**
+ * Update the status line
+ */
+function updateStatusLine(): void {
+  const player = world.getPlayer();
+  let locationName = '';
+
+  if (player) {
+    const locationId = world.getLocation(player.id);
+    if (locationId) {
+      const room = world.getEntity(locationId);
+      if (room) {
+        locationName = room.name || 'Unknown';
+      }
+    }
+  }
+
+  if (statusLocation) {
+    statusLocation.textContent = locationName;
+  }
+
+  if (statusScore) {
+    statusScore.textContent = `Score: ${currentScore} | Turns: ${currentTurn}`;
+  }
+}
+
+/**
+ * Scroll main window to bottom
+ */
+function scrollToBottom(): void {
+  if (mainWindow) {
+    mainWindow.scrollTop = mainWindow.scrollHeight;
+  }
+}
+
+/**
+ * Start the game
+ */
+async function start(): Promise<void> {
+  console.log('=== {{STORY_TITLE}} BROWSER START ===');
+
+  try {
+    setupDOM();
+    initializeGame();
+
+    // Start the engine
+    await engine.start();
+
+    // Initial look
+    await engine.executeTurn('look');
+
+    // Focus input
+    if (commandInput) {
+      commandInput.focus();
+    }
+  } catch (error) {
+    console.error('=== STARTUP ERROR ===', error);
+    displayText(`[Startup Error: ${error}]`);
+  }
+}
+
+// Start when DOM is ready
+if (document.readyState === 'loading') {
+  document.addEventListener('DOMContentLoaded', start);
+} else {
+  start();
+}

package/templates/browser/index.html

@@ -0,0 +1,75 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>{{STORY_TITLE}}</title>
+  <link rel="stylesheet" href="styles.css">
+</head>
+<body>
+  <div id="game-container">
+    <div id="status-line">
+      <span id="location-name"></span>
+      <span id="score-turns">Score: 0 | Turns: 0</span>
+    </div>
+    <div id="main-window">
+      <div id="text-content"></div>
+    </div>
+    <div id="input-area">
+      <span class="prompt">&gt;</span>
+      <input id="command-input" type="text"
+             autocomplete="off" autocapitalize="none"
+             spellcheck="false" autofocus>
+    </div>
+  </div>
+
+  <!-- Save/Restore Modal Dialogs -->
+  <div id="modal-overlay" class="modal-hidden">
+    <!-- Save Dialog -->
+    <div id="save-dialog" class="modal-dialog modal-hidden">
+      <div class="modal-title">SAVE GAME</div>
+      <div class="modal-content">
+        <div class="save-input-row">
+          <label for="save-name-input">Save name:</label>
+          <input type="text" id="save-name-input" maxlength="30"
+                 autocomplete="off" spellcheck="false">
+        </div>
+        <div class="saves-list-label">Existing saves (click to overwrite):</div>
+        <div id="save-slots-list" class="saves-list"></div>
+      </div>
+      <div class="modal-buttons">
+        <button id="save-confirm-btn" class="modal-btn">Save</button>
+        <button id="save-cancel-btn" class="modal-btn">Cancel</button>
+      </div>
+    </div>
+
+    <!-- Restore Dialog -->
+    <div id="restore-dialog" class="modal-dialog modal-hidden">
+      <div class="modal-title">RESTORE GAME</div>
+      <div class="modal-content">
+        <div class="saves-list-label">Select a saved game:</div>
+        <div id="restore-slots-list" class="saves-list"></div>
+        <div id="no-saves-message" class="no-saves-message modal-hidden">No saved games found.</div>
+      </div>
+      <div class="modal-buttons">
+        <button id="restore-confirm-btn" class="modal-btn">Restore</button>
+        <button id="restore-cancel-btn" class="modal-btn">Cancel</button>
+      </div>
+    </div>
+
+    <!-- Startup Dialog (continue saved game?) -->
+    <div id="startup-dialog" class="modal-dialog modal-hidden">
+      <div class="modal-title">CONTINUE GAME?</div>
+      <div class="modal-content">
+        <p id="startup-save-info" class="startup-info"></p>
+        <p class="startup-question">Continue where you left off?</p>
+      </div>
+      <div class="modal-buttons">
+        <button id="startup-continue-btn" class="modal-btn">Continue</button>
+        <button id="startup-new-btn" class="modal-btn">New Game</button>
+      </div>
+    </div>
+  </div>
+  <script src="{{STORY_ID}}.js"></script>
+</body>
+</html>

package/templates/browser/styles.css

@@ -0,0 +1,495 @@
+/* Infocom DOS-era styling for Sharpee IF games */
+
+/* DOS Color Palette */
+:root {
+  --dos-blue: #0000aa;
+  --dos-cyan: #00aaaa;
+  --dos-white: #aaaaaa;
+  --dos-bright-white: #ffffff;
+  --dos-black: #000000;
+}
+
+* {
+  box-sizing: border-box;
+  margin: 0;
+  padding: 0;
+}
+
+html, body {
+  height: 100%;
+  overflow: hidden;
+}
+
+body {
+  background: var(--dos-blue);
+  color: var(--dos-bright-white);
+  font-family: "Perfect DOS VGA 437", "Consolas", "Courier New", monospace;
+  font-size: 16px;
+  line-height: 1.4;
+}
+
+#game-container {
+  display: flex;
+  flex-direction: column;
+  height: 100vh;
+  max-width: 80ch;
+  margin: 0 auto;
+  padding: 0;
+}
+
+/* Status Line - Cyan background, black text */
+#status-line {
+  background: var(--dos-cyan);
+  color: var(--dos-black);
+  padding: 4px 8px;
+  display: flex;
+  justify-content: space-between;
+  font-weight: bold;
+  flex-shrink: 0;
+}
+
+#location-name {
+  text-transform: uppercase;
+}
+
+/* Main Text Window */
+#main-window {
+  flex: 1;
+  overflow-y: auto;
+  padding: 8px;
+  padding-bottom: 1em;
+}
+
+#text-content p {
+  margin-bottom: 0.8em;
+}
+
+#text-content p:last-child {
+  margin-bottom: 0;
+}
+
+/* Command echo styling */
+.command-echo {
+  color: var(--dos-white);
+  margin-top: 1em;
+  margin-bottom: 0.5em;
+}
+
+/* Input Area */
+#input-area {
+  display: flex;
+  align-items: center;
+  padding: 4px 8px;
+  border-top: 2px solid var(--dos-cyan);
+  flex-shrink: 0;
+  background: var(--dos-blue);
+}
+
+.prompt {
+  color: var(--dos-bright-white);
+  margin-right: 4px;
+}
+
+#command-input {
+  flex: 1;
+  background: transparent;
+  border: none;
+  color: var(--dos-bright-white);
+  font-family: inherit;
+  font-size: inherit;
+  line-height: inherit;
+  outline: none;
+  caret-color: var(--dos-bright-white);
+}
+
+#command-input::placeholder {
+  color: var(--dos-white);
+  opacity: 0.5;
+}
+
+/* Hide scrollbar but allow scrolling (Webkit) */
+#main-window::-webkit-scrollbar {
+  width: 8px;
+}
+
+#main-window::-webkit-scrollbar-track {
+  background: var(--dos-blue);
+}
+
+#main-window::-webkit-scrollbar-thumb {
+  background: var(--dos-cyan);
+}
+
+/* Firefox scrollbar */
+#main-window {
+  scrollbar-width: thin;
+  scrollbar-color: var(--dos-cyan) var(--dos-blue);
+}
+
+/* System messages */
+.system-message {
+  color: var(--dos-cyan);
+}
+
+/* Game over / victory */
+.game-status {
+  color: var(--dos-bright-white);
+  text-align: center;
+  font-weight: bold;
+  margin: 1em 0;
+  padding: 0.5em;
+  border: 1px solid var(--dos-cyan);
+}
+
+/* Mobile adjustments */
+@media (max-width: 600px) {
+  body {
+    font-size: 14px;
+  }
+
+  #game-container {
+    max-width: 100%;
+    padding: 0;
+  }
+
+  #status-line {
+    font-size: 12px;
+    padding: 6px 12px;
+    /* Safe area for notched phones */
+    padding-top: max(6px, env(safe-area-inset-top));
+    padding-left: max(12px, env(safe-area-inset-left));
+    padding-right: max(12px, env(safe-area-inset-right));
+  }
+
+  #main-window {
+    padding: 12px;
+    padding-left: max(12px, env(safe-area-inset-left));
+    padding-right: max(12px, env(safe-area-inset-right));
+  }
+
+  #input-area {
+    padding: 8px 12px;
+    padding-bottom: max(8px, env(safe-area-inset-bottom));
+    padding-left: max(12px, env(safe-area-inset-left));
+    padding-right: max(12px, env(safe-area-inset-right));
+    /* Larger touch target */
+    min-height: 48px;
+  }
+
+  #command-input {
+    font-size: 16px; /* Prevents iOS zoom on focus */
+    padding: 8px 0;
+  }
+
+  .prompt {
+    font-size: 16px;
+  }
+}
+
+/* Small phones */
+@media (max-width: 380px) {
+  body {
+    font-size: 13px;
+  }
+
+  #status-line {
+    font-size: 11px;
+    flex-wrap: wrap;
+    gap: 4px;
+  }
+
+  #location-name {
+    flex: 1 1 100%;
+    text-align: center;
+  }
+
+  #score-turns {
+    flex: 1 1 100%;
+    text-align: center;
+  }
+}
+
+/* Landscape phone */
+@media (max-height: 500px) and (orientation: landscape) {
+  body {
+    font-size: 13px;
+    line-height: 1.3;
+  }
+
+  #status-line {
+    padding: 2px 8px;
+    padding-left: max(8px, env(safe-area-inset-left));
+    padding-right: max(8px, env(safe-area-inset-right));
+  }
+
+  #main-window {
+    padding: 4px 8px;
+    padding-left: max(8px, env(safe-area-inset-left));
+    padding-right: max(8px, env(safe-area-inset-right));
+  }
+
+  #text-content p {
+    margin-bottom: 0.5em;
+  }
+
+  #input-area {
+    padding: 4px 8px;
+    padding-left: max(8px, env(safe-area-inset-left));
+    padding-right: max(8px, env(safe-area-inset-right));
+    min-height: 36px;
+  }
+}
+
+/* When virtual keyboard is likely open - use dvh for dynamic viewport */
+@supports (height: 100dvh) {
+  #game-container {
+    height: 100dvh;
+  }
+}
+
+/* Touch-specific: larger tap targets, no hover effects */
+@media (pointer: coarse) {
+  #command-input {
+    padding: 12px 0;
+  }
+
+  #input-area {
+    min-height: 52px;
+  }
+
+  /* Ensure scrollbar is visible on touch */
+  #main-window {
+    scrollbar-width: auto;
+  }
+
+  #main-window::-webkit-scrollbar {
+    width: 12px;
+  }
+}
+
+/* Blinking cursor effect */
+@keyframes blink {
+  0%, 50% { opacity: 1; }
+  51%, 100% { opacity: 0; }
+}
+
+#command-input:focus {
+  caret-color: var(--dos-bright-white);
+}
+
+/* ============================================
+   Save/Restore Modal Dialogs
+   ============================================ */
+
+.modal-hidden {
+  display: none !important;
+}
+
+#modal-overlay {
+  position: fixed;
+  top: 0;
+  left: 0;
+  right: 0;
+  bottom: 0;
+  background: rgba(0, 0, 0, 0.7);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  z-index: 1000;
+}
+
+.modal-dialog {
+  background: var(--dos-blue);
+  border: 2px solid var(--dos-cyan);
+  min-width: 300px;
+  max-width: 90vw;
+  max-height: 80vh;
+  display: flex;
+  flex-direction: column;
+}
+
+.modal-title {
+  background: var(--dos-cyan);
+  color: var(--dos-black);
+  padding: 4px 8px;
+  font-weight: bold;
+  text-align: center;
+}
+
+.modal-content {
+  padding: 12px;
+  flex: 1;
+  overflow-y: auto;
+}
+
+.save-input-row {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  margin-bottom: 12px;
+}
+
+.save-input-row label {
+  white-space: nowrap;
+}
+
+#save-name-input {
+  flex: 1;
+  background: var(--dos-black);
+  border: 1px solid var(--dos-cyan);
+  color: var(--dos-bright-white);
+  font-family: inherit;
+  font-size: inherit;
+  padding: 4px 6px;
+  outline: none;
+}
+
+#save-name-input:focus {
+  border-color: var(--dos-bright-white);
+}
+
+.saves-list-label {
+  color: var(--dos-white);
+  margin-bottom: 8px;
+  font-size: 0.9em;
+}
+
+.saves-list {
+  background: var(--dos-black);
+  border: 1px solid var(--dos-cyan);
+  max-height: 200px;
+  overflow-y: auto;
+}
+
+.save-slot {
+  padding: 6px 8px;
+  cursor: pointer;
+  display: flex;
+  justify-content: space-between;
+  gap: 12px;
+  border-bottom: 1px solid #333;
+}
+
+.save-slot:last-child {
+  border-bottom: none;
+}
+
+.save-slot:hover {
+  background: var(--dos-blue);
+}
+
+.save-slot.selected {
+  background: var(--dos-bright-white);
+  color: var(--dos-blue);
+}
+
+.save-slot-name {
+  font-weight: bold;
+  flex: 1;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.save-slot-info {
+  color: var(--dos-white);
+  font-size: 0.85em;
+  white-space: nowrap;
+}
+
+.save-slot.selected .save-slot-info {
+  color: var(--dos-blue);
+}
+
+.no-saves-message {
+  color: var(--dos-white);
+  font-style: italic;
+  padding: 12px;
+  text-align: center;
+}
+
+.modal-buttons {
+  display: flex;
+  justify-content: center;
+  gap: 16px;
+  padding: 12px;
+  border-top: 1px solid var(--dos-cyan);
+}
+
+.modal-btn {
+  background: var(--dos-black);
+  border: 1px solid var(--dos-cyan);
+  color: var(--dos-bright-white);
+  font-family: inherit;
+  font-size: inherit;
+  padding: 6px 20px;
+  cursor: pointer;
+  min-width: 80px;
+}
+
+.modal-btn:hover {
+  background: var(--dos-blue);
+  border-color: var(--dos-bright-white);
+}
+
+.modal-btn:focus {
+  outline: 1px solid var(--dos-bright-white);
+  outline-offset: 2px;
+}
+
+.modal-btn:disabled {
+  color: var(--dos-white);
+  opacity: 0.5;
+  cursor: not-allowed;
+}
+
+/* Startup dialog */
+.startup-info {
+  color: var(--dos-cyan);
+  margin: 0 0 12px 0;
+  line-height: 1.4;
+}
+
+.startup-question {
+  color: var(--dos-bright-white);
+  margin: 0;
+}
+
+/* Modal scrollbar styling */
+.saves-list::-webkit-scrollbar,
+.modal-content::-webkit-scrollbar {
+  width: 8px;
+}
+
+.saves-list::-webkit-scrollbar-track,
+.modal-content::-webkit-scrollbar-track {
+  background: var(--dos-black);
+}
+
+.saves-list::-webkit-scrollbar-thumb,
+.modal-content::-webkit-scrollbar-thumb {
+  background: var(--dos-cyan);
+}
+
+/* Mobile modal adjustments */
+@media (max-width: 600px) {
+  .modal-dialog {
+    min-width: 280px;
+    margin: 12px;
+  }
+
+  .save-input-row {
+    flex-direction: column;
+    align-items: stretch;
+    gap: 4px;
+  }
+
+  .modal-buttons {
+    gap: 12px;
+  }
+
+  .modal-btn {
+    flex: 1;
+    padding: 10px 16px;
+  }
+}

package/templates/story/index.ts.template

@@ -0,0 +1,74 @@
+/**
+ * {{STORY_TITLE}}
+ *
+ * A Sharpee Interactive Fiction story
+ */
+
+import {
+  Story,
+  StoryConfig,
+  WorldModel,
+  IFEntity,
+  Parser,
+  LanguageProvider,
+} from '@sharpee/sharpee';
+
+export const config: StoryConfig = {
+  id: '{{STORY_ID}}',
+  title: '{{STORY_TITLE}}',
+  author: '{{AUTHOR}}',
+  version: '1.0.0',
+  description: '{{DESCRIPTION}}',
+};
+
+export const story: Story = {
+  config,
+
+  initializeWorld(world: WorldModel): IFEntity {
+    // Get the player entity
+    const player = world.getPlayer();
+
+    // === CREATE YOUR ROOMS ===
+
+    // Starting room
+    const startRoom = world.createRoom('start-room', {
+      name: 'Starting Room',
+      description: 'You are in a small, dimly lit room. This is where your adventure begins.',
+    });
+
+    // === CREATE YOUR OBJECTS ===
+
+    // Example: a simple object
+    // const key = world.createEntity('key', 'object', {
+    //   name: 'brass key',
+    //   description: 'A small brass key.',
+    // });
+    // world.moveEntity(key.id, startRoom.id);
+
+    // === CONNECT YOUR ROOMS ===
+
+    // Example: connect rooms
+    // world.connectRooms(startRoom.id, 'north', anotherRoom.id);
+
+    // Place player in starting room
+    world.moveEntity(player.id, startRoom.id);
+
+    // Return the starting room
+    return startRoom;
+  },
+
+  // Optional: extend the parser with custom vocabulary
+  extendParser(parser: Parser): void {
+    // const grammar = parser.getStoryGrammar();
+    // grammar.define('custom command').mapsTo('story.action.custom').build();
+  },
+
+  // Optional: extend the language with custom messages
+  extendLanguage(language: LanguageProvider): void {
+    // language.addMessages({
+    //   'story.message.custom': 'A custom message.',
+    // });
+  },
+};
+
+export default story;

package/templates/story/package.json.template

@@ -0,0 +1,25 @@
+{
+  "name": "{{STORY_ID}}",
+  "version": "1.0.0",
+  "description": "{{DESCRIPTION}}",
+  "type": "module",
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "build:browser": "npx sharpee build-browser",
+    "dev": "tsc --watch"
+  },
+  "dependencies": {
+    "@sharpee/sharpee": "^0.9.61-beta"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0"
+  },
+  "keywords": [
+    "interactive-fiction",
+    "sharpee",
+    "text-adventure"
+  ],
+  "author": "{{AUTHOR}}",
+  "license": "MIT"
+}

package/templates/story/tsconfig.json.template

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "declaration": true,
+    "skipLibCheck": true
+  },
+  "include": ["src/**/*"]
+}