@sharpee/lang-en-us 1.5.0 → 2.1.0

package/npc/npc.js

@@ -1,36 +1,42 @@
 "use strict";
 /**
  * Language content for NPC system (ADR-070)
+ *
+ * Attribution lines name the acting NPC via a `speaker` NounPhrase param (ADR-203)
+ * and agree their verb with it via the ADR-199 Verb atom (`{verb:LEMMA speaker}`).
+ * The article is the ADR-192 hint (`{the speaker}` here; author-overridable). The
+ * `{capitalize …}` hint supplies the sentence-initial capital (top-level messages are
+ * not sentence-initial by default, so auto-cap does not fire here).
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.npcLanguage = void 0;
 exports.npcLanguage = {
     messages: {
         // Movement messages (visual renderings)
-        'npc.enters': "{npcName} enters from the {direction}.",
-        'npc.leaves': "{npcName} leaves to the {direction}.",
-        'npc.arrives': "{npcName} arrives.",
-        'npc.departs': "{npcName} departs.",
+        'npc.enters': "{capitalize the speaker} {verb:enters speaker} from the {verbatim:direction}.",
+        'npc.leaves': "{capitalize the speaker} {verb:leaves speaker} to the {verbatim:direction}.",
+        'npc.arrives': "{capitalize the speaker} {verb:arrives speaker}.",
+        'npc.departs': "{capitalize the speaker} {verb:departs speaker}.",
         // Movement messages (anonymized hearing renderings — heard in the dark/when blind)
         'npc.heard_arrives': "You hear someone enter.",
         'npc.heard_departs': "You hear someone leave.",
         // Observation messages
-        'npc.notices_player': "{npcName} notices you.",
-        'npc.ignores_player': "{npcName} ignores you.",
+        'npc.notices_player': "{capitalize the speaker} {verb:notices speaker} you.",
+        'npc.ignores_player': "{capitalize the speaker} {verb:ignores speaker} you.",
         // Action messages
-        'npc.takes': "{npcName} picks up {itemName}.",
-        'npc.drops': "{npcName} drops {itemName}.",
-        'npc.follows': "{npcName} follows you.",
+        'npc.takes': "{capitalize the speaker} {verb:picks speaker} up {verbatim:itemName}.",
+        'npc.drops': "{capitalize the speaker} {verb:drops speaker} {verbatim:itemName}.",
+        'npc.follows': "{capitalize the speaker} {verb:follows speaker} you.",
         // Guard messages
-        'npc.guard.blocks': "{npcName} blocks your way!",
-        'npc.guard.attacks': "{npcName} attacks you!",
-        'npc.guard.defeated': "{npcName} is no longer a threat.",
+        'npc.guard.blocks': "{capitalize the speaker} {verb:blocks speaker} your way!",
+        'npc.guard.attacks': "{capitalize the speaker} {verb:attacks speaker} you!",
+        'npc.guard.defeated': "{capitalize the speaker} {verb:is speaker} no longer a threat.",
         // Combat messages (basic)
-        'npc.attacks': "{npcName} attacks you!",
-        'npc.misses': "{npcName} swings at you but misses!",
-        'npc.hits': "{npcName} hits you for {damage} damage!",
-        'npc.killed': "{npcName} has been slain.",
-        'npc.unconscious': "{npcName} collapses, unconscious.",
+        'npc.attacks': "{capitalize the speaker} {verb:attacks speaker} you!",
+        'npc.misses': "{capitalize the speaker} {verb:swings speaker} at you but {verb:misses speaker}!",
+        'npc.hits': "{capitalize the speaker} {verb:hits speaker} you for {damage} damage!",
+        'npc.killed': "{capitalize the speaker} {verb:has speaker} been slain.",
+        'npc.unconscious': "{capitalize the speaker} {verb:collapses speaker}, unconscious.",
         // NPC combat attack outcomes (canonical Zork troll messages from MDL source)
         'npc.combat.attack.missed': "The troll swings his axe, but it misses.",
         'npc.combat.attack.hit': "The axe gets you right in the side. Ouch!",
@@ -40,25 +46,25 @@ exports.npcLanguage = {
         'npc.combat.attack.killed': "The troll lands a killing blow. You are dead.",
         // Speech messages
         // `npc.speech` is the generic id emitted by NpcBehavior `speak` actions:
-        // the behavior supplies the full line in `{text}`, so render it verbatim.
-        'npc.speech': "{text}",
-        'npc.speaks': "{npcName} says, \"{text}\"",
-        'npc.shouts': "{npcName} shouts, \"{text}\"",
-        'npc.whispers': "{npcName} whispers, \"{text}\"",
-        'npc.mutters': "{npcName} mutters, \"{text}\"",
+        // the behavior supplies the full line in `{verbatim:text}`, so render it verbatim.
+        'npc.speech': "{verbatim:text}",
+        'npc.speaks': "{capitalize the speaker} {verb:says speaker}, \"{verbatim:text}\"",
+        'npc.shouts': "{capitalize the speaker} {verb:shouts speaker}, \"{verbatim:text}\"",
+        'npc.whispers': "{capitalize the speaker} {verb:whispers speaker}, \"{verbatim:text}\"",
+        'npc.mutters': "{capitalize the speaker} {verb:mutters speaker}, \"{verbatim:text}\"",
         // Emote messages
         // `npc.emote` is the generic id emitted by NpcBehavior `emote` actions:
-        // the behavior supplies the full sentence in `{text}`, so render it verbatim.
-        'npc.emote': "{text}",
-        'npc.laughs': "{npcName} laughs.",
-        'npc.growls': "{npcName} growls menacingly.",
-        'npc.cries': "{npcName} cries.",
-        'npc.sighs': "{npcName} sighs.",
+        // the behavior supplies the full sentence in `{verbatim:text}`, so render it verbatim.
+        'npc.emote': "{verbatim:text}",
+        'npc.laughs': "{capitalize the speaker} {verb:laughs speaker}.",
+        'npc.growls': "{capitalize the speaker} {verb:growls speaker} menacingly.",
+        'npc.cries': "{capitalize the speaker} {verb:cries speaker}.",
+        'npc.sighs': "{capitalize the speaker} {verb:sighs speaker}.",
         // Dialogue messages
-        'npc.greets': "{npcName} greets you.",
-        'npc.farewell': "{npcName} bids you farewell.",
-        'npc.no_response': "{npcName} doesn't respond.",
-        'npc.confused': "{npcName} looks confused."
+        'npc.greets': "{capitalize the speaker} {verb:greets speaker} you.",
+        'npc.farewell': "{capitalize the speaker} {verb:bids speaker} you farewell.",
+        'npc.no_response': "{capitalize the speaker} {verb:does speaker} not respond.",
+        'npc.confused': "{capitalize the speaker} {verb:looks speaker} confused."
     }
 };
 //# sourceMappingURL=npc.js.map

package/npc/npc.js.map

@@ -1 +1 @@
-{"version":3,"file":"npc.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee_v1/packages/lang-en-us/src/npc/npc.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEU,QAAA,WAAW,GAAG;IACzB,QAAQ,EAAE;QACR,wCAAwC;QACxC,YAAY,EAAE,wCAAwC;QACtD,YAAY,EAAE,sCAAsC;QACpD,aAAa,EAAE,oBAAoB;QACnC,aAAa,EAAE,oBAAoB;QAEnC,mFAAmF;QACnF,mBAAmB,EAAE,yBAAyB;QAC9C,mBAAmB,EAAE,yBAAyB;QAE9C,uBAAuB;QACvB,oBAAoB,EAAE,wBAAwB;QAC9C,oBAAoB,EAAE,wBAAwB;QAE9C,kBAAkB;QAClB,WAAW,EAAE,gCAAgC;QAC7C,WAAW,EAAE,6BAA6B;QAC1C,aAAa,EAAE,wBAAwB;QAEvC,iBAAiB;QACjB,kBAAkB,EAAE,4BAA4B;QAChD,mBAAmB,EAAE,wBAAwB;QAC7C,oBAAoB,EAAE,kCAAkC;QAExD,0BAA0B;QAC1B,aAAa,EAAE,wBAAwB;QACvC,YAAY,EAAE,qCAAqC;QACnD,UAAU,EAAE,yCAAyC;QACrD,YAAY,EAAE,2BAA2B;QACzC,iBAAiB,EAAE,mCAAmC;QAEtD,6EAA6E;QAC7E,0BAA0B,EAAE,0CAA0C;QACtE,uBAAuB,EAAE,2CAA2C;QACpE,6BAA6B,EAAE,wDAAwD;QACvF,6BAA6B,EAAE,2EAA2E;QAC1G,+BAA+B,EAAE,gFAAgF;QACjH,0BAA0B,EAAE,+CAA+C;QAE3E,kBAAkB;QAClB,yEAAyE;QACzE,0EAA0E;QAC1E,YAAY,EAAE,QAAQ;QACtB,YAAY,EAAE,4BAA4B;QAC1C,YAAY,EAAE,8BAA8B;QAC5C,cAAc,EAAE,gCAAgC;QAChD,aAAa,EAAE,+BAA+B;QAE9C,iBAAiB;QACjB,wEAAwE;QACxE,8EAA8E;QAC9E,WAAW,EAAE,QAAQ;QACrB,YAAY,EAAE,mBAAmB;QACjC,YAAY,EAAE,8BAA8B;QAC5C,WAAW,EAAE,kBAAkB;QAC/B,WAAW,EAAE,kBAAkB;QAE/B,oBAAoB;QACpB,YAAY,EAAE,uBAAuB;QACrC,cAAc,EAAE,8BAA8B;QAC9C,iBAAiB,EAAE,4BAA4B;QAC/C,cAAc,EAAE,2BAA2B;KAC5C;CACF,CAAC"}
+{"version":3,"file":"npc.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee_v2/packages/lang-en-us/src/npc/npc.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEU,QAAA,WAAW,GAAG;IACzB,QAAQ,EAAE;QACR,wCAAwC;QACxC,YAAY,EAAE,+EAA+E;QAC7F,YAAY,EAAE,6EAA6E;QAC3F,aAAa,EAAE,kDAAkD;QACjE,aAAa,EAAE,kDAAkD;QAEjE,mFAAmF;QACnF,mBAAmB,EAAE,yBAAyB;QAC9C,mBAAmB,EAAE,yBAAyB;QAE9C,uBAAuB;QACvB,oBAAoB,EAAE,sDAAsD;QAC5E,oBAAoB,EAAE,sDAAsD;QAE5E,kBAAkB;QAClB,WAAW,EAAE,uEAAuE;QACpF,WAAW,EAAE,oEAAoE;QACjF,aAAa,EAAE,sDAAsD;QAErE,iBAAiB;QACjB,kBAAkB,EAAE,0DAA0D;QAC9E,mBAAmB,EAAE,sDAAsD;QAC3E,oBAAoB,EAAE,gEAAgE;QAEtF,0BAA0B;QAC1B,aAAa,EAAE,sDAAsD;QACrE,YAAY,EAAE,kFAAkF;QAChG,UAAU,EAAE,uEAAuE;QACnF,YAAY,EAAE,yDAAyD;QACvE,iBAAiB,EAAE,iEAAiE;QAEpF,6EAA6E;QAC7E,0BAA0B,EAAE,0CAA0C;QACtE,uBAAuB,EAAE,2CAA2C;QACpE,6BAA6B,EAAE,wDAAwD;QACvF,6BAA6B,EAAE,2EAA2E;QAC1G,+BAA+B,EAAE,gFAAgF;QACjH,0BAA0B,EAAE,+CAA+C;QAE3E,kBAAkB;QAClB,yEAAyE;QACzE,mFAAmF;QACnF,YAAY,EAAE,iBAAiB;QAC/B,YAAY,EAAE,mEAAmE;QACjF,YAAY,EAAE,qEAAqE;QACnF,cAAc,EAAE,uEAAuE;QACvF,aAAa,EAAE,sEAAsE;QAErF,iBAAiB;QACjB,wEAAwE;QACxE,uFAAuF;QACvF,WAAW,EAAE,iBAAiB;QAC9B,YAAY,EAAE,iDAAiD;QAC/D,YAAY,EAAE,4DAA4D;QAC1E,WAAW,EAAE,gDAAgD;QAC7D,WAAW,EAAE,gDAAgD;QAE7D,oBAAoB;QACpB,YAAY,EAAE,qDAAqD;QACnE,cAAc,EAAE,4DAA4D;QAC5E,iBAAiB,EAAE,2DAA2D;QAC9E,cAAc,EAAE,yDAAyD;KAC1E;CACF,CAAC"}

package/npc/propagation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"propagation.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee_v1/packages/lang-en-us/src/npc/propagation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;CAwB/B,CAAC"}
+{"version":3,"file":"propagation.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee_v2/packages/lang-en-us/src/npc/propagation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;CAwB/B,CAAC"}

package/npc/propagation.js

@@ -14,15 +14,15 @@ exports.propagationLanguage = {
         // -----------------------------------------------------------------------
         // Witnessed messages — player sees NPC-to-NPC information exchange
         // -----------------------------------------------------------------------
-        'character.propagation.witnessed.neutral': '{speakerName} mentions something to {listenerName}.',
-        'character.propagation.witnessed.dramatic': '{speakerName} excitedly tells {listenerName} about something.',
-        'character.propagation.witnessed.vague': '{speakerName} vaguely alludes to something near {listenerName}.',
-        'character.propagation.witnessed.fearful': '{speakerName} nervously whispers something to {listenerName}.',
-        'character.propagation.witnessed.conspiratorial': '{speakerName} leans close to {listenerName}, muttering under their breath.',
+        'character.propagation.witnessed.neutral': '{verbatim:speakerName} mentions something to {verbatim:listenerName}.',
+        'character.propagation.witnessed.dramatic': '{verbatim:speakerName} excitedly tells {verbatim:listenerName} about something.',
+        'character.propagation.witnessed.vague': '{verbatim:speakerName} vaguely alludes to something near {verbatim:listenerName}.',
+        'character.propagation.witnessed.fearful': '{verbatim:speakerName} nervously whispers something to {verbatim:listenerName}.',
+        'character.propagation.witnessed.conspiratorial': '{verbatim:speakerName} leans close to {verbatim:listenerName}, muttering under their breath.',
         // -----------------------------------------------------------------------
         // Eavesdropped — player overhears a full exchange
         // -----------------------------------------------------------------------
-        'character.propagation.eavesdropped': 'You overhear {speakerName} speaking to {listenerName}.',
+        'character.propagation.eavesdropped': 'You overhear {verbatim:speakerName} speaking to {verbatim:listenerName}.',
     },
 };
 //# sourceMappingURL=propagation.js.map

package/npc/propagation.js.map

@@ -1 +1 @@
-{"version":3,"file":"propagation.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee_v1/packages/lang-en-us/src/npc/propagation.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEU,QAAA,mBAAmB,GAAG;IACjC,QAAQ,EAAE;QACR,0EAA0E;QAC1E,mEAAmE;QACnE,0EAA0E;QAE1E,yCAAyC,EACvC,qDAAqD;QACvD,0CAA0C,EACxC,+DAA+D;QACjE,uCAAuC,EACrC,iEAAiE;QACnE,yCAAyC,EACvC,+DAA+D;QACjE,gDAAgD,EAC9C,4EAA4E;QAE9E,0EAA0E;QAC1E,kDAAkD;QAClD,0EAA0E;QAE1E,oCAAoC,EAClC,wDAAwD;KAC3D;CACF,CAAC"}
+{"version":3,"file":"propagation.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee_v2/packages/lang-en-us/src/npc/propagation.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEU,QAAA,mBAAmB,GAAG;IACjC,QAAQ,EAAE;QACR,0EAA0E;QAC1E,mEAAmE;QACnE,0EAA0E;QAE1E,yCAAyC,EACvC,uEAAuE;QACzE,0CAA0C,EACxC,iFAAiF;QACnF,uCAAuC,EACrC,mFAAmF;QACrF,yCAAyC,EACvC,iFAAiF;QACnF,gDAAgD,EAC9C,8FAA8F;QAEhG,0EAA0E;QAC1E,kDAAkD;QAClD,0EAA0E;QAE1E,oCAAoC,EAClC,0EAA0E;KAC7E;CACF,CAAC"}

package/number-words.d.ts

@@ -5,4 +5,22 @@
  * @returns "one".."ten" for 1–10, otherwise the numeral as a string
  */
 export declare function countWord(n: number): string;
