@sharpee/helpers 0.9.103

package/augment.d.ts

@@ -0,0 +1,18 @@
+/**
+ * IWorldModel augmentation — adds helpers() method via declaration merging.
+ *
+ * Importing this module (or any re-export of it) patches WorldModel.prototype
+ * with a helpers() method that returns pre-bound entity builder functions.
+ *
+ * This follows the same pattern as @sharpee/media extending EventDataRegistry.
+ *
+ * Owner context: @sharpee/helpers (ADR-140)
+ */
+import { EntityHelpers } from './create-helpers';
+declare module '@sharpee/world-model' {
+    interface WorldModel {
+        /** Get fluent entity builder functions bound to this world. */
+        helpers(): EntityHelpers;
+    }
+}
+//# sourceMappingURL=augment.d.ts.map

package/augment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"augment.d.ts","sourceRoot":"","sources":["../../../../../repos/sharpee/packages/helpers/src/augment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAiB,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAKhE,OAAO,QAAQ,sBAAsB,CAAC;IACpC,UAAU,UAAU;QAClB,+DAA+D;QAC/D,OAAO,IAAI,aAAa,CAAC;KAC1B;CACF"}

package/augment.js

@@ -0,0 +1,19 @@
+"use strict";
+/**
+ * IWorldModel augmentation — adds helpers() method via declaration merging.
+ *
+ * Importing this module (or any re-export of it) patches WorldModel.prototype
+ * with a helpers() method that returns pre-bound entity builder functions.
+ *
+ * This follows the same pattern as @sharpee/media extending EventDataRegistry.
+ *
+ * Owner context: @sharpee/helpers (ADR-140)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const world_model_1 = require("../world-model/index.js");
+const create_helpers_1 = require("./create-helpers");
+// Patch WorldModel.prototype at import time
+world_model_1.WorldModel.prototype.helpers = function () {
+    return (0, create_helpers_1.createHelpers)(this);
+};
+//# sourceMappingURL=augment.js.map

package/augment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"augment.js","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/helpers/src/augment.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;AAEH,sDAAkD;AAClD,qDAAgE;AAYhE,4CAA4C;AAC3C,wBAAU,CAAC,SAAiB,CAAC,OAAO,GAAG;IACtC,OAAO,IAAA,8BAAa,EAAC,IAA6D,CAAC,CAAC;AACtF,CAAC,CAAC"}

package/builders/actor.d.ts

@@ -0,0 +1,83 @@
+/**
+ * ActorBuilder — fluent builder for actor entities.
+ *
+ * Public interface: description, aliases, properName, inventory, in,
+ * skipValidation, build.
+ *
+ * Owner context: @sharpee/helpers (ADR-140)
+ */
+import { IFEntity } from "../../world-model/index";
+import type { IWorldModel } from "../../world-model/index";
+/**
+ * Fluent builder for creating actor entities (players and NPCs).
+ *
+ * @example
+ * ```typescript
+ * const player = actor('yourself')
+ *   .description('As good-looking as ever.')
+ *   .aliases('self', 'me', 'myself')
+ *   .properName()
+ *   .inventory({ maxItems: 10 })
+ *   .build();
+ * ```
+ */
+export declare class ActorBuilder {
+    private world;
+    private name;
+    private _description?;
+    private _aliases?;
+    private _properName;
+    private _inventory?;
+    private _location?;
+    private _skipValidation;
+    constructor(world: IWorldModel, name: string);
+    /**
+     * Set the actor description.
+     *
+     * @param desc - Actor description text
+     * @returns this (for chaining)
+     */
+    description(desc: string): this;
+    /**
+     * Add name aliases.
+     *
+     * @param names - Alternative names
+     * @returns this (for chaining)
+     */
+    aliases(...names: string[]): this;
+    /**
+     * Mark as a proper name (no article).
+     *
+     * @returns this (for chaining)
+     */
+    properName(): this;
+    /**
+     * Add inventory capacity (adds ContainerTrait).
+     *
+     * @param opts - Inventory options
+     * @returns this (for chaining)
+     */
+    inventory(opts?: {
+        maxItems?: number;
+    }): this;
+    /**
+     * Place the actor in a location.
+     *
+     * @param location - The entity to place this actor in
+     * @returns this (for chaining)
+     */
+    in(location: IFEntity): this;
+    /**
+     * Bypass validation for placement.
+     *
+     * @returns this (for chaining)
+     */
+    skipValidation(): this;
+    /**
+     * Create the actor entity with configured traits.
+     *
+     * @returns The created IFEntity
+     */
+    build(): IFEntity;
+}
+//# sourceMappingURL=actor.d.ts.map

package/builders/actor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actor.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/helpers/src/builders/actor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,QAAQ,EAKT,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD;;;;;;;;;;;;GAYG;AACH,qBAAa,YAAY;IASrB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,IAAI;IATd,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,CAAW;IAC5B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAC,CAAwB;IAC3C,OAAO,CAAC,SAAS,CAAC,CAAW;IAC7B,OAAO,CAAC,eAAe,CAAS;gBAGtB,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,MAAM;IAGtB;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK/B;;;;;OAKG;IACH,OAAO,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAKjC;;;;OAIG;IACH,UAAU,IAAI,IAAI;IAKlB;;;;;OAKG;IACH,SAAS,CAAC,IAAI,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,IAAI;IAKjD;;;;;OAKG;IACH,EAAE,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAK5B;;;;OAIG;IACH,cAAc,IAAI,IAAI;IAKtB;;;;OAIG;IACH,KAAK,IAAI,QAAQ;CA0BlB"}

package/builders/actor.js

