@sharpee/lang-en-us 0.9.61-beta

package/dist-npm/formatters/text.js

@@ -0,0 +1,80 @@
+"use strict";
+/**
+ * Text Formatters
+ *
+ * Formatters for case transformation and text manipulation.
+ *
+ * @see ADR-095 Message Templates with Formatters
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.titleFormatter = exports.lowerFormatter = exports.upperFormatter = exports.capFormatter = void 0;
+/**
+ * Extract name from value (string or EntityInfo)
+ */
+function getName(value) {
+    return typeof value === 'string' ? value : value.name;
+}
+/**
+ * "cap" formatter - capitalize first letter
+ *
+ * "sword" → "Sword"
+ */
+const capFormatter = (value, _context) => {
+    // Handle arrays
+    if (Array.isArray(value)) {
+        return value.map((v) => (0, exports.capFormatter)(v, _context)).join(', ');
+    }
+    const text = getName(value);
+    if (!text)
+        return '';
+    return text.charAt(0).toUpperCase() + text.slice(1);
+};
+exports.capFormatter = capFormatter;
+/**
+ * "upper" formatter - all uppercase
+ *
+ * "sword" → "SWORD"
+ */
+const upperFormatter = (value, _context) => {
+    // Handle arrays
+    if (Array.isArray(value)) {
+        return value.map((v) => (0, exports.upperFormatter)(v, _context)).join(', ');
+    }
+    const text = getName(value);
+    return text.toUpperCase();
+};
+exports.upperFormatter = upperFormatter;
+/**
+ * "lower" formatter - all lowercase
+ *
+ * "SWORD" → "sword"
+ */
+const lowerFormatter = (value, _context) => {
+    // Handle arrays
+    if (Array.isArray(value)) {
+        return value.map((v) => (0, exports.lowerFormatter)(v, _context)).join(', ');
+    }
+    const text = getName(value);
+    return text.toLowerCase();
+};
+exports.lowerFormatter = lowerFormatter;
+/**
+ * "title" formatter - title case (capitalize each word)
+ *
+ * "brass lantern" → "Brass Lantern"
+ */
+const titleFormatter = (value, _context) => {
+    // Handle arrays
+    if (Array.isArray(value)) {
+        return value.map((v) => (0, exports.titleFormatter)(v, _context)).join(', ');
+    }
+    const text = getName(value);
+    if (!text)
+        return '';
+    return text
+        .split(' ')
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+        .join(' ');
+};
+exports.titleFormatter = titleFormatter;
+//# sourceMappingURL=text.js.map

package/dist-npm/formatters/text.js.map

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

package/dist-npm/formatters/types.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Formatter Types
+ *
+ * Formatters transform placeholder values in message templates.
+ *
+ * Syntax: {formatter:formatter:...:placeholder}
+ * Example: {a:item} → "a sword"
+ * Example: {items:list} → "a sword, a key, and a coin"
+ *
+ * @see ADR-095 Message Templates with Formatters
+ */
+/**
+ * Context passed to formatters
+ */
+export interface FormatterContext {
+    /** Get entity by ID for nounType/article lookup */
+    getEntity?: (id: string) => EntityInfo | undefined;
+}
+/**
+ * Minimal entity info for formatting
+ */
+export interface EntityInfo {
+    name: string;
+    nounType?: 'common' | 'proper' | 'mass' | 'unique' | 'plural';
+    properName?: boolean;
+    article?: string;
+    grammaticalNumber?: 'singular' | 'plural';
+}
+/**
+ * Formatter function signature
+ *
+ * @param value - The value to format (string, array, or EntityInfo)
+ * @param context - Formatting context with entity lookup
+ * @returns Formatted string
+ */
+export type Formatter = (value: string | string[] | EntityInfo | EntityInfo[], context: FormatterContext) => string;
+/**
+ * Formatter registry - maps formatter names to functions
+ */
+export type FormatterRegistry = Map<string, Formatter>;
+//# sourceMappingURL=types.d.ts.map

package/dist-npm/formatters/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/formatters/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,UAAU,GAAG,SAAS,CAAC;CACpD;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC9D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC;CAC3C;AAED;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,CACtB,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,UAAU,GAAG,UAAU,EAAE,EACpD,OAAO,EAAE,gBAAgB,KACtB,MAAM,CAAC;AAEZ;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC"}

