@sharpee/world-model 0.9.111 → 1.0.0

package/world/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/world-model/src/world/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,UAAU,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,eAAe,EACf,WAAW,EACX,YAAY,EACZ,cAAc,EACd,cAAc,EAEd,iBAAiB,EACjB,iBAAiB,EAEjB,UAAU,EAEV,aAAa,EACb,eAAe,EAEf,YAAY,EACZ,eAAe,EAChB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,EACzB,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAGnE,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EACvB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/world-model/src/world/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,UAAU,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,eAAe,EACf,WAAW,EACX,YAAY,EACZ,cAAc,EACd,cAAc,EAEd,iBAAiB,EACjB,iBAAiB,EAEjB,UAAU,EAEV,aAAa,EACb,eAAe,EAEf,YAAY,EACZ,eAAe,EAChB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,EACzB,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAGnE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC1D,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAG9D,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EACvB,MAAM,gBAAgB,CAAC"}

package/world/index.js

@@ -1,7 +1,7 @@
 "use strict";
 // index.ts - World model exports
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.StandardCapabilities = exports.AuthorModel = exports.VisibilityBehavior = exports.SpatialIndex = exports.GrammarVocabularyProvider = exports.WorldModel = void 0;
+exports.StandardCapabilities = exports.validateWallSpec = exports.createWalls = exports.createWall = exports.AuthorModel = exports.VisibilityBehavior = exports.SpatialIndex = exports.GrammarVocabularyProvider = exports.WorldModel = void 0;
 // Export all types and the WorldModel interface/class from the same file
 var WorldModel_1 = require("./WorldModel");
 Object.defineProperty(exports, "WorldModel", { enumerable: true, get: function () { return WorldModel_1.WorldModel; } });
@@ -15,6 +15,12 @@ var VisibilityBehavior_1 = require("./VisibilityBehavior");
 Object.defineProperty(exports, "VisibilityBehavior", { enumerable: true, get: function () { return VisibilityBehavior_1.VisibilityBehavior; } });
 var AuthorModel_1 = require("./AuthorModel");
 Object.defineProperty(exports, "AuthorModel", { enumerable: true, get: function () { return AuthorModel_1.AuthorModel; } });
+// Wall Adjacency (ADR-173)
+var wall_creation_1 = require("./wall-creation");
+Object.defineProperty(exports, "createWall", { enumerable: true, get: function () { return wall_creation_1.createWall; } });
+Object.defineProperty(exports, "createWalls", { enumerable: true, get: function () { return wall_creation_1.createWalls; } });
+var wall_validation_1 = require("./wall-validation");
+Object.defineProperty(exports, "validateWallSpec", { enumerable: true, get: function () { return wall_validation_1.validateWallSpec; } });
 // Export capability types
 var capabilities_1 = require("./capabilities");
 Object.defineProperty(exports, "StandardCapabilities", { enumerable: true, get: function () { return capabilities_1.StandardCapabilities; } });

package/world/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/world-model/src/world/index.ts"],"names":[],"mappings":";AAAA,iCAAiC;;;AAEjC,yEAAyE;AACzE,2CAqBsB;AApBpB,wGAAA,UAAU,OAAA;AAsBZ,oEAAoE;AACpE,gDAK4B;AAH1B,sHAAA,yBAAyB,OAAA;AAK3B,uBAAuB;AACvB,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AACrB,2DAA0D;AAAjD,wHAAA,kBAAkB,OAAA;AAC3B,6CAAmE;AAA1D,0GAAA,WAAW,OAAA;AAEpB,0BAA0B;AAC1B,+CAOwB;AAFtB,oHAAA,oBAAoB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/world-model/src/world/index.ts"],"names":[],"mappings":";AAAA,iCAAiC;;;AAEjC,yEAAyE;AACzE,2CAqBsB;AApBpB,wGAAA,UAAU,OAAA;AAsBZ,oEAAoE;AACpE,gDAK4B;AAH1B,sHAAA,yBAAyB,OAAA;AAK3B,uBAAuB;AACvB,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AACrB,2DAA0D;AAAjD,wHAAA,kBAAkB,OAAA;AAC3B,6CAAmE;AAA1D,0GAAA,WAAW,OAAA;AAEpB,2BAA2B;AAC3B,iDAA0D;AAAjD,2GAAA,UAAU,OAAA;AAAE,4GAAA,WAAW,OAAA;AAEhC,qDAAqD;AAA5C,mHAAA,gBAAgB,OAAA;AAGzB,0BAA0B;AAC1B,+CAOwB;AAFtB,oHAAA,oBAAoB,OAAA"}