@@ -0,0 +1,127 @@
+"use strict";
+/**
+ * ActorBuilder — fluent builder for actor entities.
+ *
+ * Public interface: description, aliases, properName, inventory, in,
+ * skipValidation, build.
+ *
+ * Owner context: @sharpee/helpers (ADR-140)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ActorBuilder = void 0;
+const world_model_1 = require("../../world-model/index.js");
+/**
+ * Fluent builder for creating actor entities (players and NPCs).
+ *
+ * @example
+ * ```typescript
+ * const player = actor('yourself')
+ *   .description('As good-looking as ever.')
+ *   .aliases('self', 'me', 'myself')
+ *   .properName()
+ *   .inventory({ maxItems: 10 })
+ *   .build();
+ * ```
+ */
+class ActorBuilder {
+    world;
+    name;
+    _description;
+    _aliases;
+    _properName = false;
+    _inventory;
+    _location;
+    _skipValidation = false;
+    constructor(world, name) {
+        this.world = world;
+        this.name = name;
+    }
+    /**
+     * Set the actor description.
+     *
+     * @param desc - Actor description text
+     * @returns this (for chaining)
+     */
+    description(desc) {
+        this._description = desc;
+        return this;
+    }
+    /**
+     * Add name aliases.
+     *
+     * @param names - Alternative names
+     * @returns this (for chaining)
+     */
+    aliases(...names) {
+        this._aliases = names;
+        return this;
+    }
+    /**
+     * Mark as a proper name (no article).
+     *
+     * @returns this (for chaining)
+     */
+    properName() {
+        this._properName = true;
+        return this;
+    }
+    /**
+     * Add inventory capacity (adds ContainerTrait).
+     *
+     * @param opts - Inventory options
+     * @returns this (for chaining)
+     */
+    inventory(opts = {}) {
+        this._inventory = opts;
+        return this;
+    }
+    /**
+     * Place the actor in a location.
+     *
+     * @param location - The entity to place this actor in
+     * @returns this (for chaining)
+     */
+    in(location) {
+        this._location = location;
+        return this;
+    }
+    /**
+     * Bypass validation for placement.
+     *
+     * @returns this (for chaining)
+     */
+    skipValidation() {
+        this._skipValidation = true;
+        return this;
+    }
+    /**
+     * Create the actor entity with configured traits.
+     *
+     * @returns The created IFEntity
+     */
+    build() {
+        const entity = this.world.createEntity(this.name, 'actor');
+        entity.add(new world_model_1.ActorTrait());
+        entity.add(new world_model_1.IdentityTrait({
+            name: this.name,
+            description: this._description,
+            aliases: this._aliases,
+            properName: this._properName,
+            article: this._properName ? '' : undefined,
+        }));
+        if (this._inventory) {
+            entity.add(new world_model_1.ContainerTrait({
+                capacity: this._inventory.maxItems ? { maxItems: this._inventory.maxItems } : undefined,
+            }));
+        }
+        if (this._location) {
+            const mover = this._skipValidation
+                ? new world_model_1.AuthorModel(this.world.getDataStore(), this.world)
+                : this.world;
+            mover.moveEntity(entity.id, this._location.id);
+        }
+        return entity;
+    }
+}
+exports.ActorBuilder = ActorBuilder;
+//# sourceMappingURL=actor.js.map

package/builders/actor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actor.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/helpers/src/builders/actor.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH,sDAM8B;AAG9B;;;;;;;;;;;;GAYG;AACH,MAAa,YAAY;IASb;IACA;IATF,YAAY,CAAU;IACtB,QAAQ,CAAY;IACpB,WAAW,GAAG,KAAK,CAAC;IACpB,UAAU,CAAyB;IACnC,SAAS,CAAY;IACrB,eAAe,GAAG,KAAK,CAAC;IAEhC,YACU,KAAkB,EAClB,IAAY;QADZ,UAAK,GAAL,KAAK,CAAa;QAClB,SAAI,GAAJ,IAAI,CAAQ;IACnB,CAAC;IAEJ;;;;;OAKG;IACH,WAAW,CAAC,IAAY;QACtB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,GAAG,KAAe;QACxB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,UAAU;QACR,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,OAA8B,EAAE;QACxC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,EAAE,CAAC,QAAkB;QACnB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,cAAc;QACZ,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,KAAK;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC3D,MAAM,CAAC,GAAG,CAAC,IAAI,wBAAU,EAAE,CAAC,CAAC;QAC7B,MAAM,CAAC,GAAG,CAAC,IAAI,2BAAa,CAAC;YAC3B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,YAAY;YAC9B,OAAO,EAAE,IAAI,CAAC,QAAQ;YACtB,UAAU,EAAE,IAAI,CAAC,WAAW;YAC5B,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS;SAC3C,CAAC,CAAC,CAAC;QAEJ,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,MAAM,CAAC,GAAG,CAAC,IAAI,4BAAc,CAAC;gBAC5B,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS;aACxF,CAAC,CAAC,CAAC;QACN,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe;gBAChC,CAAC,CAAC,IAAI,yBAAW,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC;gBACxD,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;YACf,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACjD,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AA5GD,oCA4GC"}

package/builders/container.d.ts

@@ -0,0 +1,87 @@
+/**
+ * ContainerBuilder — fluent builder for container entities.
+ *
+ * Public interface: description, aliases, in, openable, lockable,
+ * skipValidation, build.
+ *
+ * Owner context: @sharpee/helpers (ADR-140)
+ */
+import { IFEntity } from "../../world-model/index";
+import type { IWorldModel } from "../../world-model/index";
+/**
+ * Fluent builder for creating container entities.
+ *
+ * @example
+ * ```typescript
+ * const chest = container('wooden chest')
+ *   .description('A sturdy wooden chest.')
+ *   .openable({ isOpen: false })
+ *   .lockable({ isLocked: true, keyId: key.id })
+ *   .in(treasureRoom)
+ *   .build();
+ * ```
+ */
+export declare class ContainerBuilder {
+    private world;
+    private name;
+    private _description?;
+    private _aliases?;
+    private _location?;
+    private _openable?;
+    private _lockable?;
+    private _skipValidation;
+    constructor(world: IWorldModel, name: string);
+    /**
+     * Set the container description.
+     *
+     * @param desc - Container description text
+     * @returns this (for chaining)
+     */
+    description(desc: string): this;
+    /**
+     * Add name aliases.
+     *
+     * @param names - Alternative names
+     * @returns this (for chaining)
+     */
+    aliases(...names: string[]): this;
+    /**
+     * Place the container in a location.
+     *
+     * @param location - The entity to place this container in
+     * @returns this (for chaining)
+     */
+    in(location: IFEntity): this;
+    /**
+     * Make the container openable.
+     *
+     * @param opts - Openable options
+     * @returns this (for chaining)
+     */
+    openable(opts?: {
+        isOpen?: boolean;
+    }): this;
+    /**
+     * Make the container lockable.
+     *
+     * @param opts - Lockable options
+     * @returns this (for chaining)
+     */
+    lockable(opts?: {
+        isLocked?: boolean;
+        keyId?: string;
+    }): this;
+    /**
+     * Bypass validation for placement.
+     *
+     * @returns this (for chaining)
+     */
+    skipValidation(): this;
+    /**
+     * Create the container entity with configured traits.
+     *
+     * @returns The created IFEntity
+     */
+    build(): IFEntity;
+}
+//# sourceMappingURL=container.d.ts.map

