@sharpee/if-domain 0.9.60-beta

package/dist/grammar/vocabulary-provider.d.ts

@@ -0,0 +1,163 @@
+/**
+ * @file Grammar Vocabulary Provider
+ * @description Context-aware vocabulary system for grammar pattern matching (ADR-082)
+ *
+ * This is distinct from vocabulary-contracts/VocabularyProvider which is for
+ * providing vocabulary entries to VocabularyRegistry. This system is specifically
+ * for context-aware vocabulary categories used in grammar slot matching.
+ *
+ * Vocabulary categories are registered with optional context predicates.
+ * The parser only considers a pattern if its vocabulary is active in the current context.
+ */
+import { GrammarContext } from './grammar-builder';
+/**
+ * Configuration for a vocabulary category
+ */
+export interface GrammarVocabularyConfig {
+    /** Words in this vocabulary category */
+    words: string[];
+    /**
+     * Optional context predicate - if provided, vocabulary is only active
+     * when this function returns true for the current GrammarContext.
+     *
+     * @example
+     * ```typescript
+     * vocab.define('panel-colors', {
+     *   words: ['red', 'yellow', 'mahogany', 'pine'],
+     *   when: (ctx) => ctx.currentLocation === insideMirrorId
+     * });
+     * ```
+     */
+    when?: (ctx: GrammarContext) => boolean;
+}
+/**
+ * Result of a grammar vocabulary match
+ */
+export interface GrammarVocabularyMatch {
+    /** The matched word (normalized to lowercase) */
+    word: string;
+    /** The category this word was matched from */
+    category: string;
+}
+/**
+ * Context-aware vocabulary provider for grammar pattern matching.
+ *
+ * Stories register vocabulary categories with optional context predicates.
+ * The parser checks if a category is active before attempting to match words.
+ *
+ * @example
+ * ```typescript
+ * // Story initialization
+ * const vocab = world.getGrammarVocabularyProvider();
+ *
+ * // Global vocabulary (always active)
+ * vocab.define('manner', {
+ *   words: ['carefully', 'quickly', 'forcefully']
+ * });
+ *
+ * // Context-specific vocabulary
+ * vocab.define('panel-colors', {
+ *   words: ['red', 'yellow', 'mahogany', 'pine'],
+ *   when: (ctx) => ctx.currentLocation === insideMirrorId
+ * });
+ *
+ * // Grammar pattern references the category
+ * grammar
+ *   .define('push :color panel')
+ *   .fromVocabulary('color', 'panel-colors')
+ *   .mapsTo('push_panel')
+ *   .build();
+ * ```
+ */
+export interface IGrammarVocabularyProvider {
+    /**
+     * Define a named vocabulary category.
+     *
+     * @param category - Unique category name (e.g., 'panel-colors', 'dial-positions')
+     * @param config - Words and optional context predicate
+     * @throws Error if category already exists (use extend() to add words)
+     */
+    define(category: string, config: GrammarVocabularyConfig): void;
+    /**
+     * Extend an existing category with additional words.
+     * The context predicate is inherited from the original definition.
+     *
+     * @param category - Existing category name
+     * @param words - Additional words to add
+     * @throws Error if category doesn't exist
+     */
+    extend(category: string, words: string[]): void;
+    /**
+     * Check if a word matches a category in the current context.
+     *
+     * Returns true only if:
+     * 1. The category exists
+     * 2. The category is active in the context (when predicate passes or is absent)
+     * 3. The word is in the category's word list
+     *
+     * @param category - Category name to check
+     * @param word - Word to match (case-insensitive)
+     * @param ctx - Current grammar context
+     * @returns true if word matches category in context
+     */
+    match(category: string, word: string, ctx: GrammarContext): boolean;
+    /**
+     * Get all words in a category (for tooling/debugging).
+     * Returns empty set if category doesn't exist.
+     *
+     * @param category - Category name
+     * @returns Set of words in the category
+     */
+    getWords(category: string): Set<string>;
+    /**
+     * Check if a category is active in the current context.
+     *
+     * @param category - Category name
+     * @param ctx - Current grammar context
+     * @returns true if category exists and its when predicate passes (or is absent)
+     */
+    isActive(category: string, ctx: GrammarContext): boolean;
+    /**
+     * Check if a category exists (regardless of context).
+     *
+     * @param category - Category name
+     * @returns true if category has been defined
+     */
+    hasCategory(category: string): boolean;
+    /**
+     * Get all defined category names (for tooling/debugging).
+     *
+     * @returns Array of category names
+     */
+    getCategories(): string[];
+    /**
+     * Remove a category.
+     *
+     * @param category - Category name to remove
+     * @returns true if category was removed, false if it didn't exist
+     */
+    removeCategory(category: string): boolean;
+    /**
+     * Clear all vocabulary categories.
+     */
+    clear(): void;
+}
+/**
+ * Default implementation of IGrammarVocabularyProvider.
+ *
+ * Stores vocabulary categories with their words and context predicates.
+ * All word matching is case-insensitive.
+ */
+export declare class GrammarVocabularyProvider implements IGrammarVocabularyProvider {
+    private categories;
+    define(category: string, config: GrammarVocabularyConfig): void;
+    extend(category: string, words: string[]): void;
+    match(category: string, word: string, ctx: GrammarContext): boolean;
+    getWords(category: string): Set<string>;
+    isActive(category: string, ctx: GrammarContext): boolean;
+    hasCategory(category: string): boolean;
+    getCategories(): string[];
+    removeCategory(category: string): boolean;
+    clear(): void;
+}
+//# sourceMappingURL=vocabulary-provider.d.ts.map