package/dist-npm/formatters/types.js

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * Formatter Types
+ *
+ * Formatters transform placeholder values in message templates.
+ *
+ * Syntax: {formatter:formatter:...:placeholder}
+ * Example: {a:item} → "a sword"
+ * Example: {items:list} → "a sword, a key, and a coin"
+ *
+ * @see ADR-095 Message Templates with Formatters
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist-npm/formatters/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/formatters/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG"}

package/dist-npm/grammar.d.ts

@@ -0,0 +1,189 @@
+/**
+ * English-specific grammar types and constants
+ *
+ * This module defines the parts of speech and grammatical structures
+ * specific to the English language. Other languages will have their
+ * own grammar modules with different parts of speech.
+ */
+/**
+ * English parts of speech
+ *
+ * Note: This is specific to English and may not apply to other languages.
+ * For example, Japanese has particles, Turkish has postpositions, etc.
+ */
+export declare const EnglishPartsOfSpeech: Readonly<{
+    readonly VERB: "verb";
+    readonly NOUN: "noun";
+    readonly ADJECTIVE: "adjective";
+    readonly ARTICLE: "article";
+    readonly PREPOSITION: "preposition";
+    readonly PRONOUN: "pronoun";
+    readonly DETERMINER: "determiner";
+    readonly CONJUNCTION: "conjunction";
+    readonly INTERJECTION: "interjection";
+    readonly DIRECTION: "direction";
+    readonly ADVERB: "adverb";
+    readonly AUXILIARY: "auxiliary";
+}>;
+/**
+ * Type for English parts of speech values
+ */
+export type EnglishPartOfSpeech = typeof EnglishPartsOfSpeech[keyof typeof EnglishPartsOfSpeech];
+/**
+ * English grammar patterns
+ *
+ * These patterns describe common command structures in English
+ */
+export declare const EnglishGrammarPatterns: {
+    readonly VERB_ONLY: {
+        readonly name: "verb_only";
+        readonly elements: readonly ["VERB"];
+        readonly example: "look";
+        readonly description: "Simple intransitive verb";
+    };
+    readonly VERB_NOUN: {
+        readonly name: "verb_noun";
+        readonly elements: readonly ["VERB", "NOUN_PHRASE"];
+        readonly example: "take ball";
+        readonly description: "Transitive verb with direct object";
+    };
+    readonly VERB_NOUN_PREP_NOUN: {
+        readonly name: "verb_noun_prep_noun";
+        readonly elements: readonly ["VERB", "NOUN_PHRASE", "PREP", "NOUN_PHRASE"];
+        readonly example: "put ball in box";
+        readonly description: "Ditransitive verb with direct and indirect objects";
+    };
+    readonly VERB_PREP_NOUN: {
+        readonly name: "verb_prep_noun";
+        readonly elements: readonly ["VERB", "PREP", "NOUN_PHRASE"];
+        readonly example: "look at painting";
+        readonly description: "Verb with prepositional phrase";
+    };
+    readonly VERB_PARTICLE_NOUN: {
+        readonly name: "verb_particle_noun";
+        readonly elements: readonly ["VERB", "PARTICLE", "NOUN_PHRASE"];
+        readonly example: "pick up ball";
+        readonly description: "Phrasal verb with direct object";
+    };
+    readonly VERB_NOUN_PARTICLE: {
+        readonly name: "verb_noun_particle";
+        readonly elements: readonly ["VERB", "NOUN_PHRASE", "PARTICLE"];
+        readonly example: "put ball down";
+        readonly description: "Phrasal verb with object before particle";
+    };
+    readonly VERB_DIRECTION: {
+        readonly name: "verb_direction";
+        readonly elements: readonly ["VERB", "DIRECTION"];
+        readonly example: "go north";
+        readonly description: "Movement verb with direction";
+    };
+    readonly DIRECTION_ONLY: {
+        readonly name: "direction_only";
+        readonly elements: readonly ["DIRECTION"];
+        readonly example: "north";
+        readonly description: "Implicit movement command";
+    };
+};
+/**
+ * Type for English grammar pattern names
+ */
+export type EnglishGrammarPatternName = keyof typeof EnglishGrammarPatterns;
+/**
+ * English-specific token type for language processing
+ */
+export interface EnglishToken {
+    /** Original word as typed */
+    word: string;
+    /** Normalized form (lowercase, etc.) */
+    normalized: string;
+    /** Character position in original input */
+    position: number;
+    /** Length of the token */
+    length: number;
+    /** Possible English parts of speech */
+    partsOfSpeech: EnglishPartOfSpeech[];
+    /** Additional English-specific data */
+    englishData?: {
+        /** Is this a contraction? */
+        isContraction?: boolean;
+        /** Expanded form if contraction */
+        expandedForm?: string;
+        /** Is this part of a phrasal verb? */
+        isPhrasalVerbParticle?: boolean;
+        /** Is this a modal verb? */
+        isModal?: boolean;
+    };
+}
+/**
+ * English verb forms and conjugations
+ */
+export interface EnglishVerbForms {
+    /** Base form (infinitive without 'to') */
+    base: string;
+    /** Third person singular present */
+    thirdPersonSingular?: string;
+    /** Past tense */
+    past?: string;
+    /** Past participle */
+    pastParticiple?: string;
+    /** Present participle (-ing form) */
+    presentParticiple?: string;
+    /** Imperative form (usually same as base) */
+    imperative?: string;
+}
+/**
+ * English noun properties
+ */
+export interface EnglishNounProperties {
+    /** Singular form */
+    singular: string;
+    /** Plural form */
+    plural?: string;
+    /** Is this a mass noun (uncountable)? */
+    isMassNoun?: boolean;
+    /** Is this a proper noun? */
+    isProperNoun?: boolean;
+    /** Common adjectives that collocate with this noun */
+    commonAdjectives?: string[];
+}
+/**
+ * English preposition properties
+ */
+export interface EnglishPrepositionProperties {
+    /** The preposition */
+    preposition: string;
+    /** Type of relationship it expresses */
+    relationshipType: 'spatial' | 'temporal' | 'logical' | 'other';
+    /** Can it be used as a particle in phrasal verbs? */
+    canBeParticle?: boolean;
+}
+/**
+ * Utility functions for English grammar
+ */
+export declare const EnglishGrammarUtils: {
+    /**
+     * Check if a word is likely an article
+     */
+    isArticle(word: string): boolean;
+    /**
+     * Check if a word is a common determiner
+     */
+    isDeterminer(word: string): boolean;
+    /**
+     * Check if a word is a pronoun
+     */
+    isPronoun(word: string): boolean;
+    /**
+     * Check if a word is a conjunction
+     */
+    isConjunction(word: string): boolean;
+    /**
+     * Get the indefinite article for a word
+     */
+    getIndefiniteArticle(word: string): "a" | "an";
+};
+/**
+ * Export all grammar types and constants
+ */
+export * from './index';
+//# sourceMappingURL=grammar.d.ts.map