package/builders/container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/helpers/src/builders/container.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,QAAQ,EAMT,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD;;;;;;;;;;;;GAYG;AACH,qBAAa,gBAAgB;IASzB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,IAAI;IATd,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,CAAW;IAC5B,OAAO,CAAC,SAAS,CAAC,CAAW;IAC7B,OAAO,CAAC,SAAS,CAAC,CAAuB;IACzC,OAAO,CAAC,SAAS,CAAC,CAAyC;IAC3D,OAAO,CAAC,eAAe,CAAS;gBAGtB,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,MAAM;IAGtB;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK/B;;;;;OAKG;IACH,OAAO,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAKjC;;;;;OAKG;IACH,EAAE,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAK5B;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,IAAI;IAK/C;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,GAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,IAAI;IAKjE;;;;OAIG;IACH,cAAc,IAAI,IAAI;IAKtB;;;;OAIG;IACH,KAAK,IAAI,QAAQ;CA6BlB"}

package/builders/container.js

@@ -0,0 +1,130 @@
+"use strict";
+/**
+ * ContainerBuilder — fluent builder for container entities.
+ *
+ * Public interface: description, aliases, in, openable, lockable,
+ * skipValidation, build.
+ *
+ * Owner context: @sharpee/helpers (ADR-140)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContainerBuilder = void 0;
+const world_model_1 = require("../../world-model/index.js");
+/**
+ * Fluent builder for creating container entities.
+ *
+ * @example
+ * ```typescript
+ * const chest = container('wooden chest')
+ *   .description('A sturdy wooden chest.')
+ *   .openable({ isOpen: false })
+ *   .lockable({ isLocked: true, keyId: key.id })
+ *   .in(treasureRoom)
+ *   .build();
+ * ```
+ */
+class ContainerBuilder {
+    world;
+    name;
+    _description;
+    _aliases;
+    _location;
+    _openable;
+    _lockable;
+    _skipValidation = false;
+    constructor(world, name) {
+        this.world = world;
+        this.name = name;
+    }
+    /**
+     * Set the container description.
+     *
+     * @param desc - Container description text
+     * @returns this (for chaining)
+     */
+    description(desc) {
+        this._description = desc;
+        return this;
+    }
+    /**
+     * Add name aliases.
+     *
+     * @param names - Alternative names
+     * @returns this (for chaining)
+     */
+    aliases(...names) {
+        this._aliases = names;
+        return this;
+    }
+    /**
+     * Place the container in a location.
+     *
+     * @param location - The entity to place this container in
+     * @returns this (for chaining)
+     */
+    in(location) {
+        this._location = location;
+        return this;
+    }
+    /**
+     * Make the container openable.
+     *
+     * @param opts - Openable options
+     * @returns this (for chaining)
+     */
+    openable(opts = {}) {
+        this._openable = opts;
+        return this;
+    }
+    /**
+     * Make the container lockable.
+     *
+     * @param opts - Lockable options
+     * @returns this (for chaining)
+     */
+    lockable(opts = {}) {
+        this._lockable = opts;
+        return this;
+    }
+    /**
+     * Bypass validation for placement.
+     *
+     * @returns this (for chaining)
+     */
+    skipValidation() {
+        this._skipValidation = true;
+        return this;
+    }
+    /**
+     * Create the container entity with configured traits.
+     *
+     * @returns The created IFEntity
+     */
+    build() {
+        const entity = this.world.createEntity(this.name, 'object');
+        entity.add(new world_model_1.IdentityTrait({
+            name: this.name,
+            description: this._description,
+            aliases: this._aliases,
+        }));
+        entity.add(new world_model_1.ContainerTrait());
+        if (this._openable) {
+            entity.add(new world_model_1.OpenableTrait({ isOpen: this._openable.isOpen ?? true }));
+        }
+        if (this._lockable) {
+            entity.add(new world_model_1.LockableTrait({
+                isLocked: this._lockable.isLocked ?? false,
+                ...(this._lockable.keyId ? { requiredKey: this._lockable.keyId } : {}),
+            }));
+        }
+        if (this._location) {
+            const mover = this._skipValidation
+                ? new world_model_1.AuthorModel(this.world.getDataStore(), this.world)
+                : this.world;
+            mover.moveEntity(entity.id, this._location.id);
+        }
+        return entity;
+    }
+}
+exports.ContainerBuilder = ContainerBuilder;
+//# sourceMappingURL=container.js.map

package/builders/container.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/helpers/src/builders/container.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH,sDAO8B;AAG9B;;;;;;;;;;;;GAYG;AACH,MAAa,gBAAgB;IASjB;IACA;IATF,YAAY,CAAU;IACtB,QAAQ,CAAY;IACpB,SAAS,CAAY;IACrB,SAAS,CAAwB;IACjC,SAAS,CAA0C;IACnD,eAAe,GAAG,KAAK,CAAC;IAEhC,YACU,KAAkB,EAClB,IAAY;QADZ,UAAK,GAAL,KAAK,CAAa;QAClB,SAAI,GAAJ,IAAI,CAAQ;IACnB,CAAC;IAEJ;;;;;OAKG;IACH,WAAW,CAAC,IAAY;QACtB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,GAAG,KAAe;QACxB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,EAAE,CAAC,QAAkB;QACnB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,OAA6B,EAAE;QACtC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,OAA+C,EAAE;QACxD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,cAAc;QACZ,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,KAAK;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC5D,MAAM,CAAC,GAAG,CAAC,IAAI,2BAAa,CAAC;YAC3B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,YAAY;YAC9B,OAAO,EAAE,IAAI,CAAC,QAAQ;SACvB,CAAC,CAAC,CAAC;QACJ,MAAM,CAAC,GAAG,CAAC,IAAI,4BAAc,EAAE,CAAC,CAAC;QAEjC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,CAAC,GAAG,CAAC,IAAI,2BAAa,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;QAC3E,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,CAAC,GAAG,CAAC,IAAI,2BAAa,CAAC;gBAC3B,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,IAAI,KAAK;gBAC1C,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACvE,CAAC,CAAC,CAAC;QACN,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe;gBAChC,CAAC,CAAC,IAAI,yBAAW,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC;gBACxD,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;YACf,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACjD,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAhHD,4CAgHC"}