package/dist/grammar/vocabulary-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vocabulary-provider.d.ts","sourceRoot":"","sources":["../../src/grammar/vocabulary-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,wCAAwC;IACxC,KAAK,EAAE,MAAM,EAAE,CAAC;IAEhB;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IAEb,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAEhE;;;;;;;OAOG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAEhD;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC;IAEpE;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;IAExC;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC;IAEzD;;;;;OAKG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAEvC;;;;OAIG;IACH,aAAa,IAAI,MAAM,EAAE,CAAC;IAE1B;;;;;OAKG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAE1C;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;;;GAKG;AACH,qBAAa,yBAA0B,YAAW,0BAA0B;IAC1E,OAAO,CAAC,UAAU,CAGb;IAEL,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,uBAAuB,GAAG,IAAI;IAgB/D,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAY/C,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO;IAenE,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IASvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO;IAcxD,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAItC,aAAa,IAAI,MAAM,EAAE;IAIzB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIzC,KAAK,IAAI,IAAI;CAGd"}

package/dist/grammar/vocabulary-provider.js

@@ -0,0 +1,89 @@
+"use strict";
+/**
+ * @file Grammar Vocabulary Provider
+ * @description Context-aware vocabulary system for grammar pattern matching (ADR-082)
+ *
+ * This is distinct from vocabulary-contracts/VocabularyProvider which is for
+ * providing vocabulary entries to VocabularyRegistry. This system is specifically
+ * for context-aware vocabulary categories used in grammar slot matching.
+ *
+ * Vocabulary categories are registered with optional context predicates.
+ * The parser only considers a pattern if its vocabulary is active in the current context.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GrammarVocabularyProvider = void 0;
+/**
+ * Default implementation of IGrammarVocabularyProvider.
+ *
+ * Stores vocabulary categories with their words and context predicates.
+ * All word matching is case-insensitive.
+ */
+class GrammarVocabularyProvider {
+    categories = new Map();
+    define(category, config) {
+        if (this.categories.has(category)) {
+            throw new Error(`Vocabulary category '${category}' already exists. Use extend() to add words.`);
+        }
+        // Normalize words to lowercase
+        const normalizedWords = new Set(config.words.map(w => w.toLowerCase()));
+        this.categories.set(category, {
+            words: normalizedWords,
+            when: config.when
+        });
+    }
+    extend(category, words) {
+        const existing = this.categories.get(category);
+        if (!existing) {
+            throw new Error(`Vocabulary category '${category}' does not exist. Use define() first.`);
+        }
+        // Add normalized words
+        for (const word of words) {
+            existing.words.add(word.toLowerCase());
+        }
+    }
+    match(category, word, ctx) {
+        const config = this.categories.get(category);
+        if (!config) {
+            return false;
+        }
+        // Check context predicate
+        if (config.when && !config.when(ctx)) {
+            return false;
+        }
+        // Check word (case-insensitive)
+        return config.words.has(word.toLowerCase());
+    }
+    getWords(category) {
+        const config = this.categories.get(category);
+        if (!config) {
+            return new Set();
+        }
+        // Return a copy to prevent external modification
+        return new Set(config.words);
+    }
+    isActive(category, ctx) {
+        const config = this.categories.get(category);
+        if (!config) {
+            return false;
+        }
+        // No predicate means always active
+        if (!config.when) {
+            return true;
+        }
+        return config.when(ctx);
+    }
+    hasCategory(category) {
+        return this.categories.has(category);
+    }
+    getCategories() {
+        return Array.from(this.categories.keys());
+    }
+    removeCategory(category) {
+        return this.categories.delete(category);
+    }
+    clear() {
+        this.categories.clear();
+    }
+}
+exports.GrammarVocabularyProvider = GrammarVocabularyProvider;
+//# sourceMappingURL=vocabulary-provider.js.map