package/dist-npm/grammar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grammar.d.ts","sourceRoot":"","sources":["../src/grammar.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;EAatB,CAAC;AAEZ;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,oBAAoB,CAAC,MAAM,OAAO,oBAAoB,CAAC,CAAC;AAEjG;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiDzB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,MAAM,OAAO,sBAAsB,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,aAAa,EAAE,mBAAmB,EAAE,CAAC;IACrC,uCAAuC;IACvC,WAAW,CAAC,EAAE;QACZ,6BAA6B;QAC7B,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,mCAAmC;QACnC,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,sCAAsC;QACtC,qBAAqB,CAAC,EAAE,OAAO,CAAC;QAChC,4BAA4B;QAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iBAAiB;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qCAAqC;IACrC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,6BAA6B;IAC7B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,sDAAsD;IACtD,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,sBAAsB;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,gBAAgB,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC;IAC/D,qDAAqD;IACrD,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB;IAC9B;;OAEG;oBACa,MAAM,GAAG,OAAO;IAKhC;;OAEG;uBACgB,MAAM,GAAG,OAAO;IAUnC;;OAEG;oBACa,MAAM,GAAG,OAAO;IAYhC;;OAEG;wBACiB,MAAM,GAAG,OAAO;IASpC;;OAEG;+BACwB,MAAM,GAAG,GAAG,GAAG,IAAI;CAqD/C,CAAC;AAEF;;GAEG;AACH,cAAc,SAAS,CAAC"}