package/builders/door.d.ts

@@ -0,0 +1,85 @@
+/**
+ * DoorBuilder — fluent builder for door entities.
+ *
+ * Public interface: description, aliases, between, openable, lockable, build.
+ *
+ * Owner context: @sharpee/helpers (ADR-140)
+ */
+import { IFEntity } from "../../world-model/index";
+import type { IWorldModel } from "../../world-model/index";
+import type { DirectionType } from "../../world-model/index";
+/**
+ * Fluent builder for creating door entities.
+ *
+ * @example
+ * ```typescript
+ * const ironDoor = door('iron door')
+ *   .description('A heavy iron door.')
+ *   .between(room1, room2, Direction.NORTH)
+ *   .openable({ isOpen: false })
+ *   .lockable({ isLocked: true, keyId: ironKey.id })
+ *   .build();
+ * ```
+ */
+export declare class DoorBuilder {
+    private world;
+    private name;
+    private _description?;
+    private _aliases?;
+    private _room1?;
+    private _room2?;
+    private _direction?;
+    private _openable?;
+    private _lockable?;
+    constructor(world: IWorldModel, name: string);
+    /**
+     * Set the door description.
+     *
+     * @param desc - Door description text
+     * @returns this (for chaining)
+     */
+    description(desc: string): this;
+    /**
+     * Add name aliases.
+     *
+     * @param names - Alternative names
+     * @returns this (for chaining)
+     */
+    aliases(...names: string[]): this;
+    /**
+     * Set the two rooms the door connects and the direction from room1 to room2.
+     *
+     * @param room1 - First room entity
+     * @param room2 - Second room entity
+     * @param direction - Direction from room1 to room2
+     * @returns this (for chaining)
+     */
+    between(room1: IFEntity, room2: IFEntity, direction: DirectionType): this;
+    /**
+     * Make the door openable.
+     *
+     * @param opts - Openable options
+     * @returns this (for chaining)
+     */
+    openable(opts?: {
+        isOpen?: boolean;
+    }): this;
+    /**
+     * Make the door lockable.
+     *
+     * @param opts - Lockable options
+     * @returns this (for chaining)
+     */
+    lockable(opts?: {
+        isLocked?: boolean;
+        keyId?: string;
+    }): this;
+    /**
+     * Create the door entity with configured traits and wire room exits.
+     *
+     * @returns The created IFEntity
+     * @throws Error if between() was not called
+     */
+    build(): IFEntity;
+}
+//# sourceMappingURL=door.d.ts.map

package/builders/door.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"door.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/helpers/src/builders/door.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,QAAQ,EAOT,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;;;;;;;;;;;GAYG;AACH,qBAAa,WAAW;IAUpB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,IAAI;IAVd,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,CAAW;IAC5B,OAAO,CAAC,MAAM,CAAC,CAAW;IAC1B,OAAO,CAAC,MAAM,CAAC,CAAW;IAC1B,OAAO,CAAC,UAAU,CAAC,CAAgB;IACnC,OAAO,CAAC,SAAS,CAAC,CAAuB;IACzC,OAAO,CAAC,SAAS,CAAC,CAAyC;gBAGjD,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,MAAM;IAGtB;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK/B;;;;;OAKG;IACH,OAAO,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAKjC;;;;;;;OAOG;IACH,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,GAAG,IAAI;IAOzE;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,IAAI;IAK/C;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,GAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,IAAI;IAKjE;;;;;OAKG;IACH,KAAK,IAAI,QAAQ;CAmClB"}

package/builders/door.js

@@ -0,0 +1,132 @@
+"use strict";
+/**
+ * DoorBuilder — fluent builder for door entities.
+ *
+ * Public interface: description, aliases, between, openable, lockable, build.
+ *
+ * Owner context: @sharpee/helpers (ADR-140)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DoorBuilder = void 0;
+const world_model_1 = require("../../world-model/index.js");
+const world_model_2 = require("../../world-model/index.js");
+/**
+ * Fluent builder for creating door entities.
+ *
+ * @example
+ * ```typescript
+ * const ironDoor = door('iron door')
+ *   .description('A heavy iron door.')
+ *   .between(room1, room2, Direction.NORTH)
+ *   .openable({ isOpen: false })
+ *   .lockable({ isLocked: true, keyId: ironKey.id })
+ *   .build();
+ * ```
+ */
+class DoorBuilder {
+    world;
+    name;
+    _description;
+    _aliases;
+    _room1;
+    _room2;
+    _direction;
+    _openable;
+    _lockable;
+    constructor(world, name) {
+        this.world = world;
+        this.name = name;
+    }
+    /**
+     * Set the door description.
+     *
+     * @param desc - Door description text
+     * @returns this (for chaining)
+     */
+    description(desc) {
+        this._description = desc;
+        return this;
+    }
+    /**
+     * Add name aliases.
+     *
+     * @param names - Alternative names
+     * @returns this (for chaining)
+     */
+    aliases(...names) {
+        this._aliases = names;
+        return this;
+    }
+    /**
+     * Set the two rooms the door connects and the direction from room1 to room2.
+     *
+     * @param room1 - First room entity
+     * @param room2 - Second room entity
+     * @param direction - Direction from room1 to room2
+     * @returns this (for chaining)
+     */
+    between(room1, room2, direction) {
+        this._room1 = room1;
+        this._room2 = room2;
+        this._direction = direction;
+        return this;
+    }
+    /**
+     * Make the door openable.
+     *
+     * @param opts - Openable options
+     * @returns this (for chaining)
+     */
+    openable(opts = {}) {
+        this._openable = opts;
+        return this;
+    }
+    /**
+     * Make the door lockable.
+     *
+     * @param opts - Lockable options
+     * @returns this (for chaining)
+     */
+    lockable(opts = {}) {
+        this._lockable = opts;
+        return this;
+    }
+    /**
+     * Create the door entity with configured traits and wire room exits.
+     *
+     * @returns The created IFEntity
+     * @throws Error if between() was not called
+     */
+    build() {
+        if (!this._room1 || !this._room2 || !this._direction) {
+            throw new Error('DoorBuilder: .between(room1, room2, direction) is required before .build()');
+        }
+        const entity = this.world.createEntity(this.name, 'door');
+        entity.add(new world_model_1.IdentityTrait({
+            name: this.name,
+            description: this._description,
+            aliases: this._aliases,
+        }));
+        entity.add(new world_model_1.DoorTrait({
+            room1: this._room1.id,
+            room2: this._room2.id,
+        }));
+        entity.add(new world_model_1.SceneryTrait());
+        entity.add(new world_model_1.OpenableTrait({ isOpen: this._openable?.isOpen ?? false }));
+        if (this._lockable) {
+            entity.add(new world_model_1.LockableTrait({
+                isLocked: this._lockable.isLocked ?? true,
+                ...(this._lockable.keyId ? { requiredKey: this._lockable.keyId } : {}),
+            }));
+        }
+        // Wire exits through the door
+        const opposite = (0, world_model_2.getOppositeDirection)(this._direction);
+        world_model_1.RoomBehavior.setExit(this._room1, this._direction, this._room2.id, entity.id);
+        world_model_1.RoomBehavior.setExit(this._room2, opposite, this._room1.id, entity.id);
+        // Place door in room1 for scope resolution
+        this.world.moveEntity(entity.id, this._room1.id);
+        return entity;
+    }
+}
+exports.DoorBuilder = DoorBuilder;
+//# sourceMappingURL=door.js.map

