@sharpee/devkit 1.0.0

package/repo.js

@@ -0,0 +1,185 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BUNDLE_DTS = exports.BUNDLE_ALIASES = exports.PLATFORM_PACKAGES = void 0;
+exports.findMonorepoRoot = findMonorepoRoot;
+exports.findRepoRoot = findRepoRoot;
+exports.detectMode = detectMode;
+exports.tsfBin = tsfBin;
+exports.resolveStoryDir = resolveStoryDir;
+exports.storyVersionFile = storyVersionFile;
+exports.resolveStory = resolveStory;
+exports.readVersion = readVersion;
+/**
+ * repo.ts — monorepo layout constants and root resolution for devkit build/bundle.
+ *
+ * Owner context: @sharpee/devkit (ADR-180 Phase 3). These values mirror build.sh
+ * exactly so `devkit build`/`bundle` reach byte-for-byte output parity before
+ * build.sh is retired. Any drift here is a parity-gate failure.
+ *
+ * Public interface: findRepoRoot(), PLATFORM_PACKAGES, BUNDLE_ALIASES, BUNDLE_DTS,
+ * storyVersionFile(), resolveStoryDir().
+ */
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+/**
+ * Ordered platform build list (build.sh PACKAGES, 479-507): `[pkgName, dirUnderPackages]`.
+ * Order is dependency order — do not re-sort.
+ */
+exports.PLATFORM_PACKAGES = [
+    ['@sharpee/core', 'core'],
+    ['@sharpee/text-blocks', 'text-blocks'],
+    ['@sharpee/if-domain', 'if-domain'],
+    ['@sharpee/media', 'media'],
+    ['@sharpee/world-model', 'world-model'],
+    ['@sharpee/helpers', 'helpers'],
+    ['@sharpee/queries', 'queries'],
+    ['@sharpee/event-processor', 'event-processor'],
+    ['@sharpee/lang-en-us', 'lang-en-us'],
+    ['@sharpee/parser-en-us', 'parser-en-us'],
+    ['@sharpee/if-services', 'if-services'],
+    ['@sharpee/channel-service', 'channel-service'],
+    ['@sharpee/stdlib', 'stdlib'],
+    ['@sharpee/character', 'character'],
+    ['@sharpee/ext-basic-combat', 'extensions/basic-combat'],
+    ['@sharpee/plugins', 'plugins'],
+    ['@sharpee/plugin-npc', 'plugin-npc'],
+    ['@sharpee/plugin-scheduler', 'plugin-scheduler'],
+    ['@sharpee/plugin-state-machine', 'plugin-state-machine'],
+    ['@sharpee/story-runtime-baseline', 'story-runtime-baseline'],
+    ['@sharpee/ext-testing', 'extensions/testing'],
+    ['@sharpee/engine', 'engine'],
+    ['@sharpee/bootstrap', 'bootstrap'],
+    ['@sharpee/platform-browser', 'platform-browser'],
+    ['@sharpee/sharpee', 'sharpee'],
+    ['@sharpee/transcript-tester', 'transcript-tester'],
+    ['@sharpee/devkit', 'devkit'],
+];
+/**
+ * esbuild `--alias:` entries for the CLI bundle (build.sh build_bundle, 587-604).
+ * Order matches build.sh so the esbuild command is byte-identical.
+ */
+exports.BUNDLE_ALIASES = [
+    ['@sharpee/core', './packages/core/dist/index.js'],
+    ['@sharpee/if-domain', './packages/if-domain/dist/index.js'],
+    ['@sharpee/world-model', './packages/world-model/dist/index.js'],
+    ['@sharpee/stdlib', './packages/stdlib/dist/index.js'],
+    ['@sharpee/engine', './packages/engine/dist/index.js'],
+    ['@sharpee/parser-en-us', './packages/parser-en-us/dist/index.js'],
+    ['@sharpee/lang-en-us', './packages/lang-en-us/dist/index.js'],
+    ['@sharpee/event-processor', './packages/event-processor/dist/index.js'],
+    ['@sharpee/text-blocks', './packages/text-blocks/dist/index.js'],
+    ['@sharpee/channel-service', './packages/channel-service/dist/index.js'],
+    ['@sharpee/if-services', './packages/if-services/dist/index.js'],
+    ['@sharpee/ext-basic-combat', './packages/extensions/basic-combat/dist/index.js'],
+    ['@sharpee/plugins', './packages/plugins/dist/index.js'],
+    ['@sharpee/plugin-npc', './packages/plugin-npc/dist/index.js'],
+    ['@sharpee/plugin-scheduler', './packages/plugin-scheduler/dist/index.js'],
+    ['@sharpee/plugin-state-machine', './packages/plugin-state-machine/dist/index.js'],
+    ['@sharpee/bootstrap', './packages/bootstrap/dist/index.js'],
+    ['@sharpee/transcript-tester', './packages/transcript-tester/dist/index.js'],
+];
+/** Hand-written CLI bundle declarations (build.sh build_bundle, 607-619) — verbatim. */
+exports.BUNDLE_DTS = `// Auto-generated Sharpee type declarations
+export * from '../packages/core/dist/index';
+export * from '../packages/if-domain/dist/index';
+export * from '../packages/world-model/dist/index';
+export * from '../packages/stdlib/dist/index';
+export * from '../packages/engine/dist/index';
+export * from '../packages/parser-en-us/dist/index';
+export * from '../packages/lang-en-us/dist/index';
+export * from '../packages/event-processor/dist/index';
+export * from '../packages/text-blocks/dist/index';
+export * from '../packages/channel-service/dist/index';
+`;
+/**
+ * Walk up from `start` to the Sharpee monorepo root (the dir holding
+ * pnpm-workspace.yaml AND packages/core — the monorepo signature, so an author's
+ * coincidental pnpm workspace is not mistaken for it). Returns null if not found.
+ */
+function findMonorepoRoot(start = process.cwd()) {
+    let dir = (0, node_path_1.resolve)(start);
+    for (;;) {
+        if ((0, node_fs_1.existsSync)((0, node_path_1.join)(dir, 'pnpm-workspace.yaml')) && (0, node_fs_1.existsSync)((0, node_path_1.join)(dir, 'packages', 'core'))) {
+            return dir;
+        }
+        const parent = (0, node_path_1.dirname)(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+/**
+ * The monorepo root, or throw. Use when an operation is monorepo-only.
+ * @throws if not inside the Sharpee monorepo.
+ */
+function findRepoRoot(start = process.cwd()) {
+    const root = findMonorepoRoot(start);
+    if (!root)
+        throw new Error(`not inside the Sharpee monorepo (no pnpm-workspace.yaml + packages/core above ${start})`);
+    return root;
+}
+/**
+ * 'monorepo' when run inside the Sharpee monorepo (build platform + bundle + in-repo
+ * stories); 'standalone' when run in an author's own project (build their story via its
+ * own toolchain). The location-aware split behind `sharpee build` (ADR-180 unify).
+ */
+function detectMode(start = process.cwd()) {
+    return findMonorepoRoot(start) ? 'monorepo' : 'standalone';
+}
+/**
+ * Resolve the `tsf` executable. Prefers the workspace-local `node_modules/.bin/tsf`
+ * (a bare `tsf` fails when tsf is only a shell alias / not on a non-interactive PATH);
+ * falls back to `tsf` on PATH. Produces identical compiler output either way.
+ */
+function tsfBin(root) {
+    const local = (0, node_path_1.join)(root, 'node_modules', '.bin', 'tsf');
+    return (0, node_fs_1.existsSync)(local) ? local : 'tsf';
+}
+/**
+ * Resolve a story name to its directory (build.sh resolve_story_dir, 39-48):
+ * `stories/<name>` then `tutorials/<name>`. Returns absolute path or null.
+ */
+function resolveStoryDir(root, name) {
+    for (const base of ['stories', 'tutorials']) {
+        const dir = (0, node_path_1.join)(root, base, name);
+        if ((0, node_fs_1.existsSync)(dir))
+            return dir;
+    }
+    return null;
+}
+/** The story version.ts path build.sh stamps (stories/<name> only — tutorials are NOT stamped). */
+function storyVersionFile(root, name) {
+    return (0, node_path_1.join)(root, 'stories', name, 'src', 'version.ts');
+}
+function classifyStory(root, dir) {
+    const name = (0, node_path_1.basename)(dir);
+    const parent = (0, node_path_1.dirname)(dir);
+    const underStories = parent === (0, node_path_1.join)(root, 'stories');
+    const underTutorials = parent === (0, node_path_1.join)(root, 'tutorials');
+    const inRepo = underStories || underTutorials;
+    const pkg = underStories
+        ? `@sharpee/story-${name}`
+        : underTutorials
+            ? `@sharpee/tutorial-${name}`
+            : null;
+    return { name, dir, pkg, inRepo, underStories };
+}
+/**
+ * Resolve a story given either a **path** (a directory with a package.json, tried
+ * relative to cwd then to root) or a bare **name** (stories/<name> then tutorials/<name>).
+ * Returns null if neither resolves. This is the single resolver `build` + `stampVersions`
+ * share, so path and name forms behave identically (ADR-180 Decision 4: a story is a location).
+ */
+function resolveStory(root, nameOrPath) {
+    for (const dir of [(0, node_path_1.resolve)(nameOrPath), (0, node_path_1.resolve)(root, nameOrPath)]) {
+        if ((0, node_fs_1.existsSync)(dir) && (0, node_fs_1.existsSync)((0, node_path_1.join)(dir, 'package.json')))
+            return classifyStory(root, dir);
+    }
+    const byName = resolveStoryDir(root, nameOrPath);
+    return byName ? classifyStory(root, byName) : null;
+}
+/** Read a package.json's `version` field. */
+function readVersion(pkgJsonPath) {
+    return JSON.parse((0, node_fs_1.readFileSync)(pkgJsonPath, 'utf8')).version;
+}
+//# sourceMappingURL=repo.js.map

package/repo.js.map

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

package/standalone/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[], projectDirArg?: string): Promise<void>;
+//# sourceMappingURL=build-browser.d.ts.map

package/standalone/build-browser.d.ts.map

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

package/standalone/build-browser.js

@@ -0,0 +1,208 @@
+"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, projectDirArg) {
+    // Check for help
+    if (args.includes('--help') || args.includes('-h')) {
+        showHelp();
+        return;
+    }
+    const projectDir = projectDirArg || 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\\"',
+        '--define:process.env.PARSER_DEBUG=\\"false\\"',
+        '--define:process.env.DEBUG_PRONOUNS=\\"\\"',
+    ];
+    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/standalone/build-browser.js.map

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

package/standalone/build.d.ts

@@ -0,0 +1,8 @@
+/**
+ * CLI: sharpee build
+ *
+ * Builds a .sharpee story bundle and browser client from a story project.
+ * With --test, also compiles the story and runs transcript tests.
+ */
+export declare function runBuildCommand(args: string[], projectDirArg?: string): Promise<void>;
+//# sourceMappingURL=build.d.ts.map

package/standalone/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/devkit/src/standalone/build.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiDH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwI3F"}