package/dist-npm/grammar.js

@@ -0,0 +1,203 @@
+"use strict";
+/**
+ * English-specific grammar types and constants
+ *
+ * This module defines the parts of speech and grammatical structures
+ * specific to the English language. Other languages will have their
+ * own grammar modules with different parts of speech.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnglishGrammarUtils = exports.EnglishGrammarPatterns = exports.EnglishPartsOfSpeech = void 0;
+/**
+ * English parts of speech
+ *
+ * Note: This is specific to English and may not apply to other languages.
+ * For example, Japanese has particles, Turkish has postpositions, etc.
+ */
+exports.EnglishPartsOfSpeech = Object.freeze({
+    VERB: 'verb',
+    NOUN: 'noun',
+    ADJECTIVE: 'adjective',
+    ARTICLE: 'article',
+    PREPOSITION: 'preposition',
+    PRONOUN: 'pronoun',
+    DETERMINER: 'determiner',
+    CONJUNCTION: 'conjunction',
+    INTERJECTION: 'interjection',
+    DIRECTION: 'direction',
+    ADVERB: 'adverb',
+    AUXILIARY: 'auxiliary'
+});
+/**
+ * English grammar patterns
+ *
+ * These patterns describe common command structures in English
+ */
+exports.EnglishGrammarPatterns = {
+    VERB_ONLY: {
+        name: 'verb_only',
+        elements: ['VERB'],
+        example: 'look',
+        description: 'Simple intransitive verb'
+    },
+    VERB_NOUN: {
+        name: 'verb_noun',
+        elements: ['VERB', 'NOUN_PHRASE'],
+        example: 'take ball',
+        description: 'Transitive verb with direct object'
+    },
+    VERB_NOUN_PREP_NOUN: {
+        name: 'verb_noun_prep_noun',
+        elements: ['VERB', 'NOUN_PHRASE', 'PREP', 'NOUN_PHRASE'],
+        example: 'put ball in box',
+        description: 'Ditransitive verb with direct and indirect objects'
+    },
+    VERB_PREP_NOUN: {
+        name: 'verb_prep_noun',
+        elements: ['VERB', 'PREP', 'NOUN_PHRASE'],
+        example: 'look at painting',
+        description: 'Verb with prepositional phrase'
+    },
+    VERB_PARTICLE_NOUN: {
+        name: 'verb_particle_noun',
+        elements: ['VERB', 'PARTICLE', 'NOUN_PHRASE'],
+        example: 'pick up ball',
+        description: 'Phrasal verb with direct object'
+    },
+    VERB_NOUN_PARTICLE: {
+        name: 'verb_noun_particle',
+        elements: ['VERB', 'NOUN_PHRASE', 'PARTICLE'],
+        example: 'put ball down',
+        description: 'Phrasal verb with object before particle'
+    },
+    VERB_DIRECTION: {
+        name: 'verb_direction',
+        elements: ['VERB', 'DIRECTION'],
+        example: 'go north',
+        description: 'Movement verb with direction'
+    },
+    DIRECTION_ONLY: {
+        name: 'direction_only',
+        elements: ['DIRECTION'],
+        example: 'north',
+        description: 'Implicit movement command'
+    }
+};
+/**
+ * Utility functions for English grammar
+ */
+exports.EnglishGrammarUtils = {
+    /**
+     * Check if a word is likely an article
+     */
+    isArticle(word) {
+        const articles = ['a', 'an', 'the'];
+        return articles.includes(word.toLowerCase());
+    },
+    /**
+     * Check if a word is a common determiner
+     */
+    isDeterminer(word) {
+        const determiners = [
+            'all', 'every', 'some', 'any', 'no', 'each',
+            'this', 'that', 'these', 'those',
+            'my', 'your', 'his', 'her', 'its', 'our', 'their',
+            'much', 'many', 'few', 'little', 'several'
+        ];
+        return determiners.includes(word.toLowerCase());
+    },
+    /**
+     * Check if a word is a pronoun
+     */
+    isPronoun(word) {
+        const pronouns = [
+            'i', 'me', 'you', 'he', 'him', 'she', 'her', 'it',
+            'we', 'us', 'they', 'them',
+            'myself', 'yourself', 'himself', 'herself', 'itself',
+            'ourselves', 'yourselves', 'themselves',
+            'this', 'that', 'these', 'those',
+            'who', 'whom', 'whose', 'which', 'what'
+        ];
+        return pronouns.includes(word.toLowerCase());
+    },
+    /**
+     * Check if a word is a conjunction
+     */
+    isConjunction(word) {
+        const conjunctions = [
+            'and', 'or', 'but', 'nor', 'for', 'yet', 'so',
+            'although', 'because', 'since', 'unless',
+            'while', 'when', 'where', 'if'
+        ];
+        return conjunctions.includes(word.toLowerCase());
+    },
+    /**
+     * Get the indefinite article for a word
+     */
+    getIndefiniteArticle(word) {
+        if (!word || word.length === 0) {
+            throw new Error('Cannot determine article for empty string');
+        }
+        const lowerWord = word.toLowerCase();
+        const firstChar = lowerWord[0];
+        const vowels = ['a', 'e', 'i', 'o', 'u'];
+        // Special cases for numbers
+        const numberSounds = {
+            '8': 'an', // "eight"
+            '11': 'an', // "eleven"
+            '18': 'an', // "eighteen"
+            '80': 'an', // "eighty"
+            '800': 'an', // "eight hundred"
+            '1': 'a', // "one"
+            '2': 'a', // "two"
+            '3': 'a', // "three"
+            '4': 'a', // "four"
+            '5': 'a', // "five"
+            '6': 'a', // "six"
+            '7': 'a', // "seven"
+            '9': 'a', // "nine"
+            '10': 'a', // "ten"
+            '12': 'a', // "twelve"
+            '13': 'a', // "thirteen"
+            '14': 'a', // "fourteen"
+            '15': 'a', // "fifteen"
+            '16': 'a', // "sixteen"
+            '17': 'a', // "seventeen"
+            '19': 'a', // "nineteen"
+        };
+        // Check if it's a number
+        if (word in numberSounds) {
+            return numberSounds[word];
+        }
+        // Special cases for words starting with silent 'h'
+        const silentH = ['hour', 'honest', 'honor', 'heir'];
+        if (silentH.some(w => lowerWord.startsWith(w))) {
+            return 'an';
+        }
+        // Special cases for words starting with 'u' that sound like 'you'
+        const uSoundsLikeYou = ['unit', 'university', 'unique', 'uniform'];
+        if (uSoundsLikeYou.some(w => lowerWord.startsWith(w))) {
+            return 'a';
+        }
+        return vowels.includes(firstChar) ? 'an' : 'a';
+    }
+};
+/**
+ * Export all grammar types and constants
+ */
+__exportStar(require("./index"), exports);
+//# sourceMappingURL=grammar.js.map