package/builders/door.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"door.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/helpers/src/builders/door.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,sDAQ8B;AAE9B,sDAA4D;AAG5D;;;;;;;;;;;;GAYG;AACH,MAAa,WAAW;IAUZ;IACA;IAVF,YAAY,CAAU;IACtB,QAAQ,CAAY;IACpB,MAAM,CAAY;IAClB,MAAM,CAAY;IAClB,UAAU,CAAiB;IAC3B,SAAS,CAAwB;IACjC,SAAS,CAA0C;IAE3D,YACU,KAAkB,EAClB,IAAY;QADZ,UAAK,GAAL,KAAK,CAAa;QAClB,SAAI,GAAJ,IAAI,CAAQ;IACnB,CAAC;IAEJ;;;;;OAKG;IACH,WAAW,CAAC,IAAY;QACtB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,GAAG,KAAe;QACxB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;OAOG;IACH,OAAO,CAAC,KAAe,EAAE,KAAe,EAAE,SAAwB;QAChE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,OAA6B,EAAE;QACtC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,OAA+C,EAAE;QACxD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,4EAA4E,CAAC,CAAC;QAChG,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC1D,MAAM,CAAC,GAAG,CAAC,IAAI,2BAAa,CAAC;YAC3B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,YAAY;YAC9B,OAAO,EAAE,IAAI,CAAC,QAAQ;SACvB,CAAC,CAAC,CAAC;QACJ,MAAM,CAAC,GAAG,CAAC,IAAI,uBAAS,CAAC;YACvB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE;YACrB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE;SACtB,CAAC,CAAC,CAAC;QACJ,MAAM,CAAC,GAAG,CAAC,IAAI,0BAAY,EAAE,CAAC,CAAC;QAC/B,MAAM,CAAC,GAAG,CAAC,IAAI,2BAAa,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC;QAE3E,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,CAAC,GAAG,CAAC,IAAI,2BAAa,CAAC;gBAC3B,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,IAAI,IAAI;gBACzC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACvE,CAAC,CAAC,CAAC;QACN,CAAC;QAED,8BAA8B;QAC9B,MAAM,QAAQ,GAAG,IAAA,kCAAoB,EAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACvD,0BAAY,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QAC9E,0BAAY,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QAEvE,2CAA2C;QAC3C,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAEjD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAlHD,kCAkHC"}

package/builders/object.d.ts

@@ -0,0 +1,84 @@
+/**
+ * ObjectBuilder — fluent builder for object entities.
+ *
+ * Public interface: description, aliases, in, scenery, lightSource,
+ * skipValidation, build.
+ *
+ * Owner context: @sharpee/helpers (ADR-140)
+ */
+import { IFEntity } from "../../world-model/index";
+import type { IWorldModel } from "../../world-model/index";
+/**
+ * Fluent builder for creating object entities.
+ *
+ * @example
+ * ```typescript
+ * const knife = object('bread knife')
+ *   .description('A sharp bread knife.')
+ *   .aliases('knife', 'blade')
+ *   .in(kitchen)
+ *   .build();
+ * ```
+ */
+export declare class ObjectBuilder {
+    private world;
+    private name;
+    private _description?;
+    private _aliases?;
+    private _location?;
+    private _scenery;
+    private _lightSource?;
+    private _skipValidation;
+    constructor(world: IWorldModel, name: string);
+    /**
+     * Set the object description.
+     *
+     * @param desc - Object description text
+     * @returns this (for chaining)
+     */
+    description(desc: string): this;
+    /**
+     * Add name aliases for the object.
+     *
+     * @param names - Alternative names
+     * @returns this (for chaining)
+     */
+    aliases(...names: string[]): this;
+    /**
+     * Place the object in a location.
+     *
+     * @param location - The entity to place this object in
+     * @returns this (for chaining)
+     */
+    in(location: IFEntity): this;
+    /**
+     * Mark as scenery (non-portable).
+     *
+     * @returns this (for chaining)
+     */
+    scenery(): this;
+    /**
+     * Add light source trait.
+     *
+     * @param opts - Light source options
+     * @returns this (for chaining)
+     */
+    lightSource(opts?: {
+        isLit?: boolean;
+        fuelTurns?: number;
+    }): this;
+    /**
+     * Bypass validation for placement (e.g., placing in closed containers).
+     * Internally wraps the world in an AuthorModel.
+     *
+     * @returns this (for chaining)
+     */
+    skipValidation(): this;
+    /**
+     * Create the object entity with configured traits.
+     *
+     * @returns The created IFEntity
+     */
+    build(): IFEntity;
+}
+//# sourceMappingURL=object.d.ts.map

