@sharpee/parser-en-us 0.9.60-beta

package/dist/slot-consumers/vocabulary-slot-consumer.js

@@ -0,0 +1,186 @@
+"use strict";
+/**
+ * @file Vocabulary Slot Consumer
+ * @description Handles vocabulary-constrained slots (ADR-088, ADR-082)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VocabularySlotConsumer = void 0;
+const if_domain_1 = require("@sharpee/if-domain");
+/**
+ * Built-in manner adverbs that modify how actions are performed.
+ * Stories can extend this via vocab.extend('manner', [...])
+ */
+const MANNER_ADVERBS = new Set([
+    'carefully', 'quietly', 'quickly', 'slowly',
+    'forcefully', 'gently', 'loudly', 'softly',
+    'cautiously', 'boldly', 'stealthily', 'silently',
+    'hastily', 'deliberately', 'violently', 'tenderly'
+]);
+/**
+ * Consumer for vocabulary-constrained slots (ADJECTIVE, NOUN, VOCABULARY, MANNER)
+ * Validates input against registered vocabulary categories
+ */
+class VocabularySlotConsumer {
+    slotTypes = [
+        if_domain_1.SlotType.ADJECTIVE,
+        if_domain_1.SlotType.NOUN,
+        if_domain_1.SlotType.VOCABULARY,
+        if_domain_1.SlotType.MANNER
+    ];
+    consume(ctx) {
+        const { slotType } = ctx;
+        switch (slotType) {
+            case if_domain_1.SlotType.ADJECTIVE:
+                return this.consumeAdjective(ctx);
+            case if_domain_1.SlotType.NOUN:
+                return this.consumeNoun(ctx);
+            case if_domain_1.SlotType.VOCABULARY:
+                return this.consumeVocabulary(ctx);
+            case if_domain_1.SlotType.MANNER:
+                return this.consumeManner(ctx);
+            default:
+                return null;
+        }
+    }
+    /**
+     * Consume an adjective slot from story vocabulary
+     * Requires vocabulary to be registered via language provider
+     */
+    consumeAdjective(ctx) {
+        const { tokens, startIndex, context } = ctx;
+        if (startIndex >= tokens.length) {
+            return null;
+        }
+        const token = tokens[startIndex];
+        const normalized = token.normalized;
+        // Get adjective vocabulary from context (world has language provider)
+        const adjectives = this.getVocabulary(context, 'adjectives');
+        if (adjectives && adjectives.has(normalized)) {
+            return {
+                tokens: [startIndex],
+                text: token.word,
+                confidence: 1.0,
+                slotType: if_domain_1.SlotType.ADJECTIVE
+            };
+        }
+        return null;
+    }
+    /**
+     * Consume a noun slot from story vocabulary
+     * Requires vocabulary to be registered via language provider
+     */
+    consumeNoun(ctx) {
+        const { tokens, startIndex, context } = ctx;
+        if (startIndex >= tokens.length) {
+            return null;
+        }
+        const token = tokens[startIndex];
+        const normalized = token.normalized;
+        // Get noun vocabulary from context (world has language provider)
+        const nouns = this.getVocabulary(context, 'nouns');
+        if (nouns && nouns.has(normalized)) {
+            return {
+                tokens: [startIndex],
+                text: token.word,
+                confidence: 1.0,
+                slotType: if_domain_1.SlotType.NOUN
+            };
+        }
+        return null;
+    }
+    /**
+     * Consume a vocabulary slot from a story-defined category.
+     * Uses GrammarVocabularyProvider to check if word is in category
+     * and if the category is active in the current context.
+     */
+    consumeVocabulary(ctx) {
+        const { tokens, startIndex, context, slotConstraints } = ctx;
+        const category = slotConstraints?.vocabularyCategory;
+        if (startIndex >= tokens.length || !category) {
+            return null;
+        }
+        const token = tokens[startIndex];
+        const word = token.normalized;
+        // Get the vocabulary provider from the world
+        const world = context.world;
+        if (!world?.getGrammarVocabularyProvider) {
+            return null;
+        }
+        const vocabProvider = world.getGrammarVocabularyProvider();
+        // Check if word matches the category in current context
+        if (vocabProvider.match(category, word, context)) {
+            return {
+                tokens: [startIndex],
+                text: token.word,
+                confidence: 1.0,
+                slotType: if_domain_1.SlotType.VOCABULARY,
+                // Store category and matched word for action access
+                category,
+                matchedWord: word
+            };
+        }
+        return null;
+    }
+    /**
+     * Consume a manner adverb slot.
+     * Matches built-in manner adverbs plus any story-defined extensions.
+     * The matched manner is intended to feed into command.intention.manner
+     */
+    consumeManner(ctx) {
+        const { tokens, startIndex, context } = ctx;
+        if (startIndex >= tokens.length) {
+            return null;
+        }
+        const token = tokens[startIndex];
+        const word = token.normalized;
+        // First check built-in manner adverbs
+        if (MANNER_ADVERBS.has(word)) {
+            return {
+                tokens: [startIndex],
+                text: token.word,
+                confidence: 1.0,
+                slotType: if_domain_1.SlotType.MANNER,
+                manner: word
+            };
+        }
+        // Then check story-extended manner vocabulary
+        const world = context.world;
+        if (world?.getGrammarVocabularyProvider) {
+            const vocabProvider = world.getGrammarVocabularyProvider();
+            if (vocabProvider.match('manner', word, context)) {
+                return {
+                    tokens: [startIndex],
+                    text: token.word,
+                    confidence: 1.0,
+                    slotType: if_domain_1.SlotType.MANNER,
+                    manner: word
+                };
+            }
+        }
+        return null;
+    }
+    /**
+     * Get vocabulary set from context
+     * Returns null if vocabulary not available
+     */
+    getVocabulary(context, type) {
+        // Try to get vocabulary from world's language provider
+        const world = context.world;
+        if (!world)
+            return null;
+        // Check for vocabulary provider interface
+        const provider = world.getVocabularyProvider?.();
+        if (!provider)
+            return null;
+        switch (type) {
+            case 'adjectives':
+                return provider.getAdjectives?.() || null;
+            case 'nouns':
+                return provider.getNouns?.() || null;
+            default:
+                return null;
+        }
+    }
+}
+exports.VocabularySlotConsumer = VocabularySlotConsumer;
+//# sourceMappingURL=vocabulary-slot-consumer.js.map

