@sharpee/world-model 0.9.113 → 1.0.0

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":";AAAA,oDAAoD;;AAoDpD,4CAyDC;AAvFD,uDAAkD;AAGlD;;GAEG;AACH,SAAS,OAAO,CAAC,GAAwB;IACvC,OAAO,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;AAChD,CAAC;AAaD;;;;;;;;GAQG;AACH,SAAgB,gBAAgB,CAC9B,IAAe,EACf,KAA2B;IAE3B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChF,CAAC;IACD,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,6DAA6D,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CACpF,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAEzC,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,kFAAkF,OAAO,IAAI,CAC9F,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,qBAAqB,OAAO,kBAAkB,CAAC,CAAC;IAClE,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,qBAAqB,OAAO,kBAAkB,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAY,uBAAS,CAAC,IAAI,CAAC,CAAC;IACxD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,uBAAuB,OAAO,iBAAiB,CAAC,CAAC;IACnE,CAAC;IACD,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAY,uBAAS,CAAC,IAAI,CAAC,CAAC;IACxD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,uBAAuB,OAAO,iBAAiB,CAAC,CAAC;IACnE,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3E,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAElC,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC7B,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAE7B,2BAA2B,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;IACzE,2BAA2B,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;IAEzE,kBAAkB,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAC1C,kBAAkB,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAE1C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC5C,CAAC;AAED,SAAS,YAAY,CAAC,MAAgB,EAAE,IAA+B;IACrE,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,+CAA+C,MAAM,GAAG,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CACb,8BAA8B,MAAM,qCAAqC,CAC1E,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CACb,8BAA8B,MAAM,8BAA8B,CACnE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,2BAA2B,CAClC,MAAgB,EAChB,SAAiB,EACjB,SAAoB,EACpB,KAA2B;IAE3B,MAAM,eAAe,GAAG,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC;IAC9C,KAAK,MAAM,cAAc,IAAI,eAAe,EAAE,CAAC;QAC7C,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QACjD,IAAI,CAAC,QAAQ;YAAE,SAAS;QACxB,MAAM,KAAK,GAAI,QAAgE,CAAC,KAAK,CAAC;QACtF,MAAM,YAAY,GAAG,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,YAAY,IAAI,YAAY,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACzD,MAAM,IAAI,KAAK,CACb,0BAA0B,SAAS,8CAA8C,MAAM,GAAG,CAC3F,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CACzB,MAAgB,EAChB,IAAmB,EACnB,KAA2B;IAE3B,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS;QAAE,OAAO;IAC5C,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACtD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CACb,+DAA+D,IAAI,CAAC,YAAY,eAAe,MAAM,GAAG,CACzG,CAAC;IACJ,CAAC;IACD,MAAM,kBAAkB,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAChE,IAAI,kBAAkB,KAAK,MAAM,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CACb,wCAAwC,IAAI,CAAC,YAAY,8BAA8B,MAAM,oBAAoB,kBAAkB,IAAI,aAAa,IAAI,CACzJ,CAAC;IACJ,CAAC;AACH,CAAC"}