@sharpee/if-domain 0.9.60-beta

package/dist/vocabulary-contracts/vocabulary-types.d.ts

@@ -0,0 +1,240 @@
+/**
+ * Vocabulary types and interfaces for the parser
+ *
+ * The vocabulary system is extensible at multiple levels:
+ * - Base vocabulary from language packages
+ * - Extension vocabulary from extensions
+ * - Story-specific vocabulary overrides
+ * - Entity-specific vocabulary from traits
+ */
+/**
+ * Part of speech categories
+ */
+export declare const PartOfSpeech: {
+    readonly VERB: "verb";
+    readonly NOUN: "noun";
+    readonly ADJECTIVE: "adjective";
+    readonly PREPOSITION: "preposition";
+    readonly ARTICLE: "article";
+    readonly PRONOUN: "pronoun";
+    readonly DIRECTION: "direction";
+    readonly SPECIAL: "special";
+    readonly DETERMINER: "determiner";
+    readonly CONJUNCTION: "conjunction";
+    readonly NUMBER: "number";
+};
+export type PartOfSpeech = typeof PartOfSpeech[keyof typeof PartOfSpeech];
+/**
+ * A vocabulary entry
+ */
+export interface VocabularyEntry {
+    /**
+     * The word itself
+     */
+    word: string;
+    /**
+     * Part of speech
+     */
+    partOfSpeech: PartOfSpeech;
+    /**
+     * What this word maps to (action ID, entity ID, etc.)
+     */
+    mapsTo: string;
+    /**
+     * Priority for disambiguation (higher = preferred)
+     */
+    priority?: number;
+    /**
+     * Source of this vocabulary entry
+     */
+    source?: 'base' | 'extension' | 'story' | 'entity' | 'dynamic';
+    /**
+     * Additional metadata
+     */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Collection of vocabulary entries
+ */
+export interface VocabularySet {
+    /**
+     * All vocabulary entries
+     */
+    entries: VocabularyEntry[];
+    /**
+     * Quick lookup by word
+     */
+    byWord: Map<string, VocabularyEntry[]>;
+    /**
+     * Quick lookup by part of speech
+     */
+    byPartOfSpeech: Map<PartOfSpeech, VocabularyEntry[]>;
+}
+/**
+ * Vocabulary provider interface
+ *
+ * Different sources can provide vocabulary:
+ * - Language packages provide base vocabulary
+ * - Extensions can add domain-specific vocabulary
+ * - Stories can override or add vocabulary
+ * - Entities register their own vocabulary dynamically
+ */
+export interface VocabularyProvider {
+    /**
+     * Unique identifier for this provider
+     */
+    id: string;
+    /**
+     * Get vocabulary entries from this provider
+     */
+    getVocabulary(): VocabularyEntry[];
+    /**
+     * Priority for this provider (higher = override lower)
+     */
+    priority?: number;
+}
+/**
+ * Standard verb vocabulary
+ */
+export interface VerbVocabulary {
+    /**
+     * The canonical action ID this verb maps to
+     */
+    actionId: string;
+    /**
+     * All verb forms that map to this action
+     */
+    verbs: string[];
+    /**
+     * Grammar pattern for this verb
+     */
+    pattern?: string;
+    /**
+     * Required prepositions (if any)
+     */
+    prepositions?: string[];
+}
+/**
+ * Direction vocabulary entry
+ */
+export interface DirectionVocabulary {
+    /**
+     * Canonical direction (NORTH, SOUTH, etc.)
+     */
+    direction: string;
+    /**
+     * All words that map to this direction
+     */
+    words: string[];
+    /**
+     * Short forms (n, s, e, w, etc.)
+     */
+    abbreviations?: string[];
+}
+/**
+ * Special vocabulary for pronouns and references
+ */
+export interface SpecialVocabulary {
+    /**
+     * Pronouns that refer to last noun
+     */
+    pronouns: string[];
+    /**
+     * Words that mean "everything"
+     */
+    allWords: string[];
+    /**
+     * Words that mean "except"
+     */
+    exceptWords: string[];
+    /**
+     * Common articles to ignore
+     */
+    articles: string[];
+}
+/**
+ * Dynamic vocabulary entry from an entity
+ */
+export interface EntityVocabulary {
+    /**
+     * Entity ID this vocabulary belongs to
+     */
+    entityId: string;
+    /**
+     * Nouns that refer to this entity
+     */
+    nouns: string[];
+    /**
+     * Adjectives that can describe this entity
+     */
+    adjectives: string[];
+    /**
+     * Whether this entity is in scope
+     */
+    inScope?: boolean;
+    /**
+     * Priority for disambiguation
+     */
+    priority?: number;
+}
+/**
+ * Grammar pattern for verb syntax
+ */
+export interface GrammarPattern {
+    /**
+     * Pattern name
+     */
+    name: string;
+    /**
+     * Pattern elements (VERB, NOUN, PREP, etc.)
+     */
+    elements: string[];
+    /**
+     * Example usage
+     */
+    example?: string;
+    /**
+     * Actions that use this pattern
+     */
+    actions?: string[];
+}
+/**
+ * Common grammar patterns
+ */
+export declare const GrammarPatterns: Readonly<{
+    VERB_ONLY: Readonly<{
+        name: "verb_only";
+        elements: readonly string[];
+        example: "look";
+    }>;
+    VERB_NOUN: Readonly<{
+        name: "verb_noun";
+        elements: readonly string[];
+        example: "take sword";
+    }>;
+    VERB_NOUN_PREP_NOUN: Readonly<{
+        name: "verb_noun_prep_noun";
+        elements: readonly string[];
+        example: "put sword in chest";
+    }>;
+    VERB_PREP_NOUN: Readonly<{
+        name: "verb_prep_noun";
+        elements: readonly string[];
+        example: "look at painting";
+    }>;
+    VERB_DIRECTION: Readonly<{
+        name: "verb_direction";
+        elements: readonly string[];
+        example: "go north";
+    }>;
+    DIRECTION_ONLY: Readonly<{
+        name: "direction_only";
+        elements: readonly string[];
+        example: "north";
+    }>;
+}>;
+/**
+ * Type for standard grammar pattern names
+ */
+export type GrammarPatternName = keyof typeof GrammarPatterns;
+//# sourceMappingURL=vocabulary-types.d.ts.map

package/dist/vocabulary-contracts/vocabulary-types.d.ts.map

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

package/dist/vocabulary-contracts/vocabulary-types.js

@@ -0,0 +1,64 @@
+"use strict";
+/**
+ * Vocabulary types and interfaces for the parser
+ *
+ * The vocabulary system is extensible at multiple levels:
+ * - Base vocabulary from language packages
+ * - Extension vocabulary from extensions
+ * - Story-specific vocabulary overrides
+ * - Entity-specific vocabulary from traits
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GrammarPatterns = exports.PartOfSpeech = void 0;
+/**
+ * Part of speech categories
+ */
+exports.PartOfSpeech = {
+    VERB: 'verb',
+    NOUN: 'noun',
+    ADJECTIVE: 'adjective',
+    PREPOSITION: 'preposition',
+    ARTICLE: 'article',
+    PRONOUN: 'pronoun',
+    DIRECTION: 'direction',
+    SPECIAL: 'special',
+    DETERMINER: 'determiner',
+    CONJUNCTION: 'conjunction',
+    NUMBER: 'number'
+};
+/**
+ * Common grammar patterns
+ */
+exports.GrammarPatterns = Object.freeze({
+    VERB_ONLY: Object.freeze({
+        name: 'verb_only',
+        elements: Object.freeze(['VERB']),
+        example: 'look'
+    }),
+    VERB_NOUN: Object.freeze({
+        name: 'verb_noun',
+        elements: Object.freeze(['VERB', 'NOUN']),
+        example: 'take sword'
+    }),
+    VERB_NOUN_PREP_NOUN: Object.freeze({
+        name: 'verb_noun_prep_noun',
+        elements: Object.freeze(['VERB', 'NOUN', 'PREP', 'NOUN']),
+        example: 'put sword in chest'
+    }),
+    VERB_PREP_NOUN: Object.freeze({
+        name: 'verb_prep_noun',
+        elements: Object.freeze(['VERB', 'PREP', 'NOUN']),
+        example: 'look at painting'
+    }),
+    VERB_DIRECTION: Object.freeze({
+        name: 'verb_direction',
+        elements: Object.freeze(['VERB', 'DIRECTION']),
+        example: 'go north'
+    }),
+    DIRECTION_ONLY: Object.freeze({
+        name: 'direction_only',
+        elements: Object.freeze(['DIRECTION']),
+        example: 'north'
+    })
+});
+//# sourceMappingURL=vocabulary-types.js.map

package/dist/vocabulary-contracts/vocabulary-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vocabulary-types.js","sourceRoot":"","sources":["../../src/vocabulary-contracts/vocabulary-types.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH;;GAEG;AACU,QAAA,YAAY,GAAG;IAC1B,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,SAAS,EAAE,WAAW;IACtB,WAAW,EAAE,aAAa;IAC1B,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,YAAY;IACxB,WAAW,EAAE,aAAa;IAC1B,MAAM,EAAE,QAAQ;CACR,CAAC;AAkNX;;GAEG;AACU,QAAA,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC;IAC3C,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC;QACvB,IAAI,EAAE,WAAW;QACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;QACjC,OAAO,EAAE,MAAM;KAChB,CAAC;IACF,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC;QACvB,IAAI,EAAE,WAAW;QACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACzC,OAAO,EAAE,YAAY;KACtB,CAAC;IACF,mBAAmB,EAAE,MAAM,CAAC,MAAM,CAAC;QACjC,IAAI,EAAE,qBAAqB;QAC3B,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACzD,OAAO,EAAE,oBAAoB;KAC9B,CAAC;IACF,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,EAAE,gBAAgB;QACtB,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACjD,OAAO,EAAE,kBAAkB;KAC5B,CAAC;IACF,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,EAAE,gBAAgB;QACtB,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAC9C,OAAO,EAAE,UAAU;KACpB,CAAC;IACF,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,EAAE,gBAAgB;QACtB,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,CAAC;QACtC,OAAO,EAAE,OAAO;KACjB,CAAC;CACH,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@sharpee/if-domain",
+  "version": "0.9.60-beta",
+  "description": "Core domain model and contracts 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"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rimraf dist"
+  },
+  "dependencies": {
+    "@sharpee/core": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.19",
+    "typescript": "^5.3.3",
+    "rimraf": "^5.0.5"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "interactive-fiction",
+    "if",
+    "text-adventure",
+    "sharpee",
+    "domain",
+    "events",
+    "contracts"
+  ],
+  "author": "Sharpee Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ChicagoDave/sharpee.git",
+    "directory": "packages/if-domain"
+  },
+  "homepage": "https://github.com/ChicagoDave/sharpee#readme",
+  "bugs": {
+    "url": "https://github.com/ChicagoDave/sharpee/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}