package/dist/slot-consumers/vocabulary-slot-consumer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vocabulary-slot-consumer.js","sourceRoot":"","sources":["../../src/slot-consumers/vocabulary-slot-consumer.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@sharpee/parser-en-us",
+  "version": "0.9.60-beta",
+  "description": "English (US) parser for Sharpee Interactive Fiction Platform",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@sharpee/lang-en-us": "0.9.60-beta",
+    "@sharpee/world-model": "0.9.60-beta",
+    "@sharpee/core": "0.9.60-beta",
+    "@sharpee/if-domain": "0.9.60-beta"
+  },
+  "devDependencies": {
+    "@types/node": "^20.8.0",
+    "@typescript-eslint/eslint-plugin": "^6.7.4",
+    "@typescript-eslint/parser": "^6.7.4",
+    "eslint": "^8.50.0",
+    "rimraf": "^5.0.5",
+    "typescript": "^5.2.2"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "interactive-fiction",
+    "if",
+    "text-adventure",
+    "sharpee",
+    "parser",
+    "english",
+    "natural-language"
+  ],
+  "author": "Sharpee Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ChicagoDave/sharpee.git",
+    "directory": "packages/parser-en-us"
+  },
+  "homepage": "https://github.com/ChicagoDave/sharpee#readme",
+  "bugs": {
+    "url": "https://github.com/ChicagoDave/sharpee/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rimraf dist",
+    "test": "vitest",
+    "test:ci": "vitest run",
+    "lint": "eslint src --ext .ts"
+  }
+}