@sharpee/sharpee 0.9.61-beta

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 David Cornelson
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,114 @@
+# @sharpee/sharpee
+
+A modern TypeScript interactive fiction engine for creating text adventures and parser-based games.
+
+[![npm version](https://img.shields.io/npm/v/@sharpee/sharpee/beta.svg)](https://www.npmjs.com/package/@sharpee/sharpee)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Installation
+
+```bash
+npm install @sharpee/sharpee
+```
+
+## Features
+
+- **Event-Driven Architecture** - Immutable events for all state changes
+- **Rich World Model** - Entities with traits, behaviors, and relationships
+- **Natural Language Parser** - Understands complex player commands
+- **Extensible** - Add custom actions, behaviors, and game mechanics
+- **Type-Safe** - Full TypeScript with strict typing
+
+## Quick Start
+
+```typescript
+import {
+  GameEngine,
+  WorldModel,
+  EnglishParser,
+  EnglishLanguageProvider,
+  TextService
+} from '@sharpee/sharpee';
+
+// Define your story
+const story = {
+  metadata: {
+    title: 'My Adventure',
+    author: 'Your Name',
+    version: '1.0.0'
+  },
+
+  setup(world: WorldModel) {
+    // Create a room
+    const room = world.createEntity('room', {
+      id: 'start-room',
+      name: 'Starting Room',
+      description: 'You are in a small room with stone walls.'
+    });
+
+    // Set as starting location
+    world.setStartingLocation(room);
+  }
+};
+
+// Initialize the engine
+const engine = new GameEngine({
+  story,
+  parser: new EnglishParser(),
+  languageProvider: new EnglishLanguageProvider(),
+  textService: new TextService()
+});
+
+// Start the game
+const startEvents = engine.start();
+
+// Process player commands
+const events = engine.processCommand('look');
+```
+
+## What's Included
+
+This package re-exports the core Sharpee packages:
+
+| Export | Description |
+|--------|-------------|
+| `GameEngine` | Main game runtime |
+| `WorldModel`, `IFEntity` | Entity and world management |
+| `EnglishParser` | Natural language command parser |
+| `EnglishLanguageProvider` | English text generation |
+| `TextService` | Text formatting and output |
+| `QueryManager` | Player input queries (yes/no, menus) |
+
+## Standard Actions
+
+The engine includes 40+ standard IF actions out of the box:
+
+- **Movement**: go, enter, exit
+- **Manipulation**: take, drop, put, insert, remove
+- **Interaction**: open, close, lock, unlock, push, pull
+- **Observation**: look, examine, search, read
+- **Communication**: talk, give, show
+- **Meta**: save, restore, quit, inventory, score
+
+## Documentation
+
+- [GitHub Repository](https://github.com/ChicagoDave/sharpee)
+- [Author's Guide](https://github.com/ChicagoDave/sharpee/blob/main/docs/getting-started/authors/README.md)
+- [API Reference](https://github.com/ChicagoDave/sharpee/blob/main/docs/api/README.md)
+- [Architecture Decisions](https://github.com/ChicagoDave/sharpee/blob/main/docs/architecture/adrs/)
+
+## Example Stories
+
+See the [stories directory](https://github.com/ChicagoDave/sharpee/tree/main/stories) for complete examples:
+
+- **Cloak of Darkness** - The classic IF benchmark
+- **Dungeo** - Full implementation of Mainframe Zork (~190 rooms)
+
+## Requirements
+
+- Node.js 18+
+- TypeScript 5.2+ (for development)
+
+## License
+
+MIT

package/dist-npm/cli/build-browser.d.ts

@@ -0,0 +1,10 @@
+/**
+ * CLI: sharpee build-browser
+ *
+ * Bundles a Sharpee story for web browser deployment.
+ */
+/**
+ * Run the build-browser command
+ */
+export declare function runBuildBrowserCommand(args: string[]): Promise<void>;
+//# sourceMappingURL=build-browser.d.ts.map

package/dist-npm/cli/build-browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-browser.d.ts","sourceRoot":"","sources":["../../src/cli/build-browser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAwDH;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA8G1E"}

package/dist-npm/cli/build-browser.js

@@ -0,0 +1,206 @@
+"use strict";
+/**
+ * CLI: sharpee build-browser
+ *
+ * Bundles a Sharpee story for web browser deployment.
+ */
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runBuildBrowserCommand = runBuildBrowserCommand;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+/**
+ * Read story info from package.json or index.ts
+ */
+function getProjectInfo(projectDir) {
+    // Try package.json first
+    const packagePath = path.join(projectDir, 'package.json');
+    if (fs.existsSync(packagePath)) {
+        try {
+            const pkg = JSON.parse(fs.readFileSync(packagePath, 'utf-8'));
+            return {
+                storyId: pkg.name || 'my-story',
+                storyTitle: pkg.description || pkg.name || 'My Story',
+            };
+        }
+        catch {
+            // Fall through
+        }
+    }
+    // Try reading from src/index.ts
+    const indexPath = path.join(projectDir, 'src', 'index.ts');
+    if (fs.existsSync(indexPath)) {
+        const content = fs.readFileSync(indexPath, 'utf-8');
+        const idMatch = content.match(/id:\s*['"]([^'"]+)['"]/);
+        const titleMatch = content.match(/title:\s*['"]([^'"]+)['"]/);
+        if (idMatch || titleMatch) {
+            return {
+                storyId: idMatch?.[1] || 'my-story',
+                storyTitle: titleMatch?.[1] || 'My Story',
+            };
+        }
+    }
+    return null;
+}
+/**
+ * Process template placeholders
+ */
+function processTemplate(content, info) {
+    return content
+        .replace(/\{\{STORY_ID\}\}/g, info.storyId)
+        .replace(/\{\{STORY_TITLE\}\}/g, info.storyTitle);
+}
+/**
+ * Run the build-browser command
+ */
+async function runBuildBrowserCommand(args) {
+    // Check for help
+    if (args.includes('--help') || args.includes('-h')) {
+        showHelp();
+        return;
+    }
+    const projectDir = process.cwd();
+    const minify = !args.includes('--no-minify');
+    const sourcemap = !args.includes('--no-sourcemap');
+    console.log('\n🔨 Building browser bundle\n');
+    // Check if this is a Sharpee project
+    const info = getProjectInfo(projectDir);
+    if (!info) {
+        console.error('Error: This does not appear to be a Sharpee project.');
+        console.error('Make sure you have a package.json or src/index.ts with story config.');
+        process.exit(1);
+    }
+    console.log(`  Story: ${info.storyTitle} (${info.storyId})`);
+    // Check for browser-entry.ts
+    const browserEntryPath = path.join(projectDir, 'src', 'browser-entry.ts');
+    if (!fs.existsSync(browserEntryPath)) {
+        console.error('\nError: src/browser-entry.ts not found.');
+        console.error('Run "sharpee init-browser" first to add browser support.');
+        process.exit(1);
+    }
+    // Create output directory
+    const outDir = path.join(projectDir, 'dist', 'web');
+    fs.mkdirSync(outDir, { recursive: true });
+    // Build with esbuild
+    console.log('  Building...');
+    const esbuildArgs = [
+        browserEntryPath,
+        '--bundle',
+        '--platform=browser',
+        '--target=es2020',
+        '--format=iife',
+        `--global-name=SharpeeGame`,
+        `--outfile=${path.join(outDir, info.storyId + '.js')}`,
+        '--define:process.env.NODE_ENV=\\"production\\"',
+    ];
+    if (minify) {
+        esbuildArgs.push('--minify');
+    }
+    if (sourcemap) {
+        esbuildArgs.push('--sourcemap');
+    }
+    try {
+        (0, child_process_1.execSync)(`npx esbuild ${esbuildArgs.join(' ')}`, {
+            cwd: projectDir,
+            stdio: 'pipe',
+        });
+        console.log(`  ✓ Built ${info.storyId}.js`);
+    }
+    catch (error) {
+        console.error('  ✗ Build failed');
+        if (error.stderr) {
+            console.error(error.stderr.toString());
+        }
+        process.exit(1);
+    }
+    // Copy HTML template
+    const browserHtmlPath = path.join(projectDir, 'browser', 'index.html');
+    const defaultHtmlPath = path.join(__dirname, '..', '..', 'templates', 'browser', 'index.html');
+    const htmlSource = fs.existsSync(browserHtmlPath) ? browserHtmlPath : defaultHtmlPath;
+    if (fs.existsSync(htmlSource)) {
+        let htmlContent = fs.readFileSync(htmlSource, 'utf-8');
+        htmlContent = processTemplate(htmlContent, info);
+        fs.writeFileSync(path.join(outDir, 'index.html'), htmlContent);
+        console.log('  ✓ Copied index.html');
+    }
+    else {
+        console.warn('  ⚠ HTML template not found');
+    }
+    // Copy CSS
+    const browserCssPath = path.join(projectDir, 'browser', 'styles.css');
+    const defaultCssPath = path.join(__dirname, '..', '..', 'templates', 'browser', 'styles.css');
+    const cssSource = fs.existsSync(browserCssPath) ? browserCssPath : defaultCssPath;
+    if (fs.existsSync(cssSource)) {
+        fs.copyFileSync(cssSource, path.join(outDir, 'styles.css'));
+        console.log('  ✓ Copied styles.css');
+    }
+    else {
+        console.warn('  ⚠ CSS file not found');
+    }
+    // Report bundle size
+    const bundlePath = path.join(outDir, info.storyId + '.js');
+    if (fs.existsSync(bundlePath)) {
+        const stats = fs.statSync(bundlePath);
+        const sizeKb = (stats.size / 1024).toFixed(1);
+        console.log(`\n  Bundle size: ${sizeKb} KB`);
+    }
+    console.log('\n✅ Build complete!\n');
+    console.log(`Output: ${path.relative(projectDir, outDir)}/`);
+    console.log('');
+    console.log('To test locally:');
+    console.log(`  npx serve ${path.relative(projectDir, outDir)}`);
+    console.log('');
+}
+function showHelp() {
+    console.log(`
+sharpee build-browser - Build a web browser bundle
+
+Usage: sharpee build-browser [options]
+
+Options:
+  --no-minify      Skip minification
+  --no-sourcemap   Skip source map generation
+
+Output:
+  dist/web/
+    index.html     HTML page
+    <story-id>.js  JavaScript bundle
+    styles.css     Stylesheet
+
+The bundle includes your story, the Sharpee engine, and all dependencies.
+`);
+}
+//# sourceMappingURL=build-browser.js.map

package/dist-npm/cli/build-browser.js.map

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

package/dist-npm/cli/ifid.d.ts

@@ -0,0 +1,2 @@
+export declare function runIfidCommand(args: string[]): void;
+//# sourceMappingURL=ifid.d.ts.map

package/dist-npm/cli/ifid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ifid.d.ts","sourceRoot":"","sources":["../../src/cli/ifid.ts"],"names":[],"mappings":"AAKA,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAmBnD"}

package/dist-npm/cli/ifid.js

@@ -0,0 +1,71 @@
+"use strict";
+// packages/sharpee/src/cli/ifid.ts
+// IFID CLI commands
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runIfidCommand = runIfidCommand;
+const core_1 = require("@sharpee/core");
+function runIfidCommand(args) {
+    const subcommand = args[0];
+    switch (subcommand) {
+        case 'generate':
+            handleGenerate();
+            break;
+        case 'validate':
+            handleValidate(args.slice(1));
+            break;
+        case undefined:
+        case 'help':
+            showHelp();
+            break;
+        default:
+            console.error(`Unknown ifid subcommand: ${subcommand}`);
+            showHelp();
+            process.exit(1);
+    }
+}
+function handleGenerate() {
+    const ifid = (0, core_1.generateIfid)();
+    console.log(ifid);
+}
+function handleValidate(args) {
+    const ifid = args[0];
+    if (!ifid) {
+        console.error('Usage: sharpee ifid validate <ifid>');
+        process.exit(1);
+    }
+    const isValid = (0, core_1.validateIfid)(ifid);
+    if (isValid) {
+        console.log(`Valid IFID: ${ifid}`);
+    }
+    else {
+        // Try normalizing (uppercase conversion)
+        const normalized = (0, core_1.normalizeIfid)(ifid);
+        if (normalized) {
+            console.log(`Valid after normalization:`);
+            console.log(`  Original:   ${ifid}`);
+            console.log(`  Normalized: ${normalized}`);
+        }
+        else {
+            console.error(`Invalid IFID: ${ifid}`);
+            console.error('IFID requirements:');
+            console.error('  - Length: 8-63 characters');
+            console.error('  - Characters: A-Z, 0-9, and hyphens only');
+            console.error('  - Recommended: UUID format (uppercase)');
+            process.exit(1);
+        }
+    }
+}
+function showHelp() {
+    console.log(`
+sharpee ifid - IFID utilities
+
+Commands:
+  generate           Generate a new IFID (UUID format)
+  validate <ifid>    Validate an IFID string
+
+Examples:
+  sharpee ifid generate
+  sharpee ifid validate A1B2C3D4-E5F6-7890-ABCD-EF1234567890
+`);
+}
+//# sourceMappingURL=ifid.js.map

package/dist-npm/cli/ifid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ifid.js","sourceRoot":"","sources":["../../src/cli/ifid.ts"],"names":[],"mappings":";AAAA,mCAAmC;AACnC,oBAAoB;;AAIpB,wCAmBC;AArBD,wCAA0E;AAE1E,SAAgB,cAAc,CAAC,IAAc;IAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAE3B,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,UAAU;YACb,cAAc,EAAE,CAAC;YACjB,MAAM;QACR,KAAK,UAAU;YACb,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9B,MAAM;QACR,KAAK,SAAS,CAAC;QACf,KAAK,MAAM;YACT,QAAQ,EAAE,CAAC;YACX,MAAM;QACR;YACE,OAAO,CAAC,KAAK,CAAC,4BAA4B,UAAU,EAAE,CAAC,CAAC;YACxD,QAAQ,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACH,CAAC;AAED,SAAS,cAAc;IACrB,MAAM,IAAI,GAAG,IAAA,mBAAY,GAAE,CAAC;IAC5B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACpB,CAAC;AAED,SAAS,cAAc,CAAC,IAAc;IACpC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAErB,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACrD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,OAAO,GAAG,IAAA,mBAAY,EAAC,IAAI,CAAC,CAAC;IAEnC,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC;IACrC,CAAC;SAAM,CAAC;QACN,yCAAyC;QACzC,MAAM,UAAU,GAAG,IAAA,oBAAa,EAAC,IAAI,CAAC,CAAC;QACvC,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;YAC1C,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;YACrC,OAAO,CAAC,GAAG,CAAC,iBAAiB,UAAU,EAAE,CAAC,CAAC;QAC7C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;YACvC,OAAO,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;YACpC,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;YAC7C,OAAO,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAC;YAC5D,OAAO,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;YAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,QAAQ;IACf,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;CAUb,CAAC,CAAC;AACH,CAAC"}

package/dist-npm/cli/index.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * Sharpee CLI
+ *
+ * Command-line tools for creating and building Sharpee interactive fiction.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist-npm/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA;;;;GAIG"}

package/dist-npm/cli/index.js

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Sharpee CLI
+ *
+ * Command-line tools for creating and building Sharpee interactive fiction.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const ifid_1 = require("./ifid");
+const init_1 = require("./init");
+const init_browser_1 = require("./init-browser");
+const build_browser_1 = require("./build-browser");
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const { version: VERSION } = require('../../package.json');
+async function main() {
+    const args = process.argv.slice(2);
+    const command = args[0];
+    try {
+        switch (command) {
+            case 'init':
+                await (0, init_1.runInitCommand)(args.slice(1));
+                break;
+            case 'init-browser':
+                await (0, init_browser_1.runInitBrowserCommand)(args.slice(1));
+                break;
+            case 'build-browser':
+                await (0, build_browser_1.runBuildBrowserCommand)(args.slice(1));
+                break;
+            case 'ifid':
+                (0, ifid_1.runIfidCommand)(args.slice(1));
+                break;
+            case 'version':
+            case '-v':
+            case '--version':
+                console.log(`sharpee ${VERSION}`);
+                break;
+            case 'help':
+            case '-h':
+            case '--help':
+            case undefined:
+                showHelp();
+                break;
+            default:
+                console.error(`Unknown command: ${command}`);
+                showHelp();
+                process.exit(1);
+        }
+    }
+    catch (error) {
+        console.error('Error:', error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+}
+function showHelp() {
+    console.log(`
+sharpee - Interactive Fiction Engine CLI
+
+Usage: sharpee <command> [options]
+
+Commands:
+  init              Create a new Sharpee story project
+  init-browser      Add browser client to an existing project
+  build-browser     Build a web browser bundle
+  ifid              IFID utilities (generate, validate)
+  version           Show version
+  help              Show this help
+
+Examples:
+  sharpee init my-adventure       Create new project in ./my-adventure/
+  sharpee init-browser            Add browser support to current project
+  sharpee build-browser           Build web bundle in dist/web/
+
+Run 'sharpee <command> --help' for command-specific help.
+`);
+}
+main();
+//# sourceMappingURL=index.js.map

package/dist-npm/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";;AACA;;;;GAIG;;AAEH,iCAAwC;AACxC,iCAAwC;AACxC,iDAAuD;AACvD,mDAAyD;AAEzD,8DAA8D;AAC9D,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;AAE3D,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAExB,IAAI,CAAC;QACH,QAAQ,OAAO,EAAE,CAAC;YAChB,KAAK,MAAM;gBACT,MAAM,IAAA,qBAAc,EAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBACpC,MAAM;YACR,KAAK,cAAc;gBACjB,MAAM,IAAA,oCAAqB,EAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC3C,MAAM;YACR,KAAK,eAAe;gBAClB,MAAM,IAAA,sCAAsB,EAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC5C,MAAM;YACR,KAAK,MAAM;gBACT,IAAA,qBAAc,EAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC9B,MAAM;YACR,KAAK,SAAS,CAAC;YACf,KAAK,IAAI,CAAC;YACV,KAAK,WAAW;gBACd,OAAO,CAAC,GAAG,CAAC,WAAW,OAAO,EAAE,CAAC,CAAC;gBAClC,MAAM;YACR,KAAK,MAAM,CAAC;YACZ,KAAK,IAAI,CAAC;YACV,KAAK,QAAQ,CAAC;YACd,KAAK,SAAS;gBACZ,QAAQ,EAAE,CAAC;gBACX,MAAM;YACR;gBACE,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;gBAC7C,QAAQ,EAAE,CAAC;gBACX,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACxE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,SAAS,QAAQ;IACf,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;CAmBb,CAAC,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist-npm/cli/init-browser.d.ts

@@ -0,0 +1,10 @@
+/**
+ * CLI: sharpee init-browser
+ *
+ * Adds browser client files to an existing Sharpee story project.
+ */
+/**
+ * Run the init-browser command
+ */
+export declare function runInitBrowserCommand(args: string[]): Promise<void>;
+//# sourceMappingURL=init-browser.d.ts.map

package/dist-npm/cli/init-browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-browser.d.ts","sourceRoot":"","sources":["../../src/cli/init-browser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA2DH;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgGzE"}