package/dist-npm/grammar.js.map

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

package/dist-npm/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * English (US) Language Package for Sharpee IF Platform
+ *
+ * Provides English language support including:
+ * - Vocabulary (verbs, nouns, adjectives, etc.)
+ * - Grammar patterns
+ * - Text formatting and lemmatization
+ * - Message templates
+ * - Action patterns and messages
+ * - NPC messages (ADR-070)
+ */
+export { EnglishLanguageProvider, default } from './language-provider';
+export { EnglishLanguageProvider as LanguageProvider } from './language-provider';
+export type { VerbDefinition } from './data/verbs';
+export * from './grammar';
+export * from './actions';
+export * from './npc';
+export * from './perspective';
+export * from './formatters';
+export { cardinalNumbers, ordinalNumbers, directionMap, englishWords, abbreviations, irregularPlurals } from './data/words';
+export { parserErrors, getParserErrorMessage } from './data/messages';
+//# sourceMappingURL=index.d.ts.map

package/dist-npm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,uBAAuB,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,uBAAuB,IAAI,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAGlF,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGnD,cAAc,WAAW,CAAC;AAG1B,cAAc,WAAW,CAAC;AAG1B,cAAc,OAAO,CAAC;AAGtB,cAAc,eAAe,CAAC;AAG9B,cAAc,cAAc,CAAC;AAG7B,OAAO,EACL,eAAe,EACf,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,gBAAgB,EACjB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist-npm/index.js