+/**
+ * Spell an integer in words: ones/teens/tens, hundreds with "and", and the
+ * thousand/million/billion scales. Negatives prefix "minus"; non-integers fall
+ * back to digits. The general speller for the `Numeral` atom (ADR-198) —
+ * distinct from {@link countWord}, which caps at ten for list grouping.
+ *
+ * @param value the number to spell
+ * @returns the cardinal words, e.g. 105 → "one hundred and five"
+ */
+export declare function numberToWords(value: number): string;
+/**
+ * The ordinal surface of an integer: digits + suffix, handling the 11–13
+ * exception (1st, 2nd, 3rd, 4th, 11th, 21st). Non-integers fall back to digits.
+ *
+ * @param value the number to ordinalize
+ * @returns e.g. 3 → "3rd", 11 → "11th"
+ */
+export declare function ordinalString(value: number): string;
 //# sourceMappingURL=number-words.d.ts.map

package/number-words.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"number-words.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee_v1/packages/lang-en-us/src/number-words.ts"],"names":[],"mappings":"AAWA;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAG3C"}
+{"version":3,"file":"number-words.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee_v2/packages/lang-en-us/src/number-words.ts"],"names":[],"mappings":"AAWA;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAG3C;AA6BD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAmBnD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASnD"}