package/world/wall-creation.d.ts

@@ -0,0 +1,38 @@
+import { IFEntity } from '../entities/if-entity';
+import { WallEntity, IWallSpec, IWallsSpec } from '../entities/wall-entity';
+/**
+ * The narrow world surface required for wall creation. Implemented by
+ * `WorldModel`; not part of the public IWorldModel interface.
+ */
+export interface IWallCreationWorld {
+    getEntity(id: string): IFEntity | undefined;
+    getLocation(entityId: string): string | undefined;
+    generateWallId(): string;
+    registerWall(wall: WallEntity): void;
+}
+/**
+ * Creates a single wall between exactly two distinct rooms (ADR-173).
+ *
+ * Validates the spec (cardinality, per-side adjectives, per-room
+ * adjective uniqueness, obstructor resolution), builds a `WallEntity`
+ * carrying any whole-wall traits and per-side data, registers it in
+ * the world, and pushes its id into both rooms' `RoomTrait.walls`
+ * collections.
+ *
+ * @throws Error on any validation failure (see `validateWallSpec`).
+ */
+export declare function createWall(world: IWallCreationWorld, spec: IWallSpec): WallEntity;
+/**
+ * Convenience helper that fans out into N walls between `from` and
+ * each room in `to` (ADR-173 §Authoring API). Each underlying wall is
+ * created with the supplied whole-wall traits (cloned per call to
+ * avoid sharing trait instances across walls) and per-side data
+ * produced by the `sides` callback.
+ *
+ * Walls are created sequentially. If validation fails on the K-th
+ * pair, walls 0..K-1 are already in the world — author is expected
+ * to fix the offending pair and re-run only the bad declaration, in
+ * keeping with ADR-173's load-time-failure model.
+ */
+export declare function createWalls(world: IWallCreationWorld, spec: IWallsSpec): WallEntity[];
+//# sourceMappingURL=wall-creation.d.ts.map

package/world/wall-creation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wall-creation.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/world-model/src/world/wall-creation.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EACL,UAAU,EACV,SAAS,EACT,UAAU,EAEX,MAAM,yBAAyB,CAAC;AAMjC;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC5C,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAClD,cAAc,IAAI,MAAM,CAAC;IACzB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;CACtC;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,kBAAkB,EACzB,IAAI,EAAE,SAAS,GACd,UAAU,CAkCZ;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,kBAAkB,EACzB,IAAI,EAAE,UAAU,GACf,UAAU,EAAE,CAoBd"}

package/world/wall-creation.js