package/dist/grammar/vocabulary-provider.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @sharpee/if-domain - Core domain model for Sharpee Interactive Fiction Platform
+ *
+ * This package contains the shared domain types, events, and contracts
+ * used throughout the Sharpee platform.
+ */
+export * from './events';
+export * from './contracts';
+export * from './changes';
+export * from './sequencing';
+export * from './language-provider';
+export * from './parser-language-provider';
+export * from './parser-contracts';
+export * from './vocabulary-contracts';
+export * from './grammar';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,UAAU,CAAC;AAGzB,cAAc,aAAa,CAAC;AAG5B,cAAc,WAAW,CAAC;AAG1B,cAAc,cAAc,CAAC;AAG7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAG3C,cAAc,oBAAoB,CAAC;AAGnC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,40 @@
+"use strict";
+/**
+ * @sharpee/if-domain - Core domain model for Sharpee Interactive Fiction Platform
+ *
+ * This package contains the shared domain types, events, and contracts
+ * used throughout the Sharpee platform.
+ */
+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 });
+// Domain events
+__exportStar(require("./events"), exports);
+// Domain contracts
+__exportStar(require("./contracts"), exports);
+// World state changes
+__exportStar(require("./changes"), exports);
+// Event sequencing
+__exportStar(require("./sequencing"), exports);
+// Language provider interfaces
+__exportStar(require("./language-provider"), exports);
+__exportStar(require("./parser-language-provider"), exports);
+// Parser contracts
+__exportStar(require("./parser-contracts"), exports);
+// Vocabulary contracts
+__exportStar(require("./vocabulary-contracts"), exports);
+// Grammar system
+__exportStar(require("./grammar"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;AAEH,gBAAgB;AAChB,2CAAyB;AAEzB,mBAAmB;AACnB,8CAA4B;AAE5B,sBAAsB;AACtB,4CAA0B;AAE1B,mBAAmB;AACnB,+CAA6B;AAE7B,+BAA+B;AAC/B,sDAAoC;AACpC,6DAA2C;AAE3C,mBAAmB;AACnB,qDAAmC;AAEnC,uBAAuB;AACvB,yDAAuC;AAEvC,iBAAiB;AACjB,4CAA0B"}

package/dist/language-provider.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Language provider interface for Interactive Fiction
+ *
+ * This interface defines the contract for providing localized text,
+ * action patterns, and message formatting throughout the IF system.
+ *
+ * Implementations should handle:
+ * - Action patterns (verb synonyms)
+ * - Message text with parameter substitution
+ * - Localization and customization
+ */
+/**
+ * Structured help information for an action
+ */
+export interface ActionHelp {
+    /**
+     * Brief description of what the action does
+     */
+    description: string;
+    /**
+     * Verb forms and patterns that trigger this action
+     * Extracted from the patterns array
+     */
+    verbs: string[];
+    /**
+     * Example commands showing usage
+     */
+    examples: string[];
+    /**
+     * The one-line help summary (from help_<action> message)
+     * Format: "VERB/VERB - Description. Example: COMMAND"
+     */
+    summary?: string;
+}
+/**
+ * Language provider interface
+ */
+export interface LanguageProvider {
+    /**
+     * The language code this provider supports (e.g., 'en-us', 'es-es')
+     */
+    readonly languageCode: string;
+    /**
+     * Get patterns/aliases for an action
+     * @param actionId The action identifier (e.g., 'if.action.taking')
+     * @returns Array of patterns or undefined if action not found
+     */
+    getActionPatterns(actionId: string): string[] | undefined;
+    /**
+     * Get a message by ID with optional parameter substitution
+     * @param messageId The message identifier
+     * @param params Optional parameters for substitution
+     * @returns The formatted message
+     */
+    getMessage(messageId: string, params?: Record<string, any>): string;
+    /**
+     * Check if a message exists
+     * @param messageId The message identifier
+     * @returns True if the message exists
+     */
+    hasMessage(messageId: string): boolean;
+    /**
+     * Get structured help information for an action
+     * @param actionId The action identifier (e.g., 'if.action.taking')
+     * @returns Structured help information or undefined if not found
+     */
+    getActionHelp?(actionId: string): ActionHelp | undefined;
+    /**
+     * Get all supported actions
+     * @returns Array of action IDs
+     */
+    getSupportedActions?(): string[];
+}
+/**
+ * Language provider registry interface
+ */
+export interface LanguageProviderRegistry {
+    /**
+     * Register a language provider
+     * @param provider The language provider to register
+     */
+    register(provider: LanguageProvider): void;
+    /**
+     * Get a language provider by code
+     * @param languageCode The language code (e.g., 'en-us')
+     * @returns The provider or undefined if not found
+     */
+    get(languageCode: string): LanguageProvider | undefined;
+    /**
+     * Get the default language provider
+     * @returns The default provider
+     * @throws Error if no default provider is set
+     */
+    getDefault(): LanguageProvider;
+    /**
+     * Set the default language provider
+     * @param languageCode The language code to set as default
+     */
+    setDefault(languageCode: string): void;
+    /**
+     * Get all registered language codes
+     * @returns Array of language codes
+     */
+    getAvailableLanguages(): string[];
+}
+//# sourceMappingURL=language-provider.d.ts.map

package/dist/language-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-provider.d.ts","sourceRoot":"","sources":["../src/language-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,KAAK,EAAE,MAAM,EAAE,CAAC;IAEhB;;OAEG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B;;;;OAIG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;IAE1D;;;;;OAKG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC;IAEpE;;;;OAIG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IAEvC;;;;OAIG;IACH,aAAa,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IAEzD;;;OAGG;IACH,mBAAmB,CAAC,IAAI,MAAM,EAAE,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAE3C;;;;OAIG;IACH,GAAG,CAAC,YAAY,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAAC;IAExD;;;;OAIG;IACH,UAAU,IAAI,gBAAgB,CAAC;IAE/B;;;OAGG;IACH,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvC;;;OAGG;IACH,qBAAqB,IAAI,MAAM,EAAE,CAAC;CACnC"}

package/dist/language-provider.js

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * Language provider interface for Interactive Fiction
+ *
+ * This interface defines the contract for providing localized text,
+ * action patterns, and message formatting throughout the IF system.
+ *
+ * Implementations should handle:
+ * - Action patterns (verb synonyms)
+ * - Message text with parameter substitution
+ * - Localization and customization
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=language-provider.js.map

package/dist/language-provider.js.map

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

package/dist/parser-contracts/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Parser contracts module exports
+ *
+ * These are the language-agnostic parser interfaces and types
+ * that can be implemented by language-specific parsers.
+ */
+export * from './parser-types';
+export * from './parser-internals';
+export * from './parser-factory';
+//# sourceMappingURL=index.d.ts.map

package/dist/parser-contracts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/parser-contracts/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}

package/dist/parser-contracts/index.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * Parser contracts module exports
+ *
+ * These are the language-agnostic parser interfaces and types
+ * that can be implemented by language-specific parsers.
+ */
+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 });
+__exportStar(require("./parser-types"), exports);
+__exportStar(require("./parser-internals"), exports);
+__exportStar(require("./parser-factory"), exports);
+//# sourceMappingURL=index.js.map