package/builders/object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/helpers/src/builders/object.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,QAAQ,EAKT,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD;;;;;;;;;;;GAWG;AACH,qBAAa,aAAa;IAStB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,IAAI;IATd,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,CAAW;IAC5B,OAAO,CAAC,SAAS,CAAC,CAAW;IAC7B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAAC,CAA0C;IAC/D,OAAO,CAAC,eAAe,CAAS;gBAGtB,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,MAAM;IAGtB;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK/B;;;;;OAKG;IACH,OAAO,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAKjC;;;;;OAKG;IACH,EAAE,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAK5B;;;;OAIG;IACH,OAAO,IAAI,IAAI;IAKf;;;;;OAKG;IACH,WAAW,CAAC,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,IAAI;IAKrE;;;;;OAKG;IACH,cAAc,IAAI,IAAI;IAKtB;;;;OAIG;IACH,KAAK,IAAI,QAAQ;CAyBlB"}

package/builders/object.js

@@ -0,0 +1,125 @@
+"use strict";
+/**
+ * ObjectBuilder — fluent builder for object entities.
+ *
+ * Public interface: description, aliases, in, scenery, lightSource,
+ * skipValidation, build.
+ *
+ * Owner context: @sharpee/helpers (ADR-140)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObjectBuilder = void 0;
+const world_model_1 = require("../../world-model/index.js");
+/**
+ * Fluent builder for creating object entities.
+ *
+ * @example
+ * ```typescript
+ * const knife = object('bread knife')
+ *   .description('A sharp bread knife.')
+ *   .aliases('knife', 'blade')
+ *   .in(kitchen)
+ *   .build();
+ * ```
+ */
+class ObjectBuilder {
+    world;
+    name;
+    _description;
+    _aliases;
+    _location;
+    _scenery = false;
+    _lightSource;
+    _skipValidation = false;
+    constructor(world, name) {
+        this.world = world;
+        this.name = name;
+    }
+    /**
+     * Set the object description.
+     *
+     * @param desc - Object description text
+     * @returns this (for chaining)
+     */
+    description(desc) {
+        this._description = desc;
+        return this;
+    }
+    /**
+     * Add name aliases for the object.
+     *
+     * @param names - Alternative names
+     * @returns this (for chaining)
+     */
+    aliases(...names) {
+        this._aliases = names;
+        return this;
+    }
+    /**
+     * Place the object in a location.
+     *
+     * @param location - The entity to place this object in
+     * @returns this (for chaining)
+     */
+    in(location) {
+        this._location = location;
+        return this;
+    }
+    /**
+     * Mark as scenery (non-portable).
+     *
+     * @returns this (for chaining)
+     */
+    scenery() {
+        this._scenery = true;
+        return this;
+    }
+    /**
+     * Add light source trait.
+     *
+     * @param opts - Light source options
+     * @returns this (for chaining)
+     */
+    lightSource(opts = {}) {
+        this._lightSource = opts;
+        return this;
+    }
+    /**
+     * Bypass validation for placement (e.g., placing in closed containers).
+     * Internally wraps the world in an AuthorModel.
+     *
+     * @returns this (for chaining)
+     */
+    skipValidation() {
+        this._skipValidation = true;
+        return this;
+    }
+    /**
+     * Create the object entity with configured traits.
+     *
+     * @returns The created IFEntity
+     */
+    build() {
+        const entity = this.world.createEntity(this.name, 'object');
+        entity.add(new world_model_1.IdentityTrait({
+            name: this.name,
+            description: this._description,
+            aliases: this._aliases,
+        }));
+        if (this._scenery) {
+            entity.add(new world_model_1.SceneryTrait());
+        }
+        if (this._lightSource) {
+            entity.add(new world_model_1.LightSourceTrait(this._lightSource));
+        }
+        if (this._location) {
+            const mover = this._skipValidation
+                ? new world_model_1.AuthorModel(this.world.getDataStore(), this.world)
+                : this.world;
+            mover.moveEntity(entity.id, this._location.id);
+        }
+        return entity;
+    }
+}
+exports.ObjectBuilder = ObjectBuilder;
+//# sourceMappingURL=object.js.map

package/builders/object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/helpers/src/builders/object.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH,sDAM8B;AAG9B;;;;;;;;;;;GAWG;AACH,MAAa,aAAa;IASd;IACA;IATF,YAAY,CAAU;IACtB,QAAQ,CAAY;IACpB,SAAS,CAAY;IACrB,QAAQ,GAAG,KAAK,CAAC;IACjB,YAAY,CAA2C;IACvD,eAAe,GAAG,KAAK,CAAC;IAEhC,YACU,KAAkB,EAClB,IAAY;QADZ,UAAK,GAAL,KAAK,CAAa;QAClB,SAAI,GAAJ,IAAI,CAAQ;IACnB,CAAC;IAEJ;;;;;OAKG;IACH,WAAW,CAAC,IAAY;QACtB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,GAAG,KAAe;QACxB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,EAAE,CAAC,QAAkB;QACnB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,OAAO;QACL,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,WAAW,CAAC,OAAgD,EAAE;QAC5D,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,cAAc;QACZ,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,KAAK;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC5D,MAAM,CAAC,GAAG,CAAC,IAAI,2BAAa,CAAC;YAC3B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,YAAY;YAC9B,OAAO,EAAE,IAAI,CAAC,QAAQ;SACvB,CAAC,CAAC,CAAC;QAEJ,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,CAAC,GAAG,CAAC,IAAI,0BAAY,EAAE,CAAC,CAAC;QACjC,CAAC;QAED,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,MAAM,CAAC,GAAG,CAAC,IAAI,8BAAgB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;QACtD,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe;gBAChC,CAAC,CAAC,IAAI,yBAAW,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC;gBACxD,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;YACf,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACjD,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AA5GD,sCA4GC"}

package/builders/room.d.ts

@@ -0,0 +1,54 @@
+/**
+ * RoomBuilder — fluent builder for room entities.
+ *
+ * Public interface: description, aliases, dark, build.
+ *
+ * Owner context: @sharpee/helpers (ADR-140)
+ */
+import { IFEntity } from "../../world-model/index";
+import type { IWorldModel } from "../../world-model/index";
+/**
+ * Fluent builder for creating room entities.
+ *
+ * @example
+ * ```typescript
+ * const kitchen = room('Kitchen')
+ *   .description('A warm kitchen.')
+ *   .build();
+ * ```
+ */
+export declare class RoomBuilder {
+    private world;
+    private name;
+    private _description?;
+    private _aliases?;
+    private _isDark;
+    constructor(world: IWorldModel, name: string);
+    /**
+     * Set the room description.
+     *
+     * @param desc - Room description text
+     * @returns this (for chaining)
+     */
+    description(desc: string): this;
+    /**
+     * Add name aliases for the room.
+     *
+     * @param names - Alternative names
+     * @returns this (for chaining)
+     */
+    aliases(...names: string[]): this;
+    /**
+     * Mark the room as dark (requires a light source to see).
+     *
+     * @returns this (for chaining)
+     */
+    dark(): this;
+    /**
+     * Create the room entity with configured traits.
+     *
+     * @returns The created IFEntity
+     */
+    build(): IFEntity;
+}
+//# sourceMappingURL=room.d.ts.map

