@sharpee/stdlib 2.0.0 → 2.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sharpee/stdlib",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Standard library for Sharpee IF Platform - actions, commands, and game mechanics",
   "main": "./index.js",
   "types": "./index.d.ts",
@@ -12,12 +12,12 @@
     }
   },
   "dependencies": {
-    "@sharpee/core": "^2.0.0",
-    "@sharpee/if-domain": "^2.0.0",
-    "@sharpee/if-services": "^2.0.0",
-    "@sharpee/lang-en-us": "^2.0.0",
-    "@sharpee/text-blocks": "^2.0.0",
-    "@sharpee/world-model": "^2.0.0"
+    "@sharpee/core": "^2.1.0",
+    "@sharpee/if-domain": "^2.1.0",
+    "@sharpee/if-services": "^2.1.0",
+    "@sharpee/lang-en-us": "^2.1.0",
+    "@sharpee/text-blocks": "^2.1.0",
+    "@sharpee/world-model": "^2.1.0"
   },
   "keywords": [
     "interactive-fiction",

package/utils/entity-info.d.ts

@@ -1,45 +0,0 @@
-/**
- * @file entity-info.ts
- * @module @sharpee/stdlib/utils
- *
- * Bridges world-model's `IFEntity` to lang-en-us's `EntityInfo` so that
- * message templates using formatter chains (`{the:cap:item}`, `{a:item}`,
- * `{some:item}`) receive the metadata they need to choose articles correctly.
- *
- * Per ADR-158: stdlib actions and capability behaviors must populate
- * entity-valued message parameters with `EntityInfo` (built via this helper),
- * not with bare entity names. The helper lives in stdlib because stdlib is
- * the only package depending on both `@sharpee/world-model` (source of
- * `IFEntity`) and `@sharpee/lang-en-us` (source of `EntityInfo`).
- *
- * @see ADR-158 Entity-Valued Message Params Carry EntityInfo
- * @see ADR-095 Message Templates with Formatters
- */
-import type { EntityInfo } from '@sharpee/lang-en-us';
-import { IFEntity } from '@sharpee/world-model';
-/**
- * Build an `EntityInfo` from an `IFEntity` for use as a message-template
- * parameter value.
- *
- * Reads `IdentityTrait` fields and projects them onto the formatter's
- * consumption shape. If the entity has no `IdentityTrait`, returns a minimal
- * `{ name }` so callers do not need null guards — the `the` formatter will
- * fall back to "the {name}" as before.
- *
- * @param entity - Any IFEntity. Typically the noun, container, target, etc.
- *                 from an action's `ValidatedCommand` or capability behavior.
- * @returns An `EntityInfo` consumable by `theFormatter`, `aFormatter`,
- *          `someFormatter`, and the `:cap` chain.
- *
- * @example
- *   // In an action's report() phase:
- *   return {
- *     valid: false,
- *     error: TakingMessages.FIXED_IN_PLACE,
- *     params: { item: entityInfoFrom(noun) }
- *   };
- *   // Template: "{the:cap:item} is fixed in place."
- *   // Renders:  "The white house is fixed in place."
- */
-export declare function entityInfoFrom(entity: IFEntity): EntityInfo;
-//# sourceMappingURL=entity-info.d.ts.map

package/utils/entity-info.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"entity-info.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee_v1/packages/stdlib/src/utils/entity-info.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAA4B,MAAM,sBAAsB,CAAC;AAE1E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,QAAQ,GAAG,UAAU,CA4B3D"}

package/utils/entity-info.js

@@ -1,71 +0,0 @@
-"use strict";
-/**
- * @file entity-info.ts
- * @module @sharpee/stdlib/utils
- *
- * Bridges world-model's `IFEntity` to lang-en-us's `EntityInfo` so that
- * message templates using formatter chains (`{the:cap:item}`, `{a:item}`,
- * `{some:item}`) receive the metadata they need to choose articles correctly.
- *
- * Per ADR-158: stdlib actions and capability behaviors must populate
- * entity-valued message parameters with `EntityInfo` (built via this helper),
- * not with bare entity names. The helper lives in stdlib because stdlib is
- * the only package depending on both `@sharpee/world-model` (source of
- * `IFEntity`) and `@sharpee/lang-en-us` (source of `EntityInfo`).
- *
- * @see ADR-158 Entity-Valued Message Params Carry EntityInfo
- * @see ADR-095 Message Templates with Formatters
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.entityInfoFrom = entityInfoFrom;
-const world_model_1 = require("@sharpee/world-model");
-/**
- * Build an `EntityInfo` from an `IFEntity` for use as a message-template
- * parameter value.
- *
- * Reads `IdentityTrait` fields and projects them onto the formatter's
- * consumption shape. If the entity has no `IdentityTrait`, returns a minimal
- * `{ name }` so callers do not need null guards — the `the` formatter will
- * fall back to "the {name}" as before.
- *
- * @param entity - Any IFEntity. Typically the noun, container, target, etc.
- *                 from an action's `ValidatedCommand` or capability behavior.
- * @returns An `EntityInfo` consumable by `theFormatter`, `aFormatter`,
- *          `someFormatter`, and the `:cap` chain.
- *
- * @example
- *   // In an action's report() phase:
- *   return {
- *     valid: false,
- *     error: TakingMessages.FIXED_IN_PLACE,
- *     params: { item: entityInfoFrom(noun) }
- *   };
- *   // Template: "{the:cap:item} is fixed in place."
- *   // Renders:  "The white house is fixed in place."
- */
-function entityInfoFrom(entity) {
-    if (!entity.has(world_model_1.TraitType.IDENTITY)) {
-        return { name: entity.name };
-    }
-    const identity = entity.get(world_model_1.TraitType.IDENTITY);
-    const info = {
-        name: identity.name || entity.name,
-    };
-    if (identity.nounType !== undefined) {
-        info.nounType = identity.nounType;
-    }
-    if (identity.properName) {
-        info.properName = true;
-    }
-    if (identity.article) {
-        info.article = identity.article;
-    }
-    if (identity.grammaticalNumber !== undefined) {
-        info.grammaticalNumber = identity.grammaticalNumber;
-    }
-    if (identity.plural) {
-        info.plural = identity.plural;
-    }
-    return info;
-}
-//# sourceMappingURL=entity-info.js.map

package/utils/entity-info.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"entity-info.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee_v1/packages/stdlib/src/utils/entity-info.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;AA6BH,wCA4BC;AAtDD,sDAA0E;AAE1E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,SAAgB,cAAc,CAAC,MAAgB;IAC7C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,uBAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;IAC/B,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,uBAAS,CAAC,QAAQ,CAAkB,CAAC;IAEjE,MAAM,IAAI,GAAe;QACvB,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI;KACnC,CAAC;IAEF,IAAI,QAAQ,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACpC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;IACpC,CAAC;IACD,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;QACxB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;IACzB,CAAC;IACD,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;IAClC,CAAC;IACD,IAAI,QAAQ,CAAC,iBAAiB,KAAK,SAAS,EAAE,CAAC;QAC7C,IAAI,CAAC,iBAAiB,GAAG,QAAQ,CAAC,iBAAiB,CAAC;IACtD,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpB,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;IAChC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}