package/dist/parser-contracts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/parser-contracts/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;AAEH,iDAA+B;AAC/B,qDAAmC;AACnC,mDAAiC"}

package/dist/parser-contracts/parser-factory.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Parser Factory
+ *
+ * Creates language-specific parser instances.
+ * The actual parser implementations are in separate packages
+ * and must be registered before use.
+ */
+import { Parser } from './parser-types';
+/**
+ * Registry of parser constructors
+ * Language providers are passed as 'any' to avoid coupling
+ */
+type ParserConstructor = new (languageProvider: any) => Parser;
+/**
+ * Parser factory for creating language-specific parsers
+ */
+export declare class ParserFactory {
+    /**
+     * Register a parser implementation for a language
+     *
+     * @example
+     * import { EnglishParser } from '@sharpee/parser-en-us';
+     * ParserFactory.registerParser('en-US', EnglishParser);
+     */
+    static registerParser(languageCode: string, parserClass: ParserConstructor): void;
+    /**
+     * Create a parser for the specified language
+     *
+     * @throws Error if no parser is registered for the language
+     */
+    static createParser(languageCode: string, languageProvider: any): Parser;
+    /**
+     * Get list of registered language codes
+     */
+    static getRegisteredLanguages(): string[];
+    /**
+     * Check if a parser is registered for a language
+     */
+    static isLanguageRegistered(languageCode: string): boolean;
+    /**
+     * Clear all registered parsers (mainly for testing)
+     */
+    static clearRegistry(): void;
+}
+export {};
+//# sourceMappingURL=parser-factory.d.ts.map