package/builders/room.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"room.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/helpers/src/builders/room.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,QAAQ,EAGT,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD;;;;;;;;;GASG;AACH,qBAAa,WAAW;IAMpB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,IAAI;IANd,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,CAAW;IAC5B,OAAO,CAAC,OAAO,CAAS;gBAGd,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,MAAM;IAGtB;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK/B;;;;;OAKG;IACH,OAAO,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAKjC;;;;OAIG;IACH,IAAI,IAAI,IAAI;IAKZ;;;;OAIG;IACH,KAAK,IAAI,QAAQ;CAUlB"}

package/builders/room.js

@@ -0,0 +1,78 @@
+"use strict";
+/**
+ * RoomBuilder — fluent builder for room entities.
+ *
+ * Public interface: description, aliases, dark, build.
+ *
+ * Owner context: @sharpee/helpers (ADR-140)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RoomBuilder = void 0;
+const world_model_1 = require("../../world-model/index.js");
+/**
+ * Fluent builder for creating room entities.
+ *
+ * @example
+ * ```typescript
+ * const kitchen = room('Kitchen')
+ *   .description('A warm kitchen.')
+ *   .build();
+ * ```
+ */
+class RoomBuilder {
+    world;
+    name;
+    _description;
+    _aliases;
+    _isDark = false;
+    constructor(world, name) {
+        this.world = world;
+        this.name = name;
+    }
+    /**
+     * Set the room description.
+     *
+     * @param desc - Room description text
+     * @returns this (for chaining)
+     */
+    description(desc) {
+        this._description = desc;
+        return this;
+    }
+    /**
+     * Add name aliases for the room.
+     *
+     * @param names - Alternative names
+     * @returns this (for chaining)
+     */
+    aliases(...names) {
+        this._aliases = names;
+        return this;
+    }
+    /**
+     * Mark the room as dark (requires a light source to see).
+     *
+     * @returns this (for chaining)
+     */
+    dark() {
+        this._isDark = true;
+        return this;
+    }
+    /**
+     * Create the room entity with configured traits.
+     *
+     * @returns The created IFEntity
+     */
+    build() {
+        const entity = this.world.createEntity(this.name, 'room');
+        entity.add(new world_model_1.RoomTrait({ isDark: this._isDark }));
+        entity.add(new world_model_1.IdentityTrait({
+            name: this.name,
+            description: this._description,
+            aliases: this._aliases,
+        }));
+        return entity;
+    }
+}
+exports.RoomBuilder = RoomBuilder;
+//# sourceMappingURL=room.js.map

package/builders/room.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"room.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/helpers/src/builders/room.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,sDAI8B;AAG9B;;;;;;;;;GASG;AACH,MAAa,WAAW;IAMZ;IACA;IANF,YAAY,CAAU;IACtB,QAAQ,CAAY;IACpB,OAAO,GAAG,KAAK,CAAC;IAExB,YACU,KAAkB,EAClB,IAAY;QADZ,UAAK,GAAL,KAAK,CAAa;QAClB,SAAI,GAAJ,IAAI,CAAQ;IACnB,CAAC;IAEJ;;;;;OAKG;IACH,WAAW,CAAC,IAAY;QACtB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,GAAG,KAAe;QACxB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,IAAI;QACF,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,KAAK;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC1D,MAAM,CAAC,GAAG,CAAC,IAAI,uBAAS,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACpD,MAAM,CAAC,GAAG,CAAC,IAAI,2BAAa,CAAC;YAC3B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,YAAY;YAC9B,OAAO,EAAE,IAAI,CAAC,QAAQ;SACvB,CAAC,CAAC,CAAC;QACJ,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAzDD,kCAyDC"}

package/create-helpers.d.ts

@@ -0,0 +1,37 @@
+/**
+ * createHelpers — factory that binds a world reference and returns
+ * all entity builder functions.
+ *
+ * Public interface: createHelpers(world) => EntityHelpers
+ *
+ * Owner context: @sharpee/helpers (ADR-140)
+ */
+import type { IWorldModel } from "../world-model/index";
+import { RoomBuilder } from './builders/room';
+import { ObjectBuilder } from './builders/object';
+import { ContainerBuilder } from './builders/container';
+import { ActorBuilder } from './builders/actor';
+import { DoorBuilder } from './builders/door';
+/**
+ * The set of builder factories returned by world.helpers().
+ */
+export interface EntityHelpers {
+    /** Create a room entity */
+    room(name: string): RoomBuilder;
+    /** Create an object entity */
+    object(name: string): ObjectBuilder;
+    /** Create a container entity */
+    container(name: string): ContainerBuilder;
+    /** Create an actor entity (player or NPC) */
+    actor(name: string): ActorBuilder;
+    /** Create a door entity */
+    door(name: string): DoorBuilder;
+}
+/**
+ * Create a set of entity builder functions bound to a world reference.
+ *
+ * @param world - The IWorldModel to create entities in
+ * @returns EntityHelpers with all builder factories
+ */
+export declare function createHelpers(world: IWorldModel): EntityHelpers;
+//# sourceMappingURL=create-helpers.d.ts.map

package/create-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-helpers.d.ts","sourceRoot":"","sources":["../../../../../repos/sharpee/packages/helpers/src/create-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,2BAA2B;IAC3B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAChC,8BAA8B;IAC9B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAAC;IACpC,gCAAgC;IAChC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAC1C,6CAA6C;IAC7C,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAAC;IAClC,2BAA2B;IAC3B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;CACjC;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,aAAa,CAQ/D"}