@@ -0,0 +1,98 @@
+"use strict";
+// packages/world-model/src/world/wall-creation.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWall = createWall;
+exports.createWalls = createWalls;
+const wall_entity_1 = require("../entities/wall-entity");
+const trait_types_1 = require("../traits/trait-types");
+const wall_validation_1 = require("./wall-validation");
+function refToId(ref) {
+    return typeof ref === 'string' ? ref : ref.id;
+}
+/**
+ * Creates a single wall between exactly two distinct rooms (ADR-173).
+ *
+ * Validates the spec (cardinality, per-side adjectives, per-room
+ * adjective uniqueness, obstructor resolution), builds a `WallEntity`
+ * carrying any whole-wall traits and per-side data, registers it in
+ * the world, and pushes its id into both rooms' `RoomTrait.walls`
+ * collections.
+ *
+ * @throws Error on any validation failure (see `validateWallSpec`).
+ */
+function createWall(world, spec) {
+    const { roomAId, roomBId, roomA, roomB } = (0, wall_validation_1.validateWallSpec)(spec, world);
+    const wallId = world.generateWallId();
+    const wall = new wall_entity_1.WallEntity(wallId, [roomAId, roomBId], {
+        attributes: {
+            displayName: 'wall',
+            name: 'wall',
+            entityType: 'wall',
+        },
+    });
+    if (spec.whole) {
+        for (const trait of spec.whole) {
+            wall.add(trait);
+        }
+    }
+    wall.sides.set(roomAId, { ...spec.sides[roomAId] });
+    wall.sides.set(roomBId, { ...spec.sides[roomBId] });
+    // ADR-173 Phase 3 — make the wall reachable for parser/validator scope from
+    // either connecting room. Walls have no spatial containment, so the default
+    // scope rules (room contents + the room itself) do not include them. Numeric
+    // 2 corresponds to ScopeLevel.VISIBLE (see if-entity.ts setMinimumScope).
+    wall.setMinimumScope(2, [roomAId, roomBId]);
+    world.registerWall(wall);
+    pushWallId(roomA, wallId);
+    pushWallId(roomB, wallId);
+    return wall;
+}
+/**
+ * Convenience helper that fans out into N walls between `from` and
+ * each room in `to` (ADR-173 §Authoring API). Each underlying wall is
+ * created with the supplied whole-wall traits (cloned per call to
+ * avoid sharing trait instances across walls) and per-side data
+ * produced by the `sides` callback.
+ *
+ * Walls are created sequentially. If validation fails on the K-th
+ * pair, walls 0..K-1 are already in the world — author is expected
+ * to fix the offending pair and re-run only the bad declaration, in
+ * keeping with ADR-173's load-time-failure model.
+ */
+function createWalls(world, spec) {
+    const fromId = refToId(spec.from);
+    const walls = [];
+    for (const toRef of spec.to) {
+        const toId = refToId(toRef);
+        const sides = {
+            [fromId]: spec.sides(fromId),
+            [toId]: spec.sides(toId),
+        };
+        const whole = spec.whole ? cloneTraits(spec.whole) : undefined;
+        const wall = createWall(world, {
+            between: [fromId, toId],
+            whole,
+            sides,
+        });
+        walls.push(wall);
+    }
+    return walls;
+}
+function pushWallId(room, wallId) {
+    const trait = room.get(trait_types_1.TraitType.ROOM);
+    if (!trait) {
+        throw new Error(`wall-creation: room '${room.id}' lost its RoomTrait between validation and mutation`);
+    }
+    if (!trait.walls) {
+        trait.walls = [];
+    }
+    trait.walls.push(wallId);
+}
+function cloneTraits(traits) {
+    return traits.map((t) => {
+        const proto = Object.getPrototypeOf(t);
+        const copy = Object.assign(Object.create(proto), t);
+        return copy;
+    });
+}
+//# sourceMappingURL=wall-creation.js.map

package/world/wall-creation.js.map

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

package/world/wall-validation.d.ts

@@ -0,0 +1,45 @@
+/**
+ * World-load validation for wall specifications (ADR-173).
+ *
+ * Implements the Rejection rules from ADR-173 §"Rejection rules":
+ * cardinality (exactly two distinct rooms), per-side adjective
+ * presence/non-emptiness, per-room adjective uniqueness, and
+ * `obstructedBy` resolution against the world's current entity map.
+ *
+ * Public interface: `validateWallSpec`. Pure validation — no mutation.
+ * Throws `Error` with a descriptive message on the first violation
+ * detected; never returns a structured error object (the validator is
+ * a precondition gate at the createWall boundary, not a recoverable
+ * subsystem).
+ *
+ * Owner context: `@sharpee/world-model` — world / spatial primitives.
+ */
+import { EntityId } from "../../core/index";
+import { IFEntity } from '../entities/if-entity';
+import { IWallSpec } from '../entities/wall-entity';
+/**
+ * Read-only world surface this validator depends on. Limited to the
+ * methods required so the validator can be invoked from tests with a
+ * minimal stand-in if desired (and so it does not creep into mutation
+ * APIs by accident).
+ */
+export interface IWallValidationWorld {
+    getEntity(id: string): IFEntity | undefined;
+    getLocation(entityId: string): string | undefined;
+}
+/**
+ * Validates a wall specification before mutation.
+ *
+ * @param spec - The author-supplied wall specification.
+ * @param world - Read-only view of the world for entity/location lookups.
+ * @throws Error if cardinality, adjective presence, per-room adjective
+ *   uniqueness, or `obstructedBy` resolution fails. The first failure
+ *   detected aborts validation; no partial state escapes.
+ */
+export declare function validateWallSpec(spec: IWallSpec, world: IWallValidationWorld): {
+    roomAId: EntityId;
+    roomBId: EntityId;
+    roomA: IFEntity;
+    roomB: IFEntity;
+};
+//# sourceMappingURL=wall-validation.d.ts.map

package/world/wall-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wall-validation.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/world-model/src/world/wall-validation.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAiB,MAAM,yBAAyB,CAAC;AAWnE;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC5C,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACnD;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,SAAS,EACf,KAAK,EAAE,oBAAoB,GAC1B;IAAE,OAAO,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,CAsD5E"}

package/world/wall-validation.js