package/dist/parser-contracts/parser-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser-factory.d.ts","sourceRoot":"","sources":["../../src/parser-contracts/parser-factory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC;;;GAGG;AACH,KAAK,iBAAiB,GAAG,KAAK,gBAAgB,EAAE,GAAG,KAAK,MAAM,CAAC;AAI/D;;GAEG;AACH,qBAAa,aAAa;IACxB;;;;;;OAMG;IACH,MAAM,CAAC,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,iBAAiB,GAAG,IAAI;IAWjF;;;;OAIG;IACH,MAAM,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,gBAAgB,EAAE,GAAG,GAAG,MAAM;IAwBxE;;OAEG;IACH,MAAM,CAAC,sBAAsB,IAAI,MAAM,EAAE;IAIzC;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAQ1D;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;CAG7B"}

package/dist/parser-contracts/parser-factory.js

@@ -0,0 +1,78 @@
+"use strict";
+/**
+ * Parser Factory
+ *
+ * Creates language-specific parser instances.
+ * The actual parser implementations are in separate packages
+ * and must be registered before use.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ParserFactory = void 0;
+const parserRegistry = new Map();
+/**
+ * Parser factory for creating language-specific parsers
+ */
+class ParserFactory {
+    /**
+     * Register a parser implementation for a language
+     *
+     * @example
+     * import { EnglishParser } from '@sharpee/parser-en-us';
+     * ParserFactory.registerParser('en-US', EnglishParser);
+     */
+    static registerParser(languageCode, parserClass) {
+        const normalized = languageCode.toLowerCase();
+        parserRegistry.set(normalized, parserClass);
+        // Also register without region code
+        const langOnly = normalized.split('-')[0];
+        if (langOnly !== normalized && !parserRegistry.has(langOnly)) {
+            parserRegistry.set(langOnly, parserClass);
+        }
+    }
+    /**
+     * Create a parser for the specified language
+     *
+     * @throws Error if no parser is registered for the language
+     */
+    static createParser(languageCode, languageProvider) {
+        const normalized = languageCode.toLowerCase();
+        // Try exact match first
+        let ParserClass = parserRegistry.get(normalized);
+        // Try language without region
+        if (!ParserClass) {
+            const langOnly = normalized.split('-')[0];
+            ParserClass = parserRegistry.get(langOnly);
+        }
+        if (!ParserClass) {
+            const available = Array.from(parserRegistry.keys()).sort();
+            throw new Error(`No parser registered for language: ${languageCode}. ` +
+                `Available languages: ${available.join(', ')}. ` +
+                `Register a parser using ParserFactory.registerParser().`);
+        }
+        return new ParserClass(languageProvider);
+    }
+    /**
+     * Get list of registered language codes
+     */
+    static getRegisteredLanguages() {
+        return Array.from(parserRegistry.keys()).sort();
+    }
+    /**
+     * Check if a parser is registered for a language
+     */
+    static isLanguageRegistered(languageCode) {
+        const normalized = languageCode.toLowerCase();
+        if (parserRegistry.has(normalized))
+            return true;
+        const langOnly = normalized.split('-')[0];
+        return parserRegistry.has(langOnly);
+    }
+    /**
+     * Clear all registered parsers (mainly for testing)
+     */
+    static clearRegistry() {
+        parserRegistry.clear();
+    }
+}
+exports.ParserFactory = ParserFactory;
+//# sourceMappingURL=parser-factory.js.map

