@adatechnology/game-items 0.1.10 → 0.2.0

package/README.md

@@ -70,7 +70,7 @@ const { contents, leftover } = placeFinds(stacks, slots, items)
 | `advanceAge`, `moveToStorage`, `storageMultiplier`, `freshness`, `shelfRatio`, `chargeLevel`, `failsToStart` | aging and decay |
 | `blockChance`, `wearBlocked`, `repairPiece`, `pieceBlock` | layered clothing protection |
 | `maxLoadKg`, `carriedKg`, `loadState`, `bagOption`, `canTake` | carry weight and slots |
-| `resolveUse` | what using an item does, as data |
+| `resolveUse` | what using an item does, as data; with `UseContext.seal` a sealed item (`ItemDef.seal`, a `SealSpec` of game-contracts) still closed, holed or leaking is not eaten (`blocked`) |
 | `canCraft`, `craft` | recipes |
 | `createFindsProvider`, `rollByCategory`, `rollExplicitPool`, `spawnData`, `depletionFactor`, `placeFinds`, `toLootTables` | finds |
 | `itemsFromArsenal` | the arsenal as items |

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { BodySlot, DeepPartial } from '@adatechnology/game-contracts';
+import { BodySlot, SealSpec, DeepPartial, SealState, SealBlock } from '@adatechnology/game-contracts';
 export { BodySlot } from '@adatechnology/game-contracts';
 import { ItemDef as ItemDef$1, rng, ItemStack, SlotSpec, LootTables } from '@adatechnology/game-interactables';
 export { ItemDef as BaseItemDef } from '@adatechnology/game-interactables';
@@ -180,6 +180,8 @@ interface ItemDef extends ItemDef$1 {
         chance: number;
     };
     /** Key of the 3D model in `game-items-three`; without it a simple shape from `shape` is drawn. */
+    /** A sealed container (a food tin, a drink can): what opens it and whether a breach spoils it. The kinds of a content pack give it (`game-items-goods`). */
+    seal?: SealSpec;
     model?: string;
 }
 /** A bundle of content: items plus the categories, places and containers they rely on. */
@@ -492,6 +494,8 @@ interface UseContext {
     freshness?: Freshness;
     /** The food was cooked: it keeps only `cookedPoisonFactor` of its poison chance. */
     isCooked?: boolean;
+    /** State of a sealed item (`ItemDef.seal`): opened, holed, leaking. Given, a closed or spoiled container is not eaten (`UseResult.blocked`). */
+    seal?: SealState;
 }
 interface NutritionResult {
     satiety: number;
@@ -508,6 +512,8 @@ interface UseResult {
     consumes: boolean;
     /** Only for `consume_nutrition`. */
     nutrition?: NutritionResult;
+    /** Why it cannot be eaten or drunk now: still `sealed`, or spoiled by a hole (`breached`) or a leak (`leaked`). Only with `UseContext.seal`. */
+    blocked?: SealBlock;
 }
 /**
  * What using `item` does, as data: the host applies it (the player, the needs, the world). Pure. The first effect that lists the item wins, then the first

package/dist/index.global.js

@@ -61,6 +61,12 @@ var GameItems = (() => {
   });
 
   // ../game-contracts/dist/index.js
+  var sealBlock = (seal, state) => {
+    if (seal.spoilsWhenBreached && state.breached) return "breached";
+    if (seal.spoilsWhenBreached && state.leaked) return "leaked";
+    if (!state.opened) return "sealed";
+    return void 0;
+  };
   var UNSAFE_KEYS = /* @__PURE__ */ new Set(["__proto__", "constructor", "prototype"]);
   var isPlainObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value) && Object.getPrototypeOf(value) === Object.prototype;
   var deepMerge = (base, patch) => {
@@ -440,6 +446,8 @@ ${problems.map((problem) => `  - ${problem}`).join("\n")}`);
     const base = { useId: def.id, effect: def.effect, params: def.params ?? {}, consumes: def.consumes };
     if (def.effect !== "consume_nutrition") return base;
     const nutrition = nutritionOf(item, context, rules);
+    const blocked = item.seal && context.seal ? sealBlock(item.seal, context.seal) : void 0;
+    if (blocked) return { ...base, consumes: false, nutrition: { ...nutrition, isEdible: false }, blocked };
     return { ...base, consumes: def.consumes && nutrition.isEdible, nutrition };
   };