@@ -0,0 +1,59 @@
+"use strict";
+/**
+ * English (US) Language Package for Sharpee IF Platform
+ *
+ * Provides English language support including:
+ * - Vocabulary (verbs, nouns, adjectives, etc.)
+ * - Grammar patterns
+ * - Text formatting and lemmatization
+ * - Message templates
+ * - Action patterns and messages
+ * - NPC messages (ADR-070)
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getParserErrorMessage = exports.parserErrors = exports.irregularPlurals = exports.abbreviations = exports.englishWords = exports.directionMap = exports.ordinalNumbers = exports.cardinalNumbers = exports.LanguageProvider = exports.default = exports.EnglishLanguageProvider = void 0;
+var language_provider_1 = require("./language-provider");
+Object.defineProperty(exports, "EnglishLanguageProvider", { enumerable: true, get: function () { return language_provider_1.EnglishLanguageProvider; } });
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return __importDefault(language_provider_1).default; } });
+var language_provider_2 = require("./language-provider"); // For convenience
+Object.defineProperty(exports, "LanguageProvider", { enumerable: true, get: function () { return language_provider_2.EnglishLanguageProvider; } });
+// Export grammar types and constants
+__exportStar(require("./grammar"), exports);
+// Export action language definitions
+__exportStar(require("./actions"), exports);
+// Export NPC language definitions (ADR-070)
+__exportStar(require("./npc"), exports);
+// Export perspective placeholder resolution (ADR-089)
+__exportStar(require("./perspective"), exports);
+// Export formatter system (ADR-095)
+__exportStar(require("./formatters"), exports);
+// Export vocabulary data for parser use (ADR-082)
+var words_1 = require("./data/words");
+Object.defineProperty(exports, "cardinalNumbers", { enumerable: true, get: function () { return words_1.cardinalNumbers; } });
+Object.defineProperty(exports, "ordinalNumbers", { enumerable: true, get: function () { return words_1.ordinalNumbers; } });
+Object.defineProperty(exports, "directionMap", { enumerable: true, get: function () { return words_1.directionMap; } });
+Object.defineProperty(exports, "englishWords", { enumerable: true, get: function () { return words_1.englishWords; } });
+Object.defineProperty(exports, "abbreviations", { enumerable: true, get: function () { return words_1.abbreviations; } });
+Object.defineProperty(exports, "irregularPlurals", { enumerable: true, get: function () { return words_1.irregularPlurals; } });
+// Export parser error messages (Phase 1.2 recommendations)
+var messages_1 = require("./data/messages");
+Object.defineProperty(exports, "parserErrors", { enumerable: true, get: function () { return messages_1.parserErrors; } });
+Object.defineProperty(exports, "getParserErrorMessage", { enumerable: true, get: function () { return messages_1.getParserErrorMessage; } });
+//# sourceMappingURL=index.js.map

package/dist-npm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;;;;;;;;;;;;;;;;;;AAEH,yDAAuE;AAA9D,4HAAA,uBAAuB,OAAA;AAAE,6HAAA,OAAO,OAAA;AACzC,yDAAkF,CAAC,kBAAkB;AAA5F,qHAAA,uBAAuB,OAAoB;AAKpD,qCAAqC;AACrC,4CAA0B;AAE1B,qCAAqC;AACrC,4CAA0B;AAE1B,4CAA4C;AAC5C,wCAAsB;AAEtB,sDAAsD;AACtD,gDAA8B;AAE9B,oCAAoC;AACpC,+CAA6B;AAE7B,kDAAkD;AAClD,sCAOsB;AANpB,wGAAA,eAAe,OAAA;AACf,uGAAA,cAAc,OAAA;AACd,qGAAA,YAAY,OAAA;AACZ,qGAAA,YAAY,OAAA;AACZ,sGAAA,aAAa,OAAA;AACb,yGAAA,gBAAgB,OAAA;AAGlB,2DAA2D;AAC3D,4CAAsE;AAA7D,wGAAA,YAAY,OAAA;AAAE,iHAAA,qBAAqB,OAAA"}