package/dist/parser-contracts/parser-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser-factory.js","sourceRoot":"","sources":["../../src/parser-contracts/parser-factory.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAUH,MAAM,cAAc,GAAG,IAAI,GAAG,EAA6B,CAAC;AAE5D;;GAEG;AACH,MAAa,aAAa;IACxB;;;;;;OAMG;IACH,MAAM,CAAC,cAAc,CAAC,YAAoB,EAAE,WAA8B;QACxE,MAAM,UAAU,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;QAC9C,cAAc,CAAC,GAAG,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QAE5C,oCAAoC;QACpC,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1C,IAAI,QAAQ,KAAK,UAAU,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7D,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,YAAY,CAAC,YAAoB,EAAE,gBAAqB;QAC7D,MAAM,UAAU,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;QAE9C,wBAAwB;QACxB,IAAI,WAAW,GAAG,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAEjD,8BAA8B;QAC9B,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1C,WAAW,GAAG,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7C,CAAC;QAED,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAC3D,MAAM,IAAI,KAAK,CACb,sCAAsC,YAAY,IAAI;gBACtD,wBAAwB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;gBAChD,yDAAyD,CAC1D,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,WAAW,CAAC,gBAAgB,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,sBAAsB;QAC3B,OAAO,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,YAAoB;QAC9C,MAAM,UAAU,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;QAC9C,IAAI,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC;YAAE,OAAO,IAAI,CAAC;QAEhD,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1C,OAAO,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,aAAa;QAClB,cAAc,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;CACF;AAxED,sCAwEC"}