package/number-words.js

@@ -6,6 +6,8 @@
 // by list count-grouping.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.countWord = countWord;
+exports.numberToWords = numberToWords;
+exports.ordinalString = ordinalString;
 const SMALL = [
     'zero', 'one', 'two', 'three', 'four', 'five',
     'six', 'seven', 'eight', 'nine', 'ten',
@@ -21,4 +23,79 @@ function countWord(n) {
         return SMALL[n];
     return String(n);
 }
+// --- full cardinal speller (ADR-198 Numeral atom) --------------------------
+const ONES = [
+    'zero', 'one', 'two', 'three', 'four', 'five', 'six', 'seven', 'eight', 'nine',
+    'ten', 'eleven', 'twelve', 'thirteen', 'fourteen', 'fifteen', 'sixteen',
+    'seventeen', 'eighteen', 'nineteen',
+];
+const TENS = ['', '', 'twenty', 'thirty', 'forty', 'fifty', 'sixty', 'seventy', 'eighty', 'ninety'];
+const SCALES = [
+    [1_000_000_000, 'billion'],
+    [1_000_000, 'million'],
+    [1_000, 'thousand'],
+];
+/** Spell 0–999 ("one hundred and five"). */
+function under1000(n) {
+    if (n < 20)
+        return ONES[n];
+    if (n < 100) {
+        const t = TENS[Math.floor(n / 10)];
+        const o = n % 10;
+        return o ? `${t}-${ONES[o]}` : t;
+    }
+    const h = `${ONES[Math.floor(n / 100)]} hundred`;
+    const rest = n % 100;
+    return rest ? `${h} and ${under1000(rest)}` : h;
+}
+/**
+ * Spell an integer in words: ones/teens/tens, hundreds with "and", and the
+ * thousand/million/billion scales. Negatives prefix "minus"; non-integers fall
+ * back to digits. The general speller for the `Numeral` atom (ADR-198) —
+ * distinct from {@link countWord}, which caps at ten for list grouping.
+ *
+ * @param value the number to spell
+ * @returns the cardinal words, e.g. 105 → "one hundred and five"
+ */
+function numberToWords(value) {
+    if (!Number.isFinite(value))
+        return String(value);
+    if (!Number.isInteger(value))
+        return String(value);
+    if (value === 0)
+        return 'zero';
+    if (value < 0)
+        return `minus ${numberToWords(-value)}`;
+    const parts = [];
+    let remainder = value;
+    for (const [scale, name] of SCALES) {
+        if (remainder >= scale) {
+            parts.push(`${numberToWords(Math.floor(remainder / scale))} ${name}`);
+            remainder %= scale;
+        }
+    }
+    if (remainder > 0) {
+        // British-style "and" before a trailing <100 group when there is a higher group.
+        parts.push(parts.length && remainder < 100 ? `and ${under1000(remainder)}` : under1000(remainder));
+    }
+    return parts.join(' ');
+}
+/**
+ * The ordinal surface of an integer: digits + suffix, handling the 11–13
+ * exception (1st, 2nd, 3rd, 4th, 11th, 21st). Non-integers fall back to digits.
+ *
+ * @param value the number to ordinalize
+ * @returns e.g. 3 → "3rd", 11 → "11th"
+ */
+function ordinalString(value) {
+    if (!Number.isInteger(value))
+        return String(value);
+    const abs = Math.abs(value) % 100;
+    const last = abs % 10;
+    let suffix = 'th';
+    if (abs < 11 || abs > 13) {
+        suffix = last === 1 ? 'st' : last === 2 ? 'nd' : last === 3 ? 'rd' : 'th';
+    }
+    return `${value}${suffix}`;
+}
 //# sourceMappingURL=number-words.js.map

package/number-words.js.map

@@ -1 +1 @@
-{"version":3,"file":"number-words.js","sourceRoot":"","sources":["../../../../../../repos/sharpee_v1/packages/lang-en-us/src/number-words.ts"],"names":[],"mappings":";AAAA,0CAA0C;AAC1C,EAAE;AACF,yEAAyE;AACzE,iFAAiF;AACjF,0BAA0B;;AAa1B,8BAGC;AAdD,MAAM,KAAK,GAAG;IACZ,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM;IAC7C,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK;CACvC,CAAC;AAEF;;;;;GAKG;AACH,SAAgB,SAAS,CAAC,CAAS;IACjC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IACvC,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC"}
+{"version":3,"file":"number-words.js","sourceRoot":"","sources":["../../../../../../repos/sharpee_v2/packages/lang-en-us/src/number-words.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sharpee/lang-en-us",
-  "version": "1.5.0",
+  "version": "2.1.0",
   "description": "English language implementation for Sharpee IF Engine",
   "main": "./index.js",
   "types": "./index.d.ts",
@@ -12,8 +12,8 @@
     }
   },
   "dependencies": {
-    "@sharpee/core": "^1.5.0",
-    "@sharpee/if-domain": "^1.5.0"
+    "@sharpee/core": "^2.1.0",
+    "@sharpee/if-domain": "^2.1.0"
   },
   "keywords": [
     "interactive-fiction",

package/parser/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @file Phrase parser barrel (ADR-192).
+ *
+ * Owner context: `@sharpee/lang-en-us` — the English authoring-template parser
+ * that produces language-neutral phrase trees.
+ */
+export { parsePhraseTemplate, PhraseParseError } from './parse-phrase-template.js';
+//# sourceMappingURL=index.d.ts.map

package/parser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee_v2/packages/lang-en-us/src/parser/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC"}

package/parser/index.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * @file Phrase parser barrel (ADR-192).
+ *
+ * Owner context: `@sharpee/lang-en-us` — the English authoring-template parser
+ * that produces language-neutral phrase trees.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PhraseParseError = exports.parsePhraseTemplate = void 0;
+var parse_phrase_template_js_1 = require("./parse-phrase-template.js");
+Object.defineProperty(exports, "parsePhraseTemplate", { enumerable: true, get: function () { return parse_phrase_template_js_1.parsePhraseTemplate; } });
+Object.defineProperty(exports, "PhraseParseError", { enumerable: true, get: function () { return parse_phrase_template_js_1.PhraseParseError; } });
+//# sourceMappingURL=index.js.map

package/parser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee_v2/packages/lang-en-us/src/parser/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,uEAAmF;AAA1E,+HAAA,mBAAmB,OAAA;AAAE,4HAAA,gBAAgB,OAAA"}

package/parser/parse-phrase-template.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @file parsePhraseTemplate — the phrase-tree template parser (ADR-192 §5).
+ *
+ * Purpose: parse an author template string into a `Phrase` tree, binding each
+ * placeholder to a producer/param value. Replaces `parsePlaceholder` and the
+ * `:`-chain formatter grammar. Placeholders are producer references, never
+ * formatter chains.
+ *
+ * Public interface: `parsePhraseTemplate(template, params)` and
+ * `PhraseParseError`.
+ *
+ * Owner context: `@sharpee/lang-en-us`. The grammar is English-locale authoring
+ * surface; the produced `Phrase` tree is language-neutral.
+ *
+ * Grammar (ADR-192 §5):
+ *  - `{item}` / `{the item}` / `{a item}` / `{an item}` / `{some item}` /
+ *    `{capitalize the item}` → `NounPhrase` (last bare token = param name,
+ *    leading bare tokens = reserved hints).
+ *  - `{verb:is target}` / `{verb:has target}` / `{verb:opens door}` → a `Verb`
+ *    atom (ADR-199): leading bare token is the lemma, last bare token is the
+ *    subject param to agree with. The subject must be a bound param.
+ *  - `{verbatim:name}` → a `Verbatim` atom (ADR-200): the param's value rendered
+ *    as opaque, whitespace-exempt text. The param must be bound.
+ *  - `{number:coins}` / `{number:coins words}` / `{number:floor ordinal}` → a
+ *    `Numeral` atom (ADR-198): the numeric param, optional format. Must be bound.
+ *  - `{pronoun:subject}` / `{pronoun:object}` / `{pronoun:possessive}` → a `Pronoun`
+ *    atom (ADR-197): a grammatical case; the referent is the last-mentioned entity.
+ *  - `{contents:box}` → a `Contents` atom (ADR-194): the container's live contents
+ *    as a grouped list, read at realize time. The container must be bound.
+ *  - `{slot:here}` / `{slot:detail clause}` / `{slot:detail clause or}` → a `Slot`
+ *    combinator (ADR-195): the first bare token is the contribution channel key;
+ *    optional trailing hints set `mode` (`sentence` default | `clause`) and the
+ *    `clause` conjunction (`and` default | `or`). The key need NOT be a bound param
+ *    — an unfilled slot is valid (AC-7); a keyless `{slot:}` is a parse error (AC-9).
+ *  - No `:`-chain, `?`, `|`, `#`. A `:` head whose prefix is not a known kind,
+ *    an unknown leading hint, or an unbound param all raise `PhraseParseError`
+ *    AT PARSE TIME (never a silent `Empty` at realize time). (AC-8, AC-11)
+ */
+import { Phrase } from '@sharpee/if-domain';
+/**
+ * Raised when a template cannot be parsed: a legacy `:`-chain, an unknown
+ * kind-prefix, an unknown leading hint, or a reference to an unbound param.
+ * Carries the offending token and the full template so the author sees both.
+ */
+export declare class PhraseParseError extends Error {
+    readonly offendingToken: string;
+    readonly template: string;
+    readonly reason: string;
+    constructor(offendingToken: string, template: string, reason: string);
+}
+/**
+ * Parse a template into a phrase tree.
+ *
+ * @param template author template, e.g. "You take {the item}."
+ * @param params param/producer bindings keyed by placeholder name
+ * @returns the parsed phrase (a `Sequence` when the template mixes literal text
+ *          and placeholders; the bare phrase when it is a single placeholder)
+ * @throws PhraseParseError on a legacy `:`-chain, unknown kind-prefix, unknown
+ *         hint, or unbound param — synchronously, at parse time (AC-8, AC-11)
+ */
+export declare function parsePhraseTemplate(template: string, params?: Record<string, unknown>): Phrase;
+//# sourceMappingURL=parse-phrase-template.d.ts.map

package/parser/parse-phrase-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-phrase-template.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee_v2/packages/lang-en-us/src/parser/parse-phrase-template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,EAAE,MAAM,EAAoB,MAAM,oBAAoB,CAAC;AAuB9D;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAOrE;AAiTD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,MAAM,CAmBlG"}