package/create-helpers.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * createHelpers — factory that binds a world reference and returns
+ * all entity builder functions.
+ *
+ * Public interface: createHelpers(world) => EntityHelpers
+ *
+ * Owner context: @sharpee/helpers (ADR-140)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createHelpers = createHelpers;
+const room_1 = require("./builders/room");
+const object_1 = require("./builders/object");
+const container_1 = require("./builders/container");
+const actor_1 = require("./builders/actor");
+const door_1 = require("./builders/door");
+/**
+ * Create a set of entity builder functions bound to a world reference.
+ *
+ * @param world - The IWorldModel to create entities in
+ * @returns EntityHelpers with all builder factories
+ */
+function createHelpers(world) {
+    return {
+        room: (name) => new room_1.RoomBuilder(world, name),
+        object: (name) => new object_1.ObjectBuilder(world, name),
+        container: (name) => new container_1.ContainerBuilder(world, name),
+        actor: (name) => new actor_1.ActorBuilder(world, name),
+        door: (name) => new door_1.DoorBuilder(world, name),
+    };
+}
+//# sourceMappingURL=create-helpers.js.map

package/create-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-helpers.js","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/helpers/src/create-helpers.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AA+BH,sCAQC;AApCD,0CAA8C;AAC9C,8CAAkD;AAClD,oDAAwD;AACxD,4CAAgD;AAChD,0CAA8C;AAkB9C;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,KAAkB;IAC9C,OAAO;QACL,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,kBAAW,CAAC,KAAK,EAAE,IAAI,CAAC;QACpD,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,sBAAa,CAAC,KAAK,EAAE,IAAI,CAAC;QACxD,SAAS,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,4BAAgB,CAAC,KAAK,EAAE,IAAI,CAAC;QAC9D,KAAK,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,oBAAY,CAAC,KAAK,EAAE,IAAI,CAAC;QACtD,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,kBAAW,CAAC,KAAK,EAAE,IAAI,CAAC;KACrD,CAAC;AACJ,CAAC"}

package/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @sharpee/helpers — Fluent entity builder helpers for the Sharpee IF platform.
+ *
+ * Public interface: Importing this module activates world.helpers() via
+ * declaration merging on IWorldModel. Also exports createHelpers() and
+ * EntityHelpers for direct use.
+ *
+ * Owner context: @sharpee/helpers (ADR-140)
+ *
+ * @example
+ * ```typescript
+ * import '@sharpee/helpers';
+ *
+ * initializeWorld(world: WorldModel): void {
+ *   const { room, object, actor } = world.helpers();
+ *
+ *   const kitchen = room('Kitchen')
+ *     .description('A warm kitchen.')
+ *     .build();
+ * }
+ * ```
+ */
+import './augment';
+export { createHelpers, EntityHelpers } from './create-helpers';
+export { RoomBuilder } from './builders/room';
+export { ObjectBuilder } from './builders/object';
+export { ContainerBuilder } from './builders/container';
+export { ActorBuilder } from './builders/actor';
+export { DoorBuilder } from './builders/door';
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../repos/sharpee/packages/helpers/src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,WAAW,CAAC;AAGnB,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC"}

package/index.js

@@ -0,0 +1,41 @@
+"use strict";
+/**
+ * @sharpee/helpers — Fluent entity builder helpers for the Sharpee IF platform.
+ *
+ * Public interface: Importing this module activates world.helpers() via
+ * declaration merging on IWorldModel. Also exports createHelpers() and
+ * EntityHelpers for direct use.
+ *
+ * Owner context: @sharpee/helpers (ADR-140)
+ *
+ * @example
+ * ```typescript
+ * import "./index.js";
+ *
+ * initializeWorld(world: WorldModel): void {
+ *   const { room, object, actor } = world.helpers();
+ *
+ *   const kitchen = room('Kitchen')
+ *     .description('A warm kitchen.')
+ *     .build();
+ * }
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DoorBuilder = exports.ActorBuilder = exports.ContainerBuilder = exports.ObjectBuilder = exports.RoomBuilder = exports.createHelpers = void 0;
+// Side-effect import: patches WorldModel.prototype.helpers
+require("./augment");
+// Named exports for direct use
+var create_helpers_1 = require("./create-helpers");
+Object.defineProperty(exports, "createHelpers", { enumerable: true, get: function () { return create_helpers_1.createHelpers; } });
+var room_1 = require("./builders/room");
+Object.defineProperty(exports, "RoomBuilder", { enumerable: true, get: function () { return room_1.RoomBuilder; } });
+var object_1 = require("./builders/object");
+Object.defineProperty(exports, "ObjectBuilder", { enumerable: true, get: function () { return object_1.ObjectBuilder; } });
+var container_1 = require("./builders/container");
+Object.defineProperty(exports, "ContainerBuilder", { enumerable: true, get: function () { return container_1.ContainerBuilder; } });
+var actor_1 = require("./builders/actor");
+Object.defineProperty(exports, "ActorBuilder", { enumerable: true, get: function () { return actor_1.ActorBuilder; } });
+var door_1 = require("./builders/door");
+Object.defineProperty(exports, "DoorBuilder", { enumerable: true, get: function () { return door_1.DoorBuilder; } });
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/helpers/src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;AAEH,2DAA2D;AAC3D,qBAAmB;AAEnB,+BAA+B;AAC/B,mDAAgE;AAAvD,+GAAA,aAAa,OAAA;AACtB,wCAA8C;AAArC,mGAAA,WAAW,OAAA;AACpB,4CAAkD;AAAzC,uGAAA,aAAa,OAAA;AACtB,kDAAwD;AAA/C,6GAAA,gBAAgB,OAAA;AACzB,0CAAgD;AAAvC,qGAAA,YAAY,OAAA;AACrB,wCAA8C;AAArC,mGAAA,WAAW,OAAA"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@sharpee/helpers",
+  "version": "0.9.103",
+  "description": "Fluent entity builder helpers for Sharpee Interactive Fiction Platform",
+  "main": "./index.js",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "require": "./index.js",
+      "default": "./index.js"
+    }
+  },
+  "dependencies": {
+    "@sharpee/world-model": "^0.9.103"
+  },
+  "keywords": [
+    "interactive-fiction",
+    "if",
+    "text-adventure",
+    "sharpee",
+    "helpers",
+    "builders"
+  ],
+  "author": "Sharpee Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ChicagoDave/sharpee.git",
+    "directory": "packages/helpers"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}