@sharpee/plugins 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/dist-npm/index.d.ts

@@ -0,0 +1,4 @@
+export { TurnPlugin } from './turn-plugin';
+export { TurnPluginContext, TurnPluginActionResult } from './turn-plugin-context';
+export { PluginRegistry } from './plugin-registry';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/dist-npm/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PluginRegistry = void 0;
+var plugin_registry_1 = require("./plugin-registry");
+Object.defineProperty(exports, "PluginRegistry", { enumerable: true, get: function () { return plugin_registry_1.PluginRegistry; } });
+//# sourceMappingURL=index.js.map

package/dist-npm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAEA,qDAAmD;AAA1C,iHAAA,cAAc,OAAA"}

package/dist-npm/plugin-registry.d.ts

@@ -0,0 +1,11 @@
+import { TurnPlugin } from './turn-plugin';
+export declare class PluginRegistry {
+    private plugins;
+    register(plugin: TurnPlugin): void;
+    unregister(id: string): void;
+    getAll(): TurnPlugin[];
+    getById(id: string): TurnPlugin | undefined;
+    getStates(): Record<string, unknown>;
+    setStates(states: Record<string, unknown>): void;
+}
+//# sourceMappingURL=plugin-registry.d.ts.map

package/dist-npm/plugin-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-registry.d.ts","sourceRoot":"","sources":["../src/plugin-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAsC;IAErD,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAOlC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI5B,MAAM,IAAI,UAAU,EAAE;IAMtB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAI3C,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAUpC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAQjD"}

package/dist-npm/plugin-registry.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PluginRegistry = void 0;
+class PluginRegistry {
+    plugins = new Map();
+    register(plugin) {
+        if (this.plugins.has(plugin.id)) {
+            throw new Error(`Plugin already registered: ${plugin.id}`);
+        }
+        this.plugins.set(plugin.id, plugin);
+    }
+    unregister(id) {
+        this.plugins.delete(id);
+    }
+    getAll() {
+        return Array.from(this.plugins.values()).sort((a, b) => b.priority - a.priority);
+    }
+    getById(id) {
+        return this.plugins.get(id);
+    }
+    getStates() {
+        const states = {};
+        for (const plugin of this.plugins.values()) {
+            if (plugin.getState) {
+                states[plugin.id] = plugin.getState();
+            }
+        }
+        return states;
+    }
+    setStates(states) {
+        for (const [id, state] of Object.entries(states)) {
+            const plugin = this.plugins.get(id);
+            if (plugin?.setState) {
+                plugin.setState(state);
+            }
+        }
+    }
+}
+exports.PluginRegistry = PluginRegistry;
+//# sourceMappingURL=plugin-registry.js.map

package/dist-npm/plugin-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-registry.js","sourceRoot":"","sources":["../src/plugin-registry.ts"],"names":[],"mappings":";;;AAEA,MAAa,cAAc;IACjB,OAAO,GAA4B,IAAI,GAAG,EAAE,CAAC;IAErD,QAAQ,CAAC,MAAkB;QACzB,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,8BAA8B,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QAC7D,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAED,UAAU,CAAC,EAAU;QACnB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM;QACJ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAC3C,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAClC,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,EAAU;QAChB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED,SAAS;QACP,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3C,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACpB,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;YACxC,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,SAAS,CAAC,MAA+B;QACvC,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACjD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACpC,IAAI,MAAM,EAAE,QAAQ,EAAE,CAAC;gBACrB,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;CACF;AA1CD,wCA0CC"}

package/dist-npm/turn-plugin-context.d.ts

@@ -0,0 +1,18 @@
+import { EntityId, SeededRandom, ISemanticEvent } from '@sharpee/core';
+import { WorldModel } from '@sharpee/world-model';
+export interface TurnPluginActionResult {
+    actionId: string;
+    success: boolean;
+    targetId?: EntityId;
+    sharedData?: Record<string, unknown>;
+}
+export interface TurnPluginContext {
+    world: WorldModel;
+    turn: number;
+    playerId: EntityId;
+    playerLocation: EntityId;
+    random: SeededRandom;
+    actionResult?: TurnPluginActionResult;
+    actionEvents?: ISemanticEvent[];
+}
+//# sourceMappingURL=turn-plugin-context.d.ts.map

package/dist-npm/turn-plugin-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-plugin-context.d.ts","sourceRoot":"","sources":["../src/turn-plugin-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;IACnB,cAAc,EAAE,QAAQ,CAAC;IACzB,MAAM,EAAE,YAAY,CAAC;IACrB,YAAY,CAAC,EAAE,sBAAsB,CAAC;IACtC,YAAY,CAAC,EAAE,cAAc,EAAE,CAAC;CACjC"}

package/dist-npm/turn-plugin-context.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=turn-plugin-context.js.map

package/dist-npm/turn-plugin-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-plugin-context.js","sourceRoot":"","sources":["../src/turn-plugin-context.ts"],"names":[],"mappings":""}

package/dist-npm/turn-plugin.d.ts

@@ -0,0 +1,10 @@
+import { ISemanticEvent } from '@sharpee/core';
+import { TurnPluginContext } from './turn-plugin-context';
+export interface TurnPlugin {
+    id: string;
+    priority: number;
+    onAfterAction(context: TurnPluginContext): ISemanticEvent[];
+    getState?(): unknown;
+    setState?(state: unknown): void;
+}
+//# sourceMappingURL=turn-plugin.d.ts.map

package/dist-npm/turn-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-plugin.d.ts","sourceRoot":"","sources":["../src/turn-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,cAAc,EAAE,CAAC;IAC5D,QAAQ,CAAC,IAAI,OAAO,CAAC;IACrB,QAAQ,CAAC,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CACjC"}

package/dist-npm/turn-plugin.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=turn-plugin.js.map

package/dist-npm/turn-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-plugin.js","sourceRoot":"","sources":["../src/turn-plugin.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@sharpee/plugins",
+  "version": "0.9.61-beta",
+  "description": "Plugin contracts for Sharpee engine turn-cycle extensibility",
+  "main": "dist-npm/index.js",
+  "module": "dist-npm/index.js",
+  "types": "dist-npm/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist-npm/index.d.ts",
+      "import": "./dist-npm/index.js",
+      "require": "./dist-npm/index.js"
+    }
+  },
+  "dependencies": {
+    "@sharpee/core": "0.9.61-beta",
+    "@sharpee/world-model": "0.9.61-beta"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.19",
+    "typescript": "^5.3.3",
+    "rimraf": "^5.0.5"
+  },
+  "files": [
+    "dist-npm"
+  ],
+  "keywords": [
+    "interactive-fiction",
+    "sharpee",
+    "plugins",
+    "turn-cycle"
+  ],
+  "author": "Sharpee Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ChicagoDave/sharpee.git",
+    "directory": "packages/plugins"
+  },
+  "homepage": "https://github.com/ChicagoDave/sharpee#readme",
+  "bugs": {
+    "url": "https://github.com/ChicagoDave/sharpee/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rimraf dist",
+    "build:npm": "tsc --outDir dist-npm"
+  }
+}