@@ -0,0 +1,98 @@
+"use strict";
+// packages/world-model/src/world/wall-validation.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateWallSpec = validateWallSpec;
+const trait_types_1 = require("../traits/trait-types");
+/**
+ * Resolves an `IFEntity | EntityId` reference to its id string.
+ */
+function refToId(ref) {
+    return typeof ref === 'string' ? ref : ref.id;
+}
+/**
+ * Validates a wall specification before mutation.
+ *
+ * @param spec - The author-supplied wall specification.
+ * @param world - Read-only view of the world for entity/location lookups.
+ * @throws Error if cardinality, adjective presence, per-room adjective
+ *   uniqueness, or `obstructedBy` resolution fails. The first failure
+ *   detected aborts validation; no partial state escapes.
+ */
+function validateWallSpec(spec, world) {
+    if (!Array.isArray(spec.between)) {
+        throw new Error('createWall: `between` must be a tuple of exactly two rooms');
+    }
+    if (spec.between.length !== 2) {
+        throw new Error(`createWall: \`between\` must contain exactly 2 rooms (got ${spec.between.length})`);
+    }
+    const roomAId = refToId(spec.between[0]);
+    const roomBId = refToId(spec.between[1]);
+    if (roomAId === roomBId) {
+        throw new Error(`createWall: \`between\` must reference two distinct rooms (got self-reference '${roomAId}')`);
+    }
+    const roomA = world.getEntity(roomAId);
+    if (!roomA) {
+        throw new Error(`createWall: room '${roomAId}' does not exist`);
+    }
+    const roomB = world.getEntity(roomBId);
+    if (!roomB) {
+        throw new Error(`createWall: room '${roomBId}' does not exist`);
+    }
+    const roomATrait = roomA.get(trait_types_1.TraitType.ROOM);
+    if (!roomATrait) {
+        throw new Error(`createWall: entity '${roomAId}' is not a room`);
+    }
+    const roomBTrait = roomB.get(trait_types_1.TraitType.ROOM);
+    if (!roomBTrait) {
+        throw new Error(`createWall: entity '${roomBId}' is not a room`);
+    }
+    if (!spec.sides || typeof spec.sides !== 'object') {
+        throw new Error('createWall: `sides` must be a record keyed by room id');
+    }
+    const sideA = spec.sides[roomAId];
+    const sideB = spec.sides[roomBId];
+    validateSide(roomAId, sideA);
+    validateSide(roomBId, sideB);
+    validateAdjectiveUniqueness(roomAId, sideA.adjective, roomATrait, world);
+    validateAdjectiveUniqueness(roomBId, sideB.adjective, roomBTrait, world);
+    validateObstructor(roomAId, sideA, world);
+    validateObstructor(roomBId, sideB, world);
+    return { roomAId, roomBId, roomA, roomB };
+}
+function validateSide(roomId, side) {
+    if (!side) {
+        throw new Error(`createWall: missing per-side data for room '${roomId}'`);
+    }
+    if (typeof side.adjective !== 'string') {
+        throw new Error(`createWall: side for room '${roomId}' is missing a string \`adjective\``);
+    }
+    if (side.adjective.trim().length === 0) {
+        throw new Error(`createWall: side for room '${roomId}' has an empty \`adjective\``);
+    }
+}
+function validateAdjectiveUniqueness(roomId, adjective, roomTrait, world) {
+    const existingWallIds = roomTrait.walls ?? [];
+    for (const existingWallId of existingWallIds) {
+        const existing = world.getEntity(existingWallId);
+        if (!existing)
+            continue;
+        const sides = existing.sides;
+        const existingSide = sides?.get(roomId);
+        if (existingSide && existingSide.adjective === adjective) {
+            throw new Error(`createWall: adjective '${adjective}' is already used by another wall in room '${roomId}'`);
+        }
+    }
+}
+function validateObstructor(roomId, side, world) {
+    if (side.obstructedBy === undefined)
+        return;
+    const obstructor = world.getEntity(side.obstructedBy);
+    if (!obstructor) {
+        throw new Error(`createWall: \`obstructedBy\` references nonexistent entity '${side.obstructedBy}' for room '${roomId}'`);
+    }
+    const obstructorLocation = world.getLocation(side.obstructedBy);
+    if (obstructorLocation !== roomId) {
+        throw new Error(`createWall: \`obstructedBy\` entity '${side.obstructedBy}' must be located in room '${roomId}' (currently in '${obstructorLocation ?? 'no location'}')`);
+    }
+}
+//# sourceMappingURL=wall-validation.js.map

package/world/wall-validation.js.map

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